| 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 |
| 19 | qemu\-start \- start qemu safely with tap devices |
19 | qemu\-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 |
| 24 | This manual page documents the |
24 | This manual page documents the |
| 25 | .B qemu-start |
25 | .B qemu-start |
| 26 | command. |
26 | command. |
| 27 | .PP |
27 | .PP |
| … | |
… | |
| 37 | is created; only members of this group are allowed to start qemu. Qemu is |
37 | is created; only members of this group are allowed to start qemu. Qemu is |
| 38 | started with one ethernet interface, which is bound through a tap |
38 | started with one ethernet interface, which is bound through a tap |
| 39 | device. Xauthority data is |
39 | device. Xauthority data is |
| 40 | automatically transferred if the DISPLAY variable is set. |
40 | automatically transferred if the DISPLAY variable is set. |
| 41 | .SH PARAMETERS |
41 | .SH PARAMETERS |
| 42 | The first parameter |
42 | The parameter |
| 43 | .B TAPDEVNR |
43 | .B --tapnr TAPDEVNR |
| 44 | is the number of the tap\-device. Use 0 for tap0, etc. See below how you |
44 | is the number of the tap\-device. Use 0 for tap0, etc. See below how you |
| 45 | safely can define tap devices. |
45 | safely can define tap devices. |
| 46 | .PP |
46 | .PP |
| 47 | The second parameter |
47 | The parameter |
| 48 | .B VLAN |
48 | .B --vlan VLAN |
| 49 | is the VLAN you want to add this adapter to. Usually, |
49 | is the VLAN you want to add this adapter to. Usually, |
| 50 | using 0 will do. |
50 | using 0 will do. |
| 51 | .PP |
51 | .PP |
| 52 | The third parameter |
52 | The parameter |
| 53 | .B SYSTEM |
53 | .B --nic-model NICMODEL |
|
|
54 | is the model type of the emulated nic presented to the guest os. Use |
|
|
55 | qemu -net nic,model=? for information on allowed values for this |
|
|
56 | parameter |
|
|
57 | .PP |
|
|
58 | The parameter |
|
|
59 | .B --macaddr MACADDRESS |
|
|
60 | sets the MAC address for the emulated nic presented to guest os. |
|
|
61 | .PP |
|
|
62 | The parameter |
|
|
63 | .B --system SYSTEM |
| 54 | is the system you want to emulate. Use "" if you want to use your current |
64 | is the system you want to emulate. Leave out if you want to use your current |
| 55 | architecture; in this case, |
65 | architecture; in this case, |
| 56 | .B /usr/bin/qemm |
66 | .B /usr/bin/qemu |
| 57 | will be called. If you want to simulate some other type of system, specify |
67 | will be called. If you want to simulate some other type of system, specify |
| 58 | it here; in that case, |
68 | it here; in that case, |
| 59 | .B /usr/bin/qemm-system-SYSTEM |
69 | .B /usr/bin/qemu-system-SYSTEM |
| 60 | will be called. |
70 | will be called. |
| 61 | .PP |
71 | .PP |
|
|
72 | The parameter |
|
|
73 | .B --window-left X |
|
|
74 | sets the left-most column of the window (in pixels) to X. |
|
|
75 | .PP |
|
|
76 | The parameter |
|
|
77 | .B --window-top Y |
|
|
78 | sets the top-most row of the window (in pixels) to Y. |
|
|
79 | .PP |
| 62 | All other options and parameters are fed to qemm. |
80 | All options and parameters after -- are fed to qemu. |
| 63 | .SH TAP DEVICE |
81 | .SH TAP DEVICE (DEBIAN SPECIFIC) |
| 64 | You must create a tap device for use by qemu. The nicest way of doing this |
82 | You must create a tap device for use by qemu. The nicest way of doing this |
| 65 | is combining it with a bridge. This section describes how you can do this. |
83 | is combining it with a bridge. This section describes how you can do this. |
|
|
84 | .PP |
|
|
85 | Make sure you have the packages |
|
|
86 | .I bridge-utils |
|
|
87 | and |
|
|
88 | .I uml-utilities |
|
|
89 | installed. |
| 66 | .PP |
90 | .PP |
| 67 | Edit |
91 | Edit |
| 68 | .BR /etc/network/interfaces . |
92 | .BR /etc/network/interfaces . |
| 69 | Find the section where your current ethernet interface is described; we will |
93 | Find the section where your current ethernet interface is described; we will |
| 70 | assume here it is |
94 | assume here it is |
Parent Directory
| 
Revision Log
| 
Patch