Skip to contentSkip to conversation

Add note on splice/tee EAGAIN error when called with nonblocking descriptors

PATCH Applied Slavomir Kaslev 2 participants 5 messages Apr 12, 2019 – May 5, 2019 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

cover Add note on splice/tee EAGAIN error when called with nonblocking descriptors

Document that splice(2)/tee(2) can fail with EAGAIN when called with nonblocking file descriptors and the operation would block.

Slavomir Kaslev (2):
splice.2: Note EAGAIN can occur when called on nonblocking file
descriptors
tee.2: Note EAGAIN can occur when called on nonblocking file
descriptors

 man2/splice.2 | 4 +++-
 man2/tee.2    | 4 +++-
 2 files changed, 6 insertions(+), 2 deletions(-)
Signature · 1 line
2.19.1
#1 lore raw

PATCH 1/2 splice.2: Note EAGAIN can occur when called on nonblocking file descriptors

---
 man2/splice.2 | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)
man2/splice.2 +3 -1
index 57988d9d6..af3fa4e74 100644
@@ -155,7 +155,9 @@ is set to indicate the error.
 .B EAGAIN
 .B SPLICE_F_NONBLOCK
 was specified in
-.IR flags ,
+.IR flags
+or one of the file descriptors had been marked as nonblocking
+.RB ( O_NONBLOCK ) ,
 and the operation would block.
 .TP
 .B EBADF
Signature · 1 line
2.19.1
#3 lore raw

PATCH 2/2 tee.2: Note EAGAIN can occur when called on nonblocking file descriptors

In reply to Slavomir Kaslev
---
 man2/tee.2 | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)
man2/tee.2 +3 -1
index 7bb0d3a31..03d043b46 100644
@@ -100,7 +100,9 @@ is set to indicate the error.
 .B EAGAIN
 .B SPLICE_F_NONBLOCK
 was specified in
-.IR flags ,
+.IR flags
+or one of the file descriptors had been marked as nonblocking
+.RB ( O_NONBLOCK ) ,
 and the operation would block.
 .TP
 .B EINVAL
Signature · 1 line
2.19.1
#2 lore raw

Re: [PATCH 1/2] splice.2: Note EAGAIN can occur when called on nonblocking file descriptors

In reply to Slavomir Kaslev

Hello Slavomir,

Quoted 1 line · Slavomir Kaslev

Thanks! Applied.

Cheers,

Michael

Quoted 20 lines
---
  man2/splice.2 | 4 +++-
  1 file changed, 3 insertions(+), 1 deletion(-)
man2/splice.2 +3 -1
index 57988d9d6..af3fa4e74 100644
@@ -155,7 +155,9 @@ is set to indicate the error.
  .B EAGAIN
  .B SPLICE_F_NONBLOCK
  was specified in
-.IR flags ,
+.IR flags
+or one of the file descriptors had been marked as nonblocking
+.RB ( O_NONBLOCK ) ,
  and the operation would block.
  .TP
  .B EBADF
#4 lore raw

Re: [PATCH 2/2] tee.2: Note EAGAIN can occur when called on nonblocking file descriptors

In reply to Slavomir Kaslev

Hello again Slavomir,

Quoted 1 line · Slavomir Kaslev

Thanks! Applied.

Cheers,

Michael

Quoted 20 lines
---
  man2/tee.2 | 4 +++-
  1 file changed, 3 insertions(+), 1 deletion(-)
man2/tee.2 +3 -1
index 7bb0d3a31..03d043b46 100644
@@ -100,7 +100,9 @@ is set to indicate the error.
  .B EAGAIN
  .B SPLICE_F_NONBLOCK
  was specified in
-.IR flags ,
+.IR flags
+or one of the file descriptors had been marked as nonblocking
+.RB ( O_NONBLOCK ) ,
  and the operation would block.
  .TP
  .B EINVAL