'\"macro stdmacro
.if n .pH g1a.pwconv @(#)pwconv	40.4 of 10/10/89
.\" Copyright 1989 AT&T
.nr X
.if \nX=0 .ds x} pwconv 1M "" "\&"
.if \nX=1 .ds x} pwconv 1M ""
.if \nX=2 .ds x} pwconv 1M "" "\&"
.if \nX=3 .ds x} pwconv "" "" "\&"
.TH \*(x}
.SH NAME
\f4pwconv\f1 \- Installs and updates
\f4/etc/shadow\f1
with information from
\f4/etc/passwd\f1
.SH SYNOPSIS
\f4pwconv\f1
.SH DESCRIPTION
The \f4pwconv\fP command
creates and updates 
\f4/etc/shadow\f1
with information from 
\f4/etc/passwd\f1.
.PP
If the
\f4/etc/shadow \f1
file does not exist, this command will create 
\f4/etc/shadow \f1
with information from
\f4/etc/passwd\f1.
The command populates 
\f4/etc/shadow \f1
with the user's login name, password, and password aging information.
If 
password aging information does not exist in 
\f4/etc/passwd \f1
for a given user, none will be added to 
\f4/etc/shadow\f1.
However, the last changed information will
always be updated.
.PP
If the 
\f4/etc/shadow \f1
file does exist, the following tasks will be performed:
.IP
Entries that are in the 
\f4/etc/passwd \f1
file and not in the
\f4/etc/shadow \f1
file will be added to the \f4/etc/shadow\f1 file.
.IP
Entries that are in the 
\f4/etc/shadow\f1
file and not in the
\f4/etc/passwd\f1
file will be removed from \f4/etc/shadow\f1.
.IP
Password attributes (e.g., password and aging information) 
that exist in an
\f4/etc/passwd \f1
entry will be moved to the corresponding entry in 
\f4/etc/shadow.\f1
.PP
The \f4pwconv\fP program
is a privileged system command that cannot be executed by ordinary users.
.SH FILES
\f4/etc/passwd\f1, \f4/etc/shadow\f1, \f4/etc/opasswd\f1, \f4/etc/oshadow\f1
.SH "SEE ALSO"
\f4passwd\fP(1), \f4passmgmt\fP(1M)
.SH DIAGNOSTICS
The
\f4pwconv\f1
command exits with one of the following values:
.IP 0 10
SUCCESS.
.IP 1 10
Permission denied.
.IP 2 10
Invalid command syntax.
.IP 3 10
Unexpected failure.  Conversion not done.
.IP 4 10
Unexpected failure.  Password file(s) missing.
.IP 5 10
Password file(s) busy.  Try again later.

