Skip to content

Commit 4bf2d1f

Browse files
Pratik32nathany
authored andcommitted
Updating the FAQ section for supportability with NFS & FUSE filesystems.
closes fsnotify#312 fsnotify#306
1 parent dc27d96 commit 4bf2d1f

File tree

1 file changed

+11
-7
lines changed

1 file changed

+11
-7
lines changed

README.md

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -10,16 +10,16 @@ go get -u golang.org/x/sys/...
1010

1111
Cross platform: Windows, Linux, BSD and macOS.
1212

13-
| Adapter | OS | Status |
14-
| --------------------- | -------------------------------- | --------------------------------------------------------- |
13+
| Adapter | OS | Status |
14+
| --------------------- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
1515
| inotify | Linux 2.6.27 or later, Android\* | Supported [![Build Status](https://travis-ci.org/fsnotify/fsnotify.svg?branch=master)](https://travis-ci.org/fsnotify/fsnotify) |
1616
| kqueue | BSD, macOS, iOS\* | Supported [![Build Status](https://travis-ci.org/fsnotify/fsnotify.svg?branch=master)](https://travis-ci.org/fsnotify/fsnotify) |
1717
| ReadDirectoryChangesW | Windows | Supported [![Build Status](https://travis-ci.org/fsnotify/fsnotify.svg?branch=master)](https://travis-ci.org/fsnotify/fsnotify) |
18-
| FSEvents | macOS | [Planned](https://github.com/fsnotify/fsnotify/issues/11) |
19-
| FEN | Solaris 11 | [In Progress](https://github.com/fsnotify/fsnotify/issues/12) |
20-
| fanotify | Linux 2.6.37+ | [Planned](https://github.com/fsnotify/fsnotify/issues/114) |
21-
| USN Journals | Windows | [Maybe](https://github.com/fsnotify/fsnotify/issues/53) |
22-
| Polling | *All* | [Maybe](https://github.com/fsnotify/fsnotify/issues/9) |
18+
| FSEvents | macOS | [Planned](https://github.com/fsnotify/fsnotify/issues/11) |
19+
| FEN | Solaris 11 | [In Progress](https://github.com/fsnotify/fsnotify/issues/12) |
20+
| fanotify | Linux 2.6.37+ | [Planned](https://github.com/fsnotify/fsnotify/issues/114) |
21+
| USN Journals | Windows | [Maybe](https://github.com/fsnotify/fsnotify/issues/53) |
22+
| Polling | *All* | [Maybe](https://github.com/fsnotify/fsnotify/issues/9) |
2323

2424
\* Android and iOS are untested.
2525

@@ -65,6 +65,10 @@ There are OS-specific limits as to how many watches can be created:
6565
* Linux: /proc/sys/fs/inotify/max_user_watches contains the limit, reaching this limit results in a "no space left on device" error.
6666
* BSD / OSX: sysctl variables "kern.maxfiles" and "kern.maxfilesperproc", reaching these limits results in a "too many open files" error.
6767

68+
**Why don't notifications work with NFS filesystems or filesystem in userspace (FUSE)?**
69+
70+
fsnotify requires support from underlying OS to work. The current NFS protocol does not provide network level support for file notifications.
71+
6872
[#62]: https://github.com/howeyc/fsnotify/issues/62
6973
[#18]: https://github.com/fsnotify/fsnotify/issues/18
7074
[#11]: https://github.com/fsnotify/fsnotify/issues/11

0 commit comments

Comments
 (0)