GIDS-TOOL(1)

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

💖 GIDS-TOOL — the OpenSC smart card utility for GIDS cards 💖

okay bestie, gather round, because this is gids-tool from the OpenSC Tools fam and she is literally the group chat MVP for GIDS smart cards. no cap. 🫶

✨ NAME ✨

gids-tool — a smart card utility for GIDS cards 🎀

🌸 SYNOPSIS 🌸

gids-tool [OPTIONS]

so the gids-tool utility can be run straight from the command line to do a whole lil' assortment of miscellaneous smart card operations on a GIDS smart card. it's giving "swiss army knife but make it cute." 💅

👑 OPTIONS 👑

  • -X, --initialize — initialize the token. fresh start era. ✨
  • --admin-key argument — define the administrator key 🔑
  • --pin pin — this one lets you specify the PIN value right there on the command line. and listen: if the value is set to env:VARIABLE, then the value of the environment variable you named gets used instead. by default though, the code is just prompted on the command line if it's needed. 🙈
⚠️ okay real talk bestie: on most operating systems, any user can display the command line of any process on the system using utilities such as ps(1). so yeah — you should prefer passing the codes via an environment variable on an unsecured system. protect the PIN, protect the peace. 😭
  • --serial-number argument — define the serial number 🏷️
  • -U, --unblock — unblock the user PIN after an administrator authentication. let her back in!! 🦋
  • -C, --change-admin-key — change the administrator key 🔄
  • --new-admin-key argument — define the new administrator key (the glow-up key, if you will) ✨
  • --reader argument, -r argument — the number of the reader to use. by default, the first reader with a present card gets used. and plot twist: if argument is an ATR, then the reader with a matching card will be chosen. iconic behavior. 👑
  • -w, --wait — wait for a card to be inserted. patience is a vibe. ⏳
  • -v, --verbose — verbose operation. use it several times to enable debug output — yes, several, stack those -vs like friendship bracelets. 🔥

🌈 SEE ALSO 🌈

opensc-tool(1)

💜 AUTHORS 💜

gids-tool was written by Vincent Le Toux <vincent.letoux@mysmartlogon.com>. thank you king 🫡

and that's the whole page, bestie!! this one comes from the opensc source, version dated 04/19/2026 — mwah, go slay some smart card operations 💖✨🎀

📦 where this page comes from