sq-key-subkey-password - Change the password protecting secret key material

NAME  SYNOPSIS  DESCRIPTION  OPTIONS  Subcommand options  Global options  EXAMPLES  SEE ALSO  VERSION 

---

NAME

sq−key−subkey−password − 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.3.1

---