[Bug 48641] New: splice can return EAGAIN

[Bug 48641] New: splice can return EAGAIN

[bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r]

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/vQLgFONoPN62D2FQJk+8+b@public.gmane.org
        ReportedBy: quae-l4MFkWPWeOkX2WXlbB3fKg@public.gmane.org
        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

-- 
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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Bug 48641] [TRIVIAL]splice can return EAGAIN

[bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r]

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

Alan <alan-qBU/x9rampVanCEyBjwyrvXRex20P6io@public.gmane.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |alan-qBU/x9rampVanCEyBjwyrvXRex20P6io@public.gmane.org
            Summary|splice can return EAGAIN    |[TRIVIAL]splice can return
                   |                            |EAGAIN

-- 
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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Bug 48641] [TRIVIAL]splice can return EAGAIN

[bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r]

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

sakshi.april5-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |sakshi.april5-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org

--- Comment #1 from sakshi.april5-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org ---
Hello,

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

-- 
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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Bug 48641] [TRIVIAL]splice can return EAGAIN

[bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r]

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

Michael Kerrisk <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org

--- Comment #2 from Michael Kerrisk <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> ---
(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.

-- 
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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Bug 48641] [TRIVIAL]splice can return EAGAIN

[bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r]

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

--- Comment #3 from sakshi.april5-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org ---
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.

-- 
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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Bug 48641] [TRIVIAL]splice can return EAGAIN

[bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r]

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

--- Comment #4 from Michael Kerrisk <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> ---
This is a bug in the man page, not in the kernel...

-- 
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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Bug 48641] [TRIVIAL]splice can return EAGAIN

[bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r]

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

--- Comment #5 from sakshi.april5-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org ---
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?

-- 
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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Bug 48641] [TRIVIAL]splice can return EAGAIN

[bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r]

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

--- Comment #6 from Michael Kerrisk <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> ---
(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

-- 
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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Bug 48641] [TRIVIAL]splice can return EAGAIN

[bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r]

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

--- Comment #7 from sakshi.april5-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org ---
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?

-- 
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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Bug 48641] [TRIVIAL]splice can return EAGAIN

[bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r]

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

--- Comment #8 from sakshi.april5-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org ---
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?

-- 
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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Bug 48641] [TRIVIAL]splice can return EAGAIN

[bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r]

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

Michael Kerrisk <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |RESOLVED
         Resolution|---                         |CODE_FIX

--- Comment #9 from Michael Kerrisk <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> ---
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.
]]

-- 
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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html