home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / useful / comm / tcp / amitcp / note_to_beta_testers < prev    next >
Text File  |  1994-05-09  |  4KB  |  132 lines
  1.         Note to AmiTCP/IP beta testers
  2.         ==============================
  3.  
  4.  
  5. PLEASE READ CAREFULLY
  6. ---------------------
  7.  
  8.     This is a BETA release of the AmiTCP/IP. There is no bugs
  9.     (note the omissions section below, however), that we would be
  10.     aware of, but we thought that it would be wise to test it more
  11.     before release. Please do not distribute this too widely,
  12.     since even INCOMPATIBLE changes WILL BE MADE to the actual
  13.     release, if there are good reasons to do so.
  14.  
  15.     So, you have been warned!
  16.  
  17.  
  18. A wish for all application developers
  19. -------------------------------------
  20.  
  21.     One purpose of this beta release is to give you some time to
  22.     update your applications to use the new features of the AmiTCP
  23.     distribution, so that they would be available when the actual
  24.     AmiTCP/IP release 3.0 ships.
  25.  
  26.     So, please recompile all your AmiTCP code and use the new
  27.     features. Take special care with the following:
  28.  
  29.         3.0 beta 2:
  30.  
  31.         - The net.lib implements the level 1 I/O functions,
  32.           replacing the functions of the sc.lib. This
  33.           functionality is highly compiler (or link library)
  34.           specific, and is tested on SAS/C 6.51 sc.lib only.
  35.           On the bright side, this should make porting those
  36.           applications _mush_ easier!
  37.  
  38.         - The library functions for starting an inetd started
  39.           daemon have changed. See the
  40.           src/examples/serv/in.example.c for an example.
  41.           The binary interface with the inetd has not changed,
  42.           though.
  43.           
  44.         3.0 beta (1):
  45.  
  46.         - user informations should now be get with the
  47.           usergroup.library. All you need to do is to include
  48.           the usr.lib to the link and _use_ the functions
  49.           provided.
  50.  
  51.         - also the path to the user home directory is got from
  52.           the usergroup.library, so please change all
  53.           user-specific files to be stored/taken to/from
  54.           there.
  55.  
  56.         - AmiTCP now adds the program name automatically to
  57.           every syslog message.
  58.  
  59.         - you need now longer need to use the `l' modifiers
  60.           with the syslog(), since all arguments are expected
  61.           to be longs.
  62.  
  63.         - SetDTableSize() no longer exists (it was changed to
  64.           getdtablesize() so old programs will work just fine,
  65.           the table size just is not changed).
  66.           SocketBaseTagList() now has a tag for setting the
  67.           dtable size.
  68.  
  69.         - interface names are now only 16 chars long (the BSD
  70.           style). This will not need any changes to your
  71.           source.
  72.  
  73.     Please read the README.FIRST carefully, since it should
  74.     contain notes of all API changes.
  75.  
  76.  
  77. Omissions of this beta release
  78. ------------------------------
  79.  
  80.     - The installation script (Install_AmiTCP) is not at the best
  81.       with the new way to handle the interfaces.
  82.     - AmiTCP/IP documentation is still not included in the
  83.       distribution. This will be on the actual release, however.
  84.     - portmap is single threaded by now, so some of the rpcinfo
  85.       operations will just not work (they wait until the
  86.       timeout hits).
  87.  
  88.  
  89. Few notes on setting up the AmiTCP/IP 3.0 beta
  90. ----------------------------------------------
  91.  
  92.     Since the interface names have been modified, your
  93.     bin/startnet script has to be changed.
  94.  
  95.     The db/interfaces contains defaults for the a2065.device,
  96.     a2060.device, ax25.device, rhcslip.device and rhslip.device,
  97.     which should be changed as follows:
  98.  
  99.         a2065.device/0    -> ether0
  100.         a2060.device/0    -> arcnet0
  101.         ax25.device/0    -> axdm0
  102.         rhcslip.device/0 -> cslip0
  103.         rhslip.device/0    -> slip0
  104.  
  105.     The interface names are fully configurable by editing the
  106.     db/interfaces file.
  107.  
  108.     Note that online/offline still takes the name of the actual
  109.     sana2 device driver on the old format (or '/' replaced by a
  110.     blank). Note also, that these still need the 'networks/'
  111.     prefix on the device name.
  112.  
  113.     In addition to changing the interface name you should delete
  114.     the `wait 2' line, which is not needed any more.
  115.  
  116.     Then you should add following line to the end of the script:
  117.  
  118.         AmiTCP:bin/login -f <your-user-name>
  119.  
  120.     The "-f" option causes the login not to ask the password at
  121.     all. If you leave that off, the password is asked normally.
  122.  
  123.     This requires you to edit the db/passwd to include a proper
  124.     entry for your login name.
  125.  
  126.     Also note that taking the ">nil:" redirections, which you have
  127.     probably added to the bin/startnet commands, away makes your
  128.     setting up easier, since you will see any possible error
  129.     messagas generated by the commands :-)
  130.  
  131. EOF
  132.