Manpages

NAME

sq pki link retract - 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 [AT] a.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.34.0 (sequoia-openpgp 1.19.0)