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.