1tpm2_readpublic(1)          General Commands Manual         tpm2_readpublic(1)
2
3
4

NAME

6       tpm2_readpublic(1) - Read the public area of a loaded object.
7

SYNOPSIS

9       tpm2_readpublic [OPTIONS]
10

DESCRIPTION

12       tpm2_readpublic(1) Reads the public area of a loaded object.
13

OPTIONS

15       · -H, –object=HANDLE:
16
17         The loaded object handle to read the public data of.
18
19       · -c, –ak-context=OBJECT_CONTEXT_FILE:
20
21         Filename for object context.
22
23       · -o, –opu:
24
25         The output file path, recording the public portion of the object.
26
27       · -f, –format:
28
29         Format selection for the public key output file.  `tss' (the default)
30         will output a binary blob according  to  the  TPM  2.0  secification.
31         `pem'  will  output  an  OpenSSL  compatible  PEM encoded public key.
32         `der' will output an OpenSSL compatible DER encoded public key.
33

COMMON OPTIONS

35       This collection of options are common to many programs and provide  in‐
36       formation that many users may expect.
37
38       · -h,  –help: Display the tools manpage.  This requires the manpages to
39         be installed or on MANPATH, See man(1) for more details.
40
41       · -v, –version: Display version information for  this  tool,  supported
42         tctis and exit.
43
44       · -V,  –verbose:  Increase  the information that the tool prints to the
45         console during its execution.  When using this option  the  file  and
46         line number are printed.
47
48       · -Q, –quiet: Silence normal tool output to stdout.
49
50       · -Z,  –enable-errata: Enable the application of errata fixups.  Useful
51         if an errata fixup needs to be applied to commands sent to  the  TPM.
52         # TCTI ENVIRONMENT
53
54       This  collection of environment variables that may be used to configure
55       the various TCTI modules available.
56
57       The values passed through  these  variables  can  be  overridden  on  a
58       per-command basis using the available command line options, see the TC‐
59       TI_OPTIONS section.
60
61       The variables respected depend on how the software was configured.
62
63       · TPM2TOOLS_TCTI_NAME: Select the TCTI used for communication with  the
64         next  component down the TSS stack.  In most configurations this will
65         be the TPM but it could be a simulator or proxy.  The  current  known
66         TCTIs are:
67
68         · tabrmd    -    The    new    resource    manager,   called   tabrmd
69           (https://github.com/01org/tpm2-abrmd).
70
71         · socket - Typically used with the old resource manager,  or  talking
72           directly to a simulator.
73
74         · device - Used when talking directly to a TPM device file.
75
76       · TPM2TOOLS_DEVICE_FILE:  When  using  the device TCTI, specify the TPM
77         device file.  The default is “/dev/tpm0”.
78
79         Note: Using the tpm directly requires the users to ensure  that  con‐
80         current access does not occur and that they manage the tpm resources.
81         These tasks are usually managed by a resource  manager.   Linux  4.12
82         and  greater  supports an in kernel resource manager at “/dev/tpmrm”,
83         typically “/dev/tpmrm0”.
84
85       · TPM2TOOLS_SOCKET_ADDRESS: When using the socket TCTI, specify the do‐
86         main name or IP address used.  The default is 127.0.0.1.
87
88       · TPM2TOOLS_SOCKET_PORT:  When  using the socket TCTI, specify the port
89         number used.  The default is 2321.
90

TCTI OPTIONS

92       This collection of options are used to configure the varous  TCTI  mod‐
93       ules available.  They override any environment variables.
94
95       · -T, –tcti=TCTI_NAME[:TCTI_OPTIONS]: Select the TCTI used for communi‐
96         cation with the next component down the TSS stack.  In most  configu‐
97         rations    this    will    be    the    resource    manager:   tabrmd
98         (https://github.com/01org/tpm2-abrmd) Optionally, tcti  specific  op‐
99         tions can appended to TCTI_NAME by appending a : to TCTI_NAME.
100
101         · For the device TCTI, the TPM device file for use by the device TCTI
102           can be specified.  The  default  is  /dev/tpm0.   Example:  -T  de‐
103           vice:/dev/tpm0
104
105         · For  the socket TCTI, the domain name or IP address and port number
106           used by the socket can be specified.  The default are 127.0.0.1 and
107           2321.  Example: -T socket:127.0.0.1:2321
108
109         · For the abrmd TCTI, it takes no options.  Example: -T abrmd
110

EXAMPLES

112              tpm2_readpublic -H 0x81010002 --opu output.dat
113

RETURNS

115       0 on success or 1 on failure.
116

BUGS

118       Github Issues (https://github.com/01org/tpm2-tools/issues)
119

HELP

121       See the Mailing List (https://lists.01.org/mailman/listinfo/tpm2)
122
123
124
125tpm2-tools                      SEPTEMBER 2017              tpm2_readpublic(1)