Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Standard C Library Functionsgetusershell(3C)


NAME

 getusershell, setusershell, endusershell - get legal user shells

SYNOPSIS

 
char *getusershell()
 
void setusershell()
 
void endusershell()

DESCRIPTION

 

The getusershell() function 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 following locations of the standard system shells are used in its place:

 
/bin/bash                  /bin/csh
/bin/jsh                   /bin/ksh
/bin/pfcsh                 /bin/pfksh
/bin/pfsh                  /bin/sh
/bin/tcsh                  /bin/zsh
/sbin/jsh                  /sbin/sh
/usr/bin/bash              /usr/bin/csh
/usr/bin/jsh               /usr/bin/ksh
/usr/bin/pfcsh             /usr/bin/pfksh
/usr/bin/pfsh              /usr/bin/sh
/usr/bin/tcsh              /usr/bin/zsh
/usr/xpg4/bin/sh

The getusershell() function opens the file /etc/shells, if it exists, and returns the next entry in the list of shells.

The setusershell() function rewinds the file or the list.

The endusershell() function closes the file, frees any memory used by getusershell() and setusershell(), and rewinds the file /etc/shells.

RETURN VALUES

 

The getusershell() function returns a null pointer on EOF.

BUGS

 

All information is contained in memory that may be freed with a call to endusershell(), so it must be copied if it is to be saved.


SunOS 5.9Go To TopLast Changed 18 Oct 2001

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.