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

NAME

6       tss2_gettpm2object(1)
7

SYNOPSIS

9       tss2_gettpm2object [OPTIONS]
10

SEE ALSO

12       fapi-config(5)  to  adjust  Fapi parameters like the used cryptographic
13       profile and TCTI or directories for the Fapi metadata storages.
14
15       fapi-profile(5) to determine the cryptographic algorithms  and  parame‐
16       ters for all keys and operations of a specific TPM interaction like the
17       name hash algorithm, the asymmetric signature algorithm, scheme and pa‐
18       rameters and PCR bank selection.
19

DESCRIPTION

21       tss2_gettpm2object(1)  -  With  this  command  for FAPI objects context
22       files which can be used by tpm2 tool commands can be created.  For per‐
23       sistent  object only the textual representation of the handle number as
24       hex number will be written and for keys a tpm2 tool context  file  will
25       be  written.  If the default TCTI differs from the FAPI profile the de‐
26       fault the tcti can be defined with the  -T  (–tcti)  option.   Note  To
27       avoid  wrong nv_written state in keystore before writing data to the NV
28       ram with tpm2_nvwrite, at least an empty string should be written  with
29       tss2_nvwrite.
30

OPTIONS

32       These are the available options:
33
34       • -f, --force:
35
36         Force overwriting the output file.
37
38       • -p, --path=STRING:
39
40         Path of the object for which the application data will be loaded.
41
42       • -c, --context=FILENAME or - (for stdout):
43
44         The returned key context or handle.
45

COMMON OPTIONS

47       This  collection of options are common to all tss2 programs and provide
48       information that many users may expect.
49
50       • -h, --help [man|no-man]: Display the tools manpage.  By  default,  it
51         attempts  to  invoke  the  manpager for the tool, however, on failure
52         will output a short tool summary.  This is the same behavior  if  the
53         “man”  option argument is specified, however if explicit “man” is re‐
54         quested, the tool will provide errors from man  on  stderr.   If  the
55         “no-man”  option  if  specified, or the manpager fails, the short op‐
56         tions will be output to stdout.
57
58         To successfully use the manpages feature requires the manpages to  be
59         installed or on MANPATH, See man(1) for more details.
60
61       • -v,  --version:  Display version information for this tool, supported
62         tctis and exit.
63

EXAMPLES

65              tss2_gettpm2object --path=/HS/SRK/myRSACrypt --key-context=mykey.ctx
66              tss2_gettpm2object --path=/nv/Owner/mynv -c-
67
68       The command can be used in options of tpm2 commands:
69
70              handle=$(tss2_gettpm2object --path=/nv/Owner/mynv -c-)
71              tpm2_nvread $handle
72

RETURNS

74       0 on success or 1 on failure.
75

BUGS

77       Github Issues (https://github.com/tpm2-software/tpm2-tools/issues)
78

HELP

80       See the Mailing List (https://lists.linuxfoundation.org/mailman/listin‐
81       fo/tpm2)
82
83
84
85tpm2-tools                        APRIL 2019             tss2_gettpm2object(1)
Impressum