Kernel Extensions and Device Support Programming Concepts

<BODY BGCOLOR="FCFBF0"> <CENTER> <FONT COLOR="#A62A2A" SIZE="+2"> </FONT> </CENTER> <HR> <H1><A HREF="edition.htm#A3709082916vang">Second Edition (September 1999)</A></H1> <H1><A HREF="trademarks.htm#ZWHNp23bstue">Trademarks and Acknowledgements</A></H1> <H1><A HREF="About.htm#C34726D206sylv">About This Book</A></H1> <H1><A HREF="kern_enviro.htm#A23C0f19a">Chapter 1. Kernel Environment</A></H1> <H2><A HREF="kernex_binding.htm#A23C0f1a0">Understanding Kernel Extension Binding</A></H2> <H2><A HREF="exec_enviro.htm#A23C0f1d3">Understanding Execution Environments</A></H2> <H2><A HREF="kern_threads.htm#w2PAjbbmanu">Understanding Kernel Threads</A></H2> <H2><A HREF="kern_processes.htm#A23C0f21f">Using Kernel Processes</A></H2> <H2><A HREF="Usermode_in_kern.htm#A23C0f21c">Accessing User-Mode Data While in Kernel Mode</A></H2> <H2><A HREF="locking.htm#xpM180chri">Understanding Locking</A></H2> <H2><A HREF="exception_handling.htm#A23C0f1e1">Understanding Exception Handling</A></H2> <H2><A HREF="64bit_kernex_dev.htm#816971354sls">64-bit Kernel Extension Development </A></H2> <H1><A HREF="system_calls.htm#YRK1350chri">Chapter 2. System Calls</A></H1> <H2><A HREF="syscall_execu.htm#xIj270chri">Understanding System Call Execution</A></H2> <H2><A HREF="syscall_to_kernex.htm#A68C017254">System Calls Available to Kernel Extensions</A></H2> <H1><A HREF="virtual_fsys.htm#A26C01021c">Chapter 3. Virtual File Systems</A></H1> <H2><A HREF="logical_fsys.htm#A26C01022c">Logical File System Overview</A></H2> <H2><A HREF="virtual_fsys_over.htm#A26C010241">Virtual File System Overview</A></H2> <H2><A HREF="datastruc_hdrfiles_virtual.htm#A26C0102a4">Understanding Data Structures and Header Files for Virtual File Systems</A></H2> <H2><A HREF="config_virtual_fsys.htm#A10C0b01d">Configuring a Virtual File System</A></H2> <H1><A HREF="kern_svcs.htm#eOg1b0jean">Chapter 4. Kernel Services</A></H1> <H2><A HREF="iokern_svcs.htm#A8eKc0jean">I/O Kernel Services</A></H2> <H2><A HREF="blockio_cache_kernsvcs_over.htm#qoT370chri">Block I/O Buffer Cache Kernel Services: Overview</A></H2> <H2><A HREF="interrupts.htm#A7C0a521">Understanding Interrupts</A></H2> <H2><A HREF="dma_transfers.htm#A71C0177a6">Understanding DMA Transfers</A></H2> <H2><A HREF="kernex_ddmgmt_kernsvcs.htm#VbK320jean">Kernel Extension and Device Driver Management Kernel Services</A></H2> <H2><A HREF="lock_kernsvcs.htm#KtGHibthom">Locking Kernel Services</A></H2> <H2><A HREF="fdescript_mgmtsvcs.htm#D73A6D9151emil">File Descriptor Management Services</A></H2> <H2><A HREF="logical_fsys_kernex.htm#cfK240jean">Logical File System Kernel Services</A></H2> <H2><A HREF="memory_kernsvcs.htm#A339C966a4">Memory Kernel Services</A></H2> <H2><A HREF="virtualmem_mgr_inter.htm#A91C019ceb">Understanding Virtual Memory Manager Interfaces</A></H2> <H2><A HREF="msgqueue_kernsvcs.htm#q0ifrz4jean">Message Queue Kernel Services</A></H2> <H2><A HREF="network_kernsvcs.htm#A7SZ20jean">Network Kernel Services</A></H2> <H2><A HREF="proc_except_mgmt_kernsvcs.htm#A339C966ad">Process and Exception Management Kernel Services</A></H2> <H2><A HREF="ras_kernsvcs.htm#JSx270jean">RAS Kernel Services</A></H2> <H2><A HREF="security_kernsvcs.htm#A283X918fb">Security Kernel Services</A></H2> <H2><A HREF="timer_tod_kernsvcs.htm#mcI0chris">Timer and Time-of-Day Kernel Services</A></H2> <H2><A HREF="finegran_timersvcs.htm#A275X9361f">Using Fine Granularity Timer Services and Structures</A></H2> <H2><A HREF="multiprocsafe_timersvcs.htm#nT4Ci32fthom">Using Multiprocessor-Safe Timer Services</A></H2> <H2><A HREF="vfs_kernsvcs.htm#vcK100jean">Virtual File System (VFS) Kernel Services</A></H2> <H1><A HREF="async_io_subsys.htm#kVuPp3d1stue">Chapter 5. Asynchronous I/O Subsystem</A></H1> <H2><A HREF="async_io_subsys.htm#overview">Asynchronous I/O Overview</A></H2> <H2><A HREF="async_io_subsys.htm#pre_req">Prerequisites</A></H2> <H2><A HREF="async_io_subsys.htm#A120C113">Functions of Asynchronous I/O</A></H2> <H2><A HREF="async_io_subsys.htm#A106C158f">Asynchronous I/O Subroutines</A></H2> <H2><A HREF="async_io_subsys.htm#A106C159e">Subroutines Affected by Asynchronous I/O</A></H2> <H2><A HREF="async_io_subsys.htm#A163C11cf">Changing Attributes for Asynchronous I/O</A></H2> <H2><A HREF="async_io_subsys.htm#enhance">64-bit Enhancements</A></H2> <H2><A HREF="async_io_subsys.htm#related">Related Information</A></H2> <H1><A HREF="device_config_subsys.htm#A4d56110chri">Chapter 6. Device Configuration Subsystem</A></H1> <H2><A HREF="device_config_db_over.htm#A2sI80jean">Device Configuration Database Overview</A></H2> <H2><A HREF="device_config_procedures_over.htm#uyI370jean">Basic Device Configuration Procedures Overview</A></H2> <H2><A HREF="devconfig_mgr_over.htm#A2fI3a0jean">Device Configuration Manager Overview</A></H2> <H2><A HREF="dev_sub_classes_types_over.htm#nCI310jean">Device Classes, Subclasses, and Types Overview</A></H2> <H2><A HREF="writ_devmethod.htm#A49C013b8e">Writing a Device Method</A></H2> <H2><A HREF="devmethod_interf.htm#A86C0194a6">Understanding Device Methods Interfaces</A></H2> <H2><A HREF="devstates.htm#A86C01949a">Understanding Device States</A></H2> <H2><A HREF="add_unsuppdev_sys.htm#A4ce280jean">Adding an Unsupported Device to the System</A></H2> <H2><A HREF="dev_child_depen.htm#A87C0196ab">Understanding Device Dependencies and Child Devices</A></H2> <H2><A HREF="access_devattrs.htm#A86C0194cf">Accessing Device Attributes</A></H2> <H2><A HREF="dds_over.htm#A8Bg1160mary">Device Dependent Structure (DDS) Overview</A></H2> <H2><A HREF="ls_devconfig_cmds.htm#A234X9159">List of Device Configuration Commands</A></H2> <H2><A HREF="ls_devconfig_subr.htm#A227X922d">List of Device Configuration Subroutines</A></H2> <H1><A HREF="comm_io_subsys.htm#A2C0974f">Chapter 7. Communications I/O Subsystem</A></H1> <H2><A HREF="comm_physdev_hdler_over.htm#A12C0bb35">Communications Physical Device Handler Model Overview</A></H2> <H2><A HREF="stat_comm_dev_hdler_over.htm#A7C0a68a">Status Blocks for Communications Device Handlers Overview</A></H2> <H2><A HREF="mpqpdev_hdler_interover.htm#A14C0c2f7">MPQP Device Handler Interface Overview</A></H2> <H2><A HREF="serial_optical_linkdev_hdler_over.htm#hZt11donna">Serial Optical Link Device Handler Overview</A></H2> <H2><A HREF="config_serial_optical_link_dd.htm#A4423karen">Configuring the Serial Optical Link Device Driver</A></H2> <H2><A HREF="forum_comp_atm_lan_emul_dd.htm#A2ECE008394joyc">Forum-Compliant ATM LAN Emulation Device Driver</A></H2> <H2><A HREF="fddi_dd.htm#E54E1E8965virg">Fiber Distributed Data Interface (FDDI) Device Driver</A></H2> <H2><A HREF="hp8fc8_tokenring_dd.htm#hJaNk126virg">High-Performance (8fc8) Token-Ring Device Driver</A></H2> <H2><A HREF="hp8fa2_tokenring_dd.htm#A2rAQk385virg">High-Performance (8fa2) Token-Ring Device Driver</A></H2> <H2><A HREF="pci_tokenring_dd.htm#gevBm130joyc">PCI Token-Ring High Performance (14101800) Device Driver</A></H2> <h2><a href="ethernet_dd.htm">Ethernet Device Drivers</a></h2> <H1><A HREF="graphic_inputdev_subsys.htm#A1xhJj357bob">Chapter 8. Graphic Input Devices Subsystem</A></H1> <H1><A HREF="lowfunc_term_subsys.htm#CF14BF7988judy">Chapter 9. Low Function Terminal Subsystem</A></H1> <H2><A HREF="lowfunc_terminter_funcdescript.htm#D934A6F558stew">Low Function Terminal Interface Functional Description </A></H2> <H2><A HREF="compon_lowfunc_interf.htm#D934A74173stew">Components Affected by the Low Function Terminal Interface</A></H2> <H2><A HREF="accented_char.htm#A354C988d8">Accented Characters</A></H2> <H1><A HREF="logival_vol_subsys.htm#A156C11f">Chapter 10. Logical Volume Subsystem</A></H1> <H2><A HREF="logical_vol_dd.htm#A156C174">Understanding the Logical Volume Device Driver</A></H2> <H2><A HREF="log_vol_badblks.htm#A156C1bf">Understanding Logical Volumes and Bad Blocks</A></H2> <H2><A HREF="mwcc_ent.htm#A156C1df">Changing the mwcc_entries Variable</A></H2> <H1><A HREF="printer_mgmt_subsys.htm#ujY2a0jean">Chapter 11. Printer Addition Management Subsystem</A></H1> <H2><A HREF="newprint_sys.htm#eVbe0jean">Adding a New Printer Type to Your System</A></H2> <H2><A HREF="printer_def.htm#g1d20jean">Adding a Printer Definition</A></H2> <H2><A HREF="print_format_backend.htm#tyb300jean">Adding a Printer Formatter to the Printer Backend</A></H2> <H2><A HREF="prt_embed_ref.htm#M1e6250chri">Understanding Embedded References in Printer Attribute Strings</A></H2> <H1><A HREF="sm_sysint_subsys.htm#A3DE07B7673janb">Chapter 12. Small Computer System Interface Subsystem</A></H1> <H2><A HREF="scsi_subsys_over.htm#A350C983af"></A>SCSI Subsystem Overview</A></H2> <H2><A HREF="scsi_async.htm#A143C1242">Understanding SCSI Asynchronous Event Handling</A></H2> <H2><A HREF="scsi_error_rec.htm#A24C0f54a">SCSI Error Recovery</A></H2> <H2><A HREF="scsi_trans_sequence.htm#A24C0f571">A Typical Initiator-Mode SCSI Driver Transaction Sequence</A></H2> <H2><A HREF="scsi_dd_cmds.htm#A24C0f54f">Understanding SCSI Device Driver Internal Commands</A></H2> <H2><A HREF="exec_io_reqs.htm#A25C0fd96">Understanding the Execution of Initiator I/O Requests</A></H2> <H2><A HREF="scsi_cmd_tag.htm#A9FDC7E3430raga">SCSI Command Tag Queuing</A></H2> <H2><A HREF="sc_buf.htm#DlM2320chri">Understanding the sc_buf Structure</A></H2> <H2><A HREF="scsi_design.htm#A24C0f578">Other SCSI Design Considerations</A></H2> <H2><A HREF="scsi_target.htm#A140C1938">SCSI Target-Mode Overview</A></H2> <H2><A HREF="scsi_dd_ioctl.htm#A24C0f553">Required SCSI Adapter Device Driver ioctl Commands</A></H2> <h1><a href="fcp.htm">Chapter 13. Fibre Channel Protocol for SCSI Subsystem</a></h1> <h2><a href="fcp_overview.htm">FCP Subsystem Overview</a></h2> <h2><a href="fcp_event.htm">Understanding FCP Asynchronous Event Handling</a></h2> <h2><a href="fcp_error.htm">FCP Error Recovery</a></h2> <h2><a href="fcp_sequence.htm">A Typical Initiator-Mode FCP Driver Transaction Sequence</a></h2> <h2><a href="fcp_internal_commands.htm">Understanding FCP Device Driver Internal Commands</a></h2> <h2><a href="fcp_io.htm">Understanding the Execution of Initiator I/O Requests</a></h2> <h2><a href="fcp_tag.htm">FCP Command Tag Queuing</a></h2> <h2><a href="fcp_scsi_buf.htm">Understanding the scsi_buf Structure</a></h2> <h2><a href="fcp_design.htm">Other FCP Design Considerations</a></h2> <h2><a href="fcp_ioctl_commands.htm">Required FCP Adapter Device Driver ioctl Commands</a></h2> <h1><a href="fcp_drivers.htm">Chapter 14. FCP Device Drivers</a></h1> <H2><A HREF="fcp_drivers.htm#programming">Programming FCP Device Drivers</A></H2> <H2><A HREF="fcp_drivers_overview.htm#overview">FCP Device Driver Overview</A></H2> <H2><A HREF="fcp_drivers_adapter_overview.htm#adapter_overview">FCP Adapter Device Driver Overview</A></H2> <H2><A HREF="fcp_drivers_interface.htm#interface">FCP Adapter/Device Interface</A></H2> <H2><A HREF="fcp_drivers_routines.htm#routines">FCP Adapter Device Driver Routines</A></H2> <H2><A HREF="fcp_drivers_ioctl.htm#ioctl">FCP Adapter ioctl Operations</A></H2> <H1><A HREF="ide_subsys.htm#F953B39893joyc"></A>Chapter 15. Integrated Device Electronics (IDE) Subsystem</A></H1> <H2><A HREF="ide_error.htm#F953B46282joyc">IDE Error Recovery</A></H2> <H2><A HREF="ide_trans_seq.htm#F953B52322joyc">A Typical IDE Driver Transaction Sequence</A></H2> <H2><A HREF="ide_dd_cmds.htm#F953B5E185joyc">IDE Device Driver Internal Commands</A></H2> <H2><A HREF="exec_io_req.htm#F953B6A214joyc">Execution of I/O Requests</A></H2> <H2><A HREF="ataide_buf.htm#F953B76774joyc">ataide_buf Structure</A></H2> <H2><A HREF="ide_design.htm#F953B84925joyc">Other IDE Design Considerations</A></H2> <H2><A HREF="ide_dd_ioctl.htm#F953B92565joyc">Required IDE Adapter Device Driver ioctl Commands</A></H2> <H1><A HREF="serial_direct_storage.htm#dasdkm1"></A>Chapter 16. Serial Direct Access Storage Device Subsystem</A></H1> <h1><a href="debug_tools.htm">Chapter 17. Debugging Tools</a></h1> <H2><A HREF="sys_dump.htm#Yy7nh2cemary">System Dump</A></H2> <H2><A HREF="crash_cmd.htm#dy7nha3mary">The crash Command</A></H2> <h2><a href="lldb.htm">Low Level Kernel Debugger (LLDB)</a></h2> <h2><a href="kdb.htm">KDB Kernel Debugger and Command</a></h2> <H2><A HREF="error_log.htm#jy7nh2f1mary">Error Logging</A></H2> <H2><A HREF="debug_perf_trace.htm#ny7nhd4mary">Debug and Performance Tracing</A></H2> <H2><A HREF="mods.htm#911971500sls">Memory Overlay Detection System (MODS)</A></H2> <H1><A HREF="ls_kern_svcs.htm#CoH3e0chri">Appendix A. Alphabetical List of Kernel Services</A></H1>