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



NAME
     getlogin - get login name

SYNOPSIS
     #include <bsd/sys/types.h>

     char *getlogin ( );

DESCRIPTION
     getlogin returns a pointer to the login name as found in
     /etc/utmp.  It may be used in conjunction with getpwnam (see
     getpwent(3C)) 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
     /etc/utmp

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

DIAGNOSTICS
     Returns the NULL pointer if name is not found.

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
























                        Printed 11/19/92                   Page 1