shadow/man/passwd.5.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
		"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
<refentry id='passwd.5'>
  <!-- $Id: passwd.5.xml,v 1.5 2005/04/27 16:44:12 kloczek Exp $ -->
  <refmeta>
    <refentrytitle>passwd</refentrytitle>
    <manvolnum>5</manvolnum>
  </refmeta>
  <refnamediv id='name'>
    <refname>passwd</refname>
    <refpurpose>The password file</refpurpose>
  </refnamediv>
  
  <refsect1 id='description'>
    <title>DESCRIPTION</title>
    <para>
      <filename>/etc/passwd</filename> contains various pieces of
      information for each user account. Included is:
    </para>
    
    <para>Login name</para>
    
    <para>Optional encrypted password</para>
    
    <para>Numerical user ID</para>
    
    <para>Numerical group ID</para>
    
    <para>User name or comment field</para>
    
    <para>User home directory</para>
    
    <para>User command interpreter</para>
    
    <para>The password field may not be filled if shadow passwords have been
      enabled. If shadow passwords are being used, the encrypted password
      will be found in <filename>/etc/shadow</filename>. The encrypted
      password consists of characters from the 64 characters alphabet a thru
      z, A thru Z, 0 thru 9, \. and /. Optionally it can start with a "$"
      character. This means the encrypted password was generated using
      another (not DES) algorithm. For example if it starts with "$1$" it
      means the MD5-based algorithm was used.
    </para>
    
    <para> Refer to <citerefentry>
        <refentrytitle>crypt</refentrytitle><manvolnum>3</manvolnum>
      </citerefentry> for details on how this string is interpreted.
    </para>
    
    <para>The comment field is used by various system utilities, such as
      <citerefentry>
        <refentrytitle>finger</refentrytitle><manvolnum>1</manvolnum>
      </citerefentry>. Three additional values may be present in the comment
      field. They are:
    </para>
    
    <para>pri= - set initial value of nice</para>
    
    <para>umask= - set initial value of umask</para>
    
    <para>ulimit= - set initial value of ulimit</para>
    
    <para>These fields are separated from each other and from any other
      comment field by a comma.
    </para>
    
    <para>The home directory field provides the name of the initial working
      directory. <emphasis remap='B'>Login</emphasis> uses this information
      to set the value of the <envar>$HOME</envar> environmental variable.
    </para>
    
    <para>The command interpreter field provides the name of the user's
      command language interpreter, or the name of the initial program to
      execute. <emphasis remap='B'>Login</emphasis> uses this information
      to set the value of the <envar>$SHELL</envar> environmental variable.
      If this field is empty, it defaults to the value
      <filename>/bin/sh</filename>.
    </para>
  </refsect1>
  
  <refsect1 id='files'>
    <title>FILES</title>
    <variablelist>
      <varlistentry>
        <term><filename>/etc/passwd</filename></term>
        <listitem>user account information</listitem>
      </varlistentry>
    </variablelist>
  </refsect1>
  
  <refsect1 id='see_also'>
    <title>SEE ALSO</title>
    <para>
      <citerefentry>
        <refentrytitle>login</refentrytitle><manvolnum>1</manvolnum>
      </citerefentry>,
      <citerefentry>
        <refentrytitle>passwd</refentrytitle><manvolnum>1</manvolnum>
      </citerefentry>,
      <citerefentry>
        <refentrytitle>su</refentrytitle><manvolnum>1</manvolnum>
      </citerefentry>,
      <citerefentry>
        <refentrytitle>shadow</refentrytitle><manvolnum>5</manvolnum>
      </citerefentry>,
      <citerefentry>
        <refentrytitle>pwconv</refentrytitle><manvolnum>8</manvolnum>
      </citerefentry>,
      <citerefentry>
        <refentrytitle>pwunconv</refentrytitle><manvolnum>8</manvolnum>
      </citerefentry>,
      <citerefentry>
        <refentrytitle>sulogin</refentrytitle><manvolnum>8</manvolnum>
      </citerefentry>
    </para>
  </refsect1>
  
  <refsect1 id='author'>
    <title>AUTHOR</title>
    <para>Julianne Frances Haugh (jockgrrl@ix.netcom.com)</para>
  </refsect1>
</refentry>