diff options
| author | James M Snell <jasnell@gmail.com> | 2018-10-20 01:25:34 +0300 |
|---|---|---|
| committer | Rod Vagg <rod@vagg.org> | 2018-11-28 03:26:47 +0300 |
| commit | 0ff88a3510aeb07c0a5ae81360b55337423275fc (patch) | |
| tree | 1403106ac1ace02fcadff85113293cf8018d7aa7 /doc | |
| parent | 32ae851710a30f740aed0522b45fdd9d872c8db6 (diff) | |
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 <vsemozhetbyt@gmail.com>
Reviewed-By: Sam Roberts <vieuxtech@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Bartosz Sosnowski <bartosz@janeasystems.com>
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/api/fs.md | 5 |
1 files changed, 5 insertions, 0 deletions
diff --git a/doc/api/fs.md b/doc/api/fs.md index 2f15aeeb73c..c0b28fc5073 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -565,6 +565,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 |