LLVM-RANLIB(1) User Commands LLVM-RANLIB(1)NAME
llvm-ranlib - manual page for llvm-ranlib 3.9
DESCRIPTION
OVERVIEW: LLVM Archiver (llvm-ar)
This program archives bitcode files into single libraries
USAGE: llvm-ranlib [subcommand] [options] [relpos] [count] <ar‐
chive-file> [members]...
OPTIONS:
General options:
-M-
-aarch64-neon-syntax - Choose style of NEON
code to emit from AArch64 backend:
=generic
- Emit generic NEON assembly
=apple - Emit Apple-style NEON assembly
-amdgpu-fast-fdiv - Enable faster 2.5 ulp
fdiv
-bounds-checking-single-trap - Use one trap block
per function
-color - use colored syntax
highlighting (default=autodetect)
-disable-spill-fusing - Disable fusing of
spill code into instructions
-enable-implicit-null-checks - Fold null checks into
faulting memory operations
-enable-load-pre-
-enable-name-compression - Enable name string
compression
-enable-objc-arc-opts - enable/disable all
ARC Optimizations
-enable-scoped-noalias-
-enable-tbaa-
-exhaustive-register-search - Exhaustive Search for
registers bypassing the depth and interference cutoffs of last
chance recoloring
-expensive-combines - Enable expensive
instruction combines
-filter-print-funcs=<function names> - Only print IR for
functions whose name match this for all
print-[before|after][-all] options
-format - Archive format to
create
=default
- default
=gnu - gnu
=bsd - bsd
-gpsize=<uint> - Global Pointer
Addressing Size.
The default size is 8.
-imp-null-check-page-size=<int> - The page size of the
target in bytes
-internalize-public-api-file=<filename> - A file containing
list of symbol names to preserve
-internalize-public-api-list=<list> - A list of symbol
names to preserve
-join-liveintervals - Coalesce copies
(default=true)
-limit-float-precision=<uint> - Generate low-preci‐
sion inline sequences for some float libcalls
-merror-missing-parenthesis - Error for missing
parenthesis around predicate registers
-merror-noncontigious-register - Error for register
names that aren't contigious
-mfuture-regs - Enable future regis‐
ters
-mips-compact-branches - MIPS Specific: Com‐
pact branch policy.
=never
- Do not use compact branches if possible.
=optimal
- Use compact branches where appropiate (default).
=always
- Always use compact branches if possible.
-mips16-constant-islands - Enable mips16 con‐
stant islands.
-mips16-hard-float - Enable mips16 hard
float.
-mno-compound - Disable looking for
compound instructions for Hexagon
-mno-fixup - Disable fixing up
resolved relocations for Hexagon
-mno-ldc1-sdc1 - Expand double preci‐
sion loads and stores to their single precision counterparts
-mno-pairing - Disable looking for
duplex instructions for Hexagon
-mwarn-missing-parenthesis - Warn for missing
parenthesis around predicate registers
-mwarn-noncontigious-register - Warn for register
names that arent contigious
-mwarn-sign-mismatch - Warn for mismatching
a signed and unsigned value
-no-discriminators - Disable generation of
discriminator information.
-nvptx-sched4reg - NVPTX Specific:
schedule for register pressue
-plugin=<string> - plugin (ignored for
compatibility
-print-after-all - Print IR after each
pass
-print-before-all - Print IR before each
pass
-print-machineinstrs=<pass-name> - Print machine instrs
-r600-ir-structurize - Use StructurizeCFG IR
pass
-rdf-dump-
-rdf-limit=<uint> -
-regalloc - Register allocator to
use
=default
- pick register allocator based on -O option
=pbqp - PBQP register allocator
=greedy
- greedy register allocator
=fast - fast register allocator
=basic - basic register allocator
-rewrite-map-file=<filename> - Symbol Rewrite Map
-rng-seed=<seed> - Seed for the random
number generator
-sample-profile-check-record-coverage=<N> - Emit a warning if
less than N% of records in the input profile are matched to the
IR.
-sample-profile-check-sample-coverage=<N> - Emit a warning if
less than N% of samples in the input profile are matched to the
IR.
-sample-profile-inline-hot-threshold=<N> - Inlined functions
that account for more than N% of all samples collected in the
parent function, will be inlined again.
-sample-profile-max-propagate-iterations=<uint> - Maximum number of
iterations to go through when propagating sample block/edge
weights through the CFG.
-stackmap-version=<int> - Specify the stackmap
encoding version (default = 1)
-static-func-full-module-prefix - Use full module build
paths in the profile counter names for static functions.
-stats - Enable statistics
output from program (available with Asserts)
-stats-json - Display statistics as
json data
-summary-file=<string> - The summary file to
use for function importing.
-threads=<int> -
-time-passes - Time each pass,
printing elapsed time for each on exit
-verify-debug-info-
-verify-dom-info - Verify dominator info
(time consuming)
-verify-loop-info - Verify loop info
(time consuming)
-verify-machine-dom-info - Verify machine domi‐
nator info (time consuming)
-verify-regalloc - Verify during regis‐
ter allocation
-verify-region-info - Verify region info
(time consuming)
-verify-scev - Verify ScalarEvolu‐
tion's backedge taken counts (slow)
-verify-scev-maps - Verify no dangling
value in ScalarEvolution's ExprValueMap (slow)
-vp-counters-per-site=<number> - The average number of
profile counters allocated per value profiling site.
-vp-static-alloc - Do static counter
allocation for value profiler
-x86-asm-syntax - Choose style of code
to emit from X86 backend:
=att - Emit AT&T-style assembly
=intel - Emit Intel-style assembly
Generic Options:
-help - Display available
options (-help-hidden for more)
-help-list - Display list of
available options (-help-list-hidden for more)
-version - Display the version
of this program
OPERATIONS:
d[NsS] - delete file(s) from the archive
m[abiSs]
- move file(s) in the archive
p[kN] - print file(s) found in the archive
q[ufsS]
- quick append file(s) to the archive
r[abfiuRsS]
- replace or insert file(s) into the archive
t - display contents of archive
x[No] - extract file(s) from the archive
MODIFIERS (operation specific):
[a] - put file(s) after [relpos] [b] - put file(s) before [rel‐
pos] (same as [i]) [i] - put file(s) before [relpos] (same as
[b]) [o] - preserve original dates [s] - create an archive index
(cf. ranlib) [S] - do not build a symbol table [u] - update only
files newer than archive contents
MODIFIERS (generic):
[c] - do not warn if the library had to be created [v] - be ver‐
bose about actions taken
llvm-ranlib 3.9 December 2017 LLVM-RANLIB(1)
