User Guide

Ampex 1308904-X4 Preliminary Draft 4-33

ACL Application Programmer’s Guide aclRelease

4.16 aclRelease

NAME

aclRelease() - release a previously reserved ACL so that another SCSI initiator can use it.

SYNOPSIS

#include <acl.h>

int aclRelease(char *device, int tpr, int tpdid);

DESCRIPTION

aclRelease() releases a previously reserved ACL from the speciﬁed initiator. This function,

along with the aclReserve() function, provides a mechanism to obtain exclusive access to the

ACL when it is connected to multiple initiators.

aclRelease() is available to all users.

PARAMETERS

*device Pointer or string specifying the device special ﬁle associated with the

ACL.

*tpr When set to zero, releases any outstanding reservation made by the

initiator issuing the aclRelease() function—which was not a 3rd party

reservation.

When set to one, releases any outstanding reservation made by the

initiator issuing the aclRelease() function—which was a 3rd party

reservation on behalf of the same device speciﬁed by the 3rd Party

Device ID (tpdid parameter).

tpdid Third Party SCSI Device ID (0 -7) of the initiator reserving the ACL.

This parameter is ignored when the tpr parameter is zero

ENVIRONMENT

When the $RETRY_ON_RESET environment variable is set, all libacl functions

automatically perform one retry when a failure is caused by a SCSI Bus Device Reset of the

ACL.