xref: /llvm-project/llvm/docs/CommandGuide/llvm-lib.rst (revision fa9d232e4389bbd9ca82f8b6b34a1784107835fc)
13116f6ebSRafael Espindolallvm-lib - LLVM lib.exe compatible library tool
23116f6ebSRafael Espindola===============================================
33116f6ebSRafael Espindola
4*a056684cSJames Henderson.. program:: llvm-lib
53116f6ebSRafael Espindola
63116f6ebSRafael EspindolaSYNOPSIS
73116f6ebSRafael Espindola--------
83116f6ebSRafael Espindola
93116f6ebSRafael Espindola**llvm-lib** [/libpath:<path>] [/out:<output>] [/llvmlibthin]
103116f6ebSRafael Espindola[/ignore] [/machine] [/nologo] [files...]
113116f6ebSRafael Espindola
123116f6ebSRafael EspindolaDESCRIPTION
133116f6ebSRafael Espindola-----------
143116f6ebSRafael Espindola
153116f6ebSRafael EspindolaThe **llvm-lib** command is intended to be a ``lib.exe`` compatible
163116f6ebSRafael Espindolatool. See https://msdn.microsoft.com/en-us/library/7ykb2k5f for the
173116f6ebSRafael Espindolageneral description.
183116f6ebSRafael Espindola
193116f6ebSRafael Espindola**llvm-lib** has the following extensions:
203116f6ebSRafael Espindola
213116f6ebSRafael Espindola* Bitcode files in symbol tables.
223116f6ebSRafael Espindola  **llvm-lib** includes symbols from both bitcode files and regular
233116f6ebSRafael Espindola  object files in the symbol table.
243116f6ebSRafael Espindola
253116f6ebSRafael Espindola* Creating thin archives.
263116f6ebSRafael Espindola  The /llvmlibthin option causes **llvm-lib** to create thin archive
273116f6ebSRafael Espindola  that contain only the symbol table and the header for the various
283116f6ebSRafael Espindola  members. These files are much smaller, but are not compatible with
293116f6ebSRafael Espindola  link.exe (lld can handle them).
30