Skip to content

Commit f4c4b2b

Browse files
jasnelltargos
authored andcommitted
doc: document ACL limitation for fs.access on Windows
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>
1 parent 83b776c commit f4c4b2b

File tree

1 file changed

+5
-0
lines changed

1 file changed

+5
-0
lines changed

doc/api/fs.md

+5
Original file line numberDiff line numberDiff line change
@@ -980,6 +980,11 @@ In general, check for the accessibility of a file only if the file will not be
980980
used directly, for example when its accessibility is a signal from another
981981
process.
982982

983+
On Windows, access-control policies (ACLs) on a directory may limit access to
984+
a file or directory. The `fs.access()` function, however, does not check the
985+
ACL and therefore may report that a path is accessible even if the ACL restricts
986+
the user from reading or writing to it.
987+
983988
## fs.accessSync(path[, mode])
984989
<!-- YAML
985990
added: v0.11.15

0 commit comments

Comments
 (0)