Diff for /qemu/qemu-options.hx between versions 1.1.1.10 and 1.1.1.11

version 1.1.1.10, 2018/04/24 19:17:36 version 1.1.1.11, 2018/04/24 19:34:52
Line 31  DEF("machine", HAS_ARG, QEMU_OPTION_mach Line 31  DEF("machine", HAS_ARG, QEMU_OPTION_mach
     "-machine [type=]name[,prop[=value][,...]]\n"      "-machine [type=]name[,prop[=value][,...]]\n"
     "                selects emulated machine (-machine ? for list)\n"      "                selects emulated machine (-machine ? for list)\n"
     "                property accel=accel1[:accel2[:...]] selects accelerator\n"      "                property accel=accel1[:accel2[:...]] selects accelerator\n"
     "                supported accelerators are kvm, xen, tcg (default: tcg)\n",      "                supported accelerators are kvm, xen, tcg (default: tcg)\n"
       "                kernel_irqchip=on|off controls accelerated irqchip support\n"
       "                kvm_shadow_mem=size of KVM shadow MMU\n",
     QEMU_ARCH_ALL)      QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -machine [type=]@var{name}[,prop=@var{value}[,...]]  @item -machine [type=]@var{name}[,prop=@var{value}[,...]]
Line 44  This is used to enable an accelerator. D Line 46  This is used to enable an accelerator. D
 kvm, xen, or tcg can be available. By default, tcg is used. If there is more  kvm, xen, or tcg can be available. By default, tcg is used. If there is more
 than one accelerator specified, the next one is used if the previous one fails  than one accelerator specified, the next one is used if the previous one fails
 to initialize.  to initialize.
   @item kernel_irqchip=on|off
   Enables in-kernel irqchip support for the chosen accelerator when available.
   @item kvm_shadow_mem=size
   Defines the size of the KVM shadow MMU.
 @end table  @end table
 ETEXI  ETEXI
   
Line 135  DEF("drive", HAS_ARG, QEMU_OPTION_drive, Line 141  DEF("drive", HAS_ARG, QEMU_OPTION_drive,
     "       [,cyls=c,heads=h,secs=s[,trans=t]][,snapshot=on|off]\n"      "       [,cyls=c,heads=h,secs=s[,trans=t]][,snapshot=on|off]\n"
     "       [,cache=writethrough|writeback|none|directsync|unsafe][,format=f]\n"      "       [,cache=writethrough|writeback|none|directsync|unsafe][,format=f]\n"
     "       [,serial=s][,addr=A][,id=name][,aio=threads|native]\n"      "       [,serial=s][,addr=A][,id=name][,aio=threads|native]\n"
     "       [,readonly=on|off]\n"      "       [,readonly=on|off][,copy-on-read=on|off]\n"
       "       [[,bps=b]|[[,bps_rd=r][,bps_wr=w]]][[,iops=i]|[[,iops_rd=r][,iops_wr=w]]\n"
     "                use 'file' as a drive image\n", QEMU_ARCH_ALL)      "                use 'file' as a drive image\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -drive @var{option}[,@var{option}[,@var{option}[,...]]]  @item -drive @var{option}[,@var{option}[,@var{option}[,...]]]
Line 186  host disk is full; report the error to t Line 193  host disk is full; report the error to t
 The default setting is @option{werror=enospc} and @option{rerror=report}.  The default setting is @option{werror=enospc} and @option{rerror=report}.
 @item readonly  @item readonly
 Open drive @option{file} as read-only. Guest write attempts will fail.  Open drive @option{file} as read-only. Guest write attempts will fail.
   @item copy-on-read=@var{copy-on-read}
   @var{copy-on-read} is "on" or "off" and enables whether to copy read backing
   file sectors into the image file.
 @end table  @end table
   
 By default, writethrough caching is used for all block device.  This means that  By default, writethrough caching is used for all block device.  This means that
Line 211  qcow2.  If performance is more important Line 221  qcow2.  If performance is more important
 @option{cache=writeback} should be used with qcow2.  @option{cache=writeback} should be used with qcow2.
   
 In case you don't care about data integrity over host failures, use  In case you don't care about data integrity over host failures, use
 cache=unsafe. This option tells qemu that it never needs to write any data  cache=unsafe. This option tells QEMU that it never needs to write any data
 to the disk but can instead keeps things in cache. If anything goes wrong,  to the disk but can instead keeps things in cache. If anything goes wrong,
 like your host losing power, the disk storage getting disconnected accidently,  like your host losing power, the disk storage getting disconnected accidentally,
 etc. you're image will most probably be rendered unusable.   When using  etc. you're image will most probably be rendered unusable.   When using
 the @option{-snapshot} option, unsafe caching is always used.  the @option{-snapshot} option, unsafe caching is always used.
   
   Copy-on-read avoids accessing the same backing file sectors repeatedly and is
   useful when the backing file is over a slow network.  By default copy-on-read
   is off.
   
 Instead of @option{-cdrom} you can use:  Instead of @option{-cdrom} you can use:
 @example  @example
 qemu -drive file=file,index=2,media=cdrom  qemu-system-i386 -drive file=file,index=2,media=cdrom
 @end example  @end example
   
 Instead of @option{-hda}, @option{-hdb}, @option{-hdc}, @option{-hdd}, you can  Instead of @option{-hda}, @option{-hdb}, @option{-hdc}, @option{-hdd}, you can
 use:  use:
 @example  @example
 qemu -drive file=file,index=0,media=disk  qemu-system-i386 -drive file=file,index=0,media=disk
 qemu -drive file=file,index=1,media=disk  qemu-system-i386 -drive file=file,index=1,media=disk
 qemu -drive file=file,index=2,media=disk  qemu-system-i386 -drive file=file,index=2,media=disk
 qemu -drive file=file,index=3,media=disk  qemu-system-i386 -drive file=file,index=3,media=disk
 @end example  @end example
   
 You can connect a CDROM to the slave of ide0:  You can connect a CDROM to the slave of ide0:
 @example  @example
 qemu -drive file=file,if=ide,index=1,media=cdrom  qemu-system-i386 -drive file=file,if=ide,index=1,media=cdrom
 @end example  @end example
   
 If you don't specify the "file=" argument, you define an empty drive:  If you don't specify the "file=" argument, you define an empty drive:
 @example  @example
 qemu -drive if=ide,index=1,media=cdrom  qemu-system-i386 -drive if=ide,index=1,media=cdrom
 @end example  @end example
   
 You can connect a SCSI disk with unit ID 6 on the bus #0:  You can connect a SCSI disk with unit ID 6 on the bus #0:
 @example  @example
 qemu -drive file=file,if=scsi,bus=0,unit=6  qemu-system-i386 -drive file=file,if=scsi,bus=0,unit=6
 @end example  @end example
   
 Instead of @option{-fda}, @option{-fdb}, you can use:  Instead of @option{-fda}, @option{-fdb}, you can use:
 @example  @example
 qemu -drive file=file,index=0,if=floppy  qemu-system-i386 -drive file=file,index=0,if=floppy
 qemu -drive file=file,index=1,if=floppy  qemu-system-i386 -drive file=file,index=1,if=floppy
 @end example  @end example
   
 By default, @var{interface} is "ide" and @var{index} is automatically  By default, @var{interface} is "ide" and @var{index} is automatically
 incremented:  incremented:
 @example  @example
 qemu -drive file=a -drive file=b"  qemu-system-i386 -drive file=a -drive file=b"
 @end example  @end example
 is interpreted like:  is interpreted like:
 @example  @example
 qemu -hda a -hdb b  qemu-system-i386 -hda a -hdb b
 @end example  @end example
 ETEXI  ETEXI
   
Line 274  TODO Line 288  TODO
 ETEXI  ETEXI
   
 DEF("global", HAS_ARG, QEMU_OPTION_global,  DEF("global", HAS_ARG, QEMU_OPTION_global,
     "-global driver.property=value\n"      "-global driver.prop=value\n"
     "                set a global default for a driver property\n",      "                set a global default for a driver property\n",
     QEMU_ARCH_ALL)      QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -global  @item -global @var{driver}.@var{prop}=@var{value}
 @findex -global  @findex -global
 TODO  Set default value of @var{driver}'s property @var{prop} to @var{value}, e.g.:
   
   @example
   qemu-system-i386 -global ide-drive.physical_block_size=4096 -drive file=file,if=ide,index=0,media=disk
   @end example
   
   In particular, you can use this to set driver properties for devices which are 
   created automatically by the machine model. To create a device which is not 
   created automatically and set properties on it, use -@option{device}.
 ETEXI  ETEXI
   
 DEF("mtdblock", HAS_ARG, QEMU_OPTION_mtdblock,  DEF("mtdblock", HAS_ARG, QEMU_OPTION_mtdblock,
Line 337  the recommended is 320x240, 640x480, 800 Line 359  the recommended is 320x240, 640x480, 800
   
 @example  @example
 # try to boot from network first, then from hard disk  # try to boot from network first, then from hard disk
 qemu -boot order=nc  qemu-system-i386 -boot order=nc
 # boot from CD-ROM first, switch back to default order after reboot  # boot from CD-ROM first, switch back to default order after reboot
 qemu -boot once=d  qemu-system-i386 -boot once=d
 # boot with a splash picture for 5 seconds.  # boot with a splash picture for 5 seconds.
 qemu -boot menu=on,splash=/root/boot.bmp,splash-time=5000  qemu-system-i386 -boot menu=on,splash=/root/boot.bmp,splash-time=5000
 @end example  @end example
   
 Note: The legacy format '-boot @var{drives}' is still supported but its  Note: The legacy format '-boot @var{drives}' is still supported but its
Line 432  Enable audio and selected sound hardware Line 454  Enable audio and selected sound hardware
 available sound hardware.  available sound hardware.
   
 @example  @example
 qemu -soundhw sb16,adlib disk.img  qemu-system-i386 -soundhw sb16,adlib disk.img
 qemu -soundhw es1370 disk.img  qemu-system-i386 -soundhw es1370 disk.img
 qemu -soundhw ac97 disk.img  qemu-system-i386 -soundhw ac97 disk.img
 qemu -soundhw hda disk.img  qemu-system-i386 -soundhw hda disk.img
 qemu -soundhw all disk.img  qemu-system-i386 -soundhw all disk.img
 qemu -soundhw ?  qemu-system-i386 -soundhw ?
 @end example  @end example
   
 Note that Linux's i810_audio OSS kernel (for AC97) module might  Note that Linux's i810_audio OSS kernel (for AC97) module might
Line 448  modprobe i810_audio clocking=48000 Line 470  modprobe i810_audio clocking=48000
 @end example  @end example
 ETEXI  ETEXI
   
   DEF("balloon", HAS_ARG, QEMU_OPTION_balloon,
       "-balloon none   disable balloon device\n"
       "-balloon virtio[,addr=str]\n"
       "                enable virtio balloon device (default)\n", QEMU_ARCH_ALL)
   STEXI
   @item -balloon none
   @findex -balloon
   Disable balloon device.
   @item -balloon virtio[,addr=@var{addr}]
   Enable virtio balloon device (default), optionally with PCI address
   @var{addr}.
   ETEXI
   
 STEXI  STEXI
 @end table  @end table
 ETEXI  ETEXI
Line 480  Virtual Mouse. This will override the PS Line 515  Virtual Mouse. This will override the PS
   
 @item tablet  @item tablet
 Pointer device that uses absolute coordinates (like a touchscreen). This  Pointer device that uses absolute coordinates (like a touchscreen). This
 means qemu is able to report the mouse position without having to grab the  means QEMU is able to report the mouse position without having to grab the
 mouse. Also overrides the PS/2 mouse emulation when activated.  mouse. Also overrides the PS/2 mouse emulation when activated.
   
 @item disk:[format=@var{format}]:@var{file}  @item disk:[format=@var{format}]:@var{file}
Line 530  DEFHEADING() Line 565  DEFHEADING()
 DEFHEADING(File system options:)  DEFHEADING(File system options:)
   
 DEF("fsdev", HAS_ARG, QEMU_OPTION_fsdev,  DEF("fsdev", HAS_ARG, QEMU_OPTION_fsdev,
     "-fsdev fsdriver,id=id,path=path,[security_model={mapped|passthrough|none}]\n"      "-fsdev fsdriver,id=id[,path=path,][security_model={mapped-xattr|mapped-file|passthrough|none}]\n"
     "       [,writeout=immediate][,readonly]\n",      " [,writeout=immediate][,readonly][,socket=socket|sock_fd=sock_fd]\n",
     QEMU_ARCH_ALL)      QEMU_ARCH_ALL)
   
 STEXI  STEXI
   
 @item -fsdev @var{fsdriver},id=@var{id},path=@var{path},[security_model=@var{security_model}][,writeout=@var{writeout}][,readonly]  @item -fsdev @var{fsdriver},id=@var{id},path=@var{path},[security_model=@var{security_model}][,writeout=@var{writeout}][,readonly][,socket=@var{socket}|sock_fd=@var{sock_fd}]
 @findex -fsdev  @findex -fsdev
 Define a new file system device. Valid options are:  Define a new file system device. Valid options are:
 @table @option  @table @option
 @item @var{fsdriver}  @item @var{fsdriver}
 This option specifies the fs driver backend to use.  This option specifies the fs driver backend to use.
 Currently "local" and "handle" file system drivers are supported.  Currently "local", "handle" and "proxy" file system drivers are supported.
 @item id=@var{id}  @item id=@var{id}
 Specifies identifier for this device  Specifies identifier for this device
 @item path=@var{path}  @item path=@var{path}
Line 550  Specifies the export path for the file s Line 585  Specifies the export path for the file s
 this path will be available to the 9p client on the guest.  this path will be available to the 9p client on the guest.
 @item security_model=@var{security_model}  @item security_model=@var{security_model}
 Specifies the security model to be used for this export path.  Specifies the security model to be used for this export path.
 Supported security models are "passthrough", "mapped" and "none".  Supported security models are "passthrough", "mapped-xattr", "mapped-file" and "none".
 In "passthrough" security model, files are stored using the same  In "passthrough" security model, files are stored using the same
 credentials as they are created on the guest. This requires qemu  credentials as they are created on the guest. This requires QEMU
 to run as root. In "mapped" security model, some of the file  to run as root. In "mapped-xattr" security model, some of the file
 attributes like uid, gid, mode bits and link target are stored as  attributes like uid, gid, mode bits and link target are stored as
 file attributes. Directories exported by this security model cannot  file attributes. For "mapped-file" these attributes are stored in the
   hidden .virtfs_metadata directory. Directories exported by this security model cannot
 interact with other unix tools. "none" security model is same as  interact with other unix tools. "none" security model is same as
 passthrough except the sever won't report failures if it fails to  passthrough except the sever won't report failures if it fails to
 set file attributes like ownership. Security model is mandatory  set file attributes like ownership. Security model is mandatory
 only for local fsdriver. Other fsdrivers (like handle) don't take  only for local fsdriver. Other fsdrivers (like handle, proxy) don't take
 security model as a parameter.  security model as a parameter.
 @item writeout=@var{writeout}  @item writeout=@var{writeout}
 This is an optional argument. The only supported value is "immediate".  This is an optional argument. The only supported value is "immediate".
Line 569  reported as written by the storage subsy Line 605  reported as written by the storage subsy
 @item readonly  @item readonly
 Enables exporting 9p share as a readonly mount for guests. By default  Enables exporting 9p share as a readonly mount for guests. By default
 read-write access is given.  read-write access is given.
   @item socket=@var{socket}
   Enables proxy filesystem driver to use passed socket file for communicating
   with virtfs-proxy-helper
   @item sock_fd=@var{sock_fd}
   Enables proxy filesystem driver to use passed socket descriptor for
   communicating with virtfs-proxy-helper. Usually a helper like libvirt
   will create socketpair and pass one of the fds as sock_fd
 @end table  @end table
   
 -fsdev option is used along with -device driver "virtio-9p-pci".  -fsdev option is used along with -device driver "virtio-9p-pci".
Line 588  DEFHEADING() Line 631  DEFHEADING()
 DEFHEADING(Virtual File system pass-through options:)  DEFHEADING(Virtual File system pass-through options:)
   
 DEF("virtfs", HAS_ARG, QEMU_OPTION_virtfs,  DEF("virtfs", HAS_ARG, QEMU_OPTION_virtfs,
     "-virtfs local,path=path,mount_tag=tag,security_model=[mapped|passthrough|none]\n"      "-virtfs local,path=path,mount_tag=tag,security_model=[mapped-xattr|mapped-file|passthrough|none]\n"
     "        [,writeout=immediate][,readonly]\n",      "        [,writeout=immediate][,readonly][,socket=socket|sock_fd=sock_fd]\n",
     QEMU_ARCH_ALL)      QEMU_ARCH_ALL)
   
 STEXI  STEXI
   
 @item -virtfs @var{fsdriver},path=@var{path},mount_tag=@var{mount_tag},security_model=@var{security_model}[,writeout=@var{writeout}][,readonly]  @item -virtfs @var{fsdriver}[,path=@var{path}],mount_tag=@var{mount_tag}[,security_model=@var{security_model}][,writeout=@var{writeout}][,readonly][,socket=@var{socket}|sock_fd=@var{sock_fd}]
 @findex -virtfs  @findex -virtfs
   
 The general form of a Virtual File system pass-through options are:  The general form of a Virtual File system pass-through options are:
 @table @option  @table @option
 @item @var{fsdriver}  @item @var{fsdriver}
 This option specifies the fs driver backend to use.  This option specifies the fs driver backend to use.
 Currently "local" and "handle" file system drivers are supported.  Currently "local", "handle" and "proxy" file system drivers are supported.
 @item id=@var{id}  @item id=@var{id}
 Specifies identifier for this device  Specifies identifier for this device
 @item path=@var{path}  @item path=@var{path}
Line 609  Specifies the export path for the file s Line 652  Specifies the export path for the file s
 this path will be available to the 9p client on the guest.  this path will be available to the 9p client on the guest.
 @item security_model=@var{security_model}  @item security_model=@var{security_model}
 Specifies the security model to be used for this export path.  Specifies the security model to be used for this export path.
 Supported security models are "passthrough", "mapped" and "none".  Supported security models are "passthrough", "mapped-xattr", "mapped-file" and "none".
 In "passthrough" security model, files are stored using the same  In "passthrough" security model, files are stored using the same
 credentials as they are created on the guest. This requires qemu  credentials as they are created on the guest. This requires QEMU
 to run as root. In "mapped" security model, some of the file  to run as root. In "mapped-xattr" security model, some of the file
 attributes like uid, gid, mode bits and link target are stored as  attributes like uid, gid, mode bits and link target are stored as
 file attributes. Directories exported by this security model cannot  file attributes. For "mapped-file" these attributes are stored in the
   hidden .virtfs_metadata directory. Directories exported by this security model cannot
 interact with other unix tools. "none" security model is same as  interact with other unix tools. "none" security model is same as
 passthrough except the sever won't report failures if it fails to  passthrough except the sever won't report failures if it fails to
 set file attributes like ownership. Security model is mandatory only  set file attributes like ownership. Security model is mandatory only
 for local fsdriver. Other fsdrivers (like handle) don't take security  for local fsdriver. Other fsdrivers (like handle, proxy) don't take security
 model as a parameter.  model as a parameter.
 @item writeout=@var{writeout}  @item writeout=@var{writeout}
 This is an optional argument. The only supported value is "immediate".  This is an optional argument. The only supported value is "immediate".
Line 628  reported as written by the storage subsy Line 672  reported as written by the storage subsy
 @item readonly  @item readonly
 Enables exporting 9p share as a readonly mount for guests. By default  Enables exporting 9p share as a readonly mount for guests. By default
 read-write access is given.  read-write access is given.
   @item socket=@var{socket}
   Enables proxy filesystem driver to use passed socket file for
   communicating with virtfs-proxy-helper. Usually a helper like libvirt
   will create socketpair and pass one of the fds as sock_fd
   @item sock_fd
   Enables proxy filesystem driver to use passed 'sock_fd' as the socket
   descriptor for interfacing with virtfs-proxy-helper
 @end table  @end table
 ETEXI  ETEXI
   
Line 836  The x509 file names can also be configur Line 887  The x509 file names can also be configur
 @item tls-ciphers=<list>  @item tls-ciphers=<list>
 Specify which ciphers to use.  Specify which ciphers to use.
   
 @item tls-channel=[main|display|inputs|record|playback|tunnel]  @item tls-channel=[main|display|cursor|inputs|record|playback]
 @item plaintext-channel=[main|display|inputs|record|playback|tunnel]  @item plaintext-channel=[main|display|cursor|inputs|record|playback]
 Force specific channel to be used with or without TLS encryption.  The  Force specific channel to be used with or without TLS encryption.  The
 options can be specified multiple times to configure multiple  options can be specified multiple times to configure multiple
 channels.  The special name "default" can be used to set the default  channels.  The special name "default" can be used to set the default
Line 1055  This can be really helpful to save bandw Line 1106  This can be really helpful to save bandw
 adaptive encodings allows to restore the original static behavior of encodings  adaptive encodings allows to restore the original static behavior of encodings
 like Tight.  like Tight.
   
   @item share=[allow-exclusive|force-shared|ignore]
   
   Set display sharing policy.  'allow-exclusive' allows clients to ask
   for exclusive access.  As suggested by the rfb spec this is
   implemented by dropping other connections.  Connecting multiple
   clients in parallel requires all clients asking for a shared session
   (vncviewer: -shared switch).  This is the default.  'force-shared'
   disables exclusive client access.  Useful for shared desktop sessions,
   where you don't want someone forgetting specify -shared disconnect
   everybody else.  'ignore' completely ignores the shared flag and
   allows everybody connect unconditionally.  Doesn't conform to the rfb
   spec but is traditional QEMU behavior.
   
 @end table  @end table
 ETEXI  ETEXI
   
Line 1062  STEXI Line 1126  STEXI
 @end table  @end table
 ETEXI  ETEXI
   
 DEFHEADING()  ARCHHEADING(, QEMU_ARCH_I386)
   
 DEFHEADING(i386 target only:)  ARCHHEADING(i386 target only:, QEMU_ARCH_I386)
 STEXI  STEXI
 @table @option  @table @option
 ETEXI  ETEXI
Line 1112  STEXI Line 1176  STEXI
 Disable HPET support.  Disable HPET support.
 ETEXI  ETEXI
   
 DEF("balloon", HAS_ARG, QEMU_OPTION_balloon,  
     "-balloon none   disable balloon device\n"  
     "-balloon virtio[,addr=str]\n"  
     "                enable virtio balloon device (default)\n", QEMU_ARCH_ALL)  
 STEXI  
 @item -balloon none  
 @findex -balloon  
 Disable balloon device.  
 @item -balloon virtio[,addr=@var{addr}]  
 Enable virtio balloon device (default), optionally with PCI address  
 @var{addr}.  
 ETEXI  
   
 DEF("acpitable", HAS_ARG, QEMU_OPTION_acpitable,  DEF("acpitable", HAS_ARG, QEMU_OPTION_acpitable,
     "-acpitable [sig=str][,rev=n][,oem_id=str][,oem_table_id=str][,oem_rev=n][,asl_compiler_id=str][,asl_compiler_rev=n][,{data|file}=file1[:file2]...]\n"      "-acpitable [sig=str][,rev=n][,oem_id=str][,oem_table_id=str][,oem_rev=n][,asl_compiler_id=str][,asl_compiler_rev=n][,{data|file}=file1[:file2]...]\n"
     "                ACPI table description\n", QEMU_ARCH_I386)      "                ACPI table description\n", QEMU_ARCH_I386)
Line 1197  DEF("net", HAS_ARG, QEMU_OPTION_net, Line 1248  DEF("net", HAS_ARG, QEMU_OPTION_net,
     "-net tap[,vlan=n][,name=str],ifname=name\n"      "-net tap[,vlan=n][,name=str],ifname=name\n"
     "                connect the host TAP network interface to VLAN 'n'\n"      "                connect the host TAP network interface to VLAN 'n'\n"
 #else  #else
     "-net tap[,vlan=n][,name=str][,fd=h][,ifname=name][,script=file][,downscript=dfile][,sndbuf=nbytes][,vnet_hdr=on|off][,vhost=on|off][,vhostfd=h][,vhostforce=on|off]\n"      "-net tap[,vlan=n][,name=str][,fd=h][,ifname=name][,script=file][,downscript=dfile][,helper=helper][,sndbuf=nbytes][,vnet_hdr=on|off][,vhost=on|off][,vhostfd=h][,vhostforce=on|off]\n"
     "                connect the host TAP network interface to VLAN 'n' and use the\n"      "                connect the host TAP network interface to VLAN 'n' \n"
     "                network scripts 'file' (default=" DEFAULT_NETWORK_SCRIPT ")\n"      "                use network scripts 'file' (default=" DEFAULT_NETWORK_SCRIPT ")\n"
     "                and 'dfile' (default=" DEFAULT_NETWORK_DOWN_SCRIPT ")\n"      "                to configure it and 'dfile' (default=" DEFAULT_NETWORK_DOWN_SCRIPT ")\n"
       "                to deconfigure it\n"
     "                use '[down]script=no' to disable script execution\n"      "                use '[down]script=no' to disable script execution\n"
       "                use network helper 'helper' (default=" DEFAULT_BRIDGE_HELPER ") to\n"
       "                configure it\n"
     "                use 'fd=h' to connect to an already opened TAP interface\n"      "                use 'fd=h' to connect to an already opened TAP interface\n"
     "                use 'sndbuf=nbytes' to limit the size of the send buffer (the\n"      "                use 'sndbuf=nbytes' to limit the size of the send buffer (the\n"
     "                default is disabled 'sndbuf=0' to enable flow control set 'sndbuf=1048576')\n"      "                default is disabled 'sndbuf=0' to enable flow control set 'sndbuf=1048576')\n"
Line 1211  DEF("net", HAS_ARG, QEMU_OPTION_net, Line 1265  DEF("net", HAS_ARG, QEMU_OPTION_net,
     "                    (only has effect for virtio guests which use MSIX)\n"      "                    (only has effect for virtio guests which use MSIX)\n"
     "                use vhostforce=on to force vhost on for non-MSIX virtio guests\n"      "                use vhostforce=on to force vhost on for non-MSIX virtio guests\n"
     "                use 'vhostfd=h' to connect to an already opened vhost net device\n"      "                use 'vhostfd=h' to connect to an already opened vhost net device\n"
       "-net bridge[,vlan=n][,name=str][,br=bridge][,helper=helper]\n"
       "                connects a host TAP network interface to a host bridge device 'br'\n"
       "                (default=" DEFAULT_BRIDGE_INTERFACE ") using the program 'helper'\n"
       "                (default=" DEFAULT_BRIDGE_HELPER ")\n"
 #endif  #endif
     "-net socket[,vlan=n][,name=str][,fd=h][,listen=[host]:port][,connect=host:port]\n"      "-net socket[,vlan=n][,name=str][,fd=h][,listen=[host]:port][,connect=host:port]\n"
     "                connect the vlan 'n' to another VLAN using a socket connection\n"      "                connect the vlan 'n' to another VLAN using a socket connection\n"
     "-net socket[,vlan=n][,name=str][,fd=h][,mcast=maddr:port[,localaddr=addr]]\n"      "-net socket[,vlan=n][,name=str][,fd=h][,mcast=maddr:port[,localaddr=addr]]\n"
     "                connect the vlan 'n' to multicast maddr and port\n"      "                connect the vlan 'n' to multicast maddr and port\n"
     "                use 'localaddr=addr' to specify the host address to send packets from\n"      "                use 'localaddr=addr' to specify the host address to send packets from\n"
       "-net socket[,vlan=n][,name=str][,fd=h][,udp=host:port][,localaddr=host:port]\n"
       "                connect the vlan 'n' to another VLAN using an UDP tunnel\n"
 #ifdef CONFIG_VDE  #ifdef CONFIG_VDE
     "-net vde[,vlan=n][,name=str][,sock=socketpath][,port=n][,group=groupname][,mode=octalmode]\n"      "-net vde[,vlan=n][,name=str][,sock=socketpath][,port=n][,group=groupname][,mode=octalmode]\n"
     "                connect the vlan 'n' to port 'n' of a vde switch running\n"      "                connect the vlan 'n' to port 'n' of a vde switch running\n"
Line 1234  DEF("netdev", HAS_ARG, QEMU_OPTION_netde Line 1294  DEF("netdev", HAS_ARG, QEMU_OPTION_netde
     "user|"      "user|"
 #endif  #endif
     "tap|"      "tap|"
       "bridge|"
 #ifdef CONFIG_VDE  #ifdef CONFIG_VDE
     "vde|"      "vde|"
 #endif  #endif
Line 1249  and a @var{name} can be assigned for use Line 1310  and a @var{name} can be assigned for use
 Optionally, for PCI cards, you can specify the number @var{v} of MSI-X vectors  Optionally, for PCI cards, you can specify the number @var{v} of MSI-X vectors
 that the card should have; this option currently only affects virtio cards; set  that the card should have; this option currently only affects virtio cards; set
 @var{v} = 0 to disable MSI-X. If no @option{-net} option is specified, a single  @var{v} = 0 to disable MSI-X. If no @option{-net} option is specified, a single
 NIC is created.  Qemu can emulate several different models of network card.  NIC is created.  QEMU can emulate several different models of network card.
 Valid values for @var{type} are  Valid values for @var{type} are
 @code{virtio}, @code{i82551}, @code{i82557b}, @code{i82559er},  @code{virtio}, @code{i82551}, @code{i82557b}, @code{i82559er},
 @code{ne2k_pci}, @code{ne2k_isa}, @code{pcnet}, @code{rtl8139},  @code{ne2k_pci}, @code{ne2k_isa}, @code{pcnet}, @code{rtl8139},
Line 1307  a guest from a local directory. Line 1368  a guest from a local directory.
   
 Example (using pxelinux):  Example (using pxelinux):
 @example  @example
 qemu -hda linux.img -boot n -net user,tftp=/path/to/tftp/files,bootfile=/pxelinux.0  qemu-system-i386 -hda linux.img -boot n -net user,tftp=/path/to/tftp/files,bootfile=/pxelinux.0
 @end example  @end example
   
 @item smb=@var{dir}[,smbserver=@var{addr}]  @item smb=@var{dir}[,smbserver=@var{addr}]
Line 1342  screen 0, use the following: Line 1403  screen 0, use the following:
   
 @example  @example
 # on the host  # on the host
 qemu -net user,hostfwd=tcp:127.0.0.1:6001-:6000 [...]  qemu-system-i386 -net user,hostfwd=tcp:127.0.0.1:6001-:6000 [...]
 # this host xterm should open in the guest X11 server  # this host xterm should open in the guest X11 server
 xterm -display :1  xterm -display :1
 @end example  @end example
Line 1352  the guest, use the following: Line 1413  the guest, use the following:
   
 @example  @example
 # on the host  # on the host
 qemu -net user,hostfwd=tcp::5555-:23 [...]  qemu-system-i386 -net user,hostfwd=tcp::5555-:23 [...]
 telnet localhost 5555  telnet localhost 5555
 @end example  @end example
   
Line 1370  processed and applied to -net user. Mixi Line 1431  processed and applied to -net user. Mixi
 syntax gives undefined results. Their use for new applications is discouraged  syntax gives undefined results. Their use for new applications is discouraged
 as they will be removed from future versions.  as they will be removed from future versions.
   
 @item -net tap[,vlan=@var{n}][,name=@var{name}][,fd=@var{h}][,ifname=@var{name}] [,script=@var{file}][,downscript=@var{dfile}]  @item -net tap[,vlan=@var{n}][,name=@var{name}][,fd=@var{h}][,ifname=@var{name}][,script=@var{file}][,downscript=@var{dfile}][,helper=@var{helper}]
 Connect the host TAP network interface @var{name} to VLAN @var{n}, use  Connect the host TAP network interface @var{name} to VLAN @var{n}.
 the network script @var{file} to configure it and the network script  
   Use the network script @var{file} to configure it and the network script
 @var{dfile} to deconfigure it. If @var{name} is not provided, the OS  @var{dfile} to deconfigure it. If @var{name} is not provided, the OS
 automatically provides one. @option{fd}=@var{h} can be used to specify  automatically provides one. The default network configure script is
 the handle of an already opened host TAP interface. The default network  @file{/etc/qemu-ifup} and the default network deconfigure script is
 configure script is @file{/etc/qemu-ifup} and the default network  @file{/etc/qemu-ifdown}. Use @option{script=no} or @option{downscript=no}
 deconfigure script is @file{/etc/qemu-ifdown}. Use @option{script=no}  to disable script execution.
 or @option{downscript=no} to disable script execution. Example:  
   If running QEMU as an unprivileged user, use the network helper
   @var{helper} to configure the TAP interface. The default network
   helper executable is @file{/usr/local/libexec/qemu-bridge-helper}.
   
   @option{fd}=@var{h} can be used to specify the handle of an already
   opened host TAP interface.
   
   Examples:
   
   @example
   #launch a QEMU instance with the default network script
   qemu-system-i386 linux.img -net nic -net tap
   @end example
   
   @example
   #launch a QEMU instance with two NICs, each one connected
   #to a TAP device
   qemu-system-i386 linux.img \
                    -net nic,vlan=0 -net tap,vlan=0,ifname=tap0 \
                    -net nic,vlan=1 -net tap,vlan=1,ifname=tap1
   @end example
   
   @example
   #launch a QEMU instance with the default network helper to
   #connect a TAP device to bridge br0
   qemu-system-i386 linux.img \
                    -net nic -net tap,"helper=/usr/local/libexec/qemu-bridge-helper"
   @end example
   
   @item -net bridge[,vlan=@var{n}][,name=@var{name}][,br=@var{bridge}][,helper=@var{helper}]
   Connect a host TAP network interface to a host bridge device.
   
   Use the network helper @var{helper} to configure the TAP interface and
   attach it to the bridge. The default network helper executable is
   @file{/usr/local/libexec/qemu-bridge-helper} and the default bridge
   device is @file{br0}.
   
   Examples:
   
 @example  @example
 qemu linux.img -net nic -net tap  #launch a QEMU instance with the default network helper to
   #connect a TAP device to bridge br0
   qemu-system-i386 linux.img -net bridge -net nic,model=virtio
 @end example  @end example
   
 More complicated example (two NICs, each one connected to a TAP device)  
 @example  @example
 qemu linux.img -net nic,vlan=0 -net tap,vlan=0,ifname=tap0 \  #launch a QEMU instance with the default network helper to
                -net nic,vlan=1 -net tap,vlan=1,ifname=tap1  #connect a TAP device to bridge qemubr0
   qemu-system-i386 linux.img -net bridge,br=qemubr0 -net nic,model=virtio
 @end example  @end example
   
 @item -net socket[,vlan=@var{n}][,name=@var{name}][,fd=@var{h}] [,listen=[@var{host}]:@var{port}][,connect=@var{host}:@var{port}]  @item -net socket[,vlan=@var{n}][,name=@var{name}][,fd=@var{h}] [,listen=[@var{host}]:@var{port}][,connect=@var{host}:@var{port}]
Line 1402  specifies an already opened TCP socket. Line 1504  specifies an already opened TCP socket.
 Example:  Example:
 @example  @example
 # launch a first QEMU instance  # launch a first QEMU instance
 qemu linux.img -net nic,macaddr=52:54:00:12:34:56 \  qemu-system-i386 linux.img \
                -net socket,listen=:1234                   -net nic,macaddr=52:54:00:12:34:56 \
                    -net socket,listen=:1234
 # connect the VLAN 0 of this instance to the VLAN 0  # connect the VLAN 0 of this instance to the VLAN 0
 # of the first instance  # of the first instance
 qemu linux.img -net nic,macaddr=52:54:00:12:34:57 \  qemu-system-i386 linux.img \
                -net socket,connect=127.0.0.1:1234                   -net nic,macaddr=52:54:00:12:34:57 \
                    -net socket,connect=127.0.0.1:1234
 @end example  @end example
   
 @item -net socket[,vlan=@var{n}][,name=@var{name}][,fd=@var{h}][,mcast=@var{maddr}:@var{port}[,localaddr=@var{addr}]]  @item -net socket[,vlan=@var{n}][,name=@var{name}][,fd=@var{h}][,mcast=@var{maddr}:@var{port}[,localaddr=@var{addr}]]
Line 1430  Use @option{fd=h} to specify an already  Line 1534  Use @option{fd=h} to specify an already 
 Example:  Example:
 @example  @example
 # launch one QEMU instance  # launch one QEMU instance
 qemu linux.img -net nic,macaddr=52:54:00:12:34:56 \  qemu-system-i386 linux.img \
                -net socket,mcast=230.0.0.1:1234                   -net nic,macaddr=52:54:00:12:34:56 \
                    -net socket,mcast=230.0.0.1:1234
 # launch another QEMU instance on same "bus"  # launch another QEMU instance on same "bus"
 qemu linux.img -net nic,macaddr=52:54:00:12:34:57 \  qemu-system-i386 linux.img \
                -net socket,mcast=230.0.0.1:1234                   -net nic,macaddr=52:54:00:12:34:57 \
                    -net socket,mcast=230.0.0.1:1234
 # launch yet another QEMU instance on same "bus"  # launch yet another QEMU instance on same "bus"
 qemu linux.img -net nic,macaddr=52:54:00:12:34:58 \  qemu-system-i386 linux.img \
                -net socket,mcast=230.0.0.1:1234                   -net nic,macaddr=52:54:00:12:34:58 \
                    -net socket,mcast=230.0.0.1:1234
 @end example  @end example
   
 Example (User Mode Linux compat.):  Example (User Mode Linux compat.):
 @example  @example
 # launch QEMU instance (note mcast address selected  # launch QEMU instance (note mcast address selected
 # is UML's default)  # is UML's default)
 qemu linux.img -net nic,macaddr=52:54:00:12:34:56 \  qemu-system-i386 linux.img \
                -net socket,mcast=239.192.168.1:1102                   -net nic,macaddr=52:54:00:12:34:56 \
                    -net socket,mcast=239.192.168.1:1102
 # launch UML  # launch UML
 /path/to/linux ubd0=/path/to/root_fs eth0=mcast  /path/to/linux ubd0=/path/to/root_fs eth0=mcast
 @end example  @end example
   
 Example (send packets from host's 1.2.3.4):  Example (send packets from host's 1.2.3.4):
 @example  @example
 qemu linux.img -net nic,macaddr=52:54:00:12:34:56 \  qemu-system-i386 linux.img \
                -net socket,mcast=239.192.168.1:1102,localaddr=1.2.3.4                   -net nic,macaddr=52:54:00:12:34:56 \
                    -net socket,mcast=239.192.168.1:1102,localaddr=1.2.3.4
 @end example  @end example
   
 @item -net vde[,vlan=@var{n}][,name=@var{name}][,sock=@var{socketpath}] [,port=@var{n}][,group=@var{groupname}][,mode=@var{octalmode}]  @item -net vde[,vlan=@var{n}][,name=@var{name}][,sock=@var{socketpath}] [,port=@var{n}][,group=@var{groupname}][,mode=@var{octalmode}]
Line 1468  Example: Line 1577  Example:
 # launch vde switch  # launch vde switch
 vde_switch -F -sock /tmp/myswitch  vde_switch -F -sock /tmp/myswitch
 # launch QEMU instance  # launch QEMU instance
 qemu linux.img -net nic -net vde,sock=/tmp/myswitch  qemu-system-i386 linux.img -net nic -net vde,sock=/tmp/myswitch
 @end example  @end example
   
 @item -net dump[,vlan=@var{n}][,file=@var{file}][,len=@var{len}]  @item -net dump[,vlan=@var{n}][,file=@var{file}][,len=@var{len}]
Line 1691  not take any options. Line 1800  not take any options.
 @option{pty} is not available on Windows hosts.  @option{pty} is not available on Windows hosts.
   
 @item -chardev stdio ,id=@var{id} [,signal=on|off]  @item -chardev stdio ,id=@var{id} [,signal=on|off]
 Connect to standard input and standard output of the qemu process.  Connect to standard input and standard output of the QEMU process.
   
 @option{signal} controls if signals are enabled on the terminal, that includes  @option{signal} controls if signals are enabled on the terminal, that includes
 exiting QEMU with the key sequence @key{Control-c}. This option is enabled by  exiting QEMU with the key sequence @key{Control-c}. This option is enabled by
Line 1753  Syntax for specifying iSCSI LUNs is Line 1862  Syntax for specifying iSCSI LUNs is
   
 Example (without authentication):  Example (without authentication):
 @example  @example
 qemu -cdrom iscsi://192.0.2.1/iqn.2001-04.com.example/2 \  qemu-system-i386 -iscsi initiator-name=iqn.2001-04.com.example:my-initiator \
 --drive file=iscsi://192.0.2.1/iqn.2001-04.com.example/1                   -cdrom iscsi://192.0.2.1/iqn.2001-04.com.example/2 \
                    -drive file=iscsi://192.0.2.1/iqn.2001-04.com.example/1
 @end example  @end example
   
 Example (CHAP username/password via URL):  Example (CHAP username/password via URL):
 @example  @example
 qemu --drive file=iscsi://user%password@@192.0.2.1/iqn.2001-04.com.example/1  qemu-system-i386 -drive file=iscsi://user%password@@192.0.2.1/iqn.2001-04.com.example/1
 @end example  @end example
   
 Example (CHAP username/password via environment variables):  Example (CHAP username/password via environment variables):
 @example  @example
 LIBISCSI_CHAP_USERNAME="user" \  LIBISCSI_CHAP_USERNAME="user" \
 LIBISCSI_CHAP_PASSWORD="password" \  LIBISCSI_CHAP_PASSWORD="password" \
 qemu --drive file=iscsi://192.0.2.1/iqn.2001-04.com.example/1  qemu-system-i386 -drive file=iscsi://192.0.2.1/iqn.2001-04.com.example/1
 @end example  @end example
   
 iSCSI support is an optional feature of QEMU and only available when  iSCSI support is an optional feature of QEMU and only available when
 compiled and linked against libiscsi.  compiled and linked against libiscsi.
   ETEXI
   DEF("iscsi", HAS_ARG, QEMU_OPTION_iscsi,
       "-iscsi [user=user][,password=password]\n"
       "       [,header-digest=CRC32C|CR32C-NONE|NONE-CRC32C|NONE\n"
       "       [,initiator-name=iqn]\n"
       "                iSCSI session parameters\n", QEMU_ARCH_ALL)
   STEXI
   
 @item NBD  @item NBD
 QEMU supports NBD (Network Block Devices) both using TCP protocol as well  QEMU supports NBD (Network Block Devices) both using TCP protocol as well
Line 1785  Syntax for specifying a NBD device using Line 1902  Syntax for specifying a NBD device using
   
 Example for TCP  Example for TCP
 @example  @example
 qemu --drive file=nbd:192.0.2.1:30000  qemu-system-i386 --drive file=nbd:192.0.2.1:30000
 @end example  @end example
   
 Example for Unix Domain Sockets  Example for Unix Domain Sockets
 @example  @example
 qemu --drive file=nbd:unix:/tmp/nbd-socket  qemu-system-i386 --drive file=nbd:unix:/tmp/nbd-socket
 @end example  @end example
   
 @item Sheepdog  @item Sheepdog
Line 1815  Syntax for specifying a sheepdog device Line 1932  Syntax for specifying a sheepdog device
   
 Example  Example
 @example  @example
 qemu --drive file=sheepdog:192.0.2.1:30000:MyVirtualMachine  qemu-system-i386 --drive file=sheepdog:192.0.2.1:30000:MyVirtualMachine
 @end example  @end example
   
 See also @url{http://http://www.osrg.net/sheepdog/}.  See also @url{http://http://www.osrg.net/sheepdog/}.
Line 1878  and communicate.  Requires the Linux @co Line 1995  and communicate.  Requires the Linux @co
 be used as following:  be used as following:
   
 @example  @example
 qemu [...OPTIONS...] -bt hci,vlan=5 -bt vhci,vlan=5  qemu-system-i386 [...OPTIONS...] -bt hci,vlan=5 -bt vhci,vlan=5
 @end example  @end example
   
 @item -bt device:@var{dev}[,vlan=@var{n}]  @item -bt device:@var{dev}[,vlan=@var{n}]
Line 1937  Use @var{file1} and @var{file2} as modul Line 2054  Use @var{file1} and @var{file2} as modul
 first module.  first module.
 ETEXI  ETEXI
   
   DEF("dtb", HAS_ARG, QEMU_OPTION_dtb, \
       "-dtb    file    use 'file' as device tree image\n", QEMU_ARCH_ALL)
   STEXI
   @item -dtb @var{file}
   @findex -dtb
   Use @var{file} as a device tree binary (dtb) image and pass it to the kernel
   on boot.
   ETEXI
   
 STEXI  STEXI
 @end table  @end table
 ETEXI  ETEXI
Line 2002  they default to @code{0.0.0.0}. Line 2128  they default to @code{0.0.0.0}.
 When not using a specified @var{src_port} a random port is automatically chosen.  When not using a specified @var{src_port} a random port is automatically chosen.
   
 If you just want a simple readonly console you can use @code{netcat} or  If you just want a simple readonly console you can use @code{netcat} or
 @code{nc}, by starting qemu with: @code{-serial udp::4555} and nc as:  @code{nc}, by starting QEMU with: @code{-serial udp::4555} and nc as:
 @code{nc -u -l -p 4555}. Any time qemu writes something to that port it  @code{nc -u -l -p 4555}. Any time QEMU writes something to that port it
 will appear in the netconsole session.  will appear in the netconsole session.
   
 If you plan to send characters back via netconsole or you want to stop  If you plan to send characters back via netconsole or you want to stop
 and start qemu a lot of times, you should have qemu use the same  and start QEMU a lot of times, you should have QEMU use the same
 source port each time by using something like @code{-serial  source port each time by using something like @code{-serial
 udp::4555@@:4556} to qemu. Another approach is to use a patched  udp::4555@@:4556} to QEMU. Another approach is to use a patched
 version of netcat which can listen to a TCP port and send and receive  version of netcat which can listen to a TCP port and send and receive
 characters via udp.  If you have a patched version of netcat which  characters via udp.  If you have a patched version of netcat which
 activates telnet remote echo and single char transfer, then you can  activates telnet remote echo and single char transfer, then you can
 use the following options to step up a netcat redirector to allow  use the following options to step up a netcat redirector to allow
 telnet on port 5555 to access the qemu port.  telnet on port 5555 to access the QEMU port.
 @table @code  @table @code
 @item Qemu Options:  @item QEMU Options:
 -serial udp::4555@@:4556  -serial udp::4555@@:4556
 @item netcat options:  @item netcat options:
 -u -P 4555 -L 0.0.0.0:4556 -t -p 5555 -I -T  -u -P 4555 -L 0.0.0.0:4556 -t -p 5555 -I -T
Line 2169  STEXI Line 2295  STEXI
 @findex -gdb  @findex -gdb
 Wait for gdb connection on device @var{dev} (@pxref{gdb_usage}). Typical  Wait for gdb connection on device @var{dev} (@pxref{gdb_usage}). Typical
 connections will likely be TCP-based, but also UDP, pseudo TTY, or even  connections will likely be TCP-based, but also UDP, pseudo TTY, or even
 stdio are reasonable use case. The latter is allowing to start qemu from  stdio are reasonable use case. The latter is allowing to start QEMU from
 within gdb and establish the connection via a pipe:  within gdb and establish the connection via a pipe:
 @example  @example
 (gdb) target remote | exec qemu -gdb stdio ...  (gdb) target remote | exec qemu-system-i386 -gdb stdio ...
 @end example  @end example
 ETEXI  ETEXI
   
Line 2199  DEF("D", HAS_ARG, QEMU_OPTION_D, \ Line 2325  DEF("D", HAS_ARG, QEMU_OPTION_D, \
     "-D logfile      output log to logfile (instead of the default /tmp/qemu.log)\n",      "-D logfile      output log to logfile (instead of the default /tmp/qemu.log)\n",
     QEMU_ARCH_ALL)      QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -D  @item -D @var{logfile}
 @findex -D  @findex -D
 Output log in logfile instead of /tmp/qemu.log  Output log in @var{logfile} instead of /tmp/qemu.log
 ETEXI  ETEXI
   
 DEF("hdachs", HAS_ARG, QEMU_OPTION_hdachs, \  DEF("hdachs", HAS_ARG, QEMU_OPTION_hdachs, \
     "-hdachs c,h,s[,t]\n" \      "-hdachs c,h,s[,t]\n" \
     "                force hard disk 0 physical geometry and the optional BIOS\n" \      "                force hard disk 0 physical geometry and the optional BIOS\n" \
     "                translation (t=none or lba) (usually qemu can guess them)\n",      "                translation (t=none or lba) (usually QEMU can guess them)\n",
     QEMU_ARCH_ALL)      QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -hdachs @var{c},@var{h},@var{s},[,@var{t}]  @item -hdachs @var{c},@var{h},@var{s},[,@var{t}]
Line 2253  DEF("xen-create", 0, QEMU_OPTION_xen_cre Line 2379  DEF("xen-create", 0, QEMU_OPTION_xen_cre
     QEMU_ARCH_ALL)      QEMU_ARCH_ALL)
 DEF("xen-attach", 0, QEMU_OPTION_xen_attach,  DEF("xen-attach", 0, QEMU_OPTION_xen_attach,
     "-xen-attach     attach to existing xen domain\n"      "-xen-attach     attach to existing xen domain\n"
     "                xend will use this when starting qemu\n",      "                xend will use this when starting QEMU\n",
     QEMU_ARCH_ALL)      QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -xen-domid @var{id}  @item -xen-domid @var{id}
Line 2266  Warning: should not be used when xend is Line 2392  Warning: should not be used when xend is
 @item -xen-attach  @item -xen-attach
 @findex -xen-attach  @findex -xen-attach
 Attach to existing xen domain.  Attach to existing xen domain.
 xend will use this when starting qemu (XEN only).  xend will use this when starting QEMU (XEN only).
 ETEXI  ETEXI
   
 DEF("no-reboot", 0, QEMU_OPTION_no_reboot, \  DEF("no-reboot", 0, QEMU_OPTION_no_reboot, \
Line 2336  DEF("localtime", 0, QEMU_OPTION_localtim Line 2462  DEF("localtime", 0, QEMU_OPTION_localtim
 DEF("startdate", HAS_ARG, QEMU_OPTION_startdate, "", QEMU_ARCH_ALL)  DEF("startdate", HAS_ARG, QEMU_OPTION_startdate, "", QEMU_ARCH_ALL)
   
 DEF("rtc", HAS_ARG, QEMU_OPTION_rtc, \  DEF("rtc", HAS_ARG, QEMU_OPTION_rtc, \
     "-rtc [base=utc|localtime|date][,clock=host|vm][,driftfix=none|slew]\n" \      "-rtc [base=utc|localtime|date][,clock=host|rt|vm][,driftfix=none|slew]\n" \
     "                set the RTC base and clock, enable drift fix for clock ticks (x86 only)\n",      "                set the RTC base and clock, enable drift fix for clock ticks (x86 only)\n",
     QEMU_ARCH_ALL)      QEMU_ARCH_ALL)
   
Line 2352  format @code{2006-06-17T16:01:21} or @co Line 2478  format @code{2006-06-17T16:01:21} or @co
 By default the RTC is driven by the host system time. This allows to use the  By default the RTC is driven by the host system time. This allows to use the
 RTC as accurate reference clock inside the guest, specifically if the host  RTC as accurate reference clock inside the guest, specifically if the host
 time is smoothly following an accurate external reference clock, e.g. via NTP.  time is smoothly following an accurate external reference clock, e.g. via NTP.
 If you want to isolate the guest time from the host, even prevent it from  If you want to isolate the guest time from the host, you can set @option{clock}
 progressing during suspension, you can set @option{clock} to @code{vm} instead.  to @code{rt} instead.  To even prevent it from progressing during suspension,
   you can set it to @code{vm}.
   
 Enable @option{driftfix} (i386 targets only) if you experience time drift problems,  Enable @option{driftfix} (i386 targets only) if you experience time drift problems,
 specifically with Windows' ACPI HAL. This option will try to figure out how  specifically with Windows' ACPI HAL. This option will try to figure out how
Line 2567  DEF("nodefconfig", 0, QEMU_OPTION_nodefc Line 2694  DEF("nodefconfig", 0, QEMU_OPTION_nodefc
 STEXI  STEXI
 @item -nodefconfig  @item -nodefconfig
 @findex -nodefconfig  @findex -nodefconfig
 Normally QEMU loads a configuration file from @var{sysconfdir}/qemu.conf and  Normally QEMU loads configuration files from @var{sysconfdir} and @var{datadir} at startup.
 @var{sysconfdir}/target-@var{ARCH}.conf on startup.  The @code{-nodefconfig}  The @code{-nodefconfig} option will prevent QEMU from loading any of those config files.
 option will prevent QEMU from loading these configuration files at startup.  ETEXI
   DEF("no-user-config", 0, QEMU_OPTION_nouserconfig,
       "-no-user-config\n"
       "                do not load user-provided config files at startup\n",
       QEMU_ARCH_ALL)
   STEXI
   @item -no-user-config
   @findex -no-user-config
   The @code{-no-user-config} option makes QEMU not load any of the user-provided
   config files on @var{sysconfdir}, but won't make it skip the QEMU-provided config
   files from @var{datadir}.
 ETEXI  ETEXI
 DEF("trace", HAS_ARG, QEMU_OPTION_trace,  DEF("trace", HAS_ARG, QEMU_OPTION_trace,
     "-trace [events=<file>][,file=<file>]\n"      "-trace [events=<file>][,file=<file>]\n"
Line 2598  the @var{simple} tracing backend. Line 2735  the @var{simple} tracing backend.
 @end table  @end table
 ETEXI  ETEXI
   
   DEF("qtest", HAS_ARG, QEMU_OPTION_qtest,
       "-qtest CHR      specify tracing options\n",
       QEMU_ARCH_ALL)
   
   DEF("qtest-log", HAS_ARG, QEMU_OPTION_qtest_log,
       "-qtest-log LOG  specify tracing options\n",
       QEMU_ARCH_ALL)
   
 HXCOMM This is the last statement. Insert new options before this line!  HXCOMM This is the last statement. Insert new options before this line!
 STEXI  STEXI
 @end table  @end table

Removed from v.1.1.1.10  
changed lines
  Added in v.1.1.1.11


unix.superglobalmegacorp.com