Bug 23072 - preadv(2) and pwritev(2) lack man pages, pread64(2) and pwrite64(2) aren't mentioned on their man pages
Summary: preadv(2) and pwritev(2) lack man pages, pread64(2) and pwrite64(2) aren't me...
Status: RESOLVED CODE_FIX
Alias: None
Product: Documentation
Classification: Unclassified
Component: man-pages (show other bugs)
Hardware: All Linux
: P1 normal
Assignee: Michael Kerrisk
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2010-11-17 14:58 UTC by Evgeny Kapun
Modified: 2010-11-21 05:44 UTC (History)
1 user (show)

See Also:
Kernel Version:
Subsystem:
Regression: No
Bisected commit-id:


Attachments

Description Evgeny Kapun 2010-11-17 14:58:29 UTC
System calls preadv(2) and pwritev(2) are provided by Linux kernel, and glibc has wrappers for them, but there are no corresponding man pages.

Man pages for pread64(2) and pwrite64(2) redirect to pread(2) man page. However, these system calls aren't mentioned on that man page.
Comment 1 Michael Kerrisk 2010-11-21 05:44:52 UTC
Eugene, this would have been best submitted as two bug reports, because these really are two separate issues.

However, by chance, I had recently dealt with on of the issues: the lack of a preadv() and pwritev() documentation (now added to the readv(2) page).

Your report triggered me to deal with the other issue as well. I added a note as follows:

       On  Linux,  the  underlying  system calls were renamed in
       kernel 2.6: pread() became pread64(), and pwrite() became
       pwrite64(),  The  system  call numbers remained the same.
       The glibc pread() and pwrite() wrapper  functions  trans-
       parently deal with the change.

All of the changes are already pushed to git,and will be in man-pages 3.32.

Note You need to log in before you can comment on or make changes to this bug.