AR(1) General Commands Manual AR(1)NAME
ar, aal - archivers
SYNOPSIS
ar [dmpqrtx][abciluv] [posname] archive [file ...]
aal [dpqrtx][clv] archive [file ...]
EXAMPLES
ar r libc.a sort.s # Replace sort.s in libc.a
ar rb a.s libc.a b.s
# Insert b.s before a.s in libc.a
DESCRIPTION
Ar allows groups of files to be put together into a single archive. It is normally used for libraries of compiled procedures. Aal is like
ar, but is to be used with the ACK compiler. The following keys are allowed:
d: Delete. Ar will delete the named members.
m: Move named files. Ar expects a, b, or i to be specified.
p: Print the named files (list them on stdout)
q: Quickly append to the end of the archive file.
r: Replace (append when not in archive).
t: Print the archive's table of contents.
x: Extract
The keys may optionally concatencated with one or more of the following:
a: After posname
b: Before posname
c: Create (suppresses creation message)
i: Before posname
l: Local temporary file for work instead of /tmp/ar.$$$$$
u: Replace only if dated later than member in archive
v: Verbose
SEE ALSO anm(1), asize(1), nm(1), size(1).
AR(1)
Check Out this Related Man Page
AR(1) General Commands Manual AR(1)NAME
ar - archive and library maintainer
SYNOPSIS
ar key [ posname ] afile [ file ... ]
DESCRIPTION
Ar maintains groups of files combined into a single archive file, afile. The main use of ar is to create and update library files for the
loaders 2l(1), etc. It can be used, though, for any similar purpose.
Key is one character from the set drqtpmx, optionally concatenated with one or more of vuaibclo. The files are constituents of the archive
afile. The meanings of the key characters are:
d Delete files from the archive file.
r Replace files in the archive file, or add them if missing. Optional modifiers are
u Replace only files with modified dates later than that of the archive.
a Place new files after posname in the archive rather than at the end.
b or i Place new files before posname in the archive.
q Quick. Append files to the end of the archive without checking for duplicates. Avoids quadratic behavior in
t List a table of contents of the archive. If names are given, only those files are listed.
p Print the named files in the archive.
m Move the named files to the end or elsewhere, specified as with
o Preserve the access and modification times of files extracted with the x command.
x Extract the named files. If no names are given, all files in the archive are extracted. In neither case does x alter the archive
file.
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
p, precede each file with a name. With t, give a long listing of all information about the files, somewhat like a listing by ls(1),
showing
mode uid/gid size date name
c Create. Normally ar will create a new archive when afile does not exist, and give a warning. Option c discards any old contents
and suppresses the warning.
l Local. Normally ar places its temporary files in the directory /tmp. This option causes them to be placed in the local directory.
When a d, r, or m key is specified and all members of the archive are valid object files for the same architecture, 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 q key is specified or when the table of contents is explicitly moved or deleted.
EXAMPLE
ar cr lib.a *.o
Replace the contents of library with the object files in the current directory.
FILES
/tmp/v*
temporaries
SOURCE
/sys/src/cmd/ar.c
SEE ALSO 2l(1), ar(6)BUGS
If the same file is mentioned twice in an argument list, it may be put in the archive twice.
This command predates Plan 9 and makes some invalid assumptions, for instance that user id's are numeric.
AR(1)