Revision d691f669 qemu-doc.texi
| b/qemu-doc.texi | ||
|---|---|---|
| 73 | 73 |
|
| 74 | 74 |
@chapter Invocation |
| 75 | 75 |
|
| 76 |
@section Quick Start |
|
| 77 |
|
|
| 76 | 78 |
In order to launch a Linux process, QEMU needs the process executable |
| 77 |
itself and all the target (x86) dynamic libraries used by it. Currently,
|
|
| 78 |
QEMU is not distributed with the necessary packages so that you can test |
|
| 79 |
it easily on non x86 CPUs.
|
|
| 79 |
itself and all the target (x86) dynamic libraries used by it. |
|
| 80 |
|
|
| 81 |
@itemize
|
|
| 80 | 82 |
|
| 81 |
However, the statically x86 binary 'tests/hello' can be used to do a
|
|
| 82 |
first test:
|
|
| 83 |
@item On x86, you can just try to launch any process by using the native
|
|
| 84 |
libraries:
|
|
| 83 | 85 |
|
| 84 | 86 |
@example |
| 85 |
qemu tests/hello
|
|
| 87 |
qemu -L / /bin/ls
|
|
| 86 | 88 |
@end example |
| 87 | 89 |
|
| 88 |
@code{Hello world} should be printed on the terminal.
|
|
| 90 |
@code{-L /} tells that the x86 dynamic linker must be searched with a
|
|
| 91 |
@file{/} prefix.
|
|
| 89 | 92 |
|
| 90 |
If you are testing it on a x86 CPU, then you can test it on any process: |
|
| 91 | 93 |
|
| 92 |
@example |
|
| 93 |
qemu /bin/ls -l |
|
| 94 |
@item On non x86 CPUs, you need first to download at least an x86 glibc |
|
| 95 |
(@file{qemu-i386-glibc21.tar.gz} on the QEMU web page). Then you can
|
|
| 96 |
launch the precompiled @file{ls} x86 executable:
|
|
| 97 |
@example |
|
| 98 |
qemu /usr/local/qemu-i386/bin/ls |
|
| 99 |
@end example |
|
| 100 |
You can look at @file{/usr/local/qemu-i386/bin/qemu-conf.sh} so that QEMU is automatically
|
|
| 101 |
launched by the Linux kernel when you try to launch x86 executables. It |
|
| 102 |
requires the @code{binfmt_misc} module in the Linux kernel.
|
|
| 103 |
|
|
| 104 |
@end itemize |
|
| 105 |
|
|
| 106 |
@section Command line options |
|
| 107 |
|
|
| 108 |
@example |
|
| 109 |
usage: qemu [-h] [-d] [-L path] [-s size] program [arguments...] |
|
| 94 | 110 |
@end example |
| 95 | 111 |
|
| 112 |
@table @samp |
|
| 113 |
@item -h |
|
| 114 |
Print the help |
|
| 115 |
@item -d |
|
| 116 |
Activate log (logfile=/tmp/qemu.log) |
|
| 117 |
@item -L path |
|
| 118 |
Set the x86 elf interpreter prefix (default=/usr/local/qemu-i386) |
|
| 119 |
@item -s size |
|
| 120 |
Set the x86 stack size in bytes (default=524288) |
|
| 121 |
@end table |
|
| 122 |
|
|
| 96 | 123 |
@chapter QEMU Internals |
| 97 | 124 |
|
| 98 | 125 |
@section QEMU compared to other emulators |
Also available in: Unified diff