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 `\0' will be placed at
s[0].

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


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

SEE ALSO

getlogin(3C), getpwnam(3C), attributes(7)

December 30, 1996 CUSERID(3C)