User Guide

Ampex 1308904-X4 Preliminary Draft 2-5
ACL Application Programmer’s Guide ACL Utilities Overview
2.4.7 Restrictions
None; the libacl API functions are available to all users
2.5 ACL Utilities Overview
The ACL utilities provide command-line access to an Ampex DST or DIS ACL. They are
compatible with the DST/DIS Tape Management (DD-2) Utilities and can be used together
with them in scripts that perform higher-level operations. Both sets of utilities use a consistent
set of input and output conventions that make them easy to link together.
2.5.1 Exit Status
The ACL utilities use the following exit status codes, and may also produce output to -stdout
on success:
0 Operation successful.
nonzero Operation failed.
A nonzero return value describes the error encountered error during processing. An error
message is written to stderr along with the return value.
The limited number of error definitions in the
<sys/errno.h> file requires mapping of
multiple ACL errors onto single values. Because of this overloading, the
acl_status_library
utility provides additional error information beyond that provided by the return value.
2.5.2 Platform and Drive Compatibility
All of the ACL utilities operate consistently across supported platforms. See the on line release
notes installed with the ACL software for more information.
2.5.3 ACL Driver Version Compatibility
See the on line release notes installed with the ACL software to find out which version of the
ACL device driver the utilities are compatible with.
2.5.4 Open behavior
Each ACL utility handles the opening and closing of the ACL. If an error occurs during an
open, one of the following messages should be written to stderr: