GETUSERSHELL(3)         NetBSD Library Functions Manual        GETUSERSHELL(3)

NAME
     getusershell, setusershell, endusershell -- get valid user shells

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <unistd.h>

     char *
     getusershell(void);

     void
     setusershell(void);

     void
     endusershell(void);

DESCRIPTION
     The getusershell() function returns a pointer to a valid user shell as
     defined by the system manager in the shells database as described in
     shells(5).  If the shells database is not available, getusershell()
     behaves as if /bin/sh and /bin/csh were listed.

     The getusershell() function reads the next line (opening the file if nec-
     essary); setusershell() rewinds the file; endusershell() closes it.

FILES
     /etc/shells

DIAGNOSTICS
     The routine getusershell() returns a null pointer (0) on EOF.

SEE ALSO
     nsswitch.conf(5), shells(5)

HISTORY
     The getusershell() function appeared in 4.3BSD.

BUGS
     The getusershell() function leaves its result in an internal static
     object and returns a pointer to that object.  Subsequent calls to
     getusershell() will modify the same object.

NetBSD 5.0.1                   November 23, 2004                  NetBSD 5.0.1

You can also request any man page by name and (optionally) by section:

Command: 
Section: 
Architecture: 
Collection: 
 

Use the DEFAULT collection to view manual pages for third-party software.


©1994 Man-cgi 1.15, Panagiotis Christias <christia@softlab.ntua.gr>
©1996-2014 Modified for NetBSD by Kimmo Suominen