https://github.com/Kitware/CMake
Raw File
Tip revision: 7d710abc87a83d96bb3b0f504338c2110d9afa19 authored by Brad King on 19 October 2022, 15:22:54 UTC
CMake 3.25.0-rc2
Tip revision: 7d710ab
CMP0009.rst
CMP0009
-------

FILE GLOB_RECURSE calls should not follow symlinks by default.

In CMake 2.6.1 and below, :command:`file(GLOB_RECURSE)` calls would follow
through symlinks, sometimes coming up with unexpectedly large result sets
because of symlinks to top level directories that contain hundreds of
thousands of files.

This policy determines whether or not to follow symlinks encountered
during a :command:`file(GLOB_RECURSE)` call.  The ``OLD`` behavior for this
policy is to follow the symlinks.  The ``NEW`` behavior for this policy is not
to follow the symlinks by default, but only if ``FOLLOW_SYMLINKS`` is given
as an additional argument to the ``FILE`` command.

This policy was introduced in CMake version 2.6.2.  CMake version
|release| warns when the policy is not set and uses ``OLD`` behavior.  Use
the :command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly.

.. include:: DEPRECATED.txt
back to top