From: ceriel <none@none>
Date: Wed, 11 Mar 1987 15:07:29 +0000 (+0000)
Subject: Initial revision
X-Git-Tag: release-5-5~4424
X-Git-Url: https://git.ndcode.org/public/gitweb.cgi?a=commitdiff_plain;h=32fa87085566c3743f1f7ee756b05a22617c20c1;p=ack.git

Initial revision
---

diff --git a/util/arch/arch.5 b/util/arch/arch.5
new file mode 100644
index 000000000..468195f06
--- /dev/null
+++ b/util/arch/arch.5
@@ -0,0 +1,55 @@
+.\" $Header$
+.TH ARCH 5ACK
+.ad
+.SH NAME
+arch \- archive (library) file format
+.SH SYNOPSIS
+.B #include <arch.h>
+.SH DESCRIPTION
+The archive command
+.I arch
+is used to combine several files into
+one.
+Archives are used mainly as libraries to be searched
+by the EM assembler/linker em_ass(6) or the universal
+assembler/linker uni_ass(6).
+.PP
+A file produced by
+.I arch
+has a magic number at the start,
+followed by the constituent files, each preceded by a file header.
+The magic number and header layout as described in the
+include file are:
+.RS
+.PP
+.nf
+.ta \w'#define 'u +\w'ARMAG 'u
+.so ../h/arch.h
+.fi
+.RE
+.LP
+The name is a null-terminated string;
+The sizes of the other entries are determined as follows:
+long's are 4 bytes in PDP-11 order, int are 2 bytes, low order
+byte first, char's are 1 byte.
+The date is in the
+form of
+.IR time (2);
+the user ID and group ID are numbers; the mode is a bit pattern
+per
+.IR chmod (2);
+the size is counted in bytes.
+.PP
+Each file begins on a even offset;
+a null byte is inserted between files if necessary.
+Nevertheless the size given reflects the
+actual size of the file exclusive of padding.
+.PP
+Notice there is no provision for empty areas in an archive
+file.
+.SH FILES
+~em/h/arch.h
+.SH "SEE ALSO"
+arch(1), em_ass(6), uni_ass(6)
+.SH BUGS
+Coding user and group IDs as characters is a botch.