readv.2: Reorder "C library/kernel ABI differences" subsections under NOTES

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2015-01-20 17:41:37 +01:00
parent 8a930bf121
commit 8b5857b0c2
1 changed files with 16 additions and 16 deletions

View File

@ -238,6 +238,22 @@ or at run time via the return value from
On modern Linux systems, the limit is 1024.
Back in Linux 2.0 days, this limit was 16.
\"
\"
.SS C library/kernel ABI differences
The raw
.BR preadv ()
and
.BR pwritev ()
system calls have call signatures that differ slightly from that of the
corresponding GNU C library wrapper functions shown in the SYNOPSIS.
The final argument,
.IR offset ,
is unpacked by the wrapper functions into two arguments in the system calls:
.BI " unsigned long " pos_l ", unsigned long " pos
These arguments contain, respectively, the low order and high order 32 bits of
.IR offset .
.SS Historical C library/kernel ABI differences
To deal with the fact that
.B IOV_MAX
@ -275,22 +291,6 @@ that the system is running a Linux kernel older than version 2.6.18
And since glibc 2.20
(which requires a minimum Linux kernel version of 2.6.32),
the glibc wrapper functions always just directly invoke the system calls.
\"
.SS C library/kernel ABI differences
The raw
.BR preadv ()
and
.BR pwritev ()
system calls have call signatures that differ slightly from that of the
corresponding GNU C library wrapper functions shown in the SYNOPSIS.
The final argument,
.IR offset ,
is unpacked by the wrapper functions into two arguments in the system calls:
.BI " unsigned long " pos_l ", unsigned long " pos
These arguments contain, respectively, the low order and high order 32 bits of
.IR offset .
.SH BUGS
It is not advisable to mix calls to
.BR readv ()