sdi_access(D3I) sdi_access(D3I)
NAME
sdi_access - claim or release ownership of a given device
SYNOPSIS
#include <sys/sdi.h>
int sdi_access(struct sdi_edt *edtp, int access, struct owner *owner);
Arguments
edtp Pointer to the Equipped Device Table entry associated
with the device.
access
Flag indicating whether ownership is to be claimed or
released.
owner Defines the owner for the device [see owner(D4I)].
DESCRIPTION
If the requested device is currently claimed by a target
driver, sdi_access refuses any requests to add the device to
an owner list and any attempts to claim the device.
Return Values
On success, sdi_access returns SDI_RET_OK, indicating that the
access is allowed and has been set up. On failure, it returns
SDI_RET_ERR, indicating the requested access is not allowed.
USAGE
sdi_access is used internally by SDI to claim and release
ownership of devices on target driver's behalf.
Following are the values the access field can take:
SDI_CLAIM
Claim a device for driver access
SDI_ADD
Add an owner block to the target driver's list
SDI_DISCLAIM
Release a claim to a device
SDI_REMOVE
Remove the driver from owner list
Copyright 1994 Novell, Inc. Page 1
sdi_access(D3I) sdi_access(D3I)
If the device is not currently claimed by a target driver,
sdi_access:
1. Adds the device to the calling target driver's list for
SDI_ADD requests
2. Makes the device the target driver's current drive for
SDI_CLAIM requests
Level
Base only.
REFERENCES
owner(D4I)
NOTICES
Applicability
sdi: 1, 2
Copyright 1994 Novell, Inc. Page 2