voa-import(1)

📦 version 0.7.6, in arch rolling

💖 NAME — voa-import(1) from General Commands Manual 💖

okay bestie, welcome to the voa-import(1) page from the General Commands Manual. The whole main-character energy here is: voa-import — Import a single verifier into a VOA hierarchy. slay.

✨ SYNOPSIS ✨

voa import [-c|--context] [-v|--verbose]... [-i|--input] [-q|--quiet]...
[-b|--base-path] [-r|--runtime] [-h|--help] <OS> <PURPOSE> <TECHNOLOGY>

that's the whole shape of it, no cap — the ... is right there in the synopsis, iykyk.

🦋 DESCRIPTION 🦋

okay so the main character here is literally: Import a single verifier into a VOA hierarchy. periodt. By default a single verifier is expected on stdin. Using the -i/--input option a specific directory or file can be selected for import instead.

The verifier is written to the user's writable, persistent VOA load path, e.g.:

  • ~/.config/voa/: for users with uid >= 1000. Note, that voa import respects the XDG Base Directory Specification and the XDG_CONFIG_HOME environment variable. The above serves as default example.
  • /etc/voa/: for users with uid < 1000

When using the -r/--runtime option, the verifier is written to the user's writable, ephemeral VOA load path instead, e.g.:

  • /run/user/$(id -u)/voa/: for users with uid >= 1000. Note, that voa import respects the XDG Base Directory Specification and the XDG_RUNTIME_DIR environment variable. The above serves as default example.
  • /run/voa: for users with uid < 1000

The verifier can be written to another, specific VOA base path using the -b/--base-path option.

💅 OPTIONS 💅

okay bestie, here's the full menu — every flag, every arg, no skips, fr fr 🫶

  • -c, --context <CONTEXT> — The context to import for. If not specified, defaults to default. May also be specified with the VOA_IMPORT_CONTEXT environment variable.
  • -v, --verbose — Increase logging verbosity
  • -i, --input <INPUT> — The directory or file to import from. If a directory is provided and the selected technology is openpgp it must either contain:
    • OpenPGP packet files
    • or a directory structure with OpenPGP packet files, compatible with the archlinux-keyring format.

If no directory or file is provided, stdin is used instead. May also be specified with the VOA_IMPORT_INPUT environment variable.

  • -q, --quiet — Decrease logging verbosity
  • -b, --base-path <BASE_PATH> — The VOA base path to write to. If not specified, the user's writable, persistent VOA load path is chosen, e.g.:
    • ~/.config/voa/: for users with uid >= 1000
    • /etc/voa/: for users with uid < 1000

To use the user's writable, ephemeral VOA load path if no directory is provided, pass the -r/--runtime option to the command. In this case the writable, ephemeral VOA load path is chosen, e.g.:

  • /run/user/$(id -u)/voa/: for users with uid >= 1000
  • /run/voa: for users with uid < 1000

May also be specified with the VOA_IMPORT_BASE_PATH environment variable.

  • -r, --runtime — Whether to import to the runtime directory. Instructs the import mechanism to use the user's writable, ephemeral VOA load path, e.g.:
    • /run/user/$(id -u)/voa/: for users with uid >= 1000
    • /run/voa: for users with uid < 1000

By default, if this option and the -b/--base-path options are not provided, a verifier is imported to the writable, persistent VOA load path of the user, e.g.:

  • ~/.config/voa/: for users with uid >= 1000
  • /etc/voa/: for users with uid < 1000

Note, that this option cannot be selected together with -b/--base-path. May also be specified with the VOA_IMPORT_RUNTIME environment variable.

  • -h, --help — Print help (see a summary with -h)
  • <OS> — The OS to import for. May also be specified with the VOA_IMPORT_OS environment variable.
  • <PURPOSE> — The purpose to import for. May also be specified with the VOA_IMPORT_PURPOSE environment variable.
  • <TECHNOLOGY> — The technology to import for. Currently only openpgp is supported. May also be specified with the VOA_IMPORT_TECHNOLOGY environment variable.

🎀 okay that's the whole page, bestie — footer vibe check: source/manual name is voa-import, section is voa-import(1), and there's no extra version or date line to report, so we're not inventing one. periodt. 🎀

📦 where this page comes from