Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ cm_params(D5) — UnixWare 2.01

Media Vault

Software Library

Restoration Projects

Artifacts Sought






       cm_params(D5)                                          cm_params(D5)


       NAME
             cm_params - Configuration Manager Parameters

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

       DESCRIPTION
             The configuration manager includes a set of routines for
             accessing the resource manager database.  The resource manager
             is a repository for <key, param, value> tuples.  A parameter
             is an arbitrary character string uninterpreted by the resource
             manager.  Described herein are the pre-defined parameters
             provided by the configuration manager that drivers and modules
             can use to access their configuration information.  Most of
             these parameters correspond to the configuration information
             in a driver's System(4) file.

             The configuration manager parameters use the following defined
             types:

             cm_num_t      This type is used for scalar numeric quantities.
                           Integer arithmetic operations apply to this
                           type.

             cm_range_t    This type is used for address ranges.  It is a
                           structure with two members: startaddr and
                           endaddr.  These are the starting and ending
                           addresses, inclusive.

             string        This type, not explicitly defined, is used for
                           text strings.  It is just an array of characters
                           terminated by a null byte ('\0').

             The pre-defined parameters accessible to drivers are as
             follows:

             CM_MODNAME    The external name of the module.  This
                           corresponds to pfx_MODNAME as generated for
                           Space.c(4).  CM_MODNAME is a read-only parameter
                           of type string.

             CM_UNIT       Parameter used to store arbitrary driver-
                           specific data.  CM_UNIT is of type cm_num_t.



                           Copyright 1994 Novell, Inc.               Page 1













      cm_params(D5)                                          cm_params(D5)


            CM_IPL        Interrupt priority level.  CM_IPL is of type
                          cm_num_t and may have multiple values.

            CM_ITYPE      Interrupt type.  CM_ITYPE is of type cm_num_t
                          and may have multiple values.  If drivers set
                          this parameter, it should be set to
                          CM_ITYPE_EDGE for edge-triggered interrupts or
                          CM_ITYPE_LEVEL for level-sensitive interrupts.

            CM_IRQ        Interrupt vector number.  CM_IRQ is of type
                          cm_num_t and may have multiple values.

            CM_IOADDR     IO address range, includes start and end
                          addresses.  CM_IOADDR is of type cm_range_t and
                          may have multiple values.

            CM_MEMADDR    Memory address range, includes start and end
                          addresses.  CM_MEMADDR is of type cm_range_t and
                          may have multiple values.

            CM_DMAC       DMA channel.  If this parameter is not present,
                          the device does not use DMA channels.  CM_DMAC
                          is of type cm_num_t and may have multiple
                          values.

            CM_SLOT       Bus slot number.  CM_SLOT is a read-only
                          parameter of type cm_num_t.  This parameter is
                          provided only on buses on which slot numbers can
                          be determined, such as EISA and MCA.

            CM_CLAIM      Bitmap of parameters owned by the driver.
                          CM_CLAIM is of type cm_num_t.  A driver can set
                          this parameter to prevent the configuration
                          manager from updating the resource manager with
                          information from NVRAM.  CM_CLAIM may be set
                          explicitly by cm_AT_putconf(D3).

      REFERENCES
            cm_addval(D3), cm_AT_putconf(D3), cm_delval(D3), cm_getval(D3)

      NOTICES
         Portability
            AT-compatible architectures





                          Copyright 1994 Novell, Inc.               Page 2








Typewritten Software • bear@typewritten.org • Edmonds, WA 98026