forked from ~ljy/RK356X_SDK_RELEASE
blame | history | patch | commit | commitdiff
hc
2024-02-20 ea08eeccae9297f7aabd2ef7f0c2517ac4549acc 
 kernel/Documentation/ABI/stable/sysfs-class-tpm
....@@ -1,7 +1,7 @@
11 What:		/sys/class/tpm/tpmX/device/
22 Date:		April 2005
33 KernelVersion:	2.6.12
4
-Contact:	tpmdd-devel@lists.sf.net
4
+Contact:	linux-integrity@vger.kernel.org
55 Description:	The device/ directory under a specific TPM instance exposes
66 		the properties of that TPM chip
77 
....@@ -9,7 +9,7 @@
99 What:		/sys/class/tpm/tpmX/device/active
1010 Date:		April 2006
1111 KernelVersion:	2.6.17
12
-Contact:	tpmdd-devel@lists.sf.net
12
+Contact:	linux-integrity@vger.kernel.org
1313 Description:	The "active" property prints a '1' if the TPM chip is accepting
1414 		commands. An inactive TPM chip still contains all the state of
1515 		an active chip (Storage Root Key, NVRAM, etc), and can be
....@@ -21,7 +21,7 @@
2121 What:		/sys/class/tpm/tpmX/device/cancel
2222 Date:		June 2005
2323 KernelVersion:	2.6.13
24
-Contact:	tpmdd-devel@lists.sf.net
24
+Contact:	linux-integrity@vger.kernel.org
2525 Description:	The "cancel" property allows you to cancel the currently
2626 		pending TPM command. Writing any value to cancel will call the
2727 		TPM vendor specific cancel operation.
....@@ -29,14 +29,14 @@
2929 What:		/sys/class/tpm/tpmX/device/caps
3030 Date:		April 2005
3131 KernelVersion:	2.6.12
32
-Contact:	tpmdd-devel@lists.sf.net
32
+Contact:	linux-integrity@vger.kernel.org
3333 Description:	The "caps" property contains TPM manufacturer and version info.
3434 
35
-		Example output:
35
+		Example output::
3636 
37
-		Manufacturer: 0x53544d20
38
-		TCG version: 1.2
39
-		Firmware version: 8.16
37
+		  Manufacturer: 0x53544d20
38
+		  TCG version: 1.2
39
+		  Firmware version: 8.16
4040 
4141 		Manufacturer is a hex dump of the 4 byte manufacturer info
4242 		space in a TPM. TCG version shows the TCG TPM spec level that
....@@ -46,7 +46,7 @@
4646 What:		/sys/class/tpm/tpmX/device/durations
4747 Date:		March 2011
4848 KernelVersion:	3.1
49
-Contact:	tpmdd-devel@lists.sf.net
49
+Contact:	linux-integrity@vger.kernel.org
5050 Description:	The "durations" property shows the 3 vendor-specific values
5151 		used to wait for a short, medium and long TPM command. All
5252 		TPM commands are categorized as short, medium or long in
....@@ -54,9 +54,9 @@
5454 		any longer than necessary before starting to poll for a
5555 		result.
5656 
57
-		Example output:
57
+		Example output::
5858 
59
-		3015000 4508000 180995000 [original]
59
+		  3015000 4508000 180995000 [original]
6060 
6161 		Here the short, medium and long durations are displayed in
6262 		usecs. "[original]" indicates that the values are displayed
....@@ -69,7 +69,7 @@
6969 What:		/sys/class/tpm/tpmX/device/enabled
7070 Date:		April 2006
7171 KernelVersion:	2.6.17
72
-Contact:	tpmdd-devel@lists.sf.net
72
+Contact:	linux-integrity@vger.kernel.org
7373 Description:	The "enabled" property prints a '1' if the TPM chip is enabled,
7474 		meaning that it should be visible to the OS. This property
7575 		may be visible but produce a '0' after some operation that
....@@ -78,7 +78,7 @@
7878 What:		/sys/class/tpm/tpmX/device/owned
7979 Date:		April 2006
8080 KernelVersion:	2.6.17
81
-Contact:	tpmdd-devel@lists.sf.net
81
+Contact:	linux-integrity@vger.kernel.org
8282 Description:	The "owned" property produces a '1' if the TPM_TakeOwnership
8383 		ordinal has been executed successfully in the chip. A '0'
8484 		indicates that ownership hasn't been taken.
....@@ -86,20 +86,20 @@
8686 What:		/sys/class/tpm/tpmX/device/pcrs
8787 Date:		April 2005
8888 KernelVersion:	2.6.12
89
-Contact:	tpmdd-devel@lists.sf.net
89
+Contact:	linux-integrity@vger.kernel.org
9090 Description:	The "pcrs" property will dump the current value of all Platform
9191 		Configuration Registers in the TPM. Note that since these
9292 		values may be constantly changing, the output is only valid
9393 		for a snapshot in time.
9494 
95
-		Example output:
95
+		Example output::
9696 
97
-		PCR-00: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
98
-		PCR-01: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
99
-		PCR-02: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
100
-		PCR-03: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
101
-		PCR-04: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
102
-		...
97
+		  PCR-00: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
98
+		  PCR-01: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
99
+		  PCR-02: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
100
+		  PCR-03: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
101
+		  PCR-04: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
102
+		  ...
103103 
104104 		The number of PCRs and hex bytes needed to represent a PCR
105105 		value will vary depending on TPM chip version. For TPM 1.1 and
....@@ -109,7 +109,7 @@
109109 What:		/sys/class/tpm/tpmX/device/pubek
110110 Date:		April 2005
111111 KernelVersion:	2.6.12
112
-Contact:	tpmdd-devel@lists.sf.net
112
+Contact:	linux-integrity@vger.kernel.org
113113 Description:	The "pubek" property will return the TPM's public endorsement
114114 		key if possible. If the TPM has had ownership established and
115115 		is version 1.2, the pubek will not be available without the
....@@ -119,49 +119,49 @@
119119 		ated at TPM manufacture time and exists for the life of the
120120 		chip.
121121 
122
-		Example output:
122
+		Example output::
123123 
124
-		Algorithm: 00 00 00 01
125
-		Encscheme: 00 03
126
-		Sigscheme: 00 01
127
-		Parameters: 00 00 08 00 00 00 00 02 00 00 00 00
128
-		Modulus length: 256
129
-		Modulus:
130
-		B4 76 41 82 C9 20 2C 10 18 40 BC 8B E5 44 4C 6C
131
-		3A B2 92 0C A4 9B 2A 83 EB 5C 12 85 04 48 A0 B6
132
-		1E E4 81 84 CE B2 F2 45 1C F0 85 99 61 02 4D EB
133
-		86 C4 F7 F3 29 60 52 93 6B B2 E5 AB 8B A9 09 E3
134
-		D7 0E 7D CA 41 BF 43 07 65 86 3C 8C 13 7A D0 8B
135
-		82 5E 96 0B F8 1F 5F 34 06 DA A2 52 C1 A9 D5 26
136
-		0F F4 04 4B D9 3F 2D F2 AC 2F 74 64 1F 8B CD 3E
137
-		1E 30 38 6C 70 63 69 AB E2 50 DF 49 05 2E E1 8D
138
-		6F 78 44 DA 57 43 69 EE 76 6C 38 8A E9 8E A3 F0
139
-		A7 1F 3C A8 D0 12 15 3E CA 0E BD FA 24 CD 33 C6
140
-		47 AE A4 18 83 8E 22 39 75 93 86 E6 FD 66 48 B6
141
-		10 AD 94 14 65 F9 6A 17 78 BD 16 53 84 30 BF 70
142
-		E0 DC 65 FD 3C C6 B0 1E BF B9 C1 B5 6C EF B1 3A
143
-		F8 28 05 83 62 26 11 DC B4 6B 5A 97 FF 32 26 B6
144
-		F7 02 71 CF 15 AE 16 DD D1 C1 8E A8 CF 9B 50 7B
145
-		C3 91 FF 44 1E CF 7C 39 FE 17 77 21 20 BD CE 9B
124
+		  Algorithm: 00 00 00 01
125
+		  Encscheme: 00 03
126
+		  Sigscheme: 00 01
127
+		  Parameters: 00 00 08 00 00 00 00 02 00 00 00 00
128
+		  Modulus length: 256
129
+		  Modulus:
130
+		  B4 76 41 82 C9 20 2C 10 18 40 BC 8B E5 44 4C 6C
131
+		  3A B2 92 0C A4 9B 2A 83 EB 5C 12 85 04 48 A0 B6
132
+		  1E E4 81 84 CE B2 F2 45 1C F0 85 99 61 02 4D EB
133
+		  86 C4 F7 F3 29 60 52 93 6B B2 E5 AB 8B A9 09 E3
134
+		  D7 0E 7D CA 41 BF 43 07 65 86 3C 8C 13 7A D0 8B
135
+		  82 5E 96 0B F8 1F 5F 34 06 DA A2 52 C1 A9 D5 26
136
+		  0F F4 04 4B D9 3F 2D F2 AC 2F 74 64 1F 8B CD 3E
137
+		  1E 30 38 6C 70 63 69 AB E2 50 DF 49 05 2E E1 8D
138
+		  6F 78 44 DA 57 43 69 EE 76 6C 38 8A E9 8E A3 F0
139
+		  A7 1F 3C A8 D0 12 15 3E CA 0E BD FA 24 CD 33 C6
140
+		  47 AE A4 18 83 8E 22 39 75 93 86 E6 FD 66 48 B6
141
+		  10 AD 94 14 65 F9 6A 17 78 BD 16 53 84 30 BF 70
142
+		  E0 DC 65 FD 3C C6 B0 1E BF B9 C1 B5 6C EF B1 3A
143
+		  F8 28 05 83 62 26 11 DC B4 6B 5A 97 FF 32 26 B6
144
+		  F7 02 71 CF 15 AE 16 DD D1 C1 8E A8 CF 9B 50 7B
145
+		  C3 91 FF 44 1E CF 7C 39 FE 17 77 21 20 BD CE 9B
146146 
147
-		Possible values:
147
+		Possible values::
148148 
149
-		Algorithm:	TPM_ALG_RSA			(1)
150
-		Encscheme:	TPM_ES_RSAESPKCSv15		(2)
149
+		  Algorithm:	TPM_ALG_RSA			(1)
150
+		  Encscheme:	TPM_ES_RSAESPKCSv15		(2)
151151 				TPM_ES_RSAESOAEP_SHA1_MGF1	(3)
152
-		Sigscheme:	TPM_SS_NONE			(1)
153
-		Parameters, a byte string of 3 u32 values:
152
+		  Sigscheme:	TPM_SS_NONE			(1)
153
+		  Parameters, a byte string of 3 u32 values:
154154 			Key Length (bits):	00 00 08 00	(2048)
155155 			Num primes:		00 00 00 02	(2)
156156 			Exponent Size:		00 00 00 00	(0 means the
157157 								 default exp)
158
-		Modulus Length: 256 (bytes)
159
-		Modulus:	The 256 byte Endorsement Key modulus
158
+		  Modulus Length: 256 (bytes)
159
+		  Modulus:	The 256 byte Endorsement Key modulus
160160 
161161 What:		/sys/class/tpm/tpmX/device/temp_deactivated
162162 Date:		April 2006
163163 KernelVersion:	2.6.17
164
-Contact:	tpmdd-devel@lists.sf.net
164
+Contact:	linux-integrity@vger.kernel.org
165165 Description:	The "temp_deactivated" property returns a '1' if the chip has
166166 		been temporarily deactivated, usually until the next power
167167 		cycle. Whether a warm boot (reboot) will clear a TPM chip
....@@ -170,16 +170,27 @@
170170 What:		/sys/class/tpm/tpmX/device/timeouts
171171 Date:		March 2011
172172 KernelVersion:	3.1
173
-Contact:	tpmdd-devel@lists.sf.net
173
+Contact:	linux-integrity@vger.kernel.org
174174 Description:	The "timeouts" property shows the 4 vendor-specific values
175175 		for the TPM's interface spec timeouts. The use of these
176176 		timeouts is defined by the TPM interface spec that the chip
177177 		conforms to.
178178 
179
-		Example output:
179
+		Example output::
180180 
181
-		750000 750000 750000 750000 [original]
181
+		  750000 750000 750000 750000 [original]
182182 
183183 		The four timeout values are shown in usecs, with a trailing
184184 		"[original]" or "[adjusted]" depending on whether the values
185185 		were scaled by the driver to be reported in usec from msecs.
186
+
187
+What:		/sys/class/tpm/tpmX/tpm_version_major
188
+Date:		October 2019
189
+KernelVersion:	5.5
190
+Contact:	linux-integrity@vger.kernel.org
191
+Description:	The "tpm_version_major" property shows the TCG spec major version
192
+		implemented by the TPM device.
193
+
194
+		Example output::
195
+
196
+		  2