sys/sys/bus_private.h

   1 /*-
   2  * Copyright (c) 1997,1998 Doug Rabson
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer.
  10  * 2. Redistributions in binary form must reproduce the above copyright
  11  *    notice, this list of conditions and the following disclaimer in the
  12  *    documentation and/or other materials provided with the distribution.
  13  *
  14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  15  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  17  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  18  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  19  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  20  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  21  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  22  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  23  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  24  * SUCH DAMAGE.
  25  *
  26  * $FreeBSD$
  27  */
  28
  29 #ifndef _SYS_BUS_PRIVATE_H_
  30 #define _SYS_BUS_PRIVATE_H_
  31
  32 #include <sys/bus.h>
  33
  34 /*
  35  * Used to attach drivers to devclasses.
  36  */
  37 typedef struct driverlink *driverlink_t;
  38 struct driverlink {
  39     driver_t            *driver;
  40     TAILQ_ENTRY(driverlink) link; /* list of drivers in devclass */
  41 };
  42
  43 /*
  44  * Forward declarations
  45  */
  46 typedef TAILQ_HEAD(devclass_list, devclass) devclass_list_t;
  47 typedef TAILQ_HEAD(driver_list, driverlink) driver_list_t;
  48 typedef TAILQ_HEAD(device_list, device) device_list_t;
  49
  50 struct devclass {
  51     TAILQ_ENTRY(devclass) link;
  52     driver_list_t       drivers; /* bus devclasses store drivers for bus */
  53     char                *name;
  54     device_t            *devices; /* array of devices indexed by unit */
  55     int                 maxunit; /* size of devices array */
  56 };
  57
  58 /*
  59  * Implementation of device.
  60  */
  61 struct device {
  62     /*
  63      * A device is a kernel object. The first field must be the
  64      * current ops table for the object.
  65      */
  66     KOBJ_FIELDS;
  67
  68     /*
  69      * Device hierarchy.
  70      */
  71     TAILQ_ENTRY(device) link;   /* list of devices in parent */
  72     TAILQ_ENTRY(device) devlink; /* global device list membership */
  73     device_t            parent;
  74     device_list_t       children; /* list of subordinate devices */
  75
  76     /*
  77      * Details of this device.
  78      */
  79     driver_t            *driver;
  80     devclass_t          devclass; /* device class which we are in */
  81     int                 unit;
  82     char*               nameunit; /* name+unit e.g. foodev0 */
  83     char*               desc;   /* driver specific description */
  84     int                 busy;   /* count of calls to device_busy() */
  85     device_state_t      state;
  86     u_int32_t           devflags; /* api level flags for device_get_flags() */
  87     u_short             flags;
  88 #define DF_ENABLED      1       /* device should be probed/attached */
  89 #define DF_FIXEDCLASS   2       /* devclass specified at create time */
  90 #define DF_WILDCARD     4       /* unit was originally wildcard */
  91 #define DF_DESCMALLOCED 8       /* description was malloced */
  92 #define DF_QUIET        16      /* don't print verbose attach message */
  93 #define DF_DONENOMATCH  32      /* don't execute DEVICE_NOMATCH again */
  94 #define DF_EXTERNALSOFTC 64     /* softc not allocated by us */
  95     u_char              order;  /* order from device_add_child_ordered() */
  96     u_char              pad;
  97     void                *ivars;
  98     void                *softc;
  99 };
 100
 101 struct device_op_desc {
 102     unsigned int        offset; /* offset in driver ops */
 103     struct method*      method; /* internal method implementation */
 104     devop_t             deflt;  /* default implementation */
 105     const char*         name;   /* unique name (for registration) */
 106 };
 107
 108 #endif /* !_SYS_BUS_PRIVATE_H_ */