182 lines
3.1 KiB
Text
182 lines
3.1 KiB
Text
.TH AR 1
|
|
.SH NAME
|
|
ar \- archive and library maintainer
|
|
.SH SYNOPSIS
|
|
.B ar
|
|
.I key
|
|
[
|
|
.I posname
|
|
]
|
|
.I afile
|
|
[
|
|
.I file ...
|
|
]
|
|
.SH DESCRIPTION
|
|
.I Ar
|
|
maintains groups of files
|
|
combined into a single archive file,
|
|
.IR afile .
|
|
The main use of
|
|
.I ar
|
|
is to create and update library files for the loaders
|
|
.IR 2l (1),
|
|
etc.
|
|
It can be used, though, for any similar purpose.
|
|
.PP
|
|
.I Key
|
|
is one character from the set
|
|
.BR drqtpmx ,
|
|
optionally concatenated with
|
|
one or more of
|
|
.BR vuaibclo .
|
|
The
|
|
.I files
|
|
are constituents of the archive
|
|
.IR afile .
|
|
The meanings of the
|
|
.I key
|
|
characters are:
|
|
.TP
|
|
.B d
|
|
Delete
|
|
.I files
|
|
from the archive file.
|
|
.TP
|
|
.B r
|
|
Replace
|
|
.I files
|
|
in the archive file, or add them if missing.
|
|
Optional modifiers are
|
|
.RS
|
|
.PD0
|
|
.TP
|
|
.B u
|
|
Replace only files with
|
|
modified dates later than that of
|
|
the archive.
|
|
.TP
|
|
.B a
|
|
Place new files after
|
|
.I posname
|
|
in the archive rather than at the end.
|
|
.TP
|
|
.BR b " or " i
|
|
Place new files before
|
|
.I posname
|
|
in the archive.
|
|
.RE
|
|
.PD
|
|
.TP
|
|
.B q
|
|
Quick. Append
|
|
.I files
|
|
to the end of the archive without checking for duplicates.
|
|
Avoids quadratic behavior in
|
|
.LR "for (i in *.v) ar r lib.a $i" .
|
|
.TP
|
|
.B t
|
|
List a table of contents of the archive.
|
|
If names are given, only those files are listed.
|
|
.TP
|
|
.B p
|
|
Print the named files in the archive.
|
|
.TP
|
|
.B m
|
|
Move the named files to the end or elsewhere,
|
|
specified as with
|
|
.LR r .
|
|
.TP
|
|
.B o
|
|
Preserve the access and modification times of files
|
|
extracted with the
|
|
.B x
|
|
command.
|
|
.TP
|
|
.B x
|
|
Extract 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.
|
|
.TP
|
|
.B v
|
|
Verbose.
|
|
Give a file-by-file
|
|
description of the making of a
|
|
new archive file from the old archive and the constituent files.
|
|
With
|
|
.BR p ,
|
|
precede each file with a name.
|
|
With
|
|
.BR t ,
|
|
give a long listing of all information about the files,
|
|
somewhat like a listing by
|
|
.IR ls (1),
|
|
showing
|
|
.br
|
|
.ns
|
|
.IP
|
|
.B
|
|
mode uid/gid size date name
|
|
.\" .TP
|
|
.\" .B c
|
|
.\" Create.
|
|
.\" Normally
|
|
.\" .I ar
|
|
.\" will create a new archive when
|
|
.\" .I afile
|
|
.\" does not exist, and give a warning.
|
|
.\" Option
|
|
.\" .B c
|
|
.\" discards any old contents and suppresses the warning.
|
|
.TP
|
|
.B l
|
|
Local.
|
|
Normally
|
|
.I ar
|
|
places its temporary files in the directory
|
|
.BR /tmp .
|
|
This option causes them to be placed in the local directory.
|
|
.PP
|
|
When a
|
|
.BR d ,
|
|
.BR r ,
|
|
or
|
|
.BR m
|
|
.I key
|
|
is specified and all members of the archive are valid object files for
|
|
the same architecture,
|
|
.I ar
|
|
inserts a table of contents, required by the loaders, at
|
|
the front of the library.
|
|
The table of contents is
|
|
rebuilt whenever the archive is modified, except
|
|
when the
|
|
.B q
|
|
.I key
|
|
is specified or when the table of contents is
|
|
explicitly moved or deleted.
|
|
.SH EXAMPLE
|
|
.TP
|
|
.L
|
|
ar cr lib.a *.v
|
|
Replace the contents of library
|
|
.L lib.a
|
|
with the object files in the current directory.
|
|
.SH FILES
|
|
.TF /tmp/vxxxx
|
|
.TP
|
|
.B /tmp/v*
|
|
temporaries
|
|
.SH SOURCE
|
|
.B /sys/src/cmd/ar.c
|
|
.SH "SEE ALSO"
|
|
.IR 2l (1),
|
|
.IR ar (6)
|
|
.SH BUGS
|
|
If the same file is mentioned twice in an argument list,
|
|
it may be put in the archive twice.
|
|
.br
|
|
This command predates Plan 9 and makes some invalid assumptions,
|
|
for instance that user id's are numeric.
|