• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1utility_source
2--------------
3
4Disallowed since version 3.0.  See CMake Policy :policy:`CMP0034`.
5
6Specify the source tree of a third-party utility.
7
8::
9
10  utility_source(cache_entry executable_name
11                 path_to_source [file1 file2 ...])
12
13When a third-party utility's source is included in the distribution,
14this command specifies its location and name.  The cache entry will
15not be set unless the ``path_to_source`` and all listed files exist.  It
16is assumed that the source tree of the utility will have been built
17before it is needed.
18
19When cross compiling CMake will print a warning if a ``utility_source()``
20command is executed, because in many cases it is used to build an
21executable which is executed later on.  This doesn't work when cross
22compiling, since the executable can run only on their target platform.
23So in this case the cache entry has to be adjusted manually so it
24points to an executable which is runnable on the build host.
25