LDP: Update original to LDP v3.68

[linuxjm/LDP_man-pages.git] / original / man2 / posix_fadvise.2

diff --git a/original/man2/posix_fadvise.2 b/original/man2/posix_fadvise.2
index 3c04b40..b918f45 100644 (file)
--- a/original/man2/posix_fadvise.2
+++ b/original/man2/posix_fadvise.2
@@ -25,7 +25,7 @@
 .\" 2005-04-08 mtk, noted kernel version and added BUGS
 .\" 2010-10-09, mtk, document arm_fadvise64_64()
 .\"
-.TH POSIX_FADVISE 2 2010-10-09 "Linux" "Linux Programmer's Manual"
+.TH POSIX_FADVISE 2 2014-05-03 "Linux" "Linux Programmer's Manual"
 .SH NAME
 posix_fadvise \- predeclare an access pattern for file data
 .SH SYNOPSIS
@@ -151,18 +151,25 @@ call
 or
 .BR fdatasync (2)
 first.
-.SS arm_fadvise()
-The ARM architecture
-needs 64-bit arguments to be aligned in a suitable pair of registers.
-On this architecture, the call signature of
+.SS Architecture-specific variants
+Some architectures require
+64-bit arguments to be aligned in a suitable pair of registers (see
+.BR syscall (2)
+for further detail).
+On such architectures, the call signature of
 .BR posix_fadvise ()
-is flawed, since it forces a register to be wasted as padding between the
+shown in the SYNOPSIS would force
+a register to be wasted as padding between the
 .I fd
 and
-.I len
+.I offset
 arguments.
-Therefore, since Linux 2.6.14, ARM defines a different
-system call that orders the arguments suitably:
+Therefore, these architectures define a version of the
+system call that orders the arguments suitably,
+but otherwise is otherwise exactly the same as
+.BR posix_fadvise ().
+
+For example, since Linux 2.6.14, ARM has the following system call:
 .PP
 .in +4n
 .nf
@@ -171,10 +178,11 @@ system call that orders the arguments suitably:
 .fi
 .in
 .PP
-The behavior of this system call is otherwise exactly the same as
-.BR posix_fadvise ().
-No library support is provided for this system call in glibc.
-.\" No ARM support in glibc.
+These architecture-specific details are generally
+hidden from applications by the glibc
+.BR posix_fadvise ()
+wrapper function,
+which invokes the appropriate architecture-specific system call.
 .SH BUGS
 In kernels before 2.6.6, if
 .I len
@@ -186,3 +194,12 @@ rather than as meaning "all bytes through to the end of the file".
 .BR posix_fallocate (3),
 .BR posix_madvise (3)
 .\" FIXME . Write a posix_fadvise(3) page.
+.SH COLOPHON
+This page is part of release 3.68 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.