.TH SQ 1 0.38.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] \fIEXPIRATION\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.
.PP


.SH OPTIONS
.SS "Subcommand options"
.TP
\fB\-\-binary\fR
Emit binary data
.TP
\fB\-\-cert\fR=\fIFINGERPRINT|KEYID\fR
Change the expiration time of keys on the specified certificate
.TP
\fB\-\-cert\-file\fR=\fICERT_FILE\fR
Change the expiration time of keys on the specified certificate
.TP
\fB\-\-key\fR=\fIKEY\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
 \fIEXPIRATION\fR
Sets the key's 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
When using an ISO 8601 formatted string, the validity period is from the key's creation time to the specified time.  When using a duration, the validity period is from the key's creation time for the specified duration.
.SS "Global options"
See \fBsq\fR(1) for a description of the global options.
.SH EXAMPLES
.PP

.PP
Make Alice's authentication subkey expire in 6 months.
.PP
.nf
.RS
sq key subkey expire 6m \-\-cert \\
.RE
.RS
.RS
EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \-\-key \\
.RE
.RE
.RS
.RS
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.38.0 (sequoia\-openpgp 1.21.2)