.TH SQ 1 1.3.1 "Sequoia PGP" "User Commands"
.SH NAME
sq\-key\-expire \- Change a certificate's expiration time
.SH SYNOPSIS
.br
\fBsq key expire\fR [\fIOPTIONS\fR]  
.SH DESCRIPTION
Change a certificate's expiration time.
.PP
This subcommand changes a certificate's expiration time.  To change the expiration time of an individual subkey, use the `sq key subkey expire` subcommand.
.PP


.SH OPTIONS
.SS "Subcommand options"
.TP
\fB\-\-cert\fR=\fIFINGERPRINT|KEYID\fR
Change the expiration of the key with the specified fingerprint or key ID
.TP
\fB\-\-cert\-email\fR=\fIEMAIL\fR
Change the expiration of the key where a user ID includes the specified email address
.TP
\fB\-\-cert\-file\fR=\fIPATH\fR
Change the expiration of the key read from PATH
.TP
\fB\-\-cert\-userid\fR=\fIUSERID\fR
Change the expiration of 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\-\-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 Alice's certificate to expire in a year.
.PP
.nf
.RS
sq key expire \-\-expiration 1y \-\-cert \\
.RE
.RS
.RS
EB28F26E2739A4870ECC47726F0073F60FD0CBF0
.RE
.RE
.PP
.fi

.PP
Change Alice's certificate to never expire.
.PP
.nf
.RS
sq key expire \-\-expiration never \-\-cert \\
.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.3.1