User Guide

Ampex 1308904-X4 Preliminary Draft 2-1
ACL Application Programmer’s Guide ACL Software Overview
Section 2
ACL Software Overview
2.1 Introduction
This section provides a general overview of the host system device driver interface, the libacl
API functions, and the ACL Management Utilities. Table 2-1 shows the ACL operations
performed by the
libacl functions and the Management Utilities.
2.2 The Ampex Automated Cartridge Library Device Driver
The ACL device driver is a standard UNIX device driver which implements a pass-through
access via the DSTIOCPASSTHRU
ioctl. The ACL device driver provides an interface
through which programs can operate an ACL.
2.3 Native Device Drivers
Some platforms supported by the DST/DIS host system software have their own SCSI
passthru driver interfaces. The
libacl API provides access to these driver interfaces when
available. See the
DST/DIS Software Installation Guide for your host operating system for
more information.
Table 2-1. ACL Operations
Operation libacl API Function ACL Utility Usage
Get status of specified
element.
aclAuditElement() acl_audit_element See “Read Element Status” on
page 3-11.
Get status of all
elements.
aclAuditLibrary() acl_audit_library See “Read Element Status” on
page 3-11.
Issue SCSI command. aclGeneric() N/A See “SCSI Commands” on page
3-1.
Get element count and
addresses.
aclGetElemData() N/A See “Element SCSI Addresses”
on page 3-2.
Retrieve the error or
event log.
aclGetErrorLog() acl_errlog_library See “Internal Logs” on page
3-13.