getlogin(3C)                     DG/UX 5.4.2                    getlogin(3C)


NAME
       getlogin - get login name

SYNOPSIS
       #include <stdlib.h>

       char *getlogin (void);

DESCRIPTION
       getlogin returns a pointer to the login name as found in /etc/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.  This is the case for processes
       started at the system console.  The correct procedure 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 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.

























Licensed material--property of copyright holder(s)                         1