Sync man pages.

This commit is contained in:
Romain Tartiere 2010-12-24 13:34:25 +00:00
parent 29c8ef5c07
commit 4c3f0cd7d0
4 changed files with 54 additions and 21 deletions

17
NEWS
View file

@ -1,16 +1,11 @@
Changes between 0.2.3 and 0.3.0 [XX xxx XXXX] Changes between 0.2.3 and 0.3.0 [XX xxx XXXX]
*) New functions mifare_desfire_create_application_ex(), *) Add support for ISO and AES authentication through
mifare_desfire_create_application_iso(), mifare_desfire_authenticate_iso() and mifare_desfire_authenticate_aes().
mifare_desfire_create_application_iso_ex(), mifare_desfire_get_df_names(), *) Add support for 3K3DES and AES cryptographic operations.
mifare_desfire_free_mem(), mifare_desfire_set_configuration(), *) New functions mifare_desfire_free_mem(),
mifare_desfire_set_default_key(), mifare_desfire_set_ats(), mifare_desfire_set_configuration(), mifare_desfire_get_card_uid(), for
mifare_desfire_get_card_uid(), mifare_desfire_get_iso_file_ids(), Mifare DESFire EV1 targets manipulation.
mifare_desfire_create_std_data_file_iso(),
mifare_desfire_create_backup_data_file_iso(),
mifare_desfire_create_linear_record_file_iso() and
mifare_desfire_create_cyclic_record_file_iso() for Mifare DESFire EV1
targets manipulation.
*) Deprecate authentication information when deleting the currently selected *) Deprecate authentication information when deleting the currently selected
application application

View file

@ -85,6 +85,8 @@ linkedman = \
mifare_classic.3 mifare_classic_write.3 \ mifare_classic.3 mifare_classic_write.3 \
mifare_desfire.3 mifare_desfire_abort_transaction.3 \ mifare_desfire.3 mifare_desfire_abort_transaction.3 \
mifare_desfire.3 mifare_desfire_authenticate.3 \ mifare_desfire.3 mifare_desfire_authenticate.3 \
mifare_desfire.3 mifare_desfire_authenticate_aes.3 \
mifare_desfire.3 mifare_desfire_authenticate_iso.3 \
mifare_desfire.3 mifare_desfire_change_file_settings.3 \ mifare_desfire.3 mifare_desfire_change_file_settings.3 \
mifare_desfire.3 mifare_desfire_change_key.3 \ mifare_desfire.3 mifare_desfire_change_key.3 \
mifare_desfire.3 mifare_desfire_change_key_settings.3 \ mifare_desfire.3 mifare_desfire_change_key_settings.3 \
@ -130,6 +132,10 @@ linkedman = \
mifare_desfire_aid.3 mifare_desfire_aid_new_with_mad_aid.3 \ mifare_desfire_aid.3 mifare_desfire_aid_new_with_mad_aid.3 \
mifare_desfire_key.3 mifare_desfire_3des_key_new.3 \ mifare_desfire_key.3 mifare_desfire_3des_key_new.3 \
mifare_desfire_key.3 mifare_desfire_3des_key_new_with_version.3 \ mifare_desfire_key.3 mifare_desfire_3des_key_new_with_version.3 \
mifare_desfire_key.3 mifare_desfire_3k3des_key_new.3 \
mifare_desfire_key.3 mifare_desfire_3k3des_key_new_with_version.3 \
mifare_desfire_key.3 mifare_desfire_aes_key_new.3 \
mifare_desfire_key.3 mifare_desfire_aes_key_new_with_version.3 \
mifare_desfire_key.3 mifare_desfire_des_key_new.3 \ mifare_desfire_key.3 mifare_desfire_des_key_new.3 \
mifare_desfire_key.3 mifare_desfire_des_key_new_with_version.3 \ mifare_desfire_key.3 mifare_desfire_des_key_new_with_version.3 \
mifare_desfire_key.3 mifare_desfire_key_free.3 \ mifare_desfire_key.3 mifare_desfire_key_free.3 \

View file

@ -29,6 +29,8 @@
.Nm mifare_desfire_disconnect . .Nm mifare_desfire_disconnect .
.\" .\"
.Nm mifare_desfire_authenticate , .Nm mifare_desfire_authenticate ,
.Nm mifare_desfire_authenticate_aes ,
.Nm mifare_desfire_authenticate_iso ,
.Nm mifare_desfire_change_key_settings , .Nm mifare_desfire_change_key_settings ,
.Nm mifare_desfire_get_key_settings , .Nm mifare_desfire_get_key_settings ,
.Nm mifare_desfire_change_key , .Nm mifare_desfire_change_key ,
@ -97,6 +99,10 @@ Mifare card manipulation library (libfreefare, \-lfreefare)
.Ft int .Ft int
.Fn mifare_desfire_authenticate "MifareTag tag" "uint8_t key_no" "MifareDESFireKey key" .Fn mifare_desfire_authenticate "MifareTag tag" "uint8_t key_no" "MifareDESFireKey key"
.Ft int .Ft int
.Fn mifare_desfire_authenticate_aes "MifareTag tag" "uint8_t key_no" "MifareDESFireKey key"
.Ft int
.Fn mifare_desfire_authenticate_iso "MifareTag tag" "uint8_t key_no" "MifareDESFireKey key"
.Ft int
.Fn mifare_desfire_change_key_settings "MifareTag tag" "uint8_t settings" .Fn mifare_desfire_change_key_settings "MifareTag tag" "uint8_t settings"
.Ft int .Ft int
.Fn mifare_desfire_get_key_settings "MifareTag tag" "uint8_t *settings" "uint8_t *max_keys" .Fn mifare_desfire_get_key_settings "MifareTag tag" "uint8_t *settings" "uint8_t *max_keys"
@ -245,6 +251,16 @@ on the card and the
.Vt tag . .Vt tag .
.Pp .Pp
The The
.Fn mifare_desfire_authenticate_aes
function performs an authentication using an AES
.Vt key .
.Pp
The
.Fn mifare_desfire_authenticate_iso
function performs an ISO authentication using either a 3DES or a 3K3DES
.Vt key .
.Pp
The
.Fn mifare_desfire_get_key_settings .Fn mifare_desfire_get_key_settings
function, returns the function, returns the
.Vt settings .Vt settings

View file

@ -27,8 +27,12 @@
.Sh NAME .Sh NAME
.Nm mifare_desfire_des_key_new , .Nm mifare_desfire_des_key_new ,
.Nm mifare_desfire_3des_key_new , .Nm mifare_desfire_3des_key_new ,
.Nm mifare_desfire_3k3des_key_new ,
.Nm mifare_desfire_aes_key_new ,
.Nm mifare_desfire_des_key_new_with_version , .Nm mifare_desfire_des_key_new_with_version ,
.Nm mifare_desfire_3des_key_new_with_version , .Nm mifare_desfire_3des_key_new_with_version ,
.Nm mifare_desfire_3k3des_key_new_with_version ,
.Nm mifare_desfire_aes_key_new _with_version,
.Nm mifare_desfire_key_get_version , .Nm mifare_desfire_key_get_version ,
.Nm mifare_desfire_key_set_version , .Nm mifare_desfire_key_set_version ,
.Nm mifare_desfire_key_free .Nm mifare_desfire_key_free
@ -54,9 +58,17 @@ Mifare card manipulation library (libfreefare, \-lfreefare)
.Ft MifareDESFireKey .Ft MifareDESFireKey
.Fn mifare_desfire_3des_key_new "uint8_t value[16]" .Fn mifare_desfire_3des_key_new "uint8_t value[16]"
.Ft MifareDESFireKey .Ft MifareDESFireKey
.Fn mifare_desfire_3k3des_key_new "uint8_t value[24]"
.Ft MifareDESFireKey
.Fn mifare_desfire_aes_key_new "uint8_t value[16]"
.Ft MifareDESFireKey
.Fn mifare_desfire_des_key_new_with_version "uint8_t value[8]" .Fn mifare_desfire_des_key_new_with_version "uint8_t value[8]"
.Ft MifareDESFireKey .Ft MifareDESFireKey
.Fn mifare_desfire_3des_key_new_with_version "uint8_t value[16]" .Fn mifare_desfire_3des_key_new_with_version "uint8_t value[16]"
.Ft MifareDESFireKey
.Fn mifare_desfire_3k3des_key_new_with_version "uint8_t value[24]"
.Ft MifareDESFireKey
.Fn mifare_desfire_aes_key_new_with_version "uint8_t value[16]" "uint8_t version"
.Ft uint8_t .Ft uint8_t
.Fn mifare_desfire_key_get_version "MifareDESFireKey key" .Fn mifare_desfire_key_get_version "MifareDESFireKey key"
.Ft void .Ft void
@ -75,24 +87,28 @@ The
family of functions allows management of Mifare DESFire keys. family of functions allows management of Mifare DESFire keys.
.Pp .Pp
The The
.Fn mifare_desfire_des_key_new .Fn mifare_desfire_des_key_new ,
.Fn mifare_desfire_3des_key_new ,
.Fn mifare_desfire_3k3des_key_new
and and
.Fn mifare_desfire_3des_key_new .Fn mifare_desfire_ades_key_new
alocate a new key with the provided data alocate a new key with the provided data
.Va value . .Va value .
The key version is set to The key version is set to
.Va 0 . .Va 0 .
.Pp .Pp
The The
.Fn mifare_desfire_des_key_new_with_version .Fn mifare_desfire_des_key_new_with_version ,
.Fn mifare_desfire_3des_key_new_with_version ,
.Fn mifare_desfire_3k3des_key_new_with_version
and and
.Fn mifare_desfire_3des_key_new_with_version .Fn mifare_desfire_aes_key_new_with_version
functions are equivalent to the functions are equivalent to the previous functions except that the key version
.Fn mifare_desfire_des_key_new is read from
and .Va value
.Fn mifare_desfire_3des_key_new (DES, 3DES, 3K3DES) or set to
functions except that the key version is set to .Va version
.Va version . (AES).
.Pp .Pp
The version of a The version of a
.Vt MifareDESFireKey .Vt MifareDESFireKey