1IPMCTL-SHOW-FIRMWARE(1)             ipmctl             IPMCTL-SHOW-FIRMWARE(1)
2
3
4

NAME

6       ipmctl-show-firmware - Shows detailed information about the firmware
7

SYNOPSIS

9           ipmctl show [OPTIONS] -firmware [TARGETS]
10

DESCRIPTION

12       Shows detailed information about the firmware on one or more PMem
13       modules.
14

OPTIONS

16       -a, -all
17           Shows all attributes.
18
19           Note
20           The all and display options are exclusive and may not be used
21           together.
22
23       -d (attributes), -display (attributes)
24           Filters the returned attributes by explicitly specifying a comma
25           separated list of any of the attributes defined in the Return Data
26           section.
27
28           Note
29           The all and display options are exclusive and may not be used
30           together.
31
32       -h, -help
33           Displays help for the command.
34
35       -ddrt
36           Used to specify DDRT as the desired transport protocol for the
37           current invocation of ipmctl.
38
39       -smbus
40           Used to specify SMBUS as the desired transport protocol for the
41           current invocation of ipmctl.
42
43           Note
44           The -ddrt and -smbus options are mutually exclusive and may not be
45           used together.
46
47       -o (text|nvmxml), -output (text|nvmxml)
48           Changes the output format. One of: "text" (default) or "nvmxml".
49

TARGETS

51       -dimm [DimmIDs]
52           Restricts output to the firmware information for specific PMem
53           modules by supplying one or more comma separated PMem module
54           identifiers. The default is to display the firmware information for
55           all manageable PMem modules.
56

EXAMPLES

58       Shows the firmware information for all PMem modules in the server.
59
60           ipmctl show -dimm -firmware
61

LIMITATIONS

63       In order to successfully execute this command:
64
65       •   The caller must have the appropriate privileges.
66
67       •   The specified PMem modules must be manageable by the host software.
68

RETURN DATA

70       The default behavior is to display a table with the default attributes
71       listed below; the options can be used to expand or restrict the output.
72
73       DimmID
74           (Default) The PMem module identifier
75
76       ActiveFWVersion
77           (Default) The BCD-formatted revision of the active firmware in the
78           format PN.RN.SV.bbbb where:
79
80           •   PN = 2-digit product number
81
82           •   RN = 2-digit revision number
83
84           •   SV = 2-digit security version number
85
86           •   bbbb = 4-digit build version
87
88       StagedFWVersion
89           (Default) The BCD-formatted revision of the firmware staged for
90           execution on the next power cycle in the format PN.RN.SV.bbbb
91           where:
92
93           •   PN = 2-digit product number
94
95           •   RN = 2-digit revision number
96
97           •   SV = 2-digit security version number
98
99           •   bbbb = 4-digit build version
100
101       StagedFWActivatable
102           The state of whether the staged firmware is activatable or not,
103           where:
104
105           •   0 = Not activatable, reboot is required
106
107           •   1 = Activatable
108
109       FWUpdateStatus
110           The status of the last firmware update operation. One of:
111
112           •   Unknown
113
114           •   Staged successfully
115
116           •   Update loaded successfully
117
118           •   Update failed to load, fell back to previous firmware
119
120       FWImageMaxSize
121           The maximum size of a firmware image.
122
123       QuiesceRequired
124           The state of whether activating the firmware requires the host to
125           quiesce traffic prior to calling the command.
126
127           •   0 = No traffic quiesce required prior to activate
128
129           •   1 = Traffic quiesce required prior to activate
130
131       ActivationTime
132           The estimated activation time, in ms, required for activating the
133           firmware.
134
135
136
137ipmctl                            2023-07-20           IPMCTL-SHOW-FIRMWARE(1)