1VFS_CACHEPRIME(8) VFS_CACHEPRIME(8)
2
6 vfs_cacheprime - prime the kernel file data cache
7
9 vfs objects = cacheprime
10
12 This VFS module is part of the samba(7) suite.
13 The vfs_cacheprime VFS module reads chunks of file data near the range
15 requested by clients in order to make sure the data is present in the
16 kernel file data cache at the time when it is actually requested by
17 clients.
18 The size of the disk read operations performed by vfs_cacheprime is
20 determined by the cacheprime:rsize option. All disk read operations are
21 aligned on boundaries that are a multiple of this size. Each range of
22 the file data is primed at most once during the time the client has the
23 file open.
24 This module is stackable.
26
28 cacheprime:rsize = BYTES
29 The number of bytes with which to prime the kernel data cache.
30 The following suffixes may be applied to BYTES:
32 · K - BYTES is a number of kilobytes
34 · M - BYTES is a number of megabytes
36 · G - BYTES is a number of gigabytes
38
40 For a hypothetical disk array, it is necessary to ensure that all read
41 operations are of size 1 megabyte (1048576 bytes), and aligned on 1
42 megabyte boundaries:
43 [hypothetical]
46 vfs objects = cacheprime
47 cacheprime:rsize = 1M
48
51 cacheprime is not a a substitute for a general-purpose readahead mecha‐
52 nism. It is intended for use only in very specific environments where
53 disk operations must be aligned and sized to known values (as much as
54 that is possible).
55
57 This man page is correct for version 3.0.25 of the Samba suite.
58
60 The original Samba software and related utilities were created by
61 Andrew Tridgell. Samba is now developed by the Samba Team as an Open
62 Source project similar to the way the Linux kernel is developed.
63 VFS_CACHEPRIME(8)