OpenE2K
/
qemu-e2k
13
4
Fork 0
Code Issues 4 Pull Requests Projects 2 Releases Activity

qemu-doc: Fix executable name in examples 

The executable name qemu was replaced some time ago by qemu-system-i386.
Fix all examples accordingly.

Some examples will only work with qemu-system-i386 or qemu-system-x86_64
for obvious reasons ("dos.img").

To keep things simple, I did not vary the executable name.
Place holders like qemu-system-TARGET were also only used once
in the enhanced description for QEMU launches using Wine.

Signed-off-by: Stefan Weil <sw@weilnetz.de>
This commit is contained in:
Stefan Weil 2012-05-11 22:21:50 +02:00
parent 8bd383b41a
commit 3804da9dbe
2 changed files with 101 additions and 91 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

71
qemu-doc.texi
View File

@ -230,12 +230,12 @@ Note that, by default, GUS shares IRQ(7) with parallel ports and so
qemu must be told to not have parallel ports to have working GUS qemu must be told to not have parallel ports to have working GUS
@example @example
qemu dos.img -soundhw gus -parallel none qemu-system-i386 dos.img -soundhw gus -parallel none
@end example @end example
Alternatively: Alternatively:
@example @example
qemu dos.img -device gus,irq=5 qemu-system-i386 dos.img -device gus,irq=5
@end example @end example
Or some other unclaimed IRQ. Or some other unclaimed IRQ.
@ -251,7 +251,7 @@ CS4231A is the chip used in Windows Sound System and GUSMAX products
Download and uncompress the linux image (@file{linux.img}) and type: Download and uncompress the linux image (@file{linux.img}) and type:
@example @example
qemu linux.img qemu-system-i386 linux.img
@end example @end example
Linux should boot and give you a prompt. Linux should boot and give you a prompt.
@ -261,7 +261,7 @@ Linux should boot and give you a prompt.
@example @example
@c man begin SYNOPSIS @c man begin SYNOPSIS
usage: qemu [options] [@var{disk_image}] usage: qemu-system-i386 [options] [@var{disk_image}]
@c man end @c man end
@end example @end example
@ -575,7 +575,7 @@ QEMU can automatically create a virtual FAT disk image from a
directory tree. In order to use it, just type: directory tree. In order to use it, just type:
@example @example
qemu linux.img -hdb fat:/my_directory qemu-system-i386 linux.img -hdb fat:/my_directory
@end example @end example
Then you access access to all the files in the @file{/my_directory} Then you access access to all the files in the @file{/my_directory}
@ -585,14 +585,14 @@ them via SAMBA or NFS. The default access is @emph{read-only}.
Floppies can be emulated with the @code{:floppy:} option: Floppies can be emulated with the @code{:floppy:} option:
@example @example
qemu linux.img -fda fat:floppy:/my_directory qemu-system-i386 linux.img -fda fat:floppy:/my_directory
@end example @end example
A read/write support is available for testing (beta stage) with the A read/write support is available for testing (beta stage) with the
@code{:rw:} option: @code{:rw:} option:
@example @example
qemu linux.img -fda fat:floppy:rw:/my_directory qemu-system-i386 linux.img -fda fat:floppy:rw:/my_directory
@end example @end example
What you should @emph{never} do: What you should @emph{never} do:
@ -610,14 +610,14 @@ QEMU can access directly to block device exported using the Network Block Device
protocol. protocol.
@example @example
qemu linux.img -hdb nbd:my_nbd_server.mydomain.org:1024 qemu-system-i386 linux.img -hdb nbd:my_nbd_server.mydomain.org:1024
@end example @end example
If the NBD server is located on the same host, you can use an unix socket instead If the NBD server is located on the same host, you can use an unix socket instead
of an inet socket: of an inet socket:
@example @example
qemu linux.img -hdb nbd:unix:/tmp/my_socket qemu-system-i386 linux.img -hdb nbd:unix:/tmp/my_socket
@end example @end example
In this case, the block device must be exported using qemu-nbd: In this case, the block device must be exported using qemu-nbd:
@ -633,15 +633,15 @@ qemu-nbd --socket=/tmp/my_socket --share=2 my_disk.qcow2
and then you can use it with two guests: and then you can use it with two guests:
@example @example
qemu linux1.img -hdb nbd:unix:/tmp/my_socket qemu-system-i386 linux1.img -hdb nbd:unix:/tmp/my_socket
qemu linux2.img -hdb nbd:unix:/tmp/my_socket qemu-system-i386 linux2.img -hdb nbd:unix:/tmp/my_socket
@end example @end example
If the nbd-server uses named exports (since NBD 2.9.18), you must use the If the nbd-server uses named exports (since NBD 2.9.18), you must use the
"exportname" option: "exportname" option:
@example @example
qemu -cdrom nbd:localhost:exportname=debian-500-ppc-netinst qemu-system-i386 -cdrom nbd:localhost:exportname=debian-500-ppc-netinst
qemu -cdrom nbd:localhost:exportname=openSUSE-11.1-ppc-netinst qemu-system-i386 -cdrom nbd:localhost:exportname=openSUSE-11.1-ppc-netinst
@end example @end example
@node disk_images_sheepdog @node disk_images_sheepdog
@ -666,7 +666,7 @@ qemu-img convert @var{filename} sheepdog:@var{image}
You can boot from the Sheepdog disk image with the command: You can boot from the Sheepdog disk image with the command:
@example @example
qemu sheepdog:@var{image} qemu-system-i386 sheepdog:@var{image}
@end example @end example
You can also create a snapshot of the Sheepdog image like qcow2. You can also create a snapshot of the Sheepdog image like qcow2.
@ -678,7 +678,7 @@ where @var{tag} is a tag name of the newly created snapshot.
To boot from the Sheepdog snapshot, specify the tag name of the To boot from the Sheepdog snapshot, specify the tag name of the
snapshot. snapshot.
@example @example
qemu sheepdog:@var{image}:@var{tag} qemu-system-i386 sheepdog:@var{image}:@var{tag}
@end example @end example
You can create a cloned image from the existing snapshot. You can create a cloned image from the existing snapshot.
@ -692,7 +692,7 @@ If the Sheepdog daemon doesn't run on the local host, you need to
specify one of the Sheepdog servers to connect to. specify one of the Sheepdog servers to connect to.
@example @example
qemu-img create sheepdog:@var{hostname}:@var{port}:@var{image} @var{size} qemu-img create sheepdog:@var{hostname}:@var{port}:@var{image} @var{size}
qemu sheepdog:@var{hostname}:@var{port}:@var{image} qemu-system-i386 sheepdog:@var{hostname}:@var{port}:@var{image}
@end example @end example
@node disk_images_iscsi @node disk_images_iscsi
@ -899,7 +899,7 @@ zero-copy communication to the application level of the guests. The basic
syntax is: syntax is:
@example @example
qemu -device ivshmem,size=<size in format accepted by -m>[,shm=<shm name>] qemu-system-i386 -device ivshmem,size=<size in format accepted by -m>[,shm=<shm name>]
@end example @end example
If desired, interrupts can be sent between guest VMs accessing the same shared If desired, interrupts can be sent between guest VMs accessing the same shared
@ -909,9 +909,9 @@ is qemu.git/contrib/ivshmem-server. An example syntax when using the shared
memory server is: memory server is:
@example @example
qemu -device ivshmem,size=<size in format accepted by -m>[,chardev=<id>] qemu-system-i386 -device ivshmem,size=<size in format accepted by -m>[,chardev=<id>]
[,msi=on][,ioeventfd=on][,vectors=n][,role=peer|master] [,msi=on][,ioeventfd=on][,vectors=n][,role=peer|master]
qemu -chardev socket,path=<path>,id=<id> qemu-system-i386 -chardev socket,path=<path>,id=<id>
@end example @end example
When using the server, the guest will be assigned a VM ID (>=0) that allows guests When using the server, the guest will be assigned a VM ID (>=0) that allows guests
@ -941,7 +941,7 @@ kernel testing.
The syntax is: The syntax is:
@example @example
qemu -kernel arch/i386/boot/bzImage -hda root-2.4.20.img -append "root=/dev/hda" qemu-system-i386 -kernel arch/i386/boot/bzImage -hda root-2.4.20.img -append "root=/dev/hda"
@end example @end example
Use @option{-kernel} to provide the Linux kernel image and Use @option{-kernel} to provide the Linux kernel image and
@ -956,8 +956,8 @@ If you do not need graphical output, you can disable it and redirect
the virtual serial port and the QEMU monitor to the console with the the virtual serial port and the QEMU monitor to the console with the
@option{-nographic} option. The typical command line is: @option{-nographic} option. The typical command line is:
@example @example
qemu -kernel arch/i386/boot/bzImage -hda root-2.4.20.img \ qemu-system-i386 -kernel arch/i386/boot/bzImage -hda root-2.4.20.img \
-append "root=/dev/hda console=ttyS0" -nographic -append "root=/dev/hda console=ttyS0" -nographic
@end example @end example
Use @key{Ctrl-a c} to switch between the serial console and the Use @key{Ctrl-a c} to switch between the serial console and the
@ -1020,7 +1020,7 @@ Network adapter that supports CDC ethernet and RNDIS protocols. @var{options}
specifies NIC options as with @code{-net nic,}@var{options} (see description). specifies NIC options as with @code{-net nic,}@var{options} (see description).
For instance, user-mode networking can be used with For instance, user-mode networking can be used with
@example @example
qemu [...OPTIONS...] -net user,vlan=0 -usbdevice net:vlan=0 qemu-system-i386 [...OPTIONS...] -net user,vlan=0 -usbdevice net:vlan=0
@end example @end example
Currently this cannot be used in machines that support PCI NICs. Currently this cannot be used in machines that support PCI NICs.
@item bt[:@var{hci-type}] @item bt[:@var{hci-type}]
@ -1030,7 +1030,7 @@ no type is given, the HCI logic corresponds to @code{-bt hci,vlan=0}.
This USB device implements the USB Transport Layer of HCI. Example This USB device implements the USB Transport Layer of HCI. Example
usage: usage:
@example @example
qemu [...OPTIONS...] -usbdevice bt:hci,vlan=3 -bt device:keyboard,vlan=3 qemu-system-i386 [...OPTIONS...] -usbdevice bt:hci,vlan=3 -bt device:keyboard,vlan=3
@end example @end example
@end table @end table
@ -1108,7 +1108,7 @@ For this setup it is recommended to restrict it to listen on a UNIX domain
socket only. For example socket only. For example
@example @example
qemu [...OPTIONS...] -vnc unix:/home/joebloggs/.qemu-myvm-vnc qemu-system-i386 [...OPTIONS...] -vnc unix:/home/joebloggs/.qemu-myvm-vnc
@end example @end example
This ensures that only users on local box with read/write access to that This ensures that only users on local box with read/write access to that
@ -1129,7 +1129,7 @@ option, and then once QEMU is running the password is set with the monitor. Unti
the monitor is used to set the password all clients will be rejected. the monitor is used to set the password all clients will be rejected.
@example @example
qemu [...OPTIONS...] -vnc :1,password -monitor stdio qemu-system-i386 [...OPTIONS...] -vnc :1,password -monitor stdio
(qemu) change vnc password (qemu) change vnc password
Password: ******** Password: ********
(qemu) (qemu)
@ -1146,7 +1146,7 @@ support provides a secure session, but no authentication. This allows any
client to connect, and provides an encrypted session. client to connect, and provides an encrypted session.
@example @example
qemu [...OPTIONS...] -vnc :1,tls,x509=/etc/pki/qemu -monitor stdio qemu-system-i386 [...OPTIONS...] -vnc :1,tls,x509=/etc/pki/qemu -monitor stdio
@end example @end example
In the above example @code{/etc/pki/qemu} should contain at least three files, In the above example @code{/etc/pki/qemu} should contain at least three files,
@ -1164,7 +1164,7 @@ then validate against the CA certificate. This is a good choice if deploying
in an environment with a private internal certificate authority. in an environment with a private internal certificate authority.
@example @example
qemu [...OPTIONS...] -vnc :1,tls,x509verify=/etc/pki/qemu -monitor stdio qemu-system-i386 [...OPTIONS...] -vnc :1,tls,x509verify=/etc/pki/qemu -monitor stdio
@end example @end example
@ -1175,7 +1175,7 @@ Finally, the previous method can be combined with VNC password authentication
to provide two layers of authentication for clients. to provide two layers of authentication for clients.
@example @example
qemu [...OPTIONS...] -vnc :1,password,tls,x509verify=/etc/pki/qemu -monitor stdio qemu-system-i386 [...OPTIONS...] -vnc :1,password,tls,x509verify=/etc/pki/qemu -monitor stdio
(qemu) change vnc password (qemu) change vnc password
Password: ******** Password: ********
(qemu) (qemu)
@ -1198,7 +1198,7 @@ used for authentication, but assuming use of one supporting SSF,
then QEMU can be launched with: then QEMU can be launched with:
@example @example
qemu [...OPTIONS...] -vnc :1,sasl -monitor stdio qemu-system-i386 [...OPTIONS...] -vnc :1,sasl -monitor stdio
@end example @end example
@node vnc_sec_certificate_sasl @node vnc_sec_certificate_sasl
@ -1212,7 +1212,7 @@ credentials. This can be enabled, by combining the 'sasl' option
with the aforementioned TLS + x509 options: with the aforementioned TLS + x509 options:
@example @example
qemu [...OPTIONS...] -vnc :1,tls,x509,sasl -monitor stdio qemu-system-i386 [...OPTIONS...] -vnc :1,tls,x509,sasl -monitor stdio
@end example @end example
@ -1380,8 +1380,8 @@ QEMU has a primitive support to work with gdb, so that you can do
In order to use gdb, launch qemu with the '-s' option. It will wait for a In order to use gdb, launch qemu with the '-s' option. It will wait for a
gdb connection: gdb connection:
@example @example
> qemu -s -kernel arch/i386/boot/bzImage -hda root-2.4.20.img \ qemu-system-i386 -s -kernel arch/i386/boot/bzImage -hda root-2.4.20.img \
-append "root=/dev/hda" -append "root=/dev/hda"
Connected to host network interface: tun0 Connected to host network interface: tun0
Waiting gdb connection on port 1234 Waiting gdb connection on port 1234
@end example @end example
@ -2669,7 +2669,8 @@ installation directory.
@end itemize @end itemize
Wine can be used to launch the resulting qemu.exe compiled for Win32. Wine can be used to launch the resulting qemu-system-i386.exe
and all other qemu-system-@var{target}.exe compiled for Win32.
@node Mac OS X @node Mac OS X
@section Mac OS X @section Mac OS X

121
qemu-options.hx
View File

@ -233,47 +233,47 @@ is off.
Instead of @option{-cdrom} you can use: Instead of @option{-cdrom} you can use:
@example @example
qemu -drive file=file,index=2,media=cdrom qemu-system-i386 -drive file=file,index=2,media=cdrom
@end example @end example
Instead of @option{-hda}, @option{-hdb}, @option{-hdc}, @option{-hdd}, you can Instead of @option{-hda}, @option{-hdb}, @option{-hdc}, @option{-hdd}, you can
use: use:
@example @example
qemu -drive file=file,index=0,media=disk qemu-system-i386 -drive file=file,index=0,media=disk
qemu -drive file=file,index=1,media=disk qemu-system-i386 -drive file=file,index=1,media=disk
qemu -drive file=file,index=2,media=disk qemu-system-i386 -drive file=file,index=2,media=disk
qemu -drive file=file,index=3,media=disk qemu-system-i386 -drive file=file,index=3,media=disk
@end example @end example
You can connect a CDROM to the slave of ide0: You can connect a CDROM to the slave of ide0:
@example @example
qemu -drive file=file,if=ide,index=1,media=cdrom qemu-system-i386 -drive file=file,if=ide,index=1,media=cdrom
@end example @end example
If you don't specify the "file=" argument, you define an empty drive: If you don't specify the "file=" argument, you define an empty drive:
@example @example
qemu -drive if=ide,index=1,media=cdrom qemu-system-i386 -drive if=ide,index=1,media=cdrom
@end example @end example
You can connect a SCSI disk with unit ID 6 on the bus #0: You can connect a SCSI disk with unit ID 6 on the bus #0:
@example @example
qemu -drive file=file,if=scsi,bus=0,unit=6 qemu-system-i386 -drive file=file,if=scsi,bus=0,unit=6
@end example @end example
Instead of @option{-fda}, @option{-fdb}, you can use: Instead of @option{-fda}, @option{-fdb}, you can use:
@example @example
qemu -drive file=file,index=0,if=floppy qemu-system-i386 -drive file=file,index=0,if=floppy
qemu -drive file=file,index=1,if=floppy qemu-system-i386 -drive file=file,index=1,if=floppy
@end example @end example
By default, @var{interface} is "ide" and @var{index} is automatically By default, @var{interface} is "ide" and @var{index} is automatically
incremented: incremented:
@example @example
qemu -drive file=a -drive file=b" qemu-system-i386 -drive file=a -drive file=b"
@end example @end example
is interpreted like: is interpreted like:
@example @example
qemu -hda a -hdb b qemu-system-i386 -hda a -hdb b
@end example @end example
ETEXI ETEXI
@ -297,7 +297,7 @@ STEXI
Set default value of @var{driver}'s property @var{prop} to @var{value}, e.g.: Set default value of @var{driver}'s property @var{prop} to @var{value}, e.g.:
@example @example
qemu -global ide-drive.physical_block_size=4096 -drive file=file,if=ide,index=0,media=disk qemu-system-i386 -global ide-drive.physical_block_size=4096 -drive file=file,if=ide,index=0,media=disk
@end example @end example
In particular, you can use this to set driver properties for devices which are In particular, you can use this to set driver properties for devices which are
@ -359,11 +359,11 @@ the recommended is 320x240, 640x480, 800x640.
@example @example
# try to boot from network first, then from hard disk # try to boot from network first, then from hard disk
qemu -boot order=nc qemu-system-i386 -boot order=nc
# boot from CD-ROM first, switch back to default order after reboot # boot from CD-ROM first, switch back to default order after reboot
qemu -boot once=d qemu-system-i386 -boot once=d
# boot with a splash picture for 5 seconds. # boot with a splash picture for 5 seconds.
qemu -boot menu=on,splash=/root/boot.bmp,splash-time=5000 qemu-system-i386 -boot menu=on,splash=/root/boot.bmp,splash-time=5000
@end example @end example
Note: The legacy format '-boot @var{drives}' is still supported but its Note: The legacy format '-boot @var{drives}' is still supported but its
@ -454,12 +454,12 @@ Enable audio and selected sound hardware. Use ? to print all
available sound hardware. available sound hardware.
@example @example
qemu -soundhw sb16,adlib disk.img qemu-system-i386 -soundhw sb16,adlib disk.img
qemu -soundhw es1370 disk.img qemu-system-i386 -soundhw es1370 disk.img
qemu -soundhw ac97 disk.img qemu-system-i386 -soundhw ac97 disk.img
qemu -soundhw hda disk.img qemu-system-i386 -soundhw hda disk.img
qemu -soundhw all disk.img qemu-system-i386 -soundhw all disk.img
qemu -soundhw ? qemu-system-i386 -soundhw ?
@end example @end example
Note that Linux's i810_audio OSS kernel (for AC97) module might Note that Linux's i810_audio OSS kernel (for AC97) module might
@ -1368,7 +1368,7 @@ a guest from a local directory.
Example (using pxelinux): Example (using pxelinux):
@example @example
qemu -hda linux.img -boot n -net user,tftp=/path/to/tftp/files,bootfile=/pxelinux.0 qemu-system-i386 -hda linux.img -boot n -net user,tftp=/path/to/tftp/files,bootfile=/pxelinux.0
@end example @end example
@item smb=@var{dir}[,smbserver=@var{addr}] @item smb=@var{dir}[,smbserver=@var{addr}]
@ -1403,7 +1403,7 @@ screen 0, use the following:
@example @example
# on the host # on the host
qemu -net user,hostfwd=tcp:127.0.0.1:6001-:6000 [...] qemu-system-i386 -net user,hostfwd=tcp:127.0.0.1:6001-:6000 [...]
# this host xterm should open in the guest X11 server # this host xterm should open in the guest X11 server
xterm -display :1 xterm -display :1
@end example @end example
@ -1413,7 +1413,7 @@ the guest, use the following:
@example @example
# on the host # on the host
qemu -net user,hostfwd=tcp::5555-:23 [...] qemu-system-i386 -net user,hostfwd=tcp::5555-:23 [...]
telnet localhost 5555 telnet localhost 5555
@end example @end example
@ -1452,20 +1452,22 @@ Examples:
@example @example
#launch a QEMU instance with the default network script #launch a QEMU instance with the default network script
qemu linux.img -net nic -net tap qemu-system-i386 linux.img -net nic -net tap
@end example @end example
@example @example
#launch a QEMU instance with two NICs, each one connected #launch a QEMU instance with two NICs, each one connected
#to a TAP device #to a TAP device
qemu linux.img -net nic,vlan=0 -net tap,vlan=0,ifname=tap0 \ qemu-system-i386 linux.img \
-net nic,vlan=1 -net tap,vlan=1,ifname=tap1 -net nic,vlan=0 -net tap,vlan=0,ifname=tap0 \
-net nic,vlan=1 -net tap,vlan=1,ifname=tap1
@end example @end example
@example @example
#launch a QEMU instance with the default network helper to #launch a QEMU instance with the default network helper to
#connect a TAP device to bridge br0 #connect a TAP device to bridge br0
qemu linux.img -net nic -net tap,"helper=/usr/local/libexec/qemu-bridge-helper" qemu-system-i386 linux.img \
-net nic -net tap,"helper=/usr/local/libexec/qemu-bridge-helper"
@end example @end example
@item -net bridge[,vlan=@var{n}][,name=@var{name}][,br=@var{bridge}][,helper=@var{helper}] @item -net bridge[,vlan=@var{n}][,name=@var{name}][,br=@var{bridge}][,helper=@var{helper}]
@ -1481,13 +1483,13 @@ Examples:
@example @example
#launch a QEMU instance with the default network helper to #launch a QEMU instance with the default network helper to
#connect a TAP device to bridge br0 #connect a TAP device to bridge br0
qemu linux.img -net bridge -net nic,model=virtio qemu-system-i386 linux.img -net bridge -net nic,model=virtio
@end example @end example
@example @example
#launch a QEMU instance with the default network helper to #launch a QEMU instance with the default network helper to
#connect a TAP device to bridge qemubr0 #connect a TAP device to bridge qemubr0
qemu linux.img -net bridge,br=qemubr0 -net nic,model=virtio qemu-system-i386 linux.img -net bridge,br=qemubr0 -net nic,model=virtio
@end example @end example
@item -net socket[,vlan=@var{n}][,name=@var{name}][,fd=@var{h}] [,listen=[@var{host}]:@var{port}][,connect=@var{host}:@var{port}] @item -net socket[,vlan=@var{n}][,name=@var{name}][,fd=@var{h}] [,listen=[@var{host}]:@var{port}][,connect=@var{host}:@var{port}]
@ -1502,12 +1504,14 @@ specifies an already opened TCP socket.
Example: Example:
@example @example
# launch a first QEMU instance # launch a first QEMU instance
qemu linux.img -net nic,macaddr=52:54:00:12:34:56 \ qemu-system-i386 linux.img \
-net socket,listen=:1234 -net nic,macaddr=52:54:00:12:34:56 \
-net socket,listen=:1234
# connect the VLAN 0 of this instance to the VLAN 0 # connect the VLAN 0 of this instance to the VLAN 0
# of the first instance # of the first instance
qemu linux.img -net nic,macaddr=52:54:00:12:34:57 \ qemu-system-i386 linux.img \
-net socket,connect=127.0.0.1:1234 -net nic,macaddr=52:54:00:12:34:57 \
-net socket,connect=127.0.0.1:1234
@end example @end example
@item -net socket[,vlan=@var{n}][,name=@var{name}][,fd=@var{h}][,mcast=@var{maddr}:@var{port}[,localaddr=@var{addr}]] @item -net socket[,vlan=@var{n}][,name=@var{name}][,fd=@var{h}][,mcast=@var{maddr}:@var{port}[,localaddr=@var{addr}]]
@ -1530,30 +1534,35 @@ Use @option{fd=h} to specify an already opened UDP multicast socket.
Example: Example:
@example @example
# launch one QEMU instance # launch one QEMU instance
qemu linux.img -net nic,macaddr=52:54:00:12:34:56 \ qemu-system-i386 linux.img \
-net socket,mcast=230.0.0.1:1234 -net nic,macaddr=52:54:00:12:34:56 \
-net socket,mcast=230.0.0.1:1234
# launch another QEMU instance on same "bus" # launch another QEMU instance on same "bus"
qemu linux.img -net nic,macaddr=52:54:00:12:34:57 \ qemu-system-i386 linux.img \
-net socket,mcast=230.0.0.1:1234 -net nic,macaddr=52:54:00:12:34:57 \
-net socket,mcast=230.0.0.1:1234
# launch yet another QEMU instance on same "bus" # launch yet another QEMU instance on same "bus"
qemu linux.img -net nic,macaddr=52:54:00:12:34:58 \ qemu-system-i386 linux.img \
-net socket,mcast=230.0.0.1:1234 -net nic,macaddr=52:54:00:12:34:58 \
-net socket,mcast=230.0.0.1:1234
@end example @end example
Example (User Mode Linux compat.): Example (User Mode Linux compat.):
@example @example
# launch QEMU instance (note mcast address selected # launch QEMU instance (note mcast address selected
# is UML's default) # is UML's default)
qemu linux.img -net nic,macaddr=52:54:00:12:34:56 \ qemu-system-i386 linux.img \
-net socket,mcast=239.192.168.1:1102 -net nic,macaddr=52:54:00:12:34:56 \
-net socket,mcast=239.192.168.1:1102
# launch UML # launch UML
/path/to/linux ubd0=/path/to/root_fs eth0=mcast /path/to/linux ubd0=/path/to/root_fs eth0=mcast
@end example @end example
Example (send packets from host's 1.2.3.4): Example (send packets from host's 1.2.3.4):
@example @example
qemu linux.img -net nic,macaddr=52:54:00:12:34:56 \ qemu-system-i386 linux.img \
-net socket,mcast=239.192.168.1:1102,localaddr=1.2.3.4 -net nic,macaddr=52:54:00:12:34:56 \
-net socket,mcast=239.192.168.1:1102,localaddr=1.2.3.4
@end example @end example
@item -net vde[,vlan=@var{n}][,name=@var{name}][,sock=@var{socketpath}] [,port=@var{n}][,group=@var{groupname}][,mode=@var{octalmode}] @item -net vde[,vlan=@var{n}][,name=@var{name}][,sock=@var{socketpath}] [,port=@var{n}][,group=@var{groupname}][,mode=@var{octalmode}]
@ -1568,7 +1577,7 @@ Example:
# launch vde switch # launch vde switch
vde_switch -F -sock /tmp/myswitch vde_switch -F -sock /tmp/myswitch
# launch QEMU instance # launch QEMU instance
qemu linux.img -net nic -net vde,sock=/tmp/myswitch qemu-system-i386 linux.img -net nic -net vde,sock=/tmp/myswitch
@end example @end example
@item -net dump[,vlan=@var{n}][,file=@var{file}][,len=@var{len}] @item -net dump[,vlan=@var{n}][,file=@var{file}][,len=@var{len}]
@ -1853,21 +1862,21 @@ Syntax for specifying iSCSI LUNs is
Example (without authentication): Example (without authentication):
@example @example
qemu -iscsi initiator-name=iqn.2001-04.com.example:my-initiator \ qemu-system-i386 -iscsi initiator-name=iqn.2001-04.com.example:my-initiator \
-cdrom iscsi://192.0.2.1/iqn.2001-04.com.example/2 \ -cdrom iscsi://192.0.2.1/iqn.2001-04.com.example/2 \
-drive file=iscsi://192.0.2.1/iqn.2001-04.com.example/1 -drive file=iscsi://192.0.2.1/iqn.2001-04.com.example/1
@end example @end example
Example (CHAP username/password via URL): Example (CHAP username/password via URL):
@example @example
qemu -drive file=iscsi://user%password@@192.0.2.1/iqn.2001-04.com.example/1 qemu-system-i386 -drive file=iscsi://user%password@@192.0.2.1/iqn.2001-04.com.example/1
@end example @end example
Example (CHAP username/password via environment variables): Example (CHAP username/password via environment variables):
@example @example
LIBISCSI_CHAP_USERNAME="user" \ LIBISCSI_CHAP_USERNAME="user" \
LIBISCSI_CHAP_PASSWORD="password" \ LIBISCSI_CHAP_PASSWORD="password" \
qemu -drive file=iscsi://192.0.2.1/iqn.2001-04.com.example/1 qemu-system-i386 -drive file=iscsi://192.0.2.1/iqn.2001-04.com.example/1
@end example @end example
iSCSI support is an optional feature of QEMU and only available when iSCSI support is an optional feature of QEMU and only available when
@ -1893,12 +1902,12 @@ Syntax for specifying a NBD device using Unix Domain Sockets
Example for TCP Example for TCP
@example @example
qemu --drive file=nbd:192.0.2.1:30000 qemu-system-i386 --drive file=nbd:192.0.2.1:30000
@end example @end example
Example for Unix Domain Sockets Example for Unix Domain Sockets
@example @example
qemu --drive file=nbd:unix:/tmp/nbd-socket qemu-system-i386 --drive file=nbd:unix:/tmp/nbd-socket
@end example @end example
@item Sheepdog @item Sheepdog
@ -1923,7 +1932,7 @@ Syntax for specifying a sheepdog device
Example Example
@example @example
qemu --drive file=sheepdog:192.0.2.1:30000:MyVirtualMachine qemu-system-i386 --drive file=sheepdog:192.0.2.1:30000:MyVirtualMachine
@end example @end example
See also @url{http://http://www.osrg.net/sheepdog/}. See also @url{http://http://www.osrg.net/sheepdog/}.
@ -1986,7 +1995,7 @@ and communicate. Requires the Linux @code{vhci} driver installed. Can
be used as following: be used as following:
@example @example
qemu [...OPTIONS...] -bt hci,vlan=5 -bt vhci,vlan=5 qemu-system-i386 [...OPTIONS...] -bt hci,vlan=5 -bt vhci,vlan=5
@end example @end example
@item -bt device:@var{dev}[,vlan=@var{n}] @item -bt device:@var{dev}[,vlan=@var{n}]
@ -2289,7 +2298,7 @@ connections will likely be TCP-based, but also UDP, pseudo TTY, or even
stdio are reasonable use case. The latter is allowing to start qemu from stdio are reasonable use case. The latter is allowing to start qemu from
within gdb and establish the connection via a pipe: within gdb and establish the connection via a pipe:
@example @example
(gdb) target remote | exec qemu -gdb stdio ... (gdb) target remote | exec qemu-system-i386 -gdb stdio ...
@end example @end example
ETEXI ETEXI