posix_getgrgid
(PHP 4, PHP 5)
posix_getgrgid — Return info about a group by group id
Описание
array posix_getgrgid
( int $gid
)
Gets information about a group provided its id.
Список параметров
- gid
-
The group id.
Возвращаемые значения
The array elements returned are:
| Element | Description |
|---|---|
| name | The name element contains the name of the group. This is a short, usually less than 16 character "handle" of the group, not the real, full name. |
| passwd | The passwd element contains the group's password in an encrypted format. Often, for example on a system employing "shadow" passwords, an asterisk is returned instead. |
| gid | Group ID, should be the same as the gid parameter used when calling the function, and hence redundant. |
| members | This consists of an array of string's for all the members in the group. |
Список изменений
| Версия | Описание |
|---|---|
| 4.2.0 | Prior to this version, members was simply an integer representing the number of members in the group, and the member names were returned with numerical indices. |
Примеры
Пример #1 Example use of posix_getgrgid()
<?php
$groupid = posix_getegid();
$groupinfo = posix_getgrgid($groupid);
print_r($groupinfo);
?>
Результатом выполнения данного примера будет что-то подобное:
Array ( [name] => toons [passwd] => x [members] => Array ( [0] => tom [1] => jerry ) [gid] => 42 )
Смотрите также
- posix_getegid()
- posix_getgrnam()
- filegroup()
- stat()
- safe_mode_gid
- POSIX man page GETGRNAM(3)
- PHP Руководство
- Функции по категориям
- Индекс функций
- Справочник функций
- Расширения для управления процессами программ
- POSIX
- posix_access
- posix_ctermid
- posix_errno
- posix_get_last_error
- posix_getcwd
- posix_getegid
- posix_geteuid
- posix_getgid
- posix_getgrgid
- posix_getgrnam
- posix_getgroups
- posix_getlogin
- posix_getpgid
- posix_getpgrp
- posix_getpid
- posix_getppid
- posix_getpwnam
- posix_getpwuid
- posix_getrlimit
- posix_getsid
- posix_getuid
- posix_initgroups
- posix_isatty
- posix_kill
- posix_mkfifo
- posix_mknod
- posix_setegid
- posix_seteuid
- posix_setgid
- posix_setpgid
- posix_setrlimit
- posix_setsid
- posix_setuid
- posix_strerror
- posix_times
- posix_ttyname
- posix_uname
Коментарии
Returns an array containing the elements of the group structure. The array has both numeric indices, each of which is a string naming one member of the group, and named string indices. The array elements are:
$_["name"] string groupname (users)
$_["gid"] integer gidnumber (e.g. 0 for wheel/root)
$_["members"] int number of users in group
$_[0]..$_[n] string usernames in the group
okies...
This code should be considered as an OPTION only, it works under MY set of circumstances, and that is all I intended. The below funtion will return the NAME of the GROUP if provided with the Group ID#
function RC_posix_getgrgid($gid)
{
$LocationGroup = "/etc/group"; //EDIT THIS IF YOU HAVE A DIFFERENT OS. mine = debian
$fp = fopen ("/etc/group","r");
while ($groupinfo = fscanf ($fp, "%[a-zA-Z0-9]:x:%[0-9]:%[a-zA-Z0-9]\n"))
{
list ($name, $groupID, $nfi) = $groupinfo;
if ($groupID == $gid)
{
$returnval = $name;
}
}
fclose($fp);
if($returnval) { return $returnval; } else { return 0; }
}
in php-4.3 the array returned seems to have changed.
it now returns:
["name"] group name
["passwd"] group password
["members"] group members (array of usernames)
["gid"] numeric group id
When posix_getgrgid() fails (e.g. an invalid/unknown group id), it returns false.This is except for Mac OSX on which you get an array with name "nogroup" and gid of "-1".