irix - pwconv (1)




NAME
     pwconv - install and update /etc/shadow with information from /etc/passwd


SYNOPSIS
     pwconv


DESCRIPTION
     The pwconv	command	creates	and updates /etc/shadow	with information from
     /etc/passwd.

     If	the /etc/shadow	file does not exist, pwconv creates /etc/shadow	with
     information from /etc/passwd.  The	command	populates /etc/shadow with the
     user's login name,	password, and password aging information.  If password
     aging information does not	exist in /etc/passwd for a given user, none is
     added to /etc/shadow.  However, the last changed information is always
     updated.

     If	the /etc/shadow	file does exist, the following tasks are performed:

     o	Entries	that are in the	/etc/passwd file and not in the	/etc/shadow
	file are added to the /etc/shadow file.

     o	Entries	that are in the	/etc/shadow file and not in the	/etc/passwd
	file are removed from /etc/shadow.

     o	Password attributes (for example, password and aging information) in
	an /etc/passwd entry are moved to the corresponding entry in
	/etc/shadow.

     The pwconv	program	is a privileged	system command that cannot be executed
     by	ordinary users.

     The contents of the /etc/passwd and /etc/shadow files are saved in
     /etc/opasswd and /etc/oshadow, respectively.  The system can be restored
     to	its preconversion state	by replacing the content of the	/etc/passwd
     file with the content of /etc/opasswd and removal of /etc/shadow (if it
     did not exist prior to the	run of pwconv) or its replacement by
     /etc/oshadow.  These files	are overwritten	each time the pwconv program
     is	run.  The use of some of the system administration tools causes	pwconv
     to	be run,	and therefore the backup files to be overwritten, each time an
     entry is added, deleted, or modified.


NOTES
     There is no NIS equivalent	to /etc/shadow.	 Therefore, if a user does not
     have an entry in /etc/shadow, they	can not	log in.	 This is because the
     password field must come from /etc/shadow.	 Other NIS information such as
     user name,	home directory,	and so on is still available, just not
     passwords.

     pwconv does not copy NIS entries from /etc/passwd.	 In order for such
     users to be able to log in, entries in /etc/shadow	must be	created	by


FILES
     /etc/passwd
     /etc/shadow
     /etc/opasswd
     /etc/oshadow


SEE ALSO
     passwd(1).


DIAGNOSTICS
     The pwconv	command	exits with one of the following	values:

     0	  Success.
     1	  Permission denied.
     2	  Invalid command syntax.
     3	  Unexpected failure.  Conversion not done.
     4	  Unexpected failure.  Password	file(s)	missing.
     5	  Password file(s) busy.  Try again later.