File: Linking-programs-with-the-library.html

package info (click to toggle)
gsl-ref-html 2.3-1
  • links: PTS
  • area: non-free
  • in suites: buster
  • size: 6,876 kB
  • ctags: 4,574
  • sloc: makefile: 35
file content (116 lines) | stat: -rw-r--r-- 5,690 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 The GSL Team.

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with the
Invariant Sections being "GNU General Public License" and "Free Software
Needs Free Documentation", the Front-Cover text being "A GNU Manual",
and with the Back-Cover Text being (a) (see below). A copy of the
license is included in the section entitled "GNU Free Documentation
License".

(a) The Back-Cover Text is: "You have the freedom to copy and modify this
GNU Manual." -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Scientific Library &ndash; Reference Manual: Linking programs with the library</title>

<meta name="description" content="GNU Scientific Library &ndash; Reference Manual: Linking programs with the library">
<meta name="keywords" content="GNU Scientific Library &ndash; Reference Manual: Linking programs with the library">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Function-Index.html#Function-Index" rel="index" title="Function Index">
<link href="Compiling-and-Linking.html#Compiling-and-Linking" rel="up" title="Compiling and Linking">
<link href="Linking-with-an-alternative-BLAS-library.html#Linking-with-an-alternative-BLAS-library" rel="next" title="Linking with an alternative BLAS library">
<link href="Compiling-and-Linking.html#Compiling-and-Linking" rel="previous" title="Compiling and Linking">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Linking-programs-with-the-library"></a>
<div class="header">
<p>
Next: <a href="Linking-with-an-alternative-BLAS-library.html#Linking-with-an-alternative-BLAS-library" accesskey="n" rel="next">Linking with an alternative BLAS library</a>, Up: <a href="Compiling-and-Linking.html#Compiling-and-Linking" accesskey="u" rel="up">Compiling and Linking</a> &nbsp; [<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Linking-programs-with-the-library-1"></a>
<h4 class="subsection">2.2.1 Linking programs with the library</h4>
<a name="index-compiling-programs_002c-library-paths"></a>
<a name="index-linking-with-GSL-libraries"></a>
<a name="index-libraries_002c-linking-with"></a>
<p>The library is installed as a single file, <samp>libgsl.a</samp>.  A shared
version of the library <samp>libgsl.so</samp> is also installed on systems
that support shared libraries.  The default location of these files is
<samp>/usr/local/lib</samp>.  If this directory is not on the standard search
path of your linker you will also need to provide its location as a
command line flag.
</p>
<p>To link against the library you need to specify
both the main library and a supporting <small>CBLAS</small> library, which
provides standard basic linear algebra subroutines.  A suitable
<small>CBLAS</small> implementation is provided in the library
<samp>libgslcblas.a</samp> if your system does not provide one.  The following
example shows how to link an application with the library,
</p>
<div class="example">
<pre class="example">$ gcc -L/usr/local/lib example.o -lgsl -lgslcblas -lm
</pre></div>

<p>The default library path for <code>gcc</code> searches <samp>/usr/local/lib</samp>
automatically so the <code>-L</code> option can be omitted when GSL is
installed in its default location.  
</p>
<p>The option <code>-lm</code> links with the system math library. On some
systems it is not needed.<a name="DOCF3" href="#FOOT3"><sup>3</sup></a>
</p>
<p>For a tutorial introduction to the GNU C Compiler and related programs,
see <a href="http://www.network-theory.co.uk/gcc/intro/"><cite>An Introduction to GCC</cite></a> (ISBN 0954161793).<a name="DOCF4" href="#FOOT4"><sup>4</sup></a>
</p>
<div class="footnote">
<hr>
<h4 class="footnotes-heading">Footnotes</h4>

<h3><a name="FOOT3" href="#DOCF3">(3)</a></h3>
<p>It is not needed on MacOS X.</p>
<h3><a name="FOOT4" href="#DOCF4">(4)</a></h3>
<p><a href="http://www.network-theory.co.uk/gcc/intro/">http://www.network-theory.co.uk/gcc/intro/</a></p>
</div>



</body>
</html>