2018-11-29 12:09:34 +00:00
|
|
|
From d0656d8b2e0de42d04c224db36fe9c1ec015a9cc Mon Sep 17 00:00:00 2001
|
2018-10-14 17:48:54 +00:00
|
|
|
From: Miroslav Rezanina <mrezanin@redhat.com>
|
|
|
|
Date: Fri, 14 Nov 2014 08:51:50 +0100
|
|
|
|
Subject: Use qemu-kvm in documentation instead of qemu-system-<arch>
|
|
|
|
|
|
|
|
Patchwork-id: 62380
|
|
|
|
O-Subject: [RHEV-7.1 qemu-kvm-rhev PATCHv4] Use qemu-kvm in documentation instead of qemu-system-i386
|
|
|
|
Bugzilla: 1140620
|
|
|
|
RH-Acked-by: Laszlo Ersek <lersek@redhat.com>
|
|
|
|
RH-Acked-by: Markus Armbruster <armbru@redhat.com>
|
|
|
|
RH-Acked-by: Stefan Hajnoczi <stefanha@redhat.com>
|
|
|
|
|
|
|
|
From: Miroslav Rezanina <mrezanin@redhat.com>
|
|
|
|
|
|
|
|
We change the name and location of qemu-kvm binaries. Update documentation
|
|
|
|
to reflect this change. Only architectures available in RHEL are updated.
|
|
|
|
|
|
|
|
Signed-off-by: Miroslav Rezanina <mrezanin@redhat.com>
|
|
|
|
---
|
2018-11-29 12:09:34 +00:00
|
|
|
docs/COLO-FT.txt | 4 +-
|
2018-10-14 17:48:54 +00:00
|
|
|
docs/can.txt | 8 +--
|
|
|
|
docs/pr-manager.rst | 4 +-
|
2018-11-29 12:09:34 +00:00
|
|
|
docs/qemu-block-drivers.texi | 70 +++++++++++-----------
|
|
|
|
docs/qemu-cpu-models.texi | 8 +--
|
2018-10-14 17:48:54 +00:00
|
|
|
docs/replay.txt | 4 +-
|
|
|
|
docs/specs/tpm.txt | 8 +--
|
2018-11-29 12:09:34 +00:00
|
|
|
qemu-doc.texi | 70 +++++++++++-----------
|
|
|
|
qemu-options.hx | 140 ++++++++++++++++++++++---------------------
|
|
|
|
9 files changed, 160 insertions(+), 156 deletions(-)
|
2018-10-14 17:48:54 +00:00
|
|
|
|
2018-11-29 12:09:34 +00:00
|
|
|
diff --git a/docs/COLO-FT.txt b/docs/COLO-FT.txt
|
|
|
|
index e2686bb..8c48f86 100644
|
|
|
|
--- a/docs/COLO-FT.txt
|
|
|
|
+++ b/docs/COLO-FT.txt
|
|
|
|
@@ -147,7 +147,7 @@ in test procedure.
|
|
|
|
== Test procedure ==
|
|
|
|
1. Startup qemu
|
|
|
|
Primary:
|
|
|
|
-# qemu-system-x86_64 -accel kvm -m 2048 -smp 2 -qmp stdio -name primary \
|
|
|
|
+# qemu-kvm -accel kvm -m 2048 -smp 2 -qmp stdio -name primary \
|
|
|
|
-device piix3-usb-uhci -vnc :7 \
|
|
|
|
-device usb-tablet -netdev tap,id=hn0,vhost=off \
|
|
|
|
-device virtio-net-pci,id=net-pci0,netdev=hn0 \
|
|
|
|
@@ -155,7 +155,7 @@ Primary:
|
|
|
|
children.0.file.filename=1.raw,\
|
|
|
|
children.0.driver=raw -S
|
|
|
|
Secondary:
|
|
|
|
-# qemu-system-x86_64 -accel kvm -m 2048 -smp 2 -qmp stdio -name secondary \
|
|
|
|
+# qemu-kvm -accel kvm -m 2048 -smp 2 -qmp stdio -name secondary \
|
|
|
|
-device piix3-usb-uhci -vnc :7 \
|
|
|
|
-device usb-tablet -netdev tap,id=hn0,vhost=off \
|
|
|
|
-device virtio-net-pci,id=net-pci0,netdev=hn0 \
|
2018-10-14 17:48:54 +00:00
|
|
|
diff --git a/docs/can.txt b/docs/can.txt
|
|
|
|
index 7ba23b2..4ae5690 100644
|
|
|
|
--- a/docs/can.txt
|
|
|
|
+++ b/docs/can.txt
|
|
|
|
@@ -50,9 +50,9 @@ CAN boards can be selected
|
|
|
|
The ''kvaser_pci'' board/device model is compatible with and has been tested with
|
|
|
|
''kvaser_pci'' driver included in mainline Linux kernel.
|
|
|
|
The tested setup was Linux 4.9 kernel on the host and guest side.
|
|
|
|
-Example for qemu-system-x86_64:
|
|
|
|
+Example for qemu-kvm (intel architecture):
|
|
|
|
|
|
|
|
- qemu-system-x86_64 -accel kvm -kernel /boot/vmlinuz-4.9.0-4-amd64 \
|
|
|
|
+ qemu-kvm -accel kvm -kernel /boot/vmlinuz-4.9.0-4-amd64 \
|
|
|
|
-initrd ramdisk.cpio \
|
|
|
|
-virtfs local,path=shareddir,security_model=none,mount_tag=shareddir \
|
|
|
|
-object can-bus,id=canbus0 \
|
|
|
|
@@ -60,9 +60,9 @@ Example for qemu-system-x86_64:
|
|
|
|
-device kvaser_pci,canbus=canbus0 \
|
|
|
|
-nographic -append "console=ttyS0"
|
|
|
|
|
|
|
|
-Example for qemu-system-arm:
|
|
|
|
+Example for qemu-kvm (arm architecture):
|
|
|
|
|
|
|
|
- qemu-system-arm -cpu arm1176 -m 256 -M versatilepb \
|
|
|
|
+ qemu-kvm -cpu arm1176 -m 256 -M versatilepb \
|
|
|
|
-kernel kernel-qemu-arm1176-versatilepb \
|
|
|
|
-hda rpi-wheezy-overlay \
|
|
|
|
-append "console=ttyAMA0 root=/dev/sda2 ro init=/sbin/init-overlay" \
|
|
|
|
diff --git a/docs/pr-manager.rst b/docs/pr-manager.rst
|
|
|
|
index 9b1de19..45cb8be 100644
|
|
|
|
--- a/docs/pr-manager.rst
|
|
|
|
+++ b/docs/pr-manager.rst
|
|
|
|
@@ -36,7 +36,7 @@ accepts the path to the helper program's Unix socket. For example,
|
|
|
|
the following command line defines a ``pr-manager-helper`` object and
|
|
|
|
attaches it to a SCSI passthrough device::
|
|
|
|
|
|
|
|
- $ qemu-system-x86_64
|
|
|
|
+ $ qemu-kvm
|
|
|
|
-device virtio-scsi \
|
|
|
|
-object pr-manager-helper,id=helper0,path=/var/run/qemu-pr-helper.sock
|
|
|
|
-drive if=none,id=hd,driver=raw,file.filename=/dev/sdb,file.pr-manager=helper0
|
|
|
|
@@ -44,7 +44,7 @@ attaches it to a SCSI passthrough device::
|
|
|
|
|
|
|
|
Alternatively, using ``-blockdev``::
|
|
|
|
|
|
|
|
- $ qemu-system-x86_64
|
|
|
|
+ $ qemu-kvm
|
|
|
|
-device virtio-scsi \
|
|
|
|
-object pr-manager-helper,id=helper0,path=/var/run/qemu-pr-helper.sock
|
|
|
|
-blockdev node-name=hd,driver=raw,file.driver=host_device,file.filename=/dev/sdb,file.pr-manager=helper0
|
|
|
|
diff --git a/docs/qemu-block-drivers.texi b/docs/qemu-block-drivers.texi
|
|
|
|
index 38e9f34..2e71ec9 100644
|
|
|
|
--- a/docs/qemu-block-drivers.texi
|
|
|
|
+++ b/docs/qemu-block-drivers.texi
|
|
|
|
@@ -405,7 +405,7 @@ QEMU can automatically create a virtual FAT disk image from a
|
|
|
|
directory tree. In order to use it, just type:
|
|
|
|
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 linux.img -hdb fat:/my_directory
|
|
|
|
+qemu-kvm linux.img -hdb fat:/my_directory
|
|
|
|
@end example
|
|
|
|
|
|
|
|
Then you access access to all the files in the @file{/my_directory}
|
|
|
|
@@ -415,14 +415,14 @@ them via SAMBA or NFS. The default access is @emph{read-only}.
|
|
|
|
Floppies can be emulated with the @code{:floppy:} option:
|
|
|
|
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 linux.img -fda fat:floppy:/my_directory
|
|
|
|
+qemu-kvm linux.img -fda fat:floppy:/my_directory
|
|
|
|
@end example
|
|
|
|
|
|
|
|
A read/write support is available for testing (beta stage) with the
|
|
|
|
@code{:rw:} option:
|
|
|
|
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 linux.img -fda fat:floppy:rw:/my_directory
|
|
|
|
+qemu-kvm linux.img -fda fat:floppy:rw:/my_directory
|
|
|
|
@end example
|
|
|
|
|
|
|
|
What you should @emph{never} do:
|
|
|
|
@@ -440,14 +440,14 @@ QEMU can access directly to block device exported using the Network Block Device
|
|
|
|
protocol.
|
|
|
|
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 linux.img -hdb nbd://my_nbd_server.mydomain.org:1024/
|
|
|
|
+qemu-kvm linux.img -hdb nbd://my_nbd_server.mydomain.org:1024/
|
|
|
|
@end example
|
|
|
|
|
|
|
|
If the NBD server is located on the same host, you can use an unix socket instead
|
|
|
|
of an inet socket:
|
|
|
|
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 linux.img -hdb nbd+unix://?socket=/tmp/my_socket
|
|
|
|
+qemu-kvm linux.img -hdb nbd+unix://?socket=/tmp/my_socket
|
|
|
|
@end example
|
|
|
|
|
|
|
|
In this case, the block device must be exported using qemu-nbd:
|
|
|
|
@@ -464,23 +464,23 @@ qemu-nbd --socket=/tmp/my_socket --share=2 my_disk.qcow2
|
|
|
|
@noindent
|
|
|
|
and then you can use it with two guests:
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 linux1.img -hdb nbd+unix://?socket=/tmp/my_socket
|
|
|
|
-qemu-system-i386 linux2.img -hdb nbd+unix://?socket=/tmp/my_socket
|
|
|
|
+qemu-kvm linux1.img -hdb nbd+unix://?socket=/tmp/my_socket
|
|
|
|
+qemu-kvm linux2.img -hdb nbd+unix://?socket=/tmp/my_socket
|
|
|
|
@end example
|
|
|
|
|
|
|
|
If the nbd-server uses named exports (supported since NBD 2.9.18, or with QEMU's
|
|
|
|
own embedded NBD server), you must specify an export name in the URI:
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 -cdrom nbd://localhost/debian-500-ppc-netinst
|
|
|
|
-qemu-system-i386 -cdrom nbd://localhost/openSUSE-11.1-ppc-netinst
|
|
|
|
+qemu-kvm -cdrom nbd://localhost/debian-500-ppc-netinst
|
|
|
|
+qemu-kvm -cdrom nbd://localhost/openSUSE-11.1-ppc-netinst
|
|
|
|
@end example
|
|
|
|
|
|
|
|
The URI syntax for NBD is supported since QEMU 1.3. An alternative syntax is
|
|
|
|
also available. Here are some example of the older syntax:
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 linux.img -hdb nbd:my_nbd_server.mydomain.org:1024
|
|
|
|
-qemu-system-i386 linux2.img -hdb nbd:unix:/tmp/my_socket
|
|
|
|
-qemu-system-i386 -cdrom nbd:localhost:10809:exportname=debian-500-ppc-netinst
|
|
|
|
+qemu-kvm linux.img -hdb nbd:my_nbd_server.mydomain.org:1024
|
|
|
|
+qemu-kvm linux2.img -hdb nbd:unix:/tmp/my_socket
|
|
|
|
+qemu-kvm -cdrom nbd:localhost:10809:exportname=debian-500-ppc-netinst
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@node disk_images_sheepdog
|
|
|
|
@@ -505,7 +505,7 @@ qemu-img convert @var{filename} sheepdog:///@var{image}
|
|
|
|
|
|
|
|
You can boot from the Sheepdog disk image with the command:
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 sheepdog:///@var{image}
|
|
|
|
+qemu-kvm sheepdog:///@var{image}
|
|
|
|
@end example
|
|
|
|
|
|
|
|
You can also create a snapshot of the Sheepdog image like qcow2.
|
|
|
|
@@ -517,7 +517,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
|
|
|
|
snapshot.
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 sheepdog:///@var{image}#@var{tag}
|
|
|
|
+qemu-kvm sheepdog:///@var{image}#@var{tag}
|
|
|
|
@end example
|
|
|
|
|
|
|
|
You can create a cloned image from the existing snapshot.
|
|
|
|
@@ -530,14 +530,14 @@ is its tag name.
|
|
|
|
You can use an unix socket instead of an inet socket:
|
|
|
|
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 sheepdog+unix:///@var{image}?socket=@var{path}
|
|
|
|
+qemu-kvm sheepdog+unix:///@var{image}?socket=@var{path}
|
|
|
|
@end example
|
|
|
|
|
|
|
|
If the Sheepdog daemon doesn't run on the local host, you need to
|
|
|
|
specify one of the Sheepdog servers to connect to.
|
|
|
|
@example
|
|
|
|
qemu-img create sheepdog://@var{hostname}:@var{port}/@var{image} @var{size}
|
|
|
|
-qemu-system-i386 sheepdog://@var{hostname}:@var{port}/@var{image}
|
|
|
|
+qemu-kvm sheepdog://@var{hostname}:@var{port}/@var{image}
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@node disk_images_iscsi
|
|
|
|
@@ -627,7 +627,7 @@ cat >iscsi.conf <<EOF
|
|
|
|
header-digest = "CRC32C"
|
|
|
|
EOF
|
|
|
|
|
|
|
|
-qemu-system-i386 -drive file=iscsi://127.0.0.1/iqn.qemu.test/1 \
|
|
|
|
+qemu-kvm -drive file=iscsi://127.0.0.1/iqn.qemu.test/1 \
|
|
|
|
-readconfig iscsi.conf
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@@ -646,7 +646,7 @@ tgtadm --lld iscsi --mode logicalunit --op new --tid 1 --lun 2 \
|
|
|
|
-b /IMAGES/cd.iso --device-type=cd
|
|
|
|
tgtadm --lld iscsi --op bind --mode target --tid 1 -I ALL
|
|
|
|
|
|
|
|
-qemu-system-i386 -iscsi initiator-name=iqn.qemu.test:my-initiator \
|
|
|
|
+qemu-kvm -iscsi initiator-name=iqn.qemu.test:my-initiator \
|
|
|
|
-boot d -drive file=iscsi://127.0.0.1/iqn.qemu.test/1 \
|
|
|
|
-cdrom iscsi://127.0.0.1/iqn.qemu.test/2
|
|
|
|
@end example
|
|
|
|
@@ -659,11 +659,11 @@ GlusterFS is a user space distributed file system.
|
|
|
|
You can boot from the GlusterFS disk image with the command:
|
|
|
|
@example
|
|
|
|
URI:
|
|
|
|
-qemu-system-x86_64 -drive file=gluster[+@var{type}]://[@var{host}[:@var{port}]]/@var{volume}/@var{path}
|
|
|
|
+qemu-kvm -drive file=gluster[+@var{type}]://[@var{host}[:@var{port}]]/@var{volume}/@var{path}
|
|
|
|
[?socket=...][,file.debug=9][,file.logfile=...]
|
|
|
|
|
|
|
|
JSON:
|
|
|
|
-qemu-system-x86_64 'json:@{"driver":"qcow2",
|
|
|
|
+qemu-kvm 'json:@{"driver":"qcow2",
|
|
|
|
"file":@{"driver":"gluster",
|
|
|
|
"volume":"testvol","path":"a.img","debug":9,"logfile":"...",
|
|
|
|
"server":[@{"type":"tcp","host":"...","port":"..."@},
|
|
|
|
@@ -711,22 +711,22 @@ qemu-img create gluster://@var{host}/@var{volume}/@var{path} @var{size}
|
|
|
|
|
|
|
|
Examples
|
|
|
|
@example
|
|
|
|
-qemu-system-x86_64 -drive file=gluster://1.2.3.4/testvol/a.img
|
|
|
|
-qemu-system-x86_64 -drive file=gluster+tcp://1.2.3.4/testvol/a.img
|
|
|
|
-qemu-system-x86_64 -drive file=gluster+tcp://1.2.3.4:24007/testvol/dir/a.img
|
|
|
|
-qemu-system-x86_64 -drive file=gluster+tcp://[1:2:3:4:5:6:7:8]/testvol/dir/a.img
|
|
|
|
-qemu-system-x86_64 -drive file=gluster+tcp://[1:2:3:4:5:6:7:8]:24007/testvol/dir/a.img
|
|
|
|
-qemu-system-x86_64 -drive file=gluster+tcp://server.domain.com:24007/testvol/dir/a.img
|
|
|
|
-qemu-system-x86_64 -drive file=gluster+unix:///testvol/dir/a.img?socket=/tmp/glusterd.socket
|
|
|
|
-qemu-system-x86_64 -drive file=gluster+rdma://1.2.3.4:24007/testvol/a.img
|
|
|
|
-qemu-system-x86_64 -drive file=gluster://1.2.3.4/testvol/a.img,file.debug=9,file.logfile=/var/log/qemu-gluster.log
|
|
|
|
-qemu-system-x86_64 'json:@{"driver":"qcow2",
|
|
|
|
+qemu-kvm -drive file=gluster://1.2.3.4/testvol/a.img
|
|
|
|
+qemu-kvm -drive file=gluster+tcp://1.2.3.4/testvol/a.img
|
|
|
|
+qemu-kvm -drive file=gluster+tcp://1.2.3.4:24007/testvol/dir/a.img
|
|
|
|
+qemu-kvm -drive file=gluster+tcp://[1:2:3:4:5:6:7:8]/testvol/dir/a.img
|
|
|
|
+qemu-kvm -drive file=gluster+tcp://[1:2:3:4:5:6:7:8]:24007/testvol/dir/a.img
|
|
|
|
+qemu-kvm -drive file=gluster+tcp://server.domain.com:24007/testvol/dir/a.img
|
|
|
|
+qemu-kvm -drive file=gluster+unix:///testvol/dir/a.img?socket=/tmp/glusterd.socket
|
|
|
|
+qemu-kvm -drive file=gluster+rdma://1.2.3.4:24007/testvol/a.img
|
|
|
|
+qemu-kvm -drive file=gluster://1.2.3.4/testvol/a.img,file.debug=9,file.logfile=/var/log/qemu-gluster.log
|
|
|
|
+qemu-kvm 'json:@{"driver":"qcow2",
|
|
|
|
"file":@{"driver":"gluster",
|
|
|
|
"volume":"testvol","path":"a.img",
|
|
|
|
"debug":9,"logfile":"/var/log/qemu-gluster.log",
|
|
|
|
"server":[@{"type":"tcp","host":"1.2.3.4","port":24007@},
|
|
|
|
@{"type":"unix","socket":"/var/run/glusterd.socket"@}]@}@}'
|
|
|
|
-qemu-system-x86_64 -drive driver=qcow2,file.driver=gluster,file.volume=testvol,file.path=/path/a.img,
|
|
|
|
+qemu-kvm -drive driver=qcow2,file.driver=gluster,file.volume=testvol,file.path=/path/a.img,
|
|
|
|
file.debug=9,file.logfile=/var/log/qemu-gluster.log,
|
|
|
|
file.server.0.type=tcp,file.server.0.host=1.2.3.4,file.server.0.port=24007,
|
|
|
|
file.server.1.type=unix,file.server.1.socket=/var/run/glusterd.socket
|
|
|
|
@@ -739,13 +739,13 @@ You can access disk images located on a remote ssh server
|
|
|
|
by using the ssh protocol:
|
|
|
|
|
|
|
|
@example
|
|
|
|
-qemu-system-x86_64 -drive file=ssh://[@var{user}@@]@var{server}[:@var{port}]/@var{path}[?host_key_check=@var{host_key_check}]
|
|
|
|
+qemu-kvm -drive file=ssh://[@var{user}@@]@var{server}[:@var{port}]/@var{path}[?host_key_check=@var{host_key_check}]
|
|
|
|
@end example
|
|
|
|
|
|
|
|
Alternative syntax using properties:
|
|
|
|
|
|
|
|
@example
|
|
|
|
-qemu-system-x86_64 -drive file.driver=ssh[,file.user=@var{user}],file.host=@var{server}[,file.port=@var{port}],file.path=@var{path}[,file.host_key_check=@var{host_key_check}]
|
|
|
|
+qemu-kvm -drive file.driver=ssh[,file.user=@var{user}],file.host=@var{server}[,file.port=@var{port}],file.path=@var{path}[,file.host_key_check=@var{host_key_check}]
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@var{ssh} is the protocol.
|
|
|
|
@@ -808,13 +808,13 @@ driver. For example:
|
|
|
|
# echo 0000:06:0d.0 > /sys/bus/pci/devices/0000:06:0d.0/driver/unbind
|
|
|
|
# echo 1102 0002 > /sys/bus/pci/drivers/vfio-pci/new_id
|
|
|
|
|
|
|
|
-# qemu-system-x86_64 -drive file=nvme://@var{host}:@var{bus}:@var{slot}.@var{func}/@var{namespace}
|
|
|
|
+# qemu-kvm -drive file=nvme://@var{host}:@var{bus}:@var{slot}.@var{func}/@var{namespace}
|
|
|
|
@end example
|
|
|
|
|
|
|
|
Alternative syntax using properties:
|
|
|
|
|
|
|
|
@example
|
|
|
|
-qemu-system-x86_64 -drive file.driver=nvme,file.device=@var{host}:@var{bus}:@var{slot}.@var{func},file.namespace=@var{namespace}
|
|
|
|
+qemu-kvm -drive file.driver=nvme,file.device=@var{host}:@var{bus}:@var{slot}.@var{func},file.namespace=@var{namespace}
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@var{host}:@var{bus}:@var{slot}.@var{func} is the NVMe controller's PCI device
|
2018-11-29 12:09:34 +00:00
|
|
|
diff --git a/docs/qemu-cpu-models.texi b/docs/qemu-cpu-models.texi
|
|
|
|
index 1935f98..93672de 100644
|
|
|
|
--- a/docs/qemu-cpu-models.texi
|
|
|
|
+++ b/docs/qemu-cpu-models.texi
|
|
|
|
@@ -387,25 +387,25 @@ CPU models / features in QEMU and libvirt
|
|
|
|
@item Host passthrough
|
|
|
|
|
|
|
|
@example
|
|
|
|
- $ qemu-system-x86_64 -cpu host
|
|
|
|
+ $ qemu-kvm -cpu host
|
|
|
|
@end example
|
|
|
|
|
|
|
|
With feature customization:
|
|
|
|
|
|
|
|
@example
|
|
|
|
- $ qemu-system-x86_64 -cpu host,-vmx,...
|
|
|
|
+ $ qemu-kvm -cpu host,-vmx,...
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@item Named CPU models
|
|
|
|
|
|
|
|
@example
|
|
|
|
- $ qemu-system-x86_64 -cpu Westmere
|
|
|
|
+ $ qemu-kvm -cpu Westmere
|
|
|
|
@end example
|
|
|
|
|
|
|
|
With feature customization:
|
|
|
|
|
|
|
|
@example
|
|
|
|
- $ qemu-system-x86_64 -cpu Westmere,+pcid,...
|
|
|
|
+ $ qemu-kvm -cpu Westmere,+pcid,...
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@end table
|
2018-10-14 17:48:54 +00:00
|
|
|
diff --git a/docs/replay.txt b/docs/replay.txt
|
2018-11-29 12:09:34 +00:00
|
|
|
index 3497585..8d67ea7 100644
|
2018-10-14 17:48:54 +00:00
|
|
|
--- a/docs/replay.txt
|
|
|
|
+++ b/docs/replay.txt
|
|
|
|
@@ -25,7 +25,7 @@ Deterministic replay has the following features:
|
|
|
|
|
|
|
|
Usage of the record/replay:
|
|
|
|
* First, record the execution with the following command line:
|
|
|
|
- qemu-system-i386 \
|
|
|
|
+ qemu-kvm \
|
|
|
|
-icount shift=7,rr=record,rrfile=replay.bin \
|
|
|
|
-drive file=disk.qcow2,if=none,id=img-direct \
|
|
|
|
-drive driver=blkreplay,if=none,image=img-direct,id=img-blkreplay \
|
|
|
|
@@ -33,7 +33,7 @@ Usage of the record/replay:
|
|
|
|
-netdev user,id=net1 -device rtl8139,netdev=net1 \
|
|
|
|
-object filter-replay,id=replay,netdev=net1
|
|
|
|
* After recording, you can replay it by using another command line:
|
|
|
|
- qemu-system-i386 \
|
|
|
|
+ qemu-kvm \
|
|
|
|
-icount shift=7,rr=replay,rrfile=replay.bin \
|
|
|
|
-drive file=disk.qcow2,if=none,id=img-direct \
|
|
|
|
-drive driver=blkreplay,if=none,image=img-direct,id=img-blkreplay \
|
|
|
|
diff --git a/docs/specs/tpm.txt b/docs/specs/tpm.txt
|
2018-11-29 12:09:34 +00:00
|
|
|
index 1af82bb..b2741ac 100644
|
2018-10-14 17:48:54 +00:00
|
|
|
--- a/docs/specs/tpm.txt
|
|
|
|
+++ b/docs/specs/tpm.txt
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -113,7 +113,7 @@ QEMU files related to the TPM passthrough device:
|
2018-10-14 17:48:54 +00:00
|
|
|
Command line to start QEMU with the TPM passthrough device using the host's
|
|
|
|
hardware TPM /dev/tpm0:
|
|
|
|
|
|
|
|
-qemu-system-x86_64 -display sdl -accel kvm \
|
|
|
|
+qemu-kvm -display vnc -accel kvm \
|
|
|
|
-m 1024 -boot d -bios bios-256k.bin -boot menu=on \
|
|
|
|
-tpmdev passthrough,id=tpm0,path=/dev/tpm0 \
|
|
|
|
-device tpm-tis,tpmdev=tpm0 test.img
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -179,7 +179,7 @@ swtpm socket --tpmstate dir=/tmp/mytpm1 \
|
2018-10-14 17:48:54 +00:00
|
|
|
Command line to start QEMU with the TPM emulator device communicating with
|
|
|
|
the swtpm:
|
|
|
|
|
|
|
|
-qemu-system-x86_64 -display sdl -accel kvm \
|
|
|
|
+qemu-kvm -display vnc -accel kvm \
|
|
|
|
-m 1024 -boot d -bios bios-256k.bin -boot menu=on \
|
|
|
|
-chardev socket,id=chrtpm,path=/tmp/mytpm1/swtpm-sock \
|
|
|
|
-tpmdev emulator,id=tpm0,chardev=chrtpm \
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -237,7 +237,7 @@ swtpm socket --tpmstate dir=/tmp/mytpm1 \
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
In a 2nd terminal start the VM:
|
|
|
|
|
|
|
|
-qemu-system-x86_64 -display sdl -accel kvm \
|
|
|
|
+qemu-kvm -display sdl -accel kvm \
|
|
|
|
-m 1024 -boot d -bios bios-256k.bin -boot menu=on \
|
|
|
|
-chardev socket,id=chrtpm,path=/tmp/mytpm1/swtpm-sock \
|
|
|
|
-tpmdev emulator,id=tpm0,chardev=chrtpm \
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -270,7 +270,7 @@ swtpm socket --tpmstate dir=/tmp/mytpm1 \
|
2018-10-14 17:48:54 +00:00
|
|
|
In the 2nd terminal restore the state of the VM using the additional
|
|
|
|
'-incoming' option.
|
|
|
|
|
|
|
|
-qemu-system-x86_64 -display sdl -accel kvm \
|
|
|
|
+qemu-kvm -display sdl -accel kvm \
|
|
|
|
-m 1024 -boot d -bios bios-256k.bin -boot menu=on \
|
|
|
|
-chardev socket,id=chrtpm,path=/tmp/mytpm1/swtpm-sock \
|
|
|
|
-tpmdev emulator,id=tpm0,chardev=chrtpm \
|
|
|
|
diff --git a/qemu-doc.texi b/qemu-doc.texi
|
2018-11-29 12:09:34 +00:00
|
|
|
index f7ad1df..0e4b34a 100644
|
2018-10-14 17:48:54 +00:00
|
|
|
--- a/qemu-doc.texi
|
|
|
|
+++ b/qemu-doc.texi
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -205,12 +205,12 @@ Note that, by default, GUS shares IRQ(7) with parallel ports and so
|
2018-10-14 17:48:54 +00:00
|
|
|
QEMU must be told to not have parallel ports to have working GUS.
|
|
|
|
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 dos.img -soundhw gus -parallel none
|
|
|
|
+qemu-kvm dos.img -soundhw gus -parallel none
|
|
|
|
@end example
|
|
|
|
|
|
|
|
Alternatively:
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 dos.img -device gus,irq=5
|
|
|
|
+qemu-kvm dos.img -device gus,irq=5
|
|
|
|
@end example
|
|
|
|
|
|
|
|
Or some other unclaimed IRQ.
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -226,7 +226,7 @@ CS4231A is the chip used in Windows Sound System and GUSMAX products
|
2018-10-14 17:48:54 +00:00
|
|
|
Download and uncompress the linux image (@file{linux.img}) and type:
|
|
|
|
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 linux.img
|
|
|
|
+qemu-kvm linux.img
|
|
|
|
@end example
|
|
|
|
|
|
|
|
Linux should boot and give you a prompt.
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -236,7 +236,7 @@ Linux should boot and give you a prompt.
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
@example
|
|
|
|
@c man begin SYNOPSIS
|
|
|
|
-@command{qemu-system-i386} [@var{options}] [@var{disk_image}]
|
|
|
|
+@command{qemu-kvm} [@var{options}] [@var{disk_image}]
|
|
|
|
@c man end
|
|
|
|
@end example
|
|
|
|
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -276,21 +276,21 @@ is specified in seconds. The default is 0 which means no timeout. Libiscsi
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
Example (without authentication):
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 -iscsi initiator-name=iqn.2001-04.com.example:my-initiator \
|
|
|
|
+qemu-kvm -iscsi initiator-name=iqn.2001-04.com.example:my-initiator \
|
|
|
|
-cdrom iscsi://192.0.2.1/iqn.2001-04.com.example/2 \
|
|
|
|
-drive file=iscsi://192.0.2.1/iqn.2001-04.com.example/1
|
|
|
|
@end example
|
|
|
|
|
|
|
|
Example (CHAP username/password via URL):
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 -drive file=iscsi://user%password@@192.0.2.1/iqn.2001-04.com.example/1
|
|
|
|
+qemu-kvm -drive file=iscsi://user%password@@192.0.2.1/iqn.2001-04.com.example/1
|
|
|
|
@end example
|
|
|
|
|
|
|
|
Example (CHAP username/password via environment variables):
|
|
|
|
@example
|
|
|
|
LIBISCSI_CHAP_USERNAME="user" \
|
|
|
|
LIBISCSI_CHAP_PASSWORD="password" \
|
|
|
|
-qemu-system-i386 -drive file=iscsi://192.0.2.1/iqn.2001-04.com.example/1
|
|
|
|
+qemu-kvm -drive file=iscsi://192.0.2.1/iqn.2001-04.com.example/1
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@item NBD
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -305,12 +305,12 @@ Syntax for specifying a NBD device using Unix Domain Sockets
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
Example for TCP
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 --drive file=nbd:192.0.2.1:30000
|
|
|
|
+qemu-kvm --drive file=nbd:192.0.2.1:30000
|
|
|
|
@end example
|
|
|
|
|
|
|
|
Example for Unix Domain Sockets
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 --drive file=nbd:unix:/tmp/nbd-socket
|
|
|
|
+qemu-kvm --drive file=nbd:unix:/tmp/nbd-socket
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@item SSH
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -318,8 +318,8 @@ QEMU supports SSH (Secure Shell) access to remote disks.
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
Examples:
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 -drive file=ssh://user@@host/path/to/disk.img
|
|
|
|
-qemu-system-i386 -drive file.driver=ssh,file.user=user,file.host=host,file.port=22,file.path=/path/to/disk.img
|
|
|
|
+qemu-kvm -drive file=ssh://user@@host/path/to/disk.img
|
|
|
|
+qemu-kvm -drive file.driver=ssh,file.user=user,file.host=host,file.port=22,file.path=/path/to/disk.img
|
|
|
|
@end example
|
|
|
|
|
|
|
|
Currently authentication must be done using ssh-agent. Other
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -337,7 +337,7 @@ sheepdog[+tcp|+unix]://[host:port]/vdiname[?socket=path][#snapid|#tag]
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
Example
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 --drive file=sheepdog://192.0.2.1:30000/MyVirtualMachine
|
|
|
|
+qemu-kvm --drive file=sheepdog://192.0.2.1:30000/MyVirtualMachine
|
|
|
|
@end example
|
|
|
|
|
|
|
|
See also @url{https://sheepdog.github.io/sheepdog/}.
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -363,17 +363,17 @@ JSON:
|
2018-10-14 17:48:54 +00:00
|
|
|
Example
|
|
|
|
@example
|
|
|
|
URI:
|
|
|
|
-qemu-system-x86_64 --drive file=gluster://192.0.2.1/testvol/a.img,
|
|
|
|
+qemu-kvm --drive file=gluster://192.0.2.1/testvol/a.img,
|
|
|
|
@ file.debug=9,file.logfile=/var/log/qemu-gluster.log
|
|
|
|
|
|
|
|
JSON:
|
|
|
|
-qemu-system-x86_64 'json:@{"driver":"qcow2",
|
|
|
|
+qemu-kvm 'json:@{"driver":"qcow2",
|
|
|
|
@ "file":@{"driver":"gluster",
|
|
|
|
@ "volume":"testvol","path":"a.img",
|
|
|
|
@ "debug":9,"logfile":"/var/log/qemu-gluster.log",
|
|
|
|
@ "server":[@{"type":"tcp","host":"1.2.3.4","port":24007@},
|
|
|
|
@ @{"type":"unix","socket":"/var/run/glusterd.socket"@}]@}@}'
|
|
|
|
-qemu-system-x86_64 -drive driver=qcow2,file.driver=gluster,file.volume=testvol,file.path=/path/a.img,
|
|
|
|
+qemu-kvm -drive driver=qcow2,file.driver=gluster,file.volume=testvol,file.path=/path/a.img,
|
|
|
|
@ file.debug=9,file.logfile=/var/log/qemu-gluster.log,
|
|
|
|
@ file.server.0.type=tcp,file.server.0.host=1.2.3.4,file.server.0.port=24007,
|
|
|
|
@ file.server.1.type=unix,file.server.1.socket=/var/run/glusterd.socket
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -438,9 +438,9 @@ of <protocol>.
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
Example: boot from a remote Fedora 20 live ISO image
|
|
|
|
@example
|
|
|
|
-qemu-system-x86_64 --drive media=cdrom,file=http://dl.fedoraproject.org/pub/fedora/linux/releases/20/Live/x86_64/Fedora-Live-Desktop-x86_64-20-1.iso,readonly
|
|
|
|
+qemu-kvm --drive media=cdrom,file=http://dl.fedoraproject.org/pub/fedora/linux/releases/20/Live/x86_64/Fedora-Live-Desktop-x86_64-20-1.iso,readonly
|
|
|
|
|
|
|
|
-qemu-system-x86_64 --drive media=cdrom,file.driver=http,file.url=http://dl.fedoraproject.org/pub/fedora/linux/releases/20/Live/x86_64/Fedora-Live-Desktop-x86_64-20-1.iso,readonly
|
|
|
|
+qemu-kvm --drive media=cdrom,file.driver=http,file.url=http://dl.fedoraproject.org/pub/fedora/linux/releases/20/Live/x86_64/Fedora-Live-Desktop-x86_64-20-1.iso,readonly
|
|
|
|
@end example
|
|
|
|
|
|
|
|
Example: boot from a remote Fedora 20 cloud image using a local overlay for
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -448,7 +448,7 @@ writes, copy-on-read, and a readahead of 64k
|
2018-10-14 17:48:54 +00:00
|
|
|
@example
|
|
|
|
qemu-img create -f qcow2 -o backing_file='json:@{"file.driver":"http",, "file.url":"https://dl.fedoraproject.org/pub/fedora/linux/releases/20/Images/x86_64/Fedora-x86_64-20-20131211.1-sda.qcow2",, "file.readahead":"64k"@}' /tmp/Fedora-x86_64-20-20131211.1-sda.qcow2
|
|
|
|
|
|
|
|
-qemu-system-x86_64 -drive file=/tmp/Fedora-x86_64-20-20131211.1-sda.qcow2,copy-on-read=on
|
|
|
|
+qemu-kvm -drive file=/tmp/Fedora-x86_64-20-20131211.1-sda.qcow2,copy-on-read=on
|
|
|
|
@end example
|
|
|
|
|
|
|
|
Example: boot from an image stored on a VMware vSphere server with a self-signed
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -457,7 +457,7 @@ of 10 seconds.
|
2018-10-14 17:48:54 +00:00
|
|
|
@example
|
|
|
|
qemu-img create -f qcow2 -o backing_file='json:@{"file.driver":"https",, "file.url":"https://user:password@@vsphere.example.com/folder/test/test-flat.vmdk?dcPath=Datacenter&dsName=datastore1",, "file.sslverify":"off",, "file.readahead":"64k",, "file.timeout":10@}' /tmp/test.qcow2
|
|
|
|
|
|
|
|
-qemu-system-x86_64 -drive file=/tmp/test.qcow2
|
|
|
|
+qemu-kvm -drive file=/tmp/test.qcow2
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@end table
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -824,7 +824,7 @@ On Linux hosts, a shared memory device is available. The basic syntax
|
2018-10-14 17:48:54 +00:00
|
|
|
is:
|
|
|
|
|
|
|
|
@example
|
|
|
|
-qemu-system-x86_64 -device ivshmem-plain,memdev=@var{hostmem}
|
|
|
|
+qemu-kvm -device ivshmem-plain,memdev=@var{hostmem}
|
|
|
|
@end example
|
|
|
|
|
|
|
|
where @var{hostmem} names a host memory backend. For a POSIX shared
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -845,7 +845,7 @@ memory server is:
|
2018-10-14 17:48:54 +00:00
|
|
|
ivshmem-server -p @var{pidfile} -S @var{path} -m @var{shm-name} -l @var{shm-size} -n @var{vectors}
|
|
|
|
|
|
|
|
# Then start your qemu instances with matching arguments
|
|
|
|
-qemu-system-x86_64 -device ivshmem-doorbell,vectors=@var{vectors},chardev=@var{id}
|
|
|
|
+qemu-kvm -device ivshmem-doorbell,vectors=@var{vectors},chardev=@var{id}
|
|
|
|
-chardev socket,path=@var{path},id=@var{id}
|
|
|
|
@end example
|
|
|
|
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -870,7 +870,7 @@ Instead of specifying the <shm size> using POSIX shm, you may specify
|
2018-10-14 17:48:54 +00:00
|
|
|
a memory backend that has hugepage support:
|
|
|
|
|
|
|
|
@example
|
|
|
|
-qemu-system-x86_64 -object memory-backend-file,size=1G,mem-path=/dev/hugepages/my-shmem-file,share,id=mb1
|
|
|
|
+qemu-kvm -object memory-backend-file,size=1G,mem-path=/dev/hugepages/my-shmem-file,share,id=mb1
|
|
|
|
-device ivshmem-plain,memdev=mb1
|
|
|
|
@end example
|
|
|
|
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -886,7 +886,7 @@ kernel testing.
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
The syntax is:
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 -kernel arch/i386/boot/bzImage -hda root-2.4.20.img -append "root=/dev/hda"
|
|
|
|
+qemu-kvm -kernel arch/i386/boot/bzImage -hda root-2.4.20.img -append "root=/dev/hda"
|
|
|
|
@end example
|
|
|
|
|
|
|
|
Use @option{-kernel} to provide the Linux kernel image and
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -901,7 +901,7 @@ If you do not need graphical output, you can disable it and redirect
|
2018-10-14 17:48:54 +00:00
|
|
|
the virtual serial port and the QEMU monitor to the console with the
|
|
|
|
@option{-nographic} option. The typical command line is:
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 -kernel arch/i386/boot/bzImage -hda root-2.4.20.img \
|
|
|
|
+qemu-kvm -kernel arch/i386/boot/bzImage -hda root-2.4.20.img \
|
|
|
|
-append "root=/dev/hda console=ttyS0" -nographic
|
|
|
|
@end example
|
|
|
|
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -967,7 +967,7 @@ Network adapter that supports CDC ethernet and RNDIS protocols. @var{id}
|
2018-10-14 17:48:54 +00:00
|
|
|
specifies a netdev defined with @code{-netdev @dots{},id=@var{id}}.
|
|
|
|
For instance, user-mode networking can be used with
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 [...] -netdev user,id=net0 -device usb-net,netdev=net0
|
|
|
|
+qemu-kvm [...] -netdev user,id=net0 -device usb-net,netdev=net0
|
|
|
|
@end example
|
|
|
|
@item usb-ccid
|
|
|
|
Smartcard reader device
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -986,7 +986,7 @@ no type is given, the HCI logic corresponds to @code{-bt hci,vlan=0}.
|
2018-10-14 17:48:54 +00:00
|
|
|
This USB device implements the USB Transport Layer of HCI. Example
|
|
|
|
usage:
|
|
|
|
@example
|
|
|
|
-@command{qemu-system-i386} [...@var{OPTIONS}...] @option{-usbdevice} bt:hci,vlan=3 @option{-bt} device:keyboard,vlan=3
|
|
|
|
+@command{qemu-kvm} [...@var{OPTIONS}...] @option{-usbdevice} bt:hci,vlan=3 @option{-bt} device:keyboard,vlan=3
|
|
|
|
@end example
|
|
|
|
@end table
|
|
|
|
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -1063,7 +1063,7 @@ For this setup it is recommended to restrict it to listen on a UNIX domain
|
2018-10-14 17:48:54 +00:00
|
|
|
socket only. For example
|
|
|
|
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 [...OPTIONS...] -vnc unix:/home/joebloggs/.qemu-myvm-vnc
|
|
|
|
+qemu-kvm [...OPTIONS...] -vnc unix:/home/joebloggs/.qemu-myvm-vnc
|
|
|
|
@end example
|
|
|
|
|
|
|
|
This ensures that only users on local box with read/write access to that
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -1086,7 +1086,7 @@ is running the password is set with the monitor. Until the monitor is used to
|
2018-10-14 17:48:54 +00:00
|
|
|
set the password all clients will be rejected.
|
|
|
|
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 [...OPTIONS...] -vnc :1,password -monitor stdio
|
|
|
|
+qemu-kvm [...OPTIONS...] -vnc :1,password -monitor stdio
|
|
|
|
(qemu) change vnc password
|
|
|
|
Password: ********
|
|
|
|
(qemu)
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -1103,7 +1103,7 @@ support provides a secure session, but no authentication. This allows any
|
2018-10-14 17:48:54 +00:00
|
|
|
client to connect, and provides an encrypted session.
|
|
|
|
|
|
|
|
@example
|
2018-11-29 12:09:34 +00:00
|
|
|
-qemu-system-i386 [...OPTIONS...] \
|
|
|
|
+qemu-kvm [...OPTIONS...] \
|
|
|
|
-object tls-creds-x509,id=tls0,dir=/etc/pki/qemu,endpoint=server,verify-peer=no \
|
|
|
|
-vnc :1,tls-creds=tls0 -monitor stdio
|
2018-10-14 17:48:54 +00:00
|
|
|
@end example
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -1125,7 +1125,7 @@ same syntax as previously, but with @code{verify-peer} set to @code{yes}
|
|
|
|
instead.
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
@example
|
2018-11-29 12:09:34 +00:00
|
|
|
-qemu-system-i386 [...OPTIONS...] \
|
|
|
|
+qemu-kvm [...OPTIONS...] \
|
|
|
|
-object tls-creds-x509,id=tls0,dir=/etc/pki/qemu,endpoint=server,verify-peer=yes \
|
|
|
|
-vnc :1,tls-creds=tls0 -monitor stdio
|
2018-10-14 17:48:54 +00:00
|
|
|
@end example
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -1138,7 +1138,7 @@ Finally, the previous method can be combined with VNC password authentication
|
2018-10-14 17:48:54 +00:00
|
|
|
to provide two layers of authentication for clients.
|
|
|
|
|
|
|
|
@example
|
2018-11-29 12:09:34 +00:00
|
|
|
-qemu-system-i386 [...OPTIONS...] \
|
|
|
|
+qemu-kvm [...OPTIONS...] \
|
|
|
|
-object tls-creds-x509,id=tls0,dir=/etc/pki/qemu,endpoint=server,verify-peer=yes \
|
|
|
|
-vnc :1,tls-creds=tls0,password -monitor stdio
|
2018-10-14 17:48:54 +00:00
|
|
|
(qemu) change vnc password
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -1163,7 +1163,7 @@ used for authentication, but assuming use of one supporting SSF,
|
2018-10-14 17:48:54 +00:00
|
|
|
then QEMU can be launched with:
|
|
|
|
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 [...OPTIONS...] -vnc :1,sasl -monitor stdio
|
|
|
|
+qemu-kvm [...OPTIONS...] -vnc :1,sasl -monitor stdio
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@node vnc_sec_certificate_sasl
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -1177,7 +1177,7 @@ credentials. This can be enabled, by combining the 'sasl' option
|
2018-10-14 17:48:54 +00:00
|
|
|
with the aforementioned TLS + x509 options:
|
|
|
|
|
|
|
|
@example
|
2018-11-29 12:09:34 +00:00
|
|
|
-qemu-system-i386 [...OPTIONS...] \
|
|
|
|
+qemu-kvm [...OPTIONS...] \
|
|
|
|
-object tls-creds-x509,id=tls0,dir=/etc/pki/qemu,endpoint=server,verify-peer=yes \
|
|
|
|
-vnc :1,tls-creds=tls0,sasl -monitor stdio
|
2018-10-14 17:48:54 +00:00
|
|
|
@end example
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -1572,7 +1572,7 @@ QEMU has a primitive support to work with gdb, so that you can do
|
2018-10-14 17:48:54 +00:00
|
|
|
In order to use gdb, launch QEMU with the '-s' option. It will wait for a
|
|
|
|
gdb connection:
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 -s -kernel arch/i386/boot/bzImage -hda root-2.4.20.img \
|
|
|
|
+qemu-kvm -s -kernel arch/i386/boot/bzImage -hda root-2.4.20.img \
|
|
|
|
-append "root=/dev/hda"
|
|
|
|
Connected to host network interface: tun0
|
|
|
|
Waiting gdb connection on port 1234
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -1818,7 +1818,7 @@ Set the initial VGA graphic mode. The default is 800x600x32.
|
2018-10-14 17:48:54 +00:00
|
|
|
Set OpenBIOS variables in NVRAM, for example:
|
|
|
|
|
|
|
|
@example
|
|
|
|
-qemu-system-ppc -prom-env 'auto-boot?=false' \
|
|
|
|
+qemu-kvm -prom-env 'auto-boot?=false' \
|
|
|
|
-prom-env 'boot-device=hd:2,\yaboot' \
|
|
|
|
-prom-env 'boot-args=conf=hd:2,\yaboot.conf'
|
|
|
|
@end example
|
|
|
|
diff --git a/qemu-options.hx b/qemu-options.hx
|
2018-11-29 12:09:34 +00:00
|
|
|
index cd2b25b..a65c63b 100644
|
2018-10-14 17:48:54 +00:00
|
|
|
--- a/qemu-options.hx
|
|
|
|
+++ b/qemu-options.hx
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -253,7 +253,7 @@ This option defines a free-form string that can be used to describe @var{fd}.
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
You can open an image using pre-opened file descriptors from an fd set:
|
|
|
|
@example
|
|
|
|
-qemu-system-i386
|
|
|
|
+qemu-kvm
|
|
|
|
-add-fd fd=3,set=2,opaque="rdwr:/path/to/file"
|
|
|
|
-add-fd fd=4,set=2,opaque="rdonly:/path/to/file"
|
|
|
|
-drive file=/dev/fdset/2,index=0,media=disk
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -282,7 +282,7 @@ STEXI
|
2018-10-14 17:48:54 +00:00
|
|
|
Set default value of @var{driver}'s property @var{prop} to @var{value}, e.g.:
|
|
|
|
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 -global ide-hd.physical_block_size=4096 disk-image.img
|
|
|
|
+qemu-kvm -global ide-hd.physical_block_size=4096 disk-image.img
|
|
|
|
@end example
|
|
|
|
|
|
|
|
In particular, you can use this to set driver properties for devices which are
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -336,11 +336,11 @@ bootindex options. The default is non-strict boot.
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
@example
|
|
|
|
# try to boot from network first, then from hard disk
|
|
|
|
-qemu-system-i386 -boot order=nc
|
|
|
|
+qemu-kvm -boot order=nc
|
|
|
|
# boot from CD-ROM first, switch back to default order after reboot
|
|
|
|
-qemu-system-i386 -boot once=d
|
|
|
|
+qemu-kvm -boot once=d
|
|
|
|
# boot with a splash picture for 5 seconds.
|
|
|
|
-qemu-system-i386 -boot menu=on,splash=/root/boot.bmp,splash-time=5000
|
|
|
|
+qemu-kvm -boot menu=on,splash=/root/boot.bmp,splash-time=5000
|
|
|
|
@end example
|
|
|
|
|
|
|
|
Note: The legacy format '-boot @var{drives}' is still supported but its
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -369,7 +369,7 @@ For example, the following command-line sets the guest startup RAM size to
|
2018-10-14 17:48:54 +00:00
|
|
|
memory the guest can reach to 4GB:
|
|
|
|
|
|
|
|
@example
|
|
|
|
-qemu-system-x86_64 -m 1G,slots=3,maxmem=4G
|
|
|
|
+qemu-kvm -m 1G,slots=3,maxmem=4G
|
|
|
|
@end example
|
|
|
|
|
|
|
|
If @var{slots} and @var{maxmem} are not specified, memory hotplug won't
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -438,12 +438,12 @@ Enable audio and selected sound hardware. Use 'help' to print all
|
2018-10-14 17:48:54 +00:00
|
|
|
available sound hardware.
|
|
|
|
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 -soundhw sb16,adlib disk.img
|
|
|
|
-qemu-system-i386 -soundhw es1370 disk.img
|
|
|
|
-qemu-system-i386 -soundhw ac97 disk.img
|
|
|
|
-qemu-system-i386 -soundhw hda disk.img
|
|
|
|
-qemu-system-i386 -soundhw all disk.img
|
|
|
|
-qemu-system-i386 -soundhw help
|
|
|
|
+qemu-kvm -soundhw sb16,adlib disk.img
|
|
|
|
+qemu-kvm -soundhw es1370 disk.img
|
|
|
|
+qemu-kvm -soundhw ac97 disk.img
|
|
|
|
+qemu-kvm -soundhw hda disk.img
|
|
|
|
+qemu-kvm -soundhw all disk.img
|
|
|
|
+qemu-kvm -soundhw help
|
|
|
|
@end example
|
|
|
|
|
|
|
|
Note that Linux's i810_audio OSS kernel (for AC97) module might
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -918,21 +918,21 @@ is off.
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
Instead of @option{-cdrom} you can use:
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 -drive file=file,index=2,media=cdrom
|
|
|
|
+qemu-kvm -drive file=file,index=2,media=cdrom
|
|
|
|
@end example
|
|
|
|
|
|
|
|
Instead of @option{-hda}, @option{-hdb}, @option{-hdc}, @option{-hdd}, you can
|
|
|
|
use:
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 -drive file=file,index=0,media=disk
|
|
|
|
-qemu-system-i386 -drive file=file,index=1,media=disk
|
|
|
|
-qemu-system-i386 -drive file=file,index=2,media=disk
|
|
|
|
-qemu-system-i386 -drive file=file,index=3,media=disk
|
|
|
|
+qemu-kvm -drive file=file,index=0,media=disk
|
|
|
|
+qemu-kvm -drive file=file,index=1,media=disk
|
|
|
|
+qemu-kvm -drive file=file,index=2,media=disk
|
|
|
|
+qemu-kvm -drive file=file,index=3,media=disk
|
|
|
|
@end example
|
|
|
|
|
|
|
|
You can open an image using pre-opened file descriptors from an fd set:
|
|
|
|
@example
|
|
|
|
-qemu-system-i386
|
|
|
|
+qemu-kvm
|
|
|
|
-add-fd fd=3,set=2,opaque="rdwr:/path/to/file"
|
|
|
|
-add-fd fd=4,set=2,opaque="rdonly:/path/to/file"
|
|
|
|
-drive file=/dev/fdset/2,index=0,media=disk
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -940,28 +940,28 @@ qemu-system-i386
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
You can connect a CDROM to the slave of ide0:
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 -drive file=file,if=ide,index=1,media=cdrom
|
|
|
|
+qemu-kvm -drive file=file,if=ide,index=1,media=cdrom
|
|
|
|
@end example
|
|
|
|
|
|
|
|
If you don't specify the "file=" argument, you define an empty drive:
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 -drive if=ide,index=1,media=cdrom
|
|
|
|
+qemu-kvm -drive if=ide,index=1,media=cdrom
|
|
|
|
@end example
|
|
|
|
|
|
|
|
Instead of @option{-fda}, @option{-fdb}, you can use:
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 -drive file=file,index=0,if=floppy
|
|
|
|
-qemu-system-i386 -drive file=file,index=1,if=floppy
|
|
|
|
+qemu-kvm -drive file=file,index=0,if=floppy
|
|
|
|
+qemu-kvm -drive file=file,index=1,if=floppy
|
|
|
|
@end example
|
|
|
|
|
|
|
|
By default, @var{interface} is "ide" and @var{index} is automatically
|
|
|
|
incremented:
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 -drive file=a -drive file=b"
|
|
|
|
+qemu-kvm -drive file=a -drive file=b"
|
|
|
|
@end example
|
|
|
|
is interpreted like:
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 -hda a -hdb b
|
|
|
|
+qemu-kvm -hda a -hdb b
|
|
|
|
@end example
|
|
|
|
ETEXI
|
|
|
|
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -1975,8 +1975,8 @@ The following two example do exactly the same, to show how @option{-nic} can
|
2018-10-14 17:48:54 +00:00
|
|
|
be used to shorten the command line length (note that the e1000 is the default
|
|
|
|
on i386, so the @option{model=e1000} parameter could even be omitted here, too):
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 -netdev user,id=n1,ipv6=off -device e1000,netdev=n1,mac=52:54:98:76:54:32
|
|
|
|
-qemu-system-i386 -nic user,ipv6=off,model=e1000,mac=52:54:98:76:54:32
|
|
|
|
+qemu-kvm -netdev user,id=n1,ipv6=off -device e1000,netdev=n1,mac=52:54:98:76:54:32
|
|
|
|
+qemu-kvm -nic user,ipv6=off,model=e1000,mac=52:54:98:76:54:32
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@item -nic none
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -2047,7 +2047,7 @@ can not be resolved.
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
Example:
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 -nic user,dnssearch=mgmt.example.org,dnssearch=example.org
|
|
|
|
+qemu-kvm -nic user,dnssearch=mgmt.example.org,dnssearch=example.org
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@item domainname=@var{domain}
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -2071,7 +2071,7 @@ a guest from a local directory.
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
Example (using pxelinux):
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 -hda linux.img -boot n -device e1000,netdev=n1 \
|
|
|
|
+qemu-kvm -hda linux.img -boot n -device e1000,netdev=n1 \
|
|
|
|
-netdev user,id=n1,tftp=/path/to/tftp/files,bootfile=/pxelinux.0
|
|
|
|
@end example
|
|
|
|
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -2105,7 +2105,7 @@ screen 0, use the following:
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
@example
|
|
|
|
# on the host
|
|
|
|
-qemu-system-i386 -nic user,hostfwd=tcp:127.0.0.1:6001-:6000
|
|
|
|
+qemu-kvm -nic user,hostfwd=tcp:127.0.0.1:6001-:6000
|
|
|
|
# this host xterm should open in the guest X11 server
|
|
|
|
xterm -display :1
|
|
|
|
@end example
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -2115,7 +2115,7 @@ the guest, use the following:
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
@example
|
|
|
|
# on the host
|
|
|
|
-qemu-system-i386 -nic user,hostfwd=tcp::5555-:23
|
|
|
|
+qemu-kvm -nic user,hostfwd=tcp::5555-:23
|
|
|
|
telnet localhost 5555
|
|
|
|
@end example
|
|
|
|
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -2134,7 +2134,7 @@ lifetime, like in the following example:
|
2018-10-14 17:48:54 +00:00
|
|
|
@example
|
|
|
|
# open 10.10.1.1:4321 on bootup, connect 10.0.2.100:1234 to it whenever
|
|
|
|
# the guest accesses it
|
|
|
|
-qemu-system-i386 -nic user,guestfwd=tcp:10.0.2.100:1234-tcp:10.10.1.1:4321
|
|
|
|
+qemu-kvm -nic user,guestfwd=tcp:10.0.2.100:1234-tcp:10.10.1.1:4321
|
|
|
|
@end example
|
|
|
|
|
|
|
|
Or you can execute a command on every TCP connection established by the guest,
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -2143,7 +2143,7 @@ so that QEMU behaves similar to an inetd process for that virtual server:
|
2018-10-14 17:48:54 +00:00
|
|
|
@example
|
|
|
|
# call "netcat 10.10.1.1 4321" on every TCP connection to 10.0.2.100:1234
|
|
|
|
# and connect the TCP stream to its stdin/stdout
|
|
|
|
-qemu-system-i386 -nic 'user,id=n1,guestfwd=tcp:10.0.2.100:1234-cmd:netcat 10.10.1.1 4321'
|
|
|
|
+qemu-kvm -nic 'user,id=n1,guestfwd=tcp:10.0.2.100:1234-cmd:netcat 10.10.1.1 4321'
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@end table
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -2170,21 +2170,22 @@ Examples:
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
@example
|
|
|
|
#launch a QEMU instance with the default network script
|
|
|
|
-qemu-system-i386 linux.img -nic tap
|
|
|
|
+qemu-kvm linux.img -nic tap
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@example
|
|
|
|
#launch a QEMU instance with two NICs, each one connected
|
|
|
|
#to a TAP device
|
|
|
|
-qemu-system-i386 linux.img \
|
|
|
|
+qemu-kvm linux.img \
|
|
|
|
-netdev tap,id=nd0,ifname=tap0 -device e1000,netdev=nd0 \
|
|
|
|
-netdev tap,id=nd1,ifname=tap1 -device rtl8139,netdev=nd1
|
|
|
|
+ -net nic,vlan=1 -net tap,vlan=1,ifname=tap1
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@example
|
|
|
|
#launch a QEMU instance with the default network helper to
|
|
|
|
#connect a TAP device to bridge br0
|
|
|
|
-qemu-system-i386 linux.img -device virtio-net-pci,netdev=n1 \
|
|
|
|
+qemu-kvm linux.img -device virtio-net-pci,netdev=n1 \
|
|
|
|
-netdev tap,id=n1,"helper=/path/to/qemu-bridge-helper"
|
|
|
|
@end example
|
|
|
|
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -2201,13 +2202,13 @@ Examples:
|
2018-10-14 17:48:54 +00:00
|
|
|
@example
|
|
|
|
#launch a QEMU instance with the default network helper to
|
|
|
|
#connect a TAP device to bridge br0
|
|
|
|
-qemu-system-i386 linux.img -netdev bridge,id=n1 -device virtio-net,netdev=n1
|
|
|
|
+qemu-kvm linux.img -netdev bridge,id=n1 -device virtio-net,netdev=n1
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@example
|
|
|
|
#launch a QEMU instance with the default network helper to
|
|
|
|
#connect a TAP device to bridge qemubr0
|
|
|
|
-qemu-system-i386 linux.img -netdev bridge,br=qemubr0,id=n1 -device virtio-net,netdev=n1
|
|
|
|
+qemu-kvm linux.img -netdev bridge,br=qemubr0,id=n1 -device virtio-net,netdev=n1
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@item -netdev socket,id=@var{id}[,fd=@var{h}][,listen=[@var{host}]:@var{port}][,connect=@var{host}:@var{port}]
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -2222,13 +2223,13 @@ specifies an already opened TCP socket.
|
2018-10-14 17:48:54 +00:00
|
|
|
Example:
|
|
|
|
@example
|
|
|
|
# launch a first QEMU instance
|
|
|
|
-qemu-system-i386 linux.img \
|
|
|
|
- -device e1000,netdev=n1,mac=52:54:00:12:34:56 \
|
|
|
|
- -netdev socket,id=n1,listen=:1234
|
|
|
|
+qemu-kvm linux.img \
|
|
|
|
+ -device e1000,netdev=n1,mac=52:54:00:12:34:56 \
|
|
|
|
+ -netdev socket,id=n1,listen=:1234
|
|
|
|
# connect the network of this instance to the network of the first instance
|
|
|
|
-qemu-system-i386 linux.img \
|
|
|
|
- -device e1000,netdev=n2,mac=52:54:00:12:34:57 \
|
|
|
|
- -netdev socket,id=n2,connect=127.0.0.1:1234
|
|
|
|
+qemu-kvm linux.img \
|
|
|
|
+ -device e1000,netdev=n2,mac=52:54:00:12:34:57 \
|
|
|
|
+ -netdev socket,id=n2,connect=127.0.0.1:1234
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@item -netdev socket,id=@var{id}[,fd=@var{h}][,mcast=@var{maddr}:@var{port}[,localaddr=@var{addr}]]
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -2251,15 +2252,15 @@ Use @option{fd=h} to specify an already opened UDP multicast socket.
|
2018-10-14 17:48:54 +00:00
|
|
|
Example:
|
|
|
|
@example
|
|
|
|
# launch one QEMU instance
|
|
|
|
-qemu-system-i386 linux.img \
|
|
|
|
- -device e1000,netdev=n1,mac=52:54:00:12:34:56 \
|
|
|
|
- -netdev socket,id=n1,mcast=230.0.0.1:1234
|
|
|
|
+qemu-kvm linux.img \
|
|
|
|
+ -device e1000,netdev=n1,mac=52:54:00:12:34:56 \
|
|
|
|
+ -netdev socket,id=n1,mcast=230.0.0.1:1234
|
|
|
|
# launch another QEMU instance on same "bus"
|
|
|
|
-qemu-system-i386 linux.img \
|
|
|
|
- -device e1000,netdev=n2,mac=52:54:00:12:34:57 \
|
|
|
|
- -netdev socket,id=n2,mcast=230.0.0.1:1234
|
|
|
|
+qemu-kvm linux.img \
|
|
|
|
+ -device e1000,netdev=n2,mac=52:54:00:12:34:57 \
|
|
|
|
+ -netdev socket,id=n2,mcast=230.0.0.1:1234
|
|
|
|
# launch yet another QEMU instance on same "bus"
|
|
|
|
-qemu-system-i386 linux.img \
|
|
|
|
+qemu-kvm linux.img \
|
2018-11-29 12:09:34 +00:00
|
|
|
-device e1000,netdev=n3,mac=52:54:00:12:34:58 \
|
|
|
|
-netdev socket,id=n3,mcast=230.0.0.1:1234
|
2018-10-14 17:48:54 +00:00
|
|
|
@end example
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -2267,7 +2268,7 @@ qemu-system-i386 linux.img \
|
2018-10-14 17:48:54 +00:00
|
|
|
Example (User Mode Linux compat.):
|
|
|
|
@example
|
|
|
|
# launch QEMU instance (note mcast address selected is UML's default)
|
|
|
|
-qemu-system-i386 linux.img \
|
|
|
|
+qemu-kvm linux.img \
|
|
|
|
-device e1000,netdev=n1,mac=52:54:00:12:34:56 \
|
|
|
|
-netdev socket,id=n1,mcast=239.192.168.1:1102
|
|
|
|
# launch UML
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -2276,9 +2277,12 @@ qemu-system-i386 linux.img \
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
Example (send packets from host's 1.2.3.4):
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 linux.img \
|
|
|
|
- -device e1000,netdev=n1,mac=52:54:00:12:34:56 \
|
|
|
|
- -netdev socket,id=n1,mcast=239.192.168.1:1102,localaddr=1.2.3.4
|
|
|
|
+qemu-kvm linux.img \
|
|
|
|
+ -device e1000,netdev=n1,mac=52:54:00:12:34:56 \
|
|
|
|
+ -netdev socket,id=n1,mcast=239.192.168.1:1102,localaddr=1.2.3.4
|
|
|
|
+qemu-kvm 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 -netdev l2tpv3,id=@var{id},src=@var{srcaddr},dst=@var{dstaddr}[,srcport=@var{srcport}][,dstport=@var{dstport}],txsession=@var{txsession}[,rxsession=@var{rxsession}][,ipv6][,udp][,cookie64][,counter][,pincounter][,txcookie=@var{txcookie}][,rxcookie=@var{rxcookie}][,offset=@var{offset}]
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -2336,7 +2340,7 @@ brctl addif br-lan vmtunnel0
|
2018-10-14 17:48:54 +00:00
|
|
|
# on 4.3.2.1
|
|
|
|
# launch QEMU instance - if your network has reorder or is very lossy add ,pincounter
|
|
|
|
|
|
|
|
-qemu-system-i386 linux.img -device e1000,netdev=n1 \
|
|
|
|
+qemu-kvm linux.img -device e1000,netdev=n1 \
|
|
|
|
-netdev l2tpv3,id=n1,src=4.2.3.1,dst=1.2.3.4,udp,srcport=16384,dstport=16384,rxsession=0xffffffff,txsession=0xffffffff,counter
|
|
|
|
|
|
|
|
@end example
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -2353,7 +2357,7 @@ Example:
|
2018-10-14 17:48:54 +00:00
|
|
|
# launch vde switch
|
|
|
|
vde_switch -F -sock /tmp/myswitch
|
|
|
|
# launch QEMU instance
|
|
|
|
-qemu-system-i386 linux.img -nic vde,sock=/tmp/myswitch
|
|
|
|
+qemu-kvm linux.img -nic vde,sock=/tmp/myswitch
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@item -netdev vhost-user,chardev=@var{id}[,vhostforce=on|off][,queues=n]
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -2367,11 +2371,11 @@ be created for multiqueue vhost-user.
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
Example:
|
|
|
|
@example
|
|
|
|
-qemu -m 512 -object memory-backend-file,id=mem,size=512M,mem-path=/hugetlbfs,share=on \
|
|
|
|
- -numa node,memdev=mem \
|
|
|
|
- -chardev socket,id=chr0,path=/path/to/socket \
|
|
|
|
- -netdev type=vhost-user,id=net0,chardev=chr0 \
|
|
|
|
- -device virtio-net-pci,netdev=net0
|
|
|
|
+qemu-kvm -m 512 -object memory-backend-file,id=mem,size=512M,mem-path=/hugetlbfs,share=on \
|
|
|
|
+ -numa node,memdev=mem \
|
|
|
|
+ -chardev socket,id=chr0,path=/path/to/socket \
|
|
|
|
+ -netdev type=vhost-user,id=net0,chardev=chr0 \
|
|
|
|
+ -device virtio-net-pci,netdev=net0
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@item -netdev hubport,id=@var{id},hubid=@var{hubid}[,netdev=@var{nd}]
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -2804,7 +2808,7 @@ and communicate. Requires the Linux @code{vhci} driver installed. Can
|
2018-10-14 17:48:54 +00:00
|
|
|
be used as following:
|
|
|
|
|
|
|
|
@example
|
|
|
|
-qemu-system-i386 [...OPTIONS...] -bt hci,vlan=5 -bt vhci,vlan=5
|
|
|
|
+qemu-kvm [...OPTIONS...] -bt hci,vlan=5 -bt vhci,vlan=5
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@item -bt device:@var{dev}[,vlan=@var{n}]
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -3253,14 +3257,14 @@ ETEXI
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
DEF("realtime", HAS_ARG, QEMU_OPTION_realtime,
|
|
|
|
"-realtime [mlock=on|off]\n"
|
|
|
|
- " run qemu with realtime features\n"
|
|
|
|
+ " run qemu-kvm with realtime features\n"
|
|
|
|
" mlock=on|off controls mlock support (default: on)\n",
|
|
|
|
QEMU_ARCH_ALL)
|
|
|
|
STEXI
|
|
|
|
@item -realtime mlock=on|off
|
|
|
|
@findex -realtime
|
|
|
|
-Run qemu with realtime features.
|
|
|
|
-mlocking qemu and guest memory can be enabled via @option{mlock=on}
|
|
|
|
+Run qemu-kvm with realtime features.
|
|
|
|
+mlocking qemu-kvm and guest memory can be enabled via @option{mlock=on}
|
|
|
|
(enabled by default).
|
|
|
|
ETEXI
|
|
|
|
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -3298,7 +3302,7 @@ connections will likely be TCP-based, but also UDP, pseudo TTY, or even
|
2018-10-14 17:48:54 +00:00
|
|
|
stdio are reasonable use case. The latter is allowing to start QEMU from
|
|
|
|
within gdb and establish the connection via a pipe:
|
|
|
|
@example
|
|
|
|
-(gdb) target remote | exec qemu-system-i386 -gdb stdio ...
|
|
|
|
+(gdb) target remote | exec qemu-kvm -gdb stdio ...
|
|
|
|
@end example
|
|
|
|
ETEXI
|
|
|
|
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -4247,7 +4251,7 @@ which specify the queue number of cryptodev backend, the default of
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
@example
|
|
|
|
|
|
|
|
- # qemu-system-x86_64 \
|
|
|
|
+ # qemu-kvm \
|
|
|
|
[...] \
|
|
|
|
-object cryptodev-backend-builtin,id=cryptodev0 \
|
|
|
|
-device virtio-crypto-pci,id=crypto0,cryptodev=cryptodev0 \
|
2018-11-29 12:09:34 +00:00
|
|
|
@@ -4267,7 +4271,7 @@ of cryptodev backend for multiqueue vhost-user, the default of @var{queues} is 1
|
2018-10-14 17:48:54 +00:00
|
|
|
|
|
|
|
@example
|
|
|
|
|
|
|
|
- # qemu-system-x86_64 \
|
|
|
|
+ # qemu-kvm \
|
|
|
|
[...] \
|
|
|
|
-chardev socket,id=chardev0,path=/path/to/socket \
|
|
|
|
-object cryptodev-vhost-user,id=cryptodev0,chardev=chardev0 \
|
|
|
|
--
|
|
|
|
1.8.3.1
|
|
|
|
|