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

  
 
  

home | help
MIFARE_APPLICATION(3)	     Library Functions Manual	   MIFARE_APPLICATION(3)

NAME
     mifare_application_alloc, mifare_application_find, mifare_application_free,
     mifare_application_read,  mifare_application_write  --  Mifare Applications
     Manipulation Functions

LIBRARY
     Mifare card manipulation library (libfreefare, -lfreefare)

SYNOPSIS
     #include <freefare.h>

     MifareClassicSectorNumber *
     mifare_application_alloc(Mad mad, MadAid aid, size_t size);

     void
     mifare_application_free(Mad mad, MadAid aid);

     MifareClassicSectorNumber *
     mifare_application_find(Mad mad, MadAid aid);

     ssize_t
     mifare_application_read(MifareTag tag, Mad mad, MadAid aid, void *buf,
	 size_t nbytes, MifareClassicKey key, MifareClassicKeyType key_type);

     ssize_t
     mifare_application_write(MifareTag tag, Mad mad, MadAid aid,
	 const void *buf, size_t nbytes, MifareClassicKey key,
	 MifareClassicKeyType key_type);

DESCRIPTION
     The mifare_application_*() functions facilitate management of  applications
     in a Mifare Application Directory.

     The  mifare_application_alloc() function allocates enought sectors to store
     size bytes for the Application Identifier aid and returns the list of allo-
     cated sectors.

     The list of the sectors previously allocated for aid in a mad  can  be  re-
     quested using mifare_application_find().

     An application can be removed from a mad using mifare_application_free().

     The mifare_application_read() reads at most nbytes of the application iden-
     tified  by  aid  in the mad on the tag and copy them into buf. The function
     returns the amount of data it copied, or -1 on error.

     The mifare_application_write() functions writes at most nbytes  of  buf  in
     the  application  identified  by  aid on the mad of the tag and returns the
     quantity of data written, or -1 on error.

IMPLEMENTATION NOTES
     The mifare_application_alloc() function will try to avoid wasting space and
     might not allocate sectors sequentially if a large amount of space  is  re-
     quested and the target has sectors of different size.

     The   nbytes  argument  of  mifare_application_read()  and  mifare_applica-
     tion_write() does not need to be aligned on blocks not sectors.

RETURN VALUES
     Unless stated otherwise, all functions return a value greater than or equal
     to 0 on success or -1 on failure.

SEE ALSO
     mad(3), mifare_classic(3)

AUTHORS
     Romain Tartiere <romain@blogreen.org>
     Romuald Conty <romuald@libnfc.org>

FreeBSD ports 15.quarterly	 March 30, 2010 	   MIFARE_APPLICATION(3)

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

home | help