posix_getgrnam

Return info about a group by name

&reftitle.description; ``array``false```posix_getgrnam` `string` `name`

Gets information about a group provided its name.

&reftitle.parameters;

`name`

- The name of the group

&reftitle.returnvalues;

Returns an `array` on success, &return.falseforfailure;. 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.

&reftitle.examples;

### Example use of `posix_getgrnam`

    <?php

    $groupinfo = posix_getgrnam("toons");

    print_r($groupinfo);
    ?>

&example.outputs.similar;

    Array
    (
        [name]    => toons
        [passwd]  => x
        [members] => Array
            (
                [0] => tom
                [1] => jerry
            )
        [gid]     => 42
    )

&reftitle.seealso;

- `posix_getegid`
- `posix_getgrgid`
- `filegroup`
- `stat`
- POSIX man page GETGRNAM(3)