1tpm2_policyduplicationselect(G1e)neral Commands Mantupaml2_policyduplicationselect(1)
2
3
4

NAME

6       tpm2_policyduplicationselect(1)  -  Restricts duplication to a specific
7       new parent.
8

SYNOPSIS

10       tpm2_policyduplicationselect [OPTIONS]
11

DESCRIPTION

13       tpm2_policyduplicationselect(1) - Restricts duplication to  a  specific
14       new parent.
15

OPTIONS

17-S, --session=FILE:
18
19         The  policy  session  file  generated via the -S option to tpm2_star‐
20         tauthsession(1).
21
22-n, --object-name=FILE:
23
24         Input name file of the object to be duplicated.
25
26-N, --parent-name=FILE:
27
28         Input name file of the new parent.
29
30-L, --policy=FILE:
31
32         File to save the policy digest.
33
34--include-object:
35
36         If exists, the object name will be included in the  value  in  policy
37         digest.
38
39   References

COMMON OPTIONS

41       This  collection of options are common to many programs and provide in‐
42       formation that many users may expect.
43
44-h, --help=[man|no-man]: Display the tools manpage.  By  default,  it
45         attempts  to  invoke  the  manpager for the tool, however, on failure
46         will output a short tool summary.  This is the same behavior  if  the
47         “man”  option argument is specified, however if explicit “man” is re‐
48         quested, the tool will provide errors from man  on  stderr.   If  the
49         “no-man”  option  if  specified, or the manpager fails, the short op‐
50         tions will be output to stdout.
51
52         To successfully use the manpages feature requires the manpages to  be
53         installed or on MANPATH, See man(1) for more details.
54
55-v,  --version:  Display version information for this tool, supported
56         tctis and exit.
57
58-V, --verbose: Increase the information that the tool prints  to  the
59         console  during  its  execution.  When using this option the file and
60         line number are printed.
61
62-Q, --quiet: Silence normal tool output to stdout.
63
64-Z, --enable-errata: Enable the application of errata fixups.  Useful
65         if  an  errata fixup needs to be applied to commands sent to the TPM.
66         Defining the environment TPM2TOOLS_ENABLE_ERRATA is equivalent.   in‐
67         formation many users may expect.
68

TCTI Configuration

70       The  TCTI  or  “Transmission  Interface” is the communication mechanism
71       with the TPM.  TCTIs can be changed for communication with TPMs  across
72       different mediums.
73
74       To control the TCTI, the tools respect:
75
76       1. The command line option -T or --tcti
77
78       2. The environment variable: TPM2TOOLS_TCTI.
79
80       Note:  The  command  line option always overrides the environment vari‐
81       able.
82
83       The current known TCTIs are:
84
85       • tabrmd     -     The     resource     manager,     called      tabrmd
86         (https://github.com/tpm2-software/tpm2-abrmd).   Note that tabrmd and
87         abrmd as a tcti name are synonymous.
88
89       • mssim - Typically used for communicating to the TPM software  simula‐
90         tor.
91
92       • device - Used when talking directly to a TPM device file.
93
94       • none  - Do not initalize a connection with the TPM.  Some tools allow
95         for off-tpm options and thus support not using a TCTI.  Tools that do
96         not  support  it  will error when attempted to be used without a TCTI
97         connection.  Does not support ANY options and MUST  BE  presented  as
98         the exact text of “none”.
99
100       The  arguments  to  either  the  command line option or the environment
101       variable are in the form:
102
103       <tcti-name>:<tcti-option-config>
104
105       Specifying an empty string for  either  the  <tcti-name>  or  <tcti-op‐
106       tion-config> results in the default being used for that portion respec‐
107       tively.
108
109   TCTI Defaults
110       When a TCTI is not specified, the default TCTI is  searched  for  using
111       dlopen(3)  semantics.   The  tools  will  search for tabrmd, device and
112       mssim TCTIs IN THAT ORDER and USE THE FIRST ONE FOUND.  You  can  query
113       what TCTI will be chosen as the default by using the -v option to print
114       the version information.  The “default-tcti” key-value pair will  indi‐
115       cate which of the aforementioned TCTIs is the default.
116
117   Custom TCTIs
118       Any TCTI that implements the dynamic TCTI interface can be loaded.  The
119       tools internally use dlopen(3), and the raw tcti-name value is used for
120       the lookup.  Thus, this could be a path to the shared library, or a li‐
121       brary name as understood by dlopen(3) semantics.
122

TCTI OPTIONS

124       This collection of options are used to configure the various known TCTI
125       modules available:
126
127device: For the device TCTI, the TPM character device file for use by
128         the device TCTI can be specified.  The default is /dev/tpm0.
129
130         Example:   -T   device:/dev/tpm0   or   export    TPM2TOOLS_TCTI=“de‐
131         vice:/dev/tpm0”
132
133mssim:  For  the  mssim  TCTI, the domain name or IP address and port
134         number used by the simulator  can  be  specified.   The  default  are
135         127.0.0.1 and 2321.
136
137         Example:  -T  mssim:host=localhost,port=2321  or export TPM2TOOLS_TC‐
138         TI=“mssim:host=localhost,port=2321”
139
140abrmd: For the abrmd TCTI, the configuration string format is  a  se‐
141         ries  of  simple  key value pairs separated by a `,' character.  Each
142         key and value string are separated by a `=' character.
143
144         • TCTI abrmd supports two keys:
145
146           1. `bus_name' : The name of  the  tabrmd  service  on  the  bus  (a
147              string).
148
149           2. `bus_type' : The type of the dbus instance (a string) limited to
150              `session' and `system'.
151
152         Specify the tabrmd tcti name and a config string of  bus_name=com.ex‐
153         ample.FooBar:
154
155                \--tcti=tabrmd:bus_name=com.example.FooBar
156
157         Specify the default (abrmd) tcti and a config string of bus_type=ses‐
158         sion:
159
160                \--tcti:bus_type=session
161
162         NOTE: abrmd and tabrmd are synonymous.  the various known  TCTI  mod‐
163         ules.
164

EXAMPLES

166   Setup a duplication role policy to restricted new parent
167   Create source parent and destination(or new) parent
168              tpm2_createprimary -C n -g sha256 -G rsa -c dst_n.ctx -Q
169              tpm2_createprimary -C o -g sha256 -G rsa -c src_o.ctx -Q
170
171   Create the restricted parent policy
172              tpm2_readpublic -c dst_n.ctx -n dst_n.name -Q
173              tpm2_startauthsession -S session.ctx
174              tpm2_policyduplicationselect -S session.ctx  -N dst_n.name \
175              -L policydupselect.dat -Q
176              tpm2_flushcontext session.ctx
177              rm session.ctx
178
179   Create the object to be duplicated using the policy
180              tpm2_create -C src_o.ctx -g sha256 -G rsa -r dupkey.priv -u dupkey.pub \
181              -L policydupselect.dat  -a "sensitivedataorigin|sign|decrypt" -c dupkey.ctx -Q
182              tpm2_readpublic -c dupkey.ctx -n dupkey.name -Q
183
184   Satisfy the policy and duplicate the object
185              tpm2_startauthsession -S session.ctx --policy-session
186              tpm2_policyduplicationselect -S session.ctx  -N dst_n.name -n dupkey.name -Q
187              tpm2_duplicate -C dst_n.ctx -c dupkey.ctx -G null -p session:session.ctx \
188              -r new_dupkey.priv -s dupseed.dat
189              tpm2_flushcontext  session.ctx
190              rm session.ctx
191

NOTES

193       • This  command usually cooperates with tpm2_duplicate(1), so referring
194         to the man page of tpm2_duplicate(1) is recommended.
195
196       • This command will set the policy session’s command code to TPM_CC_Du‐
197         plicate which enables duplication role of the policy.
198

Returns

200       Tools can return any of the following codes:
201
202       • 0 - Success.
203
204       • 1 - General non-specific error.
205
206       • 2 - Options handling error.
207
208       • 3 - Authentication error.
209
210       • 4 - TCTI related error.
211
212       • 5 - Non supported scheme.  Applicable to tpm2_testparams.
213

Limitations

215       It  expects  a session to be already established via tpm2_startauthses‐
216       sion(1) and requires one of the following:
217
218       • direct device access
219
220       • extended session support with tpm2-abrmd.
221
222       Without it, most resource managers will not save session state  between
223       command invocations.
224

BUGS

226       Github Issues (https://github.com/tpm2-software/tpm2-tools/issues)
227

HELP

229       See the Mailing List (https://lists.01.org/mailman/listinfo/tpm2)
230
231
232
233tpm2-tools                                     tpm2_policyduplicationselect(1)
Impressum