Go to main content

man pages section 3: Basic Library Functions

Exit Print View

Updated: July 2017
 
 

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(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
MT-Level
MT-Safe

See Also

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