HP-UX Reference (11i v1 05/09) - 3 Library Functions A-M (vol 6)

c
cuserid(3S) cuserid(3S)
(TO BE OBSOLETED)
NAME
cuserid() - get character login name of the user
SYNOPSIS
#include <stdio.h>
char *cuserid(char *s);
Remarks:
Because this function behaved differently in previous releases of HP-UX, and behaves differently on
other systems, its use is not recommended. 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 cuserid() with equivalent calls to
getpwuid (getuid()),
getpwuid (geteuid()), or getlogin() , depending on which user name is desired.
DESCRIPTION
cuserid() 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
L_cuserid charac-
ters; the representation is left in this array. The constant
L_cuserid is defined in the <stdio.h>
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,
cuserid() returns a NULL pointer; if s is not a
NULL pointer, a null
character (
\0) is placed at s[0].
WARNINGS
Obsolescent Interfaces
csuserid() 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
cuserid(): AES, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1
Section 3128 Hewlett-Packard Company 1 HP-UX 11i Version 1: September 2005