ecm-find-modules(7) — Extra CMake Modules 6.29.0 documentation

# ecm-find-modules(7)

## Introduction

Find modules are used by the CMake `find_package` command to search for packages that do not provide their own CMake package config files. CMake provides an extensive set of find modules, and Extra CMake Modules (ECM) adds to that.

To use ECM’s find modules, you need to tell CMake to find the ECM package, and then add either `${ECM_MODULE_PATH}` or `${ECM_FIND_MODULE_DIR}` to the `CMAKE_MODULE_PATH` variable:

    find_package(ECM REQUIRED NO_MODULE)
    set(CMAKE_MODULE_PATH ${ECM_FIND_MODULE_DIR})

Using `${ECM_MODULE_PATH}` will also make the modules intended for direct use by CMake scripts available (see `ecm-modules(7)` and `ecm-kde-modules(7)`).

You can also make local copies of find modules using the `ecm_use_find_modules` function from `ECMUseFindModules`, which is automatically included when ECM is found:

    find_package(ECM REQUIRED NO_MODULE)
    ecm_use_find_modules(
        DIR "${CMAKE_BINARY_DIR}/cmake"
        MODULES FindEGL.cmake
    )
    set(CMAKE_MODULE_PATH "${CMAKE_BINARY_DIR}/cmake")

This allows selective use of ECM’s find modules, and the NO_OVERRIDE argument can be used to ensure that if CMake ships its own version of that find module, it will be used instead.

## All Find Modules

- Find7Zip
- Find7z
- FindCanberra
- FindEGL
- FindFFmpeg
- FindGLIB2
- FindGperf
- FindGradle
- FindIcoTool
- FindInotify
- FindIsoCodes
- FindKF5
- FindKF6
- FindLibExiv2
- FindLibGit2
- FindLibMount
- FindLibcap
- FindOpenEXR
- FindPhoneNumber
- FindPoppler
- FindPulseAudio
- FindQtWaylandScanner
- FindSasl2
- FindSeccomp
- FindSharedMimeInfo
- FindTaglib
- FindUDev
- FindWayland
- FindWaylandProtocols
- FindWaylandScanner
- FindX11_XCB
- FindXCB
- Findepoxy
- Findgzip