Return to mc68ar.1 CVS log

Up to [Research Unix] / researchv10dc / 630 / man / src / u_man / man1

Annotation of researchv10dc/630/man/src/u_man/man1/mc68ar.1, revision 1.1

1.1     ! root        1: .TH MC68AR 1 "630 MTG"
        !             2: .SH NAME
        !             3: mc68ar \- archive and library maintainer for portable archives
        !             4: .SH SYNOPSIS
        !             5: .B mc68ar
        !             6: key [ posname ] afile name ...
        !             7: .SH DESCRIPTION
        !             8: .I Mc68ar\^
        !             9: maintains groups of files
        !            10: combined into a single archive file.
        !            11: Its main use
        !            12: is to create and update library files as used by the link editor.
        !            13: It can be used, though, for any similar purpose.
        !            14: .PP
        !            15: When
        !            16: .I mc68ar\^
        !            17: creates an archive, it creates headers in a format that is portable across
        !            18: all machines.  The portable archive's format and structure are described in
        !            19: detail in
        !            20: .IR ar (4).
        !            21: The archive symbol table [described in
        !            22: .IR ar (4)]
        !            23: is used by the link editor
        !            24: [\f2mc68ld(1)\f1]
        !            25: to effect multiple passes over libraries of
        !            26: object files in an efficient manner.
        !            27: Whenever the 
        !            28: .IR mc68ar (1)
        !            29: command is used to create or update the contents of an archive, the
        !            30: symbol table is rebuilt.  The symbol table can be forced to be rebuilt
        !            31: by the
        !            32: .BR s
        !            33: option described below.
        !            34: .PP
        !            35: .I Key\^
        !            36: is one character from the set
        !            37: .BR drqtpmx ,
        !            38: optionally concatenated with
        !            39: one or more of
        !            40: .BR vuaibcls .
        !            41: .I Afile\^
        !            42: is the archive file.
        !            43: The
        !            44: .I names\^
        !            45: are constituent files in the archive file.
        !            46: The meanings of the
        !            47: .I key\^
        !            48: characters are:
        !            49: .TP
        !            50: .B d
        !            51: Deletes the named files from the archive file.
        !            52: .TP
        !            53: .B r
        !            54: Replaces the named files in the archive file.
        !            55: If the optional character
        !            56: .B u
        !            57: is used with
        !            58: .BR r ,
        !            59: then only those files with
        !            60: modified dates later than
        !            61: the archive files are replaced.
        !            62: If an optional positioning character from the set
        !            63: .B abi
        !            64: is used, then the
        !            65: .I posname\^
        !            66: argument must be present
        !            67: and specifies that new files are to be placed
        !            68: after
        !            69: .RB ( a )
        !            70: or before
        !            71: .RB ( b
        !            72: or
        !            73: .BR i )
        !            74: .IR posname .
        !            75: Otherwise
        !            76: new files are placed at the end.
        !            77: .TP
        !            78: .B q
        !            79: Quickly appends the named files to the end of the archive file.
        !            80: Optional positioning characters are invalid.
        !            81: The command does not check whether the added members
        !            82: are already in the archive.
        !            83: Useful only to avoid quadratic behavior when creating a large
        !            84: archive piece-by-piece.
        !            85: .TP
        !            86: .B t
        !            87: Prints a table of contents of the archive file.
        !            88: If no names are given, all files in the archive are tabled.
        !            89: If names are given, only those files are tabled.
        !            90: .TP
        !            91: .B p
        !            92: Prints the contents of named files in the archive.
        !            93: .TP
        !            94: .B m
        !            95: Moves the named files to the end of the archive.
        !            96: If a positioning character is present,
        !            97: then the
        !            98: .I posname\^
        !            99: argument must be present and,
        !           100: as in
        !           101: .BR r ,
        !           102: specifies where the files are to be moved.
        !           103: .TP
        !           104: .B x
        !           105: Extracts the named files.
        !           106: If no names are given, all files in the archive are
        !           107: extracted.
        !           108: In neither case does
        !           109: .B x
        !           110: alter the archive file.
        !           111: .bp
        !           112: .TP
        !           113: .B v
        !           114: Verbose.
        !           115: Under the verbose option,
        !           116: .I mc68ar\^
        !           117: gives a file-by-file
        !           118: description of the making of a
        !           119: new archive file from the old archive and the constituent files.
        !           120: When used with
        !           121: .BR t ,
        !           122: it gives a long listing of all information about the files.
        !           123: When used with
        !           124: .BR x ,
        !           125: it precedes each file with a name.
        !           126: .TP
        !           127: .B c
        !           128: Create.
        !           129: Normally,
        !           130: .I mc68ar\^
        !           131: will create
        !           132: .I afile\^
        !           133: when it needs to.
        !           134: The create option suppresses the
        !           135: normal message that is produced when
        !           136: .I afile\^
        !           137: is created.
        !           138: .TP
        !           139: .B l
        !           140: Local.
        !           141: Normally,
        !           142: .I mc68ar\^
        !           143: places its temporary files in the directory
        !           144: .BR /tmp .
        !           145: This option causes them to be placed in the local directory.
        !           146: .TP
        !           147: .B s
        !           148: Symbol table creation.
        !           149: Forces the regeneration of the archive symbol table even if 
        !           150: .IR mc68ar (1) 
        !           151: is not invoked with a command which will modify the archive contents.
        !           152: This command is useful to restore the archive symbol table after the
        !           153: .IR mc68strip (1)
        !           154: command has been used on the archive.
        !           155: .SH FILES
        !           156: /tmp/ar\(**    temporaries
        !           157: .SH SEE ALSO
        !           158: mc68ld(1),
        !           159: mc68lorder(1),
        !           160: mc68strip(1).
        !           161: .br
        !           162: a.out(4), ar(4) in the \f2UNIX System V Programmer's Reference
        !           163: Manual\f1.
        !           164: .SH BUGS
        !           165: If the same file is mentioned twice in an argument list,
        !           166: it may be put in the archive twice.

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