ar86 - Create, modify, and extract from archive file
ar86 operation archive [
file...]
ar86 positional-op member archive [
file...]
The
ar86 program is used to create, examine and modify archive files
produced by the Dev86/ELKS toolchain.
The
ar86 command requires that the operation to be performed on the
archive be specified as the first option. If the operation is positional then
the next option is the archive member marking the position. This is followed
by the archive file name and any list of file names.
One of the following operations can be specified
- d
-
delete the listed files from the archive.
- m
-
move the named files. By default files are moved to
the end of the archive unless a positional modifier is present.
- p
-
print the contents of archive members to standard
out. If a file list is included only those members are printed. If the
v modifier is present each file's contents are preceded by a new
line, a line with the string member, a space character, the member
name, and two following newlines.
- q
-
quickly add the files to the end of the archive
without checking to see if they already exist in the archive. This
operation will ignore any positional modifiers. Creates the archive file
if it does not exist.
- r
-
replace archive members with the files listed. If
the file name is not present in the archive it is added to the end of the
archive (or to any explicitly specified position). Creates the archive
file if it does not exist.
- t
-
table; list the file names of archive members. If a
file list is present only those files that are present in the archive are
listed. The v modifier prints member attributes.
- x
-
extract the named files from the archive into the
current directory. If no files are specified all the archive members will
be extracted.
The following modifiers may be used with the operations
- o
-
original time stamps from the archive are preserved
for extracted files when possible.
- s
-
symbol update; this option may be used by itself to
force an update to the symbol definition section of the archive (the
__.SYMDEF member). If any files are specified they will be replaced
as if the r operation had been specified. If no symbol definition
section exists one is created. This option will also creates the archive
file if it does not exist.
- u
-
update files in the archive during a r
(replace) operation. The files are added to the archive in exactly
the same manner as replace except that an existing archive member
will be retained (in its original position) if it has a modified more
recently than the file being added. Note that this modifier acts as if a
r operation has been specified (even it has not), and will actually
override any other previously specified operation.
- v
-
verbose; print additional diagnostic messages while
processing the archive.
The following modifiers specify where in the archive files are moved to or
added. If any of these modifiers are specified then the second option to
ar86 must be the name of an archive member.
- a
-
after; files are placed after the specified archive
member.
- b
-
before; files are placed before the specified
archive member.
- i
- same as b.
To see the contents of an archive
- ar86 tv libfile.a
To add some files to an archive
- ar86 r libfile.a file1.o file2.o
to add some files after a member named mem.o and to update the symbol table
- ar86 rsa mem.o libfile.a file1.o file2.o
A
l modifier will be accepted but ignored.
This command is intended for use only with object files created using the
Dev86/ELKS toolchain.
as86(1),
bcc(1),
ld86(1)
© 1988, 1990 Free Software Foundation Inc. Changes for
ar86 by
Greg Haerr <
[email protected]>.
The manual page was written for Debian GNU/Linux, © 2006 Shyamal Prasad
<
[email protected]>. It is distributed under the terms of the GNU
General Public License version 2 (or any later version released by the Free
Software Foundation).