up | Inhaltsverzeichniss | Kommentar
Manual page for GETLOGIN(3)

getlogin - get login name

SYNOPSIS

#include <libc.h>   /* POSIX applications #include <unistd.h> */

char *getlogin(void);

DESCRIPTION

Getlogin returns a pointer to a string giving a login name associated with the user process. The login name is 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 terminal, or if there is no entry in /etc/utmp for the process's terminal, getlogin returns a NULL pointer (0). A reasonable procedure for determining the login name is to first call getlogin and if it fails, to call getpwuid(getuid()).

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

FILES

/etc/utmp

RETURN VALUE

A successful call returns a pointer to a string containing the user's login name, or a NULL pointer if the user's login name cannot be found.

SEE ALSO

getpwent(3), utmp(5), ttyslot(3)

index | Inhaltsverzeichniss | Kommentar

Created by unroff & hp-tools. © somebody (See intro for details). All Rights Reserved. Last modified 11/5/97