Skip to content

Commit ad35fe9

Browse files
PickBasaduh95
PickBas
authored and
aduh95
committed
src: expose Windows-only fs open flags
Signed-off-by: Kirill Saied <[email protected]> PR-URL: #64775 Reviewed-By: Aviv Keller <[email protected]>
1 parent 8657497 commit ad35fe9

3 files changed

Lines changed: 37 additions & 2 deletions

File tree

‎doc/api/fs.md‎

Lines changed: 27 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8766,10 +8766,36 @@ The following constants are meant for use with `fs.open()`.
87668766
is available on Windows operating systems only. On other operating systems,
87678767
this flag is ignored.</td>
87688768
</tr>
8769+
<tr>
8770+
<td><code>UV_FS_O_TEMPORARY</code></td>
8771+
<td>When set, the file is deleted automatically when the last handle to it
8772+
is closed. This flag is available on Windows operating systems only. On
8773+
other operating systems, this flag is ignored.</td>
8774+
</tr>
8775+
<tr>
8776+
<td><code>UV_FS_O_SHORT_LIVED</code></td>
8777+
<td>Hint that the file is short-lived, so the system avoids flushing it to
8778+
disk when possible. This flag is available on Windows operating systems
8779+
only. On other operating systems, this flag is ignored.</td>
8780+
</tr>
8781+
<tr>
8782+
<td><code>UV_FS_O_SEQUENTIAL</code></td>
8783+
<td>Hint that the file is accessed sequentially from beginning to end, to
8784+
optimize caching. This flag is available on Windows operating systems only.
8785+
On other operating systems, this flag is ignored.</td>
8786+
</tr>
8787+
<tr>
8788+
<td><code>UV_FS_O_RANDOM</code></td>
8789+
<td>Hint that the file is accessed randomly, to optimize caching. This flag
8790+
is available on Windows operating systems only. On other operating systems,
8791+
this flag is ignored.</td>
8792+
</tr>
87698793
</table>
87708794
87718795
On Windows, only `O_APPEND`, `O_CREAT`, `O_EXCL`, `O_RDONLY`, `O_RDWR`,
8772-
`O_TRUNC`, `O_WRONLY`, and `UV_FS_O_FILEMAP` are available.
8796+
`O_TRUNC`, `O_WRONLY`, `UV_FS_O_FILEMAP`, `UV_FS_O_TEMPORARY`,
8797+
`UV_FS_O_SHORT_LIVED`, `UV_FS_O_SEQUENTIAL`, and `UV_FS_O_RANDOM` are
8798+
available.
87738799
87748800
##### File type constants
87758801

‎src/node_constants.cc‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1137,7 +1137,12 @@ void DefineFsConstants(Local<Object> target) {
11371137
NODE_DEFINE_CONSTANT(target, O_EXCL);
11381138
#endif
11391139

1140-
NODE_DEFINE_CONSTANT(target, UV_FS_O_FILEMAP);
1140+
// Windows-only open flags honored by libuv. They are 0 on other platforms.
1141+
NODE_DEFINE_CONSTANT(target, UV_FS_O_FILEMAP);
1142+
NODE_DEFINE_CONSTANT(target, UV_FS_O_TEMPORARY);
1143+
NODE_DEFINE_CONSTANT(target, UV_FS_O_SHORT_LIVED);
1144+
NODE_DEFINE_CONSTANT(target, UV_FS_O_SEQUENTIAL);
1145+
NODE_DEFINE_CONSTANT(target, UV_FS_O_RANDOM);
11411146

11421147
#ifdef O_NOCTTY
11431148
NODE_DEFINE_CONSTANT(target, O_NOCTTY);

‎test/parallel/test-fs-constants.js‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,10 @@ const knownFsConstantNames = [
3535
'O_CREAT',
3636
'O_EXCL',
3737
'UV_FS_O_FILEMAP',
38+
'UV_FS_O_TEMPORARY',
39+
'UV_FS_O_SHORT_LIVED',
40+
'UV_FS_O_SEQUENTIAL',
41+
'UV_FS_O_RANDOM',
3842
'O_NOCTTY',
3943
'O_TRUNC',
4044
'O_APPEND',

0 commit comments

Comments
 (0)