Crate inotify[][src]

Expand description

Idiomatic inotify wrapper for the Rust programming language


inotify-rs is an idiomatic wrapper around the Linux kernel’s inotify API for the Rust programming language. It can be used for monitoring changes to files or directories.

The Inotify struct is the main entry point into the API.


use inotify::{

let mut inotify = Inotify::init()
    .expect("Error while initializing inotify instance");

// Watch for modify and close events.
        WatchMask::MODIFY | WatchMask::CLOSE,
    .expect("Failed to add file watch");

// Read events that were added with `add_watch` above.
let mut buffer = [0; 1024];
let events = inotify.read_events_blocking(&mut buffer)
    .expect("Error while reading events");

for event in events {
    // Handle event

Attention: inotify gotchas

inotify (as in, the Linux API, not this wrapper) has many edge cases, making it hard to use correctly. This can lead to weird and hard to find bugs in applications that are based on it. inotify-rs does its best to fix these issues, but sometimes this would require an amount of runtime overhead that is just unacceptable for a low-level wrapper such as this.

We’ve documented any issues that inotify-rs has inherited from inotify, as far as we are aware of them. Please watch out for any further warnings throughout this documentation. If you want to be on the safe side, in case we have missed something, please read the inotify man pages carefully.


An inotify event

Indicates the type of an event

Stream of inotify events

Iterator over inotify events

Idiomatic Rust wrapper around Linux’s inotify API

Represents a watch on an inode

Describes a file system watch


Get the inotify event buffer size for an absolute path

Get the inotify event buffer size

Type Definitions

An owned version of Event