New: Man page bug for mmap2(2)
https://bugzilla.kernel.org/show_bug.cgi?id=42892
Summary: Man page bug for mmap2(2)
Product: Documentation
Version: unspecified
Platform: All
OS/Version: Linux
Tree: Mainline
Status: NEW
Severity: normal
Priority: P1
Component: man-pages
AssignedTo: documentation_man-pages-ztI5WcYan/[email protected]
ReportedBy: [email protected]
Regression: No
Created an attachment (id=72559)
--> (https://bugzilla.kernel.org/attachment.cgi?id=72559)
Program to discover partitions that got lost.
Using the mmap2(2) man page to write code results in an error, possibly because of missing includes. In any event, no definition of mmap2 is seen when I use gcc -E. The result is compilation without a prototype.
It happens that compilation succeeds, but linking fails for lack of a library containing mmap2.
This is Ubuntu 11.04, kernel 2.6.38, and man page dated 2008-04-22, from release 3.27 of the man-pages project.
Source code is attached. It's a single source file, intended to be a program to discover partitions that got lost. It is incomplete and may be buggy, but I cannot debug this version until mmap2 works for me.
It looks to me as if there needs to be two things added to the synopsis:
a cc line showing a non glibc library.
a #include line showing an additional header.
Signature · 7 lines
Configure bugmail: https://bugzilla.kernel.org/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
[Bug 42892] Man page bug for mmap2(2)
In reply to a message not in the archivehttps://bugzilla.kernel.org/show_bug.cgi?id=42892
--- Comment #1 from Kevin <[email protected]> 2012-03-09 15:14:06 --- It occurs to me that perhaps glue code is intentionally missing, and this
system call is to be used internally for library authors. If this is the case,
then it seems to me the man page should look more like getdents(2) and a few
others, with the description beginning "This is not the function you are
interested in."
Signature · 7 lines
Configure bugmail: https://bugzilla.kernel.org/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
[Bug 42892] Man page bug for mmap2(2)
In reply to a message not in the archivehttps://bugzilla.kernel.org/show_bug.cgi?id=42892
Michael Kerrisk <[email protected]> changed:
What |Removed |Added
----------------------------------------------------------------------------
CC| |[email protected] AssignedTo|documentation_man-pages@ker |[email protected] |nel-bugs.osdl.org |
Signature · 7 lines
Configure bugmail: https://bugzilla.kernel.org/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html