trust

TRUST(1)                         User Commands                        TRUST(1)

NAME
       trust - Tool for operating on the trust policy store

SYNOPSIS
       trust list

       trust extract --filter=<what> --format=<type> /path/to/destination

       trust anchor /path/to/certificate.crt

       trust dump

DESCRIPTION
       trust is a command line tool to examine and modify the shared trust
       policy store.

       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
       List trust policy store items.

           $ trust list

       List information about the various items in the trust policy store.
       Each item is listed with it's PKCS#11 URI and some descriptive
       information.

       You can specify the following options to control what to list.

       --filter=<what>
           Specifies what certificates to extract. You can specify the
           following values:

           ca-anchors
               Certificate anchors

           trust-policy
               Anchors and blacklist (default)

           blacklist
               Blacklisted certificates

           certificates
               All certificates

           pkcs11:object=xx
               A PKCS#11 URI to filter with

           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.

       --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

ANCHOR
       Store or remove trust anchors.

           $ trust anchor /path/to/certificate.crt
           $ trust anchor --remove /path/to/certificate.crt
           $ trust anchor --remove "pkcs11:id=%AA%BB%CC%DD%EE;type=cert"

       Store or remove trust anchors in the trust policy store. These are
       usually root certificate authorities.

       Specify either the --store or --remove operations. If no operation is
       specified then --store is assumed.

       When storing, one or more certificate files are expected on the command
       line. These are stored as anchors, unless they are already present.

       When removing an anchor, either specify certificate files or PKCS#11
       URI's on the command line. Matching anchors will be removed.

       It may be that this command needs to be run as root in order to modify
       the system trust policy store, if no user specific store is available.

       You can specify the following options.

       --remove
           Remove one or more anchors from the trust policy store. Specify
           certificate files or PKCS#11 URI's on the command line.

       --store
           Store one or more anchors to the trust policy store. Specify
           certificate files on the command line.

EXTRACT
       Extract trust policy from the shared trust policy store.

           $ trust 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 of PEM files each containing one certificate

           pem-directory-hash
               Directory of PEM files each containing one certificate, with
               hash symlinks

           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 COMPAT
       Extract compatibility trust certificate bundles.

           $ trust extract-compat

       OpenSSL, Java and some versions of GnuTLS cannot currently read trust
       information directly from the trust policy store. 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.

DUMP
       Dump PKCS#11 items in the various tokens.

           $ trust dump

       Dump information about the various PKCS#11 items in the tokens. Each
       item is dumped with it's PKCS#11 URI and information in the .p11-kit
       persistence format.

       You can specify the following options to control what to dump.

       --filter=<what>
           Specifies what certificates to extract. You can specify the
           following values:

           all
               All objects. This is the default

           pkcs11:object=xx
               A PKCS#11 URI to filter with

BUGS
       Please send bug reports to either the distribution bug tracker or the
       upstream bug tracker at https://github.com/p11-glue/p11-kit/issues/.

SEE ALSO
       p11-kit(8)

       An explanatory document about storing trust policy:
       https://p11-glue.github.io/p11-glue/doc/storing-trust-policy/

       Further details available in the p11-kit online documentation at
       https://p11-glue.github.io/p11-glue/p11-kit/manual/.

p11-kit                                                               TRUST(1)