1ROOT-CONFIG(1) General Commands Manual ROOT-CONFIG(1)
2
6 root-config - ROOT utility for your Makefiles
7
9 root-config [options]
10
12 root-config is a tool that is used to configure and determine the com‐
13 piler and linker flags that should be used to compile and link programs
14 that use ROOT.
15 CPPFLAGS += $(shell root-config --cflags)
17 LDLIBS += $(shell root-config --libs)
18 LDFLAGS += $(shell root-config --ldflags)
19 %Cint.cxx:Include.h LinkDef.h
21 rootcint -f $@ -c $^
22 in your Makefile to use the built-in rules of GNU make. For GUIs,
24 replace --libs by --glibs.
25 You may also find the automake(1), autoconf(1), and libtool(1) macro
27 file /usr/share/aclocal/root.m4 useful. If that macro file isn't
28 installed where aclocal will find it, copy the contents to your local
29 acinclude.m4 file. In the directories you use ROOT libraries, have in
30 your Makefile.am file:
31 lib_LTLIBRARIES = libFoo.la
33 pkginclude_HEADERS = Foo.h
34 noinst_HEADERS = FooCint.h
35 libFoo_la_SOURCES = Foo.cxx FooCint.cxx
36 libFoo_la_LDFLAGS = -version-info 1:0 -R @ROOTLIBDIR@
37 libFoo_la_LDADD = -lCore -lCint @ROOTAUXLIBS@
38 BUILT_SOURCES = FooCint.cxx FooCint.h
40 AM_CPPFLAGS = -I@ROOTINCDIR@
42 AM_LDFLAGS = -L@ROOTLIBDIR@
43 CLEANFILES = *Cint.cxx *Cint.h *~ core
44 %Cint.cxx %Cint.h:Include.h LinkDef.h
46 @ROOTCINT@ -f $*Cint.cxx -c $(INCLUDES) $(AM_CPPFLAGS) $^
47 where you should substitute Foo with whatever, and list the appropriate
49 source files in the _SOURCES variable. In you configure.in file, put:
50 AC_PROG_CC
52 AC_PROG_CXX
53 ROOT_PATH
54 AM_PROG_LIBTOOL
55 along with any other macros you may need.
57 Note that the ROOT_PATH macro takes three optional arguments: the mini‐
59 mal ROOT version to use, action if ROOT is found, and action if ROOT
60 isn't found. Some examples are
61 ROOT_PATH(3.03/05, , AC_MSG_ERROR(Your ROOT version is too old))
63 ROOT_PATH(, AC_DEFUN(HAVE_ROOT))
64 For example, if you want to compile some part of your source tree con‐
66 ditionally on wether ROOT is present or not, you can put in your con‐
67 figure.in file
68 ROOT_PATH(,
70 [
71 AC_DEFUN(HAVE_ROOT)
72 have_root=yes
73 ])
74 AM_CONDITIONAL(GOT_ROOT, test "x$have_root" = "xyes")
75 And then in some Makefile.am
77 EXTRA_SOURCES = root_dependent_source.cc
79 if GOT_ROOT
80 LIBFOOXTRA = root_dependent_source.cc
81 else
82 LIBFOOXTRA =
83 endif
84 lib_LTLIBRARIES = libFoo.la
86 libFoo_la_SOURCES = Foo.cc $(LIBFOOXTRA)
87 The full list of substitution variables are:
89 ROOTCONF
91 full path to root-config
92 ROOTEXEC
94 full path to root
95 ROOTCINT
97 full path to rootcint
98 ROOTLIBDIR
100 Where the ROOT libraries are
101 ROOTINCDIR
103 Where the ROOT headers are
104 ROOTCFLAGS
106 Extra compiler flags
107 ROOTLIBS
109 ROOT basic libraries
110 ROOTGLIBS
112 ROOT basic + GUI libraries
113 ROOTAUXLIBS
115 Auxiliary libraries and linker flags for ROOT
116 ROOTAUXCFLAGS
118 Auxiliary compiler flags
119 ROOTRPATH
121 Same as ROOTLIBDIR
122
124 --help Give a short list of options available, and exit
125 --version
127 Report the version number of installed ROOT, and exit.
128 --prefix=<prefix>
130 If no arguments are given, reports where ROOT is installed. With
131 an argument of =<prefix>, set the base of the subsequent options
132 to <prefix>. If \--exec-prefix is passed with an argument, it
133 overrides the argument given to \--prefix for the library path.
134 --exec-prefix=<prefix>
136 If no argument is given, report where the libraries are
137 installed. If an argument is given, use that as the installation
138 base directory for the libraries. This option does not affect
139 the include path.
140 --libdir
142 Print the directory where the ROOT libraries are installed.
143 --incdir
145 Print the directory where the ROOT headers are installed.
146 --libs Output a line suitable for linking a program against the ROOT
148 libraries. No graphics libraries are included.
149 --glibs
151 As above, but also output for the graphics (GUI) libraries.
152 --evelibs
154 As above, but also output for the graphics libraries and Eve
155 libraries.
156 --cflags
158 Output a line suitable for compiling a source file against the
159 ROOT header (class declararion) files.
160 --new Put the libNew.so library in the library lists. This option
162 must be given before options --libs and --glibs.
163 --nonew
165 Compatiblity option, does nothing.
166 --auxlibs
168 Print auxiliary libraries and/or system linker flags.
169 --noauxlibs
171 Do not print auxiliary libraries and/or system linker flags in
172 the output of --libs and --glibs. --auxcflags Print auxiliary
173 compiler flags.
174 --noauxcflags
176 Do not print auxiliary compiler flags in the output of --cflags.
177 --noldflags
179 Do not print library path link option in output of --libs,
180 --evelibs and --glibs.
181 --ldflags
183 Print additional linker flags (eg. -m64)
184 --arch Print the architecture (compiler/OS)
186 --platform
188 Print the platform (OS)
189 --bindir
191 Print the binary directory of the root installation (location of
192 the root executable)
193 --etcdir
195 Print the configuration directory (place of system.rootrc, mime
196 type, valgrind suppression files and .desktop files)
197 --config
199 Print arguments used for ./configure as used when building root.
200 These cannot be used for ./configure if root was built with
201 CMake.
202 --git-revision
204 Print the ROOT git revision number from which root was built.
205 --has-<feature>
207 Test if <feature> has been enabled in the build process.
208 --features
210 Print list of all supported features
211 --ncpu Print number of available (hyperthreaded) cores
213 --python-version
215 Print the Python version used by ROOT
216 --cc Print alternative C compiler specified when ROOT was built
218 --cxx Print alternative C++ compiler specified when ROOT was built
220 --f77 Print alternative Fortran compiler specified when ROOT was built
222 --ld Print alternative Linker specified when ROOT was built
224
226 root(1), root-cint(1)
227 See also the ROOT webpages: http://root.cern.ch
229
231 The ROOT team (see web page above):
232 Rene Brun and Fons Rademakers
233
235 This library is free software; you can redistribute it and/or modify it
236 under the terms of the GNU Lesser General Public License as published
237 by the Free Software Foundation; either version 2.1 of the License, or
238 (at your option) any later version.
239 This library is distributed in the hope that it will be useful, but
241 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
242 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
243 General Public License for more details.
244 You should have received a copy of the GNU Lesser General Public
246 License along with this library; if not, write to the Free Software
247 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301
248 USA
249
251 This manual page was written by Christian Holm Christensen
252 <cholm@nbi.dk>, for the Debian GNU/Linux system (but may be used by
253 others).
254ROOT Version 3 ROOT-CONFIG(1)