Skip to contentSkip to conversation

New: splice can return EAGAIN

Bug 48641 bugzilla-daemon-590EEB7GvNiWaY/[email protected] 1 participant 11 messages Oct 9, 2012 – Jun 18, 2014 1 message not in the archive Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

https://bugzilla.kernel.org/show_bug.cgi?id=48641

Summary: splice can return EAGAIN
Product: Documentation
Version: unspecified
Kernel Version: n/a
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

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

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
#2 lore raw

[Bug 48641] [TRIVIAL]splice can return EAGAIN

In reply to a message not in the archive

https://bugzilla.kernel.org/show_bug.cgi?id=48641

Alan <alan-qBU/[email protected]> changed:

What |Removed |Added
----------------------------------------------------------------------------

                 CC|                            |alan-qBU/[email protected]
            Summary|splice can return EAGAIN    |[TRIVIAL]splice can return
                   |                            |EAGAIN
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
#3 lore raw

[Bug 48641] [TRIVIAL]splice can return EAGAIN

In reply to a message not in the archive

https://bugzilla.kernel.org/show_bug.cgi?id=48641

[email protected] changed:

What |Removed |Added
----------------------------------------------------------------------------
CC| |[email protected]

--- Comment #1 from [email protected] --- Hello,

I am a beginner and would like to work on this bug.

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
#4 lore raw

[Bug 48641] [TRIVIAL]splice can return EAGAIN

In reply to a message not in the archive

https://bugzilla.kernel.org/show_bug.cgi?id=48641

Michael Kerrisk <[email protected]> changed:

What |Removed |Added
----------------------------------------------------------------------------
CC| |[email protected]

--- Comment #2 from Michael Kerrisk <[email protected]> --- (In reply to sakshi.april5 from comment #1)

Quoted 3 lines

Hello,

I am a beginner and would like to work on this bug.

It's still open.

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
#5 lore raw

[Bug 48641] [TRIVIAL]splice can return EAGAIN

In reply to a message not in the archive

https://bugzilla.kernel.org/show_bug.cgi?id=48641

--- Comment #3 from [email protected] --- 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.

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
#6 lore raw

[Bug 48641] [TRIVIAL]splice can return EAGAIN

In reply to a message not in the archive

https://bugzilla.kernel.org/show_bug.cgi?id=48641

--- Comment #4 from Michael Kerrisk <[email protected]> --- This is a bug in the man page, not in the kernel...

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
#7 lore raw

[Bug 48641] [TRIVIAL]splice can return EAGAIN

In reply to a message not in the archive

https://bugzilla.kernel.org/show_bug.cgi?id=48641

--- Comment #5 from [email protected] --- 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?

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
#8 lore raw

[Bug 48641] [TRIVIAL]splice can return EAGAIN

In reply to a message not in the archive

https://bugzilla.kernel.org/show_bug.cgi?id=48641

--- Comment #6 from Michael Kerrisk <[email protected]> --- (In reply to sakshi.april5 from comment #5)

Quoted 4 lines

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.

Quoted 1 line

I suppose change in any one file would reflect changes in the other?

Yes, that sounds reasonable.

Quoted 1 line

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

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
#9 lore raw

[Bug 48641] [TRIVIAL]splice can return EAGAIN

In reply to a message not in the archive

https://bugzilla.kernel.org/show_bug.cgi?id=48641

--- Comment #7 from [email protected] --- 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?

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
#10 lore raw

[Bug 48641] [TRIVIAL]splice can return EAGAIN

In reply to a message not in the archive

https://bugzilla.kernel.org/show_bug.cgi?id=48641

--- Comment #8 from [email protected] --- 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?

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
#11 lore raw

[Bug 48641] [TRIVIAL]splice can return EAGAIN

In reply to a message not in the archive

https://bugzilla.kernel.org/show_bug.cgi?id=48641

Michael Kerrisk <[email protected]> changed:

What |Removed |Added
----------------------------------------------------------------------------

             Status|NEW                         |RESOLVED
         Resolution|---                         |CODE_FIX

--- Comment #9 from Michael Kerrisk <[email protected]> --- 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.
]]

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