setusershel(3c) [hpux man page]

getusershell(3C)														  getusershell(3C)

NAME

       getusershell(), setusershell(), endusershell() - get legal user shells

SYNOPSIS

   Obsolescent Interfaces
DESCRIPTION

       Returns a pointer to the first legal user shell
				as defined in the file (see shells(4)).  If does not exist or is not readable, returns the following standard sys-
				tem shells:

				as if they were contained in The file is left open so that the next call returns the next shell.  A  null  pointer(0) is returned on EOF or error.

       Rewinds the file.

       Closes the file.

   Obsolescent Interfaces
       get legal user shells.

WARNINGS

       and  are obsolescent interfaces	supported only for compatibility with existing DCE applications. New multithreaded applications should use
       and

AUTHOR

       was developed by HP and the University of California, Berkeley.

FILES

SEE ALSO

       shells(4), thread_safety(5).

																  getusershell(3C)

GETUSERSHELL(3) 					   BSD 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 necessary); 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.

BSD
								 January 16, 1999							       BSD