嵌入式數(shù)據(jù)庫Sqlite移植教程

sqlite-3.3.17交叉編譯說明
1、在Redhat Linux9上用arm-linux-gcc編譯成功sqlite-3.3.17靜態(tài)庫版本。
2、在Redhat Linux9上用arm-linux-gcc編譯成功sqlite-3.3.17動(dòng)態(tài)庫版本。
3、在Redhat Linux9上用arm-linux-gcc編譯成功基于sqlite3靜態(tài)庫的應(yīng)用程序。
4、在Redhat Linux9上用arm-linux-gcc編譯成功基于sqlite3動(dòng)態(tài)庫的應(yīng)用程序。
//==================================================================
//Compile SQLite using the cross-compiler such as arm-linux-gcc

1. first, get sqlite-3.3.17.tar.gz from www.sqlite.org

2. unzip it
?? #tar -zxvf sqlite-3.3.17.tar.gz
3. change into the sqlite-3.3.17 directory
?? cd sqlite-3.3.17
4. make a new directory such as ''''''''build'''''''' under sqlite-3.3.17 directory,
?? mkdir sqlite-arm-linux
5. First,Please ensure the cross compiler arm-linux-gcc included in PATH,
?? Use ''''''''echo $PATH'''''''',you can look out the PATH,
?? if no,Set the path:
?? export PATH=/usr/local/arm/2.95.3/bin:$PATH
6. 3.3.17版本的configure和Makefile都不需改動(dòng)
7. change into the build directory you created
?? cd sqlite-arm-linux
8. call the edited configure script from the sqlite directory by using the following option:
../configure --disable-tcl --host=arm-linux
9. After that configure should have created a Makefile and a libtool script in your build directory.
10. run ''''''''make'''''''' command to create the sqlite3 execute file, after a successful compile

11. Now you should find a hiden “.libs” directory in your build directory containing sqlite shared object files,
?? like libsqlite3.so or static libray files like libsqlite3.a .

12. use ''''''''file sqlite3'''''''' to look the inf of sqlite3, run ''''''''arm-linux-strip sqlite3'''''''' to decrease the execute file size.
13. upload the sqlite3 to target ARM9 board by any FTP client and make it executive:
14. on ARM9 board with terminal or telnet ,run
?? chmod 775 sqlite3
15. and then run sqlite3 like this
?? sqlite3 ex2

16. ,if you see the following messages:
?? SQLite version 3.3.17
??? Enter ".help" for instructions
sqlite>

在ARM-Linux平臺(tái)上移植SQLite
1、軟硬件平臺(tái)
本文中采用的硬件平臺(tái)為Sitsang嵌入式評(píng)估板。Sitsang評(píng)估板的核心是PXA255嵌入式處理器。底層軟件系統(tǒng)是以ARM-Linux內(nèi)核為基礎(chǔ)的。
要將SQLite3移植到Sitsang評(píng)估板上，除了要有底層操作系統(tǒng)的支持外，還必須要有相應(yīng)的交叉編譯工具鏈。由于Sitsang評(píng)估板采用的是ARM-Linux作為底層操作系統(tǒng)，因此需要首先安裝ARM-Linux工具鏈。關(guān)于ARM-Linux工具鏈的安裝可以參閱文獻(xiàn)[4]。ARM-Linux工具鏈通常安裝在/usr/local/arm-linux/bin/目錄下，通常以arm-linux-開頭。本文中將會(huì)涉及到的主要是arm-linux-gcc、arm-linux-ar、arm-linux-ranlib這樣三個(gè)工具。
2、移植過程
首先從http://sqlite.org下載SQLite 3.4.2。本文中假設(shè)將sqlite-3.4.2.tar.gz下載到/home/liyan/sqlite目錄下。然后，通過下列命令解壓縮sqlite-3.4.2.tar.gz并將文件和目錄從歸檔文件中抽取出來：
# tar zxvf sqlite-3.4.2.tar.gz
解壓抽取完成之后將會(huì)在/home/liyan/sqlite目錄下生成一個(gè)sqlite-3.4.2/子目錄，在該目錄中包含了編譯所需要的所有源文件和配置腳本。SQLite3的所有源代碼文件都位于sqlite-3.4.2/src/目錄下。
和在PC環(huán)境下編譯SQLite3不同，不能通過sqlite-3.4.2/目錄下的configure腳本來生成Makefile文件。取而代之的是必須手動(dòng)修改Makefile文件。在sqlite-3.4.2/目錄下有一個(gè)Makefile范例文件Makefile.linux-gcc。首先通過下面的命令拷貝此文件并重命名為Makefile：
# cp Makefile.linux-gcc Makefile
接下來，用vim打開Makefile文件并手動(dòng)修改Makefile文件的內(nèi)容。首先找到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”為查找下一處。
原則上，對(duì)Makefile的修改主要包括兩個(gè)方面：首先是將編譯器、歸檔工具等換成交叉工具鏈中的對(duì)應(yīng)工具，比如，gcc換成arm-linux-gcc，ar換成ar-linux-ar，ranlib換成arm-linux-ranlib等等；其次是去掉與TCL相關(guān)的編譯選項(xiàng)，因?yàn)槟J(rèn)情況下，將會(huì)編譯SQLite3的Tcl語言綁定，但是在移植到ARM-Linux的時(shí)候并不需要，因此將兩個(gè)與TCL有關(guān)的行注釋掉。
接下來，還需要修改的一個(gè)的文件是main.mk，因?yàn)镸akefile包含了這個(gè)文件。找到這個(gè)文件中的下面一行：select.o table.o tclsqlite.o tokenize.o trigger.o把它替換成：select.o table.o tokenize.o trigger.o
也就是把該行上的tclsqlite.o去掉。這樣編譯的時(shí)候?qū)⒉粫?huì)編譯SQLite3的Tcl語言綁定。
自此，修改工作就完成了，接下來就可以開始編譯SQLite3了，這通過make命令即可完成：
# make
編譯完成之后，將在sqlite3.4.2/目錄下生成庫函數(shù)文件libsqlite3.a和頭文件sqlite3.h，這就是所需要的兩個(gè)文件了。
3、測試
這里以SQLite官方站點(diǎn)http://sqlite.org的quick start文檔中的測試程序?yàn)槔龑?duì)移植到ARM-Linux上的SQLite3進(jìn)行測試。該程序清單如下：

#include

#include

static int callback(void *NotUsed, int argc, char **argv, char **azColName)

{

int i;

for(i=0; 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

注意：可能會(huì)出現(xiàn)以下錯(cuò)誤

/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指定了庫函數(shù)文件libsqlite3.a所在的目錄;

-o test指定編譯生成的文件名為test，test.c是源程序文件;

-lsqlite3指明要鏈接靜態(tài)庫文件libsqlite3.a。

編譯完成后，可以通過NFS將test下載到Sitsang評(píng)估板上，通過ls命令可以看到test的大小只有300K左右：

[root@ee301 sqlite]# ls -l test

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

接下來就可以測試test程序了。test程序接受兩個(gè)參數(shù)：第一個(gè)參數(shù)為數(shù)據(jù)庫文件名，第二個(gè)參數(shù)為要執(zhí)行的SQL語句。程序中與SQLite3的API相關(guān)的地方主要有四個(gè)：sqlite3_open()， sqlite3_exec()， sqlite3_close()， sqlite3_free()。關(guān)于SQLite3的API接口請(qǐng)參閱文獻(xiàn)[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這個(gè)數(shù)據(jù)庫文件中創(chuàng)建了一個(gè)tbl0表，表中包含兩個(gè)字段，字段name是一個(gè)變長字符串，字段number的類型為smallint；

第二條命令向數(shù)據(jù)庫的tbl0表中插入了一條記錄(‘cyc’,1)；

第三條命令向數(shù)據(jù)庫的tbl0表中插入了一條記錄(‘dzy’,2)；

第四條命令則是查詢表tbl0中的所有內(nèi)容，與預(yù)期的一樣，這條命令打印除了數(shù)據(jù)庫中的兩條剛插入的記錄。

由此可以得出結(jié)論，這幾條命令確實(shí)都已經(jīng)按照預(yù)期的目標(biāo)工作了。

同時(shí)，在向數(shù)據(jù)庫中插入上面所示的數(shù)據(jù)之后，可以看到數(shù)據(jù)庫文件xyz.db大小已經(jīng)發(fā)生了變化：

/var/tmp/ly # ls -l test

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

此時(shí)數(shù)據(jù)庫文件xyz.db的大小為2K。自此，SQLite3數(shù)據(jù)庫在Sitsang評(píng)估板上移植完成。測試結(jié)果表明數(shù)據(jù)庫能夠正常工作。

參考文獻(xiàn)

[1] The Definitive Guide to SQLite。[美]Michael Owens著。Apress，2006

[2] http://sqlite.org

[3] SQLite移植手記。Hily Jiang。www.sqlite.com.cn，2006年11月

[4] Sitsang/PXA255 Evaluation Platform Linux User’s Guide。Intel Ltd，Sep. 2003

*主要參考*[5] 在ARM-Linux平臺(tái)上移植SQLite,

sqlite嵌入式數(shù)據(jù)庫在arm-linux下的編譯全攻略
sqlite嵌入式數(shù)據(jù)庫在arm-linux下的編譯全攻略 [原創(chuàng)] 2004-06-02
作者：余濤（yut616_at_sohu.com）

第一步 sqlite在arm-linux下的編譯
1、 下載sqlite：請(qǐng)到http://www.sqlite.org/download.html，將下載的代碼包解開，將生成sqlite目錄，另外新建一個(gè)build目錄，如sqlite-arm-linux，應(yīng)該是和sqlite目錄平行的同級(jí)目錄。

2、 請(qǐng)先確定你的PATH中已經(jīng)包含交叉編譯工具arm-linux-gcc?？捎谩癳cho $PATH”命令查看。如我的是“/opt/toolchain/gcc 3.2/toolchain/bin/”

3、 為了在arm-linux下能正常運(yùn)行sqlite，我們需要修改一處代碼，否則在arm板上運(yùn)行sqlite時(shí)會(huì)出現(xiàn)下面的東東：
===============================
在文件btree.c中拋出斷言，
assert( sizeof(ptr)==sizeof(char*) );
===============================
此斷言是為了保證btree（B樹）有正確的變量大小，如“ptr”和“char*”。 在不同的體系結(jié)構(gòu)的linux，如x86和arm，會(huì)有些差別。剛好讓我們?cè)赼rm-linux下遇到了:-)。那么我們可以做一定的修改。
請(qǐng)修改sqlite/src/sqliteInt.h，找到如下部分：
#ifndef INTPTR_TYPE
# if SQLITE_PTR_SZ==4
# define INTPTR_TYPE int
# else
# define INTPTR_TYPE long long
# endif
在上面的代碼前加上一句：
#define SQLITE_PTR_SZ 4
這樣后面的“typedef INTPTR_TYPE ptr;”就是定義的“int”類型，而不是“l(fā)ong long”。

4、 準(zhǔn)備使用configure進(jìn)行一些配置。請(qǐng)?jiān)趕qlite目錄下的configure中找到如下4處，并將他們注釋掉，這樣可以讓configure不去檢查你的交叉編譯環(huán)境。在此提示一下：請(qǐng)你自己確定自己的“arm-linux-”系列命令在你的PATH環(huán)境變量中。如：你可以輸入“arm-linux-”再按“TAB”鍵，看其是否自動(dòng)完成命令行。
#if test "$cross_compiling" = "yes"; then
# { { echo "$as_me:12710: error: unable to find a compiler for building build tools" >&5
#echo "$as_me: error: unable to find a compiler for building build tools" >&2;}
# { (exit 1); exit 1; }; }
#fi

. . .

#else
# test "$cross_compiling" = yes &&
# { { echo "$as_me:13264: error: cannot check for file existence when cross compiling" >&5
#echo "$as_me: error: cannot check for file existence when cross compiling" >&2;}
# { (exit 1); exit 1; }; }

. . .

#else
# test "$cross_compiling" = yes &&
# { { echo "$as_me:13464: error: cannot check for file existence when cross compiling" >&5
#echo "$as_me: error: cannot check for file existence when cross compiling" >&2;}
# { (exit 1); exit 1; }; }

. . .

#else
# test "$cross_compiling" = yes &&
# { { echo "$as_me:13490: error: cannot check for file existence when cross compiling" >&5
#echo "$as_me: error: cannot check for file existence when cross compiling" >&2;}
# { (exit 1); exit 1; }; }
注釋掉后，就可以執(zhí)行configure了。在sqlite-arm-linux目錄下，輸入如下命令：
../sqlite/configure --host=arm-linux
這樣在你的build目錄中就將生成Makefile和一個(gè)libtool腳本，這些將在make時(shí)用到。

5、 修改Makefile文件
請(qǐng)修改Makefile文件，將下面的這行
BCC = arm-linux-gcc -g -O2
改掉，改成：
BCC = gcc -g -O2

一般地，我們都是將sqlite放到arm-linux的硬件板子上運(yùn)行，所以我們一般將其編譯成靜態(tài)鏈接的形式。如果是共享so庫的話，比較麻煩。
所以繼續(xù)修改Makefile，找到如下地方：
sqlite:
將有其后的“l(fā)ibsqlite.la”改成
“.libs/libsqlite.a”
大功告成，現(xiàn)在可以make了。
應(yīng)該不會(huì)出錯(cuò)，生成sqlite，libsqlite.a，libsqlite.so。你可以使用命令：find -name "sqlite";find -name "*.a";find -name "*.so"查

看文件所在的目錄。
此時(shí)生成的sqlite文件是還未strip過的，你可以使用命令“file sqlite”查看文件信息。用strip處理過后，將去掉其中的調(diào)試信息，執(zhí)行文

件大小也將小很多。命令如下：
arm-linux-strip sqlite

第二步 在arm板上運(yùn)行sqlite
將sqlite拷貝到你的arm板上，方法很多，你需要根據(jù)自己的情況來選擇。如ftp,cmdftp,wget等。
我的方法是使用wget將sqlite下載到arm板的/tmp目錄，此目錄是可寫的。命令如下：
busybox wget ftp://192.168.0.100/sqlite
上面的命令，你可以看到我的板子上是已經(jīng)有busybox來支持wget命令了的。:-)
好，開始運(yùn)行
chmod +wx sqlite
./sqlite test.sqlite
會(huì)出現(xiàn)
sqlite>
提示符號(hào)，打個(gè)“.help”來看看命令先:-)
sqlite>.help
好了?，F(xiàn)在sqlite已經(jīng)在arm-linux下跑了起來。如何，感覺不錯(cuò)吧，在arm板子上玩玩“select * from”語句蠻爽吧:-)

友情提示：
如果sqlite在處理數(shù)據(jù)庫過程中出現(xiàn)“The database disk image is malformed”，如：你在delete from sometable時(shí)，可能遇到這個(gè)問題。
那么就是你的arm板上的空間不夠（如在/tmp下），請(qǐng)刪除掉一些文件。我遇到的情況是空間還剩1-2M都會(huì)出現(xiàn)這個(gè)提示。刪除后空余4M，就正

常了(如delete from sometable)。我是開的8M的ramdisk做開發(fā)玩的:-)

謝謝閱讀。
歡迎轉(zhuǎn)載，但請(qǐng)寫明出處。

Undefined reference to dlsym
1) I checked out the code to directory called sqlite
2) I modified the Makefile.in to allow loading
extensions. We have to comment the following line
#TCC += -DSQLITE_OMIT_LOAD_EXTENSION=1
3) Created a directory called build. Ran configure and make from there.
4) I get "undefined refernce to dlsym, dlopen, dlclose" error.

Apparently the problem is with SQLite failing to find dynamic linker
library. I added LDFLAGS to command line before running make
Like this: LDFLAGS=-ldl make. Still it fails.

Please tell me what is the error.

You''''''''ll end up with a Makefile (and several other files) in this directory. Edit this mmakefile and comment out the line:

TCC += -DSQLITE_OMIT_LOAD_EXTENSION=1

I found this to be necessary to avoid errors later when I compile the shell.c (the sqlite3 CLP).

You may also what to edit the line "TLIBS = " to read

TLIBS = -ldl

Now do the following to compile and install:

~/dev/build$ make

After the make you will have a directory full of object files and the sqlite CLP executable called sqlite3

~/dev/build$ sudo make install

New libraries will be installed as /usr/local/lib/libsqlite3.a and /usr/local/lib/libsqlite3.so.0.8.6 (The former being the static lib and the later the shared lib). The sqlite3 executable is also installed in /usr/local/bin/.

Now make the amalgamated sqlite source file:

~/dev/build$ make sqlite3.c

You end up with a very large source file sqlite3.c and the header sqlite3.h which are essentially what you need to embed sqlite in your applications. You also have individual source files under the ~/dev/build/tsrc/. You will also find shell.c here - this is the source used to build the CLP.

To build the CLP using shared library:

~/dev/build$ gcc -O2 -o sqlite3 tsrc/shell.c -ldl -lsqlite3

Note that -lpthread is not required since shell.c does not require it.

You''''''''ll end up with a 39k sqlite3 executable file.

To build the CLP with the sqlite embedded:

~/dev/build$ gcc -O2 -o sqlite3 tsrc/shell.c sqlite3.c -ldl -lpthread

I end up with and executable of just under 380k size. Note that -lpthread needs to be specified since sqlite3.c uses it (I think).

I''''''''m not sure how the static library can be used. When I try

~/dev/build$ gcc -O2 -o sqlite3 tsrc/shell.c -ldl -lpthread -l:libsqlite3.a

I end up with an executable of 1.4MB in size. It still works but I think it''''''''s not right

When cross-compiling sqlite-3.4.0, I encounter this linkage error:

./.libs/libsqlite3.s undefined reference to `dlclose''''''''
./.libs/libsqlite3.s undefined reference to `dlopen''''''''
./.libs/libsqlite3.s undefined reference to `dlsym''''''''

The solution:
===========
I added in Makefile.in the "-ldl" at the end of the line.
----
sqlite3$(TEXE): $(TOP)/src/shell.c libsqlite3.la sqlite3.h
$(LTLINK) $(READLINE_FLAGS) $(LIBPTHREAD) \
-o $@ $(TOP)/src/shell.c libsqlite3.la \
$(LIBREADLINE) $(TLIBS) -ldl

My configure command is:
--------------------------------------
./configure
''''''''--build=i686-linux'''''''' \
--host=powerpc-wrs-linux-gnu \
--prefix=/usr/local \
''''''''--disable-tcl'''''''' \
''''''''--disable-debug'''''''' \
''''''''--with-gnu-ld'''''''' \
''''''''--enable-threadsafe'''''''' \
''''''''--enable-releasemode'''''''' \
--disable-static

sqlite 移植到arm-linux

不過他們用的sqlite版本相對(duì)都要老一些，有很多說明已經(jīng)不太實(shí)用。以下引用yeshi的文章，來自http://blog.chinaunix.net/u/16292/showart_149594.html：

首先在http://www.sqlite.org/download.html上下載sqlite-3.3.13.tar.gz
$ tar -zxvf sqlite-3.3.13.tar.gz ~/sqliteforuclinux/
$ cd sqliteforuclinux/sqlite-3.3.13
查看readme，內(nèi)容為：
For example:
??? tar x*** sqlite.tar.gz??? ;# Unpack the source tree into "sqlite"
??? mkdir bld??????????????? ;# Build will occur in a sibling directory
??? cd bld?????????????????? ;# Change to the build directory
??? ../sqlite/configure????? ;# Run the configure script
??? make???????????????????? ;# Run the makefile.
??? make install???????????? ;# (Optional) Install the build products
我們現(xiàn)在要做的是交叉編譯，要是為本機(jī)編譯，可以照做就可以了
$ mkdir bld
$ cd bld
export config_BUILD_CC=gcc
export config_TARGET_CC=arm-linux-gcc
修改bld/目錄下的 configure 文件的部分內(nèi)容
20420行 { (exit 1); exit 1; }; }改為 { (echo 1); echo 1; }; }
20446行 { (exit 1); exit 1; }; }改為 { (echo 1); echo 1; }; }
$ ../sqlite-3.3.13/configure --disable-tcl --prefix=/home/yeshi/sqliteforuclinux/bld --host=arm-linux
將/bld/Makefile文件中如下語句
BCC = arm-linux-gcc -g -O2
改成：
BCC = gcc -g -O2 //紅色字體的是上面貼子上的，我的不用改的，已經(jīng)是BCC = gcc -g
（我的也已經(jīng)不需要改）
$make
$make install
bld/lib 目錄下，
庫文件已經(jīng)生成在為了減小執(zhí)行文件大小可以用strip處理,去掉其中的調(diào)試信息。
arm-linux-strip libsqlit3.so.0

在這個(gè)過程中起先遇到了不認(rèn)識(shí)編譯器的問題，修改環(huán)境變量解決問題，而這個(gè)文章中沒有提到的是link tag的問題，要修改一下makefile文件，把 --tag=arm-linux放到libtool字段的link段的后面，去掉$(TCC),或者在$（TCC）之前空一格然后添上--tag=CC