https://github.com/Kitware/CMake
Raw File
Tip revision: 0cd5300665fdbb68c32e318e5ca423854716c7a7 authored by Brad King on 20 June 2023, 17:11:25 UTC
CMake 3.27.0-rc3
Tip revision: 0cd5300
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