← Documents Documentation/ABI/testing/sysfs-driver-ppi GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

TPM Physical Presence Interface sysfs ABI

BIOS가 지원하는 TPM Physical Presence Interface의 version, pre-OS request·response·transition과 TCG·vendor-specific operation permissions를 설명합니다.

Source pathDocumentation/ABI/testing/sysfs-driver-ppi
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

PPI directory and version

sysfs-driver-ppi:1-25

PPI directory는 BIOS TPM support가 있을 때 의미가 있고 Linux 4.2부터 character-device directory로 이동했으며 compatibility symlink를 제공합니다.

Pre-OS request, response and transition

sysfs-driver-ppi:26-54

OS는 request에 1~160 operation을 기록하고, response와 transition_action에서 최근 결과와 BIOS 전환 동작을 정해진 format으로 읽습니다.

TCG and vendor operation permissions

sysfs-driver-ppi:55-75

PPI 1.2 이상은 TCG requests 1~22와 vendor-specific requests 128~255의 pre-OS 실행 요청 허용 상태를 각각 노출합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 What: /sys/class/tpm/tpmX/ppi/
2 Date: August 2012
3 KernelVersion: 3.6
4 Contact: xiaoyan.zhang@intel.com
5 Description:
6 This folder includes the attributes related with PPI (Physical
7 Presence Interface). Only if TPM is supported by BIOS, this
8 folder makes sense. The folder path can be got by command
9 'find /sys/ -name 'pcrs''. For the detail information of PPI,
10 please refer to the PPI specification from
11
12 http://www.trustedcomputinggroup.org/
13
14 In Linux 4.2 ppi was moved to the character device directory.
15 A symlink from tpmX/device/ppi to tpmX/ppi to provide backwards
16 compatibility.
17
18 What: /sys/class/tpm/tpmX/ppi/version
19 Date: August 2012
20 Contact: xiaoyan.zhang@intel.com
21 Description:
22 This attribute shows the version of the PPI supported by the
23 platform.
24 This file is readonly.
25
26 What: /sys/class/tpm/tpmX/ppi/request
27 Date: August 2012
28 Contact: xiaoyan.zhang@intel.com
29 Description:
30 This attribute shows the request for an operation to be
31 executed in the pre-OS environment. It is the only input from
32 the OS to the pre-OS environment. The request should be an
33 integer value range from 1 to 160, and 0 means no request.
34 This file can be read and written.
35
36 What: /sys/class/tpm/tpmX/ppi/response
37 Date: August 2012
38 Contact: xiaoyan.zhang@intel.com
39 Description:
40 This attribute shows the response to the most recent operation
41 request it acted upon. The format is "<request> <response num>
42 : <response description>".
43 This file is readonly.
44
45 What: /sys/class/tpm/tpmX/ppi/transition_action
46 Date: August 2012
47 Contact: xiaoyan.zhang@intel.com
48 Description:
49 This attribute shows the platform-specific action that should
50 take place in order to transition to the BIOS for execution of
51 a requested operation. The format is "<action num>: <action
52 description>".
53 This file is readonly.
54
55 What: /sys/class/tpm/tpmX/ppi/tcg_operations
56 Date: August 2012
57 Contact: xiaoyan.zhang@intel.com
58 Description:
59 This attribute shows whether it is allowed to request an
60 operation to be executed in the pre-OS environment by the BIOS
61 for the requests defined by TCG, i.e. requests from 1 to 22.
62 The format is "<request> <status num>: <status description>".
63 This attribute is only supported by PPI version 1.2+.
64 This file is readonly.
65
66 What: /sys/class/tpm/tpmX/ppi/vs_operations
67 Date: August 2012
68 Contact: xiaoyan.zhang@intel.com
69 Description:
70 This attribute shows whether it is allowed to request an
71 operation to be executed in the pre-OS environment by the BIOS
72 for the verdor specific requests, i.e. requests from 128 to
73 255. The format is same with tcg_operations. This attribute
74 is also only supported by PPI version 1.2+.
75 This file is readonly.
76

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

TPM Physical Presence Interface directory

1-17
항목한국어 전문 번역
What/sys/class/tpm/tpmX/ppi/
Date2012년 8월
KernelVersion3.6
Contactxiaoyan.zhang@intel.com
DescriptionPPI(Physical Presence Interface) 관련 attributes를 포함하는 folder입니다. BIOS가 TPM을 지원할 때만 이 folder가 의미가 있습니다. Folder path는 'find /sys/ -name 'pcrs'' command로 찾을 수 있으며 자세한 PPI 정보는 Trusted Computing Group specification을 참조합니다. Linux 4.2에서 ppi는 character device directory로 이동했고, backward compatibility를 위해 tpmX/device/ppi에서 tpmX/ppi로 향하는 symlink를 제공합니다.
Specificationhttp://www.trustedcomputinggroup.org/
TPM PPI attributes
AttributeAccessValue / format
versionRead-onlyPlatform-supported PPI version
requestRead-write0 or operation 1..160
responseRead-only<request> <response num> : <response description>
transition_actionRead-only<action num>: <action description>
tcg_operationsRead-only; PPI 1.2+TCG requests 1..22
vs_operationsRead-only; PPI 1.2+Vendor requests 128..255

PPI directory의 request path, output formats와 version constraints를 정리했습니다.

Platform PPI version

18-25
항목한국어 전문 번역
What/sys/class/tpm/tpmX/ppi/version
Date2012년 8월
Contactxiaoyan.zhang@intel.com
DescriptionPlatform이 지원하는 PPI version을 표시합니다.
AccessRead-only

Pre-OS operation request

26-35
항목한국어 전문 번역
What/sys/class/tpm/tpmX/ppi/request
Date2012년 8월
Contactxiaoyan.zhang@intel.com
DescriptionPre-OS environment에서 실행할 operation request를 표시합니다. OS에서 pre-OS environment로 전달하는 유일한 input입니다. Request는 1~160 범위의 integer여야 하고 0은 request가 없음을 뜻합니다.
AccessRead-write
Values0, or 1..160

Most recent PPI response

36-44
항목한국어 전문 번역
What/sys/class/tpm/tpmX/ppi/response
Date2012년 8월
Contactxiaoyan.zhang@intel.com
DescriptionPlatform이 처리한 가장 최근 operation request의 response를 표시합니다. Format은 "<request> <response num> : <response description>"입니다.
AccessRead-only

BIOS transition action

45-54
항목한국어 전문 번역
What/sys/class/tpm/tpmX/ppi/transition_action
Date2012년 8월
Contactxiaoyan.zhang@intel.com
DescriptionRequested operation을 실행하기 위해 BIOS로 transition할 때 수행해야 하는 platform-specific action을 표시합니다. Format은 "<action num>: <action description>"입니다.
AccessRead-only

TCG operation request permissions

55-65
항목한국어 전문 번역
What/sys/class/tpm/tpmX/ppi/tcg_operations
Date2012년 8월
Contactxiaoyan.zhang@intel.com
DescriptionTCG가 정의한 requests 1~22에 대해 BIOS가 pre-OS environment에서 operation을 실행하도록 요청할 수 있는지를 표시합니다. Format은 "<request> <status num>: <status description>"입니다. PPI version 1.2 이상에서만 지원합니다.
AccessRead-only

Vendor-specific operation permissions

66-75
항목한국어 전문 번역
What/sys/class/tpm/tpmX/ppi/vs_operations
Date2012년 8월
Contactxiaoyan.zhang@intel.com
DescriptionVendor-specific requests 128~255에 대해 BIOS가 pre-OS environment에서 operation을 실행하도록 요청할 수 있는지를 표시합니다. Format은 tcg_operations와 같으며 이 attribute도 PPI version 1.2 이상에서만 지원합니다.
AccessRead-only