GOID-TOOL(1)

📦
version 0.27.1 · 17 versions
, in fedora 43, fedora 44

💖 GOID-TOOL(1) — the OpenSC Tools glow-up 💖

okay bestie, welcome to the goid-tool manual page, section 1 of the OpenSC Tools collection. this is your girl's guide to talking to a GoID fingerprint card from the command line, and yes, she is that girl. 🫶

✨ NAME ✨

goid-tool — a smart card utility for the GoID fingerprint card. it's giving "little tool, big responsibilities." 💅

✨ SYNOPSIS ✨

goid-tool [OPTIONS] [mode]

✨ DESCRIPTION ✨

so the way that goid-tool works is: you run it from the command line, and it reads and writes data on the GoID fingerprint card<sup>[1]</sup>. that's it, that's the whole vibe. she reads, she writes, she slays. 💖

✨ OPTIONS ✨

  • --help, -h — prints the help message right on your screen. no cap, it's right there. 🌸
  • --version, -V — prints the OpenSC package release version. iykyk. ✨
  • --reader string, -r string — pick which reader to use, by number. default behavior? the first reader that actually has a card present gets chosen. and plot twist: if the argument is an ATR, then the reader with a matching card gets picked instead. iconic. 👑
  • --verbose, -v — makes goid-tool more verbose. use it multiple times to be even MORE verbose. layer it like perfume bestie, the info just keeps coming. 😭
  • --verify-pin, -p — verify PIN. 🔥
  • --verify-bio, -b — verify finger print. 🦋
  • --verify-pin-or-bio — verify PIN or finger print, the user's choice. main character energy, you decide. ✨

🎀 OPTIONS FOR SOCMANAGER APPLET 🎀

  • --new-pin — change PIN. 💅
  • --new-bio — use this (several times) to change one or more biometric templates. one at a time, bestie, we're not rushing. 🌸
  • --info — dumps information about the SoCManager's configuration. it's giving full lore drop. 📖

🌈 OPTIONS FOR PACCESS APPLET 🌈

  • --certificate filename, -c filename — use it (several times) to pass CV certificates. stack 'em up. 💜
  • --key, -k, — private key for the CV certificate. 🔐
  • --print-cardid — prints the card ID. ✨
  • --write-cardid data — writes the specified card ID. 💫
  • --print-paccessid — prints the PAccess ID. 🦋
  • --write-paccessid data — writes the specified PAccess ID. 💫
  • --read-dg id — reads the specified data group; use it several times to read out multiple files. 🍓
  • --out-file filename — writes output to a file instead of printing it; use it once for each use of --read-dg. 🌸
  • --write-dg id — writes the specified data group; use it several times to write multiple files. 🍓
  • --in-file filename — reads input from a file; use it once for each use of --write-dg. 🌸
  • --delete-dg id — deletes the specified data group; use it several times to delete multiple files. 💀
  • --create-dg id — creates the specified data group; use it several times to create multiple files. 🌱
  • --new-size size — file size of newly created DGs. 📏
  • --new-read-ac condition — access condition for reading newly created DGs. 🔍
  • --new-read-ac condition — access condition for reading newly created DGs. 🔍 (yes bestie, she's listed twice in the original — i don't make the rules, i just report them, no cap 🫶)
  • --new-read-ac-chatbit index — required access bit in the certificate's CHAT for reading newly created DGs. 🎫
  • --new-write-ac condition — access condition for writing newly created DGs. ✍️
  • --new-write-ac-chatbit index — required access bit in the certificate's CHAT for writing newly created DGs. 🎫

✨ SEE ALSO ✨

opensc.conf(5) — go read that one too, it's the sister page. 💖

✨ AUTHORS ✨

goid-tool was written by Frank Morgner <frankmorgner@gmail.com>. thank you for your service king 👑✨

✨ NOTES ✨

  1. GoID fingerprint card — https://github.com/OpenSC/OpenSC/wiki/GoID-fingerprint-card 🦋

okay that's the whole page, bestie, you're fully caught up 💅 and just so you know, this came to you from opensc, dated 04/19/2026. go forth and read those data groups. periodt. 💖✨🎀

📦 where this page comes from