12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152 |
- .\" $Header$
- .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.
|