Mercurial > hg > orthanc

comparison LinuxCompilation.txt @ 634:d775a3cb5a06

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
refactoring of CMake scripts
author jodogne
date Tue, 29 Oct 2013 10:31:02 +0100
parents
children cd3b60f6e7d4
comparison
equal deleted inserted replaced
633:e207b33216db 634:d775a3cb5a06
1 This file is a complement to "INSTALL", which contains instructions
2 that are specific to Linux.
3
4
5 Static linking for Linux
6 ========================
7
8 The most simple way of building Orthanc under Linux consists in
9 statically linking against all the third-party dependencies. In this
10 case, the system-wide libraries will not be used. The build tool
11 (CMake) will download the sources of all the required packages and
12 automatically compile them. This process should work on all the Linux
13 distributions.
14
15
16 To build binaries with debug information:
17
18 # cd ~/OrthancBuild
19 # cmake -DSTATIC_BUILD=ON -DCMAKE_BUILD_TYPE=Debug ~/Orthanc
20 # make
21 # make doc
22
23
24 To build a release version:
25
26 # cd ~/OrthancBuild
27 # cmake -DSTATIC_BUILD=ON -DCMAKE_BUILD_TYPE=Release ~/Orthanc
28 # make
29 # make doc
30
31
32 Note: When the "STATIC_BUILD" option is set to "ON", the build tool
33 will not ask you the permission to download packages from the
34 Internet.
35
36
37 Use system-wide libraries under Linux
38 =====================================
39
40 Under Linux, by default, Orthanc links against the shared libraries of
41 your system (the "STATIC_BUILD" option is set to "OFF"). This greatly
42 speeds up the compilation. This is also required when building
43 packages for Linux distributions. Because using system libraries is
44 the default behavior, you just have to use:
45
46 # cd ~/OrthancBuild
47 # cmake -DCMAKE_BUILD_TYPE=Debug ~/Orthanc
48 # make
49
50
51 However, on some Linux distributions, it is still required to download
52 and static link against some third-party dependencies, e.g. when the
53 system-wide library is not shipped or is outdated. Because of
54 difference in the packaging of the various Linux distribution, it is
55 also sometimes required to fine-tune some options.
56
57 You will find below build instructions for specific Linux
58 distributions. Distributions tagged by "SUPPORTED" are tested by
59 Sébastien Jodogne. Distributions tagged by "CONTRIBUTED" come from
60 Orthanc users.
61
62
63 SUPPORTED - Debian Squeeze (6.0)
64 --------------------------------
65
66 # sudo apt-get install build-essential unzip cmake mercurial \
67 uuid-dev libcurl4-gnutls-dev liblua5.1-0-dev
68
69 # cmake -DALLOW_DOWNLOADS=ON \
70 -DUSE_SYSTEM_BOOST=OFF \
71 -DUSE_SYSTEM_DCMTK=OFF \
72 -DUSE_SYSTEM_MONGOOSE=OFF \
73 -DUSE_SYSTEM_JSONCPP=OFF \
74 ~/Orthanc
75
76
77
78 Other Linux distributions?
79 --------------------------
80
81 Please send us your build instructions (by a mail to
82 s.jodogne@gmail.com)!
83
84 You can find build instructions for Orthanc up to 0.7.0 on the
85 following Wiki page:
86 https://code.google.com/p/orthanc/wiki/LinuxCompilationUpTo070
87
88 These instructions will not work as such beyond Orthanc 0.7.0, but
89 they might give indications.
90
91
92
93
94 Using ccache
95 ============
96
97 Under Linux, you also have the opportunity to use "ccache" to
98 dramatically decrease the compilation time when rebuilding
99 Orthanc. This is especially useful for developers. To this end, you
100 would use:
101
102 # CC="ccache gcc" CXX="ccache g++" cmake ~/Orthanc [Options]