Debian Codegraph @

upstream/opensuse-tumbleweed/man8/vfs_readahead.8

raw
1 '\" t
2 .\" Title: vfs_readahead
3 .\" Author: [see the "AUTHOR" section]
4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
5 .\" Date: 05/26/2026
6 .\" Manual: System Administration tools
7 .\" Source: Samba 4.23.8-git.477.f78166bceedSUSE-oS16.9-x86_64
8 .\" Language: English
9 .\"
10 .TH "VFS_READAHEAD" "8" "05/26/2026" "Samba 4\&.23\&.8\-git\&.477\&.f78166bcee" "System Administration tools"
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"
31 vfs_readahead \- pre\-load the kernel buffer cache
32 .SH "SYNOPSIS"
33 .HP \w'\ 'u
34 vfs objects = readahead
35 .SH "DESCRIPTION"
36 .PP
37 This VFS module is part of the
38 \fBsamba\fR(7)
39 suite\&.
40 .PP
41 This
42 vfs_readahead
43 VFS 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
45 This 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
47 The offset multiple used is given by the readahead:offset option, which defaults to 0x80000\&.
48 .PP
49 The size of the disk read operations performed by
50 vfs_readahead
51 is 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
53 This module is stackable\&.
54 .SH "OPTIONS"
55 .PP
56 readahead:offset = BYTES
57 .RS 4
58 The offset multiple that causes readahead to be requested of the kernel buffer cache\&.
59 .RE
60 .PP
61 readahead:length = BYTES
62 .RS 4
63 The number of bytes requested to be read into the kernel buffer cache on each readahead call\&.
64 .RE
65 .PP
66 The following suffixes may be applied to BYTES:
67 .RS
68 .sp
69 .RS 4
70 .ie n \{\
71 \h'-04'\(bu\h'+03'\c
72 .\}
73 .el \{\
74 .sp -1
75 .IP \(bu 2.3
76 .\}
77 K
78 \- BYTES is a number of kilobytes
79 .RE
80 .sp
81 .RS 4
82 .ie n \{\
83 \h'-04'\(bu\h'+03'\c
84 .\}
85 .el \{\
86 .sp -1
87 .IP \(bu 2.3
88 .\}
89 M
90 \- BYTES is a number of megabytes
91 .RE
92 .sp
93 .RS 4
94 .ie n \{\
95 \h'-04'\(bu\h'+03'\c
96 .\}
97 .el \{\
98 .sp -1
99 .IP \(bu 2.3
100 .\}
101 G
102 \- BYTES is a number of gigabytes
103 .RE
104 .SH "EXAMPLES"
105 .sp
106 .if n \{\
107 .RS 4
108 .\}
109 .nf
110 \fI[hypothetical]\fR
111 \m[blue]\fBvfs objects = readahead\fR\m[]
112 .fi
113 .if n \{\
114 .RE
115 .\}
116 .SH "VERSION"
117 .PP
118 This man page is part of version 4\&.23\&.8\-git\&.477\&.f78166bceedSUSE\-oS16\&.9\-x86_64 of the Samba suite\&.
119 .SH "AUTHOR"
120 .PP
121 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\&.