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    32/64-bit mismatches between hosts and targets. IOCTLs can be
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
47 .. _linux-user-mode:
49 Linux User space emulator
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``
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.
116    (NOTE: the actual 'strace' program will not work because the user
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:
194 BSD User space emulator
195 -----------------------
200 -  target Sparc64 on Sparc64: Some trivial programs work.
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``
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.