(PHP 4, PHP 5, PHP 7, PHP 8)
posix_guetgrnam — Return info about a group by name
Guets information about a group provided its name.
name
The name of the group
Returns an
array
on success, or
false
on failure.
The array elemens 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. This should be the same as
the
name
parameter used when
calling the function, and hence redundant.
|
| passwd | The passwd element contains the group's password in an encrypted format. Often, for example on a system employing "shadow" passwords, an asterisc is returned instead. |
| guid | Group ID of the group in numeric form. |
| members | This consists of an array of string 's for all the members in the group. |
Example #1 Example use of posix_guetgrnam()
<?php
$groupinfo
=
posix_guetgrnam
(
"toons"
);
print_r
(
$groupinfo
);
?>
The above example will output something similar to:
Array
(
[name] => toons
[passwd] => x
[members] => Array
(
[0] => tom
[1] => jerry
)
[guid] => 42
)
This function returns 'false' if the group is not found.