From 326303276c3db4e013e805b389913b353bc56ae0 Mon Sep 17 00:00:00 2001 From: Kalle Sommer Nielsen Date: Wed, 13 Jan 2010 02:50:20 +0000 Subject: [PATCH] Fixed bug #50218 (flock() has numerous documentation errors) git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@293481 c90b9560-bf6c-de11-be94-00142212c4b1 --- reference/filesystem/functions/flock.xml | 47 ++++++++++++++++++------ 1 file changed, 36 insertions(+), 11 deletions(-) diff --git a/reference/filesystem/functions/flock.xml b/reference/filesystem/functions/flock.xml index 2236e41d9c..5bf0159dc3 100644 --- a/reference/filesystem/functions/flock.xml +++ b/reference/filesystem/functions/flock.xml @@ -28,7 +28,7 @@ (which means all accessing programs have to use the same way of locking or it will not work). By default, this function will block until the requested lock is acquired; this may be controlled (on non-Windows - platforms) with the LOCK_NB option documented below. + platforms) with the LOCK_NB option documented below. @@ -68,9 +68,9 @@ - It is also possible to add LOCK_NB if you don't - want flock to block while locking. - (not supported on Windows) + It is also possible to add LOCK_NB as a bitmask to one + of the above operations if you don't want flock to + block while locking. (not supported on Windows) @@ -79,7 +79,7 @@ The optional third argument is set to &true; if the lock would block - (EWOULDBLOCK errno condition). + (EWOULDBLOCK errno condition). (not supported on Windows) @@ -142,6 +142,28 @@ if (flock($fp, LOCK_EX)) { // do an exclusive lock fclose($fp); +?> +]]> + + + + + + <function>flock</function> using the <constant>LOCK_NB</constant> option + + ]]> @@ -153,7 +175,8 @@ fclose($fp); &reftitle.notes; - flock locks mandatory under Windows. + flock locks mandatory under Windows aswell as some + POSIX based operating systems. @@ -164,6 +187,13 @@ fclose($fp); fopen). + + + POSIX.1 compatible systems will release the scripts flock's + on a file, if the scripts uses fclose on any file handle + on that file. + + Assigning other value to handle argument in the @@ -171,11 +201,6 @@ fclose($fp); - - flock will not work on NFS and many other networked - file systems. Check your operating system documentation for more - details. - On some operating systems flock is implemented at the process level. When using a multithreaded server API like ISAPI you