bsd man page for getusershell

GETUSERSHELL(3) 					     Library Functions Manual						   GETUSERSHELL(3)

NAME
       getusershell, setusershell, endusershell - get legal user shells

SYNOPSIS
       char *getusershell()

       setusershell()

       endusershell()

DESCRIPTION
       Getusershell  returns  a pointer to a legal user shell as defined by the system manager in the file /etc/shells.  If /etc/shells is unread-
       able or does not exist, getusershell behaves as if /bin/sh and /bin/csh were listed in the file.

       Getusershell reads the next line (opening the file if necessary); setusershell rewinds the file; endusershell closes it.

FILES
       /etc/shells

SEE ALSO
       shells(5)

DIAGNOSTICS
       The routine getusershell 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.

4.3 Berkeley Distribution					 November 30, 1988						   GETUSERSHELL(3)