uldb_get_limit_values(3c)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.
Page 1
uldb_get_limit_values(3c)uldb_get_limit_values(3c)
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 ALSOjlimit_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.
Page 2