110 lines · plain
1llvm-link - LLVM bitcode linker2===============================3 4.. program:: llvm-link5 6SYNOPSIS7--------8 9:program:`llvm-link` [*options*] *filename ...*10 11DESCRIPTION12-----------13 14:program:`llvm-link` takes several LLVM bitcode files and links them together15into a single LLVM bitcode file. It writes the output file to standard output,16unless the :option:`-o` option is used to specify a filename.17 18OPTIONS19-------20 21.. option:: -f22 23 Enable binary output on terminals. Normally, :program:`llvm-link` will refuse24 to write raw bitcode output if the output stream is a terminal. With this25 option, :program:`llvm-link` will write raw bitcode regardless of the output26 device.27 28.. option:: -o filename29 30 Specify the output file name. If ``filename`` is "``-``", then31 :program:`llvm-link` will write its output to standard output.32 33.. option:: -S34 35 Write output in LLVM intermediate language (instead of bitcode).36 37.. option:: -d38 39 If specified, :program:`llvm-link` prints a human-readable version of the40 output bitcode file to standard error.41 42.. option:: --help43 44 Print a summary of command line options.45 46.. option:: -v47 48 Verbose mode. Print information about what :program:`llvm-link` is doing.49 This typically includes a message for each bitcode file linked in and for each50 library found.51 52.. option:: --override <filename>53 54 Adds the passed-in file to the link and overrides symbols that have already55 been declared with the definitions in the file that is passed in. This flag56 can be specified multiple times to have multiple files act as overrides. If57 a symbol is declared more than twice, the definition from the file declared58 last takes precedence.59 60.. option:: --import <function:filename>61 62 Specify a function that should be imported from the specified file for63 linking with ThinLTO. This option can be specified multiple times to import64 multiple functions.65 66.. option:: --summary-index <filename>67 68 Specify the path to a file containing the module summary index with the69 results of an earlier ThinLTO link. This option is required when 70 `--import` is used.71 72.. option:: --internalize73 74 Internalize the linked symbols.75 76.. option:: --disable-debug-info-type-map77 78 Disables the use of a uniquing type map for debug info.79 80.. option:: --only-needed81 82 Link only needed symbols.83 84.. option:: --disable-lazy-loading85 86 Disable lazy module loading.87 88.. option:: --suppress-warnings89 90 Suppress all linker warnings.91 92.. option:: --preserve-bc-uselistorder93 94 Preserve the use-list order when writing LLVM bitcode.95 96.. option:: --preserve-ll-uselistorder97 98 Preserve the use-list order when writing LLVM assembly.99 100.. option:: --ignore-non-bitcode101 102 Do not error out when a non-bitcode file is encountered while processing103 an archive.104 105EXIT STATUS106-----------107 108If :program:`llvm-link` succeeds, it will exit with 0. Otherwise, if an error109occurs, it will exit with a non-zero value.110