inotify_rm_watch — remove an existing watch from an inotify instance

Synopsis

#include <sys/inotify.h>

int inotify_rm_watch(int fd, int wd);

Description

inotify_rm_watch() removes the watch associated with the watch descriptor wd from the inotify instance associated with the file descriptor fd.

Removing a watch causes an IN_IGNORED event to be generated for this watch descriptor. (See inotify(7).)

Return Value

On success, inotify_rm_watch() returns zero. On error, -1 is returned and errno is set to indicate the cause of the error.

Errors

EBADF

fd is not a valid file descriptor.

EINVAL

The watch descriptor wd is not valid; or fd is not an inotify file descriptor.

Versions

Inotify was merged into the 2.6.13 Linux kernel.

Conforming to

This system call is Linux-specific.

See Also

inotify_add_watch(2), inotify_init(2), inotify(7)

Colophon

This page is part of release 5.04 of the Linux man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at https://www.kernel.org/doc/man-pages/.

Referenced By

inotify(7), inotify_add_watch(2), inotify_init(2), syscalls(2).

2017-09-15 Linux Programmer's Manual