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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

171

172

173

174

175

176

177

178

179

180

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man3/!!!intro.3c

________________________________________________________________

___ ___

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 deﬁned in the <stdio.h>

header ﬁle.

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].

WARNINGS

Obsolescent Interfaces

csuserid() is to be obsoleted at a future date.