Ignore:
Timestamp:
May 27, 2007, 12:26:26 AM (19 years ago)
Author:
Paul Smedley
Message:

Upgrade source to 3.0.25a

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/samba/docs/manpages/vfs_cacheprime.8

    r1 r39  
    1919..
    2020.TH "VFS_CACHEPRIME" 8 "" "" ""
    21 .SH NAME
    22 vfs_cacheprime \- prime the kernel file data cache
     21.SH
     22vfs_cacheprime - prime the kernel file data cache
    2323.SH "SYNOPSIS"
    24 .ad l
    25 .hy 0
    2624.HP 25
    2725\fBvfs objects = cacheprime\fR
    28 .ad
    29 .hy
    30 
    3126.SH "DESCRIPTION"
    32 
    3327.PP
    34 This VFS module is part of the\fBsamba\fR(7) suite\&.
    35 
     28This VFS module is part of the
     29\fBsamba\fR(7)
     30suite.
    3631.PP
    37 The \fBvfs_cacheprime\fR 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\&.
    38 
     32The
     33\fBvfs_cacheprime\fR
     34VFS 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.
    3935.PP
    40 The size of the disk read operations performed by \fBvfs_cacheprime\fR 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\&.
    41 
     36The size of the disk read operations performed by
     37\fBvfs_cacheprime\fR
     38is 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.
    4239.PP
    43 This module is stackable\&.
    44 
     40This module is stackable.
    4541.SH "OPTIONS"
    46 
    47 .TP
     42.PP
    4843cacheprime:rsize = BYTES
    49 The number of bytes with which to prime the kernel data cache\&.
    50 
     44.RS 3n
     45The number of bytes with which to prime the kernel data cache.
     46.sp
    5147The following suffixes may be applied to BYTES:
    52 
    53 .RS
    54 .TP 3
    55 \(bu
    56 \fBK\fR \- BYTES is a number of kilobytes
    57 .TP
    58 \(bu
    59 \fBM\fR \- BYTES is a number of megabytes
    60 .TP
    61 \(bu
    62 \fBG\fR \- BYTES is a number of gigabytes
    63 .LP
     48.RS 3n
     49.TP 3n
     50•
     51\fBK\fR
     52- BYTES is a number of kilobytes
     53.TP 3n
     54•
     55\fBM\fR
     56- BYTES is a number of megabytes
     57.TP 3n
     58•
     59\fBG\fR
     60- BYTES is a number of gigabytes
    6461.RE
    65 .IP
    66 
     62.RE
    6763.SH "EXAMPLES"
    68 
    6964.PP
    7065For 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:
    … …  
    7772
    7873.fi
     74
     75
     76
     77
     78
     79
     80
     81
     82
     83
    7984
    80 .SH "CAVEATS"
    81 
    82 .PP
    83 \fBcacheprime\fR 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)\&.
    84 
    85 .SH "VERSION"
    86 
    87 .PP
    88 This man page is correct for version 3\&.0\&.25 of the Samba suite\&.
    89 
    90 .SH "AUTHOR"
    91 
    92 .PP
    93 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\&.
    94 
Note: See TracChangeset for help on using the changeset viewer.