xref: /netbsd-src/sys/kern/subr_device.c (revision b1c86f5f087524e68db12794ee9c3e3da1ab17a0)
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