| 1 |
qemu-start is a small program that helps you start qemu in a safe and |
| 2 |
useful way. It has the following features: |
| 3 |
* Start qemu as a non-privileged user |
| 4 |
* Run qemu as a non-root user |
| 5 |
* Propegates xauth information |
| 6 |
* Only selected users can start qemu |
| 7 |
* Existing tap network devices can be bound |
| 8 |
|
| 9 |
It presumes all qemu instances will run under the same user-id (qemu). A group |
| 10 |
emulator is created; only members of this group are allowed to start qemu. Qemu |
| 11 |
is started with one ethernet interface, which is bound through a tap device. |
| 12 |
Xauthority data is automatically transferred if the DISPLAY variable is set. |
| 13 |
|
| 14 |
|
| 15 |
USING THIS PACKAGE |
| 16 |
================== |
| 17 |
|
| 18 |
Add any users that may start qemu to the emulator group. |
| 19 |
Create a tap-device, like described in the manual page or in some other |
| 20 |
way. |
| 21 |
Now you are ready to call qemu-start. |
| 22 |
If you have a DISPLAY variable set, the xauth key will be imported into |
| 23 |
the .Xauthority file of the qemu user. That means it will be able to |
| 24 |
display qemu on your X display. |
| 25 |
|
| 26 |
|
| 27 |
NON-DEBIAN SYSTEMS |
| 28 |
================== |
| 29 |
|
| 30 |
This package is somewhat Debian-centric. It might still be useful if you |
| 31 |
use some other distribution, though. You will have to create a |
| 32 |
group emulator, and a user qemu yourself. The qemu user does not need a |
| 33 |
password, and /bin/false is a good shell. Afterwards, compile the package |
| 34 |
by calling `make' and install it by calling `make install'. |