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



NAME
     getusershell, setusershell, endusershell - get legal user
     shells

SYNOPSIS
     char *getusershell()

     setusershell()

     endusershell()

DESCRIPTION
     _G_e_t_u_s_e_r_s_h_e_l_l returns a pointer to a legal user shell as
     defined by the system manager in the file /_e_t_c/_s_h_e_l_l_s.  If
     /_e_t_c/_s_h_e_l_l_s is unreadable or does not exist, _g_e_t_u_s_e_r_s_h_e_l_l
     behaves as if /_b_i_n/_s_h and /_b_i_n/_c_s_h were listed in the file.

     _G_e_t_u_s_e_r_s_h_e_l_l reads the next line (opening the file if neces-
     sary); _s_e_t_u_s_e_r_s_h_e_l_l rewinds the file; _e_n_d_u_s_e_r_s_h_e_l_l closes
     it.

FILES
     /etc/shells

SEE ALSO
     shells(5)

DIAGNOSTICS
     The routine _g_e_t_u_s_e_r_s_h_e_l_l returns a null pointer (0) on EOF.

BUGS
     All information is contained in a static area so it must be
     copied if it is to be saved.






















Printed 11/26/99	November 30, 1988			1