5 # = TPM (trusted platform module) devices
11 # An enumeration of TPM models
13 # @tpm-tis: TPM TIS model
17 { 'enum': 'TpmModel', 'data': [ 'tpm-tis' ] }
22 # Return a list of supported TPM models
24 # Returns: a list of TpmModel
30 # -> { "execute": "query-tpm-models" }
31 # <- { "return": [ "tpm-tis" ] }
34 { 'command': 'query-tpm-models', 'returns': ['TpmModel'] }
39 # An enumeration of TPM types
41 # @passthrough: TPM passthrough type
42 # @emulator: Software Emulator TPM type
47 { 'enum': 'TpmType', 'data': [ 'passthrough', 'emulator' ] }
52 # Return a list of supported TPM types
54 # Returns: a list of TpmType
60 # -> { "execute": "query-tpm-types" }
61 # <- { "return": [ "passthrough", "emulator" ] }
64 { 'command': 'query-tpm-types', 'returns': ['TpmType'] }
67 # @TPMPassthroughOptions:
69 # Information about the TPM passthrough type
71 # @path: string describing the path used for accessing the TPM device
73 # @cancel-path: string showing the TPM's sysfs cancel file
74 # for cancellation of TPM commands while they are executing
78 { 'struct': 'TPMPassthroughOptions', 'data': { '*path' : 'str',
79 '*cancel-path' : 'str'} }
82 # @TPMEmulatorOptions:
84 # Information about the TPM emulator type
86 # @chardev: Name of a unix socket chardev
90 { 'struct': 'TPMEmulatorOptions', 'data': { 'chardev' : 'str' } }
95 # A union referencing different TPM backend types' configuration options
97 # @type: 'passthrough' The configuration options for the TPM passthrough type
98 # 'emulator' The configuration options for TPM emulator backend type
102 { 'union': 'TpmTypeOptions',
103 'data': { 'passthrough' : 'TPMPassthroughOptions',
104 'emulator': 'TPMEmulatorOptions' } }
109 # Information about the TPM
111 # @id: The Id of the TPM
113 # @model: The TPM frontend model
115 # @options: The TPM (backend) type configuration options
119 { 'struct': 'TPMInfo',
120 'data': {'id': 'str',
122 'options': 'TpmTypeOptions' } }
127 # Return information about the TPM device
129 # Returns: @TPMInfo on success
135 # -> { "execute": "query-tpm" }
138 # { "model": "tpm-tis",
140 # { "type": "passthrough",
142 # { "cancel-path": "/sys/class/misc/tpm0/device/cancel",
143 # "path": "/dev/tpm0"
152 { 'command': 'query-tpm', 'returns': ['TPMInfo'] }