Pike Module Reference:

Please have a look at the inotify(7) manpage for information about these constants.

Some constants may not be available when the module has been compiled on a machine with an old kernel (before 2.6.15). See the manpage for more details.

Parses one inotify_event struct from data.

Returns an array consisting of

The watch descriptor returned by add_watch() when the watch for this file was added.

An integer that describes the event that occured. See the inotify manpage for a list of possible events and their numerical identifiers.

An integer cookie that can be used to group together different events that were triggered by moving a file from one location to another.

The name of the file. This will only be present if the event happened to a file in a directory that was watched, e.g. with Public.System.Inotify.IN_CREATE. Otherwise this will be 0.

The length of the data that has been parsed. In case a string contains more than one inotify events, this parse function has to be called again with the rest as an argument.

More convenient interface to inotify(7). Automatically reads events from the inotify file descriptor and parses them.

Add a watch for a certain file and a set of events specified by mask. The function callback will be called when such an event occurs. The arguments to the callback will be the events mask, the cookie, the filename and extra.

Returns a watch descriptor which can be used to remove the watch.

When adding a second watch for the same file the old one will be removed unless Public.System.Inotify.IN_MASK_ADD is contained in mask.

The mask of an event may be a subset of the mask given when adding the watch.

In case the watch is added for a regular file, the filename will be passed to the callback. In case the watch is added for a directory, the name of the file to which the event happened inside the directory will be concatenated.

Remove the watch associated with the watch descriptor wd.

Simple wrapper class that gives direct access to the inotify(7) interface. On create an inotify instance is initiated by calling inotify_init(2). Every object of this class has its own inotify file descriptor. Use this class only if you want direct access to the file descriptor to read from it manually. For a more user-friendly inferface use Public.System.Inotify.Instance.

Add a watch for a certain file/dir and certain events. Adding more than one watch for a file will overwrite the previous watch unless Public.System.Inotify.IN_MASK_ADD is ORed to the mask.

Name of the file that should be watched. Can be either a directory or a file.

Integer mask specifying the event. This can be a combination of different event types combined using bitwise OR. See the inotify manpage for possible values and their description. The values defined by the inotify header file are exported by Public.System.Inotify as constants using the same names (e.g. Public.System.Inotify.IN_CREATE).

Subdirectories are not watched. If you want to watch subdirectories aswell, its necessary to add watches for them individually.

Returns the file descriptor that is associated to the inotify instance.

Remove a watch.

The watch descriptor that was returned by add_watch().