NAME

     mifare_desfire_des_key_new, mifare_desfire_3des_key_new, mifare_desfire_3k3des_key_new,
     mifare_desfire_aes_key_new, mifare_desfire_des_key_new_with_version,
     mifare_desfire_3des_key_new_with_version, mifare_desfire_3k3des_key_new_with_version,
     mifare_desfire_aes_key_new _with_version, mifare_desfire_key_get_version,
     mifare_desfire_key_set_version, mifare_desfire_key_free — Mifare DESFire keys Manipulation
     Functions

LIBRARY

     Mifare card manipulation library (libfreefare, -lfreefare)

SYNOPSIS

     #include <freefare.h>

     MifareDESFireKey
     mifare_desfire_des_key_new(uint8_t value[8]);

     MifareDESFireKey
     mifare_desfire_3des_key_new(uint8_t value[16]);

     MifareDESFireKey
     mifare_desfire_3k3des_key_new(uint8_t value[24]);

     MifareDESFireKey
     mifare_desfire_aes_key_new(uint8_t value[16]);

     MifareDESFireKey
     mifare_desfire_des_key_new_with_version(uint8_t value[8]);

     MifareDESFireKey
     mifare_desfire_3des_key_new_with_version(uint8_t value[16]);

     MifareDESFireKey
     mifare_desfire_3k3des_key_new_with_version(uint8_t value[24]);

     MifareDESFireKey
     mifare_desfire_aes_key_new_with_version(uint8_t value[16], uint8_t version);

     uint8_t
     mifare_desfire_key_get_version(MifareDESFireKey key);

     void
     mifare_desfire_key_set_version(MifareDESFireKey key, uint8_t version);

     void
     mifare_desfire_key_free(MifareDESFireKey key);

DESCRIPTION

     The mifare_desfire_key_*() family of functions allows management of Mifare DESFire keys.

     The mifare_desfire_des_key_new(), mifare_desfire_3des_key_new(),
     mifare_desfire_3k3des_key_new() and mifare_desfire_ades_key_new() alocate a new key with the
     provided data value.  The key version is set to 0.

     The mifare_desfire_des_key_new_with_version(), mifare_desfire_3des_key_new_with_version(),
     mifare_desfire_3k3des_key_new_with_version() and mifare_desfire_aes_key_new_with_version()
     functions are equivalent to the previous functions except that the key version is read from
     value (DES, 3DES, 3K3DES) or set to version (AES).

     The version of a MifareDESFireKey can be extracted using mifare_desfire_key_get_version()
     and changed using mifare_desfire_key_set_version.()

     The mifare_desfire_key_free() has to be called for each MifareDESFireKey after usage to
     reclaim memory.

RETURN VALUES

     Key allocations functions return the allocaed key of NULL on failure.

SEE ALSO

     mifare_desfire(3)

AUTHORS

     Romain Tartiere <romain@il4p.org>