Merge from vendor branch OPENSSL:
[dragonfly.git] / sys / kern / subr_bus.c
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: src/sys/kern/subr_bus.c,v 1.54.2.9 2002/10/10 15:13:32 jhb Exp $
27  * $DragonFly: src/sys/kern/subr_bus.c,v 1.21 2004/07/08 12:43:32 joerg Exp $
28  */
29
30 #include "opt_bus.h"
31
32 #include <sys/param.h>
33 #include <sys/queue.h>
34 #include <sys/malloc.h>
35 #include <sys/kernel.h>
36 #include <sys/module.h>
37 #ifdef DEVICE_SYSCTLS
38 #include <sys/sysctl.h>
39 #endif
40 #include <sys/kobj.h>
41 #include <sys/bus_private.h>
42 #include <sys/systm.h>
43 #include <machine/bus.h>
44 #include <sys/rman.h>
45 #include <machine/stdarg.h>     /* for device_printf() */
46
47 MALLOC_DEFINE(M_BUS, "bus", "Bus data structures");
48
49 #ifdef BUS_DEBUG
50 #define PDEBUG(a)       (printf("%s:%d: ", __FUNCTION__, __LINE__), printf a, printf("\n"))
51 #define DEVICENAME(d)   ((d)? device_get_name(d): "no device")
52 #define DRIVERNAME(d)   ((d)? d->name : "no driver")
53 #define DEVCLANAME(d)   ((d)? d->name : "no devclass")
54
55 /* Produce the indenting, indent*2 spaces plus a '.' ahead of that to 
56  * prevent syslog from deleting initial spaces
57  */
58 #define indentprintf(p) do { int iJ; printf("."); for (iJ=0; iJ<indent; iJ++) printf("  "); printf p ; } while(0)
59
60 static void     print_device_short(device_t dev, int indent);
61 static void     print_device(device_t dev, int indent);
62 void            print_device_tree_short(device_t dev, int indent);
63 void            print_device_tree(device_t dev, int indent);
64 static void     print_driver_short(driver_t *driver, int indent);
65 static void     print_driver(driver_t *driver, int indent);
66 static void     print_driver_list(driver_list_t drivers, int indent);
67 static void     print_devclass_short(devclass_t dc, int indent);
68 static void     print_devclass(devclass_t dc, int indent);
69 void            print_devclass_list_short(void);
70 void            print_devclass_list(void);
71
72 #else
73 /* Make the compiler ignore the function calls */
74 #define PDEBUG(a)                       /* nop */
75 #define DEVICENAME(d)                   /* nop */
76 #define DRIVERNAME(d)                   /* nop */
77 #define DEVCLANAME(d)                   /* nop */
78
79 #define print_device_short(d,i)         /* nop */
80 #define print_device(d,i)               /* nop */
81 #define print_device_tree_short(d,i)    /* nop */
82 #define print_device_tree(d,i)          /* nop */
83 #define print_driver_short(d,i)         /* nop */
84 #define print_driver(d,i)               /* nop */
85 #define print_driver_list(d,i)          /* nop */
86 #define print_devclass_short(d,i)       /* nop */
87 #define print_devclass(d,i)             /* nop */
88 #define print_devclass_list_short()     /* nop */
89 #define print_devclass_list()           /* nop */
90 #endif
91
92 #ifdef DEVICE_SYSCTLS
93 static void     device_register_oids(device_t dev);
94 static void     device_unregister_oids(device_t dev);
95 #endif
96
97 kobj_method_t null_methods[] = {
98         { 0, 0 }
99 };
100
101 DEFINE_CLASS(null, null_methods, 0);
102
103 /*
104  * Devclass implementation
105  */
106
107 static devclass_list_t devclasses = TAILQ_HEAD_INITIALIZER(devclasses);
108
109 static devclass_t
110 devclass_find_internal(const char *classname, const char *parentname,
111                        int create)
112 {
113         devclass_t dc;
114
115         PDEBUG(("looking for %s", classname));
116         if (classname == NULL)
117                 return(NULL);
118
119         TAILQ_FOREACH(dc, &devclasses, link)
120                 if (!strcmp(dc->name, classname))
121                         break;
122
123         if (create && !dc) {
124                 PDEBUG(("creating %s", classname));
125                 dc = malloc(sizeof(struct devclass) + strlen(classname) + 1,
126                             M_BUS, M_INTWAIT | M_ZERO);
127                 if (!dc)
128                         return(NULL);
129                 dc->parent = NULL;
130                 dc->name = (char*) (dc + 1);
131                 strcpy(dc->name, classname);
132                 dc->devices = NULL;
133                 dc->maxunit = 0;
134                 TAILQ_INIT(&dc->drivers);
135                 TAILQ_INSERT_TAIL(&devclasses, dc, link);
136         }
137         if (parentname && dc && !dc->parent)
138                 dc->parent = devclass_find_internal(parentname, NULL, FALSE);
139
140         return(dc);
141 }
142
143 devclass_t
144 devclass_create(const char *classname)
145 {
146         return(devclass_find_internal(classname, NULL, TRUE));
147 }
148
149 devclass_t
150 devclass_find(const char *classname)
151 {
152         return(devclass_find_internal(classname, NULL, FALSE));
153 }
154
155 int
156 devclass_add_driver(devclass_t dc, driver_t *driver)
157 {
158         driverlink_t dl;
159         int i;
160
161         PDEBUG(("%s", DRIVERNAME(driver)));
162
163         dl = malloc(sizeof *dl, M_BUS, M_INTWAIT | M_ZERO);
164         if (!dl)
165                 return(ENOMEM);
166
167         /*
168          * Compile the driver's methods. Also increase the reference count
169          * so that the class doesn't get freed when the last instance
170          * goes. This means we can safely use static methods and avoids a
171          * double-free in devclass_delete_driver.
172          */
173         kobj_class_instantiate(driver);
174
175         /*
176          * Make sure the devclass which the driver is implementing exists.
177          */
178         devclass_find_internal(driver->name, NULL, TRUE);
179
180         dl->driver = driver;
181         TAILQ_INSERT_TAIL(&dc->drivers, dl, link);
182
183         /*
184          * Call BUS_DRIVER_ADDED for any existing busses in this class.
185          */
186         for (i = 0; i < dc->maxunit; i++)
187                 if (dc->devices[i])
188                         BUS_DRIVER_ADDED(dc->devices[i], driver);
189
190         return(0);
191 }
192
193 int
194 devclass_delete_driver(devclass_t busclass, driver_t *driver)
195 {
196         devclass_t dc = devclass_find(driver->name);
197         driverlink_t dl;
198         device_t dev;
199         int i;
200         int error;
201
202         PDEBUG(("%s from devclass %s", driver->name, DEVCLANAME(busclass)));
203
204         if (!dc)
205                 return(0);
206
207         /*
208          * Find the link structure in the bus' list of drivers.
209          */
210         TAILQ_FOREACH(dl, &busclass->drivers, link)
211                 if (dl->driver == driver)
212                         break;
213
214         if (!dl) {
215                 PDEBUG(("%s not found in %s list", driver->name, busclass->name));
216                 return(ENOENT);
217         }
218
219         /*
220          * Disassociate from any devices.  We iterate through all the
221          * devices in the devclass of the driver and detach any which are
222          * using the driver and which have a parent in the devclass which
223          * we are deleting from.
224          *
225          * Note that since a driver can be in multiple devclasses, we
226          * should not detach devices which are not children of devices in
227          * the affected devclass.
228          */
229         for (i = 0; i < dc->maxunit; i++)
230                 if (dc->devices[i]) {
231                         dev = dc->devices[i];
232                         if (dev->driver == driver && dev->parent &&
233                             dev->parent->devclass == busclass) {
234                                 if ((error = device_detach(dev)) != 0)
235                                         return(error);
236                                 device_set_driver(dev, NULL);
237                         }
238                 }
239
240         TAILQ_REMOVE(&busclass->drivers, dl, link);
241         free(dl, M_BUS);
242
243         kobj_class_uninstantiate(driver);
244
245         return(0);
246 }
247
248 static driverlink_t
249 devclass_find_driver_internal(devclass_t dc, const char *classname)
250 {
251         driverlink_t dl;
252
253         PDEBUG(("%s in devclass %s", classname, DEVCLANAME(dc)));
254
255         TAILQ_FOREACH(dl, &dc->drivers, link)
256                 if (!strcmp(dl->driver->name, classname))
257                         return(dl);
258
259         PDEBUG(("not found"));
260         return(NULL);
261 }
262
263 kobj_class_t
264 devclass_find_driver(devclass_t dc, const char *classname)
265 {
266         driverlink_t dl;
267
268         dl = devclass_find_driver_internal(dc, classname);
269         if (dl)
270                 return(dl->driver);
271         else
272                 return(NULL);
273 }
274
275 const char *
276 devclass_get_name(devclass_t dc)
277 {
278         return(dc->name);
279 }
280
281 device_t
282 devclass_get_device(devclass_t dc, int unit)
283 {
284         if (dc == NULL || unit < 0 || unit >= dc->maxunit)
285                 return(NULL);
286         return(dc->devices[unit]);
287 }
288
289 void *
290 devclass_get_softc(devclass_t dc, int unit)
291 {
292         device_t dev;
293
294         dev = devclass_get_device(dc, unit);
295         if (!dev)
296                 return(NULL);
297
298         return(device_get_softc(dev));
299 }
300
301 int
302 devclass_get_devices(devclass_t dc, device_t **devlistp, int *devcountp)
303 {
304         int i;
305         int count;
306         device_t *list;
307     
308         count = 0;
309         for (i = 0; i < dc->maxunit; i++)
310                 if (dc->devices[i])
311                         count++;
312
313         list = malloc(count * sizeof(device_t), M_TEMP, M_INTWAIT | M_ZERO);
314         if (list == NULL)
315                 return(ENOMEM);
316
317         count = 0;
318         for (i = 0; i < dc->maxunit; i++)
319                 if (dc->devices[i]) {
320                         list[count] = dc->devices[i];
321                         count++;
322                 }
323
324         *devlistp = list;
325         *devcountp = count;
326
327         return(0);
328 }
329
330 int
331 devclass_get_maxunit(devclass_t dc)
332 {
333         return(dc->maxunit);
334 }
335
336 void
337 devclass_set_parent(devclass_t dc, devclass_t pdc)
338 {
339         dc->parent = pdc;
340 }
341
342 devclass_t
343 devclass_get_parent(devclass_t dc)
344 {
345         return(dc->parent);
346 }
347
348 static int
349 devclass_alloc_unit(devclass_t dc, int *unitp)
350 {
351         int unit = *unitp;
352
353         PDEBUG(("unit %d in devclass %s", unit, DEVCLANAME(dc)));
354
355         /* If we have been given a wired unit number, check for existing device */
356         if (unit != -1) {
357                 if (unit >= 0 && unit < dc->maxunit &&
358                     dc->devices[unit] != NULL) {
359                         if (bootverbose)
360                                 printf("%s-: %s%d exists, using next available unit number\n",
361                                        dc->name, dc->name, unit);
362                         /* find the next available slot */
363                         while (++unit < dc->maxunit && dc->devices[unit] != NULL)
364                                 ;
365                 }
366         } else {
367                 /* Unwired device, find the next available slot for it */
368                 unit = 0;
369                 while (unit < dc->maxunit && dc->devices[unit] != NULL)
370                         unit++;
371         }
372
373         /*
374          * We've selected a unit beyond the length of the table, so let's
375          * extend the table to make room for all units up to and including
376          * this one.
377          */
378         if (unit >= dc->maxunit) {
379                 device_t *newlist;
380                 int newsize;
381
382                 newsize = roundup((unit + 1), MINALLOCSIZE / sizeof(device_t));
383                 newlist = malloc(sizeof(device_t) * newsize, M_BUS,
384                                  M_INTWAIT | M_ZERO);
385                 if (newlist == NULL)
386                         return(ENOMEM);
387                 bcopy(dc->devices, newlist, sizeof(device_t) * dc->maxunit);
388                 if (dc->devices)
389                         free(dc->devices, M_BUS);
390                 dc->devices = newlist;
391                 dc->maxunit = newsize;
392         }
393         PDEBUG(("now: unit %d in devclass %s", unit, DEVCLANAME(dc)));
394
395         *unitp = unit;
396         return(0);
397 }
398
399 static int
400 devclass_add_device(devclass_t dc, device_t dev)
401 {
402         int buflen, error;
403
404         PDEBUG(("%s in devclass %s", DEVICENAME(dev), DEVCLANAME(dc)));
405
406         buflen = strlen(dc->name) + 5;
407         dev->nameunit = malloc(buflen, M_BUS, M_INTWAIT | M_ZERO);
408         if (!dev->nameunit)
409                 return(ENOMEM);
410
411         if ((error = devclass_alloc_unit(dc, &dev->unit)) != 0) {
412                 free(dev->nameunit, M_BUS);
413                 dev->nameunit = NULL;
414                 return(error);
415         }
416         dc->devices[dev->unit] = dev;
417         dev->devclass = dc;
418         snprintf(dev->nameunit, buflen, "%s%d", dc->name, dev->unit);
419
420 #ifdef DEVICE_SYSCTLS
421         device_register_oids(dev);
422 #endif
423
424         return(0);
425 }
426
427 static int
428 devclass_delete_device(devclass_t dc, device_t dev)
429 {
430         if (!dc || !dev)
431                 return(0);
432
433         PDEBUG(("%s in devclass %s", DEVICENAME(dev), DEVCLANAME(dc)));
434
435         if (dev->devclass != dc || dc->devices[dev->unit] != dev)
436                 panic("devclass_delete_device: inconsistent device class");
437         dc->devices[dev->unit] = NULL;
438         if (dev->flags & DF_WILDCARD)
439                 dev->unit = -1;
440         dev->devclass = NULL;
441         free(dev->nameunit, M_BUS);
442         dev->nameunit = NULL;
443
444 #ifdef DEVICE_SYSCTLS
445         device_unregister_oids(dev);
446 #endif
447
448         return(0);
449 }
450
451 static device_t
452 make_device(device_t parent, const char *name, int unit)
453 {
454         device_t dev;
455         devclass_t dc;
456
457         PDEBUG(("%s at %s as unit %d", name, DEVICENAME(parent), unit));
458
459         if (name != NULL) {
460                 dc = devclass_find_internal(name, NULL, TRUE);
461                 if (!dc) {
462                         printf("make_device: can't find device class %s\n", name);
463                         return(NULL);
464                 }
465         } else
466                 dc = NULL;
467
468         dev = malloc(sizeof(struct device), M_BUS, M_INTWAIT | M_ZERO);
469         if (!dev)
470                 return(0);
471
472         dev->parent = parent;
473         TAILQ_INIT(&dev->children);
474         kobj_init((kobj_t) dev, &null_class);
475         dev->driver = NULL;
476         dev->devclass = NULL;
477         dev->unit = unit;
478         dev->nameunit = NULL;
479         dev->desc = NULL;
480         dev->busy = 0;
481         dev->devflags = 0;
482         dev->flags = DF_ENABLED;
483         dev->order = 0;
484         if (unit == -1)
485                 dev->flags |= DF_WILDCARD;
486         if (name) {
487                 dev->flags |= DF_FIXEDCLASS;
488                 if (devclass_add_device(dc, dev) != 0) {
489                         kobj_delete((kobj_t)dev, M_BUS);
490                         return(NULL);
491                 }
492         }
493         dev->ivars = NULL;
494         dev->softc = NULL;
495
496         dev->state = DS_NOTPRESENT;
497
498         return(dev);
499 }
500
501 static int
502 device_print_child(device_t dev, device_t child)
503 {
504         int retval = 0;
505
506         if (device_is_alive(child))
507                 retval += BUS_PRINT_CHILD(dev, child);
508         else
509                 retval += device_printf(child, " not found\n");
510
511         return(retval);
512 }
513
514 device_t
515 device_add_child(device_t dev, const char *name, int unit)
516 {
517         return device_add_child_ordered(dev, 0, name, unit);
518 }
519
520 device_t
521 device_add_child_ordered(device_t dev, int order, const char *name, int unit)
522 {
523         device_t child;
524         device_t place;
525
526         PDEBUG(("%s at %s with order %d as unit %d", name, DEVICENAME(dev),
527                 order, unit));
528
529         child = make_device(dev, name, unit);
530         if (child == NULL)
531                 return child;
532         child->order = order;
533
534         TAILQ_FOREACH(place, &dev->children, link)
535                 if (place->order > order)
536                         break;
537
538         if (place) {
539                 /*
540                  * The device 'place' is the first device whose order is
541                  * greater than the new child.
542                  */
543                 TAILQ_INSERT_BEFORE(place, child, link);
544         } else {
545                 /*
546                  * The new child's order is greater or equal to the order of
547                  * any existing device. Add the child to the tail of the list.
548                  */
549                 TAILQ_INSERT_TAIL(&dev->children, child, link);
550         }
551
552         return(child);
553 }
554
555 int
556 device_delete_child(device_t dev, device_t child)
557 {
558         int error;
559         device_t grandchild;
560
561         PDEBUG(("%s from %s", DEVICENAME(child), DEVICENAME(dev)));
562
563         /* remove children first */
564         while ( (grandchild = TAILQ_FIRST(&child->children)) ) {
565                 error = device_delete_child(child, grandchild);
566                 if (error)
567                         return(error);
568         }
569
570         if ((error = device_detach(child)) != 0)
571                 return(error);
572         if (child->devclass)
573                 devclass_delete_device(child->devclass, child);
574         TAILQ_REMOVE(&dev->children, child, link);
575         device_set_desc(child, NULL);
576         kobj_delete((kobj_t)child, M_BUS);
577
578         return(0);
579 }
580
581 /*
582  * Find only devices attached to this bus.
583  */
584 device_t
585 device_find_child(device_t dev, const char *classname, int unit)
586 {
587         devclass_t dc;
588         device_t child;
589
590         dc = devclass_find(classname);
591         if (!dc)
592                 return(NULL);
593
594         child = devclass_get_device(dc, unit);
595         if (child && child->parent == dev)
596                 return(child);
597         return(NULL);
598 }
599
600 static driverlink_t
601 first_matching_driver(devclass_t dc, device_t dev)
602 {
603         if (dev->devclass)
604                 return(devclass_find_driver_internal(dc, dev->devclass->name));
605         else
606                 return(TAILQ_FIRST(&dc->drivers));
607 }
608
609 static driverlink_t
610 next_matching_driver(devclass_t dc, device_t dev, driverlink_t last)
611 {
612         if (dev->devclass) {
613                 driverlink_t dl;
614                 for (dl = TAILQ_NEXT(last, link); dl; dl = TAILQ_NEXT(dl, link))
615                         if (!strcmp(dev->devclass->name, dl->driver->name))
616                                 return(dl);
617                 return(NULL);
618         } else
619                 return(TAILQ_NEXT(last, link));
620 }
621
622 static int
623 device_probe_child(device_t dev, device_t child)
624 {
625         devclass_t dc;
626         driverlink_t best = 0;
627         driverlink_t dl;
628         int result, pri = 0;
629         int hasclass = (child->devclass != 0);
630
631         dc = dev->devclass;
632         if (!dc)
633                 panic("device_probe_child: parent device has no devclass");
634
635         if (child->state == DS_ALIVE)
636                 return(0);
637
638         for (; dc; dc = dc->parent) {
639                 for (dl = first_matching_driver(dc, child); dl;
640                      dl = next_matching_driver(dc, child, dl)) {
641                         PDEBUG(("Trying %s", DRIVERNAME(dl->driver)));
642                         device_set_driver(child, dl->driver);
643                         if (!hasclass)
644                                 device_set_devclass(child, dl->driver->name);
645                         result = DEVICE_PROBE(child);
646                         if (!hasclass)
647                                 device_set_devclass(child, 0);
648
649                         /*
650                          * If the driver returns SUCCESS, there can be
651                          * no higher match for this device.
652                          */
653                         if (result == 0) {
654                                 best = dl;
655                                 pri = 0;
656                                 break;
657                         }
658
659                         /*
660                          * The driver returned an error so it
661                          * certainly doesn't match.
662                          */
663                         if (result > 0) {
664                                 device_set_driver(child, 0);
665                                 continue;
666                         }
667
668                         /*
669                          * A priority lower than SUCCESS, remember the
670                          * best matching driver. Initialise the value
671                          * of pri for the first match.
672                          */
673                         if (best == 0 || result > pri) {
674                                 best = dl;
675                                 pri = result;
676                                 continue;
677                         }
678                 }
679                 /*
680                  * If we have unambiguous match in this devclass,
681                  * don't look in the parent.
682                  */
683                 if (best && pri == 0)
684                         break;
685         }
686
687         /*
688          * If we found a driver, change state and initialise the devclass.
689          */
690         if (best) {
691                 if (!child->devclass)
692                         device_set_devclass(child, best->driver->name);
693                 device_set_driver(child, best->driver);
694                 if (pri < 0) {
695                         /*
696                          * A bit bogus. Call the probe method again to make
697                          * sure that we have the right description.
698                          */
699                         DEVICE_PROBE(child);
700                 }
701                 child->state = DS_ALIVE;
702                 return(0);
703         }
704
705         return(ENXIO);
706 }
707
708 device_t
709 device_get_parent(device_t dev)
710 {
711         return dev->parent;
712 }
713
714 int
715 device_get_children(device_t dev, device_t **devlistp, int *devcountp)
716 {
717         int count;
718         device_t child;
719         device_t *list;
720     
721         count = 0;
722         TAILQ_FOREACH(child, &dev->children, link)
723                 count++;
724
725         list = malloc(count * sizeof(device_t), M_TEMP, M_INTWAIT | M_ZERO);
726         if (!list)
727                 return(ENOMEM);
728
729         count = 0;
730         TAILQ_FOREACH(child, &dev->children, link) {
731                 list[count] = child;
732                 count++;
733         }
734
735         *devlistp = list;
736         *devcountp = count;
737
738         return(0);
739 }
740
741 driver_t *
742 device_get_driver(device_t dev)
743 {
744         return(dev->driver);
745 }
746
747 devclass_t
748 device_get_devclass(device_t dev)
749 {
750         return(dev->devclass);
751 }
752
753 const char *
754 device_get_name(device_t dev)
755 {
756         if (dev->devclass)
757                 return devclass_get_name(dev->devclass);
758         return(NULL);
759 }
760
761 const char *
762 device_get_nameunit(device_t dev)
763 {
764         return(dev->nameunit);
765 }
766
767 int
768 device_get_unit(device_t dev)
769 {
770         return(dev->unit);
771 }
772
773 const char *
774 device_get_desc(device_t dev)
775 {
776         return(dev->desc);
777 }
778
779 uint32_t
780 device_get_flags(device_t dev)
781 {
782         return(dev->devflags);
783 }
784
785 int
786 device_print_prettyname(device_t dev)
787 {
788         const char *name = device_get_name(dev);
789
790         if (name == 0)
791                 return printf("unknown: ");
792         else
793                 return printf("%s%d: ", name, device_get_unit(dev));
794 }
795
796 int
797 device_printf(device_t dev, const char * fmt, ...)
798 {
799         __va_list ap;
800         int retval;
801
802         retval = device_print_prettyname(dev);
803         __va_start(ap, fmt);
804         retval += vprintf(fmt, ap);
805         __va_end(ap);
806         return retval;
807 }
808
809 static void
810 device_set_desc_internal(device_t dev, const char* desc, int copy)
811 {
812         if (dev->desc && (dev->flags & DF_DESCMALLOCED)) {
813                 free(dev->desc, M_BUS);
814                 dev->flags &= ~DF_DESCMALLOCED;
815                 dev->desc = NULL;
816         }
817
818         if (copy && desc) {
819                 dev->desc = malloc(strlen(desc) + 1, M_BUS, M_INTWAIT);
820                 if (dev->desc) {
821                         strcpy(dev->desc, desc);
822                         dev->flags |= DF_DESCMALLOCED;
823                 }
824         } else
825                 /* Avoid a -Wcast-qual warning */
826                 dev->desc = (char *)(uintptr_t) desc;
827
828 #ifdef DEVICE_SYSCTLS
829         {
830                 struct sysctl_oid *oid = &dev->oid[1];
831                 oid->oid_arg1 = dev->desc ? dev->desc : "";
832                 oid->oid_arg2 = dev->desc ? strlen(dev->desc) : 0;
833         }
834 #endif
835 }
836
837 void
838 device_set_desc(device_t dev, const char* desc)
839 {
840         device_set_desc_internal(dev, desc, FALSE);
841 }
842
843 void
844 device_set_desc_copy(device_t dev, const char* desc)
845 {
846         device_set_desc_internal(dev, desc, TRUE);
847 }
848
849 void
850 device_set_flags(device_t dev, uint32_t flags)
851 {
852         dev->devflags = flags;
853 }
854
855 void *
856 device_get_softc(device_t dev)
857 {
858         return dev->softc;
859 }
860
861 void
862 device_set_softc(device_t dev, void *softc)
863 {
864         if (dev->softc && !(dev->flags & DF_EXTERNALSOFTC))
865                 free(dev->softc, M_BUS);
866         dev->softc = softc;
867         if (dev->softc)
868                 dev->flags |= DF_EXTERNALSOFTC;
869         else
870                 dev->flags &= ~DF_EXTERNALSOFTC;
871 }
872
873 void *
874 device_get_ivars(device_t dev)
875 {
876         return dev->ivars;
877 }
878
879 void
880 device_set_ivars(device_t dev, void * ivars)
881 {
882         if (!dev)
883                 return;
884
885         dev->ivars = ivars;
886 }
887
888 device_state_t
889 device_get_state(device_t dev)
890 {
891         return(dev->state);
892 }
893
894 void
895 device_enable(device_t dev)
896 {
897         dev->flags |= DF_ENABLED;
898 }
899
900 void
901 device_disable(device_t dev)
902 {
903         dev->flags &= ~DF_ENABLED;
904 }
905
906 /*
907  * YYY cannot block
908  */
909 void
910 device_busy(device_t dev)
911 {
912         if (dev->state < DS_ATTACHED)
913                 panic("device_busy: called for unattached device");
914         if (dev->busy == 0 && dev->parent)
915                 device_busy(dev->parent);
916         dev->busy++;
917         dev->state = DS_BUSY;
918 }
919
920 /*
921  * YYY cannot block
922  */
923 void
924 device_unbusy(device_t dev)
925 {
926         if (dev->state != DS_BUSY)
927                 panic("device_unbusy: called for non-busy device");
928         dev->busy--;
929         if (dev->busy == 0) {
930                 if (dev->parent)
931                         device_unbusy(dev->parent);
932                 dev->state = DS_ATTACHED;
933         }
934 }
935
936 void
937 device_quiet(device_t dev)
938 {
939         dev->flags |= DF_QUIET;
940 }
941
942 void
943 device_verbose(device_t dev)
944 {
945         dev->flags &= ~DF_QUIET;
946 }
947
948 int
949 device_is_quiet(device_t dev)
950 {
951         return((dev->flags & DF_QUIET) != 0);
952 }
953
954 int
955 device_is_enabled(device_t dev)
956 {
957         return((dev->flags & DF_ENABLED) != 0);
958 }
959
960 int
961 device_is_alive(device_t dev)
962 {
963         return(dev->state >= DS_ALIVE);
964 }
965
966 int
967 device_is_attached(device_t dev)
968 {
969         return(dev->state >= DS_ATTACHED);
970 }
971
972 int
973 device_set_devclass(device_t dev, const char *classname)
974 {
975         devclass_t dc;
976
977         if (!classname) {
978                 if (dev->devclass)
979                         devclass_delete_device(dev->devclass, dev);
980                 return(0);
981         }
982
983         if (dev->devclass) {
984                 printf("device_set_devclass: device class already set\n");
985                 return(EINVAL);
986         }
987
988         dc = devclass_find_internal(classname, NULL, TRUE);
989         if (!dc)
990                 return(ENOMEM);
991
992         return(devclass_add_device(dc, dev));
993 }
994
995 int
996 device_set_driver(device_t dev, driver_t *driver)
997 {
998         if (dev->state >= DS_ATTACHED)
999                 return(EBUSY);
1000
1001         if (dev->driver == driver)
1002                 return(0);
1003
1004         if (dev->softc && !(dev->flags & DF_EXTERNALSOFTC)) {
1005                 free(dev->softc, M_BUS);
1006                 dev->softc = NULL;
1007         }
1008         kobj_delete((kobj_t) dev, 0);
1009         dev->driver = driver;
1010         if (driver) {
1011                 kobj_init((kobj_t) dev, (kobj_class_t) driver);
1012                 if (!(dev->flags & DF_EXTERNALSOFTC)) {
1013                         dev->softc = malloc(driver->size, M_BUS,
1014                                             M_INTWAIT | M_ZERO);
1015                         if (!dev->softc) {
1016                                 kobj_delete((kobj_t)dev, 0);
1017                                 kobj_init((kobj_t) dev, &null_class);
1018                                 dev->driver = NULL;
1019                                 return(ENOMEM);
1020                         }
1021                 }
1022         } else
1023                 kobj_init((kobj_t) dev, &null_class);
1024         return(0);
1025 }
1026
1027 int
1028 device_probe_and_attach(device_t dev)
1029 {
1030         device_t bus = dev->parent;
1031         int error = 0;
1032         int hasclass = (dev->devclass != 0);
1033
1034         if (dev->state >= DS_ALIVE)
1035                 return(0);
1036
1037         if ((dev->flags & DF_ENABLED) == 0) {
1038                 if (bootverbose) {
1039                         device_print_prettyname(dev);
1040                         printf("not probed (disabled)\n");
1041                 }
1042                 return(0);
1043         }
1044
1045         error = device_probe_child(bus, dev);
1046         if (error) {
1047                 if (!(dev->flags & DF_DONENOMATCH)) {
1048                         BUS_PROBE_NOMATCH(bus, dev);
1049                         dev->flags |= DF_DONENOMATCH;
1050                 }
1051                 return(error);
1052         }
1053         
1054         if (!device_is_quiet(dev))
1055                 device_print_child(bus, dev);
1056         error = DEVICE_ATTACH(dev);
1057         if (!error)
1058                 dev->state = DS_ATTACHED;
1059         else {
1060                 printf("device_probe_and_attach: %s%d attach returned %d\n",
1061                        dev->driver->name, dev->unit, error);
1062                 /* Unset the class that was set in device_probe_child */
1063                 if (!hasclass)
1064                         device_set_devclass(dev, 0);
1065                 device_set_driver(dev, NULL);
1066                 dev->state = DS_NOTPRESENT;
1067         }
1068
1069         return(error);
1070 }
1071
1072 int
1073 device_detach(device_t dev)
1074 {
1075         int error;
1076
1077         PDEBUG(("%s", DEVICENAME(dev)));
1078         if (dev->state == DS_BUSY)
1079                 return(EBUSY);
1080         if (dev->state != DS_ATTACHED)
1081                 return(0);
1082
1083         if ((error = DEVICE_DETACH(dev)) != 0)
1084                 return(error);
1085         device_printf(dev, "detached\n");
1086         if (dev->parent)
1087                 BUS_CHILD_DETACHED(dev->parent, dev);
1088
1089         if (!(dev->flags & DF_FIXEDCLASS))
1090                 devclass_delete_device(dev->devclass, dev);
1091
1092         dev->state = DS_NOTPRESENT;
1093         device_set_driver(dev, NULL);
1094
1095         return(0);
1096 }
1097
1098 int
1099 device_shutdown(device_t dev)
1100 {
1101         if (dev->state < DS_ATTACHED)
1102                 return 0;
1103         PDEBUG(("%s", DEVICENAME(dev)));
1104         return DEVICE_SHUTDOWN(dev);
1105 }
1106
1107 int
1108 device_set_unit(device_t dev, int unit)
1109 {
1110         devclass_t dc;
1111         int err;
1112
1113         dc = device_get_devclass(dev);
1114         if (unit < dc->maxunit && dc->devices[unit])
1115                 return(EBUSY);
1116         err = devclass_delete_device(dc, dev);
1117         if (err)
1118                 return(err);
1119         dev->unit = unit;
1120         err = devclass_add_device(dc, dev);
1121         return(err);
1122 }
1123
1124 #ifdef DEVICE_SYSCTLS
1125
1126 /*
1127  * Sysctl nodes for devices.
1128  */
1129
1130 SYSCTL_NODE(_hw, OID_AUTO, devices, CTLFLAG_RW, 0, "A list of all devices");
1131
1132 static int
1133 sysctl_handle_children(SYSCTL_HANDLER_ARGS)
1134 {
1135         device_t dev = arg1;
1136         device_t child;
1137         int first = 1, error = 0;
1138
1139         TAILQ_FOREACH(child, &dev->children, link)
1140                 if (child->nameunit) {
1141                         if (!first) {
1142                                 error = SYSCTL_OUT(req, ",", 1);
1143                                 if (error)
1144                                         return error;
1145                         } else
1146                                 first = 0;
1147                         error = SYSCTL_OUT(req, child->nameunit,
1148                                            strlen(child->nameunit));
1149                         if (error)
1150                                 return(error);
1151                 }
1152
1153         error = SYSCTL_OUT(req, "", 1);
1154
1155         return(error);
1156 }
1157
1158 static int
1159 sysctl_handle_state(SYSCTL_HANDLER_ARGS)
1160 {
1161         device_t dev = arg1;
1162
1163         switch (dev->state) {
1164         case DS_NOTPRESENT:
1165                 return SYSCTL_OUT(req, "notpresent", sizeof("notpresent"));
1166         case DS_ALIVE:
1167                 return SYSCTL_OUT(req, "alive", sizeof("alive"));
1168         case DS_ATTACHED:
1169                 return SYSCTL_OUT(req, "attached", sizeof("attached"));
1170         case DS_BUSY:
1171                 return SYSCTL_OUT(req, "busy", sizeof("busy"));
1172         default:
1173                 return (0);
1174         }
1175 }
1176
1177 static void
1178 device_register_oids(device_t dev)
1179 {
1180         struct sysctl_oid* oid;
1181
1182         oid = &dev->oid[0];
1183         bzero(oid, sizeof(*oid));
1184         oid->oid_parent = &sysctl__hw_devices_children;
1185         oid->oid_number = OID_AUTO;
1186         oid->oid_kind = CTLTYPE_NODE | CTLFLAG_RW;
1187         oid->oid_arg1 = &dev->oidlist[0];
1188         oid->oid_arg2 = 0;
1189         oid->oid_name = dev->nameunit;
1190         oid->oid_handler = 0;
1191         oid->oid_fmt = "N";
1192         SLIST_INIT(&dev->oidlist[0]);
1193         sysctl_register_oid(oid);
1194
1195         oid = &dev->oid[1];
1196         bzero(oid, sizeof(*oid));
1197         oid->oid_parent = &dev->oidlist[0];
1198         oid->oid_number = OID_AUTO;
1199         oid->oid_kind = CTLTYPE_STRING | CTLFLAG_RD;
1200         oid->oid_arg1 = dev->desc ? dev->desc : "";
1201         oid->oid_arg2 = dev->desc ? strlen(dev->desc) : 0;
1202         oid->oid_name = "desc";
1203         oid->oid_handler = sysctl_handle_string;
1204         oid->oid_fmt = "A";
1205         sysctl_register_oid(oid);
1206
1207         oid = &dev->oid[2];
1208         bzero(oid, sizeof(*oid));
1209         oid->oid_parent = &dev->oidlist[0];
1210         oid->oid_number = OID_AUTO;
1211         oid->oid_kind = CTLTYPE_INT | CTLFLAG_RD;
1212         oid->oid_arg1 = dev;
1213         oid->oid_arg2 = 0;
1214         oid->oid_name = "children";
1215         oid->oid_handler = sysctl_handle_children;
1216         oid->oid_fmt = "A";
1217         sysctl_register_oid(oid);
1218
1219         oid = &dev->oid[3];
1220         bzero(oid, sizeof(*oid));
1221         oid->oid_parent = &dev->oidlist[0];
1222         oid->oid_number = OID_AUTO;
1223         oid->oid_kind = CTLTYPE_INT | CTLFLAG_RD;
1224         oid->oid_arg1 = dev;
1225         oid->oid_arg2 = 0;
1226         oid->oid_name = "state";
1227         oid->oid_handler = sysctl_handle_state;
1228         oid->oid_fmt = "A";
1229         sysctl_register_oid(oid);
1230 }
1231
1232 static void
1233 device_unregister_oids(device_t dev)
1234 {
1235         sysctl_unregister_oid(&dev->oid[0]);
1236         sysctl_unregister_oid(&dev->oid[1]);
1237         sysctl_unregister_oid(&dev->oid[2]);
1238 }
1239
1240 #endif
1241
1242 /*======================================*/
1243 /*
1244  * Access functions for device resources.
1245  */
1246
1247 /* Supplied by config(8) in ioconf.c */
1248 extern struct config_device config_devtab[];
1249 extern int devtab_count;
1250
1251 /* Runtime version */
1252 struct config_device *devtab = config_devtab;
1253
1254 static int
1255 resource_new_name(const char *name, int unit)
1256 {
1257         struct config_device *new;
1258
1259         new = malloc((devtab_count + 1) * sizeof(*new), M_TEMP,
1260                      M_INTWAIT | M_ZERO);
1261         if (new == NULL)
1262                 return(-1);
1263         if (devtab && devtab_count > 0)
1264                 bcopy(devtab, new, devtab_count * sizeof(*new));
1265         new[devtab_count].name = malloc(strlen(name) + 1, M_TEMP, M_INTWAIT);
1266         if (new[devtab_count].name == NULL) {
1267                 free(new, M_TEMP);
1268                 return(-1);
1269         }
1270         strcpy(new[devtab_count].name, name);
1271         new[devtab_count].unit = unit;
1272         new[devtab_count].resource_count = 0;
1273         new[devtab_count].resources = NULL;
1274         if (devtab && devtab != config_devtab)
1275                 free(devtab, M_TEMP);
1276         devtab = new;
1277         return devtab_count++;
1278 }
1279
1280 static int
1281 resource_new_resname(int j, const char *resname, resource_type type)
1282 {
1283         struct config_resource *new;
1284         int i;
1285
1286         i = devtab[j].resource_count;
1287         new = malloc((i + 1) * sizeof(*new), M_TEMP, M_INTWAIT | M_ZERO);
1288         if (new == NULL)
1289                 return(-1);
1290         if (devtab[j].resources && i > 0)
1291                 bcopy(devtab[j].resources, new, i * sizeof(*new));
1292         new[i].name = malloc(strlen(resname) + 1, M_TEMP, M_INTWAIT);
1293         if (new[i].name == NULL) {
1294                 free(new, M_TEMP);
1295                 return(-1);
1296         }
1297         strcpy(new[i].name, resname);
1298         new[i].type = type;
1299         if (devtab[j].resources)
1300                 free(devtab[j].resources, M_TEMP);
1301         devtab[j].resources = new;
1302         devtab[j].resource_count = i + 1;
1303         return(i);
1304 }
1305
1306 static int
1307 resource_match_string(int i, const char *resname, const char *value)
1308 {
1309         int j;
1310         struct config_resource *res;
1311
1312         for (j = 0, res = devtab[i].resources;
1313              j < devtab[i].resource_count; j++, res++)
1314                 if (!strcmp(res->name, resname)
1315                     && res->type == RES_STRING
1316                     && !strcmp(res->u.stringval, value))
1317                         return(j);
1318         return(-1);
1319 }
1320
1321 static int
1322 resource_find(const char *name, int unit, const char *resname, 
1323               struct config_resource **result)
1324 {
1325         int i, j;
1326         struct config_resource *res;
1327
1328         /*
1329          * First check specific instances, then generic.
1330          */
1331         for (i = 0; i < devtab_count; i++) {
1332                 if (devtab[i].unit < 0)
1333                         continue;
1334                 if (!strcmp(devtab[i].name, name) && devtab[i].unit == unit) {
1335                         res = devtab[i].resources;
1336                         for (j = 0; j < devtab[i].resource_count; j++, res++)
1337                                 if (!strcmp(res->name, resname)) {
1338                                         *result = res;
1339                                         return(0);
1340                                 }
1341                 }
1342         }
1343         for (i = 0; i < devtab_count; i++) {
1344                 if (devtab[i].unit >= 0)
1345                         continue;
1346                 /* XXX should this `&& devtab[i].unit == unit' be here? */
1347                 /* XXX if so, then the generic match does nothing */
1348                 if (!strcmp(devtab[i].name, name) && devtab[i].unit == unit) {
1349                         res = devtab[i].resources;
1350                         for (j = 0; j < devtab[i].resource_count; j++, res++)
1351                                 if (!strcmp(res->name, resname)) {
1352                                         *result = res;
1353                                         return(0);
1354                                 }
1355                 }
1356         }
1357         return(ENOENT);
1358 }
1359
1360 int
1361 resource_int_value(const char *name, int unit, const char *resname, int *result)
1362 {
1363         int error;
1364         struct config_resource *res;
1365
1366         if ((error = resource_find(name, unit, resname, &res)) != 0)
1367                 return(error);
1368         if (res->type != RES_INT)
1369                 return(EFTYPE);
1370         *result = res->u.intval;
1371         return(0);
1372 }
1373
1374 int
1375 resource_long_value(const char *name, int unit, const char *resname,
1376                     long *result)
1377 {
1378         int error;
1379         struct config_resource *res;
1380
1381         if ((error = resource_find(name, unit, resname, &res)) != 0)
1382                 return(error);
1383         if (res->type != RES_LONG)
1384                 return(EFTYPE);
1385         *result = res->u.longval;
1386         return(0);
1387 }
1388
1389 int
1390 resource_string_value(const char *name, int unit, const char *resname,
1391                       char **result)
1392 {
1393         int error;
1394         struct config_resource *res;
1395
1396         if ((error = resource_find(name, unit, resname, &res)) != 0)
1397                 return(error);
1398         if (res->type != RES_STRING)
1399                 return(EFTYPE);
1400         *result = res->u.stringval;
1401         return(0);
1402 }
1403
1404 int
1405 resource_query_string(int i, const char *resname, const char *value)
1406 {
1407         if (i < 0)
1408                 i = 0;
1409         else
1410                 i = i + 1;
1411         for (; i < devtab_count; i++)
1412                 if (resource_match_string(i, resname, value) >= 0)
1413                         return(i);
1414         return(-1);
1415 }
1416
1417 int
1418 resource_locate(int i, const char *resname)
1419 {
1420         if (i < 0)
1421                 i = 0;
1422         else
1423                 i = i + 1;
1424         for (; i < devtab_count; i++)
1425                 if (!strcmp(devtab[i].name, resname))
1426                         return(i);
1427         return(-1);
1428 }
1429
1430 int
1431 resource_count(void)
1432 {
1433         return(devtab_count);
1434 }
1435
1436 char *
1437 resource_query_name(int i)
1438 {
1439         return(devtab[i].name);
1440 }
1441
1442 int
1443 resource_query_unit(int i)
1444 {
1445         return(devtab[i].unit);
1446 }
1447
1448 static int
1449 resource_create(const char *name, int unit, const char *resname,
1450                 resource_type type, struct config_resource **result)
1451 {
1452         int i, j;
1453         struct config_resource *res = NULL;
1454
1455         for (i = 0; i < devtab_count; i++)
1456                 if (!strcmp(devtab[i].name, name) && devtab[i].unit == unit) {
1457                         res = devtab[i].resources;
1458                         break;
1459                 }
1460         if (res == NULL) {
1461                 i = resource_new_name(name, unit);
1462                 if (i < 0)
1463                         return(ENOMEM);
1464                 res = devtab[i].resources;
1465         }
1466         for (j = 0; j < devtab[i].resource_count; j++, res++)
1467                 if (!strcmp(res->name, resname)) {
1468                         *result = res;
1469                         return(0);
1470                 }
1471         j = resource_new_resname(i, resname, type);
1472         if (j < 0)
1473                 return(ENOMEM);
1474         res = &devtab[i].resources[j];
1475         *result = res;
1476         return(0);
1477 }
1478
1479 int
1480 resource_set_int(const char *name, int unit, const char *resname, int value)
1481 {
1482         int error;
1483         struct config_resource *res;
1484
1485         error = resource_create(name, unit, resname, RES_INT, &res);
1486         if (error)
1487                 return(error);
1488         if (res->type != RES_INT)
1489                 return(EFTYPE);
1490         res->u.intval = value;
1491         return(0);
1492 }
1493
1494 int
1495 resource_set_long(const char *name, int unit, const char *resname, long value)
1496 {
1497         int error;
1498         struct config_resource *res;
1499
1500         error = resource_create(name, unit, resname, RES_LONG, &res);
1501         if (error)
1502                 return(error);
1503         if (res->type != RES_LONG)
1504                 return(EFTYPE);
1505         res->u.longval = value;
1506         return(0);
1507 }
1508
1509 int
1510 resource_set_string(const char *name, int unit, const char *resname,
1511                     const char *value)
1512 {
1513         int error;
1514         struct config_resource *res;
1515
1516         error = resource_create(name, unit, resname, RES_STRING, &res);
1517         if (error)
1518                 return(error);
1519         if (res->type != RES_STRING)
1520                 return(EFTYPE);
1521         if (res->u.stringval)
1522                 free(res->u.stringval, M_TEMP);
1523         res->u.stringval = malloc(strlen(value) + 1, M_TEMP, M_INTWAIT);
1524         if (res->u.stringval == NULL)
1525                 return(ENOMEM);
1526         strcpy(res->u.stringval, value);
1527         return(0);
1528 }
1529
1530 static void
1531 resource_cfgload(void *dummy __unused)
1532 {
1533         struct config_resource *res, *cfgres;
1534         int i, j;
1535         int error;
1536         char *name, *resname;
1537         int unit;
1538         resource_type type;
1539         char *stringval;
1540         int config_devtab_count;
1541
1542         config_devtab_count = devtab_count;
1543         devtab = NULL;
1544         devtab_count = 0;
1545
1546         for (i = 0; i < config_devtab_count; i++) {
1547                 name = config_devtab[i].name;
1548                 unit = config_devtab[i].unit;
1549
1550                 for (j = 0; j < config_devtab[i].resource_count; j++) {
1551                         cfgres = config_devtab[i].resources;
1552                         resname = cfgres[j].name;
1553                         type = cfgres[j].type;
1554                         error = resource_create(name, unit, resname, type,
1555                                                 &res);
1556                         if (error) {
1557                                 printf("create resource %s%d: error %d\n",
1558                                         name, unit, error);
1559                                 continue;
1560                         }
1561                         if (res->type != type) {
1562                                 printf("type mismatch %s%d: %d != %d\n",
1563                                         name, unit, res->type, type);
1564                                 continue;
1565                         }
1566                         switch (type) {
1567                         case RES_INT:
1568                                 res->u.intval = cfgres[j].u.intval;
1569                                 break;
1570                         case RES_LONG:
1571                                 res->u.longval = cfgres[j].u.longval;
1572                                 break;
1573                         case RES_STRING:
1574                                 if (res->u.stringval)
1575                                         free(res->u.stringval, M_TEMP);
1576                                 stringval = cfgres[j].u.stringval;
1577                                 res->u.stringval = malloc(strlen(stringval) + 1,
1578                                                           M_TEMP, M_INTWAIT);
1579                                 if (res->u.stringval == NULL)
1580                                         break;
1581                                 strcpy(res->u.stringval, stringval);
1582                                 break;
1583                         default:
1584                                 panic("unknown resource type %d", type);
1585                         }
1586                 }
1587         }
1588 }
1589 SYSINIT(cfgload, SI_SUB_KMEM, SI_ORDER_ANY + 50, resource_cfgload, 0)
1590
1591
1592 /*======================================*/
1593 /*
1594  * Some useful method implementations to make life easier for bus drivers.
1595  */
1596
1597 void
1598 resource_list_init(struct resource_list *rl)
1599 {
1600         SLIST_INIT(rl);
1601 }
1602
1603 void
1604 resource_list_free(struct resource_list *rl)
1605 {
1606         struct resource_list_entry *rle;
1607
1608         while ((rle = SLIST_FIRST(rl)) != NULL) {
1609                 if (rle->res)
1610                         panic("resource_list_free: resource entry is busy");
1611                 SLIST_REMOVE_HEAD(rl, link);
1612                 free(rle, M_BUS);
1613         }
1614 }
1615
1616 void
1617 resource_list_add(struct resource_list *rl,
1618                   int type, int rid,
1619                   u_long start, u_long end, u_long count)
1620 {
1621         struct resource_list_entry *rle;
1622
1623         rle = resource_list_find(rl, type, rid);
1624         if (rle == NULL) {
1625                 rle = malloc(sizeof(struct resource_list_entry), M_BUS,
1626                              M_INTWAIT);
1627                 if (!rle)
1628                         panic("resource_list_add: can't record entry");
1629                 SLIST_INSERT_HEAD(rl, rle, link);
1630                 rle->type = type;
1631                 rle->rid = rid;
1632                 rle->res = NULL;
1633         }
1634
1635         if (rle->res)
1636                 panic("resource_list_add: resource entry is busy");
1637
1638         rle->start = start;
1639         rle->end = end;
1640         rle->count = count;
1641 }
1642
1643 struct resource_list_entry*
1644 resource_list_find(struct resource_list *rl,
1645                    int type, int rid)
1646 {
1647         struct resource_list_entry *rle;
1648
1649         SLIST_FOREACH(rle, rl, link)
1650                 if (rle->type == type && rle->rid == rid)
1651                         return(rle);
1652         return(NULL);
1653 }
1654
1655 void
1656 resource_list_delete(struct resource_list *rl,
1657                      int type, int rid)
1658 {
1659         struct resource_list_entry *rle = resource_list_find(rl, type, rid);
1660
1661         if (rle) {
1662                 SLIST_REMOVE(rl, rle, resource_list_entry, link);
1663                 free(rle, M_BUS);
1664         }
1665 }
1666
1667 struct resource *
1668 resource_list_alloc(struct resource_list *rl,
1669                     device_t bus, device_t child,
1670                     int type, int *rid,
1671                     u_long start, u_long end,
1672                     u_long count, u_int flags)
1673 {
1674         struct resource_list_entry *rle = 0;
1675         int passthrough = (device_get_parent(child) != bus);
1676         int isdefault = (start == 0UL && end == ~0UL);
1677
1678         if (passthrough) {
1679                 return(BUS_ALLOC_RESOURCE(device_get_parent(bus), child,
1680                                           type, rid,
1681                                           start, end, count, flags));
1682         }
1683
1684         rle = resource_list_find(rl, type, *rid);
1685
1686         if (!rle)
1687                 return(0);              /* no resource of that type/rid */
1688         if (rle->res)
1689                 panic("resource_list_alloc: resource entry is busy");
1690
1691         if (isdefault) {
1692                 start = rle->start;
1693                 count = max(count, rle->count);
1694                 end = max(rle->end, start + count - 1);
1695         }
1696
1697         rle->res = BUS_ALLOC_RESOURCE(device_get_parent(bus), child,
1698                                       type, rid, start, end, count, flags);
1699
1700         /*
1701          * Record the new range.
1702          */
1703         if (rle->res) {
1704                 rle->start = rman_get_start(rle->res);
1705                 rle->end = rman_get_end(rle->res);
1706                 rle->count = count;
1707         }
1708
1709         return(rle->res);
1710 }
1711
1712 int
1713 resource_list_release(struct resource_list *rl,
1714                       device_t bus, device_t child,
1715                       int type, int rid, struct resource *res)
1716 {
1717         struct resource_list_entry *rle = 0;
1718         int passthrough = (device_get_parent(child) != bus);
1719         int error;
1720
1721         if (passthrough) {
1722                 return(BUS_RELEASE_RESOURCE(device_get_parent(bus), child,
1723                                             type, rid, res));
1724         }
1725
1726         rle = resource_list_find(rl, type, rid);
1727
1728         if (!rle)
1729                 panic("resource_list_release: can't find resource");
1730         if (!rle->res)
1731                 panic("resource_list_release: resource entry is not busy");
1732
1733         error = BUS_RELEASE_RESOURCE(device_get_parent(bus), child,
1734                                      type, rid, res);
1735         if (error)
1736                 return(error);
1737
1738         rle->res = NULL;
1739         return(0);
1740 }
1741
1742 int
1743 resource_list_print_type(struct resource_list *rl, const char *name, int type,
1744                          const char *format)
1745 {
1746         struct resource_list_entry *rle;
1747         int printed, retval;
1748
1749         printed = 0;
1750         retval = 0;
1751         /* Yes, this is kinda cheating */
1752         SLIST_FOREACH(rle, rl, link) {
1753                 if (rle->type == type) {
1754                         if (printed == 0)
1755                                 retval += printf(" %s ", name);
1756                         else
1757                                 retval += printf(",");
1758                         printed++;
1759                         retval += printf(format, rle->start);
1760                         if (rle->count > 1) {
1761                                 retval += printf("-");
1762                                 retval += printf(format, rle->start +
1763                                                  rle->count - 1);
1764                         }
1765                 }
1766         }
1767         return(retval);
1768 }
1769
1770 /*
1771  * Call DEVICE_IDENTIFY for each driver.
1772  */
1773 int
1774 bus_generic_probe(device_t dev)
1775 {
1776         devclass_t dc = dev->devclass;
1777         driverlink_t dl;
1778
1779         TAILQ_FOREACH(dl, &dc->drivers, link)
1780                 DEVICE_IDENTIFY(dl->driver, dev);
1781
1782         return(0);
1783 }
1784
1785 int
1786 bus_generic_attach(device_t dev)
1787 {
1788         device_t child;
1789
1790         TAILQ_FOREACH(child, &dev->children, link)
1791                 device_probe_and_attach(child);
1792
1793         return(0);
1794 }
1795
1796 int
1797 bus_generic_detach(device_t dev)
1798 {
1799         device_t child;
1800         int error;
1801
1802         if (dev->state != DS_ATTACHED)
1803                 return(EBUSY);
1804
1805         TAILQ_FOREACH(child, &dev->children, link)
1806                 if ((error = device_detach(child)) != 0)
1807                         return(error);
1808
1809         return 0;
1810 }
1811
1812 int
1813 bus_generic_shutdown(device_t dev)
1814 {
1815         device_t child;
1816
1817         TAILQ_FOREACH(child, &dev->children, link)
1818                 device_shutdown(child);
1819
1820         return(0);
1821 }
1822
1823 int
1824 bus_generic_suspend(device_t dev)
1825 {
1826         int error;
1827         device_t child, child2;
1828
1829         TAILQ_FOREACH(child, &dev->children, link) {
1830                 error = DEVICE_SUSPEND(child);
1831                 if (error) {
1832                         for (child2 = TAILQ_FIRST(&dev->children);
1833                              child2 && child2 != child; 
1834                              child2 = TAILQ_NEXT(child2, link))
1835                                 DEVICE_RESUME(child2);
1836                         return(error);
1837                 }
1838         }
1839         return(0);
1840 }
1841
1842 int
1843 bus_generic_resume(device_t dev)
1844 {
1845         device_t child;
1846
1847         TAILQ_FOREACH(child, &dev->children, link)
1848                 DEVICE_RESUME(child);
1849                 /* if resume fails, there's nothing we can usefully do... */
1850
1851         return(0);
1852 }
1853
1854 int
1855 bus_print_child_header(device_t dev, device_t child)
1856 {
1857         int retval = 0;
1858
1859         if (device_get_desc(child))
1860                 retval += device_printf(child, "<%s>", device_get_desc(child));
1861         else
1862                 retval += printf("%s", device_get_nameunit(child));
1863
1864         return(retval);
1865 }
1866
1867 int
1868 bus_print_child_footer(device_t dev, device_t child)
1869 {
1870         return(printf(" on %s\n", device_get_nameunit(dev)));
1871 }
1872
1873 int
1874 bus_generic_print_child(device_t dev, device_t child)
1875 {
1876         int retval = 0;
1877
1878         retval += bus_print_child_header(dev, child);
1879         retval += bus_print_child_footer(dev, child);
1880
1881         return(retval);
1882 }
1883
1884 int
1885 bus_generic_read_ivar(device_t dev, device_t child, int index, 
1886                       uintptr_t * result)
1887 {
1888     return(ENOENT);
1889 }
1890
1891 int
1892 bus_generic_write_ivar(device_t dev, device_t child, int index, 
1893                        uintptr_t value)
1894 {
1895     return(ENOENT);
1896 }
1897
1898 struct resource_list *
1899 bus_generic_get_resource_list(device_t dev, device_t child)
1900 {
1901     return(NULL);
1902 }
1903
1904 void
1905 bus_generic_driver_added(device_t dev, driver_t *driver)
1906 {
1907         device_t child;
1908
1909         DEVICE_IDENTIFY(driver, dev);
1910         TAILQ_FOREACH(child, &dev->children, link)
1911                 if (child->state == DS_NOTPRESENT)
1912                         device_probe_and_attach(child);
1913 }
1914
1915 int
1916 bus_generic_setup_intr(device_t dev, device_t child, struct resource *irq, 
1917                        int flags, driver_intr_t *intr, void *arg,
1918                        void **cookiep)
1919 {
1920         /* Propagate up the bus hierarchy until someone handles it. */
1921         if (dev->parent)
1922                 return(BUS_SETUP_INTR(dev->parent, child, irq, flags,
1923                                       intr, arg, cookiep));
1924         else
1925                 return(EINVAL);
1926 }
1927
1928 int
1929 bus_generic_teardown_intr(device_t dev, device_t child, struct resource *irq,
1930                           void *cookie)
1931 {
1932         /* Propagate up the bus hierarchy until someone handles it. */
1933         if (dev->parent)
1934                 return(BUS_TEARDOWN_INTR(dev->parent, child, irq, cookie));
1935         else
1936                 return(EINVAL);
1937 }
1938
1939 struct resource *
1940 bus_generic_alloc_resource(device_t dev, device_t child, int type, int *rid,
1941                            u_long start, u_long end, u_long count, u_int flags)
1942 {
1943         /* Propagate up the bus hierarchy until someone handles it. */
1944         if (dev->parent)
1945                 return(BUS_ALLOC_RESOURCE(dev->parent, child, type, rid, 
1946                                            start, end, count, flags));
1947         else
1948                 return(NULL);
1949 }
1950
1951 int
1952 bus_generic_release_resource(device_t dev, device_t child, int type, int rid,
1953                              struct resource *r)
1954 {
1955         /* Propagate up the bus hierarchy until someone handles it. */
1956         if (dev->parent)
1957                 return(BUS_RELEASE_RESOURCE(dev->parent, child, type, rid, r));
1958         else
1959                 return(EINVAL);
1960 }
1961
1962 int
1963 bus_generic_activate_resource(device_t dev, device_t child, int type, int rid,
1964                               struct resource *r)
1965 {
1966         /* Propagate up the bus hierarchy until someone handles it. */
1967         if (dev->parent)
1968                 return(BUS_ACTIVATE_RESOURCE(dev->parent, child, type, rid, r));
1969         else
1970                 return(EINVAL);
1971 }
1972
1973 int
1974 bus_generic_deactivate_resource(device_t dev, device_t child, int type,
1975                                 int rid, struct resource *r)
1976 {
1977         /* Propagate up the bus hierarchy until someone handles it. */
1978         if (dev->parent)
1979                 return(BUS_DEACTIVATE_RESOURCE(dev->parent, child, type, rid,
1980                                                r));
1981         else
1982                 return(EINVAL);
1983 }
1984
1985 int
1986 bus_generic_config_intr(device_t dev, int irq, enum intr_trigger trig,
1987     enum intr_polarity pol)
1988 {
1989         /* Propagate up the bus hierarchy until someone handles it. */
1990         if (dev->parent)
1991                 return(BUS_CONFIG_INTR(dev->parent, irq, trig, pol));
1992         else
1993                 return(EINVAL);
1994 }
1995
1996 int
1997 bus_generic_rl_get_resource(device_t dev, device_t child, int type, int rid,
1998     u_long *startp, u_long *countp)
1999 {
2000         struct resource_list *rl = NULL;
2001         struct resource_list_entry *rle = NULL;
2002
2003         rl = BUS_GET_RESOURCE_LIST(dev, child);
2004         if (!rl)
2005                 return(EINVAL);
2006
2007         rle = resource_list_find(rl, type, rid);
2008         if (!rle)
2009                 return(ENOENT);
2010
2011         if (startp)
2012                 *startp = rle->start;
2013         if (countp)
2014                 *countp = rle->count;
2015
2016         return(0);
2017 }
2018
2019 int
2020 bus_generic_rl_set_resource(device_t dev, device_t child, int type, int rid,
2021     u_long start, u_long count)
2022 {
2023         struct resource_list *rl = NULL;
2024
2025         rl = BUS_GET_RESOURCE_LIST(dev, child);
2026         if (!rl)
2027                 return(EINVAL);
2028
2029         resource_list_add(rl, type, rid, start, (start + count - 1), count);
2030
2031         return(0);
2032 }
2033
2034 void
2035 bus_generic_rl_delete_resource(device_t dev, device_t child, int type, int rid)
2036 {
2037         struct resource_list *rl = NULL;
2038
2039         rl = BUS_GET_RESOURCE_LIST(dev, child);
2040         if (!rl)
2041                 return;
2042
2043         resource_list_delete(rl, type, rid);
2044 }
2045
2046 int
2047 bus_generic_rl_release_resource(device_t dev, device_t child, int type,
2048     int rid, struct resource *r)
2049 {
2050         struct resource_list *rl = NULL;
2051
2052         rl = BUS_GET_RESOURCE_LIST(dev, child);
2053         if (!rl)
2054                 return(EINVAL);
2055
2056         return(resource_list_release(rl, dev, child, type, rid, r));
2057 }
2058
2059 struct resource *
2060 bus_generic_rl_alloc_resource(device_t dev, device_t child, int type,
2061     int *rid, u_long start, u_long end, u_long count, u_int flags)
2062 {
2063         struct resource_list *rl = NULL;
2064
2065         rl = BUS_GET_RESOURCE_LIST(dev, child);
2066         if (!rl)
2067                 return(NULL);
2068
2069         return(resource_list_alloc(rl, dev, child, type, rid,
2070             start, end, count, flags));
2071 }
2072
2073 int
2074 bus_generic_child_present(device_t bus, device_t child)
2075 {
2076         return(BUS_CHILD_PRESENT(device_get_parent(bus), bus));
2077 }
2078
2079
2080 /*
2081  * Some convenience functions to make it easier for drivers to use the
2082  * resource-management functions.  All these really do is hide the
2083  * indirection through the parent's method table, making for slightly
2084  * less-wordy code.  In the future, it might make sense for this code
2085  * to maintain some sort of a list of resources allocated by each device.
2086  */
2087 struct resource *
2088 bus_alloc_resource(device_t dev, int type, int *rid, u_long start, u_long end,
2089                    u_long count, u_int flags)
2090 {
2091         if (dev->parent == 0)
2092                 return(0);
2093         return(BUS_ALLOC_RESOURCE(dev->parent, dev, type, rid, start, end,
2094                                   count, flags));
2095 }
2096
2097 int
2098 bus_activate_resource(device_t dev, int type, int rid, struct resource *r)
2099 {
2100         if (dev->parent == 0)
2101                 return(EINVAL);
2102         return(BUS_ACTIVATE_RESOURCE(dev->parent, dev, type, rid, r));
2103 }
2104
2105 int
2106 bus_deactivate_resource(device_t dev, int type, int rid, struct resource *r)
2107 {
2108         if (dev->parent == 0)
2109                 return(EINVAL);
2110         return(BUS_DEACTIVATE_RESOURCE(dev->parent, dev, type, rid, r));
2111 }
2112
2113 int
2114 bus_release_resource(device_t dev, int type, int rid, struct resource *r)
2115 {
2116         if (dev->parent == 0)
2117                 return(EINVAL);
2118         return(BUS_RELEASE_RESOURCE(dev->parent, dev, type, rid, r));
2119 }
2120
2121 int
2122 bus_setup_intr(device_t dev, struct resource *r, int flags,
2123                driver_intr_t handler, void *arg, void **cookiep)
2124 {
2125         if (dev->parent == 0)
2126                 return(EINVAL);
2127         return(BUS_SETUP_INTR(dev->parent, dev, r, flags, handler, arg,
2128                cookiep));
2129 }
2130
2131 int
2132 bus_teardown_intr(device_t dev, struct resource *r, void *cookie)
2133 {
2134         if (dev->parent == 0)
2135                 return(EINVAL);
2136         return(BUS_TEARDOWN_INTR(dev->parent, dev, r, cookie));
2137 }
2138
2139 int
2140 bus_set_resource(device_t dev, int type, int rid,
2141                  u_long start, u_long count)
2142 {
2143         return(BUS_SET_RESOURCE(device_get_parent(dev), dev, type, rid,
2144                                 start, count));
2145 }
2146
2147 int
2148 bus_get_resource(device_t dev, int type, int rid,
2149                  u_long *startp, u_long *countp)
2150 {
2151         return(BUS_GET_RESOURCE(device_get_parent(dev), dev, type, rid,
2152                                 startp, countp));
2153 }
2154
2155 u_long
2156 bus_get_resource_start(device_t dev, int type, int rid)
2157 {
2158         u_long start, count;
2159         int error;
2160
2161         error = BUS_GET_RESOURCE(device_get_parent(dev), dev, type, rid,
2162                                  &start, &count);
2163         if (error)
2164                 return(0);
2165         return(start);
2166 }
2167
2168 u_long
2169 bus_get_resource_count(device_t dev, int type, int rid)
2170 {
2171         u_long start, count;
2172         int error;
2173
2174         error = BUS_GET_RESOURCE(device_get_parent(dev), dev, type, rid,
2175                                  &start, &count);
2176         if (error)
2177                 return(0);
2178         return(count);
2179 }
2180
2181 void
2182 bus_delete_resource(device_t dev, int type, int rid)
2183 {
2184         BUS_DELETE_RESOURCE(device_get_parent(dev), dev, type, rid);
2185 }
2186
2187 int
2188 bus_child_present(device_t child)
2189 {
2190         return (BUS_CHILD_PRESENT(device_get_parent(child), child));
2191 }
2192
2193 int
2194 bus_child_pnpinfo_str(device_t child, char *buf, size_t buflen)
2195 {
2196         device_t parent;
2197
2198         parent = device_get_parent(child);
2199         if (parent == NULL) {
2200                 *buf = '\0';
2201                 return (0);
2202         }
2203         return (BUS_CHILD_PNPINFO_STR(parent, child, buf, buflen));
2204 }
2205
2206 int
2207 bus_child_location_str(device_t child, char *buf, size_t buflen)
2208 {
2209         device_t parent;
2210
2211         parent = device_get_parent(child);
2212         if (parent == NULL) {
2213                 *buf = '\0';
2214                 return (0);
2215         }
2216         return (BUS_CHILD_LOCATION_STR(parent, child, buf, buflen));
2217 }
2218
2219 static int
2220 root_print_child(device_t dev, device_t child)
2221 {
2222         return(0);
2223 }
2224
2225 static int
2226 root_setup_intr(device_t dev, device_t child, driver_intr_t *intr, void *arg,
2227                 void **cookiep)
2228 {
2229         /*
2230          * If an interrupt mapping gets to here something bad has happened.
2231          */
2232         panic("root_setup_intr");
2233 }
2234
2235 /*
2236  * If we get here, assume that the device is permanant and really is
2237  * present in the system.  Removable bus drivers are expected to intercept
2238  * this call long before it gets here.  We return -1 so that drivers that
2239  * really care can check vs -1 or some ERRNO returned higher in the food
2240  * chain.
2241  */
2242 static int
2243 root_child_present(device_t dev, device_t child)
2244 {
2245         return(-1);
2246 }
2247
2248 /*
2249  * XXX NOTE! other defaults may be set in bus_if.m
2250  */
2251 static kobj_method_t root_methods[] = {
2252         /* Device interface */
2253         KOBJMETHOD(device_shutdown,     bus_generic_shutdown),
2254         KOBJMETHOD(device_suspend,      bus_generic_suspend),
2255         KOBJMETHOD(device_resume,       bus_generic_resume),
2256
2257         /* Bus interface */
2258         KOBJMETHOD(bus_print_child,     root_print_child),
2259         KOBJMETHOD(bus_read_ivar,       bus_generic_read_ivar),
2260         KOBJMETHOD(bus_write_ivar,      bus_generic_write_ivar),
2261         KOBJMETHOD(bus_setup_intr,      root_setup_intr),
2262         KOBJMETHOD(bus_child_present,   root_child_present),
2263
2264         { 0, 0 }
2265 };
2266
2267 static driver_t root_driver = {
2268         "root",
2269         root_methods,
2270         1,                      /* no softc */
2271 };
2272
2273 device_t        root_bus;
2274 devclass_t      root_devclass;
2275
2276 static int
2277 root_bus_module_handler(module_t mod, int what, void* arg)
2278 {
2279         switch (what) {
2280         case MOD_LOAD:
2281                 root_bus = make_device(NULL, "root", 0);
2282                 root_bus->desc = "System root bus";
2283                 kobj_init((kobj_t) root_bus, (kobj_class_t) &root_driver);
2284                 root_bus->driver = &root_driver;
2285                 root_bus->state = DS_ATTACHED;
2286                 root_devclass = devclass_find_internal("root", NULL, FALSE);
2287                 return(0);
2288
2289         case MOD_SHUTDOWN:
2290                 device_shutdown(root_bus);
2291                 return(0);
2292         default:
2293                 return(0);
2294         }
2295 }
2296
2297 static moduledata_t root_bus_mod = {
2298         "rootbus",
2299         root_bus_module_handler,
2300         0
2301 };
2302 DECLARE_MODULE(rootbus, root_bus_mod, SI_SUB_DRIVERS, SI_ORDER_FIRST);
2303
2304 void
2305 root_bus_configure(void)
2306 {
2307         device_t dev;
2308
2309         PDEBUG(("."));
2310
2311         TAILQ_FOREACH(dev, &root_bus->children, link)
2312                 device_probe_and_attach(dev);
2313 }
2314
2315 int
2316 driver_module_handler(module_t mod, int what, void *arg)
2317 {
2318         int error;
2319         struct driver_module_data *dmd;
2320         devclass_t bus_devclass;
2321         kobj_class_t driver;
2322         const char *parentname;
2323
2324         dmd = (struct driver_module_data *)arg;
2325         bus_devclass = devclass_find_internal(dmd->dmd_busname, NULL, TRUE);
2326         error = 0;
2327
2328         switch (what) {
2329         case MOD_LOAD:
2330                 if (dmd->dmd_chainevh)
2331                         error = dmd->dmd_chainevh(mod,what,dmd->dmd_chainarg);
2332
2333                 driver = dmd->dmd_driver;
2334                 PDEBUG(("Loading module: driver %s on bus %s",
2335                         DRIVERNAME(driver), dmd->dmd_busname));
2336                 error = devclass_add_driver(bus_devclass, driver);
2337                 if (error)
2338                         break;
2339
2340                 /*
2341                  * If the driver has any base classes, make the
2342                  * devclass inherit from the devclass of the driver's
2343                  * first base class. This will allow the system to
2344                  * search for drivers in both devclasses for children
2345                  * of a device using this driver.
2346                  */
2347                 if (driver->baseclasses)
2348                         parentname = driver->baseclasses[0]->name;
2349                 else
2350                         parentname = NULL;
2351                 *dmd->dmd_devclass = devclass_find_internal(driver->name,
2352                                                             parentname, TRUE);
2353                 break;
2354
2355         case MOD_UNLOAD:
2356                 PDEBUG(("Unloading module: driver %s from bus %s",
2357                         DRIVERNAME(dmd->dmd_driver), dmd->dmd_busname));
2358                 error = devclass_delete_driver(bus_devclass, dmd->dmd_driver);
2359
2360                 if (!error && dmd->dmd_chainevh)
2361                         error = dmd->dmd_chainevh(mod,what,dmd->dmd_chainarg);
2362                 break;
2363         }
2364
2365         return (error);
2366 }
2367
2368 #ifdef BUS_DEBUG
2369
2370 /*
2371  * The _short versions avoid iteration by not calling anything that prints
2372  * more than oneliners. I love oneliners.
2373  */
2374
2375 static void
2376 print_device_short(device_t dev, int indent)
2377 {
2378         if (!dev)
2379                 return;
2380
2381         indentprintf(("device %d: <%s> %sparent,%schildren,%s%s%s%s,%sivars,%ssoftc,busy=%d\n",
2382                       dev->unit, dev->desc,
2383                       (dev->parent? "":"no "),
2384                       (TAILQ_EMPTY(&dev->children)? "no ":""),
2385                       (dev->flags&DF_ENABLED? "enabled,":"disabled,"),
2386                       (dev->flags&DF_FIXEDCLASS? "fixed,":""),
2387                       (dev->flags&DF_WILDCARD? "wildcard,":""),
2388                       (dev->flags&DF_DESCMALLOCED? "descmalloced,":""),
2389                       (dev->ivars? "":"no "),
2390                       (dev->softc? "":"no "),
2391                       dev->busy));
2392 }
2393
2394 static void
2395 print_device(device_t dev, int indent)
2396 {
2397         if (!dev)
2398                 return;
2399
2400         print_device_short(dev, indent);
2401
2402         indentprintf(("Parent:\n"));
2403         print_device_short(dev->parent, indent+1);
2404         indentprintf(("Driver:\n"));
2405         print_driver_short(dev->driver, indent+1);
2406         indentprintf(("Devclass:\n"));
2407         print_devclass_short(dev->devclass, indent+1);
2408 }
2409
2410 /*
2411  * Print the device and all its children (indented).
2412  */
2413 void
2414 print_device_tree_short(device_t dev, int indent)
2415 {
2416         device_t child;
2417
2418         if (!dev)
2419                 return;
2420
2421         print_device_short(dev, indent);
2422
2423         TAILQ_FOREACH(child, &dev->children, link)
2424                 print_device_tree_short(child, indent+1);
2425 }
2426
2427 /*
2428  * Print the device and all its children (indented).
2429  */
2430 void
2431 print_device_tree(device_t dev, int indent)
2432 {
2433         device_t child;
2434
2435         if (!dev)
2436                 return;
2437
2438         print_device(dev, indent);
2439
2440         TAILQ_FOREACH(child, &dev->children, link)
2441                 print_device_tree(child, indent+1);
2442 }
2443
2444 static void
2445 print_driver_short(driver_t *driver, int indent)
2446 {
2447         if (!driver)
2448                 return;
2449
2450         indentprintf(("driver %s: softc size = %d\n",
2451                       driver->name, driver->size));
2452 }
2453
2454 static void
2455 print_driver(driver_t *driver, int indent)
2456 {
2457         if (!driver)
2458                 return;
2459
2460         print_driver_short(driver, indent);
2461 }
2462
2463
2464 static void
2465 print_driver_list(driver_list_t drivers, int indent)
2466 {
2467         driverlink_t driver;
2468
2469         TAILQ_FOREACH(driver, &drivers, link)
2470                 print_driver(driver->driver, indent);
2471 }
2472
2473 static void
2474 print_devclass_short(devclass_t dc, int indent)
2475 {
2476         if (!dc)
2477                 return;
2478
2479         indentprintf(("devclass %s: max units = %d\n", dc->name, dc->maxunit));
2480 }
2481
2482 static void
2483 print_devclass(devclass_t dc, int indent)
2484 {
2485         int i;
2486
2487         if (!dc)
2488                 return;
2489
2490         print_devclass_short(dc, indent);
2491         indentprintf(("Drivers:\n"));
2492         print_driver_list(dc->drivers, indent+1);
2493
2494         indentprintf(("Devices:\n"));
2495         for (i = 0; i < dc->maxunit; i++)
2496                 if (dc->devices[i])
2497                         print_device(dc->devices[i], indent+1);
2498 }
2499
2500 void
2501 print_devclass_list_short(void)
2502 {
2503         devclass_t dc;
2504
2505         printf("Short listing of devclasses, drivers & devices:\n");
2506         TAILQ_FOREACH(dc, &devclasses, link) {
2507                 print_devclass_short(dc, 0);
2508         }
2509 }
2510
2511 void
2512 print_devclass_list(void)
2513 {
2514         devclass_t dc;
2515
2516         printf("Full listing of devclasses, drivers & devices:\n");
2517         TAILQ_FOREACH(dc, &devclasses, link) {
2518                 print_devclass(dc, 0);
2519         }
2520 }
2521
2522 #endif
2523
2524 /*
2525  * Check to see if a device is disabled via a disabled hint.
2526  */
2527 int
2528 resource_disabled(const char *name, int unit)
2529 {
2530         int error, value;
2531
2532         error = resource_int_value(name, unit, "disabled", &value);
2533         if (error)
2534                return(0);
2535         return(value);
2536 }