cmake find_program examples

Signatures

find_program (
  <VAR>
  name | NAMES name1 [name2 ...] [NAMES_PER_DIR]
  [HINTS [path | ENV var]...]
  [PATHS [path | ENV var]...]
  [REGISTRY_VIEW (64|32|64_32|32_64|HOST|TARGET|BOTH)]
  [PATH_SUFFIXES suffix1 [suffix2 ...]]
  [VALIDATOR function]
  [DOC "cache documentation string"]
  [NO_CACHE]
  [REQUIRED|OPTIONAL]
  [NO_DEFAULT_PATH]
  [NO_PACKAGE_ROOT_PATH]
  [NO_CMAKE_PATH]
  [NO_CMAKE_ENVIRONMENT_PATH]
  [NO_SYSTEM_ENVIRONMENT_PATH]
  [NO_CMAKE_SYSTEM_PATH]
  [NO_CMAKE_INSTALL_PREFIX]
  [CMAKE_FIND_ROOT_PATH_BOTH |
  ONLY_CMAKE_FIND_ROOT_PATH |
  NO_CMAKE_FIND_ROOT_PATH]
)

Examples

geodynamics/aspect contrib/world_builder/cmake/FindSphinx.cmake :2

find_program(SPHINX_EXECUTABLE
             NAMES sphinx-build
             DOC "Path to sphinx-build executable")

AtomicGameEngine/AtomicGameEngine Source/ThirdParty/libcurl/LibCurl.cmake :217

find_program(NROFF NAMES gnroff nroff)

u3d-community/U3D cmake/Modules/FindWayland.cmake :41

find_program (WAYLAND_SCANNER NAMES wayland-scanner DOC "Wayland scanner host tool")

AcademySoftwareFoundation/Imath cmake/clang-format.cmake :24

find_program (CLANG_FORMAT_EXE
              NAMES clang-format bin/clang-format
              HINTS ${CLANG_FORMAT_ROOT}
                    ENV CLANG_FORMAT_ROOT
                    LLVM_ROOT
                    ENV LLVM_ROOT
              DOC "Path to clang-format executable")

FreeCAD/FreeCAD cMake/FindPySide2Tools.cmake :20

FIND_PROGRAM(PYSIDE2_RCC_EXECUTABLE NAMES pyside2-rcc pyside2-rcc-${Python3_VERSION_MAJOR}.${Python3_VERSION_MINOR} pyrcc5 HINTS ${PYSIDE_BIN_DIR})

godlikepanos/anki-3d-engine ThirdParty/Sdl3/build-scripts/cmake-toolchain-mingw64-i686.cmake :4

find_program(CMAKE_C_COMPILER NAMES i686-w64-mingw32-gcc)

harfang3d/harfang3d harfang/cmake/CodeCoverage.cmake :144

find_program( CPPFILT_PATH NAMES c++filt )

Hork-Engine/Hork-Source ThirdParty/SDL3/build-scripts/cmake-toolchain-mingw64-i686.cmake :5

find_program(CMAKE_CXX_COMPILER NAMES i686-w64-mingw32-g++)

STORM-IRIT/Radium-Engine cmake/CodeCoverage.cmake :144

find_program(LCOV_PATH NAMES lcov lcov.bat lcov.exe lcov.perl)

RavEngine/RavEngine deps/OpenXR-SDK/CMakeLists.txt :117

find_program(BASH_COMMAND NAMES bash)

cnr-isti-vclab/meshlab unsupported/plugins_unsupported/external/CoMISo/cmake/FindMPI.cmake :552

find_program(MPI_${lang}_COMPILER
      NAMES  ${_MPI_${lang}_COMPILER_NAMES}
      PATHS  "${MPI_HOME}/bin" "$ENV{MPI_HOME}/bin" ${_MPI_PREFIX_PATH})

bmwcarit/ramses cmake/modules/FindSphinx.cmake :10

find_program(SPHINX_EXECUTABLE
             NAMES sphinx-build
             DOC "Path to sphinx-build executable")

pioneerspacesim/pioneer CMakeLists.txt :362

find_program(NATURALDOCS NAMES naturaldocs)

overte-org/overte cmake/modules/GenerateAppImage.cmake :17

find_program(LINUXDEPLOY_EXECUTABLE
  NAMES linuxdeploy linuxdeploy-${CMAKE_SYSTEM_PROCESSOR}.AppImage
  PATHS ${CPACK_PACKAGE_DIRECTORY}/linuxdeploy)

kokkos/kokkos cmake/kokkos_compiler_id.cmake :34

find_program(
      Kokkos_NVCC_WRAPPER
      NAMES nvcc_wrapper
      HINTS ${PROJECT_SOURCE_DIR}
      PATHS ${PROJECT_SOURCE_DIR}
      PATH_SUFFIXES bin
    )

alpaka-group/alpaka thirdParty/catch2/CMake/FindGcov.cmake :35

find_program(GCOV_BIN NAMES gcov-${GCC_VERSION} gcov
				HINTS ${COMPILER_PATH})

eclipse-ecal/ecal cmake/Modules/Findpatchelf.cmake :1

find_program(PATCHELF_COMMAND
	     NAMES patchelf)

LLNL/zfp python/scikit-build-cmake/FindCython.cmake :48

find_program(CYTHON_EXECUTABLE
               NAMES cython cython.bat cython3
               HINTS ${_python_path}
               DOC "path to the cython executable")

nextcloud/desktop cmake/modules/ECMAddAppIcon.cmake :129

find_program(KSVG2ICNS NAMES ksvg2icns)

CNES/MAJA Documentation/Conception/CMakeLists.txt :37

find_program(LATEX_COMMAND NAMES latex)

end2endzone/ShellAnything cmake/FindWIX.cmake :62

find_program(WIX_CANDLE
    NAMES
      candle
    PATHS
      ${WIX_BIN_DIR}
  )

svkaiser/Doom64EX cmake/FindVala.cmake :49

find_program(VALA_EXECUTABLE
  NAMES ${VALAC_NAMES})

AcademySoftwareFoundation/OpenShadingLanguage src/cmake/compiler.cmake :487

find_program (CLANG_FORMAT_EXE NAMES clang-format bin/clang-format)

etternagame/etterna extern/curl/CMake/Macros.cmake :83

find_program(NROFF NAMES gnroff nroff)

NREL/OpenStudio ruby/test/CMakeLists.txt :19

find_program(SYSTEM_RUBY_EXECUTABLE NAMES ${_RUBY_POSSIBLE_EXECUTABLE_NAMES}
    HINTS
      "/usr/local/rvm/rubies/ruby-3.2.2/bin/"
      "/usr/local/rvm/rubies/ruby-3.2.2/bin/ruby"
      "/usr/share/rvm/rubies/ruby-3.2.2/bin/"
      "$ENV{HOME}/.rvm/rubies/ruby-3.2.2/bin/"
      "$ENV{HOME}/.rbenv/versions/3.2.2/bin/"
      "/opt/rbenv/versions/3.2.2/bin/"

      "C:/Ruby32-x64/bin/"

       "/usr/local/ruby322/bin/"
       "/usr/local/ruby32/bin/"
       "/usr/bin/"
       "/usr/local/bin/"

    NO_DEFAULT_PATH)

supercollider/supercollider cmake_modules/FindBela.cmake :28

find_program(BELA_CONFIG
        NAMES
        bela-config
        PATHS
        /root/Bela/resources/bin
        $ENV{BELA_ROOT}/resources/bin
        /usr/local/bin
        /usr/bin
        )

Morwenn/cpp-sort cmake/FindGcov.cmake :35

find_program(GCOV_BIN NAMES gcov-${GCC_VERSION} gcov
				HINTS ${COMPILER_PATH})

nojhan/paradiseo eo/BuildConfig.cmake :7

FIND_PROGRAM(MEMORYCHECK_COMMAND
  NAMES purify valgrind
  PATHS
  "/usr/local/bin /usr/bin [HKEY_LOCAL_MACHINE\\SOFTWARE\\Rational Software\\Purify\\Setup;InstallFolder]"
  DOC "Path to the memory checking command, used for memory error detection.")

NGSolve/ngsolve cmake/SuperBuild.cmake :101

find_program(CCACHE_FOUND NAMES ccache ccache.bat)

KhronosGroup/Vulkan-Samples bldsys/cmake/module/FindVulkan.cmake :529

find_program(Vulkan_dxc_EXECUTABLE
            NAMES dxc
            HINTS
            ${_Vulkan_hint_executable_search_paths})

SCOREC/core CMakeLists.txt :89

find_program(MPIRUN NAMES mpirun PATHS "${COMPILER_DIR}")

nv-legate/legate src/cmake/thirdparty/sphinx/FindSphinx.cmake :6

find_program(SPHINX_EXECUTABLE NAMES sphinx-build DOC "Path to sphinx-build executable")

maidsafe-archive/MaidSafe cmake_modules/monolithic_lib.cmake :90

find_program(LibTool NAMES libtool)

MultiMC/Launcher CMakeLists.txt :26

find_program(CLANG_TIDY_COMMAND NAMES clang-tidy)

RichieSams/FiberTaskingLib third_party/catch2/CMake/FindGcov.cmake :35

find_program(GCOV_BIN NAMES gcov-${GCC_VERSION} gcov
				HINTS ${COMPILER_PATH})

lightspark/lightspark CMakeLists.txt :97

FIND_PROGRAM(GNASH_EXE_PATH NAMES gnash)

JSBSim-Team/jsbsim tests/unit_tests/CMakeModules/FindGcov.cmake :49

find_program(LLVM_COV_BIN NAMES "llvm-cov-${LLVM_VERSION}"
					"llvm-cov" HINTS ${COMPILER_PATH})

performous/performous cmake/Modules/FindWebP.cmake :78

find_program(WEBP_CWEBP_EXECUTABLE NAMES cwebp)

CppMicroServices/CppMicroServices doc/src/CMakeLists.txt :190

find_program(MAKE_COMMAND NAMES make gmake)

SsageParuders/Android_Native_Surface my_android_opencv/platforms/android/android.toolchain.cmake :1163

find_program( CMAKE_INSTALL_NAME_TOOL NAMES install_name_tool )

psi4/psi4 cdash/CDashTSan.cmake :14

find_program(CTEST_GIT_COMMAND NAMES git)

OpenKneeboard/OpenKneeboard CMakeLists.txt :192

find_program(
  CLANG_TIDY
  NAMES clang-tidy
  HINTS "${MSBUILD_LLVM_ROOT}/bin"
)

moneymanagerex/moneymanagerex util/FindwxWidgets.cmake :1000

find_program(wxWidgets_wxrc_EXECUTABLE
  NAMES $ENV{WXRC_CMD} wxrc
  PATHS ${wxWidgets_ROOT_DIR}/utils/wxrc/vc_msw
  DOC "Location of wxWidgets resource file compiler binary (wxrc)"
  )

chdb-io/chdb cmake/clang_tidy.cmake :10

find_program (_CLANG_TIDY_PATH NAMES "clang-tidy-19" "clang-tidy-18" "clang-tidy-17" "clang-tidy")

Rezonality/zep demos/demo_qt/CMakeLists.txt :19

find_program(WINDEPLOYQT_EXECUTABLE NAMES windeployqt HINTS ${QTDIR} ENV QTDIR PATH_SUFFIXES bin)

NVIDIA/DALI cmake/modules/FindProtobuf.cmake :395

find_program(Protobuf_PROTOC_EXECUTABLE
    NAMES protoc
    DOC "The Google Protocol Buffers Compiler"
    PATHS
    ${Protobuf_SRC_ROOT_FOLDER}/vsprojects/${_PROTOBUF_ARCH_DIR}Release
    ${Protobuf_SRC_ROOT_FOLDER}/vsprojects/${_PROTOBUF_ARCH_DIR}Debug
    NO_CMAKE_SYSTEM_PATH
)

LiangliangNan/MVStudio 3rd_party/nlopt/cmake/FindGuile.cmake :65

find_program(GUILE_EXECUTABLE
              NAMES guile
           )

Kitware/ParaView .gitlab/ci/update_translations.cmake :1

find_program(LUPDATE_COMMAND NAMES lupdate lupdate-qt5 lupdate-qt6)

scanner-research/scanner cmake/Modules/FindSaneProtobuf.cmake :328

find_program(PROTOBUF_PROTOC_EXECUTABLE
    NAMES protoc
    DOC "The Google Protocol Buffers Compiler"
    PATHS
    ${PROTOBUF_SRC_ROOT_FOLDER}/vsprojects/${_PROTOBUF_ARCH_DIR}Release
    ${PROTOBUF_SRC_ROOT_FOLDER}/vsprojects/${_PROTOBUF_ARCH_DIR}Debug
)

codilime/veles CMakeLists.txt :422

find_program(CLANG_TIDY NAMES clang-tidy-6.0 clang-tidy HINTS ${CLANG_TOOLS_PATH})

ukoethe/vigra CMakeLists.txt :332

find_program(GIT_EXECUTABLE
              NAMES git git.exe git.cmd
              HINTS $ENV{ProgramFiles}/Git/bin
              DOC "git command line client")

marsyas/marsyas doc/CMakeLists.txt :13

find_program(DOXYGEN NAMES doxygen PATHS $ENV{PATH})

in-formant/in-formant cmake_support/FindVulkan.cmake :78

find_program(Vulkan_GLSLC_EXECUTABLE
      NAMES glslc
      HINTS
        "$ENV{VULKAN_SDK}/Bin32"
      NO_CMAKE_FIND_ROOT_PATH
      )

DIPlib/diplib doc/CMakeLists.txt :35

find_program(
   DOXPP_BRIEF_EXECUTABLE
   NAMES dox++brief
   PATHS ${DIP_DOXPP_PATH}
   DOC "dox++ documentation generation tool, brief generator"
)

gismo/gismo cmake/CodeCoverage.cmake :73

find_program( LCOV_PATH  NAMES lcov lcov.bat lcov.exe lcov.perl)

awawa-dev/HyperHDR cmake/cmake_modules/FindFlatBuffers.cmake :29

find_program(FLATBUFFERS_FLATC_EXECUTABLE NAMES flatc)

SimVascular/SimVascular Code/CMake/SimVascularInstallLibs.cmake :250

find_program(EXTERNALEXE_${_EXE}
    NAMES ${_${_EXE}_NAMES}
    PATHS ${SV_DISTRIBUTION_DIR}/dicom2 ${SV_DISTRIBUTION_DIR}/dcmtk
    )

NERSC/timemory cmake/Modules/ClangFormat.cmake :36

find_program(TIMEMORY_CMAKE_FORMATTER NAMES cmake-format)

emsec/hal cmake/CodeCoverage.cmake :73

find_program( LCOV_PATH  NAMES lcov lcov.bat lcov.exe lcov.perl)

GoSSIP-SJTU/TripleDoggy CMakeLists.txt :73

find_program(CMAKE_LIBTOOL NAMES libtool)

ceph/ceph cmake/modules/FindPython/Support.cmake :1881

find_program (_${_PYTHON_PREFIX}_EXECUTABLE
                        NAMES ${_${_PYTHON_PREFIX}_NAMES}
                        NAMES_PER_DIR
                        HINTS ${_${_PYTHON_PREFIX}_HINTS}
                        PATHS ${_${_PYTHON_PREFIX}_REGISTRY_PATHS}
                        PATH_SUFFIXES ${_${_PYTHON_PREFIX}_PATH_SUFFIXES}
                        ${_${_PYTHON_PREFIX}_REGISTRY_VIEW}
                        NO_SYSTEM_ENVIRONMENT_PATH
                        NO_CMAKE_SYSTEM_PATH
                        VALIDATOR _python_validate_find_interpreter)

catchorg/Catch2 CMake/FindGcov.cmake :49

find_program(LLVM_COV_BIN NAMES "llvm-cov-${LLVM_VERSION}"
					"llvm-cov" HINTS ${COMPILER_PATH})

gnuradio/gnuradio grc/CMakeLists.txt :106

find_program(GRC_XTERM_EXE
        NAMES x-terminal-emulator gnome-terminal konsole xfce4-terminal urxvt xterm foot
        HINTS ENV PATH
        DOC "graphical terminal emulator used in GRC's no-gui-mode"
    )

STEllAR-GROUP/hpx cmake/FindSphinx.cmake :16

find_program(
  Sphinx_EXECUTABLE
  NAMES sphinx-build sphinx-build2
  PATHS ${Sphinx_ROOT} ENV SPHINX_ROOT
  DOC "Path to sphinx-build executable"
)

simbody/simbody cmake/FindGcov.cmake :36

find_program(GCOV_BIN NAMES gcov-${GCC_VERSION} gcov
        HINTS ${COMPILER_PATH})

hlrs-vis/covise cmake/Toolchain-cross-mingw32-linux.cmake :39

find_program(CMAKE_CXX_COMPILER NAMES ${COMPILER_PREFIX}-g++)

vengi-voxel/vengi CMakeLists.txt :111

find_program(GLSLANG_EXECUTABLE NAMES glslangValidator glslang-standalone)

YosysHQ/nextpnr cmake/CodeCoverage.cmake :74

find_program( GENHTML_PATH NAMES genhtml genhtml.perl genhtml.bat )

steemit/steem CMakeLists.txt :122

find_program(
   CLANG_TIDY_EXE
   NAMES "clang-tidy"
   DOC "Path to clain-tidy executable"
)

brndnmtthws/conky 3rdparty/toluapp/cmake/lua.cmake :39

find_program( SRLUA_EXECUTABLE NAMES srlua )

root-project/root cmake/modules/RootConfiguration.cmake :316

find_program(FIREFOX_EXECUTABLE NAMES firefox firefox-bin firefox.exe
             HINTS /snap/bin
             PATH_SUFFIXES "Mozilla Firefox")

CLIUtils/CLI11 cmake/CodeCoverage.cmake :144

find_program(LCOV_PATH NAMES lcov lcov.bat lcov.exe lcov.perl)

Slicer/Slicer CMake/FindPatch.cmake :51

find_program(Patch_EXECUTABLE
    NAMES patch
    PATH_SUFFIXES Git/usr/bin Git/bin GnuWin32/bin
    DOC ${_doc}
    )

google/filament third_party/dawn/third_party/dxc/cmake/modules/CoverageReport.cmake :21

find_program(LLVM_COV NAMES llvm-cov llvm-cov${HOST_LLVM_VERSION_SUFFIX} PATHS ${COMPILER_DIRECTORY} NO_DEFAULT_PATH)

elemental/Elemental cmake/modules/FindValgrind.cmake :18

find_program(VALGRIND_PROGRAM NAMES valgrind PATH 
  /usr/bin /usr/local/bin ${VALGRIND_PREFIX}/bin)

percona/percona-xtrabackup cmake/fastcov.cmake :67

FIND_PROGRAM(GCOV_EXECUTABLE NAMES gcov)

NREL/EnergyPlus CMakeLists.txt :355

find_program(VALGRIND NAMES valgrind PATH /usr/bin /usr/local/bin)

ngscopeclient/scopehal-apps cmake/FindVulkan.cmake :319

find_program(Vulkan_GLSLC_EXECUTABLE
    NAMES glslc
    HINTS
      ${_Vulkan_hint_executable_search_paths}
    )

appleseedhq/appleseed cmake/modules/DELETE.FindOpenImageIO.cmake :56

find_program (OPENIMAGEIO_IDIFF NAMES idiff)

Devsh-Graphics-Programming/Nabla tools/nsc/CMakeLists.txt :62

find_program(DOCKER_EXE NAMES docker REQUIRED)

mysql/mysql-server CMakeLists.txt :754

FIND_PROGRAM(READELF_EXECUTABLE
      NAMES eu-readelf readelf
      )

GPSBabel/gpsbabel gui/CMakeLists.txt :224

find_program(INNO_COMPILER NAMES iscc ISCC
                 PATHS "C:/Program Files (x86)/Inno Setup 6" "C:/Program Files/Inno Setup 6")

openturns/openturns CMakeLists.txt :545

find_program (SPHINX_EXECUTABLE NAMES sphinx-build DOC "Sphinx Documentation Builder (sphinx-doc.org)")

robotology/yarp bindings/lua/tests/CMakeLists.txt :4

find_program(LUA_EXECUTABLE
             NAMES lua${LUA_VERSION_MAJOR}.${LUA_VERSION_MINOR}
                   lua)

apache/thrift build/cmake/DefineOptions.cmake :51

find_program(HAVE_COMPC NAMES compc HINTS ${POSSIBLE_PATHS})

datastax/cpp-driver cmake/ClangFormat.cmake :19

find_program(CLANG_FORMAT_EXE NAMES ${CLANG_FORMAT_EXE_NAME})

AcademySoftwareFoundation/OpenImageIO src/cmake/compiler.cmake :538

find_program(CLANG_TIDY_EXE NAMES "clang-tidy"
                 DOC "Path to clang-tidy executable")

cginternals/glbinding cmake/Findcppcheck.cmake :11

find_program(cppcheck_EXECUTABLE
    NAMES
        cppcheck
    PATHS
        "${CPPCHECK_DIR}"
        "$ENV{CPPCHECK_DIR}"
        "$ENV{PROGRAMFILES}/Cppcheck"
        "$ENV{${PROGRAMFILES_x86_ENV}}/Cppcheck"
)

tlorach/nvFX cmake/FindZLib.cmake :55

FIND_PROGRAM(ZLIB_BIN  NAMES zlib.dll zlibd.dll ${${search}} PATH_SUFFIXES bin bin32)

cycfi/artist examples/cmake/FindWaylandScanner.cmake :20

find_program(WaylandScanner_EXECUTABLE NAMES wayland-scanner HINTS ${WaylandScanner_EXECUTABLE_DIR})

manticoresoftware/manticoresearch misc/ctest/justbuild.cmake :51

find_program ( CTEST_GIT_COMMAND NAMES git )

eclipse-upm/upm cmake/modules/FindNpm.cmake :14

find_program(NPM_EXECUTABLE NAMES npm HINTS /usr)

openstudiocoalition/OpenStudioApplication CMakeLists.txt :554

find_program(QtWebEngineProcess NAMES QtWebEngineProcess PATHS "${QT_INSTALL_DIR}/bin/" "${QT_INSTALL_DIR}/libexec/" "${QT_INSTALL_DIR}/lib/QtWebEngineCore.framework/Helpers" NO_DEFAULT_PATH)

OSVR/OSVR-Core cmake/CreateDashboardScripts.cmake :97

find_program(DASHBOARDSCRIPT_CTEST_EXECUTABLE
		NAMES
		ctest
		HINTS
		"${_cmake_dir}"
		NO_DEFAULT_PATH)

prophesee-ai/openeb cmake/Modules/Findnodejs.cmake :14

find_program(NODEJS_EXECUTABLE
    NAMES node nodejs 
    HINTS /usr
          /usr/local
          /opt
          /opt/local
    PATH_SUFFIXES bin)

d1vanov/quentier cmake/modules/FindBreakpad.cmake :145

FIND_PROGRAM(BREAKPAD_DUMP_SYMS
      NAMES dump_syms
      PATHS
      ${BREAKPAD_BINARY_DIRS}
      NO_DEFAULT_PATH)

jahnf/Projecteur CMakeLists.txt :372

find_program(iwyu_path NAMES include-what-you-use iwyu)

mysql/mysql-connector-cpp cdk/cmake/FindSphinx.cmake :35

find_program(SPHINX_EXECUTABLE NAMES sphinx-build
    HINTS
    ${WITH_SPHINX}
    PATH_SUFFIXES bin
    DOC "Sphinx documentation generator"
)

faheel/BigInt CMake/FindGcov.cmake :35

find_program(GCOV_BIN NAMES gcov-${GCC_VERSION} gcov
				HINTS ${COMPILER_PATH})

greatscottgadgets/gr-bluetooth cmake/Modules/GrPython.cmake :43

find_program(PYTHON_EXECUTABLE NAMES python python2.7 python2.6 python2.5)