voa-import1
Import a single verifier into a voa hierarchy.
Usage
voa import
[{-c | --context}]
[{-v | --verbose}] ...
[{-i | --input}]
[{-q | --quiet}] ...
[{-b | --base-path}]
[{-r | --runtime}]
[{-h | --help}]
<OS>
<PURPOSE>
<TECHNOLOGY>
Overview
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.
Options
-
-c, --context <CONTEXT> -
The context to import for.
If not specified, defaults to "default".
May also be specified with the
VOA_IMPORT_CONTEXTenvironment 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_INPUTenvironment 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_PATHenvironment 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_RUNTIMEenvironment variable.
-
-h, --help -
Print help (see a summary with '-h')
- <OS>
-
The OS to import for.
May also be specified with the
VOA_IMPORT_OSenvironment variable.
- <PURPOSE>
-
The purpose to import for.
May also be specified with the
VOA_IMPORT_PURPOSEenvironment variable.
- <TECHNOLOGY>
-
The technology to import for.
Currently only "openpgp" is supported.
May also be specified with the
VOA_IMPORT_TECHNOLOGYenvironment variable.