[qemu.git] / README

The QEMU x86 emulator
---------------------

INSTALLATION
------------

Type 

    ./configure --interp-prefix=/usr/local/qemu-i386
    make

to build qemu and libqemu.a.

Type

    make install

to install QEMU in /usr/local/bin

* On x86 you should be able to launch any program by using the
libraries installed on your PC. For example:

    ./qemu -L / /bin/ls

* On non x86 CPUs, you need first to download at least an x86 glibc
(qemu-XXX-i386-glibc21.tar.gz on the qemu web page). Ensure that
LD_LIBRARY_PATH is not set:

    unset LD_LIBRARY_PATH 

Then you can launch the precompiled 'ls' x86 executable:

    ./qemu /usr/local/qemu-i386/bin/ls-i386

You can look at /usr/local/qemu-i386/bin/qemu-conf.sh so that QEMU is
automatically launched by the Linux kernel when you try to launch x86
executables.

Documentation
-------------

Read the documentation in qemu-doc.html.


Fabrice Bellard.
Commit	Line	Data
	1	The QEMU x86 emulator
	2	---------------------
	3
	4	INSTALLATION
	5	------------
	6
	7	Type
	8
	9	./configure --interp-prefix=/usr/local/qemu-i386
	10	make
	11
	12	to build qemu and libqemu.a.
	13
	14	Type
	15
	16	make install
	17
	18	to install QEMU in /usr/local/bin
	19
	20	* On x86 you should be able to launch any program by using the
	21	libraries installed on your PC. For example:
	22
	23	./qemu -L / /bin/ls
	24
	25	* On non x86 CPUs, you need first to download at least an x86 glibc
	26	(qemu-XXX-i386-glibc21.tar.gz on the qemu web page). Ensure that
	27	LD_LIBRARY_PATH is not set:
	28
	29	unset LD_LIBRARY_PATH
	30
	31	Then you can launch the precompiled 'ls' x86 executable:
	32
	33	./qemu /usr/local/qemu-i386/bin/ls-i386
	34
	35	You can look at /usr/local/qemu-i386/bin/qemu-conf.sh so that QEMU is
	36	automatically launched by the Linux kernel when you try to launch x86
	37	executables.
	38
	39	Documentation
	40	-------------
	41
	42	Read the documentation in qemu-doc.html.
	43
	44
	45	Fabrice Bellard.