Initial revision
[nfs-utils.git] / README
1 This is the Linux NFS utility package version 0.1. It is based on knfsd
2 1.4.7.
3
4 WARNING: The NFS servers in Linux 2.2 to 2.2.12 are not compatible with
5 other NFS client implemenations. If you plan to use Linux 2.2.x as an
6 NFS server for non-Linux NFS clients, you should get the Linux NFS
7 kernel from the Linux NFS CVS server:
8
9 1. Set the environment variable, CVS_RSH, to ssh.
10 2. Login to the Linux NFS CVS server:
11
12 # cvs -z 9 -d:pserver:anonymous@cvs.linuxnfs.sourceforge.org:/cvsroot/nfs login
13
14 without password if it is your first time.
15
16 3. Check out the current Linux 2.2 NFS kernel:
17
18 # cvs -z 9 -d:pserver:anonymous@cvs.linuxnfs.sourceforge.org:/cvsroot/nfs co -r linux-2-2-nfsv2 linux-2.2
19
20 4. If you don't want to use the current NFS kernel, you can find out
21 for which kernels the NFS patch is available:
22
23 # cd linux-2.2
24 # cvs -z 9 -d:pserver:anonymous@cvs.linuxnfs.sourceforge.org:/cvsroot/nfs status -v Makefile
25
26 Then generate the kernel patch:
27
28 # cvs -z 9 -d:pserver:anonymous@cvs.linuxnfs.sourceforge.org:/cvsroot/nfs rdiff -ko -u -r linux-2-2-xx -r linux-2-2-xx-nfsv2-xxxxx linux-2.2
29
30 If there is no NFS patch for the kernel you are interested in, you have
31 to make a patch closest to your kernel version and apply it by hand.
32
33 There is a Linux NFS kernel source tree for Linux 2.3, linux-2.3, on
34 the Linux NFS CVS server. However, it is not maintained. We will need
35 all the help we can get. To contribute to the Linux NFS project, please
36 go to
37
38 http://www.linuxnfs.sourceforge.org
39
40 and login as "beta" with password "beta4u". You register yourself.
41 please send an email to nfs-admin@linuxnfs.sourceforge.org with
42
43 1. Your user id on www.linuxnfs.sourceforge.org.
44 2. The area in NFS you'd like to work on.
45
46 You will be notified when it is done.
47
48 There is a Linux NFS mailing list at
49
50 http://lists.varesearch.com/lists/listinfo/nfs/
51
52 You can subscribe it and search the mailing list archive via a web
53 browser.
54
55 The nfs-utils package is avaible from the CVS server:
56
57 # cvs -z 9 -d:pserver:anonymous@cvs.linuxnfs.sourceforge.org:/cvsroot/nfs co nfs-utils
58
59 will get the latest version.
60
61 The tar file is at
62
63 ftp://ftp.valinux.com/pub/support/hjl/nfs/nfs-utils-0.1.tar.gz
64
65 To compile, just do
66
67 # ./configure
68 # make
69
70 # make install
71
72 will install the nfs-utils binaries. You have to install the NFS
73 service scripts. There are 2 in etc/redhat provided for RedHat 6.x.
74 They are tested on RedHat 6.1.
75
76 On RedHat 6.1, you can use
77
78 # rpm -ta nfs-utils-0.1.tar.gz
79
80 to build the source and binary RPMs.
81
82 If your mount from util-linux is too old, you will need 2 patches:
83
84 ftp://ftp.valinux.com/pub/support/hjl/nfs/util-linux-2.9o-mount-nfsv3.patch
85 ftp://ftp.valinux.com/pub/support/hjl/nfs/util-linux-2.9w-mount-nfsv3try.patch
86
87 Thanks.
88
89
90 H.J.
91 hjl@lucon.org
92 10/18/99