Php/docs/function.posix-getgrnam

• PHP Manual
• POSIX Functions
• Return info about a group by name

posix_getgrnam

(PHP 4, PHP 5, PHP 7)

posix_getgrnam — Return info about a group by name

Description

posix_getgrnam ( string $name ) : array|false

Gets information about a group provided its name.

Parameters

name

The name of the group

Return Values

Returns an array on success, or FALSE on failure. 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 redundant.
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()

<?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() - Return the effective group ID of the current process
• posix_getgrgid() - Return info about a group by group id
• filegroup() - Gets file group
• stat() - Gives information about a file
• POSIX man page GETGRNAM(3)