SQ(1)

NAME
sq key userid strip - Strips a User ID

SYNOPSIS
sq [GLOBAL OPTIONS] key userid strip [OPTIONS] FILE

DESCRIPTION
Strips a User ID.

Note that this operation does not reliably remove User IDs from a certificate that has already been disseminated! (OpenPGP software typically appends new information it receives about a certificate to its local copy of that certificate. Systems that have obtained a copy of your certificate with the User ID that you are trying to strip will not drop that User ID from their copy.)

In most cases, you will want to use the 'sq revoke userid' operation instead. That issues a revocation for a User ID, which can be used to mark the User ID as invalidated.

However, this operation can be useful in very specific cases, in particular: to remove a mistakenly added User ID before it has been uploaded to key servers or otherwise shared.

Stripping a User ID may change how a certificate is interpreted. This is because information about the certificate like algorithm preferences, the primary key's key flags, etc. is stored in the User ID's binding signature.

OPTIONS

  Global options

-f, --force
    Overwrites existing files

--help
    Print help information

--known-notation=NOTATION
    Adds NOTATION to the list of known notations

--output-format=FORMAT
    Produces output in FORMAT, if possible

--output-version=VERSION
    Produces output variant VERSION.

--version
    Print version information

  Subcommand options

-B, --binary
    Emits binary data

--help
    Print help information

-o, --output=FILE
    Writes to FILE or stdout if omitted

-u, --userid=USERID
    User IDs to strip

--version
    Print version information

EXAMPLES

First, this generates a key

    sq key generate --userid "<juliet@example.org>" --export juliet.key.pgp

Then, this strips a User ID

    sq key userid strip --userid "<juliet@example.org>" \

  --output juliet-new.key.pgp juliet.key.pgp

SEE ALSO
sq(1).

For the full documentation see <https://docs.sequoia-pgp.org/sq/>.

VERSION
0.28.0 (sequoia-openpgp 1.13.0, using Nettle)