setusershell.3.gz

GETUSERSHELL

NAME

getusershell, setusershell, endusershell - get legal user shells

SYNOPSIS

#include <unistd.h>
 char *getusershell(void);
 void setusershell(void);
 void endusershell(void);

DESCRIPTION

The R 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, R getusershell () behaves as if /bin/sh and /bin/csh were listed in the file.
The R setusershell () function rewinds /etc/shells.
The R endusershell () function closes /etc/shells.

RETURN VALUE

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

FILES

/etc/shells

CONFORMING TO

4.3BSD

SEE ALSO

shells(5)