4.3BSD-Tahoe/usr/man/cat3/getlogin.0

Compare this file to the similar file:
Show the results in this format:



GETLOGIN(3)	    UNIX Programmer's Manual	      GETLOGIN(3)



NNAAMMEE
     getlogin - get login name

SSYYNNOOPPSSIISS
     cchhaarr **ggeettllooggiinn(())

DDEESSCCRRIIPPTTIIOONN
     _G_e_t_l_o_g_i_n returns a pointer to the login name as found in
     /_e_t_c/_u_t_m_p.  It may be used in conjunction with _g_e_t_p_w_n_a_m to
     locate the correct password file entry when the same userid
     is shared by several login names.

     If _g_e_t_l_o_g_i_n is called within a process that is not attached
     to a terminal, or if there is no entry in /_e_t_c/_u_t_m_p for the
     process's terminal, _g_e_t_l_o_g_i_n returns a NULL pointer (0).  A
     reasonable procedure for determining the login name is to
     first call _g_e_t_l_o_g_i_n and if it fails, to call
     _g_e_t_p_w_u_i_d(_g_e_t_u_i_d()).

FFIILLEESS
     /etc/utmp

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

DDIIAAGGNNOOSSTTIICCSS
     Returns a NULL pointer (0) if name not found.

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
























Printed 7/9/88		   May 9, 1986				1