summaryrefslogtreecommitdiffstats
path: root/man/man3/TPMLIB_ChooseTPMVersion.pod
blob: 65d0a6dd759c9b1e7f4c8fb7fe2d53b4ac3c44e8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
=head1 NAME

TPMLIB_ChooseTPMVersion    - Choose the version of the TPM

=head1 SYNOPSIS

B<#include <libtpms/tpm_types.h>>

B<#include <libtpms/tpm_library.h>>

B<TPM_RESULT TPMLIB_ChooseTPMVersion(TPMLIB_TPMVersion> I<ver>B<);>

 typedef enum TPMLIB_TPMVersion {
    TPMLIB_TPM_VERSION_1_2,
    TPMLIB_TPM_VERSION_2,
 } TPMLIB_TPMVersion;

=head1 DESCRIPTION

The B<TPMLIB_ChooseTPMVersion()> function is used to choose the version
of the TPM, either a TPM 1.2 or TPM 2.

This function must be called before B<TPMLIB_MainInit()> is called and
will otherwise return an error. This function may be called again once
B<TPMLIB_Terminate()> has been called.

If this function is not called, the last chosen TPM version will be
started with B<TPMLIB_MainInit()>. If this function is not called,
a TPM  1.2 will be used.

=head1 ERRORS

=over 4

=item B<TPM_SUCCESS>

The version of the TPM was chosen successfully.

=item B<TPM_FAIL>

The choice of the TPM was wrong, or TPMLIB_MainInit() has already been called.

=back

For a complete list of TPM error codes please consult the include file
B<libtpms/tpm_error.h>

=head1 SEE ALSO

B<TPMLIB_MainInit>(3), B<TPMLIB_Terminate>(3)

=cut