2006-12-06 17:25:32 -06:00
|
|
|
.\"
|
|
|
|
.\" chsh.1 -- change your login shell
|
|
|
|
.\" (c) 1994 by salvatore valente <svalente@athena.mit.edu>
|
|
|
|
.\"
|
2014-07-27 13:58:58 -05:00
|
|
|
.\" 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.
|
2006-12-06 17:25:32 -06:00
|
|
|
.\"
|
2014-07-27 13:58:58 -05:00
|
|
|
.TH CHSH 1 "July 2014" "util-linux" "User Commands"
|
2006-12-06 17:25:32 -06:00
|
|
|
.SH NAME
|
|
|
|
chsh \- change your login shell
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.B chsh
|
2009-07-22 04:29:04 -05:00
|
|
|
.RB [ \-s
|
|
|
|
.IR shell ]
|
|
|
|
.RB [ \-l ]
|
2017-01-19 16:04:47 -06:00
|
|
|
.RB [ \-h ]
|
2009-07-22 04:29:04 -05:00
|
|
|
.RB [ \-v ]
|
|
|
|
.RI [ username ]
|
2006-12-06 17:25:32 -06:00
|
|
|
.SH DESCRIPTION
|
|
|
|
.B chsh
|
|
|
|
is used to change your login shell.
|
|
|
|
If a shell is not given on the command line,
|
|
|
|
.B chsh
|
|
|
|
prompts for one.
|
2010-07-29 07:54:19 -05:00
|
|
|
|
|
|
|
.B chsh
|
2014-05-02 21:32:36 -05:00
|
|
|
supports non-local entries (kerberos, LDAP, etc.\&) if linked with libuser,
|
2014-07-27 13:58:58 -05:00
|
|
|
otherwise use \fBypchsh\fR, \fBlchsh\fR or any other implementation for
|
|
|
|
non-local entries.
|
2006-12-06 17:25:32 -06:00
|
|
|
.SH OPTIONS
|
|
|
|
.TP
|
2014-07-27 13:58:58 -05:00
|
|
|
.BR \-s , " \-\-shell " \fIshell
|
2006-12-06 17:25:32 -06:00
|
|
|
Specify your login shell.
|
|
|
|
.TP
|
2015-01-19 19:11:52 -06:00
|
|
|
.BR \-l , " \-\-list\-shells"
|
2006-12-06 17:25:32 -06:00
|
|
|
Print the list of shells listed in
|
|
|
|
.I /etc/shells
|
|
|
|
and exit.
|
|
|
|
.TP
|
2017-01-19 16:04:47 -06:00
|
|
|
.BR \-h , " \-\-help"
|
2013-10-14 14:34:39 -05:00
|
|
|
Display help text and exit.
|
2006-12-06 17:25:32 -06:00
|
|
|
.TP
|
2014-07-27 13:58:58 -05:00
|
|
|
.BR \-v , " \-\-version"
|
2013-10-14 14:34:39 -05:00
|
|
|
Display version information and exit.
|
2020-05-19 03:31:19 -05:00
|
|
|
.SH VALID SHELLS
|
2012-12-12 03:48:01 -06:00
|
|
|
.B chsh
|
|
|
|
will accept the full pathname of any executable file on the system.
|
2020-02-27 06:54:05 -06:00
|
|
|
.sp
|
|
|
|
The default behavior for non-root users is to accept only shells
|
|
|
|
listed in the
|
2012-12-12 03:48:01 -06:00
|
|
|
.I /etc/shells
|
2020-02-27 06:54:05 -06:00
|
|
|
file, and issue a warning for root user. It can also be configured
|
|
|
|
at compile-time to only issue a warning for all users.
|
|
|
|
|
2020-05-19 03:31:19 -05:00
|
|
|
.SH EXIT STATUS
|
2012-12-12 03:48:01 -06:00
|
|
|
Returns 0 if operation was successful, 1 if operation failed or command syntax was not valid.
|
2020-05-21 02:28:21 -05:00
|
|
|
.SH AUTHORS
|
|
|
|
Salvatore Valente <svalente@mit.edu>
|
2020-05-19 03:31:19 -05:00
|
|
|
.SH SEE ALSO
|
2006-12-06 17:25:32 -06:00
|
|
|
.BR login (1),
|
2018-05-18 19:09:56 -05:00
|
|
|
.BR login.defs (5),
|
2006-12-06 17:25:32 -06:00
|
|
|
.BR passwd (5),
|
|
|
|
.BR shells (5)
|
2007-07-02 18:17:04 -05:00
|
|
|
.SH AVAILABILITY
|
2010-11-30 04:41:59 -06:00
|
|
|
The chsh command is part of the util-linux package and is available from
|
2016-12-17 02:06:57 -06:00
|
|
|
https://www.kernel.org/pub/linux/utils/util-linux/.
|