Writing Device Drivers


D

	data alignment for SPARC ( )

	data corruption
		control data ( )
		detecting ( )
		device management data ( )
		malignant, definition of ( )
		misleading, definition of ( )
		of received data ( )

	data sharing
		using `devmap()` ( )
		using `ioctl()` ( )
		using `mmap()` ( )

	data storage classes ( )

	data structures
		`dev_ops` structure ( )
		GLDv2 ( ) ( )
		`modldrv` structure ( )

	data transfers, character drivers ( )

	`ddi_cb_register()` function ( )

	`ddi_cb_unregister()` function ( )

	DDI-compliant drivers
		byte ordering ( )
		compliance testing ( )

	`ddi_create_minor_node()` function ( )

	`ddi_device_acc_attr` structure ( )

	`ddi_device_copy()` function ( )

	`ddi_device_zero()` function ( )

	`ddi_devid_free()` function ( )

	DDI/DKI
		See also LDI
		design considerations ( )
		and disk performance ( )
		overview ( )
		purpose in kernel ( )

	`ddi_dma_attr` structure ( ) ( ) ( )

	`ddi_dma_cookie` structure ( )

	`ddi_dma_getwin()` function ( )

	`ddi_dma_mem_alloc()` function ( )

	`ddi_dma_nextseg()` function ( )

	`ddi_dma_sync()` function ( ) ( )

	`ddi_driver_major()` function ( ) ( )

	`ddi_enter_critical()` function ( )

	`ddi_eventcookie_t` ( )

	`ddi_fm_acc_err_clear()` function ( )

	`ddi_fm_acc_err_get()` function ( ) ( )

	`ddi_fm_capable()` function ( )

	`ddi_fm_dma_err_clear()` function ( )

	`ddi_fm_dma_err_get()` function ( )

	`ddi_fm_ereport_post()` function ( ) ( )

	`ddi_fm_error` structure ( ) ( ) ( )

	`ddi_fm_fini()` function ( )

	`ddi_fm_handler_register()` function ( ) ( )

	`ddi_fm_handler_unregister()` function ( )

	`ddi_fm_init()` function ( )

	`ddi_fm_service_impact()` function ( )

	DDI function tables ( )

	`ddi_get()X` functions ( ) ( )

	`ddi_get_cred()` function ( ) ( )

	`ddi_get_driver_private()` function ( ) ( )

	`ddi_get_instance()` function ( )

	`ddi_get_lbolt()` function ( )

	`ddi_get_pid()` function ( )

	`ddi_get_time()` function ( )

	`DDI_INFO_DEVT2DEVINFO` ( )

	`DDI_INFO_DEVT2INSTANCE` ( )

	`ddi_intr_add_handler()` function ( ) ( ) ( )

	`ddi_intr_add_softint()` function ( )

	`ddi_intr_alloc()` function ( ) ( ) ( )

	`ddi_intr_block_disable()` function ( )

	`ddi_intr_block_enable()` function ( )

	`DDI_INTR_CLAIMED` ( )

	`ddi_intr_clr_mask()` function ( ) ( )

	`ddi_intr_disable()` function ( ) ( )

	`ddi_intr_dup_handler()` function ( ) ( )

	`ddi_intr_enable()` function ( ) ( )

	`ddi_intr_free()` function ( ) ( )

	`ddi_intr_get_cap()` function ( )

	`ddi_intr_get_hilevel_pri()` function ( ) ( )

	`ddi_intr_get_navail()` function ( )

	`ddi_intr_get_nintrs()` function ( )

	`ddi_intr_get_pending()` function ( ) ( )

	`ddi_intr_get_pri()` function ( ) ( )

	`ddi_intr_get_softint_pri()` function ( )

	`ddi_intr_get_supported_types()` function ( )

	`ddi_intr_hilevel()` function ( )

	`ddi_intr_remove_handler()` function ( ) ( )

	`ddi_intr_remove_softint()` function ( )

	`ddi_intr_set_cap()` function ( )

	`ddi_intr_set_mask()` function ( ) ( )

	`ddi_intr_set_nreq()` function ( )

	`ddi_intr_set_pri()` function ( )

	`ddi_intr_set_softint_pri()` function ( ) ( )

	`ddi_intr_trigger_softint()` function ( ) ( )

	`DDI_INTR_UNCLAIMED` ( )

	`ddi_log_sysevent()` function ( ) ( )

	`ddi_model_convert_from()` function ( )

	`ddi_peek()` function ( )

	`ddi_poke()` function ( )

	`ddi_prop_free()` function ( )

	`ddi_prop_get_int()` function ( )

	`ddi_prop_lookup()` function ( )

	`ddi_prop_lookup_string()` function ( )

	`ddi_prop_op()` function ( )

	`ddi_ptob()` function ( )

	`ddi_put()X` functions ( ) ( )

	`ddi_regs_map_setup()` function ( ) ( ) ( ) ( )

	`ddi_removing_power()` function ( )

	`ddi_rep_get()X` functions ( )

	`ddi_rep_put()X` functions ( )

	`DDI_RESUME`, `detach()` function ( )

	`ddi_set_driver_private()` function ( )

	`DDI_SUSPEND`, `detach()` function ( )

	`ddi_umem_alloc()` function ( ) ( )

	`ddi_umem_free()` function ( )

	DDX module ( )

	DE (diagnosis engine), definition ( )

	deadman kernel feature ( )

	`DEBUG` symbol ( ) ( )

	debugging
		`ASSERT()` macro ( )
		booting an alternate kernel ( )
		coding hints ( )
		common tasks ( )
		conditional compilation ( )
		console frame buffer drivers ( )
		`DEBUG` symbol ( )
		detecting kernel memory leaks ( )
		displaying kernel data structures ( )
		`system` file ( )
		`kmdb` debugger ( )
		`kmem_flags` ( )
		`mdb` debugger ( )
		`moddebug` ( )
		postmortem ( )
		preparing for disasters ( )
		setting up a serial connection ( )
		setting up a SPARC test system ( )
		setting up an x86 test system ( )
		system registers ( )
		tools ( )
		using kernel variables ( )
		using the SPARC PROM for device debugging ( )
		writing `mdb` commands ( )

	`delay()` function ( )
		changes to ( )

	dependency ( )

	deprecated device access functions ( )

	deprecated DMA functions ( )

	deprecated interrupt functions ( )

	deprecated memory allocation functions ( )

	deprecated power management functions ( )

	deprecated programmed I/O functions ( )

	deprecated property functions ( )

	deprecated SCSI functions ( )

	deprecated time-related functions ( )

	deprecated user application kernel functions ( )

	deprecated user process information functions ( )

	deprecated user space access functions ( )

	deprecated virtual memory functions ( )

	descriptor tree ( ) ( )

	`dest_adcent` argument, `ddi_device_copy()`, changes to ( )

	`detach()` entry point
		active power management ( )
		description of ( )
		hot removal ( )
		network drivers ( )
		system power management ( )

	detecting kernel memory leaks with `mdb` ( )

	`dev_advcnt` argument, `ddi_device_zero()`, changes to ( )

	`dev_datasz` argument, `ddi_device_copy()`, changes to ( )

	`dev_datasz` argument, `ddi_device_zero()`, changes to ( )

	`dev_info_t` functions ( )

	`dev_ops` structure, description of ( )

	`dev_t` functions ( )

	`devfsadm` command ( )

	device
		alternate settings ( )
		composite ( ) ( )
		configurations ( )
		endpoints ( )
		interface number ( )
		interfaces ( )
		quiesce ( )
		resume ( )
		splitting interfaces ( ) ( )

	device access functions
		block drivers ( )
		character drivers ( )
		deprecated ( )
		table ( )

	device configuration, entry points ( )

	device context management ( )
		entry points ( )
		model ( )
		operation ( )

	device-dependency, `power.conf` entry ( )

	device-dependency-property, `power.conf` entry ( )

	device directory, recovering ( )

	device drivers
		See also compiling drivers
		See also linking drivers
		See also loading drivers
		64-bit drivers ( ) ( )
		access from within kernel ( )
		aliases ( )
		binding to device node ( ) ( )
		bindings ( )
		block driver ( )
		configuration descriptor clouds ( )
		context ( )
		debugging ( )
			coding hints ( )
			setting up a serial connection ( )
			tools ( )
			using the PROM ( )
		definition ( )
		entry points ( )
		error handling ( )
		header files ( )
		`hubd` USB hub driver ( )
		loadable interface ( )
		modifying information with `update_drv` ( )
		modifying permissions ( )
		module configuration ( )
		network drivers ( )
		offlining ( ) ( )
		packaging ( )
		printing messages ( )
		purpose in kernel ( )
		source files ( )
		standard character driver ( )
		testing ( ) ( )
		tuning ( )
		USB driver ( )
		`usb_mid` USB multi-interface driver ( ) ( ) ( )
		using kstats ( )

	device ID functions ( )

	device information
		binding a driver to a device ( )
		binding a driver to a USB device ( )
		compatible device names ( )
		`di_link_next_by_lnode()` function ( )
		`di_link_next_by_node()` function ( )
		`di_link_private_get()` function ( )
		`di_link_private_set()` function ( )
		`di_link_spectype()` function ( )
		`di_link_t` ( )
		`di_link_to_lnode()` function ( )
		`di_lnode_devinfo()` function ( )
		`di_lnode_devt()` function ( )
		`di_lnode_name()` function ( )
		`di_lnode_next()` function ( )
		`di_lnode_private_get()` function ( )
		`di_lnode_private_set()` function ( )
		`di_lnode_t` ( )
		`di_node_t` ( )
		`di_walk_link()` function ( )
		`di_walk_lnode()` function ( )
		`DINFOLYR` ( )
		LDI ( )
		lnode ( )
		`nblocks` property ( )
		`Nblocks` property ( )
		property values ( )
		self-identifying ( )
		tree structure ( ) ( )

	device instances ( )

	device interrupts, See interrupts; interrupt handling

	device layering, See LDI

	device memory
		`D_DEVMAP` flag in `cb_ops` ( )
		mapping ( ) ( )

	device node ( )

	device number, description of ( )

	device polling ( )
		in character drivers ( )
		`chpoll()` function ( )
		`poll()` function ( )

	device power management
		components ( )
		definition of ( )
		dependency ( )
		entry points ( )
		interfaces ( )
		model ( )
		`pm_busy_component()` function ( ) ( ) ( ) ( )
		`pm_idle_component()` function ( ) ( ) ( ) ( ) ( )
		`pm_lower_power()` function ( ) ( )
		`pm_raise_power()` function ( ) ( ) ( ) ( ) ( )
		`power()` entry point ( ) ( )
		`power()` function ( )
		power levels ( )
		state transitions ( )
		`usb_create_pm_components()` function ( )
		USB devices ( )

	device registers, mapping ( )

	device state in power management ( )

	device tree
		displaying ( )
		navigating, in debugger ( )
		overview ( )
		purpose in kernel ( )

	device usage ( )
		See LDI

	`/devices` directory
		description of ( )
		displaying the device tree ( )

	devinfo tree ( )

	`devmap_` entry point, `devmap_access()` function ( )

	`devmap_` entry points
		`devmap()` function ( )
		`devmap_access()` function ( )
		`devmap_contextmgt()`function ( )
		`devmap_dup()` function ( )
		`devmap_map()` function ( )
		`devmap_unmap()` function ( )

	`devmap_` functions
		`devmap_devmem_setup()` function ( )
		`devmap_load()` function ( )
		`devmap_umem_setup()` function ( )
		`devmap_unload()` function ( )

	diagnosis engine, definition ( )

	`.dict` dictionary files ( )

	disaster recovery ( )

	disk
		I/O controls ( )
		performance ( )

	disk driver testing ( )

	DKI, See DDI/DKI

	`DL_ETHER`, network statistics ( )

	`DLIOCRAW`, `ioctl()` function ( )

	DLPI (Data Link Provider Interface), See network drivers, GLDv2

	DLPI primitives, `DL_GET_STATISTICS_REQ` ( )

	DMA
		buffer allocation ( )
		burst sizes ( )
		callbacks ( )
		cookie ( ) ( )
		freeing handle ( )
		freeing resources ( )
		handle ( ) ( ) ( )
		object ( )
		object locking ( )
		operations ( )
		physical addresses ( )
		private buffer allocation ( )
		register structure ( )
		resource allocation ( )
		restrictions ( )
		transfers ( ) ( )
		virtual addresses ( )
		windows ( ) ( )

	DMA functions ( )
		deprecated ( )

	driver binding name ( )

	`driver.conf` files, See hardware configuration files

	driver instances ( )

	driver module entry points, See entry points

	drivers, requests from user applications ( )

	`drv_getparm()` function, changes to ( )

	`drv_usecwait(9F)` ( )

	DTrace
		definition ( )
		task queues ( )

	`dump()` entry point, block drivers ( )

	DVMA
		SBus slots supporting ( )
		virtual addresses ( )

	dynamic memory allocation ( )