login-utils/chsh.1

   1 .\"
   2 .\"  chsh.1 -- change your login shell
   3 .\"  (c) 1994 by salvatore valente <svalente@athena.mit.edu>
   4 .\"
   5 .\"  This program is free software.  You can redistribute it and
   6 .\"  modify it under the terms of the GNU General Public License.
   7 .\"  There is no warranty.
   8 .\"
   9 .TH CHSH 1 "July 2014" "util-linux" "User Commands"
  10 .SH NAME
  11 chsh \- change your login shell
  12 .SH SYNOPSIS
  13 .B chsh
  14 .RB [ \-s
  15 .IR shell ]
  16 .RB [ \-l ]
  17 .RB [ \-h ]
  18 .RB [ \-v ]
  19 .RI [ username ]
  20 .SH DESCRIPTION
  21 .B chsh
  22 is used to change your login shell.
  23 If a shell is not given on the command line,
  24 .B chsh
  25 prompts for one.
  26
  27 .B chsh
  28 supports non-local entries (kerberos, LDAP, etc.\&) if linked with libuser,
  29 otherwise use \fBypchsh\fR, \fBlchsh\fR or any other implementation for
  30 non-local entries.
  31 .SH OPTIONS
  32 .TP
  33 .BR \-s , " \-\-shell " \fIshell
  34 Specify your login shell.
  35 .TP
  36 .BR \-l , " \-\-list\-shells"
  37 Print the list of shells listed in
  38 .I /etc/shells
  39 and exit.
  40 .TP
  41 .BR \-h , " \-\-help"
  42 Display help text and exit.
  43 .TP
  44 .BR \-v , " \-\-version"
  45 Display version information and exit.
  46 .SH "VALID SHELLS"
  47 .B chsh
  48 will accept the full pathname of any executable file on the system.
  49 However, it will issue a warning if the shell is not listed in the
  50 .I /etc/shells
  51 file.
  52 On the other hand, it can also be configured such that it will
  53 only accept shells listed in this file, unless you are root.
  54 .SH "EXIT STATUS"
  55 Returns 0 if operation was successful, 1 if operation failed or command syntax was not valid.
  56 .SH "SEE ALSO"
  57 .BR login (1),
  58 .BR login.defs (5),
  59 .BR passwd (5),
  60 .BR shells (5)
  61 .SH AUTHOR
  62 Salvatore Valente <svalente@mit.edu>
  63 .SH AVAILABILITY
  64 The chsh command is part of the util-linux package and is available from
  65 https://www.kernel.org/pub/linux/utils/util-linux/.