CHSH(1)                         User Commands                        CHSH(1)

NAME         top

       chsh - change your login shell

SYNOPSIS         top

       chsh [-s shell] [-l] [-h] [-v] [username]

DESCRIPTION         top

       chsh is used to change your login shell.  If a shell is not given on
       the command line, chsh prompts for one.

       chsh supports non-local entries (kerberos, LDAP, etc.) if linked with
       libuser, otherwise use ypchsh, lchsh or any other implementation for
       non-local entries.

OPTIONS         top

       -s, --shell shell
              Specify your login shell.

       -l, --list-shells
              Print the list of shells listed in /etc/shells and exit.

       -h, --help
              Display help text and exit.

       -v, --version
              Display version information and exit.

VALID SHELLS         top

       chsh will accept the full pathname of any executable file on the
       system.  However, it will issue a warning if the shell is not listed
       in the /etc/shells file.  On the other hand, it can also be
       configured such that it will only accept shells listed in this file,
       unless you are root.

EXIT STATUS         top

       Returns 0 if operation was successful, 1 if operation failed or
       command syntax was not valid.

SEE ALSO         top

       login(1), login.defs(5), passwd(5), shells(5)

AUTHOR         top

       Salvatore Valente <>

AVAILABILITY         top

       The chsh command is part of the util-linux package and is available

COLOPHON         top

       This page is part of the util-linux (a random collection of Linux
       utilities) project.  Information about the project can be found at 
       ⟨⟩.  If you have a
       bug report for this manual page, send it to  This page was obtained from the
       project's upstream Git repository 
       ⟨git://⟩ on
       2017-09-15.  If you discover any rendering problems in this HTML ver‐
       sion of the page, or you believe there is a better or more up-to-date
       source for the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original man‐
       ual page), send a mail to

util-linux                        July 2014                          CHSH(1)

Pages that refer to this page: chfn(1)chfn(1@@shadow-utils)intro(1)passwd(5)shells(5)groupadd(8)groupdel(8)groupmems(8)groupmod(8)useradd(8)userdel(8)usermod(8)