From 794967ed3ec5a46329375ae19eac21c1c508c1ee Mon Sep 17 00:00:00 2001 From: Jason Edgecombe Date: Wed, 12 Nov 2008 02:17:49 +0000 Subject: [PATCH] man-page-fileserver-updates-20081111 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. --- doc/man-pages/pod8/fileserver.pod | 27 ++++++++++++++------------- 1 file changed, 14 insertions(+), 13 deletions(-) diff --git a/doc/man-pages/pod8/fileserver.pod b/doc/man-pages/pod8/fileserver.pod index a7429de20..ef5c26be0 100644 --- a/doc/man-pages/pod8/fileserver.pod +++ b/doc/man-pages/pod8/fileserver.pod @@ -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 -or C 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 exists. The data in the partition is a -special format that can only be access using OpenAFS commands or an -OpenAFS client. +or C 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 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 for the current release. +The maximum number of threads can differ in each release of OpenAFS. +Consult the I for the current release. =item B<-spare> > -- 2.39.5