home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Netzwerk / scream_1.dms / in.adf / inet.lha / inet / docs / readme! < prev    next >
Encoding:
Text File  |  1993-01-11  |  6.7 KB  |  165 lines
  1.  
  2.  
  3.     ******************************************************************
  4.  
  5.     This is a BETA version of this software. ALL the files on this disk 
  6.     should be considered beta and, as such, we may change them at will
  7.     (theoretically because of the input from beta testers :))
  8.  
  9.     ******************************************************************
  10.  
  11. This is a beta release of the CBM AS225 TCP/IP package.  There are some
  12. important changes to this software that must be dealt with so please read
  13. and understand the following: 
  14.  
  15.                             -------------
  16.                             General stuff
  17.                             -------------
  18.  
  19.     1. You need inet.library version 5.2 or later in your inet:libs
  20.        directory.
  21.     
  22.     2. You need socket.library version 4.0 or later in your inet:libs
  23.        directory.
  24.     
  25.  
  26.     3. You need a directory called 'networks' in your DEVS: directory.
  27.        devs:networks"
  28.  
  29.     4. This software now uses the SANA-II device drivers. You will need 
  30.        to place the SANA-II device drivers in the "devs:networks" 
  31.        directory. Commodore provides SANA-II device drivers for the 
  32.        A2065 Ethernet card, the A2060 ARCNET card, and drivers for SLIP 
  33.        and CSLIP. Any other hardware used must have it's own SANA-II 
  34.        device driver. This would normally come from the hardware's 
  35.        manufacturer.
  36.  
  37.        These network device drivers should be placed in the 
  38.        "DEVS:networks" directory.
  39.  
  40.     5. You need a file in your "inet:s:" directory called "sana2_devs".
  41.        See the section below on the "sana2_devs" file for what this needs
  42.        to look like.
  43.     
  44.     6. The "inet:db/inetd.conf" has changed in structure.   The 'user'
  45.        field in the previous version has been removed. So, if an entry in
  46.        your old inetd.conf file lookked like:
  47.        
  48.             ftp stream tcp nowait nobody inet:serv/ftpd -l
  49.        
  50.        then the new version would look like:
  51.        
  52.             ftp stream tcp nowait inet:serv/ftpd -l
  53.        
  54.        You are warned - the new inetd will not work properly with the
  55.        old inetd.conf structure.
  56.        
  57.  
  58. Inet.library 5.2  (61660 bytes)
  59. -------------------------------
  60.  
  61.     
  62.     There are two main things to note about inet.library v5.2 :
  63.  
  64.     1. It is now a SANA-II library in that you need SANA-II drivers to 
  65.        talk to your hardware.  You will need the a2065.device (Ethernet) 
  66.        and/or the a2060.device(ARCNET) to speak to the Commodore boards.
  67.        These drivers are on this disk in a directory called 
  68.        ":devs/networks". The proper place for these drivers is in a 
  69.        directory called "networks" in your system's "devs:" volume.
  70.         
  71.         example:   "devs:networks/a2065.device"
  72.  
  73.        In addition, you need a file 'sana2_devs' which goes in the
  74.        inet:s directory.  This is described in detail below.
  75.  
  76.     2. This new inet.library does NOT forward IP packets from board to
  77.        board. The old inet.library did this. It shouldn't have. (See 
  78.        RFC 1122.)  The old version (a) defaulted to ON, and (b) had 
  79.        no way to turn it off.  The new one defaults to OFF and we now 
  80.        provide you with a "inet:c/configinet" which allows you to 
  81.        (a) set the status of  this flag and (b) query the status of 
  82.        the flag.
  83.        
  84.        People using Amigas as gateways should take note.  Docs for 
  85.        'configinet' are in the docs directory.
  86.  
  87.  
  88. Socket.library 4.2 (25432 bytes)
  89. --------------------------------
  90.  
  91.     The new version 4.2 of the new socket.library offers Domain Name
  92.     Service (DNS).  See the docs directory.
  93.  
  94.  
  95.  
  96.      ==================================================================
  97.  
  98. Sana2_devs file
  99. ---------------
  100.  
  101.         Inet.library has received some major changes in terms of
  102.     it's communication with networking hardware.  As of version 5.0,
  103.     all of the hardcoded device drivers (such as hardcoded A2065,
  104.     A2060, or SLIP drivers) have been removed from the code, and
  105.     replaced with an interface to standardized SANA-II drivers. 
  106.     Naturally, this causes certain changes to AS225 installations:
  107.     
  108.         Most importantly, there exists a new file "inet:s/sana2_devs"
  109.     which must exist in order for inet.library to operate.  A sample
  110.     of the file follows:
  111.     
  112.     #Sana II devices used by the inet.library
  113.     #device path             Unit No IPType  ARPType (opt. hardware addr)
  114.     #--------------------------------------------------------------------
  115.     devs:Networks/a2065.device  0     2048    2054
  116.     devs:Networks/a2065.device  1     2048    2054
  117.     devs:Networks/a2060.device  0     240     241
  118.     devs:Networks/slip.device   0     1       2
  119.     
  120.         Each line in the file represents an inet.library device, and
  121.     these devices are numbered, beginning with the first entry in
  122.     the file.  The name that inet.library will know the device by is
  123.     simply an 's', followed by the number of the entry in the file -
  124.     starting with zero.  In our example, the first line relates
  125.     to 's0', the second to 's1', the third to 's2', and the last to
  126.     's3'.
  127.     
  128.         Since the hardcoded drivers are no longer included in
  129.     inet.library, any and all references users may be making to them
  130.     (such as references to 'ae0' or 'ae1' in their inet:s/start-inet
  131.     files) are now faulty.
  132.     
  133.         Each line is broken up into five fields -- the pathname of
  134.     the SANA-II device, the unit number to configure, the ip and arp
  135.     packet types, and an optional hardware address.
  136.     
  137.         The path of the SANA-II device is fairly self-explanatory. 
  138.     Most SANA-II devices can (should) be found in devs:Networks.
  139.     
  140.         The unit number is used to differentiate between multiple
  141.     boards of the same type in a machine.  For instance, if you plug
  142.     two A2065 boards into an Amiga, the first board is unit 0, the
  143.     second is unit 1, and so on.
  144.     
  145.         The IP and ARP types are standardized "packet types".  It is
  146.     by these numbers that inet.library is capable of determining
  147.     which packets coming over the network are TCP/IP packets. 
  148.     Unfortunately, even though these numbers are standardized, they
  149.     vary between different types of hardware. For Ethernet, they are
  150.     2048 and 2054, respectively.  Arcnet seems to have three
  151.     seperate 'standards', but the most common usage seems to be 240
  152.     and 241 respectively.  SLIP, as in our example above, has no
  153.     notion of packet types, so any two different numbers will do.
  154.     
  155.         If you wish to use inet.library with an unusual SANA-II
  156.     device that doesn't have an inherent hardware address, you can
  157.     optionally specify one.  The format is a 0x, followed by any
  158.     number of hex digits (up to the SANA-II limit of 32).  An
  159.     example might be 0x8 for hardware address 8.
  160.  
  161.  
  162.  
  163.     
  164.  
  165.