Lines Matching +full:- +full:- +full:files
1 llvm-ar - LLVM archiver
4 .. program:: llvm-ar
7 --------
9 :program:`llvm-ar` [-]{dmpqrstx}[abcDilLNoOPsSTuUvV] [relpos] [count] archive [files...]
12 -----------
14 The :program:`llvm-ar` command is similar to the common Unix utility,
15 :program:`ar`. It archives several files, such as objects and LLVM bitcode
16 files into a single archive library that can be linked into a program. However,
17 the archive can contain any kind of file. By default, :program:`llvm-ar`
21 The :program:`llvm-ar` command can be used to *read* archive files in SVR4, GNU,
23 Darwin style archive files. If an SVR4 format archive is used with the :option:`r`
26 defined by :option:`--format`.
28 Here's where :program:`llvm-ar` departs from previous :program:`ar`
33 [f] - truncate inserted filenames
37 --plugin=<string> - load a plugin which adds support for other file formats
39 [l] - ignored in :program:`ar`
43 Since :program:`llvm-ar` supports bitcode files, the symbol table it creates
48 By default, :program:`llvm-ar` always uses zero for timestamps and UIDs/GIDs
56 When on Windows :program:`llvm-ar` treats the names of archived *files* in the same
57 case sensitive manner as the operating system. When on a non-Windows machine
58 :program:`llvm-ar` does not consider character case.
61 -------
63 :program:`llvm-ar` operations are compatible with other :program:`ar`
66 :program:`llvm-ar` specify a single basic Operation to perform on the archive,
68 optional list of file names. If the *files* option is not specified, it
80 Delete files from the ``archive``. The :option:`N` and :option:`T` modifiers
81 apply to this operation. The *files* options specify which members should be
83 appear in the archive. If no *files* are specified, the archive is not
88 Move files from one location in the ``archive`` to another. The :option:`a`,
89 :option:`b`, and :option:`i` modifiers apply to this operation. The *files*
91 used, the files will be moved to the end of the archive. If no *files* are
96 Print *files* to the standard output stream. If no *files* are specified, the
98 :program:`llvm-ar` also prints out the name of the file being output. Printing
99 binary files is ill-advised as they might confuse your terminal settings. The
104 Quickly append files to the end of the ``archive`` without removing
105 duplicates. If no *files* are specified, the archive is not modified. The
126 Replace existing *files* or insert them at the end of the ``archive`` if
128 modifiers apply to this operation. If no *files* are specified, the archive
136 modifier, :program:`llvm-ar` also prints out the file type (B=bitcode,
138 are ignored when extracting *files* and set to placeholder values when adding
140 any *files* are specified, the listing is only for those files. If no *files*
145 A synonym for the :option:`--version` option.
149 Extract ``archive`` members back to files. The :option:`o` modifier applies
150 to this operation. This operation retrieves the indicated *files* from the
152 *files* are specified, the entire archive is extracted.
162 When inserting or moving member files, this option specifies the destination
163 of the new files as being after the *relpos* member. If *relpos* is not found,
164 the files are placed at the end of the ``archive``. *relpos* cannot be
169 When inserting or moving member files, this option specifies the destination
170 of the new files as being before the *relpos* member. If *relpos* is not
171 found, the files are placed at the end of the ``archive``. *relpos* cannot
182 is a feature for :program:`llvm-ar` that is not found in gnu-ar.
194 When extracting files, use the modification times of any *files* as they
195 appear in the ``archive``. By default *files* extracted from the archive
204 Alias for ``--thin``. In many ar implementations ``T`` has a different
209 When printing *files* or the ``archive`` table of contents, this modifier
210 instructs :program:`llvm-ar` to include additional information in the output.
220 :program:`llvm-ar` will always create the archive if it doesn't exist.
221 Normally, :program:`llvm-ar` will print a warning message indicating that the
241 files in the archive. By default :program:`llvm-ar` generates symbol tables in
247 :program:`llvm-ar` to not build the symbol table. If both :option:`s` and
252 Only update ``archive`` members with *files* that have more recent
262 .. option:: --format=<type>
265 When creating an ``archive`` with the default ``<type>``, :program:``llvm-ar``
266 will attempt to infer it from the input files and fallback to the default
269 .. option:: -h, --help
271 Print a summary of command-line options and their meanings.
273 .. option:: -M
278 .. option:: --output=<dir>
283 .. option:: --rsp-quoting=<type>
284 This option selects the quoting style ``<type>`` for response files, either
288 .. option:: --thin
294 .. option:: --version
296 Display the version of the :program:`llvm-ar` executable.
298 .. option:: -X mode
300 Specifies the type of object file :program:`llvm-ar` will recognise. The mode must be
304 Process only 32-bit object files.
306 Process only 64-bit object files.
308 Process both 32-bit and 64-bit object files.
310 Process all object files.
312 The default is to process 32-bit object files (ignore 64-bit objects). The mode can also
314 process any 64-bit objects and ignore 32-bit objects. The -X flag overrides the OBJECT_MODE
319 Read command-line options and commands from response file ``<FILE>``.
322 -----------
324 :program:`llvm-ar` understands a subset of the MRI scripting interface commonly
326 sequence of commands to be executed by the archiver. The :option:`-M` option
327 allows for an MRI script to be passed to :program:`llvm-ar` through the
330 Note that :program:`llvm-ar` has known limitations regarding the use of MRI
378 -----------
380 If :program:`llvm-ar` succeeds, it will exit with 0. Otherwise, if an error occurs, it
381 will exit with a non-zero value.