BOOSTROOT, BOOSTROOT. Preferred installation prefix. Preferred include directory e.g. Preferred library directory e.g. Set to ON to disable searching in locations not specified by these hint variables. Boost, lift, and support roots for all-day voluminosity in 60 seconds: The perfect root volumizer for fast results on fine locks, Boldify Root Boosting Spray plumps strands for an instantly fuller appearance, lifts and supports locks at the root for insane volume that lasts from the office to happy hour, and texturizes and thickens when tousled throughout hair lengths for a layered, sexy, edgy look that doesn’t know the meaning of the word quit. Boost; ROOT master - Reference Guide Generated on Mon Mar 22 2021 12:16:51 (GVA Time) using Doxygen 1.9.0.

Find Boost include dirs and libraries

Use this module by invoking find_package() with the form:

This module finds headers and requested component libraries OR a CMakepackage configuration file provided by a 'Boost CMake' build. For thelatter case skip to the Boost CMake section below.

New in version 3.7: bzip2 and zlib components (Windows only).

New in version 3.11: The OPTIONAL_COMPONENTS option.

New in version 3.19: bzip2 and zlib components on all platforms.

Result Variables¶

This module defines the following variables:


Boost_root Ubuntu

True if headers and requested libraries were found.


Boost include directories.


Link directories for Boost libraries.


Boost component libraries to be linked.


True if component <COMPONENT> was found (<COMPONENT> name is upper-case).


Libraries to link for component <COMPONENT> (may includetarget_link_libraries() debug/optimized keywords).


BOOST_VERSION value from boost/version.hpp.


Boost version number in X.Y.Z format.


Boost version number in X.Y.Z format (same as Boost_VERSION_STRING).

Changed in version 3.15: In previous CMake versions, this variable used the raw version stringfrom the Boost header (same as Boost_VERSION_MACRO).See policy CMP0093.


Version string appended to library filenames.


Boost major version number (X in X.Y.Z).


Boost minor version number (Y in X.Y.Z).


Boost subminor version number (Z in X.Y.Z).


Amount of version components (3).


Pass to add_definitions() to have diagnosticinformation about Boost's automatic linkingdisplayed during compilation

New in version 3.15: The Boost_VERSION_<PART> variables.

Cache variables¶

Search results are saved persistently in CMake cache entries:


Directory containing Boost headers.


Directory containing release Boost libraries.


Directory containing debug Boost libraries.


Component <COMPONENT> library debug variant.


Component <COMPONENT> library release variant.

New in version 3.3: Per-configuration variables Boost_LIBRARY_DIR_RELEASE andBoost_LIBRARY_DIR_DEBUG.


This module reads hints about search locations from variables:


Preferred installation prefix.


Preferred include directory e.g. <prefix>/include.


Preferred library directory e.g. <prefix>/lib.


Set to ON to disable searching in locations notspecified by these hint variables. Default is OFF.


List of Boost versions not known to this module.(Boost install locations may contain the version).

Users may set these hints or results as CACHE entries. Projectsshould not read these entries directly but instead use the aboveresult variables. Note that some hint names start in upper-caseBOOST. One may specify these as environment variables if they arenot specified as CMake variables or cache entries.

This module first searches for the Boost header files using the abovehint variables (excluding BOOST_LIBRARYDIR) and saves the result inBoost_INCLUDE_DIR. Then it searches for requested component librariesusing the above hints (excluding BOOST_INCLUDEDIR andBoost_ADDITIONAL_VERSIONS), 'lib' directories near Boost_INCLUDE_DIR,and the library name configuration settings below. It saves thelibrary directories in Boost_LIBRARY_DIR_DEBUG andBoost_LIBRARY_DIR_RELEASE and individual librarylocations in Boost_<COMPONENT>_LIBRARY_DEBUG and Boost_<COMPONENT>_LIBRARY_RELEASE.When one changes settings used by previous searches in the same buildtree (excluding environment variables) this module discards previoussearch results affected by the changes and searches again.

Imported Targets¶

This module defines the following IMPORTED targets:


Target for header-only dependencies. (Boost include directory).


New in version 3.15: Alias for Boost::boost.


Target for specific component dependency (shared or static library);<component> name is lower-case.


Interface target to enable diagnostic information about Boost's automaticlinking during compilation (adds -DBOOST_LIB_DIAGNOSTIC).


Interface target to disable automatic linking with MSVC(adds -DBOOST_ALL_NO_LIB).


Interface target to enable dynamic linking linking with MSVC(adds -DBOOST_ALL_DYN_LINK).

Implicit dependencies such as Boost::filesystem requiringBoost::system will be automatically detected and satisfied, evenif system is not specified when using find_package() and ifBoost::system is not added to target_link_libraries(). If usingBoost::thread, then Threads::Threads will also be added automatically.

It is important to note that the imported targets behave differentlythan variables created by this module: multiple calls tofind_package(Boost) in the same directory or sub-directories withdifferent options (e.g. static or shared) will not override thevalues of the targets created by the first call.

Other Variables¶

Boost libraries come in many variants encoded in their file name.Users or projects may tell this module which variant to find bysetting variables:


Set to ON or OFF to specify whether to search and use the debuglibraries. Default is ON.


New in version 3.10.

Set to ON or OFF to specify whether to search and use the releaselibraries. Default is ON.


Set to OFF to use the non-multithreaded libraries ('mt' tag). Default isON.


Set to ON to force the use of the static libraries. Default is OFF.


Set to ON or OFF to specify whether to use libraries linkedstatically to the C++ runtime ('s' tag). Default is platform dependent.


Set to ON or OFF to specify whether to use libraries linked to theMS debug C++ runtime ('g' tag). Default is ON.


Set to ON to use libraries compiled with a debug Python build ('y'tag). Default is OFF.


Set to ON to use libraries compiled with STLPort ('p' tag). Default isOFF.


Set to ON to use libraries compiled with STLPort deprecated 'nativeiostreams' ('n' tag). Default is OFF.


Set to the compiler-specific library suffix (e.g. -gcc43). Default isauto-computed for the C++ compiler in use.

Changed in version 3.9: A list may be used if multiple compatible suffixes should be tested for,in decreasing order of preference.


Set to the platform-specific library name prefix (e.g. lib) used byBoost static libs. This is needed only on platforms where CMake does notknow the prefix by default.


New in version 3.13.

Set to the architecture-specific library suffix (e.g. -x64).Default is auto-computed for the C++ compiler in use.


Goldwell Double Boost Root Lift Spray

Suffix for thread component library name, such as pthread orwin32. Names with and without this suffix will both be tried.


Alternate namespace used to build boost with e.g. if set to myboost,will search for myboost_thread instead of boost_thread.

Other variables one may set to control this module are:


Set to ON to enable debug output from FindBoost.Please enable this before filing any bug report.


Set to ON to resolve symlinks for discovered libraries to assist withpackaging. For example, the 'system' component library may be resolved to/usr/lib/ instead of/usr/lib/ This does not affect linking and shouldnot be enabled unless the user needs this information.


Default value for Boost_LIBRARY_DIR_RELEASE andBoost_LIBRARY_DIR_DEBUG.


Set to ON to suppress the warning about unknown dependencies for newBoost versions.

On Visual Studio and Borland compilers Boost headers request automaticlinking to corresponding libraries. This requires matching librariesto be linked explicitly or available in the link library search path.In this case setting Boost_USE_STATIC_LIBS to OFF may not achievedynamic linking. Boost automatic linking typically requests staticlibraries with a few exceptions (such as Boost.Python). Use:

to ask Boost to report information about automatic linking requests.


Find Boost headers only:

Find Boost libraries and use imported targets:

Find Boost Python 3.6 libraries and use imported targets:

Find Boost headers and some static (release only) libraries:

Boost_root Variable

Boost CMake¶

Boost Root Dip

If Boost was built using the boost-cmake project or from Boost 1.70.0 onit provides a package configuration file for use with find_package's config mode.This module looks for the package configuration file calledBoostConfig.cmake or boost-config.cmake and stores the result inCACHE entry Boost_DIR. If found, the package configuration file is loadedand this module returns with no further action. See documentation ofthe Boost CMake package configuration for details on what it provides.

Boost_root Cmake

Set Boost_NO_BOOST_CMAKE to ON, to disable the search for boost-cmake.