CUSERID(3S)         UNIX Programmer's Manual          CUSERID(3S)

NAME
     cuserid - character login name of the user

SYNOPSIS
     #include <stdio.h>

     char *cuserid (s)
     char *s;

HP-UX COMPATIBILITY
     Level:    HP-UX/NUCLEUS

     Origin:   System III

DESCRIPTION
     _C_u_s_e_r_i_d generates a character representation  of  the  login
     name  of  the  owner  of  the current process.  If (int)_s is
     zero, this representation is generated in an internal static
     area,  the  address of which is returned.  If (int)_s is non-
     zero, _s is  assumed  to  point  to  an  array  of  at  least
     L_cuserid  characters;  the  representation  is left in this
     array.   The  manifest  constant  L_cuserid  is  defined  in
     <stdio.h>.

SEE ALSO
     getlogin(3C), getpwent(3C).

DIAGNOSTICS
     If the login name cannot be found, _c_u_s_e_r_i_d returns NULL;  if
     _s is non-zero in this case, \0 will be placed at *_s.

BUGS
     _C_u_s_e_r_i_d uses _g_e_t_p_w_n_a_m (see _g_e_t_p_w_e_n_t(3C)); thus  the  results
     of a user's call to the latter will be obliterated by a sub-
     sequent call to the former.