
		The TrueGrid NFS Server
		OVERVIEW & LICENSING

	A Freeware NFS Server for Windows 95/NT

COPYRIGHT (C) BY XYZ SCIENTIFIC APPLICATIONS, INC., 1998
ALL RIGHTS RESERVED.  TrueGrid IS A TRADEMARK OF
XYZ SCIENTIFIC APPLICATIONS, INC.

		XYZ Scientific Applications, Inc.
		1324 Concannon Blvd.
		Livermore, CA  94550

DISCLAIMER OF WARRANTY
----------------------
NO WARRANTIES. THE SOFTWARE PRODUCT IS PROVIDED "AS IS" WITHOUT WARRANTY
OF ANY KIND. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, XYZ
AND ITS SUPPLIERS DISCLAIM ALL WARRANTIES, EITHER EXPRESS OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS FOR A PARTICULAR PURPOSE AND ANY WARRANTY AGAINST
INFRINGEMENT, WITH REGARD TO THE SOFTWARE PRODUCT. THIS LIMITED
WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS. YOU MAY HAVE OTHERS, WHICH
VARY FROM STATE/JURISDICTION TO STATE/JURISDICTION.

CUSTOMER REMEDIES. XYZ'S ENTIRE LIABILITY AND YOUR EXCLUSIVE REMEDY
SHALL NOT EXCEED THE PRICE PAID FOR THE SOFTWARE PRODUCT.

NO LIABILITY FOR DAMAGES. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE
LAW, IN NO EVENT SHALL XYZ OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES
WHATSOEVER (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS
PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR ANY
OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF OR INABILITY TO USE
THIS XYZ PRODUCT, EVEN IF XYZ HAS BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES.

-----------------------
BACKGROUND
-----------------------
This is a freeware implementation of an NFS Server.  This basic
server has been used to mount PC file systems on the following
UNIX machines
		SGI	IRIX 4.x 5.x 6.x
		SUN	SUNOS 4.x SOLARIS 2.x
		IBM	AIX 4.x
		DEC	DEC UNIX 2.x+
		HP	HPUX 9.x 10.x
The NFS Server conforms to RFC 1094 as closely as possible
(included here as RFC1094.TXT).

This program is freeware.  It is not supported.  However, you can
send bug reports to nfs@truegrid.com.  If you like the program,
then please add the following to your web page

<A HREF="http://www.truegrid.com/nfs.html">TrueGrid Pro NFS Server</A>

Make sure to mention the "TrueGrid Pro NFS Server", and let use know
about your pointer.  If there are enough pointers, then we will offer
free upgrades and enhancements.  You may *not* directly distribute this 
program in whole or in part.  We retain the copyright to this program.

		XYZ Scientific Applications, Inc.
		1324 Concannon Blvd.
		Livermore, CA  94550
		nfs@truegrid.com

-----------------------
GETTING STARTED
-----------------------
This distribution contains all the files you need to install and
configure an NFS server for your Windows 95/NT machine.

		README.TXT	This file.  Contains licensing
				information, distribution contents,
				and a technical overview.

		INSTALL.TXT	Instructions for installing and
				configuring the NFS server.

		NOTES.TXT	Technical information you should
				know about.

		rfc1094.txt	The RFC for NFS Version 2.

Start by reading CONTENTS.TXT and checking that you have everything.
Then follow the steps in INSTALL.TXT to install and configure the
server.  Finally, read NOTES.TXT for a discussion of the more
highly technical issues concerning the NFS server.

-----------------------
TECHNICAL OVERVIEW
-----------------------
DOCUMENTS
	README.TXT	Overview & Licensing of the NFS Server
	INSTALL.TXT	Installation guide
	NOTES.TXT	Technical notes
	rfc1094.txt	Full copy of the RFC For NFS Version 2
SERVER EXECUTABLES
	PORTMAP.EXE	TrueGrid Portmapper
	NFS.EXE		TrueGrid NFS Server
	PCNFSD.EXE	TrueGrid PCNFS Daemon
UTILITIES
	SHOWMOUNT.EXE	Utility for displaying exported file systems
			and mounted file systems
	RPCINFO.EXE	RPC information utility.  Displays information
			about registered RPC programs on the local
			machine and on remote machines.
	FINDHOST.EXE	Host utility.  Converts IP addresses to host
			names and vice-versa.
	RSH.EXE		Remote Shell utility.  Works great with UNIX
			systems.
LIBRARY
	SUNRPC.DLL	used by the servers and by showmount, rpcinfo
CONFIGURATION
	rpc		used by RPCINFO
	exports		Sample exports file for the NFS Server
	passwd		required for PCNFSD

This is a freeware NFS Server that runs under Windows 95, Windows NT 3.51
and Windows NT 4.0.  The server closely adheres to RFC 1094 (see the
file rfc1094.txt).  The server has been tested on several PC's running
various operating systems.  It has been used to export file systems to
many UNIX configurations such as SGI, SUN, HP, DEC, and IBM workstations
running a variety of operating systems.  That is not to say that this
program will function on your PC or with your UNIX workstations.  But
it is likely to work just fine.

Even though the server is not multi-threaded, it performs quite well
under fairly heavy loads.  However, the server caches a maximum of 32
files.  So if you expect simultaneous access of more than 32 files,
then this server may not work well for you.

The implementation is based on SUN's RPC4.0 and the fleshed out versions
of NFS and MOUNT procedures generated by rpcgen from the nfs_prot.x and
mount.x files provided with the RPC4.0 distribution.  The RPC library was
converted to use only WinSock calls, and broadcast capabilities were
removed.  The resulting library "SUNRPC.DLL" is included.  Then other
programs included with RPC4.0 were modified to work with the modified
RPC including PORTMAP and RPCINFO.  The portmapper (PORTMAP) handles
registration of RPC procedures, and RPCINFO queries any portmapper
(both locally and remotely).  The NFS and MOUNT programs were combined
into one to produce an NFS server.  These programs register themselves
with the local portmapper so that remote machines can access the NFS
and mount services.  A showmount program is provided that is based
on the client portion of the mount program.
	PORTMAP.EXE	RPC Portmapper Program
	RPCINFO.EXE	RPC Query Program
	NFS.EXE		NFS Server
	SHOWMOUNT.EXE	NFS Mounts Query Program

The RPCINFO.EXE program requires an "rpc" file in the "/etc" directory
on UNIX machines in order to convert protocol numbers to names.
We supply such an "rpc" file, and expect it to be placed in the
"%windir%\etc" directory (you may need to create this directory).
The nfsd program under UNIX requires an "exports" file in the "/etc"
directory.  We have supplied a sample "exports" file, which should
be appropriately modified and placed in "%windir%\etc".  The "rpc"
file needs no modification, but you can add entries if you like.
	rpc		RPC procedure to name listing
	exports		sample NFS exports file

PC-NFS clients rely on a special authentication daemon.  It seems
a bit silly to share file systems between PC's using NFS, but I
have included a PCNFSD program that will allow you to do just that.
The source to this server is freely avaialable and trivially modified
to work with our RPC library.  You will need to modify the included
passwd file and copy it to "%windir%\etc".  The password in "passwd"
is not encrypted.  So be careful about any passwords you use.
	PCNFSD.EXE	PCNFSD authentication server
	passwd		sample password file

A couple of extra programs were provided just for convenience.
	FINDHOST.EXE	Converts hosts to IP address and vice-versa
	RSH.EXE		UNIX compatible remote shell program
I have included the FINDHOST program to help debug TCP/IP on the
PC.  In particular, DNS must be enabled so that "gethostbyname"
and "gethostbyaddress" function properly.  FINDHOST calls one of
these two functions, depending on whether you give it a host name
or an IP address.  FINDHOST returns the host name of the machine,
any registered aliases, and the IP addresses of the machine.  I
have included the RSH program because many seem to be searching
for a freeware RSH program that is UNIX compatible.
