Skip to content

Commit

Permalink
doc: document ACL limitation for fs.access on Windows
Browse files Browse the repository at this point in the history
Fixes: #19192

PR-URL: #23772
Reviewed-By: Vse Mozhet Byt <vsemozhetbyt@gmail.com>
Reviewed-By: Sam Roberts <vieuxtech@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Bartosz Sosnowski <bartosz@janeasystems.com>
  • Loading branch information
jasnell authored and rvagg committed Nov 28, 2018
1 parent a3362a7 commit 47f87c5
Showing 1 changed file with 5 additions and 0 deletions.
5 changes: 5 additions & 0 deletions doc/api/fs.md
Original file line number Diff line number Diff line change
@@ -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])
<!-- YAML
added: v0.11.15

0 comments on commit 47f87c5

Please sign in to comment.