Add some info on devtree
[www.git] / projects / openbsd_devtree.shtml
diff --git a/projects/openbsd_devtree.shtml b/projects/openbsd_devtree.shtml
new file mode 100644 (file)
index 0000000..1f6aa8b
--- /dev/null
@@ -0,0 +1,90 @@
+<!--#include virtual="/doctype.txt"-->
+<html>
+
+<!--#include virtual="/head.shtml"-->
+
+<body>
+
+<!--#include virtual="/header.shtml"-->
+
+<!--#include virtual="/navigation.shtml"-->
+
+<div id="content">
+
+<h1>Printing device trees on OpenBSD</h1>
+
+<p>
+I've written a small Perl utility that takes <tt>dmesg</tt> output on
+standard input and produces a human-friendly tree of devices on
+standard output. Since it accepts any <tt>dmesg</tt> output, you can
+use it to produce a tree of hardware on someone else's system as well
+as examine your own.
+</p>
+
+<p>As an example, this is what it looks like on my Lemote Yeeloong:</p>
+
+<code>
+$ dmesg | devtree 
+root
+  |-mainbus0 (Lemote Yeeloong)
+  |  |-apm0
+  |  |-bonito0 (memory and PCI-X controller, rev 1)
+  |  |  |-pci0 (bus 0)
+  |  |     |-auglx0 (AMD CS5536 Audio)
+  |  |     |  |-audio0
+  |  |     |-ehci0 (NEC USB)
+  |  |     |  |-usb0 (USB revision 2.0)
+  |  |     |     |-uhub0 (NEC EHCI root hub)
+  |  |     |-ehci1 (AMD CS5536 USB)
+  |  |     |  |-usb1 (USB revision 2.0)
+  |  |     |     |-uhub1 (AMD EHCI root hub)
+  |  |     |        |-umass0 (Generic USB2.0-CRW)
+  |  |     |        |  |-scsibus0 (2 targets, initiator 0)
+  |  |     |        |     |-sd0 (Generic-, Multi-Card, 1.00)
+  |  |     |        |-urtw0 (Realtek RTL8187B)
+  |  |     |-glxpcib0 (AMD CS5536 ISA)
+  |  |     |  |-glxclk0 (clock, prof)
+  |  |     |  |-gpio1 (32 pins)
+  |  |     |  |-iic (not configured)
+  |  |     |  |-isa0
+  |  |     |     |-mcclock0 (port 0x70/2: mc146818 or compatible)
+  |  |     |     |-pckbc0 (port 0x60/5)
+  |  |     |     |  |-pckbd0 (kbd slot)
+  |  |     |     |  |  |-wskbd0 (console keyboard, using wsdisplay0)
+  |  |     |     |  |-pms0 (aux slot)
+  |  |     |     |     |-wsmouse0 (mux 0)
+  |  |     |     |-ykbec0 (port 0x381/3)
+  |  |     |-ohci0 (NEC USB)
+  |  |     |  |-usb2 (USB revision 1.0)
+  |  |     |     |-uhub2 (NEC OHCI root hub)
+  |  |     |-ohci1 (AMD CS5536 USB)
+  |  |     |  |-usb3 (USB revision 1.0)
+  |  |     |     |-uhub3 (AMD OHCI root hub)
+  |  |     |-pciide0 (AMD CS5536 IDE)
+  |  |     |  |-wd0 (Corsair Force 3 SSD)
+  |  |     |-rl0 (Realtek 8139)
+  |  |     |  |-rlphy0 (phy 0: RTL internal PHY)
+  |  |     |-smfb0 (Silicon Motion LynxEM+)
+  |  |        |-wsdisplay0 (std, vt100 emulation)
+  |  |-cpu0 (STC Loongson2F CPU 796 MHz, STC Loongson2F FPU)
+  |-softraid0
+  |  |-scsibus2 (256 targets)
+  |-vscsi0
+     |-scsibus1 (256 targets)
+</code>
+
+<p>Source and a man page are available under the
+<a href="http://git.sjm.so/?p=openbsd-goodies.git;a=tree;f=devtree;hb=HEAD">WTFPL</a>
+from
+<a href="git://git.sjm.so/openbsd-goodies.git">git://git.sjm.so/openbsd-goodies.git</a>
+(or view it on <a href="http://git.sjm.so/?p=openbsd-goodies.git;a=tree;f=devtree;hb=HEAD">GitWeb</a>)
+.
+</p>
+
+</div>
+
+<!--#include virtual="/footer.shtml"-->
+
+</body>
+
+</html>