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