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

version 1.1.1.7, 2018/04/24 18:24:20 version 1.1.1.8, 2018/04/24 18:34:13
Line 393  available sound hardware. Line 393  available sound hardware.
 qemu -soundhw sb16,adlib disk.img  qemu -soundhw sb16,adlib disk.img
 qemu -soundhw es1370 disk.img  qemu -soundhw es1370 disk.img
 qemu -soundhw ac97 disk.img  qemu -soundhw ac97 disk.img
   qemu -soundhw hda disk.img
 qemu -soundhw all disk.img  qemu -soundhw all disk.img
 qemu -soundhw ?  qemu -soundhw ?
 @end example  @end example
Line 482  possible drivers and properties, use @co Line 483  possible drivers and properties, use @co
 @code{-device @var{driver},?}.  @code{-device @var{driver},?}.
 ETEXI  ETEXI
   
 #ifdef CONFIG_LINUX  
 DEFHEADING(File system options:)  DEFHEADING(File system options:)
   
 DEF("fsdev", HAS_ARG, QEMU_OPTION_fsdev,  DEF("fsdev", HAS_ARG, QEMU_OPTION_fsdev,
     "-fsdev local,id=id,path=path,security_model=[mapped|passthrough]\n",      "-fsdev local,id=id,path=path,security_model=[mapped|passthrough|none]\n",
     QEMU_ARCH_ALL)      QEMU_ARCH_ALL)
   
 STEXI  STEXI
Line 515  Create a file-system-"device" for local- Line 515  Create a file-system-"device" for local-
   
 @end table  @end table
 ETEXI  ETEXI
 #endif  
   
 #ifdef CONFIG_LINUX  
 DEFHEADING(Virtual File system pass-through options:)  DEFHEADING(Virtual File system pass-through options:)
   
 DEF("virtfs", HAS_ARG, QEMU_OPTION_virtfs,  DEF("virtfs", HAS_ARG, QEMU_OPTION_virtfs,
     "-virtfs local,path=path,mount_tag=tag,security_model=[mapped|passthrough]\n",      "-virtfs local,path=path,mount_tag=tag,security_model=[mapped|passthrough|none]\n",
     QEMU_ARCH_ALL)      QEMU_ARCH_ALL)
   
 STEXI  STEXI
Line 554  Create a Virtual file-system-pass throug Line 552  Create a Virtual file-system-pass throug
   
 @end table  @end table
 ETEXI  ETEXI
 #endif  
   
 DEFHEADING()  DEFHEADING()
   
Line 674  STEXI Line 671  STEXI
 Enable SDL.  Enable SDL.
 ETEXI  ETEXI
   
   DEF("spice", HAS_ARG, QEMU_OPTION_spice,
       "-spice <args>   enable spice\n", QEMU_ARCH_ALL)
   STEXI
   @item -spice @var{option}[,@var{option}[,...]]
   @findex -spice
   Enable the spice remote desktop protocol. Valid options are
   
   @table @option
   
   @item port=<nr>
   Set the TCP port spice is listening on for plaintext channels.
   
   @item addr=<addr>
   Set the IP address spice is listening on.  Default is any address.
   
   @item ipv4
   @item ipv6
   Force using the specified IP version.
   
   @item password=<secret>
   Set the password you need to authenticate.
   
   @item disable-ticketing
   Allow client connects without authentication.
   
   @item tls-port=<nr>
   Set the TCP port spice is listening on for encrypted channels.
   
   @item x509-dir=<dir>
   Set the x509 file directory. Expects same filenames as -vnc $display,x509=$dir
   
   @item x509-key-file=<file>
   @item x509-key-password=<file>
   @item x509-cert-file=<file>
   @item x509-cacert-file=<file>
   @item x509-dh-key-file=<file>
   The x509 file names can also be configured individually.
   
   @item tls-ciphers=<list>
   Specify which ciphers to use.
   
   @item tls-channel=[main|display|inputs|record|playback|tunnel]
   @item plaintext-channel=[main|display|inputs|record|playback|tunnel]
   Force specific channel to be used with or without TLS encryption.  The
   options can be specified multiple times to configure multiple
   channels.  The special name "default" can be used to set the default
   mode.  For channels which are not explicitly forced into one mode the
   spice client is allowed to pick tls/plaintext as he pleases.
   
   @item image-compression=[auto_glz|auto_lz|quic|glz|lz|off]
   Configure image compression (lossless).
   Default is auto_glz.
   
   @item jpeg-wan-compression=[auto|never|always]
   @item zlib-glz-wan-compression=[auto|never|always]
   Configure wan image compression (lossy for slow links).
   Default is auto.
   
   @item streaming-video=[off|all|filter]
   Configure video stream detection.  Default is filter.
   
   @item agent-mouse=[on|off]
   Enable/disable passing mouse events via vdagent.  Default is on.
   
   @item playback-compression=[on|off]
   Enable/disable audio stream compression (using celt 0.5.1).  Default is on.
   
   @end table
   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)      QEMU_ARCH_ALL)
Line 684  Rotate graphical output 90 deg left (onl Line 751  Rotate graphical output 90 deg left (onl
 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|qxl|xenfb|none]\n"
     "                select video card type\n", QEMU_ARCH_ALL)      "                select video card type\n", QEMU_ARCH_ALL)
 STEXI  STEXI
 @item -vga @var{type}  @item -vga @var{type}
Line 705  this option. Line 772  this option.
 VMWare SVGA-II compatible adapter. Use it if you have sufficiently  VMWare SVGA-II compatible adapter. Use it if you have sufficiently
 recent XFree86/XOrg server or Windows guest with a driver for this  recent XFree86/XOrg server or Windows guest with a driver for this
 card.  card.
   @item qxl
   QXL paravirtual graphic card.  It is VGA compatible (including VESA
   2.0 VBE support).  Works best with qxl guest drivers installed though.
   Recommended choice when using the spice protocol.
 @item none  @item none
 Disable VGA card.  Disable VGA card.
 @end table  @end table
Line 979  DEF("net", HAS_ARG, QEMU_OPTION_net, Line 1050  DEF("net", HAS_ARG, QEMU_OPTION_net,
     "-net tap[,vlan=n][,name=str],ifname=name\n"      "-net tap[,vlan=n][,name=str],ifname=name\n"
     "                connect the host TAP network interface to VLAN 'n'\n"      "                connect the host TAP network interface to VLAN 'n'\n"
 #else  #else
     "-net tap[,vlan=n][,name=str][,fd=h][,ifname=name][,script=file][,downscript=dfile][,sndbuf=nbytes][,vnet_hdr=on|off][,vhost=on|off][,vhostfd=h]\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][,vhostforce=on|off]\n"
     "                connect the host TAP network interface to VLAN 'n' and use the\n"      "                connect the host TAP network interface to VLAN 'n' and use the\n"
     "                network scripts 'file' (default=" DEFAULT_NETWORK_SCRIPT ")\n"      "                network scripts 'file' (default=" DEFAULT_NETWORK_SCRIPT ")\n"
     "                and 'dfile' (default=" DEFAULT_NETWORK_DOWN_SCRIPT ")\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 is disabled 'sndbuf=0' to enable flow control set 'sndbuf=1048576')\n"
     "                use vnet_hdr=off to avoid enabling the IFF_VNET_HDR tap flag\n"      "                use vnet_hdr=off to avoid enabling the IFF_VNET_HDR tap flag\n"
     "                use 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 vhost=on to enable experimental in kernel accelerator\n"
       "                    (only has effect for virtio guests which use MSIX)\n"
       "                use vhostforce=on to force vhost on for non-MSIX virtio guests\n"
     "                use 'vhostfd=h' to connect to an already opened vhost net device\n"      "                use 'vhostfd=h' to connect to an already opened vhost net device\n"
 #endif  #endif
     "-net socket[,vlan=n][,name=str][,fd=h][,listen=[host]:port][,connect=host:port]\n"      "-net socket[,vlan=n][,name=str][,fd=h][,listen=[host]:port][,connect=host:port]\n"
     "                connect the vlan 'n' to another VLAN using a socket connection\n"      "                connect the vlan 'n' to another VLAN using a socket connection\n"
     "-net socket[,vlan=n][,name=str][,fd=h][,mcast=maddr:port]\n"      "-net socket[,vlan=n][,name=str][,fd=h][,mcast=maddr:port[,localaddr=addr]]\n"
     "                connect the vlan 'n' to multicast maddr and port\n"      "                connect the vlan 'n' to multicast maddr and port\n"
       "                use 'localaddr=addr' to specify the host address to send packets from\n"
 #ifdef CONFIG_VDE  #ifdef CONFIG_VDE
     "-net vde[,vlan=n][,name=str][,sock=socketpath][,port=n][,group=groupname][,mode=octalmode]\n"      "-net vde[,vlan=n][,name=str][,sock=socketpath][,port=n][,group=groupname][,mode=octalmode]\n"
     "                connect the vlan 'n' to port 'n' of a vde switch running\n"      "                connect the vlan 'n' to port 'n' of a vde switch running\n"
Line 1189  qemu linux.img -net nic,macaddr=52:54:00 Line 1263  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}[,localaddr=@var{addr}]]
   
 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 1229  qemu linux.img -net nic,macaddr=52:54:00 Line 1303  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
   
   Example (send packets from host's 1.2.3.4):
   @example
   qemu linux.img -net nic,macaddr=52:54:00:12:34:56 \
                  -net socket,mcast=239.192.168.1:1102,localaddr=1.2.3.4
   @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}
Line 1290  DEF("chardev", HAS_ARG, QEMU_OPTION_char Line 1370  DEF("chardev", HAS_ARG, QEMU_OPTION_char
 #if defined(__linux__) || defined(__FreeBSD__) || defined(__DragonFly__)  #if defined(__linux__) || defined(__FreeBSD__) || defined(__DragonFly__)
     "-chardev parport,id=id,path=path[,mux=on|off]\n"      "-chardev parport,id=id,path=path[,mux=on|off]\n"
 #endif  #endif
   #if defined(CONFIG_SPICE)
       "-chardev spicevmc,id=id,name=name[,debug=debug]\n"
   #endif
     , QEMU_ARCH_ALL      , QEMU_ARCH_ALL
 )  )
   
Line 1314  Backend is one of: Line 1397  Backend is one of:
 @option{stdio},  @option{stdio},
 @option{braille},  @option{braille},
 @option{tty},  @option{tty},
 @option{parport}.  @option{parport},
   @option{spicevmc}.
 The specific backend will determine the applicable options.  The specific backend will determine the applicable options.
   
 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.
Line 1490  Connect to a local parallel port. Line 1574  Connect to a local parallel port.
 @option{path} specifies the path to the parallel port device. @option{path} is  @option{path} specifies the path to the parallel port device. @option{path} is
 required.  required.
   
   #if defined(CONFIG_SPICE)
   @item -chardev spicevmc ,id=@var{id} ,debug=@var{debug}, name=@var{name}
   
   @option{debug} debug level for spicevmc
   
   @option{name} name of spice channel to connect to
   
   Connect to a spice virtual machine channel, such as vdiport.
   #endif
   
 @end table  @end table
 ETEXI  ETEXI
   
Line 2234  Normally QEMU loads a configuration file Line 2328  Normally QEMU loads a configuration file
 @var{sysconfdir}/target-@var{ARCH}.conf on startup.  The @code{-nodefconfig}  @var{sysconfdir}/target-@var{ARCH}.conf on startup.  The @code{-nodefconfig}
 option will prevent QEMU from loading these configuration files at startup.  option will prevent QEMU from loading these configuration files at startup.
 ETEXI  ETEXI
   #ifdef CONFIG_SIMPLE_TRACE
   DEF("trace", HAS_ARG, QEMU_OPTION_trace,
       "-trace\n"
       "                Specify a trace file to log traces to\n",
       QEMU_ARCH_ALL)
   STEXI
   @item -trace
   @findex -trace
   Specify a trace file to log output traces to.
   ETEXI
   #endif
   
 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.7  
changed lines
  Added in v.1.1.1.8


unix.superglobalmegacorp.com