.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH voa-import 1  "voa-import " 
.SH NAME
voa\-import \- Import a single verifier into a VOA hierarchy.
.SH SYNOPSIS
\fBvoa import\fR [\fB\-c\fR|\fB\-\-context\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-i\fR|\fB\-\-input\fR] [\fB\-q\fR|\fB\-\-quiet\fR]... [\fB\-b\fR|\fB\-\-base\-path\fR] [\fB\-r\fR|\fB\-\-runtime\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIOS\fR> <\fIPURPOSE\fR> <\fITECHNOLOGY\fR> 
.SH DESCRIPTION
Import a single verifier into a VOA hierarchy.
.PP
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.
.PP
The verifier is written to the user\*(Aqs writable, persistent VOA load path, e.g.:
.PP
\- "~/.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
.PP
When using the "\-r"/"\-\-runtime" option, the verifier is written to the user\*(Aqs writable, ephemeral VOA load path instead, e.g.:
.PP
\- "/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
.PP
The verifier can be written to another, specific VOA base path using the "\-b"/"\-\-base\-path" option.
.SH OPTIONS
.TP
\fB\-c\fR, \fB\-\-context\fR \fI<CONTEXT>\fR
The context to import for.

If not specified, defaults to "default".
.RS
May also be specified with the \fBVOA_IMPORT_CONTEXT\fR environment variable. 
.RE
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Increase logging verbosity
.TP
\fB\-i\fR, \fB\-\-input\fR \fI<INPUT>\fR
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.
.RS
May also be specified with the \fBVOA_IMPORT_INPUT\fR environment variable. 
.RE
.TP
\fB\-q\fR, \fB\-\-quiet\fR
Decrease logging verbosity
.TP
\fB\-b\fR, \fB\-\-base\-path\fR \fI<BASE_PATH>\fR
The VOA base path to write to.

If not specified, the user\*(Aqs 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\*(Aqs 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
.RS
May also be specified with the \fBVOA_IMPORT_BASE_PATH\fR environment variable. 
.RE
.TP
\fB\-r\fR, \fB\-\-runtime\fR
Whether to import to the runtime directory.

Instructs the import mechanism to use the user\*(Aqs 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".
.RS
May also be specified with the \fBVOA_IMPORT_RUNTIME\fR environment variable. 
.RE
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help (see a summary with \*(Aq\-h\*(Aq)
.TP
<\fIOS\fR>
The OS to import for.
.RS
May also be specified with the \fBVOA_IMPORT_OS\fR environment variable. 
.RE
.TP
<\fIPURPOSE\fR>
The purpose to import for.
.RS
May also be specified with the \fBVOA_IMPORT_PURPOSE\fR environment variable. 
.RE
.TP
<\fITECHNOLOGY\fR>
The technology to import for.

Currently only "openpgp" is supported.
.RS
May also be specified with the \fBVOA_IMPORT_TECHNOLOGY\fR environment variable. 
.RE