open(D2sdi)

open -- initiate Host Bus Adapter pass-through access

Synopsis (HBA)

int prefixopen(dev_t *devp, int flags, int otype, cred_t *cred_t);

Synopsis (Target drivers)

See open(D2) for synopsis and general usage information about this entry point in target and layered drivers.

Description

Arguments

devp: Pointer to the device number.
flags: Flags for open.
otype: Type of open.
cred_t: Credential pointer of the opening process.

Return values

On success, open( ) returns 0. On failure, it returns the approprate error number corresponding to the failure.

Usage

The open( ) entry point routine in an HBA driver provides pass-through access to a peripheral device attached to a HBA. The pass-through mechanism allows an application to have direct access to SDI devices.

This mechanism provides exclusive access to a device. For this reason, the pass-through open( ) routine must verify that the device being requested is valid, and that no other requests are pending for the device.

Target drivers that call the DDI 8 style open( ) routine must also include a devinfo(D2sdi) routine.

Context and synchronization

Blockable context. The driver can block but cannot do operations such as copyout(D3) that require access to the requesting process's address space.

Applicable hardware

All

Version applicability

sdi: 1, 2, 3, 4 HBA drivers.