docs/user/main.rst

1 .. _user-mode:
3 QEMU User space emulator
7 ---------------------------
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:
20 **System call translation:**
21    QEMU includes a generic system call translator. This means that the
22    parameters of the system calls can be converted to fix endianness and
23    32/64-bit mismatches between hosts and targets. IOCTLs can be
27    QEMU can redirect to the running program all signals coming from the
32    QEMU relies on the host kernel to emulate most signal system calls,
33    for example to emulate the signal mask. On Linux, QEMU supports both
34    normal and real-time signals.
37    On Linux, QEMU can emulate the ``clone`` syscall and create a real
43 QEMU was conceived so that ultimately it can emulate itself. Although it
47 .. _linux-user-mode:
50 -------------------------
57 …qemu-i386 [-h] [-d] [-L path] [-s size] [-cpu model] [-g endpoint] [-B offset] [-R size] program […
59 ``-h``
62 ``-L path``
63    Set the x86 elf interpreter prefix (default=/usr/local/qemu-i386)
65 ``-s size``
68 ``-cpu model``
69    Select CPU model (-cpu help for list and additional feature
72 ``-E var=value``
75 ``-U var``
78 ``-B offset``
83 ``-R size``
84    Pre-allocate a guest virtual address space of the given size (in
90 ``-d item1,...``
91    Activate logging of the specified items (use '-d help' for a list of
94 ``-g endpoint``
96    ``/tmp/qemu.sock``).
99    ``/tmp/qemu-%d.sock``), it is replaced by the emulator PID, which is useful
101    multi-process application.
107 ``-one-insn-per-tb``
110    such as when trying to analyse the logs produced by the ``-d`` option.
115    Print system calls and arguments similar to the 'strace' program
118    incomplete. All system calls that don't have a specific argument
120    flag-style arguments don't have decoders and will show up as numbers.
125 -  user mode (Alpha)
127    * ``qemu-alpha`` TODO.
129 -  user mode (Arm)
131    * ``qemu-armeb`` TODO.
133    * ``qemu-arm`` is also capable of running Arm \"Angel\" semihosted ELF
134      binaries (as implemented by the arm-elf and arm-eabi Newlib/GDB
135      configurations), and arm-uclinux bFLT format binaries.
137 -  user mode (ColdFire)
139 -  user mode (M68K)
141    * ``qemu-m68k`` is capable of running semihosted binaries using the BDM
142      (m5xxx-ram-hosted.ld) or m68k-sim (sim.ld) syscall interfaces, and
147 -  user mode (i386)
149    * ``qemu-i386`` TODO.
150    * ``qemu-x86_64`` TODO.
152 -  user mode (Microblaze)
154    * ``qemu-microblaze`` TODO.
156 -  user mode (MIPS)
158    * ``qemu-mips`` executes 32-bit big endian MIPS binaries (MIPS O32 ABI).
160    * ``qemu-mipsel`` executes 32-bit little endian MIPS binaries (MIPS O32 ABI).
162    * ``qemu-mips64`` executes 64-bit big endian MIPS binaries (MIPS N64 ABI).
164    * ``qemu-mips64el`` executes 64-bit little endian MIPS binaries (MIPS N64
167    * ``qemu-mipsn32`` executes 32-bit big endian MIPS binaries (MIPS N32 ABI).
169    * ``qemu-mipsn32el`` executes 32-bit little endian MIPS binaries (MIPS N32
172 -  user mode (PowerPC)
174    * ``qemu-ppc64`` TODO.
175    * ``qemu-ppc`` TODO.
177 -  user mode (SH4)
179    * ``qemu-sh4eb`` TODO.
180    * ``qemu-sh4`` TODO.
182 -  user mode (SPARC)
184    * ``qemu-sparc`` can execute Sparc32 binaries (Sparc32 CPU, 32 bit ABI).
186    * ``qemu-sparc32plus`` can execute Sparc32 and SPARC32PLUS binaries
189    * ``qemu-sparc64`` can execute some Sparc64 (Sparc64 CPU, 64 bit ABI) and
192 .. _bsd-user-mode:
195 -----------------------
200 -  target Sparc64 on Sparc64: Some trivial programs work.
205 In order to launch a BSD process, QEMU needs the process executable
208 -  On Sparc64, you can just try to launch any process by using the
211       qemu-sparc64 /bin/ls
218    qemu-sparc64 [-h] [-d] [-L path] [-s size] [-bsd type] program [arguments...]
220 ``-h``
223 ``-L path``
226 ``-s size``
229 ``-ignore-environment``
233 ``-E var=value``
236 ``-U var``
239 ``-bsd type``
240    Set the type of the emulated BSD Operating system. Valid values are
245 ``-d item1,...``
246    Activate logging of the specified items (use '-d help' for a list of
249 ``-p pagesize``
252 ``-one-insn-per-tb``
255    such as when trying to analyse the logs produced by the ``-d`` option.