qapi: Make BlockdevOptions doc example closer to reality
[qemu/cris-port.git] / bootdevice.c
blobdbc0159392bd8c614bd8216a3f4b626c260ec31a
1 /*
2 * QEMU Boot Device Implement
4 * Copyright (c) 2014 HUAWEI TECHNOLOGIES CO., LTD.
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22 * THE SOFTWARE.
25 #include "qemu/osdep.h"
26 #include "sysemu/sysemu.h"
27 #include "qapi/visitor.h"
28 #include "qemu/error-report.h"
29 #include "hw/hw.h"
31 typedef struct FWBootEntry FWBootEntry;
33 struct FWBootEntry {
34 QTAILQ_ENTRY(FWBootEntry) link;
35 int32_t bootindex;
36 DeviceState *dev;
37 char *suffix;
40 static QTAILQ_HEAD(, FWBootEntry) fw_boot_order =
41 QTAILQ_HEAD_INITIALIZER(fw_boot_order);
42 static QEMUBootSetHandler *boot_set_handler;
43 static void *boot_set_opaque;
45 void qemu_register_boot_set(QEMUBootSetHandler *func, void *opaque)
47 boot_set_handler = func;
48 boot_set_opaque = opaque;
51 void qemu_boot_set(const char *boot_order, Error **errp)
53 Error *local_err = NULL;
55 if (!boot_set_handler) {
56 error_setg(errp, "no function defined to set boot device list for"
57 " this architecture");
58 return;
61 validate_bootdevices(boot_order, &local_err);
62 if (local_err) {
63 error_propagate(errp, local_err);
64 return;
67 boot_set_handler(boot_set_opaque, boot_order, errp);
70 void validate_bootdevices(const char *devices, Error **errp)
72 /* We just do some generic consistency checks */
73 const char *p;
74 int bitmap = 0;
76 for (p = devices; *p != '\0'; p++) {
77 /* Allowed boot devices are:
78 * a-b: floppy disk drives
79 * c-f: IDE disk drives
80 * g-m: machine implementation dependent drives
81 * n-p: network devices
82 * It's up to each machine implementation to check if the given boot
83 * devices match the actual hardware implementation and firmware
84 * features.
86 if (*p < 'a' || *p > 'p') {
87 error_setg(errp, "Invalid boot device '%c'", *p);
88 return;
90 if (bitmap & (1 << (*p - 'a'))) {
91 error_setg(errp, "Boot device '%c' was given twice", *p);
92 return;
94 bitmap |= 1 << (*p - 'a');
98 void restore_boot_order(void *opaque)
100 char *normal_boot_order = opaque;
101 static int first = 1;
103 /* Restore boot order and remove ourselves after the first boot */
104 if (first) {
105 first = 0;
106 return;
109 if (boot_set_handler) {
110 qemu_boot_set(normal_boot_order, &error_abort);
113 qemu_unregister_reset(restore_boot_order, normal_boot_order);
114 g_free(normal_boot_order);
117 void check_boot_index(int32_t bootindex, Error **errp)
119 FWBootEntry *i;
121 if (bootindex >= 0) {
122 QTAILQ_FOREACH(i, &fw_boot_order, link) {
123 if (i->bootindex == bootindex) {
124 error_setg(errp, "The bootindex %d has already been used",
125 bootindex);
126 return;
132 void del_boot_device_path(DeviceState *dev, const char *suffix)
134 FWBootEntry *i;
136 if (dev == NULL) {
137 return;
140 QTAILQ_FOREACH(i, &fw_boot_order, link) {
141 if ((!suffix || !g_strcmp0(i->suffix, suffix)) &&
142 i->dev == dev) {
143 QTAILQ_REMOVE(&fw_boot_order, i, link);
144 g_free(i->suffix);
145 g_free(i);
147 break;
152 void add_boot_device_path(int32_t bootindex, DeviceState *dev,
153 const char *suffix)
155 FWBootEntry *node, *i;
157 if (bootindex < 0) {
158 del_boot_device_path(dev, suffix);
159 return;
162 assert(dev != NULL || suffix != NULL);
164 del_boot_device_path(dev, suffix);
166 node = g_malloc0(sizeof(FWBootEntry));
167 node->bootindex = bootindex;
168 node->suffix = g_strdup(suffix);
169 node->dev = dev;
171 QTAILQ_FOREACH(i, &fw_boot_order, link) {
172 if (i->bootindex == bootindex) {
173 error_report("Two devices with same boot index %d", bootindex);
174 exit(1);
175 } else if (i->bootindex < bootindex) {
176 continue;
178 QTAILQ_INSERT_BEFORE(i, node, link);
179 return;
181 QTAILQ_INSERT_TAIL(&fw_boot_order, node, link);
184 DeviceState *get_boot_device(uint32_t position)
186 uint32_t counter = 0;
187 FWBootEntry *i = NULL;
188 DeviceState *res = NULL;
190 if (!QTAILQ_EMPTY(&fw_boot_order)) {
191 QTAILQ_FOREACH(i, &fw_boot_order, link) {
192 if (counter == position) {
193 res = i->dev;
194 break;
196 counter++;
199 return res;
203 * This function returns null terminated string that consist of new line
204 * separated device paths.
206 * memory pointed by "size" is assigned total length of the array in bytes
209 char *get_boot_devices_list(size_t *size, bool ignore_suffixes)
211 FWBootEntry *i;
212 size_t total = 0;
213 char *list = NULL;
215 QTAILQ_FOREACH(i, &fw_boot_order, link) {
216 char *devpath = NULL, *suffix = NULL;
217 char *bootpath;
218 char *d;
219 size_t len;
221 if (i->dev) {
222 devpath = qdev_get_fw_dev_path(i->dev);
223 assert(devpath);
226 if (!ignore_suffixes) {
227 if (i->dev) {
228 d = qdev_get_own_fw_dev_path_from_handler(i->dev->parent_bus,
229 i->dev);
230 if (d) {
231 assert(!i->suffix);
232 suffix = d;
233 } else {
234 suffix = g_strdup(i->suffix);
236 } else {
237 suffix = g_strdup(i->suffix);
241 bootpath = g_strdup_printf("%s%s",
242 devpath ? devpath : "",
243 suffix ? suffix : "");
244 g_free(devpath);
245 g_free(suffix);
247 if (total) {
248 list[total-1] = '\n';
250 len = strlen(bootpath) + 1;
251 list = g_realloc(list, total + len);
252 memcpy(&list[total], bootpath, len);
253 total += len;
254 g_free(bootpath);
257 *size = total;
259 if (boot_strict && *size > 0) {
260 list[total-1] = '\n';
261 list = g_realloc(list, total + 5);
262 memcpy(&list[total], "HALT", 5);
263 *size = total + 5;
265 return list;
268 typedef struct {
269 int32_t *bootindex;
270 const char *suffix;
271 DeviceState *dev;
272 } BootIndexProperty;
274 static void device_get_bootindex(Object *obj, Visitor *v, const char *name,
275 void *opaque, Error **errp)
277 BootIndexProperty *prop = opaque;
278 visit_type_int32(v, name, prop->bootindex, errp);
281 static void device_set_bootindex(Object *obj, Visitor *v, const char *name,
282 void *opaque, Error **errp)
284 BootIndexProperty *prop = opaque;
285 int32_t boot_index;
286 Error *local_err = NULL;
288 visit_type_int32(v, name, &boot_index, &local_err);
289 if (local_err) {
290 goto out;
292 /* check whether bootindex is present in fw_boot_order list */
293 check_boot_index(boot_index, &local_err);
294 if (local_err) {
295 goto out;
297 /* change bootindex to a new one */
298 *prop->bootindex = boot_index;
300 add_boot_device_path(*prop->bootindex, prop->dev, prop->suffix);
302 out:
303 if (local_err) {
304 error_propagate(errp, local_err);
308 static void property_release_bootindex(Object *obj, const char *name,
309 void *opaque)
312 BootIndexProperty *prop = opaque;
314 del_boot_device_path(prop->dev, prop->suffix);
315 g_free(prop);
318 void device_add_bootindex_property(Object *obj, int32_t *bootindex,
319 const char *name, const char *suffix,
320 DeviceState *dev, Error **errp)
322 Error *local_err = NULL;
323 BootIndexProperty *prop = g_malloc0(sizeof(*prop));
325 prop->bootindex = bootindex;
326 prop->suffix = suffix;
327 prop->dev = dev;
329 object_property_add(obj, name, "int32",
330 device_get_bootindex,
331 device_set_bootindex,
332 property_release_bootindex,
333 prop, &local_err);
335 if (local_err) {
336 error_propagate(errp, local_err);
337 g_free(prop);
338 return;
340 /* initialize devices' bootindex property to -1 */
341 object_property_set_int(obj, -1, name, NULL);