1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
|
% tss2_pcrread(1) tpm2-tools | General Commands Manual
%
% APRIL 2019
# NAME
**tss2_pcrread**(1) -
# SYNOPSIS
**tss2_pcrread** [*OPTIONS*]
[common fapi references](common/tss2-fapi-references.md)
# DESCRIPTION
**tss2_pcrread**(1) - This command provides a PCRs value and corresponding event
log. The PCR bank to be used per PCR is defined in the cryptographic profile
(cf., **fapi-profile(5)**).
# OPTIONS
These are the available options:
* **-o**, **\--pcrValue**=_FILENAME_ or _-_ (for stdout):
Returns PCR digest. Optional parameter.
* **-x**, **\--pcrIndex**=_INTEGER_:
Identifies the PCR to read.
* **-f**, **\--force**:
Force overwriting the output files.
* **-l**, **\--pcrLog**=_FILENAME_ or _-_ (for stdout):
Returns the PCR log for that PCR. Optional parameter.
PCR event logs are a list (arbitrary length JSON array) of log entries with
the following content.
- recnum: Unique record number
- pcr: PCR index
- digest: The digests
- type: The type of event. At the moment the only possible value is: "LINUX_IMA" (legacy IMA)
- eventDigest: Digest of the event; e.g. the digest of the measured file
- eventName: Name of the event; e.g. the name of the measured file.
[common tss2 options](common/tss2-options.md)
# EXAMPLE
```
tss2_pcrread --pcrIndex=16 --pcrValue=pcrValue.file --pcrLog=pcrLog.file
```
# RETURNS
0 on success or 1 on failure.
[footer](common/footer.md)
|