177690SbrianCopyright (c) 2001 Brian Somers <brian@Awfulhak.org> 277690Sbrian based on work by Eivind Eklund <perhaps@yes.no>, 377690SbrianAll rights reserved. 477690Sbrian 577690SbrianRedistribution and use in source and binary forms, with or without 677690Sbrianmodification, are permitted provided that the following conditions 777690Sbrianare met: 877690Sbrian1. Redistributions of source code must retain the above copyright 977690Sbrian notice, this list of conditions and the following disclaimer. 1077690Sbrian2. Redistributions in binary form must reproduce the above copyright 1177690Sbrian notice, this list of conditions and the following disclaimer in the 1277690Sbrian documentation and/or other materials provided with the distribution. 1377690Sbrian 1477690SbrianTHIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 1577690SbrianANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 1677690SbrianIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 1777690SbrianARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 1877690SbrianFOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 1977690SbrianDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 2077690SbrianOR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 2177690SbrianHOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 2277690SbrianLIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 2377690SbrianOUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 2477690SbrianSUCH DAMAGE. 2577690Sbrian 2653889Sbrian$FreeBSD$ 2753889Sbrian 2836285SbrianThis file summarises changes made to ppp that effect 2936285Sbrianits configuration. 3036285Sbrian 3136285SbrianIt does not describe new features, rather it attempts 3236285Sbrianto answer any `this used to work, why doesn't it now?' 3336285Sbrianquestions. 3436285Sbrian 3536285Sbriano The `set debug' command was replaced with `set log'. 3636285Sbriano The `set log LCP' command was split into LCP, IPCP and CCP logs. 3736285Sbriano Syslogd is used for logging. /etc/syslog.conf must be updated. 3836285Sbriano LQR is disabled by default. 3936285Sbriano Openmode is active by default. 4036285Sbriano Users must be a member of group `network' for ppp access. Furthermore, 4136285Sbrian they must be `allow'ed to run ppp via the `allow' command in the 4236285Sbrian configuration file. 4336285Sbrian For a brief period, ppp could only be run as root. 4436285Sbriano No diagnostic socket is created by default. The `set server' command 4536285Sbrian must be used. 4636285Sbriano The diagnostic socket password must be specified *only* on the `set 4736285Sbrian server' command line. 4836285Sbriano When `set server' is used to re-select a diagnostic port, all existing 4936285Sbrian diagnostic connections are dropped. 5036285Sbriano pppd-deflate is now called deflate24. 5136285Sbriano Filter IPs of 0.0.0.0 have a default width of 0, not 32. 5236285Sbriano Errors in `add' and `delete' are logged as warnings rather than being 5336285Sbrian written to the TCP/IP log. 5436285Sbriano Any number of diagnostic prompts are allowed, and they are allowed in 5536285Sbrian interactive mode. 56137885Sobrieno The default `device' is cuad1, then cuad0 5736285Sbriano A password of "*" in ppp.secret causes a passwd database lookup in 5836285Sbrian pap mode. 5936285Sbriano The value of the CONNECT environment variable is logged in the 6036285Sbrian utmp host field in -direct mode. 6136285Sbriano Out-of-sequence FSM packets (IPCP/LCP/CCP) are dropped by default. 6236285Sbriano Reconnect values are used after an LQR timeout. 6336285Sbriano ^C works on the parent in -background mode. 6436466Sbriano The dial/call/open command works asynchronously. As a result, prompts 6536285Sbrian do not lose control while dialing. 6636285Sbriano The `display' command has been removed. All information is available 6736285Sbrian with the appropriate `show' command. 6836285Sbriano Msext does not need to be enabled/disabled. Setting the NBNS (set nbns) 6936285Sbrian will auto enable it. The DNS side may be enabled/disabled, and if 7036774Sbrian enabled without a `set dns' (was `set ns') will use values from 7136774Sbrian /etc/resolv.conf. 7236285Sbriano Filters are now called `allow', `dial', `in' and `out'. `set 7336285Sbrian ifilter ...' becomes `set filter in ...' etc. 7436285Sbriano Authname and Authkey may only be `set' in phase DEAD. 7536285Sbriano Set encrypt is no longer necessary. Ppp will respond to M$CHAP 7636285Sbrian servers correctly if it's built with DES. 7736285Sbriano Throughput statistics are enabled by default. 7836285Sbriano `Set stopped' only has two parameters. It's no longer possible to 7936285Sbrian have an IPCP stopped timer. 8049978Sbriano `Set timeout' only has one or two parameters. Use `set lqrperiod' and 8149978Sbrian `set {lcp,ccp,ipcp,chap,pap}retry' for the other timers. These timeout 8249978Sbrian values can be seen using the relevant show commands. 8336285Sbriano `set loopback' is now `enable/disable loopback'. 8436285Sbriano `show auto', `show loopback' and `show mtu' are all part of `show bundle'. 8536285Sbriano `show mru' is part of `show lcp' 8636285Sbriano `show msext' and `show vj' are part of `show ipcp' 8736285Sbriano `show reconnect' and `show redial' are part of `show link' 8836285Sbriano A signal 15 (TERM) will now shut down the link gracefully. 8936285Sbriano A signal 2 (HUP) will drop all links immediately. 9036285Sbriano Signal 30 (USR1) is now ignored. 9136285Sbriano Add & delete commands are not necessary in ppp.linkup if they are 9236285Sbrian `sticky routes' (ie, contain MYADDR or HISADDR). 9336285Sbriano LINK and CARRIER logging are no longer available. 9436285Sbriano Timer based DEBUG messages are now logged in the new TIMER log. 9536285Sbriano Ppp can use tun devices > tun255. 9636285Sbriano Protocol-compressed packets are accepted even if they were denied 9736285Sbrian at LCP negotiation time. 9836285Sbriano Passwords aren't logged when logging the ``set server'' line. 9936466Sbriano Command line options only need enough characters to uniquely identify 10036466Sbrian them. -a == -auto, -dd == -ddial etc. -interactive is also allowed. 10141754Sbriano If you don't like seeing additional interface aliases when running in 10241754Sbrian -auto -alias mode, add ``iface clear'' to your ppp.linkdown file - 10341754Sbrian check the sample file. 10444073Sbriano Ppp waits for 1 second before checking whether the device supports 10544073Sbrian carrier. This is controllable with ``set cd''. 10644261Sbriano Random dial timeouts are now between 1 and 30 seconds inclusive rather 10744261Sbrian than between 0 and 29. 10844796Sbriano Ppp now accepts M$CHAP (as well as normal CHAP) by default. If this 10944796Sbrian is not required, you must ``deny chap05 chap80''. 11046102Sbriano The ``set device'' command now expects each device to be specified as an 11146102Sbrian argument rather than concatentating all arguments and splitting based 11246102Sbrian on commas and spaces. 11353889Sbriano The ``show modem'' command is deprecated and has been changed to 11446686Sbrian ``show physical''. 11549140Sbriano The words ``host'' and ``port'' are no longer accepted by the ``set filter'' 11649140Sbrian command. Removing them should yield the same results as before. 11753889Sbriano The ``set weight'' command has been deprecated. The ``set bandwidth'' 11849434Sbrian command should now be used instead. 11949434Sbriano The ``set autoload'' command syntax and implementation have changed as the 12049434Sbrian old implementation was mis-designed and dysfunctional. 12149472Sbriano Ppp now waits either the full ``set cd'' time or until carrier is detected 12249472Sbrian before running the login script (whichever comes first). 12353889Sbriano The -alias flag has been deprecated. The -nat flag should be used instead. 12454914Sbriano Unbalanced quotes in commands are now warned about and the entire command 12554914Sbrian is ignored. 12655246Sbriano It is now only necessary to escape the `-' character in chat scripts twice. 12755246Sbrian See the example files for details. 12858045Sbriano Environment variables and ~ are expanded on in commands 12961863Sbriano ``nat pptp'' is no longer necessary as this is now done transparently 13064465Sbriano The ``!'' at the start of chat scripts and authkey can be made literal 13164465Sbrian (rather than meaning execute) by doubling it to ``!!''. 13264670Sbriano MP autoload throughput measurements are now based on the maximum of input 13364670Sbrian and output averages rather than on the total. 13464780Sbriano When only one link is open in MP mode, MP link level compression is not 13564780Sbrian open and the peer MRU >= the peer MRRU, ppp sends outbound traffic as 13664780Sbrian PROTO_IP traffic rather than PROTO_MP. 13768906Sbriano MSCHAPv2 is now accepted by default. If you don't wish to negotiate 13868906Sbrian this, you must explicitly deny it. 13968906Sbriano MPPE is enabled and accepted by default (although deflate and predictor1 14068906Sbrian are preferred. 141