headers.htm

What is this ``device driver stuff anyway? Here s a very short introduction to the concept.

</tt></strong>
</td>
<td align="left" valign="top">
Defines a device driver's entry points and other information.
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
handler_intr_info
</tt></strong>
</td>
<td align="left" valign="top">
Contains interrupt handler information.
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
ihandler_t
</tt></strong>
</td>
<td align="left" valign="top">
Contains information associated with device driver interrupt handling.
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
item_list
</tt></strong>
</td>
<td align="left" valign="top">
Contains hardware platform-specific information.
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
lock
</tt></strong>
</td>
<td align="left" valign="top">
Contains complex lock-specific information.
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
port
</tt></strong>
</td>
<td align="left" valign="top">
Contains information about a port.
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
pt_tbl
</tt></strong>
</td>
<td align="left" valign="top">
Stores a disk partition map.
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
sel_queue
</tt></strong>
</td>
<td align="left" valign="top">
Defines a queue of select events.
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
sg_entry
</tt></strong>
</td>
<td align="left" valign="top">
Contains bus address/byte count pairs.
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
<tt>slock</tt>
</tt></strong>
</td>
<td align="left" valign="top">
Contains simple lock-specific information.
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
task
</tt></strong>
</td>
<td align="left" valign="top">
Contains task-specific information.
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
thread
</tt></strong>
</td>
<td align="left" valign="top">
Contains kernel threads-related information.
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
uio
</tt></strong>
</td>
<td align="left" valign="top">
Describes I/O, either single vector or multiple vectors.
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
v1_bustype_info_t
</tt></strong>
</td>
<td align="left" valign="top">
Stores bus information.
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
v1_device_info_t
</tt></strong>
</td>
<td align="left" valign="top">
Is the top-level union that stores bus- and device-type information.
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
v1_devtype_info_t
</tt></strong>
</td>
<td align="left" valign="top">
Stores device-type information.
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
v1_disk_dev_info_t
</tt></strong>
</td>
<td align="left" valign="top">
Stores disk information.
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
v1_tape_dev_info_t
</tt></strong>
</td>
<td align="left" valign="top">
Stores tape information.
</td>
</tr>
</tbody></table><p>
<a name="ListofDevDrvInter"></a>
</p><p></p><hr><p align="center">
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/Digital_UNIX_Bookshelf.html"><img src="headers_files/BOOKSHELF.GIF" alt="[Return to Library]" border="0"></a>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/AA-PUBVD-TE_html/TOC.html"><img src="headers_files/TOC.GIF" alt="[Contents]" border="0"></a>
<a href="#SumryTables"><img src="headers_files/REW.GIF" alt="[Previous Chapter]" border="0"></a>
<a href="#ListofStructDescrips"><img src="headers_files/PREV.GIF" alt="[Previous Section]" border="0"></a>
<a href="#ListofBusConfigInter"><img src="headers_files/NEXT.GIF" alt="[Next Section]" border="0"></a>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/AA-PUBVD-TE_html/drivertut28.html"><img src="headers_files/FF.GIF" alt="[Next Chapter]" border="0"></a>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/AA-PUBVD-TE_html/INDEX.html"><img src="headers_files/INDEX.GIF" alt="[Index]" border="0"></a>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/HELP.html"><img src="headers_files/HELP.GIF" alt="[Help]" border="0"></a>
</p><p></p><hr><p>
</p><h2>
A.5&nbsp;&nbsp;&nbsp;&nbsp;List of Device Driver Interfaces
</h2>
<p>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/AA-PUBVD-TE_html/drivertut27.html#sumry_dev_drv_rtns">Table A-5</a>
summarizes the interfaces that device drivers use.
Chapter 4
of
<cite>Writing Device Drivers: Reference</cite>
provides reference page descriptions of the driver interfaces
listed in
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/AA-PUBVD-TE_html/drivertut27.html#sumry_dev_drv_rtns">Table A-5</a>.
The table has the following columns:
</p><ul>
<p></p><li>
Interface
<p>
This column lists the driver interface name.
</p><p></p></li><li>
Entry point
<p>
This column lists the structure (or file) where the driver writer
defines
the entry point for the device driver interface.
</p><p></p></li><li>
Character
<p>
A Yes appears in this column if the interface is applicable to a
character
device.
Otherwise, N/A (not applicable) appears.
</p><p></p></li><li>
Block
<p>
A Yes appears in this column if the interface is applicable to a block
device.
Otherwise, N/A (not applicable) appears.
</p></li></ul><p>
</p><p>
<a name="nx_id_889"></a>
<a name="sumry_dev_drv_rtns"></a>
</p><h3>
Table A-5: Summary of Block and Character Device Driver Interfaces
</h3>
<table border="4" cellpadding="4">
<tbody><tr>
<td align="left" valign="top">
<strong>
Interface
</strong>
</td>
<td align="left" valign="top">
<strong>
Entry Point
</strong>
</td>
<td align="left" valign="top">
<strong>
Character
</strong>
</td>
<td align="left" valign="top">
<strong>
Block
</strong>
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
callback
</tt></strong>
</td>
<td align="left" valign="top">
N/A
</td>
<td align="left" valign="top">
Yes
</td>
<td align="left" valign="top">
Yes
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
cattach
</tt></strong>
</td>
<td align="left" valign="top">
<tt>driver</tt>
</td>
<td align="left" valign="top">
Yes
</td>
<td align="left" valign="top">
Yes
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
close
</tt></strong>
</td>
<td align="left" valign="top">
<tt>dsent</tt>
</td>
<td align="left" valign="top">
Yes
</td>
<td align="left" valign="top">
Yes
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
configure
</tt></strong>
</td>
<td align="left" valign="top">
N/A
</td>
<td align="left" valign="top">
Yes
</td>
<td align="left" valign="top">
Yes
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
ctrl_unattach
</tt></strong>
</td>
<td align="left" valign="top">
<tt>driver</tt>
</td>
<td align="left" valign="top">
Yes
</td>
<td align="left" valign="top">
Yes
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
dattach
</tt></strong>
</td>
<td align="left" valign="top">
<tt>driver</tt>
</td>
<td align="left" valign="top">
Yes
</td>
<td align="left" valign="top">
Yes
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
dev_unattach
</tt></strong>
</td>
<td align="left" valign="top">
<tt>driver</tt>
</td>
<td align="left" valign="top">
Yes
</td>
<td align="left" valign="top">
Yes
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
dump
</tt></strong>
</td>
<td align="left" valign="top">
<tt>dsent</tt>
</td>
<td align="left" valign="top">
N/A
</td>
<td align="left" valign="top">
Yes
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
flush
</tt></strong>
</td>
<td align="left" valign="top">
N/A
</td>
<td align="left" valign="top">
Yes
</td>
<td align="left" valign="top">
Yes
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
intr
</tt></strong>
</td>
<td align="left" valign="top">
Use the
<tt>handler_add</tt>
and
<tt>handler_enable</tt>
interfaces for registration of interrupt handlers
</td>
<td align="left" valign="top">
Yes
</td>
<td align="left" valign="top">
Yes
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
ioctl
</tt></strong>
</td>
<td align="left" valign="top">
<tt>dsent</tt>
</td>
<td align="left" valign="top">
Yes
</td>
<td align="left" valign="top">
Yes
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
mmap
</tt></strong>
</td>
<td align="left" valign="top">
<tt>dsent</tt>
</td>
<td align="left" valign="top">
Yes
</td>
<td align="left" valign="top">
N/A
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
open
</tt></strong>
</td>
<td align="left" valign="top">
<tt>dsent</tt>
</td>
<td align="left" valign="top">
Yes
</td>
<td align="left" valign="top">
Yes
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
probe
</tt></strong>
</td>
<td align="left" valign="top">
<tt>driver</tt>
</td>
<td align="left" valign="top">
Yes
</td>
<td align="left" valign="top">
Yes
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
psize
</tt></strong>
</td>
<td align="left" valign="top">
<tt>dsent</tt>
</td>
<td align="left" valign="top">
N/A
</td>
<td align="left" valign="top">
Yes
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
read
</tt></strong>
</td>
<td align="left" valign="top">
<tt>dsent</tt>
</td>
<td align="left" valign="top">
Yes
</td>
<td align="left" valign="top">
N/A
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
reset
</tt></strong>
</td>
<td align="left" valign="top">
<tt>dsent</tt>
</td>
<td align="left" valign="top">
Yes
</td>
<td align="left" valign="top">
N/A
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
select
</tt></strong>
</td>
<td align="left" valign="top">
<tt>dsent</tt>
</td>
<td align="left" valign="top">
Yes
</td>
<td align="left" valign="top">
N/A
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
shutdown
</tt></strong>
</td>
<td align="left" valign="top">
N/A
</td>
<td align="left" valign="top">
Yes
</td>
<td align="left" valign="top">
Yes
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
slave
</tt></strong>
</td>
<td align="left" valign="top">
<tt>driver</tt>
</td>
<td align="left" valign="top">
Yes
</td>
<td align="left" valign="top">
Yes
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
stop
</tt></strong>
</td>
<td align="left" valign="top">
<tt>dsent</tt>
</td>
<td align="left" valign="top">
Yes
</td>
<td align="left" valign="top">
N/A
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
strategy
</tt></strong>
</td>
<td align="left" valign="top">
<tt>dsent</tt>
</td>
<td align="left" valign="top">
N/A
</td>
<td align="left" valign="top">
Yes
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
write
</tt></strong>
</td>
<td align="left" valign="top">
<tt>dsent</tt>
</td>
<td align="left" valign="top">
Yes
</td>
<td align="left" valign="top">
N/A
</td>
</tr>
</tbody></table><p>
<a name="ListofBusConfigInter"></a>
</p><p></p><hr><p align="center">
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/Digital_UNIX_Bookshelf.html"><img src="headers_files/BOOKSHELF.GIF" alt="[Return to Library]" border="0"></a>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/AA-PUBVD-TE_html/TOC.html"><img src="headers_files/TOC.GIF" alt="[Contents]" border="0"></a>
<a href="#SumryTables"><img src="headers_files/REW.GIF" alt="[Previous Chapter]" border="0"></a>
<a href="#ListofDevDrvInter"><img src="headers_files/PREV.GIF" alt="[Previous Section]" border="0"></a>
<img src=