source: server/databases/sqlite.xml

trunk
Last change on this file was 2222949, checked in by Pierre Labastie <pierre.labastie@…>, 4 days ago

Move version entities from sqlite.xml to packages.ent

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