JavaScript Editor Javascript debugger     Website design 


posix_getgrnam

Return info about a group by name (PHP 4, PHP 5)
array posix_getgrnam ( string name )

Gets information about a group provided its name.

Parameters

name

The name of the group

Return Values

The array elements returned are:

Table 265. The group information array

ElementDescription
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.


ChangeLog

VersionDescription
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.

Examples

Example 1872. 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
)