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

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <refentry id='vipw.8'>
   3   <!--  $Id: vipw.8.xml,v 1.18 2006/05/20 12:11:38 kloczek Exp $  -->
   4   <refmeta>
   5     <refentrytitle>vipw</refentrytitle>
   6     <manvolnum>8</manvolnum>
   7     <refmiscinfo class="sectdesc">System Management Commands</refmiscinfo>
   8   </refmeta>
   9   <refnamediv id='name'>
  10     <refname>vipw</refname>
  11     <refname>vigr</refname>
  12     <refpurpose>
  13       edit the password, group, shadow-password or shadow-group file
  14     </refpurpose>
  15   </refnamediv>
  16
  17   <refsynopsisdiv id='synopsis'>
  18     <cmdsynopsis>
  19       <command>vipw</command><arg choice='opt'>options</arg>
  20     </cmdsynopsis>
  21     <cmdsynopsis>
  22       <command>vigr</command><arg choice='opt'>options</arg>
  23     </cmdsynopsis>
  24   </refsynopsisdiv>
  25
  26   <refsect1 id='description'>
  27     <title>DESCRIPTION</title>
  28     <para>
  29       <command>vipw</command> and <command>vigr</command> will edit the
  30       files <filename>/etc/passwd</filename> and
  31       <filename>/etc/group</filename>, respectively. With the
  32       <option>-s</option> flag, they will edit the shadow versions of those
  33       files, <filename>/etc/shadow</filename> and
  34       <filename>/etc/gshadow</filename>, respectively. The programs will set
  35       the appropriate locks to prevent file corruption. When looking for an
  36       editor, the programs will first try the environment variable
  37       <envar>$VISUAL</envar>, then the environment variable
  38       <envar>$EDITOR</envar>, and finally the default editor,
  39       <citerefentry><refentrytitle>vi</refentrytitle>
  40       <manvolnum>1</manvolnum></citerefentry>.
  41     </para>
  42   </refsect1>
  43
  44   <refsect1 id='options'>
  45     <title>OPTIONS</title>
  46     <para>
  47       The options which apply to the <command>vipw</command> and
  48       <command>vigr</command> commands are:
  49     </para>
  50     <variablelist remap='IP'>
  51       <varlistentry>
  52         <term><option>-g</option>, <option>--group</option></term>
  53         <listitem>
  54           <para>Edit group database.</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>-p</option>, <option>--passwd</option></term>
  65         <listitem>
  66           <para>Edit passwd database.</para>
  67         </listitem>
  68       </varlistentry>
  69       <varlistentry>
  70         <term><option>-q</option>, <option>--quiet</option></term>
  71         <listitem>
  72           <para>Quiet mode.</para>
  73         </listitem>
  74       </varlistentry>
  75       <varlistentry>
  76         <term><option>-s</option>, <option>--shadow</option></term>
  77         <listitem>
  78           <para>Edit shadow or gshadow database.</para>
  79         </listitem>
  80       </varlistentry>
  81     </variablelist>
  82   </refsect1>
  83
  84   <refsect1 id='files'>
  85     <title>FILES</title>
  86     <variablelist>
  87       <varlistentry>
  88         <term><filename>/etc/group</filename></term>
  89         <listitem>
  90           <para>Group account information.</para>
  91         </listitem>
  92       </varlistentry>
  93       <varlistentry>
  94         <term><filename>/etc/gshadow</filename></term>
  95         <listitem>
  96           <para>Secure group account information.</para>
  97         </listitem>
  98       </varlistentry>
  99       <varlistentry>
 100         <term><filename>/etc/passwd</filename></term>
 101         <listitem>
 102           <para>User account information.</para>
 103         </listitem>
 104       </varlistentry>
 105       <varlistentry>
 106         <term><filename>/etc/shadow</filename></term>
 107         <listitem>
 108           <para>Secure user account information.</para>
 109         </listitem>
 110       </varlistentry>
 111     </variablelist>
 112   </refsect1>
 113   <refsect1 id='see_also'>
 114     <title>SEE ALSO</title>
 115     <para>
 116       <citerefentry>
 117         <refentrytitle>vi</refentrytitle><manvolnum>1</manvolnum>
 118       </citerefentry>,
 119       <citerefentry>
 120         <refentrytitle>group</refentrytitle><manvolnum>5</manvolnum>
 121       </citerefentry>,
 122       <citerefentry>
 123         <refentrytitle>gshadow</refentrytitle><manvolnum>5</manvolnum>
 124       </citerefentry>
 125       <citerefentry>
 126         <refentrytitle>passwd</refentrytitle><manvolnum>5</manvolnum>
 127       </citerefentry>,
 128       <citerefentry>
 129         <refentrytitle>shadow</refentrytitle><manvolnum>5</manvolnum>
 130       </citerefentry>.
 131     </para>
 132   </refsect1>
 133 </refentry>