tail head cat sleep
QR code linking to this page
Main index Section 3
Go to:
日本語 DeutschOptions

Manual Pages  — GETUSERSHELL

NAME

getusershell, setusershell, endusershell – get valid user shells

CONTENTS

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 BSD 4.3 .

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.
GETUSERSHELL (3) January 16, 1999
tail head cat sleep
QR code linking to this page
Main index Section 3
Go to:
日本語 DeutschOptions

Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

“ Never write it in C if you can do it in `awk';
Never do it in `awk' if `sed' can handle it;
Never use `sed' when `tr' can do the job;
Never invoke `tr' when `cat' is sufficient;
Avoid using `cat' whenever possible. 		”
— Taylor's Laws of Programming