TLS621 - the ap(1M) Utility port for UnixWare 2.1.x =================================================== To install this TLS, simply copy the archive to a temporary directory, eg. /tmp then, using the root account follow these steps: # cd /tmp # uncompress tls621.Z # mv tls621 /usr/sbin/ap # chown root:sys /usr/sbin/ap # chmod 550 /usr/sbin/ap ------------------------------------------------------------------------------ ap(1M) _________________________________________________________________ ap -- dump and load user account profiles Synopsis ap -d [ -g ] [ -v ] [ usernames ] Description ap for UnixWare 2.1.3 allows an administrator to dump UnixWare® 2.1.3 accounts to a file for migration to a UnixWare® 7 system. An account profile entry consists of a user's entry from the password file followed by all relevant parts of their I&A (UnixWare) or Protected Password (SCO OpenServer) database entry. The following database fields are irrelevant and are not copied: * time of last unsuccessful password change * time of last successful and last unsuccessful login * terminal of last successful and last unsuccessful login * number of consecutive unsuccessful logins ap understands the following options: -d Write an account profile entry to the standard output for each username specified. If no usernames are specified, account profiles are written for all users listed in the password file. -g Include group membership in the account profile information that is written out by the -d option. -v Print a message to the standard error for each account profile dumped or restored. Files Common files: /etc/group group file /etc/passwd password file /etc/shadow shadow password file SCO OpenServer only: /etc/default/accounts user and group defaults' file /tcb/files/auth/?/ * Protected Password database /etc/auth/subsystems/ * Subsystem Authorizations database UnixWare only: /etc/default/useradd user defaults' file /etc/security/ia/ageduid aged user ID file /etc/security/ia/audit master audit file (if auditing is installed) /etc/security/ia/index I&A master index file /etc/security/ia/master I&A master database /etc/security/tcb/privs system command privilege database /etc/security/tfm/users/ * user authorizations /etc/security/tfm/roles/ * administrative role authorizations Authorization ap requires the invoking user to be root or to have dacread and dacwrite privileges. Exit values If ap detects a fatal error, it displays an appropriate error message and exits with status greater than zero. If no errors are encountered, ap exits with status zero. References filepriv(1M), group(4), groupadd(1M), groupdel(1M), groupmod(1M), logins(1M), passwd(4), shadow(4), useradd(1M), userdel(1M), usermod(1M) Notices Account profiles dumped on one UnixWare system can only be restored on another UnixWare systems. They cannot be restored to an SCO OpenServer system because UnixWare encrypted passwords are not transferable to SCO OpenServer. You cannot use the UDK to run the UnixWare 7 version of ap on UnixWare 2.1 because long passwords are only supported in UnixWare 7. A version of ap that runs on UnixWare 2.1 is separately available for downloading from the SCO Secure Technologies Group. As UnixWare systems may have different system default values, the same profile transferred to another UnixWare system may give the user different capabilities simply because different default values are picked up for fields that are not present in the profile entry for a user. As the file containing the dumped account profile information is used to update the password and Identification and Authentication (I&A) database, it must be protected from unauthorized access in the same way that entries in the I&A database themselves are protected. Standards compliance ap is not part of any currently supported standard; it is an extension of AT&T System V provided by The Santa Cruz Operation, Inc. Examples To dump the account profiles for users fred and guest on an SCO OpenServer system to a file called profiles, and display a message after each account profile is dumped: ap -dv fred guest > profiles.acct This file can then be transferred to a UnixWare machine. To restore the account profile for user fred on a UnixWare system, overwriting any existing profile, and substituting the password ``clydenw'' if the existing password is longer than 8 characters: ap -ro -f profiles.acct -p clydenw fred _________________________________________________________________ 5 November 1999 © 1999 The Santa Cruz Operation, Inc. All rights reserved. UnixWare 7 Release 7.1.1 - 5 November 1999