1 /* 2 ** 2010 February 23 3 ** 4 ** The author disclaims copyright to this source code. In place of 5 ** a legal notice, here is a blessing: 6 ** 7 ** May you do good and not evil. 8 ** May you find forgiveness for yourself and forgive others. 9 ** May you share freely, never taking more than you give. 10 ** 11 ************************************************************************* 12 ** 13 ** This file implements routines used to report what compile-time options 14 ** SQLite was built with. 15 */ 16 17 #ifndef SQLITE_OMIT_COMPILEOPTION_DIAGS 18 19 #include "sqliteInt.h" 20 21 /* 22 ** An array of names of all compile-time options. This array should 23 ** be sorted A-Z. 24 ** 25 ** This array looks large, but in a typical installation actually uses 26 ** only a handful of compile-time options, so most times this array is usually 27 ** rather short and uses little memory space. 28 */ 29 static const char * const azCompileOpt[] = { 30 31 /* These macros are provided to "stringify" the value of the define 32 ** for those options in which the value is meaningful. */ 33 #define CTIMEOPT_VAL_(opt) #opt 34 #define CTIMEOPT_VAL(opt) CTIMEOPT_VAL_(opt) 35 36 #if SQLITE_32BIT_ROWID 37 "32BIT_ROWID", 38 #endif 39 #if SQLITE_4_BYTE_ALIGNED_MALLOC 40 "4_BYTE_ALIGNED_MALLOC", 41 #endif 42 #if SQLITE_CASE_SENSITIVE_LIKE 43 "CASE_SENSITIVE_LIKE", 44 #endif 45 #if SQLITE_CHECK_PAGES 46 "CHECK_PAGES", 47 #endif 48 #if SQLITE_COVERAGE_TEST 49 "COVERAGE_TEST", 50 #endif 51 #if SQLITE_DEBUG 52 "DEBUG", 53 #endif 54 #if SQLITE_DEFAULT_LOCKING_MODE 55 "DEFAULT_LOCKING_MODE=" CTIMEOPT_VAL(SQLITE_DEFAULT_LOCKING_MODE), 56 #endif 57 #if defined(SQLITE_DEFAULT_MMAP_SIZE) && !defined(SQLITE_DEFAULT_MMAP_SIZE_xc) 58 "DEFAULT_MMAP_SIZE=" CTIMEOPT_VAL(SQLITE_DEFAULT_MMAP_SIZE), 59 #endif 60 #if SQLITE_DISABLE_DIRSYNC 61 "DISABLE_DIRSYNC", 62 #endif 63 #if SQLITE_DISABLE_LFS 64 "DISABLE_LFS", 65 #endif 66 #if SQLITE_ENABLE_API_ARMOR 67 "ENABLE_API_ARMOR", 68 #endif 69 #if SQLITE_ENABLE_ATOMIC_WRITE 70 "ENABLE_ATOMIC_WRITE", 71 #endif 72 #if SQLITE_ENABLE_CEROD 73 "ENABLE_CEROD", 74 #endif 75 #if SQLITE_ENABLE_COLUMN_METADATA 76 "ENABLE_COLUMN_METADATA", 77 #endif 78 #if SQLITE_ENABLE_DBSTAT_VTAB 79 "ENABLE_DBSTAT_VTAB", 80 #endif 81 #if SQLITE_ENABLE_EXPENSIVE_ASSERT 82 "ENABLE_EXPENSIVE_ASSERT", 83 #endif 84 #if SQLITE_ENABLE_FTS1 85 "ENABLE_FTS1", 86 #endif 87 #if SQLITE_ENABLE_FTS2 88 "ENABLE_FTS2", 89 #endif 90 #if SQLITE_ENABLE_FTS3 91 "ENABLE_FTS3", 92 #endif 93 #if SQLITE_ENABLE_FTS3_PARENTHESIS 94 "ENABLE_FTS3_PARENTHESIS", 95 #endif 96 #if SQLITE_ENABLE_FTS4 97 "ENABLE_FTS4", 98 #endif 99 #if SQLITE_ENABLE_ICU 100 "ENABLE_ICU", 101 #endif 102 #if SQLITE_ENABLE_IOTRACE 103 "ENABLE_IOTRACE", 104 #endif 105 #if SQLITE_ENABLE_LOAD_EXTENSION 106 "ENABLE_LOAD_EXTENSION", 107 #endif 108 #if SQLITE_ENABLE_LOCKING_STYLE 109 "ENABLE_LOCKING_STYLE=" CTIMEOPT_VAL(SQLITE_ENABLE_LOCKING_STYLE), 110 #endif 111 #if SQLITE_ENABLE_MEMORY_MANAGEMENT 112 "ENABLE_MEMORY_MANAGEMENT", 113 #endif 114 #if SQLITE_ENABLE_MEMSYS3 115 "ENABLE_MEMSYS3", 116 #endif 117 #if SQLITE_ENABLE_MEMSYS5 118 "ENABLE_MEMSYS5", 119 #endif 120 #if SQLITE_ENABLE_OVERSIZE_CELL_CHECK 121 "ENABLE_OVERSIZE_CELL_CHECK", 122 #endif 123 #if SQLITE_ENABLE_RTREE 124 "ENABLE_RTREE", 125 #endif 126 #if defined(SQLITE_ENABLE_STAT4) 127 "ENABLE_STAT4", 128 #elif defined(SQLITE_ENABLE_STAT3) 129 "ENABLE_STAT3", 130 #endif 131 #if SQLITE_ENABLE_UNLOCK_NOTIFY 132 "ENABLE_UNLOCK_NOTIFY", 133 #endif 134 #if SQLITE_ENABLE_UPDATE_DELETE_LIMIT 135 "ENABLE_UPDATE_DELETE_LIMIT", 136 #endif 137 #if SQLITE_HAS_CODEC 138 "HAS_CODEC", 139 #endif 140 #if HAVE_ISNAN || SQLITE_HAVE_ISNAN 141 "HAVE_ISNAN", 142 #endif 143 #if SQLITE_HOMEGROWN_RECURSIVE_MUTEX 144 "HOMEGROWN_RECURSIVE_MUTEX", 145 #endif 146 #if SQLITE_IGNORE_AFP_LOCK_ERRORS 147 "IGNORE_AFP_LOCK_ERRORS", 148 #endif 149 #if SQLITE_IGNORE_FLOCK_LOCK_ERRORS 150 "IGNORE_FLOCK_LOCK_ERRORS", 151 #endif 152 #ifdef SQLITE_INT64_TYPE 153 "INT64_TYPE", 154 #endif 155 #if SQLITE_LOCK_TRACE 156 "LOCK_TRACE", 157 #endif 158 #if defined(SQLITE_MAX_MMAP_SIZE) && !defined(SQLITE_MAX_MMAP_SIZE_xc) 159 "MAX_MMAP_SIZE=" CTIMEOPT_VAL(SQLITE_MAX_MMAP_SIZE), 160 #endif 161 #ifdef SQLITE_MAX_SCHEMA_RETRY 162 "MAX_SCHEMA_RETRY=" CTIMEOPT_VAL(SQLITE_MAX_SCHEMA_RETRY), 163 #endif 164 #if SQLITE_MEMDEBUG 165 "MEMDEBUG", 166 #endif 167 #if SQLITE_MIXED_ENDIAN_64BIT_FLOAT 168 "MIXED_ENDIAN_64BIT_FLOAT", 169 #endif 170 #if SQLITE_NO_SYNC 171 "NO_SYNC", 172 #endif 173 #if SQLITE_OMIT_ALTERTABLE 174 "OMIT_ALTERTABLE", 175 #endif 176 #if SQLITE_OMIT_ANALYZE 177 "OMIT_ANALYZE", 178 #endif 179 #if SQLITE_OMIT_ATTACH 180 "OMIT_ATTACH", 181 #endif 182 #if SQLITE_OMIT_AUTHORIZATION 183 "OMIT_AUTHORIZATION", 184 #endif 185 #if SQLITE_OMIT_AUTOINCREMENT 186 "OMIT_AUTOINCREMENT", 187 #endif 188 #if SQLITE_OMIT_AUTOINIT 189 "OMIT_AUTOINIT", 190 #endif 191 #if SQLITE_OMIT_AUTOMATIC_INDEX 192 "OMIT_AUTOMATIC_INDEX", 193 #endif 194 #if SQLITE_OMIT_AUTORESET 195 "OMIT_AUTORESET", 196 #endif 197 #if SQLITE_OMIT_AUTOVACUUM 198 "OMIT_AUTOVACUUM", 199 #endif 200 #if SQLITE_OMIT_BETWEEN_OPTIMIZATION 201 "OMIT_BETWEEN_OPTIMIZATION", 202 #endif 203 #if SQLITE_OMIT_BLOB_LITERAL 204 "OMIT_BLOB_LITERAL", 205 #endif 206 #if SQLITE_OMIT_BTREECOUNT 207 "OMIT_BTREECOUNT", 208 #endif 209 #if SQLITE_OMIT_BUILTIN_TEST 210 "OMIT_BUILTIN_TEST", 211 #endif 212 #if SQLITE_OMIT_CAST 213 "OMIT_CAST", 214 #endif 215 #if SQLITE_OMIT_CHECK 216 "OMIT_CHECK", 217 #endif 218 #if SQLITE_OMIT_COMPLETE 219 "OMIT_COMPLETE", 220 #endif 221 #if SQLITE_OMIT_COMPOUND_SELECT 222 "OMIT_COMPOUND_SELECT", 223 #endif 224 #if SQLITE_OMIT_CTE 225 "OMIT_CTE", 226 #endif 227 #if SQLITE_OMIT_DATETIME_FUNCS 228 "OMIT_DATETIME_FUNCS", 229 #endif 230 #if SQLITE_OMIT_DECLTYPE 231 "OMIT_DECLTYPE", 232 #endif 233 #if SQLITE_OMIT_DEPRECATED 234 "OMIT_DEPRECATED", 235 #endif 236 #if SQLITE_OMIT_DISKIO 237 "OMIT_DISKIO", 238 #endif 239 #if SQLITE_OMIT_EXPLAIN 240 "OMIT_EXPLAIN", 241 #endif 242 #if SQLITE_OMIT_FLAG_PRAGMAS 243 "OMIT_FLAG_PRAGMAS", 244 #endif 245 #if SQLITE_OMIT_FLOATING_POINT 246 "OMIT_FLOATING_POINT", 247 #endif 248 #if SQLITE_OMIT_FOREIGN_KEY 249 "OMIT_FOREIGN_KEY", 250 #endif 251 #if SQLITE_OMIT_GET_TABLE 252 "OMIT_GET_TABLE", 253 #endif 254 #if SQLITE_OMIT_INCRBLOB 255 "OMIT_INCRBLOB", 256 #endif 257 #if SQLITE_OMIT_INTEGRITY_CHECK 258 "OMIT_INTEGRITY_CHECK", 259 #endif 260 #if SQLITE_OMIT_LIKE_OPTIMIZATION 261 "OMIT_LIKE_OPTIMIZATION", 262 #endif 263 #if SQLITE_OMIT_LOAD_EXTENSION 264 "OMIT_LOAD_EXTENSION", 265 #endif 266 #if SQLITE_OMIT_LOCALTIME 267 "OMIT_LOCALTIME", 268 #endif 269 #if SQLITE_OMIT_LOOKASIDE 270 "OMIT_LOOKASIDE", 271 #endif 272 #if SQLITE_OMIT_MEMORYDB 273 "OMIT_MEMORYDB", 274 #endif 275 #if SQLITE_OMIT_OR_OPTIMIZATION 276 "OMIT_OR_OPTIMIZATION", 277 #endif 278 #if SQLITE_OMIT_PAGER_PRAGMAS 279 "OMIT_PAGER_PRAGMAS", 280 #endif 281 #if SQLITE_OMIT_PRAGMA 282 "OMIT_PRAGMA", 283 #endif 284 #if SQLITE_OMIT_PROGRESS_CALLBACK 285 "OMIT_PROGRESS_CALLBACK", 286 #endif 287 #if SQLITE_OMIT_QUICKBALANCE 288 "OMIT_QUICKBALANCE", 289 #endif 290 #if SQLITE_OMIT_REINDEX 291 "OMIT_REINDEX", 292 #endif 293 #if SQLITE_OMIT_SCHEMA_PRAGMAS 294 "OMIT_SCHEMA_PRAGMAS", 295 #endif 296 #if SQLITE_OMIT_SCHEMA_VERSION_PRAGMAS 297 "OMIT_SCHEMA_VERSION_PRAGMAS", 298 #endif 299 #if SQLITE_OMIT_SHARED_CACHE 300 "OMIT_SHARED_CACHE", 301 #endif 302 #if SQLITE_OMIT_SUBQUERY 303 "OMIT_SUBQUERY", 304 #endif 305 #if SQLITE_OMIT_TCL_VARIABLE 306 "OMIT_TCL_VARIABLE", 307 #endif 308 #if SQLITE_OMIT_TEMPDB 309 "OMIT_TEMPDB", 310 #endif 311 #if SQLITE_OMIT_TRACE 312 "OMIT_TRACE", 313 #endif 314 #if SQLITE_OMIT_TRIGGER 315 "OMIT_TRIGGER", 316 #endif 317 #if SQLITE_OMIT_TRUNCATE_OPTIMIZATION 318 "OMIT_TRUNCATE_OPTIMIZATION", 319 #endif 320 #if SQLITE_OMIT_UTF16 321 "OMIT_UTF16", 322 #endif 323 #if SQLITE_OMIT_VACUUM 324 "OMIT_VACUUM", 325 #endif 326 #if SQLITE_OMIT_VIEW 327 "OMIT_VIEW", 328 #endif 329 #if SQLITE_OMIT_VIRTUALTABLE 330 "OMIT_VIRTUALTABLE", 331 #endif 332 #if SQLITE_OMIT_WAL 333 "OMIT_WAL", 334 #endif 335 #if SQLITE_OMIT_WSD 336 "OMIT_WSD", 337 #endif 338 #if SQLITE_OMIT_XFER_OPT 339 "OMIT_XFER_OPT", 340 #endif 341 #if SQLITE_PERFORMANCE_TRACE 342 "PERFORMANCE_TRACE", 343 #endif 344 #if SQLITE_PROXY_DEBUG 345 "PROXY_DEBUG", 346 #endif 347 #if SQLITE_RTREE_INT_ONLY 348 "RTREE_INT_ONLY", 349 #endif 350 #if SQLITE_SECURE_DELETE 351 "SECURE_DELETE", 352 #endif 353 #if SQLITE_SMALL_STACK 354 "SMALL_STACK", 355 #endif 356 #if SQLITE_SOUNDEX 357 "SOUNDEX", 358 #endif 359 #if SQLITE_SYSTEM_MALLOC 360 "SYSTEM_MALLOC", 361 #endif 362 #if SQLITE_TCL 363 "TCL", 364 #endif 365 #if defined(SQLITE_TEMP_STORE) && !defined(SQLITE_TEMP_STORE_xc) 366 "TEMP_STORE=" CTIMEOPT_VAL(SQLITE_TEMP_STORE), 367 #endif 368 #if SQLITE_TEST 369 "TEST", 370 #endif 371 #if defined(SQLITE_THREADSAFE) 372 "THREADSAFE=" CTIMEOPT_VAL(SQLITE_THREADSAFE), 373 #endif 374 #if SQLITE_USE_ALLOCA 375 "USE_ALLOCA", 376 #endif 377 #if SQLITE_USER_AUTHENTICATION 378 "USER_AUTHENTICATION", 379 #endif 380 #if SQLITE_WIN32_MALLOC 381 "WIN32_MALLOC", 382 #endif 383 #if SQLITE_ZERO_MALLOC 384 "ZERO_MALLOC" 385 #endif 386 }; 387 388 /* 389 ** Given the name of a compile-time option, return true if that option 390 ** was used and false if not. 391 ** 392 ** The name can optionally begin with "SQLITE_" but the "SQLITE_" prefix 393 ** is not required for a match. 394 */ 395 int sqlite3_compileoption_used(const char *zOptName){ 396 int i, n; 397 398 #if SQLITE_ENABLE_API_ARMOR 399 if( zOptName==0 ){ 400 (void)SQLITE_MISUSE_BKPT; 401 return 0; 402 } 403 #endif 404 if( sqlite3StrNICmp(zOptName, "SQLITE_", 7)==0 ) zOptName += 7; 405 n = sqlite3Strlen30(zOptName); 406 407 /* Since ArraySize(azCompileOpt) is normally in single digits, a 408 ** linear search is adequate. No need for a binary search. */ 409 for(i=0; i<ArraySize(azCompileOpt); i++){ 410 if( sqlite3StrNICmp(zOptName, azCompileOpt[i], n)==0 411 && sqlite3IsIdChar((unsigned char)azCompileOpt[i][n])==0 412 ){ 413 return 1; 414 } 415 } 416 return 0; 417 } 418 419 /* 420 ** Return the N-th compile-time option string. If N is out of range, 421 ** return a NULL pointer. 422 */ 423 const char *sqlite3_compileoption_get(int N){ 424 if( N>=0 && N<ArraySize(azCompileOpt) ){ 425 return azCompileOpt[N]; 426 } 427 return 0; 428 } 429 430 #endif /* SQLITE_OMIT_COMPILEOPTION_DIAGS */ 431