= HDT - Hardware Detection Tool =
[[TOC]]

== What is HDT? ==
HDT (stands for ''Hardware Detection Tool'') is a Syslinux com32 module that displays low-level information for any x86 compatible system.
It provides both a command line interface and a semi-graphical menu mode for browsing.

== Documentation ==

=== [wiki:howtostarthdt How can I start HDT ?] ===
[wiki:howtostarthdt How can I start HDT ?]

=== Usage per subsystem ===
HDT can inspect multiple subsystems:
    * [wiki:CPU CPU]
    * [wiki:PCI PCI devices]
    * [wiki:Memory Memory]
      * [wiki:Memory#e820memorymap e820 memory map]
      * [wiki:Memory#e801memorymap e801 memory map]
      * [wiki:Memory#a8800hmemorysize 8800h memory size]
    * [wiki:DMI DMI]
      * [wiki:DMI#Memorybanks Memory modules]
      * [wiki:DMI#BIOS BIOS]
      * [wiki:DMI#Motherboard Motherboard]
      * IPMI base board (XXX Anyone with screenshots?)
      * [wiki:DMI#Chassis Chassis]
      * Batteries (XXX Anyone with screenshots?)
      * [wiki:DMI#CPU CPU]
      * [wiki:DMI#System System]
      * [wiki:DMI#Security Security]
      * System reset (XXX Anyone with screenshots?)
    * [wiki:Disks Disks]
      * [wiki:Disks#Linuxswsuspdetection Linux swsusp detection]
      * [wiki:Disks#Bootloaderdetection Bootloader detection]
      * [wiki:Disks#MBRdetection MBR detection]
    * [wiki:Syslinux Syslinux]
    * Linux Kernel modules needed by this host
    * [wiki:PXE PXE environment]
    * [wiki:VESA VESA]

=== Dumping hardware Information ===

HDT is able to dump hardware information, please consult the [wiki:Dump Dump] page

=== Boot parameters ===
HDT feature some boot parameters to control its behavior. 

    * [wiki:PCI#PCIclassnameresolution Defining the pci.ids path]
    * [wiki:PCI#PCIlinuxkernelmodulenameresolution Defining the modules.pcimap path]
    * [wiki:Memory#Overloadingmemtest Defining the memtest entry]
    * [wiki:BootParameters#nomenu Disabling the menu mode]
    * [wiki:BootParameters#Automaticcommands Executing automatic commands]
    * [wiki:BootParameters#dump Dumping parameters]


== Downloads ==

The latest version of HDT can be found in the Syslinux tarball under {{{com32/hdt/hdt.c32}}}. Source code and official builds can be downloaded in {{{.tar.gz}}}, {{{.tar.bz2}}}, and {{{.zip}}} formats from [http://www.kernel.org/pub/linux/utils/boot/syslinux/ kernel.org].

Builds of the HDT module can also be found below.

=== Testing ===

 * Nothing for today

=== Stable ===

==== Current release ====
 * [wiki:hdt-0.5.0 0.5.2] | [/raw-attachment/wiki/hdt-0.5.0/hdt_0_5_2.c32 com32 module] | [/raw-attachment/wiki/hdt-0.5.0/hdt-0.5.2.img 1.44MB floppy image] | [/raw-attachment/wiki/hdt-0.5.0/hdt-0.5.2.iso Bootable ISO image] | [/raw-attachment/wiki/hdt-0.5.0/hdt-0.5.2.img.gz 1.44MB gzipped floppy image] | [/raw-attachment/wiki/hdt-0.5.0/hdt-0.5.2.checksums Checksums] |

==== Previous releases ====
 * [wiki:hdt-0.5.0]
 * [wiki:hdt-0.4.0]
 * [wiki:hdt-0.3.6]
 * [wiki:hdt-0.3.5] for Syslinux 3.83
 * [wiki:hdt-0.3.4] for Syslinux 3.83
 * [wiki:hdt-0.3.3] for Syslinux 3.75
 * [wiki:hdt-0.3.2] for Syslinux 3.75
 * [wiki:hdt-0.3.1] for Syslinux 3.75

==== Previous Syslinux releases ====
 * Syslinux 3.83 is featuring HDT 0.3.1
 * Syslinux 3.75 is featuring HDT 0.2.7 with a fix to prevent hard lock during pci detection 
 * Syslinux 3.74 is featuring HDT 0.2.7

=== Unstable ===

These are NOT suited for production.

 * None

=== Source ===

The official, latest and stable code is available in the Syslinux tree [http://git.zytor.com/?p=syslinux/syslinux.git;a=summary syslinux.git], under {{{/com32/hdt}}}.

Development is active in the following trees:
 * [http://git.zytor.com/?p=users/erwan/hdt.git;a=summary Erwan's tree]
 * [http://git.zytor.com/?p=users/pam/hdt-pierre.git;a=summary Pierre's tree]

== Screenshots ==

[[Image(hdt-0.4.0.png, align=center)]][[BR]]Menu displaying system summary

[[Image(disks-detection.png, align=center)]][[BR]]Command line interface inspecting disks

[[Image(hdt-serial.png, align=center)]][[BR]]Summary mode from menu while using a real serial interface

== Projects known to use HDT ==

 * [http://boot.kernel.org/ Boot Kernel.org]
 * [http://www.mandriva.com/fr Mandriva Linux] since 2009.1
 * [http://www.ultimatebootcd.com/ Ultimate boot CD] since version 5.0
 * [http://partedmagic.com/programs.html Parted Magic] since 0.4.0
 * [http://rip.7bf.de/current/ Rescue Is Possible] since 8.0
 * [http://www.netboot.me/ Netboot me]
 * [http://grml.org grml]
 * [http://sourceforge.net/projects/g4l/ g4l]
 * [http://www.slitaz.org/ slitaz]
 * [http://www.finnix.org/ Finnix] since release 101
 * [http://www.archlinux.org/ ArchLinux]
 * [http://wiki.freegeektwincities.org/doku.php?id=intake:pxeserver#printing_hardware_specs Free Geek Twin Cities] ([http://www.youtube.com/watch?v=BS8E0jcIHKA&list=UUZ2m2AEmCaXiVJECvhYdHYA&index=1&feature=plcp A video showing HDT in action])
 * Any other ? Please tell us.

== Public Presentations ==

 * [https://kernel-recipes.org/?page_id=245 Kernel Recipes 2012 ] : Download the [/raw-attachment/wiki/WikiStart/HDT-KR2012.pdf presentation]

== IRC Channel ==

Developers are usually around on the the {{{#syslinux}}} and {{{#hdt}}} channels of the Freenode network ({{{irc.freenode.net}}}).
Feel free to join us for open discussions.

== Mailing List ==

The official mailing-list is {{{hdt@zytor.com}}}.
 
 * You can subscribe to the mailing list [http://www.zytor.com/mailman/listinfo/hdt/ here]
 * Archives can be browsed online [http://www.zytor.com/pipermail/hdt/ here]

Please submit HDT patches to this mailing-list. {{{syslinux@zytor.com}}} should be {{{CC:}}} for integration patches with Syslinux.

== Resources ==

 * [http://syslinux.zytor.com/wiki/index.php/The_Syslinux_Project The Syslinux Project]

== Team ==
 * [http://konilope.linuxeries.org/dotclear Erwan Velu]             (Project Leader)
 * [http://pub.mouraf.org/blog Pierre-Alexandre Meyer] (Core developer)
 * Gert Hulselmans        (Testing)
 * Alexander Andino       (Design & Art)