Croak with usage info on no arguments
[pcu.git] / pcu-fadvise.1.txt
blobe7f26a9e491a4e86b6f5056904a9357bc982adeb
1 NAME
2   pcu-fadvise - predeclare an access pattern on given files
3 SYNOPSIS
4   pcu-fadvise [-a advice] [-o offset] [-l length] FILE...
5 DESCRIPTION
6   A command-line interface to the posix_fadvise(2) syscall to tell
7   the kernel to optimize access patterns for specified files.
8 OPTIONS
9   -a advice
11   File access pattern advice.
12   The advice must be one of the following:
14     normal
15     sequential
16     random
17     noreuse
18     willneed
19     dontneed
21   The default advice is normal.
23   -o offset
25   Apply advice only to the given byte offset.
26   This offset rounded down to the previous page offset.
27   The default offset is zero (beginning of the file)
29   -l length
31   Apply advice only to the given length in bytes.
32   This length is rounded up next page offset.
33   The default is to scan the entire file.
35 OUTPUT
36   Errors only.
37 ENVIRONMENT
38   none
39 SEE ALSO
40   posix_fadvise(2), pcu(7)
41 BUGS
42   None known. Email the author if you find any.
43 AUTHOR
44   Eric Wong <normalperson@yhbt.net>