Bug 48641 (splice_EAGAIN)
| Summary: | [TRIVIAL]splice can return EAGAIN | ||
|---|---|---|---|
| Product: | Documentation | Reporter: | Daurnimator (quae) |
| Component: | man-pages | Assignee: | documentation_man-pages (documentation_man-pages) |
| Status: | RESOLVED CODE_FIX | ||
| Severity: | normal | CC: | alan, mtk.manpages, sakshi.april5 |
| Priority: | P1 | ||
| Hardware: | All | ||
| OS: | Linux | ||
| Kernel Version: | n/a | Subsystem: | |
| Regression: | No | Bisected commit-id: | |
Hello, I am a beginner and would like to work on this bug. (In reply to sakshi.april5 from comment #1) > Hello, > > I am a beginner and would like to work on this bug. It's still open. Yes, I would like to work on this bug. Since this is my first time fixing a bug in Linux Kernel it would be nice if someone can help me out. This is a bug in the man page, not in the kernel... I have found these files where the changes need to be made: man2/splice.2 man2/vmsplice.2 man2/tee.2 I suppose change in any one file would reflect changes in the other? How exactly do we need to make the chnage to get the above mentioned output? (In reply to sakshi.april5 from comment #5) > I have found these files where the changes need to be made: > man2/splice.2 > man2/vmsplice.2 > man2/tee.2 Yes, it looks like all three pages need the fix. > I suppose change in any one file would reflect changes in the other? Yes, that sounds reasonable. > How exactly do we need to make the chnage to get the above mentioned output? Not sure that I your question. Clone the man-pages git repo [1], and then send a patch. [1] https://www.kernel.org/doc/man-pages/download.html What I meant to ask is - do we have to replace every occurence of splice (2) with splice (2) can return EAGAIN in all the three files? Is that the only change? What I meant to ask is - do we have to replace every occurence of splice (2) with splice (2) can return EAGAIN in all the three files? Is that the only change? I've added the following text to each of the three man pages splice.2, vmsplice.2, tee.2: [[ .TP .B EAGAIN .B SPLICE_F_NONBLOCK was specified in .IR flags , and the operation would block. ]] |
`splice (2)` can return EAGAIN, this is not mentioned in the man pages. Example strace output: pipe([4, 5]) = 0 splice(4, NULL, 1, NULL, 5, SPLICE_F_NONBLOCK) = -1 EAGAIN (Resource temporarily unavailable) I run Arch Linux, the date at the bottom of the man page is: 2012-05-04