source: vendor/current/docs/manpages/vfs_readahead.8

Last change on this file was 989, checked in by Silvan Scherrer, 9 years ago

Samba Server: update vendor to version 4.4.7

File size: 3.3 KB
RevLine 
[860]1'\" t
2.\" Title: vfs_readahead
3.\" Author: [see the "AUTHOR" section]
[988]4.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
[989]5.\" Date: 10/25/2016
[860]6.\" Manual: System Administration tools
[988]7.\" Source: Samba 4.4
[860]8.\" Language: English
9.\"
[989]10.TH "VFS_READAHEAD" "8" "10/25/2016" "Samba 4\&.4" "System Administration tools"
[860]11.\" -----------------------------------------------------------------
12.\" * Define some portability stuff
13.\" -----------------------------------------------------------------
14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15.\" http://bugs.debian.org/507673
16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18.ie \n(.g .ds Aq \(aq
19.el .ds Aq '
20.\" -----------------------------------------------------------------
21.\" * set default formatting
22.\" -----------------------------------------------------------------
23.\" disable hyphenation
24.nh
25.\" disable justification (adjust text to left margin only)
26.ad l
27.\" -----------------------------------------------------------------
28.\" * MAIN CONTENT STARTS HERE *
29.\" -----------------------------------------------------------------
30.SH "NAME"
31vfs_readahead \- pre\-load the kernel buffer cache
32.SH "SYNOPSIS"
33.HP \w'\ 'u
34vfs objects = readahead
35.SH "DESCRIPTION"
36.PP
37This VFS module is part of the
38\fBsamba\fR(7)
39suite\&.
40.PP
41This
42vfs_readahead
43VFS module detects read requests at multiples of a given offset (hex 0x80000 by default) and then tells the kernel via either the readahead system call (on Linux) or the posix_fadvise system call to pre\-fetch this data into the buffer cache\&.
44.PP
45This module is useful for Windows Vista clients reading data using the Windows Explorer program, which asynchronously does multiple file read requests at offset boundaries of 0x80000 bytes\&.
46.PP
47The offset multiple used is given by the readahead:offset option, which defaults to 0x80000\&.
48.PP
49The size of the disk read operations performed by
50vfs_readahead
51is determined by the readahead:length option\&. By default this is set to the same value as the readahead:offset option and if not set explicitly will use the current value of readahead:offset\&.
52.PP
53This module is stackable\&.