cm_AT_putconf(D3) cm_AT_putconf(D3)
NAME
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);
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.
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 will typically be determined by interpreting the
MCA POS registers. Other drivers, which can determine
hardware parameters by reading configuration information
Copyright 1994 Novell, Inc. Page 1
cm_AT_putconf(D3) cm_AT_putconf(D3)
directly from their device may also use this routine. For
most drivers, though, this will be unnecessary, as the correct
information should already be in the resource manager
database.
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.
Level
Initialization or Base.
Synchronization Constraints
May sleep.
Driver-defined basic locks, read/write locks may not be held
across calls to this function. Driver-defined sleep locks may
be held across calls to this function.
REFERENCES
cm_addval(D3), cm_read_devconfig(D3), cm_write_devconfig(D3),
cm_params(D5)
Copyright 1994 Novell, Inc. Page 2
cm_AT_putconf(D3) cm_AT_putconf(D3)
NOTICES
Portability
AT-compatible architectures
Applicability
ddi: 6, 6mp, 7, 7mp
Copyright 1994 Novell, Inc. Page 3