~ubuntu-branches/ubuntu/precise/libdbi-drivers/precise

« back to all changes in this revision

Viewing changes to drivers/sqlite/dbd_sqlite/x54.html

  • Committer: Bazaar Package Importer
  • Author(s): Steve Langasek
  • Date: 2008-08-02 09:00:11 UTC
  • mfrom: (3.1.6 intrepid)
  • Revision ID: james.westby@ubuntu.com-20080802090011-j05v2349u2ptvg05
Tags: 0.8.2-1-4.1
* Non-maintainer upload with maintainer's approval.
* High urgency upload for RC bugfix.
* Pass --freetds-inc-dir to configure, to bypass the ridiculous upstream
  AC_FIND_FILE() checks for files that *aren't used during the build*;
  fixes a build failure with FreeTDS 0.82.  Closes: #493349.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<HTML
 
2
><HEAD
 
3
><TITLE
 
4
>Build and install the sqlite driver</TITLE
 
5
><META
 
6
NAME="GENERATOR"
 
7
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
 
8
"><LINK
 
9
REL="HOME"
 
10
TITLE="sqlite driver manual"
 
11
HREF="index.html"><LINK
 
12
REL="UP"
 
13
TITLE="Installation"
 
14
HREF="c37.html"><LINK
 
15
REL="PREVIOUS"
 
16
TITLE="Prerequisites"
 
17
HREF="x40.html"><LINK
 
18
REL="NEXT"
 
19
TITLE="Driver options"
 
20
HREF="c92.html"></HEAD
 
21
><BODY
 
22
CLASS="SECT1"
 
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
>sqlite driver manual: A libdbi driver using the SQLite embedded database engine</TH
 
41
></TR
 
42
><TR
 
43
><TD
 
44
WIDTH="10%"
 
45
ALIGN="left"
 
46
VALIGN="bottom"
 
47
><A
 
48
HREF="x40.html"
 
49
ACCESSKEY="P"
 
50
>Prev</A
 
51
></TD
 
52
><TD
 
53
WIDTH="80%"
 
54
ALIGN="center"
 
55
VALIGN="bottom"
 
56
>Chapter 2. Installation</TD
 
57
><TD
 
58
WIDTH="10%"
 
59
ALIGN="right"
 
60
VALIGN="bottom"
 
61
><A
 
62
HREF="c92.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="SECT1"
 
73
><H1
 
74
CLASS="SECT1"
 
75
><A
 
76
NAME="AEN54">2.2. Build and install the sqlite driver</H1
 
77
><P
 
78
>First you have to unpack the libdbi-drivers archive in a suitable directory. Unpacking will create a new subdirectory <TT
 
79
CLASS="FILENAME"
 
80
>libdbi-drivers-X.Y</TT
 
81
> where "X.Y" denotes the version:</P
 
82
><TABLE
 
83
BORDER="0"
 
84
BGCOLOR="#000000"
 
85
WIDTH="100%"
 
86
><TR
 
87
><TD
 
88
><FONT
 
89
COLOR="#32CD32"
 
90
><PRE
 
91
CLASS="SCREEN"
 
92
><TT
 
93
CLASS="PROMPT"
 
94
>$ </TT
 
95
><TT
 
96
CLASS="USERINPUT"
 
97
><B
 
98
>tar -xzf libdbi-drivers-0.3.tar.gz</B
 
99
></TT
 
100
></PRE
 
101
></FONT
 
102
></TD
 
103
></TR
 
104
></TABLE
 
105
><P
 
106
>The libdbi-drivers project consists of several drivers that use a common build system. Therefore you <EM
 
107
>must</EM
 
108
> tell configure explicitly that you want to build the sqlite driver (you can list as many drivers as you want to build):</P
 
109
><TABLE
 
110
BORDER="0"
 
111
BGCOLOR="#000000"
 
112
WIDTH="100%"
 
113
><TR
 
114
><TD
 
115
><FONT
 
116
COLOR="#32CD32"
 
117
><PRE
 
118
CLASS="SCREEN"
 
119
><TT
 
120
CLASS="PROMPT"
 
121
>$ </TT
 
122
><TT
 
123
CLASS="USERINPUT"
 
124
><B
 
125
>cd libdbi-drivers</B
 
126
></TT
 
127
></PRE
 
128
></FONT
 
129
></TD
 
130
></TR
 
131
></TABLE
 
132
><TABLE
 
133
BORDER="0"
 
134
BGCOLOR="#000000"
 
135
WIDTH="100%"
 
136
><TR
 
137
><TD
 
138
><FONT
 
139
COLOR="#32CD32"
 
140
><PRE
 
141
CLASS="SCREEN"
 
142
><TT
 
143
CLASS="PROMPT"
 
144
>$ </TT
 
145
><TT
 
146
CLASS="USERINPUT"
 
147
><B
 
148
>./configure --with-sqlite</B
 
149
></TT
 
150
></PRE
 
151
></FONT
 
152
></TD
 
153
></TR
 
154
></TABLE
 
155
><P
 
156
>Run <B
 
157
CLASS="COMMAND"
 
158
>./configure --help</B
 
159
> to find out about additional options.</P
 
160
><P
 
161
>Then build the driver with the command:</P
 
162
><TABLE
 
163
BORDER="0"
 
164
BGCOLOR="#000000"
 
165
WIDTH="100%"
 
166
><TR
 
167
><TD
 
168
><FONT
 
169
COLOR="#32CD32"
 
170
><PRE
 
171
CLASS="SCREEN"
 
172
><TT
 
173
CLASS="PROMPT"
 
174
>$ </TT
 
175
><TT
 
176
CLASS="USERINPUT"
 
177
><B
 
178
>make</B
 
179
></TT
 
180
></PRE
 
181
></FONT
 
182
></TD
 
183
></TR
 
184
></TABLE
 
185
><DIV
 
186
CLASS="NOTE"
 
187
><BLOCKQUOTE
 
188
CLASS="NOTE"
 
189
><P
 
190
><B
 
191
>Note: </B
 
192
>Please note that you may have to invoke <B
 
193
CLASS="COMMAND"
 
194
>gmake</B
 
195
>, the GNU version of make, on some systems.</P
 
196
></BLOCKQUOTE
 
197
></DIV
 
198
><P
 
199
>Then install the driver with the command (you'll need root permissions to do this):</P
 
200
><TABLE
 
201
BORDER="0"
 
202
BGCOLOR="#000000"
 
203
WIDTH="100%"
 
204
><TR
 
205
><TD
 
206
><FONT
 
207
COLOR="#32CD32"
 
208
><PRE
 
209
CLASS="SCREEN"
 
210
><TT
 
211
CLASS="PROMPT"
 
212
>$ </TT
 
213
><TT
 
214
CLASS="USERINPUT"
 
215
><B
 
216
>make install</B
 
217
></TT
 
218
></PRE
 
219
></FONT
 
220
></TD
 
221
></TR
 
222
></TABLE
 
223
><P
 
224
>To test the operation of the newly installed driver, use the command:</P
 
225
><TABLE
 
226
BORDER="0"
 
227
BGCOLOR="#000000"
 
228
WIDTH="100%"
 
229
><TR
 
230
><TD
 
231
><FONT
 
232
COLOR="#32CD32"
 
233
><PRE
 
234
CLASS="SCREEN"
 
235
><TT
 
236
CLASS="PROMPT"
 
237
>$ </TT
 
238
><TT
 
239
CLASS="USERINPUT"
 
240
><B
 
241
>make check</B
 
242
></TT
 
243
></PRE
 
244
></FONT
 
245
></TD
 
246
></TR
 
247
></TABLE
 
248
><P
 
249
>This command creates and runs a test program that performs a few basic input and output tests. The program will ask for a database name. This can be any name that is a valid filename on your system. It will also ask for a data directory. This is the directory that is used to create the test database. Needless to say that you need write access to that directory. If you accept the default ".", the database will be created in the <TT
 
250
CLASS="FILENAME"
 
251
>tests</TT
 
252
> subdirectory.</P
 
253
><DIV
 
254
CLASS="NOTE"
 
255
><BLOCKQUOTE
 
256
CLASS="NOTE"
 
257
><P
 
258
><B
 
259
>Note: </B
 
260
>If for some reason you need to re-create the autoconf/automake-related files, try running <B
 
261
CLASS="COMMAND"
 
262
>./autogen.sh</B
 
263
>. I've found out that the current stable autoconf/automake/libtool versions (as found in FreeBSD 4.7 and Debian 3.0) do not cooperate well, so I found it necessary to run the older autoconf 2.13. If necessary, edit <TT
 
264
CLASS="FILENAME"
 
265
>autogen.sh</TT
 
266
> so that it will catch the older autoconf version on your system.</P
 
267
></BLOCKQUOTE
 
268
></DIV
 
269
></DIV
 
270
><DIV
 
271
CLASS="NAVFOOTER"
 
272
><HR
 
273
ALIGN="LEFT"
 
274
WIDTH="100%"><TABLE
 
275
SUMMARY="Footer navigation table"
 
276
WIDTH="100%"
 
277
BORDER="0"
 
278
CELLPADDING="0"
 
279
CELLSPACING="0"
 
280
><TR
 
281
><TD
 
282
WIDTH="33%"
 
283
ALIGN="left"
 
284
VALIGN="top"
 
285
><A
 
286
HREF="x40.html"
 
287
ACCESSKEY="P"
 
288
>Prev</A
 
289
></TD
 
290
><TD
 
291
WIDTH="34%"
 
292
ALIGN="center"
 
293
VALIGN="top"
 
294
><A
 
295
HREF="index.html"
 
296
ACCESSKEY="H"
 
297
>Home</A
 
298
></TD
 
299
><TD
 
300
WIDTH="33%"
 
301
ALIGN="right"
 
302
VALIGN="top"
 
303
><A
 
304
HREF="c92.html"
 
305
ACCESSKEY="N"
 
306
>Next</A
 
307
></TD
 
308
></TR
 
309
><TR
 
310
><TD
 
311
WIDTH="33%"
 
312
ALIGN="left"
 
313
VALIGN="top"
 
314
>Prerequisites</TD
 
315
><TD
 
316
WIDTH="34%"
 
317
ALIGN="center"
 
318
VALIGN="top"
 
319
><A
 
320
HREF="c37.html"
 
321
ACCESSKEY="U"
 
322
>Up</A
 
323
></TD
 
324
><TD
 
325
WIDTH="33%"
 
326
ALIGN="right"
 
327
VALIGN="top"
 
328
>Driver options</TD
 
329
></TR
 
330
></TABLE
 
331
></DIV
 
332
></BODY
 
333
></HTML
 
334
>
 
 
b'\\ No newline at end of file'