cuserid(3S)                                           cuserid(3S)



     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
          login name of the owner of the current process.  If s is a
          NULL pointer, this representation is generated in an inter-
          nal static area, the address of which is returned.  Other-
          wise, s is assumed to point to an array of at least
          L_cuserid characters; the representation remains in this ar-
          ray.  The constant L_cuserid is defined in the <stdio.h>
          header file.

     RETURN VALUE
          If the login name cannot be found, cuserid returns a NULL
          pointer; if s is not a NULL pointer, a null character (\0)
          is placed at s[0].

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

     BUGS
          cuserid uses getpwnam(3C); therefore, the results of a
          user's call to the latter will be obliterated by a subse-
          quent call to the former.

          The name cuserid is rather a misnomer.






















     April, 1990                                                     1