endusershell(3C)
NAME
getusershell, setusershell, endusershell - get legal user
shells
SYNOPSIS
char *getusershell()
void setusershell()
void endusershell()
DESCRIPTION
The getusershell() function returns a pointer to a legal
user shell as defined by the system manager in the file
/etc/shells. If /etc/shells does not exist, the following
locations of the standard system shells are used in its
place:
/bin/bash /bin/csh
/bin/jsh /bin/ksh
/bin/pfcsh /bin/pfksh
/bin/pfsh /bin/sh
/bin/tcsh /bin/zsh
/sbin/jsh /sbin/sh
/usr/bin/bash /usr/bin/csh
/usr/bin/jsh /usr/bin/ksh
/usr/bin/pfcsh /usr/bin/pfksh
/usr/bin/pfsh /usr/bin/sh
/usr/bin/tcsh /usr/bin/zsh
/usr/xpg4/bin/sh
The getusershell() function opens the file /etc/shells, if
it exists, and returns the next entry in the list of shells.
The setusershell() function rewinds the file or the list.
The endusershell() function closes the file, frees any
memory used by getusershell() and setusershell(), and
rewinds the file /etc/shells.
RETURN VALUES
The getusershell() function returns a null pointer on EOF.
BUGS
All information is contained in memory that may be freed
with a call to endusershell(), so it must be copied if it is
to be saved.
Man(1) output converted with
man2html