home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 2 / amigaformatcd02.iso / comms / netsoftware / nethandler.lha / NetHandler / doc / netsource.doc < prev    next >
Encoding:
Text File  |  1989-09-17  |  5.9 KB  |  142 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. SOFTWARE DISTILLERY NETWORK FILE SYSTEM, VERSION 1.0
  12.  
  13. This material is Copyright (C) 1988 and 1989 The Software Distillery.
  14.  
  15. ------------------------------DISCLAIMER
  16.  
  17. Neither The Software Distillery nor any of its members will be liable for 
  18. any damage arising from the failure of this program to perform as described,
  19. or any destruction of other programs or data residing on a system 
  20. attempting to run the program.  While we know of no damaging errors, the 
  21. user of this program uses it at his or her own risk.
  22.  
  23. -----------------------------FUNCTIONALITY 
  24.  
  25. The network handler in this distribution relies on DNET for communication,
  26. but all dependancies on DNET are isolated.  The intent is for a future 
  27. release to support ANY COMMUNICATIONS METHOD, including serial, parallel,
  28. AppleTalk, DecNET, NFS, you name it, all simultaneously via external 
  29. communications servers.  
  30.  
  31. ============================================================================
  32.  
  33. SETTING UP THE SOURCE DIRECTORY
  34.  
  35. If you received this software as a ZOO archive, you should use the
  36. x// option to de-archive it into its original directory structure.
  37. If you didn't, delete the files produced and start over with
  38.  
  39.    ZOO x// netsrc1.zoo
  40.  
  41. You should de-zoo the archive into its own directory, since there are
  42. many files in the root of the directory structure.
  43.  
  44. ============================================================================
  45.  
  46. RUNNING THE NETWORK HANDLER:
  47.  
  48. These instructions talk about a 'local' machine and a 'remote' machine.
  49. The network is symmetrical, so for DNET at least, you can do the 
  50. installation on both sides.  Just install all files on both machines,
  51. and perform all commands on both machines.
  52.  
  53. 1. Install DNET on both machines.  Add an entry to the dnet.servers 
  54.    file on the remote machine for the network server.  A sample 
  55.    dnet.servers file is included in this distribution in the file 
  56.    "dnet.servers".  Note the server number for the network is 9492.  You 
  57.    will need to change the pathname specified in the sample dnet.servers 
  58.    file to reflect the path you intend to use.
  59.  
  60. 2. Copy netdnet-server to the path specified in the dnet.servers file on
  61.    the remote machine.
  62.  
  63. 3. Put a mountlist entry for the network handler in the local machine's
  64.    DEVS:MOUNTLIST.  A sample mountlist entry is included in this 
  65.    distribution in the file "mountlist".  If you do not want the network 
  66.    handler in l:, replace the specified path with one of your own.
  67.  
  68. 4. Copy netdnet-handler from the HANDLER subdirectory to the path specified
  69.    in the mountlist on the local machine.
  70.  
  71. 5. Issue the CLI command "ASSIGN ROOT: <path>" on the remote machine.  The
  72.    network handler mounts the ROOT: device on the remote node as a network
  73.    node on the local node;  the place you point ROOT: to is where your
  74.    files will go.  Copy the file NODE.INFO from the distribution disk
  75.    to ROOT:.  This file contains the .info information for the remote node
  76.    that will be displayed on the workbench screen of the local node.  Feel
  77.    free to replace it with any DRAWER type .info file.
  78.  
  79. 6. Issue the CLI command "MOUNT NET:" on the local node.  The first 
  80.    reference to NET: after the MOUNT command will load the handler.  DNET
  81.    will load the server on the remote node automatically.
  82.  
  83. ============================================================================
  84.  
  85. Once the NET: device is running, you can use the provided NETMOUNT command
  86. to allow access to other devices besides ROOT: on the remote machine.
  87. NETMOUNT is a temporary stopgap until a real ROOT: device is implemented
  88. that allows access to all devices on a machine via a single handler.
  89.  
  90. For now, the NETMOUNT command format is
  91.  
  92. NETMOUNT <local device> <node name> <remote device>
  93.  
  94. where <local device>  is the name you MOUNTed (usually NET:)
  95.       <node name>     is the name you want to refer to the new entry as
  96.       <remote device> is the name of the device on the remote node to use
  97.       
  98. For example, 
  99.  
  100. NETMOUNT NET: DF0 DF0:
  101.  
  102. would allow you to access the floppy on the remote node by using the path
  103. NET:DF0.  Thus, 
  104.  
  105. DIR NET:DF0
  106.  
  107. would produce the same results as doing a DIR DF0: on the remote machine.
  108.  
  109.  
  110. ============================================================================
  111.  
  112. This version of NET: is dependent on DNET.  However, all DNET-specific calls
  113. are isolated in the files iodnet.c, handler/netdnet.c and server/netdnet.c.
  114. Functions in these files refer to functions in dnetlib.c;  dnetlib.c is
  115. part of Matt Dillon's DNET distribution and will not be required if you
  116. replace the functions in the three previously named files.
  117.  
  118. The source directory contains all .c and .h files common to both the handler
  119. and the server ends of the network file system.  Handler-specific code 
  120. resides in the 'handler' subdirectory;  server-specific code resides in the
  121. 'server' subdirectory; and utilities such as the 'handd' debugging tool,
  122. the 'netstat' tool to give statistics, the 'shutdown' command to kill the
  123. network, and so forth reside in the 'utilities' subdirectory.
  124.  
  125.  
  126. Contact us with any problems:
  127.  
  128. PLINK:  DWALKER, JTOEBES
  129. BIX:    DJWALKER, JTOEBES
  130. USENET: ...mcnc!rti!sas!walker, ...mcnc!rti!sas!toebes
  131.         (Usenet connection is flakey)
  132. US MAIL:
  133.    Doug Walker
  134.    405 B3 Gooseneck Dr
  135.    Cary, NC 27513
  136.    USA
  137.  
  138.    John Toebes
  139.    235 Trillingham Lane
  140.    Cary, NC 27513
  141.    USA
  142.