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)