POSIX_GETGRNAM(3)							 1							 POSIX_GETGRNAM(3)

posix_getgrnam - Return info about a group by name

SYNOPSIS

       array posix_getgrnam (string  $name)

DESCRIPTION

	Gets information about a group provided its name.

PARAMETERS

	      o $name
		-The name of the group

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. |
       |	| This should be the same as  the  $name  parameter |
       |	| used	when calling the function, and hence redun- |
       |	| dant. 					    |
       |	|						    |
       |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(3)

	      <?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(3), posix_getgrgid(3), filegroup(3), stat(3), safe_mode_gid, POSIX man page GETGRNAM(3).

PHP Documentation Group 													 POSIX_GETGRNAM(3)