Open System Services Shell and Utilities Reference Manual (G06.29+, H06.08+, J06.03+)

ar(1) OSS Shell and Utilities Reference Manual

-p Writes the contents of the named ﬁles from archive to the standard output ﬁle. If

no ﬁles are speciﬁed, the contents of all ﬁles in the archive are written in the

order they occur in the archive.

-q Quickly appends the named ﬁles to the end of the archive ﬁle. The ar command

does not check whether the appended ﬁles already exist in the archive. ar is use-

ful if you want to bypass the search process that is otherwise done when a large

archive is created piece by piece.

-r Replaces or adds ﬁles to an archive. If the archive named in the archive operand

does not exist, a new archive ﬁle is created and a diagnostic message is written

to the standard error ﬁle (unless the -c ﬂag is speciﬁed). If no ﬁles are speciﬁed

and the archive exists, no changes are made to the archive. Files that replace

existing ﬁles do not change the order of the archive. Files that do not replace

existing ﬁles are appended to the end of the archive.

-s Forces the regeneration of the archive symbol table even if ar is not invoked

with a ﬂag that modiﬁes the archive ﬁle contents.

-t Writes a table of contents for the library to the standard output ﬁle. The ﬁles

speciﬁed by the ﬁle operands are included in the written list. If no ﬁle operands

are speciﬁed, all ﬁles in the archive given by the archive operand are included in

the order of the archive.

-T Allows truncation of names of ﬁles whose archive names are longer than 255

characters. By default, extracting a ﬁle with a name that is too long is an error: a

diagnostic message is written, and the ﬁle is not extracted.

-u Updates older ﬁles by copying to the archive only those ﬁles that have changed

since they were last entered into the archive. When used with the -r ﬂag, -u

allows ﬁles in the archive to be replaced only by ﬁles having more recent

modiﬁcation times.

-v Writes to the standard output ﬁle a verbose description of a library. When the -v

ﬂag is used with ﬂags -d, -r,or-x, it writes a ﬁle-by-ﬁle description of the

archive operations as they are performed.

When -v is used with the -p ﬂag, it writes the name of the ﬁle to the standard out-

put ﬁle before it writes the ﬁle to the standard output ﬁle.

When -v is used with the -t ﬂag, it writes a detailed list of information about each

ﬁle, including access, ownership, size, and time, to the standard output ﬁle.

-Wfiletype Displays the ﬁle type. When speciﬁed with -tv ﬂags, it displays [elf-non PIC]

for TNS/R native object ﬁles that are not position-independent code (non-PIC),

[elf PIC] for TNS/R PIC native linkﬁles or native load ﬁles, [tnse 32-bit] for

TNS/E native object ﬁles of 32-bit data model, [tnse 64-bit] for TNS/E native

object ﬁles of 64-bit data model, [tnse neutral] for TNS/E native object ﬁles of

neutral data model, [tns] for TNS and accelerated object ﬁles, or nothing for

other ﬁle types such as text ﬁles. Use this ﬂag when ar cannot generate the sym-

bol table because native linkﬁles or loadﬁles are mixed with TNS or accelerated

object ﬁles, or when TNS/E native object ﬁles of 32-bit and 64-bit data models

are mixed.

1−8

Hewlett-Packard Company 527188-021