home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 2 / amigaformatcd02.iso / comms / netsoftware / nethandler.lha / NetHandler / doc / README < prev   
Encoding:
Text File  |  1989-09-17  |  7.6 KB  |  181 lines
  1. /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *\
  2. * |_o_o|\\ Copyright (c) 1989 The Software Distillery.                    *
  3. * |. o.| ||          All Rights Reserved                                  *
  4. * | .  | ||          Written by John Toebes and Doug Walker               *
  5. * | o  | ||          The Software Distillery                              *
  6. * |  . |//           235 Trillingham Lane                                 *
  7. * ======             Cary, NC 27513                                       *
  8. *                    BBS:(919)-471-6436                                   *
  9. \* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
  10.  
  11. This material is Copyright (C) 1988 and 1989 The Software Distillery.
  12. It may be distributed freely as long as the following restrictions are met:
  13.  
  14.    1.  All files present in the distribution package must be redistributed
  15.        with the package, including this documentation file.  If you 
  16.        distribute on diskette, all files must be on a single diskette.
  17.        A list of files in this distribution is at the end of this file.
  18.  
  19.    2.  The distributor may charge a fee to recover distribution costs.
  20.        The fee for diskette distribution should not be more than the cost 
  21.        to obtain the same diskette from Fred Fish or The Software Distillery,
  22.        whichever is greater.  Current charge from The Software Distillery
  23.        is $6 per disk in the United States and Canada, $7 outside, including 
  24.        all postage and handling charges.
  25.  
  26.    3.  The distributor agrees to cease distributing the programs and data
  27.        involved if requested to do so by authors or any member of The 
  28.        Software Distillery.
  29.  
  30. ------------------------------DISCLAIMER
  31.  
  32. Neither The Software Distillery nor any of its members will be liable for 
  33. any damage arising from the failure of this program to perform as described,
  34. or any destruction of other programs or data residing on a system 
  35. attempting to run the program.  While we know of no damaging errors, the 
  36. user of this program uses it at his or her own risk.
  37.  
  38. -----------------------------FUNCTIONALITY 
  39.  
  40. The network handler in this distribution relies on DNET for communication,
  41. but all dependencies on DNET are isolated.  The intent is for a future 
  42. release to support ANY COMMUNICATIONS METHOD, including serial, parallel,
  43. AppleTalk, DecNET, NFS, you name it, all simultaneously via external 
  44. communications servers.
  45.  
  46.  
  47. ============================================================================
  48.  
  49. RUNNING THE NETWORK HANDLER:
  50.  
  51. These instructions talk about a 'local' machine and a 'remote' machine.
  52. The network is symmetric, so for DNET at least, you can do the 
  53. installation on both sides.  Just install all files on both machines,
  54. and perform all commands on both machines.
  55.  
  56. 1. Install DNET on both machines.  Add an entry to the dnet.servers 
  57.    file on the remote machine for the network server.  A sample 
  58.    dnet.servers file is included in this distribution in the file 
  59.    "dnet.servers".  Note the server number for the network is 9492.  You 
  60.    will need to change the pathname specified in the sample dnet.servers 
  61.    file to reflect the path you intend to use.
  62.  
  63. 2. Copy netdnet-server to the path specified in the dnet.servers file on
  64.    the remote machine.
  65.  
  66. 3. Put a mountlist entry for the network handler in the local machine's
  67.    DEVS:MOUNTLIST.  A sample mountlist entry is included in this 
  68.    distribution in the file "mountlist".  If you do not want the network 
  69.    handler in l:, replace the specified path with one of your own.
  70.  
  71. 4. Copy netdnet-handler to the path specified in the mountlist on the 
  72.    local machine.
  73.  
  74. 5. Issue the CLI command "ASSIGN ROOT: <path>" on the remote machine.  The
  75.    network handler mounts the ROOT: device on the remote node as a network
  76.    node on the local node;  the place you point ROOT: to is where your
  77.    files will go.
  78.  
  79. 6. Copy the file NODE.INFO from the distribution disk to ROOT:.  This file 
  80.    contains the .info information for the remote node that will be 
  81.    displayed on the workbench screen of the local node.  Feel free to 
  82.    replace it with any DRAWER type .info file.
  83.  
  84. 7. Issue the CLI command "MOUNT NET:" on the local node.  The first 
  85.    reference to NET: after the MOUNT command will load the handler.  DNET
  86.    will load the server on the remote node automatically.
  87.  
  88. 8. If you want a two-way network, repeat steps 1-7, but this time switch
  89.    your idea of which node is 'local' and which is 'remote'.
  90.  
  91. ============================================================================
  92.  
  93. Once the NET: device is running, you can use the provided NETMOUNT command
  94. to allow access to other devices besides ROOT: on the remote machine.
  95. NETMOUNT is a temporary stopgap until a real ROOT: device is implemented
  96. that allows access to all devices on a machine via a single handler.
  97.  
  98. For now, the NETMOUNT command format is
  99.  
  100. NETMOUNT <local device> <node name> <remote device>
  101.  
  102. where <local device>  is the name you MOUNTed (usually NET:)
  103.       <node name>     is the name you want to refer to the new entry as
  104.       <remote device> is the name of the device on the remote node to use
  105.       
  106. For example, 
  107.  
  108. NETMOUNT NET: DF0 DF0:
  109.  
  110. would allow you to access the floppy on the remote node by using the path
  111. NET:DF0.  Thus, 
  112.  
  113. DIR NET:DF0
  114.  
  115. would produce the same results as doing a DIR DF0: on the remote machine.
  116.  
  117. ============================================================================
  118.  
  119. The provided NETSTAT command gives you a visual idea of how much work your
  120. network is doing.  Run it with the command
  121.  
  122. RUN NETSTAT <devicename>
  123.  
  124. where <devicename> is the name of your network device (probably NET:).
  125. Click on the close gadget in the upper left corner to exit.
  126.  
  127. ============================================================================
  128.  
  129. Differences and enhancements:
  130.  
  131. VERSION 05/09/89:
  132.   First version released
  133.  
  134. VERSION 07/18/89:
  135.  
  136. - Speed improved due to decreasing minimum packet size
  137.   Should help when loading executables over the network and when doing
  138.   directory operations.
  139.  
  140. - Debugging code removed
  141.   This makes the code smaller and faster
  142.  
  143. - Bug fixed in the ACTION_CREATE_DIR packet
  144.  
  145. ============================================================================
  146.  
  147. CONTENTS:  This distribution should contain the following files:
  148.            
  149.      server (dir)
  150.        device.c                         dir.c
  151.        dispatch.c                       file.c
  152.        io.c                             lock.c
  153.        main.c                           makefile
  154.        netdnet-server                   netdnet.c
  155.        server.h                         struct.h
  156.        volume.c                         
  157.      handler (dir)
  158.        device.c                         devio.c
  159.        dir.c                            file.c
  160.        handler.h                        io.c
  161.        lock.c                           main.c
  162.        makefile                         mount.c
  163.        netdnet-handler                  netdnet.c
  164.        process.c                        volume.c
  165.      doc (dir)
  166.        dnet.servers                     mountlist
  167.        netsource.doc                    README
  168.      util (dir)
  169.        handd                            handd.c
  170.        netmount                         netmount.c
  171.        netstat                          netstat.c
  172.        netstat.h                        netstat.lnk
  173.        shutdown                         shutdown.c
  174.   channel.h                        debug.c
  175.   dnet.h                           dnetlib.c
  176.   iodnet.c                         netcomm.h
  177.   netdev.h                         netdnet.h
  178.   proto.h                          request.c
  179.   sendpkt.c                        subs.c
  180.   timer.c                          
  181.