blob: 33082a61a5680d6afcee26bec18eec867228bb58 [file] [log] [blame]
.\" chsh.1 -- change your login shell
.\" (c) 1994 by salvatore valente <>
.\" This program is free software. You can redistribute it and
.\" modify it under the terms of the GNU General Public License.
.\" There is no warranty.
.TH CHSH 1 "July 2014" "util-linux" "User Commands"
chsh \- change your login shell
.B chsh
.RB [ \-s
.IR shell ]
.RB [ \-l ]
.RB [ \-u ]
.RB [ \-v ]
.RI [ username ]
.B chsh
is used to change your login shell.
If a shell is not given on the command line,
.B chsh
prompts for one.
.B chsh
supports non-local entries (kerberos, LDAP, etc.\&) if linked with libuser,
otherwise use \fBypchsh\fR, \fBlchsh\fR or any other implementation for
non-local entries.
.BR \-s , " \-\-shell " \fIshell
Specify your login shell.
.BR \-l , " \-\-list\-shells"
Print the list of shells listed in
.I /etc/shells
and exit.
.BR \-u , " \-\-help"
Display help text and exit.
.BR \-v , " \-\-version"
Display version information and exit.
.B 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
.I /etc/shells
On the other hand, it can also be configured such that it will
only accept shells listed in this file, unless you are root.
Returns 0 if operation was successful, 1 if operation failed or command syntax was not valid.
.BR login (1),
.BR passwd (5),
.BR shells (5)
Salvatore Valente <>
The chsh command is part of the util-linux package and is available from