From f4c4b2b41bcf6c367a43ec6dfeddacfe3e8e86a8 Mon Sep 17 00:00:00 2001 From: James M Snell Date: Fri, 19 Oct 2018 15:25:34 -0700 Subject: [PATCH] doc: document ACL limitation for fs.access on Windows Fixes: https://github.com/nodejs/node/issues/19192 PR-URL: https://github.com/nodejs/node/pull/23772 Reviewed-By: Vse Mozhet Byt Reviewed-By: Sam Roberts Reviewed-By: Luigi Pinca Reviewed-By: Bartosz Sosnowski --- doc/api/fs.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/doc/api/fs.md b/doc/api/fs.md index baf92fa3a20f15..71ef3acc1d184e 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -980,6 +980,11 @@ In general, check for the accessibility of a file only if the file will not be used directly, for example when its accessibility is a signal from another process. +On Windows, access-control policies (ACLs) on a directory may limit access to +a file or directory. The `fs.access()` function, however, does not check the +ACL and therefore may report that a path is accessible even if the ACL restricts +the user from reading or writing to it. + ## fs.accessSync(path[, mode])