POSIX_GETGRNAM(3) 1 POSIX_GETGRNAM(3)
posix_getgrnam - Return info about a group by name
SYNOPSIS
array posix_getgrnam (string $name)
DESCRIPTION
Gets information about a group provided its name.
PARAMETERS
o $name
-The name of the group
RETURN VALUES
The array elements returned are:
The group information array
+--------+---------------------------------------------------+
|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. |
| | This should be the same as the $name parameter |
| | used when calling the function, and hence redun- |
| | dant. |
| | |
|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 of the group in numeric form. |
| | |
|members | |
| | |
| | This consists of an array of string's for all |
| | the members in the group. |
| | |
+--------+---------------------------------------------------+
EXAMPLES
Example #1
Example use of posix_getgrnam(3)
<?php
$groupinfo = posix_getgrnam("toons");
print_r($groupinfo);
?>
The above example will output something similar to:
Array
(
[name] => toons
[passwd] => x
[members] => Array
(
[0] => tom
[1] => jerry
)
[gid] => 42
)
SEE ALSO
posix_getegid(3), posix_getgrgid(3), filegroup(3), stat(3), safe_mode_gid, POSIX man page GETGRNAM(3).
PHP Documentation Group POSIX_GETGRNAM(3)