hpux man page for userdb_read

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)