downloads | documentation | faq | getting help | mailing lists | reporting bugs | php.net sites | links | my php.net 
search for in the  

<posix_getgidposix_getgrnam>
Last updated: Thu, 26 Jun 2008

posix_getgrgid

(PHP 4, PHP 5)

posix_getgrgid — Return info about a group by group id

Description

array posix_getgrgid ( int $gid )

Gets information about a group provided its id.

Parameters

gid

The group id.

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.
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, should be the same as the gid parameter used when calling the function, and hence redundant.
members This consists of an array of string's for all the members in the group.

ChangeLog

Version Description
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 #1 Example use of posix_getgrgid()

<?php

$groupid 
= posix_getegid();
$groupinfo = posix_getgrgid($groupid);

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



add a noteadd a note User Contributed Notes
Return info about a group by group id
There are no user contributed notes for this page.




<posix_getgidposix_getgrnam>
Last updated: Thu, 26 Jun 2008
show source | credits | sitemap | contact | advertising | mirror sites
Copyright © 2001-2005 The PHP Group
All rights reserved.
This unofficial mirror is operated at: http://phpbuilder.com/
Last updated: Tue Nov 1 20:20:59 2005 EST
Columns / Articles | Tips / Quickies | News | News Linking and RSS Feeds | Shared Code Library
Mail Archives | Support / Discussion Forums | Get Started! Links | Contribute! | Docs