UnixWare 7

cm_read_devconfig(D3)

cm_read_devconfig -- read a board's NVRAM extension information

Synopsis

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

Description

cm_read_devconfig( ) is used to read the 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 read is determined by the bus driver. For information about the configuration space for different bus types, see:

EISA: eisa(D5)
MCA: mca(D5)
PCI: pci(D5)

Use the GetFirstTuple(D3pccard) function to access PC Card configuration information rather than calling cm_read_devconfig( ).

Do not use this routine to directly read the standard board parameters that are documented on the cm_params(D5) manual apge. Instead, use the cm_getval(D3) function to access that information. cm_read_devconfig( ) is used to access non-standard (usually vendor-specific) information.

Arguments

key: Resource manager key selecting a particular board instance.

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

buf: Buffer to hold data to be read.

nbyte: Number of bytes of data to be read.

Return values

cm_read_devconfig( ) returns the number of bytes read. It will return -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_devconfig_size(D3), cm_getbrdkey(D3), cm_getval(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), eisa_parse_devconfig(D3), eisa(D4), eisa(D5), mca(D5), pci(D5)

``Autoconfiguration'', ``PCI''