sq-key-subkey-password - Man Page

Change the password protecting secret key material

Synopsis

sq key subkey password [Options]  

Description

Change the password protecting secret key material.

Secret key material can be protected by a password.  This subcommand changes or clears the password of one or more keys.

To strip the password either use `--clear` or supply a zero-length password when prompted for the new password.

If a key is password protected, and the correct password was not supplied using the `--password-file` argument, the user is prompted for the password.  Likewise, if the new password isn't provided, the user is prompted.

Options

Subcommand options

--cert=FINGERPRINT|KEYID

Change the password for the secret key material of the specified (sub)keys from the key with the specified fingerprint or key ID

--cert-email=EMAIL

Change the password for the secret key material of the specified (sub)keys from the key where a user ID includes the specified email address

--cert-file=PATH

Change the password for the secret key material of the specified (sub)keys from the key read from PATH

--cert-userid=USERID

Change the password for the secret key material of the specified (sub)keys from the key with the specified user ID

--clear-password

Clear the password protecting the secret key material

--key=FINGERPRINT|KEYID

Change the password protecting the specified key's secret key material

--new-password-file=PASSWORD_FILE

File containing password to encrypt the secret key material

Note that the entire key file will be used as the password including any surrounding whitespace like a trailing newline.

--output=FILE

Write to FILE or stdout if omitted

Global options

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

Examples

Change the password for Alice's signing key to the password in the specified file.

    sq key subkey password --new-password-file=password-file.txt \
    --cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \

--key=42020B87D51877E5AF8D272124F3955B0B8DECC8

Clear the password protection for Alice's signing key.

    sq key subkey password --password-file=password-file.txt \
    --clear-password \

--cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \
--key=42020B87D51877E5AF8D272124F3955B0B8DECC8

See Also

sq(1), sq-key(1), sq-key-subkey(1).

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

Version

1.0.0 (sequoia-openpgp 1.22.0)

Referenced By

sq-key-subkey(1).

1.0.0 Sequoia PGP