MPE/iX Shell and Utilities Reference Manual, Vol 1

ar(1) MPE/iX Shell and Utilities ar(1)
NAME
ar — create and maintain library archives
SYNOPSIS
ar –d [–v] archive member ...
ar –r [–cuv] archive member ...
ar –t [–v] archive [member ...]
ar –x [–v] archive [member ...]
DESCRIPTION
Note: The
MPE/iX implementation of this utility does not function exactly as this man page
describes. For details, see the MPE/iX NOTES section at the end of this man page.
ar maintains archive libraries. You an use ar to
• create a new library
• add members to an existing library
• delete members from a library
• extract members from a library
• print a table of contents for a library
A library member must be an object file, suitable for use by a link editor. ar creates and
maintains an external symbol index, to allow the library to be used for link editing.
Member names in an archive are only the final component of any file name. When opening a
member as given on the command line, the full path name given is used. When storing the
member name in the library, or comparing a member name, only the final component is used.
Options
The synopsis shows the four main functions of ar, defined as follows:
–d deletes each named member from the archive and regenerates the symbol table.
–r replaces or creates a new archive. If archive does not exist, ar creates it and prints a
message. This option adds each specified member file as a module to the archive and
regenerates the symbol table.
–t displays a table of contents that lists members or every member if no member is
specified. ar prints a diagnostic for each member that it doesn’t find. By default, ar
prints the member name for all selected members. With the verbose (–v) option, ar
prints more information for all selected members.
–x extracts each specified member from the archive and copies them (or all members if
none specified) to a file of the full member name given.
Commands and Utilities 1-11