Repository files navigation

fsnotify utilizesgolang.org/x/sys rather thansyscall from the standard library. Ensure you have the latest version installed by running:

go get -u golang.org/x/sys/...

Cross platform: Windows, Linux, BSD and macOS.

Adapter	OS	Status
inotify	Linux 2.6.27 or later, Android*	Supported
kqueue	BSD, macOS, iOS*	Supported
ReadDirectoryChangesW	Windows	Supported
FSEvents	macOS	Planned
FEN	Solaris 11	In Progress
fanotify	Linux 2.6.37+
USN Journals	Windows	Maybe
Polling	All	Maybe

* Android and iOS are untested.

Please seethe documentation and consult theFAQ for usage information.

fsnotify is a fork ofhoweyc/fsnotify with a new API as of v1.0. The API is based onthis design document.

Allreleases are tagged based onSemantic Versioning. Further API changes areplanned, and will be tagged with a new major revision number.

Go 1.6 supports dependencies located in thevendor/ folder. Unless you are creating a library, it is recommended that you copy fsnotify intovendor/github.com/fsnotify/fsnotify within your project, and likewise forgolang.org/x/sys.

Please refer toCONTRIBUTING before opening an issue or pull request.

Seeexample_test.go.

When a file is moved to another directory is it still being watched?

No (it shouldn't be, unless you are watching where it was moved to).

When I watch a directory, are all subdirectories watched as well?

No, you must add watches for any directory you want to watch (a recursive watcher is on the roadmap#18).

Do I have to watch the Error and Event channels in a separate goroutine?

As of now, yes. Looking into making this single-thread friendly (seehoweyc #7)

Why am I receiving multiple events for the same file on OS X?

Spotlight indexing on OS X can result in multiple events (seehoweyc #62). A temporary workaround is to add your folder(s) to theSpotlight Privacy settings until we have a native FSEvents implementation (see#11).

How many files can be watched at once?

There are OS-specific limits as to how many watches can be created:

• Linux: /proc/sys/fs/inotify/max_user_watches contains the limit, reaching this limit results in a "no space left on device" error.
• BSD / OSX: sysctl variables "kern.maxfiles" and "kern.maxfilesperproc", reaching these limits results in a "too many open files" error.

• notify
• fsevents