userdb_read(3)userdb_read(3)NAMEuserdb_read(), userdb_write(), userdb_delete() - read, write or delete
information in the user database, /var/adm/userdb
SYNOPSISDESCRIPTION
These functions read, write, or delete information in the user data‐
base, which is described in userdb(4).
The argument indicates a specific user entry in the user database.
Attributes are accessed or modified only in this entry.
For element i of the two arrays, is a pointer to the name of an
attribute, and is a pointer to its value represented as text. The
arrays and are terminated by a null character.
reads the values of the attributes specified in the array from the user
database into the corresponding array. If an attribute is not present,
a null string is copied into the array. Each element (except for the
terminating null) of the array is a pointer to a buffer. The size of
each buffer is assumed to be at least bytes, which is defined in
writes the values of the attributes specified in the array from the
corresponding array into the database. For each null string in the
array, the corresponding attribute is deleted; the system-wide default
described in will then apply; see security(4). Attribute values are
allowed to contain only printable ASCII characters (hex 20-7e).
The tab character (hex 09) may also be used for the following special
cases for
Add or subtract
num to or from the current attribute value. Both num and
the current value are assumed to be a string of at most
nine ASCII decimal digits. The current value may also have
an optional sign, and is assumed to have a value of 0 if
the attribute is not defined.
No operation (do not modify the attribute).
deletes a user entry from the database. The user entry contains all of
the configurable and internal attributes for a user.
RETURN VALUE
Upon successful completion, 0 is returned.
ERRORS
If an error occurs, one of the following values is returned.
could not find a database entry for the user specified in the argument
invalid argument
insufficient permission to access the user database
a file system error occurred
the value of one of the
arguments is invalid
the value of one of the
arguments is invalid
overflowed a database block
overflowed the user entry
database lock failure
the database is disabled; see
userdb(4)
the argument is not a valid username
the username specified by the
argument is not a local user in
EXAMPLES
The following program segment writes values for two attributes into the
user database for user and then deletes a third attribute. It then
reads and prints two attributes plus the attribute which it removed.
Finally, it removes all of the attributes for user
After successful execution, the output is:
FILES
user database
security defaults configuration file
security attributes description file
SEE ALSOuserdbget(1M), userdbset(1M), secdef(3), security(4), userdb(4).
userdb_read(3)