SVR5

cm_delval(D3)

cm_delval -- delete entries from the resource manager database

Synopsis

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

Description

cm_delval is used to delete all values associated with a (key, param) pair from the resource manager database.

Arguments

args: Structure containing request arguments.

Return values

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

EINVAL: if args is NULL, cm_key is invalid, 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 whose values are to be deleted. One call to cm_delval deletes all values associated with a (key, param) pair.

cm_delval( ) must be called are 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.

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_delval( ) 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)

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