Loading...
--- Libc/Libc-1725.40.4/stdio/FreeBSD/flockfile.3
+++ Libc/Libc-320/stdio/FreeBSD/flockfile.3
@@ -37,22 +37,21 @@
.Sh SYNOPSIS
.In stdio.h
.Ft void
-.Fn flockfile "FILE *file"
+.Fn flockfile "FILE *stream"
.Ft int
-.Fn ftrylockfile "FILE *file"
+.Fn ftrylockfile "FILE *stream"
.Ft void
-.Fn funlockfile "FILE *file"
+.Fn funlockfile "FILE *stream"
.Sh DESCRIPTION
-These functions provide explicit application-level locking
-of stdio FILE objects.
+These functions provide explicit application-level locking of stdio streams.
They can be used to avoid output from multiple threads being interspersed,
input being dispersed among multiple readers, and to avoid the overhead
-of locking the object for each operation.
+of locking the stream for each operation.
.Pp
The
.Fn flockfile
-function acquires an exclusive lock on the specified object.
-If another thread has already locked the object,
+function acquires an exclusive lock on the specified stream.
+If another thread has already locked the stream,
.Fn flockfile
will block until the lock is released.
.Pp
@@ -66,19 +65,19 @@
.Pp
The
.Fn funlockfile
-function releases the lock on an object acquired by an earlier call to
+function releases the lock on a stream acquired by an earlier call to
.Fn flockfile
or
.Fn ftrylockfile .
.Pp
These functions behave as if there is a lock count associated
-with each object.
+with each stream.
Each time
.Fn flockfile
-is called on the object, the count is incremented,
+is called on the stream, the count is incremented,
and each time
.Fn funlockfile
-is called on the object, the count is decremented.
+is called on the stream, the count is decremented.
The lock is only actually released when the count reaches zero.
.Sh RETURN VALUES
The
@@ -90,7 +89,7 @@
The
.Fn ftrylockfile
function
-returns zero if the object was successfully locked,
+returns zero if the stream was successfully locked,
non-zero otherwise.
.Sh SEE ALSO
.Xr getc_unlocked 3 ,
@@ -98,7 +97,7 @@
.Sh STANDARDS
The
.Fn flockfile ,
-.Fn ftrylockfile ,
+.Fn ftrylockfile
and
.Fn funlockfile
functions conform to