SVR5

cm_newkey(D3)

cm_newkey -- create a new resource manager record

Synopsis

   #include <sys/types.h>
   #include <sys/confmgr.h>
   #include <sys/ddi.h>
   
   rm_key_t cm_newkey(rm_key_t parent, boolean_t persistent);

Description

cm_newkey( ) creates a new resource manager record. This implicitly begins a new transaction and acts as if cm_begin_trans(D3) were called internally in RM_RDWR mode. The driver must call cm_end_trans(D3) to complete the transaction and make the new key visible to other contexts.

Arguments

parent: identifies the existing resource manager record to which the new record will be a child. For hardware device records, the parent should be the device through which the new device is accessed. For example, for a new disk drive, the parent should be the Host Bus Adapter to which the drive is connected. In most cases, the parent key is the calling driver's own key.
persistent: Indicates whether the record should persist across reboots.

Return values

Usage

Context and synchronization

User or blockable context.

Hardware applicability

All

Version applicability

ddi: 8, 8mp

References

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)

``Autoconfiguration'' in HDK Technical Reference