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