xref: /linux/Documentation/translations/zh_CN/security/tpm/tpm_vtpm_proxy.rst (revision bbfd5594756011167b8f8de9a00e0c946afda1e6)
1*f7824b69SShuo Zhao.. SPDX-License-Identifier: GPL-2.0
2*f7824b69SShuo Zhao.. include:: ../../disclaimer-zh_CN.rst
3*f7824b69SShuo Zhao
4*f7824b69SShuo Zhao:Original: Documentation/security/tpm/tpm_vtpm_proxy.rst
5*f7824b69SShuo Zhao
6*f7824b69SShuo Zhao:翻译:
7*f7824b69SShuo Zhao 赵硕 Shuo Zhao <zhaoshuo@cqsoftware.com.cn>
8*f7824b69SShuo Zhao
9*f7824b69SShuo Zhao==========================
10*f7824b69SShuo ZhaoLinux容器的虚拟TPM代理驱动
11*f7824b69SShuo Zhao==========================
12*f7824b69SShuo Zhao
13*f7824b69SShuo Zhao| 作者:
14*f7824b69SShuo Zhao| Stefan Berger <stefanb@linux.vnet.ibm.com>
15*f7824b69SShuo Zhao
16*f7824b69SShuo Zhao本文档描述了用于Linux容器的虚拟可信平台模块(vTPM)代理设备驱动。
17*f7824b69SShuo Zhao
18*f7824b69SShuo Zhao介绍
19*f7824b69SShuo Zhao====
20*f7824b69SShuo Zhao
21*f7824b69SShuo Zhao这项工作的目标是为每个Linux容器提供TPM功能。这使得程序能够像与物理系统
22*f7824b69SShuo Zhao上的TPM交互一样,与容器中的TPM进行交互。每个容器都会获得一个唯一的、模
23*f7824b69SShuo Zhao拟的软件TPM。
24*f7824b69SShuo Zhao
25*f7824b69SShuo Zhao设计
26*f7824b69SShuo Zhao====
27*f7824b69SShuo Zhao
28*f7824b69SShuo Zhao为了使每个容器都能使用模拟的软件TPM,容器管理栈需要创建一对设备,其中
29*f7824b69SShuo Zhao包括一个客户端TPM字符设备 ``/dev/tpmX`` (X=0,1,2...)和一个‘服务器端’
30*f7824b69SShuo Zhao文件描述符。当文件描述符传被递给TPM模拟器时,前者通过创建具有适当主次
31*f7824b69SShuo Zhao设备号的字符设备被移入容器,然后,容器内的软件可以使用字符设备发送TPM
32*f7824b69SShuo Zhao命令,模拟器将通过文件描述符接收这些命令,并用它来发送响应。
33*f7824b69SShuo Zhao
34*f7824b69SShuo Zhao为了支持这一点,虚拟TPM代理驱动程序提供了一个设备 ``/dev/vtpmx`` ,该设备
35*f7824b69SShuo Zhao用于通过ioctl创建设备对。ioctl将其作为配置设备的输入标志,例如这些标志指示
36*f7824b69SShuo ZhaoTPM模拟器是否支持TPM1.2或TPM2功能。ioctl的结果是返回‘服务器端’的文件描述符
37*f7824b69SShuo Zhao以及创建的字符设备的主次设备号。此外,还会返回TPM字符设备的编号。例如,如果
38*f7824b69SShuo Zhao创建了 ``/dev/tpm10`` ,则返回编号( ``dev_num`` )10。
39*f7824b69SShuo Zhao
40*f7824b69SShuo Zhao一旦设备被创建,驱动程序将立即尝试与TPM进行通信。来自驱动程序的所有命令
41*f7824b69SShuo Zhao都可以从ioctl返回的文件描述符中读取。这些命令应该立即得到响应。
42*f7824b69SShuo Zhao
43*f7824b69SShuo ZhaoUAPI
44*f7824b69SShuo Zhao====
45*f7824b69SShuo Zhao
46*f7824b69SShuo Zhao该API在以下内核代码中:
47*f7824b69SShuo Zhao
48*f7824b69SShuo Zhaoinclude/uapi/linux/vtpm_proxy.h
49*f7824b69SShuo Zhaodrivers/char/tpm/tpm_vtpm_proxy.c
50*f7824b69SShuo Zhao
51*f7824b69SShuo Zhao函数:vtpmx_ioc_new_dev
52