| qemu-options.hx (0a86cb731758a7167374ca68735125ce81211002) | qemu-options.hx (465bee1da82e43f18d10c43cc7566d0284ad13a9) |
|---|---|
| 1HXCOMM Use DEFHEADING() to define headings in both help text and texi 2HXCOMM Text between STEXI and ETEXI are copied to texi version and 3HXCOMM discarded from C version 4HXCOMM DEF(option, HAS_ARG/0, opt_enum, opt_help, arch_mask) is used to 5HXCOMM construct option structures, enums and help message for specified 6HXCOMM architectures. 7HXCOMM HXCOMM can be used for comments, discarded from both texi and C 8 --- 400 unchanged lines hidden (view full) --- 409 410DEF("drive", HAS_ARG, QEMU_OPTION_drive, 411 "-drive [file=file][,if=type][,bus=n][,unit=m][,media=d][,index=i]\n" 412 " [,cyls=c,heads=h,secs=s[,trans=t]][,snapshot=on|off]\n" 413 " [,cache=writethrough|writeback|none|directsync|unsafe][,format=f]\n" 414 " [,serial=s][,addr=A][,rerror=ignore|stop|report]\n" 415 " [,werror=ignore|stop|report|enospc][,id=name][,aio=threads|native]\n" 416 " [,readonly=on|off][,copy-on-read=on|off]\n" | 1HXCOMM Use DEFHEADING() to define headings in both help text and texi 2HXCOMM Text between STEXI and ETEXI are copied to texi version and 3HXCOMM discarded from C version 4HXCOMM DEF(option, HAS_ARG/0, opt_enum, opt_help, arch_mask) is used to 5HXCOMM construct option structures, enums and help message for specified 6HXCOMM architectures. 7HXCOMM HXCOMM can be used for comments, discarded from both texi and C 8 --- 400 unchanged lines hidden (view full) --- 409 410DEF("drive", HAS_ARG, QEMU_OPTION_drive, 411 "-drive [file=file][,if=type][,bus=n][,unit=m][,media=d][,index=i]\n" 412 " [,cyls=c,heads=h,secs=s[,trans=t]][,snapshot=on|off]\n" 413 " [,cache=writethrough|writeback|none|directsync|unsafe][,format=f]\n" 414 " [,serial=s][,addr=A][,rerror=ignore|stop|report]\n" 415 " [,werror=ignore|stop|report|enospc][,id=name][,aio=threads|native]\n" 416 " [,readonly=on|off][,copy-on-read=on|off]\n" |
| 417 " [,detect-zeroes=on|off|unmap]\n" |
|
| 417 " [[,bps=b]|[[,bps_rd=r][,bps_wr=w]]]\n" 418 " [[,iops=i]|[[,iops_rd=r][,iops_wr=w]]]\n" 419 " [[,bps_max=bm]|[[,bps_rd_max=rm][,bps_wr_max=wm]]]\n" 420 " [[,iops_max=im]|[[,iops_rd_max=irm][,iops_wr_max=iwm]]]\n" 421 " [[,iops_size=is]]\n" 422 " use 'file' as a drive image\n", QEMU_ARCH_ALL) 423STEXI 424@item -drive @var{option}[,@var{option}[,@var{option}[,...]]] --- 45 unchanged lines hidden (view full) --- 470"report" (report the error to the guest), "enospc" (pause QEMU only if the 471host disk is full; report the error to the guest otherwise). 472The default setting is @option{werror=enospc} and @option{rerror=report}. 473@item readonly 474Open drive @option{file} as read-only. Guest write attempts will fail. 475@item copy-on-read=@var{copy-on-read} 476@var{copy-on-read} is "on" or "off" and enables whether to copy read backing 477file sectors into the image file. | 418 " [[,bps=b]|[[,bps_rd=r][,bps_wr=w]]]\n" 419 " [[,iops=i]|[[,iops_rd=r][,iops_wr=w]]]\n" 420 " [[,bps_max=bm]|[[,bps_rd_max=rm][,bps_wr_max=wm]]]\n" 421 " [[,iops_max=im]|[[,iops_rd_max=irm][,iops_wr_max=iwm]]]\n" 422 " [[,iops_size=is]]\n" 423 " use 'file' as a drive image\n", QEMU_ARCH_ALL) 424STEXI 425@item -drive @var{option}[,@var{option}[,@var{option}[,...]]] --- 45 unchanged lines hidden (view full) --- 471"report" (report the error to the guest), "enospc" (pause QEMU only if the 472host disk is full; report the error to the guest otherwise). 473The default setting is @option{werror=enospc} and @option{rerror=report}. 474@item readonly 475Open drive @option{file} as read-only. Guest write attempts will fail. 476@item copy-on-read=@var{copy-on-read} 477@var{copy-on-read} is "on" or "off" and enables whether to copy read backing 478file sectors into the image file. |
| 479@item detect-zeroes=@var{detect-zeroes} 480@var{detect-zeroes} is "off", "on" or "unmap" and enables the automatic 481conversion of plain zero writes by the OS to driver specific optimized 482zero write commands. You may even choose "unmap" if @var{discard} is set 483to "unmap" to allow a zero write to be converted to an UNMAP operation. |
|
| 478@end table 479 480By default, the @option{cache=writeback} mode is used. It will report data 481writes as completed as soon as the data is present in the host page cache. 482This is safe as long as your guest OS makes sure to correctly flush disk caches 483where needed. If your guest OS does not handle volatile disk write caches 484correctly and your host crashes or loses power, then the guest may experience 485data corruption. --- 2735 unchanged lines hidden --- | 484@end table 485 486By default, the @option{cache=writeback} mode is used. It will report data 487writes as completed as soon as the data is present in the host page cache. 488This is safe as long as your guest OS makes sure to correctly flush disk caches 489where needed. If your guest OS does not handle volatile disk write caches 490correctly and your host crashes or loses power, then the guest may experience 491data corruption. --- 2735 unchanged lines hidden --- |