Debian Codegraph @

doc/programmers-guide/loadinglibdbi.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 >Loading libdbi at runtime</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="Generic Example Program"
17 HREF="quickstart-code.html"><LINK
18 REL="NEXT"
19 TITLE="Using libdbi in multithreaded applications"
20 HREF="threads.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="quickstart-code.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="threads.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="LOADINGLIBDBI"
77 >3.3. Loading libdbi at runtime</A
78 ></H1
79 ><P
80 >The generic example shown in the previous section assumed that the program is linked against libdbi. This is in fact the recommended way to add libdbi functionality to your programs. However, there are situations where this approach will not work. Some programs are designed to load modules at runtime to extend their capabilities. A well-known example is the web server Apache, which uses loadable modules to custom-tailor its capabilities. If such a module were to use libdbi, we'd look at the following pattern:</P
81 ><DIV
82 CLASS="INFORMALEXAMPLE"
83 ><P
84 ></P
85 ><A
86 NAME="AEN302"
87 ></A
88 ><P
89 >Parent =&gt; dl_open(module) =&gt; dl_open(driver)</P
90 ><P
91 ></P
92 ></DIV
93 ><P
94 >The dynamically loaded module is linked against libdbi whereas the parent application is not. For this pattern to work, the drivers are linked against libdbi by default. This avoids "undefined symbol" errors at runtime, but may cause problems under arcane conditions or on equally arcane operating systems. If you should ever encounter such problems, you can switch off linking the drivers against libdbi like this:</P
95 ><TABLE
96 BORDER="0"
97 BGCOLOR="#000000"
98 WIDTH="100%"
99 ><TR
100 ><TD
101 ><FONT
102 COLOR="#32CD32"
103 ><PRE
104 CLASS="SCREEN"
105 ><SAMP
106 CLASS="PROMPT"
107 >~/libdbi-drivers #</SAMP
108 ><KBD
109 CLASS="USERINPUT"
110 >./configure --disable-libdbi --with-mysql</KBD
111 ></PRE
112 ></FONT
113 ></TD
114 ></TR
115 ></TABLE
116 ></DIV
117 ><DIV
118 CLASS="NAVFOOTER"
119 ><HR
120 ALIGN="LEFT"
121 WIDTH="100%"><TABLE
122 SUMMARY="Footer navigation table"
123 WIDTH="100%"
124 BORDER="0"
125 CELLPADDING="0"
126 CELLSPACING="0"
127 ><TR
128 ><TD
129 WIDTH="33%"
130 ALIGN="left"
131 VALIGN="top"
132 ><A
133 HREF="quickstart-code.html"
134 ACCESSKEY="P"
135 >Prev</A
136 ></TD
137 ><TD
138 WIDTH="34%"
139 ALIGN="center"
140 VALIGN="top"
141 ><A
142 HREF="index.html"
143 ACCESSKEY="H"
144 >Home</A
145 ></TD
146 ><TD
147 WIDTH="33%"
148 ALIGN="right"
149 VALIGN="top"
150 ><A
151 HREF="threads.html"
152 ACCESSKEY="N"
153 >Next</A
154 ></TD
155 ></TR
156 ><TR
157 ><TD
158 WIDTH="33%"
159 ALIGN="left"
160 VALIGN="top"
161 >Generic Example Program</TD
162 ><TD
163 WIDTH="34%"
164 ALIGN="center"
165 VALIGN="top"
166 ><A
167 HREF="quickstart.html"
168 ACCESSKEY="U"
169 >Up</A
170 ></TD
171 ><TD
172 WIDTH="33%"
173 ALIGN="right"
174 VALIGN="top"
175 >Using libdbi in multithreaded applications</TD
176 ></TR
177 ></TABLE
178 ></DIV
179 ></BODY
180 ></HTML
181 >