xref: /freebsd/share/man/man4/man4.i386/vpd.4 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
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.\"
2528a8a9d1SRuslan Ermilov.Dd August 31, 2004
26340ff79fSMatthew N. Dodd.Dt VPD 4 i386
27340ff79fSMatthew N. Dodd.Os
28340ff79fSMatthew N. Dodd.Sh NAME
29340ff79fSMatthew N. Dodd.Nm vpd
30340ff79fSMatthew N. Dodd.Nd "Vital Product Data kernel interface"
31340ff79fSMatthew N. Dodd.Sh SYNOPSIS
32340ff79fSMatthew N. Dodd.Cd "device vpd"
33340ff79fSMatthew N. Dodd.Sh DESCRIPTION
34bc9a9cb4SRuslan Ermilov.Tn IBM ThinkPad
35bc9a9cb4SRuslan Ermilovnotebooks (and most
36bc9a9cb4SRuslan Ermilov.Tn IBM
37bc9a9cb4SRuslan Ermilovdesktop PCs) have a 48-byte
38340ff79fSMatthew N. DoddVital Product Data (VPD) structure located in the BIOS Shadow RAM.
39340ff79fSMatthew N. Dodd.Pp
40340ff79fSMatthew N. DoddThe VPD provides machine type and model information, the build ID
41340ff79fSMatthew N. Dodd(this is roughly the BIOS version) and serial number information.
42340ff79fSMatthew N. Dodd.Pp
43340ff79fSMatthew N. DoddThe
44bc9a9cb4SRuslan Ermilov.Nm
45340ff79fSMatthew N. Dodddriver scans the BIOS area and claims the memory used by the VPD
46bc9a9cb4SRuslan Ermilovstructure.
47bc9a9cb4SRuslan ErmilovIt provides the
48340ff79fSMatthew N. Dodd.Xr sysctl 3
49bc9a9cb4SRuslan Ermilovbranch
50bc9a9cb4SRuslan Ermilov.Va hw.vpd
51bc9a9cb4SRuslan Ermilovto allow this information to be accessed by the userland.
52340ff79fSMatthew N. DoddThe following variables are provided, one per VPD attachment (there should
53340ff79fSMatthew N. Doddonly be one):
54bc9a9cb4SRuslan Ermilov.Pp
55bc9a9cb4SRuslan Ermilov.Bl -tag -width ".Dv MACHINE_MODEL" -compact
56340ff79fSMatthew N. Dodd.It Dv MACHINE_TYPE
57bc9a9cb4SRuslan Ermilov.Pq Va machine.type
58340ff79fSMatthew N. DoddMachine type.
59340ff79fSMatthew N. Dodd.It Dv MACHINE_MODEL
60bc9a9cb4SRuslan Ermilov.Pq Va machine.model
61340ff79fSMatthew N. DoddMachine model.
62340ff79fSMatthew N. Dodd.It Dv BUILD_ID
63bc9a9cb4SRuslan Ermilov.Pq Va build.id
64340ff79fSMatthew N. DoddBIOS Build ID.
65340ff79fSMatthew N. Dodd.It Dv SERIAL_BOX
66bc9a9cb4SRuslan Ermilov.Pq Va serial.box
67340ff79fSMatthew N. DoddBox Serial Number.
68340ff79fSMatthew N. Dodd.It Dv SERIAL_PLANAR
69bc9a9cb4SRuslan Ermilov.Pq Va serial.planar
70340ff79fSMatthew N. DoddMotherboard Serial Number.
71340ff79fSMatthew N. Dodd.El
72340ff79fSMatthew N. Dodd.Sh SEE ALSO
73340ff79fSMatthew N. Dodd.Rs
74340ff79fSMatthew N. Dodd.%T "TP General - Using the BIOS Build ID to identify IBM ThinkPad systems"
75340ff79fSMatthew N. Dodd.%N "Reference #: MIGR-45120"
76340ff79fSMatthew N. Dodd.%D "November 22, 2002"
77aa4a335bSRuslan Ermilov.%U "http://www.ibm.com/support/docview.wss?uid=psg1MIGR-45120"
78340ff79fSMatthew N. Dodd.Re
79340ff79fSMatthew N. Dodd.Sh HISTORY
80340ff79fSMatthew N. DoddThe
81340ff79fSMatthew N. Dodd.Nm
82bc9a9cb4SRuslan Ermilovdriver first appeared in
83340ff79fSMatthew N. Dodd.Fx 5.1 .
84340ff79fSMatthew N. Dodd.Sh AUTHORS
85bc9a9cb4SRuslan ErmilovThe
86bc9a9cb4SRuslan Ermilov.Nm
87bc9a9cb4SRuslan Ermilovdriver and this manual page were written by
88*6c899950SBaptiste Daroussin.An Matthew N. Dodd Aq Mt mdodd@FreeBSD.org .
89