debian man page for getusershell

Query: getusershell

OS: debian

Section: 3

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

GETUSERSHELL(3) 					     Linux Programmer's Manual						   GETUSERSHELL(3)

NAME
getusershell, setusershell, endusershell - get permitted user shells
SYNOPSIS
#include <unistd.h> char *getusershell(void); void setusershell(void); void endusershell(void); Feature Test Macro Requirements for glibc (see feature_test_macros(7)): getusershell(), setusershell(), endusershell(): _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
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
4.3BSD.
SEE ALSO
shells(5)
COLOPHON
This page is part of release 3.44 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/.
GNU
2007-07-26 GETUSERSHELL(3)
Related Man Pages
getusershell(3) - linux
setusershell(3) - linux
setusershell(3) - centos
endusershell(3) - centos
setusershell(3) - suse
Similar Topics in the Unix Linux Community
Changing Shells on IBM AIX
How to open multiple shells while the scripts keeps running.
Different type of shells?
find all of the available shells
The /etc/shells file is missing.