mirror/zig
1
0
Fork 0
mirror of https://github.com/ziglang/zig.git synced 2026-01-20 22:35:24 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add note about mandatory locks on linux

Browse Source
This commit is contained in:
LeRoyce Pearson 2020-03-12 21:19:25 -06:00
parent 43c4faba55
commit 43ccc2d81e
1 changed files with 10 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
lib/std/fs/file.zig
View File

@ -46,8 +46,11 @@ pub const File = struct {
/// the file is opened with a shared lock, allowing the other processes to read from the
/// file, but not to write to the file.
///
/// Note that the lock is only advisory on Linux. This means that a process that does not
/// respect the locking API can still read and write to the file, despite the lock.
/// Note that the lock is only advisory on Linux, except in very specific cirsumstances[1].
/// This means that a process that does not respect the locking API can still read and write
/// to the file, despite the lock.
///
/// [1]: https://www.kernel.org/doc/Documentation/filesystems/mandatory-locking.txt
lock: bool = false,
/// This prevents `O_NONBLOCK` from being passed even if `std.io.is_async`.
@ -71,8 +74,11 @@ pub const File = struct {
/// Prevent other files from accessing this file while this process has it is open.
///
/// Note that the lock is only advisory on Linux. This means that a process that does not
/// respect the locking API can still read and write to the file, despite the lock.
/// Note that the lock is only advisory on Linux, except in very specific cirsumstances[1].
/// This means that a process that does not respect the locking API can still read and write
/// to the file, despite the lock.
///
/// [1]: https://www.kernel.org/doc/Documentation/filesystems/mandatory-locking.txt
lock: bool = false,
/// For POSIX systems this is the file system mode the file will