POSIX_GETPWNAM(3)							 1							 POSIX_GETPWNAM(3)

posix_getpwnam - Return info about a user by username

SYNOPSIS

       array posix_getpwnam (string  $username)

DESCRIPTION

	Returns an array of information about the given user.

PARAMETERS

	      o $username
		- An alphanumeric username.

RETURN VALUES

	On success an array with the following elements is returned, else FALSE is returned:

       The user information array

       +--------+---------------------------------------------------+
       |Element |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | name	|						    |
       |	|						    |
       |	|  The	name  element  contains the username of the |
       |	| user. This is a short, usually less than 16 char- |
       |	| acter  "handle"  of  the user, not the real, full |
       |	| name. This should be the same  as  the  $username |
       |	| parameter  used  when  calling  the function, and |
       |	| hence redundant.				    |
       |	|						    |
       |passwd	|						    |
       |	|						    |
       |	|  The passwd element contains the user's  password |
       |	| in  an  encrypted format. Often, for example on a |
       |	| system employing "shadow" passwords, an  asterisk |
       |	| is returned instead.				    |
       |	|						    |
       |  uid	|						    |
       |	|						    |
       |	|	 User ID of the user in numeric form.	    |
       |	|						    |
       |  gid	|						    |
       |	|						    |
       |	|  The	group  ID  of  the  user.  Use the function |
       |	| posix_getgrgid(3) to resolve the group name and a |
       |	| list of its members.				    |
       |	|						    |
       | gecos	|						    |
       |	|						    |
       |	|  GECOS  is  an  obsolete  term that refers to the |
       |	| finger information field  on	a  Honeywell  batch |
       |	| processing  system. The field, however, lives on, |
       |	| and its contents have been formalized  by  POSIX. |
       |	| The  field  contains	a comma separated list con- |
       |	| taining  the	user's	full  name,  office  phone, |
       |	| office  number,  and	home  phone number. On most |
       |	| systems, only the user's full name is available.  |
       |	|						    |
       |  dir	|						    |
       |	|						    |
       |	|  This element contains the absolute path  to	the |
       |	| home directory of the user.			    |
       |	|						    |
       | shell	|						    |
       |	|						    |
       |	|  The	shell element contains the absolute path to |
       |	| the executable of the user's default shell.	    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      Example use of posix_getpwnam(3)

	      <?php

	      $userinfo = posix_getpwnam("tom");

	      print_r($userinfo);
	      ?>

	      The above example will output something similar to:

	      Array
	      (
		  [name]    => tom
		  [passwd]  => x
		  [uid]     => 10000
		  [gid]     => 42
		  [gecos]   => "tom,,,"
		  [dir]     => "/home/tom"
		  [shell]   => "/bin/bash"
	      )

SEE ALSO

       posix_getpwuid(3), POSIX man page GETPWNAM(3).

PHP Documentation Group 													 POSIX_GETPWNAM(3)