Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought






       cm_read_devconfig(D3)                          cm_read_devconfig(D3)


       NAME
             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, off_t offset, void *buf,
                                   size_t nbyte);

          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.

       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 example, the EISA bus driver).

             Drivers should not use this routine to read standard board
             parameters directly.  Rather, such parameters should be
             acquired via cm_getval(D3) requests.

             cm_read_devconfig is used by MCA drivers to directly read the
             POS registers.

          Return Values
             cm_read_devconfig returns the number of bytes read.  It will
             return -1 if an error occurs.

       USAGE
          Level
             Initialization or Base.

          Synchronization Constraints
             Does not sleep.




                           Copyright 1994 Novell, Inc.               Page 1













      cm_read_devconfig(D3)                          cm_read_devconfig(D3)


            Driver-defined basic locks, read/write locks, and sleep locks
            may be held across calls to this function.

      REFERENCES
            cm_devconfig_size(D3), cm_getbrdkey(D3), cm_getval(D3),
            cm_write_devconfig(D3), eisa_parse_devconfig(D3), eisa(D4),
            devconfig(D5)

      NOTICES
         Portability
            All processors

         Applicability
            ddi: 6, 6mp, 7, 7mp


































                          Copyright 1994 Novell, Inc.               Page 2








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