Man Linux: Main Page and Category List


       LDC - manual page for the LLVM D Compiler


       OVERVIEW: LLVM-based D Compiler

       USAGE: ldc [options] files --run program args...

       -D                                           - Generate documentation

       -Dd=<docdir>                                 - Write documentation file
              to <docdir> directory

       -Df=<filename>                               - Write documentation file
              to <filename>

       -H                                           - Generate 'header' file

       -Hd=<hdrdir>                                  -  Write 'header' file to
              <hdrdir> directory

       -Hf=<filename>                               - Write 'header'  file  to

       -I=<path>                                      -   Where  to  look  for

       -J=<path>                                    - Where to look for string

       -L=<linkerflag>                              - Pass <linkerflag> to the

              Setting the optimization level:

       -O                                         - Equivalent to -O2

       -O0                                        - No optimizations (default)

       -O1                                        - Simple optimizations

       -O2                                        - Good optimizations

       -O3                                        - Aggressive optimizations

       -O4                                        - Link-time optimization

       -O5                                        - Link-time optimization

       -annotate                                     -  Annotate  the  bitcode
              with human readable source code

       -asm-verbose                                   -   Add   comments    to

       -c                                           - Do not link

       -check-printf-calls                           -  Validate  printf  call
              format strings against arguments

       -code-model                                  - Choose code model

              -   Target default code model

       =small -   Small code model

              -   Kernel code model

              -   Medium code model

       =large -   Large code model

       -d                                             -    Allow    deprecated
              language features

       -d-debug=<level/idents>                      - Compile in debug code >=
              <level> or identified by <idents>.

       -d-version=<level/idents>                    - Compile in version  code
              >= <level> or identified by <idents>

       -debuglib=<lib,...>                           -  Set  default libraries
              for debug build

       -defaultlib=<lib,...>                        -  Set  default  libraries
              for non-debug build

       -deps=<filename>                                 -     Write     module
              dependencies to filename

       -enable-asserts                              - (*) Enable assertions

       -enable-boundscheck                          - (*) Enable array  bounds

       -enable-contracts                            - (*) Enable function pre-
              and post-conditions

       -disable-d-passes                              -   Disable   D-specific
              passes in -O<N>

       -disable-excess-fp-precision                  -  Disable  optimizations
              that may increase FP precision

       -disable-fp-elim                             -  Disable  frame  pointer
              elimination optimization

       -disable-gc2stack                             - Disable promotion of GC
              allocations to stack memory in -O<N>

       -enable-inlining                              -  (*)  Enable   function
              inlining in -O<N>

       -enable-invariants                           - (*) Enable invariants

       -disable-post-RA-scheduler                   - Disable scheduling after
              register allocation

       -enable-postconditions                        -  (*)  Enable   function

       -enable-preconditions                          -  (*)  Enable  function

       -disable-simplify-drtcalls                   -  Disable  simplification
              of runtime calls in -O<N>

       -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-eh                                    -  Emit  DWARF  exception
              handling (default if target supports)

       -enable-finite-only-fp-math                   -  Enable   optimizations
              that assumes non- NaNs / +-Infs

       -enable-fp-mad                                - Enable less precise MAD
              instructions to be generated

       -enable-load-pre                             -

       -enable-sjlj-eh                               -  Emit  SJLJ   exception
              handling (default if target supports)

       -enable-unsafe-fp-math                         -  Enable  optimizations
              that may decrease FP precision

       -float-abi                                   - Choose float ABI type

              -   Target default float ABI type

       =soft  -   Soft float ABI (implied by -soft-float)

       =hard  -   Hard float ABI (uses FP registers)

              Generating debug information:

       -g                                         - Generate debug information

       -gc                                        - Same as -g, but pretend to
              be C

       -help                                          -   Display    available
              options (--help-hidden for more)

       -ignore                                        -   Ignore   unsupported

       -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

       -limit-float-precision=<uint>                 -  Generate low-precision
              inline sequences for some float libcalls

       -m32                                         - 32 bit target

       -m64                                         - 64 bit target

       -march=<string>                              - Architecture to generate
              code for:

       -mattr=<a1,+a2,-a3,...>                         -    Target    specific
              attributes (-mattr=help for details)

       -mcpu=<cpu-name>                             - Target  a  specific  cpu
              type (-mcpu=help for details)

       -mtriple=<string>                            - Override target triple

       -nested-ctx                                    -  How  to  construct  a
              nested function's context:

       =array -   Array of pointers to variables (including multi-level)

              -   List of pointers to structs of variables, one per level.

       -noasm                                       - Disallow use  of  inline

       -nodefaultlib                                 -  Don't  add  a  default
              library for linking implicitly

       -noruntime                                   - Do not allow  code  that
              generates implicit runtime calls

       -noverify                                      -   Do   not   run   the
              validation pass before writing bitcode

       -nozero-initialized-in-bss                       -     Don't      place
              zero-initialized symbols into bss section

       -o-                                          - Do not write object file

       -od=<objdir>                                 - Write  object  files  to
              directory <objdir>

       -of=<filename>                               - Use <filename> as output
              file name

       -op                                          - Do not strip paths  from
              source file

       -oq                                           - Write object files with
              fully qualified names

       -output-bc                                   - Write LLVM bitcode

       -output-ll                                   - Write LLVM IR

       -output-o                                    - Write native object

       -output-s                                    - Write native assembly

       -pre-RA-sched                                -  Instruction  schedulers
              available (before register allocation):

       =fast  -   Fast suboptimal list scheduling

              -   Top-down list scheduler

              -   Top-down register reduction list scheduling

              -   Bottom-up register reduction list scheduling

              -   Best scheduler for the target

       -print-machineinstrs                          - Print generated machine

       -profile-estimator-loop-weight=<loop-weight>   -   Number    of    loop
              executions used for profile-estimator

       -profile-info-file=<filename>                 -  Profile file loaded by

       -profile-randomness                          - How to  randomly  choose
              to profile:

              -   global counter

              -   register allocated global counter

       =rdcc  -   cycle counter

       -realign-stack                               - Realign stack if needed

       -regalloc                                     -  Register  allocator to
              use: (default = linearscan)

              -   linear scan register allocator

       -release                                       -   Disables    asserts,
              invariants, contracts and boundscheck

       -relocation-model                            - Choose relocation model

              -   Target default relocation model

              -   Non-relocatable code

       =pic   -   Fully relocatable, position independent code

              -   Relocatable external references, non-relocatable code

       -rewriter                                      -   Rewriter   to   use:
              (default: local)

       =local -   local rewriter

              -   trivial rewriter

       -run=<string>                                - program args...

       -schedule-livein-copies                       -  Schedule   copies   of
              livein registers

       -schedule-spills                             - Schedule spill code

       -shrink-wrap                                 - Shrink wrap callee-saved
              register spills/restores

       -singleobj                                   -  Create  only  a  single
              output object file

       -soft-float                                     -   Generate   software
              floating point library calls

       -stack-alignment=<uint>                      - Override  default  stack

       -stack-protector-buffer-size=<uint>          - Lower bound for a buffer
              to be considered for stack protection

       -stats                                       - Enable statistics output
              from program

       -tailcallopt                                   -   Turn  on  tail  call

       -time-passes                                 - Time each pass, printing
              elapsed time for each on exit

       -unittest                                    - Compile in unit tests

       -unwind-tables                                 -   Generate   unwinding
              tables for all functions

       -v                                           - Verbose

       -v-cg                                        - Verbose codegen

       -verify-dom-info                             -  Verify  dominator  info
              (time consuming)

       -version                                      -  Display the version of
              this program

       -vv                                          - Very verbose

       -w                                           - Enable warnings

       -x86-asm-syntax                              - Choose style of code  to
              emit from X86 backend:

       =att   -   Emit AT&T-style assembly

       =intel -   Emit Intel-style assembly

       -d-debug  can  also  be  specified  without  options,  in which case it
       enables all debug checks (i.e.  (asserts,  boundchecks,  contracts  and
       invariants) as well as acting as -d-debug=1

       Options  marked with (*) also have a -disable-FOO variant with inverted

       based on DMD v1.051 and llvm 2.6 (Wed Dec  2 17:39:53  2009)  Copyright
       (c)  1999-2009  by  Digital  Mars  and Tomas Lindquist Olsen written by
       Walter Bright and  Tomas  Lindquist  Olsen  D  Language  Documentation:        LDC        Homepage:


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

              info LLVM

       should give you access to the complete manual.