doc: fs.mkdir('/') throws EPERM on Windows

Fixes: #25110 PR-URL: #25340 Reviewed-By: Rich Trott <[email protected]> Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: Ben Coe <[email protected]>
nodejs · May 16, 2019 · ef6e4f1 · ef6e4f1
1 parent 81cf2b4
commit ef6e4f1
Showing 1 changed file with 9 additions and 0 deletions.
diff --git a/doc/api/fs.md b/doc/api/fs.md
@@ -2207,6 +2207,15 @@ fs.mkdir('/tmp/a/apple', { recursive: true }, (err) => {
 });
 ```
 
+On Windows, using `fs.mkdir()` on the root directory even with recursion will
+result in an error:
+
+```js
+fs.mkdir('/', { recursive: true }, (err) => {
+  // => [Error: EPERM: operation not permitted, mkdir 'C:\']
+});
+```
+
 See also: mkdir(2).
 
 ## fs.mkdirSync(path[, options])