noft Manual (G06.27+, H06.03+, J06.03+)

ar Utility
noft Manual—528273-003
5-2
-r Replace or add files to the archive. If the archive specified
by archive does not exist, ar creates a new archive
and writes a diagnostic message to the standard error
(unless you specify the -c option). If no files are specified
and the archive exists, no changes are made to that
archive. Files that replace existing files do not change the
order of the archive. Files that do not replace existing files
are appended to the archive.
-t Write a table of contents of archive to the standard
output. The specified files are included in the written list. If
no file operands are specified, all files in the archive
are included in the list, in the order in which they occur in
the archive.
-Wobey obey-file Indicates that an option and a list of files to be processed
should be read from the file obey-file rather than from
the command line. The -Wobey option cannot be used on
the command line when any other option is used on the
command line.
Use the -Wobey option to speed up execution of the ar
command when more than one file must be processed.
The file obey-file must be either a Guardian EDIT file
or an OSS text file. In the obey-file, you must specify
one and only one option from the required-flag set
dmpqrtx.
You can also specify any number of optional flags from
the set abcilsuvCT. If you select a modifier-option
(a, b, or i), you must also specify the name of a file within
the library (position_name ) immediately following the
option list and separated from it by a space.
-x Extract the specified files from the archive. The contents
of the archive are not changed. If no file operands are
specified, ar extracts all files in the archive. ar sets the
modification time of each extracted file to the time at
which the file is extracted from the archive.
When ar is running in the Guardian environment, it gives
file code 700 to extracted TNS/R files. It gives file code
180 to all other extracted files.
If the file name of a file to be extracted is longer than that
supported in the directory to which it is being extracted,
an error occurs, and ar does not extract the file unless
the -T option is specified, in which case ar extracts the
file and renames it with the truncated file name. If the
name of a file to be extracted is not valid on the platform
where ar is running, ar does not extract the file but
issues a diagnostic instead.
Name Function (page 2 of 2)