docs/user/main.rst

1 .. _user-mode:
7 ---------------------------
11 -  Linux (referred as qemu-linux-user)
13 -  BSD (referred as qemu-bsd-user)
16 --------
23 System calls are the principle interface between user-space and the
35 QEMU can redirect to the running program all signals coming from the
40 QEMU relies on the host kernel to emulate most signal system calls,
41 for example to emulate the signal mask. On Linux, QEMU supports both
42 normal and real-time signals.
49 However as QEMU relies on the system libc to call ``clone`` on its
50 behalf we limit the flags accepted to those it uses. Specifically this
52 supported. QEMU user-mode processes can still be run inside containers
55 While QEMU does its best to emulate atomic operations properly
60 is not very useful, it is an important test to show the power of the
63 .. _linux-user-mode:
66 -------------------------
73 …qemu-i386 [-h] [-d] [-L path] [-s size] [-cpu model] [-g endpoint] [-B offset] [-R size] program […
75 ``-h``
78 ``-L path``
79    Set the x86 elf interpreter prefix (default=/usr/local/qemu-i386)
81 ``-s size``
84 ``-cpu model``
85    Select CPU model (-cpu help for list and additional feature
88 ``-E var=value``
89    Set environment var to value.
91 ``-U var``
94 ``-B offset``
99 ``-R size``
100    Pre-allocate a guest virtual address space of the given size (in
106 ``-d item1,...``
107    Activate logging of the specified items (use '-d help' for a list of
110 ``-g endpoint``
111    Wait gdb connection to a port (e.g., ``1234``) or a unix socket (e.g.,
115    ``/tmp/qemu-%d.sock``), it is replaced by the emulator PID, which is useful
116    when passing this option via the ``QEMU_GDB`` environment variable to a
117    multi-process application.
119    If the endpoint address is followed by ``,suspend=n`` (e.g.,
120    ``1234,suspend=n``), then the emulated program starts without waiting for a
123 ``-one-insn-per-tb``
126    such as when trying to analyse the logs produced by the ``-d`` option.
131    Print system calls and arguments similar to the 'strace' program
136    flag-style arguments don't have decoders and will show up as numbers.
141 -  user mode (Alpha)
143    * ``qemu-alpha`` TODO.
145 -  user mode (Arm)
147    * ``qemu-armeb`` TODO.
149    * ``qemu-arm`` is also capable of running Arm \"Angel\" semihosted ELF
150      binaries (as implemented by the arm-elf and arm-eabi Newlib/GDB
151      configurations), and arm-uclinux bFLT format binaries.
153 -  user mode (ColdFire)
155 -  user mode (M68K)
157    * ``qemu-m68k`` is capable of running semihosted binaries using the BDM
158      (m5xxx-ram-hosted.ld) or m68k-sim (sim.ld) syscall interfaces, and
163 -  user mode (i386)
165    * ``qemu-i386`` TODO.
166    * ``qemu-x86_64`` TODO.
168 -  user mode (Microblaze)
170    * ``qemu-microblaze`` TODO.
172 -  user mode (MIPS)
174    * ``qemu-mips`` executes 32-bit big endian MIPS binaries (MIPS O32 ABI).
176    * ``qemu-mipsel`` executes 32-bit little endian MIPS binaries (MIPS O32 ABI).
178    * ``qemu-mips64`` executes 64-bit big endian MIPS binaries (MIPS N64 ABI).
180    * ``qemu-mips64el`` executes 64-bit little endian MIPS binaries (MIPS N64
183    * ``qemu-mipsn32`` executes 32-bit big endian MIPS binaries (MIPS N32 ABI).
185    * ``qemu-mipsn32el`` executes 32-bit little endian MIPS binaries (MIPS N32
188 -  user mode (PowerPC)
190    * ``qemu-ppc64`` TODO.
191    * ``qemu-ppc`` TODO.
193 -  user mode (SH4)
195    * ``qemu-sh4eb`` TODO.
196    * ``qemu-sh4`` TODO.
198 -  user mode (SPARC)
200    * ``qemu-sparc`` can execute Sparc32 binaries (Sparc32 CPU, 32 bit ABI).
202    * ``qemu-sparc32plus`` can execute Sparc32 and SPARC32PLUS binaries
205    * ``qemu-sparc64`` can execute some Sparc64 (Sparc64 CPU, 64 bit ABI) and
208 .. _bsd-user-mode:
211 -----------------------
216 -  target Sparc64 on Sparc64: Some trivial programs work.
221 In order to launch a BSD process, QEMU needs the process executable
224 -  On Sparc64, you can just try to launch any process by using the
227       qemu-sparc64 /bin/ls
234    qemu-sparc64 [-h] [-d] [-L path] [-s size] [-bsd type] program [arguments...]
236 ``-h``
239 ``-L path``
242 ``-s size``
245 ``-ignore-environment``
249 ``-E var=value``
250    Set environment var to value.
252 ``-U var``
255 ``-bsd type``
261 ``-d item1,...``
262    Activate logging of the specified items (use '-d help' for a list of
265 ``-p pagesize``
268 ``-one-insn-per-tb``
271    such as when trying to analyse the logs produced by the ``-d`` option.