vfs_cacheprime

Name

vfs_cacheprime — prime the kernel file data cache

Synopsis

vfs objects = cacheprime

DESCRIPTION

This VFS module is part of the + samba(7) suite.

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.

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.

This module is stackable.

OPTIONS

cacheprime:rsize = BYTES

The number of bytes with which to prime + the kernel data cache.

The following suffixes may be applied to BYTES:

K - BYTES is a number of kilobytes
M - BYTES is a number of megabytes
G - BYTES is a number of gigabytes

EXAMPLES

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: +

+	[hypothetical]
+	vfs objects = cacheprime
+	cacheprime:rsize = 1M
+

CAVEATS

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). +

VERSION

This man page is correct for version 3.0.25 of the Samba suite. +

AUTHOR

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.