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 procedure for determining the login name is to call cuserid(), or to call getlogin() and if it fails to call getpwuid(). 

RETURN VALUES

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

FILES

/var/adm/utmp

SEE ALSO

cuserid(3S), getgrnam(3C), getpwnam(3C), utmp(4)

NOTES

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

SunOS 5.1  —  Last change: 13 Jul 1990