--- qemu-start/trunk/qemu-start.1 2007/11/09 14:07:44 313 +++ qemu-start/trunk/qemu-start.1 2008/04/09 19:00:11 314 @@ -2,7 +2,7 @@ .\" First parameter, NAME, should be all caps .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" other parameters are allowed: see man(7), man(1) -.TH QEMU-START 1 "February 10, 2006" +.TH QEMU-START 1 "April 9, 2008" .\" Please adjust this date whenever revising the manpage. .\" .\" Some roff macros, for reference: @@ -19,7 +19,7 @@ qemu\-start \- start qemu safely with tap devices .SH SYNOPSIS .B qemu\-start -.I TAPDEVNR VLAN SYSTEM QEMUOPTS... +.I [OPTIONS] -- QEMUOPTS... .SH DESCRIPTION This manual page documents the .B qemu-start @@ -39,31 +39,55 @@ device. Xauthority data is automatically transferred if the DISPLAY variable is set. .SH PARAMETERS -The first parameter -.B TAPDEVNR +The parameter +.B --tapnr TAPDEVNR is the number of the tap\-device. Use 0 for tap0, etc. See below how you safely can define tap devices. .PP -The second parameter -.B VLAN +The parameter +.B --vlan VLAN is the VLAN you want to add this adapter to. Usually, using 0 will do. -.PP -The third parameter -.B SYSTEM -is the system you want to emulate. Use "" if you want to use your current +.PP +The parameter +.B --nic-model NICMODEL +is the model type of the emulated nic presented to the guest os. Use +qemu -net nic,model=? for information on allowed values for this +parameter +.PP +The parameter +.B --macaddr MACADDRESS +sets the MAC address for the emulated nic presented to guest os. +.PP +The parameter +.B --system SYSTEM +is the system you want to emulate. Leave out if you want to use your current architecture; in this case, -.B /usr/bin/qemm +.B /usr/bin/qemu will be called. If you want to simulate some other type of system, specify it here; in that case, -.B /usr/bin/qemm-system-SYSTEM +.B /usr/bin/qemu-system-SYSTEM will be called. .PP -All other options and parameters are fed to qemm. -.SH TAP DEVICE +The parameter +.B --window-left X +sets the left-most column of the window (in pixels) to X. +.PP +The parameter +.B --window-top Y +sets the top-most row of the window (in pixels) to Y. +.PP +All options and parameters after -- are fed to qemu. +.SH TAP DEVICE (DEBIAN SPECIFIC) You must create a tap device for use by qemu. The nicest way of doing this is combining it with a bridge. This section describes how you can do this. .PP +Make sure you have the packages +.I bridge-utils +and +.I uml-utilities +installed. +.PP Edit .BR /etc/network/interfaces . Find the section where your current ethernet interface is described; we will