cuserid(3P)                                           cuserid(3P)



NAME
     cuserid - gets a character login name of the user

SYNOPSIS
     #include <stdio.h>

     char *cuserid(s)
     char *s;

DESCRIPTION
     cuserid generates a character string representation of the
     effective user ID of the current 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.

     If multiple character strings are associated with a user ID,
     the first one encountered in /etc/passwd will be returned.

STATUS MESSAGES AND VALUES
     If the character string representing the login name
     associated with the effective user ID of the current process
     cannot be found, cuserid returns a NULL pointer; if s is not
     a NULL pointer, a null character (\0) is placed at s[0].

LIMITATIONS
     cuserid uses getpwnam(3C); thus the results of a user's call
     to the latter will be obliterated by a subsequent call to
     the former.

     The name cuserid is rather a misnomer.

FILES
     /etc/passwd
          File containing user information

SEE ALSO
     getuid(2), cuserid(3S), getlogin(3C), getpwent(3C)















January 1992                                                    1