docs/user/main.rst

1 .. _user-mode:
3 QEMU User space emulator
7 ---------------------------
9 The following OS are supported in user space emulation:
11 -  Linux (referred as qemu-linux-user)
13 -  BSD (referred as qemu-bsd-user)
16 --------
18 QEMU user space emulation has the following notable features:
23 System calls are the principle interface between user-space and the
41 for example to emulate the signal mask. On Linux, QEMU supports both
42 normal and real-time signals.
47 On Linux, QEMU can emulate the ``clone`` syscall and create a real
52 supported. QEMU user-mode processes can still be run inside containers
63 .. _linux-user-mode:
65 Linux User space emulator
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``
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``
115    ``/tmp/qemu-%d.sock``), it is replaced by the emulator PID, which is useful
117    multi-process application.
123 ``-one-insn-per-tb``
126    such as when trying to analyse the logs produced by the ``-d`` option.
132    (NOTE: the actual 'strace' program will not work because the user
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:
210 BSD User space emulator
211 -----------------------
216 -  target Sparc64 on Sparc64: Some trivial programs work.
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``
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.