AR(6) AR(6)
NAME
ar - archive (library) file format
SYNOPSIS
#include <ar.h>
DESCRIPTION
The archive command ar(1) is used to combine several files
into one. Archives are used mainly as libraries to be
searched by the loaders 2l(1) et al.
A file produced by ar has a magic string at the start, fol-
lowed by the constituent files, each preceded by a file
header. The magic number and header layout as described in
the include file are:
#define ARMAG "!<arch>\n"
#define SARMAG 8
#define ARFMAG "`\n"
struct ar_hdr {
char name[16];
char date[12];
char uid[6];
char gid[6];
char mode[8];
char size[10];
char fmag[2];
};
#define SAR_HDR 60
The name is a blank-padded string. The `fmag' field con-
tains `ARFMAG' to help verify the presence of a header. The
other fields are left-adjusted, blank-padded numbers. They
are decimal except for `mode', which is octal. The date is
the modification date of the file (see stat(2)) at the time
of its insertion into the archive. The mode is the low 9
bits of the file permission mode, in octal. The length of
the header is `SAR_HDR'. Because `struct ar_hdr' may be
padded on some machines, `SAR_HDR' should be used in prefer-
ence to `sizeof(struct ar_hdr)' when reading and writing
file headers.
Each file begins on an even (0 mod 2) boundary; a newline is
inserted between files if necessary. Nevertheless size
reflects the actual size of the file exclusive of padding.
There is no provision for empty areas in an archive file.
Page 1 Plan 9 (printed 10/29/25)
AR(6) AR(6)
SEE ALSO
ar(1), 2l(1), nm(1), stat(2)
BUGS
The uid and gid fields are unused in Plan 9. They provide
compatibility with Unix ar format.
Page 2 Plan 9 (printed 10/29/25)