home | help
SQ(1)				  User Commands 			   SQ(1)

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 pass-
     word.  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 mater-
	    ial

     --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 speci-
     fied 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

Sequoia PGP			      1.3.1				   SQ(1)

home | help