manual/shadow/original/man8/mkpasswd.8

   1 .\"$Id: mkpasswd.8,v 1.8 2002/03/08 04:39:11 kloczek Exp $
   2 .\" Copyright 1991, Julianne Frances Haugh
   3 .\" All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in the
  12 .\"    documentation and/or other materials provided with the distribution.
  13 .\" 3. Neither the name of Julianne F. Haugh nor the names of its contributors
  14 .\"    may be used to endorse or promote products derived from this software
  15 .\"    without specific prior written permission.
  16 .\"
  17 .\" THIS SOFTWARE IS PROVIDED BY JULIE HAUGH AND CONTRIBUTORS ``AS IS'' AND
  18 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  19 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  20 .\" ARE DISCLAIMED.  IN NO EVENT SHALL JULIE HAUGH OR CONTRIBUTORS BE LIABLE
  21 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  22 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  23 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  24 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  25 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  26 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  27 .\" SUCH DAMAGE.
  28 .TH MKPASSWD 1
  29 .SH NAME
  30 mkpasswd \- Update passwd and group database files
  31 .SH SYNOPSIS
  32 \fBmkpasswd\fR [\fB-fvgps\fR] \fIfile\fR
  33 .SH DESCRIPTION
  34 .B mkpasswd
  35 reads the file in the format given by the flags and converts it to the
  36 corresponding database file format.
  37 These database files are used to improve access performance on systems
  38 with large numbers of users.
  39 The output files will be named \fIfile\fR.dir and \fIfile\fR.pag.
  40 .PP
  41 The \fB-f\fR option causes \fBmkpasswd\fR to ignore any existing output
  42 files and overwrite them.
  43 Normally \fBmkpasswd\fR complains about existing output files and quits.
  44 .PP
  45 The \fB-v\fR option causes \fBmkpasswd\fR to output information about
  46 each record as it is converted, with a final message at the very end.
  47 .PP
  48 The \fB-g\fR option treats the input file as though it were in
  49 \fI/etc/group\fR file format.
  50 When combined with the \fB-s\fR option, the \fI/etc/gshadow\fR file
  51 format is used instead.
  52 .PP
  53 The \fB-p\fR option treats the input file as though it were in
  54 \fI/etc/passwd\fR file format.
  55 This is the default.
  56 When combined with the \fB-s\fR option, the \fI/etc/shadow\fR file
  57 format is used instead.
  58 .SH CAVEATS
  59 The use of more than one database file is limited to systems which
  60 include the NDBM database library and therefore may not be available
  61 on every system.
  62 .SH NOTE
  63 Since most commands are capable of updating the database files as
  64 changes are made, this command need only be used when re-creating a
  65 deleted or corrupted database file.
  66 .SH FILES
  67 /etc/passwd \- user account information
  68 .br
  69 /etc/shadow \- shadow user information
  70 .br
  71 /etc/group \- group information
  72 .br
  73 /etc/gshadow \- shadow group information
  74 .SH SEE ALSO
  75 .BR group (5),
  76 .BR passwd (5),
  77 .BR shadow (5)
  78 .SH AUTHOR
  79 Julianne Frances Haugh (jockgrrl@ix.netcom.com)