userdb_read(3) Library Functions Manual userdb_read(3)
NAME
userdb_read(), userdb_write(), userdb_delete() - read, write or delete information in the user database, /var/adm/userdb
SYNOPSIS
DESCRIPTION
These functions read, write, or delete information in the user database, 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 ALSO
userdbget(1M), userdbset(1M), secdef(3), security(4), userdb(4).
userdb_read(3)
