source: postlfs/virtualization/qemu.xml

trunk
Last change on this file was 635a277b, checked in by Xi Ruoyao <xry111@…>, 5 weeks ago

qemu: Remove stale external dependency on libfdt

Now libfdt is provided as a part of the dtc package.
  • Property mode set to 100644
File size: 27.4 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY qemu-download-http "https://download.qemu.org/qemu-&qemu-version;.tar.xz">
8 <!ENTITY qemu-download-ftp " ">
9 <!ENTITY qemu-md5sum "e43091262671c1728b09522932b75b1d">
10 <!ENTITY qemu-size "124 MB">
11 <!ENTITY qemu-buildsize "2.4 GB (373 MB installed)">
12 <!ENTITY qemu-time "1.3 SBU (add 0.8 SBU for tests, both using parallelism=4)">
13]>
14
15<sect1 id="qemu" xreflabel="qemu-&qemu-version;">
16 <?dbhtml filename="qemu.html"?>
17
18
19 <title>qemu-&qemu-version;</title>
20
21 <indexterm zone="qemu">
22 <primary sortas="a-qemu">qemu</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to qemu</title>
27
28 <para>
29 <application>qemu</application> is a full virtualization solution for
30 Linux on x86 hardware containing virtualization extensions (Intel VT or
31 AMD-V).
32 </para>
33
34 &lfs121_checked;
35
36 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing="compact">
38 <listitem>
39 <para>
40 Download (HTTP): <ulink url="&qemu-download-http;"/>
41 </para>
42 </listitem>
43 <listitem>
44 <para>
45 Download (FTP): <ulink url="&qemu-download-ftp;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download MD5 sum: &qemu-md5sum;
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download size: &qemu-size;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Estimated disk space required: &qemu-buildsize;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated build time: &qemu-time;
66 </para>
67 </listitem>
68 </itemizedlist>
69
70 <bridgehead renderas="sect3">Qemu Dependencies</bridgehead>
71
72 <bridgehead renderas="sect4">Required</bridgehead>
73 <para role="required">
74 <xref linkend="glib2"/> and
75 <xref linkend="pixman"/>
76 </para>
77
78 <bridgehead renderas="sect4">Recommended</bridgehead>
79 <para role="recommended">
80 <xref linkend="alsa-lib"/>,
81 <xref linkend="dtc"/>,
82 <xref linkend="libslirp"/>, and
83 <xref linkend="sdl2"/>
84 </para>
85
86 <note>
87 <para>
88 If <xref linkend="dtc"/> is not installed, the building system
89 will attempt to download a copy of dtc source code from the
90 Internet.
91 </para>
92 </note>
93
94 <bridgehead renderas="sect4">Optional</bridgehead>
95 <para role="optional">
96 <xref linkend="pipewire"/> or
97 <xref linkend="pulseaudio"/> (can be used instead of alsa-lib),
98 <xref linkend="bluez"/>,
99 <xref linkend="curl"/>,
100 <xref linkend="cyrus-sasl"/>,
101 <xref linkend="fuse3"/>,
102 <xref linkend="gnutls"/>,
103 <xref linkend="gtk3"/>,
104 <xref linkend="keyutils"/>,
105 <xref linkend="libaio"/>,
106 <xref linkend="libusb"/>,
107 <xref linkend="libgcrypt"/>,
108 <xref linkend="libjpeg"/>,
109 <xref linkend="libseccomp"/>,
110 <xref linkend="libssh2"/>,
111 <xref linkend="libpng"/>,
112 <xref linkend="libtasn1"/>,
113 <xref linkend="linux-pam"/>,
114 <xref linkend="lzo"/>,
115 <xref linkend="nettle"/>,
116 <xref linkend="mesa"/>,
117 <xref role="nodep" linkend="vte"/>,
118<!-- libcacard has been a standalone project since qemu-2.5.-->
119 <ulink url="https://www.capstone-engine.org/">capstone</ulink>,
120 <ulink url="https://github.com/ceph/ceph/">ceph</ulink>,
121 <ulink url="https://pmem.io/daxctl/">daxctl</ulink>,
122 <ulink url="https://jackaudio.org/">JACK</ulink>,
123 <ulink url="https://github.com/gluster/glusterfs">glusterfs</ulink>,
124 <ulink url="https://github.com/libbpf/libbpf">libbpf</ulink>,
125 <ulink url="https://gitlab.freedesktop.org/spice/libcacard">libcacard</ulink>,
126 <ulink url="https://people.redhat.com/sgrubb/libcap-ng/">libcap-ng</ulink>,
127 <ulink url="https://sourceware.org/elfutils/">libdw</ulink>,
128 <ulink url="https://github.com/sahlberg/libiscsi">libiscsi</ulink>,
129 <ulink url="https://github.com/sahlberg/libnfs">libnfs</ulink>,
130 <ulink url="https://pmem.io/pmdk/libpmem/">libpmem</ulink>,
131 <ulink url="https://www.libssh.org/">libssh</ulink>,
132 <ulink url="https://github.com/Agnoctopus/libu2f-emu">libu2f-emu</ulink>,
133 <ulink url="https://github.com/lzfse/lzfse">lzfse</ulink>,
134 <ulink url="https://github.com/luigirizzo/netmap">netmap</ulink>,
135 <ulink url="https://github.com/numactl/numactl">numactl</ulink>,
136 <ulink url="https://github.com/linux-rdma/rdma-core">rdma-core</ulink>,
137 <ulink url="https://selinuxproject.org/">SELinux</ulink>,
138 <ulink url="https://google.github.io/snappy/">snappy</ulink>,
139 <ulink url="https://gitlab.freedesktop.org/spice/spice">spice</ulink>,
140 <ulink url="https://gitlab.freedesktop.org/spice/usbredir">usbredir</ulink>,
141 and <ulink url="https://github.com/virtualsquare/vde-2">VDE</ulink>
142 </para>
143
144 <bridgehead renderas="sect4">Optional (Runtime)</bridgehead>
145 <para role="runtime">
146 &logind;
147 </para>
148
149 <bridgehead renderas="sect4">Optional (for building the documentation)</bridgehead>
150 <para role="optional">
151 <xref linkend="sphinx_rtd_theme"/>
152 </para>
153
154 <note>
155 <para>
156 This optional dependencies list is not comprehensive. See the output of
157 <command>./configure --help</command> for a more complete list.
158 </para>
159 </note>
160
161 <para condition="html" role="usernotes">Editor Notes:
162 <ulink url="&blfs-wiki;/qemu"/></para>
163
164 </sect2>
165
166 <sect2 id='qemu-prereq'>
167 <title>KVM Prerequisites</title>
168
169 <para>
170 Before building <application>qemu</application>, check to see if
171 your processor supports Virtualization Technology (VT):
172 </para>
173
174 <screen><userinput>grep -E '^flags.*(vmx|svm)' /proc/cpuinfo</userinput></screen>
175
176 <para>
177 If you get any output, you have VT technology (vmx for Intel
178 processors and svm for AMD processors). You then need to go into your
179 system BIOS and ensure it is enabled. After enabling, reboot back to your
180 LFS instance.
181 </para>
182
183 </sect2>
184
185 <sect2 role="kernel" id='qemu-kernel'>
186 <title>Kernel Configuration</title>
187
188 <para>
189 Enable the following options in the kernel configuration and
190 recompile the kernel if necessary:
191 </para>
192
193 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
194 href="qemu-kvm-kernel.xml"/>
195
196 <indexterm zone="qemu qemu-kernel">
197 <primary sortas="d-qemu">qemu</primary>
198 </indexterm>
199
200 <para>
201 The Intel or AMD settings are not both required, but the one matching
202 your system processor is required.
203 </para>
204
205 <para>
206 To use the <quote>bridge</quote> network device, as explained below,
207 check that <xref linkend='bridgeutils'/> is installed
208 and the following options in the kernel configuration are enabled:
209 </para>
210
211 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
212 href="qemu-bridge-kernel.xml"/>
213
214 </sect2>
215
216 <sect2 role="installation">
217 <title>Installation of qemu</title>
218<!-- group kvm is created in lfs chapter 7 even for sysv
219 <para revision="sysv">
220 You will need a dedicated group that will contain users (other than root)
221 allowed to access the KVM device. Create this group by running the
222 following command as the
223 <systemitem class="username">root</systemitem> user:
224 </para>
225
226<screen role="root" revision="sysv"><userinput>groupadd -g 61 kvm</userinput></screen>
227-->
228 <para>
229 The udev rule of LFS only allows the &root; user, the users owning
230 a local login session supported by the optional runtime dependency
231 &logind;, or the users in the
232 <systemitem class="groupname">kvm</systemitem> group to use the KVM
233 device. As the &root; user, add any non-&root; users that might use
234 the KVM device either without &logind; installed or remotely (via a
235 SSH connection) to the
236 <systemitem class="groupname">kvm</systemitem> group:
237 </para>
238
239<screen role="root"><userinput>usermod -a -G kvm <replaceable>&lt;username&gt;</replaceable></userinput></screen>
240
241 <para>
242 Install <application>qemu</application> by running the following
243 commands:
244 </para>
245
246 <note>
247 <para>
248 Qemu is capable of running many targets. The build process
249 is also capable of building multiple targets at one time in a
250 comma delimited list assigned to <option>--target-list</option>. Run
251 <command>./configure --help</command> to get a complete list of
252 available targets.
253 </para>
254 </note>
255
256
257<screen><userinput>if [ $(uname -m) = i686 ]; then
258 QEMU_ARCH=i386-softmmu
259else
260 QEMU_ARCH=x86_64-softmmu
261fi
262
263
264mkdir -vp build &amp;&amp;
265cd build &amp;&amp;
266
267../configure --prefix=/usr \
268 --sysconfdir=/etc \
269 --localstatedir=/var \
270 --target-list=$QEMU_ARCH \
271 --audio-drv-list=alsa \
272 --disable-pa \
273 --enable-slirp \
274 --docdir=/usr/share/doc/qemu-&qemu-version; &amp;&amp;
275
276unset QEMU_ARCH &amp;&amp;
277
278make</userinput></screen>
279
280 <para>
281 <application>qemu</application> uses <command>ninja</command> as
282 a subprocess when building. To run the tests, issue:
283 <command>ninja test</command>. Two tests, bios-tables-test and migration-test,
284 are known to fail.
285 </para>
286
287 <para>
288 Now, as the &root; user:
289 </para>
290
291<screen role="root"><userinput>make install</userinput></screen>
292
293 <para>
294 Change the permissions and ownership of a helper script, which is needed
295 when using the <quote>bridge</quote> network device (see below). Again
296 as the &root; user, issue:
297 </para>
298
299 <note>
300 <para>
301 You need to add any users who might use the <quote>bridge</quote>
302 network device into the
303 <systemitem class="groupname">kvm</systemitem> group even if
304 &logind; is installed.
305 </para>
306 </note>
307
308<screen role="root"><userinput>chgrp kvm /usr/libexec/qemu-bridge-helper &amp;&amp;
309chmod 4750 /usr/libexec/qemu-bridge-helper</userinput></screen>
310
311 <note>
312 <para>
313 For convenience you may want to create a symbolic link to run
314 the installed program. For instance (as the &root; user):
315 </para>
316
317<screen role="root"><userinput>ln -sv qemu-system-`uname -m` /usr/bin/qemu</userinput></screen>
318 </note>
319
320 </sect2>
321
322 <sect2 role="commands">
323 <title>Command Explanations</title>
324
325 <para>
326 <parameter>--audio-drv-list=alsa</parameter>: This switch
327 sets the audio driver to ALSA. See below for enabling other audio drivers.
328 </para>
329
330 <para>
331 <parameter>--disable-pa</parameter>: even if <emphasis>pa</emphasis> is
332 not in <parameter>--audio-drv-list</parameter> list, the pulseaudio
333 driver is built, unless disabled by this parameter.
334 </para>
335
336 <para>
337 <parameter>--enable-slirp</parameter>: This switch forces the building
338 system to check for <xref linkend='libslirp'/>. Remove it if you
339 don't need the <option>-netdev user</option> support.
340 </para>
341
342 <para>
343 <option>--audio-drv-list=pa --disable-alsa</option>: This switch sets
344 the audio driver to pulseaudio. For other drivers see the
345 --audio-drv-list choices in the output of
346 <command>./configure --help</command>. The default audio driver is OSS.
347 To enable support for both alsa and pulseaudio, use
348 <option>--audio-drv-list=alsa,pa</option>.
349 </para>
350
351 </sect2>
352
353 <sect2 role="using">
354 <title>Using Qemu</title>
355
356 <para>
357 Since using qemu means using a virtual computer, the steps to set up
358 the virtual machine are in close analogy with those to set up a real
359 computer. You'll need to decide about CPU, memory, disk, USB devices,
360 network card(s), screen size, etc. Once the <quote>hardware</quote> is
361 decided, you'll have for example to choose how to connect the machine
362 to internet, and/or to install an OS. In the following, we show basic
363 ways of performing those steps. But qemu is much more than this, and it
364 is strongly advised to read the qemu documentation in
365 <filename>/usr/share/doc/qemu-&qemu-version;/qemu-doc.html</filename>.
366 </para>
367
368 <note>
369 <para>
370 It is standard practice to name the computer running qemu
371 <quote>host</quote> and the emulated machine running under qemu the
372 <quote>guest</quote>. We'll use those notations in the following.
373 </para>
374 </note>
375
376 <note>
377 <para>
378 The following instructions assume the optional symbolic link,
379 <filename>qemu</filename>, has been created. Additionally,
380 <command>qemu</command> should be run in a graphical environment.
381 But it is possible to use qemu <quote>headless</quote> or through
382 SSH. See the documentation for the various possibilities.
383 </para>
384 </note>
385
386 <bridgehead renderas="sect3">Disk</bridgehead>
387 <para>
388 A virtual disk may be set up in the following way:
389 </para>
390
391<screen><userinput>VDISK_SIZE=<replaceable>50G</replaceable>
392VDISK_FILENAME=<replaceable>vdisk.img</replaceable>
393qemu-img create -f qcow2 $VDISK_FILENAME $VDISK_SIZE</userinput></screen>
394
395 <para>
396 The virtual disk size and filename should be adjusted as desired. The
397 actual size of the file will be less than specified, but will expand as
398 needed, so it is safe to put a high value.
399 </para>
400
401 <bridgehead renderas="sect3">Operating System</bridgehead>
402 <para>
403 To install an operating system, download an iso image from your preferred
404 Linux distribution. For the purposes of this example, we'll use
405 <filename>Fedora-16-x86_64-Live-LXDE.iso</filename> in the current
406 directory. Run the following:
407 </para>
408
409<screen><userinput>qemu -enable-kvm \
410 -drive file=$VDISK_FILENAME \
411 -cdrom Fedora-16-x86_64-Live-LXDE.iso \
412 -boot d \
413 -m <replaceable>1G</replaceable></userinput></screen>
414
415 <para>
416 Follow the normal installation procedures for the chosen distribution.
417 The <parameter>-boot</parameter> option specifies the boot order of
418 drives as a string of drive letters. Valid drive letters are: a, b
419 (floppy 1 and 2), c (first hard disk), d (first CD-ROM). The
420 <parameter>-m</parameter> option is the amount of memory to use for the
421 virtual machine. The choice depends on the load of the host. Modern
422 distributions should be comfortable with 1GB.
423 The <parameter>-enable-kvm</parameter> option allows hardware
424 acceleration. Without this switch, the emulation is much slower.
425 </para>
426
427 <bridgehead renderas="sect3">Defining the virtual hardware</bridgehead>
428 <para>
429 The virtual machine hardware is defined by the qemu command line.
430 An example command is given below:
431 </para>
432
433<screen><userinput>qemu -enable-kvm \
434 -smp 4 \
435 -cpu host \
436 -m 1G \
437 -drive file=$VDISK_FILENAME \
438 -cdrom grub-img.iso \
439 -boot order=c,once=d,menu=on \
440 -net nic,netdev=net0 \
441 -netdev user,id=net0 \
442 -device ac97 \
443 -vga std \
444 -serial mon:stdio \
445 -name "fedora-16"</userinput></screen>
446
447 <bridgehead renderas="sect3">Meaning of the command line options</bridgehead>
448 <para>
449 <parameter>-enable-kvm</parameter>: enable full KVM virtualization
450 support. On some hardware, it may be necessary to add the undocumented
451 <option>-machine smm=off</option> option in order to enable KVM.
452 </para>
453
454 <para>
455 <parameter>-smp &lt;N&gt;</parameter>: enable symmetric multiprocessing
456 with &lt;N&gt; CPUs.
457 </para>
458
459 <para>
460 <parameter>-cpu &lt;model&gt;</parameter>: simulate CPU &lt;model&gt;.
461 the list of supported models can be obtained with <option>-cpu
462 help</option>.
463 </para>
464
465 <para>
466 <parameter>-drive file=&lt;filename&gt;</parameter>: defines a virtual
467 disk whose image is stored in <filename>&lt;filename&gt;</filename>.
468 </para>
469
470 <para>
471 <parameter>-cdrom grub-img.iso</parameter>: defines an iso formatted file
472 to use as a cdrom. Here we use a grub rescue disk, which may turn handy
473 when something goes wrong at boot time.
474 </para>
475
476 <para>
477 <parameter>-boot order=c,once=d,menu=on</parameter>: defines the boot
478 order for the virtual BIOS.
479 </para>
480
481 <para>
482 <parameter>-net nic,netdev=&lt;netid&gt;</parameter>: defines a network
483 card connected to the network device with id &lt;netid&gt;.
484 </para>
485
486 <para>
487 <parameter>-netdev user,id=&lt;netid&gt;</parameter>: defines the
488 network <quote>user</quote> device. This is a virtual local network
489 with addresses 10.0.2.0/24, where the host has address 10.0.2.2 and
490 acts as a gateway to internet, and with a name server at address
491 10.0.2.3, and an smb server at address 10.0.2.4. A builtin DHCP server
492 can allocate addresses between 10.0.2.15 and 10.0.2.31.
493 </para>
494
495 <para>
496 <parameter>-soundhw &lt;model&gt;</parameter>: defines the soundcard
497 model. The list may be obtained with <option>-soundhw help</option>.
498 </para>
499
500 <para>
501 <parameter>-vga &lt;type&gt;</parameter>: defines the type of VGA card
502 to emulate. For <parameter>-vga std</parameter>, if you are building
503 a Linux kernel for the guest, it's recommended to enable
504 <option>CONFIG_DRM_BOCHS</option> (as a part of the kernel or a kernel
505 module) to drive all the features of the emulated VGA card, and
506 <option>CONFIG_FB</option> to display the Linux console on it. The
507 other <option>&lt;type&gt;</option> values are not tested by the
508 editors and may require additional dependencies.
509 </para>
510
511 <para>
512 <parameter>-serial mon:stdio</parameter>: sends the serial port of the
513 guest (<filename>/dev/ttyS0</filename> on linux guests), multiplexed with
514 the qemu monitor, to the standard input and output of the qemu
515 process.
516 </para>
517
518 <para>
519 <parameter>-name &lt;name&gt;</parameter>: sets the name of the guest.
520 This name is displayed in the guest window caption. It may be useful
521 if you run several guests at the same time.
522 </para>
523
524 <para>
525 <option>-drive if=pflash,format=raw,readonly=on,file=/usr/share/qemu/edk2-x86_64-code.fd</option>: Load a
526 pre-built EDK2 UEFI firmware, instead of the default PC BIOS. Use
527 this option if you want to boot the guest OS with UEFI.
528 </para>
529
530 <para>
531 <option>-drive file=&lt;filename&gt;,if=virtio</option>: Provide
532 Virtio interface to the guest kernel for accessing the disk image,
533 instead of simulating a real disk hardware. This can improve disk I/O
534 performance, but it requires a Virtio driver in guest kernel. Use
535 it instead of a plain <option>-drive</option> if the guest kernel
536 supports Virtio. To build a Linux kernel with Virtio support for the
537 guest, use
538 <command>make defconfig &amp;&amp; make kvm_guest.config</command> to
539 create an initial kernel configuration with the Virtio drives enabled,
540 then make your customization. And, if the guest kernel is Linux, the
541 virtual disks using Virtio interface will be named
542 <filename>vdx</filename> in the devtmpfs, instead of
543 <filename>sdx</filename>.
544 </para>
545
546 <para>
547 <option>-net nic,netdev=net0,model=virtio-net-pci</option>: Provide
548 Virtio interface to the guest kernel for accessing the network
549 interface, instead of simulating a real network interface card. This
550 can improve network I/O performance, but it requires a Virtio driver
551 in guest kernel. Use it instead of a plain <option>-net</option> if
552 the guest kernel supports Virtio.
553 </para>
554
555 <bridgehead renderas="sect3">Controlling the Emulated Display</bridgehead>
556 <para>
557 To set the resolution of the emulated display for a Xorg server
558 running in the guest Linux system, read <xref linkend='xdisplay'/>.
559 </para>
560
561 <bridgehead renderas="sect3">Networking</bridgehead>
562 <para>
563 The above solution for networking allows the guest to access the local
564 network through the host (and possibly to access internet through the
565 local routers), but the converse is not true. Not even the host can
566 access the guest, unless port forwarding is enabled. And in the case
567 several guests are running, they cannot communicate with each other.
568 Other network devices can be used for this purpose. For example, there
569 is the <quote>socket</quote> device, which allows several guests to
570 share a common virtual network. In the following, we describe in more
571 details how to set up the <quote>bridge</quote> device, which allows
572 the guests to appear as if connected to the local network. All the
573 commands below should be run as the <systemitem
574 class="username">root</systemitem> user.
575 </para>
576
577 <para revision="sysv">
578 Set up bridging with <xref linkend="bridgeutils"/>. Only the physical
579 interface(s) should be set up at boot. The virtual interface(s) will be
580 added as needed when qemu is started.
581 </para>
582
583 <para revision="systemd">
584 <!-- On SYS-V, IP_FORWARD is enabled by the bridge script. -->
585 Allow the host to forward IP packets:
586 </para>
587
588<screen role="root"
589 revision="systemd"><userinput>sysctl -w net.ipv4.ip_forward=1</userinput></screen>
590
591 <para revision="systemd">
592 To make this permanent, add the command to
593 <filename>/etc/sysctl.d/60-net-forward.conf:</filename>
594 </para>
595
596<screen role="root"
597 revision="systemd"><userinput>cat &gt;&gt; /etc/sysctl.d/60-net-forward.conf &lt;&lt; EOF
598<literal>net.ipv4.ip_forward=1</literal>
599EOF</userinput></screen>
600
601 <para>
602 Set up a required configuration file:
603 </para>
604
605<!-- /etc/qemu has not been installed by "make install" since version 2.4 -->
606<screen role="root"><userinput>install -vdm 755 /etc/qemu &amp;&amp;
607echo allow br0 &gt; /etc/qemu/bridge.conf</userinput></screen>
608
609 <para>
610 In the qemu command line above, replace the switch
611 <parameter>-netdev user,...</parameter> with
612 <parameter>-netdev bridge,...</parameter>.
613 </para>
614
615 </sect2>
616
617 <sect2 role="content">
618 <title>Contents</title>
619
620 <segmentedlist>
621 <segtitle>Installed Programs</segtitle>
622 <segtitle>Installed Library</segtitle>
623 <segtitle>Installed Directories</segtitle>
624
625 <seglistitem>
626 <seg>
627 elf2dmp,
628 qemu (symlink),
629 qemu-edid,
630 qemu-ga,
631 qemu-img,
632 qemu-io,
633 qemu-keymap,
634 qemu-nbd,
635 qemu-pr-helper,
636 qemu-storage-daemon, and
637 qemu-system-&lt;arch&gt;
638 </seg>
639 <seg>None</seg>
640 <seg>
641 /usr/share/qemu and
642 /usr/share/doc/qemu-&qemu-version; (optional)
643 </seg>
644 </seglistitem>
645 </segmentedlist>
646
647 <variablelist>
648 <bridgehead renderas="sect3">Short Description</bridgehead>
649 <?dbfo list-presentation="list"?>
650 <?dbhtml list-presentation="table"?>
651
652 <varlistentry id="elf2dmp">
653 <term><command>elf2dmp</command></term>
654 <listitem>
655 <para>
656 Converts files from elf to dmp format
657 </para>
658 <indexterm zone="qemu elf2dmp">
659 <primary sortas="b-elf2dmp">elf2dmp</primary>
660 </indexterm>
661 </listitem>
662 </varlistentry>
663
664 <varlistentry id="qemu-edid">
665 <term><command>qemu-edid</command></term>
666 <listitem>
667 <para>
668 is a test tool for the qemu EDID generator
669 </para>
670 <indexterm zone="qemu qemu-edid">
671 <primary sortas="b-qemu-edid">qemu-edid</primary>
672 </indexterm>
673 </listitem>
674 </varlistentry>
675
676 <varlistentry id="qemu-ga">
677 <term><command>qemu-ga</command></term>
678 <listitem>
679 <para>
680 implements support for QMP (QEMU Monitor Protocol) commands and
681 events that terminate and originate respectively within the guest
682 using an agent built as part of QEMU
683 </para>
684 <indexterm zone="qemu qemu-ga">
685 <primary sortas="b-qemu-ga">qemu-ga</primary>
686 </indexterm>
687 </listitem>
688 </varlistentry>
689
690 <varlistentry id="qemu-img">
691 <term><command>qemu-img</command></term>
692 <listitem>
693 <para>
694 provides commands to manage QEMU disk images
695 </para>
696 <indexterm zone="qemu qemu-img">
697 <primary sortas="b-qemu-img">qemu-img</primary>
698 </indexterm>
699 </listitem>
700 </varlistentry>
701
702 <varlistentry id="qemu-io">
703 <term><command>qemu-io</command></term>
704 <listitem>
705 <para>
706 is a diagnostic and manipulation program for (virtual) memory
707 media. It is still at an early stage of development
708 </para>
709 <indexterm zone="qemu qemu-io">
710 <primary sortas="b-qemu-io">qemu-io</primary>
711 </indexterm>
712 </listitem>
713 </varlistentry>
714
715 <varlistentry id="qemu-keymap">
716 <term><command>qemu-keymap</command></term>
717 <listitem>
718 <para>
719 generates qemu reverse keymaps from xkb keymaps,
720 which can be used with the qemu "-k" command line switch
721 </para>
722 <indexterm zone="qemu qemu-keymap">
723 <primary sortas="b-qemu-keymap">qemu-keymap</primary>
724 </indexterm>
725 </listitem>
726 </varlistentry>
727
728
729 <varlistentry id="qemu-nbd">
730 <term><command>qemu-nbd</command></term>
731 <listitem>
732 <para>
733 exports Qemu disk images using the QEMU Disk Network Block
734 Device (NBD) protocol
735 </para>
736 <indexterm zone="qemu qemu-nbd">
737 <primary sortas="b-qemu-nbd">qemu-nbd</primary>
738 </indexterm>
739 </listitem>
740 </varlistentry>
741
742 <varlistentry id="qemu-pr-helper">
743 <term><command>qemu-pr-helper</command></term>
744 <listitem>
745 <para>
746 Implements the persistent reservation helper for QEMU
747 </para>
748 <indexterm zone="qemu qemu-pr-helper">
749 <primary sortas="b-qemu-pr-helper">qemu-pr-helper</primary>
750 </indexterm>
751 </listitem>
752 </varlistentry>
753
754 <varlistentry id="qemu-storage-daemon">
755 <term><command>qemu-storage-daemon</command></term>
756 <listitem>
757 <para>
758 allows to modify disk images using the QEMU Monitor Protocol (QMP)
759 without running a VM
760 </para>
761 <indexterm zone="qemu qemu-storage-daemon">
762 <primary sortas="b-qemu-storage-daemon">qemu-storage-daemon</primary>
763 </indexterm>
764 </listitem>
765 </varlistentry>
766
767 <varlistentry id="qemu-system">
768 <term><command>qemu-system-x86_64</command></term>
769 <listitem>
770 <para>
771 is the QEMU PC System emulator
772 </para>
773 <indexterm zone="qemu qemu-system">
774 <primary sortas="b-qemu-system">qemu-system-x86_64</primary>
775 </indexterm>
776 </listitem>
777 </varlistentry>
778
779 </variablelist>
780
781 </sect2>
782
783</sect1>
Note: See TracBrowser for help on using the repository browser.