Index for Section 3

Alphabetical listing for C

Bottom of page

cuserid(3)
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
  s	    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)

Index for Section 3

Alphabetical listing for C

Top of page