nfc-list(1)

✨ nfc-list — the nfc-list(1) glow-up ✨

okay bestie, welcome to the NFC Utilities corner of the manual, this is nfc-list(1) and she's here to serve 💅

🎀 NAME 🎀

nfc-list — literally just lists your NFC targets. that's the whole job. iconic behaviour.

🌸 SYNOPSIS 🌸

nfc-list [ options ]

🦋 DESCRIPTION 🦋

so nfc-list is that utility that goes and lists every available tag it can find — think ISO14443-A, FeliCa, Jewel or ISO14443-B, depending on what your device is capable of 🫶

and here's the cute part: it can detect several tags at once thanks to a little mechanism called anti-collision ✨ but ngl, not every type of tag supports anti-collision, and also there's a physical limitation on how many tags the reader can actually discover. so like… it tries, bestie. it tries.

this tool displays all available information at selection time. no notes.

💖 OPTIONS 💖

• -v — tells nfc-list to be verbose, meaning it spills the detailed tea about the targets it's showing. this includes SAK decoding, and fingerprinting is available. lowkey the fun mode 🔥
• -t X — polls only for the types matching the bitfield value of X:
  1. ISO14443A
  2. Felica (212 kbps)
  3. Felica (424 kbps)
  4. ISO14443B
  5. ISO14443B'
  6. ISO14443B-2 ST SRx
  7. ISO14443B-2 ASK CTx
  8. ISO14443B iClass
  9. ISO14443A-3 Jewel
  10. ISO14443A-2 NFC Barcode

wait — the numbering up there is the list, but the actual bitfield values are these:

 1: ISO14443A
 2: Felica (212 kbps)
 4: Felica (424 kbps)
 8: ISO14443B
16: ISO14443B'
32: ISO14443B-2 ST SRx
64: ISO14443B-2 ASK CTx
128: ISO14443B iClass
256: ISO14443A-3 Jewel
512: ISO14443A-2 NFC Barcode

so 1023 (the default) polls for all types. queen of doing everything at once 👑

⚠️ heads up bestie: if you pick 16, 32, 64 or 128, then 8 gets selected too. they come as a package deal, no cap.

🌈 EXAMPLE 🌈

for an ISO/IEC 14443-A tag (i.e. Mifare DESFire):

    ATQA (SENS_RES): 03  44
       UID (NFCID1): 04  45  35  01  db  24  80
      SAK (SEL_RES): 20
          ATS (ATR): 75  77  81  02  80

look at that output. immaculate. ✨

💀 BUGS 💀

please report any bugs on the libnfc issue tracker at:

https://github.com/nfc-tools/libnfc/issues

(be nice about it, the devs are people too 🙈)

🎀 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.

yes, "the the". we're keeping it exactly as written, periodt. 💅

👑 AUTHORS 👑

• 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).

and that's the whole vibe check, bestie 🫶 this page came from the libnfc era and is dated June 26, 2009 — yeah she's an elder but she still ate 💖 go list some tags, you got this 🌸