Annotation of embedaddon/mpd/doc/mpd22.html, revision 1.1.1.4
1.1 misho 1: <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
2: <HTML>
3: <HEAD>
4: <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
5: <TITLE>Bundle layer</TITLE>
6: </HEAD>
7: <BODY text="#000000" bgcolor="#ffffff">
8:
1.1.1.4 ! misho 9: <A HREF="mpd.html"><EM>Mpd 5.9 User Manual</EM></A>
1.1 misho 10: <b>:</b> <A HREF="mpd17.html"><EM>Configuring Mpd</EM></A>
11: <b>:</b> <EM>Bundle layer</EM><BR>
12: <b>Previous:</b> <A HREF="mpd21.html"><EM>EAP</EM></A><BR>
13: <b>Next:</b> <A HREF="mpd23.html"><EM>Encryption (ECP) layer</EM></A>
14:
15:
16: <HR NOSHADE>
17: <H2><A NAME="22"></A>4.4. Bundle layer<A NAME="bundle"></A></H2>
18:
19: <p>This chapter describes commands that configure the bundle layer.
20: All of these commands (except <b><code>new</code></b>)
21: apply to the currently active bundle, i.e.,
22: the bundle shown at the command line prompt.</p>
23: <p>
24: <dl>
25:
26: <dt><b><code>set bundle period <em>seconds</em><br>
27: set bundle hiwat <em>percent</em><br>
28: set bundle lowat <em>percent</em><br>
29: set bundle min-con <em>seconds</em><br>
30: set bundle min-dis <em>seconds</em><br>
31: set bundle links <em>link1</em> [ <em>...</em> ]</code></b><dd><p>These commands are only meaningful when bandwidth management is enabled.
32: Mpd will attempt to bring up a new link from the list specified
33: or take down an existing link when the utilization goes above
34: <code><em>hiwat</em></code> or below <code><em>lowat</em></code> percent,
35: respectively. The utilization is sampled every <code><em>period</em></code>
36: divided by 6 points, and is averaged over the past <code><em>period</em></code> seconds.</p>
37: <p>Mpd will not attempt to disconnect a link unless previous one was
38: disconnected at least <code><em>min-dis</em></code> seconds before.
39: Similarly, mpd will not open a link unless previous was opened at least
40: <code><em>min-con</em></code> seconds before. These two parameters
41: help prevent oscillations, but cause slower response time.</p>
42:
43: <dt><b><code>set bundle fsm-timeout <em>seconds</em></code></b><dd><p>This sets the finite state machine (FSM) retry interval for all
44: FSM's on this bundle. This command should only be used in exceptional
45: situations, such as doing PPP over high-latency satellite links.
46: The default is 2 seconds. </p>
47:
48: <dt><b><code>set bundle accept <em>option ...</em><br>
49: set bundle deny <em>option ...</em><br>
50: set bundle enable <em>option ...</em><br>
51: set bundle disable <em>option ...</em><br>
52: set bundle yes <em>option ...</em><br>
53: set bundle no <em>option ...</em></code></b><dd><p>These commands configure various bundle options. Most options
54: are <em>bi-directional</em> in that they can be independently
55: enabled and disabled in each direction.</p>
56:
57: <p>The <code><b>enable</b></code> and <code><b>disable</b></code> commands determine
58: whether we want the corresponding option.
59: The <code><b>accept</b></code> and <code><b>deny</b></code> commands determine
60: whether we will allow the peer to request the corresponding option.</p>
61:
62: <p>The <b><code>yes</code></b> command is the same as
63: <code><b>enable</b></code> and <code><b>accept</b></code>.
64: The <b><code>no</code></b> command is the same as
65: <code><b>disable</b></code> and <code><b>deny</b></code>.</p>
66:
67: </dl>
68: </p>
69:
70: <p>The options available at the bundle layer are:</p>
71: <p>
72: <dl>
73:
74: <dt><b><code>bw-manage</code></b><dd><p>This command enables <em>bandwidth management</em>, in which mpd attempts
75: to dynamically adjust the number of connected links depending on the
76: traffic load.</p>
77: <p>The proper functioning of bandwidth management depends on the correct
78: latency and bandwidth information configured for each link; see the
79: <code><b>set link latency</b></code> and <code><b>set link bandwidth</b></code>
80: commands.</p>
81: <p>The default for this option is off -- mpd connects the links ``all or none.''</p>
82:
83: <dt><b><code>round-robin</code></b><dd><p>When multilink PPP is enabled and there are two or more links
84: connected, this option enables round robin packet scheduling
85: across the links. That is, instead of breaking each packet
86: into fragments and delivering the individual fragments over
87: all the links in the bundle, each packet is delivered whole
88: over single link. The link is chosen by rotating in round-robin
89: fashion over all the links in the bundle.</p>
90: <p>This option normally would result in higher latency and
91: possible delays due to TCP packets being received out of order;
92: however, it may help in certain situations of high packet
93: loss or broken peer equipment.</p>
94: <p>The default is disable.</p>
95:
96: <dt><b><code>ipcp</code></b><dd><p>Enable/Disable IPCP negotiation. For details see
1.1.1.4 ! misho 97: <A HREF="mpd26.html#ipcp">the IPCP layer chapter</A>.</p>
1.1 misho 98: <p>The default is enable.</p>
99:
100: <dt><b><code>ipv6cp</code></b><dd><p>Enable/Disable IPV6CP negotiation.</p>
101: <p>The default is disable.</p>
102:
103: <dt><b><code>compression</code></b><dd><p>Enable/Disable CCP (Compression Control Protocol) negotiation. For details see
1.1.1.4 ! misho 104: <A HREF="mpd24.html#compression">the compression layer chapter</A>.</p>
1.1 misho 105: <p>The default is disable.</p>
106:
107: <dt><b><code>encryption</code></b><dd><p>Enable/Disable ECP (Encryption Control Protocol) negotiation. For details see
1.1.1.4 ! misho 108: <A HREF="mpd23.html#encryption">the encryption layer chapter</A>.</p>
1.1 misho 109: <p>The default is disable.</p>
110:
111: <dt><b><code>crypt-reqd</code></b><dd><p>Require encryption.
112: When encryption support is compiled into mpd, this option
1.1.1.4 ! misho 113: causes mpd to drop the link if encryption cannot be successfully
1.1 misho 114: negotiated in both directions. This means in effect, ``use encryption
1.1.1.4 ! misho 115: or do not connect at all.''</p>
1.1 misho 116: <p>The default is disable.</p>
117:
118: </dl>
119: </p>
120: <HR NOSHADE>
1.1.1.4 ! misho 121: <A HREF="mpd.html"><EM>Mpd 5.9 User Manual</EM></A>
1.1 misho 122: <b>:</b> <A HREF="mpd17.html"><EM>Configuring Mpd</EM></A>
123: <b>:</b> <EM>Bundle layer</EM><BR>
124: <b>Previous:</b> <A HREF="mpd21.html"><EM>EAP</EM></A><BR>
125: <b>Next:</b> <A HREF="mpd23.html"><EM>Encryption (ECP) layer</EM></A>
126:
127:
128:
129: </BODY>
130: </HTML>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>