{ "data": { "doc": [ "Data produced by CMake configure, build, and install." , "" , "All variables accessible to commands and options are: \"TMPDIR\"," , "\"LOCALBASE\", \"CC\", \"CXX\", \"CFLAGS\", \"CXXFLAGS\", \"LDFLAGS\"," , "and \"AR\". \"LOCALBASE\" contains the path to the installed artifacts" , "from \"deps\"." ] , "target_fields": ["project"] , "string_fields": [ "subdir" , "options" , "defines" , "targets" , "jobs" , "pre_cmds" , "post_cmds" , "out_files" , "out_dirs" , "resolve_symlinks" ] , "config_vars": [ "ARCH" , "HOST_ARCH" , "CC" , "CXX" , "CFLAGS" , "CXXFLAGS" , "LDFLAGS" , "ADD_CFLAGS" , "ADD_CXXFLAGS" , "ADD_LDFLAGS" , "ENV" , "AR" , "BUILD_POSITION_INDEPENDENT" , "TIMEOUT_SCALE" , "FOREIGN_EXECUTION_PROPERTIES" ] , "implicit": { "defaults": [["CC", "defaults"]] , "foreign-defaults": [["CC/foreign", "defaults"]] , "shell defaults": [["shell", "defaults"]] , "expand_exec": [["./", "..", "expand_exec"]] } , "field_doc": { "project": ["The CMake project directory. It should contain a single tree artifact"] , "subdir": [ "The subdirectory that contains the entry CMakeLists.txt. Individual" , "directory components are joined with \"/\"." ] , "options": [ "CMake options for the configuration phase." , "(e.g., [\"-GNinja\", \"-Ax64\"])" ] , "defines": [ "CMake defines for the configuration phase." , "(e.g., [\"CMAKE_BUILD_TYPE=Release\"])" ] , "targets": [ "The CMake targets to build in the specified order" , "(default: [\"install\"])." ] , "jobs": [ "Number of jobs to run simultaneously. If omitted, CMake's default" , "number is used." ] , "pre_cmds": [ "List of commands executed in the project directory before calling" , "CMake. Useful for renaming files or directories. Note that data" , "between \"pre_cmds\" and \"post_cmds\" can be exchanged via" , "\"$TMPDIR\" which is uniquely reserved for this action." ] , "post_cmds": [ "List of commands executed in the install directory after successful" , "installation but before the output files are collected. Useful for" , "renaming files or directories. Note that data between \"pre_cmds\" and" , "\"post_cmds\" can be exchanged via \"$TMPDIR\", which is uniquely" , "reserved for this action. The CMake source and build directory can be" , "accessed via \"$CMAKE_SOURCE_DIR\" and \"$CMAKE_BINARY_DIR\"," , "respectively." ] , "resolve_symlinks": [ "Resolve all symlinks in the install directory. This operation is" , "performed immediately after the install, before \"post_cmds\" are run." ] , "out_files": [ "Paths to the produced output files. The paths are considered relative" , "to the install directory." , "Note that \"out_files\" and \"out_dirs\" may not overlap." ] , "out_dirs": [ "Paths to the produced output directories. The paths are considered" , "relative to the install directory." , "Note that \"out_files\" and \"out_dirs\" may not overlap." ] } , "config_doc": { "CC": [ "The name of the C compiler to be used." , "If null, the respective value from [\"CC\", \"defaults\"] will be taken." ] , "CXX": [ "The name of the C++ compiler to be used." , "If null, the respective value from [\"CC\", \"defaults\"] will be taken." ] , "CFLAGS": [ "The flags for CC to be used instead of the default ones." , "For libraries that should be built in a non-standard way; usually" , "adapting the default target [\"CC\", \"defaults\"] is the better" , "choice" ] , "CXXFLAGS": [ "The flags for CXX to be used instead of the default ones." , "For libraries that should be built in a non-standard way; usually" , "adapting the default target [\"CC\", \"defaults\"] is the better" , "choice." ] , "LDFLAGS": [ "The linker flags to be used instead of the default ones." , "For libraries that should be linked in a non-standard way; usually" , "adapting the default target [\"CC\", \"defaults\"] is the better" , "choice" ] , "ADD_CFLAGS": [ "The flags to add to the default ones for CC." , "For libraries that should be built in a non-standard way; usually" , "adapting the default target [\"CC\", \"defaults\"] is the better" , "choice." ] , "ADD_CXXFLAGS": [ "The flags to add to the default ones for CXX." , "For libraries that should be built in a non-standard way; usually" , "adapting the default target [\"CC\", \"defaults\"] is the better" , "choice." ] , "ADD_LDFLAGS": [ "The linker flags to add to the default ones." , "For libraries that should be linked in a non-standard way; usually" , "adapting the default target [\"CC\", \"defaults\"] is the better" , "choice." ] , "ENV": [ "The environment for any action generated." , "If null, the respective value from [\"CC\", \"defaults\"] will be taken." ] , "AR": [ "The archive tool to used for creating the library." , "If null, the respective value from [\"CC\", \"defaults\"] will be taken." ] , "BUILD_POSITION_INDEPENDENT": ["Build position independent code."] , "TIMEOUT_SCALE": [ "The scaling of the timeout for the invocation of the foreign build." , "Defaults to 10." ] , "FOREIGN_EXECUTION_PROPERTIES": [ "A map with extra remote-execution properties to be added to the foreign build action." ] } , "imports": { "stage_field": ["", "stage_singleton_field"] , "cmake-build": "cmake-build" , "strip-prefix": ["./", "..", "strip-prefix"] , "for host": ["transitions", "for host"] , "map_provider": ["", "field_map_provider"] , "sh": ["shell", "sh"] } , "config_transitions": { "defaults": [{"type": "empty_map"}, {"type": "CALL_EXPRESSION", "name": "for host"}] , "expand_exec": [{"type": "CALL_EXPRESSION", "name": "for host"}] } , "expression": { "type": "let*" , "bindings": [ ["install_prefix", "install"] , [ "source_dir" , { "type": "let*" , "bindings": [["fieldname", "project"], ["location", "source"]] , "body": {"type": "CALL_EXPRESSION", "name": "stage_field"} } ] , [ "installed_out_files" , { "type": "foreach" , "var": "file_path" , "range": {"type": "FIELD", "name": "out_files"} , "body": { "type": "join" , "separator": "/" , "$1": [ {"type": "var", "name": "install_prefix"} , {"type": "var", "name": "file_path"} ] } } ] , [ "installed_out_dirs" , { "type": "foreach" , "var": "dir_path" , "range": {"type": "FIELD", "name": "out_dirs"} , "body": { "type": "join" , "separator": "/" , "$1": [ {"type": "var", "name": "install_prefix"} , {"type": "var", "name": "dir_path"} ] } } ] , ["cmake_subdir", {"type": "FIELD", "name": "subdir"}] , ["cmake_options", {"type": "FIELD", "name": "options"}] , ["cmake_defines", {"type": "FIELD", "name": "defines"}] , ["cmake_targets", {"type": "FIELD", "name": "targets"}] , ["cmake_jobs", {"type": "FIELD", "name": "jobs"}] , ["pre_cmds", {"type": "FIELD", "name": "pre_cmds"}] , ["post_cmds", {"type": "FIELD", "name": "post_cmds"}] , ["resolve_symlinks", {"type": "FIELD", "name": "resolve_symlinks"}] , ["defaults-transition", {"type": "empty_map"}] , [ "expand_exec" , { "type": "let*" , "bindings": [ ["fieldname", "expand_exec"] , ["location", "expand_exec"] , ["transition", {"type": "CALL_EXPRESSION", "name": "for host"}] ] , "body": {"type": "CALL_EXPRESSION", "name": "stage_field"} } ] , [ "full_install_dir" , {"type": "CALL_EXPRESSION", "name": "cmake-build"} ] , ["TOOLCHAIN_DIR", "toolchain"] , [ "shell TOOLCHAIN" , { "type": "let*" , "bindings": [ ["fieldname", "shell defaults"] , ["provider", "TOOLCHAIN"] , ["default", {"type": "empty_map"}] ] , "body": {"type": "CALL_EXPRESSION", "name": "map_provider"} } ] , [ "sh" , { "type": "let*" , "bindings": [["fieldname", "shell defaults"]] , "body": {"type": "CALL_EXPRESSION", "name": "sh"} } ] , [ "install_dir" , { "type": "ACTION" , "inputs": { "type": "map_union" , "$1": [ {"type": "var", "name": "shell TOOLCHAIN"} , {"type": "var", "name": "full_install_dir"} ] } , "cmd": [{"type": "var", "name": "sh"}, "-c", ":"] , "outs": {"type": "var", "name": "installed_out_files"} , "out_dirs": {"type": "var", "name": "installed_out_dirs"} } ] , [ "out_files" , { "type": "let*" , "bindings": [ ["artifacts", {"type": "var", "name": "install_dir"}] , ["paths", {"type": "FIELD", "name": "out_files"}] , ["prefix", {"type": "var", "name": "install_prefix"}] ] , "body": {"type": "CALL_EXPRESSION", "name": "strip-prefix"} } ] , [ "out_dirs" , { "type": "let*" , "bindings": [ ["artifacts", {"type": "var", "name": "install_dir"}] , ["paths", {"type": "FIELD", "name": "out_dirs"}] , ["prefix", {"type": "var", "name": "install_prefix"}] ] , "body": {"type": "CALL_EXPRESSION", "name": "strip-prefix"} } ] ] , "body": { "type": "RESULT" , "artifacts": { "type": "map_union" , "$1": { "type": "++" , "$1": [ {"type": "var", "name": "out_files"} , {"type": "var", "name": "out_dirs"} ] } } } } } , "library": { "doc": [ "Library produced by CMake configure, build, and install." , "" , "All variables accessible to commands and options are: \"TMPDIR\"," , "\"LOCALBASE\", \"CC\", \"CXX\", \"CFLAGS\", \"CXXFLAGS\", \"LDFLAGS\"," , "and \"AR\". \"LOCALBASE\" contains the path to the installed artifacts" , "from \"deps\"." ] , "target_fields": ["project", "deps"] , "string_fields": [ "subdir" , "name" , "version" , "stage" , "options" , "defines" , "jobs" , "pre_cmds" , "post_cmds" , "out_hdrs" , "out_hdr_dirs" , "out_libs" , "cflags" , "ldflags" , "pkg-config" , "hdr_prefix" , "lib_prefix" , "pc_prefix" , "resolve_symlinks" ] , "config_vars": [ "ARCH" , "HOST_ARCH" , "CC" , "CXX" , "CFLAGS" , "CXXFLAGS" , "LDFLAGS" , "ADD_CFLAGS" , "ADD_CXXFLAGS" , "ADD_LDFLAGS" , "ENV" , "AR" , "BUILD_POSITION_INDEPENDENT" , "TIMEOUT_SCALE" , "FOREIGN_EXECUTION_PROPERTIES" ] , "implicit": { "defaults": [["CC", "defaults"]] , "foreign-defaults": [["CC/foreign", "defaults"]] , "shell defaults": [["shell", "defaults"]] , "config_reader": [["CC", "prebuilt/read_pkgconfig.py"]] , "expand_exec": [["./", "..", "expand_exec"]] } , "field_doc": { "project": ["The CMake project directory. It should contain a single tree artifact"] , "subdir": [ "The subdirectory that contains the entry CMakeLists.txt. Individual" , "directory components are joined with \"/\"." ] , "name": [ "The name of the library (without leading \"lib\" or trailing file name" , "extension), also used as name for pkg-config files." ] , "version": [ "The library version, used for pkg-config files. Individual version" , "components are joined with \".\"." ] , "options": [ "CMake options for the configuration phase" , "(e.g., [\"-GNinja\", \"-Ax64\"]). Variables can be accessed via" , "\"$()\", e.g., \"$(TMPDIR)\" for variable \"$TMPDIR\"." ] , "defines": [ "CMake defines for the configuration phase" , "(e.g., [\"CMAKE_BUILD_TYPE=Release\"]). Variables can be accessed via" , "\"$()\", e.g., \"$(TMPDIR)\" for variable \"$TMPDIR\"." ] , "jobs": [ "Number of jobs to run simultaneously. If omitted, CMake's default" , "number is used." ] , "pre_cmds": [ "List of commands executed in the project directory before calling" , "CMake. Useful for renaming files or directories. Note that data" , "between \"pre_cmds\" and \"post_cmds\" can be exchanged via" , "\"$TMPDIR\" which is uniquely reserved for this action." ] , "post_cmds": [ "List of commands executed in the install directory after successful" , "installation but before the output files are collected. Useful for" , "renaming files or directories (e.g., in case of SONAME mismatch). Note" , "that data between \"pre_cmds\" and \"post_cmds\" can be exchanged via" , "\"$TMPDIR\", which is uniquely reserved for this action. The CMake" , "source and build directory can be accessed via \"$CMAKE_SOURCE_DIR\"" , "and \"$CMAKE_BINARY_DIR\", respectively." ] , "resolve_symlinks": [ "Resolve all symlinks in the install directory. This operation is" , "performed immediately after the install, before \"post_cmds\" are run." ] , "out_hdrs": [ "Paths to produced public header files. The path is considered" , "relative to the include directory, which be set via \"hdr_prefix\"." , "Note that \"out_hdrs\" and \"out_hdr_dirs\" may not overlap." ] , "out_hdr_dirs": [ "Paths to produced public header directories. The path is considered" , "relative to the include directory, which be set via \"hdr_prefix\"." , "Note that \"out_hdrs\" and \"out_hdr_dirs\" may not overlap." ] , "out_libs": [ "Paths to produced library files. The path is considered relative" , "to the library directory, which be set via \"lib_prefix\"." , "Order matters in the case of one library depending on another." ] , "cflags": ["List of compile flags set for this target and its consumers."] , "ldflags": [ "Additional linker flags that are required for the consumer of the" , "produced libraries." ] , "stage": [ "The logical location of the public headers and library files." , "Individual directory components are joined with \"/\"." ] , "deps": ["Public dependency on other CC libraries."] , "pkg-config": [ "Pkg-config file for optional infer of public cflags and ldflags. If" , "multiple files are specified (e.g., one depends on the other), the" , "first one is used as entry. Note that if this field is non-empty the" , "tool \"pkg-config\" must be available in \"PATH\", which is taken" , "from [\"CC\", \"defaults\"] or the \"ENV\" variable." ] , "hdr_prefix": [ "Prefix where headers will be installed by CMake. Individual directory" , "components are joined with \"/\". Defaults to \"include\" if not set." ] , "lib_prefix": [ "Prefix where libraries will be installed by CMake. Individual" , "directory components are joined with \"/\". Defaults to \"lib\" if" , "not set." ] , "pc_prefix": [ "Prefix where pkg-config files will be installed by CMake. Individual" , "directory components are joined with \"/\". Defaults to" , "\"lib/pkgconfig\" if not set." ] } , "config_doc": { "CC": [ "The name of the C compiler to be used." , "If null, the respective value from [\"CC\", \"defaults\"] will be taken." ] , "CXX": [ "The name of the C++ compiler to be used." , "If null, the respective value from [\"CC\", \"defaults\"] will be taken." ] , "CFLAGS": [ "The flags for CC to be used instead of the default ones." , "For libraries that should be built in a non-standard way; usually" , "adapting the default target [\"CC\", \"defaults\"] is the better" , "choice" ] , "CXXFLAGS": [ "The flags for CXX to be used instead of the default ones." , "For libraries that should be built in a non-standard way; usually" , "adapting the default target [\"CC\", \"defaults\"] is the better" , "choice." ] , "LDFLAGS": ["Global ld flags, for common link args,such as -Wl,-z,noexecstack"] , "ADD_CFLAGS": [ "The flags to add to the default ones for CC." , "For libraries that should be built in a non-standard way; usually" , "adapting the default target [\"CC\", \"defaults\"] is the better" , "choice." ] , "ADD_CXXFLAGS": [ "The flags to add to the default ones for CXX." , "For libraries that should be built in a non-standard way; usually" , "adapting the default target [\"CC\", \"defaults\"] is the better" , "choice." ] , "ADD_LDFLAGS": [ "The linker flags to add to the default ones." , "For libraries that should be linked in a non-standard way; usually" , "adapting the default target [\"CC\", \"defaults\"] is the better" , "choice." ] , "ENV": [ "The environment for any action generated." , "If null, the respective value from [\"CC\", \"defaults\"] will be taken." ] , "AR": [ "The archive tool to used for creating the library" , "If null, the respective value from [\"CC\", \"defaults\"] will be taken." ] , "BUILD_POSITION_INDEPENDENT": ["Build position independent code."] , "TIMEOUT_SCALE": [ "The scaling of the timeout for the invocation of the foreign build." , "Defaults to 10." ] , "FOREIGN_EXECUTION_PROPERTIES": [ "A map with extra remote-execution properties to be added to the foreign build action." ] } , "imports": { "stage_field": ["", "stage_singleton_field"] , "cmake-build": "cmake-build" , "strip-prefix": ["./", "..", "strip-prefix"] , "prebuilt result": ["CC/prebuilt", "prebuilt result"] , "install-deps": ["CC", "install-with-deps stage"] , "for host": ["transitions", "for host"] , "map_provider": ["", "field_map_provider"] , "sh": ["shell", "sh"] } , "config_transitions": { "defaults": [{"type": "empty_map"}, {"type": "CALL_EXPRESSION", "name": "for host"}] , "expand_exec": [{"type": "CALL_EXPRESSION", "name": "for host"}] } , "expression": { "type": "let*" , "bindings": [ [ "hdr_prefix" , { "type": "join" , "separator": "/" , "$1": { "type": "++" , "$1": [ ["install"] , { "type": "if" , "cond": {"type": "FIELD", "name": "hdr_prefix"} , "then": {"type": "FIELD", "name": "hdr_prefix"} , "else": ["include"] } ] } } ] , [ "lib_prefix" , { "type": "join" , "separator": "/" , "$1": { "type": "++" , "$1": [ ["install"] , { "type": "if" , "cond": {"type": "FIELD", "name": "lib_prefix"} , "then": {"type": "FIELD", "name": "lib_prefix"} , "else": ["lib"] } ] } } ] , [ "pc_prefix" , { "type": "join" , "separator": "/" , "$1": { "type": "++" , "$1": [ ["install"] , { "type": "if" , "cond": {"type": "FIELD", "name": "pc_prefix"} , "then": {"type": "FIELD", "name": "pc_prefix"} , "else": ["lib", "pkgconfig"] } ] } } ] , [ "source_dir" , { "type": "let*" , "bindings": [["fieldname", "project"], ["location", "source"]] , "body": {"type": "CALL_EXPRESSION", "name": "stage_field"} } ] , [ "localbase_dir" , { "type": "to_subdir" , "subdir": "localbase" , "msg": "dependency installation files may not overlap" , "$1": { "type": "let*" , "bindings": [ ["pc-install-dir", "lib/pkgconfig"] , ["targets", {"type": "FIELD", "name": "deps"}] ] , "body": {"type": "CALL_EXPRESSION", "name": "install-deps"} } } ] , [ "installed_dirs" , { "type": "foreach" , "var": "dir_path" , "range": {"type": "FIELD", "name": "out_hdr_dirs"} , "body": { "type": "join" , "separator": "/" , "$1": [ {"type": "var", "name": "hdr_prefix"} , {"type": "var", "name": "dir_path"} ] } } ] , [ "installed_files" , { "type": "++" , "$1": [ { "type": "foreach" , "var": "lib_path" , "range": {"type": "FIELD", "name": "out_libs"} , "body": { "type": "join" , "separator": "/" , "$1": [ {"type": "var", "name": "lib_prefix"} , {"type": "var", "name": "lib_path"} ] } } , { "type": "foreach" , "var": "hdr_path" , "range": {"type": "FIELD", "name": "out_hdrs"} , "body": { "type": "join" , "separator": "/" , "$1": [ {"type": "var", "name": "hdr_prefix"} , {"type": "var", "name": "hdr_path"} ] } } , { "type": "foreach" , "var": "pc_path" , "range": {"type": "FIELD", "name": "pkg-config"} , "body": { "type": "join" , "separator": "/" , "$1": [ {"type": "var", "name": "pc_prefix"} , {"type": "var", "name": "pc_path"} ] } } ] } ] , ["cmake_subdir", {"type": "FIELD", "name": "subdir"}] , ["cmake_options", {"type": "FIELD", "name": "options"}] , ["cmake_defines", {"type": "FIELD", "name": "defines"}] , ["cmake_jobs", {"type": "FIELD", "name": "jobs"}] , ["pre_cmds", {"type": "FIELD", "name": "pre_cmds"}] , ["post_cmds", {"type": "FIELD", "name": "post_cmds"}] , ["resolve_symlinks", {"type": "FIELD", "name": "resolve_symlinks"}] , ["defaults-transition", {"type": "empty_map"}] , [ "expand_exec" , { "type": "let*" , "bindings": [ ["fieldname", "expand_exec"] , ["location", "expand_exec"] , ["transition", {"type": "CALL_EXPRESSION", "name": "for host"}] ] , "body": {"type": "CALL_EXPRESSION", "name": "stage_field"} } ] , [ "full_install_dir" , {"type": "CALL_EXPRESSION", "name": "cmake-build"} ] , [ "shell TOOLCHAIN" , { "type": "let*" , "bindings": [ ["fieldname", "shell defaults"] , ["provider", "TOOLCHAIN"] , ["default", {"type": "empty_map"}] ] , "body": {"type": "CALL_EXPRESSION", "name": "map_provider"} } ] , [ "sh" , { "type": "let*" , "bindings": [["fieldname", "shell defaults"]] , "body": {"type": "CALL_EXPRESSION", "name": "sh"} } ] , [ "install_dir" , { "type": "ACTION" , "inputs": { "type": "map_union" , "$1": [ {"type": "var", "name": "shell TOOLCHAIN"} , {"type": "var", "name": "full_install_dir"} ] } , "cmd": [{"type": "var", "name": "sh"}, "-c", ":"] , "outs": {"type": "var", "name": "installed_files"} , "out_dirs": {"type": "var", "name": "installed_dirs"} } ] , [ "hdrs" , { "type": "++" , "$1": [ { "type": "let*" , "bindings": [ ["artifacts", {"type": "var", "name": "install_dir"}] , ["paths", {"type": "FIELD", "name": "out_hdrs"}] , ["prefix", {"type": "var", "name": "hdr_prefix"}] ] , "body": {"type": "CALL_EXPRESSION", "name": "strip-prefix"} } , { "type": "let*" , "bindings": [ ["artifacts", {"type": "var", "name": "install_dir"}] , ["paths", {"type": "FIELD", "name": "out_hdr_dirs"}] , ["prefix", {"type": "var", "name": "hdr_prefix"}] ] , "body": {"type": "CALL_EXPRESSION", "name": "strip-prefix"} } ] } ] , [ "libs" , { "type": "let*" , "bindings": [ ["artifacts", {"type": "var", "name": "install_dir"}] , ["paths", {"type": "FIELD", "name": "out_libs"}] , ["prefix", {"type": "var", "name": "lib_prefix"}] ] , "body": {"type": "CALL_EXPRESSION", "name": "strip-prefix"} } ] , [ "config_reader" , { "type": "let*" , "bindings": [["fieldname", "config_reader"], ["location", "config_reader"]] , "body": {"type": "CALL_EXPRESSION", "name": "stage_field"} } ] , [ "pkg-configs" , { "type": "let*" , "bindings": [ ["artifacts", {"type": "var", "name": "install_dir"}] , ["paths", {"type": "FIELD", "name": "pkg-config"}] , ["prefix", {"type": "var", "name": "pc_prefix"}] ] , "body": {"type": "CALL_EXPRESSION", "name": "strip-prefix"} } ] , [ "name" , { "type": "assert_non_empty" , "msg": "name is required for cmake library" , "$1": {"type": "join", "$1": {"type": "FIELD", "name": "name"}} } ] , ["version", {"type": "FIELD", "name": "version"}] , ["cflags", {"type": "FIELD", "name": "cflags"}] , ["ldflags", {"type": "FIELD", "name": "ldflags"}] , [ "stage" , { "type": "join" , "separator": "/" , "$1": {"type": "FIELD", "name": "stage"} } ] , ["deps-fieldnames", ["deps", "defaults"]] ] , "body": {"type": "CALL_EXPRESSION", "name": "prebuilt result"} } } }