52 lines
1.3 KiB
Groff
52 lines
1.3 KiB
Groff
|
.TH ARCH 5
|
||
|
.SH NAME
|
||
|
arch \- archive (library) file format
|
||
|
.SH SYNOPSIS
|
||
|
.B #include "/usr/em/h/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(VI) or the universal
|
||
|
assembler/linker em_unias(VI).
|
||
|
.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 "SEE ALSO"
|
||
|
arch(I), em_ass(VI), em_unias(VI)
|
||
|
.SH BUGS
|
||
|
Coding user and group IDs as characters is a botch.
|