Developer reports

CMake compile-setting origins

Trace source compile groups and settings to File API backtrace records.

Your inputs

Start with an example

One CMake File API target-v2 JSON reply

{
  "name": "app",
  "id": "app::example",
  "type": "EXECUTABLE",
  "paths": {
    "source": ".",
    "build": "."
  },
  "sources": [
    {
      "path": "src/main.cpp",
      "compileGroupIndex": 0,
      "backtrace": 0
    },
    {
      "path": "include/api.h"
    }
  ],
  "compileGroups": [
    {
      "language": "CXX",
      "sourceIndexes": [
        0
      ],
      "languageStandard": {
        "standard": "20"
      },
      "includes": [
        {
          "path": "/opt/sdk/include",
          "isSystem": true,
          "backtrace": 1
        }
      ],
      "defines": [
        {
          "define": "MODE=1",
          "backtrace": 2
        }
      ],
      "compileCommandFragments": [
        {
          "fragment": "-O2"
        }
      ]
    }
  ],
  "backtraceGraph": {
    "files": [
      "CMakeLists.txt",
      "cmake/options.cmake"
    ],
    "commands": [
      "add_executable",
      "target_include_directories",
      "target_compile_definitions",
      "include"
    ],
    "nodes": [
      {
        "file": 0,
        "line": 3,
        "command": 0
      },
      {
        "file": 1,
        "line": 5,
        "command": 1,
        "parent": 3
      },
      {
        "file": 1,
        "line": 6,
        "command": 2,
        "parent": 3
      },
      {
        "file": 0,
        "line": 2,
        "command": 3
      }
    ]
  }
}

Explicit top-level source root · optional

Exact source path filter · optional

Your inputs stay in your browser.

Your result

Example result

How it works

Map source compileGroupIndex values, including zero, to supplied language, includes, defines and raw command fragments. Follow settings backtrace nodes to their CMake files and commands.

src/main.cpp uses CXX20 with a system SDK include, MODE=1 and raw -O2. The header has no compile group.

Limits

Up to 5000 sources, 1000 groups and 10000 backtrace nodes; exports are bounded. Inconsistent indexes and cycles stay unknown. Relative paths resolve only against an explicitly supplied top-level source root. Interface sources are separate. No build execution or reconstructed shell command.

CMake compile-setting origins

Your inputs

Your result

How it works

Limits

Related tools

Subversion dump record map↗

Meson install destination report↗

CTest resource-slot feasibility↗

Subversion dump record map

Meson install destination report

CTest resource-slot feasibility