DESCRIPTION

OVERVIEW: LLVM Archiver (llvm-ar)

  • This program archives bitcode files into single libraries

USAGE: llvm-ranlib [options] [relpos] [count] <archive-file> [members]...

OPTIONS:

-asm-verbose - Add comments to directives. -bounds-checking-single-trap - Use one trap block per function -cppfname=<function name> - Specify the name of the generated function -cppfor=<string> - Specify the name of the thing to generate -cppgen - Choose what kind of output to generate

=program

- Generate a complete program

=module

- Generate a module definition

=contents

- Generate contents of a module

=function

- Generate a function definition

=functions

- Generate all function definitions

=inline

- Generate an inline function

=variable

- Generate a variable definition

=type

- Generate a type definition -disable-debug-info-verifier - -disable-spill-fusing - Disable fusing of spill code into instructions -enable-correct-eh-support - Make the -lowerinvoke pass insert expensive, but correct, EH code -enable-load-pre - -enable-objc-arc-opts - enable/disable all ARC Optimizations -enable-tbaa - -fatal-assembler-warnings - Consider warnings as error -fdata-sections - Emit data into separate sections -ffunction-sections - Emit functions into separate sections -help - Display available options (-help-hidden for more) -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-precision inline sequences for some float libcalls -mc-x86-disable-arith-relaxation - Disable relaxation of arithmetic instruction for X86 -mips16-hard-float - MIPS: mips16 hard float enable. -mno-ldc1-sdc1 - Expand double precision loads and stores to their single precision counterparts -nvptx-sched4reg - NVPTX Specific: schedule for register pressue -pre-RA-sched - Instruction schedulers available (before register allocation):

=vliw-td

- VLIW scheduler

=list-ilp

- Bottom-up register pressure aware list scheduling which tries to balance ILP and register pressure

=list-hybrid

- Bottom-up register pressure aware list scheduling which tries to balance latency and register pressure

=source

- Similar to list-burr but schedules in source order when possible

=list-burr

- Bottom-up register reduction list scheduling

=linearize

- Linearize DAG, no scheduling

=fast

- Fast suboptimal list scheduling

=default

- Best scheduler for the target -print-after-all - Print IR after each pass -print-before-all - Print IR before each pass -print-machineinstrs=<pass-name> - Print machine instrs -regalloc - Register allocator to use

=default

- pick register allocator based on -O option

=basic

- basic register allocator

=fast

- fast register allocator

=greedy

- greedy register allocator

=pbqp

- PBQP register allocator -spiller - Spiller to use: (default: standard)

=trivial

- trivial spiller

=inline

- inline spiller -stats - Enable statistics output from program (available with Asserts) -time-passes - Time each pass, printing elapsed time for each on exit -verify-dom-info - Verify dominator info (time consuming) -verify-loop-info - Verify loop info (time consuming) -verify-regalloc - Verify during register allocation -verify-region-info - Verify region info (time consuming) -verify-scev - Verify ScalarEvolution's backedge taken counts (slow) -version - Display the version of this program -x86-asm-syntax - Choose style of code to emit from X86 backend:

=att

- Emit AT&T-style assembly

=intel

- Emit Intel-style assembly

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 [relpos] (same as [i]) [i] - put file(s) before [relpos] (same as [b]) [N] - use instance [count] of name [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 verbose about actions taken

RELATED TO llvm-ranlib-3.4…

The full documentation for llvm-ranlib is maintained as a Texinfo manual. If the info and llvm-ranlib programs are properly installed at your site, the command

  • info llvm-ranlib

should give you access to the complete manual.