Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
FREEFARE(3)	       FreeBSD 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
     The freefare_*() 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 the free() function.

     Because of	the nature of the target detection process, any	previously
     detected target will be in	an inconsistent	state after a call to
     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>

FreeBSD	Ports 11.2		March 30, 2010		    FreeBSD Ports 11.2

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=freefare_get_tags&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help