Home
March 19, 2010 7:19:48 PM EST
home
back print
GETUSERSHELL   (3) manpage
GETUSERSHELL
3
2007-07-26
GNU
Linux Programmer's Manual
  • 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
  • COLOPHON
      This page is part of release 3.19 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/.


Current Users: 84 © 1999-2009 PenguinSoft. All trademarks and copyrights on this page are owned by their respective companies. Linux is a trademark of Linus Torvalds.