uldb_get_limit_values(3c)

NAME
     uldb_get_limit_values, uldb_get_value_units, uldb_get_limit_names,
     uldb_get_domain_names, uldb_free_namelist, uldb_free_limit_list - ULDB
     functions

SYNOPSIS
     #include <uldb.h>

     uldb_limitlist_t *uldb_get_limit_values(char *domainname, char
     *username, uldb_namelist_t *namelist);

     uldb_limitlist_t *uldb_get_value_units(char *domainname, char *username,
     uldb_namelist_t *namelist);

     uldb_namelist_t *uldb_get_limit_names(char *domainname)

     uldb_namelist_t *uldb_get_domain_names(void);

     void uldb_free_namelist (uldb_namelist_t *namelist);

     void uldb_free_limit_list (uldb_limitlist_t *limitlist);

DESCRIPTION
     The uldb_get_limit_values, uldb_get_value_units, uldb_get_limit_names,
     uldb_get_domain_names, uldb_free_namelist, and uldb_free_limit_list
     functions all interact with the user limits database (ULDB) to retrieve
     or set limit values for a domain or user. For uldb type definitions, see
     the uldb.h file.

     The uldb_get_limit_values function takes a job limits domain name, a
     username, and a namelist of the limit names whose values the function
     should return.  The domainname and namelist arguments must be specified.
     The username may be NULL, in which case the function will return the
     domain defaults for the specified job limits domain.  The function
     returns a limit list containing the limit values for the limit names
     specified in the namelist.  It is the responsibility of the calling
     function to free the limitlist structure.

     The uldb_get_value_units function takes a job limits domainname, a
     username, and a namelist of the limit names values that the function
     should return.  The domainname and namelist arguments must be specified.
     The username may be NULL, in which case the function will return the
     domain defaults for the specified job limits domain.  The function
     returns a limitlist containing the limit value units for the limit names
     specified in the namelist.  It is the responsibility of the calling
     function to free the limitlist structure.

     The uldb_get_limit_names function takes a job limits domainname as an
     argument and returns a namelist structure containing all the limit names
     defined for that domain.  It is the responsibility of the calling
     function to free the namelist structure.
     The uldb_get_domain_names function retrieves all the domain names in the
     ULDB.  The function returns a namelist structure containing all of the
     domain names in the ULDB.  It is the calling function's responsibility to
     free the namelist structure.

     The uldb_free_namelist function frees a namelist structure and the
     uldb_free_limit_list frees a limitlist structure.

     The jlimit_startjob function creates a new job container.

ERRORS
     Under the following conditions, the uldb_get_limit_values,
     uldb_get_value_units, uldb_get_limit_names, and uldb_get_domain_names
     functions fail and set errno to:

     [ENOATTR]      The domain name or namelist are not specified.

     [EINVAL]       Invalid parameters encountered.

     [ENOMEM]       Sufficient memory is not available.

     [ENOEXIST]     The jlimits file does not exit.

SEE ALSO
     jlimit_startjob(3C).

DIAGNOSTICS
     The uldb_get_limit_values, uldb_get_value_units, uldb_get_limit_names,
     and uldb_get_domain_names functions return NULL if an error is
     encountered and errno is set to indicate the error.