Blame README

Packit Service e18529
** INTRODUCTION **
Packit Service e18529
Packit Service e18529
Dmidecode reports information about your system's hardware as described in
Packit Service e18529
your system BIOS according to the SMBIOS/DMI standard. This information
Packit Service e18529
typically includes system manufacturer, model name, serial number, BIOS
Packit Service e18529
version, asset tag as well as a lot of other details of varying level of
Packit Service e18529
interest and reliability depending on the manufacturer. This will often
Packit Service e18529
include usage status for the CPU sockets, expansion slots (e.g. AGP, PCI,
Packit Service e18529
ISA) and memory module slots, and the list of I/O ports (e.g. serial,
Packit Service e18529
parallel, USB).
Packit Service e18529
Packit Service e18529
DMI data can be used to enable or disable specific portions of kernel code
Packit Service e18529
depending on the specific hardware. Thus, one use of dmidecode is for kernel
Packit Service e18529
developers to detect system "signatures" and add them to the kernel source
Packit Service e18529
code when needed.
Packit Service e18529
Packit Service e18529
Beware that DMI data have proven to be too unreliable to be blindly trusted.
Packit Service e18529
Dmidecode does not scan your hardware, it only reports what the BIOS told it
Packit Service e18529
to.
Packit Service e18529
Packit Service e18529
Packit Service e18529
** INSTALLATION **
Packit Service e18529
Packit Service e18529
The home web page for dmidecode is hosted on Savannah:
Packit Service e18529
  http://www.nongnu.org/dmidecode/
Packit Service e18529
You will find the latest version (including CVS) there, as well as fresh news
Packit Service e18529
and other interesting material, such as a list of related projects and
Packit Service e18529
articles.
Packit Service e18529
Packit Service e18529
This program was first written for Linux, and has since been reported to work
Packit Service e18529
on FreeBSD, NetBSD, OpenBSD, BeOS and Solaris as well.
Packit Service e18529
Packit Service e18529
There's no configure script, so simply run "make" to build dmidecode, and
Packit Service e18529
"make install" to install it. You also can use "make uninstall" to remove
Packit Service e18529
all the files you installed. By default, files are installed in /usr/local
Packit Service e18529
but you can change this behavior by editing the Makefile file and setting
Packit Service e18529
prefix to wherever you want. You may change the C compiler and the
Packit Service e18529
compilation flags as well.
Packit Service e18529
Packit Service e18529
Optionally, you can run "make strip" prior to "make install" if you want
Packit Service e18529
smaller binaries. However, be aware that this will prevent any further
Packit Service e18529
attempt to debug the programs.
Packit Service e18529
Packit Service e18529
Two parameters can be set in the Makefile file to make dmidecode work on
Packit Service e18529
non-i386 systems. They should be used if your system uses the big endian
Packit Service e18529
byte ordering (Motorola) or doesn't support unaligned memory accesses,
Packit Service e18529
respectively. For example, compiling for a SPARC processor would require
Packit Service e18529
both (but I am not aware of SPARC-based systems implementing SMBIOS).
Packit Service e18529
Compiling for an IA64 processor requires the memory alignment workaround,
Packit Service e18529
and it is enabled automatically.
Packit Service e18529
Packit Service e18529
Packit Service e18529
** DOCUMENTATION **
Packit Service e18529
Packit Service e18529
Each tool has a manual page, found in the "man" subdirectory. Manual pages
Packit Service e18529
are installed by "make install". See these manual pages for command line
Packit Service e18529
interface details and tool specific information.
Packit Service e18529
Packit Service e18529
For an history of the changes made to dmidecode, see the NEWS file.
Packit Service e18529
Packit Service e18529
If you need help, your best chances are to visit the web page (see the
Packit Service e18529
INSTALLATION section above) or to get in touch with the developers directly.
Packit Service e18529
Have a look at the AUTHORS file and contact one of the maintainers.
Packit Service e18529
Packit Service e18529
If you want to help with the development of dmidecode, please consider
Packit Service e18529
joining the dmidecode-devel discussion list:
Packit Service e18529
  http://lists.nongnu.org/mailman/listinfo/dmidecode-devel
Packit Service e18529
Packit Service e18529
Packit Service e18529
** COMMON PROBLEMS **
Packit Service e18529
Packit Service e18529
IA-64
Packit Service e18529
Packit Service e18529
Non-Linux systems are not yet supported.
Packit Service e18529
Packit Service e18529
MMAP
Packit Service e18529
Packit Service e18529
Note that mmap() is now used by default wherever possible, since this seems
Packit Service e18529
to solve a number of problems. This default behavior can be changed in
Packit Service e18529
config.h. Just to make sure this is clear, mmap() is not used for performance
Packit Service e18529
reasons but to increase the number of systems on which dmidecode can be
Packit Service e18529
successfully run.
Packit Service e18529
Packit Service e18529
CYGWIN
Packit Service e18529
Packit Service e18529
Dmidecode used to work under Cygwin. However the /dev/mem interface was
Packit Service e18529
removed at some point in time so it no longer works.
Packit Service e18529
Packit Service e18529
Packit Service e18529
** MISCELLANEOUS TOOLS **
Packit Service e18529
Packit Service e18529
Three other tools come along with dmidecode: biosdecode, ownership and
Packit Service e18529
vpddecode. These tools are only useful on systems with a BIOS, so they
Packit Service e18529
are not built on IA-64 by default.
Packit Service e18529
Packit Service e18529
BIOSDECODE
Packit Service e18529
Packit Service e18529
This one prints all BIOS related information it can find in /dev/mem.
Packit Service e18529
It used to be part of dmidecode itself, but as dmidecode was growing,
Packit Service e18529
we felt that the non-DMI part had to be moved to a separate tool.
Packit Service e18529
Packit Service e18529
OWNERSHIP
Packit Service e18529
Packit Service e18529
This tool was written on a request by Luc Van de Velde for use with Novell
Packit Service e18529
tools in his company. It retrieves the "ownership tag" that can be set on
Packit Service e18529
most Compaq computers. Since it uses the same mechanisms dmidecode and
Packit Service e18529
biosdecode use, and could be of some use for other people as well, we
Packit Service e18529
decided to make it part of the project.
Packit Service e18529
Packit Service e18529
VPDDECODE
Packit Service e18529
Packit Service e18529
This tool prints the contents of the "vital product data" structure as
Packit Service e18529
found in most IBM and Lenovo computers. It used to have a lookup table
Packit Service e18529
for the machine name, but it was unreliable and hard to maintain so it
Packit Service e18529
was ultimately dropped. It has a command line interface.