JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Writing Device Drivers     Oracle Solaris 10 1/13 Information Library
search filter icon
search icon

Document Information


Part I Designing Device Drivers for the Oracle Solaris Platform

1.  Overview of Oracle Solaris Device Drivers

2.  Oracle Solaris Kernel and Device Tree

3.  Multithreading

4.  Properties

5.  Managing Events and Queueing Tasks

6.  Driver Autoconfiguration

7.  Device Access: Programmed I/O

8.  Interrupt Handlers

9.  Direct Memory Access (DMA)

10.  Mapping Device and Kernel Memory

11.  Device Context Management

12.  Power Management

13.  Hardening Oracle Solaris Drivers

14.  Layered Driver Interface (LDI)

Part II Designing Specific Kinds of Device Drivers

15.  Drivers for Character Devices

16.  Drivers for Block Devices

17.  SCSI Target Drivers

18.  SCSI Host Bus Adapter Drivers

19.  Drivers for Network Devices

20.  USB Drivers

21.  SR-IOV Drivers

Introduction to SR-IOV

Benefits of SR-IOV

Supported Platforms


Overview of SR-IOV Device Driver

Physical Function (PF) Driver

Virtual Function (VF) Driver

Device Configuration Parameters

pci.conf File

Setting Device Configuration Parameters

SR-IOV Configuration on Sparc OVM Platform

SR-IOV Configuration on Bare Metal Platforms

Boot Configuration Sequence

SR-IOV Interfaces Summary

Driver Ioctls

Interfaces for SR-IOV Drivers

pci_param_get() Interface

pci_param_get_ioctl() Interface

pci_plist_get() Interface

pci_plist_getvf() Interface

pciv_vf_config() Interface

pci_plist_lookup() Interface

pci_param_free() Interface

pciv_send() Interface

SR-IOV Driver Ioctls

Data Structures

iov_param_ver_info Structure

iov_param_validate Structure

iov_param_desc Structure




Driver Callbacks

Sample Code for Driver Ioctls

Part III Building a Device Driver

22.  Compiling, Loading, Packaging, and Testing Drivers

23.  Debugging, Testing, and Tuning Device Drivers

24.  Recommended Coding Practices

Part IV Appendixes

A.  Hardware Overview

B.  Summary of Solaris DDI/DKI Services

C.  Making a Device Driver 64-Bit Ready

D.  Console Frame Buffer Drivers

E.  pci.conf File


SR-IOV Interfaces Summary

The following table lists the Oracle Solaris interfaces that are available to the SR-IOV drivers. The interfaces are called to obtain PF and VF parameters, to configure VFs, and to export the configuration parameters to any calling applications.

Note - All the interfaces listed in the table with the exception of pciv_send() are applicable only for PF drivers.

Table 21-2 Interfaces for SR-IOV Drivers

Interface Name
Used by PCI device drivers to get the name-value pair list of the currently configured parameters
Must be called by the device driver after they have obtained the device parameters by using the param handle. This call frees up the resources allocated by the pci_param_get() and pci_param_get_ioctl() interfaces.
Used by the SR-IOV device drivers to get the name-value pair list for the PF devices.
Used by the SR-IOV device drivers to get the name-value pair list for the VF devices.
A helper function to SR-IOV device drivers to extract the parameters for the PF and VF devices from the arg argument if the drivers implement the ioctl IOV_VALIDATE_PARAM.
Used by PF drivers to obtain VF configuration parameters and to configure their VFs.
Used to obtain the parameters for PF and VF from the list obtained from the pci_plist_get() and pci_plist_getvf() interfaces.
Used by the PF and VF drivers to transmit information.
Callback registration mechanism interfaces.

Driver Ioctls

The SR-IOV driver ioctls are used to identify the device–specific parameters that can be configured by the administrator and to validate a specific configuration before it is applied. The following ioctls and their data structures are defined.