util-linux-mount-man-nfs4.patch

   1 --- util-linux-2.13-pre7/mount/mount.8.man-nfs4 2006-03-06 00:04:37.000000000 +0100
   2 +++ util-linux-2.13-pre7/mount/mount.8  2006-12-14 00:30:33.000000000 +0100
   3 @@ -385,6 +385,7 @@
   4  .IR msdos ,
   5  .IR ncpfs ,
   6  .IR nfs ,
   7 +.IR nfs4 ,
   8  .IR ntfs ,
   9  .IR proc ,
  10  .IR qnx4 ,
  11 @@ -422,7 +423,7 @@
  12  program has to do is issue a simple
  13  .IR mount (2)
  14  system call, and no detailed knowledge of the filesystem type is required.
  15 -For a few types however (like nfs, cifs, smbfs, ncpfs) ad hoc code is
  16 +For a few types however (like nfs, nfs4, cifs, smbfs, ncpfs) ad hoc code is
  17  necessary. The nfs ad hoc code is built in, but cifs, smbfs, and ncpfs
  18  have a separate mount program. In order to make it possible to
  19  treat all types in a uniform way, mount will execute the program
  20 @@ -450,9 +451,10 @@
  21  All of the filesystem types listed there will be tried,
  22  except for those that are labeled "nodev" (e.g.,
  23  .IR devpts ,
  24 -.I proc
  25 +.IR proc ,
  26 +.IR nfs ,
  27  and
  28 -.IR nfs ).
  29 +.IR nfs4 ).
  30  If
  31  .I /etc/filesystems
  32  ends in a line with a single * only, mount will read
  33 @@ -1368,6 +1370,81 @@
  34  .B nolock
  35  Do not use locking. Do not start lockd.
  36
  37 +.SH "Mount options for nfs4"
  38 +Instead of a textual option string, parsed by the kernel, the
  39 +.I nfs4
  40 +file system expects a binary argument of type
  41 +.IR "struct nfs4_mount_data" .
  42 +The program
  43 +.B mount
  44 +itself parses the following options of the form `tag=value',
  45 +and puts them in the structure mentioned:
  46 +.BI rsize= n,
  47 +.BI wsize= n,
  48 +.BI timeo= n,
  49 +.BI retrans= n,
  50 +.BI acregmin= n,
  51 +.BI acregmax= n,
  52 +.BI acdirmin= n,
  53 +.BI acdirmax= n,
  54 +.BI actimeo= n,
  55 +.BI retry= n,
  56 +.BI port= n,
  57 +.BI proto= n,
  58 +.BI clientaddr= n,
  59 +.BI sec= n.
  60 +The option
  61 +.BI addr= n
  62 +is accepted but ignored.
  63 +Also the following Boolean options, possibly preceded by
  64 +.B no
  65 +are recognized:
  66 +.BR bg ,
  67 +.BR fg ,
  68 +.BR soft ,
  69 +.BR hard ,
  70 +.BR intr ,
  71 +.BR cto ,
  72 +.BR ac ,
  73 +For details, see
  74 +.BR nfs (5).
  75 +
  76 +Especially useful options include
  77 +.TP
  78 +.B rsize=32768,wsize=32768
  79 +This causes the NFS4 client to try to negotiate a buffer size
  80 +up to the size specified.
  81 +A large buffer size does improve performance, but both the
  82 +server and client have to support it.
  83 +In the case where one of these does not support the size specified,
  84 +the size negotiated will be the largest that both support.
  85 +.TP
  86 +.B intr
  87 +This will allow NFS4 operations (on hard mounts) to be
  88 +interrupted while waiting for a response from the server.
  89 +.TP
  90 +.B hard
  91 +The program accessing a file on a NFS mounted file system will hang
  92 +when the server crashes. The process cannot be interrupted or
  93 +killed unless you also specify
  94 +.BR intr .
  95 +When the NFS server is back online the program will continue undisturbed
  96 +from where it was. This is probably what you want.
  97 +.TP
  98 +.B soft
  99 +This option allows the kernel to time out if the NFS server is not
 100 +responding for some time. The time can be
 101 +specified with
 102 +.BR timeo=time .
 103 +This timeout value is expressed in tenths of a second.
 104 +The
 105 +.BR soft
 106 +option might be useful if your NFS server sometimes doesn't respond
 107 +or will be rebooted while some process tries to get a file from the server.
 108 +Avoid using this option with
 109 +.BR proto=udp
 110 +or with a short timeout.
 111 +
 112  .SH "Mount options for ntfs"
 113  .TP
 114  .BI iocharset= name