source: server/databases/sqlite.xml

trunk
Last change on this file was 8e874375, checked in by Bruce Dubbs <bdubbs@…>, 5 weeks ago

Update to sqlite-autoconf-3400100.

  • Property mode set to 100644
File size: 7.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7<!-- moved to packages.ent because they are often forgotten...
8 <!ENTITY sqlite-dl-version "3360000">
9 <!ENTITY sqlite-doc-version "3360000">
10
11When updating, do not forget the above entities... They are anyway -->
12
13 <!ENTITY sqlite-download-http "https://sqlite.org/2022/sqlite-autoconf-&sqlite-dl-version;.tar.gz">
14 <!ENTITY sqlite-download-ftp " ">
15 <!ENTITY sqlite-md5sum "42175b1a1d23529cb133bbd2b5900afd">
16 <!ENTITY sqlite-size "3.0 MB">
17 <!ENTITY sqlite-buildsize "78 MB">
18 <!ENTITY sqlite-time "0.3 SBU (Using parallelism=4)">
19
20 <!ENTITY sqlite-docs-download "https://sqlite.org/2022/sqlite-doc-&sqlite-doc-version;.zip">
21 <!ENTITY sqlite-docs-md5sum "f4cc9073ea45b01f62b9652e5e28a383">
22 <!ENTITY sqlite-docs-size "11 MB">
23]>
24
25<sect1 id="sqlite" xreflabel="SQLite-&sqlite-version;">
26 <?dbhtml filename="sqlite.html"?>
27
28
29 <title>SQLite-&sqlite-version;</title>
30
31 <indexterm zone="sqlite">
32 <primary sortas="a-SQLite">SQLite</primary>
33 </indexterm>
34
35 <sect2 role="package">
36 <title>Introduction to SQLite</title>
37
38 <para>
39 The <application>SQLite</application> package is a software library that
40 implements a self-contained, serverless, zero-configuration, transactional
41 SQL database engine.
42 </para>
43
44 &lfs112_checked;
45
46 <bridgehead renderas="sect3">Package Information</bridgehead>
47 <itemizedlist spacing="compact">
48 <listitem>
49 <para>
50 Download (HTTP): <ulink url="&sqlite-download-http;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download (FTP): <ulink url="&sqlite-download-ftp;"/>
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download MD5 sum: &sqlite-md5sum;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Download size: &sqlite-size;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated disk space required: &sqlite-buildsize;
71 </para>
72 </listitem>
73 <listitem>
74 <para>
75 Estimated build time: &sqlite-time;
76 </para>
77 </listitem>
78 </itemizedlist>
79
80 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
81 <itemizedlist spacing="compact">
82 <title>Optional Documentation</title>
83 <listitem>
84 <para>
85 Download (HTTP): <ulink url="&sqlite-docs-download;"/>
86 </para>
87 </listitem>
88 <listitem>
89 <para>
90 Download MD5 sum: &sqlite-docs-md5sum;
91 </para>
92 </listitem>
93 <listitem>
94 <para>
95 Download size: &sqlite-docs-size;
96 </para>
97 </listitem>
98 </itemizedlist>
99
100 <bridgehead renderas="sect3">SQLite Dependencies</bridgehead>
101
102 <bridgehead renderas="sect4">Optional</bridgehead>
103 <para role="optional">
104 <ulink url="https://www.thrysoee.dk/editline/">libedit</ulink> and
105 <xref linkend="unzip"/> (required to unzip the documentation)
106 </para>
107
108 <para condition="html" role="usernotes">
109 User Notes: <ulink url="&blfs-wiki;/sqlite"/>
110 </para>
111 </sect2>
112
113 <sect2 role="installation">
114 <title>Installation of SQLite</title>
115
116 <para>
117 If you downloaded the optional documentation, issue the following command
118 to install the documentation into the source tree:
119 </para>
120
121<screen><userinput>unzip -q ../sqlite-doc-&sqlite-doc-version;.zip</userinput></screen>
122
123 <para>
124 Install <application>SQLite</application> by running the following
125 commands:
126 </para>
127
128<screen><userinput>./configure --prefix=/usr \
129 --disable-static \
130 --enable-fts5 \
131 CPPFLAGS="-DSQLITE_ENABLE_FTS3=1 \
132 -DSQLITE_ENABLE_FTS4=1 \
133 -DSQLITE_ENABLE_COLUMN_METADATA=1 \
134 -DSQLITE_ENABLE_UNLOCK_NOTIFY=1 \
135 -DSQLITE_ENABLE_DBSTAT_VTAB=1 \
136 -DSQLITE_SECURE_DELETE=1 \
137 -DSQLITE_ENABLE_FTS3_TOKENIZER=1" &amp;&amp;
138make</userinput></screen>
139
140 <para>
141 This package does not come with a test suite.
142 </para>
143
144 <para>
145 Now, as the <systemitem class="username">root</systemitem> user:
146 </para>
147
148<screen role="root"><userinput>make install</userinput></screen>
149
150 <para>
151 If you downloaded the optional documentation, issue the following commands
152 as the <systemitem class="username">root</systemitem> user to install it:
153 </para>
154
155<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/sqlite-&sqlite-version; &amp;&amp;
156cp -v -R sqlite-doc-&sqlite-doc-version;/* /usr/share/doc/sqlite-&sqlite-version;</userinput></screen>
157
158 </sect2>
159
160 <sect2 role="commands">
161 <title>Command Explanations</title>
162
163 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
164 href="../../xincludes/static-libraries.xml"/>
165
166 <para>
167 <parameter>--enable-fts5</parameter>: This switch enables support for
168 version 5 of the full text search extension.
169 </para>
170
171 <para>
172 <parameter>CPPFLAGS="-DSQLITE_ENABLE_FTS3=1
173 -DSQLITE_ENABLE_FTS3_TOKENIZER=1
174 -DSQLITE_ENABLE_FTS4=1
175 -DSQLITE_ENABLE_COLUMN_METADATA=1
176 -DSQLITE_SECURE_DELETE
177 -DSQLITE_ENABLE_UNLOCK_NOTIFY=1
178 -DSQLITE_ENABLE_DBSTAT_VTAB=1"</parameter>: Applications such as
179 <application>SeaMonkey</application> require these options
180 to be turned on.
181 The only way to do this is to include them in
182 the <envar>CFLAGS</envar> or <envar>CPPFLAGS</envar>.
183 We use the latter so the default value (or any value set by the user)
184 of <envar>CFLAGS</envar> won't be affected.
185 For further information on what can be specified see <ulink
186 url="https://www.sqlite.org/compile.html"/>.
187 </para>
188
189 </sect2>
190
191 <sect2 role="content">
192 <title>Contents</title>
193
194 <segmentedlist>
195 <segtitle>Installed Program</segtitle>
196 <segtitle>Installed Library</segtitle>
197 <segtitle>Installed Directory</segtitle>
198
199 <seglistitem>
200 <seg>
201 sqlite3
202 </seg>
203 <seg>
204 libsqlite3.so
205 </seg>
206 <seg>
207 /usr/share/doc/sqlite-&sqlite-version;
208 </seg>
209 </seglistitem>
210 </segmentedlist>
211
212 <variablelist>
213 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
214 <?dbfo list-presentation="list"?>
215 <?dbhtml list-presentation="table"?>
216
217 <varlistentry id="sqlite3">
218 <term><command>sqlite3</command></term>
219 <listitem>
220 <para>
221 is a terminal-based front-end to the <application>SQLite</application>
222 library that can evaluate queries interactively and display the
223 results
224 </para>
225 <indexterm zone="sqlite sqlite3">
226 <primary sortas="b-sqlite3">sqlite3</primary>
227 </indexterm>
228 </listitem>
229 </varlistentry>
230
231 <varlistentry id="libsqlite3">
232 <term><filename class="libraryfile">libsqlite3.so</filename></term>
233 <listitem>
234 <para>
235 contains the <application>SQLite</application> API functions
236 </para>
237 <indexterm zone="sqlite libsqlite3">
238 <primary sortas="c-libsqlite3">libsqlite3.so</primary>
239 </indexterm>
240 </listitem>
241 </varlistentry>
242
243 </variablelist>
244
245 </sect2>
246
247</sect1>
Note: See TracBrowser for help on using the repository browser.