New: Errors in sendfile man page
https://bugzilla.kernel.org/show_bug.cgi?id=86001
Bug ID: 86001
Summary: Errors in sendfile man page
Product: Documentation
Version: unspecified
Hardware: All
OS: Linux
Status: NEW
Severity: normal
Priority: P1
Component: man-pages
Assignee: documentation_man-pages-ztI5WcYan/[email protected]
Reporter: safinaskar-JGs/[email protected]
Regression: No
Current "man sendfile" (git commit 36ad6ae0b4b6252a921a91dbd785de8fd88a364b) from kernel man pages contradicts to itself. The section "DESCRIPTION" says:
"In Linux kernels before 2.6.33, out_fd must refer to a socket. Since Linux 2.6.33 it can be any file", and AFAIK this is right current info. But the section "NOTES" says: "In Linux 2.4 and earlier, out_fd could also refer to a regular file" and this confuses. Also, the "NOTES" says: "The Linux-specific splice(2) call supports transferring data between arbitrary files (e.g., a pair of sockets)". This is wrong, because one splice call cannot splice together two sockets. So, please fix the man. Probably you should double-check whole man and make sure that whole man is up-to-date
Signature · 6 lines
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
A message that is not in the archive (sent off-list or not yet received): bug-86001-11311-3bo0kxnWaOQUvHkbgXJLS5sdmw4N0Rt+2LY78lusg7I@public.gmane.org/
[Bug 86001] Errors in sendfile man page
https://bugzilla.kernel.org/show_bug.cgi?id=86001
Michael Kerrisk <[email protected]> changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|NEW |RESOLVED
CC| |[email protected]
Resolution|--- |CODE_FIX--- Comment #1 from Michael Kerrisk <[email protected]> --- I changed the text in NOTES to
[[
In Linux 2.4 and earlier,
.I out_fd
could also refer to a regular file;
this possibility went away in the Linux 2.6.x kernel series, but was restored in Linux 2.6.33.
]]
Thanks,
Michael
Signature · 6 lines
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 86001] Errors in sendfile man page
In reply to a message not in the archivehttps://bugzilla.kernel.org/show_bug.cgi?id=86001
Askar Safin <safinaskar-JGs/[email protected]> changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|RESOLVED |REOPENED
Resolution|CODE_FIX |------ Comment #2 from Askar Safin <safinaskar-JGs/[email protected]> --- "The Linux-specific splice(2) call supports transferring data between arbitrary files (e.g., a pair of sockets)"
"pair of sockets" part is wrong. See splice(2). Also, I just tested this, splice doesn't work on pair of sockets (tested on Linux 3.16). So, please, change this phrase to (for example):
"The Linux-specific splice(2) call supports transferring data between arbitrary file descriptors provided one of them (or both) is a pipe".
(Also, where is your change? I don't see it in current head [
https://git.kernel.org/cgit/docs/man-pages/man-pages.git/tree/man2/sendfile.2?id=beb9356fdc3d377f27eec6fd2cb07b97bb1927d4
])
Signature · 6 lines
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 86001] Errors in sendfile man page
In reply to a message not in the archivehttps://bugzilla.kernel.org/show_bug.cgi?id=86001
Michael Kerrisk <[email protected]> changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|REOPENED |RESOLVED
Resolution|--- |CODE_FIX--- Comment #3 from Michael Kerrisk <[email protected]> --- (In reply to Askar Safin from comment #2)
Quoted 9 lines
"The Linux-specific splice(2) call supports transferring data between arbitrary files (e.g., a pair of sockets)"
"pair of sockets" part is wrong. See splice(2). Also, I just tested this, splice doesn't work on pair of sockets (tested on Linux 3.16). So, please, change this phrase to (for example):
"The Linux-specific splice(2) call supports transferring data between arbitrary file descriptors provided one of them (or both) is a pipe".
Thanks, Askar.
Changed as you suggest (but not yet pushed).
Cheers,
Michael
Signature · 6 lines
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 86001] Errors in sendfile man page
In reply to a message not in the archivehttps://bugzilla.kernel.org/show_bug.cgi?id=86001
--- Comment #4 from Askar Safin <safinaskar-JGs/[email protected]> --- Thanks :)
Signature · 6 lines
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