unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

GETUSERSHELL(3)            Library Functions Manual            GETUSERSHELL(3)



NAME
       getusershell, setusershell, endusershell - get legal user shells

SYNOPSIS
       char *getusershell()

       setusershell()

       endusershell()

DESCRIPTION
       getusershell()  returns  a  pointer to a legal user shell as defined by
       the system manager in the file /etc/shells.  If  /etc/shells  does  not
       exist,  the  four  locations of the two standard system shells /bin/sh,
       /bin/csh, /usr/bin/sh and /usr/bin/csh are returned.

       getusershell() reads the next line (opening  the  file  if  necessary);
       setusershell() rewinds the file; endusershell() closes it.

FILES
       /etc/shells
       /bin/sh
       /bin/csh
       /usr/bin/sh
       /usr/bin/csh

DIAGNOSTICS
       The routine getusershell() returns a NULL pointer (0) on EOF or error.

BUGS
       All  information  is contained in a static area so it must be copied if
       it is to be saved.



                                6 October 1987                 GETUSERSHELL(3)