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, project, 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 discrepencies between /etc/passwd and /etc/passwd.map, run crpasswd after modifying 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 network registry.  Otherwise, 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. 

DOMAIN/IX does not support the distinction between real and effective user and group identifications (IDs). 

NOTES

It is not necessary (nor is it advisable) to delete the /etc/passwd and /etc/group files before you run crpasswd, as crpasswd can create new entries in these files without affecting the existing ones. 

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)
Administering Your DOMAIN System, DOMAIN System Command Reference.