-
Notifications
You must be signed in to change notification settings - Fork 10
/
Copy pathvdeq.1.html
323 lines (232 loc) · 6.95 KB
/
vdeq.1.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
Content-type: text/html; charset=UTF-8
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of VDEQ</TITLE>
</HEAD><BODY>
<H1>VDEQ</H1>
Section: User Commands (1)<BR>Updated: December 6, 2006<BR><A HREF="#index">Index</A>
<A HREF="/#/man/index">Return to Main Contents</A><HR>
<A NAME="lbAB"> </A>
<H2>NAME</H2>
vdeq - Virtual Distributed Ethernet wrapper for QEMU/KVM virtual machines
<A NAME="lbAC"> </A>
<H2>SYNOPSIS</H2>
<B>vdeq</B>
<B>qemu</B>
[
<B>--mod</B>
<I>octalmode</I>
]
<I>QEMU_OPTIONS</I>
<B>-net vde[,vlan=n][,sock=socketpath][,port=n]</B>
<I>QEMU_OPTIONS</I>
<BR>
<B>vdeq</B>
<B>kvm</B>
[
<B>--mod</B>
<I>octalmode</I>
]
<I>KVM_OPTIONS</I>
<B>-net vde[,vlan=n][,sock=socketpath][,port=n]</B>
<I>KVM_OPTIONS</I>
<BR>
<B>vde</B>{<I>qemu_name</I>}
[
<B>--mod</B>
<I>octalmode</I>
]
<I>QEMU_OPTIONS</I>
<B>-net vde[,vlan=n][,sock=socketpath][,port=n]</B>
<I>QEMU_OPTIONS</I>
<BR>
<P>
<A NAME="lbAD"> </A>
<H2>OLD SYNOPSIS</H2>
<B>vdeq </B>
<B>qemu</B>
[
<B>--mod</B>
<I>octalmode</I>
]
[
<B>-sock</B>
<I>socketpath</I>
[
<I>,socketpath</I>
[
<I>,...</I>
]
]
]
[ qemu_args ]
<BR>
<B>vde</B>{<I>qemu_name</I>}
[
<B>-sock</B>
<I>socketpath</I>
[
<I>,socketpath</I>
[
<I>,...</I>
]
]
]
[ qemu_args ]
<P>
<BR>
<A NAME="lbAE"> </A>
<H2>DESCRIPTION</H2>
<B>vdeq</B>
is a wrapper to start a QEMU/KVM virtual machine connected to a VDE network.
It uses the qemu/kvm <B> -tun-fd </B> parameter to set up the connection with
a vde_switch.
<P>
The command
<DL COMPACT><DT><DD>
<BR>
<B>vdeq qemu -b c -hda=sampledisk</B>
</DL>
starts a qemu machine which boots from the sampledisk image and
has a ne2000 ethernet interface connected to the standard vde_switch.
The command
<DL COMPACT><DT><DD>
<BR>
<B>vdeq kvm -b c -hda=sampledisk</B>
</DL>
starts a kvm machine which boots from the sampledisk image and
has a ne2000 ethernet interface connected to the standard vde_switch.
<BR>
<P>
It is also possible to create symbolic links to the vdeq executable to have
a simpler command. If the link has a name that begins with vde the remaining part
of the name is taken as the qemu command. For example if vdeq is linked to
vdeqemu:
<DL COMPACT><DT><DD>
<BR>
<B>vdeqemu -b c -hda=sampledisk</B>
</DL>
starts qemu as above. If vdeq is linked to vdekvm:
<DL COMPACT><DT><DD>
<BR>
<B>vdekvm -b c -hda=sampledisk</B>
</DL>
starts kvm with the same parameters.
<P>
The new syntax is consistent with the new Qemu 0.8.0 network parameters.
Using vdeq is possible to specify a vde interface in the same way as
user,tap or socket interfaces.
The <B>sock=</B> parameter can be used to use a specific socket.
Please note that what qemu names as vlan is not related to the
802.1q VLAN managed by the vde_switch.
<B>port=</B> can be used to specify the port of the switch,
otherwise the first allocatable port is assigned.
The following command run a qemu VM with two ethernet interface
connected to the standard switch and
to the switch with local socket "/tmp/my.ctl", port 10, respectively
<DL COMPACT><DT><DD>
<BR>
<B>vde qemu -net nic,vlan=0 -net nic,vlan=1 -net vde,vlan=0 -net vde,vlan=1,sock=/tmp/my.ctl,port=10</B>
</DL>
<DL COMPACT><DT><DD>
<BR>
<B>vdeqemu -net nic,vlan=0 -net nic,vlan=1 -net vde,vlan=0 -net vde,vlan=1,sock=/tmp/my.ctl,port=10</B>
</DL>
The following command run a kvm VM with two ethernet interface
connected to the standard switch and
to the switch with local socket "/tmp/my.ctl", port 10, respectively
<DL COMPACT><DT><DD>
<BR>
<B>vde kvm -net nic,vlan=0 -net nic,vlan=1 -net vde,vlan=0 -net vde,vlan=1,sock=/tmp/my.ctl,port=10</B>
</DL>
<DL COMPACT><DT><DD>
<BR>
<B>vdekvm -net nic,vlan=0 -net nic,vlan=1 -net vde,vlan=0 -net vde,vlan=1,sock=/tmp/my.ctl,port=10</B>
</DL>
<P>
The old syntax can be used with Qemu 0.8.0 but all the vde interfaces are assigned to
vlan 0.
<DL COMPACT><DT><DD>
<BR>
<B>vdeq qemu -sock /tmp/vde.ctl,/tmp/my.ctl -b c -hda=sampledisk</B>
</DL>
<DL COMPACT><DT><DD>
<BR>
<B>vdeqemu -sock /tmp/vde.ctl,/tmp/my.ctl -b c -hda=sampledisk</B>
</DL>
both start qemu with <B>one</B> ethernet interface connected both to the standard switch and
to the switch with local socket "/tmp/my.ctl".
<P>
<A NAME="lbAF"> </A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT><B>--mod</B>
<DD>
<I>octalmode, </I>
specify the mode for comm socket.
<BR>
<DT><B>-sock </B>
<DD>
<I>socketpath, </I>
specify the UNIX socket to be used by local programs for joining the VDE.
The default value is "/tmp/vde.ctl"
It is also possible to indicate several socketpath (comma separated, no blanks):
in this case several interfaces are defined. The first socketpath is connected
to the first ne2k interface and so on.
<BR>
<DT><B>-h, -help, --help</B>
<DD>
print a Usage help.
</DL>
<A NAME="lbAG"> </A>
<H2>NOTE</H2>
Qemu has changed its syntax for networking (cvs Nov.15 2005).
As a temporary solution use vdeoq and vdeoqemu instead of vdeq and vdeqemu
if you are running a qemu with the old syntax.
<BR>
By default qemu uses the same MAC address for every virtual machine, so if
you plan to use several instances of qemu be sure to explicitly set a different
MAC address for each virtual machine. While generating your address beware to
not use broadcast/multicast reserved MACs, ethernet rules say: the multicast
bit is the low-order bit of the first byte, which is "the first bit on the wire".
For example <I>34:12:de:ad:be:ef</I> is an unicast address, <I>35:12:de:ad:be:ef</I>
is a multicast address (see ETHERNET MULTICAST ADDRESSES section in
<A HREF="http://www.iana.org/assignments/ethernet-numbers">http://www.iana.org/assignments/ethernet-numbers</A> for more informations).
<BR>
<A NAME="lbAH"> </A>
<H2>NOTICE</H2>
Virtual Distributed Ethernet is not related in any way with
<A HREF="http://www.vde.com">www.vde.com</A> ("Verband der Elektrotechnik, Elektronik und Informationstechnik"
i.e. the German "Association for Electrical, Electronic & Information
Technologies").
<P>
<A NAME="lbAI"> </A>
<H2>SEE ALSO</H2>
<B><A HREF="/#/man/man1/vde_switch.1.html">vde_switch</A></B>(1),
<B><A HREF="/#/man/man1/vde_plug.1.html">vde_plug</A></B>(1),
<B><A HREF="/#/man/man1/vde_plug2tap.1.html">vde_plug2tap</A></B>(1),
<B><A HREF="/#/man/man1/dpipe.1.html">dpipe</A></B>(1).
<BR>
<A NAME="lbAJ"> </A>
<H2>AUTHOR</H2>
VDE is a project by Renzo Davoli <<A HREF="mailto:renzo@cs.unibo.it">renzo@cs.unibo.it</A>>
<P>
<HR>
<A NAME="index"> </A><H2>Index</H2>
<DL>
<DT><A HREF="#lbAB">NAME</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">OLD SYNOPSIS</A><DD>
<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
<DT><A HREF="#lbAF">OPTIONS</A><DD>
<DT><A HREF="#lbAG">NOTE</A><DD>
<DT><A HREF="#lbAH">NOTICE</A><DD>
<DT><A HREF="#lbAI">SEE ALSO</A><DD>
<DT><A HREF="#lbAJ">AUTHOR</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 15:22:07 GMT, November 27, 2023
</BODY>
</HTML>