manpages-3/vfs_cacheprime.8.xml

   1 <?xml version="1.0" encoding="iso-8859-1"?>
   2 <!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
   3 <refentry id="vfs_cacheprime.8">
   4
   5 <refmeta>
   6         <refentrytitle>vfs_cacheprime</refentrytitle>
   7         <manvolnum>8</manvolnum>
   8 </refmeta>
   9
  10
  11 <refnamediv>
  12         <refname>vfs_cacheprime</refname>
  13         <refpurpose>prime the kernel file data cache</refpurpose>
  14 </refnamediv>
  15
  16 <refsynopsisdiv>
  17         <cmdsynopsis>
  18                 <command>vfs objects = cacheprime</command>
  19         </cmdsynopsis>
  20 </refsynopsisdiv>
  21
  22 <refsect1>
  23         <title>DESCRIPTION</title>
  24
  25         <para>This VFS module is part of the
  26         <citerefentry><refentrytitle>samba</refentrytitle>
  27         <manvolnum>7</manvolnum></citerefentry> suite.</para>
  28
  29         <para>The <command>vfs_cacheprime</command> VFS module reads chunks
  30         of file data near the range requested by clients in order to
  31         make sure the data is present in the kernel file data cache at
  32         the time when it is actually requested by clients. </para>
  33
  34         <para>The size of the disk read operations performed
  35         by <command>vfs_cacheprime</command> is determined by the
  36         cacheprime:rsize option. All disk read operations are aligned
  37         on boundaries that are a multiple of this size. Each range of
  38         the file data is primed at most once during the time the client
  39         has the file open. </para>
  40
  41         <para>This module is stackable.</para>
  42 </refsect1>
  43
  44 <refsect1>
  45         <title>OPTIONS</title>
  46
  47         <variablelist>
  48
  49                 <varlistentry>
  50                 <term>cacheprime:rsize = BYTES</term>
  51                 <listitem>
  52                 <para>The number of bytes with which to prime
  53                 the kernel data cache.</para>
  54                 <para>The following suffixes may be applied to BYTES:</para>
  55                 <itemizedlist>
  56                 <listitem><para><command>K</command> - BYTES is a number of kilobytes</para></listitem>
  57                 <listitem><para><command>M</command> - BYTES is a number of megabytes</para></listitem>
  58                 <listitem><para><command>G</command> - BYTES is a number of gigabytes</para></listitem>
  59                 </itemizedlist>
  60
  61                 </listitem>
  62                 </varlistentry>
  63
  64         </variablelist>
  65 </refsect1>
  66
  67 <refsect1>
  68         <title>EXAMPLES</title>
  69
  70         <para>For a hypothetical disk array, it is necessary to ensure
  71         that all read operations are of size 1 megabyte (1048576 bytes),
  72         and aligned on 1 megabyte boundaries:
  73         </para>
  74 <programlisting>
  75         <smbconfsection name="[hypothetical]"/>
  76         <smbconfoption name="vfs objects">cacheprime</smbconfoption>
  77         <smbconfoption name="cacheprime:rsize">1M</smbconfoption>
  78 </programlisting>
  79
  80 </refsect1>
  81
  82 <refsect1>
  83         <title>CAVEATS</title>
  84         <para><command>cacheprime</command> is not a a substitute for
  85         a general-purpose readahead mechanism. It is intended for use
  86         only in very specific environments where disk operations must
  87         be aligned and sized to known values (as much as that is possible).
  88         </para>
  89 </refsect1>
  90
  91 <refsect1>
  92         <title>VERSION</title>
  93         <para>This man page is correct for version 3.0.25 of the Samba suite.
  94         </para>
  95 </refsect1>
  96
  97 <refsect1>
  98         <title>AUTHOR</title>
  99
 100         <para>The original Samba software and related utilities
 101         were created by Andrew Tridgell. Samba is now developed
 102         by the Samba Team as an Open Source project similar
 103         to the way the Linux kernel is developed.</para>
 104
 105 </refsect1>
 106
 107 </refentry>