Debian Codegraph @

doc/programmers-guide/addtoproject.html

raw
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2 <HTML
3 ><HEAD
4 ><TITLE
5 >Adding libdbi to your project</TITLE
6 ><META
7 NAME="GENERATOR"
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9 REL="HOME"
10 TITLE="Database Independent Abstraction Layer for C"
11 HREF="index.html"><LINK
12 REL="UP"
13 TITLE="libdbi in a Nutshell (Quickstart Guide)"
14 HREF="quickstart.html"><LINK
15 REL="PREVIOUS"
16 TITLE="Using libdbi in multithreaded applications"
17 HREF="threads.html"><LINK
18 REL="NEXT"
19 TITLE="Error Handling"
20 HREF="errorhandling.html"></HEAD
21 ><BODY
22 CLASS="SECTION"
23 BGCOLOR="#FFFFFF"
24 TEXT="#000000"
25 LINK="#0000FF"
26 VLINK="#840084"
27 ALINK="#0000FF"
28 ><DIV
29 CLASS="NAVHEADER"
30 ><TABLE
31 SUMMARY="Header navigation table"
32 WIDTH="100%"
33 BORDER="0"
34 CELLPADDING="0"
35 CELLSPACING="0"
36 ><TR
37 ><TH
38 COLSPAN="3"
39 ALIGN="center"
40 >Database Independent Abstraction Layer for C: libdbi Programmer's Guide</TH
41 ></TR
42 ><TR
43 ><TD
44 WIDTH="10%"
45 ALIGN="left"
46 VALIGN="bottom"
47 ><A
48 HREF="threads.html"
49 ACCESSKEY="P"
50 >Prev</A
51 ></TD
52 ><TD
53 WIDTH="80%"
54 ALIGN="center"
55 VALIGN="bottom"
56 >Chapter 3. libdbi in a Nutshell (Quickstart Guide)</TD
57 ><TD
58 WIDTH="10%"
59 ALIGN="right"
60 VALIGN="bottom"
61 ><A
62 HREF="errorhandling.html"
63 ACCESSKEY="N"
64 >Next</A
65 ></TD
66 ></TR
67 ></TABLE
68 ><HR
69 ALIGN="LEFT"
70 WIDTH="100%"></DIV
71 ><DIV
72 CLASS="SECTION"
73 ><H1
74 CLASS="SECTION"
75 ><A
76 NAME="ADDTOPROJECT"
77 >3.5. Adding libdbi to your project</A
78 ></H1
79 ><P
80 >If your project uses autoconf to manage the build process on the target machine, you should add some tests to your <TT
81 CLASS="FILENAME"
82 >./configure</TT
83 > script to check for the presence and usability of libdbi. The following example shows how this can be done:</P
84 ><TABLE
85 BORDER="0"
86 BGCOLOR="#E0E0E0"
87 WIDTH="100%"
88 ><TR
89 ><TD
90 ><FONT
91 COLOR="#000000"
92 ><PRE
93 CLASS="PROGRAMLISTING"
94 >dnl check for dynamic linking functions
95 AC_CHECK_LIB(dl,dlopen)
96
97 dnl check for the libdbi library
98 AC_CHECK_LIB(dbi,dbi_initialize)
99
100 dnl to check for the availability and function of a particular
101 dnl driver we need a runtime check (since the driver is loaded
102 dnl dynamically). This example checks for the mysql driver
103 AC_MSG_CHECKING("for libdbi mysql driver (dynamic load)")
104 AC_RUN_IFELSE(
105 [AC_LANG_PROGRAM(,
106 [[dbi_initialize(0); return(dbi_conn_new("mysql") ? 0 : 1);]])],
107 [AC_MSG_RESULT("yes")],
108 [AC_MSG_FAILURE("mysql driver not installed?")])</PRE
109 ></FONT
110 ></TD
111 ></TR
112 ></TABLE
113 ><P
114 >The first two tests add the appropriate flags to the <CODE
115 CLASS="VARNAME"
116 >LIBS</CODE
117 > variable to link against the required libraries.</P
118 ><P
119 >In addition, you have to make sure that both the directory which contains the libdbi header file directory (usually <TT
120 CLASS="FILENAME"
121 >/usr/include</TT
122 > or <TT
123 CLASS="FILENAME"
124 >/usr/local/include</TT
125 >) as well as the directory which contains the libdbi library (usually <TT
126 CLASS="FILENAME"
127 >/usr/lib</TT
128 > or <TT
129 CLASS="FILENAME"
130 >/usr/local/lib</TT
131 >) are accessible to the compiler and to the linker by using the <CODE
132 CLASS="OPTION"
133 >-I</CODE
134 > and <CODE
135 CLASS="OPTION"
136 >-L</CODE
137 > compiler flags, respectively.</P
138 ></DIV
139 ><DIV
140 CLASS="NAVFOOTER"
141 ><HR
142 ALIGN="LEFT"
143 WIDTH="100%"><TABLE
144 SUMMARY="Footer navigation table"
145 WIDTH="100%"
146 BORDER="0"
147 CELLPADDING="0"
148 CELLSPACING="0"
149 ><TR
150 ><TD
151 WIDTH="33%"
152 ALIGN="left"
153 VALIGN="top"
154 ><A
155 HREF="threads.html"
156 ACCESSKEY="P"
157 >Prev</A
158 ></TD
159 ><TD
160 WIDTH="34%"
161 ALIGN="center"
162 VALIGN="top"
163 ><A
164 HREF="index.html"
165 ACCESSKEY="H"
166 >Home</A
167 ></TD
168 ><TD
169 WIDTH="33%"
170 ALIGN="right"
171 VALIGN="top"
172 ><A
173 HREF="errorhandling.html"
174 ACCESSKEY="N"
175 >Next</A
176 ></TD
177 ></TR
178 ><TR
179 ><TD
180 WIDTH="33%"
181 ALIGN="left"
182 VALIGN="top"
183 >Using libdbi in multithreaded applications</TD
184 ><TD
185 WIDTH="34%"
186 ALIGN="center"
187 VALIGN="top"
188 ><A
189 HREF="quickstart.html"
190 ACCESSKEY="U"
191 >Up</A
192 ></TD
193 ><TD
194 WIDTH="33%"
195 ALIGN="right"
196 VALIGN="top"
197 >Error Handling</TD
198 ></TR
199 ></TABLE
200 ></DIV
201 ></BODY
202 ></HTML
203 >