4.3BSD-Reno/share/man/cat3/getlogin.0

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



GETLOGIN(3)		      1990		      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
     /_v_a_r/_r_u_n/_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 /_v_a_r/_r_u_n/_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
     /var/run/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/26/90               June				1