LLVM-CGDATA(1)                       LLVM                       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-2025, LLVM Project

20                                2025-06-05                    LLVM-CGDATA(1)