1VFS_CACHEPRIME(8)         System Administration tools        VFS_CACHEPRIME(8)
2
3
4

NAME

6       vfs_cacheprime - prime the kernel file data cache
7

SYNOPSIS

9       vfs objects = cacheprime
10

DESCRIPTION

12       This VFS module is part of the samba(7) suite.
13
14       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
19       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
25       This module is stackable.
26

OPTIONS

28       cacheprime:rsize = BYTES
29           The number of bytes with which to prime the kernel data cache.
30
31           The following suffixes may be applied to BYTES:
32
33                  ·   K - BYTES is a number of kilobytes
34
35                  ·   M - BYTES is a number of megabytes
36
37                  ·   G - BYTES is a number of gigabytes
38
39

EXAMPLES

41       For a hypothetical disk array, it is necessary to ensure that all read
42       operations are of size 1 megabyte (1048576 bytes), and aligned on 1
43       megabyte boundaries:
44
45                [hypothetical]
46                vfs objects = cacheprime
47                cacheprime:rsize = 1M
48

CAVEATS

50       cacheprime is not a substitute for a general-purpose readahead
51       mechanism. It is intended for use only in very specific environments
52       where disk operations must be aligned and sized to known values (as
53       much as that is possible).
54

VERSION

56       This man page is part of version 4.8.3 of the Samba suite.
57

AUTHOR

59       The original Samba software and related utilities were created by
60       Andrew Tridgell. Samba is now developed by the Samba Team as an Open
61       Source project similar to the way the Linux kernel is developed.
62
63
64
65Samba 4.8.3                       10/30/2018                 VFS_CACHEPRIME(8)
Impressum