LLVM-CGDATA(1)

NAME
llvm-cgdata - LLVM CodeGen Data Tool

SYNOPSIS

llvm-cgdata [commands] [options] (<binaries>|<.cgdata>)

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.

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.

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.

EXAMPLES

To convert a .cgdata file from binary to text format:
    $ llvm-cgdata --convert --format=text input.cgdata --output=output.data

To merge multiple raw codegen data in object files into a single .cgdata file:
    $ llvm-cgdata --merge file1.o file2.o --output=merged.cgdata

To show summary information about a .cgdata file:
    $ llvm-cgdata --show input.cgdata

Author
Maintained by the LLVM Team (https://llvm.org/).

Copyright
2003-2026, LLVM Project