pcu-fadvise.1.txt

   1 % PCU-FADVISE(1) Page Cache Utilities Manual
   2 % Eric Wong <normalperson@yhbt.net>
   3 % July 26, 2009
   4
   5 # NAME
   6
   7 pcu-fadvise - predeclare an access pattern on given files
   8
   9 # SYNOPSIS
  10
  11 pcu-fadvise [*-a ADVICE*] [*-o OFFSET*] [*-l LENGTH*] FILE...
  12
  13 # DESCRIPTION
  14
  15 A command-line interface to the posix_fadvise(2) syscall to tell
  16 the kernel to optimize access patterns for specified files.
  17
  18 # OPTIONS
  19
  20 -a *ADVICE*
  21 :   File access pattern advice.
  22
  23 :   *ADVICE* must be one of the following:
  24
  25       * normal
  26       * sequential
  27       * random
  28       * noreuse
  29       * willneed
  30       * dontneed
  31
  32      The default advice is `normal`.
  33
  34 -o *OFFSET*
  35 :   Apply advice only to the given byte offset.
  36     This offset rounded down to the previous page offset.
  37     The default offset is zero (beginning of the file).
  38
  39 -l *LENGTH*
  40 :   Apply advice only to the given length in bytes.
  41     This length is rounded up next page offset.
  42     The default is to scan the entire file.
  43
  44 # OUTPUT
  45
  46 Errors only.
  47
  48 # ENVIRONMENT
  49
  50 none
  51
  52 # SEE ALSO
  53 [`posix_fadvise`(2)](http://linux.die.net/man/2/posix_fadvise)
  54
  55 # BUGS
  56
  57 None known. Email <pcu@librelist.com> if you find any.