summaryrefslogblamecommitdiffstats
path: root/login-utils/chsh.1
blob: d597adc38e3de9afcf7369a42b45cd91ad5d3b86 (plain) (tree)
1
2
3
4
5
6
7
8







                                                                 


                                 
   
                                                   



                               





                





                                            



                                                                    

           
                           

                         
                         



                                  
                  

                               
                    
                                   









                                                                                             





                                    
                

                                                                        
.\"
.\"  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/.