granicus.if.org Git - shadow/blob - man/chgpasswd.8.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <refentry id='chgpasswd.8'>
   3   <!-- $Id: chgpasswd.8.xml,v 1.2 2006/06/01 01:29:41 kloczek Exp $ -->
   4   <refmeta>
   5     <refentrytitle>chgpasswd</refentrytitle>
   6     <manvolnum>8</manvolnum>
   7     <refmiscinfo class="sectdesc">System Management Commands</refmiscinfo>
   8   </refmeta>
   9   <refnamediv id='name'>
  10     <refname>chgpasswd</refname>
  11     <refpurpose>update group passwords in batch mode</refpurpose>
  12   </refnamediv>
  13
  14   <refsynopsisdiv id='synopsis'>
  15     <cmdsynopsis>
  16       <command>chgpasswd</command>
  17       <arg choice='opt'>
  18         <replaceable>options</replaceable>
  19       </arg>
  20     </cmdsynopsis>
  21   </refsynopsisdiv>
  22
  23   <refsect1 id='description'>
  24     <title>DESCRIPTION</title>
  25     <para>
  26       <command>chgpasswd</command> reads a list of group name and password
  27       pairs from standard input and uses this information to update a set
  28       of existing groups. Each line is of the format:
  29     </para>
  30     <para>
  31       <emphasis remap='I'>group_name</emphasis>:<emphasis
  32       remap='I'>password</emphasis>
  33     </para>
  34     <para>
  35       By default the supplied password must be in clear-text. Default
  36       encryption algorithm is DES.
  37     </para>
  38     <para>
  39       This command is intended to be used in a large system environment
  40       where many accounts are created at a single time.
  41     </para>
  42   </refsect1>
  43
  44   <refsect1 id='options'>
  45     <title>OPTIONS</title>
  46     <para>
  47       The options which apply to the <command>chgpasswd</command> command
  48       are:
  49     </para>
  50     <variablelist remap='IP'>
  51       <varlistentry>
  52         <term><option>-e</option>, <option>--encrypted</option></term>
  53         <listitem>
  54           <para>Supplied passwords are in encrypted form.</para>
  55         </listitem>
  56       </varlistentry>
  57       <varlistentry>
  58         <term><option>-h</option>, <option>--help</option></term>
  59         <listitem>
  60           <para>Display help message and exit.</para>
  61         </listitem>
  62       </varlistentry>
  63       <varlistentry>
  64         <term><option>-m</option>, <option>--md5</option></term>
  65         <listitem>
  66           <para>
  67             Use MD5 encryption instead DES when the supplied passwords are
  68             not encrypted.
  69           </para>
  70         </listitem>
  71       </varlistentry>
  72     </variablelist>
  73   </refsect1>
  74
  75   <refsect1 id='caveats'>
  76     <title>CAVEATS</title>
  77     <para>
  78       Remember to set permissions or umask to prevent readability of
  79       unencrypted files by other users.
  80     </para>
  81   </refsect1>
  82
  83   <refsect1 id='see_also'>
  84     <title>SEE ALSO</title>
  85     <para>
  86       <citerefentry>
  87         <refentrytitle>gpasswd</refentrytitle><manvolnum>1</manvolnum>
  88       </citerefentry>,
  89       <citerefentry>
  90         <refentrytitle>groupadd</refentrytitle><manvolnum>8</manvolnum>
  91       </citerefentry>.
  92     </para>
  93   </refsect1>
  94 </refentry>