CHSH(1)                 System General Commands Manual                 CHSH(1)

NAME
     chsh - change the login shell for a user

SYNOPSIS
     chsh [-u user] [-v] shellpath

DESCRIPTION
     The chsh changes the default login shell for a user. The information is
     stored in the user database and the user invoking this utility must have
     the privileges needed to make changes in the user database to be success-
     ful.

     The shellpath is a full pathname to the shell. If shellpath is not a
     valid shell in the file /etc/shells then the change will be denied.  Also
     if shellpath does not exist and is not executable then the change will
     also be denied.

     Available options:

     -u user
             Do the change request for the specified user account instead of
             the user account running the utility. This is useful for an
             administrator to make the change.

     -v      Be verbose while running the utility.

DIAGNOSTICS
     The chsh utility exits with one of the following values:

     0       The utility exited successfully

     1       A usage error occurred.

     2       The specified shell shellpath
              not exist.

     3       The specified shell shellpath is not executable.

     4       The specified shell shellpath is not listed as a valid shell in
             /etc/shells.

     5       The specified user user cannot be found in the user database.

     6       The user account to change is missing from the user database.

     7       Cannot get principle domainname.

     8       Cannot get hostname.

     9       The shell change request to the user database was not successful.

BUGS
     We have to rely on a Win32 utility to make the actual change.

Interix                          July 26, 2006                         Interix