From 483d4d578f86c613271829c6fdcc2cb3802100b4 Mon Sep 17 00:00:00 2001
From: Adam Harvey <aharvey@php.net>
Date: Thu, 12 Dec 2013 18:36:18 +0000
Subject: [PATCH] Warn users of the buggy behaviour of sem_get() with non-PHP
 semaphores.

Fixes doc bug #66270 (sem_get() expects an already created pack of semaphores
to have 3 of them).


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@332354 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/sem/functions/sem-get.xml | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/reference/sem/functions/sem-get.xml b/reference/sem/functions/sem-get.xml
index c6888153ae..3745aee112 100644
--- a/reference/sem/functions/sem-get.xml
+++ b/reference/sem/functions/sem-get.xml
@@ -101,6 +101,19 @@
   </para>
  </refsect1>
 
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <warning>
+   <simpara>
+    When using <function>sem_get</function> to access a semaphore created
+    outside PHP, note that the semaphore must have been created as a set of 3
+    semaphores (for example, by specifying 3 as the <literal>nsems</literal>
+    parameter when calling the C <literal>semget()</literal> function),
+    otherwise PHP will be unable to access the semaphore.
+   </simpara>
+  </warning>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>