-
Notifications
You must be signed in to change notification settings - Fork 73
/
posix-getgrgid.xml
157 lines (149 loc) · 4.51 KB
/
posix-getgrgid.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 265acc36ee4a1f4553a52030bf1717521c24dfb4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.posix-getgrgid" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>posix_getgrgid</refname>
<refpurpose>Возвращает информацию о группе по её ID</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>array</type><type>false</type></type><methodname>posix_getgrgid</methodname>
<methodparam><type>int</type><parameter>group_id</parameter></methodparam>
</methodsynopsis>
<para>
Возвращает информацию о группе, используя её ID.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>group_id</parameter></term>
<listitem>
<para>
Идентификатор группы.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Массив со следующими элементами:
<table>
<title>Массив с информацией о группе</title>
<tgroup cols="2">
<thead>
<row>
<entry>Элемент</entry>
<entry>Описание</entry>
</row>
</thead>
<tbody>
<row>
<entry>name</entry>
<entry>
Элемент name содержит имя группы. Это короткий, обычно
менее 16 символов "дескриптор" группы, не являющийся
полным именем группы.
</entry>
</row>
<row>
<entry>passwd</entry>
<entry>
Элемент passwd содержит пароль группы в зашифрованном виде.
Часто, например в системах, использующих "shadow" файлы для хранения информации о паролях,
это поле содержит строку из звёздочек.
</entry>
</row>
<row>
<entry>gid</entry>
<entry>
Элемент содержит ID группы и должен соответствовать <parameter>group_id</parameter> параметру, используемому
при вызове функции. Данный элемент является избыточным.
</entry>
</row>
<row>
<entry>members</entry>
<entry>
Этот элемент состоит из <type>array</type>, содержащего <type>string</type>.
Значениями данного массива являются имена членов данной группы.
</entry>
</row>
</tbody>
</tgroup>
</table>
Функция возвращает &false; в случае возникновения ошибки.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Пример использования <function>posix_getgrgid</function></title>
<programlisting role="php">
<![CDATA[
<?php
$groupid = posix_getegid();
$groupinfo = posix_getgrgid($groupid);
print_r($groupinfo);
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
Array
(
[name] => toons
[passwd] => x
[members] => Array
(
[0] => tom
[1] => jerry
)
[gid] => 42
)
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>posix_getegid</function></member>
<member><function>posix_getgrnam</function></member>
<member><function>filegroup</function></member>
<member><function>stat</function></member>
<member>POSIX руководство GETGRNAM(3)</member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->