home *** CD-ROM | disk | FTP | other *** search
/ MS-DOS 8.0 / MS-DOS8.iso / SOFTWARE / A195GPL.EXE / LSPPP.DOC < prev    next >
Encoding:
Text File  |  2003-10-20  |  9.1 KB  |  275 lines
  1. 1) general info
  2.  
  3.   LSppp is a small MSDOS PPP packet driver.  It is compatible with the 
  4.   needs of WATTCP and trumpet stacks.  The resident size is approximately
  5.   28K.
  6.  
  7.   LSppp loads as a class one ethernet driver and handles all 
  8.   aspects of the connection from dialing onward.  Optionally, an external 
  9.   dialer may be used to dial an ISP prior to running LSppp; it will 
  10.   detect the carrier and go immediately into internet communications 
  11.   setup.
  12.   
  13.   LSppp is capable of auto-configuring WATTCP through the bootp mechanism 
  14.   and will do so automatically.  However, for this to work properly LSppp
  15.   will have to be supplied with name server information.  LSppp will 
  16.   attempt to automatically load name server information from the ISP 
  17.   if none is specified on the command line, however, this is an optional 
  18.   feature your ISP may not support.  To see if it is supported run LSppp
  19.   without specifying the name server switch (/N) and see if it places
  20.   DNS addresses in the IP-UP.bat file
  21.  
  22.   LSppp does not use configuration files; all parameters are placed on 
  23.   the command line or optionally in the LSPPP environment variable.  
  24.   LSPPP will search the environment variable for valid command switches 
  25.   first, then modify this information with command switches specified on 
  26.   the command line.  Configuration options include user name and 
  27.   password, number to dial, nameserver information, and various options 
  28.   to set up a communications port to use or customize the timeout 
  29.   mechanisms.
  30.  
  31.   The current version does not have a lot of backwards compatability for 
  32.   old versions of the protocols.  If you have problems running it use the
  33.   undocumented /z switch and send the resulting LSPPP.LOG file to the
  34.   author for analysis.  Note that to get a log file you MUST use the /z
  35.   switch; the /l switch is now used for local mode
  36.  
  37.   Van jacobsen compression and the CHAP protocol have recently been added
  38.   to LSPPP.  Other less used protocols (including MSCHAP) are not 
  39.   currently supported.
  40.  
  41.   Note that the undocumented /l option has been changed to the 
  42.   undocumented /z option.  Use of the new /l option will in general cause
  43.   internet connections to not work.
  44.  
  45. 2) Disclaimer and license
  46.  
  47.      LSPPP - DOS PPP Packet Driver
  48.      Copyright (C) 1997-2003  David Lindauer
  49.  
  50.      This program is free software; you can redistribute it and/or modify
  51.      it under the terms of the GNU General Public License as published by
  52.      the Free Software Foundation; either version 2 of the License, or
  53.      (at your option) any later version.
  54.  
  55.      This program is distributed in the hope that it will be useful,
  56.      but WITHOUT ANY WARRANTY; without even the implied warranty of
  57.      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  58.      GNU General Public License for more details.
  59.  
  60.      You should have received a copy of the GNU General Public License
  61.      along with this program; if not, write to the Free Software
  62.      Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  63.  
  64.      (for GNU General public license see file COPYING)
  65.  
  66.      you may contact the author at:  mailto::camille@bluegrass.net
  67.   
  68.      or by snail mail at:
  69.  
  70.      David Lindauer
  71.      850 Washburn Ave.  Apt  99
  72.      Louisville, KY 40222
  73.  
  74.  
  75. 3) Configuration
  76.  
  77. When dialing the modem sends the following configuration string:
  78.  
  79. ATZ
  80.  
  81. Also if /dm:# is specified the modem will be told to mute the speaker.
  82.  
  83. At any time before LSPPP goes resident, you may press 'esc' to end the 
  84. session and hang up.
  85.  
  86. Configuration options are as follows:
  87.  
  88. /a:$    set async map
  89.     set an asynchronous control map.  Characters in the map will be
  90.     treated as purely control characters and will be escaped during
  91.     transmission.  For example if the modem uses XON and XOFF you 
  92.     would specify a map of 0x000A0000.  
  93.     The default is a map of zero, meaning no characters are escaped.
  94.  
  95. /b:$    Comm port
  96.  
  97.     Set a base i/o port.  For example /b03f8
  98.     default: /b:03f8
  99.  
  100. /d[r][m][f][l][e]:* Dial [redial] phone number
  101.  
  102.     Set the phone number to dial.  The redial option is not 
  103.     supported yet.  The 'm' option tells lsppp to mute the speaker.
  104.     The 'f' option forces it to dial even when it thinks it is 
  105.     already connected (useful with winmodems).  The 'l' option
  106.     causes lsppp to initially attempt a terminal-mode login before
  107.     attempting to connect with the PPP protocol.  The 'e' option
  108.     causes lsppp to dial with 'ATX3D' instead of 'ATD', which 
  109.     should be useful in Europe where no dial tone exists.
  110.      Example:  /d:5551214 
  111.      Example:  /d:P5551214 this does pulse dialing 
  112.     default: LSPPP does not dial
  113.  
  114. /h or /?
  115.  
  116.     Displays the help text
  117.  
  118. /i      Comm IRQ (0-15) 
  119.  
  120.     Set the interrupt vector to use
  121.     example : /i:4
  122.     default:  /i:4
  123.  
  124. /l    Local mode
  125.  
  126.         Forces LSPPP to not dial (local mode connection)
  127.     Also turns off use of modem control signals
  128.  
  129. /m:#,#  set MRUs
  130.  
  131.   sets the maximum recieve unit for both sides of the link.
  132.   The first number is what the number which this client can transmit
  133.   which will be passed to the TCP stack; the second number is the
  134.   amount this client can receive.
  135.  
  136.   default: /m:576,576
  137.  
  138. /n:#    Comm port
  139.  
  140.     Set the com port (1-4).  Automatically sets the /b and /i 
  141.     options based on the setting.
  142.  
  143.     example: /n:1
  144.     default: /n:1
  145.  
  146. /p  ppp driver interface
  147.  
  148.   set the driver to use the native PPP packet interface.  By default
  149.   LSPPP will use the non-native class 1 ethernet interface.  Using the
  150.   native PPP interface has slightly less overhead than using the class 1
  151.   interface, for those TCP stacks that support it.
  152.  
  153. /u      Unload TSR 
  154.     unloads the tsr
  155.  
  156. /x    xon/xoff
  157.  
  158.     use the xon/xoff protocol instead of modem control signals
  159.  
  160. /A:#,#    PAP timeout and count
  161.  
  162.     Set the timeout and count governing password authentication.  
  163.     The timeout is in seconds and is the time between retries; when 
  164.     count retries have been done LSPPP will give up.  default: 
  165.     /A:3,10
  166.  
  167. /B:#    Baud rate 
  168.     
  169.     Set the baud rate
  170.     example: /B:57600
  171.     default: /B:19200
  172.  
  173. /D:#,#,#  Dial timeout & count & delay
  174.     
  175.     Set the timeout and retries for dialing.  This is the time 
  176.     LSPPP will wait for a connection (in seconds) and the number of 
  177.     retries to make before LSPPP gives up entirely.  The third
  178.     parameter is optional and is the number of seconds after 
  179.     dialing before it tries to connect to the ISP.
  180.  
  181.    default:  /D:45,1,0
  182.  
  183. /F:#[,#]  UART Fifo buffering
  184.  
  185.   Set the buffering level of the Uart's receive and possibly transmit 
  186.   fifo (if present).  Valid values for receive fifo are are 1,4,8, and 14.
  187.   If the transmit fifo setting is present, valid values are 1-16
  188.  
  189.   default: no fifo usage
  190.  
  191. /I:#,#  IPCP timeout & count 
  192.  
  193.     Set the timeout and count governing IP configuration.  
  194.     The timeout is in seconds and is the time between retries; when 
  195.     count retries have been done LSPPP will give up.  
  196.     default: /I:3,10
  197.  
  198.  
  199. /L:#,#  LCP timeout & count 
  200.     
  201.     Set the timeout and count governing initial link configuration.  
  202.     The timeout is in seconds and is the time between retries; when 
  203.     count retries have been done LSPPP will give up.  
  204.     default: /L:3,10
  205.  
  206. /M:*    Modem init string
  207.     
  208.     Specify a string to use to initialize the modem when dialing.  
  209.     A typical example is AT&F to initialize defaults.  Note that 
  210.     the dialer will always send ATZ prior to sending the initialize 
  211.     string, which resets the modem.  Also the 'm' parameter on the
  212.     dialer can be used to automatically send ATM0 (mutes the modem)
  213.     in addition to this initialize string
  214.  
  215.   default:  no initialization string used
  216.  
  217.  
  218. /N:@[,@]        DNS address 
  219.  
  220.     Set the DNS name server address[s].  First address is primary
  221.     and second address is secondary.  If no name servers are 
  222.     specified LSPPP will attempt to auto-configure them from the 
  223.     server.
  224.     example:  /N:198.77.33.2,198.77.33.1
  225.     default: /N:0.0.0.0,0.0.0.0 (autoconfigure)
  226. /P:*    passwd
  227.  
  228.     Set the login password
  229.     example: /P:truely
  230.     default: no login password
  231.  
  232. /S:@    Suggest address
  233.  
  234.         Suggest an IP address for the server to assign to LSPPP
  235.         example: /S:199.62.66.44
  236.         default: no address suggested
  237.         
  238. /U:*    User name
  239.  
  240.     Set the login user name
  241.     example: /U:dinosaur
  242.     default: user name
  243.  
  244. /V:$    Packet driver vector
  245.  
  246.     Set the packet driver vector to use
  247.     example: /V:60
  248.     default: LSPPP searches for a free vector
  249.  
  250.  
  251. An example of a valid command line is:
  252.  
  253. lsppp /dm:5551214 /n:3 /B:57600 /N:101.202.101.4 /U:myname /P:mypass
  254.  
  255. which uses COM3 to log into an ISP at 57600 BPS with account 'myname' 
  256. and password 'mypass'.  A nameserver is specified and the speaker will 
  257. be muted.
  258.  
  259. If we had performed the following to set the LSPPP environment 
  260. variable:
  261.  
  262. set LSPPP=/n:3 /B:57600 /U:myname /P:mypass
  263.  
  264. Then typing
  265.  
  266. lsppp /dm:5551214 /N:101.202.101.4
  267.  
  268. would have the same effect as the first commmand line since LSPPP will 
  269. read the environment varible before reading the command line.  Of 
  270. course you can put the number to dial and nameserver in the environment 
  271. too.
  272.  
  273. LSPPP will also read from the file LSPPP.CFG which is in the same directory
  274. as LSPPP.EXE.  Format parameters the same as before on as many lines as
  275. you want.