File: lsmcode.8

package info (click to toggle)
lsvpd 1.7.14-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, sid
  • size: 556 kB
  • sloc: cpp: 8,605; makefile: 82; sh: 33
file content (95 lines) | stat: -rw-r--r-- 3,248 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
.\"Generated by db2man.xsl. Don't modify this, modify the source.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "LSMCODE" 8 "" "" ""
.SH NAME
lsmcode \- list microcode and firmware levels
.SH "SYNOPSIS"
.ad l
.hy 0
.HP 8
\fBlsmcode\fR [\fB\-A\fR | \fB\-\-All\fR | \fB\-d<name>\fR | \fB\-\-device=<name>\fR] [\fB\-\-tabular\fR | \fB\-\-no\-menus\fR] [\fB\-p<database\-file>\fR | \fB\-\-path=<database\-file>\fR | \fB\-z<database\-archive>\fR | \fB\-\-zip=<database\-archive>\fR] [\fB\-h\fR | \fB\-\-help\fR]
.ad
.hy

.SH "DESCRIPTION"

.PP
This program is part of the lsvpd package for Linux\&. This package is a (partial) reimplementation of AIX's lsvpd and related commands\&.

.PP
 \fBlsmcode\fR lists hardware microcode and firmware levels\&. The output can be presented in a `human readable' format or a more structured format that is easily parsable by other software\&. The Linux version does not support the interactive menus that are found in the AIX version\&. \fBlsmcode\fR retrieves information from \fBlsvpd\fR's hardware inventory database\&. Therefore, the \fIvpdupdate(8)\fR command must have been executed prior to running \fBlsmcode\fR\&.

.PP
Some IBM POWER systems feature \fIdynamic VPD\fR\&. \fBlsmcode\fR will only list version information corresponding to dynamic VPD when invoked by the \fIroot\fR user \- when invoked by another user this version information will be omitted but other version information will still be listed\&.

.SH "OPTIONS"

.TP
\-A|\-\-All
Display information for all supported hardware\&.

.TP
\-d<name>|\-\-device=<name>
Only show configuration information for the component with the given \fIname\fR\&.


.TP
\-p<database\-file>|\-\-path=<database\-file>
Use <database\-file> as the hardware inventory database, rather than the default file\&. Note the supplied filename must include a full path\&. (\fI/var/lib/lsvpd/vpd.db\fR)\&.

This option is useful for producing output for previous hardware inventory databases that have been replaced by the system\&.

.TP
\-z<database\-archive>\-\-zip=<database\-archive>
Use <database\-archive> as the hardware inventory database, rather than the default directory (\fI/var/lib/lsvpd/\fR)\&. The archive has been compressed using \fIgzip(1)\fR\&.

This option is useful for producing output for old hardware inventory databases that have been archived by the system\&.

.TP
\-h|\-\-help
Display a help screen and quit\&.

.SH "FILES"

.TP
\fI/var/lib/lsvpd/vpd.db\fR
Database file used by \fBlsmcode\fR\&.

.SH "BUGS"

.PP
 \fBlsmcode\fR will not reflect changes in firmware/microcode versions for certain hardware without a reboot\&. This will (hopefully) be supported in a later version on Linux 2\&.6 systems with dynamic \fI/proc/device\-tree\fR\&.

.PP
Version information for some adapters may not be available because retrieval mechanisms have not yet been implemented\&.

.SH "SEE ALSO"

.PP
lsvpd(8), lscfg(8), lsvio(8), vpdupdate(8)

.SH "AUTHORS"

.PP
Eric Munson <ebmunson@us\&.ibm\&.com>\&. Brad Peters <bpeters@us\&.ibm\&.com>\&.

.PP
Copyright (c) 2003 - 2013 IBM\&.