POSIX_GETPWUID(3)							 1							 POSIX_GETPWUID(3)

posix_getpwuid - Return info about a user by user id

SYNOPSIS

       array posix_getpwuid (int  $uid)

DESCRIPTION

	Returns an array of information about the user referenced by the given user ID.

PARAMETERS

	      o $uid
		- The user identifier.

RETURN VALUES

	Returns an associative array with the following elements:

       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. 					    |
       |	|						    |
       |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, should be the same as the $uid parame- |
       |	| ter used when calling  the  function,  and  hence |
       |	| redundant.					    |
       |	|						    |
       |  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_getpwuid(3)

	      <?php

	      $userinfo = posix_getpwuid(10000);

	      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_getpwnam(3), POSIX man page GETPWNAM(3).

PHP Documentation Group 													 POSIX_GETPWUID(3)