.TH SQ 1 0.39.0 "Sequoia PGP" "User Commands"
.SH NAME
sq key subkey expire \- Change a subkey's expiration time
.SH SYNOPSIS
.br
\fBsq key subkey expire\fR [\fIOPTIONS\fR]  
.SH DESCRIPTION
Change a subkey's expiration time.
.PP
This subcommand changes a key's expiration time.  To change the expiration time of the certificate, use the `sq key expire` subcommand.
.PP
Changing the expiration time of the primary key is equivalent to changing the certificate's expiration time.  The expiration time of a subkey is bound by the expiration of the certificate.
.PP


.SH OPTIONS
.SS "Subcommand options"
.TP
\fB\-\-binary\fR
Emit binary data
.TP
\fB\-\-cert\fR=\fIFINGERPRINT|KEYID\fR
Change the expiration of the specified (sub)keys on the key with the specified fingerprint or key ID
.TP
\fB\-\-email\fR=\fIEMAIL\fR
Change the expiration of the specified (sub)keys on the key where a user ID includes the specified email address
.TP
\fB\-\-expiration\fR=\fIEXPIRATION\fR
Sets the expiration time.
.IP
EXPIRATION is either an ISO 8601 formatted string or a custom duration, which takes the form `N[ymwds]`, where the letters stand for years, months, weeks, days, and seconds, respectively.  Alternatively, the keyword `never` does not set an expiration time.
.IP
[default: \fBnever\fR]
.TP
\fB\-\-file\fR=\fIPATH\fR
Change the expiration of the specified (sub)keys on the key read from PATH
.TP
\fB\-\-key\fR=\fIFINGERPRINT|KEYID\fR
Change the expiration of this subkey
.TP
\fB\-\-output\fR=\fIFILE\fR
Write to the specified FILE.
.IP
If not specified, and the certificate was read from the certificate store, imports the modified certificate into the cert store.  If not specified, and the certificate was read from a file, writes the modified certificate to stdout.
.TP
\fB\-\-userid\fR=\fIUSERID\fR
Change the expiration of the specified (sub)keys on the key with the specified user ID
.SS "Global options"
See \fBsq\fR(1) for a description of the global options.
.SH EXAMPLES
.PP

.PP
Change Alice's authentication subkey to expire in 6 months.
.PP
.nf
.RS
sq key subkey expire \-\-expiration 6m \\
.RE
.RS
.RS
\-\-cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \\
.RE
.RE
.RS
.RS
\-\-key=0D45C6A756A038670FDFD85CB1C82E8D27DB23A1
.RE
.RE
.fi
.SH "SEE ALSO"
.nh
\fBsq\fR(1), \fBsq\-key\fR(1), \fBsq\-key\-subkey\fR(1).
.hy
.PP
For the full documentation see <https://book.sequoia\-pgp.org>.
.SH VERSION
0.39.0 (sequoia\-openpgp 1.21.2)