.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH SQ 1 0.31.0 Sequoia-PGP "User Commands"
.SH NAME
sq key userid add \- Adds a User ID
.SH SYNOPSIS
.br
\fBsq\fR [\fIGLOBAL OPTIONS\fR] \fBkey userid add\fR [\fIOPTIONS\fR] \fIFILE\fR
.SH DESCRIPTION
Adds a User ID.
.PP
A User ID can contain a name, like "Juliet" or an email address, like
"<juliet@example.org>".  Historically, a name and email address were often
combined as a single User ID, like "Juliet <juliet@example.org>".
.PP
"sq userid add" respects the reference time set by the top\-level
"\-\-time" argument.  It sets the creation time of the User ID\*(Aqs
binding signature to the specified time.
.PP


.SH OPTIONS
.SS "Global options"
.TP
\fB\-\-cert\-store\fR=\fIPATH\fR
Specifies the location of the certificate store
.TP
\fB\-f\fR, \fB\-\-force\fR=\fIFORCE\fR
Overwrites existing files
.TP
\fB\-\-keyring\fR=\fIPATH\fR
Specifies the location of a keyring to use
.TP
\fB\-\-known\-notation\fR=\fINOTATION\fR
Adds NOTATION to the list of known notations
.TP
\fB\-\-no\-cert\-store\fR=\fINO_CERT_STORE\fR
Disables the use of a certificate store
.TP
\fB\-\-output\-format\fR=\fIFORMAT\fR
Produces output in FORMAT, if possible
.TP
\fB\-\-output\-version\fR=\fIVERSION\fR
Produces output variant VERSION.
.TP
\fB\-\-pep\-cert\-store\fR=\fIPATH\fR
Specifies the location of a pEp certificate store
.TP
\fB\-\-time\fR=\fITIME\fR
Sets the reference time as ISO 8601 formatted timestamp
.TP
\fB\-\-trust\-root\fR=\fIFINGERPRINT|KEYID\fR
Considers the specified certificate to be a trust root
.SS "Subcommand options"
.TP
\fB\-B\fR, \fB\-\-binary\fR=\fIBINARY\fR
Emits binary data
.TP
\fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR
Writes to FILE or stdout if omitted
.TP
\fB\-\-private\-key\-store\fR=\fIKEY_STORE\fR
Provides parameters for private key store
.TP
\fB\-u\fR, \fB\-\-userid\fR=\fIUSERID\fR
User ID to add
.SH EXAMPLES
.PP

.PP
First, this generates a key
.PP
.nf
.RS
sq key generate \-\-userid "<juliet@example.org>" \-\-output juliet.key.pgp
.RE
.fi
.PP

.PP
Then, this adds a User ID
.PP
.nf
.RS
sq key userid add \-\-userid "Juliet" juliet.key.pgp \\
.RE
.fi
.PP
  \-\-output juliet\-new.key.pgp
.PP

.PP
This adds a User ID whose creation time is set to June 28, 2022 at
.PP
midnight UTC:
.PP
.nf
.RS
sq key userid add \-\-userid "Juliet" \-\-creation\-time 20210628 \\
.RE
.fi
.PP
   juliet.key.pgp \-\-output juliet\-new.key.pgp
.SH "SEE ALSO"
.nh
\fBsq\fR(1).
.hy
.PP
For the full documentation see <https://docs.sequoia\-pgp.org/sq/>.
.SH VERSION
0.31.0 (sequoia\-openpgp 1.16.0, using Nettle 3.9 (Cv448: true))
