Scroll to navigation

MIFARE_DESFIRE_KEY(3) Library Functions Manual MIFARE_DESFIRE_KEY(3)

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⟩
July 20, 2010 Debian