xref: /original-bsd/lib/libc/gen/getlogin.3 (revision aba77441)
@(#)getlogin.3 6.1 (Berkeley) 05/15/85

GETLOGIN 3 ""
.AT 3
NAME
getlogin - get login name
SYNOPSIS
char *getlogin()
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 userid is shared by several login names.

If getlogin is called within a process that is not attached to a typewriter, it returns NULL. The correct procedure for determining the login name is to first call getlogin and if it fails, to call getpw ( getuid ()).

FILES
/etc/utmp
"SEE ALSO"
getpwent(3), getgrent(3), utmp(5), getpw(3)
DIAGNOSTICS
Returns NULL (0) if name not found.
BUGS
The return values point to static data whose content is overwritten by each call.