summaryrefslogtreecommitdiff
path: root/static/freebsd/man4/mfi.4 3.html
blob: 82a738f60946b51ad66f2d36c62b463bb862aed1 (plain)
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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
<table class="head">
  <tr>
    <td class="head-ltitle">MFI(4)</td>
    <td class="head-vol">Device Drivers Manual</td>
    <td class="head-rtitle">MFI(4)</td>
  </tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp"><code class="Nm">mfi</code> &#x2014; <span class="Nd">LSI MegaRAID
    SAS driver</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp">To compile this driver into the kernel, place the following lines
    in your kernel configuration file:</p>
<div class="Bd Pp Bd-indent"><code class="Cd">device pci</code>
<br/>
<code class="Cd">device mfi</code></div>
<p class="Pp">Alternatively, to load the driver as a module at boot time, place
    the following line in <a class="Xr">loader.conf(5)</a>:</p>
<div class="Bd Pp Bd-indent Li">
<pre>mfi_load=&quot;YES&quot;</pre>
</div>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">This driver is for LSI's next generation PCI Express SAS RAID
    controllers. Access to RAID arrays (logical disks) from this driver is
    provided via <span class="Pa">/dev/mfid?</span> device nodes. A simple
    management interface is also provided on a per-controller basis via the
    <span class="Pa">/dev/mfi?</span> device node.</p>
<p class="Pp">The <code class="Nm">mfi</code> name is derived from the phrase
    &quot;MegaRAID Firmware Interface&quot;, which is substantially different
    than the old &quot;MegaRAID&quot; interface and thus requires a new driver.
    Older SCSI and SATA MegaRAID cards are supported by <a class="Xr">amr(4)</a>
    and will not work with this driver.</p>
<p class="Pp">Two sysctls are provided to tune the <code class="Nm">mfi</code>
    driver's behavior when a request is made to remove a mounted volume. By
    default the driver will disallow any requests to remove a mounted volume. If
    the sysctl <var class="Va">dev.mfi.%d.delete_busy_volumes</var> is set to 1,
    then the driver will allow mounted volumes to be removed.</p>
<p class="Pp">A tunable is provided to adjust the <code class="Nm">mfi</code>
    driver's behaviour when attaching to a card. By default the driver will
    attach to all known cards with high probe priority. If the tunable
    <var class="Va">hw.mfi.mrsas_enable</var> is set to 1, then the driver will
    reduce its probe priority to allow <a class="Xr">mrsas(4)</a> to attach to
    the card instead of <code class="Nm">mfi</code>.</p>
<p class="Pp"><code class="Nm">mfi</code> does not provide ATA TRIM support.
    Refer to <a class="Xr">mrsas(4)</a> if TRIM support is required.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="HARDWARE"><a class="permalink" href="#HARDWARE">HARDWARE</a></h1>
<p class="Pp">The <code class="Nm">mfi</code> driver supports the following
    hardware:</p>
<p class="Pp"></p>
<ul class="Bl-bullet Bl-compact">
  <li>LSI MegaRAID SAS 1078</li>
  <li>LSI MegaRAID SAS 8408E</li>
  <li>LSI MegaRAID SAS 8480E</li>
  <li>LSI MegaRAID SAS 9240</li>
  <li>LSI MegaRAID SAS 9260</li>
  <li>Dell PERC5</li>
  <li>Dell PERC6</li>
  <li>Fujitsu RAID Controller SAS 6Gbit/s 1GB (D3116)</li>
  <li>IBM ServeRAID M1015 SAS/SATA</li>
  <li>IBM ServeRAID M1115 SAS/SATA</li>
  <li>IBM ServeRAID M5015 SAS/SATA</li>
  <li>IBM ServeRAID M5110 SAS/SATA</li>
  <li>IBM ServeRAID-MR10i</li>
  <li>Intel RAID Controller SRCSAS18E</li>
  <li>Intel RAID Controller SROMBSAS18E</li>
</ul>
</section>
<section class="Sh">
<h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1>
<dl class="Bl-tag Bl-compact">
  <dt><span class="Pa">/dev/mfid?</span></dt>
  <dd>array/logical disk interface</dd>
  <dt><span class="Pa">/dev/mfi?</span></dt>
  <dd>management interface</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="DIAGNOSTICS"><a class="permalink" href="#DIAGNOSTICS">DIAGNOSTICS</a></h1>
<dl class="Bl-diag">
  <dt>mfid%d: Unable to delete busy device</dt>
  <dd>An attempt was made to remove a mounted volume.</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
  ALSO</a></h1>
<p class="Pp"><a class="Xr">amr(4)</a>, <a class="Xr">pci(4)</a>,
    <a class="Xr">mfiutil(8)</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
<p class="Pp">The <code class="Nm">mfi</code> driver first appeared in
    <span class="Ux">FreeBSD 6.1</span>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<p class="Pp">The <code class="Nm">mfi</code> driver and this manual page were
    written by <span class="An">Scott Long</span>
    &lt;<a class="Mt" href="mailto:scottl@FreeBSD.org">scottl@FreeBSD.org</a>&gt;.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1>
<p class="Pp">The driver does not support big-endian architectures at this
  time.</p>
</section>
</div>
<table class="foot">
  <tr>
    <td class="foot-date">April 19, 2023</td>
    <td class="foot-os">FreeBSD 15.0</td>
  </tr>
</table>