inotify SIGIO documentation for inotify.7 man page

inotify SIGIO documentation for inotify.7 man page

[Michael Kerrisk]

Hi Dmitry,

I don't think I got notification of the 2.6.25 API change to inotify from
you.  Please CC me on API changes.

The following is my attempt to document the SIGIO feature that is new in
2.6.25.  Does this look okay to you?

       Since Linux 2.6.25,  signal-driven  I/O  notification  is
       available  for  inotify file descriptors; see the discus-
       sion of F_SETFL (for setting the O_ASYNC flag), F_SETOWN,
       and   F_SETSIG  in  fcntl(2).   The  siginfo_t  structure
       (described in sigaction(2)) that is passed to the  signal
       handler has the following fields set: si_fd is set to the
       inotify file descriptor number; si_signo is  set  to  the
       signal  number;  si_code is set to POLL_IN; and POLLIN is
       set in si_band.

Cheers,

Michael

-- 
Michael Kerrisk
Maintainer of the Linux man-pages project
http://www.kernel.org/doc/man-pages/
Want to report a man-pages bug?  Look here:
http://www.kernel.org/doc/man-pages/reporting_bugs.html

Re: inotify SIGIO documentation for inotify.7 man page

[Michael Kerrisk]

Hey Dmitry,

Ping!

Cheers,

Michael

On Tue, Apr 8, 2008 at 12:16 AM, Michael Kerrisk
<mtk.manpages@googlemail.com> wrote:
> Hi Dmitry,
>
> I don't think I got notification of the 2.6.25 API change to inotify from
> you.  Please CC me on API changes.
>
> The following is my attempt to document the SIGIO feature that is new in
> 2.6.25.  Does this look okay to you?
>
>       Since Linux 2.6.25,  signal-driven  I/O  notification  is
>       available  for  inotify file descriptors; see the discus-
>       sion of F_SETFL (for setting the O_ASYNC flag), F_SETOWN,
>       and   F_SETSIG  in  fcntl(2).   The  siginfo_t  structure
>       (described in sigaction(2)) that is passed to the  signal
>       handler has the following fields set: si_fd is set to the
>       inotify file descriptor number; si_signo is  set  to  the
>       signal  number;  si_code is set to POLL_IN; and POLLIN is
>       set in si_band.
>
> Cheers,
>
> Michael
>
> --
> Michael Kerrisk
> Maintainer of the Linux man-pages project
> http://www.kernel.org/doc/man-pages/
> Want to report a man-pages bug?  Look here:
> http://www.kernel.org/doc/man-pages/reporting_bugs.html
>
>
>



-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Found a bug? http://www.kernel.org/doc/man-pages/reporting_bugs.html