% tpm2_incrementalselftest(1) tpm2-tools | General Commands Manual

NAME

tpm2_incrementalselftest(1) - Request testing of specified algorithm list

SYNOPSIS

tpm2_incrementalselftest [OPTIONS] ALG_SPEC_LIST

DESCRIPTION

tpm2_incrementalselftest(1) Request the TPM to perform testing on specified algorithm and print a list of algorithm scheduled to be tested OR remain to be tested but not scheduled.

The main interest of this command is to reduce delays that might occur on cryptographic operations as TPM must test the algorithm prior using it.

ALG_SPEC_LIST

A space-separated list of algorithm suite to be tested. Algorithms should follow the "formatting standards", see section "Algorithm Specifiers". Also, see section "Supported Hash Algorithms" for a list of supported hash algorithms.

If ALG_SPEC_LIST is left empty, tpm2_incrementalselftest(1) will return the list of algorithms left to be tested. Please note that in this case these algorithms are NOT scheduled to be tested.

If ALG_SPEC_LIST is not empty, tpm2_incrementalselftest(1) will return the list of algorithms that remains to be tested. This list contains algorithms scheduled for testing AND algorithms that remains to be tested and not yet scheduled. This can occur for instance if all AES mode have not been already tested yet.

Output

List of algorithms to be tested (implying scheduled) or remain to be tested (not scheduled) is also printed in YAML format.

If none of the specified algorithm is printed, that means both that they are already tested AND that these algorithms won't be tested again.

OPTIONS

This tool accepts no tool specific options.

References

algorithm specifiers details the options for specifying cryptographic algorithms ALGORITHM.

common options collection of common options that provide information many users may expect.

common tcti options collection of options used to configure the various known TCTI modules.

EXAMPLES

Request testing of RSA algorithm

tpm2_incrementalselftest rsa

Request testing of multiple algorithms

tpm2_incrementalselftest rsa ecc xor aes cbc

NOTES

Algorithm suite specified can imply either testing the combination or the complete suite, depending on TPM manufacturer implementation.

e.g : One TPM might only test AES with CTR mode if "aes ctr" is specified. An other might also test complete AES mode list AND test ctr mode.

If an algorithm has already been tested, this command won't permit re-executing the test. Only issuing tpm2_selftest(1) in full-test mode enabled will force re-testing.

returns

footer