| 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'. |