diff options
Diffstat (limited to 'static/netbsd/man4/man4.sparc/openprom.4 3.html')
| -rw-r--r-- | static/netbsd/man4/man4.sparc/openprom.4 3.html | 109 |
1 files changed, 0 insertions, 109 deletions
diff --git a/static/netbsd/man4/man4.sparc/openprom.4 3.html b/static/netbsd/man4/man4.sparc/openprom.4 3.html deleted file mode 100644 index 29e4bf9b..00000000 --- a/static/netbsd/man4/man4.sparc/openprom.4 3.html +++ /dev/null @@ -1,109 +0,0 @@ -<table class="head"> - <tr> - <td class="head-ltitle">OPENPROM(4)</td> - <td class="head-vol">Device Drivers Manual (sparc)</td> - <td class="head-rtitle">OPENPROM(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">openprom</code> — <span class="Nd">Sun - OPENPROM and EEPROM interface</span></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1> -<p class="Pp"><code class="In">#include - <<a class="In">machine/openpromio.h</a>></code></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1> -<p class="Pp">The file <code class="Nm">/dev/openprom</code> is an interface to - the SPARC OPENPROM, including the EEPROM area. This interface is highly - stylized; ioctls are used for all operations. These ioctls refer to - “nodes”, which are simply “magic” integer values - describing data areas. Occasionally the number 0 may be used or returned - instead, as described below. A special distinguished “options” - node holds the EEPROM settings.</p> -<p class="Pp">The calls that take and/or return a node use a pointer to an - <code class="Li">int</code> variable for this purpose; others use a pointer - to an <code class="Li">struct opiocdesc</code> descriptor, which contains a - node and two counted strings. The first string comprises the fields - <code class="Li">op_namelen</code> (an <code class="Li">int</code>) and - <code class="Li">op_name</code> (a <code class="Li">char *</code>), giving - the name of a field. The second string comprises the fields - <code class="Li">op_buflen</code> and <code class="Li">op_buf</code>, used - analogously. These two counted strings work in a - “value-result” fashion. At entry to the ioctl, the counts are - expected to reflect the buffer size; on return, the counts are updated to - reflect the buffer contents.</p> -<p class="Pp">The following ioctls are supported:</p> -<dl class="Bl-tag"> - <dt id="OPIOCGETOPTNODE"><a class="permalink" href="#OPIOCGETOPTNODE"><code class="Dv">OPIOCGETOPTNODE</code></a></dt> - <dd>Takes nothing, and fills in the options node number.</dd> - <dt>OPIOCGETNEXT</dt> - <dd>Takes a node number and returns the number of the following node. The node - following the last node is number 0; the node following number 0 is the - first node.</dd> - <dt id="OPIOCGETCHILD"><a class="permalink" href="#OPIOCGETCHILD"><code class="Dv">OPIOCGETCHILD</code></a></dt> - <dd>Takes a node number and returns the number of the first - “child” of that node. This child may have siblings; these - can be discovered by using <code class="Dv">OPIOCGETNEXT</code>.</dd> - <dt id="OPIOCGET"><a class="permalink" href="#OPIOCGET"><code class="Dv">OPIOCGET</code></a></dt> - <dd>Fills in the value of the named property for the given node. If no such - property is associated with that node, the value length is set to -1. If - the named property exists but has no value, the value length is set to - 0.</dd> - <dt id="OPIOCSET"><a class="permalink" href="#OPIOCSET"><code class="Dv">OPIOCSET</code></a></dt> - <dd>Writes the given value under the given name. The OPENPROM may refuse this - operation; in this case <code class="Dv">EINVAL</code> is returned.</dd> - <dt id="OPIOCNEXTPROP"><a class="permalink" href="#OPIOCNEXTPROP"><code class="Dv">OPIOCNEXTPROP</code></a></dt> - <dd>Finds the property whose name follows the given name in OPENPROM internal - order. The resulting name is returned in the value field. If the named - property is the last, the “next” name is the empty string. - As with <code class="Dv">OPIOCGETNEXT</code>, the next name after the - empty string is the first name.</dd> -</dl> -</section> -<section class="Sh"> -<h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1> -<p class="Pp"><span class="Pa">/dev/openprom</span></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1> -<p class="Pp">The following may result in rejection of an operation:</p> -<dl class="Bl-tag"> - <dt id="EINVAL">[<a class="permalink" href="#EINVAL"><code class="Er">EINVAL</code></a>]</dt> - <dd>The given node number is not zero and does not correspond to any valid - node, or is zero where zero is not allowed.</dd> - <dt id="EBADF">[<a class="permalink" href="#EBADF"><code class="Er">EBADF</code></a>]</dt> - <dd>The requested operation requires permissions not specified at the call to - <code class="Fn">open</code>().</dd> - <dt id="ENAMETOOLONG">[<a class="permalink" href="#ENAMETOOLONG"><code class="Er">ENAMETOOLONG</code></a>]</dt> - <dd>The given name or value field exceeds the maximum allowed length (8191 - bytes).</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">ioctl(2)</a></p> -<p class="Pp"><a class="Lk" href="http://www.openfirmware.org/1275/">IEEE 1275 - Open Firmware</a></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1> -<p class="Pp">Due to limitations within the <code class="Nm">openprom</code> - itself, these functions run at elevated priority and may adversely affect - system performance.</p> -<p class="Pp">The Sun <code class="Nm">openprom</code> is what became the Open - Firmware (IEEE 1275) standard for processor and system independent boot - firmware.</p> -</section> -</div> -<table class="foot"> - <tr> - <td class="foot-date">June 5, 1993</td> - <td class="foot-os">NetBSD 10.1</td> - </tr> -</table> |