pcu.git  about / heads / tags
page cache utilities for Linux
blob f4bf0c7d69452ff1b06a565425ed7a7224c6fc9d 1172 bytes (raw)
$ git show HEAD:pcu-fadvise.1.txt	# shows this blob on the CLI

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
 
% PCU-FADVISE(1) Page Cache Utilities Manual
% Eric Wong <normalperson@yhbt.net>
% July 26, 2009

# NAME

pcu-fadvise - predeclare an access pattern on given files

# SYNOPSIS

pcu-fadvise [*-a ADVICE*] [*-o OFFSET*] [*-l LENGTH*] FILE...

# DESCRIPTION

A command-line interface to the posix_fadvise(2) syscall to tell
the kernel to optimize access patterns for specified files.

# OPTIONS

-a *ADVICE*
:   File access pattern advice.

:   *ADVICE* must be one of the following:

      * normal
      * sequential
      * random
      * noreuse
      * willneed
      * dontneed

     The default advice is `normal`.

-o *OFFSET*
:   Apply advice only to the given byte offset.
    This offset rounded down to the previous page offset.
    The default offset is zero (beginning of the file).

-l *LENGTH*
:   Apply advice only to the given length in bytes.
    This length is rounded up next page offset.
    The default is to scan the entire file.

# OUTPUT

Errors only.

# ENVIRONMENT

none

# SEE ALSO
[`posix_fadvise`(2)][1]

# BUGS

None known. Email <pcu@librelist.com> if you find any.

[1]: http://opengroup.org/onlinepubs/009695399/functions/posix_fadvise.html

git clone https://yhbt.net/pcu.git