]>
Commit | Line | Data |
---|---|---|
666daa68 MA |
1 | /* |
2 | * QEMU host block devices | |
3 | * | |
4 | * Copyright (c) 2003-2008 Fabrice Bellard | |
5 | * | |
6 | * This work is licensed under the terms of the GNU GPL, version 2 or | |
7 | * later. See the COPYING file in the top-level directory. | |
8 | */ | |
9 | ||
9c17d615 | 10 | #include "sysemu/blockdev.h" |
2b584959 | 11 | #include "hw/block-common.h" |
737e150e | 12 | #include "block/blockjob.h" |
83c9089e | 13 | #include "monitor/monitor.h" |
7b1b5d19 | 14 | #include "qapi/qmp/qerror.h" |
1de7afc9 PB |
15 | #include "qemu/option.h" |
16 | #include "qemu/config-file.h" | |
7b1b5d19 | 17 | #include "qapi/qmp/types.h" |
9c17d615 | 18 | #include "sysemu/sysemu.h" |
737e150e | 19 | #include "block/block_int.h" |
a4dea8a9 | 20 | #include "qmp-commands.h" |
12bd451f | 21 | #include "trace.h" |
9c17d615 | 22 | #include "sysemu/arch_init.h" |
666daa68 | 23 | |
c9b62a7e | 24 | static QTAILQ_HEAD(drivelist, DriveInfo) drives = QTAILQ_HEAD_INITIALIZER(drives); |
666daa68 | 25 | |
1960966d MA |
26 | static const char *const if_name[IF_COUNT] = { |
27 | [IF_NONE] = "none", | |
28 | [IF_IDE] = "ide", | |
29 | [IF_SCSI] = "scsi", | |
30 | [IF_FLOPPY] = "floppy", | |
31 | [IF_PFLASH] = "pflash", | |
32 | [IF_MTD] = "mtd", | |
33 | [IF_SD] = "sd", | |
34 | [IF_VIRTIO] = "virtio", | |
35 | [IF_XEN] = "xen", | |
36 | }; | |
37 | ||
38 | static const int if_max_devs[IF_COUNT] = { | |
27d6bf40 MA |
39 | /* |
40 | * Do not change these numbers! They govern how drive option | |
41 | * index maps to unit and bus. That mapping is ABI. | |
42 | * | |
43 | * All controllers used to imlement if=T drives need to support | |
44 | * if_max_devs[T] units, for any T with if_max_devs[T] != 0. | |
45 | * Otherwise, some index values map to "impossible" bus, unit | |
46 | * values. | |
47 | * | |
48 | * For instance, if you change [IF_SCSI] to 255, -drive | |
49 | * if=scsi,index=12 no longer means bus=1,unit=5, but | |
50 | * bus=0,unit=12. With an lsi53c895a controller (7 units max), | |
51 | * the drive can't be set up. Regression. | |
52 | */ | |
53 | [IF_IDE] = 2, | |
54 | [IF_SCSI] = 7, | |
1960966d MA |
55 | }; |
56 | ||
14bafc54 MA |
57 | /* |
58 | * We automatically delete the drive when a device using it gets | |
59 | * unplugged. Questionable feature, but we can't just drop it. | |
60 | * Device models call blockdev_mark_auto_del() to schedule the | |
61 | * automatic deletion, and generic qdev code calls blockdev_auto_del() | |
62 | * when deletion is actually safe. | |
63 | */ | |
64 | void blockdev_mark_auto_del(BlockDriverState *bs) | |
65 | { | |
66 | DriveInfo *dinfo = drive_get_by_blockdev(bs); | |
67 | ||
12bde0ee PB |
68 | if (bs->job) { |
69 | block_job_cancel(bs->job); | |
70 | } | |
0fc0f1fa RH |
71 | if (dinfo) { |
72 | dinfo->auto_del = 1; | |
73 | } | |
14bafc54 MA |
74 | } |
75 | ||
76 | void blockdev_auto_del(BlockDriverState *bs) | |
77 | { | |
78 | DriveInfo *dinfo = drive_get_by_blockdev(bs); | |
79 | ||
0fc0f1fa | 80 | if (dinfo && dinfo->auto_del) { |
84fb3925 | 81 | drive_put_ref(dinfo); |
14bafc54 MA |
82 | } |
83 | } | |
84 | ||
505a7fb1 MA |
85 | static int drive_index_to_bus_id(BlockInterfaceType type, int index) |
86 | { | |
87 | int max_devs = if_max_devs[type]; | |
88 | return max_devs ? index / max_devs : 0; | |
89 | } | |
90 | ||
91 | static int drive_index_to_unit_id(BlockInterfaceType type, int index) | |
92 | { | |
93 | int max_devs = if_max_devs[type]; | |
94 | return max_devs ? index % max_devs : index; | |
95 | } | |
96 | ||
2292ddae MA |
97 | QemuOpts *drive_def(const char *optstr) |
98 | { | |
99 | return qemu_opts_parse(qemu_find_opts("drive"), optstr, 0); | |
100 | } | |
101 | ||
102 | QemuOpts *drive_add(BlockInterfaceType type, int index, const char *file, | |
5645b0f4 | 103 | const char *optstr) |
666daa68 | 104 | { |
666daa68 | 105 | QemuOpts *opts; |
2292ddae | 106 | char buf[32]; |
666daa68 | 107 | |
2292ddae | 108 | opts = drive_def(optstr); |
666daa68 MA |
109 | if (!opts) { |
110 | return NULL; | |
111 | } | |
2292ddae MA |
112 | if (type != IF_DEFAULT) { |
113 | qemu_opt_set(opts, "if", if_name[type]); | |
114 | } | |
115 | if (index >= 0) { | |
116 | snprintf(buf, sizeof(buf), "%d", index); | |
117 | qemu_opt_set(opts, "index", buf); | |
118 | } | |
666daa68 MA |
119 | if (file) |
120 | qemu_opt_set(opts, "file", file); | |
121 | return opts; | |
122 | } | |
123 | ||
124 | DriveInfo *drive_get(BlockInterfaceType type, int bus, int unit) | |
125 | { | |
126 | DriveInfo *dinfo; | |
127 | ||
128 | /* seek interface, bus and unit */ | |
129 | ||
130 | QTAILQ_FOREACH(dinfo, &drives, next) { | |
131 | if (dinfo->type == type && | |
132 | dinfo->bus == bus && | |
133 | dinfo->unit == unit) | |
134 | return dinfo; | |
135 | } | |
136 | ||
137 | return NULL; | |
138 | } | |
139 | ||
f1bd51ac MA |
140 | DriveInfo *drive_get_by_index(BlockInterfaceType type, int index) |
141 | { | |
142 | return drive_get(type, | |
143 | drive_index_to_bus_id(type, index), | |
144 | drive_index_to_unit_id(type, index)); | |
145 | } | |
146 | ||
666daa68 MA |
147 | int drive_get_max_bus(BlockInterfaceType type) |
148 | { | |
149 | int max_bus; | |
150 | DriveInfo *dinfo; | |
151 | ||
152 | max_bus = -1; | |
153 | QTAILQ_FOREACH(dinfo, &drives, next) { | |
154 | if(dinfo->type == type && | |
155 | dinfo->bus > max_bus) | |
156 | max_bus = dinfo->bus; | |
157 | } | |
158 | return max_bus; | |
159 | } | |
160 | ||
13839974 MA |
161 | /* Get a block device. This should only be used for single-drive devices |
162 | (e.g. SD/Floppy/MTD). Multi-disk devices (scsi/ide) should use the | |
163 | appropriate bus. */ | |
164 | DriveInfo *drive_get_next(BlockInterfaceType type) | |
165 | { | |
166 | static int next_block_unit[IF_COUNT]; | |
167 | ||
168 | return drive_get(type, 0, next_block_unit[type]++); | |
169 | } | |
170 | ||
e4700e59 | 171 | DriveInfo *drive_get_by_blockdev(BlockDriverState *bs) |
666daa68 MA |
172 | { |
173 | DriveInfo *dinfo; | |
174 | ||
175 | QTAILQ_FOREACH(dinfo, &drives, next) { | |
e4700e59 MA |
176 | if (dinfo->bdrv == bs) { |
177 | return dinfo; | |
178 | } | |
666daa68 | 179 | } |
e4700e59 | 180 | return NULL; |
666daa68 MA |
181 | } |
182 | ||
666daa68 MA |
183 | static void bdrv_format_print(void *opaque, const char *name) |
184 | { | |
807105a7 | 185 | error_printf(" %s", name); |
666daa68 MA |
186 | } |
187 | ||
84fb3925 | 188 | static void drive_uninit(DriveInfo *dinfo) |
666daa68 MA |
189 | { |
190 | qemu_opts_del(dinfo->opts); | |
191 | bdrv_delete(dinfo->bdrv); | |
7267c094 | 192 | g_free(dinfo->id); |
666daa68 | 193 | QTAILQ_REMOVE(&drives, dinfo, next); |
7267c094 | 194 | g_free(dinfo); |
666daa68 MA |
195 | } |
196 | ||
84fb3925 MT |
197 | void drive_put_ref(DriveInfo *dinfo) |
198 | { | |
199 | assert(dinfo->refcount); | |
200 | if (--dinfo->refcount == 0) { | |
201 | drive_uninit(dinfo); | |
202 | } | |
203 | } | |
204 | ||
205 | void drive_get_ref(DriveInfo *dinfo) | |
206 | { | |
207 | dinfo->refcount++; | |
208 | } | |
209 | ||
aa398a5c SH |
210 | typedef struct { |
211 | QEMUBH *bh; | |
212 | DriveInfo *dinfo; | |
213 | } DrivePutRefBH; | |
214 | ||
215 | static void drive_put_ref_bh(void *opaque) | |
216 | { | |
217 | DrivePutRefBH *s = opaque; | |
218 | ||
219 | drive_put_ref(s->dinfo); | |
220 | qemu_bh_delete(s->bh); | |
221 | g_free(s); | |
222 | } | |
223 | ||
224 | /* | |
225 | * Release a drive reference in a BH | |
226 | * | |
227 | * It is not possible to use drive_put_ref() from a callback function when the | |
228 | * callers still need the drive. In such cases we schedule a BH to release the | |
229 | * reference. | |
230 | */ | |
231 | static void drive_put_ref_bh_schedule(DriveInfo *dinfo) | |
232 | { | |
233 | DrivePutRefBH *s; | |
234 | ||
235 | s = g_new(DrivePutRefBH, 1); | |
236 | s->bh = qemu_bh_new(drive_put_ref_bh, s); | |
237 | s->dinfo = dinfo; | |
238 | qemu_bh_schedule(s->bh); | |
239 | } | |
240 | ||
1ceee0d5 | 241 | static int parse_block_error_action(const char *buf, bool is_read) |
666daa68 MA |
242 | { |
243 | if (!strcmp(buf, "ignore")) { | |
92aa5c6d | 244 | return BLOCKDEV_ON_ERROR_IGNORE; |
666daa68 | 245 | } else if (!is_read && !strcmp(buf, "enospc")) { |
92aa5c6d | 246 | return BLOCKDEV_ON_ERROR_ENOSPC; |
666daa68 | 247 | } else if (!strcmp(buf, "stop")) { |
92aa5c6d | 248 | return BLOCKDEV_ON_ERROR_STOP; |
666daa68 | 249 | } else if (!strcmp(buf, "report")) { |
92aa5c6d | 250 | return BLOCKDEV_ON_ERROR_REPORT; |
666daa68 | 251 | } else { |
807105a7 MA |
252 | error_report("'%s' invalid %s error action", |
253 | buf, is_read ? "read" : "write"); | |
666daa68 MA |
254 | return -1; |
255 | } | |
256 | } | |
257 | ||
c546194f | 258 | static bool do_check_io_limits(BlockIOLimit *io_limits, Error **errp) |
0563e191 ZYW |
259 | { |
260 | bool bps_flag; | |
261 | bool iops_flag; | |
262 | ||
263 | assert(io_limits); | |
264 | ||
265 | bps_flag = (io_limits->bps[BLOCK_IO_LIMIT_TOTAL] != 0) | |
266 | && ((io_limits->bps[BLOCK_IO_LIMIT_READ] != 0) | |
267 | || (io_limits->bps[BLOCK_IO_LIMIT_WRITE] != 0)); | |
268 | iops_flag = (io_limits->iops[BLOCK_IO_LIMIT_TOTAL] != 0) | |
269 | && ((io_limits->iops[BLOCK_IO_LIMIT_READ] != 0) | |
270 | || (io_limits->iops[BLOCK_IO_LIMIT_WRITE] != 0)); | |
271 | if (bps_flag || iops_flag) { | |
c546194f SH |
272 | error_setg(errp, "bps(iops) and bps_rd/bps_wr(iops_rd/iops_wr) " |
273 | "cannot be used at the same time"); | |
0563e191 ZYW |
274 | return false; |
275 | } | |
276 | ||
277 | return true; | |
278 | } | |
279 | ||
2d0d2837 | 280 | DriveInfo *drive_init(QemuOpts *opts, BlockInterfaceType block_default_type) |
666daa68 MA |
281 | { |
282 | const char *buf; | |
283 | const char *file = NULL; | |
666daa68 MA |
284 | const char *serial; |
285 | const char *mediastr = ""; | |
286 | BlockInterfaceType type; | |
287 | enum { MEDIA_DISK, MEDIA_CDROM } media; | |
288 | int bus_id, unit_id; | |
289 | int cyls, heads, secs, translation; | |
290 | BlockDriver *drv = NULL; | |
291 | int max_devs; | |
292 | int index; | |
293 | int ro = 0; | |
294 | int bdrv_flags = 0; | |
295 | int on_read_error, on_write_error; | |
296 | const char *devaddr; | |
297 | DriveInfo *dinfo; | |
0563e191 | 298 | BlockIOLimit io_limits; |
666daa68 | 299 | int snapshot = 0; |
fb0490f6 | 300 | bool copy_on_read; |
666daa68 | 301 | int ret; |
c546194f | 302 | Error *error = NULL; |
666daa68 | 303 | |
666daa68 | 304 | translation = BIOS_ATA_TRANSLATION_AUTO; |
666daa68 MA |
305 | media = MEDIA_DISK; |
306 | ||
307 | /* extract parameters */ | |
308 | bus_id = qemu_opt_get_number(opts, "bus", 0); | |
309 | unit_id = qemu_opt_get_number(opts, "unit", -1); | |
310 | index = qemu_opt_get_number(opts, "index", -1); | |
311 | ||
312 | cyls = qemu_opt_get_number(opts, "cyls", 0); | |
313 | heads = qemu_opt_get_number(opts, "heads", 0); | |
314 | secs = qemu_opt_get_number(opts, "secs", 0); | |
315 | ||
316 | snapshot = qemu_opt_get_bool(opts, "snapshot", 0); | |
317 | ro = qemu_opt_get_bool(opts, "readonly", 0); | |
fb0490f6 | 318 | copy_on_read = qemu_opt_get_bool(opts, "copy-on-read", false); |
666daa68 MA |
319 | |
320 | file = qemu_opt_get(opts, "file"); | |
321 | serial = qemu_opt_get(opts, "serial"); | |
322 | ||
323 | if ((buf = qemu_opt_get(opts, "if")) != NULL) { | |
1960966d MA |
324 | for (type = 0; type < IF_COUNT && strcmp(buf, if_name[type]); type++) |
325 | ; | |
326 | if (type == IF_COUNT) { | |
807105a7 | 327 | error_report("unsupported bus type '%s'", buf); |
666daa68 MA |
328 | return NULL; |
329 | } | |
2d3999fe | 330 | } else { |
2d0d2837 | 331 | type = block_default_type; |
666daa68 | 332 | } |
2d3999fe | 333 | |
1960966d | 334 | max_devs = if_max_devs[type]; |
666daa68 MA |
335 | |
336 | if (cyls || heads || secs) { | |
aaea3f36 | 337 | if (cyls < 1) { |
807105a7 | 338 | error_report("invalid physical cyls number"); |
666daa68 MA |
339 | return NULL; |
340 | } | |
aaea3f36 | 341 | if (heads < 1) { |
807105a7 | 342 | error_report("invalid physical heads number"); |
666daa68 MA |
343 | return NULL; |
344 | } | |
aaea3f36 | 345 | if (secs < 1) { |
807105a7 | 346 | error_report("invalid physical secs number"); |
666daa68 MA |
347 | return NULL; |
348 | } | |
349 | } | |
350 | ||
351 | if ((buf = qemu_opt_get(opts, "trans")) != NULL) { | |
352 | if (!cyls) { | |
e4080f9b | 353 | error_report("'%s' trans must be used with cyls, heads and secs", |
807105a7 | 354 | buf); |
666daa68 MA |
355 | return NULL; |
356 | } | |
357 | if (!strcmp(buf, "none")) | |
358 | translation = BIOS_ATA_TRANSLATION_NONE; | |
359 | else if (!strcmp(buf, "lba")) | |
360 | translation = BIOS_ATA_TRANSLATION_LBA; | |
361 | else if (!strcmp(buf, "auto")) | |
362 | translation = BIOS_ATA_TRANSLATION_AUTO; | |
363 | else { | |
807105a7 | 364 | error_report("'%s' invalid translation type", buf); |
666daa68 MA |
365 | return NULL; |
366 | } | |
367 | } | |
368 | ||
369 | if ((buf = qemu_opt_get(opts, "media")) != NULL) { | |
370 | if (!strcmp(buf, "disk")) { | |
371 | media = MEDIA_DISK; | |
372 | } else if (!strcmp(buf, "cdrom")) { | |
373 | if (cyls || secs || heads) { | |
e7ff8f0e | 374 | error_report("CHS can't be set with media=%s", buf); |
666daa68 MA |
375 | return NULL; |
376 | } | |
377 | media = MEDIA_CDROM; | |
378 | } else { | |
807105a7 | 379 | error_report("'%s' invalid media", buf); |
666daa68 MA |
380 | return NULL; |
381 | } | |
382 | } | |
383 | ||
1f212b9d | 384 | bdrv_flags |= BDRV_O_CACHE_WB; |
666daa68 | 385 | if ((buf = qemu_opt_get(opts, "cache")) != NULL) { |
c3993cdc SH |
386 | if (bdrv_parse_cache_flags(buf, &bdrv_flags) != 0) { |
387 | error_report("invalid cache option"); | |
388 | return NULL; | |
666daa68 MA |
389 | } |
390 | } | |
391 | ||
392 | #ifdef CONFIG_LINUX_AIO | |
393 | if ((buf = qemu_opt_get(opts, "aio")) != NULL) { | |
394 | if (!strcmp(buf, "native")) { | |
395 | bdrv_flags |= BDRV_O_NATIVE_AIO; | |
396 | } else if (!strcmp(buf, "threads")) { | |
397 | /* this is the default */ | |
398 | } else { | |
807105a7 | 399 | error_report("invalid aio option"); |
666daa68 MA |
400 | return NULL; |
401 | } | |
402 | } | |
403 | #endif | |
404 | ||
405 | if ((buf = qemu_opt_get(opts, "format")) != NULL) { | |
c8057f95 PM |
406 | if (is_help_option(buf)) { |
407 | error_printf("Supported formats:"); | |
408 | bdrv_iterate_format(bdrv_format_print, NULL); | |
409 | error_printf("\n"); | |
410 | return NULL; | |
666daa68 MA |
411 | } |
412 | drv = bdrv_find_whitelisted_format(buf); | |
413 | if (!drv) { | |
807105a7 | 414 | error_report("'%s' invalid format", buf); |
666daa68 MA |
415 | return NULL; |
416 | } | |
417 | } | |
418 | ||
0563e191 ZYW |
419 | /* disk I/O throttling */ |
420 | io_limits.bps[BLOCK_IO_LIMIT_TOTAL] = | |
421 | qemu_opt_get_number(opts, "bps", 0); | |
422 | io_limits.bps[BLOCK_IO_LIMIT_READ] = | |
423 | qemu_opt_get_number(opts, "bps_rd", 0); | |
424 | io_limits.bps[BLOCK_IO_LIMIT_WRITE] = | |
425 | qemu_opt_get_number(opts, "bps_wr", 0); | |
426 | io_limits.iops[BLOCK_IO_LIMIT_TOTAL] = | |
427 | qemu_opt_get_number(opts, "iops", 0); | |
428 | io_limits.iops[BLOCK_IO_LIMIT_READ] = | |
429 | qemu_opt_get_number(opts, "iops_rd", 0); | |
430 | io_limits.iops[BLOCK_IO_LIMIT_WRITE] = | |
431 | qemu_opt_get_number(opts, "iops_wr", 0); | |
432 | ||
c546194f SH |
433 | if (!do_check_io_limits(&io_limits, &error)) { |
434 | error_report("%s", error_get_pretty(error)); | |
435 | error_free(error); | |
0563e191 ZYW |
436 | return NULL; |
437 | } | |
438 | ||
0d92d17a JK |
439 | if (qemu_opt_get(opts, "boot") != NULL) { |
440 | fprintf(stderr, "qemu-kvm: boot=on|off is deprecated and will be " | |
441 | "ignored. Future versions will reject this parameter. Please " | |
442 | "update your scripts.\n"); | |
443 | } | |
444 | ||
92aa5c6d | 445 | on_write_error = BLOCKDEV_ON_ERROR_ENOSPC; |
666daa68 MA |
446 | if ((buf = qemu_opt_get(opts, "werror")) != NULL) { |
447 | if (type != IF_IDE && type != IF_SCSI && type != IF_VIRTIO && type != IF_NONE) { | |
807105a7 | 448 | error_report("werror is not supported by this bus type"); |
666daa68 MA |
449 | return NULL; |
450 | } | |
451 | ||
452 | on_write_error = parse_block_error_action(buf, 0); | |
453 | if (on_write_error < 0) { | |
454 | return NULL; | |
455 | } | |
456 | } | |
457 | ||
92aa5c6d | 458 | on_read_error = BLOCKDEV_ON_ERROR_REPORT; |
666daa68 | 459 | if ((buf = qemu_opt_get(opts, "rerror")) != NULL) { |
5dba48a8 | 460 | if (type != IF_IDE && type != IF_VIRTIO && type != IF_SCSI && type != IF_NONE) { |
807105a7 | 461 | error_report("rerror is not supported by this bus type"); |
666daa68 MA |
462 | return NULL; |
463 | } | |
464 | ||
465 | on_read_error = parse_block_error_action(buf, 1); | |
466 | if (on_read_error < 0) { | |
467 | return NULL; | |
468 | } | |
469 | } | |
470 | ||
471 | if ((devaddr = qemu_opt_get(opts, "addr")) != NULL) { | |
472 | if (type != IF_VIRTIO) { | |
807105a7 | 473 | error_report("addr is not supported by this bus type"); |
666daa68 MA |
474 | return NULL; |
475 | } | |
476 | } | |
477 | ||
478 | /* compute bus and unit according index */ | |
479 | ||
480 | if (index != -1) { | |
481 | if (bus_id != 0 || unit_id != -1) { | |
807105a7 | 482 | error_report("index cannot be used with bus and unit"); |
666daa68 MA |
483 | return NULL; |
484 | } | |
505a7fb1 MA |
485 | bus_id = drive_index_to_bus_id(type, index); |
486 | unit_id = drive_index_to_unit_id(type, index); | |
666daa68 MA |
487 | } |
488 | ||
489 | /* if user doesn't specify a unit_id, | |
490 | * try to find the first free | |
491 | */ | |
492 | ||
493 | if (unit_id == -1) { | |
494 | unit_id = 0; | |
495 | while (drive_get(type, bus_id, unit_id) != NULL) { | |
496 | unit_id++; | |
497 | if (max_devs && unit_id >= max_devs) { | |
498 | unit_id -= max_devs; | |
499 | bus_id++; | |
500 | } | |
501 | } | |
502 | } | |
503 | ||
504 | /* check unit id */ | |
505 | ||
506 | if (max_devs && unit_id >= max_devs) { | |
807105a7 MA |
507 | error_report("unit %d too big (max is %d)", |
508 | unit_id, max_devs - 1); | |
666daa68 MA |
509 | return NULL; |
510 | } | |
511 | ||
512 | /* | |
4e5d9b57 | 513 | * catch multiple definitions |
666daa68 MA |
514 | */ |
515 | ||
516 | if (drive_get(type, bus_id, unit_id) != NULL) { | |
4e5d9b57 MA |
517 | error_report("drive with bus=%d, unit=%d (index=%d) exists", |
518 | bus_id, unit_id, index); | |
666daa68 MA |
519 | return NULL; |
520 | } | |
521 | ||
522 | /* init */ | |
523 | ||
7267c094 | 524 | dinfo = g_malloc0(sizeof(*dinfo)); |
666daa68 | 525 | if ((buf = qemu_opts_id(opts)) != NULL) { |
7267c094 | 526 | dinfo->id = g_strdup(buf); |
666daa68 MA |
527 | } else { |
528 | /* no id supplied -> create one */ | |
7267c094 | 529 | dinfo->id = g_malloc0(32); |
666daa68 MA |
530 | if (type == IF_IDE || type == IF_SCSI) |
531 | mediastr = (media == MEDIA_CDROM) ? "-cd" : "-hd"; | |
532 | if (max_devs) | |
533 | snprintf(dinfo->id, 32, "%s%i%s%i", | |
79d21d5b | 534 | if_name[type], bus_id, mediastr, unit_id); |
666daa68 MA |
535 | else |
536 | snprintf(dinfo->id, 32, "%s%s%i", | |
79d21d5b | 537 | if_name[type], mediastr, unit_id); |
666daa68 MA |
538 | } |
539 | dinfo->bdrv = bdrv_new(dinfo->id); | |
80dd1aae KS |
540 | dinfo->bdrv->open_flags = snapshot ? BDRV_O_SNAPSHOT : 0; |
541 | dinfo->bdrv->read_only = ro; | |
666daa68 MA |
542 | dinfo->devaddr = devaddr; |
543 | dinfo->type = type; | |
544 | dinfo->bus = bus_id; | |
545 | dinfo->unit = unit_id; | |
317bb412 MA |
546 | dinfo->cyls = cyls; |
547 | dinfo->heads = heads; | |
548 | dinfo->secs = secs; | |
549 | dinfo->trans = translation; | |
666daa68 | 550 | dinfo->opts = opts; |
84fb3925 | 551 | dinfo->refcount = 1; |
577d0a38 | 552 | dinfo->serial = serial; |
666daa68 MA |
553 | QTAILQ_INSERT_TAIL(&drives, dinfo, next); |
554 | ||
abd7f68d MA |
555 | bdrv_set_on_error(dinfo->bdrv, on_read_error, on_write_error); |
556 | ||
0563e191 ZYW |
557 | /* disk I/O throttling */ |
558 | bdrv_set_io_limits(dinfo->bdrv, &io_limits); | |
559 | ||
666daa68 MA |
560 | switch(type) { |
561 | case IF_IDE: | |
562 | case IF_SCSI: | |
563 | case IF_XEN: | |
564 | case IF_NONE: | |
2b584959 | 565 | dinfo->media_cd = media == MEDIA_CDROM; |
666daa68 MA |
566 | break; |
567 | case IF_SD: | |
666daa68 | 568 | case IF_FLOPPY: |
666daa68 MA |
569 | case IF_PFLASH: |
570 | case IF_MTD: | |
571 | break; | |
572 | case IF_VIRTIO: | |
573 | /* add virtio block device */ | |
e478b448 | 574 | opts = qemu_opts_create_nofail(qemu_find_opts("device")); |
eeb9c1b5 AL |
575 | if (arch_type == QEMU_ARCH_S390X) { |
576 | qemu_opt_set(opts, "driver", "virtio-blk-s390"); | |
577 | } else { | |
578 | qemu_opt_set(opts, "driver", "virtio-blk-pci"); | |
579 | } | |
666daa68 MA |
580 | qemu_opt_set(opts, "drive", dinfo->id); |
581 | if (devaddr) | |
582 | qemu_opt_set(opts, "addr", devaddr); | |
583 | break; | |
2292ddae | 584 | default: |
666daa68 MA |
585 | abort(); |
586 | } | |
dd5b0d71 | 587 | if (!file || !*file) { |
319ae529 | 588 | return dinfo; |
666daa68 MA |
589 | } |
590 | if (snapshot) { | |
591 | /* always use cache=unsafe with snapshot */ | |
592 | bdrv_flags &= ~BDRV_O_CACHE_MASK; | |
593 | bdrv_flags |= (BDRV_O_SNAPSHOT|BDRV_O_CACHE_WB|BDRV_O_NO_FLUSH); | |
594 | } | |
595 | ||
fb0490f6 SH |
596 | if (copy_on_read) { |
597 | bdrv_flags |= BDRV_O_COPY_ON_READ; | |
598 | } | |
599 | ||
ed9d4205 BC |
600 | if (runstate_check(RUN_STATE_INMIGRATE)) { |
601 | bdrv_flags |= BDRV_O_INCOMING; | |
602 | } | |
603 | ||
666daa68 MA |
604 | if (media == MEDIA_CDROM) { |
605 | /* CDROM is fine for any interface, don't check. */ | |
606 | ro = 1; | |
607 | } else if (ro == 1) { | |
1e9eb78a JJ |
608 | if (type != IF_SCSI && type != IF_VIRTIO && type != IF_FLOPPY && |
609 | type != IF_NONE && type != IF_PFLASH) { | |
807105a7 | 610 | error_report("readonly not supported by this bus type"); |
a9ae2bff | 611 | goto err; |
666daa68 MA |
612 | } |
613 | } | |
614 | ||
615 | bdrv_flags |= ro ? 0 : BDRV_O_RDWR; | |
616 | ||
04d4abe9 SH |
617 | if (ro && copy_on_read) { |
618 | error_report("warning: disabling copy_on_read on readonly drive"); | |
619 | } | |
620 | ||
666daa68 MA |
621 | ret = bdrv_open(dinfo->bdrv, file, bdrv_flags, drv); |
622 | if (ret < 0) { | |
02582abd SW |
623 | if (ret == -EMEDIUMTYPE) { |
624 | error_report("could not open disk image %s: not in %s format", | |
625 | file, drv->format_name); | |
626 | } else { | |
627 | error_report("could not open disk image %s: %s", | |
628 | file, strerror(-ret)); | |
629 | } | |
a9ae2bff | 630 | goto err; |
666daa68 MA |
631 | } |
632 | ||
633 | if (bdrv_key_required(dinfo->bdrv)) | |
634 | autostart = 0; | |
666daa68 | 635 | return dinfo; |
a9ae2bff MA |
636 | |
637 | err: | |
638 | bdrv_delete(dinfo->bdrv); | |
7267c094 | 639 | g_free(dinfo->id); |
a9ae2bff | 640 | QTAILQ_REMOVE(&drives, dinfo, next); |
7267c094 | 641 | g_free(dinfo); |
a9ae2bff | 642 | return NULL; |
666daa68 MA |
643 | } |
644 | ||
645 | void do_commit(Monitor *mon, const QDict *qdict) | |
646 | { | |
666daa68 | 647 | const char *device = qdict_get_str(qdict, "device"); |
6ab4b5ab | 648 | BlockDriverState *bs; |
e8877497 | 649 | int ret; |
666daa68 | 650 | |
6ab4b5ab | 651 | if (!strcmp(device, "all")) { |
e8877497 | 652 | ret = bdrv_commit_all(); |
6ab4b5ab MA |
653 | } else { |
654 | bs = bdrv_find(device); | |
ac59eb95 | 655 | if (!bs) { |
58513bde | 656 | monitor_printf(mon, "Device '%s' not found\n", device); |
ac59eb95 | 657 | return; |
6ab4b5ab | 658 | } |
2d3735d3 | 659 | ret = bdrv_commit(bs); |
58513bde JC |
660 | } |
661 | if (ret < 0) { | |
662 | monitor_printf(mon, "'commit' error for '%s': %s\n", device, | |
663 | strerror(-ret)); | |
666daa68 MA |
664 | } |
665 | } | |
666 | ||
6cc2a415 PB |
667 | static void blockdev_do_action(int kind, void *data, Error **errp) |
668 | { | |
669 | BlockdevAction action; | |
670 | BlockdevActionList list; | |
671 | ||
672 | action.kind = kind; | |
673 | action.data = data; | |
674 | list.value = &action; | |
675 | list.next = NULL; | |
676 | qmp_transaction(&list, errp); | |
677 | } | |
678 | ||
6106e249 LC |
679 | void qmp_blockdev_snapshot_sync(const char *device, const char *snapshot_file, |
680 | bool has_format, const char *format, | |
6cc2a415 | 681 | bool has_mode, enum NewImageMode mode, |
6106e249 | 682 | Error **errp) |
f8882568 | 683 | { |
6cc2a415 PB |
684 | BlockdevSnapshot snapshot = { |
685 | .device = (char *) device, | |
686 | .snapshot_file = (char *) snapshot_file, | |
687 | .has_format = has_format, | |
688 | .format = (char *) format, | |
689 | .has_mode = has_mode, | |
690 | .mode = mode, | |
691 | }; | |
692 | blockdev_do_action(BLOCKDEV_ACTION_KIND_BLOCKDEV_SNAPSHOT_SYNC, &snapshot, | |
693 | errp); | |
f8882568 JS |
694 | } |
695 | ||
8802d1fd JC |
696 | |
697 | /* New and old BlockDriverState structs for group snapshots */ | |
52e7c241 | 698 | typedef struct BlkTransactionStates { |
8802d1fd JC |
699 | BlockDriverState *old_bs; |
700 | BlockDriverState *new_bs; | |
52e7c241 PB |
701 | QSIMPLEQ_ENTRY(BlkTransactionStates) entry; |
702 | } BlkTransactionStates; | |
8802d1fd JC |
703 | |
704 | /* | |
705 | * 'Atomic' group snapshots. The snapshots are taken as a set, and if any fail | |
706 | * then we do not pivot any of the devices in the group, and abandon the | |
707 | * snapshots | |
708 | */ | |
52e7c241 | 709 | void qmp_transaction(BlockdevActionList *dev_list, Error **errp) |
8802d1fd JC |
710 | { |
711 | int ret = 0; | |
52e7c241 PB |
712 | BlockdevActionList *dev_entry = dev_list; |
713 | BlkTransactionStates *states, *next; | |
43e17041 | 714 | Error *local_err = NULL; |
8802d1fd | 715 | |
52e7c241 | 716 | QSIMPLEQ_HEAD(snap_bdrv_states, BlkTransactionStates) snap_bdrv_states; |
8802d1fd JC |
717 | QSIMPLEQ_INIT(&snap_bdrv_states); |
718 | ||
719 | /* drain all i/o before any snapshots */ | |
720 | bdrv_drain_all(); | |
721 | ||
722 | /* We don't do anything in this loop that commits us to the snapshot */ | |
723 | while (NULL != dev_entry) { | |
52e7c241 PB |
724 | BlockdevAction *dev_info = NULL; |
725 | BlockDriver *proto_drv; | |
726 | BlockDriver *drv; | |
727 | int flags; | |
bc8b094f PB |
728 | enum NewImageMode mode; |
729 | const char *new_image_file; | |
52e7c241 PB |
730 | const char *device; |
731 | const char *format = "qcow2"; | |
52e7c241 | 732 | |
8802d1fd JC |
733 | dev_info = dev_entry->value; |
734 | dev_entry = dev_entry->next; | |
735 | ||
52e7c241 | 736 | states = g_malloc0(sizeof(BlkTransactionStates)); |
8802d1fd JC |
737 | QSIMPLEQ_INSERT_TAIL(&snap_bdrv_states, states, entry); |
738 | ||
52e7c241 PB |
739 | switch (dev_info->kind) { |
740 | case BLOCKDEV_ACTION_KIND_BLOCKDEV_SNAPSHOT_SYNC: | |
741 | device = dev_info->blockdev_snapshot_sync->device; | |
bc8b094f PB |
742 | if (!dev_info->blockdev_snapshot_sync->has_mode) { |
743 | dev_info->blockdev_snapshot_sync->mode = NEW_IMAGE_MODE_ABSOLUTE_PATHS; | |
744 | } | |
745 | new_image_file = dev_info->blockdev_snapshot_sync->snapshot_file; | |
52e7c241 PB |
746 | if (dev_info->blockdev_snapshot_sync->has_format) { |
747 | format = dev_info->blockdev_snapshot_sync->format; | |
748 | } | |
bc8b094f | 749 | mode = dev_info->blockdev_snapshot_sync->mode; |
52e7c241 PB |
750 | break; |
751 | default: | |
752 | abort(); | |
753 | } | |
8802d1fd | 754 | |
52e7c241 PB |
755 | drv = bdrv_find_format(format); |
756 | if (!drv) { | |
757 | error_set(errp, QERR_INVALID_BLOCK_FORMAT, format); | |
758 | goto delete_and_fail; | |
759 | } | |
760 | ||
761 | states->old_bs = bdrv_find(device); | |
8802d1fd | 762 | if (!states->old_bs) { |
52e7c241 | 763 | error_set(errp, QERR_DEVICE_NOT_FOUND, device); |
8802d1fd JC |
764 | goto delete_and_fail; |
765 | } | |
766 | ||
e86fe18a PB |
767 | if (!bdrv_is_inserted(states->old_bs)) { |
768 | error_set(errp, QERR_DEVICE_HAS_NO_MEDIUM, device); | |
769 | goto delete_and_fail; | |
770 | } | |
771 | ||
8802d1fd | 772 | if (bdrv_in_use(states->old_bs)) { |
52e7c241 | 773 | error_set(errp, QERR_DEVICE_IN_USE, device); |
8802d1fd JC |
774 | goto delete_and_fail; |
775 | } | |
776 | ||
e86fe18a | 777 | if (!bdrv_is_read_only(states->old_bs)) { |
8802d1fd JC |
778 | if (bdrv_flush(states->old_bs)) { |
779 | error_set(errp, QERR_IO_ERROR); | |
780 | goto delete_and_fail; | |
781 | } | |
782 | } | |
783 | ||
8802d1fd JC |
784 | flags = states->old_bs->open_flags; |
785 | ||
52e7c241 | 786 | proto_drv = bdrv_find_protocol(new_image_file); |
8802d1fd JC |
787 | if (!proto_drv) { |
788 | error_set(errp, QERR_INVALID_BLOCK_FORMAT, format); | |
789 | goto delete_and_fail; | |
790 | } | |
791 | ||
792 | /* create new image w/backing file */ | |
bc8b094f | 793 | if (mode != NEW_IMAGE_MODE_EXISTING) { |
43e17041 LC |
794 | bdrv_img_create(new_image_file, format, |
795 | states->old_bs->filename, | |
796 | states->old_bs->drv->format_name, | |
797 | NULL, -1, flags, &local_err); | |
798 | if (error_is_set(&local_err)) { | |
799 | error_propagate(errp, local_err); | |
bc8b094f PB |
800 | goto delete_and_fail; |
801 | } | |
8802d1fd JC |
802 | } |
803 | ||
804 | /* We will manually add the backing_hd field to the bs later */ | |
805 | states->new_bs = bdrv_new(""); | |
52e7c241 | 806 | ret = bdrv_open(states->new_bs, new_image_file, |
8802d1fd JC |
807 | flags | BDRV_O_NO_BACKING, drv); |
808 | if (ret != 0) { | |
52e7c241 | 809 | error_set(errp, QERR_OPEN_FILE_FAILED, new_image_file); |
8802d1fd JC |
810 | goto delete_and_fail; |
811 | } | |
812 | } | |
813 | ||
814 | ||
815 | /* Now we are going to do the actual pivot. Everything up to this point | |
816 | * is reversible, but we are committed at this point */ | |
817 | QSIMPLEQ_FOREACH(states, &snap_bdrv_states, entry) { | |
818 | /* This removes our old bs from the bdrv_states, and adds the new bs */ | |
819 | bdrv_append(states->new_bs, states->old_bs); | |
870f5681 JC |
820 | /* We don't need (or want) to use the transactional |
821 | * bdrv_reopen_multiple() across all the entries at once, because we | |
822 | * don't want to abort all of them if one of them fails the reopen */ | |
823 | bdrv_reopen(states->new_bs, states->new_bs->open_flags & ~BDRV_O_RDWR, | |
824 | NULL); | |
8802d1fd JC |
825 | } |
826 | ||
827 | /* success */ | |
828 | goto exit; | |
829 | ||
830 | delete_and_fail: | |
831 | /* | |
832 | * failure, and it is all-or-none; abandon each new bs, and keep using | |
833 | * the original bs for all images | |
834 | */ | |
835 | QSIMPLEQ_FOREACH(states, &snap_bdrv_states, entry) { | |
836 | if (states->new_bs) { | |
837 | bdrv_delete(states->new_bs); | |
838 | } | |
839 | } | |
840 | exit: | |
622d2419 | 841 | QSIMPLEQ_FOREACH_SAFE(states, &snap_bdrv_states, entry, next) { |
8802d1fd JC |
842 | g_free(states); |
843 | } | |
8802d1fd JC |
844 | } |
845 | ||
846 | ||
92d48558 | 847 | static void eject_device(BlockDriverState *bs, int force, Error **errp) |
666daa68 | 848 | { |
2d3735d3 SH |
849 | if (bdrv_in_use(bs)) { |
850 | error_set(errp, QERR_DEVICE_IN_USE, bdrv_get_device_name(bs)); | |
851 | return; | |
852 | } | |
2c6942fa | 853 | if (!bdrv_dev_has_removable_media(bs)) { |
92d48558 LC |
854 | error_set(errp, QERR_DEVICE_NOT_REMOVABLE, bdrv_get_device_name(bs)); |
855 | return; | |
ea8f942f | 856 | } |
92d48558 | 857 | |
025ccaa7 PB |
858 | if (bdrv_dev_is_medium_locked(bs) && !bdrv_dev_is_tray_open(bs)) { |
859 | bdrv_dev_eject_request(bs, force); | |
860 | if (!force) { | |
92d48558 LC |
861 | error_set(errp, QERR_DEVICE_LOCKED, bdrv_get_device_name(bs)); |
862 | return; | |
025ccaa7 | 863 | } |
666daa68 | 864 | } |
92d48558 | 865 | |
3b5276b5 | 866 | bdrv_close(bs); |
666daa68 MA |
867 | } |
868 | ||
c245b6a3 | 869 | void qmp_eject(const char *device, bool has_force, bool force, Error **errp) |
666daa68 MA |
870 | { |
871 | BlockDriverState *bs; | |
666daa68 | 872 | |
c245b6a3 | 873 | bs = bdrv_find(device); |
666daa68 | 874 | if (!bs) { |
c245b6a3 LC |
875 | error_set(errp, QERR_DEVICE_NOT_FOUND, device); |
876 | return; | |
92d48558 LC |
877 | } |
878 | ||
c245b6a3 | 879 | eject_device(bs, force, errp); |
666daa68 MA |
880 | } |
881 | ||
a4dea8a9 | 882 | void qmp_block_passwd(const char *device, const char *password, Error **errp) |
666daa68 MA |
883 | { |
884 | BlockDriverState *bs; | |
885 | int err; | |
886 | ||
a4dea8a9 | 887 | bs = bdrv_find(device); |
666daa68 | 888 | if (!bs) { |
a4dea8a9 LC |
889 | error_set(errp, QERR_DEVICE_NOT_FOUND, device); |
890 | return; | |
666daa68 MA |
891 | } |
892 | ||
a4dea8a9 | 893 | err = bdrv_set_key(bs, password); |
666daa68 | 894 | if (err == -EINVAL) { |
a4dea8a9 LC |
895 | error_set(errp, QERR_DEVICE_NOT_ENCRYPTED, bdrv_get_device_name(bs)); |
896 | return; | |
666daa68 | 897 | } else if (err < 0) { |
a4dea8a9 LC |
898 | error_set(errp, QERR_INVALID_PASSWORD); |
899 | return; | |
666daa68 | 900 | } |
666daa68 MA |
901 | } |
902 | ||
333a96ec LC |
903 | static void qmp_bdrv_open_encrypted(BlockDriverState *bs, const char *filename, |
904 | int bdrv_flags, BlockDriver *drv, | |
905 | const char *password, Error **errp) | |
906 | { | |
907 | if (bdrv_open(bs, filename, bdrv_flags, drv) < 0) { | |
908 | error_set(errp, QERR_OPEN_FILE_FAILED, filename); | |
909 | return; | |
910 | } | |
911 | ||
912 | if (bdrv_key_required(bs)) { | |
913 | if (password) { | |
914 | if (bdrv_set_key(bs, password) < 0) { | |
915 | error_set(errp, QERR_INVALID_PASSWORD); | |
916 | } | |
917 | } else { | |
918 | error_set(errp, QERR_DEVICE_ENCRYPTED, bdrv_get_device_name(bs), | |
919 | bdrv_get_encrypted_filename(bs)); | |
920 | } | |
921 | } else if (password) { | |
922 | error_set(errp, QERR_DEVICE_NOT_ENCRYPTED, bdrv_get_device_name(bs)); | |
923 | } | |
924 | } | |
925 | ||
926 | void qmp_change_blockdev(const char *device, const char *filename, | |
927 | bool has_format, const char *format, Error **errp) | |
666daa68 MA |
928 | { |
929 | BlockDriverState *bs; | |
930 | BlockDriver *drv = NULL; | |
931 | int bdrv_flags; | |
92d48558 | 932 | Error *err = NULL; |
666daa68 MA |
933 | |
934 | bs = bdrv_find(device); | |
935 | if (!bs) { | |
333a96ec LC |
936 | error_set(errp, QERR_DEVICE_NOT_FOUND, device); |
937 | return; | |
666daa68 | 938 | } |
333a96ec LC |
939 | |
940 | if (format) { | |
941 | drv = bdrv_find_whitelisted_format(format); | |
666daa68 | 942 | if (!drv) { |
333a96ec LC |
943 | error_set(errp, QERR_INVALID_BLOCK_FORMAT, format); |
944 | return; | |
666daa68 MA |
945 | } |
946 | } | |
333a96ec | 947 | |
92d48558 LC |
948 | eject_device(bs, 0, &err); |
949 | if (error_is_set(&err)) { | |
333a96ec LC |
950 | error_propagate(errp, err); |
951 | return; | |
666daa68 | 952 | } |
333a96ec | 953 | |
528f7663 | 954 | bdrv_flags = bdrv_is_read_only(bs) ? 0 : BDRV_O_RDWR; |
199630b6 | 955 | bdrv_flags |= bdrv_is_snapshot(bs) ? BDRV_O_SNAPSHOT : 0; |
333a96ec LC |
956 | |
957 | qmp_bdrv_open_encrypted(bs, filename, bdrv_flags, drv, NULL, errp); | |
666daa68 | 958 | } |
9063f814 | 959 | |
727f005e | 960 | /* throttling disk I/O limits */ |
80047da5 LC |
961 | void qmp_block_set_io_throttle(const char *device, int64_t bps, int64_t bps_rd, |
962 | int64_t bps_wr, int64_t iops, int64_t iops_rd, | |
963 | int64_t iops_wr, Error **errp) | |
727f005e ZYW |
964 | { |
965 | BlockIOLimit io_limits; | |
727f005e ZYW |
966 | BlockDriverState *bs; |
967 | ||
80047da5 | 968 | bs = bdrv_find(device); |
727f005e | 969 | if (!bs) { |
80047da5 LC |
970 | error_set(errp, QERR_DEVICE_NOT_FOUND, device); |
971 | return; | |
727f005e ZYW |
972 | } |
973 | ||
80047da5 LC |
974 | io_limits.bps[BLOCK_IO_LIMIT_TOTAL] = bps; |
975 | io_limits.bps[BLOCK_IO_LIMIT_READ] = bps_rd; | |
976 | io_limits.bps[BLOCK_IO_LIMIT_WRITE] = bps_wr; | |
977 | io_limits.iops[BLOCK_IO_LIMIT_TOTAL]= iops; | |
978 | io_limits.iops[BLOCK_IO_LIMIT_READ] = iops_rd; | |
979 | io_limits.iops[BLOCK_IO_LIMIT_WRITE]= iops_wr; | |
727f005e | 980 | |
c546194f | 981 | if (!do_check_io_limits(&io_limits, errp)) { |
80047da5 | 982 | return; |
727f005e ZYW |
983 | } |
984 | ||
985 | bs->io_limits = io_limits; | |
986 | bs->slice_time = BLOCK_IO_SLICE_TIME; | |
987 | ||
988 | if (!bs->io_limits_enabled && bdrv_io_limits_enabled(bs)) { | |
989 | bdrv_io_limits_enable(bs); | |
990 | } else if (bs->io_limits_enabled && !bdrv_io_limits_enabled(bs)) { | |
991 | bdrv_io_limits_disable(bs); | |
992 | } else { | |
993 | if (bs->block_timer) { | |
994 | qemu_mod_timer(bs->block_timer, qemu_get_clock_ns(vm_clock)); | |
995 | } | |
996 | } | |
727f005e ZYW |
997 | } |
998 | ||
9063f814 RH |
999 | int do_drive_del(Monitor *mon, const QDict *qdict, QObject **ret_data) |
1000 | { | |
1001 | const char *id = qdict_get_str(qdict, "id"); | |
1002 | BlockDriverState *bs; | |
9063f814 RH |
1003 | |
1004 | bs = bdrv_find(id); | |
1005 | if (!bs) { | |
1006 | qerror_report(QERR_DEVICE_NOT_FOUND, id); | |
1007 | return -1; | |
1008 | } | |
8591675f MT |
1009 | if (bdrv_in_use(bs)) { |
1010 | qerror_report(QERR_DEVICE_IN_USE, id); | |
1011 | return -1; | |
1012 | } | |
9063f814 RH |
1013 | |
1014 | /* quiesce block driver; prevent further io */ | |
922453bc | 1015 | bdrv_drain_all(); |
9063f814 RH |
1016 | bdrv_flush(bs); |
1017 | bdrv_close(bs); | |
1018 | ||
fa879d62 | 1019 | /* if we have a device attached to this BlockDriverState |
d22b2f41 RH |
1020 | * then we need to make the drive anonymous until the device |
1021 | * can be removed. If this is a drive with no device backing | |
1022 | * then we can just get rid of the block driver state right here. | |
1023 | */ | |
fa879d62 | 1024 | if (bdrv_get_attached_dev(bs)) { |
d22b2f41 RH |
1025 | bdrv_make_anon(bs); |
1026 | } else { | |
1027 | drive_uninit(drive_get_by_blockdev(bs)); | |
9063f814 RH |
1028 | } |
1029 | ||
9063f814 RH |
1030 | return 0; |
1031 | } | |
6d4a2b3a | 1032 | |
5e7caacb | 1033 | void qmp_block_resize(const char *device, int64_t size, Error **errp) |
6d4a2b3a | 1034 | { |
6d4a2b3a CH |
1035 | BlockDriverState *bs; |
1036 | ||
1037 | bs = bdrv_find(device); | |
1038 | if (!bs) { | |
5e7caacb LC |
1039 | error_set(errp, QERR_DEVICE_NOT_FOUND, device); |
1040 | return; | |
6d4a2b3a CH |
1041 | } |
1042 | ||
1043 | if (size < 0) { | |
939a1cc3 | 1044 | error_set(errp, QERR_INVALID_PARAMETER_VALUE, "size", "a >0 size"); |
5e7caacb | 1045 | return; |
6d4a2b3a CH |
1046 | } |
1047 | ||
939a1cc3 SH |
1048 | switch (bdrv_truncate(bs, size)) { |
1049 | case 0: | |
1050 | break; | |
1051 | case -ENOMEDIUM: | |
1052 | error_set(errp, QERR_DEVICE_HAS_NO_MEDIUM, device); | |
1053 | break; | |
1054 | case -ENOTSUP: | |
1055 | error_set(errp, QERR_UNSUPPORTED); | |
1056 | break; | |
1057 | case -EACCES: | |
1058 | error_set(errp, QERR_DEVICE_IS_READ_ONLY, device); | |
1059 | break; | |
1060 | case -EBUSY: | |
1061 | error_set(errp, QERR_DEVICE_IN_USE, device); | |
1062 | break; | |
1063 | default: | |
5e7caacb | 1064 | error_set(errp, QERR_UNDEFINED_ERROR); |
939a1cc3 | 1065 | break; |
6d4a2b3a | 1066 | } |
6d4a2b3a | 1067 | } |
12bd451f | 1068 | |
9abf2dba | 1069 | static void block_job_cb(void *opaque, int ret) |
12bd451f SH |
1070 | { |
1071 | BlockDriverState *bs = opaque; | |
1072 | QObject *obj; | |
1073 | ||
9abf2dba | 1074 | trace_block_job_cb(bs, bs->job, ret); |
12bd451f SH |
1075 | |
1076 | assert(bs->job); | |
1077 | obj = qobject_from_block_job(bs->job); | |
1078 | if (ret < 0) { | |
1079 | QDict *dict = qobject_to_qdict(obj); | |
1080 | qdict_put(dict, "error", qstring_from_str(strerror(-ret))); | |
1081 | } | |
1082 | ||
370521a1 SH |
1083 | if (block_job_is_cancelled(bs->job)) { |
1084 | monitor_protocol_event(QEVENT_BLOCK_JOB_CANCELLED, obj); | |
1085 | } else { | |
1086 | monitor_protocol_event(QEVENT_BLOCK_JOB_COMPLETED, obj); | |
1087 | } | |
12bd451f | 1088 | qobject_decref(obj); |
aa398a5c SH |
1089 | |
1090 | drive_put_ref_bh_schedule(drive_get_by_blockdev(bs)); | |
12bd451f SH |
1091 | } |
1092 | ||
1093 | void qmp_block_stream(const char *device, bool has_base, | |
1d809098 PB |
1094 | const char *base, bool has_speed, int64_t speed, |
1095 | bool has_on_error, BlockdevOnError on_error, | |
1096 | Error **errp) | |
12bd451f SH |
1097 | { |
1098 | BlockDriverState *bs; | |
c8c3080f | 1099 | BlockDriverState *base_bs = NULL; |
fd7f8c65 | 1100 | Error *local_err = NULL; |
12bd451f | 1101 | |
1d809098 PB |
1102 | if (!has_on_error) { |
1103 | on_error = BLOCKDEV_ON_ERROR_REPORT; | |
1104 | } | |
1105 | ||
12bd451f SH |
1106 | bs = bdrv_find(device); |
1107 | if (!bs) { | |
1108 | error_set(errp, QERR_DEVICE_NOT_FOUND, device); | |
1109 | return; | |
1110 | } | |
1111 | ||
12bd451f | 1112 | if (base) { |
c8c3080f MT |
1113 | base_bs = bdrv_find_backing_image(bs, base); |
1114 | if (base_bs == NULL) { | |
1115 | error_set(errp, QERR_BASE_NOT_FOUND, base); | |
1116 | return; | |
1117 | } | |
12bd451f SH |
1118 | } |
1119 | ||
c83c66c3 | 1120 | stream_start(bs, base_bs, base, has_speed ? speed : 0, |
1d809098 | 1121 | on_error, block_job_cb, bs, &local_err); |
fd7f8c65 SH |
1122 | if (error_is_set(&local_err)) { |
1123 | error_propagate(errp, local_err); | |
1124 | return; | |
12bd451f SH |
1125 | } |
1126 | ||
aa398a5c SH |
1127 | /* Grab a reference so hotplug does not delete the BlockDriverState from |
1128 | * underneath us. | |
1129 | */ | |
1130 | drive_get_ref(drive_get_by_blockdev(bs)); | |
1131 | ||
12bd451f SH |
1132 | trace_qmp_block_stream(bs, bs->job); |
1133 | } | |
2d47c6e9 | 1134 | |
ed61fc10 JC |
1135 | void qmp_block_commit(const char *device, |
1136 | bool has_base, const char *base, const char *top, | |
1137 | bool has_speed, int64_t speed, | |
1138 | Error **errp) | |
1139 | { | |
1140 | BlockDriverState *bs; | |
1141 | BlockDriverState *base_bs, *top_bs; | |
1142 | Error *local_err = NULL; | |
1143 | /* This will be part of the QMP command, if/when the | |
1144 | * BlockdevOnError change for blkmirror makes it in | |
1145 | */ | |
92aa5c6d | 1146 | BlockdevOnError on_error = BLOCKDEV_ON_ERROR_REPORT; |
ed61fc10 JC |
1147 | |
1148 | /* drain all i/o before commits */ | |
1149 | bdrv_drain_all(); | |
1150 | ||
1151 | bs = bdrv_find(device); | |
1152 | if (!bs) { | |
1153 | error_set(errp, QERR_DEVICE_NOT_FOUND, device); | |
1154 | return; | |
1155 | } | |
ed61fc10 JC |
1156 | |
1157 | /* default top_bs is the active layer */ | |
1158 | top_bs = bs; | |
1159 | ||
1160 | if (top) { | |
1161 | if (strcmp(bs->filename, top) != 0) { | |
1162 | top_bs = bdrv_find_backing_image(bs, top); | |
1163 | } | |
1164 | } | |
1165 | ||
1166 | if (top_bs == NULL) { | |
1167 | error_setg(errp, "Top image file %s not found", top ? top : "NULL"); | |
1168 | return; | |
1169 | } | |
1170 | ||
d5208c45 JC |
1171 | if (has_base && base) { |
1172 | base_bs = bdrv_find_backing_image(top_bs, base); | |
1173 | } else { | |
1174 | base_bs = bdrv_find_base(top_bs); | |
1175 | } | |
1176 | ||
1177 | if (base_bs == NULL) { | |
1178 | error_set(errp, QERR_BASE_NOT_FOUND, base ? base : "NULL"); | |
1179 | return; | |
1180 | } | |
1181 | ||
ed61fc10 JC |
1182 | commit_start(bs, base_bs, top_bs, speed, on_error, block_job_cb, bs, |
1183 | &local_err); | |
1184 | if (local_err != NULL) { | |
1185 | error_propagate(errp, local_err); | |
1186 | return; | |
1187 | } | |
1188 | /* Grab a reference so hotplug does not delete the BlockDriverState from | |
1189 | * underneath us. | |
1190 | */ | |
1191 | drive_get_ref(drive_get_by_blockdev(bs)); | |
1192 | } | |
1193 | ||
08e4ed6c PB |
1194 | #define DEFAULT_MIRROR_BUF_SIZE (10 << 20) |
1195 | ||
d9b902db PB |
1196 | void qmp_drive_mirror(const char *device, const char *target, |
1197 | bool has_format, const char *format, | |
1198 | enum MirrorSyncMode sync, | |
1199 | bool has_mode, enum NewImageMode mode, | |
b952b558 | 1200 | bool has_speed, int64_t speed, |
eee13dfe | 1201 | bool has_granularity, uint32_t granularity, |
08e4ed6c | 1202 | bool has_buf_size, int64_t buf_size, |
b952b558 PB |
1203 | bool has_on_source_error, BlockdevOnError on_source_error, |
1204 | bool has_on_target_error, BlockdevOnError on_target_error, | |
1205 | Error **errp) | |
d9b902db | 1206 | { |
d9b902db PB |
1207 | BlockDriverState *bs; |
1208 | BlockDriverState *source, *target_bs; | |
1209 | BlockDriver *proto_drv; | |
1210 | BlockDriver *drv = NULL; | |
1211 | Error *local_err = NULL; | |
1212 | int flags; | |
1213 | uint64_t size; | |
1214 | int ret; | |
1215 | ||
1216 | if (!has_speed) { | |
1217 | speed = 0; | |
1218 | } | |
b952b558 PB |
1219 | if (!has_on_source_error) { |
1220 | on_source_error = BLOCKDEV_ON_ERROR_REPORT; | |
1221 | } | |
1222 | if (!has_on_target_error) { | |
1223 | on_target_error = BLOCKDEV_ON_ERROR_REPORT; | |
1224 | } | |
d9b902db PB |
1225 | if (!has_mode) { |
1226 | mode = NEW_IMAGE_MODE_ABSOLUTE_PATHS; | |
1227 | } | |
eee13dfe PB |
1228 | if (!has_granularity) { |
1229 | granularity = 0; | |
1230 | } | |
08e4ed6c PB |
1231 | if (!has_buf_size) { |
1232 | buf_size = DEFAULT_MIRROR_BUF_SIZE; | |
1233 | } | |
1234 | ||
eee13dfe PB |
1235 | if (granularity != 0 && (granularity < 512 || granularity > 1048576 * 64)) { |
1236 | error_set(errp, QERR_INVALID_PARAMETER, device); | |
1237 | return; | |
1238 | } | |
1239 | if (granularity & (granularity - 1)) { | |
1240 | error_set(errp, QERR_INVALID_PARAMETER, device); | |
1241 | return; | |
1242 | } | |
d9b902db PB |
1243 | |
1244 | bs = bdrv_find(device); | |
1245 | if (!bs) { | |
1246 | error_set(errp, QERR_DEVICE_NOT_FOUND, device); | |
1247 | return; | |
1248 | } | |
1249 | ||
1250 | if (!bdrv_is_inserted(bs)) { | |
1251 | error_set(errp, QERR_DEVICE_HAS_NO_MEDIUM, device); | |
1252 | return; | |
1253 | } | |
1254 | ||
1255 | if (!has_format) { | |
1256 | format = mode == NEW_IMAGE_MODE_EXISTING ? NULL : bs->drv->format_name; | |
1257 | } | |
1258 | if (format) { | |
1259 | drv = bdrv_find_format(format); | |
1260 | if (!drv) { | |
1261 | error_set(errp, QERR_INVALID_BLOCK_FORMAT, format); | |
1262 | return; | |
1263 | } | |
1264 | } | |
1265 | ||
1266 | if (bdrv_in_use(bs)) { | |
1267 | error_set(errp, QERR_DEVICE_IN_USE, device); | |
1268 | return; | |
1269 | } | |
1270 | ||
1271 | flags = bs->open_flags | BDRV_O_RDWR; | |
1272 | source = bs->backing_hd; | |
1273 | if (!source && sync == MIRROR_SYNC_MODE_TOP) { | |
1274 | sync = MIRROR_SYNC_MODE_FULL; | |
1275 | } | |
1276 | ||
1277 | proto_drv = bdrv_find_protocol(target); | |
1278 | if (!proto_drv) { | |
1279 | error_set(errp, QERR_INVALID_BLOCK_FORMAT, format); | |
1280 | return; | |
1281 | } | |
1282 | ||
86899072 VI |
1283 | bdrv_get_geometry(bs, &size); |
1284 | size *= 512; | |
d9b902db PB |
1285 | if (sync == MIRROR_SYNC_MODE_FULL && mode != NEW_IMAGE_MODE_EXISTING) { |
1286 | /* create new image w/o backing file */ | |
1287 | assert(format && drv); | |
cf8f2426 LC |
1288 | bdrv_img_create(target, format, |
1289 | NULL, NULL, NULL, size, flags, &local_err); | |
d9b902db PB |
1290 | } else { |
1291 | switch (mode) { | |
1292 | case NEW_IMAGE_MODE_EXISTING: | |
1293 | ret = 0; | |
1294 | break; | |
1295 | case NEW_IMAGE_MODE_ABSOLUTE_PATHS: | |
1296 | /* create new image with backing file */ | |
cf8f2426 LC |
1297 | bdrv_img_create(target, format, |
1298 | source->filename, | |
1299 | source->drv->format_name, | |
86899072 | 1300 | NULL, size, flags, &local_err); |
d9b902db PB |
1301 | break; |
1302 | default: | |
1303 | abort(); | |
1304 | } | |
1305 | } | |
1306 | ||
cf8f2426 LC |
1307 | if (error_is_set(&local_err)) { |
1308 | error_propagate(errp, local_err); | |
d9b902db PB |
1309 | return; |
1310 | } | |
1311 | ||
b812f671 PB |
1312 | /* Mirroring takes care of copy-on-write using the source's backing |
1313 | * file. | |
1314 | */ | |
d9b902db PB |
1315 | target_bs = bdrv_new(""); |
1316 | ret = bdrv_open(target_bs, target, flags | BDRV_O_NO_BACKING, drv); | |
1317 | ||
1318 | if (ret < 0) { | |
1319 | bdrv_delete(target_bs); | |
1320 | error_set(errp, QERR_OPEN_FILE_FAILED, target); | |
1321 | return; | |
1322 | } | |
1323 | ||
08e4ed6c | 1324 | mirror_start(bs, target_bs, speed, granularity, buf_size, sync, |
eee13dfe | 1325 | on_source_error, on_target_error, |
b952b558 | 1326 | block_job_cb, bs, &local_err); |
d9b902db PB |
1327 | if (local_err != NULL) { |
1328 | bdrv_delete(target_bs); | |
1329 | error_propagate(errp, local_err); | |
1330 | return; | |
1331 | } | |
1332 | ||
1333 | /* Grab a reference so hotplug does not delete the BlockDriverState from | |
1334 | * underneath us. | |
1335 | */ | |
1336 | drive_get_ref(drive_get_by_blockdev(bs)); | |
1337 | } | |
1338 | ||
2d47c6e9 SH |
1339 | static BlockJob *find_block_job(const char *device) |
1340 | { | |
1341 | BlockDriverState *bs; | |
1342 | ||
1343 | bs = bdrv_find(device); | |
1344 | if (!bs || !bs->job) { | |
1345 | return NULL; | |
1346 | } | |
1347 | return bs->job; | |
1348 | } | |
1349 | ||
882ec7ce | 1350 | void qmp_block_job_set_speed(const char *device, int64_t speed, Error **errp) |
2d47c6e9 SH |
1351 | { |
1352 | BlockJob *job = find_block_job(device); | |
1353 | ||
1354 | if (!job) { | |
7ef15070 | 1355 | error_set(errp, QERR_BLOCK_JOB_NOT_ACTIVE, device); |
2d47c6e9 SH |
1356 | return; |
1357 | } | |
1358 | ||
882ec7ce | 1359 | block_job_set_speed(job, speed, errp); |
2d47c6e9 | 1360 | } |
370521a1 | 1361 | |
6e37fb81 PB |
1362 | void qmp_block_job_cancel(const char *device, |
1363 | bool has_force, bool force, Error **errp) | |
370521a1 SH |
1364 | { |
1365 | BlockJob *job = find_block_job(device); | |
1366 | ||
6e37fb81 PB |
1367 | if (!has_force) { |
1368 | force = false; | |
1369 | } | |
1370 | ||
370521a1 | 1371 | if (!job) { |
7ef15070 | 1372 | error_set(errp, QERR_BLOCK_JOB_NOT_ACTIVE, device); |
370521a1 SH |
1373 | return; |
1374 | } | |
6e37fb81 | 1375 | if (job->paused && !force) { |
8acc72a4 PB |
1376 | error_set(errp, QERR_BLOCK_JOB_PAUSED, device); |
1377 | return; | |
1378 | } | |
370521a1 SH |
1379 | |
1380 | trace_qmp_block_job_cancel(job); | |
1381 | block_job_cancel(job); | |
1382 | } | |
fb5458cd | 1383 | |
6e37fb81 PB |
1384 | void qmp_block_job_pause(const char *device, Error **errp) |
1385 | { | |
1386 | BlockJob *job = find_block_job(device); | |
1387 | ||
1388 | if (!job) { | |
1389 | error_set(errp, QERR_BLOCK_JOB_NOT_ACTIVE, device); | |
1390 | return; | |
1391 | } | |
1392 | ||
1393 | trace_qmp_block_job_pause(job); | |
1394 | block_job_pause(job); | |
1395 | } | |
1396 | ||
1397 | void qmp_block_job_resume(const char *device, Error **errp) | |
1398 | { | |
1399 | BlockJob *job = find_block_job(device); | |
1400 | ||
1401 | if (!job) { | |
1402 | error_set(errp, QERR_BLOCK_JOB_NOT_ACTIVE, device); | |
1403 | return; | |
1404 | } | |
1405 | ||
1406 | trace_qmp_block_job_resume(job); | |
1407 | block_job_resume(job); | |
1408 | } | |
1409 | ||
aeae883b PB |
1410 | void qmp_block_job_complete(const char *device, Error **errp) |
1411 | { | |
1412 | BlockJob *job = find_block_job(device); | |
1413 | ||
1414 | if (!job) { | |
1415 | error_set(errp, QERR_BLOCK_JOB_NOT_ACTIVE, device); | |
1416 | return; | |
1417 | } | |
1418 | ||
1419 | trace_qmp_block_job_complete(job); | |
1420 | block_job_complete(job, errp); | |
1421 | } | |
1422 | ||
fb5458cd SH |
1423 | static void do_qmp_query_block_jobs_one(void *opaque, BlockDriverState *bs) |
1424 | { | |
1425 | BlockJobInfoList **prev = opaque; | |
1426 | BlockJob *job = bs->job; | |
1427 | ||
1428 | if (job) { | |
30e628b7 PB |
1429 | BlockJobInfoList *elem = g_new0(BlockJobInfoList, 1); |
1430 | elem->value = block_job_query(bs->job); | |
fb5458cd SH |
1431 | (*prev)->next = elem; |
1432 | *prev = elem; | |
1433 | } | |
1434 | } | |
1435 | ||
1436 | BlockJobInfoList *qmp_query_block_jobs(Error **errp) | |
1437 | { | |
1438 | /* Dummy is a fake list element for holding the head pointer */ | |
1439 | BlockJobInfoList dummy = {}; | |
1440 | BlockJobInfoList *prev = &dummy; | |
1441 | bdrv_iterate(do_qmp_query_block_jobs_one, &prev); | |
1442 | return dummy.next; | |
1443 | } | |
4d454574 PB |
1444 | |
1445 | QemuOptsList qemu_drive_opts = { | |
1446 | .name = "drive", | |
1447 | .head = QTAILQ_HEAD_INITIALIZER(qemu_drive_opts.head), | |
1448 | .desc = { | |
1449 | { | |
1450 | .name = "bus", | |
1451 | .type = QEMU_OPT_NUMBER, | |
1452 | .help = "bus number", | |
1453 | },{ | |
1454 | .name = "unit", | |
1455 | .type = QEMU_OPT_NUMBER, | |
1456 | .help = "unit number (i.e. lun for scsi)", | |
1457 | },{ | |
1458 | .name = "if", | |
1459 | .type = QEMU_OPT_STRING, | |
1460 | .help = "interface (ide, scsi, sd, mtd, floppy, pflash, virtio)", | |
1461 | },{ | |
1462 | .name = "index", | |
1463 | .type = QEMU_OPT_NUMBER, | |
1464 | .help = "index number", | |
1465 | },{ | |
1466 | .name = "cyls", | |
1467 | .type = QEMU_OPT_NUMBER, | |
1468 | .help = "number of cylinders (ide disk geometry)", | |
1469 | },{ | |
1470 | .name = "heads", | |
1471 | .type = QEMU_OPT_NUMBER, | |
1472 | .help = "number of heads (ide disk geometry)", | |
1473 | },{ | |
1474 | .name = "secs", | |
1475 | .type = QEMU_OPT_NUMBER, | |
1476 | .help = "number of sectors (ide disk geometry)", | |
1477 | },{ | |
1478 | .name = "trans", | |
1479 | .type = QEMU_OPT_STRING, | |
1480 | .help = "chs translation (auto, lba. none)", | |
1481 | },{ | |
1482 | .name = "media", | |
1483 | .type = QEMU_OPT_STRING, | |
1484 | .help = "media type (disk, cdrom)", | |
1485 | },{ | |
1486 | .name = "snapshot", | |
1487 | .type = QEMU_OPT_BOOL, | |
1488 | .help = "enable/disable snapshot mode", | |
1489 | },{ | |
1490 | .name = "file", | |
1491 | .type = QEMU_OPT_STRING, | |
1492 | .help = "disk image", | |
1493 | },{ | |
1494 | .name = "cache", | |
1495 | .type = QEMU_OPT_STRING, | |
1496 | .help = "host cache usage (none, writeback, writethrough, " | |
1497 | "directsync, unsafe)", | |
1498 | },{ | |
1499 | .name = "aio", | |
1500 | .type = QEMU_OPT_STRING, | |
1501 | .help = "host AIO implementation (threads, native)", | |
1502 | },{ | |
1503 | .name = "format", | |
1504 | .type = QEMU_OPT_STRING, | |
1505 | .help = "disk format (raw, qcow2, ...)", | |
1506 | },{ | |
1507 | .name = "serial", | |
1508 | .type = QEMU_OPT_STRING, | |
1509 | .help = "disk serial number", | |
1510 | },{ | |
1511 | .name = "rerror", | |
1512 | .type = QEMU_OPT_STRING, | |
1513 | .help = "read error action", | |
1514 | },{ | |
1515 | .name = "werror", | |
1516 | .type = QEMU_OPT_STRING, | |
1517 | .help = "write error action", | |
1518 | },{ | |
1519 | .name = "addr", | |
1520 | .type = QEMU_OPT_STRING, | |
1521 | .help = "pci address (virtio only)", | |
1522 | },{ | |
1523 | .name = "readonly", | |
1524 | .type = QEMU_OPT_BOOL, | |
1525 | .help = "open drive file as read-only", | |
1526 | },{ | |
1527 | .name = "iops", | |
1528 | .type = QEMU_OPT_NUMBER, | |
1529 | .help = "limit total I/O operations per second", | |
1530 | },{ | |
1531 | .name = "iops_rd", | |
1532 | .type = QEMU_OPT_NUMBER, | |
1533 | .help = "limit read operations per second", | |
1534 | },{ | |
1535 | .name = "iops_wr", | |
1536 | .type = QEMU_OPT_NUMBER, | |
1537 | .help = "limit write operations per second", | |
1538 | },{ | |
1539 | .name = "bps", | |
1540 | .type = QEMU_OPT_NUMBER, | |
1541 | .help = "limit total bytes per second", | |
1542 | },{ | |
1543 | .name = "bps_rd", | |
1544 | .type = QEMU_OPT_NUMBER, | |
1545 | .help = "limit read bytes per second", | |
1546 | },{ | |
1547 | .name = "bps_wr", | |
1548 | .type = QEMU_OPT_NUMBER, | |
1549 | .help = "limit write bytes per second", | |
1550 | },{ | |
1551 | .name = "copy-on-read", | |
1552 | .type = QEMU_OPT_BOOL, | |
1553 | .help = "copy read data from backing file into image file", | |
1554 | },{ | |
1555 | .name = "boot", | |
1556 | .type = QEMU_OPT_BOOL, | |
1557 | .help = "(deprecated, ignored)", | |
1558 | }, | |
1559 | { /* end of list */ } | |
1560 | }, | |
1561 | }; |