CRPASSWD(1M)             DOMAIN/IX SYS5              CRPASSWD(1M)



NAME
     crpasswd - create password and group files

USAGE
     /etc/crpasswd

DESCRIPTION
     The DOMAIN/IX command crpasswd creates UNIX password and
     group files from the DOMAIN network registry's person, pro-
     ject, organization (PPO) file and the site directory's
     ACCOUNT (ACCT) file.  All changes to /etc/passwd and
     /etc/group must be made using crpasswd.  The sole exception
     to this rule is the ``shell'' field of /etc/passwd, which
     cannot be derived from information in the registry and must
     be added by hand.  To prevent discrepancies between
     /etc/passwd and /etc/passwd.map, run crpasswd after modify-
     ing the shell field of /etc/passwd.

     The crpasswd command also creates the file /etc/passwd.map.
     The system calls getuid and getgid use this file to map
     DOMAIN subject identifiers to user and group IDs (and vice
     versa).

     You must invoke crpasswd each the time you update the net-
     work registry.  Otherwise, there will be discrepancies
     between information contained in the registry and informa-
     tion contained in the /etc/passwd.map, /etc/passwd, and
     /etc/group files.  In this event, getuid and getgid will
     return a value of -1 for users not entered in /etc/passwd
     and /etc/group.  The system administrator will typically
     want to have cron run crpasswd once a day.

NOTES
     Do not delete /etc/passwd and /etc/group files before you
     run crpasswd, as crpasswd can update these files.  If you
     accidentally delete any of these files, see System Adminis-
     tration for DOMAIN/IX SYS5 for information about how to
     recover.

     Cron uses setuid(3) to run as ``root,'' so that you may have
     cron run crpasswd to modify password and group files owned
     by ``root.''

RELATED INFORMATION
     getuid(2)
     getgid(2)
     DOMAIN System Command Reference






Printed 12/4/86        DOMAIN System Only              CRPASSWD-1