← Back to branch summary

~jderose/ubuntu/raring/qemu/vde-again

« back to all changes in this revision

Viewing changes to debian/qemu-i386.sgml

  • Committer: Bazaar Package Importer
  • Author(s): Aurelien Jarno, Aurelien Jarno
  • Date: 2008-08-25 04:38:35 UTC
  • mfrom: (1.1.8 upstream)
  • Revision ID: james.westby@ubuntu.com-20080825043835-8e3tftavy8bujdch
Tags: 0.9.1-6
http://bugs.debian.org/488339
[ Aurelien Jarno ]
* debian/control: 
  - Update list of supported targets (Closes: bug#488339).
* debian/qemu-make-debian-root:
  - Use mktemp instead of $$ to create temporary directories (Closes: 
    bug#496394).
* debian/links:
  - Add missing links to manpages.

Show diffs side-by-side

added added

removed removed

Lines of Context:
debian/qemu-i386.sgml
1
 
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
2
 
 
3
 
<!-- Process this file with docbook-to-man to generate an nroff manual
4
 
     page: `docbook-to-man manpage.sgml > manpage.1'.  You may view
5
 
     the manual page with: `docbook-to-man manpage.sgml | nroff -man |
6
 
     less'.  A typical entry in a Makefile or Makefile.am is:
7
 
 
8
 
manpage.1: manpage.sgml
9
 
        docbook-to-man $< > $@
10
 
 
11
 
    
12
 
        The docbook-to-man binary is found in the docbook-to-man package.
13
 
        Please remember that if you create the nroff version in one of the
14
 
        debian/rules file targets (such as build), you will need to include
15
 
        docbook-to-man in your Build-Depends control field.
16
 
 
17
 
  -->
18
 
 
19
 
  <!-- Fill in your name for FIRSTNAME and SURNAME. -->
20
 
  <!ENTITY dhfirstname "<firstname>Paul</firstname>">
21
 
  <!ENTITY dhsurname   "<surname>Russell</surname>">
22
 
  <!-- Please adjust the date whenever revising the manpage. -->
23
 
  <!ENTITY dhdate      "<date>March 16, 2004</date>">
24
 
  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
25
 
       allowed: see man(7), man(1). -->
26
 
  <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
27
 
  <!ENTITY dhemail     "<email>prussell@debian.org</email>">
28
 
  <!ENTITY dhusername  "Paul Russell">
29
 
  <!ENTITY dhucpackage "<refentrytitle>QEMU</refentrytitle>">
30
 
  <!ENTITY dhpackage   "qemu-i386">
31
 
 
32
 
  <!ENTITY debian      "<productname>Debian</productname>">
33
 
  <!ENTITY gnu         "<acronym>GNU</acronym>">
34
 
  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
35
 
]>
36
 
 
37
 
<refentry>
38
 
  <refentryinfo>
39
 
    <address>
40
 
      &dhemail;
41
 
    </address>
42
 
    <author>
43
 
      &dhfirstname;
44
 
      &dhsurname;
45
 
    </author>
46
 
    <copyright>
47
 
      <year>2004</year>
48
 
      <holder>&dhusername;</holder>
49
 
    </copyright>
50
 
    &dhdate;
51
 
  </refentryinfo>
52
 
  <refmeta>
53
 
    &dhucpackage;
54
 
 
55
 
    &dhsection;
56
 
  </refmeta>
57
 
  <refnamediv>
58
 
    <refname>&dhpackage;</refname>
59
 
 
60
 
    <refpurpose>Run a Linux i386 binary under emulation</refpurpose>
61
 
  </refnamediv>
62
 
  <refsynopsisdiv>
63
 
    <cmdsynopsis>
64
 
      <command>&dhpackage;</command>
65
 
 
66
 
      <arg><option>-h</option></arg>
67
 
      <arg><option>-L <replaceable>path</replaceable></option></arg>
68
 
      <arg><option>-s <replaceable>size</replaceable></option></arg>
69
 
      <arg><option>-d</option></arg>
70
 
      <arg><option>-p <replaceable>pagesize</replaceable></option></arg>
71
 
      <arg><replaceable>program</replaceable></arg>
72
 
      <arg><option>options...</option></arg>
73
 
    </cmdsynopsis>
74
 
  </refsynopsisdiv>
75
 
  <refsect1>
76
 
    <title>DESCRIPTION</title>
77
 
 
78
 
    <para>
79
 
      The <command>&dhpackage;</command> command provides user mode
80
 
      emulation.  In this mode, QEMU can launch Linux processes
81
 
      compiled for one CPU on another CPU: currently only Intel (x86)
82
 
      binaries are supported in the &debian; package.  Linux system
83
 
      calls are converted because of endianness and 32/64 bit
84
 
      mismatches.
85
 
    </para>
86
 
 
87
 
    <para>
88
 
      QEMU x86 target features:
89
 
      <itemizedlist>
90
 
        <listitem>
91
 
          <para>The virtual x86 CPU supports 16 bit and 32 bit addressing
92
 
          with segmentation. LDT/GDT and IDT are emulated. VM86 mode
93
 
          is also supported to run DOSEMU.</para>
94
 
        </listitem>
95
 
        <listitem>
96
 
          <para>Support of host page sizes bigger than 4KB.</para>
97
 
        </listitem>
98
 
        <listitem>
99
 
          <para>QEMU can emulate itself on x86.</para>
100
 
        </listitem>
101
 
      </itemizedlist>
102
 
    </para>
103
 
 
104
 
    <para>
105
 
      QEMU limitations:
106
 
      <itemizedlist>
107
 
        <listitem>
108
 
          <para>No SSE/MMX support (yet).</para>
109
 
        </listitem>
110
 
        <listitem>
111
 
          <para>No x86-64 support.</para>
112
 
        </listitem>
113
 
        <listitem>
114
 
          <para>IPC syscalls are missing.</para>
115
 
        </listitem>
116
 
        <listitem>
117
 
          <para>The x86 segment limits and access rights are not tested at
118
 
            every memory access.</para>
119
 
        </listitem>
120
 
        <listitem>
121
 
          <para>On non x86 host CPUs, doubles are used instead of the non
122
 
            standard 10 byte long doubles of x86 for floating point
123
 
            emulation to get maximum performances.</para>
124
 
        </listitem>
125
 
        <listitem>
126
 
          <para>Some priviledged instructions or behaviors are missing,
127
 
            especially for segment protection testing (yet).</para>
128
 
        </listitem>
129
 
      </itemizedlist>
130
 
    </para>
131
 
  </refsect1>
132
 
  <refsect1>
133
 
    <title>OPTIONS</title>
134
 
 
135
 
    <para>
136
 
      A summary of options is included below.
137
 
    </para>
138
 
    <variablelist>
139
 
      <varlistentry>
140
 
        <term><option>-h</option>
141
 
        </term>
142
 
        <listitem>
143
 
          <para>Print the help message</para>
144
 
        </listitem>
145
 
      </varlistentry>
146
 
      <varlistentry>
147
 
        <term><option>-L <replaceable>path</replaceable></option>
148
 
        </term>
149
 
        <listitem>
150
 
          <para>
151
 
            Where to find the ELF dynamic linker: default is
152
 
            /usr/gnemul/qemu-i386.  On x86, you will want to use "-L
153
 
            /" to use the native linker.  On PowerPC, you'll have to
154
 
            install an x86 ld.so: one is available from the
155
 
            QEMU homepage.
156
 
          </para>
157
 
        </listitem>
158
 
      </varlistentry>
159
 
      <varlistentry>
160
 
        <term><option>-s <replaceable>size</replaceable></option>
161
 
        </term>
162
 
        <listitem>
163
 
          <para>
164
 
            Set the stack size in bytes (default 524228).
165
 
          </para>
166
 
        </listitem>
167
 
      </varlistentry>
168
 
      <varlistentry>
169
 
        <term><option>-d</option>
170
 
        </term>
171
 
        <listitem>
172
 
          <para>
173
 
            Activate debug log in /tmp/qemu.log.
174
 
          </para>
175
 
        </listitem>
176
 
      </varlistentry>
177
 
      <varlistentry>
178
 
        <term><option>-p <replaceable>pagesize</replaceable></option>
179
 
        </term>
180
 
        <listitem>
181
 
          <para>
182
 
            Act as if the host page size was
183
 
            <replaceable>pagesize</replaceable> bytes.
184
 
          </para>
185
 
        </listitem>
186
 
      </varlistentry>
187
 
    </variablelist>
188
 
  </refsect1>
189
 
  <refsect1>
190
 
    <title>SEE ALSO</title>
191
 
 
192
 
    <para>qemu(1).</para>
193
 
 
194
 
  </refsect1>
195
 
  <refsect1>
196
 
    <title>AUTHOR</title>
197
 
 
198
 
    <para>This manual page was written by &dhusername; &dhemail; for
199
 
      the &debian; system (but may be used by others).  Permission is
200
 
      granted to copy, distribute and/or modify this document under
201
 
      the terms of the &gnu; General Public License, Version 2 any 
202
 
          later version published by the Free Software Foundation.
203
 
    </para>
204
 
        <para>
205
 
          On Debian systems, the complete text of the GNU General Public
206
 
          License can be found in /usr/share/common-licenses/GPL.
207
 
        </para>
208
 
 
209
 
  </refsect1>
210
 
</refentry>
211
 
 
212
 
<!-- Keep this comment at the end of the file
213
 
Local variables:
214
 
mode: sgml
215
 
sgml-omittag:t
216
 
sgml-shorttag:t
217
 
sgml-minimize-attributes:nil
218
 
sgml-always-quote-attributes:t
219
 
sgml-indent-step:2
220
 
sgml-indent-data:t
221
 
sgml-parent-document:nil
222
 
sgml-default-dtd-file:nil
223
 
sgml-exposed-tags:nil
224
 
sgml-local-catalogs:nil
225
 
sgml-local-ecat-files:nil
226
 
End:
227
 
-->
228
 
 
229