Added initial unfs3 sources for version 0.9.22+dfsg-1maemo2
[unfs3] / unfs3 / README.nfsroot
1 Using UNFS3 for Linux nfsroot
2 =============================
3
4 General information about Linux nfsroot can be found in the
5 Linux kernel source, in the file Documentation/nfsroot.txt.
6
7 If you want the use the Linux kernel's "nfsroot=" boot option
8 to use a root directory on an NFS server and use UNFS3 in the
9 role of the NFS server for that, you need to remember that UNFS3
10 only supports NFSv3, not NFSv2. The kernel, on the other hand,
11 always defaults to using NFSv2. Thus, you need to modify the
12 nfsroot boot option to force the kernel to use NFSv3. If you do
13 not do this, an error message like this will appear on the
14 client machine:
15
16   Looking up port of RPC 1000003/2 on 172.16.100.100
17   Root-NFS: Portmapper on server returned 2049 as nfsd port
18   Looking up port of RPC 1000005/1 on 172.16.100.100
19   Root-NFS: mounted port is 2049
20   NFS:      nfs_mount (ac106464:/nfsroot)
21   RPC: call_verify: programm 100003 version 2 unsupported by server
22   nfs_get_root: getattr error = 5
23   nfs_read_super: get root inode failed
24   VFS: Unable to mount root fs via NFS trying floppy
25
26 To fix this problem, append the "v3" NFS option to the nfsroot
27 boot option. Assuming your NFS server's IP address is 192.168.2.72
28 and the path you need to mount is /tftpboot/nfsroot, the boot
29 option should look like this:
30
31   nfsroot=192.168.2.72:/tftpboot/nfsroot,v3
32
33 You can add more options to the end, seperated by commas. If you
34 use DHCP to pass the NFS server configuration to the client, you
35 need to use a line like this in the /etc/dhcpd.conf settings
36 for the client machine:
37
38   option root-path "/tftpboot/nfsroot,v3";
39
40 As above, more options can be added to the end, sepereated by
41 commas.
42
43 Thanks go to Jean Aumont <JeanAumont@videotron.ca> for suggesting
44 this bit of information to be documented.