注:本文中的网址仅供参考。
本文讨论的是比较流行的嵌入式开发组合ARM+uclinux,即目标开发板为三星S3C4510,完成sqlite在其uclinux上的移植。
本文假设你已经具备正确编译uclinux的kernel的能力,即有能力完成make menuconfig;makedep;makelib_only;make user_only;makeromfs;makeimage;make。而且还能将自己写的类似helloworld程序加到“用户自定义应用程序”中,即你能完成“uClinux-dist/Documentation/Adding-User-Apps-HOWTO”中所描述的“用户程序的订制”。
大多数需要移植sqlite到uclinux的开发者,应该已经具备上面的能力,而只是不清楚如何修改sqlite来完成其在uclinux下的编译。如果你还不能完成上面的要求,那么请先做一定的准备工作,因为本范例所涉及到的内容主要是跟sqlite在uclinux下的移植有关,其他的在这个过程中出现的问题,开发者需要自行处理。
本范例使用的uclinux是uClinux-dist-20030522.tar.gz,你可以从http://www.uclinux.org得到适合你的软件包。
交叉编译工具是arm-elf-tools-20030314.sh,你也可以在http://www.uclinux.org找到它。
本范例使用的sqlite是sqlite-2.8.15.tar.gz,本文的方法也适合于2.8.x系列的sqlite;可能有部分内容不适用于3.0.x系列的sqlite,因为3.0.x中源代码有较大的变化。
1、下载sqlite:你可以到http://www.sqlite.org/download.html,下载sqlite-2.8.15.tar.gz软件包;
2、 将下载的软件包解压缩到uClinux-dist/user目录下;
命令:
$tar zxvf sqlite-2.8.15.tar.gz -C uClinux-dist/user/
现在在uclinux的user目录下,你应该可以看到sqlite目录了。解压缩到这个user目录主要是要将sqlite编译成一个普通的用户应用程序。
3、 用户应用程序的有关设置:
按uClinux-dist/Documentation/Adding-User-Apps-HOWTO文档中说提到的,来添加sqlite作为一个用户应用程序,将其做成一个shell,这样就类似于uclinux自己的ps命令。
编辑文件
uClinux-dist/user/Makefile
uClinux-dist/config/Configure.help
uClinux-dist/config/config.in
我是在这些文件里查找“cpu”有关的项,然后在它的下面,加上自己的sqlite项,这个过程并不复杂。
通过上面的修改后,你现在就可以运行uclinux的makemenuconfig,选中“CustomizeVendor/UserSettings”,再选中“MiscellaneousApplications”,可以看到它现在出现了一个新的“sqlite(NEW)”,这个就是我们刚添加进去的sqlite项。
在稍后的makeromfs中,uclinux会将你的sqlite编译进来,做成romfs的一部分,因为你在uClinux-dist/user/Makefile中已经加上要编译sqlite项了。这样在移植后的uclinux的/bin中将会有sqlite命令可以让你来执行。
在下面的描述中,我们将对以下几个文件进行一定的添加、修改,从而来完成sqlite在uclinux下的编译:
对这几个文件进行修改时,请自己做好这些文件的备份,比如你可以将它们拷贝一份,改名成文件名后面带.bak。这个很重要,可以避免你在修改的过程出现问题而无法还原。
1、TCCX
将
TCCX = $(TCC) $(OPTS) $(THREADSAFE) $(USLEEP) -I.-I$(TOP)/src
修改为
TCCX = $(TCC) $(OPTS) $(THREADSAFE) $(USLEEP) -I.-I$(TOP)/src$(CFLAGS)
2、 LIBOBJ
找到 # Object files for the sqlite library.
将其中的tclsqlite.o去掉。即去掉tcl有关的东西。
如果没有tclsqlite.o,那么不用处理它。
3、 sqlite$(EXE)
找到类似sqlite$(EXE)的一句,将:
sqlite$(EXE): $(TOP)/src/shell.c libsqlite.a sqlite.h
$(TCCX) $(READLINE_FLAGS) -o sqlite$(EXE) $(TOP)/src/shell.c////////////////
libsqlite.a $(LIBREADLINE) $(THREADLIB)
替换为:
shell.o: $(TOP)/src/shell.c sqlite.h
$(TCCX) $(READLINE_FLAGS) -c $(TOP)/src/shell.c
sqlite$(EXE): shell.o libsqlite.a
$(TCC) $(LDFLAGS) -o $@ shell.o ////////////////
libsqlite.a $(LIBREADLINE) $(THREADLIB) $(LDLIBS)
即在sqlite$(EXE)上一行加上shell.o,及在其后加上$(LDLIBS)标记。这个是对/src/shell.c的编译方法的修改。
4、romfs
将:
install: sqlite libsqlite.a sqlite.h
mv sqlite /usr/bin
mv libsqlite.a /usr/lib
mv sqlite.h /usr/include
替换为:
romfs: sqlite
$(ROMFSINST) /bin/sqlite
即去掉make install项,加上makeromfs项。这个很重要,这将在romfs的/bin目录下生成sqlite。
5、clean
将:
clean:
rm -f *.o sqlite libsqlite.a sqlite.h opcodes.*
rm -f lemon lempar.c parse.* sqlite*.tar.gz
rm -f $(PUBLISH)
rm -f *.da *.bb *.bbg gmon.out
rm -rf tsrc替换为:
clean:
rm -f *.o sqlite libsqlite.a sqlite.h opcodes.* sqlite.gdb
rm -f $(PUBLISH)
rm -f *.da *.bb *.bbg gmon.out
rm -rf tsrc
distclean: clean
rm -f lemon lempar.c parse.* sqlite*.tar.gz
rm -f config.h
即增加make distclean项。
二、在sqlite下增加Makefile文件
在sqlite目录下应该没有Makefile文件,而只是有一个sqlite/Makefile.linux-gcc文件。我们要移植sqlite到uclinux,那么就要自己写一个合适的Makefile。
内容如下:
===========Makefile内容开始===========
#!/usr/make
#
# Makefile for sqlITE
#
# This is a template makefile for sqlite. Most peoplepreferto
# use the autoconf generated configure script togeneratethe
# makefile automatically. But that does not work foreverybody
# and in every situation. If you are having problems with the
# configure script,you might want to try this makefileasan
# alternative. Create a copy of this file,edit theparameters
# below and type make.
#
#### The toplevel directory of the source tree. This isthedirectory
# that contains this Makefile.in and theconfigure.inscript.
#
TOP = .
#### C Compiler and options for use in buildingexecutablesthat
# 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 theusleep()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 usewithina
# multi-threaded program,then define the following macro
# appropriately:
#
#THREADSAFE = -DTHREADSAFE=1
THREADSAFE = -DTHREADSAFE=0
#### Specify any extra linker options needed to makethelibrary
# thread safe
#
#THREADLIB = -lpthread
THREADLIB =
#### Leave MEMORY_DEBUG undefined for maximum speed.UseMEMORY_DEBUG=1
# to check for memory leaks. Use MEMORY_DEBUG=2 to print a logofall
# malloc()s and free()s in order to track down memory leaks.
#
# sqlite uses some expensive assert() statements in theinnerloop.
# You can make the library go almost twice as fast ifyoucompile
# 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. .exeforwindows.
# Nothing for unix.
#
#EXE = .exe
EXE =
#### C Compile and options for use in buildingexecutablesthat
# 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 theTCLlibrary.
#
#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 thereadline()library.
#
READLINE_FLAGS =
#READLINE_FLAGS = -DHAVE_READLINE=1 -I/usr/include/readline
#### Linker options needed by programs using readline() mustlinkagainst.
#
#LIBREADLINE =
#LIBREADLINE = -static -lreadline -ltermcap
#### Should the database engine assume text is coded as UTF-8oriso8859?
#
# ENCODING = UTF8
ENCODING = ISO8859
# You should not have to change anything below this line
###############################################################################
include $(TOP)/main.mk
===========Makefile内容结束===========
注:
1、 在uclinux下的sqlite的Makefile将不去用到TCL相关的库。
2、 在uclinux下的sqlite的Makefile将不去用到readline()。
在sqlite/README中有关于Makefile的一段描述:
The configure script uses autoconf 2.50 and libtool. Iftheconfigure script does not work out for you,there is agenericmakefile named Makefile.linux-gcc in the top directory ofthesource tree that you can copy and edit to suite yourneeds.Comments on the generic makefile show what changes areneeded.
你可以用sqlite/Makefile.linux-gcc作为蓝本来修改适合你自己的Makefile。
你如果有兴趣的话,可以把上面的Makefile的内容和sqlite/Makefile.linux-gcc内容diff对比一下,看看uclinux下的sqlite编译有哪些不同的地方。
如果你的sqlite包中包括os.c文件那么就对其进行修改,没有os.c文件可能是你的sqlite版本比较新,那么无须修改。
1、struct prevIoUs_mode_data 结构定义项:
将 int colWidth100;
用 int colWidth20;
替换。
2、struct callback_data 结构定义项
将:
int colWidth100;
int actualWidth100;
char outfileFILENAME_MAX;
用:
int colWidth20;
int actualWidth20;
char *outfilep;
对应替换。
再在结构下面增加:
#ifndef FILENAME_MAX
#define FILENAME_MAX 4095
#endif
char outfilenameFILENAME_MAX; /* Filename for *out */
即
struct callback_data
...
;
#ifndef FILENAME_MAX
#define FILENAME_MAX 4095
#endif
char outfilenameFILENAME_MAX; /* Filename for *out */
找到类似这样的一句:
sqlite_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,sizeof(data));
data.cnt = 0;
再继续。
找到类似这样的一句:
strcmp(azArg1,stdout)==0
在它的下面的括号中:
将 strcpy(p->outfile,stdout);
用 p->outfilep = stdout;
来替换。
再在它下面的5-6行处
将:
strcpy(p->outfile,azArg1);
用:
strcpy(outfilename,azArg1);
p->outfilep = outfilename;
替换。
再继续,找到类似这样的一句:
fprintf(p->out,%9.9s: %s////////////////n,output,
将:
fprintf(p->out,strlen(p->outfile)?p->outfile : stdout);
用:
fprintf(p->out,p->outfilep&& strlen(p->outfilep) ? p->outfilep :stdout);
替换。
完成修改。
上面的所有的对sqlite的修改完成后,你就可以make dep;make lib_only;makeuser_only;makeromfs;make image了。
如果你对sqlite的修改,在make user_only过程中出现错误的话,你可以忽略makedep;makelib_only命令,直接再次进行make user_only;makeromfs;makeimage;就可以了,而不用重复make dep;make lib_only。
makeimage会帮你生成romfs文件系统。现在在uClinux-dist/images下面就有编译生成的romfs文件系统了。这个就是我们需要的包含有sqlite的romfs了。
在上面的过程中,你可以不用在“makeimage”后再去“make”生成kernel内核,因为你只需要生成romfs就可以了,它里面已经有sqlite了。