GETUSERSHELL(3)                                                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 does not exist,
       the two standard system shells _/_b_i_n_/_s_h and _/_b_i_n_/_c_s_h are returned.

       _G_e_t_u_s_e_r_s_h_e_l_l  reads  the  next  line  (opening  the file if necessary);
       _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

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

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



4.3 Berkeley Distribution      November 8, 1985                GETUSERSHELL(3)