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 .sp
  50 The default behavior for non-root users is to accept only shells
  51 listed in the
  52 .I /etc/shells
  53 file, and issue a warning for root user.  It can also be configured
  54 at compile-time to only issue a warning for all users.
  55
  56 .SH EXIT STATUS
  57 Returns 0 if operation was successful, 1 if operation failed or command syntax was not valid.
  58 .SH SEE ALSO
  59 .BR login (1),
  60 .BR login.defs (5),
  61 .BR passwd (5),
  62 .BR shells (5)
  63 .SH AUTHOR
  64 Salvatore Valente <svalente@mit.edu>
  65 .SH AVAILABILITY
  66 The chsh command is part of the util-linux package and is available from
  67 https://www.kernel.org/pub/linux/utils/util-linux/.