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) <localpart@example.org>`.

--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.