| Current File : //usr/share/doc/proftpd-1.3.5e/contrib/mod_sql_sqlite.html |
<!-- $Id: mod_sql_sqlite.html,v 1.4 2009-06-29 17:10:22 castaglia Exp $ -->
<!-- $Source: /home/proftpd-core/backup/proftp-cvsroot/proftpd/doc/contrib/mod_sql_sqlite.html,v $ -->
<html>
<head>
<title>ProFTPD module mod_sql_sqlite</title>
</head>
<body bgcolor=white>
<hr><br>
<center>
<h2><b>ProFTPD module <code>mod_sql_sqlite</code></b></h2>
</center>
<hr><br>
<p>
SQLite is a lightweight embeddable database system that is gaining in
popularity. More details can be found here:
<pre>
<a href="http://www.sqlite.org/">http://www.sqlite.org</a>
</pre>
<p>
The <code>mod_sql_sqlite</code> module is designed to let ProFTPD's
<code>mod_sql</code> module connect to and use a SQLite database. This module
is contained in the <code>mod_sql_sqlite.c</code> file for ProFTPD 1.3.<i>x</i>,
and is not compiled by default. Installation instructions are discussed
<a href="#Installation">here</a>.
<p>
The most current version of <code>mod_sql_sqlite</code> is distributed with
ProFTPD.
<h2>Author</h2>
<p>
Please contact TJ Saunders <tj <i>at</i> castaglia.org> with any
questions, concerns, or suggestions regarding this module.
<p>
<hr>
<h2><a name="Installation">Installation</a></h2>
The <code>mod_sql_sqlite</code> modules requires that SQLite be installed.
<p>
After installing SQLite, follow the usual steps for using contrib modules in
proftpd, making sure to list <code>mod_sql</code>:
<pre>
./configure --with-modules=mod_sql:mod_sql_sqlite
make
make install
</pre>
You may need to specify the location of the SQLite header and library files in
your <code>configure</code> command, <i>e.g.</i>:
<pre>
./configure --with-modules=mod_sql:mod_sql_sqlite \
--with-includes=/usr/local/sqlite/include \
--with-libraries=/usr/local/sqlite/lib
</pre>
<p>
Alternatively, if your proftpd was compiled with DSO support, you can
use the <code>prxs</code> tool to build <code>mod_sql_sqlite</code> as
a shared module:
<pre>
prxs -c -i -d mod_sql_sqlite.c
</pre>
<p>
<hr>
<h2><a name="Usage">Usage</a></h2>
For the most part, <code>mod_sql_sqlite</code> requires little configuration.
In the <code>SQLConnectInfo</code> directive, simply use the full path
to the SQLite database file; no username or password are required. The
<code>SQLBackend</code> provided by <code>mod_sql_sqlite</code> is "sqlite3".
<p>
For example:
<pre>
<IfModule mod_sql_sqlite.c>
SQLBackend sqlite3
SQLConnectInfo /path/to/ftpd.db
</IfModule>
</pre>
<p>
Note that due to the way that <code>mod_sql_sqlite<code> implements database
transactions (e.g. <code>INSERT</code> and <code>UPDATE</code> SQL statements
for <code>SQLLog</code> directives), SQLite-3.6.5 or later is <b>required</b>
in order for <code>mod_sql_sqlite</code> to support <code>SQLLog</code>
directives if <code>DefaultRoot</code> or <code><Anonymous></code> are
used. (SQLite-3.6.5 and later support the MEMORY journal mode, which is
needed for supporting the <code>SQLLog</code> directives in a chrooted
process.)
<p>
<hr><br>
Author: <i>$Author: castaglia $</i><br>
Last Updated: <i>$Date: 2009-06-29 17:10:22 $</i><br>
<br><hr>
<font size=2><b><i>
© Copyright 2004-2009 TJ Saunders<br>
All Rights Reserved<br>
</i></b></font>
<hr><br>
</body>
</html>