sq-key-userid-add1
Add a user id
Usage
sq key
userid
add
[OPTIONS]
Overview
Add a user ID.
A user ID can contain a name, like `Juliet`, or an email address, like `<[email protected]>`. Historically, a name and an email address were usually combined as a single user ID, like `Juliet <[email protected]>`. However, user IDs that include different information such as name and email address are more difficult to reason about, so using distinct user IDs for name and email address is preferred nowadays.
`sq key 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
-
--allow-non-canonical-userids -
Don't reject user IDs that are not in canonical form
-
Canonical user IDs are of the form `Name (Comment) <[email protected]>`.
-
--cert=FINGERPRINT|KEYID -
Add the user ID to the key with the specified fingerprint or key ID
-
--cert-email=EMAIL -
Add the user ID to the key where a user ID includes the specified email address
-
--cert-file=PATH -
Add the user ID to the key read from PATH
-
--cert-userid=USERID -
Add the user ID to the key with the specified user ID
-
--email=ADDRESS -
Add an email address as user ID to the key
-
--name=NAME -
Add a name as user ID to the key
-
--output=FILE -
Write to the specified FILE
-
If not specified, and the certificate was read from the certificate store, imports the modified certificate into the cert store. If not specified, and the certificate was read from a file, writes the modified certificate to stdout.
-
--userid=USERID -
Add a user ID to the key
-
This user ID can combine name and email address, can optionally contain a comment, or even be free-form if `--allow-non-canonical-userids` is given. However, user IDs that include different information such as name and email address are more difficult to reason about, so using distinct user IDs for name and email address is preferred nowadays.
-
In doubt, prefer `--name` and `--email`.
Global options
See sq(1) for a description of the global options.
Examples
# Add a new user ID to Alice's key.
sq key userid add --cert \ EB28F26E2739A4870ECC47726F0073F60FD0CBF0 --name Alice \ --email [email protected]
Version
1.4.1
Releases
3 releases since Debian 12 (Bookworm); the text changed 2 times.
--allow-non-canonical-userids since Debian 13 (Trixie);
--cert since Debian 13 (Trixie);
--cert-email since Debian 13 (Trixie);
--cert-file since Debian 13 (Trixie);
--cert-userid since Debian 13 (Trixie);
--email since Debian 13 (Trixie);
--name since Debian 13 (Trixie).
--binary until Debian 12 (Bookworm);
--creation-time until Debian 12 (Bookworm);
--help until Debian 12 (Bookworm);
--private-key-store until Debian 12 (Bookworm);
-B until Debian 12 (Bookworm);
-h until Debian 12 (Bookworm);
-o until Debian 12 (Bookworm);
-u until Debian 12 (Bookworm).