posix_getgrnam
(PHP 4, PHP 5, PHP 7)
posix_getgrnam — Возвращает информацию о группе, используя её имя
Описание
posix_getgrnam
( string
$name
) : array|falseВозвращает информацию о группе, используя её имя.
Список параметров
-
name
-
Имя группы
Возвращаемые значения
Возвращает массив (array) при успешном выполнении, или false
в случае возникновения ошибки.
Возвращаемый массив имеет следующие элементы:
Элемент | Описание |
---|---|
name |
Элемент name содержит имя группы. Это короткий, обычно
менее 16 символов "дескриптор" группы, не являющийся действительным
полным именем группы. Он должен соответствовать name
параметру, используемому в данной функции. Элемент является избыточным.
|
passwd | Элемент passwd содержит пароль группы в зашифрованном виде. Часто, например в системах, использующих "shadow" файлы для хранения информации о паролях, это поле содержит звёздочку. |
gid | Идентификатор группы, состоящий из цифр. |
members | Этот элемент состоит из array, содержащего string. Значениями данного массива являются имена членов данной группы. |
Примеры
Пример #1 Пример использования posix_getgrnam()
<?php
$groupinfo = posix_getgrnam("toons");
print_r($groupinfo);
?>
Результатом выполнения данного примера будет что-то подобное:
Array ( [name] => toons [passwd] => x [members] => Array ( [0] => tom [1] => jerry ) [gid] => 42 )
Смотрите также
- posix_getegid() - Возвращает эффективный идентификатор группы текущего процесса EGID
- posix_getgrgid() - Возвращает информацию о группе по её ID
- filegroup() - Получает идентификатор группы файла
- stat() - Возвращает информацию о файле
- POSIX руководство GETGRNAM(3)