Intro, intro - introduction to kernel data structures

---

DESCRIPTION

Section 9S describes the data structures used by drivers to share information between the driver and the kernel.

In this section, reference pages contain the following headings:

• NAME summarizes the structure's purpose.
• SYNOPSIS lists the include file that defines the structure.
• INTERFACE LEVEL describes any architecture dependencies.
• DESCRIPTION provides general information about the structure.
• STRUCTURE MEMBERS lists all accessible structure members.
• SEE ALSO gives sources for further information.

Every driver MUST include <sys/ddi.h> and <sys/sunddi.h>, in that order, and last.

The following table summarizes the STREAMS structures described in this section.

Structure Type

copyreq DDI/DKI
copyresp DDI/DKI
datab DDI/DKI
fmodsw Solaris DDI
free_rtn DDI/DKI
iocblk DDI/DKI
linkblk DDI/DKI
module_info DDI/DKI
msgb DDI/DKI
qband DDI/DKI
qinit DDI/DKI
queclass Solaris DDI
queue DDI/DKI
streamtab DDI/DKI
stroptions DDI/DKI

The following table summarizes structures that are not specific to STREAMS I/O.

Structure Type

aio_req Solaris DDI
buf DDI/DKI
cb_ops Solaris DDI
ddi_device_acc_attr Solaris DDI
ddi_dma_attr Solaris DDI
ddi_dma_cookie Solaris DDI
ddi_dma_lim_sparc Solaris SPARC DDI
ddi_dma_lim_x86 Solaris x86 DDI
ddi_dma_req Solaris DDI
ddi_dmae_req Solaris x86 DDI
ddi_idevice_cookie Solaris DDI
ddi_mapdev_ctl Solaris DDI
dev_ops Solaris DDI
iovec DDI/DKI
kstat Solaris DDI
kstat_intr Solaris DDI
kstat_io Solaris DDI
kstat_named Solaris DDI
map DDI/DKI
modldrv Solaris DDI
modlinkage Solaris DDI
modlstrmod Solaris DDI
scsi_address Solaris DDI
scsi_arq_status Solaris DDI
scsi_device Solaris DDI
scsi_extended_sense Solaris DDI
scsi_hba_tran Solaris DDI
scsi_inquiry Solaris DDI
scsi_pkt Solaris DDI
scsi_status Solaris DDI
uio DDI/DKI

NOTES

Do not declare arrays of structures as the size of the structures may change between releases. Rely only on the structure members listed in this chapter and not on unlisted members or the position of a member in a structure.

LIST OF STRUCTURES

Name

Description

aio_req.9s

asynchronous I/O request structure

buf.9s

block I/O data transfer structure

cb_ops.9s

character/block entry points structure

copyreq.9s

STREAMS data structure for the M_COPYIN and the M_COPYOUT message types

copyresp.9s

STREAMS data structure for the M_IOCDATA message type

datab.9s

STREAMS message data structure

ddi_device_acc_attr.9s

data access attributes structure

ddi_dma_attr.9s

DMA attributes structure

ddi_dma_cookie.9s

DMA address cookie

ddi_dmae_req.9s

DMA engine request structure

ddi_dma_lim(9S)

See ddi_dma_lim_sparc.9s

ddi_dma_lim_sparc.9s

SPARC DMA limits structure

ddi_dma_lim_x86.9s

x86 DMA limits structure

ddi_dma_req.9s

DMA Request structure

ddi_idevice_cookie.9s

device interrupt cookie

ddi_mapdev_ctl.9s

device mapping-control structure

dev_ops.9s

device operations structure

fmodsw.9s

STREAMS module declaration structure

free_rtn.9s

structure that specifies a driver's message freeing routine

iocblk.9s

STREAMS data structure for the M_IOCTL message type

iovec.9s

data storage structure for I/O using uio

kstat.9s

kernel statistics structure

kstat_intr.9s

structure for interrupt kstats

kstat_io.9s

structure for I/O kstats

kstat_named.9s

structure for named kstats

linkblk.9s

STREAMS data structure sent to multiplexor drivers to indicate a link

modldrv.9s

linkage structure for loadable drivers

modlinkage.9s

module linkage structure

modlstrmod.9s

linkage structure for loadable STREAMS modules

module_info.9s

STREAMS driver identification and limit value structure

msgb.9s

STREAMS message block structure

qband.9s

STREAMS queue flow control information structure

qinit.9s

STREAMS queue processing procedures structure

queclass.9s

a STREAMS macro that returns the queue message class definitions for a given message block

queue.9s

STREAMS queue structure

scsi_address.9s

SCSI address structure

scsi_arq_status.9s

SCSI auto request sense structure

scsi_device.9s

SCSI device structure

scsi_extended_sense.9s

SCSI extended sense structure

scsi_hba_tran.9s

SCSI Host Bus Adapter (HBA) driver transport vector structure

scsi_inquiry.9s

SCSI inquiry structure

scsi_pkt.9s

SCSI packet structure

scsi_status.9s

SCSI status structure

streamtab.9s

STREAMS entity declaration structure

stroptions.9s

options structure for M_SETOPTS message

uio.9s

scatter/gather I/O request structure

Created by unroff & hp-tools. © by Hans-Peter Bischof. All Rights Reserved (1997).

Last modified 21/April/97