xref: /openbsd-src/gnu/llvm/llvm/docs/CommandGuide/llvm-lib.rst (revision 09467b48e8bc8b4905716062da846024139afbf2)
1*09467b48Spatrickllvm-lib - LLVM lib.exe compatible library tool
2*09467b48Spatrick===============================================
3*09467b48Spatrick
4*09467b48Spatrick.. program:: llvm-lib
5*09467b48Spatrick
6*09467b48SpatrickSYNOPSIS
7*09467b48Spatrick--------
8*09467b48Spatrick
9*09467b48Spatrick**llvm-lib** [/libpath:<path>] [/out:<output>] [/llvmlibthin]
10*09467b48Spatrick[/ignore] [/machine] [/nologo] [files...]
11*09467b48Spatrick
12*09467b48SpatrickDESCRIPTION
13*09467b48Spatrick-----------
14*09467b48Spatrick
15*09467b48SpatrickThe **llvm-lib** command is intended to be a ``lib.exe`` compatible
16*09467b48Spatricktool. See https://msdn.microsoft.com/en-us/library/7ykb2k5f for the
17*09467b48Spatrickgeneral description.
18*09467b48Spatrick
19*09467b48Spatrick**llvm-lib** has the following extensions:
20*09467b48Spatrick
21*09467b48Spatrick* Bitcode files in symbol tables.
22*09467b48Spatrick  **llvm-lib** includes symbols from both bitcode files and regular
23*09467b48Spatrick  object files in the symbol table.
24*09467b48Spatrick
25*09467b48Spatrick* Creating thin archives.
26*09467b48Spatrick  The /llvmlibthin option causes **llvm-lib** to create thin archive
27*09467b48Spatrick  that contain only the symbol table and the header for the various
28*09467b48Spatrick  members. These files are much smaller, but are not compatible with
29*09467b48Spatrick  link.exe (lld can handle them).
30