about summary refs log tree commit homepage
path: root/pcu-fadvise.1.txt
diff options
context:
space:
mode:
Diffstat (limited to 'pcu-fadvise.1.txt')
-rw-r--r--pcu-fadvise.1.txt44
1 files changed, 44 insertions, 0 deletions
diff --git a/pcu-fadvise.1.txt b/pcu-fadvise.1.txt
new file mode 100644
index 0000000..e7f26a9
--- /dev/null
+++ b/pcu-fadvise.1.txt
@@ -0,0 +1,44 @@
+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.
+  The 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), pcu(7)
+BUGS
+  None known. Email the author if you find any.
+AUTHOR
+  Eric Wong <normalperson@yhbt.net>