aboutsummaryrefslogtreecommitdiff
path: root/lib/libc/sys/flock.2
diff options
context:
space:
mode:
Diffstat (limited to 'lib/libc/sys/flock.2')
-rw-r--r--lib/libc/sys/flock.223
1 files changed, 22 insertions, 1 deletions
diff --git a/lib/libc/sys/flock.2 b/lib/libc/sys/flock.2
index 3cfc7cc423c2..1d095bdf3eba 100644
--- a/lib/libc/sys/flock.2
+++ b/lib/libc/sys/flock.2
@@ -112,6 +112,25 @@ references to a single lock. If a process holding a lock on a file
forks and the child explicitly unlocks the file, the parent will
lose its lock.
.Pp
+The
+.Fn flock ,
+.Xr fcntl 2 ,
+and
+.Xr lockf 3
+locks are compatible.
+Processes using different locking interfaces can cooperate
+over the same file safely.
+However, only one of such interfaces should be used within
+the same process.
+If a file is locked by a process through
+.Fn flock ,
+any record within the file will be seen as locked
+from the viewpoint of another process using
+.Xr fcntl 2
+or
+.Xr lockf 3 ,
+and vice versa.
+.Pp
Processes blocked awaiting a lock may be awakened by signals.
.Sh RETURN VALUES
.Rv -std flock
@@ -141,8 +160,10 @@ refers to an object that does not support file locking.
.Xr close 2 ,
.Xr dup 2 ,
.Xr execve 2 ,
+.Xr fcntl 2 ,
.Xr fork 2 ,
-.Xr open 2
+.Xr open 2 ,
+.Xr lockf 3
.Sh HISTORY
The
.Fn flock