]>
Commit | Line | Data |
---|---|---|
642e1c69 MY |
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 | ||
917f8478 | 21 | *fadvise* is a simple command wrapping *posix_fadvise*(2) system call |
642e1c69 MY |
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 | ||
10333c17 TW |
42 | include::man-common/help-version.adoc[] |
43 | ||
3179b40c TW |
44 | == EXIT STATUS |
45 | ||
46 | *fadvise* has the following exit status values: | |
47 | ||
48 | *0*:: | |
49 | success | |
50 | *1*:: | |
51 | unspecified failure | |
52 | ||
642e1c69 MY |
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 |