hull keyring list

Synopsis

hull keyring list (alias hull keyring ls) prints every public key installed in ~/.config/hull/keyring/, showing each key’s fingerprint and file name. These are the signers hull trusts for --verify operations.

When to use it

  • To audit which signers are trusted on this machine.
  • To find the fingerprint or filename to pass to hull keyring remove.
  • To confirm a hull keyring add succeeded.

What happens

  1. Reads ~/.config/hull/keyring/, creating it empty if it does not exist.
  2. If the directory holds no keys, prints No keys installed. and stops.
  3. Otherwise prints a FINGERPRINT / FILE table, one row per key. A key file hull cannot parse shows its fingerprint as (unreadable).
  4. Reads only local files — no cluster, no network.

Usage

hull keyring list [flags]

Flags

Inherits the global flags.

Worked example

INPUT — a keyring with one key already added:

hull keyring add ./jane.pub

List the trusted keys:

hull keyring list

OUTPUT — the fingerprint and file name of each key:

FINGERPRINT                                  FILE
3AA5C34371567BD2                             jane.pub

On a fresh machine with nothing added yet, the same command prints:

No keys installed.

See also