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