Content-type: text/html Man page of cuserid

cuserid

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

cuserid - Gets the alphanumeric username associated with the current process  

LIBRARY

Standard C Library (libc.so, libc.a)  

SYNOPSIS

#include <stdio.h>

char *cuserid(        char *s);
 

STANDARDS

Interfaces documented on this reference page conform to industry standards 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 version 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 username 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.  

RELATED INFORMATION

Functions: getlogin(2), getpwent(3)

Standards: standards(5) delim off


 

Index

NAME
LIBRARY
SYNOPSIS
STANDARDS
PARAMETERS
DESCRIPTION
NOTES
RETURN VALUES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:14 GMT, October 02, 2010