1 INOTIFY_RM_WATCH(3C)     Standard C Library Functions     INOTIFY_RM_WATCH(3C)
   2 
   3 
   4 
   5 NAME
   6        inotify_rm_watch - remove a watch from an inotify instance
   7 
   8 SYNOPSIS
   9        #include <sys/inotify.h>
  10 
  11        int inotify_rm_watch(int fd, int wd);
  12 
  13 
  14 DESCRIPTION
  15        The inotify_rm_watch() function removes the watch specified by wd from
  16        the inotify instance associated with fd.  Removing a watch will induce
  17        an IN_IGNORED event; see inotify(5) for details.
  18 
  19 
  20 RETURN VALUES
  21        Upon succesful completion, inotify_add_watch() returns the watch
  22        descriptor associated with the new watch.  If an error occurs, -1 is
  23        returned and errno is set to indicate the error.
  24 
  25 
  26 ERRORS
  27        inotify_rm_watch() will fail if:
  28 
  29        EBADF
  30                  The fd argument is not a valid open file descriptor.
  31 
  32 
  33        EINVAL
  34                  The fd argument does not correspond to an inotify(5) instance
  35                  as initialized with inotify_init(3C) or inotify_init1(3C), or
  36                  wd is not a valid watch for the specified inotify instance.
  37 
  38 
  39 
  40 NOTES
  41        While the inotify(5) facility is implemented for purposes of offering
  42        compatibility for Linux-borne applications, native applications may opt
  43        to use it instead of (or in addition to) the PORT_SOURCE_FILE
  44        capability of event ports.  See inotify(5) for details and
  45        restrictions.
  46 
  47 
  48 SEE ALSO
  49        inotify_init(3C), inotify_init1(3C), port_create(3C),
  50        port_associate(3C), port_get(3C), inotify(5)
  51 
  52 
  53 
  54                               September 17, 2014          INOTIFY_RM_WATCH(3C)