nfc-mfclassic.1 2.99 KB
Newer Older
1
.TH nfc-mfclassic 1 "Nov 02, 2009" "libnfc" "NFC Utilities"
2
.SH NAME
3
nfc-mfclassic \- MIFARE Classic command line tool
4
.SH SYNOPSIS
5
.B nfc-mfclassic
6
.RI \fR\fBf\fR|\fR\fBr\fR|\fR\fBR\fR|\fBw\fR\fR|\fBW\fR
7
.RI \fR\fBa\fR|\fR\fBA\fR|\fBb\fR\fR|\fBB\fR
8
.IR DUMP
9 10 11 12
.RI [
.IR KEYS
.RI [\fR\fBf\fR]
.RI ]
13 14

.SH DESCRIPTION
15 16
.B nfc-mfclassic
is a MIFARE Classic tool that allow to read or write
17
.IR DUMP
18
file using MIFARE keys provided in 
19 20 21
.IR KEYS
file.

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

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

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

33 34 35 36
The
.B f
option to format the card will reset all keys to FFFFFFFFFFFF, all data to 00 and all ACLs to default.

37 38 39
The
.B W
option allows writing of special MIFARE cards that can be 'unlocked' to allow block 0
40 41 42
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.

43 44 45
Similarly, the
.B R
option allows an 'unlocked' read. This bypasses authentication and allows
46 47
reading of the Key A and Key B data regardless of ACLs.

48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63
R/W errors on some blocks can be either considered as critical or ignored.
To halt on first error, specify keys with lowercase (
.B a
or
.B b
). To ignore such errors, use uppercase (
.B A
or
.B B
).

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

65
.SH OPTIONS
66
.TP
67 68 69 70
.BR f " | " r " | " R " | " w " | " W
Perform format (
.B f
) or read from (
71
.B r
72 73
) or unlocked read from (
.B R
74 75
) or write to (
.B w
76
) or unlocked write to (
77
.B W
78
) card.
79
.TP
80
.BR a " | " A " | " b " | " B
81
Use A or B MIFARE keys.
82 83 84 85 86 87 88 89 90 91
Halt on errors (
.B a
|
.B b
) or tolerate errors (
.B A
|
.B
B
).
92 93
.TP
.IR DUMP
94 95 96
MiFare Dump (MFD) used to write (card to MFD) or (MFD to card)
.TP
.IR KEYS
97
MiFare Dump (MFD) that contains the keys (optional). Data part of the dump is ignored.
98 99 100 101 102
.TP
.B f
Force using the keyfile
.IR KEYS
even if UID does not match (optional).
103 104 105 106

.SH BUGS
Please report any bugs on the
.B libnfc
107 108 109
issue tracker at:
.br
.BR http://code.google.com/p/libnfc/issues
110 111
.SH LICENCE
.B libnfc
112 113 114
is licensed under the GNU Lesser General Public License (LGPL), version 3.
.br
.B libnfc-utils
115
and
116
.B libnfc-examples
117 118
are covered by the the BSD 2-Clause license.

119
.SH AUTHORS
120 121 122 123 124 125 126
Adam Laurie <adam@algroup.co.uk>, 
.br
Roel Verdult <roel@libnfc.org>, 
.br
Romain Tartière <romain@libnfc.org>, 
.br
Romuald Conty <romuald@libnfc.org>.
127
.PP
Romuald Conty's avatar
Romuald Conty committed
128
This manual page was written by Romuald Conty <romuald@libnfc.org>.
129
It is licensed under the terms of the GNU GPL (version 2 or later).