cuserid(3P)                                           cuserid(3P)



     NAME
          cuserid - get 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 char-
          acters; the representation is left in this array.  The con-
          stant 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.

     RETURN VALUE
          If the character string representing the login name associ-
          ated with the effective user ID of the current process can-
          not be found, cuserid returns a NULL pointer; if s is not a
          NULL pointer, a null character (\0) is placed at s[0].

     FILES
          /etc/passwd

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

     BUGS
          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.















     April, 1990                                                     1