User Guide
5-4 Preliminary Draft Ampex 1308904-X4
Model No.
Running Head
acl_intro ACL Application Programmer’s Guide
For example, an argument such as -aclparam :1:::: uses colons as separators.
Separator characters must be present to reserve places for all elements, even if they are
empty.
• You can specify integer input values using a standard decimal number, a hexadecimal
value (first two characters are 0x), or an octal value (the first character is a zero and the
second character is not an x).
OUTPUT CONVENTIONS
The ACL Management Utilities have the following output conventions:
• Many utilities support the -stdout <output_spec> argument which specifies the output
stream written to stdout. Each output field in the string is identified by a unique keyword
[%field_name or %(field_name)] that you can specify to display the field, or omit to skip
the field.
• All error and help messages are written to stderr.
• On success, all utilities return an exit status of zero. Utilities that support the
-stdout <output_spec> argument may also produce output to stdout.
• On failure, all utilities return a nonzero exit status. You can use the acl_status_library
utility to retrieve SCSI Sense Data that provides detailed information on the cause of the
failure.
ARGUMENTS
The arguments supported by more than one utility are described below. For other arguments,
consult each utility’s manual page.
Writer_Note: Several Bug Reports in the DDTS refer to a v_revision keyword for the
-help <help_type> specification. If the keyword is an undocumented feature, we should
describe it here and list it on the appropriate manual pages.
-help [
help_type
]
Displays help on stderr and invalidates all other options, cancelling any other actions. The
optional help_type specification indicates the kind of help to supply:
• output - lists the keywords that are valid for the-stdout <output_spec> argument.
• revision - displays the utility revision number.
When -help is specified without the help_type argument, it displays the utility usage line.