POSIX_GETGRGID(3)							 1							 POSIX_GETGRGID(3)

posix_getgrgid - Return info about a group by group id

SYNOPSIS

       array posix_getgrgid (int  $gid)

DESCRIPTION

	Gets information about a group provided its id.

PARAMETERS

	      o $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 parame- |
       |	| ter  used  when  calling  the function, and hence |
       |	| redundant.					    |
       |	|						    |
       |members |						    |
       |	|						    |
       |	|  This consists of an array of  string's  for	all |
       |	| the members in the group.			    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      Example use of posix_getgrgid(3)

	      <?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

       posix_getegid(3), posix_getgrnam(3), filegroup(3), stat(3), safe_mode_gid, POSIX man page GETGRNAM(3).

PHP Documentation Group 													 POSIX_GETGRGID(3)