Difference between revisions of "CMake Performance Tips"

From KitwarePublic
Jump to: navigation, search
(Loop optimizations)
(Replace content with link to new CMake community wiki)
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
While CMake itself is already very fast, there are some tuning things you can do to ensure works
+
{{CMake/Template/Moved}}
as fast as possible.
+
  
=CMake build time=
+
This page has moved [https://gitlab.kitware.com/cmake/community/wikis/doc/cmake/Performance-Tips here].
 
+
==Build it with optimization enabled==
+
 
+
Ok, this is obvious, but anyway. Let's say you build CMake yourself without any special settings, e.g.
+
<pre>
+
$ cmake ..
+
$ make
+
</pre>
+
 
+
If you do it this way, you will get a CMake with optimizations turned off.
+
There are different ways to get an optimized build. You can select one of the predefined build types:
+
<pre>
+
$ cmake -DCMAKE_BUILD_TYPE=RELEASE ..
+
$ make
+
</pre>
+
Also possible are RELWITHDEBINFO and MINSIZEREL.
+
 
+
or
+
 
+
<pre>
+
$ export CXXFLAGS=-O2
+
$ cmake ..
+
$ make
+
</pre>
+
 
+
or
+
 
+
<pre>
+
$ export CXXFLAGS=-O2
+
$ cmake ..
+
$ make edit_cache (or ccmake ..)
+
... edit CMAKE_CXX_FLAGS in the advanced view
+
$ make
+
</pre>
+
 
+
CMake built with optimizations enabled can give you an almost 50% performance boost (time for running
+
CMake on VTK went down from 25 s to 14 s).
+
 
+
==Use LIST(APPEND ...)==
+
 
+
There are two ways to append values to a variable in CMake:
+
 
+
<pre>
+
  SET(myVar ${myVar} newItem)
+
</pre>
+
 
+
and since CMake 2.4 there is the new LIST() command:
+
 
+
<pre>
+
  LIST(APPEND myVar newItem)
+
</pre>
+
 
+
LIST(APPEND ...) is for large lists and appends much faster than using SET().
+
 
+
 
+
=CMake configure time=
+
 
+
==Reduce add_custom_command()s DEPENDS lists==
+
 
+
If your build setup happens to contain many targets which ''all'' depend on the same ''sizeable list'' of file dependencies,
+
then it might be useful to establish ''one single'' custom command (plus its associated target) which DEPENDS on those many files and creates one single OUTPUT "stamp file" ("one of the files changed" watchdog file) which can then be DEPENDS-fed into all affected add_custom_command()s as a ''single'' file dependency.
+
A very nice way to figure out whether this applies to your build environment is to do:
+
<source lang="bash">
+
ninja -t graph > /tmp/graphviz.log
+
dot -Tsvg /tmp/graphviz.log >/tmp/cmake_ninja.svg
+
</source>
+
and watch the resulting graph monstrosity in awe :)
+
 
+
==Use an include guard==
+
 
+
For CMake modules (files referenced via include() statement), you could use something like:
+
<source lang="CMake">
+
if(my_module_xyz_included)
+
  return()
+
endif(my_module_xyz_included)
+
set(my_module_xyz_included true)
+
</source>
+
at the beginning of your module file, to avoid repeated parsing within sibling scopes (sub directories, etc.),
+
which also cuts down on amount of
+
<source lang="bash">
+
cmake --trace
+
</source>
+
log traffic.
+
 
+
==Split modules into functions/definitions==
+
 
+
As a general hint, it might be useful to split module files into containing ''either'' clean stateless non-specific (generic) helper functions ''or'' content which defines specific settings and calls some helper functions.
+
 
+
==Loop optimizations==
+
 
+
Use these tricks to do an initial match query over the entire list prior to iterating over each element, and return() ASAP.
+
I did not profile it whether these tricks are indeed faster, but for large lists it should be useful.
+
 
+
<source lang="CMake">
+
if("${list}" MATCHES ${elem_query}) # shortcut :)
+
  foreach(elem ${list})
+
    if(${elem} STREQUAL ${elem_query})
+
      set(elem_found true)
+
      return()/break() # don't forget these...
+
    endif(${elem} STREQUAL ${elem_query})
+
  endforeach(elem ${list})
+
endif("${list}" MATCHES ${elem_query})
+
</source>
+
 
+
[[Category:CMake]]
+

Latest revision as of 11:41, 30 April 2018


The CMake community Wiki has moved to the Kitware GitLab Instance.

This page has moved here.