INOTIFY_RM_WATCH(3C) Standard C Library Functions INOTIFY_RM_WATCH(3C)

NAME

inotify_rm_watch - remove a watch from an inotify instance

SYNOPSIS


#include <sys/inotify.h>

int inotify_rm_watch(int fd, int wd);
 

DESCRIPTION

The inotify_rm_watch() function removes the watch specified by wd from the inotify instance associated with fd. Removing a watch will induce an IN_IGNORED event; see inotify(5) for details.
 

RETURN VALUES

Upon succesful completion, inotify_add_watch() returns the watch descriptor associated with the new watch. If an error occurs, -1 is returned and errno is set to indicate the error.
 

ERRORS

inotify_rm_watch() will fail if:
 
EBADF
The fd argument is not a valid open file descriptor.
 
 
EINVAL
The fd argument does not correspond to an inotify(5) instance as initialized with inotify_init(3C) or inotify_init1(3C), or wd is not a valid watch for the specified inotify instance.
 
 

NOTES

 
While the inotify(5) facility is implemented for purposes of offering compatibility for Linux-borne applications, native applications may opt to use it instead of (or in addition to) the PORT_SOURCE_FILE capability of event ports. See inotify(5) for details and restrictions.
 

SEE ALSO

inotify_init(3C), inotify_init1(3C), port_create(3C), port_associate(3C), port_get(3C), inotify(5)
September 17, 2014