.\" Copyright (C) 2014 Steven McDonald <steven@steven-mcdonald.id.au>
.\"
.\" This work is free. You can redistribute it and/or modify it under
.\" the terms of the Do What The Fuck You Want To Public License,
.\" Version 2, as published by Sam Hocevar. See the COPYING file or
.\" visit http://www.wtfpl.net/ for more details.
.\"
.Dd $Mdocdate$
.Dt DEVTREE 1
.Os
.Sh NAME
.Nm devtree
.Nd display a tree representing system hardware
.Sh SYNOPSIS
.Nm devtree
.Op Fl d
.Sh DESCRIPTION
The
.Nm
utility accepts output from
.Xr dmesg 8
on standard input, and produces a human-friendly ASCII tree
representing the currently attached system devices on standard output.
.Pp
If the
.Sy -d
option is provided, it will also include devices which have
been detached from the system, appending
.Em [DETACHED]
to any such entries. All other options are ignored.
.Sh EXAMPLES
Display a tree of all attached devices on the current system:
.Pp
.Dl $ dmesg | devtree
.Sh SEE ALSO
.Xr dmesg 8