Home | History | Annotate | Line # | Download | only in kern
subr_device.c revision 1.2 
      1 /*	$NetBSD: subr_device.c,v 1.2 2010/01/31 15:10:12 pooka Exp $	*/
      2 
      3 /*
      4  * Copyright (c) 2006 The NetBSD Foundation, Inc.
      5  * All rights reserved.
      6  *
      7  * Redistribution and use in source and binary forms, with or without
      8  * modification, are permitted provided that the following conditions
      9  * are met:
     10  * 1. Redistributions of source code must retain the above copyright
     11  *    notice, this list of conditions and the following disclaimer.
     12  * 2. Redistributions in binary form must reproduce the above copyright
     13  *    notice, this list of conditions and the following disclaimer in the
     14  *    documentation and/or other materials provided with the distribution.
     15  *
     16  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     17  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     18  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     19  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     20  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     21  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     22  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     23  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     24  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     25  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     26  * POSSIBILITY OF SUCH DAMAGE.
     27  */
     28 
     29 #include <sys/cdefs.h>
     30 __KERNEL_RCSID(0, "$NetBSD: subr_device.c,v 1.2 2010/01/31 15:10:12 pooka Exp $");
     31 
     32 #include <sys/param.h>
     33 #include <sys/device.h>
     34 #include <sys/systm.h>
     35 
     36 /*
     37  * Accessor functions for the device_t type.
     38  */
     39 devclass_t
     40 device_class(device_t dev)
     41 {
     42 
     43 	return dev->dv_class;
     44 }
     45 
     46 cfdata_t
     47 device_cfdata(device_t dev)
     48 {
     49 
     50 	return dev->dv_cfdata;
     51 }
     52 
     53 cfdriver_t
     54 device_cfdriver(device_t dev)
     55 {
     56 
     57 	return dev->dv_cfdriver;
     58 }
     59 
     60 cfattach_t
     61 device_cfattach(device_t dev)
     62 {
     63 
     64 	return dev->dv_cfattach;
     65 }
     66 
     67 int
     68 device_unit(device_t dev)
     69 {
     70 
     71 	return dev->dv_unit;
     72 }
     73 
     74 const char *
     75 device_xname(device_t dev)
     76 {
     77 
     78 	return dev->dv_xname;
     79 }
     80 
     81 device_t
     82 device_parent(device_t dev)
     83 {
     84 
     85 	return dev->dv_parent;
     86 }
     87 
     88 bool
     89 device_activation(device_t dev, devact_level_t level)
     90 {
     91 	int active_flags;
     92 
     93 	active_flags = DVF_ACTIVE;
     94 	switch (level) {
     95 	case DEVACT_LEVEL_FULL:
     96 		active_flags |= DVF_CLASS_SUSPENDED;
     97 		/*FALLTHROUGH*/
     98 	case DEVACT_LEVEL_DRIVER:
     99 		active_flags |= DVF_DRIVER_SUSPENDED;
    100 		/*FALLTHROUGH*/
    101 	case DEVACT_LEVEL_BUS:
    102 		active_flags |= DVF_BUS_SUSPENDED;
    103 		break;
    104 	}
    105 
    106 	return (dev->dv_flags & active_flags) == DVF_ACTIVE;
    107 }
    108 
    109 bool
    110 device_is_active(device_t dev)
    111 {
    112 	int active_flags;
    113 
    114 	active_flags = DVF_ACTIVE;
    115 	active_flags |= DVF_CLASS_SUSPENDED;
    116 	active_flags |= DVF_DRIVER_SUSPENDED;
    117 	active_flags |= DVF_BUS_SUSPENDED;
    118 
    119 	return (dev->dv_flags & active_flags) == DVF_ACTIVE;
    120 }
    121 
    122 bool
    123 device_is_enabled(device_t dev)
    124 {
    125 	return (dev->dv_flags & DVF_ACTIVE) == DVF_ACTIVE;
    126 }
    127 
    128 bool
    129 device_has_power(device_t dev)
    130 {
    131 	int active_flags;
    132 
    133 	active_flags = DVF_ACTIVE | DVF_BUS_SUSPENDED;
    134 
    135 	return (dev->dv_flags & active_flags) == DVF_ACTIVE;
    136 }
    137 
    138 int
    139 device_locator(device_t dev, u_int locnum)
    140 {
    141 
    142 	KASSERT(dev->dv_locators != NULL);
    143 	return dev->dv_locators[locnum];
    144 }
    145 
    146 void *
    147 device_private(device_t dev)
    148 {
    149 
    150 	/*
    151 	 * The reason why device_private(NULL) is allowed is to simplify the
    152 	 * work of a lot of userspace request handlers (i.e., c/bdev
    153 	 * handlers) which grab cfdriver_t->cd_units[n].
    154 	 * It avoids having them test for it to be NULL and only then calling
    155 	 * device_private.
    156 	 */
    157 	return dev == NULL ? NULL : dev->dv_private;
    158 }
    159 
    160 prop_dictionary_t
    161 device_properties(device_t dev)
    162 {
    163 
    164 	return dev->dv_properties;
    165 }
    166 
    167 /*
    168  * device_is_a:
    169  *
    170  *	Returns true if the device is an instance of the specified
    171  *	driver.
    172  */
    173 bool
    174 device_is_a(device_t dev, const char *dname)
    175 {
    176 
    177 	return strcmp(dev->dv_cfdriver->cd_name, dname) == 0;
    178 }
    179