sq-pki-link-retract - Man Page
Retract links
Synopsis
sq pki link retract [Options] FINGERPRINT|KEYID USERID|EMAIL
Description
Retract links.
This command retracts links that were previously created using `sq pki link add`. See that subcommand's documentation for more details. Note: this is called `retract` and not `remove`, because the certifications are not removed. Instead a new certification is added, which says that the binding has not been authenticated.
`sq pki link retract` respects the reference time set by the top-level `--time` argument. This causes a link to be retracted as of a particular time instead of the current time.
Options
Subcommand options
- --email=email
An email address to unlink from the certificate. The email address must match a User ID with the email, although, it need not be linked.
- --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.
- --userid=USERID
A User ID to unlink from the certificate. This must match a known User ID, although it need not be linked.
- FINGERPRINT|KEYID
The certificate whose acceptance is being retracted.
- USERID|EMAIL
A User ID or email address to unlink from the certificate. This must match a known User ID. Scripts should prefer to use `--email` or `--userid`, as `sq` does not need to guess if a value is a User ID or an email address. If no User IDs, or email addresses are provided, then all known User IDs are unlinked.
Global options
See sq(1) for a description of the global options.
See Also
sq(1), sq-pki(1), sq-pki-link(1).
For the full documentation see <https://book.sequoia-pgp.org>.
Version
0.38.0 (sequoia-openpgp 1.21.2)