bionic (3) iv_inotify.3.gz

NAME

       IV_INOTIFY_INIT,         iv_inotify_register,        iv_inotify_unregister,        IV_INOTIFY_WATCH_INIT,
       iv_inotify_watch_register, iv_inotify_watch_unregister - ivykis inotify(7) wrapper

SYNOPSIS

       #include <iv_inotify.h>

       struct iv_inotify {
       };

       void IV_INOTIFY_INIT(struct iv_inotify *inotify);
       int iv_inotify_register(struct iv_inotify *inotify);
       void iv_inotify_unregister(struct iv_inotify *inotify);

       struct iv_inotify_watch {
               struct iv_inotify       *inotify;
               const char              *pathname;
               uint32_t                mask;
               void                    *cookie;
               void                    (*handler)(void *, struct inotify_event *);
       };

       void IV_INOTIFY_WATCH_INIT(struct iv_inotify_watch *watch);
       int iv_inotify_watch_register(struct iv_inotify_watch *watch);
       int iv_inotify_watch_unregister(struct iv_inotify_watch *watch);

DESCRIPTION

       The iv_inotify_register function registers an iv_inotify instance with  the  iv_inotify(3)  module.   The
       inotify parameter is a pointer to the iv_inotify structure to be registered.

       The iv_inotify_unregister function unregisters an iv_inotify instance from the iv_inotify(3) module.  The
       inotify parameter is a pointer to the iv_inotify structure to be unregistered.

       The iv_inotify_watch_register function adds a watch to the registered iv_inotify  instance  specified  by
       the ->inotify member.

       The  iv_inotify_watch_unregister  function  removes a watch from the iv_inotify instance specified by the
       ->inotify member.

       In the iv_inotify_watch structure used in these functions, the ->pathname and ->mask  members  correspond
       to the members of struct inotify_watch as described in inotify(7).  ->handler is the event handler called
       when this watch triggers.  The arguments to this handler function are the pointer stored in the  ->cookie
       member  of  the  iv_inotify_watch  structure  and a pointer to an inotify_event structure as described in
       inotify(7).

RETURN VALUE

       iv_inotify_register and iv_inotify_watch_register return zero on success.  On error, -1 is returned,  and
       errno is set appropriately.

ERRORS

       iv_inotify will return errors returned by inotify_init(3) and inotify_add_watch(3).

SEE ALSO

       ivykis(3), inotify(7), inotify_init(3), inotify_add_watch(3), inotify_rm_watch(3)