INOTIFY_ADD_WATCH(2)

NAME
inotify_add_watch - add a watch to an initialized inotify instance

SYNOPSIS
#include <inotify.h>

int inotify_add_watch(int fd, const char * path, __u32 mask);

DESCRIPTION
inotify_add_watch adds a watch on the file at pathname path to the inotify instance mapped by the file descriptor fd with the event mask given by the bitmask mask.

RETURN VALUE
On success, inotify_add_watch returns a new file descriptor, or negative one if an error occurred (in which case, errno is set appropriately).

ERRORS

EBADF
    The given file descriptor is not valid.

EINVAL
    The given event mask contains no legal events.

ENOMEM
    Insufficient kernel memory was available.

ENOSPC
    The user limit on the total number of inotify watches was reached or the kernel failed to allocate a needed resource. EACCESS Read access to the given file is not permitted. EFAULT path points outside of the process's accessible address space.

HISTORY
Inotify was merged into the 2.6.13 Linux kernel.

SEE ALSO
inotify_init(2), inotify_rm_watch(2),and read(2).