mirror of
https://github.com/stefanberger/libtpms
synced 2025-08-26 04:33:40 +00:00
e97909d845
Return the RSAKeySizes in the JSON produced by TPM2_GetInfo() under a new flag with value '4'. This helps higher level tools and users to easily determine what key sizes are supported for RSA. Signed-off-by: Stefan Berger <stefanb@linux.ibm.com>
53 lines
1.2 KiB
Plaintext
53 lines
1.2 KiB
Plaintext
=head1 NAME
|
|
|
|
TPMLIB_GetInfo - Get Information about the TPM implementation
|
|
|
|
=head1 LIBRARY
|
|
|
|
TPM library (libtpms, -ltpms)
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
B<#include <libtpms/tpm_library.h>>
|
|
|
|
B<char *TPMLIB_GetInfo(TPMLIB_InfoFlags flags);>
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
The B<TPMLIB_GetInfo()> function allows to query for TPM implementation
|
|
specifics and get a JSON string in return. Which data is to be returned
|
|
can be specified in the flags parameter that may be a logical 'or' concatenation
|
|
of flags. If passed flags are not supported, nothing is returned . If a 0 is
|
|
passed in, an empty JSON Object '{}' is returned.
|
|
|
|
The following flags are defined and return JSON objects as shown:
|
|
|
|
=over 4
|
|
|
|
=item B<TPMLIB_INFO_TPMSPECIFICATION>
|
|
|
|
{"TPMSpecification":{"family":"1.2","level":2,"revision":116}}
|
|
|
|
=item B<TPMLIB_INFO_TPMATTRIBUTES>
|
|
|
|
{"TPMAttributes":{"manufacturer":"id:00001014","version":"id:00740001","model":"swtpm"}}
|
|
|
|
=item B<TPMLIB_INFO_TPMFEATURES> (since v0.8.0)
|
|
|
|
{"TPMFeatures":{"RSAKeySizes":[1024,2048,3072]}}
|
|
|
|
This JSON object may be extended in the future.
|
|
|
|
=back
|
|
|
|
=head1 RETURN VALUE
|
|
|
|
This function returns a JSON string on success and a NULL pointer if a memory
|
|
allocation failure occurred.
|
|
|
|
The caller must free() the returned string.
|
|
|
|
=head1 SEE ALSO
|
|
|
|
=cut
|