Diff for /qemu/qemu-options.hx between versions 1.1.1.6 and 1.1.1.7

version 1.1.1.6, 2018/04/24 18:16:49 version 1.1.1.7, 2018/04/24 18:24:20
Line 1 Line 1
 HXCOMM Use DEFHEADING() to define headings in both help text and texi  HXCOMM Use DEFHEADING() to define headings in both help text and texi
 HXCOMM Text between STEXI and ETEXI are copied to texi version and  HXCOMM Text between STEXI and ETEXI are copied to texi version and
 HXCOMM discarded from C version  HXCOMM discarded from C version
 HXCOMM DEF(option, HAS_ARG/0, opt_enum, opt_help) is used to construct  HXCOMM DEF(option, HAS_ARG/0, opt_enum, opt_help, arch_mask) is used to
 HXCOMM option structures, enums and help message.  HXCOMM construct option structures, enums and help message for specified
   HXCOMM architectures.
 HXCOMM HXCOMM can be used for comments, discarded from both texi and C  HXCOMM HXCOMM can be used for comments, discarded from both texi and C
   
 DEFHEADING(Standard options:)  DEFHEADING(Standard options:)
Line 11  STEXI Line 12  STEXI
 ETEXI  ETEXI
   
 DEF("help", 0, QEMU_OPTION_h,  DEF("help", 0, QEMU_OPTION_h,
     "-h or -help     display this help and exit\n")      "-h or -help     display this help and exit\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -h  @item -h
   @findex -h
 Display help and exit  Display help and exit
 ETEXI  ETEXI
   
 DEF("version", 0, QEMU_OPTION_version,  DEF("version", 0, QEMU_OPTION_version,
     "-version        display version information and exit\n")      "-version        display version information and exit\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -version  @item -version
   @findex -version
 Display version information and exit  Display version information and exit
 ETEXI  ETEXI
   
 DEF("M", HAS_ARG, QEMU_OPTION_M,  DEF("M", HAS_ARG, QEMU_OPTION_M,
     "-M machine      select emulated machine (-M ? for list)\n")      "-M machine      select emulated machine (-M ? for list)\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -M @var{machine}  @item -M @var{machine}
   @findex -M
 Select the emulated @var{machine} (@code{-M ?} for list)  Select the emulated @var{machine} (@code{-M ?} for list)
 ETEXI  ETEXI
   
 DEF("cpu", HAS_ARG, QEMU_OPTION_cpu,  DEF("cpu", HAS_ARG, QEMU_OPTION_cpu,
     "-cpu cpu        select CPU (-cpu ? for list)\n")      "-cpu cpu        select CPU (-cpu ? for list)\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -cpu @var{model}  @item -cpu @var{model}
   @findex -cpu
 Select CPU model (-cpu ? for list and additional feature selection)  Select CPU model (-cpu ? for list and additional feature selection)
 ETEXI  ETEXI
   
Line 42  DEF("smp", HAS_ARG, QEMU_OPTION_smp, Line 47  DEF("smp", HAS_ARG, QEMU_OPTION_smp,
     "-smp n[,maxcpus=cpus][,cores=cores][,threads=threads][,sockets=sockets]\n"      "-smp n[,maxcpus=cpus][,cores=cores][,threads=threads][,sockets=sockets]\n"
     "                set the number of CPUs to 'n' [default=1]\n"      "                set the number of CPUs to 'n' [default=1]\n"
     "                maxcpus= maximum number of total cpus, including\n"      "                maxcpus= maximum number of total cpus, including\n"
     "                  offline CPUs for hotplug etc.\n"      "                offline CPUs for hotplug, etc\n"
     "                cores= number of CPU cores on one socket\n"      "                cores= number of CPU cores on one socket\n"
     "                threads= number of threads on one CPU core\n"      "                threads= number of threads on one CPU core\n"
     "                sockets= number of discrete sockets in the system\n")      "                sockets= number of discrete sockets in the system\n",
           QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -smp @var{n}[,cores=@var{cores}][,threads=@var{threads}][,sockets=@var{sockets}][,maxcpus=@var{maxcpus}]  @item -smp @var{n}[,cores=@var{cores}][,threads=@var{threads}][,sockets=@var{sockets}][,maxcpus=@var{maxcpus}]
   @findex -smp
 Simulate an SMP system with @var{n} CPUs. On the PC target, up to 255  Simulate an SMP system with @var{n} CPUs. On the PC target, up to 255
 CPUs are supported. On Sparc32 target, Linux limits the number of usable CPUs  CPUs are supported. On Sparc32 target, Linux limits the number of usable CPUs
 to 4.  to 4.
Line 59  specifies the maximum number of hotplugg Line 66  specifies the maximum number of hotplugg
 ETEXI  ETEXI
   
 DEF("numa", HAS_ARG, QEMU_OPTION_numa,  DEF("numa", HAS_ARG, QEMU_OPTION_numa,
     "-numa node[,mem=size][,cpus=cpu[-cpu]][,nodeid=node]\n")      "-numa node[,mem=size][,cpus=cpu[-cpu]][,nodeid=node]\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -numa @var{opts}  @item -numa @var{opts}
   @findex -numa
 Simulate a multi node NUMA system. If mem and cpus are omitted, resources  Simulate a multi node NUMA system. If mem and cpus are omitted, resources
 are split equally.  are split equally.
 ETEXI  ETEXI
   
 DEF("fda", HAS_ARG, QEMU_OPTION_fda,  DEF("fda", HAS_ARG, QEMU_OPTION_fda,
     "-fda/-fdb file  use 'file' as floppy disk 0/1 image\n")      "-fda/-fdb file  use 'file' as floppy disk 0/1 image\n", QEMU_ARCH_ALL)
 DEF("fdb", HAS_ARG, QEMU_OPTION_fdb, "")  DEF("fdb", HAS_ARG, QEMU_OPTION_fdb, "", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -fda @var{file}  @item -fda @var{file}
 @item -fdb @var{file}  @item -fdb @var{file}
   @findex -fda
   @findex -fdb
 Use @var{file} as floppy disk 0/1 image (@pxref{disk_images}). You can  Use @var{file} as floppy disk 0/1 image (@pxref{disk_images}). You can
 use the host floppy by using @file{/dev/fd0} as filename (@pxref{host_drives}).  use the host floppy by using @file{/dev/fd0} as filename (@pxref{host_drives}).
 ETEXI  ETEXI
   
 DEF("hda", HAS_ARG, QEMU_OPTION_hda,  DEF("hda", HAS_ARG, QEMU_OPTION_hda,
     "-hda/-hdb file  use 'file' as IDE hard disk 0/1 image\n")      "-hda/-hdb file  use 'file' as IDE hard disk 0/1 image\n", QEMU_ARCH_ALL)
 DEF("hdb", HAS_ARG, QEMU_OPTION_hdb, "")  DEF("hdb", HAS_ARG, QEMU_OPTION_hdb, "", QEMU_ARCH_ALL)
 DEF("hdc", HAS_ARG, QEMU_OPTION_hdc,  DEF("hdc", HAS_ARG, QEMU_OPTION_hdc,
     "-hdc/-hdd file  use 'file' as IDE hard disk 2/3 image\n")      "-hdc/-hdd file  use 'file' as IDE hard disk 2/3 image\n", QEMU_ARCH_ALL)
 DEF("hdd", HAS_ARG, QEMU_OPTION_hdd, "")  DEF("hdd", HAS_ARG, QEMU_OPTION_hdd, "", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -hda @var{file}  @item -hda @var{file}
 @item -hdb @var{file}  @item -hdb @var{file}
 @item -hdc @var{file}  @item -hdc @var{file}
 @item -hdd @var{file}  @item -hdd @var{file}
   @findex -hda
   @findex -hdb
   @findex -hdc
   @findex -hdd
 Use @var{file} as hard disk 0, 1, 2 or 3 image (@pxref{disk_images}).  Use @var{file} as hard disk 0, 1, 2 or 3 image (@pxref{disk_images}).
 ETEXI  ETEXI
   
 DEF("cdrom", HAS_ARG, QEMU_OPTION_cdrom,  DEF("cdrom", HAS_ARG, QEMU_OPTION_cdrom,
     "-cdrom file     use 'file' as IDE cdrom image (cdrom is ide1 master)\n")      "-cdrom file     use 'file' as IDE cdrom image (cdrom is ide1 master)\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -cdrom @var{file}  @item -cdrom @var{file}
   @findex -cdrom
 Use @var{file} as CD-ROM image (you cannot use @option{-hdc} and  Use @var{file} as CD-ROM image (you cannot use @option{-hdc} and
 @option{-cdrom} at the same time). You can use the host CD-ROM by  @option{-cdrom} at the same time). You can use the host CD-ROM by
 using @file{/dev/cdrom} as filename (@pxref{host_drives}).  using @file{/dev/cdrom} as filename (@pxref{host_drives}).
Line 102  ETEXI Line 118  ETEXI
 DEF("drive", HAS_ARG, QEMU_OPTION_drive,  DEF("drive", HAS_ARG, QEMU_OPTION_drive,
     "-drive [file=file][,if=type][,bus=n][,unit=m][,media=d][,index=i]\n"      "-drive [file=file][,if=type][,bus=n][,unit=m][,media=d][,index=i]\n"
     "       [,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][,format=f][,serial=s]\n"      "       [,cache=writethrough|writeback|none|unsafe][,format=f]\n"
     "       [,addr=A][,id=name][,aio=threads|native]\n"      "       [,serial=s][,addr=A][,id=name][,aio=threads|native]\n"
     "                use 'file' as a drive image\n")      "       [,readonly=on|off]\n"
 DEF("set", HAS_ARG, QEMU_OPTION_set,      "                use 'file' as a drive image\n", QEMU_ARCH_ALL)
     "-set group.id.arg=value\n"  
     "                set <arg> parameter for item <id> of type <group>\n"  
     "                i.e. -set drive.$id.file=/path/to/image\n")  
 DEF("global", HAS_ARG, QEMU_OPTION_global,  
     "-global driver.property=value\n"  
     "                set a global default for a driver property\n")  
 STEXI  STEXI
 @item -drive @var{option}[,@var{option}[,@var{option}[,...]]]  @item -drive @var{option}[,@var{option}[,@var{option}[,...]]]
   @findex -drive
   
 Define a new drive. Valid options are:  Define a new drive. Valid options are:
   
Line 138  These options have the same definition a Line 149  These options have the same definition a
 @item snapshot=@var{snapshot}  @item snapshot=@var{snapshot}
 @var{snapshot} is "on" or "off" and allows to enable snapshot for given drive (see @option{-snapshot}).  @var{snapshot} is "on" or "off" and allows to enable snapshot for given drive (see @option{-snapshot}).
 @item cache=@var{cache}  @item cache=@var{cache}
 @var{cache} is "none", "writeback", or "writethrough" and controls how the host cache is used to access block data.  @var{cache} is "none", "writeback", "unsafe", or "writethrough" and controls how the host cache is used to access block data.
 @item aio=@var{aio}  @item aio=@var{aio}
 @var{aio} is "threads", or "native" and selects between pthread based disk I/O and native Linux AIO.  @var{aio} is "threads", or "native" and selects between pthread based disk I/O and native Linux AIO.
 @item format=@var{format}  @item format=@var{format}
Line 159  the storage subsystem. Line 170  the storage subsystem.
 Writeback caching will report data writes as completed as soon as the data is  Writeback caching will report data writes as completed as soon as the data is
 present in the host page cache.  This is safe as long as you trust your host.  present in the host page cache.  This is safe as long as you trust your host.
 If your host crashes or loses power, then the guest may experience data  If your host crashes or loses power, then the guest may experience data
 corruption.  When using the @option{-snapshot} option, writeback caching is  corruption.
 used by default.  
   
 The host page cache can be avoided entirely with @option{cache=none}.  This will  The host page cache can be avoided entirely with @option{cache=none}.  This will
 attempt to do disk IO directly to the guests memory.  QEMU may still perform  attempt to do disk IO directly to the guests memory.  QEMU may still perform
Line 170  Some block drivers perform badly with @o Line 180  Some block drivers perform badly with @o
 qcow2.  If performance is more important than correctness,  qcow2.  If performance is more important than correctness,
 @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
   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,
   like your host losing power, the disk storage getting disconnected accidently,
   etc. you're image will most probably be rendered unusable.   When using
   the @option{-snapshot} option, unsafe caching is always used.
   
 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 -drive file=file,index=2,media=cdrom
Line 216  qemu -hda a -hdb b Line 233  qemu -hda a -hdb b
 @end example  @end example
 ETEXI  ETEXI
   
 DEF("mtdblock", HAS_ARG, QEMU_OPTION_mtdblock,  DEF("set", HAS_ARG, QEMU_OPTION_set,
     "-mtdblock file  use 'file' as on-board Flash memory image\n")      "-set group.id.arg=value\n"
       "                set <arg> parameter for item <id> of type <group>\n"
       "                i.e. -set drive.$id.file=/path/to/image\n", QEMU_ARCH_ALL)
   STEXI
   @item -set
   @findex -set
   TODO
   ETEXI
   
   DEF("global", HAS_ARG, QEMU_OPTION_global,
       "-global driver.property=value\n"
       "                set a global default for a driver property\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
   @item -global
   @findex -global
   TODO
   ETEXI
   
   DEF("mtdblock", HAS_ARG, QEMU_OPTION_mtdblock,
       "-mtdblock file  use 'file' as on-board Flash memory image\n",
       QEMU_ARCH_ALL)
   STEXI
 @item -mtdblock @var{file}  @item -mtdblock @var{file}
   @findex -mtdblock
 Use @var{file} as on-board Flash memory image.  Use @var{file} as on-board Flash memory image.
 ETEXI  ETEXI
   
 DEF("sd", HAS_ARG, QEMU_OPTION_sd,  DEF("sd", HAS_ARG, QEMU_OPTION_sd,
     "-sd file        use 'file' as SecureDigital card image\n")      "-sd file        use 'file' as SecureDigital card image\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -sd @var{file}  @item -sd @var{file}
   @findex -sd
 Use @var{file} as SecureDigital card image.  Use @var{file} as SecureDigital card image.
 ETEXI  ETEXI
   
 DEF("pflash", HAS_ARG, QEMU_OPTION_pflash,  DEF("pflash", HAS_ARG, QEMU_OPTION_pflash,
     "-pflash file    use 'file' as a parallel flash image\n")      "-pflash file    use 'file' as a parallel flash image\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -pflash @var{file}  @item -pflash @var{file}
   @findex -pflash
 Use @var{file} as a parallel flash image.  Use @var{file} as a parallel flash image.
 ETEXI  ETEXI
   
 DEF("boot", HAS_ARG, QEMU_OPTION_boot,  DEF("boot", HAS_ARG, QEMU_OPTION_boot,
     "-boot [order=drives][,once=drives][,menu=on|off]\n"      "-boot [order=drives][,once=drives][,menu=on|off]\n"
     "                'drives': floppy (a), hard disk (c), CD-ROM (d), network (n)\n")      "                'drives': floppy (a), hard disk (c), CD-ROM (d), network (n)\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -boot [order=@var{drives}][,once=@var{drives}][,menu=on|off]  @item -boot [order=@var{drives}][,once=@var{drives}][,menu=on|off]
   @findex -boot
 Specify boot order @var{drives} as a string of drive letters. Valid  Specify boot order @var{drives} as a string of drive letters. Valid
 drive letters depend on the target achitecture. The x86 PC uses: a, b  drive letters depend on the target achitecture. The x86 PC uses: a, b
 (floppy 1 and 2), c (first hard disk), d (first CD-ROM), n-p (Etherboot  (floppy 1 and 2), c (first hard disk), d (first CD-ROM), n-p (Etherboot
Line 266  use is discouraged as it may be removed  Line 307  use is discouraged as it may be removed 
 ETEXI  ETEXI
   
 DEF("snapshot", 0, QEMU_OPTION_snapshot,  DEF("snapshot", 0, QEMU_OPTION_snapshot,
     "-snapshot       write to temporary files instead of disk image files\n")      "-snapshot       write to temporary files instead of disk image files\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -snapshot  @item -snapshot
   @findex -snapshot
 Write to temporary files instead of disk image files. In this case,  Write to temporary files instead of disk image files. In this case,
 the raw disk image you use is not written back. You can however force  the raw disk image you use is not written back. You can however force
 the write back by pressing @key{C-a s} (@pxref{disk_images}).  the write back by pressing @key{C-a s} (@pxref{disk_images}).
 ETEXI  ETEXI
   
 DEF("m", HAS_ARG, QEMU_OPTION_m,  DEF("m", HAS_ARG, QEMU_OPTION_m,
     "-m megs         set virtual RAM size to megs MB [default=%d]\n")      "-m megs         set virtual RAM size to megs MB [default="
       stringify(DEFAULT_RAM_SIZE) "]\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -m @var{megs}  @item -m @var{megs}
   @findex -m
 Set virtual RAM size to @var{megs} megabytes. Default is 128 MiB.  Optionally,  Set virtual RAM size to @var{megs} megabytes. Default is 128 MiB.  Optionally,
 a suffix of ``M'' or ``G'' can be used to signify a value in megabytes or  a suffix of ``M'' or ``G'' can be used to signify a value in megabytes or
 gigabytes respectively.  gigabytes respectively.
 ETEXI  ETEXI
   
   DEF("mem-path", HAS_ARG, QEMU_OPTION_mempath,
       "-mem-path FILE  provide backing storage for guest RAM\n", QEMU_ARCH_ALL)
   STEXI
   @item -mem-path @var{path}
   Allocate guest RAM from a temporarily created file in @var{path}.
   ETEXI
   
   #ifdef MAP_POPULATE
   DEF("mem-prealloc", 0, QEMU_OPTION_mem_prealloc,
       "-mem-prealloc   preallocate guest memory (use with -mem-path)\n",
       QEMU_ARCH_ALL)
   STEXI
   @item -mem-prealloc
   Preallocate memory when using -mem-path.
   ETEXI
   #endif
   
 DEF("k", HAS_ARG, QEMU_OPTION_k,  DEF("k", HAS_ARG, QEMU_OPTION_k,
     "-k language     use keyboard layout (for example 'fr' for French)\n")      "-k language     use keyboard layout (for example 'fr' for French)\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -k @var{language}  @item -k @var{language}
   @findex -k
 Use keyboard layout @var{language} (for example @code{fr} for  Use keyboard layout @var{language} (for example @code{fr} for
 French). This option is only needed where it is not easy to get raw PC  French). This option is only needed where it is not easy to get raw PC
 keycodes (e.g. on Macs, with some X11 servers or with a VNC  keycodes (e.g. on Macs, with some X11 servers or with a VNC
Line 305  The default is @code{en-us}. Line 368  The default is @code{en-us}.
 ETEXI  ETEXI
   
   
 #ifdef HAS_AUDIO  
 DEF("audio-help", 0, QEMU_OPTION_audio_help,  DEF("audio-help", 0, QEMU_OPTION_audio_help,
     "-audio-help     print list of audio drivers and their options\n")      "-audio-help     print list of audio drivers and their options\n",
 #endif      QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -audio-help  @item -audio-help
   @findex -audio-help
 Will show the audio subsystem help: list of drivers, tunable  Will show the audio subsystem help: list of drivers, tunable
 parameters.  parameters.
 ETEXI  ETEXI
   
 #ifdef HAS_AUDIO  
 DEF("soundhw", HAS_ARG, QEMU_OPTION_soundhw,  DEF("soundhw", HAS_ARG, QEMU_OPTION_soundhw,
     "-soundhw c1,... enable audio support\n"      "-soundhw c1,... enable audio support\n"
     "                and only specified sound cards (comma separated list)\n"      "                and only specified sound cards (comma separated list)\n"
     "                use -soundhw ? to get the list of supported cards\n"      "                use -soundhw ? to get the list of supported cards\n"
     "                use -soundhw all to enable all of them\n")      "                use -soundhw all to enable all of them\n", QEMU_ARCH_ALL)
 #endif  
 STEXI  STEXI
 @item -soundhw @var{card1}[,@var{card2},...] or -soundhw all  @item -soundhw @var{card1}[,@var{card2},...] or -soundhw all
   @findex -soundhw
 Enable audio and selected sound hardware. Use ? to print all  Enable audio and selected sound hardware. Use ? to print all
 available sound hardware.  available sound hardware.
   
Line 350  STEXI Line 410  STEXI
 ETEXI  ETEXI
   
 DEF("usb", 0, QEMU_OPTION_usb,  DEF("usb", 0, QEMU_OPTION_usb,
     "-usb            enable the USB driver (will be the default soon)\n")      "-usb            enable the USB driver (will be the default soon)\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 USB options:  USB options:
 @table @option  @table @option
   
 @item -usb  @item -usb
   @findex -usb
 Enable the USB driver (will be the default soon)  Enable the USB driver (will be the default soon)
 ETEXI  ETEXI
   
 DEF("usbdevice", HAS_ARG, QEMU_OPTION_usbdevice,  DEF("usbdevice", HAS_ARG, QEMU_OPTION_usbdevice,
     "-usbdevice name add the host or guest USB device 'name'\n")      "-usbdevice name add the host or guest USB device 'name'\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
   
 @item -usbdevice @var{devname}  @item -usbdevice @var{devname}
   @findex -usbdevice
 Add the USB device @var{devname}. @xref{usb_devices}.  Add the USB device @var{devname}. @xref{usb_devices}.
   
 @table @option  @table @option
Line 403  Network adapter that supports CDC ethern Line 467  Network adapter that supports CDC ethern
 ETEXI  ETEXI
   
 DEF("device", HAS_ARG, QEMU_OPTION_device,  DEF("device", HAS_ARG, QEMU_OPTION_device,
     "-device driver[,options]  add device\n")      "-device driver[,prop[=value][,...]]\n"
       "                add device (based on driver)\n"
       "                prop=value,... sets driver properties\n"
       "                use -device ? to print all possible drivers\n"
       "                use -device driver,? to print all possible properties\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -device @var{driver}[,@var{option}[,...]]  @item -device @var{driver}[,@var{prop}[=@var{value}][,...]]
 Add device @var{driver}. Depending on the device type,  @findex -device
 @var{option} (typically @var{key}=@var{value}) may be useful.  Add device @var{driver}.  @var{prop}=@var{value} sets driver
   properties.  Valid properties depend on the driver.  To get help on
   possible drivers and properties, use @code{-device ?} and
   @code{-device @var{driver},?}.
 ETEXI  ETEXI
   
   #ifdef CONFIG_LINUX
   DEFHEADING(File system options:)
   
   DEF("fsdev", HAS_ARG, QEMU_OPTION_fsdev,
       "-fsdev local,id=id,path=path,security_model=[mapped|passthrough]\n",
       QEMU_ARCH_ALL)
   
   STEXI
   
   The general form of a File system device option is:
   @table @option
   
   @item -fsdev @var{fstype} ,id=@var{id} [,@var{options}]
   @findex -fsdev
   Fstype is one of:
   @option{local},
   The specific Fstype will determine the applicable options.
   
   Options to each backend are described below.
   
   @item -fsdev local ,id=@var{id} ,path=@var{path} ,security_model=@var{security_model}
   
   Create a file-system-"device" for local-filesystem.
   
   @option{local} is only available on Linux.
   
   @option{path} specifies the path to be exported. @option{path} is required.
   
   @option{security_model} specifies the security model to be followed.
   @option{security_model} is required.
   
   @end table
   ETEXI
   #endif
   
   #ifdef CONFIG_LINUX
   DEFHEADING(Virtual File system pass-through options:)
   
   DEF("virtfs", HAS_ARG, QEMU_OPTION_virtfs,
       "-virtfs local,path=path,mount_tag=tag,security_model=[mapped|passthrough]\n",
       QEMU_ARCH_ALL)
   
   STEXI
   
   The general form of a Virtual File system pass-through option is:
   @table @option
   
   @item -virtfs @var{fstype} [,@var{options}]
   @findex -virtfs
   Fstype is one of:
   @option{local},
   The specific Fstype will determine the applicable options.
   
   Options to each backend are described below.
   
   @item -virtfs local ,path=@var{path} ,mount_tag=@var{mount_tag} ,security_model=@var{security_model}
   
   Create a Virtual file-system-pass through for local-filesystem.
   
   @option{local} is only available on Linux.
   
   @option{path} specifies the path to be exported. @option{path} is required.
   
   @option{security_model} specifies the security model to be followed.
   @option{security_model} is required.
   
   
   @option{mount_tag} specifies the tag with which the exported file is mounted.
   @option{mount_tag} is required.
   
   @end table
   ETEXI
   #endif
   
   DEFHEADING()
   
 DEF("name", HAS_ARG, QEMU_OPTION_name,  DEF("name", HAS_ARG, QEMU_OPTION_name,
     "-name string1[,process=string2]    set the name of the guest\n"      "-name string1[,process=string2]\n"
     "            string1 sets the window title and string2 the process name (on Linux)\n")      "                set the name of the guest\n"
       "                string1 sets the window title and string2 the process name (on Linux)\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -name @var{name}  @item -name @var{name}
   @findex -name
 Sets the @var{name} of the guest.  Sets the @var{name} of the guest.
 This name will be displayed in the SDL window caption.  This name will be displayed in the SDL window caption.
 The @var{name} will also be used for the VNC server.  The @var{name} will also be used for the VNC server.
Line 422  Also optionally set the top visible proc Line 573  Also optionally set the top visible proc
 ETEXI  ETEXI
   
 DEF("uuid", HAS_ARG, QEMU_OPTION_uuid,  DEF("uuid", HAS_ARG, QEMU_OPTION_uuid,
     "-uuid %%08x-%%04x-%%04x-%%04x-%%012x\n"      "-uuid %08x-%04x-%04x-%04x-%012x\n"
     "                specify machine UUID\n")      "                specify machine UUID\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -uuid @var{uuid}  @item -uuid @var{uuid}
   @findex -uuid
 Set system UUID.  Set system UUID.
 ETEXI  ETEXI
   
Line 442  STEXI Line 594  STEXI
 ETEXI  ETEXI
   
 DEF("nographic", 0, QEMU_OPTION_nographic,  DEF("nographic", 0, QEMU_OPTION_nographic,
     "-nographic      disable graphical output and redirect serial I/Os to console\n")      "-nographic      disable graphical output and redirect serial I/Os to console\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -nographic  @item -nographic
   @findex -nographic
 Normally, QEMU uses SDL to display the VGA output. With this option,  Normally, QEMU uses SDL to display the VGA output. With this option,
 you can totally disable graphical output so that QEMU is a simple  you can totally disable graphical output so that QEMU is a simple
 command line application. The emulated serial port is redirected on  command line application. The emulated serial port is redirected on
Line 455  ETEXI Line 608  ETEXI
   
 #ifdef CONFIG_CURSES  #ifdef CONFIG_CURSES
 DEF("curses", 0, QEMU_OPTION_curses,  DEF("curses", 0, QEMU_OPTION_curses,
     "-curses         use a curses/ncurses interface instead of SDL\n")      "-curses         use a curses/ncurses interface instead of SDL\n",
       QEMU_ARCH_ALL)
 #endif  #endif
 STEXI  STEXI
 @item -curses  @item -curses
   @findex curses
 Normally, QEMU uses SDL to display the VGA output.  With this option,  Normally, QEMU uses SDL to display the VGA output.  With this option,
 QEMU can display the VGA output when in text mode using a  QEMU can display the VGA output when in text mode using a
 curses/ncurses interface.  Nothing is displayed in graphical mode.  curses/ncurses interface.  Nothing is displayed in graphical mode.
Line 467  ETEXI Line 621  ETEXI
   
 #ifdef CONFIG_SDL  #ifdef CONFIG_SDL
 DEF("no-frame", 0, QEMU_OPTION_no_frame,  DEF("no-frame", 0, QEMU_OPTION_no_frame,
     "-no-frame       open SDL window without a frame and window decorations\n")      "-no-frame       open SDL window without a frame and window decorations\n",
       QEMU_ARCH_ALL)
 #endif  #endif
 STEXI  STEXI
 @item -no-frame  @item -no-frame
   @findex -no-frame
 Do not use decorations for SDL windows and start them using the whole  Do not use decorations for SDL windows and start them using the whole
 available screen space. This makes the using QEMU in a dedicated desktop  available screen space. This makes the using QEMU in a dedicated desktop
 workspace more convenient.  workspace more convenient.
Line 479  ETEXI Line 634  ETEXI
   
 #ifdef CONFIG_SDL  #ifdef CONFIG_SDL
 DEF("alt-grab", 0, QEMU_OPTION_alt_grab,  DEF("alt-grab", 0, QEMU_OPTION_alt_grab,
     "-alt-grab       use Ctrl-Alt-Shift to grab mouse (instead of Ctrl-Alt)\n")      "-alt-grab       use Ctrl-Alt-Shift to grab mouse (instead of Ctrl-Alt)\n",
       QEMU_ARCH_ALL)
 #endif  #endif
 STEXI  STEXI
 @item -alt-grab  @item -alt-grab
   @findex -alt-grab
 Use Ctrl-Alt-Shift to grab mouse (instead of Ctrl-Alt).  Use Ctrl-Alt-Shift to grab mouse (instead of Ctrl-Alt).
 ETEXI  ETEXI
   
 #ifdef CONFIG_SDL  #ifdef CONFIG_SDL
 DEF("ctrl-grab", 0, QEMU_OPTION_ctrl_grab,  DEF("ctrl-grab", 0, QEMU_OPTION_ctrl_grab,
     "-ctrl-grab       use Right-Ctrl to grab mouse (instead of Ctrl-Alt)\n")      "-ctrl-grab      use Right-Ctrl to grab mouse (instead of Ctrl-Alt)\n",
       QEMU_ARCH_ALL)
 #endif  #endif
 STEXI  STEXI
 @item -ctrl-grab  @item -ctrl-grab
   @findex -ctrl-grab
 Use Right-Ctrl to grab mouse (instead of Ctrl-Alt).  Use Right-Ctrl to grab mouse (instead of Ctrl-Alt).
 ETEXI  ETEXI
   
 #ifdef CONFIG_SDL  #ifdef CONFIG_SDL
 DEF("no-quit", 0, QEMU_OPTION_no_quit,  DEF("no-quit", 0, QEMU_OPTION_no_quit,
     "-no-quit        disable SDL window close capability\n")      "-no-quit        disable SDL window close capability\n", QEMU_ARCH_ALL)
 #endif  #endif
 STEXI  STEXI
 @item -no-quit  @item -no-quit
   @findex -no-quit
 Disable SDL window close capability.  Disable SDL window close capability.
 ETEXI  ETEXI
   
 #ifdef CONFIG_SDL  #ifdef CONFIG_SDL
 DEF("sdl", 0, QEMU_OPTION_sdl,  DEF("sdl", 0, QEMU_OPTION_sdl,
     "-sdl            enable SDL\n")      "-sdl            enable SDL\n", QEMU_ARCH_ALL)
 #endif  #endif
 STEXI  STEXI
 @item -sdl  @item -sdl
   @findex -sdl
 Enable SDL.  Enable SDL.
 ETEXI  ETEXI
   
 DEF("portrait", 0, QEMU_OPTION_portrait,  DEF("portrait", 0, QEMU_OPTION_portrait,
     "-portrait       rotate graphical output 90 deg left (only PXA LCD)\n")      "-portrait       rotate graphical output 90 deg left (only PXA LCD)\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -portrait  @item -portrait
   @findex -portrait
 Rotate graphical output 90 deg left (only PXA LCD).  Rotate graphical output 90 deg left (only PXA LCD).
 ETEXI  ETEXI
   
 DEF("vga", HAS_ARG, QEMU_OPTION_vga,  DEF("vga", HAS_ARG, QEMU_OPTION_vga,
     "-vga [std|cirrus|vmware|xenfb|none]\n"      "-vga [std|cirrus|vmware|xenfb|none]\n"
     "                select video card type\n")      "                select video card type\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -vga @var{type}  @item -vga @var{type}
   @findex -vga
 Select type of VGA card to emulate. Valid values for @var{type} are  Select type of VGA card to emulate. Valid values for @var{type} are
 @table @option  @table @option
 @item cirrus  @item cirrus
Line 552  Disable VGA card. Line 711  Disable VGA card.
 ETEXI  ETEXI
   
 DEF("full-screen", 0, QEMU_OPTION_full_screen,  DEF("full-screen", 0, QEMU_OPTION_full_screen,
     "-full-screen    start in full screen\n")      "-full-screen    start in full screen\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -full-screen  @item -full-screen
   @findex -full-screen
 Start in full screen.  Start in full screen.
 ETEXI  ETEXI
   
 #if defined(TARGET_PPC) || defined(TARGET_SPARC)  
 DEF("g", 1, QEMU_OPTION_g ,  DEF("g", 1, QEMU_OPTION_g ,
     "-g WxH[xDEPTH]  Set the initial graphical resolution and depth\n")      "-g WxH[xDEPTH]  Set the initial graphical resolution and depth\n",
 #endif      QEMU_ARCH_PPC | QEMU_ARCH_SPARC)
 STEXI  STEXI
   @item -g @var{width}x@var{height}[x@var{depth}]
   @findex -g
   Set the initial graphical resolution and depth (PPC, SPARC only).
 ETEXI  ETEXI
   
 DEF("vnc", HAS_ARG, QEMU_OPTION_vnc ,  DEF("vnc", HAS_ARG, QEMU_OPTION_vnc ,
     "-vnc display    start a VNC server on display\n")      "-vnc display    start a VNC server on display\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -vnc @var{display}[,@var{option}[,@var{option}[,...]]]  @item -vnc @var{display}[,@var{option}[,@var{option}[,...]]]
   @findex -vnc
 Normally, QEMU uses SDL to display the VGA output.  With this option,  Normally, QEMU uses SDL to display the VGA output.  With this option,
 you can have QEMU listen on VNC display @var{display} and redirect the VGA  you can have QEMU listen on VNC display @var{display} and redirect the VGA
 display over the VNC session.  It is very useful to enable the usb  display over the VNC session.  It is very useful to enable the usb
Line 673  empty, with a @code{deny} policy. Thus n Line 835  empty, with a @code{deny} policy. Thus n
 use the VNC server until the ACLs have been loaded. This can be  use the VNC server until the ACLs have been loaded. This can be
 achieved using the @code{acl} monitor command.  achieved using the @code{acl} monitor command.
   
   @item lossy
   
   Enable lossy compression methods (gradient, JPEG, ...). If this
   option is set, VNC client may receive lossy framebuffer updates
   depending on its encoding settings. Enabling this option can save
   a lot of bandwidth at the expense of quality.
   
 @end table  @end table
 ETEXI  ETEXI
   
Line 682  ETEXI Line 851  ETEXI
   
 DEFHEADING()  DEFHEADING()
   
 #ifdef TARGET_I386  
 DEFHEADING(i386 target only:)  DEFHEADING(i386 target only:)
 #endif  
 STEXI  STEXI
 @table @option  @table @option
 ETEXI  ETEXI
   
 #ifdef TARGET_I386  
 DEF("win2k-hack", 0, QEMU_OPTION_win2k_hack,  DEF("win2k-hack", 0, QEMU_OPTION_win2k_hack,
     "-win2k-hack     use it when installing Windows 2000 to avoid a disk full bug\n")      "-win2k-hack     use it when installing Windows 2000 to avoid a disk full bug\n",
 #endif      QEMU_ARCH_I386)
 STEXI  STEXI
 @item -win2k-hack  @item -win2k-hack
   @findex -win2k-hack
 Use it when installing Windows 2000 to avoid a disk full bug. After  Use it when installing Windows 2000 to avoid a disk full bug. After
 Windows 2000 is installed, you no longer need this option (this option  Windows 2000 is installed, you no longer need this option (this option
 slows down the IDE transfers).  slows down the IDE transfers).
 ETEXI  ETEXI
   
 #ifdef TARGET_I386  
 HXCOMM Deprecated by -rtc  HXCOMM Deprecated by -rtc
 DEF("rtc-td-hack", 0, QEMU_OPTION_rtc_td_hack, "")  DEF("rtc-td-hack", 0, QEMU_OPTION_rtc_td_hack, "", QEMU_ARCH_I386)
 #endif  
   
 #ifdef TARGET_I386  
 DEF("no-fd-bootchk", 0, QEMU_OPTION_no_fd_bootchk,  DEF("no-fd-bootchk", 0, QEMU_OPTION_no_fd_bootchk,
     "-no-fd-bootchk  disable boot signature checking for floppy disks\n")      "-no-fd-bootchk  disable boot signature checking for floppy disks\n",
 #endif      QEMU_ARCH_I386)
 STEXI  STEXI
 @item -no-fd-bootchk  @item -no-fd-bootchk
   @findex -no-fd-bootchk
 Disable boot signature checking for floppy disks in Bochs BIOS. It may  Disable boot signature checking for floppy disks in Bochs BIOS. It may
 be needed to boot from old floppy disks.  be needed to boot from old floppy disks.
   TODO: check reference to Bochs BIOS.
 ETEXI  ETEXI
   
 #ifdef TARGET_I386  
 DEF("no-acpi", 0, QEMU_OPTION_no_acpi,  DEF("no-acpi", 0, QEMU_OPTION_no_acpi,
            "-no-acpi        disable ACPI\n")             "-no-acpi        disable ACPI\n", QEMU_ARCH_I386)
 #endif  
 STEXI  STEXI
 @item -no-acpi  @item -no-acpi
   @findex -no-acpi
 Disable ACPI (Advanced Configuration and Power Interface) support. Use  Disable ACPI (Advanced Configuration and Power Interface) support. Use
 it if your guest OS complains about ACPI problems (PC target machine  it if your guest OS complains about ACPI problems (PC target machine
 only).  only).
 ETEXI  ETEXI
   
 #ifdef TARGET_I386  
 DEF("no-hpet", 0, QEMU_OPTION_no_hpet,  DEF("no-hpet", 0, QEMU_OPTION_no_hpet,
     "-no-hpet        disable HPET\n")      "-no-hpet        disable HPET\n", QEMU_ARCH_I386)
 #endif  
 STEXI  STEXI
 @item -no-hpet  @item -no-hpet
   @findex -no-hpet
 Disable HPET support.  Disable HPET support.
 ETEXI  ETEXI
   
 #ifdef TARGET_I386  
 DEF("balloon", HAS_ARG, QEMU_OPTION_balloon,  DEF("balloon", HAS_ARG, QEMU_OPTION_balloon,
     "-balloon none   disable balloon device\n"      "-balloon none   disable balloon device\n"
     "-balloon virtio[,addr=str]\n"      "-balloon virtio[,addr=str]\n"
     "                enable virtio balloon device (default)\n")      "                enable virtio balloon device (default)\n", QEMU_ARCH_ALL)
 #endif  
 STEXI  STEXI
 @item -balloon none  @item -balloon none
   @findex -balloon
 Disable balloon device.  Disable balloon device.
 @item -balloon virtio[,addr=@var{addr}]  @item -balloon virtio[,addr=@var{addr}]
 Enable virtio balloon device (default), optionally with PCI address  Enable virtio balloon device (default), optionally with PCI address
 @var{addr}.  @var{addr}.
 ETEXI  ETEXI
   
 #ifdef TARGET_I386  
 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=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=file1[:file2]...]\n"
     "                ACPI table description\n")      "                ACPI table description\n", QEMU_ARCH_I386)
 #endif  
 STEXI  STEXI
 @item -acpitable [sig=@var{str}][,rev=@var{n}][,oem_id=@var{str}][,oem_table_id=@var{str}][,oem_rev=@var{n}] [,asl_compiler_id=@var{str}][,asl_compiler_rev=@var{n}][,data=@var{file1}[:@var{file2}]...]  @item -acpitable [sig=@var{str}][,rev=@var{n}][,oem_id=@var{str}][,oem_table_id=@var{str}][,oem_rev=@var{n}] [,asl_compiler_id=@var{str}][,asl_compiler_rev=@var{n}][,data=@var{file1}[:@var{file2}]...]
   @findex -acpitable
 Add ACPI table with specified header fields and context from specified files.  Add ACPI table with specified header fields and context from specified files.
 ETEXI  ETEXI
   
 #ifdef TARGET_I386  
 DEF("smbios", HAS_ARG, QEMU_OPTION_smbios,  DEF("smbios", HAS_ARG, QEMU_OPTION_smbios,
     "-smbios file=binary\n"      "-smbios file=binary\n"
     "                Load SMBIOS entry from binary file\n"      "                load SMBIOS entry from binary file\n"
     "-smbios type=0[,vendor=str][,version=str][,date=str][,release=%%d.%%d]\n"      "-smbios type=0[,vendor=str][,version=str][,date=str][,release=%d.%d]\n"
     "                Specify SMBIOS type 0 fields\n"      "                specify SMBIOS type 0 fields\n"
     "-smbios type=1[,manufacturer=str][,product=str][,version=str][,serial=str]\n"      "-smbios type=1[,manufacturer=str][,product=str][,version=str][,serial=str]\n"
     "              [,uuid=uuid][,sku=str][,family=str]\n"      "              [,uuid=uuid][,sku=str][,family=str]\n"
     "                Specify SMBIOS type 1 fields\n")      "                specify SMBIOS type 1 fields\n", QEMU_ARCH_I386)
 #endif  
 STEXI  STEXI
 @item -smbios file=@var{binary}  @item -smbios file=@var{binary}
   @findex -smbios
 Load SMBIOS entry from binary file.  Load SMBIOS entry from binary file.
   
 @item -smbios type=0[,vendor=@var{str}][,version=@var{str}][,date=@var{str}][,release=@var{%d.%d}]  @item -smbios type=0[,vendor=@var{str}][,version=@var{str}][,date=@var{str}][,release=@var{%d.%d}]
   @findex -smbios
 Specify SMBIOS type 0 fields  Specify SMBIOS type 0 fields
   
 @item -smbios type=1[,manufacturer=@var{str}][,product=@var{str}][,version=@var{str}][,serial=@var{str}][,uuid=@var{uuid}][,sku=@var{str}][,family=@var{str}]  @item -smbios type=1[,manufacturer=@var{str}][,product=@var{str}] [,version=@var{str}][,serial=@var{str}][,uuid=@var{uuid}][,sku=@var{str}] [,family=@var{str}]
 Specify SMBIOS type 1 fields  Specify SMBIOS type 1 fields
 ETEXI  ETEXI
   
 #ifdef TARGET_I386  
 DEFHEADING()  DEFHEADING()
 #endif  
 STEXI  STEXI
 @end table  @end table
 ETEXI  ETEXI
Line 794  ETEXI Line 954  ETEXI
   
 HXCOMM Legacy slirp options (now moved to -net user):  HXCOMM Legacy slirp options (now moved to -net user):
 #ifdef CONFIG_SLIRP  #ifdef CONFIG_SLIRP
 DEF("tftp", HAS_ARG, QEMU_OPTION_tftp, "")  DEF("tftp", HAS_ARG, QEMU_OPTION_tftp, "", QEMU_ARCH_ALL)
 DEF("bootp", HAS_ARG, QEMU_OPTION_bootp, "")  DEF("bootp", HAS_ARG, QEMU_OPTION_bootp, "", QEMU_ARCH_ALL)
 DEF("redir", HAS_ARG, QEMU_OPTION_redir, "")  DEF("redir", HAS_ARG, QEMU_OPTION_redir, "", QEMU_ARCH_ALL)
 #ifndef _WIN32  #ifndef _WIN32
 DEF("smb", HAS_ARG, QEMU_OPTION_smb, "")  DEF("smb", HAS_ARG, QEMU_OPTION_smb, "", QEMU_ARCH_ALL)
 #endif  #endif
 #endif  #endif
   
Line 819  DEF("net", HAS_ARG, QEMU_OPTION_net, Line 979  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]\n"      "-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]\n"
     "                connect the host TAP network interface to VLAN 'n' and use the\n"      "                connect the host TAP network interface to VLAN 'n' and use the\n"
     "                network scripts 'file' (default=%s)\n"      "                network scripts 'file' (default=" DEFAULT_NETWORK_SCRIPT ")\n"
     "                and 'dfile' (default=%s);\n"      "                and 'dfile' (default=" DEFAULT_NETWORK_DOWN_SCRIPT ")\n"
     "                use '[down]script=no' to disable script execution;\n"      "                use '[down]script=no' to disable script execution\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 of 'sndbuf=1048576' can be disabled using 'sndbuf=0'\n"      "                default of 'sndbuf=1048576' can be disabled using 'sndbuf=0')\n"
     "                use vnet_hdr=off to avoid enabling the IFF_VNET_HDR tap flag; use\n"      "                use vnet_hdr=off to avoid enabling the IFF_VNET_HDR tap flag\n"
     "                vnet_hdr=on to make the lack of IFF_VNET_HDR support an error condition\n"      "                use vnet_hdr=on to make the lack of IFF_VNET_HDR support an error condition\n"
       "                use vhost=on to enable experimental in kernel accelerator\n"
       "                use 'vhostfd=h' to connect to an already opened vhost net device\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"
Line 843  DEF("net", HAS_ARG, QEMU_OPTION_net, Line 1005  DEF("net", HAS_ARG, QEMU_OPTION_net,
 #endif  #endif
     "-net dump[,vlan=n][,file=f][,len=n]\n"      "-net dump[,vlan=n][,file=f][,len=n]\n"
     "                dump traffic on vlan 'n' to file 'f' (max n bytes per packet)\n"      "                dump traffic on vlan 'n' to file 'f' (max n bytes per packet)\n"
     "-net none       use it alone to have zero network devices; if no -net option\n"      "-net none       use it alone to have zero network devices. If no -net option\n"
     "                is provided, the default is '-net nic -net user'\n")      "                is provided, the default is '-net nic -net user'\n", QEMU_ARCH_ALL)
 DEF("netdev", HAS_ARG, QEMU_OPTION_netdev,  DEF("netdev", HAS_ARG, QEMU_OPTION_netdev,
     "-netdev ["      "-netdev ["
 #ifdef CONFIG_SLIRP  #ifdef CONFIG_SLIRP
Line 854  DEF("netdev", HAS_ARG, QEMU_OPTION_netde Line 1016  DEF("netdev", HAS_ARG, QEMU_OPTION_netde
 #ifdef CONFIG_VDE  #ifdef CONFIG_VDE
     "vde|"      "vde|"
 #endif  #endif
     "socket],id=str[,option][,option][,...]\n")      "socket],id=str[,option][,option][,...]\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -net nic[,vlan=@var{n}][,macaddr=@var{mac}][,model=@var{type}][,name=@var{name}][,addr=@var{addr}][,vectors=@var{v}]  @item -net nic[,vlan=@var{n}][,macaddr=@var{mac}][,model=@var{type}] [,name=@var{name}][,addr=@var{addr}][,vectors=@var{v}]
   @findex -net
 Create a new Network Interface Card and connect it to VLAN @var{n} (@var{n}  Create a new Network Interface Card and connect it to VLAN @var{n} (@var{n}
 = 0 is the default). The NIC is an e1000 by default on the PC  = 0 is the default). The NIC is an e1000 by default on the PC
 target. Optionally, the MAC address can be changed to @var{mac}, the  target. Optionally, the MAC address can be changed to @var{mac}, the
Line 986  processed and applied to -net user. Mixi Line 1149  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}]
 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}, use
 the network script @var{file} to configure it and the network script  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
Line 1006  qemu linux.img -net nic,vlan=0 -net tap, Line 1169  qemu linux.img -net nic,vlan=0 -net tap,
                -net nic,vlan=1 -net tap,vlan=1,ifname=tap1                 -net nic,vlan=1 -net tap,vlan=1,ifname=tap1
 @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}]
   
 Connect the VLAN @var{n} to a remote VLAN in another QEMU virtual  Connect the VLAN @var{n} to a remote VLAN in another QEMU virtual
 machine using a TCP socket connection. If @option{listen} is  machine using a TCP socket connection. If @option{listen} is
Line 1026  qemu linux.img -net nic,macaddr=52:54:00 Line 1189  qemu linux.img -net nic,macaddr=52:54:00
                -net socket,connect=127.0.0.1:1234                 -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}]  @item -net socket[,vlan=@var{n}][,name=@var{name}][,fd=@var{h}] [,mcast=@var{maddr}:@var{port}]
   
 Create a VLAN @var{n} shared with another QEMU virtual  Create a VLAN @var{n} shared with another QEMU virtual
 machines using a UDP multicast socket, effectively making a bus for  machines using a UDP multicast socket, effectively making a bus for
Line 1066  qemu linux.img -net nic,macaddr=52:54:00 Line 1229  qemu linux.img -net nic,macaddr=52:54:00
 /path/to/linux ubd0=/path/to/root_fs eth0=mcast  /path/to/linux ubd0=/path/to/root_fs eth0=mcast
 @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}]
 Connect VLAN @var{n} to PORT @var{n} of a vde switch running on host and  Connect VLAN @var{n} to PORT @var{n} of a vde switch running on host and
 listening for incoming connections on @var{socketpath}. Use GROUP @var{groupname}  listening for incoming connections on @var{socketpath}. Use GROUP @var{groupname}
 and MODE @var{octalmode} to change default ownership and permissions for  and MODE @var{octalmode} to change default ownership and permissions for
Line 1099  DEFHEADING() Line 1262  DEFHEADING()
 DEFHEADING(Character device options:)  DEFHEADING(Character device options:)
   
 DEF("chardev", HAS_ARG, QEMU_OPTION_chardev,  DEF("chardev", HAS_ARG, QEMU_OPTION_chardev,
     "-chardev null,id=id\n"      "-chardev null,id=id[,mux=on|off]\n"
     "-chardev socket,id=id[,host=host],port=host[,to=to][,ipv4][,ipv6][,nodelay]\n"      "-chardev socket,id=id[,host=host],port=host[,to=to][,ipv4][,ipv6][,nodelay]\n"
     "         [,server][,nowait][,telnet] (tcp)\n"      "         [,server][,nowait][,telnet][,mux=on|off] (tcp)\n"
     "-chardev socket,id=id,path=path[,server][,nowait][,telnet] (unix)\n"      "-chardev socket,id=id,path=path[,server][,nowait][,telnet],[mux=on|off] (unix)\n"
     "-chardev udp,id=id[,host=host],port=port[,localaddr=localaddr]\n"      "-chardev udp,id=id[,host=host],port=port[,localaddr=localaddr]\n"
     "         [,localport=localport][,ipv4][,ipv6]\n"      "         [,localport=localport][,ipv4][,ipv6][,mux=on|off]\n"
     "-chardev msmouse,id=id\n"      "-chardev msmouse,id=id[,mux=on|off]\n"
     "-chardev vc,id=id[[,width=width][,height=height]][[,cols=cols][,rows=rows]]\n"      "-chardev vc,id=id[[,width=width][,height=height]][[,cols=cols][,rows=rows]]\n"
     "-chardev file,id=id,path=path\n"      "         [,mux=on|off]\n"
     "-chardev pipe,id=id,path=path\n"      "-chardev file,id=id,path=path[,mux=on|off]\n"
       "-chardev pipe,id=id,path=path[,mux=on|off]\n"
 #ifdef _WIN32  #ifdef _WIN32
     "-chardev console,id=id\n"      "-chardev console,id=id[,mux=on|off]\n"
     "-chardev serial,id=id,path=path\n"      "-chardev serial,id=id,path=path[,mux=on|off]\n"
 #else  #else
     "-chardev pty,id=id\n"      "-chardev pty,id=id[,mux=on|off]\n"
     "-chardev stdio,id=id,[,signal=on|off]\n"      "-chardev stdio,id=id[,mux=on|off][,signal=on|off]\n"
 #endif  #endif
 #ifdef CONFIG_BRLAPI  #ifdef CONFIG_BRLAPI
     "-chardev braille,id=id\n"      "-chardev braille,id=id[,mux=on|off]\n"
 #endif  #endif
 #if defined(__linux__) || defined(__sun__) || defined(__FreeBSD__) \  #if defined(__linux__) || defined(__sun__) || defined(__FreeBSD__) \
         || defined(__NetBSD__) || defined(__OpenBSD__) || defined(__DragonFly__)          || defined(__NetBSD__) || defined(__OpenBSD__) || defined(__DragonFly__)
     "-chardev tty,id=id,path=path\n"      "-chardev tty,id=id,path=path[,mux=on|off]\n"
 #endif  #endif
 #if defined(__linux__) || defined(__FreeBSD__) || defined(__DragonFly__)  #if defined(__linux__) || defined(__FreeBSD__) || defined(__DragonFly__)
     "-chardev parport,id=id,path=path\n"      "-chardev parport,id=id,path=path[,mux=on|off]\n"
 #endif  #endif
       , QEMU_ARCH_ALL
 )  )
   
 STEXI  STEXI
Line 1133  STEXI Line 1298  STEXI
 The general form of a character device option is:  The general form of a character device option is:
 @table @option  @table @option
   
 @item -chardev @var{backend} ,id=@var{id} [,@var{options}]  @item -chardev @var{backend} ,id=@var{id} [,mux=on|off] [,@var{options}]
   @findex -chardev
 Backend is one of:  Backend is one of:
 @option{null},  @option{null},
 @option{socket},  @option{socket},
Line 1155  The specific backend will determine the  Line 1320  The specific backend will determine the 
 All devices must have an id, which can be any string up to 127 characters long.  All devices must have an id, which can be any string up to 127 characters long.
 It is used to uniquely identify this device in other command line directives.  It is used to uniquely identify this device in other command line directives.
   
   A character device may be used in multiplexing mode by multiple front-ends.
   The key sequence of @key{Control-a} and @key{c} will rotate the input focus
   between attached front-ends. Specify @option{mux=on} to enable this mode.
   
 Options to each backend are described below.  Options to each backend are described below.
   
 @item -chardev null ,id=@var{id}  @item -chardev null ,id=@var{id}
Line 1179  TCP and unix socket options are given be Line 1348  TCP and unix socket options are given be
   
 @table @option  @table @option
   
 @item TCP options: port=@var{host} [,host=@var{host}] [,to=@var{to}] [,ipv4] [,ipv6] [,nodelay]  @item TCP options: port=@var{port} [,host=@var{host}] [,to=@var{to}] [,ipv4] [,ipv6] [,nodelay]
   
 @option{host} for a listening socket specifies the local address to be bound.  @option{host} for a listening socket specifies the local address to be bound.
 For a connecting socket species the remote host to connect to. @option{host} is  For a connecting socket species the remote host to connect to. @option{host} is
Line 1337  DEF("bt", HAS_ARG, QEMU_OPTION_bt, \ Line 1506  DEF("bt", HAS_ARG, QEMU_OPTION_bt, \
     "-bt vhci[,vlan=n]\n" \      "-bt vhci[,vlan=n]\n" \
     "                add host computer to virtual scatternet 'n' using VHCI\n" \      "                add host computer to virtual scatternet 'n' using VHCI\n" \
     "-bt device:dev[,vlan=n]\n" \      "-bt device:dev[,vlan=n]\n" \
     "                emulate a bluetooth device 'dev' in scatternet 'n'\n")      "                emulate a bluetooth device 'dev' in scatternet 'n'\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 @table @option  @table @option
   
 @item -bt hci[...]  @item -bt hci[...]
   @findex -bt
 Defines the function of the corresponding Bluetooth HCI.  -bt options  Defines the function of the corresponding Bluetooth HCI.  -bt options
 are matched with the HCIs present in the chosen machine type.  For  are matched with the HCIs present in the chosen machine type.  For
 example when emulating a machine with only one HCI built into it, only  example when emulating a machine with only one HCI built into it, only
Line 1407  for easier testing of various kernels. Line 1578  for easier testing of various kernels.
 ETEXI  ETEXI
   
 DEF("kernel", HAS_ARG, QEMU_OPTION_kernel, \  DEF("kernel", HAS_ARG, QEMU_OPTION_kernel, \
     "-kernel bzImage use 'bzImage' as kernel image\n")      "-kernel bzImage use 'bzImage' as kernel image\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -kernel @var{bzImage}  @item -kernel @var{bzImage}
   @findex -kernel
 Use @var{bzImage} as kernel image. The kernel can be either a Linux kernel  Use @var{bzImage} as kernel image. The kernel can be either a Linux kernel
 or in multiboot format.  or in multiboot format.
 ETEXI  ETEXI
   
 DEF("append", HAS_ARG, QEMU_OPTION_append, \  DEF("append", HAS_ARG, QEMU_OPTION_append, \
     "-append cmdline use 'cmdline' as kernel command line\n")      "-append cmdline use 'cmdline' as kernel command line\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -append @var{cmdline}  @item -append @var{cmdline}
   @findex -append
 Use @var{cmdline} as kernel command line  Use @var{cmdline} as kernel command line
 ETEXI  ETEXI
   
 DEF("initrd", HAS_ARG, QEMU_OPTION_initrd, \  DEF("initrd", HAS_ARG, QEMU_OPTION_initrd, \
            "-initrd file    use 'file' as initial ram disk\n")             "-initrd file    use 'file' as initial ram disk\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -initrd @var{file}  @item -initrd @var{file}
   @findex -initrd
 Use @var{file} as initial ram disk.  Use @var{file} as initial ram disk.
   
 @item -initrd "@var{file1} arg=foo,@var{file2}"  @item -initrd "@var{file1} arg=foo,@var{file2}"
Line 1448  STEXI Line 1622  STEXI
 ETEXI  ETEXI
   
 DEF("serial", HAS_ARG, QEMU_OPTION_serial, \  DEF("serial", HAS_ARG, QEMU_OPTION_serial, \
     "-serial dev     redirect the serial port to char device 'dev'\n")      "-serial dev     redirect the serial port to char device 'dev'\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -serial @var{dev}  @item -serial @var{dev}
   @findex -serial
 Redirect the virtual serial port to host character device  Redirect the virtual serial port to host character device
 @var{dev}. The default device is @code{vc} in graphical mode and  @var{dev}. The default device is @code{vc} in graphical mode and
 @code{stdio} in non graphical mode.  @code{stdio} in non graphical mode.
Line 1575  Three button serial mouse. Configure the Line 1751  Three button serial mouse. Configure the
 ETEXI  ETEXI
   
 DEF("parallel", HAS_ARG, QEMU_OPTION_parallel, \  DEF("parallel", HAS_ARG, QEMU_OPTION_parallel, \
     "-parallel dev   redirect the parallel port to char device 'dev'\n")      "-parallel dev   redirect the parallel port to char device 'dev'\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -parallel @var{dev}  @item -parallel @var{dev}
   @findex -parallel
 Redirect the virtual parallel port to host device @var{dev} (same  Redirect the virtual parallel port to host device @var{dev} (same
 devices as the serial port). On Linux hosts, @file{/dev/parportN} can  devices as the serial port). On Linux hosts, @file{/dev/parportN} can
 be used to use hardware devices connected on the corresponding host  be used to use hardware devices connected on the corresponding host
Line 1590  Use @code{-parallel none} to disable all Line 1768  Use @code{-parallel none} to disable all
 ETEXI  ETEXI
   
 DEF("monitor", HAS_ARG, QEMU_OPTION_monitor, \  DEF("monitor", HAS_ARG, QEMU_OPTION_monitor, \
     "-monitor dev    redirect the monitor to char device 'dev'\n")      "-monitor dev    redirect the monitor to char device 'dev'\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -monitor @var{dev}  @item -monitor @var{dev}
   @findex -monitor
 Redirect the monitor to host device @var{dev} (same devices as the  Redirect the monitor to host device @var{dev} (same devices as the
 serial port).  serial port).
 The default device is @code{vc} in graphical mode and @code{stdio} in  The default device is @code{vc} in graphical mode and @code{stdio} in
 non graphical mode.  non graphical mode.
 ETEXI  ETEXI
 DEF("qmp", HAS_ARG, QEMU_OPTION_qmp, \  DEF("qmp", HAS_ARG, QEMU_OPTION_qmp, \
     "-qmp dev        like -monitor but opens in 'control' mode.\n")      "-qmp dev        like -monitor but opens in 'control' mode\n",
       QEMU_ARCH_ALL)
   STEXI
   @item -qmp @var{dev}
   @findex -qmp
   Like -monitor but opens in 'control' mode.
   ETEXI
   
 DEF("mon", HAS_ARG, QEMU_OPTION_mon, \  DEF("mon", HAS_ARG, QEMU_OPTION_mon, \
     "-mon chardev=[name][,mode=readline|control][,default]\n")      "-mon chardev=[name][,mode=readline|control][,default]\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -mon chardev=[name][,mode=readline|control][,default]  @item -mon chardev=[name][,mode=readline|control][,default]
   @findex -mon
 Setup monitor on chardev @var{name}.  Setup monitor on chardev @var{name}.
 ETEXI  ETEXI
   
   DEF("debugcon", HAS_ARG, QEMU_OPTION_debugcon, \
       "-debugcon dev   redirect the debug console to char device 'dev'\n",
       QEMU_ARCH_ALL)
   STEXI
   @item -debugcon @var{dev}
   @findex -debugcon
   Redirect the debug console to host device @var{dev} (same devices as the
   serial port).  The debug console is an I/O port which is typically port
   0xe9; writing to that I/O port sends output to this device.
   The default device is @code{vc} in graphical mode and @code{stdio} in
   non graphical mode.
   ETEXI
   
 DEF("pidfile", HAS_ARG, QEMU_OPTION_pidfile, \  DEF("pidfile", HAS_ARG, QEMU_OPTION_pidfile, \
     "-pidfile file   write PID to 'file'\n")      "-pidfile file   write PID to 'file'\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -pidfile @var{file}  @item -pidfile @var{file}
   @findex -pidfile
 Store the QEMU process PID in @var{file}. It is useful if you launch QEMU  Store the QEMU process PID in @var{file}. It is useful if you launch QEMU
 from a script.  from a script.
 ETEXI  ETEXI
   
 DEF("singlestep", 0, QEMU_OPTION_singlestep, \  DEF("singlestep", 0, QEMU_OPTION_singlestep, \
     "-singlestep   always run in singlestep mode\n")      "-singlestep     always run in singlestep mode\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -singlestep  @item -singlestep
   @findex -singlestep
 Run the emulation in single step mode.  Run the emulation in single step mode.
 ETEXI  ETEXI
   
 DEF("S", 0, QEMU_OPTION_S, \  DEF("S", 0, QEMU_OPTION_S, \
     "-S              freeze CPU at startup (use 'c' to start execution)\n")      "-S              freeze CPU at startup (use 'c' to start execution)\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -S  @item -S
   @findex -S
 Do not start CPU at startup (you must type 'c' in the monitor).  Do not start CPU at startup (you must type 'c' in the monitor).
 ETEXI  ETEXI
   
 DEF("gdb", HAS_ARG, QEMU_OPTION_gdb, \  DEF("gdb", HAS_ARG, QEMU_OPTION_gdb, \
     "-gdb dev        wait for gdb connection on 'dev'\n")      "-gdb dev        wait for gdb connection on 'dev'\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -gdb @var{dev}  @item -gdb @var{dev}
   @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
Line 1644  within gdb and establish the connection  Line 1849  within gdb and establish the connection 
 ETEXI  ETEXI
   
 DEF("s", 0, QEMU_OPTION_s, \  DEF("s", 0, QEMU_OPTION_s, \
     "-s              shorthand for -gdb tcp::%s\n")      "-s              shorthand for -gdb tcp::" DEFAULT_GDBSTUB_PORT "\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -s  @item -s
   @findex -s
 Shorthand for -gdb tcp::1234, i.e. open a gdbserver on TCP port 1234  Shorthand for -gdb tcp::1234, i.e. open a gdbserver on TCP port 1234
 (@pxref{gdb_usage}).  (@pxref{gdb_usage}).
 ETEXI  ETEXI
   
 DEF("d", HAS_ARG, QEMU_OPTION_d, \  DEF("d", HAS_ARG, QEMU_OPTION_d, \
     "-d item1,...    output log to %s (use -d ? for a list of log items)\n")      "-d item1,...    output log to /tmp/qemu.log (use -d ? for a list of log items)\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -d  @item -d
   @findex -d
 Output log in /tmp/qemu.log  Output log in /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)
 STEXI  STEXI
 @item -hdachs @var{c},@var{h},@var{s},[,@var{t}]  @item -hdachs @var{c},@var{h},@var{s},[,@var{t}]
   @findex -hdachs
 Force hard disk 0 physical geometry (1 <= @var{c} <= 16383, 1 <=  Force hard disk 0 physical geometry (1 <= @var{c} <= 16383, 1 <=
 @var{h} <= 16, 1 <= @var{s} <= 63) and optionally force the BIOS  @var{h} <= 16, 1 <= @var{s} <= 63) and optionally force the BIOS
 translation mode (@var{t}=none, lba or auto). Usually QEMU can guess  translation mode (@var{t}=none, lba or auto). Usually QEMU can guess
Line 1672  images. Line 1883  images.
 ETEXI  ETEXI
   
 DEF("L", HAS_ARG, QEMU_OPTION_L, \  DEF("L", HAS_ARG, QEMU_OPTION_L, \
     "-L path         set the directory for the BIOS, VGA BIOS and keymaps\n")      "-L path         set the directory for the BIOS, VGA BIOS and keymaps\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -L  @var{path}  @item -L  @var{path}
   @findex -L
 Set the directory for the BIOS, VGA BIOS and keymaps.  Set the directory for the BIOS, VGA BIOS and keymaps.
 ETEXI  ETEXI
   
 DEF("bios", HAS_ARG, QEMU_OPTION_bios, \  DEF("bios", HAS_ARG, QEMU_OPTION_bios, \
     "-bios file      set the filename for the BIOS\n")      "-bios file      set the filename for the BIOS\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -bios @var{file}  @item -bios @var{file}
   @findex -bios
 Set the filename for the BIOS.  Set the filename for the BIOS.
 ETEXI  ETEXI
   
 #ifdef CONFIG_KVM  
 DEF("enable-kvm", 0, QEMU_OPTION_enable_kvm, \  DEF("enable-kvm", 0, QEMU_OPTION_enable_kvm, \
     "-enable-kvm     enable KVM full virtualization support\n")      "-enable-kvm     enable KVM full virtualization support\n", QEMU_ARCH_ALL)
 #endif  
 STEXI  STEXI
 @item -enable-kvm  @item -enable-kvm
   @findex -enable-kvm
 Enable KVM full virtualization support. This option is only available  Enable KVM full virtualization support. This option is only available
 if KVM support is enabled when compiling.  if KVM support is enabled when compiling.
 ETEXI  ETEXI
   
 #ifdef CONFIG_XEN  
 DEF("xen-domid", HAS_ARG, QEMU_OPTION_xen_domid,  DEF("xen-domid", HAS_ARG, QEMU_OPTION_xen_domid,
     "-xen-domid id   specify xen guest domain id\n")      "-xen-domid id   specify xen guest domain id\n", QEMU_ARCH_ALL)
 DEF("xen-create", 0, QEMU_OPTION_xen_create,  DEF("xen-create", 0, QEMU_OPTION_xen_create,
     "-xen-create     create domain using xen hypercalls, bypassing xend\n"      "-xen-create     create domain using xen hypercalls, bypassing xend\n"
     "                warning: should not be used when xend is in use\n")      "                warning: should not be used when xend is in use\n",
       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",
 #endif      QEMU_ARCH_ALL)
   STEXI
   @item -xen-domid @var{id}
   @findex -xen-domid
   Specify xen guest domain @var{id} (XEN only).
   @item -xen-create
   @findex -xen-create
   Create domain using xen hypercalls, bypassing xend.
   Warning: should not be used when xend is in use (XEN only).
   @item -xen-attach
   @findex -xen-attach
   Attach to existing xen domain.
   xend will use this when starting qemu (XEN only).
   ETEXI
   
 DEF("no-reboot", 0, QEMU_OPTION_no_reboot, \  DEF("no-reboot", 0, QEMU_OPTION_no_reboot, \
     "-no-reboot      exit instead of rebooting\n")      "-no-reboot      exit instead of rebooting\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -no-reboot  @item -no-reboot
   @findex -no-reboot
 Exit instead of rebooting.  Exit instead of rebooting.
 ETEXI  ETEXI
   
 DEF("no-shutdown", 0, QEMU_OPTION_no_shutdown, \  DEF("no-shutdown", 0, QEMU_OPTION_no_shutdown, \
     "-no-shutdown    stop before shutdown\n")      "-no-shutdown    stop before shutdown\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -no-shutdown  @item -no-shutdown
   @findex -no-shutdown
 Don't exit QEMU on guest shutdown, but instead only stop the emulation.  Don't exit QEMU on guest shutdown, but instead only stop the emulation.
 This allows for instance switching to monitor to commit changes to the  This allows for instance switching to monitor to commit changes to the
 disk image.  disk image.
Line 1724  ETEXI Line 1952  ETEXI
   
 DEF("loadvm", HAS_ARG, QEMU_OPTION_loadvm, \  DEF("loadvm", HAS_ARG, QEMU_OPTION_loadvm, \
     "-loadvm [tag|id]\n" \      "-loadvm [tag|id]\n" \
     "                start right away with a saved state (loadvm in monitor)\n")      "                start right away with a saved state (loadvm in monitor)\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -loadvm @var{file}  @item -loadvm @var{file}
   @findex -loadvm
 Start right away with a saved state (@code{loadvm} in monitor)  Start right away with a saved state (@code{loadvm} in monitor)
 ETEXI  ETEXI
   
 #ifndef _WIN32  #ifndef _WIN32
 DEF("daemonize", 0, QEMU_OPTION_daemonize, \  DEF("daemonize", 0, QEMU_OPTION_daemonize, \
     "-daemonize      daemonize QEMU after initializing\n")      "-daemonize      daemonize QEMU after initializing\n", QEMU_ARCH_ALL)
 #endif  #endif
 STEXI  STEXI
 @item -daemonize  @item -daemonize
   @findex -daemonize
 Daemonize the QEMU process after initialization.  QEMU will not detach from  Daemonize the QEMU process after initialization.  QEMU will not detach from
 standard IO until it is ready to receive connections on any of its devices.  standard IO until it is ready to receive connections on any of its devices.
 This option is a useful way for external programs to launch QEMU without having  This option is a useful way for external programs to launch QEMU without having
Line 1743  to cope with initialization race conditi Line 1974  to cope with initialization race conditi
 ETEXI  ETEXI
   
 DEF("option-rom", HAS_ARG, QEMU_OPTION_option_rom, \  DEF("option-rom", HAS_ARG, QEMU_OPTION_option_rom, \
     "-option-rom rom load a file, rom, into the option ROM space\n")      "-option-rom rom load a file, rom, into the option ROM space\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -option-rom @var{file}  @item -option-rom @var{file}
   @findex -option-rom
 Load the contents of @var{file} as an option ROM.  Load the contents of @var{file} as an option ROM.
 This option is useful to load things like EtherBoot.  This option is useful to load things like EtherBoot.
 ETEXI  ETEXI
   
 DEF("clock", HAS_ARG, QEMU_OPTION_clock, \  DEF("clock", HAS_ARG, QEMU_OPTION_clock, \
     "-clock          force the use of the given methods for timer alarm.\n" \      "-clock          force the use of the given methods for timer alarm.\n" \
     "                To see what timers are available use -clock ?\n")      "                To see what timers are available use -clock ?\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -clock @var{method}  @item -clock @var{method}
   @findex -clock
 Force the use of the given methods for timer alarm. To see what timers  Force the use of the given methods for timer alarm. To see what timers
 are available use -clock ?.  are available use -clock ?.
 ETEXI  ETEXI
   
 HXCOMM Options deprecated by -rtc  HXCOMM Options deprecated by -rtc
 DEF("localtime", 0, QEMU_OPTION_localtime, "")  DEF("localtime", 0, QEMU_OPTION_localtime, "", QEMU_ARCH_ALL)
 DEF("startdate", HAS_ARG, QEMU_OPTION_startdate, "")  DEF("startdate", HAS_ARG, QEMU_OPTION_startdate, "", QEMU_ARCH_ALL)
   
 #ifdef TARGET_I386  
 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|vm][,driftfix=none|slew]\n" \
     "                set the RTC base and clock, enable drift fix for clock ticks\n")      "                set the RTC base and clock, enable drift fix for clock ticks (x86 only)\n",
 #else      QEMU_ARCH_ALL)
 DEF("rtc", HAS_ARG, QEMU_OPTION_rtc, \  
     "-rtc [base=utc|localtime|date][,clock=host|vm]\n" \  
     "                set the RTC base and clock\n")  
 #endif  
   
 STEXI  STEXI
   
 @item -rtc [base=utc|localtime|@var{date}][,clock=host|vm][,driftfix=none|slew]  @item -rtc [base=utc|localtime|@var{date}][,clock=host|vm][,driftfix=none|slew]
   @findex -rtc
 Specify @option{base} as @code{utc} or @code{localtime} to let the RTC start at the current  Specify @option{base} as @code{utc} or @code{localtime} to let the RTC start at the current
 UTC or local time, respectively. @code{localtime} is required for correct date in  UTC or local time, respectively. @code{localtime} is required for correct date in
 MS-DOS or Windows. To start at a specific point in time, provide @var{date} in the  MS-DOS or Windows. To start at a specific point in time, provide @var{date} in the
Line 1796  ETEXI Line 2027  ETEXI
 DEF("icount", HAS_ARG, QEMU_OPTION_icount, \  DEF("icount", HAS_ARG, QEMU_OPTION_icount, \
     "-icount [N|auto]\n" \      "-icount [N|auto]\n" \
     "                enable virtual instruction counter with 2^N clock ticks per\n" \      "                enable virtual instruction counter with 2^N clock ticks per\n" \
     "                instruction\n")      "                instruction\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -icount [@var{N}|auto]  @item -icount [@var{N}|auto]
   @findex -icount
 Enable virtual instruction counter.  The virtual cpu will execute one  Enable virtual instruction counter.  The virtual cpu will execute one
 instruction every 2^@var{N} ns of virtual time.  If @code{auto} is specified  instruction every 2^@var{N} ns of virtual time.  If @code{auto} is specified
 then the virtual cpu speed will be automatically adjusted to keep virtual  then the virtual cpu speed will be automatically adjusted to keep virtual
Line 1812  ETEXI Line 2044  ETEXI
   
 DEF("watchdog", HAS_ARG, QEMU_OPTION_watchdog, \  DEF("watchdog", HAS_ARG, QEMU_OPTION_watchdog, \
     "-watchdog i6300esb|ib700\n" \      "-watchdog i6300esb|ib700\n" \
     "                enable virtual hardware watchdog [default=none]\n")      "                enable virtual hardware watchdog [default=none]\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -watchdog @var{model}  @item -watchdog @var{model}
   @findex -watchdog
 Create a virtual hardware watchdog device.  Once enabled (by a guest  Create a virtual hardware watchdog device.  Once enabled (by a guest
 action), the watchdog must be periodically polled by an agent inside  action), the watchdog must be periodically polled by an agent inside
 the guest or else the guest will be restarted.  the guest or else the guest will be restarted.
Line 1831  ETEXI Line 2065  ETEXI
   
 DEF("watchdog-action", HAS_ARG, QEMU_OPTION_watchdog_action, \  DEF("watchdog-action", HAS_ARG, QEMU_OPTION_watchdog_action, \
     "-watchdog-action reset|shutdown|poweroff|pause|debug|none\n" \      "-watchdog-action reset|shutdown|poweroff|pause|debug|none\n" \
     "                action when watchdog fires [default=reset]\n")      "                action when watchdog fires [default=reset]\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -watchdog-action @var{action}  @item -watchdog-action @var{action}
   
Line 1860  Examples: Line 2095  Examples:
 ETEXI  ETEXI
   
 DEF("echr", HAS_ARG, QEMU_OPTION_echr, \  DEF("echr", HAS_ARG, QEMU_OPTION_echr, \
     "-echr chr       set terminal escape character instead of ctrl-a\n")      "-echr chr       set terminal escape character instead of ctrl-a\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
   
 @item -echr @var{numeric_ascii_value}  @item -echr @var{numeric_ascii_value}
   @findex -echr
 Change the escape character used for switching to the monitor when using  Change the escape character used for switching to the monitor when using
 monitor and serial sharing.  The default is @code{0x01} when using the  monitor and serial sharing.  The default is @code{0x01} when using the
 @code{-nographic} option.  @code{0x01} is equal to pressing  @code{-nographic} option.  @code{0x01} is equal to pressing
Line 1879  ETEXI Line 2116  ETEXI
   
 DEF("virtioconsole", HAS_ARG, QEMU_OPTION_virtiocon, \  DEF("virtioconsole", HAS_ARG, QEMU_OPTION_virtiocon, \
     "-virtioconsole c\n" \      "-virtioconsole c\n" \
     "                set virtio console\n")      "                set virtio console\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -virtioconsole @var{c}  @item -virtioconsole @var{c}
   @findex -virtioconsole
 Set virtio console.  Set virtio console.
   
   This option is maintained for backward compatibility.
   
   Please use @code{-device virtconsole} for the new way of invocation.
 ETEXI  ETEXI
   
 DEF("show-cursor", 0, QEMU_OPTION_show_cursor, \  DEF("show-cursor", 0, QEMU_OPTION_show_cursor, \
     "-show-cursor    show cursor\n")      "-show-cursor    show cursor\n", QEMU_ARCH_ALL)
 STEXI  STEXI
   @item -show-cursor
   @findex -show-cursor
   Show cursor.
 ETEXI  ETEXI
   
 DEF("tb-size", HAS_ARG, QEMU_OPTION_tb_size, \  DEF("tb-size", HAS_ARG, QEMU_OPTION_tb_size, \
     "-tb-size n      set TB size\n")      "-tb-size n      set TB size\n", QEMU_ARCH_ALL)
 STEXI  STEXI
   @item -tb-size @var{n}
   @findex -tb-size
   Set TB size.
 ETEXI  ETEXI
   
 DEF("incoming", HAS_ARG, QEMU_OPTION_incoming, \  DEF("incoming", HAS_ARG, QEMU_OPTION_incoming, \
     "-incoming p     prepare for incoming migration, listen on port p\n")      "-incoming p     prepare for incoming migration, listen on port p\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
   @item -incoming @var{port}
   @findex -incoming
   Prepare for incoming migration, listen on @var{port}.
 ETEXI  ETEXI
   
 DEF("nodefaults", 0, QEMU_OPTION_nodefaults, \  DEF("nodefaults", 0, QEMU_OPTION_nodefaults, \
     "-nodefaults     don't create default devices.\n")      "-nodefaults     don't create default devices\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -nodefaults  @item -nodefaults
   @findex -nodefaults
 Don't create default devices.  Don't create default devices.
 ETEXI  ETEXI
   
 #ifndef _WIN32  #ifndef _WIN32
 DEF("chroot", HAS_ARG, QEMU_OPTION_chroot, \  DEF("chroot", HAS_ARG, QEMU_OPTION_chroot, \
     "-chroot dir     Chroot to dir just before starting the VM.\n")      "-chroot dir     chroot to dir just before starting the VM\n",
       QEMU_ARCH_ALL)
 #endif  #endif
 STEXI  STEXI
 @item -chroot @var{dir}  @item -chroot @var{dir}
   @findex -chroot
 Immediately before starting guest execution, chroot to the specified  Immediately before starting guest execution, chroot to the specified
 directory.  Especially useful in combination with -runas.  directory.  Especially useful in combination with -runas.
 ETEXI  ETEXI
   
 #ifndef _WIN32  #ifndef _WIN32
 DEF("runas", HAS_ARG, QEMU_OPTION_runas, \  DEF("runas", HAS_ARG, QEMU_OPTION_runas, \
     "-runas user     Change to user id user just before starting the VM.\n")      "-runas user     change to user id user just before starting the VM\n",
       QEMU_ARCH_ALL)
 #endif  #endif
 STEXI  STEXI
 @item -runas @var{user}  @item -runas @var{user}
   @findex -runas
 Immediately before starting guest execution, drop root privileges, switching  Immediately before starting guest execution, drop root privileges, switching
 to the specified user.  to the specified user.
 ETEXI  ETEXI
   
 #if defined(TARGET_SPARC) || defined(TARGET_PPC)  
 DEF("prom-env", HAS_ARG, QEMU_OPTION_prom_env,  DEF("prom-env", HAS_ARG, QEMU_OPTION_prom_env,
     "-prom-env variable=value\n"      "-prom-env variable=value\n"
     "                set OpenBIOS nvram variables\n")      "                set OpenBIOS nvram variables\n",
 #endif      QEMU_ARCH_PPC | QEMU_ARCH_SPARC)
 #if defined(TARGET_ARM) || defined(TARGET_M68K)  STEXI
   @item -prom-env @var{variable}=@var{value}
   @findex -prom-env
   Set OpenBIOS nvram @var{variable} to given @var{value} (PPC, SPARC only).
   ETEXI
 DEF("semihosting", 0, QEMU_OPTION_semihosting,  DEF("semihosting", 0, QEMU_OPTION_semihosting,
     "-semihosting    semihosting mode\n")      "-semihosting    semihosting mode\n", QEMU_ARCH_ARM | QEMU_ARCH_M68K)
 #endif  STEXI
 #if defined(TARGET_ARM)  @item -semihosting
   @findex -semihosting
   Semihosting mode (ARM, M68K only).
   ETEXI
 DEF("old-param", 0, QEMU_OPTION_old_param,  DEF("old-param", 0, QEMU_OPTION_old_param,
     "-old-param      old param mode\n")      "-old-param      old param mode\n", QEMU_ARCH_ARM)
 #endif  STEXI
   @item -old-param
   @findex -old-param (ARM)
   Old param mode (ARM only).
   ETEXI
   
 DEF("readconfig", HAS_ARG, QEMU_OPTION_readconfig,  DEF("readconfig", HAS_ARG, QEMU_OPTION_readconfig,
     "-readconfig <file>\n")      "-readconfig <file>\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -readconfig @var{file}  @item -readconfig @var{file}
   @findex -readconfig
 Read device configuration from @var{file}.  Read device configuration from @var{file}.
 ETEXI  ETEXI
 DEF("writeconfig", HAS_ARG, QEMU_OPTION_writeconfig,  DEF("writeconfig", HAS_ARG, QEMU_OPTION_writeconfig,
     "-writeconfig <file>\n"      "-writeconfig <file>\n"
     "                read/write config file\n")      "                read/write config file\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -writeconfig @var{file}  @item -writeconfig @var{file}
   @findex -writeconfig
 Write device configuration to @var{file}.  Write device configuration to @var{file}.
 ETEXI  ETEXI
   DEF("nodefconfig", 0, QEMU_OPTION_nodefconfig,
       "-nodefconfig\n"
       "                do not load default config files at startup\n",
       QEMU_ARCH_ALL)
   STEXI
   @item -nodefconfig
   @findex -nodefconfig
   Normally QEMU loads a configuration file from @var{sysconfdir}/qemu.conf and
   @var{sysconfdir}/target-@var{ARCH}.conf on startup.  The @code{-nodefconfig}
   option will prevent QEMU from loading these configuration files at startup.
   ETEXI
   
 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

Removed from v.1.1.1.6  
changed lines
  Added in v.1.1.1.7


unix.superglobalmegacorp.com