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 .\"  $Author: faith $
  10 .\"  $Revision: 1.1 $
  11 .\"  $Date: 1995/03/12 01:28:58 $
  12 .\"
  13 .TH CHSH 1 "7 October 1998" "chsh" "Linux Reference Manual"
  14 .SH NAME
  15 chsh \- change your login shell
  16 .SH SYNOPSIS
  17 .B chsh
  18 .RB [ \-s
  19 .IR shell ]
  20 .RB [ \-l ]
  21 .RB [ \-u ]
  22 .RB [ \-v ]
  23 .RI [ username ]
  24 .SH DESCRIPTION
  25 .B chsh
  26 is used to change your login shell.
  27 If a shell is not given on the command line,
  28 .B chsh
  29 prompts for one.
  30
  31 .B chsh
  32 is used to change local entries only. Use ypchsh, lchsh or any other
  33 implementation for non-local entries.
  34 .SS VALID SHELLS
  35 .B chsh
  36 will accept the full pathname of any executable file on the system.
  37 However, it will issue a warning if the shell is not listed in the
  38 .I /etc/shells
  39 file.
  40 On the other hand, it can also be configured such that it will
  41 only accept shells listed in this file, unless you are root.
  42 .SH OPTIONS
  43 .TP
  44 .BI "\-s, \-\-shell " shell
  45 Specify your login shell.
  46 .TP
  47 .B "\-l, \-\-list-shells"
  48 Print the list of shells listed in
  49 .I /etc/shells
  50 and exit.
  51 .TP
  52 .B "\-u, \-\-help"
  53 Print a usage message and exit.
  54 .TP
  55 .B "-v, \-\-version"
  56 Print version information and exit.
  57 .SH "SEE ALSO"
  58 .BR login (1),
  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-ng package and is available from
  65 ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/.