68 lines
1.7 KiB
Groff
68 lines
1.7 KiB
Groff
.\"
|
|
.\" 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
|
|
is used to change local entries only. 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"
|
|
Print a usage message and exit.
|
|
.TP
|
|
.B "-v, \-\-version"
|
|
Print 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/.
|