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

NAME

6       tss2_changeauth(1)  - This command changes the authorization data of an
7       entity referred to by the path.
8

SYNOPSIS

10       tss2_changeauth [OPTIONS]
11

SEE ALSO

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

DESCRIPTION

22       tss2_changeauth(1) -
23

OPTIONS

25       These are the available options:
26
27       • -a, --authValue=STRING:
28
29         The new UTF-8 password.  Optional parameter.  If it is neglected then
30         the  user  is  queried interactively for a password.  To set no pass‐
31         word, this option should be used with the  empty  string  ("").   The
32         maximum  password size is determined by the digest size of the chosen
33         name hash algorithm in  the  cryptographic  profile  (cf.,  fapi-pro‐
34         file(5)).   For  example,  choosing  SHA256 as hash algorithm, allows
35         passwords of a maximum size of 32 characters.
36
37       • -p, --entityPath=STRING:
38
39         The path identifying the entity to modify.
40

COMMON OPTIONS

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

EXAMPLES

60   Change a password for an entity HS/SRK/myRSACryptKey to M1
61              tss2_changeauth --entityPath=HS/SRK/myRSACryptKey --authValue=M1
62
63   Change  a  password  for an entity HS/SRK/myRSACryptKey and ask the user to
64       enter the password.
65              tss2_changeauth --entityPath=HS/SRK/myRSACryptKey
66

RETURNS

68       0 on success or 1 on failure.
69

BUGS

71       Github Issues (https://github.com/tpm2-software/tpm2-tools/issues)
72

HELP

74       See the Mailing List (https://lists.01.org/mailman/listinfo/tpm2)
75
76
77
78tpm2-tools                        APRIL 2019                tss2_changeauth(1)