Skip to content

Commit e4ac393

Browse files
Trottaddaleax
authored andcommitted
doc: clarify O_EXCL text in fs.md
PR-URL: #34096 Reviewed-By: Anna Henningsen <[email protected]> Reviewed-By: Ujjwal Sharma <[email protected]>
1 parent d67cb7e commit e4ac393

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

doc/api/fs.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5655,10 +5655,10 @@ are available from `fs.constants`. On Windows, flags are translated to
56555655
their equivalent ones where applicable, e.g. `O_WRONLY` to `FILE_GENERIC_WRITE`,
56565656
or `O_EXCL|O_CREAT` to `CREATE_NEW`, as accepted by `CreateFileW`.
56575657

5658-
The exclusive flag `'x'` (`O_EXCL` flag in open(2)) ensures that path is newly
5659-
created. On POSIX systems, path is considered to exist even if it is a symlink
5660-
to a non-existent file. The exclusive flag may or may not work with network
5661-
file systems.
5658+
The exclusive flag `'x'` (`O_EXCL` flag in open(2)) causes the operation to
5659+
return an error if the path already exists. On POSIX, if the path is a symbolic
5660+
link, using `O_EXCL` returns an error even if the link is to a path that does
5661+
not exist. The exclusive flag may or may not work with network file systems.
56625662

56635663
On Linux, positional writes don't work when the file is opened in append mode.
56645664
The kernel ignores the position argument and always appends the data to

0 commit comments

Comments
 (0)