STABLE14-man-page-fileserver-octet-20081111

LICENSE BSD

The sizing limit on directories is better expressed in octets than in
characters in the new possibly-Unicode world.

(cherry picked from commit 196e995b2569c7dceea8748a36431802d4875188)

diff --git a/doc/man-pages/pod8/fileserver.pod b/doc/man-pages/pod8/fileserver.pod
index 64964e8c2e0dd2b7eebafec16346e3dcb091ed45..3b3716e5f92fe95acd17638bc7096d5fdee08f8a 100644 (file)
--- a/doc/man-pages/pod8/fileserver.pod
+++ b/doc/man-pages/pod8/fileserver.pod
@@ -212,13 +212,13 @@ addition, there are reports of erroneous disk usage numbers when
 B<vos partinfo> or other OpenAFS disk reporting tools are used with
 partitions larger than 2 terabytes.
 
-The maximum number of directory entries is 64,000 if all of the
-entries have names that are 15 characters or less in length. A name
-that is 15 characters 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 characters. Each additional block
-provides an additional length of 32 characters for the name of the
-entry.
+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
+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.
 
 In real world use, the maximum number of objects in an AFS directory
 is usually between 16,000 and 25,000, depending on the average name