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>