在ARM-Linux平台上移植SQLite

在ARM-Linux平台上移植SQLite

首先从http://sqlite.org下载SQLite 3.4.2。本文中假设将sqlite-3.4.2.tar.gz下载到/home/liyan/sqlite目录下。然后，通过下列命令解压缩sqlite-3.4.2.tar.gz并将文件和目录从归档文件中抽取出来：
# tar zxvf sqlite-3.4.2.tar.gz
解压抽取完成之后将会在/home/liyan/sqlite目录下生成一个sqlite-3.4.2/子目录，在该目录中包含了编译所需要的所有源文件和配置脚本。SQLite3的所有源代码文件都位于sqlite-3.4.2/src/目录下。
和在PC环境下编译SQLite3不同，不能通过sqlite-3.4.2/目录下的configure脚本来生成Makefile文件。取而代之的是必须手动修改Makefile文件。在sqlite-3.4.2/目录下有一个Makefile范例文件Makefile.linux-gcc。首先通过下面的命令拷贝此文件并重命名为Makefile：
# cp Makefile.linux-gcc Makefile
接下来，用vim打开Makefile文件并手动修改Makefile文件的内容。首先找到Makefile文件中的下面这样一行：
TOP = ../sqlite 将其修改为：TOP = .
找到下面这样一行：TCC = gcc -O6 将其修改为：TCC = arm-linux-gcc -O6
找到下面这样一行：AR = ar cr 将其修改为：AR = arm-linux-ar cr
找到下面这样一行：RANLIB = ranlib将其修改为：RANLIB = arm-linux-ranlib
找到下面这样一行：MKSHLIB = gcc -shared 将其修改为：MKSHLIB = arm-linux-gcc -shared
注释掉下面这一行：TCL_FLAGS = -I/home/drh/tcltk/8.4linux
注释掉下面这一行：LIBTCL = /home/drh/tcltk/8.4linux/libtcl8.4g.a -lm -ldl
vi中的查找方法：在命令模式下输入“？”加要查找的字符串，再回车。输入“n”为查找下一处。
原则上，对Makefile的修改主要包括两个方面：首先是将编译器、归档工具等换成交叉工具链中的对应工具，比如，gcc换成arm-linux-gcc，ar换成ar-linux-ar，ranlib换成arm-linux-ranlib等等；其次是去掉与TCL相关的编译选项，因为默认情况下，将会编译SQLite3的Tcl语言绑定，但是在移植到ARM-Linux的时候并不需要，因此将两个与TCL有关的行注释掉。
接下来，还需要修改的一个的文件是main.mk，因为Makefile包含了这个文件。找到这个文件中的下面一行：select.o table.o tclsqlite.o tokenize.o trigger.o把它替换成：select.o table.o tokenize.o trigger.o
也就是把该行上的tclsqlite.o去掉。这样编译的时候将不会编译SQLite3的Tcl语言绑定。
自此，修改工作就完成了，接下来就可以开始编译SQLite3了，这通过make命令即可完成：
# make
编译完成之后，将在sqlite3.4.2/目录下生成库函数文件libsqlite3.a和头文件sqlite3.h，这就是所需要的两个文件了。
3、测试
这里以SQLite官方站点http://sqlite.org的quick start文档中的测试程序为例对移植到ARM-Linux上的SQLite3进行测试。该程序清单如下：

#include <stdio.h>
#include <sqlite3.h>

static int callback(void *NotUsed, int argc, char **argv, char **azColName)
{
int i;
for(i=0; i<argc; i++)
{
    printf("%s = %s/n", azColName[i], argv[i] ? argv[i] : "NULL");
}
printf("/n");
return 0;
}

int main(int argc, char **argv)
{
sqlite3 *db;
char *zErrMsg = 0;
int rc;
if( argc!=3 )
{
    fprintf(stderr, "Usage: %s DATABASE SQL-STATEMENT/n", argv[0]);
    exit(1);
}
rc = sqlite3_open(argv[1], &db);
if( rc )
{
    fprintf(stderr, "Can't open database: %s/n",sqlite3_errmsg(db));
    sqlite3_close(db);
    exit(1);
}
rc = sqlite3_exec(db, argv[2], callback, 0, &zErrMsg);
if( rc!=SQLITE_OK )
{
    fprintf(stderr, "SQL error: %s/n", zErrMsg);
    sqlite3_free(zErrMsg);
}
sqlite3_close(db);
return 0;
}

将此源程序保存为test.c，然后，通过如下命令编译该程序：

# arm-linux-gcc -I /home/liyan/sqlite/sqlite-3.4.2 -L /home/liyan/sqlite/sqlite-3.4.2 -o test test.c -lsqlite3

注意：可能会出现以下错误

/home/liyan/sqlite/sqlite-3.4.2/libsqlite3.a(os_unix.o)(.text+0x3ec): In function `sqlite3UnixDlopen':

: undefined reference to `dlopen'

/home/liyan/sqlite/sqlite-3.4.2/libsqlite3.a(os_unix.o)(.text+0x3f4): In function `sqlite3UnixDlsym':

: undefined reference to `dlsym'

/home/liyan/sqlite/sqlite-3.4.2/libsqlite3.a(os_unix.o)(.text+0x3f8): In function `sqlite3UnixDlclose':

: undefined reference to `dlclose'

collect2: ld returned 1 exit status

解决方法：在编译命令后加 “-ldl”

# arm-linux-gcc -I /home/liyan/sqlite/sqlite-3.4.2 -L /home/liyan/sqlite/sqlite-3.4.2 -o test test.c -lsqlite3 -ldl

上述编译命令中:

-I /home/liyan/sqlite/sqlite-3.4.2指明了头文件sqlite3.h所在的目录;

-L /home/liyan/sqlite/sqlite-3.4.2指定了库函数文件libsqlite3.a所在的目录;

-o test指定编译生成的文件名为test，test.c是源程序文件;

-lsqlite3指明要链接静态库文件libsqlite3.a。

编译完成后，可以通过NFS将test下载到Sitsang评估板上，通过ls命令可以看到test的大小只有300K左右：

[root@ee301 sqlite]# ls -l test

-rwxr-xr-x 1 root root 359148 09-03 13:22 test

接下来就可以测试test程序了。test程序接受两个参数：第一个参数为数据库文件名，第二个参数为要执行的SQL语句。程序中与SQLite3的API相关的地方主要有四个：sqlite3_open()， sqlite3_exec()， sqlite3_close()， sqlite3_free()。关于SQLite3的API接口请参阅文献[1]。

下面是测试test程序的完整过程，（在板子上）：

/var/tmp/ly # ./test xyz.db "create table tbl0(name varchar(10), number smallint);"

/var/tmp/ly # ./test xyz.db "insert into tbl0 values('cyc', 1);"

/var/tmp/ly # ./test xyz.db "insert into tbl0 values('dzy', 2);"

/var/tmp/ly # ./test xyz.db "select * from tbl0;"

name = cyc

number = 1

name = dzy

number = 2

解释一下上面所用的测试命令：

第一条命令在xyz.db这个数据库文件中创建了一个tbl0表，表中包含两个字段，字段name是一个变长字符串，字段number的类型为smallint；

第二条命令向数据库的tbl0表中插入了一条记录(‘cyc’,1)；

第三条命令向数据库的tbl0表中插入了一条记录(‘dzy’,2)；

第四条命令则是查询表tbl0中的所有内容，与预期的一样，这条命令打印除了数据库中的两条刚插入的记录。

由此可以得出结论，这几条命令确实都已经按照预期的目标工作了。

同时，在向数据库中插入上面所示的数据之后，可以看到数据库文件xyz.db大小已经发生了变化：

/var/tmp/ly # ls -l test

-rw-r--r-- 1 root root 2048 Sep 3 2007 xyz.db

此时数据库文件xyz.db的大小为2K。自此，SQLite3数据库在Sitsang评估板上移植完成。测试结果表明数据库能够正常工作。