userdbck(1M)

NAME

userdbck — verify or fix information in the user database, /var/adm/userdb

/usr/sbin/userdbck [-a] [-u] [-r] [-f] [file]

userdbck verifies the information in the user database (/var/adm/userdb), reports inconsistencies, and fixes problems.

If no options and no arguments are specified, userdbck reports all data corruption problems in all files in /var/adm/userdb.

If the -r option is also specified, each reported problem is repaired.

If a file argument (hex 00-ff) is specified, only that file in the /var/adm/userdb directory is verified.

The following options are recognized:

-a: Verify attributes. Information in /etc/security.dsc is used to report any attribute that is not valid, not allowed in the user database, has an invalid value, or is allowed only for a local user and the user is not in /etc/passwd.
-f: Normally when the user database is disabled (see userdb(4)), userdbck immediately exits without verifying or repairing the database. The -f option overrides this and forces userdbck to verify or repair the database.
-u: Verify user names. User names found in the database are reported if they do not exist in any of the repositories defined in /etc/nsswitch.conf. This option could take a long time on a system with many users.
-r: Repair all data corruption problems that are found. If this option is not specified, problems are reported but not repaired.

Only users who have read and write access to /var/adm/userdb can run userdbck.

userdbck exits with one of the following values:

0: success: no inconsistencies were found
1: inconsistencies were found and fixed
2: invalid usage
3: database is disabled; see userdb(4)
4: inconsistencies were found but not fixed, because the -r option was not specified
5: a problem was found that could not be fixed

In the following example, all problems in the user database are reported but not repaired.

/usr/sbin/userdbck 

In the following example, all problems in file /var/adm/userdb/7f are reported and repaired.

/usr/sbin/userdbck -r 7f 