opensolaris man page for cuserid

cuserid(3C)						   Standard C Library Functions 					       cuserid(3C)

NAME
       cuserid - get character login name of the user

SYNOPSIS
       #include <stdio.h>

       char *cuserid(char *s);

DESCRIPTION
       The cuserid() function generates a character-string representation of the login name under which the owner of the current process is logged
       in. If s is a null pointer, this representation is generated in an internal static area whose address is returned. Otherwise, s is  assumed
       to  point  to an array of at least L_cuserid characters; the representation is left in this array. The constant L_cuserid is defined in the
       <stdio.h> header.

       In multithreaded applications, the caller must always supply an array s for the return value.

RETURN VALUES
       If the login name cannot be found, cuserid() returns a null pointer.  If s is not a null pointer, the null character `' will be placed at
       s[0].

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       getlogin(3C), getpwnam(3C), attributes(5)

SunOS 5.11							    30 Dec 1996 						       cuserid(3C)