Lines Matching +full:- +full:- +full:option
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,
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,
23 archive files. If an SVR4 format archive is used with the :option:`r`
24 (replace), :option:`d` (delete), :option:`m` (move) or :option:`q`
26 defined by :option:`--format`.
28 Here's where :program:`llvm-ar` departs from previous :program:`ar`
31 *The following option is not supported*
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
50 :option:`D` modifier being enabled by default. If you wish to maintain
52 :option:`U` modifier to write actual 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`
64 implementations. However, there are a few modifiers (:option:`L`) that are not
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
78 .. option:: d [NT]
80 Delete files from the ``archive``. The :option:`N` and :option:`T` modifiers
86 .. option:: m [abi]
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*
94 .. option:: p [v]
97 entire ``archive`` is printed. With the :option:`v` modifier,
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
100 :option:`p` operation never modifies the archive.
102 .. option:: q [LT]
107 :option:`L` and :option:`T` modifiers are used:
110 file. If the :option:`L` modifier is specified the members will be appended
113 * Appending a regular archive to a thin archive requires the :option:`T`
114 modifier and will append the archive file. The :option:`L` modifier is not
118 If the :option:`L` modifier is specified the members will be appended
124 .. option:: r [abTu]
127 they do not exist. The :option:`a`, :option:`b`, :option:`T` and :option:`u`
132 .. option:: t [vO]
135 the names of the members to the standard output stream. With the :option:`v`
136 modifier, :program:`llvm-ar` also prints out the file type (B=bitcode,
139 size, and the date. With the :option:`O` modifier, display member offsets. If
143 .. option:: V
145 A synonym for the :option:`--version` option.
147 .. option:: x [oP]
149 Extract ``archive`` members back to files. The :option:`o` modifier applies
160 .. option:: a
162 When inserting or moving member files, this option specifies the destination
165 consumed without either :option:`a`, :option:`b` or :option:`i`.
167 .. option:: b
169 When inserting or moving member files, this option specifies the destination
172 be consumed without either :option:`a`, :option:`b` or :option:`i`. This
173 modifier is identical to the :option:`i` modifier.
175 .. option:: i
177 A synonym for the :option:`b` option.
179 .. option:: L
182 is a feature for :program:`llvm-ar` that is not found in gnu-ar.
184 .. option:: N
189 instance. If :option:`N` is not specified the first member of that name will
192 .. option:: o
198 .. option:: O
202 .. option:: T
204 When creating or modifying an archive, this option specifies that the
209 .. option:: v
212 instructs :program:`llvm-ar` to include additional information in the output.
219 .. option:: c
221 For the :option:`r` (replace)and :option:`q` (quick update) operations,
222 :program:`llvm-ar` will always create the archive if it doesn't exist.
223 Normally, :program:`llvm-ar` will print a warning message indicating that the
227 .. option:: D
231 .. option:: P
238 .. option:: s
243 files in the archive. By default :program:`llvm-ar` generates symbol tables in
246 .. option:: S
248 This modifier is the opposite of the :option:`s` modifier. It instructs
249 :program:`llvm-ar` to not build the symbol table. If both :option:`s` and
250 :option:`S` are used, the last modifier to occur in the options will prevail.
252 .. option:: u
257 .. option:: U
264 .. option:: --format=<type>
266 This option allows for default, gnu, darwin or bsd ``<type>`` to be selected.
270 .. option:: -h, --help
272 Print a summary of command-line options and their meanings.
274 .. option:: -M
276 This option allows for MRI scripts to be read through the standard input
277 stream. No other options are compatible with this option.
279 .. option:: --version
281 Display the version of the :program:`llvm-ar` executable.
283 .. option:: @<FILE>
285 Read command-line options and commands from response file ``<FILE>``.
288 -----------
290 :program:`llvm-ar` understands a subset of the MRI scripting interface commonly
292 sequence of commands to be executed by the archiver. The :option:`-M` option
293 allows for an MRI script to be passed to :program:`llvm-ar` through the
296 Note that :program:`llvm-ar` has known limitations regarding the use of MRI
307 whitespace. An MRI script should begin with either a :option:`CREATE` or
308 :option:`CREATETHIN` command and will typically end with a :option:`SAVE`
311 .. option:: CREATE archive
316 .. option:: CREATETHIN archive
321 .. option:: ADDLIB archive
325 .. option:: ADDMOD <file>
329 .. option:: DELETE <file>
334 .. option:: SAVE
337 :option:`CREATE`/:option:`CREATETHIN` command.
339 .. option:: END
344 -----------
346 If :program:`llvm-ar` succeeds, it will exit with 0. Otherwise, if an error occurs, it
347 will exit with a non-zero value.