xref: /freebsd/share/man/man4/man4.i386/vpd.4 (revision bc9a9cb4d043f39859a33250ea91c73b5f311319)
1340ff79fSMatthew N. Dodd.\" Copyright (c) 2003 Matthew N. Dodd <winter@jurai.net>
2340ff79fSMatthew N. Dodd.\" All rights reserved.
3340ff79fSMatthew N. Dodd.\"
4340ff79fSMatthew N. Dodd.\" Redistribution and use in source and binary forms, with or without
5340ff79fSMatthew N. Dodd.\" modification, are permitted provided that the following conditions
6340ff79fSMatthew N. Dodd.\" are met:
7340ff79fSMatthew N. Dodd.\" 1. Redistributions of source code must retain the above copyright
8340ff79fSMatthew N. Dodd.\"    notice, this list of conditions and the following disclaimer.
9340ff79fSMatthew N. Dodd.\" 2. Redistributions in binary form must reproduce the above copyright
10340ff79fSMatthew N. Dodd.\"    notice, this list of conditions and the following disclaimer in the
11340ff79fSMatthew N. Dodd.\"    documentation and/or other materials provided with the distribution.
12340ff79fSMatthew N. Dodd.\"
13340ff79fSMatthew N. Dodd.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14340ff79fSMatthew N. Dodd.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15340ff79fSMatthew N. Dodd.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16340ff79fSMatthew N. Dodd.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17340ff79fSMatthew N. Dodd.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18340ff79fSMatthew N. Dodd.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19340ff79fSMatthew N. Dodd.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20340ff79fSMatthew N. Dodd.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21340ff79fSMatthew N. Dodd.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22340ff79fSMatthew N. Dodd.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23340ff79fSMatthew N. Dodd.\" SUCH DAMAGE.
24340ff79fSMatthew N. Dodd.\"
25340ff79fSMatthew N. Dodd.\" $FreeBSD$
26340ff79fSMatthew N. Dodd.\"
27340ff79fSMatthew N. Dodd.Dd April 4, 2003
28340ff79fSMatthew N. Dodd.Dt VPD 4 i386
29340ff79fSMatthew N. Dodd.Os
30340ff79fSMatthew N. Dodd.Sh NAME
31340ff79fSMatthew N. Dodd.Nm vpd
32340ff79fSMatthew N. Dodd.Nd "Vital Product Data kernel interface"
33340ff79fSMatthew N. Dodd.Sh SYNOPSIS
34340ff79fSMatthew N. Dodd.Cd "device vpd"
35340ff79fSMatthew N. Dodd.Sh DESCRIPTION
36bc9a9cb4SRuslan Ermilov.Tn IBM ThinkPad
37bc9a9cb4SRuslan Ermilovnotebooks (and most
38bc9a9cb4SRuslan Ermilov.Tn IBM
39bc9a9cb4SRuslan Ermilovdesktop PCs) have a 48-byte
40340ff79fSMatthew N. DoddVital Product Data (VPD) structure located in the BIOS Shadow RAM.
41340ff79fSMatthew N. Dodd.Pp
42340ff79fSMatthew N. DoddThe VPD provides machine type and model information, the build ID
43340ff79fSMatthew N. Dodd(this is roughly the BIOS version) and serial number information.
44340ff79fSMatthew N. Dodd.Pp
45340ff79fSMatthew N. DoddThe
46bc9a9cb4SRuslan Ermilov.Nm
47340ff79fSMatthew N. Dodddriver scans the BIOS area and claims the memory used by the VPD
48bc9a9cb4SRuslan Ermilovstructure.
49bc9a9cb4SRuslan ErmilovIt provides the
50340ff79fSMatthew N. Dodd.Xr sysctl 3
51bc9a9cb4SRuslan Ermilovbranch
52bc9a9cb4SRuslan Ermilov.Va hw.vpd
53bc9a9cb4SRuslan Ermilovto allow this information to be accessed by the userland.
54340ff79fSMatthew N. DoddThe following variables are provided, one per VPD attachment (there should
55340ff79fSMatthew N. Doddonly be one):
56bc9a9cb4SRuslan Ermilov.Pp
57bc9a9cb4SRuslan Ermilov.Bl -tag -width ".Dv MACHINE_MODEL" -compact
58340ff79fSMatthew N. Dodd.It Dv MACHINE_TYPE
59bc9a9cb4SRuslan Ermilov.Pq Va machine.type
60340ff79fSMatthew N. DoddMachine type.
61340ff79fSMatthew N. Dodd.It Dv MACHINE_MODEL
62bc9a9cb4SRuslan Ermilov.Pq Va machine.model
63340ff79fSMatthew N. DoddMachine model.
64340ff79fSMatthew N. Dodd.It Dv BUILD_ID
65bc9a9cb4SRuslan Ermilov.Pq Va build.id
66340ff79fSMatthew N. DoddBIOS Build ID.
67340ff79fSMatthew N. Dodd.It Dv SERIAL_BOX
68bc9a9cb4SRuslan Ermilov.Pq Va serial.box
69340ff79fSMatthew N. DoddBox Serial Number.
70340ff79fSMatthew N. Dodd.It Dv SERIAL_PLANAR
71bc9a9cb4SRuslan Ermilov.Pq Va serial.planar
72340ff79fSMatthew N. DoddMotherboard Serial Number.
73340ff79fSMatthew N. Dodd.El
74340ff79fSMatthew N. Dodd.Sh SEE ALSO
75340ff79fSMatthew N. Dodd.Rs
76340ff79fSMatthew N. Dodd.%T "TP General - Using the BIOS Build ID to identify IBM ThinkPad systems"
77340ff79fSMatthew N. Dodd.%N "Reference #: MIGR-45120"
78340ff79fSMatthew N. Dodd.%D "November 22, 2002"
79340ff79fSMatthew N. Dodd.%O "http://www.ibm.com/support/docview.wss?uid=psg1MIGR-45120"
80340ff79fSMatthew N. Dodd.Re
81340ff79fSMatthew N. Dodd.Sh HISTORY
82340ff79fSMatthew N. DoddThe
83340ff79fSMatthew N. Dodd.Nm
84bc9a9cb4SRuslan Ermilovdriver first appeared in
85340ff79fSMatthew N. Dodd.Fx 5.1 .
86340ff79fSMatthew N. Dodd.Sh AUTHORS
87bc9a9cb4SRuslan ErmilovThe
88bc9a9cb4SRuslan Ermilov.Nm
89bc9a9cb4SRuslan Ermilovdriver and this manual page were written by
90340ff79fSMatthew N. Dodd.An Matthew N. Dodd Aq mdodd@FreeBSD.org .
91340ff79fSMatthew N. Dodd.Sh BUGS
92bc9a9cb4SRuslan ErmilovThe checksum code is not quite correct so we are not able to detect
93340ff79fSMatthew N. Dodda corrupt VPD structure.
94