Re: [Lse-tech] Re: [PATCH] Updated sys_epoll now with man pages

Davide Libenzi
2002-10-29T05:31:57Z

On Mon, 28 Oct 2002, Randy.Dunlap wrote:

> I expect this to be unpopular, but I've been saying lately that
> when new kernel APIs or syscalls or whatsoever are added to
> Linux, there should be sufficient docs along with the patch(es)
> explaining the patch and some intended uses of it, perhaps even
> with examples. Ingo does this sometimes. Some people don't
> bother to even come close.
>
> Leading by example would be a nice thing to see here.

Hi Randy, no it's not unpopular :) Those were posted togheter with the
patch :

http://www.xmailserver.org/linux-patches/epoll.txt
http://www.xmailserver.org/linux-patches/epoll_create.txt
http://www.xmailserver.org/linux-patches/epoll_ctl.txt
http://www.xmailserver.org/linux-patches/epoll_wait.txt

to try to explain the new API from user side. From kernel side epoll
completely uses the sk_wake_async() already available by many versions,
and also it is not expected to offer kernel services to other kernel
modules.

- Davide