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

NAME

6       tss2_getrandom(1) - # SYNOPSIS
7
8       tss2_getrandom [OPTIONS]
9

SEE ALSO

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

DESCRIPTION

20       tss2_getrandom(1)  -  This  command  uses the TPM to create an array of
21       random bytes.
22

OPTIONS

24       These are the available options:
25
26       • -n, --numBytes=INTEGER:
27
28         The number of bytes requested by the caller.
29
30       • -f, --force:
31
32         Force overwriting the output file.
33
34       • -o, --data=FILENAME or - (for stdout):
35
36         The returned random bytes.
37
38       • --hex
39
40         Convert the output data to hex format without a leading “0x”.
41

COMMON OPTIONS

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

EXAMPLE

61                  tss2_getrandom --numBytes=20 --data=- | hexdump -C
62

RETURNS

64       0 on success or 1 on failure.
65

BUGS

67       Github Issues (https://github.com/tpm2-software/tpm2-tools/issues)
68

HELP

70       See the Mailing List (https://lists.linuxfoundation.org/mailman/listin‐
71       fo/tpm2)
72
73
74
75tpm2-tools                        APRIL 2019                 tss2_getrandom(1)