JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Device Driver Tutorial     Oracle Solaris 11.1 Information Library
search filter icon
search icon

Document Information

Preface

1.  Introduction to Device Drivers

2.  Template Driver Example

3.  Reading and Writing Data in Kernel Memory

4.  Tips for Developing Device Drivers

Index

Preface

This Device Driver Tutorial is a hands-on guide that shows you how to develop a simple device driver for the Oracle Solaris Operating System (Oracle Solaris OS). Device Driver Tutorial also explains how device drivers work in the Oracle 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.


Note - This Oracle Solaris release supports systems that use the SPARC and x86 families of processor architectures. The supported systems appear in the Oracle Solaris OS: Hardware Compatibility Lists. This document cites any implementation differences between the platform types.

In this document, these x86 related terms mean the following:

For supported systems, see the Oracle Solaris OS: Hardware Compatibility Lists.


Who Should Use This Book

You should read this tutorial if you need to develop, install, and configure device drivers for the Oracle Solaris OS. You also should read this book if you need to maintain existing drivers or add new functionality to existing Oracle Solaris OS drivers. Information about the kernel provided in this book also will help you troubleshoot any problems you might encounter installing or configuring Oracle Solaris systems.

User Background

To write device drivers for the Oracle Solaris OS, you should have the following background:

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 Oracle 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.

How This Book Is Organized

This book is organized into the following chapters:

Chapter 1, Introduction to Device Drivers provides an overview of the Oracle 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.

Related Books

For detailed reference information about the device driver interfaces, see the section 9 man pages. Section 9E, Intro(9E), describes DDI/DKI (Device Driver Interface, Driver-Kernel Interface) driver entry points. Section 9F, Intro(9F), describes DDI/DKI kernel functions. Sections 9P and 9S, Intro(9S), describe DDI/DKI properties and data structures.

For information on other driver-related tools and issues, see these books from Oracle Corporation:

Access to Oracle Support

Oracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

Typographic Conventions

The following table describes the typographic conventions that are used in this book.

Table P-1 Typographic Conventions

Typeface
Description
Example
AaBbCc123
The names of commands, files, and directories, and onscreen computer output
Edit your .login file.

Use ls -a to list all files.

machine_name% you have mail.

AaBbCc123
What you type, contrasted with onscreen computer output
machine_name% su

Password:

aabbcc123
Placeholder: replace with a real name or value
The command to remove a file is rm filename.
AaBbCc123
Book titles, new terms, and terms to be emphasized
Read Chapter 6 in the User's Guide.

A cache is a copy that is stored locally.

Do not save the file.

Note: Some emphasized items appear bold online.

Shell Prompts in Command Examples

The following table shows UNIX system prompts and superuser prompts for shells that are included in the Oracle Solaris OS. In command examples, the shell prompt indicates whether the command should be executed by a regular user or a user with privileges.

Table P-2 Shell Prompts

Shell
Prompt
Bash shell, Korn shell, and Bourne shell
$
Bash shell, Korn shell, and Bourne shell for superuser
#
C shell
machine_name%
C shell for superuser
machine_name#