2 * TPM utility functions
4 * Copyright (c) 2010 - 2015 IBM Corporation
6 * Stefan Berger <stefanb@us.ibm.com>
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with this library; if not, see <http://www.gnu.org/licenses/>
22 #include "qemu/osdep.h"
23 #include "qemu/error-report.h"
24 #include "qapi/error.h"
25 #include "qapi/visitor.h"
27 #include "exec/memory.h"
28 #include "hw/qdev-properties.h"
29 #include "sysemu/tpm_backend.h"
30 #include "sysemu/tpm_util.h"
33 /* tpm backend property */
35 static void get_tpm(Object *obj, Visitor *v, const char *name, void *opaque,
38 TPMBackend **be = object_field_prop_ptr(obj, opaque);
41 p = g_strdup(*be ? (*be)->id : "");
42 visit_type_str(v, name, &p, errp);
46 static void set_tpm(Object *obj, Visitor *v, const char *name, void *opaque,
49 Property *prop = opaque;
50 TPMBackend *s, **be = object_field_prop_ptr(obj, prop);
53 if (!visit_type_str(v, name, &str, errp)) {
57 s = qemu_find_tpm_be(str);
59 error_setg(errp, "Property '%s.%s' can't find value '%s'",
60 object_get_typename(obj), name, str);
61 } else if (tpm_backend_init(s, TPM_IF(obj), errp) == 0) {
62 *be = s; /* weak reference, avoid cyclic ref */
67 static void release_tpm(Object *obj, const char *name, void *opaque)
69 Property *prop = opaque;
70 TPMBackend **be = object_field_prop_ptr(obj, prop);
73 tpm_backend_reset(*be);
77 const PropertyInfo qdev_prop_tpm = {
79 .description = "ID of a tpm to use as a backend",
82 .release = release_tpm,
86 * Write an error message in the given output buffer.
88 void tpm_util_write_fatal_error_response(uint8_t *out, uint32_t out_len)
90 if (out_len >= sizeof(struct tpm_resp_hdr)) {
91 tpm_cmd_set_tag(out, TPM_TAG_RSP_COMMAND);
92 tpm_cmd_set_size(out, sizeof(struct tpm_resp_hdr));
93 tpm_cmd_set_error(out, TPM_FAIL);
97 bool tpm_util_is_selftest(const uint8_t *in, uint32_t in_len)
99 if (in_len >= sizeof(struct tpm_req_hdr)) {
100 return tpm_cmd_get_ordinal(in) == TPM_ORD_ContinueSelfTest;
107 * Send request to a TPM device. We expect a response within one second.
109 static int tpm_util_request(int fd,
117 struct timeval tv = {
122 n = write(fd, request, requestlen);
126 if (n != requestlen) {
131 FD_SET(fd, &readfds);
133 /* wait for a second */
134 n = select(fd + 1, &readfds, NULL, NULL, &tv);
139 n = read(fd, response, responselen);
140 if (n < sizeof(struct tpm_resp_hdr)) {
144 /* check the header */
145 if (tpm_cmd_get_size(response) != n) {
153 * A basic test of a TPM device. We expect a well formatted response header
154 * (error response is fine).
156 static int tpm_util_test(int fd,
159 uint16_t *return_tag)
164 ret = tpm_util_request(fd, request, requestlen,
170 *return_tag = tpm_cmd_get_tag(buf);
176 * Probe for the TPM device in the back
177 * Returns 0 on success with the version of the probed TPM set, 1 on failure.
179 int tpm_util_test_tpmdev(int tpm_fd, TPMVersion *tpm_version)
182 * Sending a TPM1.2 command to a TPM2 should return a TPM1.2
183 * header (tag = 0xc4) and error code (TPM_BADTAG = 0x1e)
185 * Sending a TPM2 command to a TPM 2 will give a TPM 2 tag in the
187 * Sending a TPM2 command to a TPM 1.2 will give a TPM 1.2 tag
188 * in the header and an error code.
190 const struct tpm_req_hdr test_req = {
191 .tag = cpu_to_be16(TPM_TAG_RQU_COMMAND),
192 .len = cpu_to_be32(sizeof(test_req)),
193 .ordinal = cpu_to_be32(TPM_ORD_GetTicks),
196 const struct tpm_req_hdr test_req_tpm2 = {
197 .tag = cpu_to_be16(TPM2_ST_NO_SESSIONS),
198 .len = cpu_to_be32(sizeof(test_req_tpm2)),
199 .ordinal = cpu_to_be32(TPM2_CC_ReadClock),
204 /* Send TPM 2 command */
205 ret = tpm_util_test(tpm_fd, &test_req_tpm2,
206 sizeof(test_req_tpm2), &return_tag);
207 /* TPM 2 would respond with a tag of TPM2_ST_NO_SESSIONS */
208 if (!ret && return_tag == TPM2_ST_NO_SESSIONS) {
209 *tpm_version = TPM_VERSION_2_0;
213 /* Send TPM 1.2 command */
214 ret = tpm_util_test(tpm_fd, &test_req,
215 sizeof(test_req), &return_tag);
216 if (!ret && return_tag == TPM_TAG_RSP_COMMAND) {
217 *tpm_version = TPM_VERSION_1_2;
218 /* this is a TPM 1.2 */
222 *tpm_version = TPM_VERSION_UNSPEC;
227 int tpm_util_get_buffer_size(int tpm_fd, TPMVersion tpm_version,
232 switch (tpm_version) {
233 case TPM_VERSION_1_2: {
234 const struct tpm_req_get_buffer_size {
235 struct tpm_req_hdr hdr;
239 } QEMU_PACKED tpm_get_buffer_size = {
241 .tag = cpu_to_be16(TPM_TAG_RQU_COMMAND),
242 .len = cpu_to_be32(sizeof(tpm_get_buffer_size)),
243 .ordinal = cpu_to_be32(TPM_ORD_GetCapability),
245 .capability = cpu_to_be32(TPM_CAP_PROPERTY),
246 .len = cpu_to_be32(sizeof(uint32_t)),
247 .subcap = cpu_to_be32(TPM_CAP_PROP_INPUT_BUFFER),
249 struct tpm_resp_get_buffer_size {
250 struct tpm_resp_hdr hdr;
253 } QEMU_PACKED tpm_resp;
255 ret = tpm_util_request(tpm_fd, &tpm_get_buffer_size,
256 sizeof(tpm_get_buffer_size),
257 &tpm_resp, sizeof(tpm_resp));
262 if (be32_to_cpu(tpm_resp.hdr.len) != sizeof(tpm_resp) ||
263 be32_to_cpu(tpm_resp.len) != sizeof(uint32_t)) {
264 trace_tpm_util_get_buffer_size_hdr_len(
265 be32_to_cpu(tpm_resp.hdr.len),
267 trace_tpm_util_get_buffer_size_len(be32_to_cpu(tpm_resp.len),
269 error_report("tpm_util: Got unexpected response to "
270 "TPM_GetCapability; errcode: 0x%x",
271 be32_to_cpu(tpm_resp.hdr.errcode));
274 *buffersize = be32_to_cpu(tpm_resp.buffersize);
277 case TPM_VERSION_2_0: {
278 const struct tpm2_req_get_buffer_size {
279 struct tpm_req_hdr hdr;
283 } QEMU_PACKED tpm2_get_buffer_size = {
285 .tag = cpu_to_be16(TPM2_ST_NO_SESSIONS),
286 .len = cpu_to_be32(sizeof(tpm2_get_buffer_size)),
287 .ordinal = cpu_to_be32(TPM2_CC_GetCapability),
289 .capability = cpu_to_be32(TPM2_CAP_TPM_PROPERTIES),
290 .property = cpu_to_be32(TPM2_PT_MAX_COMMAND_SIZE),
291 .count = cpu_to_be32(2), /* also get TPM2_PT_MAX_RESPONSE_SIZE */
293 struct tpm2_resp_get_buffer_size {
294 struct tpm_resp_hdr hdr;
302 } QEMU_PACKED tpm2_resp;
304 ret = tpm_util_request(tpm_fd, &tpm2_get_buffer_size,
305 sizeof(tpm2_get_buffer_size),
306 &tpm2_resp, sizeof(tpm2_resp));
311 if (be32_to_cpu(tpm2_resp.hdr.len) != sizeof(tpm2_resp) ||
312 be32_to_cpu(tpm2_resp.count) != 2) {
313 trace_tpm_util_get_buffer_size_hdr_len2(
314 be32_to_cpu(tpm2_resp.hdr.len),
316 trace_tpm_util_get_buffer_size_len2(
317 be32_to_cpu(tpm2_resp.count), 2);
318 error_report("tpm_util: Got unexpected response to "
319 "TPM2_GetCapability; errcode: 0x%x",
320 be32_to_cpu(tpm2_resp.hdr.errcode));
323 *buffersize = MAX(be32_to_cpu(tpm2_resp.value1),
324 be32_to_cpu(tpm2_resp.value2));
327 case TPM_VERSION_UNSPEC:
331 trace_tpm_util_get_buffer_size(*buffersize);
336 void tpm_sized_buffer_reset(TPMSizedBuffer *tsb)
343 void tpm_util_show_buffer(const unsigned char *buffer,
344 size_t buffer_size, const char *string)
347 char *line_buffer, *p;
349 if (!trace_event_get_state_backends(TRACE_TPM_UTIL_SHOW_BUFFER)) {
352 len = MIN(tpm_cmd_get_size(buffer), buffer_size);
355 * allocate enough room for 3 chars per buffer entry plus a
356 * newline after every 16 chars and a final null terminator.
358 line_buffer = g_malloc(len * 3 + (len / 16) + 1);
360 for (i = 0, p = line_buffer; i < len; i++) {
361 if (i && !(i % 16)) {
362 p += sprintf(p, "\n");
364 p += sprintf(p, "%.2X ", buffer[i]);
366 trace_tpm_util_show_buffer(string, len, line_buffer);