llvm-cgdata - LLVM CodeGen Data Tool
Contents
Commands
At least one of the following commands are required:
--convert
Convert a .cgdata file from one format to another.
--merge
Merge multiple raw codgen data in binaries into a single .cgdata file.
--show Show summary information about a .cgdata file.
Copyright
2003-2025, LLVM Project
15 2025-04-03 LLVM-CGDATA(1)
Description
The :program:llvm-cgdata utility parses raw codegen data embedded in compiled binary files and merges
them into a single .cgdata file. It can also inspect and manipulate .cgdata files. Currently, the tool
supports saving and restoring outlined hash trees and stable function maps, allowing for more efficient
function outlining and function merging across modules in subsequent compilations. The design is
extensible, allowing for the incorporation of additional codegen summaries and optimization techniques.
Examples
Toconverta.cgdatafilefrombinarytotextformat:
$ llvm-cgdata –convert –format=text input.cgdata –output=output.data
Tomergemultiplerawcodegendatainobjectfilesintoasingle.cgdatafile:
$ llvm-cgdata –merge file1.o file2.o –output=merged.cgdata
Toshowsummaryinformationabouta.cgdatafile:
$ llvm-cgdata –show input.cgdata
Name
llvm-cgdata - LLVM CodeGen Data Tool
Options
llvm-cgdata supports the following options:
--format=[text|binary]
Specify the format of the output .cgdata file.
--output=<string>
Specify the output file name.
--cgdata-version
Print the version of the llvm-cgdata tool.
Synopsis
llvm-cgdata [commands] [options] (<binaries>|<.cgdata>)
