This Device Driver Tutorial is a hands-on guide that shows you how to develop a simple device driver for the Solaris Operating System (Solaris OS). Device Driver Tutorial also explains how device drivers work in the Solaris OS. This book is a companion to Writing Device Drivers. Writing Device Drivers is a thorough reference document that discusses many types of devices and drivers. Device Driver Tutorial examines complete drivers but does not provide a comprehensive treatment of all driver types. Device Driver Tutorial often points to Writing Device Drivers and other books for further information.This Solaris release supports systems that use the SPARC and x86 families of processor architectures: UltraSPARC, SPARC64, AMD64, Pentium, and Xeon EM64T. The supported systems appear in the Solaris OS Hardware Compatibility Lists at . This document cites any implementation differences between the platform types. SX build 102: Added quiesce(9E) in dev_ops(9S).SX build 89: Noted that configuration files are no longer needed for x86 drivers.SXDE 9/07: Fixed CR 6573163: remove references to /usr/ccs/bin. Updated compile options for Sun Studio 12.SXDE 2/07: Fixed CR 6495598: incorrect arguments used in ddi_soft_state_free. Added description of deadman to testing section. You should read this tutorial if you need to develop, install, and configure device drivers for the Solaris OS. You also should read this book if you need to maintain existing drivers or add new functionality to existing Solaris OS drivers. Information about the kernel provided in this book also will help you troubleshoot any problems you might encounter installing or configuring Solaris systems. To write device drivers for the Solaris OS, you should have the following background:Be a confident C programmer Have experience with data structures, especially with linked lists Understand bit operations Understand indirect function calls Understand caching Understand multithreading (see the Multithreaded Programming Guide) Be familiar with a UNIX shell Understand the basics of UNIX system and I/O architecture The most important information you need to have to write a device driver are the characteristics of the device. Get a detailed specification for the device you want to drive.Experience with Solaris OS compilers, debuggers, and other tools will be very helpful to you. You also need to understand where the file system fits with the kernel and the application layer. These topics are discussed in this tutorial. This book is organized into the following chapters:Chapter 1, Introduction to Device Drivers provides an overview of the Solaris Operating System and kernel. This chapter also discusses the driver development environment and tools.Chapter 2, Template Driver Example shows a simple template driver. This chapter shows in detail the steps to develop, build, install, load, and test this simple driver.Chapter 3, Reading and Writing Data in Kernel Memory describes how to develop a driver that reads data from and writes data to kernel memory.Chapter 4, Tips for Developing Device Drivers discusses some common errors in driver development and how to avoid them or handle them. This chapter also introduces driver analysis and debugging tools. For detailed reference information about the device driver interfaces, see the section 9 man pages. Section 9E, Intro9E, describes DDI/DKI (Device Driver Interface, Driver-Kernel Interface) driver entry points. Section 9F, Intro9F, describes DDI/DKI kernel functions. Sections 9P and 9S, Intro9S, describe DDI/DKI properties and data structures.For information on other driver-related tools and issues, see these books from Sun Microsystems:Writing Device Drivers. Sun Microsystems, Inc., 2008. Multithreaded Programming Guide. Sun Microsystems, Inc., 2008. STREAMS Programming Guide. Sun Microsystems, Inc., 2005. Solaris 64-bit Developer’s Guide. Sun Microsystems, Inc., 2005. Sun Studio 12: C User’s Guide. Sun Microsystems, Inc., 2007.Click Sun Studio 12 Collection at the top left of this page to see Sun Studio books about dbx, dmake, Performance Analyzer, and other software development topics. Solaris Modular Debugger Guide. Sun Microsystems, Inc., 2008. Solaris Dynamic Tracing Guide. Sun Microsystems, Inc., 2007. DTrace User Guide. Sun Microsystems, Inc., 2006. System Administration Guide: Devices and File Systems. Sun Microsystems, Inc., 2008. Application Packaging Developer’s Guide. Sun Microsystems, Inc., 2005. &sundocs;&typeconv;