V10/630/man/src/u_man/man1/mc68ar.1

Compare this file to the similar file:
Show the results in this format:
.TH MC68AR 1 "630 MTG"
.SH NAME
mc68ar \- archive and library maintainer for portable archives
.SH SYNOPSIS
.B mc68ar
key [ posname ] afile name ...
.SH DESCRIPTION
.I Mc68ar\^
maintains groups of files
combined into a single archive file.
Its main use
is to create and update library files as used by the link editor.
It can be used, though, for any similar purpose.
.PP
When
.I mc68ar\^
creates an archive, it creates headers in a format that is portable across
all machines.  The portable archive's format and structure are described in
detail in
.IR ar (4).
The archive symbol table [described in
.IR ar (4)]
is used by the link editor
[\f2mc68ld(1)\f1]
to effect multiple passes over libraries of
object files in an efficient manner.
Whenever the 
.IR mc68ar (1)
command is used to create or update the contents of an archive, the
symbol table is rebuilt.  The symbol table can be forced to be rebuilt
by the
.BR s
option described below.
.PP
.I Key\^
is one character from the set
.BR drqtpmx ,
optionally concatenated with
one or more of
.BR vuaibcls .
.I Afile\^
is the archive file.
The
.I names\^
are constituent files in the archive file.
The meanings of the
.I key\^
characters are:
.TP
.B d
Deletes the named files from the archive file.
.TP
.B r
Replaces the named files in the archive file.
If the optional character
.B u
is used with
.BR r ,
then only those files with
modified dates later than
the archive files are replaced.
If an optional positioning character from the set
.B abi
is used, then the
.I posname\^
argument must be present
and specifies that new files are to be placed
after
.RB ( a )
or before
.RB ( b
or
.BR i )
.IR posname .
Otherwise
new files are placed at the end.
.TP
.B q
Quickly appends the named files to the end of the archive file.
Optional positioning characters are invalid.
The command does not check whether the added members
are already in the archive.
Useful only to avoid quadratic behavior when creating a large
archive piece-by-piece.
.TP
.B t
Prints a table of contents of the archive file.
If no names are given, all files in the archive are tabled.
If names are given, only those files are tabled.
.TP
.B p
Prints the contents of named files in the archive.
.TP
.B m
Moves the named files to the end of the archive.
If a positioning character is present,
then the
.I posname\^
argument must be present and,
as in
.BR r ,
specifies where the files are to be moved.
.TP
.B x
Extracts the named files.
If no names are given, all files in the archive are
extracted.
In neither case does
.B x
alter the archive file.
.bp
.TP
.B v
Verbose.
Under the verbose option,
.I mc68ar\^
gives a file-by-file
description of the making of a
new archive file from the old archive and the constituent files.
When used with
.BR t ,
it gives a long listing of all information about the files.
When used with
.BR x ,
it precedes each file with a name.
.TP
.B c
Create.
Normally,
.I mc68ar\^
will create
.I afile\^
when it needs to.
The create option suppresses the
normal message that is produced when
.I afile\^
is created.
.TP
.B l
Local.
Normally,
.I mc68ar\^
places its temporary files in the directory
.BR /tmp .
This option causes them to be placed in the local directory.
.TP
.B s
Symbol table creation.
Forces the regeneration of the archive symbol table even if 
.IR mc68ar (1) 
is not invoked with a command which will modify the archive contents.
This command is useful to restore the archive symbol table after the
.IR mc68strip (1)
command has been used on the archive.
.SH FILES
/tmp/ar\(**	temporaries
.SH SEE ALSO
mc68ld(1),
mc68lorder(1),
mc68strip(1).
.br
a.out(4), ar(4) in the \f2UNIX System V Programmer's Reference
Manual\f1.
.SH BUGS
If the same file is mentioned twice in an argument list,
it may be put in the archive twice.