User Guide

4-38 Preliminary Draft Ampex 1308904-X4
Model No.
Running Head
aclRezero ACL Application Programmer’s Guide
4.19 aclRezero
NAME
aclRezero() - reset the ACL and ensure that element status is current in the internal database.
SYNOPSIS
#include <acl.h>
int aclRezero(char *device);
DESCRIPTION
aclRezero() resets the ACL cartridge handling system and directs the ACL to check element
status. If a discrepancy is found, the ACL re-initializes to update its internal database.
aclRezero() is available to all users.
PARAMETERS
*device Pointer or string specifying the device special file associated with the
ACL.
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.
RETURN VALUES
Exit status codes are:
0 DST_SUCCESS.
-1 DST_FAILURE.
SEE ALSO
libacl_api_intro(3)
DST/DIS Automated Cartridge Library Application Programming Interface (libacl)
Programmer’s Guide