Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ ar(4) — GL2 W2.3

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

ar(1)

ld(1)

nm(1)

AR(4)  —  Silicon Graphics

NAME

ar − archive (library) file format

SYNOPSIS

#include <ar.h>

DESCRIPTION

The archive command ar is used to combine several files into one.  Archives are used mainly as libraries to be searched by the link-editor ld. 

A file produced by ar 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:

#define ARMAG 0177545
struct ar_hdr {
char ar_name[14];
long ar_date;
short ar_uid;
short ar_gid;
short ar_mode;
long ar_size;
};

The "ar_fmag" field contains the 32-bit number ARFMAG to help verify the presence of a header.  The name is a blank padded string.  The date is the modification date of the file at the time of its insertion into the archive. 

Each file begins on an even boundary; a new-line is inserted between files if necessary.  Nevertheless the size given reflects the actual size of the file exclusive of padding. 

There is no provision for empty areas in an archive file. 

SEE ALSO

ar(1), ld(1), nm(1)

BUGS

File names lose trailing blanks.  Most software dealing with archives takes even an included blank as a name terminator. 

Version 2.3  —  July 04, 1985

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026