SQ(1)

NAME
sq key userid add - Adds a User ID

SYNOPSIS
sq [GLOBAL OPTIONS] key userid add [OPTIONS] FILE

DESCRIPTION
Adds a User ID.

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>".

"sq userid add" respects the reference time set by the top-level "--time" argument. It sets the creation time of the User ID's binding signature to the specified time.

OPTIONS

  Global options

--cert-store=PATH
    Specifies the location of the certificate store

-f, --force=FORCE
    Overwrites existing files

--keyring=PATH
    Specifies the location of a keyring to use

--known-notation=NOTATION
    Adds NOTATION to the list of known notations

--no-cert-store=NO_CERT_STORE
    Disables the use of a certificate store

--output-format=FORMAT
    Produces output in FORMAT, if possible

--output-version=VERSION
    Produces output variant VERSION.

--pep-cert-store=PATH
    Specifies the location of a pEp certificate store

--time=TIME
    Sets the reference time as ISO 8601 formatted timestamp

--trust-root=FINGERPRINT|KEYID
    Considers the specified certificate to be a trust root

  Subcommand options

-B, --binary=BINARY
    Emits binary data

-o, --output=FILE
    Writes to FILE or stdout if omitted

--private-key-store=KEY_STORE
    Provides parameters for private key store

-u, --userid=USERID
    User ID to add

EXAMPLES

First, this generates a key

    sq key generate --userid "<juliet@example.org>" --output juliet.key.pgp

Then, this adds a User ID

    sq key userid add --userid "Juliet" juliet.key.pgp \

  --output juliet-new.key.pgp

This adds a User ID whose creation time is set to June 28, 2022 at

midnight UTC:

    sq key userid add --userid "Juliet" --creation-time 20210628 \

   juliet.key.pgp --output juliet-new.key.pgp

SEE ALSO
sq(1).

For the full documentation see <https://docs.sequoia-pgp.org/sq/>.

VERSION
0.31.0 (sequoia-openpgp 1.16.0, using Nettle 3.9 (Cv448: true))