blob: 6e00df311001b4bada0ba46e4d491ef24b972f1b [file] [log] [blame]
.\"
.\" 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 "7 October 1998" "chsh" "Linux Reference Manual"
.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.
.SS 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 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"
Print a usage message and exit.
.TP
.B "-v, \-\-version"
Print version information and exit.
.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-ng package and is available from
ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/.