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

FreeBSD Manual Pages

  
 
  

home | help
nfc-mfclassic(1)		 NFC Utilities		      nfc-mfclassic(1)

NAME
       nfc-mfclassic - MIFARE Classic command line tool

SYNOPSIS
       nfc-mfclassic f|r|R|w|W a|A|b|B u|U<uid>	DUMP [ KEYS [f]	]

DESCRIPTION
       nfc-mfclassic is	a MIFARE Classic tool that allow to read or write DUMP
       file using MIFARE keys provided in KEYS file.

       MIFARE Classic tag is one of the	most widely used RFID tags.

       The firmware in the NFC controller supports authenticating, reading and
       writing	to/from	 MIFARE	Classic	tags. This tool	demonstrates the speed
       of this library and its ease-of-use. It's possible to  read  and	 write
       the  complete  content  of a MIFARE Classic 4KB tag within 1 second. It
       uses a binary MIFARE Dump file (MFD) to store the keys and data for all
       sectors.

       Be cautious that	some parts of a	MIFARE Classic memory are used for r/w
       access of the rest of the memory, so please read	the tag	 documentation
       before experimenting too	much!

       The  f  option  to format the card will reset all keys to FFFFFFFFFFFF,
       all data	to 00 and all ACLs to default.

       The W option allows writing of special MIFARE cards that	 can  be  'un-
       locked' to allow	block 0	to be overwritten. This	includes UID and manu-
       facturer	data. Take care	when amending UIDs to set the correct BCC (UID
       checksum). Currently only 4 byte	UIDs are supported.

       Similarly,  the	R  option allows an 'unlocked' read. This bypasses au-
       thentication and	allows reading of the Key A and	Key B data  regardless
       of ACLs.

       R/W  errors  on some blocks can be either considered as critical	or ig-
       nored.  To halt on first	error, specify keys with lowercase ( a or b ).
       To ignore such errors, use uppercase ( A	or B ).

       When using multiple tags	infront	of a reader, the U option can be  used
       to  supply the UID of tag to be read or written.	Append the hexadecimal
       UID to the U option. For	example	U01ab23cd for the 4 byte UID 0x01 0xab
       0x23 0xcd. Using	the u parameter	instead	will use whatever  libnfc  de-
       cides which generally is	the lowest UID.

       ***  Note  that W and R options only work on special versions of	MIFARE
       1K cards	(Chinese clones).

OPTIONS
       f | r | R | w | W
	      Perform format ( f ) or read from	( r ) or unlocked read from  (
	      R	) or write to (	w ) or unlocked	write to ( W ) card.

       a | A | b | B
	      Use  A  or  B MIFARE keys.  Halt on errors ( a | b ) or tolerate
	      errors ( A | B ).

       u | U  Use the default UID ( u )	or supply a valid 4 byte UID (	U<uid>
	      ).

       DUMP   MiFare Dump (MFD)	used to	write (card to MFD) or (MFD to card)

       KEYS   MiFare  Dump  (MFD) that contains	the keys (optional). Data part
	      of the dump is ignored.

       f      Force using the keyfile KEYS even	if UID	does  not  match  (op-
	      tional).

BUGS
       Please report any bugs on the libnfc issue tracker at:
       https://github.com/nfc-tools/libnfc/issues

LICENCE
       libnfc  is licensed under the GNU Lesser	General	Public License (LGPL),
       version 3.
       libnfc-utils and	libnfc-examples	are covered by the  the	 BSD  2-Clause
       license.

AUTHORS
       Adam Laurie <adam@algroup.co.uk>,
       Roel Verdult <roel@libnfc.org>,
       Romain Tartire <romain@libnfc.org>,
       Romuald Conty <romuald@libnfc.org>.

       This manual page	was written by Romuald Conty <romuald@libnfc.org>.  It
       is licensed under the terms of the GNU GPL (version 2 or	later).

libnfc				 Nov 02, 2009		      nfc-mfclassic(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=nfc-mfclassic&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help