From ae0f68d6e150cbfe18d34b5345c27099df1e7b8b Mon Sep 17 00:00:00 2001 From: Robert Jefe Lindstaedt Date: Tue, 17 May 2016 15:10:25 +0200 Subject: [PATCH] doc: add note for fs.watch virtualized env Fixes: https://github.com/nodejs/node/issues/6765 PR-URL: https://github.com/nodejs/node/pull/6809 Reviewed-By: Ben Noordhuis Reviewed-By: James M Snell Reviewed-By: Colin Ihrig Reviewed-By: Sakthipriyan Vairamani Reviewed-By: Michael Dawson --- doc/api/fs.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/doc/api/fs.md b/doc/api/fs.md index a849cd3d5b7..e369d925e7c 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -1469,9 +1469,10 @@ to be notified of filesystem changes. * On Windows systems, this feature depends on `ReadDirectoryChangesW`. If the underlying functionality is not available for some reason, then -`fs.watch` will not be able to function. For example, watching files or -directories on network file systems (NFS, SMB, etc.) often doesn't work -reliably or at all. +`fs.watch` will not be able to function. For example, watching files or +directories can be unreliable, and in some cases impossible, on network file +systems (NFS, SMB, etc), or host file systems when using virtualization software +such as Vagrant, Docker, etc. You can still use `fs.watchFile`, which uses stat polling, but it is slower and less reliable.