Include sqlcipher_export improvements in changelog
[sqlcipher.git] / autoconf / Makefile.msc
bloba131d4c6e737e5a66cad05d93d11a73fe8fd8bd5
1 #### DO NOT EDIT ####
2 # This makefile is automatically generated from the Makefile.msc at
3 # the root of the canonical SQLite source tree (not the
4 # amalgamation tarball) using the tool/mkmsvcmin.tcl
5 # script.
9 # nmake Makefile for SQLite
11 ###############################################################################
12 ############################## START OF OPTIONS ###############################
13 ###############################################################################
15 # The toplevel directory of the source tree.  This is the directory
16 # that contains this "Makefile.msc".
18 TOP = .
21 # Set this non-0 to enable full warnings (-W4, etc) when compiling.
23 !IFNDEF USE_FULLWARN
24 USE_FULLWARN = 1
25 !ENDIF
27 # Set this non-0 to enable treating warnings as errors (-WX, etc) when
28 # compiling.
30 !IFNDEF USE_FATAL_WARN
31 USE_FATAL_WARN = 0
32 !ENDIF
34 # Set this non-0 to enable full runtime error checks (-RTC1, etc).  This
35 # has no effect if (any) optimizations are enabled.
37 !IFNDEF USE_RUNTIME_CHECKS
38 USE_RUNTIME_CHECKS = 0
39 !ENDIF
41 # Set this non-0 to create a SQLite amalgamation file that excludes the
42 # various built-in extensions.
44 !IFNDEF MINIMAL_AMALGAMATION
45 MINIMAL_AMALGAMATION = 0
46 !ENDIF
48 # Set this non-0 to use "stdcall" calling convention for the core library
49 # and shell executable.
51 !IFNDEF USE_STDCALL
52 USE_STDCALL = 0
53 !ENDIF
55 # Set this non-0 to have the shell executable link against the core dynamic
56 # link library.
58 !IFNDEF DYNAMIC_SHELL
59 DYNAMIC_SHELL = 0
60 !ENDIF
62 # Set this non-0 to enable extra code that attempts to detect misuse of the
63 # SQLite API.
65 !IFNDEF API_ARMOR
66 API_ARMOR = 0
67 !ENDIF
69 # If necessary, create a list of harmless compiler warnings to disable when
70 # compiling the various tools.  For the SQLite source code itself, warnings,
71 # if any, will be disabled from within it.
73 !IFNDEF NO_WARN
74 !IF $(USE_FULLWARN)!=0
75 NO_WARN = -wd4054 -wd4055 -wd4100 -wd4127 -wd4130 -wd4152 -wd4189 -wd4206
76 NO_WARN = $(NO_WARN) -wd4210 -wd4232 -wd4305 -wd4306 -wd4702 -wd4706
77 !ENDIF
78 !ENDIF
80 # Set this non-0 to use the library paths and other options necessary for
81 # Windows Phone 8.1.
83 !IFNDEF USE_WP81_OPTS
84 USE_WP81_OPTS = 0
85 !ENDIF
87 # Set this non-0 to split the SQLite amalgamation file into chunks to
88 # be used for debugging with Visual Studio.
90 !IFNDEF SPLIT_AMALGAMATION
91 SPLIT_AMALGAMATION = 0
92 !ENDIF
95 # Set this non-0 to dynamically link to the MSVC runtime library.
97 !IFNDEF USE_CRT_DLL
98 USE_CRT_DLL = 0
99 !ENDIF
101 # Set this non-0 to link to the RPCRT4 library.
103 !IFNDEF USE_RPCRT4_LIB
104 USE_RPCRT4_LIB = 0
105 !ENDIF
107 # Set this non-0 to generate assembly code listings for the source code
108 # files.
110 !IFNDEF USE_LISTINGS
111 USE_LISTINGS = 0
112 !ENDIF
114 # Set this non-0 to attempt setting the native compiler automatically
115 # for cross-compiling the command line tools needed during the compilation
116 # process.
118 !IFNDEF XCOMPILE
119 XCOMPILE = 0
120 !ENDIF
122 # Set this non-0 to use the native libraries paths for cross-compiling
123 # the command line tools needed during the compilation process.
125 !IFNDEF USE_NATIVE_LIBPATHS
126 USE_NATIVE_LIBPATHS = 0
127 !ENDIF
129 # Set this 0 to skip the compiling and embedding of version resources.
131 !IFNDEF USE_RC
132 USE_RC = 1
133 !ENDIF
135 # Set this non-0 to compile binaries suitable for the WinRT environment.
136 # This setting does not apply to any binaries that require Tcl to operate
137 # properly (i.e. the text fixture, etc).
139 !IFNDEF FOR_WINRT
140 FOR_WINRT = 0
141 !ENDIF
143 # Set this non-0 to compile binaries suitable for the UWP environment.
144 # This setting does not apply to any binaries that require Tcl to operate
145 # properly (i.e. the text fixture, etc).
147 !IFNDEF FOR_UWP
148 FOR_UWP = 0
149 !ENDIF
151 # Set this non-0 to compile binaries suitable for the Windows 10 platform.
153 !IFNDEF FOR_WIN10
154 FOR_WIN10 = 0
155 !ENDIF
158 # Set this to non-0 to create and use PDBs.
160 !IFNDEF SYMBOLS
161 SYMBOLS = 1
162 !ENDIF
164 # Set this to non-0 to use the SQLite debugging heap subsystem.
166 !IFNDEF MEMDEBUG
167 MEMDEBUG = 0
168 !ENDIF
170 # Set this to non-0 to use the Win32 native heap subsystem.
172 !IFNDEF WIN32HEAP
173 WIN32HEAP = 0
174 !ENDIF
176 # Set this to non-0 to enable OSTRACE() macros, which can be useful when
177 # debugging.
179 !IFNDEF OSTRACE
180 OSTRACE = 0
181 !ENDIF
183 # Set this to one of the following values to enable various debugging
184 # features.  Each level includes the debugging options from the previous
185 # levels.  Currently, the recognized values for DEBUG are:
187 # 0 == NDEBUG: Disables assert() and other runtime diagnostics.
188 # 1 == SQLITE_ENABLE_API_ARMOR: extra attempts to detect misuse of the API.
189 # 2 == Disables NDEBUG and all optimizations and then enables PDBs.
190 # 3 == SQLITE_DEBUG: Enables various diagnostics messages and code.
191 # 4 == SQLITE_WIN32_MALLOC_VALIDATE: Validate the Win32 native heap per call.
192 # 5 == SQLITE_DEBUG_OS_TRACE: Enables output from the OSTRACE() macros.
193 # 6 == SQLITE_ENABLE_IOTRACE: Enables output from the IOTRACE() macros.
195 !IFNDEF DEBUG
196 DEBUG = 0
197 !ENDIF
199 # Enable use of available compiler optimizations?  Normally, this should be
200 # non-zero.  Setting this to zero, thus disabling all compiler optimizations,
201 # can be useful for testing.
203 !IFNDEF OPTIMIZATIONS
204 OPTIMIZATIONS = 2
205 !ENDIF
207 # Set this to non-0 to enable support for the session extension.
209 !IFNDEF SESSION
210 SESSION = 0
211 !ENDIF
213 # Set the source code file to be used by executables and libraries when
214 # they need the amalgamation.
216 !IFNDEF SQLITE3C
217 !IF $(SPLIT_AMALGAMATION)!=0
218 SQLITE3C = sqlite3-all.c
219 !ELSE
220 SQLITE3C = sqlite3.c
221 !ENDIF
222 !ENDIF
224 # Set the include code file to be used by executables and libraries when
225 # they need SQLite.
227 !IFNDEF SQLITE3H
228 SQLITE3H = sqlite3.h
229 !ENDIF
231 # This is the name to use for the SQLite dynamic link library (DLL).
233 !IFNDEF SQLITE3DLL
234 !IF $(FOR_WIN10)!=0
235 SQLITE3DLL = winsqlite3.dll
236 !ELSE
237 SQLITE3DLL = sqlite3.dll
238 !ENDIF
239 !ENDIF
241 # This is the name to use for the SQLite import library (LIB).
243 !IFNDEF SQLITE3LIB
244 !IF $(FOR_WIN10)!=0
245 SQLITE3LIB = winsqlite3.lib
246 !ELSE
247 SQLITE3LIB = sqlite3.lib
248 !ENDIF
249 !ENDIF
251 # This is the name to use for the SQLite shell executable (EXE).
253 !IFNDEF SQLITE3EXE
254 !IF $(FOR_WIN10)!=0
255 SQLITE3EXE = winsqlite3shell.exe
256 !ELSE
257 SQLITE3EXE = sqlite3.exe
258 !ENDIF
259 !ENDIF
261 # This is the argument used to set the program database (PDB) file for the
262 # SQLite shell executable (EXE).
264 !IFNDEF SQLITE3EXEPDB
265 !IF $(FOR_WIN10)!=0
266 SQLITE3EXEPDB =
267 !ELSE
268 SQLITE3EXEPDB = /pdb:sqlite3sh.pdb
269 !ENDIF
270 !ENDIF
273 # These are the "standard" SQLite compilation options used when compiling for
274 # the Windows platform.
276 !IFNDEF OPT_FEATURE_FLAGS
277 !IF $(MINIMAL_AMALGAMATION)==0
278 OPT_FEATURE_FLAGS = $(OPT_FEATURE_FLAGS) -DSQLITE_ENABLE_FTS3=1
279 OPT_FEATURE_FLAGS = $(OPT_FEATURE_FLAGS) -DSQLITE_ENABLE_RTREE=1
280 OPT_FEATURE_FLAGS = $(OPT_FEATURE_FLAGS) -DSQLITE_ENABLE_GEOPOLY=1
281 OPT_FEATURE_FLAGS = $(OPT_FEATURE_FLAGS) -DSQLITE_ENABLE_JSON1=1
282 OPT_FEATURE_FLAGS = $(OPT_FEATURE_FLAGS) -DSQLITE_ENABLE_STMTVTAB=1
283 OPT_FEATURE_FLAGS = $(OPT_FEATURE_FLAGS) -DSQLITE_ENABLE_DBPAGE_VTAB=1
284 OPT_FEATURE_FLAGS = $(OPT_FEATURE_FLAGS) -DSQLITE_ENABLE_DBSTAT_VTAB=1
285 OPT_FEATURE_FLAGS = $(OPT_FEATURE_FLAGS) -DSQLITE_INTROSPECTION_PRAGMAS=1
286 OPT_FEATURE_FLAGS = $(OPT_FEATURE_FLAGS) -DSQLITE_ENABLE_DESERIALIZE=1
287 !ENDIF
288 OPT_FEATURE_FLAGS = $(OPT_FEATURE_FLAGS) -DSQLITE_ENABLE_COLUMN_METADATA=1
289 !ENDIF
291 # Should the session extension be enabled?  If so, add compilation options
292 # to enable it.
294 !IF $(SESSION)!=0
295 OPT_FEATURE_FLAGS = $(OPT_FEATURE_FLAGS) -DSQLITE_ENABLE_SESSION=1
296 OPT_FEATURE_FLAGS = $(OPT_FEATURE_FLAGS) -DSQLITE_ENABLE_PREUPDATE_HOOK=1
297 !ENDIF
299 # These are the "extended" SQLite compilation options used when compiling for
300 # the Windows 10 platform.
302 !IFNDEF EXT_FEATURE_FLAGS
303 !IF $(FOR_WIN10)!=0
304 EXT_FEATURE_FLAGS = $(EXT_FEATURE_FLAGS) -DSQLITE_ENABLE_FTS4=1
305 EXT_FEATURE_FLAGS = $(EXT_FEATURE_FLAGS) -DSQLITE_SYSTEM_MALLOC=1
306 EXT_FEATURE_FLAGS = $(EXT_FEATURE_FLAGS) -DSQLITE_OMIT_LOCALTIME=1
307 !ELSE
308 EXT_FEATURE_FLAGS =
309 !ENDIF
310 !ENDIF
312 ###############################################################################
313 ############################### END OF OPTIONS ################################
314 ###############################################################################
316 # When compiling for the Windows 10 platform, the PLATFORM macro must be set
317 # to an appropriate value (e.g. x86, x64, arm, arm64, etc).
319 !IF $(FOR_WIN10)!=0
320 !IFNDEF PLATFORM
321 !ERROR Using the FOR_WIN10 option requires a value for PLATFORM.
322 !ENDIF
323 !ENDIF
325 # This assumes that MSVC is always installed in 32-bit Program Files directory
326 # and sets the variable for use in locating other 32-bit installs accordingly.
328 PROGRAMFILES_X86 = $(VCINSTALLDIR)\..\..
329 PROGRAMFILES_X86 = $(PROGRAMFILES_X86:\\=\)
331 # Check for the predefined command macro CC.  This should point to the compiler
332 # binary for the target platform.  If it is not defined, simply define it to
333 # the legacy default value 'cl.exe'.
335 !IFNDEF CC
336 CC = cl.exe
337 !ENDIF
339 # Check for the predefined command macro CSC.  This should point to a working
340 # C Sharp compiler binary.  If it is not defined, simply define it to the
341 # legacy default value 'csc.exe'.
343 !IFNDEF CSC
344 CSC = csc.exe
345 !ENDIF
347 # Check for the command macro LD.  This should point to the linker binary for
348 # the target platform.  If it is not defined, simply define it to the legacy
349 # default value 'link.exe'.
351 !IFNDEF LD
352 LD = link.exe
353 !ENDIF
355 # Check for the predefined command macro RC.  This should point to the resource
356 # compiler binary for the target platform.  If it is not defined, simply define
357 # it to the legacy default value 'rc.exe'.
359 !IFNDEF RC
360 RC = rc.exe
361 !ENDIF
363 # Check for the MSVC runtime library path macro.  Otherwise, this value will
364 # default to the 'lib' directory underneath the MSVC installation directory.
366 !IFNDEF CRTLIBPATH
367 CRTLIBPATH = $(VCINSTALLDIR)\lib
368 !ENDIF
370 CRTLIBPATH = $(CRTLIBPATH:\\=\)
372 # Check for the command macro NCC.  This should point to the compiler binary
373 # for the platform the compilation process is taking place on.  If it is not
374 # defined, simply define it to have the same value as the CC macro.  When
375 # cross-compiling, it is suggested that this macro be modified via the command
376 # line (since nmake itself does not provide a built-in method to guess it).
377 # For example, to use the x86 compiler when cross-compiling for x64, a command
378 # line similar to the following could be used (all on one line):
380 #     nmake /f Makefile.msc sqlite3.dll
381 #           XCOMPILE=1 USE_NATIVE_LIBPATHS=1
383 # Alternatively, the full path and file name to the compiler binary for the
384 # platform the compilation process is taking place may be specified (all on
385 # one line):
387 #     nmake /f Makefile.msc sqlite3.dll
388 #           "NCC=""%VCINSTALLDIR%\bin\cl.exe"""
389 #           USE_NATIVE_LIBPATHS=1
391 !IFDEF NCC
392 NCC = $(NCC:\\=\)
393 !ELSEIF $(XCOMPILE)!=0
394 NCC = "$(VCINSTALLDIR)\bin\$(CC)"
395 NCC = $(NCC:\\=\)
396 !ELSE
397 NCC = $(CC)
398 !ENDIF
400 # Check for the MSVC native runtime library path macro.  Otherwise,
401 # this value will default to the 'lib' directory underneath the MSVC
402 # installation directory.
404 !IFNDEF NCRTLIBPATH
405 NCRTLIBPATH = $(VCINSTALLDIR)\lib
406 !ENDIF
408 NCRTLIBPATH = $(NCRTLIBPATH:\\=\)
410 # Check for the Platform SDK library path macro.  Otherwise, this
411 # value will default to the 'lib' directory underneath the Windows
412 # SDK installation directory (the environment variable used appears
413 # to be available when using Visual C++ 2008 or later via the
414 # command line).
416 !IFNDEF NSDKLIBPATH
417 NSDKLIBPATH = $(WINDOWSSDKDIR)\lib
418 !ENDIF
420 NSDKLIBPATH = $(NSDKLIBPATH:\\=\)
422 # Check for the UCRT library path macro.  Otherwise, this value will
423 # default to the version-specific, platform-specific 'lib' directory
424 # underneath the Windows SDK installation directory.
426 !IFNDEF UCRTLIBPATH
427 UCRTLIBPATH = $(WINDOWSSDKDIR)\lib\$(WINDOWSSDKLIBVERSION)\ucrt\$(PLATFORM)
428 !ENDIF
430 UCRTLIBPATH = $(UCRTLIBPATH:\\=\)
432 # C compiler and options for use in building executables that
433 # will run on the platform that is doing the build.
435 !IF $(USE_FULLWARN)!=0
436 BCC = $(NCC) -nologo -W4 $(CCOPTS) $(BCCOPTS)
437 !ELSE
438 BCC = $(NCC) -nologo -W3 $(CCOPTS) $(BCCOPTS)
439 !ENDIF
441 # Check if assembly code listings should be generated for the source
442 # code files to be compiled.
444 !IF $(USE_LISTINGS)!=0
445 BCC = $(BCC) -FAcs
446 !ENDIF
448 # Check if the native library paths should be used when compiling
449 # the command line tools used during the compilation process.  If
450 # so, set the necessary macro now.
452 !IF $(USE_NATIVE_LIBPATHS)!=0
453 NLTLIBPATHS = "/LIBPATH:$(NCRTLIBPATH)" "/LIBPATH:$(NSDKLIBPATH)"
455 !IFDEF NUCRTLIBPATH
456 NUCRTLIBPATH = $(NUCRTLIBPATH:\\=\)
457 NLTLIBPATHS = $(NLTLIBPATHS) "/LIBPATH:$(NUCRTLIBPATH)"
458 !ENDIF
459 !ENDIF
461 # C compiler and options for use in building executables that
462 # will run on the target platform.  (BCC and TCC are usually the
463 # same unless your are cross-compiling.)
465 !IF $(USE_FULLWARN)!=0
466 TCC = $(CC) -nologo -W4 -DINCLUDE_MSVC_H=1 $(CCOPTS) $(TCCOPTS)
467 !ELSE
468 TCC = $(CC) -nologo -W3 $(CCOPTS) $(TCCOPTS)
469 !ENDIF
471 # Check if warnings should be treated as errors when compiling.
473 !IF $(USE_FATAL_WARN)!=0
474 TCC = $(TCC) -WX
475 !ENDIF
477 TCC = $(TCC) -DSQLITE_OS_WIN=1 -I. -I$(TOP) -fp:precise
478 RCC = $(RC) -DSQLITE_OS_WIN=1 -I. -I$(TOP) $(RCOPTS) $(RCCOPTS)
480 # Check if we want to use the "stdcall" calling convention when compiling.
481 # This is not supported by the compilers for non-x86 platforms.  It should
482 # also be noted here that building any target with these "stdcall" options
483 # will most likely fail if the Tcl library is also required.  This is due
484 # to how the Tcl library functions are declared and exported (i.e. without
485 # an explicit calling convention, which results in "cdecl").
487 !IF $(USE_STDCALL)!=0 || $(FOR_WIN10)!=0
488 !IF "$(PLATFORM)"=="x86"
489 CORE_CCONV_OPTS = -Gz -DSQLITE_CDECL=__cdecl -DSQLITE_APICALL=__stdcall -DSQLITE_CALLBACK=__stdcall -DSQLITE_SYSAPI=__stdcall
490 SHELL_CCONV_OPTS = -Gz -DSQLITE_CDECL=__cdecl -DSQLITE_APICALL=__stdcall -DSQLITE_CALLBACK=__stdcall -DSQLITE_SYSAPI=__stdcall
491 !ELSE
492 !IFNDEF PLATFORM
493 CORE_CCONV_OPTS = -Gz -DSQLITE_CDECL=__cdecl -DSQLITE_APICALL=__stdcall -DSQLITE_CALLBACK=__stdcall -DSQLITE_SYSAPI=__stdcall
494 SHELL_CCONV_OPTS = -Gz -DSQLITE_CDECL=__cdecl -DSQLITE_APICALL=__stdcall -DSQLITE_CALLBACK=__stdcall -DSQLITE_SYSAPI=__stdcall
495 !ELSE
496 CORE_CCONV_OPTS =
497 SHELL_CCONV_OPTS =
498 !ENDIF
499 !ENDIF
500 !ELSE
501 CORE_CCONV_OPTS =
502 SHELL_CCONV_OPTS =
503 !ENDIF
505 # These are additional compiler options used for the core library.
507 !IFNDEF CORE_COMPILE_OPTS
508 !IF $(DYNAMIC_SHELL)!=0 || $(FOR_WIN10)!=0
509 CORE_COMPILE_OPTS = $(CORE_CCONV_OPTS) -DSQLITE_API=__declspec(dllexport)
510 !ELSE
511 CORE_COMPILE_OPTS = $(CORE_CCONV_OPTS)
512 !ENDIF
513 !ENDIF
515 # These are the additional targets that the core library should depend on
516 # when linking.
518 !IFNDEF CORE_LINK_DEP
519 !IF $(DYNAMIC_SHELL)!=0
520 CORE_LINK_DEP =
521 !ELSEIF $(FOR_WIN10)==0 || "$(PLATFORM)"=="x86"
522 CORE_LINK_DEP = sqlite3.def
523 !ELSE
524 CORE_LINK_DEP =
525 !ENDIF
526 !ENDIF
528 # These are additional linker options used for the core library.
530 !IFNDEF CORE_LINK_OPTS
531 !IF $(DYNAMIC_SHELL)!=0
532 CORE_LINK_OPTS =
533 !ELSEIF $(FOR_WIN10)==0 || "$(PLATFORM)"=="x86"
534 CORE_LINK_OPTS = /DEF:sqlite3.def
535 !ELSE
536 CORE_LINK_OPTS =
537 !ENDIF
538 !ENDIF
540 # These are additional compiler options used for the shell executable.
542 !IFNDEF SHELL_COMPILE_OPTS
543 !IF $(DYNAMIC_SHELL)!=0 || $(FOR_WIN10)!=0
544 SHELL_COMPILE_OPTS = $(SHELL_CCONV_OPTS) -DSQLITE_API=__declspec(dllimport)
545 !ELSE
546 SHELL_COMPILE_OPTS = $(SHELL_CCONV_OPTS)
547 !ENDIF
548 !ENDIF
550 # This is the source code that the shell executable should be compiled
551 # with.
553 !IFNDEF SHELL_CORE_SRC
554 !IF $(DYNAMIC_SHELL)!=0 || $(FOR_WIN10)!=0
555 SHELL_CORE_SRC =
556 !ELSE
557 SHELL_CORE_SRC = $(SQLITE3C)
558 !ENDIF
559 !ENDIF
561 # This is the core library that the shell executable should depend on.
563 !IFNDEF SHELL_CORE_DEP
564 !IF $(DYNAMIC_SHELL)!=0 || $(FOR_WIN10)!=0
565 SHELL_CORE_DEP = $(SQLITE3DLL)
566 !ELSE
567 SHELL_CORE_DEP =
568 !ENDIF
569 !ENDIF
572 # This is the core library that the shell executable should link with.
574 !IFNDEF SHELL_CORE_LIB
575 !IF $(DYNAMIC_SHELL)!=0 || $(FOR_WIN10)!=0
576 SHELL_CORE_LIB = $(SQLITE3LIB)
577 !ELSE
578 SHELL_CORE_LIB =
579 !ENDIF
580 !ENDIF
582 # These are additional linker options used for the shell executable.
584 !IFNDEF SHELL_LINK_OPTS
585 SHELL_LINK_OPTS = $(SHELL_CORE_LIB)
586 !ENDIF
588 # Check if assembly code listings should be generated for the source
589 # code files to be compiled.
591 !IF $(USE_LISTINGS)!=0
592 TCC = $(TCC) -FAcs
593 !ENDIF
595 # When compiling the library for use in the WinRT environment,
596 # the following compile-time options must be used as well to
597 # disable use of Win32 APIs that are not available and to enable
598 # use of Win32 APIs that are specific to Windows 8 and/or WinRT.
600 !IF $(FOR_WINRT)!=0
601 TCC = $(TCC) -DSQLITE_OS_WINRT=1
602 RCC = $(RCC) -DSQLITE_OS_WINRT=1
603 TCC = $(TCC) -DWINAPI_FAMILY=WINAPI_FAMILY_APP
604 RCC = $(RCC) -DWINAPI_FAMILY=WINAPI_FAMILY_APP
605 !ENDIF
607 # C compiler options for the Windows 10 platform (needs MSVC 2015).
609 !IF $(FOR_WIN10)!=0
610 TCC = $(TCC) /d2guard4 -D_ARM_WINAPI_PARTITION_DESKTOP_SDK_AVAILABLE
611 BCC = $(BCC) /d2guard4 -D_ARM_WINAPI_PARTITION_DESKTOP_SDK_AVAILABLE
612 !ENDIF
614 # Also, we need to dynamically link to the correct MSVC runtime
615 # when compiling for WinRT (e.g. debug or release) OR if the
616 # USE_CRT_DLL option is set to force dynamically linking to the
617 # MSVC runtime library.
619 !IF $(FOR_WINRT)!=0 || $(USE_CRT_DLL)!=0
620 !IF $(DEBUG)>1
621 TCC = $(TCC) -MDd
622 BCC = $(BCC) -MDd
623 !ELSE
624 TCC = $(TCC) -MD
625 BCC = $(BCC) -MD
626 !ENDIF
627 !ELSE
628 !IF $(DEBUG)>1
629 TCC = $(TCC) -MTd
630 BCC = $(BCC) -MTd
631 !ELSE
632 TCC = $(TCC) -MT
633 BCC = $(BCC) -MT
634 !ENDIF
635 !ENDIF
638 # Define -DNDEBUG to compile without debugging (i.e., for production usage)
639 # Omitting the define will cause extra debugging code to be inserted and
640 # includes extra comments when "EXPLAIN stmt" is used.
642 !IF $(DEBUG)==0
643 TCC = $(TCC) -DNDEBUG
644 BCC = $(BCC) -DNDEBUG
645 RCC = $(RCC) -DNDEBUG
646 !ENDIF
648 !IF $(DEBUG)>0 || $(API_ARMOR)!=0 || $(FOR_WIN10)!=0
649 TCC = $(TCC) -DSQLITE_ENABLE_API_ARMOR=1
650 RCC = $(RCC) -DSQLITE_ENABLE_API_ARMOR=1
651 !ENDIF
653 !IF $(DEBUG)>2
654 TCC = $(TCC) -DSQLITE_DEBUG=1
655 RCC = $(RCC) -DSQLITE_DEBUG=1
656 !IF $(DYNAMIC_SHELL)==0
657 TCC = $(TCC) -DSQLITE_ENABLE_WHERETRACE -DSQLITE_ENABLE_SELECTTRACE
658 RCC = $(RCC) -DSQLITE_ENABLE_WHERETRACE -DSQLITE_ENABLE_SELECTTRACE
659 !ENDIF
660 !ENDIF
662 !IF $(DEBUG)>4 || $(OSTRACE)!=0
663 TCC = $(TCC) -DSQLITE_FORCE_OS_TRACE=1 -DSQLITE_DEBUG_OS_TRACE=1
664 RCC = $(RCC) -DSQLITE_FORCE_OS_TRACE=1 -DSQLITE_DEBUG_OS_TRACE=1
665 !ENDIF
667 !IF $(DEBUG)>5
668 TCC = $(TCC) -DSQLITE_ENABLE_IOTRACE=1
669 RCC = $(RCC) -DSQLITE_ENABLE_IOTRACE=1
670 !ENDIF
672 # Prevent warnings about "insecure" MSVC runtime library functions
673 # being used.
675 TCC = $(TCC) -D_CRT_SECURE_NO_DEPRECATE -D_CRT_SECURE_NO_WARNINGS
676 BCC = $(BCC) -D_CRT_SECURE_NO_DEPRECATE -D_CRT_SECURE_NO_WARNINGS
677 RCC = $(RCC) -D_CRT_SECURE_NO_DEPRECATE -D_CRT_SECURE_NO_WARNINGS
679 # Prevent warnings about "deprecated" POSIX functions being used.
681 TCC = $(TCC) -D_CRT_NONSTDC_NO_DEPRECATE -D_CRT_NONSTDC_NO_WARNINGS
682 BCC = $(BCC) -D_CRT_NONSTDC_NO_DEPRECATE -D_CRT_NONSTDC_NO_WARNINGS
683 RCC = $(RCC) -D_CRT_NONSTDC_NO_DEPRECATE -D_CRT_NONSTDC_NO_WARNINGS
685 # Use the SQLite debugging heap subsystem?
687 !IF $(MEMDEBUG)!=0
688 TCC = $(TCC) -DSQLITE_MEMDEBUG=1
689 RCC = $(RCC) -DSQLITE_MEMDEBUG=1
691 # Use native Win32 heap subsystem instead of malloc/free?
693 !ELSEIF $(WIN32HEAP)!=0
694 TCC = $(TCC) -DSQLITE_WIN32_MALLOC=1
695 RCC = $(RCC) -DSQLITE_WIN32_MALLOC=1
697 # Validate the heap on every call into the native Win32 heap subsystem?
699 !IF $(DEBUG)>3
700 TCC = $(TCC) -DSQLITE_WIN32_MALLOC_VALIDATE=1
701 RCC = $(RCC) -DSQLITE_WIN32_MALLOC_VALIDATE=1
702 !ENDIF
703 !ENDIF
706 # Compiler options needed for programs that use the readline() library.
708 !IFNDEF READLINE_FLAGS
709 READLINE_FLAGS = -DHAVE_READLINE=0
710 !ENDIF
712 # The library that programs using readline() must link against.
714 !IFNDEF LIBREADLINE
715 LIBREADLINE =
716 !ENDIF
718 # Should the database engine be compiled threadsafe
720 TCC = $(TCC) -DSQLITE_THREADSAFE=1
721 RCC = $(RCC) -DSQLITE_THREADSAFE=1
723 # Do threads override each others locks by default (1), or do we test (-1)
725 TCC = $(TCC) -DSQLITE_THREAD_OVERRIDE_LOCK=-1
726 RCC = $(RCC) -DSQLITE_THREAD_OVERRIDE_LOCK=-1
728 # Any target libraries which libsqlite must be linked against
730 !IFNDEF TLIBS
731 TLIBS =
732 !ENDIF
734 # Flags controlling use of the in memory btree implementation
736 # SQLITE_TEMP_STORE is 0 to force temporary tables to be in a file, 1 to
737 # default to file, 2 to default to memory, and 3 to force temporary
738 # tables to always be in memory.
740 TCC = $(TCC) -DSQLITE_TEMP_STORE=1
741 RCC = $(RCC) -DSQLITE_TEMP_STORE=1
743 # Enable/disable loadable extensions, and other optional features
744 # based on configuration. (-DSQLITE_OMIT*, -DSQLITE_ENABLE*).
745 # The same set of OMIT and ENABLE flags should be passed to the
746 # LEMON parser generator and the mkkeywordhash tool as well.
748 # These are the required SQLite compilation options used when compiling for
749 # the Windows platform.
751 REQ_FEATURE_FLAGS = $(REQ_FEATURE_FLAGS) -DSQLITE_MAX_TRIGGER_DEPTH=100
753 # If we are linking to the RPCRT4 library, enable features that need it.
755 !IF $(USE_RPCRT4_LIB)!=0
756 REQ_FEATURE_FLAGS = $(REQ_FEATURE_FLAGS) -DSQLITE_WIN32_USE_UUID=1
757 !ENDIF
759 # Add the required and optional SQLite compilation options into the command
760 # lines used to invoke the MSVC code and resource compilers.
762 TCC = $(TCC) $(REQ_FEATURE_FLAGS) $(OPT_FEATURE_FLAGS) $(EXT_FEATURE_FLAGS)
763 RCC = $(RCC) $(REQ_FEATURE_FLAGS) $(OPT_FEATURE_FLAGS) $(EXT_FEATURE_FLAGS)
765 # Add in any optional parameters specified on the commane line, e.g.
766 # nmake /f Makefile.msc all "OPTS=-DSQLITE_ENABLE_FOO=1 -DSQLITE_OMIT_FOO=1"
768 TCC = $(TCC) $(OPTS)
769 RCC = $(RCC) $(OPTS)
771 # If compiling for debugging, add some defines.
773 !IF $(DEBUG)>1
774 TCC = $(TCC) -D_DEBUG
775 BCC = $(BCC) -D_DEBUG
776 RCC = $(RCC) -D_DEBUG
777 !ENDIF
779 # If optimizations are enabled or disabled (either implicitly or
780 # explicitly), add the necessary flags.
782 !IF $(DEBUG)>1 || $(OPTIMIZATIONS)==0
783 TCC = $(TCC) -Od
784 BCC = $(BCC) -Od
785 !IF $(USE_RUNTIME_CHECKS)!=0
786 TCC = $(TCC) -RTC1
787 BCC = $(BCC) -RTC1
788 !ENDIF
789 !ELSEIF $(OPTIMIZATIONS)>=3
790 TCC = $(TCC) -Ox
791 BCC = $(BCC) -Ox
792 !ELSEIF $(OPTIMIZATIONS)==2
793 TCC = $(TCC) -O2
794 BCC = $(BCC) -O2
795 !ELSEIF $(OPTIMIZATIONS)==1
796 TCC = $(TCC) -O1
797 BCC = $(BCC) -O1
798 !ENDIF
800 # If symbols are enabled (or compiling for debugging), enable PDBs.
802 !IF $(DEBUG)>1 || $(SYMBOLS)!=0
803 TCC = $(TCC) -Zi
804 BCC = $(BCC) -Zi
805 !ENDIF
808 # Command line prefixes for compiling code, compiling resources,
809 # linking, etc.
811 LTCOMPILE = $(TCC) -Fo$@
812 LTRCOMPILE = $(RCC) -r
813 LTLIB = lib.exe
814 LTLINK = $(TCC) -Fe$@
816 # If requested, link to the RPCRT4 library.
818 !IF $(USE_RPCRT4_LIB)!=0
819 LTLIBS = $(LTLIBS) rpcrt4.lib
820 !ENDIF
822 # If a platform was set, force the linker to target that.
823 # Note that the vcvars*.bat family of batch files typically
824 # set this for you.  Otherwise, the linker will attempt
825 # to deduce the binary type based on the object files.
826 !IFDEF PLATFORM
827 LTLINKOPTS = /NOLOGO /MACHINE:$(PLATFORM)
828 LTLIBOPTS = /NOLOGO /MACHINE:$(PLATFORM)
829 !ELSE
830 LTLINKOPTS = /NOLOGO
831 LTLIBOPTS = /NOLOGO
832 !ENDIF
834 # When compiling for use in the WinRT environment, the following
835 # linker option must be used to mark the executable as runnable
836 # only in the context of an application container.
838 !IF $(FOR_WINRT)!=0
839 LTLINKOPTS = $(LTLINKOPTS) /APPCONTAINER
840 !IF "$(VISUALSTUDIOVERSION)"=="12.0" || "$(VISUALSTUDIOVERSION)"=="14.0"
841 !IFNDEF STORELIBPATH
842 !IF "$(PLATFORM)"=="x86"
843 STORELIBPATH = $(CRTLIBPATH)\store
844 !ELSEIF "$(PLATFORM)"=="x64"
845 STORELIBPATH = $(CRTLIBPATH)\store\amd64
846 !ELSEIF "$(PLATFORM)"=="ARM"
847 STORELIBPATH = $(CRTLIBPATH)\store\arm
848 !ELSE
849 STORELIBPATH = $(CRTLIBPATH)\store
850 !ENDIF
851 !ENDIF
852 STORELIBPATH = $(STORELIBPATH:\\=\)
853 LTLINKOPTS = $(LTLINKOPTS) "/LIBPATH:$(STORELIBPATH)"
854 !ENDIF
855 !ENDIF
857 # When compiling for Windows Phone 8.1, an extra library path is
858 # required.
860 !IF $(USE_WP81_OPTS)!=0
861 !IFNDEF WP81LIBPATH
862 !IF "$(PLATFORM)"=="x86"
863 WP81LIBPATH = $(PROGRAMFILES_X86)\Windows Phone Kits\8.1\lib\x86
864 !ELSEIF "$(PLATFORM)"=="ARM"
865 WP81LIBPATH = $(PROGRAMFILES_X86)\Windows Phone Kits\8.1\lib\ARM
866 !ELSE
867 WP81LIBPATH = $(PROGRAMFILES_X86)\Windows Phone Kits\8.1\lib\x86
868 !ENDIF
869 !ENDIF
870 !ENDIF
872 # When compiling for Windows Phone 8.1, some extra linker options
873 # are also required.
875 !IF $(USE_WP81_OPTS)!=0
876 !IFDEF WP81LIBPATH
877 LTLINKOPTS = $(LTLINKOPTS) "/LIBPATH:$(WP81LIBPATH)"
878 !ENDIF
879 LTLINKOPTS = $(LTLINKOPTS) /DYNAMICBASE
880 LTLINKOPTS = $(LTLINKOPTS) WindowsPhoneCore.lib RuntimeObject.lib PhoneAppModelHost.lib
881 LTLINKOPTS = $(LTLINKOPTS) /NODEFAULTLIB:kernel32.lib /NODEFAULTLIB:ole32.lib
882 !ENDIF
884 # When compiling for UWP or the Windows 10 platform, some extra linker
885 # options are also required.
887 !IF $(FOR_UWP)!=0 || $(FOR_WIN10)!=0
888 LTLINKOPTS = $(LTLINKOPTS) /DYNAMICBASE /NODEFAULTLIB:kernel32.lib
889 LTLINKOPTS = $(LTLINKOPTS) mincore.lib
890 !IFDEF PSDKLIBPATH
891 LTLINKOPTS = $(LTLINKOPTS) "/LIBPATH:$(PSDKLIBPATH)"
892 !ENDIF
893 !ENDIF
895 !IF $(FOR_WIN10)!=0
896 LTLINKOPTS = $(LTLINKOPTS) /guard:cf "/LIBPATH:$(UCRTLIBPATH)"
897 !IF $(DEBUG)>1
898 LTLINKOPTS = $(LTLINKOPTS) /NODEFAULTLIB:libucrtd.lib /DEFAULTLIB:ucrtd.lib
899 !ELSE
900 LTLINKOPTS = $(LTLINKOPTS) /NODEFAULTLIB:libucrt.lib /DEFAULTLIB:ucrt.lib
901 !ENDIF
902 !ENDIF
904 # If either debugging or symbols are enabled, enable PDBs.
906 !IF $(DEBUG)>1 || $(SYMBOLS)!=0
907 LDFLAGS = /DEBUG $(LDOPTS)
908 !ELSE
909 LDFLAGS = $(LDOPTS)
910 !ENDIF
913 # You should not have to change anything below this line
914 ###############################################################################
917 # Object files for the amalgamation.
919 LIBOBJS1 = sqlite3.lo
921 # Determine the real value of LIBOBJ based on the 'configure' script
923 LIBOBJ = $(LIBOBJS1)
925 # Determine if embedded resource compilation and usage are enabled.
927 !IF $(USE_RC)!=0
928 LIBRESOBJS = sqlite3res.lo
929 !ELSE
930 LIBRESOBJS =
931 !ENDIF
934 # Additional compiler options for the shell.  These are only effective
935 # when the shell is not being dynamically linked.
937 !IF $(DYNAMIC_SHELL)==0 && $(FOR_WIN10)==0
938 SHELL_COMPILE_OPTS = $(SHELL_COMPILE_OPTS) -DSQLITE_ENABLE_FTS4=1
939 SHELL_COMPILE_OPTS = $(SHELL_COMPILE_OPTS) -DSQLITE_ENABLE_EXPLAIN_COMMENTS=1
940 SHELL_COMPILE_OPTS = $(SHELL_COMPILE_OPTS) -DSQLITE_ENABLE_OFFSET_SQL_FUNC=1
941 SHELL_COMPILE_OPTS = $(SHELL_COMPILE_OPTS) -DSQLITE_ENABLE_DESERIALIZE=1
942 !ENDIF
945 # This is the default Makefile target.  The objects listed here
946 # are what get build when you type just "make" with no arguments.
948 core:   dll shell
950 # Targets that require the Tcl library.
952 tcl:    $(ALL_TCL_TARGETS)
954 # This Makefile target builds all of the standard binaries.
956 all:    core tcl
958 # Dynamic link library section.
960 dll:    $(SQLITE3DLL)
962 # Shell executable.
964 shell:  $(SQLITE3EXE)
967 $(SQLITE3DLL):  $(LIBOBJ) $(LIBRESOBJS) $(CORE_LINK_DEP)
968         $(LD) $(LDFLAGS) $(LTLINKOPTS) $(LTLIBPATHS) /DLL $(CORE_LINK_OPTS) /OUT:$@ $(LIBOBJ) $(LIBRESOBJS) $(LTLIBS) $(TLIBS)
970 Replace.exe:
971         $(CSC) /target:exe $(TOP)\Replace.cs
973 sqlite3.def:    Replace.exe $(LIBOBJ)
974         echo EXPORTS > sqlite3.def
975         dumpbin /all $(LIBOBJ) \
976                 | .\Replace.exe "^\s+/EXPORT:_?(sqlite3(?:session|changeset|changegroup|rebaser)?_[^@,]*)(?:@\d+|,DATA)?$$" $$1 true \
977                 | sort >> sqlite3.def
979 $(SQLITE3EXE):  shell.c $(SHELL_CORE_DEP) $(LIBRESOBJS) $(SHELL_CORE_SRC) $(SQLITE3H)
980         $(LTLINK) $(SHELL_COMPILE_OPTS) $(READLINE_FLAGS) shell.c $(SHELL_CORE_SRC) \
981                 /link $(SQLITE3EXEPDB) $(LDFLAGS) $(LTLINKOPTS) $(SHELL_LINK_OPTS) $(LTLIBPATHS) $(LIBRESOBJS) $(LIBREADLINE) $(LTLIBS) $(TLIBS)
984 # Rule to build the amalgamation
986 sqlite3.lo:     $(SQLITE3C)
987         $(LTCOMPILE) $(CORE_COMPILE_OPTS) -c $(SQLITE3C)
990 # Rule to build the Win32 resources object file.
992 !IF $(USE_RC)!=0
993 _HASHCHAR=^#
994 !IF ![echo !IFNDEF VERSION > rcver.vc] && \
995     ![for /F "delims=" %V in ('type "$(SQLITE3H)" ^| "%SystemRoot%\System32\find.exe" "$(_HASHCHAR)define SQLITE_VERSION "') do (echo VERSION = ^^%V >> rcver.vc)] && \
996     ![echo !ENDIF >> rcver.vc]
997 !INCLUDE rcver.vc
998 !ENDIF
1000 RESOURCE_VERSION = $(VERSION:^#=)
1001 RESOURCE_VERSION = $(RESOURCE_VERSION:define=)
1002 RESOURCE_VERSION = $(RESOURCE_VERSION:SQLITE_VERSION=)
1003 RESOURCE_VERSION = $(RESOURCE_VERSION:"=)
1004 RESOURCE_VERSION = $(RESOURCE_VERSION:.=,)
1006 $(LIBRESOBJS):  $(TOP)\sqlite3.rc rcver.vc $(SQLITE3H)
1007         echo #ifndef SQLITE_RESOURCE_VERSION > sqlite3rc.h
1008         echo #define SQLITE_RESOURCE_VERSION $(RESOURCE_VERSION) >> sqlite3rc.h
1009         echo #endif >> sqlite3rc.h
1010         $(LTRCOMPILE) -fo $(LIBRESOBJS) -DRC_VERONLY $(TOP)\sqlite3.rc
1011 !ENDIF
1014 clean:
1015         del /Q *.exp *.lo *.ilk *.lib *.obj *.ncb *.pdb *.sdf *.suo 2>NUL
1016         del /Q *.bsc *.def *.cod *.da *.bb *.bbg *.vc gmon.out 2>NUL
1017         del /Q $(SQLITE3EXE) $(SQLITE3DLL) Replace.exe 2>NUL