1 .\" Copyright (c) 2007 Joseph Koshy. All rights reserved.
3 .\" Redistribution and use in source and binary forms, with or without
4 .\" modification, are permitted provided that the following conditions
6 .\" 1. Redistributions of source code must retain the above copyright
7 .\" notice, this list of conditions and the following disclaimer.
8 .\" 2. Redistributions in binary form must reproduce the above copyright
9 .\" notice, this list of conditions and the following disclaimer in the
10 .\" documentation and/or other materials provided with the distribution.
12 .\" This software is provided by Joseph Koshy ``as is'' and
13 .\" any express or implied warranties, including, but not limited to, the
14 .\" implied warranties of merchantability and fitness for a particular purpose
15 .\" are disclaimed. in no event shall Joseph Koshy be liable
16 .\" for any direct, indirect, incidental, special, exemplary, or consequential
17 .\" damages (including, but not limited to, procurement of substitute goods
18 .\" or services; loss of use, data, or profits; or business interruption)
19 .\" however caused and on any theory of liability, whether in contract, strict
20 .\" liability, or tort (including negligence or otherwise) arising in any way
21 .\" out of the use of this software, even if advised of the possibility of
46 .Op Fl a Ar position-after
47 .Op Fl b Ar position-before
49 .Op Fl i Ar position-before
76 .Op Fl a Ar position-after
77 .Op Fl b Ar position-before
81 .Op Fl i Ar position-before
119 utility creates and maintains groups of files combined into an
121 Once an archive has been created, new files can be added to it, and
122 existing files can be extracted, deleted or replaced.
124 Files are named in the archive by their last file name component,
125 so if a file referenced by a path containing a
127 is archived, it will be named by the last component of the path.
128 Similarly when matching paths listed on the command line against
129 file names stored in the archive, only the last component of the
130 path will be compared.
134 is for the creation and maintenance of libraries suitable for use
137 although it is not restricted to this purpose.
140 utility can create and manage an archive symbol table (see
142 used to speed up link editing operations.
143 If a symbol table is present in an archive, it will be
144 kept up-to-date by subsequent operations on the archive.
148 utility is used to add an archive symbol table
149 to an existing archive.
153 utility supports the following options:
154 .Bl -tag -width indent
155 .It Fl a Ar member-after
156 When used with option
158 this option specifies that the archive members specified by
161 are moved to after the archive member named by argument
163 When used with option
165 this option specifies that the files specified by arguments
167 are added after the archive member named by argument
169 .It Fl b Ar member-before
170 When used with option
172 this option specifies that the archive members specified by
175 are moved to before the archive member named by argument
177 When used with option
179 this option specifies that the files specified by arguments
181 are added before the archive member named by argument
184 Suppress the informational message printed when a new archive is
191 Prevent extracted files from replacing like-named files
194 Delete the members named by arguments
196 from the archive specified by argument
198 The archive's symbol table, if present, is updated to reflect
199 the new contents of the archive.
201 When used in combination with the
205 option, insert 0's instead of the real mtime, uid and gid values
206 and 0644 instead of file mode from the members named by arguments
208 This ensures that checksums on the resulting archives are reproducible
209 when member contents are identical.
211 Synonymous with option
213 .It Fl i Ar member-before
214 Synonymous with option
217 This option is accepted but ignored.
219 This option is accepted for compatibility with GNU
223 Move archive members specified by arguments
226 If a position has been specified by one of the
231 options, the members are moved to before or after the specified
233 If no position has been specified, the specified members are moved
234 to the end of the archive.
235 If the archive has a symbol table, it is updated to reflect the
236 new contents of the archive.
238 Read and execute MRI librarian commands from standard input.
240 Preserve the original modification times of members when extracting
243 Write the contents of the specified archive members named by
247 If no members were specified, the contents of all the files in the
248 archive are written in the order they appear in the archive.
250 Append the files specified by arguments
252 to the archive specified by argument
254 without checking if the files already exist in the archive.
255 The archive symbol table will be updated as needed.
256 If the file specified by the argument
258 does not already exist, a new archive will be created.
260 Replace (add) the files specified by arguments
262 in the archive specified by argument
264 creating the archive if necessary.
265 Replacing existing members will not change the order of members within
267 If a file named in arguments
269 does not exist, existing members in the archive that match that
270 name are not changed.
271 New files are added to the end of the archive unless one of the
278 The archive symbol table, if it exists, is updated to reflect the
279 new state of the archive.
281 Add an archive symbol table (see
283 to the archive specified by argument
289 option alone is equivalent to invoking
292 Do not generate an archive symbol table.
294 List the files specified by arguments
296 in the order in which they appear in the archive, one per line.
297 If no files are specified, all files in the archive are listed.
299 Use only the first fifteen characters of the archive member name or
300 command line file name argument when naming archive members.
302 Conditionally update the archive or extract members.
305 option, files named by arguments
307 will be replaced in the archive if they are newer than their
311 option, the members specified by arguments
313 will be extracted only if they are newer than the corresponding
314 files in the file system.
316 Provide verbose output.
325 gives a file-by-file description of the archive modification being
326 performed, which consists of three white-space separated fields:
327 the option letter, a dash
334 displays the description as above, but the initial letter is an
336 if the file is added to the archive, or an
338 if the file replaces a file already in the archive.
341 option, the name of the file enclosed in
345 characters is written to standard output preceded by a single newline
346 character and followed by two newline characters.
347 The contents of the named file follow the file name.
352 displays eight whitespace separated fields:
353 the file permissions as displayed by
355 decimal user and group IDs separated by a slash (
357 the file size in bytes, the file modification time in
360 .Dq "%b %e %H:%M %Y" ,
361 and the name of the file.
363 Print a version string and exit.
365 Extract archive members specified by arguments
367 into the current directory.
368 If no members have been specified, extract all members of the archive.
369 If the file corresponding to an extracted member does not exist it
371 If the file corresponding to an extracted member does exist, its owner
372 and group will not be changed while its contents will be overwritten
373 and its permissions will set to that entered in the archive.
374 The file's access and modification time would be that of the time
375 of extraction unless the
377 option was specified.
379 This option is accepted but ignored.
382 To create a new archive
384 containing three files
390 .Dl "ar -rc ex.a ex1.o ex2.o ex3.o"
392 To add an archive symbol table to an existing archive
402 .D1 "ar -d ex.a ex1.o"
404 To verbosely list the contents of archive
417 .Sh STANDARDS COMPLIANCE
420 utility's support for the
436 options is believed to be compliant with
441 command first appeared in AT&T UNIX Version 1.
444 .An "Kai Wang" Aq kaiw@FreeBSD.org