initial commit

mint/sys/share/doc/nfs/COPYING

@@ -0,0 +1,53 @@
+All files in this archive are Copyright (c) 1993, 1994 by Ulrich Kuehn.
+Exceptions are explicitely stated.
+
+I cannot take over any responsibility for any files in this distribution.
+Therefore the following disclaimer:
+
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTOR BE LIABLE FOR ANY DIRECT,
+INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+You are welcome to use, copy, distribute and modify the source code
+included in this package as long as the following conditions are met:
+
+o	All the files are kept in the distribution.
+
+o	Any modifications on files in the distribution are clearly
+	marked as such, including a statement that the original author
+	is not responsible for your modifications and possible damage
+	resulting in your modifications.
+
+o	You may not sell this package for more than the cost of copying
+	the files onto media, including the cost of the media, excluding
+	local taxes. This does not apply to modified versions, which are
+  only allowed to be distributed for free (of course you are 
+  allowed to sell the diffs, but not the modified package!).
+  For exceptions the written consent of the author is necessary.
+
+
+You have agreed with the above conditions when holding copies of the
+distribution in your posession, you can terminate this by destroying 
+any copy and all modified versions of this software in your possession.
+
+
+Of course any donations of money in any amount are very wellcome, just send
+it to my address or ask for a bank connection...
+
+
+My address is:
+
+Email: 
+  kuehn@math.uni-muenster.de (preferred)
+
+Snail mail:
+  Ulrich Kuehn
+  Geibelstr.9
+  48161 Muenster
+  Germany

mint/sys/share/doc/nfs/README

@@ -0,0 +1,145 @@
+This is an early beta version of an networking file system for MiNT.
+
+Copyright 1993, 1994 by Ulrich K<>hn. All rights reserved.
+
+
+DISCLAIMER:
+===========
+THIS PROGRAM COMES WITH ABSOLUTELY NO WARRANTY, NOT
+EVEN THE IMPLIED WARRANTIES OF MERCHANTIBILITY OR
+FITNESS FOR A PARTICULAR PURPOSE. USE AT YOUR OWN
+RISK.
+
+See also the file COPYING for further details.
+
+
+
+EXPLANATION:
+============
+A network file system allows computers to access file that are physically
+located on another computer transparently. Therefor the must be a means of
+data transport between these two computers (see above for the current 
+situation). The computer accessing the remote file is called the client, 
+the computer being physically the owner of that file is the server.
+On the server, there must be a service program running, that satisfies the
+access requests of the client. This program is called nfs daemon, short
+named nfsd. Because normally the client does not know which files can be
+accessed by it, it must be told so; this is called mounting of a remote
+directory or file and done with a program called mount on the client.
+On the server side there must run another service program, the mount daemon
+called mountd, which serves these mount requests by clients. 
+So: without nfsd no file access, without mountd no mounts to access files.
+
+Another point is that both server and client can be the same computer!
+Then the daemon programs run on that machine, and also the mount program is
+executed there. This is the easiest way to test this package.
+
+
+
+INSTALLATION:
+=============
+There are a few things to do (better try first server and client on the
+same computer) :
+- (both server and client) make sure to have Kay Roemer's mint-net (a socket
+  device) installed correctly. Version >= 0.30
+  (eMail: roemer@hera.rbi.informatik.uni-frankfurt.de)
+  This includes:
+    - make sure to have a directory u:\etc  (make a symbolic link to 
+      your preferred place in mint.cnf)
+	  - place the following files in u:\etc
+	      hostname, hosts, networks, services, resolv.conf
+    - name your host by writing a name into u:\etc\hostname
+- (client) copy the nfs.xfs (the client filesystem driver) to a place where
+  MiNT can find it at boot time (that is \mint or \multitos on your boot drive)
+- (server) install the portmapper daemon from the sun rpc package. Place 
+  the rpc file into u:\etc
+	The portmapper is essential as both the mount daemon and the mount 
+	command rely on that, but as a temporary hack, they can also work without
+	the portmapper.
+- (server) create a file u:\etc\xtab containing all the exported directories
+  or files. This file is necessary for both nfsd and mountd (if necessary,
+  rename them to nfsd.ttp and mountd.ttp). Please look into the bundled 
+  example, as no further docs are availbale at the moment. (or look into 
+  some unix adm doc)
+- reboot
+
+
+Then start the mountd and the nfsd. Now the system is ready to do some
+nfs mounts. Here an example: (suppose \etc\xtab contains a line
+\f\source ....)
+mount hostname:\f\source \nfs\source
+where hostname is the name of your host. (all operations done while drive 
+u: is the current. It should be, as mount treats the ':' as separator 
+betweeen hostname and directory name)
+Another point is that if you are trying to run server and client stuff on
+the same machine, the hostname for the mount command must be 'localhost'
+or 'loopback' (there should be such a line in \etc\hosts), as the resolver
+otherwise does not find the correct host (this behavior might depend on the
+version of the mint-net your are using, or on your configuration)
+After this operation you should have a directory source in u:\nfs which has
+all the contents of the original \f\source
+
+All this can be done within mint.cnf (or better use a shell script which
+is started from mint.cnf -- look at the example rc.mup and mint.cnf)
+
+A new feature of the mountd and nfsd is that they can be started by
+the inetd and terminate themselfes in this case after a short time, so
+there is no need to hold the all the time running in memory. Just install
+the inetd and make sure that the mount and nfs lines in u:\etc\inetd.conf
+are correct, that means they are active and the paths are correct.
+
+
+
+COMPILATION:
+============
+If you want to rebuild the binaries by yourself, you have first to edit
+the paths in the Makevars file, especially the BUILDDIR variable.
+Then simply type make all or make install and wait...
+
+
+
+BUGS:
+=====
+- the nfsd is not able to find a file on a TOSFS (in the state of MiNT 
+  <= 1.10) if it has only its nfs handle and no internal information. So 
+  it does not work properly on such a file system, sorry. But it works on
+  a patched TOSFS with Julian Reschke's crc patch applied and enabled.
+  This patch is included in MiNT 1.12 (get this anyway, as binaries are
+  available!), but it seems to be disabled by default (take a look into 
+  tosfs.c in the MiNT source).
+- no caching of results for nonidempotent requests. So if the anser of a
+  file remove request gets lost and the client resends this request, it 
+  will fail because the file is already gone.
+- no exportfs command, so you have to edit your \etc\xtab yourself and
+  cannot use the \etc\exports file.
+- several mount options are still not supported by the XFS, such as 
+  hard mounts
+
+
+
+MY CONFIGURATION:
+=================
+I am running this system on a TT030 with 4/4 Mb ram, TOS 3.06, a patched 
+MiNT 1.12, using both minixfs and the patched tosfs, and it seems to be 
+quite stable now, but who knows?
+
+
+THANKS:
+=======
+Many thanks go to Kay Roemer for his great socket device, which made this
+nfs possible. He also constantly supplied me with critics, suggestions,
+ideas and bug fixes.
+
+
+CONTACT ADDRESS:
+================
+If you have questions, bug reports, suggestions, etc. please contact 
+me under:
+
+kuehn@math.uni-muenster.de  (Ulrich Kuehn)                 preferred
+
+Ulrich Kuehn, Geibelstr.9, 48161 Muenster, Germany  
+
+
+Have fun
+Ulrich