NAME    [Toc]    [Back]

       cuserid  -  Get  the alphanumeric username associated with
       the current process

SYNOPSIS    [Toc]    [Back]

       #include <stdio.h>

       char *cuserid(
               char *s );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       The cuserid() function generates a character string representing
 the real or effective username of the owner of the
       current process.

NOTES    [Toc]    [Back]

       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    [Toc]    [Back]

       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.

SEE ALSO    [Toc]    [Back]

       Functions: getlogin(2), getpwent(3)

       Standards: standards(5)



                                                       cuserid(3)