3 # To build a single huge source file holding all of SQLite (or at
4 # least the core components - the test harness, shell, and TCL
5 # interface are omitted.) first do
9 # The make target above moves all of the source code files into
10 # a subdirectory named "tsrc". (This script expects to find the files
11 # there and will not work if they are not found.) There are a few
12 # generated C code files that are also added to the tsrc directory.
13 # For example, the "parse.c" and "parse.h" files to implement the
14 # the parser are derived from "parse.y" using lemon. And the
15 # "keywordhash.h" files is generated by a program named "mkkeywordhash".
17 # After the "tsrc" directory has been created and populated, run
20 # tclsh mksqlite3c.tcl
22 # The amalgamated SQLite code will be written into sqlite3.c
25 # Begin by reading the "sqlite3.h" header file. Extract the version number
26 # from in this file. The versioon number is needed to generate the header
27 # comment of the amalgamation.
29 if {[lsearch $argv --nostatic]>=0} {
34 set in [open tsrc/sqlite3.h]
39 if {$line=="" && [eof $in]} break
41 regexp {#define\s+SQLITE_VERSION\s+"(.*)"} $line all VERSION
45 # Open the output file and write a header comment at the beginning
48 set out [open sqlite3.c w]
49 set today [clock format [clock seconds] -format "%Y-%m-%d %H:%M:%S UTC" -gmt 1]
51 {/******************************************************************************
52 ** This file is an amalgamation of many separate C source files from SQLite
53 ** version $VERSION. By combining all the individual C code files into this
54 ** single large file, the entire code can be compiled as a single translation
55 ** unit. This allows many compilers to do optimizations that would not be
56 ** possible if the files were compiled separately. Performance improvements
57 ** of 5% or more are commonly seen when SQLite is compiled as a single
60 ** This file is all you need to compile SQLite. To use SQLite in other
61 ** programs, you need this file and the "sqlite3.h" header file that defines
62 ** the programming interface to the SQLite library. (If you do not have
63 ** the "sqlite3.h" header file at hand, you will find a copy embedded within
64 ** the text of this file. Search for "Begin file sqlite3.h" to find the start
65 ** of the embedded sqlite3.h header file.) Additional code files may be needed
66 ** if you want a wrapper to interface SQLite with your choice of programming
67 ** language. The code for the "sqlite3" command-line shell is also in a
68 ** separate file. This file contains only code for the core SQLite library.
71 #define SQLITE_AMALGAMATION 1}]
74 {#ifndef SQLITE_PRIVATE
75 # define SQLITE_PRIVATE static
82 # These are the header files used by SQLite. The first time any of these
83 # files are seen in a #include statement in the C code, include the complete
84 # text of the file in-line. The file only needs to be included once.
114 set available_hdr($hdr) 1
116 set available_hdr(sqliteInt.h) 0
118 # 78 stars used for comment formatting.
120 {*****************************************************************************}
122 # Insert a comment into the code
124 proc section_comment {text} {
126 set n [string length $text]
127 set nstar [expr {60 - $n}]
128 set stars [string range $s78 0 $nstar]
129 puts $out "/************** $text $stars/"
132 # Read the source file named $filename and write it into the
133 # sqlite3.c output file. If any #include statements are seen,
134 # process them approprately.
136 proc copy_file {filename} {
137 global seen_hdr available_hdr out addstatic
138 set tail [file tail $filename]
139 section_comment "Begin file $tail"
140 set in [open $filename r]
141 set varpattern {^[a-zA-Z][a-zA-Z_0-9 *]+(sqlite3[_a-zA-Z0-9]+)(\[|;| =)}
142 set declpattern {[a-zA-Z][a-zA-Z_0-9 ]+ \**(sqlite3[_a-zA-Z0-9]+)\(}
143 if {[file extension $filename]==".h"} {
144 set declpattern " *$declpattern"
146 set declpattern ^$declpattern
149 if {[regexp {^\s*#\s*include\s+["<]([^">]+)[">]} $line all hdr]} {
150 if {[info exists available_hdr($hdr)]} {
151 if {$available_hdr($hdr)} {
152 if {$hdr!="os_common.h" && $hdr!="hwtime.h"} {
153 set available_hdr($hdr) 0
155 section_comment "Include $hdr in the middle of $tail"
157 section_comment "Continuing where we left off in $tail"
159 } elseif {![info exists seen_hdr($hdr)]} {
163 } elseif {[regexp {^#ifdef __cplusplus} $line]} {
165 } elseif {[regexp {^#line} $line]} {
166 # Skip #line directives.
167 } elseif {$addstatic && ![regexp {^(static|typedef)} $line]} {
168 regsub {^SQLITE_API } $line {} line
169 if {[regexp $declpattern $line all funcname]} {
170 # Add the SQLITE_PRIVATE or SQLITE_API keyword before functions.
171 # so that linkage can be modified at compile-time.
172 if {[regexp {^sqlite3_} $funcname]} {
173 puts $out "SQLITE_API $line"
175 puts $out "SQLITE_PRIVATE $line"
177 } elseif {[regexp $varpattern $line all varname]} {
178 # Add the SQLITE_PRIVATE before variable declarations or
179 # definitions for internal use
180 if {![regexp {^sqlite3_} $varname]} {
181 regsub {^extern } $line {} line
182 puts $out "SQLITE_PRIVATE $line"
184 if {[regexp {const char sqlite3_version\[\];} $line]} {
185 set line {const char sqlite3_version[] = SQLITE_VERSION;}
187 regsub {^SQLITE_EXTERN } $line {} line
188 puts $out "SQLITE_API $line"
190 } elseif {[regexp {^(SQLITE_EXTERN )?void \(\*sqlite3IoTrace\)} $line]} {
191 regsub {^SQLITE_EXTERN } $line {} line
192 puts $out "SQLITE_PRIVATE $line"
193 } elseif {[regexp {^void \(\*sqlite3Os} $line]} {
194 puts $out "SQLITE_PRIVATE $line"
203 section_comment "End of $tail"
207 # Process the source files. Process files containing commonly
208 # used subroutines first in order to help the compiler find
209 # inlining opportunities.