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

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

       --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.34.0 (sequoia-openpgp 1.19.0)

Sequoia PGP                                          0.34.0                                                SQ(1)