DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

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.

See Also

close(D2sdi), devinfo(D2sdi), ioctl(D2sdi), open(D2)

``SDI pass-through interface'' in HDK Technical Reference


19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005