> Linux Man Page: "chsh"


Search with Google


The Linux Documentation Project maintains an archive of snaphots of the (English language) core Linux manual pages that are maintained by Michael Kerrisk. Corrections and additions are welcome, but review the "Help Wanted" list, first.

Man pages belonging to programs are usually distributed together with those programs. Therefore, the core Linux man-pages mainly contains the pages for system calls and library routines, special devices, and file formats. However, it also contains documentation for a few programs, in cases where the authors or maintainers of the program do not distribute man pages themselves.

This page is part of release 3.11 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at


man page(1) manual page Table of Contents


chsh - change your login shell


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


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

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.


-s, --shell
Specify your login shell.

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

-u, --help
Print a usage message and exit.

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

See Also

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


Salvatore Valente <>


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

Table of Contents

use open software!