LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

posix_fadvise.2: Document the architecture-specific arm_fadvise64_64() system call 

This ARM-specific system call fixes the argument ordering
for that architecture. Since Linux 2.6.14.

Reported-by: Stephan Mueller <stephan.mueller@atsec.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2010-10-09 06:50:38 +02:00
parent e049eee85f
commit dc30fdc64e
1 changed files with 25 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
man2/posix_fadvise.2
View File

@ -22,6 +22,7 @@
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" 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"
.SH NAME
@ -148,6 +149,30 @@ 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
.BR posix_fadvise ()
is flawed, since it forces a register to be wasted as padding between the
.I fd
and
.I len
arguments.
Therefore, since Linux 2.6.14, ARM defines a different
system call that orders the arguments suitably:
.PP
.in +4n
.nf
.BI "long arm_fadvise64_64(int " fd ", int " advice ,
.BI " loff_t " offset ", loff_t " len );
.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.
.SH BUGS
In kernels before 2.6.6, if
.I len