YB-LIST(1)

🌸 NAME: list — List blobs (alias: ls) 🌸

okay so bestie, this is the YB-LIST(1) page from the User Commands section. It's literally about list, and yeah, it has a cute alias: ls. We're listing blobs here. Slay. 💅

✨ SYNOPSIS ✨

list [-l|--long] [-1 ] [-t|--sort-time] [-r|--reverse] [-h|--help]
[PATTERN]

💖 DESCRIPTION 💖

So what does it do? It lists the names of all the blobs currently stored on the YubiKey. Iconic. You can optionally pass a glob pattern to filter the output — vibe check for blob names, basically. ✨

Default output? One name per line, which is perfect for scripting. --long adds an encryption flag, chunk count, modification time, and plaintext size. The way that's useful? Obsessed. 🫶

Every blob's ECDSA signature is verified automatically — no PIN required. If a blob is CORRUPTED, the word CORRUPTED is appended to its output line and yb list exits with status 1. Unverified blobs (older yb0/yb1 format without a signature trailer) are listed normally. No cap. 💀

🎀 OPTIONS 🎀

• -l, --long — Long format: flag, chunks, date, size, name. It's giving detail overload, in the best way. 💖
• -1 — One name per line (default; explicit flag for scripting). Lowkey just here so your scripts can be extra clear. ✨
• -t, --sort-time — Sort by modification time, newest first. Fresh blobs first, periodt. 🔥
• -r, --reverse — Reverse the sort order. Flip it, reverse it, slay. 🦋
• -h, --help — Print help. Your little emergency bestie. 🫶
• [PATTERN] — Glob pattern to filter blob names (default: all). Pick your faves. 🌈

🦋 LONG FORMAT 🦋

In long format, each line contains these fields, in this order:

• Flag — - for an encrypted blob, P for a plaintext (unencrypted) blob.
• Chunks — Number of PIV objects consumed by this blob.
• Date — Modification time (month, day, time for recent blobs; year for older).
• Size — Plaintext size in bytes.
• Name — Blob name, followed by CORRUPTED if signature verification failed. Names containing characters outside the portable set a-z A-Z 0-9 . - _ + , / : are wrapped in POSIX single quotes so the marker is never ambiguous.

okay so that last bit matters: if a name has characters outside that portable set, it gets wrapped in POSIX single quotes so CORRUPTED can never be ambiguous. Cute and rigorous. 💅

🌈 EXAMPLES 🌈

List all blobs:

yb list

Long listing, newest first:

yb list -l -t

Filter by glob:

yb list '*.key'

Alert on corruption (for scripts):

yb list || echo "WARNING: store corruption detected" >&2

👑 SEE ALSO 👑

yb(1), yb-fsck(1), yb-fetch(1), yb-remove(1) — go read those too, bestie. 📚

---

okay that's literally the whole page! source/version: yb · date: 2026-03 · manual: YB-LIST(1) — mwah 💋✨