summaryrefslogtreecommitdiff
path: root/static/unix-v10/man1/ar.1
diff options
context:
space:
mode:
authorJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-26 16:38:00 -0400
committerJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-26 16:38:00 -0400
commit97d5c458cfa039d857301e1ca7d5af3beb37131d (patch)
treeb460cd850d0537eb71806ba30358840377b27688 /static/unix-v10/man1/ar.1
parentb89dc2331a50c63f8b33272a5c4c61ab98abdaa3 (diff)
build: Better Build System
Diffstat (limited to 'static/unix-v10/man1/ar.1')
-rw-r--r--static/unix-v10/man1/ar.183
1 files changed, 83 insertions, 0 deletions
diff --git a/static/unix-v10/man1/ar.1 b/static/unix-v10/man1/ar.1
new file mode 100644
index 00000000..9e882a21
--- /dev/null
+++ b/static/unix-v10/man1/ar.1
@@ -0,0 +1,83 @@
+.pa 1
+.he 'AR (I)'3/15/72'AR (I)'
+.ti 0
+NAME ar -- archive
+.sp
+.ti 0
+SYNOPSIS ar__ key afile name918 ...
+.sp
+.ti 0
+DESCRIPTION ar__
+maintains groups of files
+combined into a single archive file.
+Its main use
+is to create and update library files as used by the loader.
+It can be used, though, for any similar purpose.
+.sp
+key___ is one character from the set drtux_____,
+optionally concatenated with v_.
+afile_____ is the archive file.
+The names_____ are constituent files in the archive file.
+The meanings of the key___ characters are:
+.sp
+d_ means delete the named files from the archive file.
+.sp
+r_ means replace the named files in the archive file.
+If the archive file does not exist, r_ will create it.
+If the named files are not in the archive file, they are appended.
+.sp
+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.
+.sp
+u_ is similar to r_ except that only those
+files that have been modified are replaced.
+If no names are given, all files in the archive that
+have been modified will be replaced by the modified version.
+.sp
+x_ will 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.
+.sp
+v_ means verbose.
+Under the verbose option,
+ar__ gives a file-by-file
+description of the making of a
+new archive file from the old archive and the constituent files.
+The following abbreviations
+are used:
+.sp
+ c_ copy
+ a_ append
+ d_ delete
+ r_ replace
+ x_ extract
+.sp
+.ti 0
+FILES /tmp/vtm? temporary
+.sp
+.ti 0
+SEE ALSO ld(I), archive(V)
+.sp
+.ti 0
+DIAGNOSTICS "Bad usage",
+"afile -- not in archive format",
+"cannot open temp file",
+"name -- cannot open",
+"name -- phase error",
+"name -- cannot create",
+"no archive file",
+"cannot create archive file",
+"name -- not found".
+.sp
+.ti 0
+BUGS Option
+vt__ should be implemented as a table with more information.
+.sp
+There should be a way to specify the placement
+of a new file in an archive.
+Currently, it is placed at the end.
+
+"ar x" changes the modified-date of the current
+directory to a random number.