usr/src/man/man1m/pwconv.1m

   1 '\" te
   2 .\" Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved.
   3 .\" Copyright 1989 AT&T
   4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   7 .TH PWCONV 1M "Mar 9, 1993"
   8 .SH NAME
   9 pwconv \- installs and updates /etc/shadow with information from /etc/passwd
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fBpwconv\fR
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 The \fBpwconv\fR command creates and updates \fB/etc/shadow\fR with information
  20 from \fB/etc/passwd\fR.
  21 .sp
  22 .LP
  23 \fBpwconv\fR relies on a special value of 'x' in the password field of
  24 \fB/etc/passwd.\fR This value of 'x' indicates that the password for the user
  25 is already in \fB/etc/shadow\fR and should not be modified.
  26 .sp
  27 .LP
  28 If the \fB/etc/shadow\fR file does not exist, this command will create
  29 \fB/etc/shadow\fR with information from \fB/etc/passwd\fR. The command
  30 populates \fB/etc/shadow\fR with the user's login name, password, and password
  31 aging information. If password aging information does not exist in
  32 \fB/etc/passwd\fR for a given user, none will be added to  \fB/etc/shadow\fR.
  33 However, the last changed information will always be updated.
  34 .sp
  35 .LP
  36 If the  \fB/etc/shadow\fR file does exist, the following tasks will be
  37 performed:
  38 .sp
  39 .ne 2
  40 .na
  41 \fB\fR
  42 .ad
  43 .sp .6
  44 .RS 4n
  45 Entries that are in the  \fB/etc/passwd\fR file and not in the
  46 \fB/etc/shadow\fR file will be added to the \fB/etc/shadow\fR file.
  47 .RE
  48
  49 .sp
  50 .ne 2
  51 .na
  52 \fB\fR
  53 .ad
  54 .sp .6
  55 .RS 4n
  56 Entries that are in the  \fB/etc/shadow\fR file and not in the
  57 \fB/etc/passwd\fR file will be removed from \fB/etc/shadow\fR.
  58 .RE
  59
  60 .sp
  61 .ne 2
  62 .na
  63 \fB\fR
  64 .ad
  65 .sp .6
  66 .RS 4n
  67 Password attributes (for example, password and aging information)  that exist
  68 in an \fB/etc/passwd\fR entry will be moved to the corresponding entry in
  69 \fB/etc/shadow\fR.
  70 .RE
  71
  72 .sp
  73 .LP
  74 The \fBpwconv\fR command can only be used by the super-user.
  75 .SH FILES
  76 .sp
  77 .ne 2
  78 .na
  79 \fB\fB/etc/opasswd\fR\fR
  80 .ad
  81 .RS 16n
  82
  83 .RE
  84
  85 .sp
  86 .ne 2
  87 .na
  88 \fB\fB/etc/oshadow\fR\fR
  89 .ad
  90 .RS 16n
  91
  92 .RE
  93
  94 .sp
  95 .ne 2
  96 .na
  97 \fB\fB/etc/passwd\fR\fR
  98 .ad
  99 .RS 16n
 100
 101 .RE
 102
 103 .sp
 104 .ne 2
 105 .na
 106 \fB\fB/etc/shadow\fR\fR
 107 .ad
 108 .RS 16n
 109
 110 .RE
 111
 112 .SH SEE ALSO
 113 .sp
 114 .LP
 115 \fBpasswd\fR(1), \fBpassmgmt\fR(1M), \fBusermod\fR(1M), \fBpasswd\fR(4),
 116 \fBattributes\fR(5)
 117 .SH DIAGNOSTICS
 118 .sp
 119 .LP
 120 \fBpwconv\fR exits with one of the following values:
 121 .sp
 122 .ne 2
 123 .na
 124 \fB\fB0\fR\fR
 125 .ad
 126 .RS 5n
 127 \fBSUCCESS.\fR
 128 .RE
 129
 130 .sp
 131 .ne 2
 132 .na
 133 \fB\fB1\fR\fR
 134 .ad
 135 .RS 5n
 136 Permission denied.
 137 .RE
 138
 139 .sp
 140 .ne 2
 141 .na
 142 \fB\fB2\fR\fR
 143 .ad
 144 .RS 5n
 145 Invalid command syntax.
 146 .RE
 147
 148 .sp
 149 .ne 2
 150 .na
 151 \fB\fB3\fR\fR
 152 .ad
 153 .RS 5n
 154 Unexpected failure.  Conversion not done.
 155 .RE
 156
 157 .sp
 158 .ne 2
 159 .na
 160 \fB\fB4\fR\fR
 161 .ad
 162 .RS 5n
 163 Unexpected failure.  Password file(s) missing.
 164 .RE
 165
 166 .sp
 167 .ne 2
 168 .na
 169 \fB\fB5\fR\fR
 170 .ad
 171 .RS 5n
 172 Password file(s) busy.  Try again later.
 173 .RE
 174
 175 .sp
 176 .ne 2
 177 .na
 178 \fB\fB6\fR\fR
 179 .ad
 180 .RS 5n
 181 Bad entry in \fB/etc/shadow\fR file.
 182 .RE
 183