Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
VFS_CACHEPRIME(8)	   System Administration tools	       VFS_CACHEPRIME(8)

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 re-
     quested 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 deter-
     mined 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 op-
     erations 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 substitute for a general-purpose readahead mechanism.
     It is intended for use only in very specific environments where disk opera-
     tions must be aligned and sized to known values (as much as that is  possi-
     ble).

VERSION
     This man page is part of version 4.23.8 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.

Samba 4.23.8			   08/01/2026		       VFS_CACHEPRIME(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=vfs_cacheprime&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help