root / include / sysemu / tpm_backend.h @ dccfcd0e
History | View | Annotate | Download (5 kB)
1 | 8f0605cc | Stefan Berger | /*
|
---|---|---|---|
2 | 8f0605cc | Stefan Berger | * QEMU TPM Backend
|
3 | 8f0605cc | Stefan Berger | *
|
4 | 8f0605cc | Stefan Berger | * Copyright IBM, Corp. 2013
|
5 | 8f0605cc | Stefan Berger | *
|
6 | 8f0605cc | Stefan Berger | * Authors:
|
7 | 8f0605cc | Stefan Berger | * Stefan Berger <stefanb@us.ibm.com>
|
8 | 8f0605cc | Stefan Berger | *
|
9 | 8f0605cc | Stefan Berger | * This work is licensed under the terms of the GNU GPL, version 2 or later.
|
10 | 8f0605cc | Stefan Berger | * See the COPYING file in the top-level directory.
|
11 | 8f0605cc | Stefan Berger | */
|
12 | 8f0605cc | Stefan Berger | |
13 | 8f0605cc | Stefan Berger | #ifndef _QEMU_TPM_H
|
14 | 8f0605cc | Stefan Berger | #define _QEMU_TPM_H
|
15 | 8f0605cc | Stefan Berger | |
16 | 8f0605cc | Stefan Berger | #include "qom/object.h" |
17 | 8f0605cc | Stefan Berger | #include "qemu-common.h" |
18 | 8f0605cc | Stefan Berger | #include "qapi/error.h" |
19 | 8f0605cc | Stefan Berger | #include "qapi-types.h" |
20 | 8f0605cc | Stefan Berger | #include "qemu/option.h" |
21 | bdee56f5 | Paolo Bonzini | #include "sysemu/tpm.h" |
22 | 8f0605cc | Stefan Berger | |
23 | 8f0605cc | Stefan Berger | #define TYPE_TPM_BACKEND "tpm-backend" |
24 | 8f0605cc | Stefan Berger | #define TPM_BACKEND(obj) \
|
25 | 8f0605cc | Stefan Berger | OBJECT_CHECK(TPMBackend, (obj), TYPE_TPM_BACKEND) |
26 | 8f0605cc | Stefan Berger | #define TPM_BACKEND_GET_CLASS(obj) \
|
27 | 8f0605cc | Stefan Berger | OBJECT_GET_CLASS(TPMBackendClass, (obj), TYPE_TPM_BACKEND) |
28 | 8f0605cc | Stefan Berger | #define TPM_BACKEND_CLASS(klass) \
|
29 | 8f0605cc | Stefan Berger | OBJECT_CLASS_CHECK(TPMBackendClass, (klass), TYPE_TPM_BACKEND) |
30 | 8f0605cc | Stefan Berger | |
31 | 8f0605cc | Stefan Berger | typedef struct TPMBackendClass TPMBackendClass; |
32 | 8f0605cc | Stefan Berger | typedef struct TPMBackend TPMBackend; |
33 | 8f0605cc | Stefan Berger | |
34 | 8f0605cc | Stefan Berger | typedef struct TPMDriverOps TPMDriverOps; |
35 | 8f0605cc | Stefan Berger | |
36 | 8f0605cc | Stefan Berger | struct TPMBackendClass {
|
37 | 8f0605cc | Stefan Berger | ObjectClass parent_class; |
38 | 8f0605cc | Stefan Berger | |
39 | 8f0605cc | Stefan Berger | const TPMDriverOps *ops;
|
40 | 8f0605cc | Stefan Berger | |
41 | 8f0605cc | Stefan Berger | void (*opened)(TPMBackend *s, Error **errp);
|
42 | 8f0605cc | Stefan Berger | }; |
43 | 8f0605cc | Stefan Berger | |
44 | 8f0605cc | Stefan Berger | struct TPMBackend {
|
45 | 8f0605cc | Stefan Berger | Object parent; |
46 | 8f0605cc | Stefan Berger | |
47 | 8f0605cc | Stefan Berger | /*< protected >*/
|
48 | 8f0605cc | Stefan Berger | bool opened;
|
49 | 8f0605cc | Stefan Berger | |
50 | 8f0605cc | Stefan Berger | char *id;
|
51 | 8f0605cc | Stefan Berger | enum TpmModel fe_model;
|
52 | 8f0605cc | Stefan Berger | char *path;
|
53 | 8f0605cc | Stefan Berger | char *cancel_path;
|
54 | 8f0605cc | Stefan Berger | const TPMDriverOps *ops;
|
55 | 8f0605cc | Stefan Berger | |
56 | 8f0605cc | Stefan Berger | QLIST_ENTRY(TPMBackend) list; |
57 | 8f0605cc | Stefan Berger | }; |
58 | 8f0605cc | Stefan Berger | |
59 | bdee56f5 | Paolo Bonzini | typedef void (TPMRecvDataCB)(TPMState *, uint8_t locty); |
60 | bdee56f5 | Paolo Bonzini | |
61 | bdee56f5 | Paolo Bonzini | typedef struct TPMSizedBuffer { |
62 | bdee56f5 | Paolo Bonzini | uint32_t size; |
63 | bdee56f5 | Paolo Bonzini | uint8_t *buffer; |
64 | bdee56f5 | Paolo Bonzini | } TPMSizedBuffer; |
65 | bdee56f5 | Paolo Bonzini | |
66 | bdee56f5 | Paolo Bonzini | struct TPMDriverOps {
|
67 | bdee56f5 | Paolo Bonzini | enum TpmType type;
|
68 | bdee56f5 | Paolo Bonzini | /* get a descriptive text of the backend to display to the user */
|
69 | bdee56f5 | Paolo Bonzini | const char *(*desc)(void); |
70 | bdee56f5 | Paolo Bonzini | |
71 | bdee56f5 | Paolo Bonzini | TPMBackend *(*create)(QemuOpts *opts, const char *id); |
72 | bdee56f5 | Paolo Bonzini | void (*destroy)(TPMBackend *t);
|
73 | bdee56f5 | Paolo Bonzini | |
74 | bdee56f5 | Paolo Bonzini | /* initialize the backend */
|
75 | bdee56f5 | Paolo Bonzini | int (*init)(TPMBackend *t, TPMState *s, TPMRecvDataCB *datacb);
|
76 | bdee56f5 | Paolo Bonzini | /* start up the TPM on the backend */
|
77 | bdee56f5 | Paolo Bonzini | int (*startup_tpm)(TPMBackend *t);
|
78 | bdee56f5 | Paolo Bonzini | /* returns true if nothing will ever answer TPM requests */
|
79 | bdee56f5 | Paolo Bonzini | bool (*had_startup_error)(TPMBackend *t);
|
80 | bdee56f5 | Paolo Bonzini | |
81 | bdee56f5 | Paolo Bonzini | size_t (*realloc_buffer)(TPMSizedBuffer *sb); |
82 | bdee56f5 | Paolo Bonzini | |
83 | bdee56f5 | Paolo Bonzini | void (*deliver_request)(TPMBackend *t);
|
84 | bdee56f5 | Paolo Bonzini | |
85 | bdee56f5 | Paolo Bonzini | void (*reset)(TPMBackend *t);
|
86 | bdee56f5 | Paolo Bonzini | |
87 | bdee56f5 | Paolo Bonzini | void (*cancel_cmd)(TPMBackend *t);
|
88 | bdee56f5 | Paolo Bonzini | |
89 | bdee56f5 | Paolo Bonzini | bool (*get_tpm_established_flag)(TPMBackend *t);
|
90 | bdee56f5 | Paolo Bonzini | }; |
91 | bdee56f5 | Paolo Bonzini | |
92 | 8f0605cc | Stefan Berger | |
93 | 8f0605cc | Stefan Berger | /**
|
94 | 8f0605cc | Stefan Berger | * tpm_backend_get_type:
|
95 | 8f0605cc | Stefan Berger | * @s: the backend
|
96 | 8f0605cc | Stefan Berger | *
|
97 | 8f0605cc | Stefan Berger | * Returns the TpmType of the backend.
|
98 | 8f0605cc | Stefan Berger | */
|
99 | 8f0605cc | Stefan Berger | enum TpmType tpm_backend_get_type(TPMBackend *s);
|
100 | 8f0605cc | Stefan Berger | |
101 | 8f0605cc | Stefan Berger | /**
|
102 | 8f0605cc | Stefan Berger | * tpm_backend_get_desc:
|
103 | 8f0605cc | Stefan Berger | * @s: the backend
|
104 | 8f0605cc | Stefan Berger | *
|
105 | 8f0605cc | Stefan Berger | * Returns a human readable description of the backend.
|
106 | 8f0605cc | Stefan Berger | */
|
107 | 8f0605cc | Stefan Berger | const char *tpm_backend_get_desc(TPMBackend *s); |
108 | 8f0605cc | Stefan Berger | |
109 | 8f0605cc | Stefan Berger | /**
|
110 | 8f0605cc | Stefan Berger | * tpm_backend_destroy:
|
111 | 8f0605cc | Stefan Berger | * @s: the backend to destroy
|
112 | 8f0605cc | Stefan Berger | */
|
113 | 8f0605cc | Stefan Berger | void tpm_backend_destroy(TPMBackend *s);
|
114 | 8f0605cc | Stefan Berger | |
115 | 8f0605cc | Stefan Berger | /**
|
116 | 8f0605cc | Stefan Berger | * tpm_backend_init:
|
117 | 8f0605cc | Stefan Berger | * @s: the backend to initialized
|
118 | 8f0605cc | Stefan Berger | * @state: TPMState
|
119 | 8f0605cc | Stefan Berger | * @datacb: callback for sending data to frontend
|
120 | 8f0605cc | Stefan Berger | *
|
121 | 8f0605cc | Stefan Berger | * Initialize the backend with the given variables.
|
122 | 8f0605cc | Stefan Berger | *
|
123 | 8f0605cc | Stefan Berger | * Returns 0 on success.
|
124 | 8f0605cc | Stefan Berger | */
|
125 | 8f0605cc | Stefan Berger | int tpm_backend_init(TPMBackend *s, TPMState *state,
|
126 | 8f0605cc | Stefan Berger | TPMRecvDataCB *datacb); |
127 | 8f0605cc | Stefan Berger | |
128 | 8f0605cc | Stefan Berger | /**
|
129 | 8f0605cc | Stefan Berger | * tpm_backend_startup_tpm:
|
130 | 8f0605cc | Stefan Berger | * @s: the backend whose TPM support is to be started
|
131 | 8f0605cc | Stefan Berger | *
|
132 | 8f0605cc | Stefan Berger | * Returns 0 on success.
|
133 | 8f0605cc | Stefan Berger | */
|
134 | 8f0605cc | Stefan Berger | int tpm_backend_startup_tpm(TPMBackend *s);
|
135 | 8f0605cc | Stefan Berger | |
136 | 8f0605cc | Stefan Berger | /**
|
137 | 8f0605cc | Stefan Berger | * tpm_backend_had_startup_error:
|
138 | 8f0605cc | Stefan Berger | * @s: the backend to query for a statup error
|
139 | 8f0605cc | Stefan Berger | *
|
140 | 8f0605cc | Stefan Berger | * Check whether the backend had an error during startup. Returns
|
141 | 8f0605cc | Stefan Berger | * false if no error occurred and the backend can be used, true
|
142 | 8f0605cc | Stefan Berger | * otherwise.
|
143 | 8f0605cc | Stefan Berger | */
|
144 | 8f0605cc | Stefan Berger | bool tpm_backend_had_startup_error(TPMBackend *s);
|
145 | 8f0605cc | Stefan Berger | |
146 | 8f0605cc | Stefan Berger | /**
|
147 | 8f0605cc | Stefan Berger | * tpm_backend_realloc_buffer:
|
148 | 8f0605cc | Stefan Berger | * @s: the backend
|
149 | 8f0605cc | Stefan Berger | * @sb: the TPMSizedBuffer to re-allocated to the size suitable for the
|
150 | 8f0605cc | Stefan Berger | * backend.
|
151 | 8f0605cc | Stefan Berger | *
|
152 | 8f0605cc | Stefan Berger | * This function returns the size of the allocated buffer
|
153 | 8f0605cc | Stefan Berger | */
|
154 | 8f0605cc | Stefan Berger | size_t tpm_backend_realloc_buffer(TPMBackend *s, TPMSizedBuffer *sb); |
155 | 8f0605cc | Stefan Berger | |
156 | 8f0605cc | Stefan Berger | /**
|
157 | 8f0605cc | Stefan Berger | * tpm_backend_deliver_request:
|
158 | 8f0605cc | Stefan Berger | * @s: the backend to send the request to
|
159 | 8f0605cc | Stefan Berger | *
|
160 | 8f0605cc | Stefan Berger | * Send a request to the backend. The backend will then send the request
|
161 | 8f0605cc | Stefan Berger | * to the TPM implementation.
|
162 | 8f0605cc | Stefan Berger | */
|
163 | 8f0605cc | Stefan Berger | void tpm_backend_deliver_request(TPMBackend *s);
|
164 | 8f0605cc | Stefan Berger | |
165 | 8f0605cc | Stefan Berger | /**
|
166 | 8f0605cc | Stefan Berger | * tpm_backend_reset:
|
167 | 8f0605cc | Stefan Berger | * @s: the backend to reset
|
168 | 8f0605cc | Stefan Berger | *
|
169 | 8f0605cc | Stefan Berger | * Reset the backend into a well defined state with all previous errors
|
170 | 8f0605cc | Stefan Berger | * reset.
|
171 | 8f0605cc | Stefan Berger | */
|
172 | 8f0605cc | Stefan Berger | void tpm_backend_reset(TPMBackend *s);
|
173 | 8f0605cc | Stefan Berger | |
174 | 8f0605cc | Stefan Berger | /**
|
175 | 8f0605cc | Stefan Berger | * tpm_backend_cancel_cmd:
|
176 | 8f0605cc | Stefan Berger | * @s: the backend
|
177 | 8f0605cc | Stefan Berger | *
|
178 | 8f0605cc | Stefan Berger | * Cancel any ongoing command being processed by the TPM implementation
|
179 | 8f0605cc | Stefan Berger | * on behalf of the QEMU guest.
|
180 | 8f0605cc | Stefan Berger | */
|
181 | 8f0605cc | Stefan Berger | void tpm_backend_cancel_cmd(TPMBackend *s);
|
182 | 8f0605cc | Stefan Berger | |
183 | 8f0605cc | Stefan Berger | /**
|
184 | 8f0605cc | Stefan Berger | * tpm_backend_get_tpm_established_flag:
|
185 | 8f0605cc | Stefan Berger | * @s: the backend
|
186 | 8f0605cc | Stefan Berger | *
|
187 | 8f0605cc | Stefan Berger | * Get the TPM establishment flag. This function may be called very
|
188 | 8f0605cc | Stefan Berger | * frequently by the frontend since for example in the TIS implementation
|
189 | 8f0605cc | Stefan Berger | * this flag is part of a register.
|
190 | 8f0605cc | Stefan Berger | */
|
191 | 8f0605cc | Stefan Berger | bool tpm_backend_get_tpm_established_flag(TPMBackend *s);
|
192 | 8f0605cc | Stefan Berger | |
193 | 8f0605cc | Stefan Berger | /**
|
194 | 8f0605cc | Stefan Berger | * tpm_backend_open:
|
195 | 8f0605cc | Stefan Berger | * @s: the backend to open
|
196 | 8f0605cc | Stefan Berger | * @errp: a pointer to return the #Error object if an error occurs.
|
197 | 8f0605cc | Stefan Berger | *
|
198 | 8f0605cc | Stefan Berger | * This function will open the backend if it is not already open. Calling this
|
199 | 8f0605cc | Stefan Berger | * function on an already opened backend will not result in an error.
|
200 | 8f0605cc | Stefan Berger | */
|
201 | 8f0605cc | Stefan Berger | void tpm_backend_open(TPMBackend *s, Error **errp);
|
202 | 8f0605cc | Stefan Berger | |
203 | bdee56f5 | Paolo Bonzini | TPMBackend *qemu_find_tpm(const char *id); |
204 | bdee56f5 | Paolo Bonzini | |
205 | bdee56f5 | Paolo Bonzini | const TPMDriverOps *tpm_get_backend_driver(const char *type); |
206 | bdee56f5 | Paolo Bonzini | int tpm_register_model(enum TpmModel model); |
207 | bdee56f5 | Paolo Bonzini | int tpm_register_driver(const TPMDriverOps *tdo); |
208 | bdee56f5 | Paolo Bonzini | |
209 | 8f0605cc | Stefan Berger | #endif |