Changeset 134 for branches/samba-3.0/docs/manpages/vfs_cacheprime.8

Timestamp:

May 23, 2008, 6:56:41 AM (17 years ago)

Author:

Paul Smedley

Message:

Update source to 3.0.29

File:

• branches/samba-3.0/docs/manpages/vfs_cacheprime.8 (modified) (3 diffs)

branches/samba-3.0/docs/manpages/vfs_cacheprime.8

@@ -1 @@
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "VFS_CACHEPRIME" 8 "" "" ""
+.\"     Title: vfs_cacheprime
+.\"    Author: 
+.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
+.\"      Date: 05/21/2008
+.\"    Manual: System Administration tools
+.\"    Source: Samba 3.0
+.\"
+.TH "VFS_CACHEPRIME" "8" "05/21/2008" "Samba 3\.0" "System Administration tools"
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
 .SH "NAME"
 vfs_cacheprime - prime the kernel file data cache
@@ -28 +20 @@
 This VFS module is part of the
 \fBsamba\fR(7)
-suite.
+suite\.
 .PP
 The
 vfs_cacheprime
-VFS module reads chunks of file data near the range requested by clients in order to make sure the data is present in the kernel file data cache at the time when it is actually requested by clients.
+VFS module reads chunks of file data near the range requested by clients in order to make sure the data is present in the kernel file data cache at the time when it is actually requested by clients\.
 .PP
 The size of the disk read operations performed by
 vfs_cacheprime
-is determined by the cacheprime:rsize option. All disk read operations are aligned on boundaries that are a multiple of this size. Each range of the file data is primed at most once during the time the client has the file open.
+is determined by the cacheprime:rsize option\. All disk read operations are aligned on boundaries that are a multiple of this size\. Each range of the file data is primed at most once during the time the client has the file open\.
 .PP
-This module is stackable.
+This module is stackable\.
 .SH "OPTIONS"
 .PP
 cacheprime:rsize = BYTES
-.RS 3n
-The number of bytes with which to prime the kernel data cache.
+.RS 4
+The number of bytes with which to prime the kernel data cache\.
 .sp
 The following suffixes may be applied to BYTES:
-.RS 3n
-.TP 3n
-\(bu
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
 K
-- BYTES is a number of kilobytes
-.TP 3n
-\(bu
+\- BYTES is a number of kilobytes
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
 M
-- BYTES is a number of megabytes
-.TP 3n
-\(bu
+\- BYTES is a number of megabytes
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
 G
-- BYTES is a number of gigabytes
+\- BYTES is a number of gigabytes
+.sp
 .RE
 .RE
@@ -64 +79 @@
 .PP
 For a hypothetical disk array, it is necessary to ensure that all read operations are of size 1 megabyte (1048576 bytes), and aligned on 1 megabyte boundaries:
-
+.sp
+.RS 4
 .nf
-
         \fI[hypothetical]\fR
-        vfs objects = cacheprime
-        cacheprime:rsize = 1M
-
+        \fIvfs objects = cacheprime\fR
+        \fIcacheprime:rsize = 1M\fR
 .fi
+.RE
 .SH "CAVEATS"
 .PP
 cacheprime
-is not a a substitute for a general-purpose readahead mechanism. It is intended for use only in very specific environments where disk operations must be aligned and sized to known values (as much as that is possible).
+is not a a substitute for a general\-purpose readahead mechanism\. It is intended for use only in very specific environments where disk operations must be aligned and sized to known values (as much as that is possible)\.
 .SH "VERSION"
 .PP
-This man page is correct for version 3.0.25 of the Samba suite.
+This man page is correct for version 3\.0\.25 of the Samba suite\.
 .SH "AUTHOR"
 .PP
-The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed.
-
+The original Samba software and related utilities were created by Andrew Tridgell\. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed\.