reference/sem/functions/sem-get.xml
105769eb557af47e5f2d0bea47457827114942fa
105769eb557af47e5f2d0bea47457827114942fa
...
...
@@ -1,6 +1,6 @@
1
1
<?xml version="1.0" encoding="utf-8"?>
2
2
<!-- $Revision$ -->
3
-
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.sem-get">
3
+
<refentry xml:id="function.sem-get" xmlns="http://docbook.org/ns/docbook">
4
4
<refnamediv>
5
5
<refname>sem_get</refname>
6
6
<refpurpose>Get a semaphore id</refpurpose>
...
...
@@ -9,11 +9,11 @@
9
9
<refsect1 role="description">
10
10
&reftitle.description;
11
11
<methodsynopsis>
12
-
<type>resource</type><methodname>sem_get</methodname>
12
+
<type class="union"><type>SysvSemaphore</type><type>false</type></type><methodname>sem_get</methodname>
13
13
<methodparam><type>int</type><parameter>key</parameter></methodparam>
14
14
<methodparam choice="opt"><type>int</type><parameter>max_acquire</parameter><initializer>1</initializer></methodparam>
15
-
<methodparam choice="opt"><type>int</type><parameter>perm</parameter><initializer>0666</initializer></methodparam>
16
-
<methodparam choice="opt"><type>int</type><parameter>auto_release</parameter><initializer>1</initializer></methodparam>
15
+
<methodparam choice="opt"><type>int</type><parameter>permissions</parameter><initializer>0666</initializer></methodparam>
16
+
<methodparam choice="opt"><type>bool</type><parameter>auto_release</parameter><initializer>&true;</initializer></methodparam>
17
17
</methodsynopsis>
18
18
<para>
19
19
<function>sem_get</function> returns an id that can be used to
...
...
@@ -24,6 +24,10 @@
24
24
will return a different semaphore identifier, but both
25
25
identifiers access the same underlying semaphore.
26
26
</para>
27
+
<para>
28
+
If <parameter>key</parameter> is <literal>0</literal>, a new private semaphore
29
+
is created for each call to <function>sem_get</function>.
30
+
</para>
27
31
</refsect1>
28
32
29
33
<refsect1 role="parameters">
...
...
@@ -47,7 +51,7 @@
47
51
</listitem>
48
52
</varlistentry>
49
53
<varlistentry>
50
-
<term><parameter>perm</parameter></term>
54
+
<term><parameter>permissions</parameter></term>
51
55
<listitem>
52
56
<para>
53
57
The semaphore permissions. Actually this value is
...
...
@@ -77,6 +81,38 @@
77
81
</para>
78
82
</refsect1>
79
83
84
+
<refsect1 role="changelog">
85
+
&reftitle.changelog;
86
+
<para>
87
+
<informaltable>
88
+
<tgroup cols="2">
89
+
<thead>
90
+
<row>
91
+
<entry>&Version;</entry>
92
+
<entry>&Description;</entry>
93
+
</row>
94
+
</thead>
95
+
<tbody>
96
+
<row>
97
+
<entry>8.0.0</entry>
98
+
<entry>
99
+
On success, this function returns a <classname>SysvSemaphore</classname> instance now;
100
+
previously, a <type>resource</type> was returned.
101
+
</entry>
102
+
</row>
103
+
<row>
104
+
<entry>8.0.0</entry>
105
+
<entry>
106
+
The type of <parameter>auto_release</parameter> has been changed from
107
+
<type>int</type> to <type>bool</type>.
108
+
</entry>
109
+
</row>
110
+
</tbody>
111
+
</tgroup>
112
+
</informaltable>
113
+
</para>
114
+
</refsect1>
115
+
80
116
<refsect1 role="notes">
81
117
&reftitle.notes;
82
118
<warning>
...
...
@@ -102,7 +138,6 @@
102
138
</refsect1>
103
139
104
140
</refentry>
105
-
106
141
<!-- Keep this comment at the end of the file
107
142
Local variables:
108
143
mode: sgml
109
144