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
characters; 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.
APPLICATION USAGE
cuserid()
is thread-safe. It is not async-cancel-safe.
A cancellation point may occur when a thread is executing
cuserid().
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].
STANDARDS CONFORMANCE
cuserid(): AES, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1
