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
endusershell(3) - debian
getusershell(3) - debian
getusershell(3) - centos
endusershell(3) - suse
getusershell(3) - hpux
Similar Topics in the Unix Linux Community
what do they mean?
How to open multiple shells while the scripts keeps running.
Different type of shells?
find all of the available shells
shells and scripts