Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > C

cuserid(3S)

TO BE OBSOLETED
HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

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.

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

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.