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

  
 
  

home | help
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 tar-
     get 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 de-
     tected target will be in an  inconsistent	state  after  a  call  to  free-
     fare_get_tags().	It is the programmer's responsibility to free these tar-
     gets before calling the freefare_get_tags() function.

     Information about a  given  MifareTag  can  be  gathered  using  the  free-
     fare_get_tag_type(),	  freefare_get_tag_uid()	and	   free-
     fare_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 15.quarterly	 March 30, 2010 		     FREEFARE(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=freefare&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help