table of contents
FREEFARE(3) | Library Functions Manual | FREEFARE(3) |
NAME¶
freefare_get_tags
,
freefare_get_tag_type
,
freefare_get_tag_friendly_name
,
freefare_get_tag_uid
,
freefare_free_tag
,
freefare_free_tags
—
Generic target manipulation functions
LIBRARY¶
Mifare card manipulation library (libfreefare, -lfreefare)SYNOPSIS¶
#include
<freefare.h>
MifareTag *
freefare_get_tags
(nfc_device_t
*device);
enum mifare_tag_type { ULTRALIGHT, CLASSIC_1K, CLASSIC_4K };
enum mifare_tag_type
freefare_get_tag_type
(MifareTag
tag);
const char *
freefare_get_tag_friendly_name
(MifareTag
tag);
char *
freefare_get_tag_uid
(MifareTag
tag);
void
freefare_free_tag
(MifareTag
tags);
void
freefare_free_tags
(MifareTag
*tags);
DESCRIPTION¶
Thefreefare_*
() family of functions allow
agnostic access to the MifareTag present on a
given NFC device.
freefare_get_tags
() returns a NULL-terminated
list of MifareTag present on
device. This list has to be freed after usage
by either:
- calling the
freefare_free_tags
() function. All tags in the list are automatically freed; - calling the
freefare_free_tag
() function to free each tag in the list individually, and freeing the list itself using thefree
() function.
freefare_get_tags
(). It is the programmer's
responsibility to free these targets before calling the
freefare_get_tags
() function.
Information about a given MifareTag can be
gathered using the freefare_get_tag_type
(),
freefare_get_tag_uid
() and
freefare_get_tag_friendly_name
() functions.
RETURN VALUES¶
Unless stated otherwise, all functions return a value greater than or equal to 0 on success or -1 on failure.SEE ALSO¶
free(3), mifare_classic(3), mifare_ultralight(3)AUTHORS¶
Romain Tartiere ⟨romain@blogreen.org⟩Romuald Conty ⟨romuald@libnfc.org⟩
March 30, 2010 | Debian |