home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / ctcoll95.zip / BASTELST / ISPA305.ZIP / ISPA30.TXT < prev    next >
Text File  |  1995-03-20  |  34KB  |  791 lines

  1.  
  2.           ISPA Version 3.0.5, a Packet-Driver for ISDN-API 1.1.
  3.  
  4.                  Herbert Hanewinkel, March 1995
  5.  
  6.  
  7.  
  8.     ISPA is Shareware.
  9.  
  10.     ISPA, as it is provided, is a demo version.
  11.     To make use of the full functionality of ISPA you have to register ISPA.
  12.     The basic registration fee for a single user version of ISPA is DM 30,-
  13.     for private users and DM 50,- for commercial and institutional users.
  14.     Please read the file "ispa.reg" for details.
  15.  
  16.     As long as you have NOT registered ISPA you may test ISPA using a ? in
  17.     place of the registration code. In this case ISPA will stop forwarding
  18.     data after 10 min.
  19.  
  20.  
  21.     Disclaimer
  22.  
  23.     The program and this documentation is
  24.     Copyright (C) 1993-1995 by Herbert Hanewinkel,
  25.     All Rights Reserved.
  26.  
  27.     It is provided as shareware with the following limitations:
  28.  
  29.          This program is copyrighted and it is not in the public
  30.          domain. It may not be distributed for profit or included
  31.          in any CD-ROM or diskette software collection without
  32.          permission. This applies in particular to commercial PD
  33.          libraries. The program is not to be resold or distributed
  34.          for sale with other programs which are for sale.
  35.          There is no warranty or claim of fitness or reliability.
  36.          The program is distributed AS IS, and as such the author
  37.          shall NOT be held liable for any loss of data, down time,
  38.          loss of revenue or any other direct or indirect damage or
  39.          claims caused by this program.
  40.  
  41.          If you are a distributor of ISDN products and would like
  42.          to sell registered versions of this software with printed
  43.          hardcopy manuals, please contact me. You may not bundle or
  44.          otherwise distribute this software with any other software
  45.          without my express written permission (i.e., on the same
  46.          diskettes as part of a commercial package, compressed
  47.          along with other software, etc.).
  48.  
  49.  
  50.     Overview
  51.  
  52.     ISPA is an ethernet-type (class=1) packet-driver for IP-Routing or
  53.     remote Ethernet bridging over ISDN. ISPA communicates with the ISDN
  54.     card using the ISDN API 1.1 specification (a standard defined by
  55.     German ISDN card manufacturers and the German Telekom). Because of
  56.     this, ISPA is completely hardware independent and has successfully
  57.     been tested with many active and passive ISDN cards.
  58.  
  59.     ISPA supports a large set of protocols for communication with other
  60.     vendors ISDN routers or servers. Among these protocols are:
  61.     LAPB, Frame-Relay, PPP, SLIP, Cisco-HDLC.
  62.     ISPA can communicate at least with the following commercial systems:
  63.     Ascend Routers, Biodata ISDN Router, Cisco Routers, INS/CLS Banzai
  64.     ISDN Router, netCS ISDN Router, RzK SLIP Bridge, SGI Indy ISDN 1.0,
  65.     Spyder Routers, SunLink ISDN 1.0.
  66.  
  67.     ISPA was initialy developed for use with PCROUTE as a cheap Ethernet-ISDN
  68.     Router. However, it is more and more used to connect a standalone PC
  69.     system to the Internet using ISDN. ISPA has succesfully been tested
  70.     with a wide range of commercial, shareware and public domain TCP/IP
  71.     packages e.g. Ftp PCTCP, Sun PC-NFS, Novell LanWorkPlace and PDTEHER,
  72.     WATTCP based IP programs, NCSA & CU -Telnet/ftp, UMN gopher & popmail,
  73.     Trumpet WINSOCK, XFS.
  74.  
  75.     ISPA was written for use with ISDN BRI PC cards. I myself have
  76.     used ISPA only with Teles.S0 cards, one of the cheapest ISDN cards in
  77.     Germany, and tested ISPA successfully with NCP cards. But I got
  78.     responses from users of ISPA that it will work at least with the
  79.     following other ISDN cards:
  80.     AVM A1 & B1, Diehl SCOM & SoTec, miro, NCP p16 & a, NICCY 1000 PC,
  81.     mbp Solis. (Check the *.comment files if you are looking for
  82.     details on a specific environment).
  83.  
  84.     The current version of ISPA supports two independent active connections
  85.     at a time. Alternativly a connection can use both B-channels for
  86.     loadsharing. ISPA can be loaded more than once, if more than two
  87.     simultanous connections to different sites are desired.
  88.     Loadsharing can be configured as static or dynamic (bandwith on
  89.     demand). Dynamic loadsharing can be used concurrently with a second
  90.     independent connection.
  91.  
  92.  
  93.     Installation
  94.  
  95.     To load ISPA run ispa.exe with the following arguments:
  96.     (Parameters in [] are optional)
  97.  
  98.         ispa Reg.-Code PacketInterrupt [ConfigFile]
  99.  
  100.         "Reg.-code" is your personal registration code you will receive
  101.         after registrating ISPA. As long as you have NOT registered ISPA
  102.         you may test ISPA using a ? in place of the registration code. In
  103.         this case ISPA will stop forwarding data after 10 min.
  104.  
  105.         "PacketInterrupt" defines the software interrupt for the Packet
  106.         Driver application. The value has to be in the range from 0x60
  107.         to 0x80.
  108.  
  109.         "ConfigFile" specifies the name of the ISPA configuration file.
  110.     If the name is not given, it defaults to "ISPA.INI". Read the
  111.     section "The configuration file" below for setting up an ISPA
  112.     configuration file.
  113.  
  114.  
  115.     ISDN number format and related features of ISPA
  116.  
  117.         PBX's sometimes require a special key-code for dialing out. If this
  118.         prefix is not displayed on incoming calls, Dialback and CLI will
  119.         normally fail. To solve this problem ISPA supports an outgoing
  120.         call prefix, which is not checked on incoming calls. The prefix
  121.         can be specified in front of each ISDN number separated by a comma.
  122.  
  123.         Digits, which should not be used in an outgoing call, but have to 
  124.     be present for CLI can be marked by a decimal point from the common
  125.     part of the number.
  126.  
  127.         Examples:
  128.         089.345678 will dial 345678 and will match incoming calls
  129.         from 089345678.
  130.         0,30.123456 will dial 0123456 and will match incoming calls
  131.         from 30123456.
  132.     00,123456789 will dial 00123456789 and will match incoming calls
  133.     from 123456789.
  134.  
  135.         Subaddresses (available only in Euro ISDN, E-DSS1) can be appended
  136.         to a number by separating them with a /. Only digits are supported
  137.         in a subaddress.
  138.  
  139.         The total length of number + subaddress is limited to 26 characters.
  140.  
  141.         A SPV connection (available only in German ISDN, 1TR6) is set up
  142.         by appending an "s" to the end of the ISDN-number. An incoming SPV 
  143.         request is accepted only if the "s" is specified. 
  144.  
  145.         The CAPI standard doesn't define a standard setup for PVC's.
  146.         Teles, Berlin supports PVC's (Digitale Festverbindungen D64s) using
  147.         a pseudo ISDNnumber "tap" and selecting one of the B-channels.
  148.         ISPA supports this feature of the Teles CAPI implementation and
  149.         allows the selection of a PVC with the specification "1tap" or
  150.     "2tap", depending on the desired channel, for the ISDNnumber.
  151.  
  152.  
  153.     The configuration file
  154.  
  155.     The configuration file consists of the following formal parts:
  156.  
  157.     [global options]
  158.     [translation entry for incoming calls from numbers not specified]
  159.     [translation entries for incoming and outgoing calls]
  160.  
  161.     The first section is optional, but there has to be at least one
  162.     of the two types of translation entries.
  163.  
  164.     The global options control ISPA's overall behaviour. Global
  165.     options can be specified on one or more lines.
  166.  
  167.     The second and third part consist of translation entries to map
  168.     IP-addresses to ISDN-numbers and to select peer specific parameters
  169.     for these entries.
  170.  
  171.         The translation entries in the configuration file have two
  172.     functionalities:
  173.  
  174.         - they act as a translation table for IP routing on outgoing calls
  175.       by mapping the IP-address of the peer to an ISDNnumber.
  176.  
  177.         - they are used for calling line identification (CLI) on incoming
  178.       calls.
  179.  
  180.         Incoming connections will be accepted only from ISDN-numbers
  181.         specifed in the configuration file. To disable CLI and allow
  182.     incoming calls from any number, the first translation entry has to
  183.     contain a '*' in the common part of ISDNnumber field. For incoming
  184.     calls from ISDNnumbers not otherwise specified, the parameters of
  185.     this entry will be used.
  186.  
  187.         The translation entries in the file have to be in the following format:
  188.  
  189.         ip-address ISDNnumber [ISDNnumber2] [options] [# comment]
  190.  
  191.         "ip-address" defines the IP-address of the peer.
  192.         "ISDNnumber" defines the ISDN-number of the peer.
  193.         "ISDNnumber2" defines a second ISDN-number, when used with loadsharing.
  194.         "options" define the protocol, timeout, ... for this link.
  195.  
  196.         If the same IP-address appears more than once in the configuration
  197.         file, ISPA will try all corresponding ISDN numbers until a connection
  198.         can be established.
  199.  
  200.         Attention: If the first entry in the configuration file selects an
  201.         ethernet bridging protocol, the use of the configuration file as a
  202.         translation table for outgoing calls is disabled. All outgoing calls
  203.         will be set up to the first entry. Further entries will be used only
  204.     for CLI of incoming calls.
  205.     ISPA can operate only in routing or bridging mode. You can not
  206.     mix entries with routing and bridging protocols in the configuration
  207.     file.
  208.  
  209.     ISPA supports IP-address based routing (as it is implemented in
  210.     pcroute) as well as interface based routing of IP packets.
  211.  
  212.     For IP-applications not supporting IP-address based routing or in
  213.     case of simple point-to-point configurations, a single translation
  214.     entry for outgoing calls may be specified with an IP-address of
  215.     0.0.0.0. In this case no further translation entries for outgoing
  216.     calls are allowed and all IP packets (unicast and broadcast) sent
  217.     from the application are forwarded to the ISDN peer.
  218.  
  219.     For translation entries having a non zero IP-address only unicast
  220.     IP packets routed via this IP-gateway are forwarded to the 
  221.     corresponding ISDN peer. In this case the IP-address has to match
  222.     the (or one of the) IP-gateway address(es) in your
  223.     IP-configuration of your application software.
  224.  
  225.         Up to 64 translation entries can be specified in the configuration
  226.         file. Loadsharing entries to two different ISDN numbers allocate
  227.     two entries.
  228.         
  229.  
  230.     ISPA global options:
  231.  
  232.     -c n
  233.         selects the ISDN controller (card), n specifies the controller number.
  234.         default: 0
  235.  
  236.     -i vector
  237.         specifies the software interrupt for communication with the ISDN-API
  238.         software.
  239.         default: 0xf1
  240.  
  241.     -o
  242.         if ISPA's automatic selection of the video-RAM fails, this option
  243.         can be used to force screen output to the monochrome video-RAM at
  244.         B000:0.
  245.  
  246.     -e EAZ|index
  247.         German ISDN (1TR6) allows to specify 1 digit subaddress(EAZ).
  248.         This option defines the EAZ used by ISPA to listen for incoming
  249.         calls. The EAZ will be appended to the basic local address on
  250.     outgoing calls. EAZ's range from 1 to 9. In 1TR6 EAZ 0 means accept
  251.     all EAZ's.
  252.  
  253.     For EuroISDN this option defines an index in the range 0 to 9.
  254.         If your EuroISDN BRI supports MSN's (multiple subscriber numbers)
  255.     this option defines an index into a table of local addresses defined
  256.         during installiation of your ISDN-API 1.1 software. The address
  257.     defined for this index will be used as the local address on outgoing
  258.     calls und will match incoming calls.
  259.         default: 2
  260.  
  261.     -k sleep
  262.     specifies the setup time in seconds. ISPA will wait "sleep"
  263.     seconds for a connection to come up. If the connection does not
  264.     reach the active state during this time, ISPA resets the channel.
  265.     default: 5 seconds
  266.  
  267.     -z days[e]
  268.         forces an automatic restart of the PC after "days"-days, as soon
  269.         as the system becomes idle. "days" should be in the range from 1
  270.         to 2761.
  271.         Appending an "e" to the number of days enables automatic restart
  272.         of the PC if ISPA receives an error from the ISDN API 1.1 software.
  273.         Specifying "0e" enables only reboot on errors.
  274.         default: disabled
  275.  
  276.     -q
  277.         suppresses any message output on the screen.
  278.  
  279.     -v
  280.     ISPA tries to allocate buffers for the CAPI in upper memory (UMB).
  281.     This option disables this feature and ISPA will use conventional
  282.     memory for the CAPI buffers.
  283.  
  284.     -r lop-ip,my-ip[,interval]
  285.         remote logging on a unix host with a syslogd. Using ISPA with
  286.         IP-router software this option can be used to log all connection
  287.         related messages on a unix host with a berkeley syslogd.
  288.         "log-ip" defines the IP address of the unix host. "my-ip"
  289.         defines the source IP address of syslog messages sent by ISPA (a
  290.         packet driver can not automatically retrieve this information from
  291.         the router).
  292.         If "interval" is specified and a connection is up, a syslog message
  293.         will be sent every "interval"-seconds. "interval" should be a
  294.         multiple of 8, otherwise it is internally rounded up to the next
  295.         multiple of 8.
  296.         Syslog-messages are sent with the characteristics "local0.info".
  297.  
  298.     -w
  299.         Display activity, state and charge information in the upper right
  300.         corner of the screen.
  301.  
  302.         /0_\0_A_nnn
  303.         ||||||||  |
  304.         ||||||||  accumulated charge units
  305.         |||||||State of channel 2
  306.         ||||||State of channel 1
  307.         |||||incoming data rate on channel 2 in kB/sec, averaged over 8 seconds
  308.         ||||incoming data rate on channel 1 in kB/sec, averaged over 8 seconds
  309.         |||incoming data, rotates for every received packet
  310.         ||outgoing datarate on channel 2 in kBytes/sec, averaged over 8 seconds
  311.         |outgoing datarate on channel 1 in kBytes/sec, averaged over 8 seconds
  312.         outgoing data, rotates for every transmitted packet
  313.  
  314.         Status: _ = free, D = D-channel up, C = B-channel requested,
  315.                 B = B-channel up, A = connection set up,
  316.         (additional information for PPP:
  317.                 L = lcp configuration requested,
  318.                 I = lcp up, pap/ipcp configuration requested,
  319.                 P = PPP connection up.)
  320.  
  321.     -u
  322.         Limits ISPA to one active connection at a time. This will reduce
  323.         ISPA's memory requirement by 20kB. Selecting loadsharing (-m)
  324.         overrides this option.
  325.  
  326.     -j low[,high]
  327.         defines an ethernet type range for ethernet bridging. Ethernet
  328.         packets with type values outside the selected range are discarded.
  329.         This filter applies to all bridging protocols.
  330.         "low" defines the lower boundary. default: 0
  331.         "high" defines the upper boundary. default: 0xffff
  332.  
  333.  
  334.     ISPA supported protocols:
  335.     (only one protocol can used for one peer)
  336.  
  337.     -f dlci[i]
  338.         Frame-relay protocol. "dlci" specifies the data link connection
  339.         identifier. Appending an "i" to the dlci switches encapsulation
  340.         from "early" style to IETF format as described in RFC 1294 (but
  341.     without fragmentation support, a data size of 1500 is assumed). 
  342.  
  343.     -p
  344.         Point-to-Point protocol using default ppp-parameters.
  345.         Of the possible upper layer protocols, only IP is supported at this
  346.         time.
  347.         From the PPP configuration options PPP PAP is supported in both
  348.         directions. With the -n option a id/password combination can
  349.         be specified for each remote site. With the -g option a local
  350.         id/password can be defined for each peer.
  351.         ISPA accepts the following PPP options from the remote site:
  352.         - LCP MRU requests with values greater or equal to 1500.
  353.         - IPCP IP-ADDRESS requests. The received ip-address can be retrieved
  354.           from an IP application program via RARP.
  355.   
  356.         Additional options for use with PPP. These options have to be 
  357.     specified after the protocol selection option.
  358.  
  359.         -n id,password
  360.            Id/password combination for the remote PPP site. The
  361.            authentication string is send only, if the remote site requests
  362.            Password authentication during PPP option negotiation.
  363.  
  364.         -g id,password
  365.            Defines a local id/password combination. Incoming PPP connections
  366.            are accepted only if the remote site sends this id,password
  367.            combination.
  368.      
  369.     -h type
  370.         other HDLC based protocols
  371.         type = 0, IP-Data, no header
  372.         type = 1, IP-Data, X.75 unnumbered information frame (UI) header
  373.         type = 2, Cisco style HDLC header
  374.         type = 3, Ethernet bridging
  375.         type = 4, remote test loop, incoming data is echoed.
  376.  
  377.     -l type
  378.         LAPB (X.75) based protocols (caller=DCE, window=7, mod 8)
  379.         type = 0, IP-Data, no header, 
  380.         type = 1, multi-X.75 (called LAPB encapsulation an ACC routers or
  381.                   multi-LAPB encapsulation on Cisco routers)
  382.         type = 2, SLIP
  383.         type = 3, Ethernet bridging
  384.         type = 4, remote test loop, incoming data is echoed.
  385.     type = 5, SLIP (same as 2)
  386.         type = 6, Ethernet bridging using SLIP encapsulation (SLX)
  387.  
  388.     -s baudrate
  389.         SLIP protocol with V.110 bitrate adjustment. "baudrate" defines
  390.         the desired transfer rate.
  391.         baudrate = 9,  9600 baud,  async, 8 bit, no parity, 1 stop bit
  392.         baudrate = 19, 19200 baud, async, 8 bit, no parity, 1 stop bit
  393.         baudrate = 38, 38400 baud, async, 8 bit, no parity, 1 stop bit
  394.  
  395.         Additional options for use with SLIP protocol (X.75 or V.110 based).
  396.     The option has to be specified after the protocol selection option.
  397.  
  398.         -n string1,string2,...
  399.        A sequence of strings to send for SLIP login. To adapt to
  400.        the different kinds of login sequences used by SLIP servers,
  401.        ISPA uses a wait/send sequence for highest flexibility.
  402.        ISPA sends a string after having not received data from the
  403.        peer for more than 2 seconds. Each string will be
  404.        automatically terminated by a RETURN. This way an empty string
  405.        field will send a single RETURN. Special characters can be
  406.        included in the string by escaping with \ and specifing the
  407.        ascii code of the character (e.g. \32 will insert a space).
  408.        The ascii code may be terminated by a . if required.
  409.        Additionally \, will insert a comma, otherwise used for
  410.        separating strings, a \. will insert a literal . after an 
  411.        ascii code and \\ will insert a single \.
  412.        ISPA shows all characters received and will switch to SLIP
  413.        mode after sending the last string.
  414.        The total length of the string sequence is limited to 44
  415.        characters.
  416.  
  417.     -y baudrate
  418.         SLX (Ethernet bridging using SLIP encapsulation) protocol with
  419.         V.110 bitrate adjustment. "baudrate" defines the desired transfer
  420.         rate.
  421.         baudrate = 9,  9600 baud,  async, 8 bit, no parity, 1 stop bit
  422.         baudrate = 19, 19200 baud, async, 8 bit, no parity, 1 stop bit
  423.         baudrate = 38, 38400 baud, async, 8 bit, no parity, 1 stop bit
  424.  
  425.     default: -h0
  426.  
  427.     Other translation entry options:
  428.  
  429.     The following options can be specified for each ISDN-number entry in
  430.     the configuration file:
  431.  
  432.     -t max-idle[,min-idle]
  433.         an idle connection will be disconnected after "max-idle"-seconds.
  434.         Setting "max-idle" to zero disables shutdown of idle connections.
  435.         Specifing a "min-idle" value lower than "max-idle", an outgoing
  436.         (charged) connection will be hold at least "min-idle" seconds, it
  437.         will be closed down shortly before the next charge unit is execeeded
  438.         or max-idle expires. The time of one charge unit is calculated from
  439.         the first two units received. max-idle may be used to specify the
  440.     length of the first charge-unit.
  441.         default: max-idle: 300 seconds, min-idle: disabled
  442.  
  443.     -m high[,low]
  444.         static or dynamic loadsharing over both s0-channels.
  445.         "high" = 0, static loadsharing, the caller will always try to
  446.         activate both channels.
  447.         "high" <> 0, dynamic loadsharing, if the load is higher than
  448.         6000 Bytes/sec for "high"-seconds, the system will activate the
  449.         second channel. After "down"-seconds of a load lower than 6000
  450.         Bytes/sec the second channel will be closed down. If "down" is not
  451.         specified, the "max-idle" Timeout will be used (see option -t).
  452.         A -m option has to be specified on both ends of a link. However,
  453.         only the caller of the first channel will activate the second
  454.         channel.
  455.         The values for "high" and "low" should be multiples of 8, otherwise
  456.         they will be rounded up to next multiple of 8.
  457.  
  458.         To set up loadsharing to different target ISDN numbers, a second
  459.         ISDN number can be specified in a translation entry.
  460.  
  461.     -d flags
  462.  
  463.     Specifies ISPA's mode of operation and various flags:
  464.     The "flags" parameter is interpreted as a 16 Bit value with
  465.     the following meaning:
  466.  
  467.     Bit 0-2: Operation mode:
  468.           mode = 0, outgoing calls are disabled.
  469.           mode = 1, incoming and outgoing calls are allowed.
  470.           mode = 2, an outgoing call is dropped after sending the connect
  471.                   request and the system waits for a call back.
  472.           mode = 3, incoming calls are rejected but trigger an outgoing call
  473.                   to the received ISDN-number.
  474.           mode = 4, incoming calls are disabled.
  475.     Bit 3-7: unused
  476.     Bit 8:   Don't reset disconnect timer on received packets.
  477.     Bit 9:   Don't reset disconnect timer on sending broadcast packets.
  478.     Bit 10:  Send broadcast packets over this link.
  479.     Bit 11:  Operate as an IP-address provider for PPP. (If this is a
  480.          PPP link and the IP-address of this entry isn't zero, tell
  481.          the peer which IP-address he has to use.)
  482.  
  483.         default: 1, incoming and outgoing calls enabled
  484.  
  485.     -a service
  486.         (specific to German ISDN, however the API software should map the
  487.         values to corresponding EuroISDN codes)
  488.         additional service indicator and service indicator selection.
  489.         The high byte of the argument "service" redefines the service
  490.         indicator the low-byte defines the additional service indicator.
  491.         Some ISDN equipment (e.g. Elink TA) use the additinal service
  492.         indicator field to selcted a predefined mode/protocol of operation.
  493.         However there is no standard for this field.
  494.         ISPA sets "service" to 0x700 with the following exceptions:
  495.  
  496.         service = 0x7c5: -s 9,  -y 9
  497.         service = 0x7c7: -s 19, -y 19
  498.         service = 0x740: -s 38, -y 38
  499.  
  500.         The option allows to override the default value with your own
  501.         value. (To override the protocol specific default, the value has
  502.         to be positioned after the protocol option on the line.)
  503.  
  504.         To use the ISDN service "X.21 Services" in German national 1TR6
  505.     ISDN use a "service" value of "0x30c".
  506.  
  507.  
  508.     --------------
  509.     Deinstallation
  510.  
  511.     ISPA can be unloaded using ISPACF.EXE or TERMIN.EXE from the
  512.     Clarkson/Crynwr Packet Driver collection. 
  513.  
  514.     -----------
  515.     Controlling
  516.  
  517.     The utility program ISPACF.EXE allows you to:
  518.  
  519.     - manually set up a connection
  520.     - manually terminate all connections
  521.     - to check the parameter table
  522.     - to display/set the IP-address for PPP IP-address negotiation
  523.     - to read out the connection statistics
  524.     - to reset the connection statistics
  525.     - to unload ISPA from memory
  526.  
  527.     --------------
  528.     Other features
  529.  
  530.     1. Dynamic IP address assignment
  531.        ISPA supports dynamic IP address assignment by a remote system
  532.        via RARP and the PPP IPCP IP-ADDRESS negotiation:
  533.  
  534.        - (Make sure that your peer supports the PPP IPCP IP-ADDRESS option.)
  535.        - Configure your IP software for use with RARP.
  536.        - Use ispacf -d <pkt-int> [<ip-address>] to manually set up a connection.
  537.        - (Check the received IP address with ispacf -i <pkt-int>.)
  538.        - Start your IP software.
  539.  
  540.     2. Ascend Routers use the PPP IPCP IP-ADDRESS negotiation for
  541.        remote system identification. They don't support asking for an
  542.        IP-address using PPP IPCP IP-ADDRESS negotiation(as described above).
  543.        For Ascend Routers ISPA has to provide the correct IP-address to the
  544.        peer. To accomplish this you can set the IP-address to the desired
  545.        value using ispacf -i <pkt-int> <ip-address>
  546.  
  547.     3. ISPA can operate as an IP address provider for PPP connections.
  548.        This feature can be enabled on a peer basis using a flag of the
  549.        -d option.
  550.  
  551.     -------------------------------
  552.     Restrictions in current version
  553.  
  554.     1. Option parsing is far away from being perfect. It is possible to
  555.        specify conflicting options. Don't specify more than one protocol
  556.        option per line (translation entry).
  557.  
  558.     2. The current version does NOT support more than one active SLIP or
  559.        SLX connection at a time. For this reason you can NOT use loadsharing
  560.        with SLIP or SLX. Also you can NOT have one active SLIP/SLX
  561.        connection and another connection (using another protocol) at the
  562.        same time. Unpredictable results will occur. I recommend to use
  563.        SLIP/SLX only with the -u option.
  564.  
  565.     ------------------------
  566.     Ethernet characteristics
  567.  
  568.     ISPA works as an ethernet type Packet Driver. The ethernet address of
  569.     ISPA is defined as: 00-00-0xFB-0xAA-00-<pkt-int>. (Thanks to RzK,
  570.     Asbach, Germany for using numbers from their official 00-00-0xFB range.)
  571.     "pkt-int" is replaced by the software interrupt number in the range
  572.     0x60 to 0x80 used for accessing ISPA.
  573.  
  574.     With PKTADDR.EXE from the Clarkson/Crynwr Packet Driver collection the
  575.     ethernet address can be changed to any other desired value.
  576.  
  577.     Changing the ethernet address may be required when connecting two
  578.     ISPA's with direct applications using an ethernet bridging protocol.
  579.     It is not neccessary when using ISPA with PCBRIDGE.
  580.  
  581.     --------
  582.     Examples
  583.  
  584.     1. a simple point-to-point configuration to connect a standalone PC
  585.        to an IP provider. Local IP address 141.61.224.5. The IP Provider
  586.        has a nameserver with address 141.61.1.32. The connections uses
  587.        PPP protocol and the PC has to identify itself using the the id
  588.        "guest" and password "gast". Because the IP address in the ISPA
  589.        configuration file is specified as 0.0.0.0 ALL packets will be
  590.        send to the peer 0815712345. This way NO gateway IP address is
  591.        required in the IP configuration.
  592.  
  593.         ispa ? 0x60
  594.  
  595.     ispa.ini:
  596.     -u   # only only one active channel
  597.         -w   # activity display
  598.     0.0.0.0 089987654 -p -nguest,gast -t60 # only incoming, timeout 60 sec
  599.  
  600.         And the IP configuration of the PC in format of wattcp.cfg
  601.         my_ip=141.61.224.5
  602.         netmask=255.255.255.0              # netmask
  603.         nameserver=141.61.1.32             # nameserver
  604.         nameserver=141.61.1.23             # alt nameserver
  605.         domainslist="biochem.mpg.de"
  606.  
  607.     2. ISPA set up in a multipoint configuration as a dial-in server
  608.        with no outgoing connections.
  609.        All connections are logged with the remote logging feature in the
  610.        syslog file of host 141.61.1.32.
  611.        The syslog messages will appear as coming from 141.61.224.1.
  612.        The protocol for incoming calls from unknown numbers is PPP
  613.        with identification "guest" and passwort "gast".
  614.        The net 141.61 is connected to the Internet via 141.61.1.1.
  615.        The ISPA and PCROUTE configuration will allow the PC of example
  616.        1. to dial in as an unknown ISDN peer and connect to the Internet.
  617.        ISPA can handle two active connections, but only one unknown peer
  618.        at a time.
  619.  
  620.     ispa ? 0x60
  621.  
  622.     ispa.ini:
  623.     -r141.61.1.32,141.61.224.1           # remote logging on 141.61.1.32
  624.     -e4                                  # local EAZ 4
  625.     141.61.224.5 * -p -gguest, gast -t30 # no CLI, protocol PPP
  626.     141.61.224.2 0815712345 -d0 -t60     # incoming from 0815712345
  627.     141.61.224.3 08912345 -h1 -d0 -t60   # incoming from 08912345
  628.     141.61.224.4 08923456 -l1 -d0 -t60   # incoming from 08923456
  629.  
  630.         and the corresponding pcroute configuration:
  631.         Interface 1 (Ethernet):  141.61.1.200  255.255.255.0
  632.         Interface 2 (ISDN)    :  141.61.224.1  255.255.255.0
  633.         Routes:  Net: 0.0.0.0 Gateway: 141.61.1.1
  634.  
  635.     3. ISPA in point-to-point configuration with dynamic Loadsharing. The
  636.        second link will be established after 10 seconds of a load higher
  637.        than 6000 Bytes/sec and will be closed after 20 seconds of a load
  638.        lower than 6000 Bytes/sec. 
  639.  
  640.     ispa ? 0x60
  641.  
  642.     ispa.ini:
  643.     -e4 
  644.     -w
  645.     0.0.0.0 0815712345 -h2 -m10,20 -t90
  646.  
  647.     4. ISPA in multipoint configuration. For incoming calls from unkown
  648.        numbers the -h1 protocol will be used.
  649.  
  650.        ispa ? 0x60 ip2isdn
  651.  
  652.        ip2isdn(ISPA configuration file):
  653.     -e4 -w                 # global options
  654.     2.0.0.6 * -h1 -t60        # other incoming calls
  655.     2.0.0.1 089.89512300 -f100i -t200,30   # ietf frame-relay
  656.     2.0.0.2 089.89512301 -h2 -t20,5 -m8,30 # cisco-hdlc, loadsharing
  657.     2.0.0.3 0033,815711111 -d0 -t40        # hdlc, only incoming
  658.     2.0.0.5 0,4518789123 -p -t60,10        # PPP
  659.  
  660.  
  661.     -------
  662.     Support
  663.  
  664.     The latest version of ISPA is available on ftp.biochem.mpg.de.
  665.  
  666.     Please mail comments, questions, problems to heha@biochem.mpg.de.
  667.     I can not guarantee any level of technical support, or for any
  668.     length of time. In general, I will give priority to registered users.
  669.  
  670.     --------
  671.     Warranty
  672.  
  673.     There is absolutely NO  WARRANTY, expressed or implied with
  674.     this software.  If you choose to use this software, you
  675.     assume all risk.
  676.  
  677.     -----------------------
  678.     Appendix A: Error codes
  679.  
  680.     The error codes from ISPA are the same as defined in the ISDN-API 1.1
  681.     specification:
  682.  
  683.     2001    incorrect controller
  684.     2002    incorrect PLCI
  685.     2003    incorrect NCCI
  686.     2004    incorrect type
  687.  
  688.     3101    B-channel incorrectly coded
  689.     3102    Info-mask incorrectly coded
  690.     3103    Serviced EAZ-mask incorrectly coded
  691.     3104    Serviced SI mask incorrectly coded
  692.     3105    B-channel protocol, level 2 incorrect
  693.     3106    DLPD incorrect
  694.     3107    B-channel protocol, level 3 incorrect
  695.     3108    NCPD incorrect
  696.     3109    NCPI incorrect
  697.     310A    Flags incorrectly coded
  698.  
  699.     3201    Controller error
  700.     3202    Conflict between registrations, check SI mask and EAZ
  701.     3203    Function not supported
  702.     3204    PLCI not active
  703.     3205    NCCI not active
  704.     3206    B-channel protocol, level 2 not supported
  705.     3207    Changeover of B-channel protocol, level 2 in this state not
  706.             possible
  707.     3208    B-channel protocol, level 3 not supported
  708.     3209    Changeover of B-channel protocol, level 3 in this state not
  709.             possible
  710.     320A    Unsupported parameters in DLPD
  711.     320B    Unsupported parameters in NCPD
  712.     320C    Unsupported parameters in NCPI
  713.     320D    data length not supported
  714.  
  715.     3301    Error on setup of D-channel, level 1
  716.     3302    Error on setup of D-channel, level 2
  717.     3303    Error on setup of B-channel, level 1
  718.     3304    Error on setup of B-channel, level 2
  719.     3305    Abort D-channel, level 1
  720.     3306    Abort D-channel, level 2
  721.     3307    Abort D-channel, level 3
  722.     3308    Abort B-channel, level 1
  723.     3309    Abort B-channel, level 2
  724.     330A    Abort B-channel, level 3
  725.     330B    B-channel connection, level 2 reestablished
  726.     330C    B-channel connection, level 3 reestablished
  727.  
  728.     34xx    Abort by network, low order 8 Bit contain the cause value
  729.             according 1TR6, the MSB is used to signal an error, but is not
  730.             set by all ISDN-API 1.1 implementations.
  731.  
  732.     Cause-table according to 1TR6 (don't know what you will get with EuroISDN)
  733.  
  734.     00  normale Ausloesung (0 = lokal, 3400 = durch die Gegenstelle)
  735.         normal termination (0 = local, 3400 = from the network)
  736.  
  737.     83  Dienst ist nicht verfuegbar oder nicht beantragt
  738.         Service not available
  739.  
  740.     8A  kein B-Kanal auf lokaler Anschlussleitung verfuegbar
  741.         all B-channels are busy on the local line
  742.  
  743.     91  angefordertes Dienstmerkmal wurde abgelehnt, weil eigener
  744.         oder ferner Anschluss keine Berechtigung besitzt
  745.         ??
  746.  
  747.     a0  abgehende Rufe wegen eingerichteter Sperre nicht moeglich
  748.         outgoing calls blocked
  749.  
  750.     a2  Verbindung nicht moeglich wegen negativen GBG-Vergleich
  751.         Closed-user-group refused connection
  752.  
  753.     a3  angegebene GBG (geschlossene Benutzergruppe) unbekannt
  754.         specified closed-user-group unknown
  755.  
  756.     a5  Kommunikationsbeziehung als SPV nicht freigegeben
  757.         SPV not enabled for this number
  758.  
  759.     b5  Verbindung nicht aufbaubar wegen falscher Zieladresse,
  760.         Dienste oder Dienstmerkmale
  761.         ??
  762.  
  763.     b8  Rufnummer des gerufenen Teilnehmers hat sich geaendert
  764.         number of called station has changed
  765.  
  766.     b9  ferne DEE nicht betriebsbereit
  767.         remote station not ready
  768.  
  769.     ba  Ruf wurde von keiner Datenstation beantwortet
  770.         no station responding
  771.  
  772.     bb  gerufene Datenstation besetzt
  773.         called station busy
  774.  
  775.     bb  Gerufener Teilnehmer hat Sperre gegen ankommende Rufe oder
  776.         angeforderter Dienst vom gerufenen Teilnehmer nicht beantragt
  777.         ??
  778.  
  779.     be  Ruf wurde von gerufener Datenstation abgewiesen
  780.         Call was rejected by called station
  781.  
  782.     da  Verbindung von ferner Datenstation ausgeloest oder abgelehnt
  783.         Connection was terminated or rejected by called station
  784.  
  785.     f0  Im aktuellen Verbindundsstand keine Dienstmerkmalanforderung moeglich
  786.         ??
  787.  
  788.     f1  Ausloesung wegen Fehler bei der gerufenen Station
  789.         Disconneted due to an error at the remote station
  790.  
  791.