ric(9DRV)

NAME | SYNOPSIS | FEATURES | DESCRIPTION | ATTRIBUTES

NAME

ric- Sun reset, interrupt and clock controller

SYNOPSIS

drv_f/src/pci/ric/ric.c			- driver code
drv_f/src/pci/ric/ricProp.h		- driver specific properties

FEATURES

DRV

DESCRIPTION

The ric driver implements a ric device specific interface.

This driver implements the ric device specific interrupt handling interface for the Sun UltraSPARC II CPU using the kernel's UltraSPARC-specific dki interface.

The ric driver does not provide the drv_probe() routine. In other words, the ric driver does not enumerate the bus nor does it detect a ric device or create an associated device node. When the ric driver is used, associated device nodes should be created either statically by a boot program or dynamically by a separate bus enumerator driver. Such an enumerator driver could be developed for the particular bus architecture.

The ric driver provides the drv_bind() routine. This routine examines the device node name property (PROP_NODE) in order to recognize a ric compatible device. The routine checks whether the device node name matches a pre-defined device name. If the check is positive, the drv_bind() routine binds the driver to the device node attaching a PROP_DRIVER property to the device node. The property value specifies the ric driver name. The parent bus driver uses such a property to determine the name of the driver servicing the device. In other words, via the PROP_DRIVER property, the driver gives its name to the parent bus driver asking it to invoke the drv_init() routine on that device. Note that the drv_bind() routine does nothing if a PROP_DRIVER property is already present in the device node., so the drv_bind routine does not override existing driver-to-device binding.

The driver does not implement the drv_unload()entry. This means that the driver component cannot be unloaded even if it has been dynamically loaded at run time.

The table below summarizes characteristics of the ric pci bus driver.

driver name:	"sun:usparc-ric-ric"
hardware:	Sun ric controller
exported interface:	"ric" (RIC_CLASS)
exported interface version:	0 (RIC_VERSION_INITIAL)
imported parent interface:	"usparc" (FDKI_CLASS)
minimal parent interface version:	0 (PCI_VERSION_INITIAL)
device probing (auto-detection):	not supported
driver unloading:	not supported
system (emergency) shut-down:	supported
normal device shut-down:	not supported
hot-plug (surprise) device removal:	not supported

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

NAME | SYNOPSIS | FEATURES | DESCRIPTION | ATTRIBUTES