Return to ar.1 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man1

Annotation of 43BSDTahoe/man/man1/ar.1, revision 1.1

1.1     ! root        1: .\"    @(#)ar.1        6.1 (Berkeley) 4/29/85
        !             2: .\"
        !             3: .TH AR 1 "April 29, 1985"
        !             4: .AT 3
        !             5: .SH NAME
        !             6: ar \- archive and library maintainer
        !             7: .SH SYNOPSIS
        !             8: .B ar
        !             9: key [ posname ] afile name ...
        !            10: .SH DESCRIPTION
        !            11: .I Ar
        !            12: maintains groups of files
        !            13: combined into a single archive file.
        !            14: Its main use
        !            15: is to create and update library files as used by the loader.
        !            16: It can be used, though, for any similar purpose.
        !            17: .B N.B:
        !            18: This version of
        !            19: .I ar
        !            20: uses a ASCII-format archive which is portable among the various
        !            21: machines running \s-2UNIX\s0.
        !            22: Programs for dealing with older formats are available: see
        !            23: .IR arcv (8).
        !            24: .PP
        !            25: .I Key
        !            26: is one character from the set
        !            27: .B drqtpmx,
        !            28: optionally concatenated with
        !            29: one or more of
        !            30: .B vuaibclo.
        !            31: .I Afile
        !            32: is the archive file.
        !            33: The
        !            34: .I names
        !            35: are constituent files in the archive file.
        !            36: The meanings of the
        !            37: .I key
        !            38: characters are:
        !            39: .TP
        !            40: .B d
        !            41: Delete the named files from the archive file.
        !            42: .TP
        !            43: .B r
        !            44: Replace the named files in the archive file.
        !            45: If the optional character
        !            46: .B u
        !            47: is used with
        !            48: .B r,
        !            49: then only those files with `last-modified' dates later than
        !            50: the archive files are replaced.
        !            51: If an optional positioning character from the set
        !            52: .B abi
        !            53: is used, then the
        !            54: .I posname
        !            55: argument must be present
        !            56: and specifies that new files are to be placed
        !            57: after
        !            58: .RB ( a )
        !            59: or before
        !            60: .RB ( b
        !            61: or
        !            62: .BR i )
        !            63: .IR posname .
        !            64: Otherwise
        !            65: new files are placed at the end.
        !            66: .TP
        !            67: .B q
        !            68: Quickly append the named files to the end of the archive file.
        !            69: Optional positioning characters are invalid.
        !            70: The command does not check whether the added members
        !            71: are already in the archive.
        !            72: Useful only to avoid quadratic behavior when creating a large
        !            73: archive piece-by-piece.
        !            74: .TP
        !            75: .B t
        !            76: Print a table of contents of the archive file.
        !            77: If no names are given, all files in the archive are tabled.
        !            78: If names are given, only those files are tabled.
        !            79: .TP
        !            80: .B p
        !            81: Print the named files in the archive.
        !            82: .TP
        !            83: .B m
        !            84: Move the named files to the end of the archive.
        !            85: If a positioning character is present,
        !            86: then the
        !            87: .I posname
        !            88: argument must be present and,
        !            89: as in
        !            90: .B r,
        !            91: specifies where the files are to be moved.
        !            92: .TP
        !            93: .B x
        !            94: Extract the named files.
        !            95: If no names are given, all files in the archive are
        !            96: extracted.
        !            97: In neither case does
        !            98: .B x
        !            99: alter the archive file. Normally the `last-modified' date of each
        !           100: extracted file is the date when it is extracted. However, if
        !           101: .B o
        !           102: is used, the `last-modified' date is reset to the date recorded in the
        !           103: archive.
        !           104: .TP
        !           105: .B v
        !           106: Verbose.
        !           107: Under the verbose option,
        !           108: .I ar
        !           109: gives a file-by-file
        !           110: description of the making of a
        !           111: new archive file from the old archive and the constituent files.
        !           112: When used with
        !           113: .B t,
        !           114: it gives a long listing of all information about the files.
        !           115: When used with
        !           116: .BR p ,
        !           117: it precedes each file with a name.
        !           118: .TP
        !           119: .B c
        !           120: Create.
        !           121: Normally
        !           122: .I ar
        !           123: will create
        !           124: .I afile
        !           125: when it needs to.
        !           126: The create option suppresses the
        !           127: normal message that is produced when
        !           128: .I afile
        !           129: is created.
        !           130: .TP
        !           131: .B l
        !           132: Local.
        !           133: Normally
        !           134: .I ar
        !           135: places its temporary files in the directory /tmp.
        !           136: This option causes them to be placed in the local directory.
        !           137: .SH FILES
        !           138: /tmp/v*        temporaries
        !           139: .SH "SEE ALSO"
        !           140: lorder(1), ld(1), ranlib(1), ar(5), arcv(8)
        !           141: .SH BUGS
        !           142: If the same file is mentioned twice in an argument list,
        !           143: it may be put in the archive twice.
        !           144: .LP
        !           145: The `last-modified' date of a file will not be altered by the
        !           146: .B o
        !           147: option if the user is not the owner of the extracted file, or the super-user.

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