shells(5) [v7 man page]

SHELLS(5)						     Linux Programmer's Manual							 SHELLS(5)

NAME

       shells - pathnames of valid login shells

DESCRIPTION

       /etc/shells  is a text file which contains the full pathnames of valid login shells.  This file is consulted by chsh(1) and available to be
       queried by other programs.

       Be aware that there are programs which consult this file to find out if a user is a normal user; for  example,  FTP  daemons  traditionally
       disallow access to users with shells not included in this file.

FILES

       /etc/shells

EXAMPLE

       /etc/shells may contain the following paths:

	   /bin/sh
	   /bin/bash
	   /bin/csh

SEE ALSO

       chsh(1), getusershell(3), pam_shells(8)

COLOPHON

       This  page is part of release 4.15 of the Linux man-pages project.  A description of the project, information about reporting bugs, and the
       latest version of this page, can be found at https://www.kernel.org/doc/man-pages/.

								    2017-11-26								 SHELLS(5)

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.27 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)