chapter09/etcshells.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE part PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   3    "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
   4   <!ENTITY % general-entities SYSTEM "../general.ent">
   5   %general-entities;
   6 ]>
   7
   8 <sect1 id="ch-config-shells" xreflabel="Creating the /etc/shells File">
   9   <?dbhtml filename="etcshells.html"?>
  10
  11   <title>Creating the /etc/shells File</title>
  12
  13   <indexterm zone="ch-config-shells">
  14     <primary sortas="e-etc-shells">/etc/shells</primary>
  15   </indexterm>
  16
  17   <para>The <filename>shells</filename> file contains a list of
  18   login shells on the system. Applications use this file to determine
  19   whether a shell is valid. For each shell a single line should be
  20   present, consisting of the shell's path relative to the root of the
  21   directory structure (/).</para>
  22
  23   <para>For example, this file is consulted by <command>chsh</command>
  24   to determine whether an unprivileged user may change the login shell for her
  25   own account. If the command name is not listed, the user will be denied the
  26   ability to change shells.</para>
  27
  28   <para>It is a requirement for applications such as
  29   <application>GDM</application> which does not populate the
  30   face browser if it can't find <filename>/etc/shells</filename>, or
  31   FTP daemons which traditionally disallow access to users
  32   with shells not included in this file.</para>
  33
  34 <screen role="root"><userinput>cat &gt; /etc/shells &lt;&lt; "EOF"
  35 <literal># Begin /etc/shells
  36
  37 /bin/sh
  38 /bin/bash
  39
  40 # End /etc/shells</literal>
  41 EOF</userinput></screen>
  42
  43 </sect1>