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