Diff for /qemu/qemu-options.hx between versions 1.1.1.8 and 1.1.1.9

version 1.1.1.8, 2018/04/24 18:34:13 version 1.1.1.9, 2018/04/24 18:56:29
Line 27  STEXI Line 27  STEXI
 Display version information and exit  Display version information and exit
 ETEXI  ETEXI
   
 DEF("M", HAS_ARG, QEMU_OPTION_M,  DEF("machine", HAS_ARG, QEMU_OPTION_machine, \
     "-M machine      select emulated machine (-M ? for list)\n", QEMU_ARCH_ALL)      "-machine [type=]name[,prop[=value][,...]]\n"
       "                selects emulated machine (-machine ? for list)\n"
       "                property accel=accel1[:accel2[:...]] selects accelerator\n"
       "                supported accelerators are kvm, xen, tcg (default: tcg)\n",
       QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -M @var{machine}  @item -machine [type=]@var{name}[,prop=@var{value}[,...]]
 @findex -M  @findex -machine
 Select the emulated @var{machine} (@code{-M ?} for list)  Select the emulated machine by @var{name}. Use @code{-machine ?} to list
   available machines. Supported machine properties are:
   @table @option
   @item accel=@var{accels1}[:@var{accels2}[:...]]
   This is used to enable an accelerator. Depending on the target architecture,
   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
   to initialize.
   @end table
 ETEXI  ETEXI
   
   HXCOMM Deprecated by -machine
   DEF("M", HAS_ARG, QEMU_OPTION_M, "", QEMU_ARCH_ALL)
   
 DEF("cpu", HAS_ARG, QEMU_OPTION_cpu,  DEF("cpu", HAS_ARG, QEMU_OPTION_cpu,
     "-cpu cpu        select CPU (-cpu ? for list)\n", QEMU_ARCH_ALL)      "-cpu cpu        select CPU (-cpu ? for list)\n", QEMU_ARCH_ALL)
 STEXI  STEXI
Line 160  an untrusted format header. Line 175  an untrusted format header.
 This option specifies the serial number to assign to the device.  This option specifies the serial number to assign to the device.
 @item addr=@var{addr}  @item addr=@var{addr}
 Specify the controller's PCI address (if=virtio only).  Specify the controller's PCI address (if=virtio only).
   @item werror=@var{action},rerror=@var{action}
   Specify which @var{action} to take on write and read errors. Valid actions are:
   "ignore" (ignore the error and try to continue), "stop" (pause QEMU),
   "report" (report the error to the guest), "enospc" (pause QEMU only if the
   host disk is full; report the error to the guest otherwise).
   The default setting is @option{werror=enospc} and @option{rerror=report}.
   @item readonly
   Open drive @option{file} as read-only. Guest write attempts will fail.
 @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 590  STEXI Line 613  STEXI
 @table @option  @table @option
 ETEXI  ETEXI
   
   DEF("display", HAS_ARG, QEMU_OPTION_display,
       "-display sdl[,frame=on|off][,alt_grab=on|off][,ctrl_grab=on|off]\n"
       "            [,window_close=on|off]|curses|none|\n"
       "            vnc=<display>[,<optargs>]\n"
       "                select display type\n", QEMU_ARCH_ALL)
   STEXI
   @item -display @var{type}
   @findex -display
   Select type of display to use. This option is a replacement for the
   old style -sdl/-curses/... options. Valid values for @var{type} are
   @table @option
   @item sdl
   Display video output via SDL (usually in a separate graphics
   window; see the SDL documentation for other possibilities).
   @item curses
   Display video output via curses. For graphics device models which
   support a text mode, QEMU can display this output using a
   curses/ncurses interface. Nothing is displayed when the graphics
   device is in graphical mode or if the graphics device does not support
   a text mode. Generally only the VGA device models support text mode.
   @item none
   Do not display video output. The guest will still see an emulated
   graphics card, but its output will not be displayed to the QEMU
   user. This option differs from the -nographic option in that it
   only affects what is done with video output; -nographic also changes
   the destination of the serial and parallel port data.
   @item vnc
   Start a VNC server on display <arg>
   @end table
   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)      QEMU_ARCH_ALL)
Line 603  the console. Therefore, you can still us Line 657  the console. Therefore, you can still us
 with a serial console.  with a serial console.
 ETEXI  ETEXI
   
 #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)      QEMU_ARCH_ALL)
 #endif  
 STEXI  STEXI
 @item -curses  @item -curses
 @findex curses  @findex curses
Line 616  QEMU can display the VGA output when in  Line 668  QEMU can display the VGA output when in 
 curses/ncurses interface.  Nothing is displayed in graphical mode.  curses/ncurses interface.  Nothing is displayed in graphical mode.
 ETEXI  ETEXI
   
 #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)      QEMU_ARCH_ALL)
 #endif  
 STEXI  STEXI
 @item -no-frame  @item -no-frame
 @findex -no-frame  @findex -no-frame
Line 629  available screen space. This makes the u Line 679  available screen space. This makes the u
 workspace more convenient.  workspace more convenient.
 ETEXI  ETEXI
   
 #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)      QEMU_ARCH_ALL)
 #endif  
 STEXI  STEXI
 @item -alt-grab  @item -alt-grab
 @findex -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). Note that this also
   affects the special keys (for fullscreen, monitor-mode switching, etc).
 ETEXI  ETEXI
   
 #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)      QEMU_ARCH_ALL)
 #endif  
 STEXI  STEXI
 @item -ctrl-grab  @item -ctrl-grab
 @findex -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). Note that this also
   affects the special keys (for fullscreen, monitor-mode switching, etc).
 ETEXI  ETEXI
   
 #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", QEMU_ARCH_ALL)      "-no-quit        disable SDL window close capability\n", QEMU_ARCH_ALL)
 #endif  
 STEXI  STEXI
 @item -no-quit  @item -no-quit
 @findex -no-quit  @findex -no-quit
 Disable SDL window close capability.  Disable SDL window close capability.
 ETEXI  ETEXI
   
 #ifdef CONFIG_SDL  
 DEF("sdl", 0, QEMU_OPTION_sdl,  DEF("sdl", 0, QEMU_OPTION_sdl,
     "-sdl            enable SDL\n", QEMU_ARCH_ALL)      "-sdl            enable SDL\n", QEMU_ARCH_ALL)
 #endif  
 STEXI  STEXI
 @item -sdl  @item -sdl
 @findex -sdl  @findex -sdl
Line 693  Force using the specified IP version. Line 737  Force using the specified IP version.
 @item password=<secret>  @item password=<secret>
 Set the password you need to authenticate.  Set the password you need to authenticate.
   
   @item sasl
   Require that the client use SASL to authenticate with the spice.
   The exact choice of authentication method used is controlled from the
   system / user's SASL configuration file for the 'qemu' service. This
   is typically found in /etc/sasl2/qemu.conf. If running QEMU as an
   unprivileged user, an environment variable SASL_CONF_PATH can be used
   to make it search alternate locations for the service config.
   While some SASL auth methods can also provide data encryption (eg GSSAPI),
   it is recommended that SASL always be combined with the 'tls' and
   'x509' settings to enable use of SSL and server certificates. This
   ensures a data encryption preventing compromise of authentication
   credentials.
   
 @item disable-ticketing  @item disable-ticketing
 Allow client connects without authentication.  Allow client connects without authentication.
   
   @item disable-copy-paste
   Disable copy paste between the client and the guest.
   
 @item tls-port=<nr>  @item tls-port=<nr>
 Set the TCP port spice is listening on for encrypted channels.  Set the TCP port spice is listening on for encrypted channels.
   
Line 750  STEXI Line 810  STEXI
 Rotate graphical output 90 deg left (only PXA LCD).  Rotate graphical output 90 deg left (only PXA LCD).
 ETEXI  ETEXI
   
   DEF("rotate", HAS_ARG, QEMU_OPTION_rotate,
       "-rotate <deg>   rotate graphical output some deg left (only PXA LCD)\n",
       QEMU_ARCH_ALL)
   STEXI
   @item -rotate
   @findex -rotate
   Rotate graphical output some deg left (only PXA LCD).
   ETEXI
   
 DEF("vga", HAS_ARG, QEMU_OPTION_vga,  DEF("vga", HAS_ARG, QEMU_OPTION_vga,
     "-vga [std|cirrus|vmware|qxl|xenfb|none]\n"      "-vga [std|cirrus|vmware|qxl|xenfb|none]\n"
     "                select video card type\n", QEMU_ARCH_ALL)      "                select video card type\n", QEMU_ARCH_ALL)
Line 913  option is set, VNC client may receive lo Line 982  option is set, VNC client may receive lo
 depending on its encoding settings. Enabling this option can save  depending on its encoding settings. Enabling this option can save
 a lot of bandwidth at the expense of quality.  a lot of bandwidth at the expense of quality.
   
   @item non-adaptive
   
   Disable adaptive encodings. Adaptive encodings are enabled by default.
   An adaptive encoding will try to detect frequently updated screen regions,
   and send updates in these regions using a lossy encoding (like JPEG).
   This can be really helpful to save bandwidth when playing videos. Disabling
   adaptive encodings allows to restore the original static behavior of encodings
   like Tight.
   
 @end table  @end table
 ETEXI  ETEXI
   
Line 1037  DEF("net", HAS_ARG, QEMU_OPTION_net, Line 1115  DEF("net", HAS_ARG, QEMU_OPTION_net,
     "-net nic[,vlan=n][,macaddr=mac][,model=type][,name=str][,addr=str][,vectors=v]\n"      "-net nic[,vlan=n][,macaddr=mac][,model=type][,name=str][,addr=str][,vectors=v]\n"
     "                create a new Network Interface Card and connect it to VLAN 'n'\n"      "                create a new Network Interface Card and connect it to VLAN 'n'\n"
 #ifdef CONFIG_SLIRP  #ifdef CONFIG_SLIRP
     "-net user[,vlan=n][,name=str][,net=addr[/mask]][,host=addr][,restrict=y|n]\n"      "-net user[,vlan=n][,name=str][,net=addr[/mask]][,host=addr][,restrict=on|off]\n"
     "         [,hostname=host][,dhcpstart=addr][,dns=addr][,tftp=dir][,bootfile=f]\n"      "         [,hostname=host][,dhcpstart=addr][,dns=addr][,tftp=dir][,bootfile=f]\n"
     "         [,hostfwd=rule][,guestfwd=rule]"      "         [,hostfwd=rule][,guestfwd=rule]"
 #ifndef _WIN32  #ifndef _WIN32
Line 1124  Assign symbolic name for use in monitor  Line 1202  Assign symbolic name for use in monitor 
 @item net=@var{addr}[/@var{mask}]  @item net=@var{addr}[/@var{mask}]
 Set IP network address the guest will see. Optionally specify the netmask,  Set IP network address the guest will see. Optionally specify the netmask,
 either in the form a.b.c.d or as number of valid top-most bits. Default is  either in the form a.b.c.d or as number of valid top-most bits. Default is
 10.0.2.0/8.  10.0.2.0/24.
   
 @item host=@var{addr}  @item host=@var{addr}
 Specify the guest-visible address of the host. Default is the 2nd IP in the  Specify the guest-visible address of the host. Default is the 2nd IP in the
 guest network, i.e. x.x.x.2.  guest network, i.e. x.x.x.2.
   
 @item restrict=y|yes|n|no  @item restrict=on|off
 If this options is enabled, the guest will be isolated, i.e. it will not be  If this option is enabled, the guest will be isolated, i.e. it will not be
 able to contact the host and no guest IP packets will be routed over the host  able to contact the host and no guest IP packets will be routed over the host
 to the outside. This option does not affect explicitly set forwarding rule.  to the outside. This option does not affect any explicitly set forwarding rules.
   
 @item hostname=@var{name}  @item hostname=@var{name}
 Specifies the client hostname reported by the builtin DHCP server.  Specifies the client hostname reported by the builtin DHCP server.
   
 @item dhcpstart=@var{addr}  @item dhcpstart=@var{addr}
 Specify the first of the 16 IPs the built-in DHCP server can assign. Default  Specify the first of the 16 IPs the built-in DHCP server can assign. Default
 is the 16th to 31st IP in the guest network, i.e. x.x.x.16 to x.x.x.31.  is the 15th to 31st IP in the guest network, i.e. x.x.x.15 to x.x.x.31.
   
 @item dns=@var{addr}  @item dns=@var{addr}
 Specify the guest-visible address of the virtual nameserver. The address must  Specify the guest-visible address of the virtual nameserver. The address must
Line 1178  or @file{C:\WINNT\SYSTEM32\DRIVERS\ETC\L Line 1256  or @file{C:\WINNT\SYSTEM32\DRIVERS\ETC\L
   
 Then @file{@var{dir}} can be accessed in @file{\\smbserver\qemu}.  Then @file{@var{dir}} can be accessed in @file{\\smbserver\qemu}.
   
 Note that a SAMBA server must be installed on the host OS in  Note that a SAMBA server must be installed on the host OS.
 @file{/usr/sbin/smbd}. QEMU was tested successfully with smbd versions from  QEMU was tested successfully with smbd versions from Red Hat 9,
 Red Hat 9, Fedora Core 3 and OpenSUSE 11.x.  Fedora Core 3 and OpenSUSE 11.x.
   
 @item hostfwd=[tcp|udp]:[@var{hostaddr}]:@var{hostport}-[@var{guestaddr}]:@var{guestport}  @item hostfwd=[tcp|udp]:[@var{hostaddr}]:@var{hostport}-[@var{guestaddr}]:@var{guestport}
 Redirect incoming TCP or UDP connections to the host port @var{hostport} to  Redirect incoming TCP or UDP connections to the host port @var{hostport} to
Line 1961  STEXI Line 2039  STEXI
 Output log in /tmp/qemu.log  Output log in /tmp/qemu.log
 ETEXI  ETEXI
   
   DEF("D", HAS_ARG, QEMU_OPTION_D, \
       "-D logfile      output log to logfile (instead of the default /tmp/qemu.log)\n",
       QEMU_ARCH_ALL)
   STEXI
   @item -D
   @findex -D
   Output log in logfile instead of /tmp/qemu.log
   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" \

Removed from v.1.1.1.8  
changed lines
  Added in v.1.1.1.9


unix.superglobalmegacorp.com