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 'unlocked' to allow  block
       0 to be overwritten. This includes UID and manufacturer 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 authentication 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 ignored.  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 decides 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 (optional).

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 Tartière <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).