/[public]/qemu-start/trunk/qemu-start.1
ViewVC logotype

Diff of /qemu-start/trunk/qemu-start.1

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 290 Revision 314
1.\" Hey, EMACS: -*- nroff -*- 1.\" Hey, EMACS: -*- nroff -*-
2.\" First parameter, NAME, should be all caps 2.\" First parameter, NAME, should be all caps
3.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection 3.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
4.\" other parameters are allowed: see man(7), man(1) 4.\" other parameters are allowed: see man(7), man(1)
5.TH QEMU-START 1 "February 10, 2006" 5.TH QEMU-START 1 "April 9, 2008"
6.\" Please adjust this date whenever revising the manpage. 6.\" Please adjust this date whenever revising the manpage.
7.\" 7.\"
8.\" Some roff macros, for reference: 8.\" Some roff macros, for reference:
9.\" .nh disable hyphenation 9.\" .nh disable hyphenation
10.\" .hy enable hyphenation 10.\" .hy enable hyphenation
17.\" for manpage-specific macros, see man(7) 17.\" for manpage-specific macros, see man(7)
18.SH NAME 18.SH NAME
19qemu\-start \- start qemu safely with tap devices 19qemu\-start \- start qemu safely with tap devices
20.SH SYNOPSIS 20.SH SYNOPSIS
21.B qemu\-start 21.B qemu\-start
22.I TAPDEVNR VLAN SYSTEM QEMUOPTS... 22.I [OPTIONS] -- QEMUOPTS...
23.SH DESCRIPTION 23.SH DESCRIPTION
24This manual page documents the 24This manual page documents the
25.B qemu-start 25.B qemu-start
26command. 26command.
27.PP 27.PP
37is created; only members of this group are allowed to start qemu. Qemu is 37is created; only members of this group are allowed to start qemu. Qemu is
38started with one ethernet interface, which is bound through a tap 38started with one ethernet interface, which is bound through a tap
39device. Xauthority data is 39device. Xauthority data is
40automatically transferred if the DISPLAY variable is set. 40automatically transferred if the DISPLAY variable is set.
41.SH PARAMETERS 41.SH PARAMETERS
42The first parameter 42The parameter
43.B TAPDEVNR 43.B --tapnr TAPDEVNR
44is the number of the tap\-device. Use 0 for tap0, etc. See below how you 44is the number of the tap\-device. Use 0 for tap0, etc. See below how you
45safely can define tap devices. 45safely can define tap devices.
46.PP 46.PP
47The second parameter 47The parameter
48.B VLAN 48.B --vlan VLAN
49is the VLAN you want to add this adapter to. Usually, 49is the VLAN you want to add this adapter to. Usually,
50using 0 will do. 50using 0 will do.
51.PP 51.PP
52The third parameter 52The parameter
53.B SYSTEM 53.B --nic-model NICMODEL
54is the model type of the emulated nic presented to the guest os. Use
55qemu -net nic,model=? for information on allowed values for this
56parameter
57.PP
58The parameter
59.B --macaddr MACADDRESS
60sets the MAC address for the emulated nic presented to guest os.
61.PP
62The parameter
63.B --system SYSTEM
54is the system you want to emulate. Use "" if you want to use your current 64is the system you want to emulate. Leave out if you want to use your current
55architecture; in this case, 65architecture; in this case,
56.B /usr/bin/qemm 66.B /usr/bin/qemu
57will be called. If you want to simulate some other type of system, specify 67will be called. If you want to simulate some other type of system, specify
58it here; in that case, 68it here; in that case,
59.B /usr/bin/qemm-system-SYSTEM 69.B /usr/bin/qemu-system-SYSTEM
60will be called. 70will be called.
61.PP 71.PP
72The parameter
73.B --window-left X
74sets the left-most column of the window (in pixels) to X.
75.PP
76The parameter
77.B --window-top Y
78sets the top-most row of the window (in pixels) to Y.
79.PP
62All other options and parameters are fed to qemm. 80All options and parameters after -- are fed to qemu.
63.SH TAP DEVICE 81.SH TAP DEVICE (DEBIAN SPECIFIC)
64You must create a tap device for use by qemu. The nicest way of doing this 82You must create a tap device for use by qemu. The nicest way of doing this
65is combining it with a bridge. This section describes how you can do this. 83is combining it with a bridge. This section describes how you can do this.
84.PP
85Make sure you have the packages
86.I bridge-utils
87and
88.I uml-utilities
89installed.
66.PP 90.PP
67Edit 91Edit
68.BR /etc/network/interfaces . 92.BR /etc/network/interfaces .
69Find the section where your current ethernet interface is described; we will 93Find the section where your current ethernet interface is described; we will
70assume here it is 94assume here it is

Legend:
Removed from v.290  
changed lines
  Added in v.314

frodo@frodo.looijaard.name
ViewVC Help
Powered by ViewVC 1.1.26