SVR5

cm_addval(D3)

cm_addval -- add an entry to the resource manager database

Synopsis

   #include <sys/confmgr.h>
   #include <sys/ddi.h>
   
   int cm_addval(cm_args_t *args);

Description

cm_addval is used to append a value to the specified (key, param) pair in the resource manager database.

Arguments

args: Structure containing request arguments.

Return values

cm_addval returns 0 for success. The following errnos are returned for failure:

EINVAL: if args is NULL, cm_key is invalid, cm_vallen is zero, cm_param is NULL, or cm_param specifies a read-only parameter.

Usage

The cm_key and cm_param elements of the args structure should be set to select the (key, param) pair to which a value is to be appended. The cm_val element of args should be set to point to the value and cm_len should be set to the length (in bytes) of cm_val.

cm_addval( ) does not replace existing values of the (key, param) pair, but rather appends to the existing list of values, if any. If you want to replace an existing value, first call the cm_delval( ) function to delete the existing values.

cm_addval( ) must be called as part of a read/write transaction, between calls to cm_begin_trans(D3) and cm_end_trans(D3).

Context and synchronization

User or blockable context. Initialization or Base.

Hardware applicability

All

Version applicability

ddi: 5, 5mp, 6, 6mp, 7, 7mp, 7.1, 7.1mp, 8, 8mp

Differences between versions

In DDI versions prior to version 8, cm_begin_trans(D3) and cm_end_trans(D3) are not supported. Calls to cm_addval( ) are only atomic with respect to other simultaneous resource manager database accesses.

References

cm_args(D4), config(D2)

cm_addval(D3), cm_begin_trans(D3), cm_delkey(D3), cm_delval(D3), cm_end_trans(D3), cm_newkey(D3), cm_read_devconfig(D3), cm_read_devconfig8(D3), cm_read_devconfig16(D3), cm_read_devconfig32(D3), cm_write_devconfig(D3), cm_write_devconfig8(D3), cm_write_devconfig16(D3), cm_write_devconfig32(D3) errnos(D5)

``Hotplug devices'' in HDK Technical Reference,
``Autoconfiguration'' in HDK Technical Reference