-
Notifications
You must be signed in to change notification settings - Fork 11
/
Copy pathlibvdeplug_multi.1.html
115 lines (94 loc) · 4.16 KB
/
libvdeplug_multi.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
Content-type: text/html; charset=UTF-8
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of LIBVDEPLUG_MULTI</TITLE>
</HEAD><BODY>
<H1>LIBVDEPLUG_MULTI</H1>
Section: User Commands (1)<BR>Updated: April 30, 2017<BR><A HREF="#index">Index</A>
<A HREF="/#/man/index">Return to Main Contents</A><HR>
<A NAME="lbAB"> </A>
<H2>NAME</H2>
libvdeplug_multi - multiplexing vdeplug module: multilink
<A NAME="lbAC"> </A>
<H2>SYNOPSIS</H2>
libvdeplug_multi.so
<A NAME="lbAD"> </A>
<H2>DESCRIPTION</H2>
This is a libvdeplug multiplex module implementing a multilink.
<P>
The common usage of this module is to support (usually temporary) multiple links between
virtual machines or switches. This module can be used to implement hand-offs betweek links:
a new link can be set-up and then the old one is closed.
When both links are active, packets can be duplicated.
<P>
This module of libvdeplug4 can be used in any program supporting vde like
<B>vde_plug</B>, <B>kvm</B>, <B>qemu</B>, <B>user-mode-linux</B> and <B>virtualbox</B>.
<P>
The vde_plug_url syntax of this module is the following:
<DL COMPACT><DT><DD>
<B>multi://</B>[<I>path</I>]
<BR>
<B>multi://</B>[<I>path</I>]<B>[</B>[<I>OPTION</I>][<B>/</B><I>OPTION</I>][<B>/</B><I>OPTION</I>]...<B>]</B>
<BR>
</DL>
<P>
If <I>path</I> is omitted the path of the multi is /tmp/vdenode_$USERNAME (e.g. /tmp/vdenode_john
if the username is john).
<P>
<A NAME="lbAE"> </A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT><B>mode=</B><I>MODE<DD>
define the permissions for the multilink (see chmod). MODE is an octal number.
The standard permission mask is: 0600 (only processes owning to the same user can join the network).
<DT></I><B>dirmode=</B><I>DIRMODE<DD>
define the permissions for the multilink control directory(see chmod). MODE is an octal number.
If omitted, is computed from mode.
<DT></I><B>grp=</B><I>GROUP<DD>
define the group ownership of the multilink.
</DL>
</I><A NAME="lbAF"> </A>
<H2>EXAMPLES</H2>
<B><A HREF="multi:///tmp/multi">multi:///tmp/multi</A></B>
<BR>
Other virtual machines, namespaces or vde_plug can join this multilink using <B><A HREF="vde:///tmp/hub">vde:///tmp/hub</A></B> or simply <B>/tmp/hub</B>
<BR>
Given two virtual machines using <B><A HREF="multi:///tmp/vm1">multi:///tmp/vm1</A></B> and <B><A HREF="multi:///tmp/vm2">multi:///tmp/vm2</A></B> respectively, it is possible to
connect them using <B>vde_plug /tmp/vm1 /tmp/vm2</B>. If the second virtual machine is running on a remote hosts;
<B>ip1.vm2.domain.org</B> and <B>ip2.vm2.domain.org</B> are two ip addresses permitting to reach that remote host using
different paths, the command <B>vde_plug /tmp/vm1 = ssh ip1.vm2.domain.org vde_plug /tmp/vm2</B> connects the two vms.
In a second time is possible to run <B>vde_plug /tmp/vm1 = ssh ip2.vm2.domain.org vde_plug /tmp/vm2</B> to create another
channel on the other path. When both connections are in place packets can arrive duplicated (the upper protocols can
manage the problem). Then the process connecting the remotevm using <B>ip1.vm2.domain.org</B> can be killed, completing
in this way the (hiccup-less) handoff.
<BR>
<B><A HREF="multi:///tmp/multi[mode=0666]">multi:///tmp/multi[mode=0666]</A></B>
<BR>
It is the same multilink, but everybody is allowed to connect their processes.
<A NAME="lbAG"> </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").
<A NAME="lbAH"> </A>
<H2>SEE ALSO</H2>
<B><A HREF="/#/man/man1/vde_plug.1.html">vde_plug</A></B>(1),
<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">DESCRIPTION</A><DD>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">EXAMPLES</A><DD>
<DT><A HREF="#lbAG">NOTICE</A><DD>
<DT><A HREF="#lbAH">SEE ALSO</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>