ucLinux下sqlite数据库移植全攻略www.chinaitpower.com

本文讨论的是比较流行的嵌入式开发组合ARM+uclinux，即目标开发板为三星S3C4510，完成ite在其uclinux上的移植。
　
　　本文假设你已经具备正确编译uclinux的kernel的能力，即有能力完成make menuconfig；make dep；make lib_only；make user_only；make romfs；make image；make。而且还能将自己写的类似helloworld加到“用户自定义应用”中，即你能完成“uClinux-dist/Documentation/Adding-User-Apps-HOWTO”中所描述的“用户的订制”。

　　大多数需要移植ite到uclinux的开发者，应该已经具备上面的能力，而只是不清楚如何修改ite来完成其在uclinux下的编译。如果你还不能完成上面的要求，那么请先做一定的准备工作，因为本范例所涉及到的内容主要是跟ite在uclinux下的移植有关，其他的在这个过程中出现的问题，开发者需要自行处理。

　　本范例使用的uclinux是uClinux-dist-20030522.tar.gz，你可以从得到适合你的软件包。

　　交叉编译工具是arm-elf-tools-20030314.sh，你也可以在找到它。

　　本范例使用的ite是ite-2.8.15.tar.gz，本文的方法也适合于2.8.x系列的ite；可能有部分内容不适用于3.0.x系列的ite，因为3.0.x中源代码有较大的变化。

　　1、 下载ite：你可以到，下载ite-2.8.15.tar.gz软件包；

　　2、 将下载的软件包解压缩到uClinux-dist/user目录下；

　　命令：

$tar zxvf ite-2.8.15.tar.gz -C uClinux-dist/user/

　　现在在uclinux的user目录下，你应该可以看到ite目录了。解压缩到这个user目录主要是要将ite编译成一个普通的用户应用。

　　3、 用户应用的有关设置：

　　按uClinux-dist/Documentation/Adding-User-Apps-HOWTO文档中说提到的，来添加ite作为一个用户应用，将其做成一个shell，这样就类似于uclinux自己的ps命令。

　　编辑

uClinux-dist/user/Makefile
uClinux-dist/config/Configure.help
uClinux-dist/config/config.in

　　我是在这些里查找“cpu”有关的项，然后在它的下面，加上自己的ite项，这个过程并不复杂。

　　通过上面的修改后，你现在就可以运行uclinux的make menuconfig，选中“CustomizeVendor/User Settings”，再选中“Miscellaneous Applications”，可以看到它现在出现了一个新的“ite (NEW)”，这个就是我们刚添加进去的ite项。

　　在稍后的make romfs中，uclinux会将你的ite编译进来，做成romfs的一部分，因为你在uClinux-dist/user/Makefile中已经加上要编译ite项了。这样在移植后的uclinux的/bin中将会有ite命令可以让你来执行。

　　好，现在我们就要对ite进行修改，来做移植工作。

　　在下面的描述中，我们将对以下几个进行一定的添加、修改，从而来完成ite在uclinux下的编译：

ite/main.mk 修改
ite/Makefile 添加
ite/src/os.c 修改
ite/src/shell.c 修改

　　对这几个进行修改时，请自己做好这些的备份，比如你可以将它们拷贝一份，改名成名后面带.bak。这个很重要，可以避免你在修改的过程出现问题而无法还原。

　　一、修改ite/main.mk

　　1、TCCX

　　将

TCCX = $(TCC) $(OPTS) $(THREADSAFE) $(USLEEP) -I. -I$(TOP)/src

　　修改为

TCCX = $(TCC) $(OPTS) $(THREADSAFE) $(USLEEP) -I. -I$(TOP)/src $(CFLAGS)

　　即加上$(CFLAGS)标记。

　　2、 LIBOBJ

　　找到 # Object files for the SQLite library.

　　将其中的tclite.o去掉。即去掉tcl有关的东西。

　　如果没有tclite.o，那么不用处理它。

　　3、 ite$(EXE)

　　找到类似ite$(EXE)的一句，将：

ite$(EXE): $(TOP)/src/shell.c libite.a ite.h
$(TCCX) $(READLINE_FLAGS) -o ite$(EXE) $(TOP)/src/shell.c \
libite.a $(LIBREADLINE) $(THREADLIB)

　　替换为：

shell.o: $(TOP)/src/shell.c ite.h
$(TCCX) $(READLINE_FLAGS) -c $(TOP)/src/shell.c

ite$(EXE): shell.o libite.a
$(TCC) $(LDFLAGS) -o $@ shell.o \
libite.a $(LIBREADLINE) $(THREADLIB) $(LDLIBS)

　　即在ite$(EXE)上一行加上shell.o，及在其后加上$(LDLIBS)标记。这个是对/src/shell.c的编译方法的修改。

　　4、romfs

　　将：

install: ite libite.a ite.h
mv ite /usr/bin
mv libite.a /usr/lib
mv ite.h /usr/include

　　替换为：

romfs: ite
$(ROMFSINST) /bin/ite

　　即去掉make install项，加上make romfs项。 这个很重要，这将在romfs的/bin目录下生成ite。

　　5、clean

　　将：

clean:
rm -f *.o ite libite.a ite.h opcodes.*
rm -f lemon lempar.c parse.* ite*.tar.gz
rm -f $(PUBLISH)
rm -f *.da *.bb *.bbg gmon.out
rm -rf tsrc

　　替换为：

clean:
rm -f *.o ite libite.a ite.h opcodes.* ite.gdb
rm -f $(PUBLISH)
rm -f *.da *.bb *.bbg gmon.out
rm -rf tsrc

distclean: clean
rm -f lemon lempar.c parse.* ite*.tar.gz
rm -f config.h

　　即增加make distclean项。



　　二、在ite下增加Makefile

　　在ite目录下应该没有Makefile，而只是有一个ite/Makefile.linux-gcc。我们要移植ite到uclinux，那么就要自己写一个合适的Makefile。

　　内容如下：

===========Makefile内容开始===========
#!/usr/make
#
# Makefile for SQLITE
#
# This is a template makefile for SQLite. Most people prefer to
# use the autoconf generated "configure" script to generate the
# makefile automatically. But that does not work for everybody
# and in every situation. If you are having problems with the
# "configure" script, you might want to try this makefile as an
# alternative. Create a copy of this file, edit the parameters
# below and type "make".
#

#### The toplevel directory of the source tree. This is the directory
# that contains this "Makefile.in" and the "configure.in" script.
#
TOP = .

#### C Compiler and options for use in building executables that
# will run on the platform that is doing the build.
#
BCC = gcc -g -O2
#BCC = /opt/ancic/bin/c89 -0

#### If the target operating system supports the "usleep()" system
# call, then define the HAVE_USLEEP macro for all C modules.
#
#USLEEP =
USLEEP = -DHAVE_USLEEP=1

#### If you want the SQLite library to be safe for use within a
# multi-threaded program, then define the following macro
# appropriately:
#
#THREADSAFE = -DTHREADSAFE=1
THREADSAFE = -DTHREADSAFE=0

#### Specify any extra linker options needed to make the library
# thread safe
#
#THREADLIB = -lpthread
THREADLIB =

#### Leave MEMORY_DEBUG undefined for maximum speed. Use MEMORY_DEBUG=1
# to check for memory leaks. Use MEMORY_DEBUG=2 to print a log of all
# malloc()s and free()s in order to track down memory leaks.
#
# SQLite uses some expensive assert() statements in the inner loop.
# You can make the library go almost twice as fast if you compile
# with -DNDEBUG=1
#
#OPTS = -DMEMORY_DEBUG=2
#OPTS = -DMEMORY_DEBUG=1
#OPTS = -DNDEBUG=1
OPTS = -DMEMORY_DEBUG=1

#### The suffix to add to executable files. ".exe" for windows.
# Nothing for unix.
#
#EXE = .exe
EXE =

#### C Compile and options for use in building executables that
# will run on the target platform. This is usually the same
# as BCC, unless you are cross-compiling.
#
TCC = $(CROSS)gcc
FLTFLAGS += -s 12000
#TCC = gcc -g -O0 -Wall
#TCC = gcc -g -O0 -Wall -fprofile-arcs -ftest-coverage
#TCC = /opt/mingw/bin/i386-mingw32-gcc -O6
#TCC = /opt/ansic/bin/c89 -O +z -Wl,-a,archive

#### Tools used to build a static library.
#
AR = $(CROSS)ar cr
#AR = /opt/mingw/bin/i386-mingw32-ar cr
RANLIB = $(CROSS)ranlib
#RANLIB = /opt/mingw/bin/i386-mingw32-ranlib

#### Extra compiler options needed for programs that use the TCL library.
#
#TCL_FLAGS =
#TCL_FLAGS = -DSTATIC_BUILD=1
#TCL_FLAGS = -I/home/drh/tcltk/8.4linux
#TCL_FLAGS = -I/home/drh/tcltk/8.4win -DSTATIC_BUILD=1
#TCL_FLAGS = -I/home/drh/tcltk/8.3hpux

#### Linker options needed to link against the TCL library.
#
#LIBTCL = -ltcl -lm -ldl
#LIBTCL = /home/drh/tcltk/8.4linux/libtcl8.4g.a -lm -ldl
#LIBTCL = /home/drh/tcltk/8.4win/libtcl84s.a -lmsvcrt
#LIBTCL = /home/drh/tcltk/8.3hpux/libtcl8.3.a -ldld -lm -lc

#### Compiler options needed for programs that use the readline() library.
#
READLINE_FLAGS =
#READLINE_FLAGS = -DHAVE_READLINE=1 -I/usr/include/readline

#### Linker options needed by programs using readline() must link against.
#
#LIBREADLINE =
#LIBREADLINE = -static -lreadline -ltermcap

#### Should the database engine assume text is coded as UTF-8 or iso8859?
#
# ENCODING = UTF8
ENCODING = ISO8859

# You should not have to change anything below this line
###############################################################################
include $(TOP)/main.mk
===========Makefile内容结束===========

　　注：

　　1、 在uclinux下的ite的Makefile将不去用到TCL相关的库。

　　2、 在uclinux下的ite的Makefile将不去用到readline()。

　　在ite/README中有关于Makefile的一段描述：

The configure script uses autoconf 2.50 and libtool. If the configure script does not work out for you, there is a generic makefile named "Makefile.linux-gcc" in the top directory of the source tree that you can copy and edit to suite your needs. Comments on the generic makefile show what changes are needed.

　　你可以用ite/Makefile.linux-gcc作为蓝本来修改适合你自己的Makefile。

　　你如果有兴趣的话，可以把上面的Makefile的内容和ite/Makefile.linux-gcc内容diff对比一下，看看uclinux下的ite编译有哪些不同的地方。

　　三、修改ite/src/os.c

　　如果你的ite包中包括os.c那么就对其进行修改，没有os.c可能是你的ite版本比较新，那么无须修改。

　　将所有你找到的：

if( s!=0 )

　　用：

if( s!=0 && errno != ENOSYS )

　　替换。


　　四、修改ite/src/shell.c

　　1、struct previous_mode_data 结构定义项：

　　将 int colWidth[100];

　　用 int colWidth[20];

　　替换。

　　2、struct callback_data 结构定义项

　　将：

int colWidth[100];
int actualWidth[100];
char outfile[FILENAME_MAX];

　　用：

int colWidth[20];
int actualWidth[20];
char *outfilep;

　　对应替换。

　　再在结构下面增加：

#ifndef FILENAME_MAX
#define FILENAME_MAX 4095
#endif
char outfilename[FILENAME_MAX]; /* Filename for *out */

　　即

struct callback_data
{
...
};
#ifndef FILENAME_MAX
#define FILENAME_MAX 4095
#endif
char outfilename[FILENAME_MAX]; /* Filename for *out */

　　3、函数do_meta_command(...)

　　找到类似这样的一句：

ite_exec(p->db, "PRAGMA database_list; ", callback, &data, &zErrMsg);

　　在它的前面有一句

memcpy(&data, p, sizeof(data));

　　现在在memcpy下面增加一行

data.cnt = 0;

　　即将结构中cnt的值赋为0 ；

　　现在代码会被修改成类似：

open_db(p);
memcpy(&data, p, sizeof(data));
data.cnt = 0;

　　再继续。

　　找到类似这样的一句：

strcmp(azArg[1],"stdout")==0

　　在它的下面的括号中：

　　将 strcpy(p->outfile,"stdout");

　　用 p->outfilep = "stdout";

　　来替换。

　　再在它下面的5-6行处

　　将：

strcpy(p->outfile,azArg[1]);

　　用：

strcpy(outfilename,azArg[1]);
p->outfilep = outfilename;

　　替换。

　　再继续，找到类似这样的一句：

fprintf(p->out,"%9.9s: %s\n","output",

　　将：

fprintf(p->out,"%9.9s: %s\n","output", strlen(p->outfile) ? p->outfile : "stdout");

　　用：

fprintf(p->out,"%9.9s: %s\n","output", p->outfilep && strlen(p->outfilep) ? p->outfilep : "stdout");

　　 替换。

　　完成修改。

　　上面的所有的对ite的修改完成后，你就可以make dep；make lib_only；make user_only；make romfs；make image了。

　　如果你对ite的修改，在make user_only过程中出现错误的话，你可以忽略make dep；make lib_only命令，直接再次进行make user_only；make romfs；make image；就可以了，而不用重复make dep；make lib_only。

　　make image会帮你生成romfs。现在在uClinux-dist/images下面就有编译生成的romfs了。这个就是我们需要的包含有ite的romfs了。

　　在上面的过程中，你可以不用在“make image”后再去“make”生成kernel内核，因为你只需要生成romfs就可以了，它里面已经有ite了。

　　现在你就可以把你生成的含有ite应用的romfs下载到开发板上运行一下。

Welcome to
____ _ _
/ __| ||_|
_ _| | | | _ ____ _ _ _ _
| | | | | | || | _ \| | | |\ \/ /
| |_| | |__| || | | | | |_| |/ \
| ___\____|_||_|_| |_|\____|\_/\_/
| |
|_|

GDB/ARMulator support by
For further information check:
/

Command: /bin/ifconfig eth0 up 10.0.0.2
Execution Finished, Exiting
init: Booting to single user mode

Sash command shell (version 1.1.1)
/> cd bin
/bin> ls -l ite
-rwxr-xr-x 1 0 0 327072 Jan 01 00:00 ite
/bin >cd /tmp
/tmp>ite test.ite
ite> create table my(name varchar(80), num smallint);
ite> insert into my values('yutao', 100);
ite> insert into my values('uclinux', 99);
ite> select * from my;
yutao|100
uclinux|99
ite> .tables
my
ite> .schema
create table my(name varchar(80), num smallint);
ite> .q
/tmp>ls –l test.ite

　　你要保证你的/tmp是可写的目录。

　　好，现在你的ite就已经在uclinux运行起来了，感觉如何呀，在uclinux也可以玩玩“select * from”，感觉很爽吧。