DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
SVR5

cm_AT_putconf(D3)


cm_AT_putconf -- store standard parameters in resource manager database

Synopsis

   #include <sys/types.h>
   #include <sys/confmgr.h>
   #include <sys/cm_i386at.h>
   #include <sys/ddi.h>
   

int cm_AT_putconf(rm_key_t rm_key, int vector, int itype, ulong_t sioa, ulong_t eioa, ulong_t scma, ulong_t ecma, int dmac, uint_t setmask, int claim);

Description

cm_AT_putconf( ) is used by device drivers that need to store values for various standard hardware parameters into the resource manager database. For MCA drivers, these hardware parameters are typically determined by interpreting the MCA POS registers. Drivers that can determine hardware parameters by reading configuration information directly from their device may also use this routine. For most drivers, though, this will be unnecessary, because the correct information is already in the resource manager database.

Arguments


rm_key
Resource manager key selecting a particular board instance.

vector
Board's interrupt vector (IRQ).

itype
Interrupt type: CM_ITYPE_EDGE for edge-triggered interrupts or CM_ITYPE_LEVEL for level-sensitive interrupts.

sioa
Start of board's I/O address range.

eioa
End of board's I/O address range.

scma
Start of board's memory address range.

ecma
End of board's memory address range.

dmac
Board's DMA channel.

setmask
Indicates which parameters are to be set.

claim
Non-zero if driver wishes to ``own'' the parameters specified by setmask.

Return values

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

EINVAL
if rm_key is invalid. value.

Usage

The setmask argument is a bitmask of flags indicating which resource parameters are to be set from the values given by the other arguments:

CM_SET_IRQ
set CM_IRQ from vector.

CM_SET_ITYPE
set CM_ITYPE from itype.

CM_SET_IOADDR
set CM_IOADDR from sioa and eioa.

CM_SET_MEMADDR
set CM_MEMADDR from scma and ecma.

CM_SET_DMAC
set CM_DMAC from dmac.

If the claim argument is non-zero, the driver will subsequently be completely responsible for the resource parameters specified by setmask for this board. The system will no longer attempt to update these parameters from values found in NVRAM. A new parameter, CM_CLAIM, will be added to the key with the value setmask.

Context and synchronization

User or blockable context.

Hardware applicability

PC-AT compatible platforms

Version applicability

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

References

cm_addval(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), cm_params(D5)

``Autoconfiguration'' in HDK Technical Reference


19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005