oct(1)

📦
version 0.11.13 · 2 versions
, in arch rolling, nixpkgs unstable

🐙 oct(1) — bestie's guide to OpenPGP cards 💳✨

okay so welcome to oct(1), straight out of the General Commands Manual section — like, that's the manual this page lives in, iykyk. no cap, this is the tool you want when you're inspecting, configuring and using OpenPGP cards. let's get into it 🫶

✨ SYNOPSIS ✨

oct [--output-format] [--output-version] [-h|--help] [-V|--version]
<subcommands>

that's the whole shape of it — some flags, then a subcommand, and the subcommands are where the real main character energy lives. 💅

🌸 DESCRIPTION 🌸

A tool for inspecting, configuring and using OpenPGP cards.

literally that's the whole pitch, and honestly? it ate. 🎀

💅 OPTIONS 💅

  • --output-format <OUTPUT_FORMAT> [default: text] — produce output in the chosen format. the possible values are, and I need you to remember these exactly:
    • json
    • text
    • yaml
  • --output-version <OUTPUT_VERSION> [default: 0.11.0] — pick which output version to use. heads up though, this one's for the non-textual formats only, so don't come for it when you're in plain text mode. 😌
  • -h, --help — print help. the classic. the icon. 🫶
  • -V, --version — print version. 🏷️

🦋 SUBCOMMANDS 🦋

okay so this is the juicy part, each of these has its own manpage, so like, go read those for the deep lore 👑

  • oct-list(1) — enumerate available OpenPGP cards. like a vibe check but for cards, it tells you who's in the room ✨
  • oct-status(1) — show information about the data on a card. what's on there, bestie? 👀
  • oct-info(1) — show technical details about a card. the nerdy deep-dive, we love her 🧚
  • oct-ssh(1) — show a card's authentication key as an SSH public key. yes, that kind of SSH, slay 🔑
  • oct-pubkey(1) — export the key data on a card as an OpenPGP public key. sharing is caring 💖
  • oct-admin(1) — administer data on a card (including keys and metadata). this is the whole backstage pass 🎟️
  • oct-pin(1) — PIN management (change PINs, reset blocked PINs). forgot it? blocked? she can fix that 🙈
  • oct-decrypt(1) — decrypt data using a card. 🔓
  • oct-sign(1) — sign data using a card. ✍️ periodt
  • oct-attestation(1) — attestation management. Yubico only, and I'm not being cute about that, it's literally Yubico only ⚠️
  • oct-system(1) — initialization and similar functionality. the "let's set things up" girlie 🛠️
  • oct-output-versions(1) — show supported output format versions. so you know what's valid before you pick one 🌈
  • oct-help(1) — print this message or the help of the given subcommand(s). the helpful one, honestly iconic 😭

🌟 VERSION 🌟

v0.11.13

👑 AUTHORS 👑

Heiko Schaefer <heiko@schaefer.name> — thank you for your service, king 🫡

ngl, the flags are simple but the subcommands are the whole personality. read the individual manpages, don't guess, and you'll be fine 💀

and that's the page, bestie! 🎀 this whole thing comes to you from oct version 0.11.13 — so if something acts different on another version, that's between you and that version, fr fr. bye, love u, go inspect some cards 💜🌈✨

📦 where this page comes from