xref: /dragonfly/usr.sbin/mpsutil/mpsutil.8 (revision fb3c2c0c)
1*fd501800SSascha Wildner.\"
2*fd501800SSascha Wildner.\" Copyright (c) Baptiste Daroussin <bapt@FreeBSD.org>
3*fd501800SSascha Wildner.\"
4*fd501800SSascha Wildner.\" Redistribution and use in source and binary forms, with or without
5*fd501800SSascha Wildner.\" modification, are permitted provided that the following conditions
6*fd501800SSascha Wildner.\" are met:
7*fd501800SSascha Wildner.\" 1. Redistributions of source code must retain the above copyright
8*fd501800SSascha Wildner.\"    notice, this list of conditions and the following disclaimer.
9*fd501800SSascha Wildner.\" 2. Redistributions in binary form must reproduce the above copyright
10*fd501800SSascha Wildner.\"    notice, this list of conditions and the following disclaimer in the
11*fd501800SSascha Wildner.\"    documentation and/or other materials provided with the distribution.
12*fd501800SSascha Wildner.\"
13*fd501800SSascha Wildner.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14*fd501800SSascha Wildner.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15*fd501800SSascha Wildner.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16*fd501800SSascha Wildner.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17*fd501800SSascha Wildner.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18*fd501800SSascha Wildner.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19*fd501800SSascha Wildner.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20*fd501800SSascha Wildner.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21*fd501800SSascha Wildner.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22*fd501800SSascha Wildner.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23*fd501800SSascha Wildner.\" SUCH DAMAGE.
24*fd501800SSascha Wildner.\"
25*fd501800SSascha Wildner.\" $FreeBSD: head/usr.sbin/mpsutil/mpsutil.8 291002 2015-11-17 20:42:59Z bapt $
26*fd501800SSascha Wildner.\"
27*fd501800SSascha Wildner.Dd April 24, 2018
28*fd501800SSascha Wildner.Dt MPSUTIL 8
29*fd501800SSascha Wildner.Os
30*fd501800SSascha Wildner.Sh NAME
31*fd501800SSascha Wildner.Nm mpsutil ,
32*fd501800SSascha Wildner.Nm mprutil
33*fd501800SSascha Wildner.Nd Utility for managing LSI Fusion-MPT 2/3 controllers
34*fd501800SSascha Wildner.Sh SYNOPSIS
35*fd501800SSascha Wildner.Nm
36*fd501800SSascha Wildner.Cm version
37*fd501800SSascha Wildner.Nm
38*fd501800SSascha Wildner.Op Fl u Ar unit
39*fd501800SSascha Wildner.Cm show adapter
40*fd501800SSascha Wildner.Nm
41*fd501800SSascha Wildner.Op Fl u Ar unit
42*fd501800SSascha Wildner.Cm show adapters
43*fd501800SSascha Wildner.Nm
44*fd501800SSascha Wildner.Op Fl u Ar unit
45*fd501800SSascha Wildner.Cm show all
46*fd501800SSascha Wildner.Nm
47*fd501800SSascha Wildner.Op Fl u Ar unit
48*fd501800SSascha Wildner.Cm show cfgpages page
49*fd501800SSascha Wildner.Op Ar num
50*fd501800SSascha Wildner.Op Ar addr
51*fd501800SSascha Wildner.Nm
52*fd501800SSascha Wildner.Op Fl u Ar unit
53*fd501800SSascha Wildner.Cm show devices
54*fd501800SSascha Wildner.Nm
55*fd501800SSascha Wildner.Op Fl u Ar unit
56*fd501800SSascha Wildner.Cm show enclosures
57*fd501800SSascha Wildner.Nm
58*fd501800SSascha Wildner.Op Fl u Ar unit
59*fd501800SSascha Wildner.Cm show expanders
60*fd501800SSascha Wildner.Nm
61*fd501800SSascha Wildner.Op Fl u Ar unit
62*fd501800SSascha Wildner.Cm show iocfacts
63*fd501800SSascha Wildner.Nm
64*fd501800SSascha Wildner.Op Fl u Ar unit
65*fd501800SSascha Wildner.Cm flash save
66*fd501800SSascha Wildner.Op Ar firmware Ns | Ns Ar bios
67*fd501800SSascha Wildner.Op Ar file
68*fd501800SSascha Wildner.Nm
69*fd501800SSascha Wildner.Op Fl u Ar unit
70*fd501800SSascha Wildner.Cm flash update
71*fd501800SSascha Wildner.Op Ar firmware Ns | Ns Ar bios
72*fd501800SSascha Wildner.Ar file
73*fd501800SSascha Wildner.Sh DESCRIPTION
74*fd501800SSascha WildnerThe
75*fd501800SSascha Wildner.Nm
76*fd501800SSascha Wildnerutility can be used to display or modify various parameters on LSI
77*fd501800SSascha WildnerFusion-MPS 2 controllers.
78*fd501800SSascha Wildner.Pp
79*fd501800SSascha WildnerThe
80*fd501800SSascha Wildner.Nm mprutil
81*fd501800SSascha Wildnerutility can be used to display or modify various parameters on LSI
82*fd501800SSascha WildnerFusion-MPS 3 controllers.
83*fd501800SSascha Wildner.Pp
84*fd501800SSascha WildnerThe
85*fd501800SSascha Wildner.Nm mprutil
86*fd501800SSascha Wildnerutility behave identically to
87*fd501800SSascha Wildner.Nm .
88*fd501800SSascha Wildner(same program)
89*fd501800SSascha Wildner.Pp
90*fd501800SSascha WildnerEach invocation of
91*fd501800SSascha Wildner.Nm
92*fd501800SSascha Wildnerconsists of zero or more global options followed by a command.
93*fd501800SSascha WildnerCommands may support additional optional or required arguments after the
94*fd501800SSascha Wildnercommand.
95*fd501800SSascha Wildner.Pp
96*fd501800SSascha WildnerCurrently one global option is supported:
97*fd501800SSascha Wildner.Bl -tag -width indent
98*fd501800SSascha Wildner.It Fl u Ar unit
99*fd501800SSascha Wildner.Ar unit
100*fd501800SSascha Wildnerspecifies the unit of the controller to work with.
101*fd501800SSascha WildnerIf no unit is specified,
102*fd501800SSascha Wildnerthen unit 0 is used.
103*fd501800SSascha Wildner.El
104*fd501800SSascha Wildner.Pp
105*fd501800SSascha WildnerThe
106*fd501800SSascha Wildner.Nm
107*fd501800SSascha Wildnerutility supports several different groups of commands.
108*fd501800SSascha WildnerThe first group of commands provide information about the controller.
109*fd501800SSascha WildnerThe second group of commands are used to manager controller-wide operations.
110*fd501800SSascha Wildner.Pp
111*fd501800SSascha WildnerThe informational commands include:
112*fd501800SSascha Wildner.Bl -tag -width indent
113*fd501800SSascha Wildner.It Cm version
114*fd501800SSascha WildnerDisplays the version of
115*fd501800SSascha Wildner.Nm .
116*fd501800SSascha Wildner.It Cm show adapter
117*fd501800SSascha WildnerDisplays information about the controller such as the model number or firmware
118*fd501800SSascha Wildnerversion.
119*fd501800SSascha Wildner.It Cm show adapters
120*fd501800SSascha WildnerDisplays a summary of all adapters.
121*fd501800SSascha Wildner.It Cm show all
122*fd501800SSascha WildnerDisplays all devices, expanders and enclosures.
123*fd501800SSascha Wildner.It Cm show devices
124*fd501800SSascha WildnerDisplays all devices.
125*fd501800SSascha Wildner.It Cm show expanders
126*fd501800SSascha WildnerDisplays all expanders.
127*fd501800SSascha Wildner.It Cm show enclosures
128*fd501800SSascha WildnerDisplays all enclosures.
129*fd501800SSascha Wildner.It Cm show iocfacts
130*fd501800SSascha WildnerDisplays IOC Facts messages.
131*fd501800SSascha Wildner.It Cm show cfgpage page Oo Ar num Oc Op Ar addr
132*fd501800SSascha WildnerShow IOC Facts Message
133*fd501800SSascha Wildner.El
134*fd501800SSascha Wildner.Pp
135*fd501800SSascha WildnerController management commands include:
136*fd501800SSascha Wildner.Bl -tag -width indent
137*fd501800SSascha Wildner.It Cm flash save Oo Ar firmware Ns | Ns Ar bios Oc Op Ar file
138*fd501800SSascha WildnerSave the
139*fd501800SSascha Wildner.Ar firmware
140*fd501800SSascha Wildneror
141*fd501800SSascha Wildner.Ar bios
142*fd501800SSascha Wildnerfrom the controller into a local
143*fd501800SSascha Wildner.Ar file .
144*fd501800SSascha WildnerIf no
145*fd501800SSascha Wildner.Ar file
146*fd501800SSascha Wildneris specified then the file will be named
147*fd501800SSascha Wildner.Pa firmware
148*fd501800SSascha Wildneror
149*fd501800SSascha Wildner.Pa bios .
150*fd501800SSascha Wildner.It Cm flash update Oo Ar firmware Ns | Ns Ar bios Oc Ar file
151*fd501800SSascha WildnerReplace the
152*fd501800SSascha Wildner.Ar firmware
153*fd501800SSascha Wildneror
154*fd501800SSascha Wildner.Ar bios
155*fd501800SSascha Wildnerfrom the controller with the one specified via
156*fd501800SSascha Wildner.Ar file .
157*fd501800SSascha Wildner.El
158*fd501800SSascha Wildner.Sh SEE ALSO
159*fd501800SSascha Wildner.Xr mpr 4 ,
160*fd501800SSascha Wildner.Xr mps 4
161*fd501800SSascha Wildner.Sh HISTORY
162*fd501800SSascha WildnerThe
163*fd501800SSascha Wildner.Nm
164*fd501800SSascha Wildnerutility first appeared in
165*fd501800SSascha Wildner.Fx 11.0 .
166