mirror of
https://github.com/SEPPDROID/Digital-Research-Source-Code.git
synced 2025-10-23 16:34:07 +00:00
92 lines
3.1 KiB
Plaintext
92 lines
3.1 KiB
Plaintext
.so macro
|
|
.he 'AR68''AR68'
|
|
.pr PROGRAM AR68
|
|
ar68 - archive maintainer
|
|
.us USAGE
|
|
ar68 flags [pos] archive file1 file2 ...
|
|
.fn FUNCTION
|
|
\&'ar68' collects individual files into a single archive,
|
|
or library file.
|
|
It is primarily used to maintain libraries of object files
|
|
for use by the loader,
|
|
although it can be used with any type of file.
|
|
.sp 1
|
|
The flags argument determines the function that 'ar68' performs.
|
|
One character from the set {dprtx} must be specified;
|
|
these are the function select flags.
|
|
The function select flags specify the following functions:
|
|
.sp 2
|
|
.in +8
|
|
.ti -8
|
|
d\ \ \ \ \ \ \ Delete the specified files from the archive.
|
|
.sp
|
|
.ti -8
|
|
p\ \ \ \ \ \ \ Print the specified files.
|
|
If the files are not printable,
|
|
e.g. object files, havoc results.
|
|
.sp
|
|
.ti -8
|
|
r\ \ \ \ \ \ \ Replace the specified files.
|
|
If an optional position flag from the set
|
|
{abi} is not specified new files are placed at the end of the archive.
|
|
.sp
|
|
.ti -8
|
|
t\ \ \ \ \ \ \ Print a table of contents of the archive.
|
|
If files are specified only the specified files are listed.
|
|
.sp
|
|
.ti -8
|
|
x\ \ \ \ \ \ \ Extract the specified files from the archive,
|
|
creating loose files in the current directory.
|
|
If no files are specified, all of the files in the archive are extracted.
|
|
Note that 'x' does not alter the archive.
|
|
The 'd' flag must be used to delete files from an archive.
|
|
.sp 2
|
|
.in -8
|
|
The files must be specified in the same order as they appear in the
|
|
archive file,
|
|
otherwise some of the files may not be found.
|
|
For example, if an archive "t.a" consists of the files file1, file2
|
|
and file3 in that order,
|
|
the command "ar t t.a file2 file1" will cause file2 to be listed,
|
|
but not file1.
|
|
Instead, the message "file1 not in archive" will be printed.
|
|
This is because 'ar68' only searches the archive once.
|
|
Files must be specified in the order they appear in the archive.
|
|
.sp 2
|
|
Characters from the set {abiv} may be included in the flags argument.
|
|
These characters have the following function:
|
|
.in +8
|
|
.sp 2
|
|
.ti -8
|
|
a\ \ \ \ \ \ \ When used with the 'r' flag, 'a' specifies that new files
|
|
are to be inserted after the file "pos" in the archive.
|
|
Note that the "pos" argument must be specified if and only if
|
|
one of the characters {abi} appear in the flags argument.
|
|
.sp
|
|
.ti -8
|
|
b\ \ \ \ \ \ \ 'b' has the same function as 'a', except that new files are
|
|
inserted before the file "pos" in the archive.
|
|
.sp
|
|
.ti -8
|
|
i\ \ \ \ \ \ \ 'i' has exactly the same meaning as 'b', the two characters
|
|
can be used interchangeably (but only one must appear).
|
|
.sp
|
|
.ti -8
|
|
v\ \ \ \ \ \ \ 'v' (verbose) causes a file by file description of the
|
|
operation of 'ar68' to be printed.
|
|
Files are either copied (c),
|
|
replaced (r), added (a), deleted (d) or extracted (x) from an archive.
|
|
When used with the 't' flag, 'v' causes a long listing to be printed.
|
|
Verbose has no effect on the print function.
|
|
.in -8
|
|
.fl FILES
|
|
_~ar????? (process id in octal) - temporary file
|
|
.dg DIAGNOSTICS
|
|
.sa SEE ALSO
|
|
lo68 (cmnd), ar68 (files)
|
|
.bg BUGS
|
|
When using any of the 'a' 'b', or 'i' flags to position the files,
|
|
if any of the files in the namelist already exist in the archive,
|
|
you must delete them with the delete option first. Otherwise, 'ar68'
|
|
will make another copy of them.
|