*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> chsh (1)              


 chsh(1)                                                             chsh(1)

 NAME    [Toc]    [Back]
      chsh - change default login shell

 SYNOPSIS    [Toc]    [Back]
      chsh login-name [shell]

      chsh -r files login-name [shell]

      chsh -r nisplus login-name [shell]

      chsh -r nis login-name [shell]

      chsh -r dce login-name [shell]

 DESCRIPTION    [Toc]    [Back]
      The chsh command changes the login-shell for a user's login name in
      the repository (see passwd(1)).

      The DCE repository (-r dce) is only available if Integrated Login has
      been configured, see auth.adm(1M).  If Integrated Login has been
      configured, other considerations apply.  A user with appropriate DCE
      privileges is capable of modifying a user's shell; this is not
      dependent upon superuser privileges.

      If the repository is not specified; i.e., chsh [login-name], the login
      shell is changed in passwd file only.

      Run finger after running chsh to make sure the information was
      processed correctly.

    Arguments    [Toc]    [Back]
           login-name  A login name of a user.

           shell       The absolute path name of a shell.  If the file
                       /etc/shells exists, the new login shell must be
                       listed in that file.  Otherwise, you can specify one
                       of the standard shells listed in the getusershell(3C)
                       manual entry.  If shell is omitted, it defaults to
                       the POSIX shell, /usr/bin/sh.

    Options    [Toc]    [Back]
      The following option is recognized:

           -r             Specify the repository to which the operation is
                          to be applied.  Supported repositories include
                          files, nis, nisplus, and dce.

    Security Restrictions    [Toc]    [Back]
      You must have appropriate privileges to use the optional login-name
      argument to change another user's login shell.

 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003

 chsh(1)                                                             chsh(1)

      File /etc/passwd can be implemented as a Network Information Service
      (NIS) database.

 EXAMPLES    [Toc]    [Back]
      To change the login shell for user voltaire to the default:

           chsh voltaire

      To change the login shell for user descartes to the C shell:

           chsh descartes /usr/bin/csh

      To change the login shell for user aristotle to the Korn shell in the
      DCE registry:

           chsh -r dce aristotle /usr/bin/ksh

 WARNINGS    [Toc]    [Back]
      As many users may try to write the /etc/passwd file simultaneously, a
      passwd locking mechanism was deviced.  If this locking fails after
      subsequent retrying, chsh terminates.

 AUTHOR    [Toc]    [Back]
      chsh was developed by HP and the University of California, Berkeley.

 NOTES    [Toc]    [Back]
      The chsh command is a hard link to passwd command. When chsh is
      executed actually the passwd command gets executed with appropriate
      arguments to change the user login shell in the repository specified
      in command line. If no repository is specified the login shell is
      changed in /etc/passwd file.

 FILES    [Toc]    [Back]

 SEE ALSO    [Toc]    [Back]
      chfn(1), csh(1), ksh(1), passwd(1), sh(1), sh-posix(1),
      getusershell(3C), pam(3), passwd(4), shells(4).

 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003
[ Back ]
 Similar pages
Name OS Title
chsh Linux change login shell
yppasswd IRIX change NIS login password
passwd HP-UX change login password and associated attributes
fbtab OpenBSD change device protection upon login
fbtab FreeBSD change device protection upon login
yppasswd HP-UX change login password in Network Information System (NIS)
ssh2 Tru64 Secure Shell client remote login and command execution application
ssh Tru64 Secure Shell client remote login and command execution application
passwd IRIX change login password and password attributes
auth_timeok FreeBSD functions for checking login class based login restrictions
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service