home | help
SQ(1)				  User Commands 			   SQ(1)

NAME
     sq-key-subkey-expire - Change a subkey's expiration time

SYNOPSIS
     sq key subkey expire [OPTIONS]

DESCRIPTION
     Change a subkey's expiration time.

     This  subcommand changes a key's expiration time.	To change the expiration
     time of the certificate, use the `sq key expire` subcommand.

     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.

OPTIONS
   Subcommand options
     --cert=FINGERPRINT|KEYID
	    Change the expiration of the specified (sub)keys on the key with the
	    specified fingerprint or key ID

     --cert-email=EMAIL
	    Change the expiration of the specified (sub)keys on the key where  a
	    user ID includes the specified email address

     --cert-file=PATH
	    Change  the  expiration  of  the specified (sub)keys on the key read
	    from PATH

     --cert-userid=USERID
	    Change the expiration of the specified (sub)keys on the key with the
	    specified user ID

     --expiration=EXPIRATION
	    Sets the expiration time

	    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 ex-
	    piration time.

	    [default: never]

     --key=FINGERPRINT|KEYID
	    Use the key with the specified fingerprint or key ID

     --output=FILE
	    Write to the specified FILE

	    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 mod-
	    ified certificate to stdout.

   Global options
     See sq(1) for a description of the global options.

EXAMPLES
     Change Alice's authentication subkey to expire in 6 months.

	    sq key subkey expire --expiration 6m \
		   --cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \
		   --key=0D45C6A756A038670FDFD85CB1C82E8D27DB23A1

SEE ALSO
     sq(1), sq-key(1), sq-key-subkey(1).

     For the full documentation see <https://book.sequoia-pgp.org/>.

VERSION
     1.3.1

Sequoia PGP			      1.3.1				   SQ(1)

home | help