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

FreeBSD Manual Pages

  
 
  

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 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
       requested 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
       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 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
       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.0		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_free&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help