SQ(1)

NAME
sq key userid add - Add a User ID

SYNOPSIS
sq key userid add [OPTIONS] FILE USERID

DESCRIPTION
Add 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

  Subcommand options

-B, --binary
    Emit binary data

--allow-non-canonical-userids
    Don't reject user IDs that are not in canonical form. Canonical user IDs are of the form `Name (Comment) <localpart@example.org>`.

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

    [default: -]

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

FILE
    Read from FILE or stdin if FILE is '-'

USERID
    User ID to add

  Global options
See sq(1) for a description of the global options.

EXAMPLES

First, generate a key:

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

Then, add a User ID:

    sq key userid add --userid Juliet juliet.key.pgp \
        --output juliet-new.key.pgp

Or, add 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), sq-key(1), sq-key-userid(1).

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

VERSION
0.36.0 (sequoia-openpgp 1.20.0)