VFS_CACHEPRIME(1M) System Administration tools VFS_CACHEPRIME(1M)NAMEvfs_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.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌────────────────────┬─────────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├────────────────────┼─────────────────────────────────┤
│Availability │ SUNWsmbar, SUNWsmbac, SUNWsmbau │
├────────────────────┼─────────────────────────────────┤
│Interface Stability │ External │
└────────────────────┴─────────────────────────────────┘
NOTES
Source code for Samba is available in the SUNWsmbaS package.
Samba(7) delivers the set of four SMF(5) services as can be seen from
the following example:
$ svcs samba wins winbind swat
STATE STIME FMRI
disabled Apr_21 svc:/network/samba:default
disabled Apr_21 svc:/network/winbind:default
disabled Apr_21 svc:/network/wins:default
disabled Apr_21 svc:/network/swat:default
where the services are:
"samba"
runs the smbd daemon managing the CIFS sessions
"wins"
runs the nmbd daemon enabling the browsing (WINS)
"winbind"
runs the winbindd daemon making the domain idmap
"swat"
Samba Web Administration Tool is a service providing access to
browser-based Samba administration interface and on-line
documentation. The service runs on software loopback network
interface on port 901/tcp, i.e. opening "http://localhost:901/" in
browser will access the SWAT service on local machine.
Please note: SWAT uses HTTP Basic Authentication scheme where user name
and passwords are sent over the network in clear text. In the SWAT case
the user name is root. Transferring such sensitive data is advisable
only on the software loopback network interface or over secure
networks.
Samba 3.6 04/10/2012 VFS_CACHEPRIME(1M)