iv_inotify(3)						    ivykis programmer's manual						     iv_inotify(3)

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  ino-
       tify_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)

ivykis								    2009-02-07							     iv_inotify(3)