|
Packit |
45fded |
|
|
Packit |
45fded |
Short overview for those who don't read manuals:
|
|
Packit |
45fded |
|
|
Packit |
45fded |
This software is compiled to binary form using a build system based on the
|
|
Packit |
45fded |
CMake framework. Therefore, the requirements to build this package are:
|
|
Packit |
45fded |
|
|
Packit |
45fded |
- cmake 2.4.3 or newer (available from http://www.cmake.org or maybe as a
|
|
Packit |
45fded |
package in your Linux distribution)
|
|
Packit |
45fded |
- GNU make
|
|
Packit |
45fded |
- working GCC compiler environment
|
|
Packit |
45fded |
- maybe additional requirements for your operating system, see
|
|
Packit |
45fded |
doc/platforms/... and FAQ.
|
|
Packit |
45fded |
Recommended: glibc (Linux standard) or GNU libiconv
|
|
Packit |
45fded |
|
|
Packit |
45fded |
COMPILATION:
|
|
Packit |
45fded |
|
|
Packit |
45fded |
Run: make
|
|
Packit |
45fded |
|
|
Packit |
45fded |
INSTALLATION:
|
|
Packit |
45fded |
|
|
Packit |
45fded |
Run: make install
|
|
Packit |
45fded |
|
|
Packit |
45fded |
To customize the target paths, some variables can be appended to this line:
|
|
Packit |
45fded |
PREFIX=/opt/cdrkit/latest (default: CMake preset, e.g. /usr/local)
|
|
Packit |
45fded |
MANSUBDIR=man (default: share/man)
|
|
Packit |
45fded |
|
|
Packit |
45fded |
TROUBLESHOOTING:
|
|
Packit |
45fded |
|
|
Packit |
45fded |
Problem: Linking error.
|
|
Packit |
45fded |
Solution: Look for missing dependencies. If you installed additional libraries
|
|
Packit |
45fded |
in non-system paths, they may have a conflict with the system libraries which
|
|
Packit |
45fded |
are already installed. Make sure that the linker gets the right ones, those
|
|
Packit |
45fded |
that belong to the headers. For example, if you installed libmagic and libiconv
|
|
Packit |
45fded |
into /usr/local/{include,lib} and your compiler or linker have different
|
|
Packit |
45fded |
defaults (eg. they use /usr/lib, /usr/include or intermix them), then you can
|
|
Packit |
45fded |
set CFLAGS and LDFLAGS vars to override the system defaults, assumed by cmake.
|
|
Packit |
45fded |
Example:
|
|
Packit |
45fded |
(AIX5l, /usr/lib is default lib dir but /usr/local/include is preferred by gcc
|
|
Packit |
45fded |
for headers), command:
|
|
Packit |
45fded |
make clean
|
|
Packit |
45fded |
make CFLAGS=-I/usr/local/include LDFLAGS=-L/usr/local/lib
|
|
Packit |
45fded |
(cleaning is important to rerun tests. Alternatively, remove build/CMakeCache*)
|
|
Packit |
45fded |
|
|
Packit |
45fded |
Problem: Library not found
|
|
Packit |
45fded |
Solution: Install the library and its development files. Depending on the
|
|
Packit |
45fded |
system distribution they can be shipped in different packages. Install them
|
|
Packit |
45fded |
all and make sure that the development files match the version of the main
|
|
Packit |
45fded |
library package.
|
|
Packit |
45fded |
|
|
Packit |
45fded |
Problem: Library not found during configuration though it's installed
|
|
Packit |
45fded |
Solution: Install the development files, see above for details.
|
|
Packit |
45fded |
|
|
Packit |
45fded |
Problem: Library not found though it's installed with dev files
|
|
Packit |
45fded |
Solution: Install the development files, see above for details. If you use
|
|
Packit |
45fded |
non-standard paths not known/searched by Cmake and/or your compiler, pass the
|
|
Packit |
45fded |
location of the headers in CFLAGS and the libraries via LDFLAGS. See examples
|
|
Packit |
45fded |
above.
|
|
Packit |
45fded |
|
|
Packit |
45fded |
Problem: None of those hints helps
|
|
Packit |
45fded |
Solution: Examine the following files:
|
|
Packit |
45fded |
build/CMakeFiles/CMakeFiles/CMakeOutput.log
|
|
Packit |
45fded |
build/CMakeFiles/CMakeOutput.log
|
|
Packit |
45fded |
and look for failed commands. Some checks are expected to fail if the platform
|
|
Packit |
45fded |
does not provide a certain feature, others must not fail. Look the failing
|
|
Packit |
45fded |
check and use THE FORCE to find related problems and solutions.
|
|
Packit |
45fded |
|