![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to mc68ar.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10dc / 630 / man / src / u_man / man1|
Return to mc68ar.1 CVS log | Up to [Research Unix] / researchv10dc / 630 / man / src / u_man / man1 |
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.