Another version of this page is provided by the shadow-utils project
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | VALID SHELLS | EXIT STATUS | AUTHORS | SEE ALSO | REPORTING BUGS | AVAILABILITY
CHSH(1) User Commands CHSH(1)
chsh - change your login shell
chsh [-s shell] [-l] [-h] [-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 supports non-local entries (kerberos, LDAP, etc.) if linked with libuser, otherwise use ypchsh(1), lchsh(1) or any other implementation for non-local entries.
-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. The short options -h have been used since version 2.30; old versions use deprecated -u. -V, --version Print version and exit. The short options -V have been used since version 2.39; old versions use deprecated -v. -h, --help Display help text and exit. -V, --version Print version and exit.
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.
Returns 0 if operation was successful, 1 if operation failed or command syntax was not valid.
Salvatore Valente <firstname.lastname@example.org>
login(1), login.defs(5), passwd(5), shells(5)
For bug reports, use the issue tracker at https://github.com/util-linux/util-linux/issues.
The chsh command is part of the util-linux package which can be downloaded from Linux Kernel Archive <https://www.kernel.org/pub/linux/utils/util-linux/>. 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 email@example.com. This page was obtained from the project's upstream Git repository ⟨git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git⟩ on 2022-12-17. (At that time, the date of the most recent commit that was found in the repository was 2022-12-13.) 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 firstname.lastname@example.org util-linux 2.38.643-57df0 2022-12-17 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)