.TH SQ 1 1.4.0 "Sequoia PGP" "User Commands"
.SH NAME
sq\-key\-password \- Change the password protecting secret key material
.SH SYNOPSIS
.br
\fBsq key password\fR [\fIOPTIONS\fR]  
.SH DESCRIPTION
Change the password protecting secret key material.
.PP
Secret key material can be protected by a password.  This subcommand changes or clears the password.
.PP
To strip the password either use `\-\-clear` or supply a zero\-length password when prompted for the new password.
.PP
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.
.PP


.SH OPTIONS
.SS "Subcommand options"
.TP
\fB\-\-cert\fR=\fIFINGERPRINT|KEYID\fR
Change the password for the secret key material from the key with the specified fingerprint or key ID
.TP
\fB\-\-cert\-email\fR=\fIEMAIL\fR
Change the password for the secret key material from the key where a user ID includes the specified email address
.TP
\fB\-\-cert\-file\fR=\fIPATH\fR
Change the password for the secret key material from the key read from PATH
.TP
\fB\-\-cert\-userid\fR=\fIUSERID\fR
Change the password for the secret key material from the key with the specified user ID
.TP
\fB\-\-clear\-password\fR
Clear the password protecting the secret key material
.TP
\fB\-\-new\-password\-file\fR=\fIPASSWORD_FILE\fR
File containing password to encrypt the secret key material
.IP
Note that the entire key file will be used as the password including any surrounding whitespace like a trailing newline.
.TP
\fB\-\-output\fR=\fIFILE\fR
Write to FILE or stdout if omitted
.SS "Global options"
See \fBsq\fR(1) for a description of the global options.
.SH EXAMPLES
.PP

.PP
Change the password for all of Alice's keys to the password in the
specified file.
.PP
.nf
.RS
sq key password \-\-new\-password\-file password\-file.txt \-\-cert \\
.RE
.RS
.RS
EB28F26E2739A4870ECC47726F0073F60FD0CBF0
.RE
.RE
.PP
.fi

.PP
Clear the password protection for all of Alice's keys.
.PP
.nf
.RS
sq key password \-\-password\-file password\-file.txt \\
.RE
.RS
.RS
\-\-clear\-password \-\-cert \\
.RE
.RE
.RS
.RS
EB28F26E2739A4870ECC47726F0073F60FD0CBF0
.RE
.RE
.fi
.SH "SEE ALSO"
.nh
\fBsq\fR(1), \fBsq\-key\fR(1).
.hy
.PP
For the full documentation see <https://book.sequoia\-pgp.org/>.
.SH VERSION
1.4.0