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