SQ(1)                            User Commands                           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.35.0 (sequoia-openpgp 1.20.0)

Sequoia PGP                         0.35.0                               SQ(1)