GETUSERSHELL(3) NetBSD Library Functions Manual GETUSERSHELL(3)
getusershell, setusershell, endusershell -- get valid user shells
Standard C Library (libc, -lc)
#include <unistd.h> char * getusershell(void); void setusershell(void); void endusershell(void);
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.
The routine getusershell() returns a null pointer (0) on EOF.
The getusershell() function appeared in 4.3BSD.
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 8.1 November 23, 2004 NetBSD 8.1
You can also request any man page by name and (optionally) by section: