4.3BSD-UWisc/man/cat3/getusershell.3

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



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 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 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

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.
























Printed 12/27/86        November 8, 1985                        1