cuserid(3)cuserid(3)NAMEcuserid - Get the alphanumeric username associated with the current
process
SYNOPSIS
#include <stdio.h>
char *cuserid(
char *s );
LIBRARY
Standard C Library (libc)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
cuserid(): XPG4, XPG4-UNIX
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
PARAMETERS
Points to the character array into which the cuserid() function copies
the string representing the username. This array must contain at least
L_cuserid bytes. L_cuserid is a constant defined in the stdio.h header
file, and has a value greater than 0 (zero). If you specify a null
pointer for s, the character string is stored into an internal thread-
specific buffer, the address of which is returned.
DESCRIPTION
The cuserid() function generates a character string representing the
real or effective username of the owner of the current process.
NOTES
If the s parameter is a null pointer, the character string is stored
into an internal thread-specific buffer, the address of which is
returned. Subsequent calls to the cuserid() function from the same
thread overwrite the contents of the internal buffer.
The cuserid() function is scheduled to be withdrawn from a future ver‐
sion of the X/Open CAE Specification.
RETURN VALUES
If the s parameter is not a null pointer, the cuserid() function
returns the character string in the array pointed to by s. If the user‐
name cannot be found, an empty string is returned.
If the s parameter is a null pointer, the character string is stored
into an internal thread-specific buffer, the address of which is
returned. If the username cannot be found, a null pointer is returned.
SEE ALSO
Functions: getlogin(2), getpwent(3)
Standards: standards(5)cuserid(3)
