User Guide

Ampex 1308904-X4 Preliminary Draft 5-5
ACL Application Programmer’s Guide acl_intro
-stdout < output_spec>
The -stdout <output_spec> argument specifies the output stream written to stdout. It is
required for all ACL Management Utilities that produce an output, unless you use the -help
argument.
The -stdout <output_spec> argument allows you to specify the following:
• Keywords [%field_name or %(field_name) as documented in the utility’s manual page]
that designate the fields in the output stream written to stdout. When specifying more
than one keyword, enclose the entire argument in quotes and use spaces to separate the
field names.
• Characters that the command copies literally to the output stream. A backslash (\) in the
output specification is not itself printed and causes the following character to be printed
literally, except for
\n which produces a newline. For example, you can use \% to print
a percent sign without having it interpreted as a keyword indicator.
Keywords that start with v_ (%v_field_name) provide verbose output that displays a
descriptive string; all other keywords produce normal output that displays only the returned
value.
By default, the output stream contains a trailing newline. Use the -n option to suppress the
newline.
On output, the command formats the output values by stripping any leading zeroes from
numbers and any trailing spaces from strings. Tape cartridge barcode IDs (volume tags) are
considered to be strings.
OPTIONS
The options supported by more than one utility are described below. For other options, consult
each utility’s manual page.
-device <
device_special_file>
Specifies the device special file to use for the operation. If omitted, the device special file
specified by the $ACL_DEV environment variable is used. There is no default if $ACL_DEV
is not defined.
-n
Prevents a trailing newline from being appended to the output stream. If omitted, the output
stream includes a trailing newline.
-n does not affect newlines embedded in the output stream.
-n is valid for all commands that output to stdout.