Home / Alt manpages / vault-list(1)

  • vault-list(1)
  • User command
  • linux

See What Is Stored in a Vault with vault list

vault list prints one line per stored file with its size, modification time and name. This guide reads the output, narrows it with a prefix and explains why some records never show.

Allow about five minutes. You need a key and a vault with at least one file. Nothing is changed, and it takes only a shared lock, so it can run alongside other readers.

1. List everything

$ vault list
$ vault ls

ls is an alias. Each line has a human-readable size, the modification time in local time at minute resolution, and the name, sorted by name.

2. Narrow with a prefix

$ vault list work
$ vault list work/2026/report.pdf

A prefix that names a file shows just that file. One that names a folder shows the files under it.

3. Understand the silent skips

Records your passphrase cannot open are skipped without a word. That is by design: with the decoy passphrase you see only decoy files, and filler is never listed. An empty result can therefore mean the wrong passphrase as much as an empty vault.

Checkpoint

If a listing looks too short, confirm you typed the passphrase you meant. Nothing in the output tells you.

4. Point it elsewhere

$ vault list --vault /srv/vault --key /mnt/usb/vault.key

5. Follow up

Fetch a file with vault-get(1), rename with vault-mv(1) or delete with vault-rm(1). Shared options are in vault(1).

Done means

  • The listing matches what you expected to be stored.
  • You know an incomplete listing may mean a different passphrase, not missing data.
  • Prefixes were used to narrow output rather than filtering it with other tools.
  • The correct key and vault paths were used.