[lkml]   [2007]   [Jul]   [1]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
Messages in this thread
SubjectMan page correction: epoll (7)
Here's a bit of email I exchanged with Davide Libenzi on epoll (7) man 
page. There is an error in answer 9:

Davide Libenzi wrote:
> On Mon, 25 Jun 2007, Heikki Orsila wrote:
>> >From epoll man page:
>> Q9 Do I need to continuously read/write an fd until EAGAIN when
>> using the EPOLLET flag ( Edge Triggered behaviour ) ?
>> A9 No you don't.
>> ...
>> For example, if you call read(2) by asking to read
>> a certain amount of data and read(2) returns a lower number of
>> bytes, you can be sure to have exhausted the read I/O space for
>> such file descriptor.
>> ...
>> This doesn't seem very true in the general case. Afaik, terminal
>> devices can be configured to return only one line per read(). For
>> example,
>> read(terminal_fd, buf, 4096)
>> will return 34 (the length of the line) but obviously the IO space would
>> not be exhausted if _two_ lines arrived into terminal fd during IO wait.
>> And thus, arrival of the second line went unnoticed.
>> Teaching to optimise nonblocking reads will likely cause more bugs.
>> I'm I correct? If yes, that number should be removed from the question
>> list.
> Yes, you are correct. Although the above is true for the majority of
> stream files, so it better be fixed with the few counter-examples
> instead of being removed.
> - Davide


Davide Libenzi wrote:
> Heikki Orsila wrote:
>> Maybe so that we say that as a general rule one must read until EAGAIN,
>> but mention specific cases where one only needs to wait for "short"
>> reads?
> Yes, that's fine with me.

So, the Q9 should be changed:

Q9 Do I need to continuously read/write an fd until EAGAIN when
using the EPOLLET flag ( Edge Triggered behaviour ) ?

A9 As a general rule, yes. However, there are exceptions.
With some types of fds it is enough to wait until
read returns less bytes than was requested by the read call.

Are there any fd types where such behavior is guaranteed by the Linux
kernel (for the future)? I.e. one can assume that edge-triggered fds
will behave properly if

x = read(fd, data, count) and x < count ?

Regular files? Sockets? What?

Heikki Orsila Barbie's law: "Math is hard, let's go shopping!"
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to
More majordomo info at
Please read the FAQ at

 \ /
  Last update: 2007-07-01 14:25    [W:0.025 / U:25.108 seconds]
©2003-2018 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site