misc-utils/fadvise.1.adoc

   1 //po4a: entry man manual
   2 = fadvise(1)
   3 :doctype: manpage
   4 :man manual: User Commands
   5 :man source: util-linux {release-version}
   6 :page-layout: base
   7 :command: fadvise
   8
   9 == NAME
  10
  11 fadvise - utility to use the posix_fadvise system call
  12
  13 == SYNOPSIS
  14
  15 *fadvise* [*-a* _advice_] [*-o* _offset_] [*-l* _length_] _filename_
  16
  17 *fadvise* [*-a* _advice_] [*-o* _offset_] [*-l* _length_] -d _file-descriptor_
  18
  19 == DESCRIPTION
  20
  21 *fadvise* is a simple command wrapping posix_fadvise system call
  22 that is for predeclaring an access pattern for file data.
  23
  24 == OPTIONS
  25
  26 *-d*, *--fd* _file-descriptor_::
  27 Apply the advice to the file specified with the file descriptor instead
  28 of open a file specified with a file name.
  29
  30 *-a*, *--advice* _advice_::
  31 See the command output with *--help* option for available values for
  32 advice. If this option is omitted, "dontneed" is used as default advice.
  33
  34 *-o*, *--offset* _offset_::
  35 Specifies the beginning offset of the range, in bytes.
  36 If this option is omitted, 0 is used as default advice.
  37
  38 *-l*, *--length* _length_::
  39 Specifies the length of the range, in bytes.
  40 If this option is omitted, 0 is used as default advice.
  41
  42 include::man-common/help-version.adoc[]
  43
  44 == EXIT STATUS
  45
  46 *fadvise* has the following exit status values:
  47
  48 *0*::
  49 success
  50 *1*::
  51 unspecified failure
  52
  53 == AUTHORS
  54
  55 mailto:yamato@redhat.com[Masatake YAMATO]
  56
  57 == SEE ALSO
  58
  59 *posix_fadvise*(2)
  60
  61 include::man-common/bugreports.adoc[]
  62
  63 include::man-common/footer.adoc[]
  64
  65 ifdef::translation[]
  66 include::man-common/translation.adoc[]
  67 endif::[]
  68