SVR5

cm_write_devconfig(D3)

cm_write_devconfig -- write a board's NVRAM extension information

Synopsis

   #include <sys/confmgr.h>
   #include <sys/ddi.h>
   
   int cm_write_devconfig(rm_key_t key, size_t offset, void *buf,
                          size_t nbyte);

Description

cm_write_devconfig is used to write NVRAM extension information associated with a selected board instance. The extension information is specific to the bus type of the board and exactly what information is written is determined by the bus driver (for example, the EISA bus driver).

Drivers should not use this routine to write standard board parameters directly. Rather, such parameters should be stored via cm_addval(D3) requests.

cm_write_devconfig is used by MCA drivers to directly write the POS registers.

Arguments

key: Resource manager key selecting a particular board instance.

offset: Offset from the beginning of the board's device configuration space to start writing data.

buf: Buffer containing data to be written.

nbyte: Number of bytes of data to be written.

Return values

cm_write_devconfig( ) returns the number of bytes written. It returns -1 if an error occurs.

Usage

The caller must not have a resource manager transaction pending (see cm_begin_trans(D3)) when this function is called.

Context and synchronization

All contexts.

Hardware applicability

All

Version applicability

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

Differences between versions

In DDI versions before version 8 that support this function, the offset argument is cast as size_t rather than an off_t. When porting drivers from earlier DDI versions, it is not necessary to modify the type of the offset argument.

References

cm_addval(D3), cm_devconfig_size(D3), cm_getbrdkey(D3), cm_read_devconfig(D3), cm_read_devconfig8(D3), cm_read_devconfig16(D3), cm_read_devconfig32(D3), cm_write_devconfig8(D3), cm_write_devconfig16(D3), cm_write_devconfig32(D3), eisa(D4), eisa(D5), mca(D5), pci(D5)

``Autoconfiguration'' in HDK Technical Reference