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

NAME
     sq-key-approvals-list - Lists third-party certifications and their approval
     status

SYNOPSIS
     sq key approvals list [OPTIONS]

DESCRIPTION
     Lists third-party certifications and their approval status.

     To  prevent certificate flooding attacks, modern key servers prevent uncon-
     trolled distribution of third-party certifications on certificates.  To al-
     low the key holder to control what information is	distributed  with  their
     certificate,  these  key servers only distribute third-party certifications
     that the key holder has explicitly approved.

OPTIONS
   Subcommand options
     --cert=FINGERPRINT|KEYID
	    List the approvals on the certificate with the specified fingerprint
	    or key ID

     --cert-email=EMAIL
	    List the approvals on the certificate where a user ID  includes  the
	    specified email address

     --cert-file=PATH
	    List the approvals on the certificate read from PATH

     --cert-userid=USERID
	    List the approvals on the certificate with the specified user ID

     --email=EMAIL
	    Use the self-signed user ID with the specified email address

     --pending
	    List unapproved certifications

     --userid=USERID
	    Use the specified self-signed user ID

	    The specified user ID must be self signed.

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

EXAMPLES
     Lists the approved certifications on all the user IDs.

	    sq key approvals list \
		   --cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0

     Lists the unapproved certifications on all the user IDs.

	    sq key approvals list --pending \
		   --cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0

     Lists all unapproved certifications on a given user ID.

	    sq key approvals list --pending --email=alice@example.org \
		   --cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0

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

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

VERSION
     1.3.1

Sequoia PGP			      1.3.1				   SQ(1)

home | help