P11\-KIT
Section: System Commands (8)Updated:
Index Return to Main Contents
NAME
p11-kit - Tool for operating on configured PKCS#11 modulesSYNOPSIS
-
p11-kit list-modules
- p11-kit extract --filter=<what> --format=<type> /path/to/destination
- p11-kit extract --filter=<what> --format=<type> /path/to/destination
DESCRIPTION
p11-kit
See the various sub commands below. The following global options can be used:
-v, --verbose
- Run in verbose mode with debug output.
-q, --quiet
- Run in quiet mode without warning or failure messages.
LIST MODULES
List system configured PKCS#11 modules.
-
$ p11-kit list-modules
The modules, information about them and the tokens present in the PKCS#11 modules will be displayed.
EXTRACT
Extract certificates from configured PKCS#11 modules.
-
$ p11-kit extract --format=x509-directory --filter=ca-anchors /path/to/directory
You can specify the following options to control what to extract. The --filter and --format arguments should be specified. By default this command will not overwrite the destination file or directory.
--comment
- Add identifying comments to PEM bundle output files before each certificate.
--filter=<what>
-
Specifies what certificates to extract. You can specify the following values:
ca-anchors
- Certificate anchors (default)
trust-policy
- Anchors and blacklist
blacklist
- Blacklisted certificates
certificates
- All certificates
pkcs11:object=xx
- A PKCS#11 URI
If an output format is chosen that cannot support type what has been specified by the filter, a message will be printed.
None of the available formats support storage of blacklist entries that do not contain a full certificate. Thus any certificates blacklisted by their issuer and serial number alone, are not included in the extracted blacklist.
--format=<type>
-
The format of the destination file or directory. You can specify one of the following values:
x509-file
- DER X.509 certificate file
x509-directory
- directory of X.509 certificates
pem-bundle
- File containing one or more certificate PEM blocks
pem-directory
- Directory PEM files each containing one certifiacte
openssl-bundle
- OpenSSL specific PEM bundle of certificates
openssl-directory
- Directory of OpenSSL specific PEM files
java-cacerts
- Java keystore 'cacerts' certificate bundle
--overwrite
- Overwrite output file or directory.
--purpose=<usage>
-
Limit to certificates usable for the given purpose You can specify one of the following values:
server-auth
- For authenticating servers
client-auth
- For authenticating clients
email
- For email protection
code-signing
- For authenticated signed code
1.2.3.4.5...
- An arbitrary purpose OID
EXTRACT TRUST
Extract standard trust information files.
-
$ p11-kit extract-trust
OpenSSL, GnuTLS and Java cannot currently read trust information directly from the trust policy module. This command extracts trust information such as certificate anchors for use by these libraries.
What this command does, and where it extracts the files is distribution or site specific. Packagers or administrators are expected customize this command.
BUGS
Please send bug reports to either the distribution bug tracker or the upstream bug tracker at m[blue]https://bugs.freedesktop.org/enter_bug.cgi?product=p11-glue&component=p11-kitm[].
SEE ALSO
pkcs11.conf(5)Further details available in the p11-kit online documentation at m[blue]http://p11-glue.freedesktop.org/doc/p11-kit/m[].
Index
This document was created by man2html, using the manual pages.
Time: 05:34:28 GMT, December 24, 2015