inotify_init()

Updated: April 19, 2023

Initialize the inode notify system

Synopsis:

#include <sys/inotify.h>

int inotify_init( void );

Library:

libc

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

Description:

The inotify_init() function initializes the inode notify system that you can use to watch for filesystem events.

Note: This function opens the file /dev/fsnotify, which the filesystem event manager (fsevmgr) creates and owns. If your process doesn't have read permission for this path or fsevmgr is not running, the function fails.

The basic steps for using the inotify system are as follows:

While the QNX Neutrino inotify implementation follows the same semantics as the Linux implementation, the behavior differs from Linux due to the kernel and filesystem models employed. For an overview of inotify, see http://www.linuxjournal.com/article/8478?page=0,0 in the Linux Journal. Currently, only io-blk.so-based filesystems support inotify.

Returns:

A file descriptor for the inotify mailbox, or -1 if an error occurred (errno is set).

Classification:

Linux

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