<HTML ><HEAD ><TITLE >posix_getpwuid</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" TITLE="PHP Manual" HREF="index.html"><LINK REL="UP" TITLE="POSIX functions" HREF="ref.posix.html"><LINK REL="PREVIOUS" TITLE="posix_getpwnam" HREF="function.posix-getpwnam.html"><LINK REL="NEXT" TITLE="posix_getrlimit" HREF="function.posix-getrlimit.html"><META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=ISO-8859-1"></HEAD ><BODY CLASS="refentry" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >PHP Manual</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="function.posix-getpwnam.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="function.posix-getrlimit.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="function.posix-getpwuid" ></A >posix_getpwuid</H1 ><DIV CLASS="refnamediv" ><A NAME="AEN75652" ></A ><P > (PHP 3>= 3.0.13, PHP 4 )</P >posix_getpwuid -- Return info about a user by user id</DIV ><DIV CLASS="refsect1" ><A NAME="AEN75655" ></A ><H2 >Description</H2 >array <B CLASS="methodname" >posix_getpwuid</B > ( int uid)<BR ></BR ><P > Returns an associative array containing information about a user referenced by a numeric user ID, passed in the <TT CLASS="parameter" ><I >uid</I ></TT > parameter. </P ><P > The array elements returned are: <DIV CLASS="table" ><A NAME="AEN75666" ></A ><P ><B >Table 1. The user information array</B ></P ><TABLE BORDER="1" CLASS="CALSTABLE" ><THEAD ><TR ><TH ALIGN="LEFT" VALIGN="MIDDLE" >Element</TH ><TH ALIGN="LEFT" VALIGN="MIDDLE" >Description</TH ></TR ></THEAD ><TBODY ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >name</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" > The name element contains the username of the user. This is a short, usually less than 16 character "handle" of the user, not her real, full name. </TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >passwd</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" > 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. </TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >uid</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" > User ID, should be the same as the <TT CLASS="parameter" ><I >uid</I ></TT > parameter used when calling the function, and hence redundant. </TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >gid</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" > The group ID of the user. Use the function <A HREF="function.posix-getgrgid.html" ><B CLASS="function" >posix_getgrgid()</B ></A > to resolve the group name and a list of its members. </TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >gecos</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" > 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 containing the user's full name, office phone, office number, and home phone number. On most systems, only the user's full name is available. </TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >dir</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" > This element contains the absolute path to the home directory of the user. </TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >shell</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" > The shell element contains the absolute path to the executable of the user's default shell. </TD ></TR ></TBODY ></TABLE ></DIV > </P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="function.posix-getpwnam.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="function.posix-getrlimit.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >posix_getpwnam</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="ref.posix.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >posix_getrlimit</TD ></TR ></TABLE ></DIV ></BODY ></HTML >