From fbf614e898e59ea80146444754a2a260a56febff Mon Sep 17 00:00:00 2001 From: Jason Edgecombe Date: Mon, 14 Jul 2008 00:37:37 +0000 Subject: [PATCH] DEVEL15-docs-max-part-size-20080713 LICENSE BSD FIXES 86677 update discussion of max partition size. (cherry picked from commit c766e74fd63a58e714d7b15ef1abfbc48b2a5a85) --- doc/man-pages/pod1/fs_listquota.pod | 9 +-------- doc/man-pages/pod1/fs_minidump.pod | 10 ++++++++++ doc/man-pages/pod1/fs_quota.pod | 9 +-------- doc/man-pages/pod1/fs_setquota.pod | 9 +-------- doc/man-pages/pod1/fs_setvol.pod | 9 +-------- doc/man-pages/pod1/vos.pod | 9 +-------- doc/man-pages/pod1/vos_copy.pod | 9 +-------- doc/man-pages/pod1/vos_create.pod | 9 +-------- doc/man-pages/pod1/vos_examine.pod | 9 +-------- doc/man-pages/pod1/vos_move.pod | 9 +-------- doc/man-pages/pod1/vos_partinfo.pod | 9 +-------- doc/man-pages/pod8/fileserver.pod | 8 ++------ 12 files changed, 22 insertions(+), 86 deletions(-) diff --git a/doc/man-pages/pod1/fs_listquota.pod b/doc/man-pages/pod1/fs_listquota.pod index eaee5820c..84cc61492 100644 --- a/doc/man-pages/pod1/fs_listquota.pod +++ b/doc/man-pages/pod1/fs_listquota.pod @@ -30,14 +30,7 @@ To set volume quota, use the B or B command. =head1 CAUTIONS -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 also 2 -terabytes. The fileserver will not report an error when it has access -to a partition larger than 2 terabytes, but it will probably fail if -the administrator attempts to use more than 2 terabytes of space. In -addition, there are reports of erroneous disk usage numbers when -B or other OpenAFS disk reporting tools are used with -partitions larger than 2 terabytes. +Currently, the maximum size of a volume is 2 terabytes (2^31 bytes). =head1 OPTIONS diff --git a/doc/man-pages/pod1/fs_minidump.pod b/doc/man-pages/pod1/fs_minidump.pod index 9be46e71f..be296cb88 100644 --- a/doc/man-pages/pod1/fs_minidump.pod +++ b/doc/man-pages/pod1/fs_minidump.pod @@ -19,6 +19,16 @@ of the afsd_service.exe process. This output can be very helpful when debugging the AFS Client Service when it is unresponsive to SMB/CIFS requests. +If the AFS Client Service becomes unresponsive to any form of +communication there may be a serious error that can only be diagnosed +by someone with access to the source code and a debugger. The "fs +minidump" command can be used to force the generation of a MiniDump +file containing the state of all of the threads in the AFS Client +Service process. + +The "MiniDumpType" registry value can be used to adjust the scope of the +process information included within the dump file. + =head1 CAUTIONS This command is only available in OpenAFS for Windows version 1.4 and later. diff --git a/doc/man-pages/pod1/fs_quota.pod b/doc/man-pages/pod1/fs_quota.pod index d9445093b..d5c6afa62 100644 --- a/doc/man-pages/pod1/fs_quota.pod +++ b/doc/man-pages/pod1/fs_quota.pod @@ -26,14 +26,7 @@ To set volume quota, use the B or B command. =head1 CAUTIONS -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 also 2 -terabytes. The fileserver will not report an error when it has access -to a partition larger than 2 terabytes, but it will probably fail if -the administrator attempts to use more than 2 terabytes of space. In -addition, there are reports of erroneous disk usage numbers when -B or other OpenAFS disk reporting tools are used with -partitions larger than 2 terabytes. +Currently, the maximum size of a volume is 2 terabytes (2^31 bytes). =head1 OPTIONS diff --git a/doc/man-pages/pod1/fs_setquota.pod b/doc/man-pages/pod1/fs_setquota.pod index f0cd853a7..2a2af3e64 100644 --- a/doc/man-pages/pod1/fs_setquota.pod +++ b/doc/man-pages/pod1/fs_setquota.pod @@ -31,14 +31,7 @@ B command. =head1 CAUTIONS -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 also 2 -terabytes. The fileserver will not report an error when it has access -to a partition larger than 2 terabytes, but it will probably fail if -the administrator attempts to use more than 2 terabytes of space. In -addition, there are reports of erroneous disk usage numbers when -B or other OpenAFS disk reporting tools are used with -partitions larger than 2 terabytes. +Currently, the maximum size of a volume is 2 terabytes (2^31 bytes). =head1 OPTIONS diff --git a/doc/man-pages/pod1/fs_setvol.pod b/doc/man-pages/pod1/fs_setvol.pod index 8540f7b00..f09afbd3b 100644 --- a/doc/man-pages/pod1/fs_setvol.pod +++ b/doc/man-pages/pod1/fs_setvol.pod @@ -38,14 +38,7 @@ To set quota on one volume at a time, use the B command. =head1 CAUTIONS -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 also 2 -terabytes. The fileserver will not report an error when it has access -to a partition larger than 2 terabytes, but it will probably fail if -the administrator attempts to use more than 2 terabytes of space. In -addition, there are reports of erroneous disk usage numbers when -B or other OpenAFS disk reporting tools are used with -partitions larger than 2 terabytes. +Currently, the maximum size of a volume is 2 terabytes (2^31 bytes). =head1 OPTIONS diff --git a/doc/man-pages/pod1/vos.pod b/doc/man-pages/pod1/vos.pod index d09c7bf8e..8d37408d8 100644 --- a/doc/man-pages/pod1/vos.pod +++ b/doc/man-pages/pod1/vos.pod @@ -96,14 +96,7 @@ Commands to obtain help: B and B. =head1 CAUTIONS -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 also 2 -terabytes. The fileserver will not report an error when it has access -to a partition larger than 2 terabytes, but it will probably fail if -the administrator attempts to use more than 2 terabytes of space. In -addition, there are reports of erroneous disk usage numbers when -B or other OpenAFS disk reporting tools are used with -partitions larger than 2 terabytes. +Currently, the maximum size of a volume is 2 terabytes (2^31 bytes). =head1 OPTIONS diff --git a/doc/man-pages/pod1/vos_copy.pod b/doc/man-pages/pod1/vos_copy.pod index a9cbfe606..6d291457f 100644 --- a/doc/man-pages/pod1/vos_copy.pod +++ b/doc/man-pages/pod1/vos_copy.pod @@ -27,14 +27,7 @@ the volume be stored locally by the client. =head1 CAUTIONS -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 also 2 -terabytes. The fileserver will not report an error when it has access -to a partition larger than 2 terabytes, but it will probably fail if -the administrator attempts to use more than 2 terabytes of space. In -addition, there are reports of erroneous disk usage numbers when -B or other OpenAFS disk reporting tools are used with -partitions larger than 2 terabytes. +Currently, the maximum size of a volume is 2 terabytes (2^31 bytes). =head1 OPTIONS diff --git a/doc/man-pages/pod1/vos_create.pod b/doc/man-pages/pod1/vos_create.pod index 290620563..29ea06ae4 100644 --- a/doc/man-pages/pod1/vos_create.pod +++ b/doc/man-pages/pod1/vos_create.pod @@ -62,14 +62,7 @@ mount it in the file space by using the B command. =head1 CAUTIONS -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 also 2 -terabytes. The fileserver will not report an error when it has access -to a partition larger than 2 terabytes, but it will probably fail if -the administrator attempts to use more than 2 terabytes of space. In -addition, there are reports of erroneous disk usage numbers when -B or other OpenAFS disk reporting tools are used with -partitions larger than 2 terabytes. +Currently, the maximum size of a volume is 2 terabytes (2^31 bytes). =head1 OPTIONS diff --git a/doc/man-pages/pod1/vos_examine.pod b/doc/man-pages/pod1/vos_examine.pod index d1cebcae5..0ae5082f0 100644 --- a/doc/man-pages/pod1/vos_examine.pod +++ b/doc/man-pages/pod1/vos_examine.pod @@ -34,14 +34,7 @@ display information from the VLDB only, use the B command. =head1 CAUTIONS -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 also 2 -terabytes. The fileserver will not report an error when it has access -to a partition larger than 2 terabytes, but it will probably fail if -the administrator attempts to use more than 2 terabytes of space. In -addition, there are reports of erroneous disk usage numbers when -B or other OpenAFS disk reporting tools are used with -partitions larger than 2 terabytes. +Currently, the maximum size of a volume is 2 terabytes (2^31 bytes). =head1 OPTIONS diff --git a/doc/man-pages/pod1/vos_move.pod b/doc/man-pages/pod1/vos_move.pod index 3acb3545a..fa9233317 100644 --- a/doc/man-pages/pod1/vos_move.pod +++ b/doc/man-pages/pod1/vos_move.pod @@ -86,14 +86,7 @@ confirmation of the kill signal: To confirm termination of the operation, press Ctrl-C a second time; press any other key to continue the operation. -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 also 2 -terabytes. The fileserver will not report an error when it has access -to a partition larger than 2 terabytes, but it will probably fail if -the administrator attempts to use more than 2 terabytes of space. In -addition, there are reports of erroneous disk usage numbers when -B or other OpenAFS disk reporting tools are used with -partitions larger than 2 terabytes. +Currently, the maximum size of a volume is 2 terabytes (2^31 bytes). =head1 OPTIONS diff --git a/doc/man-pages/pod1/vos_partinfo.pod b/doc/man-pages/pod1/vos_partinfo.pod index d3b436c45..543906428 100644 --- a/doc/man-pages/pod1/vos_partinfo.pod +++ b/doc/man-pages/pod1/vos_partinfo.pod @@ -27,14 +27,7 @@ consulted. =head1 CAUTIONS -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 also 2 -terabytes. The fileserver will not report an error when it has access -to a partition larger than 2 terabytes, but it will probably fail if -the administrator attempts to use more than 2 terabytes of space. In -addition, there are reports of erroneous disk usage numbers when -B or other OpenAFS disk reporting tools are used with -partitions larger than 2 terabytes. +Currently, the maximum size of a volume is 2 terabytes (2^31 bytes). =head1 OPTIONS diff --git a/doc/man-pages/pod8/fileserver.pod b/doc/man-pages/pod8/fileserver.pod index 19e5f5cd7..3ab94cf8a 100644 --- a/doc/man-pages/pod8/fileserver.pod +++ b/doc/man-pages/pod8/fileserver.pod @@ -232,12 +232,8 @@ 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 fileserver will not report an error when it has access -to a partition larger than 2^64 kilobytes, but it will probably fail if -the administrator attempts to use more than 2^64 kilobytes of space. In -addition, there are reports of erroneous disk usage numbers when -B or other OpenAFS disk reporting tools are used with -partitions larger than 2^64 kilobytes. +kilobytes. (The maximum partition size in releases 1.5.34 and earlier +is 2^31 kilobytes.) 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 -- 2.39.5