summaryrefslogtreecommitdiff
path: root/static/freebsd/man4/ipmi.4 3.html
diff options
context:
space:
mode:
Diffstat (limited to 'static/freebsd/man4/ipmi.4 3.html')
-rw-r--r--static/freebsd/man4/ipmi.4 3.html200
1 files changed, 0 insertions, 200 deletions
diff --git a/static/freebsd/man4/ipmi.4 3.html b/static/freebsd/man4/ipmi.4 3.html
deleted file mode 100644
index a02d82b8..00000000
--- a/static/freebsd/man4/ipmi.4 3.html
+++ /dev/null
@@ -1,200 +0,0 @@
-<table class="head">
- <tr>
- <td class="head-ltitle">IPMI(4)</td>
- <td class="head-vol">Device Drivers Manual</td>
- <td class="head-rtitle">IPMI(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">ipmi</code> &#x2014; <span class="Nd">OpenIPMI
- compatible IPMI interface driver</span></p>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
-<p class="Pp"><code class="Cd">device ipmi</code></p>
-<p class="Pp">To manually specify I/O attachment in
- <span class="Pa">/boot/device.hints</span>:
- <br/>
- <code class="Cd">hint.ipmi.0.at=&quot;isa&quot;</code>
- <br/>
- <code class="Cd">hint.ipmi.0.port=&quot;0xCA2&quot;</code>
- <br/>
- <code class="Cd">hint.ipmi.0.spacing=&quot;8&quot;</code>
- <br/>
- <code class="Cd">hint.ipmi.0.mode=&quot;KCS&quot;</code></p>
-<p class="Pp">To manually specify memory attachment in
- <span class="Pa">/boot/device.hints</span>:
- <br/>
- <code class="Cd">hint.ipmi.0.at=&quot;isa&quot;</code>
- <br/>
- <code class="Cd">hint.ipmi.0.maddr=&quot;0xf0000000&quot;</code>
- <br/>
- <code class="Cd">hint.ipmi.0.spacing=&quot;8&quot;</code>
- <br/>
- <code class="Cd">hint.ipmi.0.mode=&quot;SMIC&quot;</code></p>
-<p class="Pp">Meaning of <var class="Ar">spacing</var>:</p>
-<div class="Bd-indent">
-<dl class="Bl-tag Bl-compact">
- <dt>8</dt>
- <dd>8 bit alignment</dd>
- <dt>16</dt>
- <dd>16 bit alignment</dd>
- <dt>32</dt>
- <dd>32 bit alignment</dd>
-</dl>
-</div>
-<p class="Pp">If the <var class="Ar">port</var> and
- <var class="Ar">spacing</var> are not specified the interface type default
- will be used. Only specify either the <var class="Ar">port</var> for I/O
- access or <var class="Ar">maddr</var> for memory access.</p>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
-<p class="Pp">The IPMI (Intelligent Platform Management Interface) is a standard
- for monitoring system hardware by permitting generic code to detect and
- monitor the sensors in a system. The IPMI standard offers watchdog support,
- an FRU database, and other support extensions. It is currently being adopted
- by the makers of many single board and embedded system manufacturers.</p>
-<p class="Pp">The <code class="Nm">ipmi</code> driver in
- <span class="Ux">FreeBSD</span> is heavily adopted from the standard and
- Linux driver; however, not all features described in the standard are
- supported.</p>
-<p class="Pp">The <code class="Nm">ipmi</code> driver implements the power
- cycling option to <a class="Xr">shutdown(8)</a> to implement power cycling
- of the system. The motherboard's BMC must support the chassis device and the
- optional power cycle subcomand of the chassis control command as described
- in section 28.3 of the IPMI standard. The length of time the system is off
- will be at least one second, but may be longer if the power cycle interval
- has been set (see section 28.9).</p>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="IOCTLS"><a class="permalink" href="#IOCTLS">IOCTLS</a></h1>
-<p class="Pp">Sending and receiving messages through the
- <code class="Nm">ipmi</code> driver requires the use of
- <a class="Xr">ioctl(2)</a>. The ioctls are used due to the complexity of
- data sent to and from the device. The <a class="Xr">ioctl(2)</a> command
- codes below are defined in
- <code class="In">&lt;<a class="In">sys/ipmi.h</a>&gt;</code>. The third
- argument to <a class="Xr">ioctl(2)</a> should be a pointer to the type
- indicated.</p>
-<p class="Pp">Currently the following ioctls are supported:</p>
-<dl class="Bl-tag">
- <dt id="IPMICTL_RECEIVE_MSG"><a class="permalink" href="#IPMICTL_RECEIVE_MSG"><code class="Dv">IPMICTL_RECEIVE_MSG</code></a>
- (<var class="Vt">struct ipmi_recv</var>)</dt>
- <dd>Receive a message. Possible error values:
- <dl class="Bl-tag">
- <dt>[<code class="Er">EAGAIN</code>]</dt>
- <dd>No messages are in the process queue.</dd>
- <dt>[<code class="Er">EFAULT</code>]</dt>
- <dd>An address supplied was invalid.</dd>
- <dt>[<code class="Er">EMSGSIZE</code>]</dt>
- <dd>The address could not fit in the message buffer and will remain in the
- buffer.</dd>
- </dl>
- </dd>
- <dt id="IPMICTL_RECEIVE_MSG_TRUNC"><a class="permalink" href="#IPMICTL_RECEIVE_MSG_TRUNC"><code class="Dv">IPMICTL_RECEIVE_MSG_TRUNC</code></a>
- (<var class="Vt">struct ipmi_recv</var>)</dt>
- <dd>Like <code class="Dv">IPMICTL_RECEIVE_MSG</code> but if the message cannot
- fit into the buffer, it will truncate the contents instead of leaving the
- data in the buffer.</dd>
- <dt id="IPMICTL_SEND_COMMAND"><a class="permalink" href="#IPMICTL_SEND_COMMAND"><code class="Dv">IPMICTL_SEND_COMMAND</code></a>
- (<var class="Vt">struct ipmi_req</var>)</dt>
- <dd>Send a message to the interface. Possible error values:
- <dl class="Bl-tag">
- <dt>[<code class="Er">EFAULT</code>]</dt>
- <dd>An address supplied was invalid.</dd>
- <dt>[<code class="Er">ENOMEM</code>]</dt>
- <dd>Buffers could not be allowed for the command, out of memory.</dd>
- </dl>
- </dd>
- <dt id="IPMICTL_SET_MY_ADDRESS_CMD"><a class="permalink" href="#IPMICTL_SET_MY_ADDRESS_CMD"><code class="Dv">IPMICTL_SET_MY_ADDRESS_CMD</code></a>
- (<var class="Vt">unsigned int</var>)</dt>
- <dd>Set the slave address for source messages.</dd>
- <dt id="IPMICTL_GET_MY_ADDRESS_CMD"><a class="permalink" href="#IPMICTL_GET_MY_ADDRESS_CMD"><code class="Dv">IPMICTL_GET_MY_ADDRESS_CMD</code></a>
- (<var class="Vt">unsigned int</var>)</dt>
- <dd>Get the slave address for source messages.</dd>
- <dt id="IPMICTL_SET_MY_LUN_CMD"><a class="permalink" href="#IPMICTL_SET_MY_LUN_CMD"><code class="Dv">IPMICTL_SET_MY_LUN_CMD</code></a>
- (<var class="Vt">unsigned int</var>)</dt>
- <dd>Set the slave LUN for source messages.</dd>
- <dt id="IPMICTL_GET_MY_LUN_CMD"><a class="permalink" href="#IPMICTL_GET_MY_LUN_CMD"><code class="Dv">IPMICTL_GET_MY_LUN_CMD</code></a>
- (<var class="Vt">unsigned int</var>)</dt>
- <dd>Get the slave LUN for source messages.</dd>
-</dl>
-<section class="Ss">
-<h2 class="Ss" id="Unimplemented_Ioctls"><a class="permalink" href="#Unimplemented_Ioctls">Unimplemented
- Ioctls</a></h2>
-<dl class="Bl-tag">
- <dt id="IPMICTL_REGISTER_FOR_CMD"><a class="permalink" href="#IPMICTL_REGISTER_FOR_CMD"><code class="Dv">IPMICTL_REGISTER_FOR_CMD</code></a>
- (<var class="Vt">struct ipmi_cmdspec</var>)</dt>
- <dd>Register to receive a specific command. Possible error values:
- <dl class="Bl-tag">
- <dt>[<code class="Er">EFAULT</code>]</dt>
- <dd>An supplied address was invalid.</dd>
- <dt>[<code class="Er">EBUSY</code>]</dt>
- <dd>The network function/command is already in use.</dd>
- <dt>[<code class="Er">ENOMEM</code>]</dt>
- <dd>Could not allocate memory.</dd>
- </dl>
- </dd>
- <dt id="IPMICTL_UNREGISTER_FOR_CMD"><a class="permalink" href="#IPMICTL_UNREGISTER_FOR_CMD"><code class="Dv">IPMICTL_UNREGISTER_FOR_CMD</code></a>
- (<var class="Vt">struct ipmi_cmdspec</var>)</dt>
- <dd>Unregister to receive a specific command. Possible error values:
- <dl class="Bl-tag">
- <dt>[<code class="Er">EFAULT</code>]</dt>
- <dd>An address supplied was invalid.</dd>
- <dt>[<code class="Er">ENOENT</code>]</dt>
- <dd>The network function/command was not found.</dd>
- </dl>
- </dd>
-</dl>
-</section>
-<section class="Ss">
-<h2 class="Ss" id="Stub_Only_Ioctl"><a class="permalink" href="#Stub_Only_Ioctl">Stub
- Only Ioctl</a></h2>
-<dl class="Bl-tag">
- <dt id="IPMICTL_SET_GETS_EVENTS_CMD"><a class="permalink" href="#IPMICTL_SET_GETS_EVENTS_CMD"><code class="Dv">IPMICTL_SET_GETS_EVENTS_CMD</code></a>
- (<var class="Vt">int</var>)</dt>
- <dd>Set whether this interface receives events. Possible error values:
- <dl class="Bl-tag">
- <dt>[<code class="Er">EFAULT</code>]</dt>
- <dd>An address supplied was invalid.</dd>
- </dl>
- </dd>
-</dl>
-</section>
-</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">ioctl(2)</a>, <a class="Xr">watchdog(4)</a>,
- <a class="Xr">reboot(8)</a>, <a class="Xr">shutdown(8)</a>,
- <a class="Xr">watchdog(8)</a>, <a class="Xr">watchdogd(8)</a>,
- <a class="Xr">watchdog(9)</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">ipmi</code> driver first appeared in
- <span class="Ux">FreeBSD 6.2</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">ipmi</code> driver was written by
- <span class="An">Doug Ambrisko</span>
- &lt;<a class="Mt" href="mailto:ambrisko@FreeBSD.org">ambrisko@FreeBSD.org</a>&gt;.
- This manual page was written by <span class="An">Tom Rhodes</span>
- &lt;<a class="Mt" href="mailto:trhodes@FreeBSD.org">trhodes@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">Not all features of the MontaVista driver are supported.</p>
-<p class="Pp">Currently, IPMB and BT modes are not implemented.</p>
-</section>
-</div>
-<table class="foot">
- <tr>
- <td class="foot-date">October 25, 2017</td>
- <td class="foot-os">FreeBSD 15.0</td>
- </tr>
-</table>