sq-key-userid-add - Man Page
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)