voa-import(1) General Commands Manual voa-import(1)

voa-import - Import a single verifier into a VOA hierarchy.

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

Import a single verifier into a VOA hierarchy.

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.

The context to import for.

If not specified, defaults to "default".

May also be specified with the VOA_IMPORT_CONTEXT environment variable.
Increase logging verbosity
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.
Decrease logging verbosity
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.
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.
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.
voa-import