sq-key-userid-revoke - Man Page

--add-userid

Add the given user ID if it doesn't exist in the certificate.

--binary

Emit binary data

--cert=FINGERPRINT|KEYID

Revoke the user ID from the key with the specified fingerprint or key ID

--cert-email=EMAIL

Revoke the user ID from the key where a user ID includes the specified email address

--cert-file=PATH

Revoke the user ID from the key read from PATH

--cert-userid=USERID

Revoke the user ID from the key with the specified user ID

--email=ADDRESS

Revoke the given email address user ID.  Must match a user ID exactly. To revoke a user ID that contains more than just an email address name, use `--userid`.

--message=MESSAGE

A short, explanatory text.

The text is shown to a viewer of the revocation certificate, and explains why the certificate has been revoked.  For instance, if Alice has left the organization, it might say who to contact instead.

--name=NAME

Revoke the given name user ID.  Must match a user ID exactly.  To revoke a user ID that contains more than just a name, use `--userid`.

--notation NAME VALUE

Add a notation to the certification.

A user-defined notation's name must be of the form `name@a.domain.you.control.org`.  If the notation's name starts with a `!`, then the notation is marked as being critical.  If a consumer of a signature doesn't understand a critical notation, then it will ignore the signature.  The notation is marked as being human readable.

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

--reason=REASON

The reason for the revocation.

If the reason happened in the past, you should specify that using the `--time` argument.  This allows OpenPGP implementations to more accurately reason about artifacts whose validity depends on the validity of the user ID.

[possible values: retired, unspecified]

--revoker=FINGERPRINT|KEYID

Use key with the specified fingerprint or key ID to create the revocation certificate.

Sign the revocation certificate using the specified key.  By default, the certificate being revoked is used.  Using this option, it is possible to create a third-party revocation.

--revoker-email=EMAIL

Use key where a user ID includes the specified email address to create the revocation certificate.

Sign the revocation certificate using the specified key.  By default, the certificate being revoked is used.  Using this option, it is possible to create a third-party revocation.

--revoker-file=PATH

Read key from PATH to create the revocation certificate.

Sign the revocation certificate using the specified key.  By default, the certificate being revoked is used.  Using this option, it is possible to create a third-party revocation.

--revoker-userid=USERID

Use key with the specified user ID to create the revocation certificate.

Sign the revocation certificate using the specified key.  By default, the certificate being revoked is used.  Using this option, it is possible to create a third-party revocation.

--userid=USERID

Revoke the given user ID.

By default, this must exactly match a self-signed User ID.  Use `--add-userid` to generate a revocation certificate for a User ID that is not self signed.

See sq(1) for a description of the global options.