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>

Debian                                            July 20, 2010                            MIFARE_DESFIRE_KEY(3)