home *** CD-ROM | disk | FTP | other *** search
/ The Pier Shareware 6 / The_Pier_Shareware_Number_6_(The_Pier_Exchange)_(1995).iso / 033 / atcp40de.zip / NETFS.DOC < prev    next >
Text File  |  1994-03-21  |  7KB  |  207 lines
  1.  
  2.                NetFS -- network file system for AmiTCP
  3.                ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4.  
  5.                            by Timo Rossi
  6.  
  7.  
  8.                       Version 0.56 (19-Mar-94)
  9.  
  10.  
  11.    NetFS is a network filesystem for Amigas running the AmiTCP protocol stack.
  12.  
  13. Requirements:
  14. ~~~~~~~~~~~~~
  15.  ╖ AmigaOS 2.04 or later (AmiTCP requires it anyway)
  16.  
  17.  ╖ AmiTCP version 3.0 or later.
  18.  
  19.  ╖ Some sort of network interface that has a Sana2 driver and works
  20.    with AmiTCP (Ethernet, ArcNet, SLIP, CSLIP, PLIP or something other).
  21.  
  22.  
  23. Installation instructions:
  24. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  25.  
  26.  ╖ Make sure that you have AmiTCP configured properly and it can communicate
  27.    between the machines you want to use with NetFS (you can use
  28.    the ping-command for checking this)
  29.  
  30.  ╖ Copy netfs-handler to AmiTCP:L-directory on client machine
  31.    (In earlier versions of NetFS the system L:-directory was used. 
  32.     Also, an alternate directory can be specified in the mountlist
  33.     or using the HANDLER-keyword in the netmount-command)
  34.  
  35.  ╖ Copy netfs-server to AmiTCP:serv-directory on server machine
  36.  
  37.  ╖ Copy netmount to some directory that is in your path (AmiTCP:bin
  38.    is a good place)
  39.  
  40.  ╖ Add the following line to the AmiTCP:db/services on all machines
  41.    that will use NetFS (both client and server):
  42.  
  43. amiganetfs    2500/tcp
  44.  
  45.    You may select another port number if the default 2500 conflicts with
  46.    something (port 2500 is not officially registered for NetFS)
  47.  
  48.    If you already have AmiTCP running and don't want to reboot the machine,
  49.    you should send the RESET-command to the AmiTCP AREXX-port to get it
  50.    to re-read the configuration file.
  51.  
  52.    (You can also use the AmiTCP AREXX port to add the service entry without
  53.     editing the netdb file. See AmiTCP documentation for details)
  54.  
  55. ╖  Add the following line to the AmiTCP:db/inetd.conf
  56.  
  57. amiganetfs stream    tcp nowait root amitcp:serv/netfs-server
  58.  
  59.    If you have put netfs-server in some other directory than amitcp:bin,
  60.    you should use that directory name here instead.
  61.  
  62.    If you already have AmiTCP running and don't want to reboot the machine,
  63.    you should send a Ctrl-F signal to inetd with the break-command.
  64.  
  65. ╖  Use the netmount-command to mount the partitions you want.
  66.    The command syntax is:
  67.  
  68. netmount hostname remotedev localdev
  69.  
  70.   For example, if you want to mount drive dh0: on a machine called Amiga1
  71.   and you want to call the local device rh0:, you can use the following:
  72.  
  73. netmount Amiga1 dh0 rh0
  74.  
  75.   The full command template for netmount is:
  76.  
  77. SERVER=HOST/A,REMOTEDEV/A,LOCALDEV/A,HANDLER/K,NOACT/S:
  78.  
  79.   If you have put netfs-handler in some other directory than L: or renamed
  80.   it, you can specify its filename with the HANDLER keyword.
  81.  
  82.   Normally netmount automatically activates the mounted device (the same
  83.   way as 'Mount=1' keyword in mountlist). If you don't want that to
  84.   happen, you can use the NOACT-switch. In that case the device process
  85.   starts when the device is first referenced.
  86.  
  87.  
  88. MountLists (optional):
  89. ~~~~~~~~~~~~~~~~~~~~~~
  90.   Alternatively you can make the mountlist entries and use the normal mount-
  91.   command. You can put these in the normal DEVS:MountList file or a separate
  92.   file and use the Mount FROM-option. If you have AmigaDOS 2.1 or newer,
  93.   you can also use the new style mountfiles instead of mountlists.
  94.  
  95.   Here is an example mountlist entry:
  96.  
  97. RH0:
  98.     Handler = L:netfs-handler
  99.     Priority = 5
  100.     StackSize = 5000
  101.     GlobVec = -1
  102.     Mount = 1
  103.     Startup = Server-machine.name.domain/Device-DH0:
  104. #
  105.  
  106.    The only parameters that you need to change are the server machine name
  107.    and the device name (The syntax is a little strange for compatibility with
  108.    different versions of the Mount-command. Most of them don't like '='-signs
  109.    on the startup-line)
  110.  
  111.    If you use the 2.1+ mountfiles, you don't need the device name in the beginning
  112.    or the '#' in the end.
  113.  
  114.  
  115.    (But it is so much easier to use the netmount-command, that you probably
  116.    don't want to use mountlists)
  117.  
  118.  
  119. Security (or the lack of it):
  120. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  121.    Netfs has a couple of primitive security features.
  122.  
  123.     ╖ You can prevent mounting a partition by putting a file called '.nomount'
  124.       in the root directory of that partition.
  125.  
  126.     ╖ You can cause a partition to be mounted in read-only mode by putting
  127.       a file called '.readonly' in the root directory of that partition.
  128.  
  129.   You cannot control which machines may connect to the server, so it might
  130.   not be a good idea to connect a machine with netfs-server to the
  131.   global Internet (of course you can use a strange port number
  132.   and hope that nobody guesses it (security through obscurity)).
  133.  
  134.   It is likely that future versions of netfs have more advances security/
  135.   access control features.
  136.  
  137.  
  138. Volume names:
  139. ~~~~~~~~~~~~~
  140.    Netfs normally automatically uses the remote volume name in the mounted
  141.    device, but if there is a name collision (another volume/device/assign
  142.    of the same name already exists), it modifies the name by adding
  143.    an underscore and a number to it.
  144.  
  145.    You can relabel the mounted volume, but this does not affect the actual
  146.    disk on the server machine.
  147.  
  148.  
  149. Workbench:
  150. ~~~~~~~~~~
  151.    Netfs does not allow access (or Open(), anyway) to a file called '.backdrop',
  152.    so left out icons do not work over the network. This is a feature, not a bug.
  153.  
  154.  
  155. Reconnect:
  156. ~~~~~~~~~~
  157.    If the server machine is rebooted, NetFS will automatically reconnect
  158.    to it when it is running again. However, there may be long timeouts
  159.    after a connection failure before NetFS gives up. This is a normal
  160.    for the TCP protocol that NetFS uses for its connections.
  161.  
  162.    Sometimes NetFS may lose the connection to the server machine so that
  163.    it doesn't automatically try to reconnect. In that case, you can
  164.    try to reconnect by using the DiskChange-command.
  165.  
  166.    You can also force NetFS to close the connection by sending ACTION_DIE
  167.    packet to it (for example with the 'die'-command that comes with MSH).
  168.  
  169.  
  170. Known problems:
  171. ~~~~~~~~~~~~~~~
  172.    - speed/performance is not the best possible
  173.  
  174.    - does not support all 2.0 packet types
  175.      (does not support notification or file locking, but does support links)
  176.  
  177.    - because netfs uses one TCP connection and separate server/client processes
  178.      for each mounted device, memory usage is probably more than actually
  179.      necessary if netfs was implemented in some other, smarter way...
  180.  
  181. Copyright and distribution:
  182. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  183.    NetFS is Copyright ⌐ 1993 by Timo Rossi. It can be freely distributed
  184.    for non-commercial purposes. It can be included on disk collections such
  185.    as Fred Fish's AmigaLibDisks or CD-ROMs such as the AmiNET CD-ROM.
  186.  
  187.    It may not be used for military purposes or life-critical purposes such
  188.    as controlling nuclear reactors or guidance system for a manned spacecraft.
  189.  
  190.    If you want to include netfs in a commercial product, you should contact
  191.    me first (my address is in the next section).
  192.  
  193.    NetFS is NOT under the GNU General Public Licence.
  194.             ~~~
  195.    Source code is not currently available, but it may be in the future...
  196.  
  197.  
  198. Contact information:
  199. ~~~~~~~~~~~~~~~~~~~~
  200.    Timo Rossi
  201.    Mattilankatu 40 A 4
  202.    40600 JyvΣskylΣ
  203.    FINLAND
  204.  
  205.    E-Mail:  trossi@jyu.fi
  206.  
  207.