-
Notifications
You must be signed in to change notification settings - Fork 443
BuildSystem
The C++ part of BOINC consists of several components, divided into directories as follows:
the BOINC client
the BOINC Manager (GUI for the client)
the BOINC server
API for BOINC applications
utility functions, used by all the above.
To build these components on Unix, first install the software prerequisites and get the BOINC source code. Then, in the source code directory, type
./_autosetup
./configure [see options below]
make
If you have updated the tools used by the build system (make, autotools, gcc, ...) since your last build then you have to force a rebuild of the files created by _autosetup using
./_autosetup -f
If you're creating a project, you need the server and API (you don't need the client software; participants can get that from the BOINC web site). Use
./configure --disable-client --disable-manager
If you're porting the BOINC client to a new platform, use
./configure --disable-server
If you're developing or porting a BOINC application, you need only the API:
./configure --disable-server --disable-client --disable-manager
Usage:
./configure [OPTION]... [VAR=VALUE]...
You can use environment variables to override the choices made by configure
or to help it to find libraries and programs with nonstandard names/locations.
To assign environment variables (e.g., CC, CFLAGS...), specify them as VAR=VALUE
.
Example: to compile BOINC with strict compiler warnings, use
./configure CXXFLAGS="-Wall -W -Wshadow -Wpointer-arith -Wcast-qual -Wcast-align -Wwrite-strings -fno-common "
Defaults for the options are specified in brackets.
display configuration options and exit
display configuration options and exit
Override the BOINC platform name determined by autoconf. i.e. Use NAME as platform to compile into the client. Only necessary if configure does not recognize your platform correctly by default. You can check the platform after the configure step by looking at the value of the HOSTTYPE variable in config.h
Use this option to build an client that supports an alternate platform name. For example, on a x86_64 linux system that supports both 64 bit and 32 bit executables, you might specify --with-boinc-platform=x86_64-pc-linux-gnu and --with-boinc-alt-platform=i686-pc-linux-gnu.
install architecture-independent files in PREFIX [/usr/local
] By default, make install
will install all the files in /usr/local/bin
, /usr/local/lib
etc. You can specify an installation prefix other than /usr/local
using --prefix
, for instance --prefix=
. For better control, use the options below.
do not include FEATURE (same as --enable-FEATURE=no)
include FEATURE [ARG=yes]
enable tracing and debugging flags for all components (alternatively, include -g in CFLAGS and CXXFLAGS)
disable building the server component
disable building the manager component (Disabled automatically if configure can't find wxWidgets)
disable building the client component. Default: --enable-server --enable-client --enable-manager: builds server, client and manager.
build shared libraries [default=yes]
build static libraries [default=yes]
disable static linking of certain libraries
Try building a portable 'release-candidate' (currently implemented for Linux and Solaris only): this links libstd++ statically. You will probably need gcc-3.0 for this to produce a portable client-binary. It is therefore recommended to use CC=gcc-3.0 and CXX=g++-3.0 for this. (Default = no)
use PACKAGE [ARG=yes]
do not use PACKAGE (same as --with-PACKAGE=no)
use the X Window System
use Apple OpenGL framework (Mac OS X only)
Use installed version of wxWidgets in PATH
wx-config script to use (optional)
C compiler command
C compiler flags
linker flags, e.g. -L if you have libraries in a nonstandard directory
C/C++ preprocessor flags, e.g. -I if you have headers in a nonstandard directory
C++ compiler command
C++ compiler flags.
C preprocessor
C++ preprocessor
Fortran 77 compiler command
Fortran 77 compiler flags
mysql_config program
The top-level Makefile.am
contains the SUBDIRS=
line which sets up directory recursion,
and the rules for creating source distributions.
Each subdirectory's Makefile.am
contains the rules for making the binaries
and libraries in that directory and any extra files to distribute.
If you create a new directory with another Makefile.am
, you should
- make sure the directory is referenced by a
SUBDIRS=
line from its parentMakefile.am
- add it to the AC_CONFIG_FILES directive in
configure.ac
.
To set the BOINC client version:
set-version 5.12.47
in the BOINC top-level source directory.
This updates the AC_INIT
line in configure.ac
and regenerates files that use the version numbers
(config.h, py/version.py, test/version.inc, client/win/win_config.h, Makefiles)