Changes between Version 80 and Version 81 of CompileClient

Timestamp:

Jan 31, 2015, 3:40:39 PM (9 years ago)

Author:

Bluefin Tuna

Comment:

Rearranged the part for Linux/Unix? and made things hopefully clearer

CompileClient

@@ -9 +9 @@
  * The BOINC [userw:The_BOINC_screensaver screensaver] (Windows and Mac only)
 
-
-== Linux ==
-
-If you want to build the client software for local use on your machine only, it is enough to simply build it using
-{{{
-./_autosetup
-./configure --disable-server --enable-client CXXFLAGS="-O3 "
+== Unix and Linux ==
+
+First, download and install the [SoftwarePrereqsUnix prerequisites], then [SourceCodeGit download the current source].
+
+You should then have a directory called maybe {{{boinc-client_release-7.4-7.4.41}}}.
+
+{{{cd}}} to that directory and issue the command {{{./_autosetup}}}.
+
+Consider reading the output of {{{./configure --help}}}.
+
+=== Local use ===
+
+If you want to build the client software for local use on your machine only, configure the build process using: 
+
+{{{
+./configure --prefix=/where/boinc/will/go --disable-server --disable-manager --disable-fcgi --enable-optimize
+}}}
+
+(According to {{{./configure --help}}}, the command {{{./configure --enable-pkg-client}}} should mean 'build a client package' but doing it that way results in error {{{cannot find the library `../lib/libboinc_crypt.la'}}}.)
+
+Special flags can be passed to the compiler: for example one might add {{{CXXFLAGS="-O3"}}} to the {{{./configure}}} options. Indications whether this is actually useful are hard to come by though. With {{{--enable-optimize}}}, the CXXFLAGS are set to {{{CXXFLAGS = -g -O2 -Wall -ffast-math -O3}}} in the {{{Makefile}}}.
+
+If you have old versions of libraries (curl, openssl etc.) in {{{/usr/lib}}}, and newer versions somewhere else (for example, {{{/usr/local/lib}}}) you may need to tell the linker where to find the newer versions by adding the LDFLAGS options, as in {{{LDFLAGS=-L/usr/local/lib}}}
+
+If {{{./configure}}} ended with success, you can now start the actual build process:
+
+{{{
 make
+}}}
+
+Once this has succeeded, you may either install the result to the directory given previously to {{{./configure}}} by issuing
+
+{{{
+make install
+}}}
+
+or you may want to create a distribution package:
+
+{{{
 cd packages/generic/sea/
 make
 }}}
 
-The executables are located under the folder BOINC.
-
-If instead you intend to build portable binaries of the client software that should run on a wide variety of GNU/Linux platforms, it
+Note that making the distribution package fails if not everything has been built: 
+
+{{{
+cp: cannot stat ‘../../../stage/FOO/bin/boincmgr’: No such file or directory
+cp: cannot stat ‘../../../stage/FOO/bin/boincscr’: No such file or directory
+}}}
+
+Fake the presence of those files:
+
+{{{
+touch ../../../stage/FOO/bin/boincmgr
+touch ../../../stage/FOO/bin/boincscr
+}}}
+
+The results can now be found in the {{{sea}}} directory: located under the folder BOINC and there is also a {{{sea.tar}}} file as well as a self-extracting archive e.g. {{{boinc_7.4.41_x86_64-pc-linux-gnu.sh}}}
+
+=== Portable binaries ===
+
+If instead you intend to build hopefully portable statically linked binaries of the client software that should run on a wide variety of GNU/Linux platforms, it
 is recommended to build the client software using a virtual machine (e.g. running under Microsoft Virtual PC, download the [VmCompatibility Compatibility virtual machine image]). 
-In this case you should build using:
+
+In this case you should build using the option {{{--enable-client-release}}}
+
 {{{
 ./_autosetup
@@ -32 +81 @@
 make
 }}}
+
 See [BuildSystem details of the build system].
-
-The result (in the sea/ directory) will be a self-extracting archive (boinc_x.y.z_i686-pc-linux-gnu.sh) containing the BOINC client software.
-
-== Other Unix ==
-
- * Download and install [SoftwarePrereqsUnix prerequisites]
- * [SourceCodeGit Download current source code]
- * [BuildSystem Configure (with --disable_server) and make]
-
-The result (in the sea/ directory) will be a self-extracting archive (boinc_x.y.z_PLATFORM.sh) containing the BOINC client software.  If you have old versions of libraries (curl, openssl etc.) in /usr/lib, and newer versions somewhere else (like /usr/local/lib) you may need to tell the linker where to find the newer versions, as in:
-{{{
-./configure LDFLAGS=-L/usr/local/lib
-}}}
-
-Here is the list of packages that are needed to compile the BOINC graphics libs on Debian (the same packages should also be available on Ubuntu):
-
-{{{freeglut3-dev libsm-dev libice-dev libxmu-dev libxi-dev libx11-dev libjpeg62-dev}}}
 
 == Windows ==