1 /* $NetBSD: subr_device.c,v 1.3 2015/03/09 15:35:11 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.3 2015/03/09 15:35:11 pooka Exp $"); 31 32 #include <sys/param.h> 33 #include <sys/device.h> 34 #include <sys/systm.h> 35 36 /* Root device. */ 37 device_t root_device; 38 39 /* 40 * Accessor functions for the device_t type. 41 */ 42 devclass_t 43 device_class(device_t dev) 44 { 45 46 return dev->dv_class; 47 } 48 49 cfdata_t 50 device_cfdata(device_t dev) 51 { 52 53 return dev->dv_cfdata; 54 } 55 56 cfdriver_t 57 device_cfdriver(device_t dev) 58 { 59 60 return dev->dv_cfdriver; 61 } 62 63 cfattach_t 64 device_cfattach(device_t dev) 65 { 66 67 return dev->dv_cfattach; 68 } 69 70 int 71 device_unit(device_t dev) 72 { 73 74 return dev->dv_unit; 75 } 76 77 const char * 78 device_xname(device_t dev) 79 { 80 81 return dev->dv_xname; 82 } 83 84 device_t 85 device_parent(device_t dev) 86 { 87 88 return dev->dv_parent; 89 } 90 91 bool 92 device_activation(device_t dev, devact_level_t level) 93 { 94 int active_flags; 95 96 active_flags = DVF_ACTIVE; 97 switch (level) { 98 case DEVACT_LEVEL_FULL: 99 active_flags |= DVF_CLASS_SUSPENDED; 100 /*FALLTHROUGH*/ 101 case DEVACT_LEVEL_DRIVER: 102 active_flags |= DVF_DRIVER_SUSPENDED; 103 /*FALLTHROUGH*/ 104 case DEVACT_LEVEL_BUS: 105 active_flags |= DVF_BUS_SUSPENDED; 106 break; 107 } 108 109 return (dev->dv_flags & active_flags) == DVF_ACTIVE; 110 } 111 112 bool 113 device_is_active(device_t dev) 114 { 115 int active_flags; 116 117 active_flags = DVF_ACTIVE; 118 active_flags |= DVF_CLASS_SUSPENDED; 119 active_flags |= DVF_DRIVER_SUSPENDED; 120 active_flags |= DVF_BUS_SUSPENDED; 121 122 return (dev->dv_flags & active_flags) == DVF_ACTIVE; 123 } 124 125 bool 126 device_is_enabled(device_t dev) 127 { 128 return (dev->dv_flags & DVF_ACTIVE) == DVF_ACTIVE; 129 } 130 131 bool 132 device_has_power(device_t dev) 133 { 134 int active_flags; 135 136 active_flags = DVF_ACTIVE | DVF_BUS_SUSPENDED; 137 138 return (dev->dv_flags & active_flags) == DVF_ACTIVE; 139 } 140 141 int 142 device_locator(device_t dev, u_int locnum) 143 { 144 145 KASSERT(dev->dv_locators != NULL); 146 return dev->dv_locators[locnum]; 147 } 148 149 void * 150 device_private(device_t dev) 151 { 152 153 /* 154 * The reason why device_private(NULL) is allowed is to simplify the 155 * work of a lot of userspace request handlers (i.e., c/bdev 156 * handlers) which grab cfdriver_t->cd_units[n]. 157 * It avoids having them test for it to be NULL and only then calling 158 * device_private. 159 */ 160 return dev == NULL ? NULL : dev->dv_private; 161 } 162 163 prop_dictionary_t 164 device_properties(device_t dev) 165 { 166 167 return dev->dv_properties; 168 } 169 170 /* 171 * device_is_a: 172 * 173 * Returns true if the device is an instance of the specified 174 * driver. 175 */ 176 bool 177 device_is_a(device_t dev, const char *dname) 178 { 179 180 return strcmp(dev->dv_cfdriver->cd_name, dname) == 0; 181 } 182