path: root/login-utils/chsh.1

.\"
.\"  chsh.1 -- change your login shell
.\"  (c) 1994 by salvatore valente <svalente@athena.mit.edu>
.\"
.\"  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.
.\"
.\"  $Author: faith $
.\"  $Revision: 1.1 $
.\"  $Date: 1995/03/12 01:28:58 $
.\"
.TH CHSH 1 "July 2009" "util-linux" "User Commands"
.SH NAME
chsh \- change your login shell
.SH SYNOPSIS
.B chsh
.RB [ \-s
.IR shell ]
.RB [ \-l ]
.RB [ \-u ]
.RB [ \-v ]
.RI [ username ]
.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.

.B chsh
supports non-local entries (kerberos, LDAP, etc.\&) if linked with libuser,
otherwise use ypchsh, lchsh or any other implementation for non-local
entries.
.SH OPTIONS
.TP
.BI "\-s, \-\-shell " shell
Specify your login shell.
.TP
.B "\-l, \-\-list-shells"
Print the list of shells listed in
.I /etc/shells
and exit.
.TP
.B "\-u, \-\-help"
Display help text and exit.
.TP
.B "\-v, \-\-version"
Display version information and exit.
.SH "VALID SHELLS"
.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
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.
.SH "EXIT STATUS"
Returns 0 if operation was successful, 1 if operation failed or command syntax was not valid.
.SH "SEE ALSO"
.BR login (1),
.BR passwd (5),
.BR shells (5)
.SH AUTHOR
Salvatore Valente <svalente@mit.edu>
.SH AVAILABILITY
The chsh command is part of the util-linux package and is available from
ftp://ftp.kernel.org/pub/linux/utils/util-linux/.