File:  [ELWIX - Embedded LightWeight unIX -] / embedaddon / mpd / doc / mpd22.html
Revision 1.1.1.2 (vendor branch): download - view: text, annotated - select for diffs - revision graph
Mon Jul 22 08:44:33 2013 UTC (10 years, 11 months ago) by misho
Branches: mpd, MAIN
CVS tags: v5_7p0, v5_7, HEAD
5.7

    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: 
    9: <A HREF="mpd.html"><EM>Mpd 5.7 User Manual</EM></A>
   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
   97: <A HREF="mpd26.html#ipcp">ipcp</A>.</p>
   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
  104: <A HREF="mpd24.html#compression">compression</A>.</p>
  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
  108: <A HREF="mpd23.html#encryption">encryption</A>.</p>
  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
  113: causes mpd to drop the link if encryption cannot be succesfully
  114: negotiated in both directions. This means in effect, ``use encryption
  115: or don't connect at all.''</p>
  116: <p>The default is disable.</p>
  117: 
  118: </dl>
  119: </p>
  120:  <HR NOSHADE>
  121: <A HREF="mpd.html"><EM>Mpd 5.7 User Manual</EM></A>
  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>