INN commit: trunk/doc/pod (cycbuff.conf.pod install.pod)
INN Commit
rra at isc.org
Sun Jun 14 12:23:51 UTC 2015
Date: Sunday, June 14, 2015 @ 05:23:50
Author: iulius
Revision: 9900
Improve documentation for CNFS buffers larger than 2 GB
Large-file support is useful only for 32-bit platforms (and some very
rare 64-bit platforms that aren't Linux).
Modified:
trunk/doc/pod/cycbuff.conf.pod
trunk/doc/pod/install.pod
------------------+
cycbuff.conf.pod | 20 +++++++++++---------
install.pod | 18 ++++++++++--------
2 files changed, 21 insertions(+), 17 deletions(-)
Modified: cycbuff.conf.pod
===================================================================
--- cycbuff.conf.pod 2015-06-14 11:44:57 UTC (rev 9899)
+++ cycbuff.conf.pod 2015-06-14 12:23:50 UTC (rev 9900)
@@ -10,15 +10,17 @@
if the CNFS (Cyclic News File System) storage method is used. INN will
look for it in I<pathetc> (as set in F<inn.conf>).
-CNFS stores articles in logical objects called I<metacycbuffs>. Each
-metacycbuff is in turn composed of one or more physical buffers called
-I<cycbuffs>. As articles are written to the metacycbuff, each article is
-written to the next cycbuff in the list in a round-robin fashion (unless
-C<sequential> mode is specified, in which case each cycbuff is filled
-before moving on to the next). This is so that you can distribute the
-individual cycbuffs across multiple physical disks and balance the load
-between them. Note that in order to use any cycbuff larger than S<2 GB>,
-you need to build INN with the B<--enable-largefiles> option.
+CNFS stores articles in logical objects called I<metacycbuffs>.
+Each metacycbuff is in turn composed of one or more physical buffers
+called I<cycbuffs>. As articles are written to the metacycbuff, each
+article is written to the next cycbuff in the list in a round-robin
+fashion (unless C<sequential> mode is specified, in which case each
+cycbuff is filled before moving on to the next). This is so that you
+can distribute the individual cycbuffs across multiple physical disks
+and balance the load between them. Note that in order to use any
+cycbuff larger than S<2 GB> on 32-bit platforms (and some very rare
+64-bit platforms that aren't Linux), you need to build INN with the
+B<--enable-largefiles> option.
For information about how to configure INN to use CNFS, see
storage.conf(5).
Modified: install.pod
===================================================================
--- install.pod 2015-06-14 11:44:57 UTC (rev 9899)
+++ install.pod 2015-06-14 12:23:50 UTC (rev 9900)
@@ -304,11 +304,12 @@
Enables large file support. This is not enabled by default, even on
platforms that support it, because it changes the format of INN's on-disk
-databases (making it difficult to upgrade an earlier INN installation) and
-can significantly increase the size of some of the history database files.
-Large file support is not necessary unless your F<history> database is so
-large that it exceeds S<2 GB> or you want to use CNFS buffers larger than
-S<2 GB>.
+databases (making it difficult to upgrade an earlier INN installation)
+and can significantly increase the size of some of the history database
+files. Large file support is not necessary unless your F<history>
+database is so large that it exceeds S<2 GB> or you want to use CNFS
+buffers larger than S<2 GB> on 32-bit platforms (and some very rare
+64-bit platforms that aren't Linux).
The history, tradindexed and buffindexed overview, and timecaf databases
written by an INN built with this option are incompatible with those
@@ -1116,9 +1117,10 @@
arrange them across as many physical disks as possible (or use a striped
disk array and put them all on that).
-In order to use any cycbuff larger than S<2 GB>, you need to build INN with
-the B<--enable-largefiles> option. See L<Installing INN> for more
-information and some caveats.
+In order to use any cycbuff larger than S<2 GB> on 32-bit platforms
+(and some very rare 64-bit platforms that aren't Linux), you need to
+build INN with the B<--enable-largefiles> option. See L<Installing INN>
+for more information and some caveats.
For each cycbuff you will be creating, add a line to F<cycbuff.conf> like
the following:
More information about the inn-committers
mailing list