cuserid(3c) [sunos man page]

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.10							    30 Dec 1996 						       cuserid(3C)

cuserid(3S)															       cuserid(3S)

NAME

       cuserid() - get character login name of the user

SYNOPSIS

   Remarks:
       Because	this  function	behaved differently in previous releases of HP-UX, and behaves differently on other systems, its use is not recom-
       mended.	It is provided only for conformance to current industry standards, and is subject to withdrawal in future releases of HP-UX.

       For portability and security, application writers and maintainers should search their existing code and replace references to with  equiva-
       lent calls to or depending on which user name is desired.

DESCRIPTION

       generates  a  character-string  representation  of  the	user  name  corresponding to the effective user ID of the process.  If s is a NULL
       pointer, this representation is generated in an internal static area, the address of which is returned.	Otherwise, s is assumed  to  point
       to an array of at least characters; the representation is left in this array.  The constant is defined in the header file.

       For multi-thread applications, if s is a NULL pointer, the operation is not performed and a NULL pointer is returned.

DIAGNOSTICS

       If the login name cannot be found, returns a NULL pointer; if s is not a NULL pointer, a null character is placed at s[0].

WARNINGS

   Obsolescent Interfaces
       is to be obsoleted at a future date.

SEE ALSO

       geteuid(2), getuid(2), getlogin(3C), getpwent(3C), getpwuid(3C), thread_safety(5).

STANDARDS CONFORMANCE

								  TO BE OBSOLETED						       cuserid(3S)