inotify_rm_watch()

Updated: April 19, 2023

Remove the watch associated with the given watch descriptor

Synopsis:

#include <sys/inotify.h>

int inotify_rm_watch( int fd,
                      int32_t wd );

Arguments:

fd
A valid file descriptor returned by inotify_init().
wd
A valid watch description returned by inotify_add_watch().

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The inotify_rm_watch() function removes a watch that you earlier set to watch for filesystem events. For you to use this function, the filesystem event manager (fsevmgr) manager needs to be running.

For an overview of inotify, see http://www.linuxjournal.com/article/8478?page=0,0 in the Linux Journal, but note that there are differences between the Linux and QNX Neutrino implementations. Currently, only io-blk.so-based filesystems support inotify.

Returns:

0 on success, or -1 if an error occurred (errno is set).

Classification:

Linux

Safety:  
Cancellation point No
Interrupt handler No
Signal handler No
Thread Yes