Return to ar.5 CVS log

Up to [Research Unix] / researchv10dc / man / man5

Annotation of researchv10dc/man/man5/ar.5, revision 1.1

1.1     ! root        1: .TH AR 5
        !             2: .CT 1 lib_obj
        !             3: .SH NAME
        !             4: ar \- archive (library) file format
        !             5: .SH SYNOPSIS
        !             6: .B #include <ar.h>
        !             7: .SH DESCRIPTION
        !             8: The archive command
        !             9: .IR ar (1)
        !            10: is used to combine several files into
        !            11: one.
        !            12: Archives are used mainly as libraries to be searched
        !            13: by the link-editor
        !            14: .I ld.
        !            15: .PP
        !            16: A file produced by
        !            17: .I ar
        !            18: has a magic string at the start,
        !            19: followed by the constituent files, each preceded by a file header.
        !            20: The magic number and header layout as described in the
        !            21: include file are:
        !            22: .PP
        !            23: .EX
        !            24: .ta \w'#define 'u +\w'SAR_HDR 'u
        !            25: .ec %
        !            26: #define        ARMAG   "!<arch>\n"
        !            27: #define        SARMAG  8
        !            28: 
        !            29: #define        ARFMAG  "`\n"
        !            30: 
        !            31: struct ar_hdr {
        !            32:        char    ar_name[16];
        !            33:        char    ar_date[12];
        !            34:        char    ar_uid[6];
        !            35:        char    ar_gid[6];
        !            36:        char    ar_mode[8];
        !            37:        char    ar_size[10];
        !            38:        char    ar_fmag[2];
        !            39: };
        !            40: #define        SAR_HDR 60
        !            41: .ec \
        !            42: .EE
        !            43: .LP
        !            44: The name is a blank-padded string.
        !            45: The
        !            46: .L ar_fmag
        !            47: field contains
        !            48: .L ARFMAG
        !            49: to help verify the presence of a header.
        !            50: The other fields are left-adjusted, blank-padded numbers.
        !            51: They are decimal except for
        !            52: .LR ar_mode ,
        !            53: which is octal.
        !            54: The date is the modification date of the file
        !            55: at the time of its insertion into the archive.
        !            56: The length of the header is
        !            57: .LR SAR_HDR .
        !            58: Because
        !            59: .L struct ar_hdr
        !            60: may be padded on some machines,
        !            61: .L SAR_HDR
        !            62: should be used in preference to
        !            63: .L sizeof(struct ar_hdr)
        !            64: when reading and writing file headers.
        !            65: .PP
        !            66: Each file begins on an even (0 mod 2) boundary;
        !            67: a newline is inserted between files if necessary.
        !            68: Nevertheless 
        !            69: .B ar_size
        !            70: reflects the
        !            71: actual size of the file exclusive of padding.
        !            72: .PP
        !            73: There is no provision for empty areas in an archive
        !            74: file.
        !            75: .PP
        !            76: If an archive contains only printable files, the archive itself
        !            77: is printable.
        !            78: .SH "SEE ALSO"
        !            79: .IR ar (1), 
        !            80: .IR ld (1), 
        !            81: .IR nm (1)
        !            82: .SH BUGS
        !            83: File names lose trailing blanks.
        !            84: .br
        !            85: Most software that deals with archives takes 
        !            86: an embedded blank as a name terminator.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.