man/chsh.1

   1 '\" t
   2 .\"     Title: chsh
   3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
   4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
   5 .\"      Date: 02/16/2011
   6 .\"    Manual: User Commands
   7 .\"    Source: User Commands
   8 .\"  Language: English
   9 .\"
  10 .TH "CHSH" "1" "02/16/2011" "User Commands" "User Commands"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "NAME"
  31 chsh \- change login shell
  32 .SH "SYNOPSIS"
  33 .HP \w'\fBchsh\fR\ 'u
  34 \fBchsh\fR [\fIoptions\fR] [\fILOGIN\fR]
  35 .SH "DESCRIPTION"
  36 .PP
  37 The
  38 \fBchsh\fR
  39 command changes the user login shell\&. This determines the name of the user\*(Aqs initial login command\&. A normal user may only change the login shell for her own account, the superuser may change the login shell for any account\&.
  40 .SH "OPTIONS"
  41 .PP
  42 The options which apply to the
  43 \fBchsh\fR
  44 command are:
  45 .PP
  46 \fB\-h\fR, \fB\-\-help\fR
  47 .RS 4
  48 Display help message and exit\&.
  49 .RE
  50 .PP
  51 \fB\-s\fR, \fB\-\-shell\fR \fISHELL\fR
  52 .RS 4
  53 The name of the user\*(Aqs new login shell\&. Setting this field to blank causes the system to select the default login shell\&.
  54 .RE
  55 .PP
  56 If the
  57 \fB\-s\fR
  58 option is not selected,
  59 \fBchsh\fR
  60 operates in an interactive fashion, prompting the user with the current login shell\&. Enter the new value to change the shell, or leave the line blank to use the current one\&. The current shell is displayed between a pair of
  61 \fI[ ]\fR
  62 marks\&.
  63 .SH "NOTE"
  64 .PP
  65 The only restriction placed on the login shell is that the command name must be listed in
  66 /etc/shells, unless the invoker is the superuser, and then any value may be added\&. An account with a restricted login shell may not change her login shell\&. For this reason, placing
  67 /bin/rsh
  68 in
  69 /etc/shells
  70 is discouraged since accidentally changing to a restricted shell would prevent the user from ever changing her login shell back to its original value\&.
  71 .SH "CONFIGURATION"
  72 .PP
  73 The following configuration variables in
  74 /etc/login\&.defs
  75 change the behavior of this tool:
  76 .PP
  77 \fBCHSH_AUTH\fR (boolean)
  78 .RS 4
  79 If
  80 \fIyes\fR, the
  81 \fBchsh\fR
  82 program will require authentication before making any changes, unless run by the superuser\&.
  83 .RE
  84 .PP
  85 \fBLOGIN_STRING\fR (string)
  86 .RS 4
  87 The string used for prompting a password\&. The default is to use "Password: ", or a translation of that string\&. If you set this variable, the prompt will no be translated\&.
  88 .sp
  89 If the string contains
  90 \fI%s\fR, this will be replaced by the user\*(Aqs name\&.
  91 .RE
  92 .SH "FILES"
  93 .PP
  94 /etc/passwd
  95 .RS 4
  96 User account information\&.
  97 .RE
  98 .PP
  99 /etc/shells
 100 .RS 4
 101 List of valid login shells\&.
 102 .RE
 103 .PP
 104 /etc/login\&.defs
 105 .RS 4
 106 Shadow password suite configuration\&.
 107 .RE
 108 .SH "SEE ALSO"
 109 .PP
 110
 111 \fBchfn\fR(1),
 112 \fBlogin.defs\fR(5),
 113 \fBpasswd\fR(5)\&.