bionic (3) mifare_desfire_key_get_version.3.gz
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>