DEVEL15-man-page-fileserver-updates-20081111
authorJason Edgecombe <jason@rampaginggeek.com>
Wed, 12 Nov 2008 02:18:08 +0000 (02:18 +0000)
committerRuss Allbery <rra@stanford.edu>
Wed, 12 Nov 2008 02:18:08 +0000 (02:18 +0000)
LICENSE BSD

Various file server man page updates: number of partitions, partition size
limits, directory file name block size, and a reference to the IBM manual
set.

(cherry picked from commit 794967ed3ec5a46329375ae19eac21c1c508c1ee)

doc/man-pages/pod8/fileserver.pod

index a7429de..ef5c26b 100644 (file)
@@ -198,13 +198,13 @@ effective. To change this frequency, use the B<-hr> argument.
 
 The File Server stores volumes in partitions. A partition is a
 filesystem or directory on the server machine that is named C</vicepX>
-or C</vicepXX> where XX is "a" through "z" or "aa" though "zz". The
-File Server expects that the /vicepXX directories are each on a
-dedicated filesystem. The File Server will only use a /vicepXX if it's
-a mountpoint for another filesystem, unless the file
-C</vicepXX/AlwaysAttach> exists. The data in the partition is a
-special format that can only be access using OpenAFS commands or an
-OpenAFS client.
+or C</vicepXX> where XX is "a" through "z" or "aa" though "iv". Up to
+255 partitions are allowed. The File Server expects that the /vicepXX
+directories are each on a dedicated filesystem. The File Server will
+only use a /vicepXX if it's a mountpoint for another filesystem,
+unless the file C</vicepXX/AlwaysAttach> exists. The data in the
+partition is a special format that can only be access using OpenAFS
+commands or an OpenAFS client.
 
 The File Server generates the following message when a partition is nearly
 full:
@@ -232,15 +232,16 @@ and B<-lock> options, appear in the output generated by the B<-help>
 option only on the relevant system type.
 
 Currently, the maximum size of a volume is 2 terabytes (2^31 bytes)
-and the maximum size of a /vicepX partition on a fileserver is 2^64 
-kilobytes.  (The maximum partition size in releases 1.5.34 and earlier
-is 2^31 kilobytes.)
+and the maximum size of a /vicepX partition on a fileserver is 2^64
+kilobytes. The maximum partition size in releases 1.4.7 and earlier is
+2 terabytes (2^31 bytes). The maximum partition size for 1.5.x
+releases 1.5.34 and earlier is 2 terabytes as well.
 
 The maximum number of directory entries is 64,000 if all of the entries
 have names that are 15 octets or less in length. A name that is 15 octets
 long requires the use of only one block in the directory. Additional
 sequential blocks are required to store entries with names that are longer
-than 15 octets. Each additional block provides an additional length of 32
+than 15 octets. Each additional block provides an additional length of 16
 octets for the name of the entry. Note that if file names use an encoding
 like UTF-8, a single character may be encoded into multiple octets.
 
@@ -271,8 +272,8 @@ in addition to the number specified (but if this argument specifies
 the maximum possible number, the File Server automatically uses five 
 of the threads for its own purposes).
 
-The maximum number of threads can differ in each release of AFS.  Consult
-the I<IBM AFS Release Notes> for the current release.
+The maximum number of threads can differ in each release of OpenAFS.
+Consult the I<OpenAFS Release Notes> for the current release.
 
 =item B<-spare> <I<number of spare blocks>>