6bb4d1c8e108617ead1ec88207b5970d43d0d2fb
[www.git] / projects / openbsd_devtree.shtml
1 <!--#include virtual="/doctype.txt"-->
2 <html>
3
4 <!--#include virtual="/head.shtml"-->
5
6 <body>
7
8 <!--#include virtual="/header.shtml"-->
9
10 <!--#include virtual="/navigation.shtml"-->
11
12 <div id="content">
13
14 <h1>Printing device trees on OpenBSD</h1>
15
16 <p>
17 I've written a small Perl utility for OpenBSD that takes <tt>dmesg</tt>
18 output on standard input and produces a human-friendly tree of devices
19 on standard output. Since it accepts any (OpenBSD) <tt>dmesg</tt>
20 output, you can use it to produce a tree of hardware on someone else's
21 system as well as examine your own.
22 </p>
23
24 <p>As an example, this is what it looks like on my Lemote Yeeloong:</p>
25
26 <code>
27 $&nbsp;dmesg&nbsp;|&nbsp;devtree&nbsp;<br>
28 root<br>
29 &nbsp;&nbsp;|-mainbus0&nbsp;(Lemote&nbsp;Yeeloong)<br>
30 &nbsp;&nbsp;|&nbsp;&nbsp;|-apm0<br>
31 &nbsp;&nbsp;|&nbsp;&nbsp;|-bonito0&nbsp;(memory&nbsp;and&nbsp;PCI-X&nbsp;controller,&nbsp;rev&nbsp;1)<br>
32 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;|-pci0&nbsp;(bus&nbsp;0)<br>
33 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-auglx0&nbsp;(AMD&nbsp;CS5536&nbsp;Audio)<br>
34 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;|-audio0<br>
35 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-ehci0&nbsp;(NEC&nbsp;USB)<br>
36 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;|-usb0&nbsp;(USB&nbsp;revision&nbsp;2.0)<br>
37 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-uhub0&nbsp;(NEC&nbsp;EHCI&nbsp;root&nbsp;hub)<br>
38 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-ehci1&nbsp;(AMD&nbsp;CS5536&nbsp;USB)<br>
39 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;|-usb1&nbsp;(USB&nbsp;revision&nbsp;2.0)<br>
40 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-uhub1&nbsp;(AMD&nbsp;EHCI&nbsp;root&nbsp;hub)<br>
41 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-umass0&nbsp;(Generic&nbsp;USB2.0-CRW)<br>
42 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;|-scsibus0&nbsp;(2&nbsp;targets,&nbsp;initiator&nbsp;0)<br>
43 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-sd0&nbsp;(Generic-,&nbsp;Multi-Card,&nbsp;1.00)<br>
44 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-urtw0&nbsp;(Realtek&nbsp;RTL8187B)<br>
45 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-glxpcib0&nbsp;(AMD&nbsp;CS5536&nbsp;ISA)<br>
46 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;|-glxclk0&nbsp;(clock,&nbsp;prof)<br>
47 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;|-gpio1&nbsp;(32&nbsp;pins)<br>
48 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;|-iic&nbsp;(not&nbsp;configured)<br>
49 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;|-isa0<br>
50 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-mcclock0&nbsp;(port&nbsp;0x70/2:&nbsp;mc146818&nbsp;or&nbsp;compatible)<br>
51 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-pckbc0&nbsp;(port&nbsp;0x60/5)<br>
52 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;|-pckbd0&nbsp;(kbd&nbsp;slot)<br>
53 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;|-wskbd0&nbsp;(console&nbsp;keyboard,&nbsp;using&nbsp;wsdisplay0)<br>
54 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;|-pms0&nbsp;(aux&nbsp;slot)<br>
55 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-wsmouse0&nbsp;(mux&nbsp;0)<br>
56 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-ykbec0&nbsp;(port&nbsp;0x381/3)<br>
57 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-ohci0&nbsp;(NEC&nbsp;USB)<br>
58 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;|-usb2&nbsp;(USB&nbsp;revision&nbsp;1.0)<br>
59 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-uhub2&nbsp;(NEC&nbsp;OHCI&nbsp;root&nbsp;hub)<br>
60 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-ohci1&nbsp;(AMD&nbsp;CS5536&nbsp;USB)<br>
61 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;|-usb3&nbsp;(USB&nbsp;revision&nbsp;1.0)<br>
62 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-uhub3&nbsp;(AMD&nbsp;OHCI&nbsp;root&nbsp;hub)<br>
63 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-pciide0&nbsp;(AMD&nbsp;CS5536&nbsp;IDE)<br>
64 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;|-wd0&nbsp;(Corsair&nbsp;Force&nbsp;3&nbsp;SSD)<br>
65 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-rl0&nbsp;(Realtek&nbsp;8139)<br>
66 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;|-rlphy0&nbsp;(phy&nbsp;0:&nbsp;RTL&nbsp;internal&nbsp;PHY)<br>
67 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-smfb0&nbsp;(Silicon&nbsp;Motion&nbsp;LynxEM+)<br>
68 &nbsp;&nbsp;|&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-wsdisplay0&nbsp;(std,&nbsp;vt100&nbsp;emulation)<br>
69 &nbsp;&nbsp;|&nbsp;&nbsp;|-cpu0&nbsp;(STC&nbsp;Loongson2F&nbsp;CPU&nbsp;796&nbsp;MHz,&nbsp;STC&nbsp;Loongson2F&nbsp;FPU)<br>
70 &nbsp;&nbsp;|-softraid0<br>
71 &nbsp;&nbsp;|&nbsp;&nbsp;|-scsibus2&nbsp;(256&nbsp;targets)<br>
72 &nbsp;&nbsp;|-vscsi0<br>
73 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-scsibus1&nbsp;(256&nbsp;targets)<br>
74 </code>
75
76 <p>Source and a man page are available under the
77 <a href="http://git.sjm.so/?p=openbsd-goodies.git;a=tree;f=devtree;hb=HEAD">WTFPL</a>
78 from
79 <a href="git://git.sjm.so/openbsd-goodies.git">git://git.sjm.so/openbsd-goodies.git</a>
80 (or view it on <a href="http://git.sjm.so/?p=openbsd-goodies.git;a=tree;f=devtree;hb=HEAD">GitWeb</a>)
81 .
82 </p>
83
84 </div>
85
86 <!--#include virtual="/footer.shtml"-->
87
88 </body>
89
90 </html>