GETLOGIN(3C-SVR4)   RISC/os Reference Manual    GETLOGIN(3C-SVR4)



NAME
     getlogin - get login name

SYNOPSIS
     #include <stdlib.h>

     char *getlogin (void);

DESCRIPTION
     getlogin returns a pointer to the login name as found in
     /var/adm/utmp.  It may be used in conjunction with getpwnam
     to locate the correct password file entry when the same user
     id is shared by several login names.

     If getlogin is called within a process that is not attached
     to a terminal, it returns a null pointer.  The correct pro-
     cedure for determining the login name is to call cuserid, or
     to call getlogin and if it fails to call getpwuid.

FILES
     /var/adm/utmp

SEE ALSO
     cuserid(3S), getgrent(3C), getpwent(3C), utmp(4).

DIAGNOSTICS
     Returns a null pointer if the login name is not found.

NOTES
     The return values point to static data whose content is
     overwritten by each call.
























                        Printed 11/19/92                   Page 1