getusershell man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

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);

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/ksh93		    /bin/pfcsh
	 /bin/pfksh		    /bin/pfsh
	 /bin/sh		    /bin/tcsh
	 /bin/zsh		    /sbin/jsh
	 /sbin/pfsh		    /sbin/sh
	 /usr/bin/bash		    /usr/bin/csh
	 /usr/bin/jsh		    /usr/bin/ksh
	 /usr/bin/ksh93		    /usr/bin/pfcsh
	 /usr/bin/pfksh		    /usr/bin/pfsh
	 /usr/bin/sh		    /usr/bin/tcsh
	 /usr/bin/zsh		    /usr/sfw/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.

NOTES
       Restricted shells should not be listed in /etc/shells.

				  Nov 1, 2007		      GETUSERSHELL(3C)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net