getusershel.3c (2010 09)

getusershell(3C) getusershell(3C)

NAME

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

SYNOPSIS

#include <unistd.h>

char *getusershell(void);

void setusershell(void);

void endusershell(void);

Obsolescent Interfaces

char *getusershell_r(char **shell_datap);

void setusershell_r(char **shell_datap);

void endusershell_r(char **shell_datap);

DESCRIPTION

getusershell()

Returns a pointer to the ﬁrst legal user shell as deﬁned in the ﬁle

/etc/shells (see shells (4)). If /etc/shells does not exist or is not read-

able, getusershell() returns the following standard system shells:

/sbin/sh

/usr/bin/sh

/usr/bin/rsh

/usr/bin/ksh

/usr/bin/rksh

/usr/bin/csh

/usr/bin/keysh

as if they were contained in /etc/shells. The ﬁle is left open so that the

next call returns the next shell. A null pointer (0) is returned on EOF or error.

setusershell() Rewinds the ﬁle.

endusershell() Closes the ﬁle.

Obsolescent Interfaces

getusershell_r(),

setusershell_r(), endusershell_r()

get legal user shells.

WARNINGS

getusershell_r()

, setusershell_r() and endusershell_r()

are obsolescent interfaces

supported only for compatibility with existing DCE applications. New multithreaded applications should

use

getusershell(),

setusershell() and endusershell().

AUTHOR

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

FILES

/etc/shells

PAGE 1
getusershell(3C) getusershell(3C) NAME getusershell( ), setusershell( ), endusershell( ) - get legal user shells SYNOPSIS #include char *getusershell(void); void setusershell(void); void endusershell(void); Obsolescent Interfaces char *getusershell_r(char **shell_datap); void setusershell_r(char **shell_datap); void endusershell_r(char **shell_datap); DESCRIPTION getusershell() Returns a pointer to the first legal user shell as defined in the file /etc/shells (see shells (4)).
PAGE 2
(Notes) A (Notes) gA 2 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010