summaryrefslogtreecommitdiff
path: root/docs/installation/build_unix_flags.html
blob: 6f08e9ac48b2d90981f1d46bd040f6ad4f65fc7c (plain)
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
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>Changing compile or load options</title>
    <link rel="stylesheet" href="gettingStarted.css" type="text/css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
    <link rel="start" href="index.html" title="Berkeley DB Installation and Build Guide" />
    <link rel="up" href="build_unix.html" title="Chapter 7.  Building Berkeley DB for UNIX/POSIX" />
    <link rel="prev" href="build_unix_small.html" title="Building a small memory footprint library" />
    <link rel="next" href="cross_compile_unix.html" title="Cross-Compiling on Unix" />
  </head>
  <body>
    <div xmlns="" class="navheader">
      <div class="libver">
        <p>Library Version 12.1.6.1</p>
      </div>
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">Changing compile or load
        options</th>
        </tr>
        <tr>
          <td width="20%" align="left"><a accesskey="p" href="build_unix_small.html">Prev</a> </td>
          <th width="60%" align="center">Chapter 7.  Building Berkeley DB for UNIX/POSIX
    </th>
          <td width="20%" align="right"> <a accesskey="n" href="cross_compile_unix.html">Next</a></td>
        </tr>
      </table>
      <hr />
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <div class="titlepage">
        <div>
          <div>
            <h2 class="title" style="clear: both"><a id="build_unix_flags"></a>Changing compile or load
        options</h2>
          </div>
        </div>
      </div>
      <p>
        You can specify compiler and/or compile and load time flags
        by using environment variables during Berkeley DB
        configuration. For example, if you want to use a specific
        compiler, specify the CC environment variable before running
        configure:
    </p>
      <pre class="programlisting">prompt: env CC=gcc ../dist/configure</pre>
      <p>
        Using anything other than the native compiler will almost
        certainly mean that you'll want to check the flags specified
        to the compiler and loader, too. 
    </p>
      <p>
        To specify debugging and optimization options for the C
        compiler, use the CFLAGS environment variable: 
    </p>
      <pre class="programlisting">prompt: env CFLAGS=-O2 ../dist/configure</pre>
      <p>
        To specify header file search directories and other
        miscellaneous options for the C preprocessor and compiler, use
        the CPPFLAGS environment variable: 
    </p>
      <pre class="programlisting">prompt: env CPPFLAGS=-I/usr/contrib/include ../dist/configure</pre>
      <p> 
        To specify debugging and optimization options for the C++
        compiler, use the CXXFLAGS environment variable: 
    </p>
      <pre class="programlisting">prompt: env CXXFLAGS=-Woverloaded-virtual ../dist/configure</pre>
      <p>
        To specify miscellaneous options or additional library
        directories for the linker, use the LDFLAGS environment
        variable: 
    </p>
      <pre class="programlisting">prompt: env LDFLAGS="-N32 -L/usr/local/lib" ../dist/configure</pre>
      <p>
        If you want to specify additional libraries, set the LIBS
        environment variable before running configure. For example,
        the following would specify two additional libraries to load,
        "posix" and "socket":
    </p>
      <pre class="programlisting">prompt: env LIBS="-lposix -lsocket" ../dist/configure</pre>
      <p>
        Make sure that you prepend -L to any library directory
        names and that you prepend -I to any include file directory
        names! Also, if the arguments you specify contain blank or tab
        characters, be sure to quote them as shown previously; that is
        with single or double quotes around the values you are
        specifying for LIBS. 
    </p>
      <p>
        The env command, which is available on most systems, simply
        sets one or more environment variables before running a
        command. If the env command is not available to you, you can
        set the environment variables in your shell before running
        configure. For example, in sh or ksh, you could do the
        following:
    </p>
      <pre class="programlisting">prompt: LIBS="-lposix -lsocket" ../dist/configure</pre>
      <p>
        In csh or tcsh, you could do the following: 
    </p>
      <pre class="programlisting">prompt: setenv LIBS "-lposix -lsocket"
prompt: ../dist/configure</pre>
      <p>
        See your command shell's manual page for further
        information.
    </p>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"><a accesskey="p" href="build_unix_small.html">Prev</a> </td>
          <td width="20%" align="center">
            <a accesskey="u" href="build_unix.html">Up</a>
          </td>
          <td width="40%" align="right"> <a accesskey="n" href="cross_compile_unix.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top">Building a small memory footprint library </td>
          <td width="20%" align="center">
            <a accesskey="h" href="index.html">Home</a>
          </td>
          <td width="40%" align="right" valign="top"> Cross-Compiling on
        Unix</td>
        </tr>
      </table>
    </div>
  </body>
</html>