Return to ar.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / pgrm / ar

Annotation of 43BSDReno/pgrm/ar/ar.1, revision 1.1

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