chsh(1) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | VALID SHELLS | EXIT STATUS | AUTHORS | SEE ALSO | AVAILABILITY | COLOPHON

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.

       The default behavior for non-root users is to accept only shells
       listed in the /etc/shells file, and issue a warning for root user.
       It can also be configured at compile-time to only issue a warning for
       all users.

EXIT STATUS top

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

AUTHORS top

       Salvatore Valente <svalente@mit.edu>

SEE ALSO top

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

AVAILABILITY top

       The chsh command is part of the util-linux package and is available
       from https://www.kernel.org/pub/linux/utils/util-linux/.

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 
       ⟨https://www.kernel.org/pub/linux/utils/util-linux/⟩.  If you have a
       bug report for this manual page, send it to
       util-linux@vger.kernel.org.  This page was obtained from the
       project's upstream Git repository
       ⟨git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git⟩ on
       2020-08-13.  (At that time, the date of the most recent commit that
       was found in the repository was 2020-08-12.)  If you discover any
       rendering problems in this HTML version 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 manual page), send a mail to
       man-pages@man7.org

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)