NAME

     getusershell, setusershell, endusershell -  get  legal  user
     shells


SYNOPSIS

     #include <unistd.h>

     char *getusershell(void);

     void setusershell(void);

     void endusershell(void);


DESCRIPTION

     The getusershell() function returns the next line  from  the
     file  /etc/shells,  opening the file if necessary.  The line
     should contain the pathname  of  a  valid  user  shell.   If
     /etc/shells  does not exist or is unreadable, getusershell()
     behaves as if  /bin/sh and /bin/csh were listed in the file.

     The setusershell() function rewinds /etc/shells.

     The endusershell() function closes /etc/shells.


RETURN VALUE

     The getusershell() function returns a NULL pointer  on  end-
     of-file.


FILES

     /etc/shells


CONFORMING TO

     BSD 4.3


SEE ALSO

     shells(5)