.TH SQ 1 1.3.1 "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\-\-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\-\-cert\-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\-\-cert\-file\fR=\fIPATH\fR
Change the expiration of the specified (sub)keys on the key read from PATH
.TP
\fB\-\-cert\-userid\fR=\fIUSERID\fR
Change the expiration of the specified (sub)keys on the key with the specified user ID
.TP
\fB\-\-expiration\fR=\fIEXPIRATION\fR
Sets the expiration time
.IP
EXPIRATION is either an ISO 8601 formatted date with an optional time or a custom duration.  A duration 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\-\-key\fR=\fIFINGERPRINT|KEYID\fR
Use the key with the specified fingerprint or key ID
.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.
.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
1.3.1