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

FreeBSD Manual Pages

  
 
  

home | help
MIFARE_APPLICATION(3)  FreeBSD 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 applica-
     tions 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	allocated 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
     identified	by aid in the mad on the tag and copy them into	buf. The func-
     tion 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
     requested and the target has sectors of different size.

     The nbytes	argument of mifare_application_read() and
     mifare_application_write()	does not need to be aligned on blocks not sec-
     tors.

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	13.0			March 30, 2010			  FreeBSD 13.0

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

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

home | help