?  search:
summary | log | graphiclog1 | graphiclog2 | commit | commitdiff | tree | refs | edit | fork
blame | history | raw | HEAD
changelog update
[sqlcipher.git] / src / test1.c
blob9de024b7d104e52313c9774cb8493d84d66d9b4b
1 /*
2 ** 2001 September 15
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 ** Code for testing all sorts of SQLite interfaces. This code
13 ** is not included in the SQLite library. It is used for automated
14 ** testing of the SQLite library.
15 */
16 #include "sqliteInt.h"
17 #if SQLITE_OS_WIN
18 # include "os_win.h"
19 #endif
20
21 #include "vdbeInt.h"
22 #if defined(INCLUDE_SQLITE_TCL_H)
23 # include "sqlite_tcl.h"
24 #else
25 # include "tcl.h"
26 #endif
27 #include <stdlib.h>
28 #include <string.h>
29
30 /*
31 ** This is a copy of the first part of the SqliteDb structure in
32 ** tclsqlite.c. We need it here so that the get_sqlite_pointer routine
33 ** can extract the sqlite3* pointer from an existing Tcl SQLite
34 ** connection.
35 */
36 struct SqliteDb {
37 sqlite3 *db;
38 };
39
40 /*
41 ** Convert text generated by the "%p" conversion format back into
42 ** a pointer.
43 */
44 static int testHexToInt(int h){
45 if( h>='0' && h<='9' ){
46 return h - '0';
47 }else if( h>='a' && h<='f' ){
48 return h - 'a' + 10;
49 }else{
50 assert( h>='A' && h<='F' );
51 return h - 'A' + 10;
52 }
53 }
54 void *sqlite3TestTextToPtr(const char *z){
55 void *p;
56 u64 v;
57 u32 v2;
58 if( z[0]=='0' && z[1]=='x' ){
59 z += 2;
60 }
61 v = 0;
62 while( *z ){
63 v = (v<<4) + testHexToInt(*z);
64 z++;
65 }
66 if( sizeof(p)==sizeof(v) ){
67 memcpy(&p, &v, sizeof(p));
68 }else{
69 assert( sizeof(p)==sizeof(v2) );
70 v2 = (u32)v;
71 memcpy(&p, &v2, sizeof(p));
72 }
73 return p;
74 }
75
76
77 /*
78 ** A TCL command that returns the address of the sqlite* pointer
79 ** for an sqlite connection instance. Bad things happen if the
80 ** input is not an sqlite connection.
81 */
82 static int SQLITE_TCLAPI get_sqlite_pointer(
83 void * clientData,
84 Tcl_Interp *interp,
85 int objc,
86 Tcl_Obj *CONST objv[]
87 ){
88 struct SqliteDb *p;
89 Tcl_CmdInfo cmdInfo;
90 char zBuf[100];
91 if( objc!=2 ){
92 Tcl_WrongNumArgs(interp, 1, objv, "SQLITE-CONNECTION");
93 return TCL_ERROR;
94 }
95 if( !Tcl_GetCommandInfo(interp, Tcl_GetString(objv[1]), &cmdInfo) ){
96 Tcl_AppendResult(interp, "command not found: ",
97 Tcl_GetString(objv[1]), (char*)0);
98 return TCL_ERROR;
99 }
100 p = (struct SqliteDb*)cmdInfo.objClientData;
101 sqlite3_snprintf(sizeof(zBuf), zBuf, "%p", p->db);
102 Tcl_AppendResult(interp, zBuf, 0);
103 return TCL_OK;
104 }
105
106 /*
107 ** Decode a pointer to an sqlite3 object.
108 */
109 int getDbPointer(Tcl_Interp *interp, const char *zA, sqlite3 **ppDb){
110 struct SqliteDb *p;
111 Tcl_CmdInfo cmdInfo;
112 if( Tcl_GetCommandInfo(interp, zA, &cmdInfo) ){
113 p = (struct SqliteDb*)cmdInfo.objClientData;
114 *ppDb = p->db;
115 }else{
116 *ppDb = (sqlite3*)sqlite3TestTextToPtr(zA);
117 }
118 return TCL_OK;
119 }
120
121 #if SQLITE_OS_WIN
122 /*
123 ** Decode a Win32 HANDLE object.
124 */
125 int getWin32Handle(Tcl_Interp *interp, const char *zA, LPHANDLE phFile){
126 *phFile = (HANDLE)sqlite3TestTextToPtr(zA);
127 return TCL_OK;
128 }
129 #endif
130
131 extern const char *sqlite3ErrName(int);
132 #define t1ErrorName sqlite3ErrName
133
134 /*
135 ** Convert an sqlite3_stmt* into an sqlite3*. This depends on the
136 ** fact that the sqlite3* is the first field in the Vdbe structure.
137 */
138 #define StmtToDb(X) sqlite3_db_handle(X)
139
140 /*
141 ** Check a return value to make sure it agrees with the results
142 ** from sqlite3_errcode.
143 */
144 int sqlite3TestErrCode(Tcl_Interp *interp, sqlite3 *db, int rc){
145 if( sqlite3_threadsafe()==0 && rc!=SQLITE_MISUSE && rc!=SQLITE_OK
146 && sqlite3_errcode(db)!=rc ){
147 char zBuf[200];
148 int r2 = sqlite3_errcode(db);
149 sqlite3_snprintf(sizeof(zBuf), zBuf,
150 "error code %s (%d) does not match sqlite3_errcode %s (%d)",
151 t1ErrorName(rc), rc, t1ErrorName(r2), r2);
152 Tcl_ResetResult(interp);
153 Tcl_AppendResult(interp, zBuf, 0);
154 return 1;
155 }
156 return 0;
157 }
158
159 /*
160 ** Decode a pointer to an sqlite3_stmt object.
161 */
162 static int getStmtPointer(
163 Tcl_Interp *interp,
164 const char *zArg,
165 sqlite3_stmt **ppStmt
166 ){
167 *ppStmt = (sqlite3_stmt*)sqlite3TestTextToPtr(zArg);
168 return TCL_OK;
169 }
170
171 /*
172 ** Generate a text representation of a pointer that can be understood
173 ** by the getDbPointer and getVmPointer routines above.
174 **
175 ** The problem is, on some machines (Solaris) if you do a printf with
176 ** "%p" you cannot turn around and do a scanf with the same "%p" and
177 ** get your pointer back. You have to prepend a "0x" before it will
178 ** work. Or at least that is what is reported to me (drh). But this
179 ** behavior varies from machine to machine. The solution used her is
180 ** to test the string right after it is generated to see if it can be
181 ** understood by scanf, and if not, try prepending an "0x" to see if
182 ** that helps. If nothing works, a fatal error is generated.
183 */
184 int sqlite3TestMakePointerStr(Tcl_Interp *interp, char *zPtr, void *p){
185 sqlite3_snprintf(100, zPtr, "%p", p);
186 return TCL_OK;
187 }
188
189 /*
190 ** The callback routine for sqlite3_exec_printf().
191 */
192 static int exec_printf_cb(void *pArg, int argc, char **argv, char **name){
193 Tcl_DString *str = (Tcl_DString*)pArg;
194 int i;
195
196 if( Tcl_DStringLength(str)==0 ){
197 for(i=0; i<argc; i++){
198 Tcl_DStringAppendElement(str, name[i] ? name[i] : "NULL");
199 }
200 }
201 for(i=0; i<argc; i++){
202 Tcl_DStringAppendElement(str, argv[i] ? argv[i] : "NULL");
203 }
204 return 0;
205 }
206
207 /*
208 ** The I/O tracing callback.
209 */
210 #if !defined(SQLITE_OMIT_TRACE) && defined(SQLITE_ENABLE_IOTRACE)
211 static FILE *iotrace_file = 0;
212 static void io_trace_callback(const char *zFormat, ...){
213 va_list ap;
214 va_start(ap, zFormat);
215 vfprintf(iotrace_file, zFormat, ap);
216 va_end(ap);
217 fflush(iotrace_file);
218 }
219 #endif
220
221 /*
222 ** Usage: io_trace FILENAME
223 **
224 ** Turn I/O tracing on or off. If FILENAME is not an empty string,
225 ** I/O tracing begins going into FILENAME. If FILENAME is an empty
226 ** string, I/O tracing is turned off.
227 */
228 static int SQLITE_TCLAPI test_io_trace(
229 void *NotUsed,
230 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
231 int argc, /* Number of arguments */
232 char **argv /* Text of each argument */
233 ){
234 #if !defined(SQLITE_OMIT_TRACE) && defined(SQLITE_ENABLE_IOTRACE)
235 if( argc!=2 ){
236 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
237 " FILENAME\"", 0);
238 return TCL_ERROR;
239 }
240 if( iotrace_file ){
241 if( iotrace_file!=stdout && iotrace_file!=stderr ){
242 fclose(iotrace_file);
243 }
244 iotrace_file = 0;
245 sqlite3IoTrace = 0;
246 }
247 if( argv[1][0] ){
248 if( strcmp(argv[1],"stdout")==0 ){
249 iotrace_file = stdout;
250 }else if( strcmp(argv[1],"stderr")==0 ){
251 iotrace_file = stderr;
252 }else{
253 iotrace_file = fopen(argv[1], "w");
254 }
255 sqlite3IoTrace = io_trace_callback;
256 }
257 #endif
258 return TCL_OK;
259 }
260
261 /*
262 ** Usage: clang_sanitize_address
263 **
264 ** Returns true if the program was compiled using clang with the
265 ** -fsanitize=address switch on the command line. False otherwise.
266 **
267 ** Also return true if the OMIT_MISUSE environment variable exists.
268 */
269 static int SQLITE_TCLAPI clang_sanitize_address(
270 void *NotUsed,
271 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
272 int argc, /* Number of arguments */
273 char **argv /* Text of each argument */
274 ){
275 int res = 0;
276 #if defined(__has_feature)
277 # if __has_feature(address_sanitizer)
278 res = 1;
279 # endif
280 #endif
281 #ifdef __SANITIZE_ADDRESS__
282 res = 1;
283 #endif
284 if( res==0 && getenv("OMIT_MISUSE")!=0 ) res = 1;
285 Tcl_SetObjResult(interp, Tcl_NewIntObj(res));
286 return TCL_OK;
287 }
288
289 /*
290 ** Usage: sqlite3_exec_printf DB FORMAT STRING
291 **
292 ** Invoke the sqlite3_exec_printf() interface using the open database
293 ** DB. The SQL is the string FORMAT. The format string should contain
294 ** one %s or %q. STRING is the value inserted into %s or %q.
295 */
296 static int SQLITE_TCLAPI test_exec_printf(
297 void *NotUsed,
298 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
299 int argc, /* Number of arguments */
300 char **argv /* Text of each argument */
301 ){
302 sqlite3 *db;
303 Tcl_DString str;
304 int rc;
305 char *zErr = 0;
306 char *zSql;
307 char zBuf[30];
308 if( argc!=4 ){
309 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
310 " DB FORMAT STRING", 0);
311 return TCL_ERROR;
312 }
313 if( getDbPointer(interp, argv[1], &db) ) return TCL_ERROR;
314 Tcl_DStringInit(&str);
315 zSql = sqlite3_mprintf(argv[2], argv[3]);
316 rc = sqlite3_exec(db, zSql, exec_printf_cb, &str, &zErr);
317 sqlite3_free(zSql);
318 sqlite3_snprintf(sizeof(zBuf), zBuf, "%d", rc);
319 Tcl_AppendElement(interp, zBuf);
320 Tcl_AppendElement(interp, rc==SQLITE_OK ? Tcl_DStringValue(&str) : zErr);
321 Tcl_DStringFree(&str);
322 if( zErr ) sqlite3_free(zErr);
323 if( sqlite3TestErrCode(interp, db, rc) ) return TCL_ERROR;
324 return TCL_OK;
325 }
326
327 /*
328 ** Usage: sqlite3_exec_hex DB HEX
329 **
330 ** Invoke the sqlite3_exec() on a string that is obtained by translating
331 ** HEX into ASCII. Most characters are translated as is. %HH becomes
332 ** a hex character.
333 */
334 static int SQLITE_TCLAPI test_exec_hex(
335 void *NotUsed,
336 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
337 int argc, /* Number of arguments */
338 char **argv /* Text of each argument */
339 ){
340 sqlite3 *db;
341 Tcl_DString str;
342 int rc, i, j;
343 char *zErr = 0;
344 char *zHex;
345 char zSql[501];
346 char zBuf[30];
347 if( argc!=3 ){
348 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
349 " DB HEX", 0);
350 return TCL_ERROR;
351 }
352 if( getDbPointer(interp, argv[1], &db) ) return TCL_ERROR;
353 zHex = argv[2];
354 for(i=j=0; i<(sizeof(zSql)-1) && zHex[j]; i++, j++){
355 if( zHex[j]=='%' && zHex[j+2] && zHex[j+2] ){
356 zSql[i] = (testHexToInt(zHex[j+1])<<4) + testHexToInt(zHex[j+2]);
357 j += 2;
358 }else{
359 zSql[i] = zHex[j];
360 }
361 }
362 zSql[i] = 0;
363 Tcl_DStringInit(&str);
364 rc = sqlite3_exec(db, zSql, exec_printf_cb, &str, &zErr);
365 sqlite3_snprintf(sizeof(zBuf), zBuf, "%d", rc);
366 Tcl_AppendElement(interp, zBuf);
367 Tcl_AppendElement(interp, rc==SQLITE_OK ? Tcl_DStringValue(&str) : zErr);
368 Tcl_DStringFree(&str);
369 if( zErr ) sqlite3_free(zErr);
370 if( sqlite3TestErrCode(interp, db, rc) ) return TCL_ERROR;
371 return TCL_OK;
372 }
373
374 /*
375 ** Usage: db_enter DB
376 ** db_leave DB
377 **
378 ** Enter or leave the mutex on a database connection.
379 */
380 static int SQLITE_TCLAPI db_enter(
381 void *NotUsed,
382 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
383 int argc, /* Number of arguments */
384 char **argv /* Text of each argument */
385 ){
386 sqlite3 *db;
387 if( argc!=2 ){
388 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
389 " DB", 0);
390 return TCL_ERROR;
391 }
392 if( getDbPointer(interp, argv[1], &db) ) return TCL_ERROR;
393 sqlite3_mutex_enter(db->mutex);
394 return TCL_OK;
395 }
396 static int SQLITE_TCLAPI db_leave(
397 void *NotUsed,
398 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
399 int argc, /* Number of arguments */
400 char **argv /* Text of each argument */
401 ){
402 sqlite3 *db;
403 if( argc!=2 ){
404 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
405 " DB", 0);
406 return TCL_ERROR;
407 }
408 if( getDbPointer(interp, argv[1], &db) ) return TCL_ERROR;
409 sqlite3_mutex_leave(db->mutex);
410 return TCL_OK;
411 }
412
413 /*
414 ** Usage: sqlite3_exec DB SQL
415 **
416 ** Invoke the sqlite3_exec interface using the open database DB
417 */
418 static int SQLITE_TCLAPI test_exec(
419 void *NotUsed,
420 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
421 int argc, /* Number of arguments */
422 char **argv /* Text of each argument */
423 ){
424 sqlite3 *db;
425 Tcl_DString str;
426 int rc;
427 char *zErr = 0;
428 char *zSql;
429 int i, j;
430 char zBuf[30];
431 if( argc!=3 ){
432 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
433 " DB SQL", 0);
434 return TCL_ERROR;
435 }
436 if( getDbPointer(interp, argv[1], &db) ) return TCL_ERROR;
437 Tcl_DStringInit(&str);
438 zSql = sqlite3_mprintf("%s", argv[2]);
439 for(i=j=0; zSql[i];){
440 if( zSql[i]=='%' ){
441 zSql[j++] = (testHexToInt(zSql[i+1])<<4) + testHexToInt(zSql[i+2]);
442 i += 3;
443 }else{
444 zSql[j++] = zSql[i++];
445 }
446 }
447 zSql[j] = 0;
448 rc = sqlite3_exec(db, zSql, exec_printf_cb, &str, &zErr);
449 sqlite3_free(zSql);
450 sqlite3_snprintf(sizeof(zBuf), zBuf, "%d", rc);
451 Tcl_AppendElement(interp, zBuf);
452 Tcl_AppendElement(interp, rc==SQLITE_OK ? Tcl_DStringValue(&str) : zErr);
453 Tcl_DStringFree(&str);
454 if( zErr ) sqlite3_free(zErr);
455 if( sqlite3TestErrCode(interp, db, rc) ) return TCL_ERROR;
456 return TCL_OK;
457 }
458
459 /*
460 ** Usage: sqlite3_exec_nr DB SQL
461 **
462 ** Invoke the sqlite3_exec interface using the open database DB. Discard
463 ** all results
464 */
465 static int SQLITE_TCLAPI test_exec_nr(
466 void *NotUsed,
467 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
468 int argc, /* Number of arguments */
469 char **argv /* Text of each argument */
470 ){
471 sqlite3 *db;
472 int rc;
473 char *zErr = 0;
474 if( argc!=3 ){
475 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
476 " DB SQL", 0);
477 return TCL_ERROR;
478 }
479 if( getDbPointer(interp, argv[1], &db) ) return TCL_ERROR;
480 rc = sqlite3_exec(db, argv[2], 0, 0, &zErr);
481 if( sqlite3TestErrCode(interp, db, rc) ) return TCL_ERROR;
482 return TCL_OK;
483 }
484
485 /*
486 ** Usage: sqlite3_mprintf_z_test SEPARATOR ARG0 ARG1 ...
487 **
488 ** Test the %z format of sqlite_mprintf(). Use multiple mprintf() calls to
489 ** concatenate arg0 through argn using separator as the separator.
490 ** Return the result.
491 */
492 static int SQLITE_TCLAPI test_mprintf_z(
493 void *NotUsed,
494 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
495 int argc, /* Number of arguments */
496 char **argv /* Text of each argument */
497 ){
498 char *zResult = 0;
499 int i;
500
501 for(i=2; i<argc && (i==2 || zResult); i++){
502 zResult = sqlite3_mprintf("%z%s%s", zResult, argv[1], argv[i]);
503 }
504 Tcl_AppendResult(interp, zResult, 0);
505 sqlite3_free(zResult);
506 return TCL_OK;
507 }
508
509 /*
510 ** Usage: sqlite3_mprintf_n_test STRING
511 **
512 ** Test the %n format of sqlite_mprintf(). Return the length of the
513 ** input string.
514 */
515 static int SQLITE_TCLAPI test_mprintf_n(
516 void *NotUsed,
517 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
518 int argc, /* Number of arguments */
519 char **argv /* Text of each argument */
520 ){
521 char *zStr;
522 int n = 0;
523 zStr = sqlite3_mprintf("%s%n", argv[1], &n);
524 sqlite3_free(zStr);
525 Tcl_SetObjResult(interp, Tcl_NewIntObj(n));
526 return TCL_OK;
527 }
528
529 /*
530 ** Usage: sqlite3_snprintf_int SIZE FORMAT INT
531 **
532 ** Test the of sqlite3_snprintf() routine. SIZE is the size of the
533 ** output buffer in bytes. The maximum size is 100. FORMAT is the
534 ** format string. INT is a single integer argument. The FORMAT
535 ** string must require no more than this one integer argument. If
536 ** You pass in a format string that requires more than one argument,
537 ** bad things will happen.
538 */
539 static int SQLITE_TCLAPI test_snprintf_int(
540 void *NotUsed,
541 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
542 int argc, /* Number of arguments */
543 char **argv /* Text of each argument */
544 ){
545 char zStr[100];
546 int n = atoi(argv[1]);
547 const char *zFormat = argv[2];
548 int a1 = atoi(argv[3]);
549 if( n>sizeof(zStr) ) n = sizeof(zStr);
550 sqlite3_snprintf(sizeof(zStr), zStr, "abcdefghijklmnopqrstuvwxyz");
551 sqlite3_snprintf(n, zStr, zFormat, a1);
552 Tcl_AppendResult(interp, zStr, 0);
553 return TCL_OK;
554 }
555
556 #ifndef SQLITE_OMIT_GET_TABLE
557
558 /*
559 ** Usage: sqlite3_get_table_printf DB FORMAT STRING ?--no-counts?
560 **
561 ** Invoke the sqlite3_get_table_printf() interface using the open database
562 ** DB. The SQL is the string FORMAT. The format string should contain
563 ** one %s or %q. STRING is the value inserted into %s or %q.
564 */
565 static int SQLITE_TCLAPI test_get_table_printf(
566 void *NotUsed,
567 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
568 int argc, /* Number of arguments */
569 char **argv /* Text of each argument */
570 ){
571 sqlite3 *db;
572 Tcl_DString str;
573 int rc;
574 char *zErr = 0;
575 int nRow = 0, nCol = 0;
576 char **aResult;
577 int i;
578 char zBuf[30];
579 char *zSql;
580 int resCount = -1;
581 if( argc==5 ){
582 if( Tcl_GetInt(interp, argv[4], &resCount) ) return TCL_ERROR;
583 }
584 if( argc!=4 && argc!=5 ){
585 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
586 " DB FORMAT STRING ?COUNT?", 0);
587 return TCL_ERROR;
588 }
589 if( getDbPointer(interp, argv[1], &db) ) return TCL_ERROR;
590 Tcl_DStringInit(&str);
591 zSql = sqlite3_mprintf(argv[2],argv[3]);
592 if( argc==5 ){
593 rc = sqlite3_get_table(db, zSql, &aResult, 0, 0, &zErr);
594 }else{
595 rc = sqlite3_get_table(db, zSql, &aResult, &nRow, &nCol, &zErr);
596 resCount = (nRow+1)*nCol;
597 }
598 sqlite3_free(zSql);
599 sqlite3_snprintf(sizeof(zBuf), zBuf, "%d", rc);
600 Tcl_AppendElement(interp, zBuf);
601 if( rc==SQLITE_OK ){
602 if( argc==4 ){
603 sqlite3_snprintf(sizeof(zBuf), zBuf, "%d", nRow);
604 Tcl_AppendElement(interp, zBuf);
605 sqlite3_snprintf(sizeof(zBuf), zBuf, "%d", nCol);
606 Tcl_AppendElement(interp, zBuf);
607 }
608 for(i=0; i<resCount; i++){
609 Tcl_AppendElement(interp, aResult[i] ? aResult[i] : "NULL");
610 }
611 }else{
612 Tcl_AppendElement(interp, zErr);
613 }
614 sqlite3_free_table(aResult);
615 if( zErr ) sqlite3_free(zErr);
616 if( sqlite3TestErrCode(interp, db, rc) ) return TCL_ERROR;
617 return TCL_OK;
618 }
619
620 #endif /* SQLITE_OMIT_GET_TABLE */
621
622
623 /*
624 ** Usage: sqlite3_last_insert_rowid DB
625 **
626 ** Returns the integer ROWID of the most recent insert.
627 */
628 static int SQLITE_TCLAPI test_last_rowid(
629 void *NotUsed,
630 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
631 int argc, /* Number of arguments */
632 char **argv /* Text of each argument */
633 ){
634 sqlite3 *db;
635 char zBuf[30];
636
637 if( argc!=2 ){
638 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0], " DB\"", 0);
639 return TCL_ERROR;
640 }
641 if( getDbPointer(interp, argv[1], &db) ) return TCL_ERROR;
642 sqlite3_snprintf(sizeof(zBuf), zBuf, "%lld", sqlite3_last_insert_rowid(db));
643 Tcl_AppendResult(interp, zBuf, 0);
644 return SQLITE_OK;
645 }
646
647 /*
648 ** Usage: sqlite3_key DB KEY
649 **
650 ** Set the codec key.
651 */
652 static int SQLITE_TCLAPI test_key(
653 void *NotUsed,
654 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
655 int argc, /* Number of arguments */
656 char **argv /* Text of each argument */
657 ){
658 #if defined(SQLITE_HAS_CODEC) && !defined(SQLITE_OMIT_CODEC_FROM_TCL)
659 sqlite3 *db;
660 const char *zKey;
661 int nKey;
662 if( argc!=3 ){
663 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
664 " FILENAME\"", 0);
665 return TCL_ERROR;
666 }
667 if( getDbPointer(interp, argv[1], &db) ) return TCL_ERROR;
668 zKey = argv[2];
669 nKey = strlen(zKey);
670 sqlite3_key(db, zKey, nKey);
671 #endif
672 return TCL_OK;
673 }
674
675 /*
676 ** Usage: sqlite3_rekey DB KEY
677 **
678 ** Change the codec key.
679 */
680 static int SQLITE_TCLAPI test_rekey(
681 void *NotUsed,
682 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
683 int argc, /* Number of arguments */
684 char **argv /* Text of each argument */
685 ){
686 #ifdef SQLITE_HAS_CODEC
687 sqlite3 *db;
688 const char *zKey;
689 int nKey;
690 if( argc!=3 ){
691 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
692 " FILENAME\"", 0);
693 return TCL_ERROR;
694 }
695 if( getDbPointer(interp, argv[1], &db) ) return TCL_ERROR;
696 zKey = argv[2];
697 nKey = strlen(zKey);
698 sqlite3_rekey(db, zKey, nKey);
699 #endif
700 return TCL_OK;
701 }
702
703 /*
704 ** Usage: sqlite3_close DB
705 **
706 ** Closes the database opened by sqlite3_open.
707 */
708 static int SQLITE_TCLAPI sqlite_test_close(
709 void *NotUsed,
710 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
711 int argc, /* Number of arguments */
712 char **argv /* Text of each argument */
713 ){
714 sqlite3 *db;
715 int rc;
716 if( argc!=2 ){
717 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
718 " FILENAME\"", 0);
719 return TCL_ERROR;
720 }
721 if( getDbPointer(interp, argv[1], &db) ) return TCL_ERROR;
722 rc = sqlite3_close(db);
723 Tcl_SetResult(interp, (char *)t1ErrorName(rc), TCL_STATIC);
724 return TCL_OK;
725 }
726
727 /*
728 ** Usage: sqlite3_close_v2 DB
729 **
730 ** Closes the database opened by sqlite3_open.
731 */
732 static int SQLITE_TCLAPI sqlite_test_close_v2(
733 void *NotUsed,
734 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
735 int argc, /* Number of arguments */
736 char **argv /* Text of each argument */
737 ){
738 sqlite3 *db;
739 int rc;
740 if( argc!=2 ){
741 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
742 " FILENAME\"", 0);
743 return TCL_ERROR;
744 }
745 if( getDbPointer(interp, argv[1], &db) ) return TCL_ERROR;
746 rc = sqlite3_close_v2(db);
747 Tcl_SetResult(interp, (char *)t1ErrorName(rc), TCL_STATIC);
748 return TCL_OK;
749 }
750
751 /*
752 ** Implementation of the x_coalesce() function.
753 ** Return the first argument non-NULL argument.
754 */
755 static void t1_ifnullFunc(
756 sqlite3_context *context,
757 int argc,
758 sqlite3_value **argv
759 ){
760 int i;
761 for(i=0; i<argc; i++){
762 if( SQLITE_NULL!=sqlite3_value_type(argv[i]) ){
763 int n = sqlite3_value_bytes(argv[i]);
764 sqlite3_result_text(context, (char*)sqlite3_value_text(argv[i]),
765 n, SQLITE_TRANSIENT);
766 break;
767 }
768 }
769 }
770
771 /*
772 ** These are test functions. hex8() interprets its argument as
773 ** UTF8 and returns a hex encoding. hex16le() interprets its argument
774 ** as UTF16le and returns a hex encoding.
775 */
776 static void hex8Func(sqlite3_context *p, int argc, sqlite3_value **argv){
777 const unsigned char *z;
778 int i;
779 char zBuf[200];
780 z = sqlite3_value_text(argv[0]);
781 for(i=0; i<sizeof(zBuf)/2 - 2 && z[i]; i++){
782 sqlite3_snprintf(sizeof(zBuf)-i*2, &zBuf[i*2], "%02x", z[i]);
783 }
784 zBuf[i*2] = 0;
785 sqlite3_result_text(p, (char*)zBuf, -1, SQLITE_TRANSIENT);
786 }
787 #ifndef SQLITE_OMIT_UTF16
788 static void hex16Func(sqlite3_context *p, int argc, sqlite3_value **argv){
789 const unsigned short int *z;
790 int i;
791 char zBuf[400];
792 z = sqlite3_value_text16(argv[0]);
793 for(i=0; i<sizeof(zBuf)/4 - 4 && z[i]; i++){
794 sqlite3_snprintf(sizeof(zBuf)-i*4, &zBuf[i*4],"%04x", z[i]&0xff);
795 }
796 zBuf[i*4] = 0;
797 sqlite3_result_text(p, (char*)zBuf, -1, SQLITE_TRANSIENT);
798 }
799 #endif
800
801 /*
802 ** A structure into which to accumulate text.
803 */
804 struct dstr {
805 int nAlloc; /* Space allocated */
806 int nUsed; /* Space used */
807 char *z; /* The space */
808 };
809
810 /*
811 ** Append text to a dstr
812 */
813 static void dstrAppend(struct dstr *p, const char *z, int divider){
814 int n = (int)strlen(z);
815 if( p->nUsed + n + 2 > p->nAlloc ){
816 char *zNew;
817 p->nAlloc = p->nAlloc*2 + n + 200;
818 zNew = sqlite3_realloc(p->z, p->nAlloc);
819 if( zNew==0 ){
820 sqlite3_free(p->z);
821 memset(p, 0, sizeof(*p));
822 return;
823 }
824 p->z = zNew;
825 }
826 if( divider && p->nUsed>0 ){
827 p->z[p->nUsed++] = divider;
828 }
829 memcpy(&p->z[p->nUsed], z, n+1);
830 p->nUsed += n;
831 }
832
833 /*
834 ** Invoked for each callback from sqlite3ExecFunc
835 */
836 static int execFuncCallback(void *pData, int argc, char **argv, char **NotUsed){
837 struct dstr *p = (struct dstr*)pData;
838 int i;
839 for(i=0; i<argc; i++){
840 if( argv[i]==0 ){
841 dstrAppend(p, "NULL", ' ');
842 }else{
843 dstrAppend(p, argv[i], ' ');
844 }
845 }
846 return 0;
847 }
848
849 /*
850 ** Implementation of the x_sqlite_exec() function. This function takes
851 ** a single argument and attempts to execute that argument as SQL code.
852 ** This is illegal and should set the SQLITE_MISUSE flag on the database.
853 **
854 ** 2004-Jan-07: We have changed this to make it legal to call sqlite3_exec()
855 ** from within a function call.
856 **
857 ** This routine simulates the effect of having two threads attempt to
858 ** use the same database at the same time.
859 */
860 static void sqlite3ExecFunc(
861 sqlite3_context *context,
862 int argc,
863 sqlite3_value **argv
864 ){
865 struct dstr x;
866 memset(&x, 0, sizeof(x));
867 (void)sqlite3_exec((sqlite3*)sqlite3_user_data(context),
868 (char*)sqlite3_value_text(argv[0]),
869 execFuncCallback, &x, 0);
870 sqlite3_result_text(context, x.z, x.nUsed, SQLITE_TRANSIENT);
871 sqlite3_free(x.z);
872 }
873
874 /*
875 ** Implementation of tkt2213func(), a scalar function that takes exactly
876 ** one argument. It has two interesting features:
877 **
878 ** * It calls sqlite3_value_text() 3 times on the argument sqlite3_value*.
879 ** If the three pointers returned are not the same an SQL error is raised.
880 **
881 ** * Otherwise it returns a copy of the text representation of its
882 ** argument in such a way as the VDBE representation is a Mem* cell
883 ** with the MEM_Term flag clear.
884 **
885 ** Ticket #2213 can therefore be tested by evaluating the following
886 ** SQL expression:
887 **
888 ** tkt2213func(tkt2213func('a string'));
889 */
890 static void tkt2213Function(
891 sqlite3_context *context,
892 int argc,
893 sqlite3_value **argv
894 ){
895 int nText;
896 unsigned char const *zText1;
897 unsigned char const *zText2;
898 unsigned char const *zText3;
899
900 nText = sqlite3_value_bytes(argv[0]);
901 zText1 = sqlite3_value_text(argv[0]);
902 zText2 = sqlite3_value_text(argv[0]);
903 zText3 = sqlite3_value_text(argv[0]);
904
905 if( zText1!=zText2 || zText2!=zText3 ){
906 sqlite3_result_error(context, "tkt2213 is not fixed", -1);
907 }else{
908 char *zCopy = (char *)sqlite3_malloc(nText);
909 memcpy(zCopy, zText1, nText);
910 sqlite3_result_text(context, zCopy, nText, sqlite3_free);
911 }
912 }
913
914 /*
915 ** The following SQL function takes 4 arguments. The 2nd and
916 ** 4th argument must be one of these strings: 'text', 'text16',
917 ** or 'blob' corresponding to API functions
918 **
919 ** sqlite3_value_text()
920 ** sqlite3_value_text16()
921 ** sqlite3_value_blob()
922 **
923 ** The third argument is a string, either 'bytes' or 'bytes16' or 'noop',
924 ** corresponding to APIs:
925 **
926 ** sqlite3_value_bytes()
927 ** sqlite3_value_bytes16()
928 ** noop
929 **
930 ** The APIs designated by the 2nd through 4th arguments are applied
931 ** to the first argument in order. If the pointers returned by the
932 ** second and fourth are different, this routine returns 1. Otherwise,
933 ** this routine returns 0.
934 **
935 ** This function is used to test to see when returned pointers from
936 ** the _text(), _text16() and _blob() APIs become invalidated.
937 */
938 static void ptrChngFunction(
939 sqlite3_context *context,
940 int argc,
941 sqlite3_value **argv
942 ){
943 const void *p1, *p2;
944 const char *zCmd;
945 if( argc!=4 ) return;
946 zCmd = (const char*)sqlite3_value_text(argv[1]);
947 if( zCmd==0 ) return;
948 if( strcmp(zCmd,"text")==0 ){
949 p1 = (const void*)sqlite3_value_text(argv[0]);
950 #ifndef SQLITE_OMIT_UTF16
951 }else if( strcmp(zCmd, "text16")==0 ){
952 p1 = (const void*)sqlite3_value_text16(argv[0]);
953 #endif
954 }else if( strcmp(zCmd, "blob")==0 ){
955 p1 = (const void*)sqlite3_value_blob(argv[0]);
956 }else{
957 return;
958 }
959 zCmd = (const char*)sqlite3_value_text(argv[2]);
960 if( zCmd==0 ) return;
961 if( strcmp(zCmd,"bytes")==0 ){
962 sqlite3_value_bytes(argv[0]);
963 #ifndef SQLITE_OMIT_UTF16
964 }else if( strcmp(zCmd, "bytes16")==0 ){
965 sqlite3_value_bytes16(argv[0]);
966 #endif
967 }else if( strcmp(zCmd, "noop")==0 ){
968 /* do nothing */
969 }else{
970 return;
971 }
972 zCmd = (const char*)sqlite3_value_text(argv[3]);
973 if( zCmd==0 ) return;
974 if( strcmp(zCmd,"text")==0 ){
975 p2 = (const void*)sqlite3_value_text(argv[0]);
976 #ifndef SQLITE_OMIT_UTF16
977 }else if( strcmp(zCmd, "text16")==0 ){
978 p2 = (const void*)sqlite3_value_text16(argv[0]);
979 #endif
980 }else if( strcmp(zCmd, "blob")==0 ){
981 p2 = (const void*)sqlite3_value_blob(argv[0]);
982 }else{
983 return;
984 }
985 sqlite3_result_int(context, p1!=p2);
986 }
987
988 /*
989 ** This SQL function returns a different answer each time it is called, even if
990 ** the arguments are the same.
991 */
992 static void nondeterministicFunction(
993 sqlite3_context *context,
994 int argc,
995 sqlite3_value **argv
996 ){
997 static int cnt = 0;
998 sqlite3_result_int(context, cnt++);
999 }
1000
1001 /*
1002 ** This SQL function returns the integer value of its argument as a MEM_IntReal
1003 ** value.
1004 */
1005 static void intrealFunction(
1006 sqlite3_context *context,
1007 int argc,
1008 sqlite3_value **argv
1009 ){
1010 sqlite3_int64 v = sqlite3_value_int64(argv[0]);
1011 sqlite3_result_int64(context, v);
1012 sqlite3_test_control(SQLITE_TESTCTRL_RESULT_INTREAL, context);
1013 }
1014
1015 /*
1016 ** Usage: sqlite3_create_function DB
1017 **
1018 ** Call the sqlite3_create_function API on the given database in order
1019 ** to create a function named "x_coalesce". This function does the same thing
1020 ** as the "coalesce" function. This function also registers an SQL function
1021 ** named "x_sqlite_exec" that invokes sqlite3_exec(). Invoking sqlite3_exec()
1022 ** in this way is illegal recursion and should raise an SQLITE_MISUSE error.
1023 ** The effect is similar to trying to use the same database connection from
1024 ** two threads at the same time.
1025 **
1026 ** The original motivation for this routine was to be able to call the
1027 ** sqlite3_create_function function while a query is in progress in order
1028 ** to test the SQLITE_MISUSE detection logic.
1029 */
1030 static int SQLITE_TCLAPI test_create_function(
1031 void *NotUsed,
1032 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
1033 int argc, /* Number of arguments */
1034 char **argv /* Text of each argument */
1035 ){
1036 int rc;
1037 sqlite3 *db;
1038
1039 if( argc!=2 ){
1040 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
1041 " DB\"", 0);
1042 return TCL_ERROR;
1043 }
1044 if( getDbPointer(interp, argv[1], &db) ) return TCL_ERROR;
1045 rc = sqlite3_create_function(db, "x_coalesce", -1, SQLITE_UTF8, 0,
1046 t1_ifnullFunc, 0, 0);
1047 if( rc==SQLITE_OK ){
1048 rc = sqlite3_create_function(db, "hex8", 1, SQLITE_UTF8 | SQLITE_DETERMINISTIC,
1049 0, hex8Func, 0, 0);
1050 }
1051 #ifndef SQLITE_OMIT_UTF16
1052 if( rc==SQLITE_OK ){
1053 rc = sqlite3_create_function(db, "hex16", 1, SQLITE_UTF16 | SQLITE_DETERMINISTIC,
1054 0, hex16Func, 0, 0);
1055 }
1056 #endif
1057 if( rc==SQLITE_OK ){
1058 rc = sqlite3_create_function(db, "tkt2213func", 1, SQLITE_ANY, 0,
1059 tkt2213Function, 0, 0);
1060 }
1061 if( rc==SQLITE_OK ){
1062 rc = sqlite3_create_function(db, "pointer_change", 4, SQLITE_ANY, 0,
1063 ptrChngFunction, 0, 0);
1064 }
1065
1066 /* Functions counter1() and counter2() have the same implementation - they
1067 ** both return an ascending integer with each call. But counter1() is marked
1068 ** as non-deterministic and counter2() is marked as deterministic.
1069 */
1070 if( rc==SQLITE_OK ){
1071 rc = sqlite3_create_function(db, "counter1", -1, SQLITE_UTF8,
1072 0, nondeterministicFunction, 0, 0);
1073 }
1074 if( rc==SQLITE_OK ){
1075 rc = sqlite3_create_function(db, "counter2", -1, SQLITE_UTF8|SQLITE_DETERMINISTIC,
1076 0, nondeterministicFunction, 0, 0);
1077 }
1078
1079 /* The intreal() function converts its argument to an integer and returns
1080 ** it as a MEM_IntReal.
1081 */
1082 if( rc==SQLITE_OK ){
1083 rc = sqlite3_create_function(db, "intreal", 1, SQLITE_UTF8,
1084 0, intrealFunction, 0, 0);
1085 }
1086
1087 #ifndef SQLITE_OMIT_UTF16
1088 /* Use the sqlite3_create_function16() API here. Mainly for fun, but also
1089 ** because it is not tested anywhere else. */
1090 if( rc==SQLITE_OK ){
1091 const void *zUtf16;
1092 sqlite3_value *pVal;
1093 sqlite3_mutex_enter(db->mutex);
1094 pVal = sqlite3ValueNew(db);
1095 sqlite3ValueSetStr(pVal, -1, "x_sqlite_exec", SQLITE_UTF8, SQLITE_STATIC);
1096 zUtf16 = sqlite3ValueText(pVal, SQLITE_UTF16NATIVE);
1097 if( db->mallocFailed ){
1098 rc = SQLITE_NOMEM;
1099 }else{
1100 rc = sqlite3_create_function16(db, zUtf16,
1101 1, SQLITE_UTF16, db, sqlite3ExecFunc, 0, 0);
1102 }
1103 sqlite3ValueFree(pVal);
1104 sqlite3_mutex_leave(db->mutex);
1105 }
1106 #endif
1107
1108 if( sqlite3TestErrCode(interp, db, rc) ) return TCL_ERROR;
1109 Tcl_SetResult(interp, (char *)t1ErrorName(rc), 0);
1110 return TCL_OK;
1111 }
1112
1113 /*
1114 ** Usage: sqlite3_drop_modules DB ?NAME ...?
1115 **
1116 ** Invoke the sqlite3_drop_modules(D,L) interface on database
1117 ** connection DB, in order to drop all modules except those named in
1118 ** the argument.
1119 */
1120 static int SQLITE_TCLAPI test_drop_modules(
1121 void *NotUsed,
1122 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
1123 int argc, /* Number of arguments */
1124 char **argv /* Text of each argument */
1125 ){
1126 sqlite3 *db;
1127
1128 if( argc<2 ){
1129 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
1130 " DB\"", 0);
1131 return TCL_ERROR;
1132 }
1133 if( getDbPointer(interp, argv[1], &db) ) return TCL_ERROR;
1134 #ifndef SQLITE_OMIT_VIRTUALTABLE
1135 sqlite3_drop_modules(db, argc>2 ? (const char**)(argv+2) : 0);
1136 #endif
1137 return TCL_OK;
1138 }
1139
1140 /*
1141 ** Routines to implement the x_count() aggregate function.
1142 **
1143 ** x_count() counts the number of non-null arguments. But there are
1144 ** some twists for testing purposes.
1145 **
1146 ** If the argument to x_count() is 40 then a UTF-8 error is reported
1147 ** on the step function. If x_count(41) is seen, then a UTF-16 error
1148 ** is reported on the step function. If the total count is 42, then
1149 ** a UTF-8 error is reported on the finalize function.
1150 */
1151 typedef struct t1CountCtx t1CountCtx;
1152 struct t1CountCtx {
1153 int n;
1154 };
1155 static void t1CountStep(
1156 sqlite3_context *context,
1157 int argc,
1158 sqlite3_value **argv
1159 ){
1160 t1CountCtx *p;
1161 p = sqlite3_aggregate_context(context, sizeof(*p));
1162 if( (argc==0 || SQLITE_NULL!=sqlite3_value_type(argv[0]) ) && p ){
1163 p->n++;
1164 }
1165 if( argc>0 ){
1166 int v = sqlite3_value_int(argv[0]);
1167 if( v==40 ){
1168 sqlite3_result_error(context, "value of 40 handed to x_count", -1);
1169 #ifndef SQLITE_OMIT_UTF16
1170 }else if( v==41 ){
1171 const char zUtf16ErrMsg[] = { 0, 0x61, 0, 0x62, 0, 0x63, 0, 0, 0};
1172 sqlite3_result_error16(context, &zUtf16ErrMsg[1-SQLITE_BIGENDIAN], -1);
1173 #endif
1174 }
1175 }
1176 }
1177 static void t1CountFinalize(sqlite3_context *context){
1178 t1CountCtx *p;
1179 p = sqlite3_aggregate_context(context, sizeof(*p));
1180 if( p ){
1181 if( p->n==42 ){
1182 sqlite3_result_error(context, "x_count totals to 42", -1);
1183 }else{
1184 sqlite3_result_int(context, p ? p->n : 0);
1185 }
1186 }
1187 }
1188
1189 #ifndef SQLITE_OMIT_DEPRECATED
1190 static void legacyCountStep(
1191 sqlite3_context *context,
1192 int argc,
1193 sqlite3_value **argv
1194 ){
1195 /* no-op */
1196 }
1197
1198 static void legacyCountFinalize(sqlite3_context *context){
1199 sqlite3_result_int(context, sqlite3_aggregate_count(context));
1200 }
1201 #endif
1202
1203 /*
1204 ** Usage: sqlite3_create_aggregate DB
1205 **
1206 ** Call the sqlite3_create_function API on the given database in order
1207 ** to create a function named "x_count". This function is similar
1208 ** to the built-in count() function, with a few special quirks
1209 ** for testing the sqlite3_result_error() APIs.
1210 **
1211 ** The original motivation for this routine was to be able to call the
1212 ** sqlite3_create_aggregate function while a query is in progress in order
1213 ** to test the SQLITE_MISUSE detection logic. See misuse.test.
1214 **
1215 ** This routine was later extended to test the use of sqlite3_result_error()
1216 ** within aggregate functions.
1217 **
1218 ** Later: It is now also extended to register the aggregate function
1219 ** "legacy_count()" with the supplied database handle. This is used
1220 ** to test the deprecated sqlite3_aggregate_count() API.
1221 */
1222 static int SQLITE_TCLAPI test_create_aggregate(
1223 void *NotUsed,
1224 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
1225 int argc, /* Number of arguments */
1226 char **argv /* Text of each argument */
1227 ){
1228 sqlite3 *db;
1229 int rc;
1230 if( argc!=2 ){
1231 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
1232 " FILENAME\"", 0);
1233 return TCL_ERROR;
1234 }
1235 if( getDbPointer(interp, argv[1], &db) ) return TCL_ERROR;
1236 rc = sqlite3_create_function(db, "x_count", 0, SQLITE_UTF8, 0, 0,
1237 t1CountStep,t1CountFinalize);
1238 if( rc==SQLITE_OK ){
1239 rc = sqlite3_create_function(db, "x_count", 1, SQLITE_UTF8, 0, 0,
1240 t1CountStep,t1CountFinalize);
1241 }
1242 #ifndef SQLITE_OMIT_DEPRECATED
1243 if( rc==SQLITE_OK ){
1244 rc = sqlite3_create_function(db, "legacy_count", 0, SQLITE_ANY, 0, 0,
1245 legacyCountStep, legacyCountFinalize
1246 );
1247 }
1248 #endif
1249 if( sqlite3TestErrCode(interp, db, rc) ) return TCL_ERROR;
1250 Tcl_SetResult(interp, (char *)t1ErrorName(rc), 0);
1251 return TCL_OK;
1252 }
1253
1254
1255 /*
1256 ** Usage: printf TEXT
1257 **
1258 ** Send output to printf. Use this rather than puts to merge the output
1259 ** in the correct sequence with debugging printfs inserted into C code.
1260 ** Puts uses a separate buffer and debugging statements will be out of
1261 ** sequence if it is used.
1262 */
1263 static int SQLITE_TCLAPI test_printf(
1264 void *NotUsed,
1265 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
1266 int argc, /* Number of arguments */
1267 char **argv /* Text of each argument */
1268 ){
1269 if( argc!=2 ){
1270 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
1271 " TEXT\"", 0);
1272 return TCL_ERROR;
1273 }
1274 printf("%s\n", argv[1]);
1275 return TCL_OK;
1276 }
1277
1278
1279
1280 /*
1281 ** Usage: sqlite3_mprintf_int FORMAT INTEGER INTEGER INTEGER
1282 **
1283 ** Call mprintf with three integer arguments
1284 */
1285 static int SQLITE_TCLAPI sqlite3_mprintf_int(
1286 void *NotUsed,
1287 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
1288 int argc, /* Number of arguments */
1289 char **argv /* Text of each argument */
1290 ){
1291 int a[3], i;
1292 char *z;
1293 if( argc!=5 ){
1294 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
1295 " FORMAT INT INT INT\"", 0);
1296 return TCL_ERROR;
1297 }
1298 for(i=2; i<5; i++){
1299 if( Tcl_GetInt(interp, argv[i], &a[i-2]) ) return TCL_ERROR;
1300 }
1301 z = sqlite3_mprintf(argv[1], a[0], a[1], a[2]);
1302 Tcl_AppendResult(interp, z, 0);
1303 sqlite3_free(z);
1304 return TCL_OK;
1305 }
1306
1307 /*
1308 ** Usage: sqlite3_mprintf_int64 FORMAT INTEGER INTEGER INTEGER
1309 **
1310 ** Call mprintf with three 64-bit integer arguments
1311 */
1312 static int SQLITE_TCLAPI sqlite3_mprintf_int64(
1313 void *NotUsed,
1314 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
1315 int argc, /* Number of arguments */
1316 char **argv /* Text of each argument */
1317 ){
1318 int i;
1319 sqlite_int64 a[3];
1320 char *z;
1321 if( argc!=5 ){
1322 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
1323 " FORMAT INT INT INT\"", 0);
1324 return TCL_ERROR;
1325 }
1326 for(i=2; i<5; i++){
1327 if( sqlite3Atoi64(argv[i], &a[i-2], sqlite3Strlen30(argv[i]), SQLITE_UTF8) ){
1328 Tcl_AppendResult(interp, "argument is not a valid 64-bit integer", 0);
1329 return TCL_ERROR;
1330 }
1331 }
1332 z = sqlite3_mprintf(argv[1], a[0], a[1], a[2]);
1333 Tcl_AppendResult(interp, z, 0);
1334 sqlite3_free(z);
1335 return TCL_OK;
1336 }
1337
1338 /*
1339 ** Usage: sqlite3_mprintf_long FORMAT INTEGER INTEGER INTEGER
1340 **
1341 ** Call mprintf with three long integer arguments. This might be the
1342 ** same as sqlite3_mprintf_int or sqlite3_mprintf_int64, depending on
1343 ** platform.
1344 */
1345 static int SQLITE_TCLAPI sqlite3_mprintf_long(
1346 void *NotUsed,
1347 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
1348 int argc, /* Number of arguments */
1349 char **argv /* Text of each argument */
1350 ){
1351 int i;
1352 long int a[3];
1353 int b[3];
1354 char *z;
1355 if( argc!=5 ){
1356 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
1357 " FORMAT INT INT INT\"", 0);
1358 return TCL_ERROR;
1359 }
1360 for(i=2; i<5; i++){
1361 if( Tcl_GetInt(interp, argv[i], &b[i-2]) ) return TCL_ERROR;
1362 a[i-2] = (long int)b[i-2];
1363 a[i-2] &= (((u64)1)<<(sizeof(int)*8))-1;
1364 }
1365 z = sqlite3_mprintf(argv[1], a[0], a[1], a[2]);
1366 Tcl_AppendResult(interp, z, 0);
1367 sqlite3_free(z);
1368 return TCL_OK;
1369 }
1370
1371 /*
1372 ** Usage: sqlite3_mprintf_str FORMAT INTEGER INTEGER STRING
1373 **
1374 ** Call mprintf with two integer arguments and one string argument
1375 */
1376 static int SQLITE_TCLAPI sqlite3_mprintf_str(
1377 void *NotUsed,
1378 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
1379 int argc, /* Number of arguments */
1380 char **argv /* Text of each argument */
1381 ){
1382 int a[3], i;
1383 char *z;
1384 if( argc<4 || argc>5 ){
1385 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
1386 " FORMAT INT INT ?STRING?\"", 0);
1387 return TCL_ERROR;
1388 }
1389 for(i=2; i<4; i++){
1390 if( Tcl_GetInt(interp, argv[i], &a[i-2]) ) return TCL_ERROR;
1391 }
1392 z = sqlite3_mprintf(argv[1], a[0], a[1], argc>4 ? argv[4] : NULL);
1393 Tcl_AppendResult(interp, z, 0);
1394 sqlite3_free(z);
1395 return TCL_OK;
1396 }
1397
1398 /*
1399 ** Usage: sqlite3_snprintf_str INTEGER FORMAT INTEGER INTEGER STRING
1400 **
1401 ** Call mprintf with two integer arguments and one string argument
1402 */
1403 static int SQLITE_TCLAPI sqlite3_snprintf_str(
1404 void *NotUsed,
1405 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
1406 int argc, /* Number of arguments */
1407 char **argv /* Text of each argument */
1408 ){
1409 int a[3], i;
1410 int n;
1411 char *z;
1412 if( argc<5 || argc>6 ){
1413 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
1414 " INT FORMAT INT INT ?STRING?\"", 0);
1415 return TCL_ERROR;
1416 }
1417 if( Tcl_GetInt(interp, argv[1], &n) ) return TCL_ERROR;
1418 if( n<0 ){
1419 Tcl_AppendResult(interp, "N must be non-negative", 0);
1420 return TCL_ERROR;
1421 }
1422 for(i=3; i<5; i++){
1423 if( Tcl_GetInt(interp, argv[i], &a[i-3]) ) return TCL_ERROR;
1424 }
1425 z = sqlite3_malloc( n+1 );
1426 sqlite3_snprintf(n, z, argv[2], a[0], a[1], argc>4 ? argv[5] : NULL);
1427 Tcl_AppendResult(interp, z, 0);
1428 sqlite3_free(z);
1429 return TCL_OK;
1430 }
1431
1432 /*
1433 ** Usage: sqlite3_mprintf_double FORMAT INTEGER INTEGER DOUBLE
1434 **
1435 ** Call mprintf with two integer arguments and one double argument
1436 */
1437 static int SQLITE_TCLAPI sqlite3_mprintf_double(
1438 void *NotUsed,
1439 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
1440 int argc, /* Number of arguments */
1441 char **argv /* Text of each argument */
1442 ){
1443 int a[3], i;
1444 double r;
1445 char *z;
1446 if( argc!=5 ){
1447 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
1448 " FORMAT INT INT DOUBLE\"", 0);
1449 return TCL_ERROR;
1450 }
1451 for(i=2; i<4; i++){
1452 if( Tcl_GetInt(interp, argv[i], &a[i-2]) ) return TCL_ERROR;
1453 }
1454 if( Tcl_GetDouble(interp, argv[4], &r) ) return TCL_ERROR;
1455 z = sqlite3_mprintf(argv[1], a[0], a[1], r);
1456 Tcl_AppendResult(interp, z, 0);
1457 sqlite3_free(z);
1458 return TCL_OK;
1459 }
1460
1461 /*
1462 ** Usage: sqlite3_mprintf_scaled FORMAT DOUBLE DOUBLE
1463 **
1464 ** Call mprintf with a single double argument which is the product of the
1465 ** two arguments given above. This is used to generate overflow and underflow
1466 ** doubles to test that they are converted properly.
1467 */
1468 static int SQLITE_TCLAPI sqlite3_mprintf_scaled(
1469 void *NotUsed,
1470 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
1471 int argc, /* Number of arguments */
1472 char **argv /* Text of each argument */
1473 ){
1474 int i;
1475 double r[2];
1476 char *z;
1477 if( argc!=4 ){
1478 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
1479 " FORMAT DOUBLE DOUBLE\"", 0);
1480 return TCL_ERROR;
1481 }
1482 for(i=2; i<4; i++){
1483 if( Tcl_GetDouble(interp, argv[i], &r[i-2]) ) return TCL_ERROR;
1484 }
1485 z = sqlite3_mprintf(argv[1], r[0]*r[1]);
1486 Tcl_AppendResult(interp, z, 0);
1487 sqlite3_free(z);
1488 return TCL_OK;
1489 }
1490
1491 /*
1492 ** Usage: sqlite3_mprintf_stronly FORMAT STRING
1493 **
1494 ** Call mprintf with a single double argument which is the product of the
1495 ** two arguments given above. This is used to generate overflow and underflow
1496 ** doubles to test that they are converted properly.
1497 */
1498 static int SQLITE_TCLAPI sqlite3_mprintf_stronly(
1499 void *NotUsed,
1500 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
1501 int argc, /* Number of arguments */
1502 char **argv /* Text of each argument */
1503 ){
1504 char *z;
1505 if( argc!=3 ){
1506 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
1507 " FORMAT STRING\"", 0);
1508 return TCL_ERROR;
1509 }
1510 z = sqlite3_mprintf(argv[1], argv[2]);
1511 Tcl_AppendResult(interp, z, 0);
1512 sqlite3_free(z);
1513 return TCL_OK;
1514 }
1515
1516 /*
1517 ** Usage: sqlite3_mprintf_hexdouble FORMAT HEX
1518 **
1519 ** Call mprintf with a single double argument which is derived from the
1520 ** hexadecimal encoding of an IEEE double.
1521 */
1522 static int SQLITE_TCLAPI sqlite3_mprintf_hexdouble(
1523 void *NotUsed,
1524 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
1525 int argc, /* Number of arguments */
1526 char **argv /* Text of each argument */
1527 ){
1528 char *z;
1529 double r;
1530 unsigned int x1, x2;
1531 sqlite_uint64 d;
1532 if( argc!=3 ){
1533 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
1534 " FORMAT STRING\"", 0);
1535 return TCL_ERROR;
1536 }
1537 if( sscanf(argv[2], "%08x%08x", &x2, &x1)!=2 ){
1538 Tcl_AppendResult(interp, "2nd argument should be 16-characters of hex", 0);
1539 return TCL_ERROR;
1540 }
1541 d = x2;
1542 d = (d<<32) + x1;
1543 memcpy(&r, &d, sizeof(r));
1544 z = sqlite3_mprintf(argv[1], r);
1545 Tcl_AppendResult(interp, z, 0);
1546 sqlite3_free(z);
1547 return TCL_OK;
1548 }
1549
1550 /*
1551 ** Usage: sqlite3_enable_shared_cache ?BOOLEAN?
1552 **
1553 */
1554 #if !defined(SQLITE_OMIT_SHARED_CACHE)
1555 static int SQLITE_TCLAPI test_enable_shared(
1556 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
1557 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
1558 int objc, /* Number of arguments */
1559 Tcl_Obj *CONST objv[] /* Command arguments */
1560 ){
1561 int rc;
1562 int enable;
1563 int ret = 0;
1564
1565 if( objc!=2 && objc!=1 ){
1566 Tcl_WrongNumArgs(interp, 1, objv, "?BOOLEAN?");
1567 return TCL_ERROR;
1568 }
1569 ret = sqlite3GlobalConfig.sharedCacheEnabled;
1570
1571 if( objc==2 ){
1572 if( Tcl_GetBooleanFromObj(interp, objv[1], &enable) ){
1573 return TCL_ERROR;
1574 }
1575 rc = sqlite3_enable_shared_cache(enable);
1576 if( rc!=SQLITE_OK ){
1577 Tcl_SetResult(interp, (char *)sqlite3ErrStr(rc), TCL_STATIC);
1578 return TCL_ERROR;
1579 }
1580 }
1581 Tcl_SetObjResult(interp, Tcl_NewBooleanObj(ret));
1582 return TCL_OK;
1583 }
1584 #endif
1585
1586
1587
1588 /*
1589 ** Usage: sqlite3_extended_result_codes DB BOOLEAN
1590 **
1591 */
1592 static int SQLITE_TCLAPI test_extended_result_codes(
1593 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
1594 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
1595 int objc, /* Number of arguments */
1596 Tcl_Obj *CONST objv[] /* Command arguments */
1597 ){
1598 int enable;
1599 sqlite3 *db;
1600
1601 if( objc!=3 ){
1602 Tcl_WrongNumArgs(interp, 1, objv, "DB BOOLEAN");
1603 return TCL_ERROR;
1604 }
1605 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
1606 if( Tcl_GetBooleanFromObj(interp, objv[2], &enable) ) return TCL_ERROR;
1607 sqlite3_extended_result_codes(db, enable);
1608 return TCL_OK;
1609 }
1610
1611 /*
1612 ** Usage: sqlite3_libversion_number
1613 **
1614 */
1615 static int SQLITE_TCLAPI test_libversion_number(
1616 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
1617 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
1618 int objc, /* Number of arguments */
1619 Tcl_Obj *CONST objv[] /* Command arguments */
1620 ){
1621 Tcl_SetObjResult(interp, Tcl_NewIntObj(sqlite3_libversion_number()));
1622 return TCL_OK;
1623 }
1624
1625 /*
1626 ** Usage: sqlite3_table_column_metadata DB dbname tblname colname
1627 **
1628 */
1629 static int SQLITE_TCLAPI test_table_column_metadata(
1630 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
1631 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
1632 int objc, /* Number of arguments */
1633 Tcl_Obj *CONST objv[] /* Command arguments */
1634 ){
1635 sqlite3 *db;
1636 const char *zDb;
1637 const char *zTbl;
1638 const char *zCol;
1639 int rc;
1640 Tcl_Obj *pRet;
1641
1642 const char *zDatatype;
1643 const char *zCollseq;
1644 int notnull;
1645 int primarykey;
1646 int autoincrement;
1647
1648 if( objc!=5 && objc!=4 ){
1649 Tcl_WrongNumArgs(interp, 1, objv, "DB dbname tblname colname");
1650 return TCL_ERROR;
1651 }
1652 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
1653 zDb = Tcl_GetString(objv[2]);
1654 zTbl = Tcl_GetString(objv[3]);
1655 zCol = objc==5 ? Tcl_GetString(objv[4]) : 0;
1656
1657 if( strlen(zDb)==0 ) zDb = 0;
1658
1659 rc = sqlite3_table_column_metadata(db, zDb, zTbl, zCol,
1660 &zDatatype, &zCollseq, &notnull, &primarykey, &autoincrement);
1661
1662 if( rc!=SQLITE_OK ){
1663 Tcl_AppendResult(interp, sqlite3_errmsg(db), 0);
1664 return TCL_ERROR;
1665 }
1666
1667 pRet = Tcl_NewObj();
1668 Tcl_ListObjAppendElement(0, pRet, Tcl_NewStringObj(zDatatype, -1));
1669 Tcl_ListObjAppendElement(0, pRet, Tcl_NewStringObj(zCollseq, -1));
1670 Tcl_ListObjAppendElement(0, pRet, Tcl_NewIntObj(notnull));
1671 Tcl_ListObjAppendElement(0, pRet, Tcl_NewIntObj(primarykey));
1672 Tcl_ListObjAppendElement(0, pRet, Tcl_NewIntObj(autoincrement));
1673 Tcl_SetObjResult(interp, pRet);
1674
1675 return TCL_OK;
1676 }
1677
1678 #ifndef SQLITE_OMIT_INCRBLOB
1679
1680 static int SQLITE_TCLAPI blobHandleFromObj(
1681 Tcl_Interp *interp,
1682 Tcl_Obj *pObj,
1683 sqlite3_blob **ppBlob
1684 ){
1685 char *z;
1686 int n;
1687
1688 z = Tcl_GetStringFromObj(pObj, &n);
1689 if( n==0 ){
1690 *ppBlob = 0;
1691 }else{
1692 int notUsed;
1693 Tcl_Channel channel;
1694 ClientData instanceData;
1695
1696 channel = Tcl_GetChannel(interp, z, &notUsed);
1697 if( !channel ) return TCL_ERROR;
1698
1699 Tcl_Flush(channel);
1700 Tcl_Seek(channel, 0, SEEK_SET);
1701
1702 instanceData = Tcl_GetChannelInstanceData(channel);
1703 *ppBlob = *((sqlite3_blob **)instanceData);
1704 }
1705
1706 return TCL_OK;
1707 }
1708
1709 static int SQLITE_TCLAPI test_blob_reopen(
1710 ClientData clientData, /* Not used */
1711 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
1712 int objc, /* Number of arguments */
1713 Tcl_Obj *CONST objv[] /* Command arguments */
1714 ){
1715 Tcl_WideInt iRowid;
1716 sqlite3_blob *pBlob;
1717 int rc;
1718
1719 if( objc!=3 ){
1720 Tcl_WrongNumArgs(interp, 1, objv, "CHANNEL ROWID");
1721 return TCL_ERROR;
1722 }
1723
1724 if( blobHandleFromObj(interp, objv[1], &pBlob) ) return TCL_ERROR;
1725 if( Tcl_GetWideIntFromObj(interp, objv[2], &iRowid) ) return TCL_ERROR;
1726
1727 rc = sqlite3_blob_reopen(pBlob, iRowid);
1728 if( rc!=SQLITE_OK ){
1729 Tcl_SetResult(interp, (char *)sqlite3ErrName(rc), TCL_VOLATILE);
1730 }
1731
1732 return (rc==SQLITE_OK ? TCL_OK : TCL_ERROR);
1733 }
1734
1735 #endif
1736
1737 /*
1738 ** Usage: sqlite3_create_collation_v2 DB-HANDLE NAME CMP-PROC DEL-PROC
1739 **
1740 ** This Tcl proc is used for testing the experimental
1741 ** sqlite3_create_collation_v2() interface.
1742 */
1743 struct TestCollationX {
1744 Tcl_Interp *interp;
1745 Tcl_Obj *pCmp;
1746 Tcl_Obj *pDel;
1747 };
1748 typedef struct TestCollationX TestCollationX;
1749 static void testCreateCollationDel(void *pCtx){
1750 TestCollationX *p = (TestCollationX *)pCtx;
1751
1752 int rc = Tcl_EvalObjEx(p->interp, p->pDel, TCL_EVAL_DIRECT|TCL_EVAL_GLOBAL);
1753 if( rc!=TCL_OK ){
1754 Tcl_BackgroundError(p->interp);
1755 }
1756
1757 Tcl_DecrRefCount(p->pCmp);
1758 Tcl_DecrRefCount(p->pDel);
1759 sqlite3_free((void *)p);
1760 }
1761 static int testCreateCollationCmp(
1762 void *pCtx,
1763 int nLeft,
1764 const void *zLeft,
1765 int nRight,
1766 const void *zRight
1767 ){
1768 TestCollationX *p = (TestCollationX *)pCtx;
1769 Tcl_Obj *pScript = Tcl_DuplicateObj(p->pCmp);
1770 int iRes = 0;
1771
1772 Tcl_IncrRefCount(pScript);
1773 Tcl_ListObjAppendElement(0, pScript, Tcl_NewStringObj((char *)zLeft, nLeft));
1774 Tcl_ListObjAppendElement(0, pScript, Tcl_NewStringObj((char *)zRight,nRight));
1775
1776 if( TCL_OK!=Tcl_EvalObjEx(p->interp, pScript, TCL_EVAL_DIRECT|TCL_EVAL_GLOBAL)
1777 || TCL_OK!=Tcl_GetIntFromObj(p->interp, Tcl_GetObjResult(p->interp), &iRes)
1778 ){
1779 Tcl_BackgroundError(p->interp);
1780 }
1781 Tcl_DecrRefCount(pScript);
1782
1783 return iRes;
1784 }
1785 static int SQLITE_TCLAPI test_create_collation_v2(
1786 ClientData clientData, /* Not used */
1787 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
1788 int objc, /* Number of arguments */
1789 Tcl_Obj *CONST objv[] /* Command arguments */
1790 ){
1791 TestCollationX *p;
1792 sqlite3 *db;
1793 int rc;
1794
1795 if( objc!=5 ){
1796 Tcl_WrongNumArgs(interp, 1, objv, "DB-HANDLE NAME CMP-PROC DEL-PROC");
1797 return TCL_ERROR;
1798 }
1799 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
1800
1801 p = (TestCollationX *)sqlite3_malloc(sizeof(TestCollationX));
1802 p->pCmp = objv[3];
1803 p->pDel = objv[4];
1804 p->interp = interp;
1805 Tcl_IncrRefCount(p->pCmp);
1806 Tcl_IncrRefCount(p->pDel);
1807
1808 rc = sqlite3_create_collation_v2(db, Tcl_GetString(objv[2]), 16,
1809 (void *)p, testCreateCollationCmp, testCreateCollationDel
1810 );
1811 if( rc!=SQLITE_MISUSE ){
1812 Tcl_AppendResult(interp, "sqlite3_create_collate_v2() failed to detect "
1813 "an invalid encoding", (char*)0);
1814 return TCL_ERROR;
1815 }
1816 rc = sqlite3_create_collation_v2(db, Tcl_GetString(objv[2]), SQLITE_UTF8,
1817 (void *)p, testCreateCollationCmp, testCreateCollationDel
1818 );
1819 return TCL_OK;
1820 }
1821
1822 /*
1823 ** USAGE: sqlite3_create_function_v2 DB NAME NARG ENC ?SWITCHES?
1824 **
1825 ** Available switches are:
1826 **
1827 ** -func SCRIPT
1828 ** -step SCRIPT
1829 ** -final SCRIPT
1830 ** -destroy SCRIPT
1831 */
1832 typedef struct CreateFunctionV2 CreateFunctionV2;
1833 struct CreateFunctionV2 {
1834 Tcl_Interp *interp;
1835 Tcl_Obj *pFunc; /* Script for function invocation */
1836 Tcl_Obj *pStep; /* Script for agg. step invocation */
1837 Tcl_Obj *pFinal; /* Script for agg. finalization invocation */
1838 Tcl_Obj *pDestroy; /* Destructor script */
1839 };
1840 static void cf2Func(sqlite3_context *ctx, int nArg, sqlite3_value **aArg){
1841 }
1842 static void cf2Step(sqlite3_context *ctx, int nArg, sqlite3_value **aArg){
1843 }
1844 static void cf2Final(sqlite3_context *ctx){
1845 }
1846 static void cf2Destroy(void *pUser){
1847 CreateFunctionV2 *p = (CreateFunctionV2 *)pUser;
1848
1849 if( p->interp && p->pDestroy ){
1850 int rc = Tcl_EvalObjEx(p->interp, p->pDestroy, 0);
1851 if( rc!=TCL_OK ) Tcl_BackgroundError(p->interp);
1852 }
1853
1854 if( p->pFunc ) Tcl_DecrRefCount(p->pFunc);
1855 if( p->pStep ) Tcl_DecrRefCount(p->pStep);
1856 if( p->pFinal ) Tcl_DecrRefCount(p->pFinal);
1857 if( p->pDestroy ) Tcl_DecrRefCount(p->pDestroy);
1858 sqlite3_free(p);
1859 }
1860 static int SQLITE_TCLAPI test_create_function_v2(
1861 ClientData clientData, /* Not used */
1862 Tcl_Interp *interp, /* The invoking TCL interpreter */
1863 int objc, /* Number of arguments */
1864 Tcl_Obj *CONST objv[] /* Command arguments */
1865 ){
1866 sqlite3 *db;
1867 const char *zFunc;
1868 int nArg;
1869 int enc;
1870 CreateFunctionV2 *p;
1871 int i;
1872 int rc;
1873
1874 struct EncTable {
1875 const char *zEnc;
1876 int enc;
1877 } aEnc[] = {
1878 {"utf8", SQLITE_UTF8 },
1879 {"utf16", SQLITE_UTF16 },
1880 {"utf16le", SQLITE_UTF16LE },
1881 {"utf16be", SQLITE_UTF16BE },
1882 {"any", SQLITE_ANY },
1883 {"0", 0 }
1884 };
1885
1886 if( objc<5 || (objc%2)==0 ){
1887 Tcl_WrongNumArgs(interp, 1, objv, "DB NAME NARG ENC SWITCHES...");
1888 return TCL_ERROR;
1889 }
1890
1891 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
1892 zFunc = Tcl_GetString(objv[2]);
1893 if( Tcl_GetIntFromObj(interp, objv[3], &nArg) ) return TCL_ERROR;
1894 if( Tcl_GetIndexFromObjStruct(interp, objv[4], aEnc, sizeof(aEnc[0]),
1895 "encoding", 0, &enc)
1896 ){
1897 return TCL_ERROR;
1898 }
1899 enc = aEnc[enc].enc;
1900
1901 p = sqlite3_malloc(sizeof(CreateFunctionV2));
1902 assert( p );
1903 memset(p, 0, sizeof(CreateFunctionV2));
1904 p->interp = interp;
1905
1906 for(i=5; i<objc; i+=2){
1907 int iSwitch;
1908 const char *azSwitch[] = {"-func", "-step", "-final", "-destroy", 0};
1909 if( Tcl_GetIndexFromObj(interp, objv[i], azSwitch, "switch", 0, &iSwitch) ){
1910 sqlite3_free(p);
1911 return TCL_ERROR;
1912 }
1913
1914 switch( iSwitch ){
1915 case 0: p->pFunc = objv[i+1]; break;
1916 case 1: p->pStep = objv[i+1]; break;
1917 case 2: p->pFinal = objv[i+1]; break;
1918 case 3: p->pDestroy = objv[i+1]; break;
1919 }
1920 }
1921 if( p->pFunc ) p->pFunc = Tcl_DuplicateObj(p->pFunc);
1922 if( p->pStep ) p->pStep = Tcl_DuplicateObj(p->pStep);
1923 if( p->pFinal ) p->pFinal = Tcl_DuplicateObj(p->pFinal);
1924 if( p->pDestroy ) p->pDestroy = Tcl_DuplicateObj(p->pDestroy);
1925
1926 if( p->pFunc ) Tcl_IncrRefCount(p->pFunc);
1927 if( p->pStep ) Tcl_IncrRefCount(p->pStep);
1928 if( p->pFinal ) Tcl_IncrRefCount(p->pFinal);
1929 if( p->pDestroy ) Tcl_IncrRefCount(p->pDestroy);
1930
1931 rc = sqlite3_create_function_v2(db, zFunc, nArg, enc, (void *)p,
1932 (p->pFunc ? cf2Func : 0),
1933 (p->pStep ? cf2Step : 0),
1934 (p->pFinal ? cf2Final : 0),
1935 cf2Destroy
1936 );
1937 if( rc!=SQLITE_OK ){
1938 Tcl_ResetResult(interp);
1939 Tcl_AppendResult(interp, sqlite3ErrName(rc), 0);
1940 return TCL_ERROR;
1941 }
1942 return TCL_OK;
1943 }
1944
1945 /*
1946 ** Usage: sqlite3_load_extension DB-HANDLE FILE ?PROC?
1947 */
1948 static int SQLITE_TCLAPI test_load_extension(
1949 ClientData clientData, /* Not used */
1950 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
1951 int objc, /* Number of arguments */
1952 Tcl_Obj *CONST objv[] /* Command arguments */
1953 ){
1954 Tcl_CmdInfo cmdInfo;
1955 sqlite3 *db;
1956 int rc;
1957 char *zDb;
1958 char *zFile;
1959 char *zProc = 0;
1960 char *zErr = 0;
1961
1962 if( objc!=4 && objc!=3 ){
1963 Tcl_WrongNumArgs(interp, 1, objv, "DB-HANDLE FILE ?PROC?");
1964 return TCL_ERROR;
1965 }
1966 zDb = Tcl_GetString(objv[1]);
1967 zFile = Tcl_GetString(objv[2]);
1968 if( objc==4 ){
1969 zProc = Tcl_GetString(objv[3]);
1970 }
1971
1972 /* Extract the C database handle from the Tcl command name */
1973 if( !Tcl_GetCommandInfo(interp, zDb, &cmdInfo) ){
1974 Tcl_AppendResult(interp, "command not found: ", zDb, (char*)0);
1975 return TCL_ERROR;
1976 }
1977 db = ((struct SqliteDb*)cmdInfo.objClientData)->db;
1978 assert(db);
1979
1980 /* Call the underlying C function. If an error occurs, set rc to
1981 ** TCL_ERROR and load any error string into the interpreter. If no
1982 ** error occurs, set rc to TCL_OK.
1983 */
1984 #ifdef SQLITE_OMIT_LOAD_EXTENSION
1985 rc = SQLITE_ERROR;
1986 zErr = sqlite3_mprintf("this build omits sqlite3_load_extension()");
1987 (void)zProc;
1988 (void)zFile;
1989 #else
1990 rc = sqlite3_load_extension(db, zFile, zProc, &zErr);
1991 #endif
1992 if( rc!=SQLITE_OK ){
1993 Tcl_SetResult(interp, zErr ? zErr : "", TCL_VOLATILE);
1994 rc = TCL_ERROR;
1995 }else{
1996 rc = TCL_OK;
1997 }
1998 sqlite3_free(zErr);
1999
2000 return rc;
2001 }
2002
2003 /*
2004 ** Usage: sqlite3_enable_load_extension DB-HANDLE ONOFF
2005 */
2006 static int SQLITE_TCLAPI test_enable_load(
2007 ClientData clientData, /* Not used */
2008 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
2009 int objc, /* Number of arguments */
2010 Tcl_Obj *CONST objv[] /* Command arguments */
2011 ){
2012 Tcl_CmdInfo cmdInfo;
2013 sqlite3 *db;
2014 char *zDb;
2015 int onoff;
2016
2017 if( objc!=3 ){
2018 Tcl_WrongNumArgs(interp, 1, objv, "DB-HANDLE ONOFF");
2019 return TCL_ERROR;
2020 }
2021 zDb = Tcl_GetString(objv[1]);
2022
2023 /* Extract the C database handle from the Tcl command name */
2024 if( !Tcl_GetCommandInfo(interp, zDb, &cmdInfo) ){
2025 Tcl_AppendResult(interp, "command not found: ", zDb, (char*)0);
2026 return TCL_ERROR;
2027 }
2028 db = ((struct SqliteDb*)cmdInfo.objClientData)->db;
2029 assert(db);
2030
2031 /* Get the onoff parameter */
2032 if( Tcl_GetBooleanFromObj(interp, objv[2], &onoff) ){
2033 return TCL_ERROR;
2034 }
2035
2036 #ifdef SQLITE_OMIT_LOAD_EXTENSION
2037 Tcl_AppendResult(interp, "this build omits sqlite3_load_extension()");
2038 return TCL_ERROR;
2039 #else
2040 sqlite3_enable_load_extension(db, onoff);
2041 return TCL_OK;
2042 #endif
2043 }
2044
2045 /*
2046 ** Usage: sqlite_abort
2047 **
2048 ** Shutdown the process immediately. This is not a clean shutdown.
2049 ** This command is used to test the recoverability of a database in
2050 ** the event of a program crash.
2051 */
2052 static int SQLITE_TCLAPI sqlite_abort(
2053 void *NotUsed,
2054 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
2055 int argc, /* Number of arguments */
2056 char **argv /* Text of each argument */
2057 ){
2058 #if defined(_MSC_VER)
2059 /* We do this, otherwise the test will halt with a popup message
2060 * that we have to click away before the test will continue.
2061 */
2062 _set_abort_behavior( 0, _CALL_REPORTFAULT );
2063 #endif
2064 exit(255);
2065 assert( interp==0 ); /* This will always fail */
2066 return TCL_OK;
2067 }
2068
2069 /*
2070 ** The following routine is a user-defined SQL function whose purpose
2071 ** is to test the sqlite_set_result() API.
2072 */
2073 static void testFunc(sqlite3_context *context, int argc, sqlite3_value **argv){
2074 while( argc>=2 ){
2075 const char *zArg0 = (char*)sqlite3_value_text(argv[0]);
2076 if( zArg0 ){
2077 if( 0==sqlite3StrICmp(zArg0, "int") ){
2078 sqlite3_result_int(context, sqlite3_value_int(argv[1]));
2079 }else if( sqlite3StrICmp(zArg0,"int64")==0 ){
2080 sqlite3_result_int64(context, sqlite3_value_int64(argv[1]));
2081 }else if( sqlite3StrICmp(zArg0,"string")==0 ){
2082 sqlite3_result_text(context, (char*)sqlite3_value_text(argv[1]), -1,
2083 SQLITE_TRANSIENT);
2084 }else if( sqlite3StrICmp(zArg0,"double")==0 ){
2085 sqlite3_result_double(context, sqlite3_value_double(argv[1]));
2086 }else if( sqlite3StrICmp(zArg0,"null")==0 ){
2087 sqlite3_result_null(context);
2088 }else if( sqlite3StrICmp(zArg0,"value")==0 ){
2089 sqlite3_result_value(context, argv[sqlite3_value_int(argv[1])]);
2090 }else{
2091 goto error_out;
2092 }
2093 }else{
2094 goto error_out;
2095 }
2096 argc -= 2;
2097 argv += 2;
2098 }
2099 return;
2100
2101 error_out:
2102 sqlite3_result_error(context,"first argument should be one of: "
2103 "int int64 string double null value", -1);
2104 }
2105
2106 /*
2107 ** Usage: sqlite_register_test_function DB NAME
2108 **
2109 ** Register the test SQL function on the database DB under the name NAME.
2110 */
2111 static int SQLITE_TCLAPI test_register_func(
2112 void *NotUsed,
2113 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
2114 int argc, /* Number of arguments */
2115 char **argv /* Text of each argument */
2116 ){
2117 sqlite3 *db;
2118 int rc;
2119 if( argc!=3 ){
2120 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
2121 " DB FUNCTION-NAME", 0);
2122 return TCL_ERROR;
2123 }
2124 if( getDbPointer(interp, argv[1], &db) ) return TCL_ERROR;
2125 rc = sqlite3_create_function(db, argv[2], -1, SQLITE_UTF8, 0,
2126 testFunc, 0, 0);
2127 if( rc!=0 ){
2128 Tcl_AppendResult(interp, sqlite3ErrStr(rc), 0);
2129 return TCL_ERROR;
2130 }
2131 if( sqlite3TestErrCode(interp, db, rc) ) return TCL_ERROR;
2132 return TCL_OK;
2133 }
2134
2135 /*
2136 ** Usage: sqlite3_finalize STMT
2137 **
2138 ** Finalize a statement handle.
2139 */
2140 static int SQLITE_TCLAPI test_finalize(
2141 void * clientData,
2142 Tcl_Interp *interp,
2143 int objc,
2144 Tcl_Obj *CONST objv[]
2145 ){
2146 sqlite3_stmt *pStmt;
2147 int rc;
2148 sqlite3 *db = 0;
2149
2150 if( objc!=2 ){
2151 Tcl_AppendResult(interp, "wrong # args: should be \"",
2152 Tcl_GetStringFromObj(objv[0], 0), " <STMT>", 0);
2153 return TCL_ERROR;
2154 }
2155
2156 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
2157
2158 if( pStmt ){
2159 db = StmtToDb(pStmt);
2160 }
2161 rc = sqlite3_finalize(pStmt);
2162 Tcl_SetResult(interp, (char *)t1ErrorName(rc), TCL_STATIC);
2163 if( db && sqlite3TestErrCode(interp, db, rc) ) return TCL_ERROR;
2164 return TCL_OK;
2165 }
2166
2167 /*
2168 ** Usage: sqlite3_stmt_status STMT CODE RESETFLAG
2169 **
2170 ** Get the value of a status counter from a statement.
2171 */
2172 static int SQLITE_TCLAPI test_stmt_status(
2173 void * clientData,
2174 Tcl_Interp *interp,
2175 int objc,
2176 Tcl_Obj *CONST objv[]
2177 ){
2178 int iValue;
2179 int i, op = 0, resetFlag;
2180 const char *zOpName;
2181 sqlite3_stmt *pStmt;
2182
2183 static const struct {
2184 const char *zName;
2185 int op;
2186 } aOp[] = {
2187 { "SQLITE_STMTSTATUS_FULLSCAN_STEP", SQLITE_STMTSTATUS_FULLSCAN_STEP },
2188 { "SQLITE_STMTSTATUS_SORT", SQLITE_STMTSTATUS_SORT },
2189 { "SQLITE_STMTSTATUS_AUTOINDEX", SQLITE_STMTSTATUS_AUTOINDEX },
2190 { "SQLITE_STMTSTATUS_VM_STEP", SQLITE_STMTSTATUS_VM_STEP },
2191 { "SQLITE_STMTSTATUS_REPREPARE", SQLITE_STMTSTATUS_REPREPARE },
2192 { "SQLITE_STMTSTATUS_RUN", SQLITE_STMTSTATUS_RUN },
2193 { "SQLITE_STMTSTATUS_MEMUSED", SQLITE_STMTSTATUS_MEMUSED },
2194 };
2195 if( objc!=4 ){
2196 Tcl_WrongNumArgs(interp, 1, objv, "STMT PARAMETER RESETFLAG");
2197 return TCL_ERROR;
2198 }
2199 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
2200 zOpName = Tcl_GetString(objv[2]);
2201 for(i=0; i<ArraySize(aOp); i++){
2202 if( strcmp(aOp[i].zName, zOpName)==0 ){
2203 op = aOp[i].op;
2204 break;
2205 }
2206 }
2207 if( i>=ArraySize(aOp) ){
2208 if( Tcl_GetIntFromObj(interp, objv[2], &op) ) return TCL_ERROR;
2209 }
2210 if( Tcl_GetBooleanFromObj(interp, objv[3], &resetFlag) ) return TCL_ERROR;
2211 iValue = sqlite3_stmt_status(pStmt, op, resetFlag);
2212 Tcl_SetObjResult(interp, Tcl_NewIntObj(iValue));
2213 return TCL_OK;
2214 }
2215
2216 #ifdef SQLITE_ENABLE_STMT_SCANSTATUS
2217 /*
2218 ** Usage: sqlite3_stmt_scanstatus STMT IDX
2219 */
2220 static int SQLITE_TCLAPI test_stmt_scanstatus(
2221 void * clientData,
2222 Tcl_Interp *interp,
2223 int objc,
2224 Tcl_Obj *CONST objv[]
2225 ){
2226 sqlite3_stmt *pStmt; /* First argument */
2227 int idx; /* Second argument */
2228
2229 const char *zName;
2230 const char *zExplain;
2231 sqlite3_int64 nLoop;
2232 sqlite3_int64 nVisit;
2233 double rEst;
2234 int res;
2235
2236 if( objc!=3 ){
2237 Tcl_WrongNumArgs(interp, 1, objv, "STMT IDX");
2238 return TCL_ERROR;
2239 }
2240 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
2241 if( Tcl_GetIntFromObj(interp, objv[2], &idx) ) return TCL_ERROR;
2242
2243 res = sqlite3_stmt_scanstatus(pStmt, idx, SQLITE_SCANSTAT_NLOOP, (void*)&nLoop);
2244 if( res==0 ){
2245 Tcl_Obj *pRet = Tcl_NewObj();
2246 Tcl_ListObjAppendElement(0, pRet, Tcl_NewStringObj("nLoop", -1));
2247 Tcl_ListObjAppendElement(0, pRet, Tcl_NewWideIntObj(nLoop));
2248 sqlite3_stmt_scanstatus(pStmt, idx, SQLITE_SCANSTAT_NVISIT, (void*)&nVisit);
2249 Tcl_ListObjAppendElement(0, pRet, Tcl_NewStringObj("nVisit", -1));
2250 Tcl_ListObjAppendElement(0, pRet, Tcl_NewWideIntObj(nVisit));
2251 sqlite3_stmt_scanstatus(pStmt, idx, SQLITE_SCANSTAT_EST, (void*)&rEst);
2252 Tcl_ListObjAppendElement(0, pRet, Tcl_NewStringObj("nEst", -1));
2253 Tcl_ListObjAppendElement(0, pRet, Tcl_NewDoubleObj(rEst));
2254 sqlite3_stmt_scanstatus(pStmt, idx, SQLITE_SCANSTAT_NAME, (void*)&zName);
2255 Tcl_ListObjAppendElement(0, pRet, Tcl_NewStringObj("zName", -1));
2256 Tcl_ListObjAppendElement(0, pRet, Tcl_NewStringObj(zName, -1));
2257 sqlite3_stmt_scanstatus(pStmt, idx, SQLITE_SCANSTAT_EXPLAIN, (void*)&zExplain);
2258 Tcl_ListObjAppendElement(0, pRet, Tcl_NewStringObj("zExplain", -1));
2259 Tcl_ListObjAppendElement(0, pRet, Tcl_NewStringObj(zExplain, -1));
2260 Tcl_SetObjResult(interp, pRet);
2261 }else{
2262 Tcl_ResetResult(interp);
2263 }
2264 return TCL_OK;
2265 }
2266
2267 /*
2268 ** Usage: sqlite3_stmt_scanstatus_reset STMT
2269 */
2270 static int SQLITE_TCLAPI test_stmt_scanstatus_reset(
2271 void * clientData,
2272 Tcl_Interp *interp,
2273 int objc,
2274 Tcl_Obj *CONST objv[]
2275 ){
2276 sqlite3_stmt *pStmt; /* First argument */
2277 if( objc!=2 ){
2278 Tcl_WrongNumArgs(interp, 1, objv, "STMT");
2279 return TCL_ERROR;
2280 }
2281 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
2282 sqlite3_stmt_scanstatus_reset(pStmt);
2283 return TCL_OK;
2284 }
2285 #endif
2286
2287 #ifdef SQLITE_ENABLE_SQLLOG
2288 /*
2289 ** Usage: sqlite3_config_sqllog
2290 **
2291 ** Zero the SQLITE_CONFIG_SQLLOG configuration
2292 */
2293 static int SQLITE_TCLAPI test_config_sqllog(
2294 void * clientData,
2295 Tcl_Interp *interp,
2296 int objc,
2297 Tcl_Obj *CONST objv[]
2298 ){
2299 if( objc!=1 ){
2300 Tcl_WrongNumArgs(interp, 1, objv, "");
2301 return TCL_ERROR;
2302 }
2303 sqlite3_config(SQLITE_CONFIG_SQLLOG, 0, 0);
2304 return TCL_OK;
2305 }
2306 #endif
2307
2308 /*
2309 ** Usage: sqlite3_config_sorterref
2310 **
2311 ** Set the SQLITE_CONFIG_SORTERREF_SIZE configuration option
2312 */
2313 static int SQLITE_TCLAPI test_config_sorterref(
2314 void * clientData,
2315 Tcl_Interp *interp,
2316 int objc,
2317 Tcl_Obj *CONST objv[]
2318 ){
2319 int iVal;
2320 if( objc!=2 ){
2321 Tcl_WrongNumArgs(interp, 1, objv, "NBYTE");
2322 return TCL_ERROR;
2323 }
2324 if( Tcl_GetIntFromObj(interp, objv[1], &iVal) ) return TCL_ERROR;
2325 sqlite3_config(SQLITE_CONFIG_SORTERREF_SIZE, iVal);
2326 return TCL_OK;
2327 }
2328
2329 /*
2330 ** Usage: vfs_current_time_int64
2331 **
2332 ** Return the value returned by the default VFS's xCurrentTimeInt64 method.
2333 */
2334 static int SQLITE_TCLAPI vfsCurrentTimeInt64(
2335 void * clientData,
2336 Tcl_Interp *interp,
2337 int objc,
2338 Tcl_Obj *CONST objv[]
2339 ){
2340 i64 t;
2341 sqlite3_vfs *pVfs = sqlite3_vfs_find(0);
2342 if( objc!=1 ){
2343 Tcl_WrongNumArgs(interp, 1, objv, "");
2344 return TCL_ERROR;
2345 }
2346 pVfs->xCurrentTimeInt64(pVfs, &t);
2347 Tcl_SetObjResult(interp, Tcl_NewWideIntObj(t));
2348 return TCL_OK;
2349 }
2350
2351 #ifdef SQLITE_ENABLE_SNAPSHOT
2352 /*
2353 ** Usage: sqlite3_snapshot_get DB DBNAME
2354 */
2355 static int SQLITE_TCLAPI test_snapshot_get(
2356 void * clientData,
2357 Tcl_Interp *interp,
2358 int objc,
2359 Tcl_Obj *CONST objv[]
2360 ){
2361 int rc;
2362 sqlite3 *db;
2363 char *zName;
2364 sqlite3_snapshot *pSnapshot = 0;
2365
2366 if( objc!=3 ){
2367 Tcl_WrongNumArgs(interp, 1, objv, "DB DBNAME");
2368 return TCL_ERROR;
2369 }
2370 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
2371 zName = Tcl_GetString(objv[2]);
2372
2373 rc = sqlite3_snapshot_get(db, zName, &pSnapshot);
2374 if( rc!=SQLITE_OK ){
2375 Tcl_SetObjResult(interp, Tcl_NewStringObj(sqlite3ErrName(rc), -1));
2376 return TCL_ERROR;
2377 }else{
2378 char zBuf[100];
2379 if( sqlite3TestMakePointerStr(interp, zBuf, pSnapshot) ) return TCL_ERROR;
2380 Tcl_SetObjResult(interp, Tcl_NewStringObj(zBuf, -1));
2381 }
2382 return TCL_OK;
2383 }
2384 #endif /* SQLITE_ENABLE_SNAPSHOT */
2385
2386 #ifdef SQLITE_ENABLE_SNAPSHOT
2387 /*
2388 ** Usage: sqlite3_snapshot_recover DB DBNAME
2389 */
2390 static int SQLITE_TCLAPI test_snapshot_recover(
2391 void * clientData,
2392 Tcl_Interp *interp,
2393 int objc,
2394 Tcl_Obj *CONST objv[]
2395 ){
2396 int rc;
2397 sqlite3 *db;
2398 char *zName;
2399
2400 if( objc!=3 ){
2401 Tcl_WrongNumArgs(interp, 1, objv, "DB DBNAME");
2402 return TCL_ERROR;
2403 }
2404 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
2405 zName = Tcl_GetString(objv[2]);
2406
2407 rc = sqlite3_snapshot_recover(db, zName);
2408 if( rc!=SQLITE_OK ){
2409 Tcl_SetObjResult(interp, Tcl_NewStringObj(sqlite3ErrName(rc), -1));
2410 return TCL_ERROR;
2411 }else{
2412 Tcl_ResetResult(interp);
2413 }
2414 return TCL_OK;
2415 }
2416 #endif /* SQLITE_ENABLE_SNAPSHOT */
2417
2418 #ifdef SQLITE_ENABLE_SNAPSHOT
2419 /*
2420 ** Usage: sqlite3_snapshot_open DB DBNAME SNAPSHOT
2421 */
2422 static int SQLITE_TCLAPI test_snapshot_open(
2423 void * clientData,
2424 Tcl_Interp *interp,
2425 int objc,
2426 Tcl_Obj *CONST objv[]
2427 ){
2428 int rc;
2429 sqlite3 *db;
2430 char *zName;
2431 sqlite3_snapshot *pSnapshot;
2432
2433 if( objc!=4 ){
2434 Tcl_WrongNumArgs(interp, 1, objv, "DB DBNAME SNAPSHOT");
2435 return TCL_ERROR;
2436 }
2437 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
2438 zName = Tcl_GetString(objv[2]);
2439 pSnapshot = (sqlite3_snapshot*)sqlite3TestTextToPtr(Tcl_GetString(objv[3]));
2440
2441 rc = sqlite3_snapshot_open(db, zName, pSnapshot);
2442 if( rc!=SQLITE_OK ){
2443 Tcl_SetObjResult(interp, Tcl_NewStringObj(sqlite3ErrName(rc), -1));
2444 return TCL_ERROR;
2445 }else{
2446 Tcl_ResetResult(interp);
2447 }
2448 return TCL_OK;
2449 }
2450 #endif /* SQLITE_ENABLE_SNAPSHOT */
2451
2452 #ifdef SQLITE_ENABLE_SNAPSHOT
2453 /*
2454 ** Usage: sqlite3_snapshot_free SNAPSHOT
2455 */
2456 static int SQLITE_TCLAPI test_snapshot_free(
2457 void * clientData,
2458 Tcl_Interp *interp,
2459 int objc,
2460 Tcl_Obj *CONST objv[]
2461 ){
2462 sqlite3_snapshot *pSnapshot;
2463 if( objc!=2 ){
2464 Tcl_WrongNumArgs(interp, 1, objv, "SNAPSHOT");
2465 return TCL_ERROR;
2466 }
2467 pSnapshot = (sqlite3_snapshot*)sqlite3TestTextToPtr(Tcl_GetString(objv[1]));
2468 sqlite3_snapshot_free(pSnapshot);
2469 return TCL_OK;
2470 }
2471 #endif /* SQLITE_ENABLE_SNAPSHOT */
2472
2473 #ifdef SQLITE_ENABLE_SNAPSHOT
2474 /*
2475 ** Usage: sqlite3_snapshot_cmp SNAPSHOT1 SNAPSHOT2
2476 */
2477 static int SQLITE_TCLAPI test_snapshot_cmp(
2478 void * clientData,
2479 Tcl_Interp *interp,
2480 int objc,
2481 Tcl_Obj *CONST objv[]
2482 ){
2483 int res;
2484 sqlite3_snapshot *p1;
2485 sqlite3_snapshot *p2;
2486 if( objc!=3 ){
2487 Tcl_WrongNumArgs(interp, 1, objv, "SNAPSHOT1 SNAPSHOT2");
2488 return TCL_ERROR;
2489 }
2490 p1 = (sqlite3_snapshot*)sqlite3TestTextToPtr(Tcl_GetString(objv[1]));
2491 p2 = (sqlite3_snapshot*)sqlite3TestTextToPtr(Tcl_GetString(objv[2]));
2492 res = sqlite3_snapshot_cmp(p1, p2);
2493 Tcl_SetObjResult(interp, Tcl_NewIntObj(res));
2494 return TCL_OK;
2495 }
2496 #endif /* SQLITE_ENABLE_SNAPSHOT */
2497
2498 #ifdef SQLITE_ENABLE_SNAPSHOT
2499 /*
2500 ** Usage: sqlite3_snapshot_get_blob DB DBNAME
2501 */
2502 static int SQLITE_TCLAPI test_snapshot_get_blob(
2503 void * clientData,
2504 Tcl_Interp *interp,
2505 int objc,
2506 Tcl_Obj *CONST objv[]
2507 ){
2508 int rc;
2509 sqlite3 *db;
2510 char *zName;
2511 sqlite3_snapshot *pSnapshot = 0;
2512
2513 if( objc!=3 ){
2514 Tcl_WrongNumArgs(interp, 1, objv, "DB DBNAME");
2515 return TCL_ERROR;
2516 }
2517 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
2518 zName = Tcl_GetString(objv[2]);
2519
2520 rc = sqlite3_snapshot_get(db, zName, &pSnapshot);
2521 if( rc!=SQLITE_OK ){
2522 Tcl_SetObjResult(interp, Tcl_NewStringObj(sqlite3ErrName(rc), -1));
2523 return TCL_ERROR;
2524 }else{
2525 Tcl_SetObjResult(interp,
2526 Tcl_NewByteArrayObj((unsigned char*)pSnapshot, sizeof(sqlite3_snapshot))
2527 );
2528 sqlite3_snapshot_free(pSnapshot);
2529 }
2530 return TCL_OK;
2531 }
2532 #endif /* SQLITE_ENABLE_SNAPSHOT */
2533
2534 #ifdef SQLITE_ENABLE_SNAPSHOT
2535 /*
2536 ** Usage: sqlite3_snapshot_open_blob DB DBNAME SNAPSHOT
2537 */
2538 static int SQLITE_TCLAPI test_snapshot_open_blob(
2539 void * clientData,
2540 Tcl_Interp *interp,
2541 int objc,
2542 Tcl_Obj *CONST objv[]
2543 ){
2544 int rc;
2545 sqlite3 *db;
2546 char *zName;
2547 unsigned char *pBlob;
2548 int nBlob;
2549
2550 if( objc!=4 ){
2551 Tcl_WrongNumArgs(interp, 1, objv, "DB DBNAME SNAPSHOT");
2552 return TCL_ERROR;
2553 }
2554 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
2555 zName = Tcl_GetString(objv[2]);
2556 pBlob = Tcl_GetByteArrayFromObj(objv[3], &nBlob);
2557 if( nBlob!=sizeof(sqlite3_snapshot) ){
2558 Tcl_AppendResult(interp, "bad SNAPSHOT", 0);
2559 return TCL_ERROR;
2560 }
2561 rc = sqlite3_snapshot_open(db, zName, (sqlite3_snapshot*)pBlob);
2562 if( rc!=SQLITE_OK ){
2563 Tcl_SetObjResult(interp, Tcl_NewStringObj(sqlite3ErrName(rc), -1));
2564 return TCL_ERROR;
2565 }
2566 return TCL_OK;
2567 }
2568 #endif /* SQLITE_ENABLE_SNAPSHOT */
2569
2570 #ifdef SQLITE_ENABLE_SNAPSHOT
2571 /*
2572 ** Usage: sqlite3_snapshot_cmp_blob SNAPSHOT1 SNAPSHOT2
2573 */
2574 static int SQLITE_TCLAPI test_snapshot_cmp_blob(
2575 void * clientData,
2576 Tcl_Interp *interp,
2577 int objc,
2578 Tcl_Obj *CONST objv[]
2579 ){
2580 int res;
2581 unsigned char *p1;
2582 unsigned char *p2;
2583 int n1;
2584 int n2;
2585
2586 if( objc!=3 ){
2587 Tcl_WrongNumArgs(interp, 1, objv, "SNAPSHOT1 SNAPSHOT2");
2588 return TCL_ERROR;
2589 }
2590
2591 p1 = Tcl_GetByteArrayFromObj(objv[1], &n1);
2592 p2 = Tcl_GetByteArrayFromObj(objv[2], &n2);
2593
2594 if( n1!=sizeof(sqlite3_snapshot) || n1!=n2 ){
2595 Tcl_AppendResult(interp, "bad SNAPSHOT", 0);
2596 return TCL_ERROR;
2597 }
2598
2599 res = sqlite3_snapshot_cmp((sqlite3_snapshot*)p1, (sqlite3_snapshot*)p2);
2600 Tcl_SetObjResult(interp, Tcl_NewIntObj(res));
2601 return TCL_OK;
2602 }
2603 #endif /* SQLITE_ENABLE_SNAPSHOT */
2604
2605 /*
2606 ** Usage: sqlite3_delete_database FILENAME
2607 */
2608 int sqlite3_delete_database(const char*); /* in test_delete.c */
2609 static int SQLITE_TCLAPI test_delete_database(
2610 void * clientData,
2611 Tcl_Interp *interp,
2612 int objc,
2613 Tcl_Obj *CONST objv[]
2614 ){
2615 int rc;
2616 const char *zFile;
2617 if( objc!=2 ){
2618 Tcl_WrongNumArgs(interp, 1, objv, "FILE");
2619 return TCL_ERROR;
2620 }
2621 zFile = (const char*)Tcl_GetString(objv[1]);
2622 rc = sqlite3_delete_database(zFile);
2623
2624 Tcl_SetObjResult(interp, Tcl_NewStringObj(sqlite3ErrName(rc), -1));
2625 return TCL_OK;
2626 }
2627
2628 /*
2629 ** Usage: atomic_batch_write PATH
2630 */
2631 static int SQLITE_TCLAPI test_atomic_batch_write(
2632 void * clientData,
2633 Tcl_Interp *interp,
2634 int objc,
2635 Tcl_Obj *CONST objv[]
2636 ){
2637 char *zFile = 0; /* Path to file to test */
2638 sqlite3 *db = 0; /* Database handle */
2639 sqlite3_file *pFd = 0; /* SQLite fd open on zFile */
2640 int bRes = 0; /* Integer result of this command */
2641 int dc = 0; /* Device-characteristics mask */
2642 int rc; /* sqlite3_open() return code */
2643
2644 if( objc!=2 ){
2645 Tcl_WrongNumArgs(interp, 1, objv, "PATH");
2646 return TCL_ERROR;
2647 }
2648 zFile = Tcl_GetString(objv[1]);
2649
2650 rc = sqlite3_open(zFile, &db);
2651 if( rc!=SQLITE_OK ){
2652 Tcl_AppendResult(interp, sqlite3_errmsg(db), 0);
2653 sqlite3_close(db);
2654 return TCL_ERROR;
2655 }
2656
2657 rc = sqlite3_file_control(db, "main", SQLITE_FCNTL_FILE_POINTER, (void*)&pFd);
2658 dc = pFd->pMethods->xDeviceCharacteristics(pFd);
2659 if( dc & SQLITE_IOCAP_BATCH_ATOMIC ){
2660 bRes = 1;
2661 }
2662
2663 Tcl_SetObjResult(interp, Tcl_NewIntObj(bRes));
2664 sqlite3_close(db);
2665 return TCL_OK;
2666 }
2667
2668 /*
2669 ** Usage: sqlite3_next_stmt DB STMT
2670 **
2671 ** Return the next statment in sequence after STMT.
2672 */
2673 static int SQLITE_TCLAPI test_next_stmt(
2674 void * clientData,
2675 Tcl_Interp *interp,
2676 int objc,
2677 Tcl_Obj *CONST objv[]
2678 ){
2679 sqlite3_stmt *pStmt;
2680 sqlite3 *db = 0;
2681 char zBuf[50];
2682
2683 if( objc!=3 ){
2684 Tcl_AppendResult(interp, "wrong # args: should be \"",
2685 Tcl_GetStringFromObj(objv[0], 0), " DB STMT", 0);
2686 return TCL_ERROR;
2687 }
2688
2689 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
2690 if( getStmtPointer(interp, Tcl_GetString(objv[2]), &pStmt) ) return TCL_ERROR;
2691 pStmt = sqlite3_next_stmt(db, pStmt);
2692 if( pStmt ){
2693 if( sqlite3TestMakePointerStr(interp, zBuf, pStmt) ) return TCL_ERROR;
2694 Tcl_AppendResult(interp, zBuf, 0);
2695 }
2696 return TCL_OK;
2697 }
2698
2699 /*
2700 ** Usage: sqlite3_stmt_readonly STMT
2701 **
2702 ** Return true if STMT is a NULL pointer or a pointer to a statement
2703 ** that is guaranteed to leave the database unmodified.
2704 */
2705 static int SQLITE_TCLAPI test_stmt_readonly(
2706 void * clientData,
2707 Tcl_Interp *interp,
2708 int objc,
2709 Tcl_Obj *CONST objv[]
2710 ){
2711 sqlite3_stmt *pStmt;
2712 int rc;
2713
2714 if( objc!=2 ){
2715 Tcl_AppendResult(interp, "wrong # args: should be \"",
2716 Tcl_GetStringFromObj(objv[0], 0), " STMT", 0);
2717 return TCL_ERROR;
2718 }
2719
2720 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
2721 rc = sqlite3_stmt_readonly(pStmt);
2722 Tcl_SetObjResult(interp, Tcl_NewBooleanObj(rc));
2723 return TCL_OK;
2724 }
2725
2726 /*
2727 ** Usage: sqlite3_stmt_isexplain STMT
2728 **
2729 ** Return 1, 2, or 0 respectively if STMT is an EXPLAIN statement, an
2730 ** EXPLAIN QUERY PLAN statement or an ordinary statement or NULL pointer.
2731 */
2732 static int SQLITE_TCLAPI test_stmt_isexplain(
2733 void * clientData,
2734 Tcl_Interp *interp,
2735 int objc,
2736 Tcl_Obj *CONST objv[]
2737 ){
2738 sqlite3_stmt *pStmt;
2739 int rc;
2740
2741 if( objc!=2 ){
2742 Tcl_AppendResult(interp, "wrong # args: should be \"",
2743 Tcl_GetStringFromObj(objv[0], 0), " STMT", 0);
2744 return TCL_ERROR;
2745 }
2746
2747 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
2748 rc = sqlite3_stmt_isexplain(pStmt);
2749 Tcl_SetObjResult(interp, Tcl_NewIntObj(rc));
2750 return TCL_OK;
2751 }
2752
2753 /*
2754 ** Usage: sqlite3_stmt_busy STMT
2755 **
2756 ** Return true if STMT is a non-NULL pointer to a statement
2757 ** that has been stepped but not to completion.
2758 */
2759 static int SQLITE_TCLAPI test_stmt_busy(
2760 void * clientData,
2761 Tcl_Interp *interp,
2762 int objc,
2763 Tcl_Obj *CONST objv[]
2764 ){
2765 sqlite3_stmt *pStmt;
2766 int rc;
2767
2768 if( objc!=2 ){
2769 Tcl_AppendResult(interp, "wrong # args: should be \"",
2770 Tcl_GetStringFromObj(objv[0], 0), " STMT", 0);
2771 return TCL_ERROR;
2772 }
2773
2774 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
2775 rc = sqlite3_stmt_busy(pStmt);
2776 Tcl_SetObjResult(interp, Tcl_NewBooleanObj(rc));
2777 return TCL_OK;
2778 }
2779
2780 /*
2781 ** Usage: uses_stmt_journal STMT
2782 **
2783 ** Return true if STMT uses a statement journal.
2784 */
2785 static int SQLITE_TCLAPI uses_stmt_journal(
2786 void * clientData,
2787 Tcl_Interp *interp,
2788 int objc,
2789 Tcl_Obj *CONST objv[]
2790 ){
2791 sqlite3_stmt *pStmt;
2792
2793 if( objc!=2 ){
2794 Tcl_AppendResult(interp, "wrong # args: should be \"",
2795 Tcl_GetStringFromObj(objv[0], 0), " STMT", 0);
2796 return TCL_ERROR;
2797 }
2798
2799 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
2800 sqlite3_stmt_readonly(pStmt);
2801 Tcl_SetObjResult(interp, Tcl_NewBooleanObj(((Vdbe *)pStmt)->usesStmtJournal));
2802 return TCL_OK;
2803 }
2804
2805
2806 /*
2807 ** Usage: sqlite3_reset STMT
2808 **
2809 ** Reset a statement handle.
2810 */
2811 static int SQLITE_TCLAPI test_reset(
2812 void * clientData,
2813 Tcl_Interp *interp,
2814 int objc,
2815 Tcl_Obj *CONST objv[]
2816 ){
2817 sqlite3_stmt *pStmt;
2818 int rc;
2819
2820 if( objc!=2 ){
2821 Tcl_AppendResult(interp, "wrong # args: should be \"",
2822 Tcl_GetStringFromObj(objv[0], 0), " <STMT>", 0);
2823 return TCL_ERROR;
2824 }
2825
2826 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
2827
2828 rc = sqlite3_reset(pStmt);
2829 if( pStmt && sqlite3TestErrCode(interp, StmtToDb(pStmt), rc) ){
2830 return TCL_ERROR;
2831 }
2832 Tcl_SetResult(interp, (char *)t1ErrorName(rc), TCL_STATIC);
2833 /*
2834 if( rc ){
2835 return TCL_ERROR;
2836 }
2837 */
2838 return TCL_OK;
2839 }
2840
2841 /*
2842 ** Usage: sqlite3_expired STMT
2843 **
2844 ** Return TRUE if a recompilation of the statement is recommended.
2845 */
2846 static int SQLITE_TCLAPI test_expired(
2847 void * clientData,
2848 Tcl_Interp *interp,
2849 int objc,
2850 Tcl_Obj *CONST objv[]
2851 ){
2852 #ifndef SQLITE_OMIT_DEPRECATED
2853 sqlite3_stmt *pStmt;
2854 if( objc!=2 ){
2855 Tcl_AppendResult(interp, "wrong # args: should be \"",
2856 Tcl_GetStringFromObj(objv[0], 0), " <STMT>", 0);
2857 return TCL_ERROR;
2858 }
2859 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
2860 Tcl_SetObjResult(interp, Tcl_NewBooleanObj(sqlite3_expired(pStmt)));
2861 #endif
2862 return TCL_OK;
2863 }
2864
2865 /*
2866 ** Usage: sqlite3_transfer_bindings FROMSTMT TOSTMT
2867 **
2868 ** Transfer all bindings from FROMSTMT over to TOSTMT
2869 */
2870 static int SQLITE_TCLAPI test_transfer_bind(
2871 void * clientData,
2872 Tcl_Interp *interp,
2873 int objc,
2874 Tcl_Obj *CONST objv[]
2875 ){
2876 #ifndef SQLITE_OMIT_DEPRECATED
2877 sqlite3_stmt *pStmt1, *pStmt2;
2878 if( objc!=3 ){
2879 Tcl_AppendResult(interp, "wrong # args: should be \"",
2880 Tcl_GetStringFromObj(objv[0], 0), " FROM-STMT TO-STMT", 0);
2881 return TCL_ERROR;
2882 }
2883 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt1)) return TCL_ERROR;
2884 if( getStmtPointer(interp, Tcl_GetString(objv[2]), &pStmt2)) return TCL_ERROR;
2885 Tcl_SetObjResult(interp,
2886 Tcl_NewIntObj(sqlite3_transfer_bindings(pStmt1,pStmt2)));
2887 #endif
2888 return TCL_OK;
2889 }
2890
2891 /*
2892 ** Usage: sqlite3_changes DB
2893 **
2894 ** Return the number of changes made to the database by the last SQL
2895 ** execution.
2896 */
2897 static int SQLITE_TCLAPI test_changes(
2898 void * clientData,
2899 Tcl_Interp *interp,
2900 int objc,
2901 Tcl_Obj *CONST objv[]
2902 ){
2903 sqlite3 *db;
2904 if( objc!=2 ){
2905 Tcl_AppendResult(interp, "wrong # args: should be \"",
2906 Tcl_GetString(objv[0]), " DB", 0);
2907 return TCL_ERROR;
2908 }
2909 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
2910 Tcl_SetObjResult(interp, Tcl_NewIntObj(sqlite3_changes(db)));
2911 return TCL_OK;
2912 }
2913
2914 /*
2915 ** This is the "static_bind_value" that variables are bound to when
2916 ** the FLAG option of sqlite3_bind is "static"
2917 */
2918 static char *sqlite_static_bind_value = 0;
2919 static int sqlite_static_bind_nbyte = 0;
2920
2921 /*
2922 ** Usage: sqlite3_bind VM IDX VALUE FLAGS
2923 **
2924 ** Sets the value of the IDX-th occurrence of "?" in the original SQL
2925 ** string. VALUE is the new value. If FLAGS=="null" then VALUE is
2926 ** ignored and the value is set to NULL. If FLAGS=="static" then
2927 ** the value is set to the value of a static variable named
2928 ** "sqlite_static_bind_value". If FLAGS=="normal" then a copy
2929 ** of the VALUE is made. If FLAGS=="blob10" then a VALUE is ignored
2930 ** an a 10-byte blob "abc\000xyz\000pq" is inserted.
2931 */
2932 static int SQLITE_TCLAPI test_bind(
2933 void *NotUsed,
2934 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
2935 int argc, /* Number of arguments */
2936 char **argv /* Text of each argument */
2937 ){
2938 sqlite3_stmt *pStmt;
2939 int rc;
2940 int idx;
2941 if( argc!=5 ){
2942 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
2943 " VM IDX VALUE (null|static|normal)\"", 0);
2944 return TCL_ERROR;
2945 }
2946 if( getStmtPointer(interp, argv[1], &pStmt) ) return TCL_ERROR;
2947 if( Tcl_GetInt(interp, argv[2], &idx) ) return TCL_ERROR;
2948 if( strcmp(argv[4],"null")==0 ){
2949 rc = sqlite3_bind_null(pStmt, idx);
2950 }else if( strcmp(argv[4],"static")==0 ){
2951 rc = sqlite3_bind_text(pStmt, idx, sqlite_static_bind_value, -1, 0);
2952 }else if( strcmp(argv[4],"static-nbytes")==0 ){
2953 rc = sqlite3_bind_text(pStmt, idx, sqlite_static_bind_value,
2954 sqlite_static_bind_nbyte, 0);
2955 }else if( strcmp(argv[4],"normal")==0 ){
2956 rc = sqlite3_bind_text(pStmt, idx, argv[3], -1, SQLITE_TRANSIENT);
2957 }else if( strcmp(argv[4],"blob10")==0 ){
2958 rc = sqlite3_bind_text(pStmt, idx, "abc\000xyz\000pq", 10, SQLITE_STATIC);
2959 }else{
2960 Tcl_AppendResult(interp, "4th argument should be "
2961 "\"null\" or \"static\" or \"normal\"", 0);
2962 return TCL_ERROR;
2963 }
2964 if( sqlite3TestErrCode(interp, StmtToDb(pStmt), rc) ) return TCL_ERROR;
2965 if( rc ){
2966 char zBuf[50];
2967 sqlite3_snprintf(sizeof(zBuf), zBuf, "(%d) ", rc);
2968 Tcl_AppendResult(interp, zBuf, sqlite3ErrStr(rc), 0);
2969 return TCL_ERROR;
2970 }
2971 return TCL_OK;
2972 }
2973
2974 #ifndef SQLITE_OMIT_UTF16
2975 /*
2976 ** Usage: add_test_collate <db ptr> <utf8> <utf16le> <utf16be>
2977 **
2978 ** This function is used to test that SQLite selects the correct collation
2979 ** sequence callback when multiple versions (for different text encodings)
2980 ** are available.
2981 **
2982 ** Calling this routine registers the collation sequence "test_collate"
2983 ** with database handle <db>. The second argument must be a list of three
2984 ** boolean values. If the first is true, then a version of test_collate is
2985 ** registered for UTF-8, if the second is true, a version is registered for
2986 ** UTF-16le, if the third is true, a UTF-16be version is available.
2987 ** Previous versions of test_collate are deleted.
2988 **
2989 ** The collation sequence test_collate is implemented by calling the
2990 ** following TCL script:
2991 **
2992 ** "test_collate <enc> <lhs> <rhs>"
2993 **
2994 ** The <lhs> and <rhs> are the two values being compared, encoded in UTF-8.
2995 ** The <enc> parameter is the encoding of the collation function that
2996 ** SQLite selected to call. The TCL test script implements the
2997 ** "test_collate" proc.
2998 **
2999 ** Note that this will only work with one interpreter at a time, as the
3000 ** interp pointer to use when evaluating the TCL script is stored in
3001 ** pTestCollateInterp.
3002 */
3003 static Tcl_Interp* pTestCollateInterp;
3004 static int test_collate_func(
3005 void *pCtx,
3006 int nA, const void *zA,
3007 int nB, const void *zB
3008 ){
3009 Tcl_Interp *i = pTestCollateInterp;
3010 int encin = SQLITE_PTR_TO_INT(pCtx);
3011 int res;
3012 int n;
3013
3014 sqlite3_value *pVal;
3015 Tcl_Obj *pX;
3016
3017 pX = Tcl_NewStringObj("test_collate", -1);
3018 Tcl_IncrRefCount(pX);
3019
3020 switch( encin ){
3021 case SQLITE_UTF8:
3022 Tcl_ListObjAppendElement(i,pX,Tcl_NewStringObj("UTF-8",-1));
3023 break;
3024 case SQLITE_UTF16LE:
3025 Tcl_ListObjAppendElement(i,pX,Tcl_NewStringObj("UTF-16LE",-1));
3026 break;
3027 case SQLITE_UTF16BE:
3028 Tcl_ListObjAppendElement(i,pX,Tcl_NewStringObj("UTF-16BE",-1));
3029 break;
3030 default:
3031 assert(0);
3032 }
3033
3034 sqlite3BeginBenignMalloc();
3035 pVal = sqlite3ValueNew(0);
3036 if( pVal ){
3037 sqlite3ValueSetStr(pVal, nA, zA, encin, SQLITE_STATIC);
3038 n = sqlite3_value_bytes(pVal);
3039 Tcl_ListObjAppendElement(i,pX,
3040 Tcl_NewStringObj((char*)sqlite3_value_text(pVal),n));
3041 sqlite3ValueSetStr(pVal, nB, zB, encin, SQLITE_STATIC);
3042 n = sqlite3_value_bytes(pVal);
3043 Tcl_ListObjAppendElement(i,pX,
3044 Tcl_NewStringObj((char*)sqlite3_value_text(pVal),n));
3045 sqlite3ValueFree(pVal);
3046 }
3047 sqlite3EndBenignMalloc();
3048
3049 Tcl_EvalObjEx(i, pX, 0);
3050 Tcl_DecrRefCount(pX);
3051 Tcl_GetIntFromObj(i, Tcl_GetObjResult(i), &res);
3052 return res;
3053 }
3054 static int SQLITE_TCLAPI test_collate(
3055 void * clientData,
3056 Tcl_Interp *interp,
3057 int objc,
3058 Tcl_Obj *CONST objv[]
3059 ){
3060 sqlite3 *db;
3061 int val;
3062 sqlite3_value *pVal;
3063 int rc;
3064
3065 if( objc!=5 ) goto bad_args;
3066 pTestCollateInterp = interp;
3067 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
3068
3069 if( TCL_OK!=Tcl_GetBooleanFromObj(interp, objv[2], &val) ) return TCL_ERROR;
3070 rc = sqlite3_create_collation(db, "test_collate", SQLITE_UTF8,
3071 (void *)SQLITE_UTF8, val?test_collate_func:0);
3072 if( rc==SQLITE_OK ){
3073 const void *zUtf16;
3074 if( TCL_OK!=Tcl_GetBooleanFromObj(interp, objv[3], &val) ) return TCL_ERROR;
3075 rc = sqlite3_create_collation(db, "test_collate", SQLITE_UTF16LE,
3076 (void *)SQLITE_UTF16LE, val?test_collate_func:0);
3077 if( TCL_OK!=Tcl_GetBooleanFromObj(interp, objv[4], &val) ) return TCL_ERROR;
3078
3079 #if 0
3080 if( sqlite3_iMallocFail>0 ){
3081 sqlite3_iMallocFail++;
3082 }
3083 #endif
3084 sqlite3_mutex_enter(db->mutex);
3085 pVal = sqlite3ValueNew(db);
3086 sqlite3ValueSetStr(pVal, -1, "test_collate", SQLITE_UTF8, SQLITE_STATIC);
3087 zUtf16 = sqlite3ValueText(pVal, SQLITE_UTF16NATIVE);
3088 if( db->mallocFailed ){
3089 rc = SQLITE_NOMEM;
3090 }else{
3091 rc = sqlite3_create_collation16(db, zUtf16, SQLITE_UTF16BE,
3092 (void *)SQLITE_UTF16BE, val?test_collate_func:0);
3093 }
3094 sqlite3ValueFree(pVal);
3095 sqlite3_mutex_leave(db->mutex);
3096 }
3097 if( sqlite3TestErrCode(interp, db, rc) ) return TCL_ERROR;
3098
3099 if( rc!=SQLITE_OK ){
3100 Tcl_AppendResult(interp, sqlite3ErrName(rc), 0);
3101 return TCL_ERROR;
3102 }
3103 return TCL_OK;
3104
3105 bad_args:
3106 Tcl_AppendResult(interp, "wrong # args: should be \"",
3107 Tcl_GetStringFromObj(objv[0], 0), " <DB> <utf8> <utf16le> <utf16be>", 0);
3108 return TCL_ERROR;
3109 }
3110
3111 /*
3112 ** Usage: add_test_utf16bin_collate <db ptr>
3113 **
3114 ** Add a utf-16 collation sequence named "utf16bin" to the database
3115 ** handle. This collation sequence compares arguments in the same way as the
3116 ** built-in collation "binary".
3117 */
3118 static int test_utf16bin_collate_func(
3119 void *pCtx,
3120 int nA, const void *zA,
3121 int nB, const void *zB
3122 ){
3123 int nCmp = (nA>nB ? nB : nA);
3124 int res = memcmp(zA, zB, nCmp);
3125 if( res==0 ) res = nA - nB;
3126 return res;
3127 }
3128 static int SQLITE_TCLAPI test_utf16bin_collate(
3129 void * clientData,
3130 Tcl_Interp *interp,
3131 int objc,
3132 Tcl_Obj *CONST objv[]
3133 ){
3134 sqlite3 *db;
3135 int rc;
3136
3137 if( objc!=2 ) goto bad_args;
3138 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
3139
3140 rc = sqlite3_create_collation(db, "utf16bin", SQLITE_UTF16, 0,
3141 test_utf16bin_collate_func
3142 );
3143 if( sqlite3TestErrCode(interp, db, rc) ) return TCL_ERROR;
3144 return TCL_OK;
3145
3146 bad_args:
3147 Tcl_WrongNumArgs(interp, 1, objv, "DB");
3148 return TCL_ERROR;
3149 }
3150
3151 /*
3152 ** When the collation needed callback is invoked, record the name of
3153 ** the requested collating function here. The recorded name is linked
3154 ** to a TCL variable and used to make sure that the requested collation
3155 ** name is correct.
3156 */
3157 static char zNeededCollation[200];
3158 static char *pzNeededCollation = zNeededCollation;
3159
3160
3161 /*
3162 ** Called when a collating sequence is needed. Registered using
3163 ** sqlite3_collation_needed16().
3164 */
3165 static void test_collate_needed_cb(
3166 void *pCtx,
3167 sqlite3 *db,
3168 int eTextRep,
3169 const void *pName
3170 ){
3171 int enc = ENC(db);
3172 int i;
3173 char *z;
3174 for(z = (char*)pName, i=0; *z || z[1]; z++){
3175 if( *z ) zNeededCollation[i++] = *z;
3176 }
3177 zNeededCollation[i] = 0;
3178 sqlite3_create_collation(
3179 db, "test_collate", ENC(db), SQLITE_INT_TO_PTR(enc), test_collate_func);
3180 }
3181
3182 /*
3183 ** Usage: add_test_collate_needed DB
3184 */
3185 static int SQLITE_TCLAPI test_collate_needed(
3186 void * clientData,
3187 Tcl_Interp *interp,
3188 int objc,
3189 Tcl_Obj *CONST objv[]
3190 ){
3191 sqlite3 *db;
3192 int rc;
3193
3194 if( objc!=2 ) goto bad_args;
3195 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
3196 rc = sqlite3_collation_needed16(db, 0, test_collate_needed_cb);
3197 zNeededCollation[0] = 0;
3198 if( sqlite3TestErrCode(interp, db, rc) ) return TCL_ERROR;
3199 return TCL_OK;
3200
3201 bad_args:
3202 Tcl_WrongNumArgs(interp, 1, objv, "DB");
3203 return TCL_ERROR;
3204 }
3205
3206 /*
3207 ** tclcmd: add_alignment_test_collations DB
3208 **
3209 ** Add two new collating sequences to the database DB
3210 **
3211 ** utf16_aligned
3212 ** utf16_unaligned
3213 **
3214 ** Both collating sequences use the same sort order as BINARY.
3215 ** The only difference is that the utf16_aligned collating
3216 ** sequence is declared with the SQLITE_UTF16_ALIGNED flag.
3217 ** Both collating functions increment the unaligned utf16 counter
3218 ** whenever they see a string that begins on an odd byte boundary.
3219 */
3220 static int unaligned_string_counter = 0;
3221 static int alignmentCollFunc(
3222 void *NotUsed,
3223 int nKey1, const void *pKey1,
3224 int nKey2, const void *pKey2
3225 ){
3226 int rc, n;
3227 n = nKey1<nKey2 ? nKey1 : nKey2;
3228 if( nKey1>0 && 1==(1&(SQLITE_PTR_TO_INT(pKey1))) ) unaligned_string_counter++;
3229 if( nKey2>0 && 1==(1&(SQLITE_PTR_TO_INT(pKey2))) ) unaligned_string_counter++;
3230 rc = memcmp(pKey1, pKey2, n);
3231 if( rc==0 ){
3232 rc = nKey1 - nKey2;
3233 }
3234 return rc;
3235 }
3236 static int SQLITE_TCLAPI add_alignment_test_collations(
3237 void * clientData,
3238 Tcl_Interp *interp,
3239 int objc,
3240 Tcl_Obj *CONST objv[]
3241 ){
3242 sqlite3 *db;
3243 if( objc>=2 ){
3244 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
3245 sqlite3_create_collation(db, "utf16_unaligned", SQLITE_UTF16,
3246 0, alignmentCollFunc);
3247 sqlite3_create_collation(db, "utf16_aligned", SQLITE_UTF16_ALIGNED,
3248 0, alignmentCollFunc);
3249 }
3250 return SQLITE_OK;
3251 }
3252 #endif /* !defined(SQLITE_OMIT_UTF16) */
3253
3254 /*
3255 ** Usage: add_test_function <db ptr> <utf8> <utf16le> <utf16be>
3256 **
3257 ** This function is used to test that SQLite selects the correct user
3258 ** function callback when multiple versions (for different text encodings)
3259 ** are available.
3260 **
3261 ** Calling this routine registers up to three versions of the user function
3262 ** "test_function" with database handle <db>. If the second argument is
3263 ** true, then a version of test_function is registered for UTF-8, if the
3264 ** third is true, a version is registered for UTF-16le, if the fourth is
3265 ** true, a UTF-16be version is available. Previous versions of
3266 ** test_function are deleted.
3267 **
3268 ** The user function is implemented by calling the following TCL script:
3269 **
3270 ** "test_function <enc> <arg>"
3271 **
3272 ** Where <enc> is one of UTF-8, UTF-16LE or UTF16BE, and <arg> is the
3273 ** single argument passed to the SQL function. The value returned by
3274 ** the TCL script is used as the return value of the SQL function. It
3275 ** is passed to SQLite using UTF-16BE for a UTF-8 test_function(), UTF-8
3276 ** for a UTF-16LE test_function(), and UTF-16LE for an implementation that
3277 ** prefers UTF-16BE.
3278 */
3279 #ifndef SQLITE_OMIT_UTF16
3280 static void test_function_utf8(
3281 sqlite3_context *pCtx,
3282 int nArg,
3283 sqlite3_value **argv
3284 ){
3285 Tcl_Interp *interp;
3286 Tcl_Obj *pX;
3287 sqlite3_value *pVal;
3288 interp = (Tcl_Interp *)sqlite3_user_data(pCtx);
3289 pX = Tcl_NewStringObj("test_function", -1);
3290 Tcl_IncrRefCount(pX);
3291 Tcl_ListObjAppendElement(interp, pX, Tcl_NewStringObj("UTF-8", -1));
3292 Tcl_ListObjAppendElement(interp, pX,
3293 Tcl_NewStringObj((char*)sqlite3_value_text(argv[0]), -1));
3294 Tcl_EvalObjEx(interp, pX, 0);
3295 Tcl_DecrRefCount(pX);
3296 sqlite3_result_text(pCtx, Tcl_GetStringResult(interp), -1, SQLITE_TRANSIENT);
3297 pVal = sqlite3ValueNew(0);
3298 sqlite3ValueSetStr(pVal, -1, Tcl_GetStringResult(interp),
3299 SQLITE_UTF8, SQLITE_STATIC);
3300 sqlite3_result_text16be(pCtx, sqlite3_value_text16be(pVal),
3301 -1, SQLITE_TRANSIENT);
3302 sqlite3ValueFree(pVal);
3303 }
3304 static void test_function_utf16le(
3305 sqlite3_context *pCtx,
3306 int nArg,
3307 sqlite3_value **argv
3308 ){
3309 Tcl_Interp *interp;
3310 Tcl_Obj *pX;
3311 sqlite3_value *pVal;
3312 interp = (Tcl_Interp *)sqlite3_user_data(pCtx);
3313 pX = Tcl_NewStringObj("test_function", -1);
3314 Tcl_IncrRefCount(pX);
3315 Tcl_ListObjAppendElement(interp, pX, Tcl_NewStringObj("UTF-16LE", -1));
3316 Tcl_ListObjAppendElement(interp, pX,
3317 Tcl_NewStringObj((char*)sqlite3_value_text(argv[0]), -1));
3318 Tcl_EvalObjEx(interp, pX, 0);
3319 Tcl_DecrRefCount(pX);
3320 pVal = sqlite3ValueNew(0);
3321 sqlite3ValueSetStr(pVal, -1, Tcl_GetStringResult(interp),
3322 SQLITE_UTF8, SQLITE_STATIC);
3323 sqlite3_result_text(pCtx,(char*)sqlite3_value_text(pVal),-1,SQLITE_TRANSIENT);
3324 sqlite3ValueFree(pVal);
3325 }
3326 static void test_function_utf16be(
3327 sqlite3_context *pCtx,
3328 int nArg,
3329 sqlite3_value **argv
3330 ){
3331 Tcl_Interp *interp;
3332 Tcl_Obj *pX;
3333 sqlite3_value *pVal;
3334 interp = (Tcl_Interp *)sqlite3_user_data(pCtx);
3335 pX = Tcl_NewStringObj("test_function", -1);
3336 Tcl_IncrRefCount(pX);
3337 Tcl_ListObjAppendElement(interp, pX, Tcl_NewStringObj("UTF-16BE", -1));
3338 Tcl_ListObjAppendElement(interp, pX,
3339 Tcl_NewStringObj((char*)sqlite3_value_text(argv[0]), -1));
3340 Tcl_EvalObjEx(interp, pX, 0);
3341 Tcl_DecrRefCount(pX);
3342 pVal = sqlite3ValueNew(0);
3343 sqlite3ValueSetStr(pVal, -1, Tcl_GetStringResult(interp),
3344 SQLITE_UTF8, SQLITE_STATIC);
3345 sqlite3_result_text16(pCtx, sqlite3_value_text16le(pVal),
3346 -1, SQLITE_TRANSIENT);
3347 sqlite3_result_text16be(pCtx, sqlite3_value_text16le(pVal),
3348 -1, SQLITE_TRANSIENT);
3349 sqlite3_result_text16le(pCtx, sqlite3_value_text16le(pVal),
3350 -1, SQLITE_TRANSIENT);
3351 sqlite3ValueFree(pVal);
3352 }
3353 #endif /* SQLITE_OMIT_UTF16 */
3354 static int SQLITE_TCLAPI test_function(
3355 void * clientData,
3356 Tcl_Interp *interp,
3357 int objc,
3358 Tcl_Obj *CONST objv[]
3359 ){
3360 #ifndef SQLITE_OMIT_UTF16
3361 sqlite3 *db;
3362 int val;
3363
3364 if( objc!=5 ) goto bad_args;
3365 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
3366
3367 if( TCL_OK!=Tcl_GetBooleanFromObj(interp, objv[2], &val) ) return TCL_ERROR;
3368 if( val ){
3369 sqlite3_create_function(db, "test_function", 1, SQLITE_UTF8,
3370 interp, test_function_utf8, 0, 0);
3371 }
3372 if( TCL_OK!=Tcl_GetBooleanFromObj(interp, objv[3], &val) ) return TCL_ERROR;
3373 if( val ){
3374 sqlite3_create_function(db, "test_function", 1, SQLITE_UTF16LE,
3375 interp, test_function_utf16le, 0, 0);
3376 }
3377 if( TCL_OK!=Tcl_GetBooleanFromObj(interp, objv[4], &val) ) return TCL_ERROR;
3378 if( val ){
3379 sqlite3_create_function(db, "test_function", 1, SQLITE_UTF16BE,
3380 interp, test_function_utf16be, 0, 0);
3381 }
3382
3383 return TCL_OK;
3384 bad_args:
3385 Tcl_AppendResult(interp, "wrong # args: should be \"",
3386 Tcl_GetStringFromObj(objv[0], 0), " <DB> <utf8> <utf16le> <utf16be>", 0);
3387 #endif /* SQLITE_OMIT_UTF16 */
3388 return TCL_ERROR;
3389 }
3390
3391 /*
3392 ** Usage: sqlite3_test_errstr <err code>
3393 **
3394 ** Test that the english language string equivalents for sqlite error codes
3395 ** are sane. The parameter is an integer representing an sqlite error code.
3396 ** The result is a list of two elements, the string representation of the
3397 ** error code and the english language explanation.
3398 */
3399 static int SQLITE_TCLAPI test_errstr(
3400 void * clientData,
3401 Tcl_Interp *interp,
3402 int objc,
3403 Tcl_Obj *CONST objv[]
3404 ){
3405 char *zCode;
3406 int i;
3407 if( objc!=1 ){
3408 Tcl_WrongNumArgs(interp, 1, objv, "<error code>");
3409 }
3410
3411 zCode = Tcl_GetString(objv[1]);
3412 for(i=0; i<200; i++){
3413 if( 0==strcmp(t1ErrorName(i), zCode) ) break;
3414 }
3415 Tcl_SetResult(interp, (char *)sqlite3ErrStr(i), 0);
3416 return TCL_OK;
3417 }
3418
3419 /*
3420 ** Usage: breakpoint
3421 **
3422 ** This routine exists for one purpose - to provide a place to put a
3423 ** breakpoint with GDB that can be triggered using TCL code. The use
3424 ** for this is when a particular test fails on (say) the 1485th iteration.
3425 ** In the TCL test script, we can add code like this:
3426 **
3427 ** if {$i==1485} breakpoint
3428 **
3429 ** Then run testfixture in the debugger and wait for the breakpoint to
3430 ** fire. Then additional breakpoints can be set to trace down the bug.
3431 */
3432 static int SQLITE_TCLAPI test_breakpoint(
3433 void *NotUsed,
3434 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
3435 int argc, /* Number of arguments */
3436 char **argv /* Text of each argument */
3437 ){
3438 return TCL_OK; /* Do nothing */
3439 }
3440
3441 /*
3442 ** Usage: sqlite3_bind_zeroblob STMT IDX N
3443 **
3444 ** Test the sqlite3_bind_zeroblob interface. STMT is a prepared statement.
3445 ** IDX is the index of a wildcard in the prepared statement. This command
3446 ** binds a N-byte zero-filled BLOB to the wildcard.
3447 */
3448 static int SQLITE_TCLAPI test_bind_zeroblob(
3449 void * clientData,
3450 Tcl_Interp *interp,
3451 int objc,
3452 Tcl_Obj *CONST objv[]
3453 ){
3454 sqlite3_stmt *pStmt;
3455 int idx;
3456 int n;
3457 int rc;
3458
3459 if( objc!=4 ){
3460 Tcl_WrongNumArgs(interp, 1, objv, "STMT IDX N");
3461 return TCL_ERROR;
3462 }
3463
3464 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
3465 if( Tcl_GetIntFromObj(interp, objv[2], &idx) ) return TCL_ERROR;
3466 if( Tcl_GetIntFromObj(interp, objv[3], &n) ) return TCL_ERROR;
3467
3468 rc = sqlite3_bind_zeroblob(pStmt, idx, n);
3469 if( sqlite3TestErrCode(interp, StmtToDb(pStmt), rc) ) return TCL_ERROR;
3470 if( rc!=SQLITE_OK ){
3471 return TCL_ERROR;
3472 }
3473
3474 return TCL_OK;
3475 }
3476
3477 /*
3478 ** Usage: sqlite3_bind_zeroblob64 STMT IDX N
3479 **
3480 ** Test the sqlite3_bind_zeroblob64 interface. STMT is a prepared statement.
3481 ** IDX is the index of a wildcard in the prepared statement. This command
3482 ** binds a N-byte zero-filled BLOB to the wildcard.
3483 */
3484 static int SQLITE_TCLAPI test_bind_zeroblob64(
3485 void * clientData,
3486 Tcl_Interp *interp,
3487 int objc,
3488 Tcl_Obj *CONST objv[]
3489 ){
3490 sqlite3_stmt *pStmt;
3491 int idx;
3492 Tcl_WideInt n;
3493 int rc;
3494
3495 if( objc!=4 ){
3496 Tcl_WrongNumArgs(interp, 1, objv, "STMT IDX N");
3497 return TCL_ERROR;
3498 }
3499
3500 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
3501 if( Tcl_GetIntFromObj(interp, objv[2], &idx) ) return TCL_ERROR;
3502 if( Tcl_GetWideIntFromObj(interp, objv[3], &n) ) return TCL_ERROR;
3503
3504 rc = sqlite3_bind_zeroblob64(pStmt, idx, n);
3505 if( sqlite3TestErrCode(interp, StmtToDb(pStmt), rc) ) return TCL_ERROR;
3506 if( rc!=SQLITE_OK ){
3507 Tcl_AppendResult(interp, sqlite3ErrName(rc), 0);
3508 return TCL_ERROR;
3509 }
3510
3511 return TCL_OK;
3512 }
3513
3514 /*
3515 ** Usage: sqlite3_bind_int STMT N VALUE
3516 **
3517 ** Test the sqlite3_bind_int interface. STMT is a prepared statement.
3518 ** N is the index of a wildcard in the prepared statement. This command
3519 ** binds a 32-bit integer VALUE to that wildcard.
3520 */
3521 static int SQLITE_TCLAPI test_bind_int(
3522 void * clientData,
3523 Tcl_Interp *interp,
3524 int objc,
3525 Tcl_Obj *CONST objv[]
3526 ){
3527 sqlite3_stmt *pStmt;
3528 int idx;
3529 int value;
3530 int rc;
3531
3532 if( objc!=4 ){
3533 Tcl_AppendResult(interp, "wrong # args: should be \"",
3534 Tcl_GetStringFromObj(objv[0], 0), " STMT N VALUE", 0);
3535 return TCL_ERROR;
3536 }
3537
3538 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
3539 if( Tcl_GetIntFromObj(interp, objv[2], &idx) ) return TCL_ERROR;
3540 if( Tcl_GetIntFromObj(interp, objv[3], &value) ) return TCL_ERROR;
3541
3542 rc = sqlite3_bind_int(pStmt, idx, value);
3543 if( sqlite3TestErrCode(interp, StmtToDb(pStmt), rc) ) return TCL_ERROR;
3544 if( rc!=SQLITE_OK ){
3545 return TCL_ERROR;
3546 }
3547
3548 return TCL_OK;
3549 }
3550
3551
3552 /*
3553 ** Usage: intarray_addr INT ...
3554 **
3555 ** Return the address of a C-language array of 32-bit integers.
3556 **
3557 ** Space to hold the array is obtained from malloc(). Call this procedure once
3558 ** with no arguments in order to release memory. Each call to this procedure
3559 ** overwrites the previous array.
3560 */
3561 static int SQLITE_TCLAPI test_intarray_addr(
3562 void * clientData,
3563 Tcl_Interp *interp,
3564 int objc,
3565 Tcl_Obj *CONST objv[]
3566 ){
3567 int i;
3568 static int *p = 0;
3569
3570 sqlite3_free(p);
3571 p = 0;
3572 if( objc>1 ){
3573 p = sqlite3_malloc( sizeof(p[0])*(objc-1) );
3574 if( p==0 ) return TCL_ERROR;
3575 for(i=0; i<objc-1; i++){
3576 if( Tcl_GetIntFromObj(interp, objv[1+i], &p[i]) ){
3577 sqlite3_free(p);
3578 p = 0;
3579 return TCL_ERROR;
3580 }
3581 }
3582 }
3583 Tcl_SetObjResult(interp, Tcl_NewWideIntObj((sqlite3_int64)p));
3584 return TCL_OK;
3585 }
3586 /*
3587 ** Usage: intarray_addr INT ...
3588 **
3589 ** Return the address of a C-language array of 32-bit integers.
3590 **
3591 ** Space to hold the array is obtained from malloc(). Call this procedure once
3592 ** with no arguments in order to release memory. Each call to this procedure
3593 ** overwrites the previous array.
3594 */
3595 static int SQLITE_TCLAPI test_int64array_addr(
3596 void * clientData,
3597 Tcl_Interp *interp,
3598 int objc,
3599 Tcl_Obj *CONST objv[]
3600 ){
3601 int i;
3602 static sqlite3_int64 *p = 0;
3603
3604 sqlite3_free(p);
3605 p = 0;
3606 if( objc>1 ){
3607 p = sqlite3_malloc( sizeof(p[0])*(objc-1) );
3608 if( p==0 ) return TCL_ERROR;
3609 for(i=0; i<objc-1; i++){
3610 Tcl_WideInt v;
3611 if( Tcl_GetWideIntFromObj(interp, objv[1+i], &v) ){
3612 sqlite3_free(p);
3613 p = 0;
3614 return TCL_ERROR;
3615 }
3616 p[i] = v;
3617 }
3618 }
3619 Tcl_SetObjResult(interp, Tcl_NewWideIntObj((sqlite3_int64)p));
3620 return TCL_OK;
3621 }
3622 /*
3623 ** Usage: doublearray_addr INT ...
3624 **
3625 ** Return the address of a C-language array of doubles.
3626 **
3627 ** Space to hold the array is obtained from malloc(). Call this procedure once
3628 ** with no arguments in order to release memory. Each call to this procedure
3629 ** overwrites the previous array.
3630 */
3631 static int SQLITE_TCLAPI test_doublearray_addr(
3632 void * clientData,
3633 Tcl_Interp *interp,
3634 int objc,
3635 Tcl_Obj *CONST objv[]
3636 ){
3637 int i;
3638 static double *p = 0;
3639
3640 sqlite3_free(p);
3641 p = 0;
3642 if( objc>1 ){
3643 p = sqlite3_malloc( sizeof(p[0])*(objc-1) );
3644 if( p==0 ) return TCL_ERROR;
3645 for(i=0; i<objc-1; i++){
3646 if( Tcl_GetDoubleFromObj(interp, objv[1+i], &p[i]) ){
3647 sqlite3_free(p);
3648 p = 0;
3649 return TCL_ERROR;
3650 }
3651 }
3652 }
3653 Tcl_SetObjResult(interp, Tcl_NewWideIntObj((sqlite3_int64)p));
3654 return TCL_OK;
3655 }
3656 /*
3657 ** Usage: textarray_addr TEXT ...
3658 **
3659 ** Return the address of a C-language array of strings.
3660 **
3661 ** Space to hold the array is obtained from malloc(). Call this procedure once
3662 ** with no arguments in order to release memory. Each call to this procedure
3663 ** overwrites the previous array.
3664 */
3665 static int SQLITE_TCLAPI test_textarray_addr(
3666 void * clientData,
3667 Tcl_Interp *interp,
3668 int objc,
3669 Tcl_Obj *CONST objv[]
3670 ){
3671 int i;
3672 static int n = 0;
3673 static char **p = 0;
3674
3675 for(i=0; i<n; i++) sqlite3_free(p[i]);
3676 sqlite3_free(p);
3677 p = 0;
3678 if( objc>1 ){
3679 p = sqlite3_malloc( sizeof(p[0])*(objc-1) );
3680 if( p==0 ) return TCL_ERROR;
3681 for(i=0; i<objc-1; i++){
3682 p[i] = sqlite3_mprintf("%s", Tcl_GetString(objv[1+i]));
3683 }
3684 }
3685 n = objc-1;
3686 Tcl_SetObjResult(interp, Tcl_NewWideIntObj((sqlite3_int64)p));
3687 return TCL_OK;
3688 }
3689
3690
3691 /*
3692 ** Usage: sqlite3_bind_int64 STMT N VALUE
3693 **
3694 ** Test the sqlite3_bind_int64 interface. STMT is a prepared statement.
3695 ** N is the index of a wildcard in the prepared statement. This command
3696 ** binds a 64-bit integer VALUE to that wildcard.
3697 */
3698 static int SQLITE_TCLAPI test_bind_int64(
3699 void * clientData,
3700 Tcl_Interp *interp,
3701 int objc,
3702 Tcl_Obj *CONST objv[]
3703 ){
3704 sqlite3_stmt *pStmt;
3705 int idx;
3706 Tcl_WideInt value;
3707 int rc;
3708
3709 if( objc!=4 ){
3710 Tcl_AppendResult(interp, "wrong # args: should be \"",
3711 Tcl_GetStringFromObj(objv[0], 0), " STMT N VALUE", 0);
3712 return TCL_ERROR;
3713 }
3714
3715 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
3716 if( Tcl_GetIntFromObj(interp, objv[2], &idx) ) return TCL_ERROR;
3717 if( Tcl_GetWideIntFromObj(interp, objv[3], &value) ) return TCL_ERROR;
3718
3719 rc = sqlite3_bind_int64(pStmt, idx, value);
3720 if( sqlite3TestErrCode(interp, StmtToDb(pStmt), rc) ) return TCL_ERROR;
3721 if( rc!=SQLITE_OK ){
3722 return TCL_ERROR;
3723 }
3724
3725 return TCL_OK;
3726 }
3727
3728
3729 /*
3730 ** Usage: sqlite3_bind_double STMT N VALUE
3731 **
3732 ** Test the sqlite3_bind_double interface. STMT is a prepared statement.
3733 ** N is the index of a wildcard in the prepared statement. This command
3734 ** binds a 64-bit integer VALUE to that wildcard.
3735 */
3736 static int SQLITE_TCLAPI test_bind_double(
3737 void * clientData,
3738 Tcl_Interp *interp,
3739 int objc,
3740 Tcl_Obj *CONST objv[]
3741 ){
3742 sqlite3_stmt *pStmt;
3743 int idx;
3744 double value = 0;
3745 int rc;
3746 const char *zVal;
3747 int i;
3748 static const struct {
3749 const char *zName; /* Name of the special floating point value */
3750 unsigned int iUpper; /* Upper 32 bits */
3751 unsigned int iLower; /* Lower 32 bits */
3752 } aSpecialFp[] = {
3753 { "NaN", 0x7fffffff, 0xffffffff },
3754 { "SNaN", 0x7ff7ffff, 0xffffffff },
3755 { "-NaN", 0xffffffff, 0xffffffff },
3756 { "-SNaN", 0xfff7ffff, 0xffffffff },
3757 { "+Inf", 0x7ff00000, 0x00000000 },
3758 { "-Inf", 0xfff00000, 0x00000000 },
3759 { "Epsilon", 0x00000000, 0x00000001 },
3760 { "-Epsilon", 0x80000000, 0x00000001 },
3761 { "NaN0", 0x7ff80000, 0x00000000 },
3762 { "-NaN0", 0xfff80000, 0x00000000 },
3763 };
3764
3765 if( objc!=4 ){
3766 Tcl_AppendResult(interp, "wrong # args: should be \"",
3767 Tcl_GetStringFromObj(objv[0], 0), " STMT N VALUE", 0);
3768 return TCL_ERROR;
3769 }
3770
3771 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
3772 if( Tcl_GetIntFromObj(interp, objv[2], &idx) ) return TCL_ERROR;
3773
3774 /* Intercept the string "NaN" and generate a NaN value for it.
3775 ** All other strings are passed through to Tcl_GetDoubleFromObj().
3776 ** Tcl_GetDoubleFromObj() should understand "NaN" but some versions
3777 ** contain a bug.
3778 */
3779 zVal = Tcl_GetString(objv[3]);
3780 for(i=0; i<sizeof(aSpecialFp)/sizeof(aSpecialFp[0]); i++){
3781 if( strcmp(aSpecialFp[i].zName, zVal)==0 ){
3782 sqlite3_uint64 x;
3783 x = aSpecialFp[i].iUpper;
3784 x <<= 32;
3785 x |= aSpecialFp[i].iLower;
3786 assert( sizeof(value)==8 );
3787 assert( sizeof(x)==8 );
3788 memcpy(&value, &x, 8);
3789 break;
3790 }
3791 }
3792 if( i>=sizeof(aSpecialFp)/sizeof(aSpecialFp[0]) &&
3793 Tcl_GetDoubleFromObj(interp, objv[3], &value) ){
3794 return TCL_ERROR;
3795 }
3796 rc = sqlite3_bind_double(pStmt, idx, value);
3797 if( sqlite3TestErrCode(interp, StmtToDb(pStmt), rc) ) return TCL_ERROR;
3798 if( rc!=SQLITE_OK ){
3799 return TCL_ERROR;
3800 }
3801
3802 return TCL_OK;
3803 }
3804
3805 /*
3806 ** Usage: sqlite3_bind_null STMT N
3807 **
3808 ** Test the sqlite3_bind_null interface. STMT is a prepared statement.
3809 ** N is the index of a wildcard in the prepared statement. This command
3810 ** binds a NULL to the wildcard.
3811 */
3812 static int SQLITE_TCLAPI test_bind_null(
3813 void * clientData,
3814 Tcl_Interp *interp,
3815 int objc,
3816 Tcl_Obj *CONST objv[]
3817 ){
3818 sqlite3_stmt *pStmt;
3819 int idx;
3820 int rc;
3821
3822 if( objc!=3 ){
3823 Tcl_AppendResult(interp, "wrong # args: should be \"",
3824 Tcl_GetStringFromObj(objv[0], 0), " STMT N", 0);
3825 return TCL_ERROR;
3826 }
3827
3828 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
3829 if( Tcl_GetIntFromObj(interp, objv[2], &idx) ) return TCL_ERROR;
3830
3831 rc = sqlite3_bind_null(pStmt, idx);
3832 if( sqlite3TestErrCode(interp, StmtToDb(pStmt), rc) ) return TCL_ERROR;
3833 if( rc!=SQLITE_OK ){
3834 return TCL_ERROR;
3835 }
3836
3837 return TCL_OK;
3838 }
3839
3840 /*
3841 ** Usage: sqlite3_bind_text STMT N STRING BYTES
3842 **
3843 ** Test the sqlite3_bind_text interface. STMT is a prepared statement.
3844 ** N is the index of a wildcard in the prepared statement. This command
3845 ** binds a UTF-8 string STRING to the wildcard. The string is BYTES bytes
3846 ** long.
3847 */
3848 static int SQLITE_TCLAPI test_bind_text(
3849 void * clientData,
3850 Tcl_Interp *interp,
3851 int objc,
3852 Tcl_Obj *CONST objv[]
3853 ){
3854 sqlite3_stmt *pStmt;
3855 int idx;
3856 int trueLength = 0;
3857 int bytes;
3858 char *value;
3859 int rc;
3860 char *toFree = 0;
3861
3862 if( objc!=5 ){
3863 Tcl_AppendResult(interp, "wrong # args: should be \"",
3864 Tcl_GetStringFromObj(objv[0], 0), " STMT N VALUE BYTES", 0);
3865 return TCL_ERROR;
3866 }
3867
3868 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
3869 if( Tcl_GetIntFromObj(interp, objv[2], &idx) ) return TCL_ERROR;
3870 value = (char*)Tcl_GetByteArrayFromObj(objv[3], &trueLength);
3871 if( Tcl_GetIntFromObj(interp, objv[4], &bytes) ) return TCL_ERROR;
3872 if( bytes<0 ){
3873 toFree = malloc( trueLength + 1 );
3874 if( toFree==0 ){
3875 Tcl_AppendResult(interp, "out of memory", (void*)0);
3876 return TCL_ERROR;
3877 }
3878 memcpy(toFree, value, trueLength);
3879 toFree[trueLength] = 0;
3880 value = toFree;
3881 }
3882 rc = sqlite3_bind_text(pStmt, idx, value, bytes, SQLITE_TRANSIENT);
3883 free(toFree);
3884 if( sqlite3TestErrCode(interp, StmtToDb(pStmt), rc) ) return TCL_ERROR;
3885 if( rc!=SQLITE_OK ){
3886 Tcl_AppendResult(interp, sqlite3ErrName(rc), (void*)0);
3887 return TCL_ERROR;
3888 }
3889
3890 return TCL_OK;
3891 }
3892
3893 /*
3894 ** Usage: sqlite3_bind_text16 ?-static? STMT N STRING BYTES
3895 **
3896 ** Test the sqlite3_bind_text16 interface. STMT is a prepared statement.
3897 ** N is the index of a wildcard in the prepared statement. This command
3898 ** binds a UTF-16 string STRING to the wildcard. The string is BYTES bytes
3899 ** long.
3900 */
3901 static int SQLITE_TCLAPI test_bind_text16(
3902 void * clientData,
3903 Tcl_Interp *interp,
3904 int objc,
3905 Tcl_Obj *CONST objv[]
3906 ){
3907 #ifndef SQLITE_OMIT_UTF16
3908 sqlite3_stmt *pStmt;
3909 int idx;
3910 int bytes;
3911 char *value;
3912 char *toFree = 0;
3913 int rc;
3914 int trueLength = 0;
3915
3916 void (*xDel)(void*) = (objc==6?SQLITE_STATIC:SQLITE_TRANSIENT);
3917 Tcl_Obj *oStmt = objv[objc-4];
3918 Tcl_Obj *oN = objv[objc-3];
3919 Tcl_Obj *oString = objv[objc-2];
3920 Tcl_Obj *oBytes = objv[objc-1];
3921
3922 if( objc!=5 && objc!=6){
3923 Tcl_AppendResult(interp, "wrong # args: should be \"",
3924 Tcl_GetStringFromObj(objv[0], 0), " STMT N VALUE BYTES", 0);
3925 return TCL_ERROR;
3926 }
3927
3928 if( getStmtPointer(interp, Tcl_GetString(oStmt), &pStmt) ) return TCL_ERROR;
3929 if( Tcl_GetIntFromObj(interp, oN, &idx) ) return TCL_ERROR;
3930 value = (char*)Tcl_GetByteArrayFromObj(oString, &trueLength);
3931 if( Tcl_GetIntFromObj(interp, oBytes, &bytes) ) return TCL_ERROR;
3932 if( bytes<0 && xDel==SQLITE_TRANSIENT ){
3933 toFree = malloc( trueLength + 3 );
3934 if( toFree==0 ){
3935 Tcl_AppendResult(interp, "out of memory", (void*)0);
3936 return TCL_ERROR;
3937 }
3938 memcpy(toFree, value, trueLength);
3939 memset(toFree+trueLength, 0, 3);
3940 value = toFree;
3941 }
3942 rc = sqlite3_bind_text16(pStmt, idx, (void *)value, bytes, xDel);
3943 free(toFree);
3944 if( sqlite3TestErrCode(interp, StmtToDb(pStmt), rc) ) return TCL_ERROR;
3945 if( rc!=SQLITE_OK ){
3946 Tcl_AppendResult(interp, sqlite3ErrName(rc), 0);
3947 return TCL_ERROR;
3948 }
3949
3950 #endif /* SQLITE_OMIT_UTF16 */
3951 return TCL_OK;
3952 }
3953
3954 /*
3955 ** Usage: sqlite3_bind_blob ?-static? STMT N DATA BYTES
3956 **
3957 ** Test the sqlite3_bind_blob interface. STMT is a prepared statement.
3958 ** N is the index of a wildcard in the prepared statement. This command
3959 ** binds a BLOB to the wildcard. The BLOB is BYTES bytes in size.
3960 */
3961 static int SQLITE_TCLAPI test_bind_blob(
3962 void * clientData,
3963 Tcl_Interp *interp,
3964 int objc,
3965 Tcl_Obj *CONST objv[]
3966 ){
3967 sqlite3_stmt *pStmt;
3968 int len, idx;
3969 int bytes;
3970 char *value;
3971 int rc;
3972 sqlite3_destructor_type xDestructor = SQLITE_TRANSIENT;
3973
3974 if( objc!=5 && objc!=6 ){
3975 Tcl_AppendResult(interp, "wrong # args: should be \"",
3976 Tcl_GetStringFromObj(objv[0], 0), " STMT N DATA BYTES", 0);
3977 return TCL_ERROR;
3978 }
3979
3980 if( objc==6 ){
3981 xDestructor = SQLITE_STATIC;
3982 objv++;
3983 }
3984
3985 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
3986 if( Tcl_GetIntFromObj(interp, objv[2], &idx) ) return TCL_ERROR;
3987
3988 value = (char*)Tcl_GetByteArrayFromObj(objv[3], &len);
3989 if( Tcl_GetIntFromObj(interp, objv[4], &bytes) ) return TCL_ERROR;
3990
3991 if( bytes>len ){
3992 char zBuf[200];
3993 sqlite3_snprintf(sizeof(zBuf), zBuf,
3994 "cannot use %d blob bytes, have %d", bytes, len);
3995 Tcl_AppendResult(interp, zBuf, (char*)0);
3996 return TCL_ERROR;
3997 }
3998
3999 rc = sqlite3_bind_blob(pStmt, idx, value, bytes, xDestructor);
4000 if( sqlite3TestErrCode(interp, StmtToDb(pStmt), rc) ) return TCL_ERROR;
4001 if( rc!=SQLITE_OK ){
4002 return TCL_ERROR;
4003 }
4004
4005 return TCL_OK;
4006 }
4007
4008 /*
4009 ** Usage: sqlite3_bind_value_from_preupdate STMT N NEW|OLD IDX
4010 **
4011 ** Test the sqlite3_bind_value interface using sqlite3_value objects
4012 ** obtained from either sqlite3_preupdate_new() (if arg[3]=="new") or
4013 ** sqlite3_preupdate_old() if (arg[3]=="old"). IDX is the index to
4014 ** pass to the sqlite3_preupdate_xxx() function.
4015 */
4016 static int SQLITE_TCLAPI test_bind_value_from_preupdate(
4017 void * clientData,
4018 Tcl_Interp *interp,
4019 int objc,
4020 Tcl_Obj *CONST objv[]
4021 ){
4022 sqlite3_stmt *pStmt;
4023 int idx;
4024 int bidx;
4025 const char *z3 = 0;
4026 sqlite3 *db = 0;
4027 sqlite3_value *pVal = 0;
4028
4029 if( objc!=5 ){
4030 Tcl_WrongNumArgs(interp, 1, objv, "STMT N NEW|OLD IDX");
4031 return TCL_ERROR;
4032 }
4033
4034 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
4035 if( Tcl_GetIntFromObj(interp, objv[2], &idx) ) return TCL_ERROR;
4036 z3 = Tcl_GetString(objv[3]);
4037 if( Tcl_GetIntFromObj(interp, objv[4], &bidx) ) return TCL_ERROR;
4038 db = sqlite3_db_handle(pStmt);
4039
4040 #ifdef SQLITE_ENABLE_PREUPDATE_HOOK
4041 if( z3[0]=='n' ){
4042 sqlite3_preupdate_new(db, bidx, &pVal);
4043 }else if( z3[0]=='o' ){
4044 sqlite3_preupdate_old(db, bidx, &pVal);
4045 }else{
4046 Tcl_AppendResult(interp, "expected new or old, got: ", z3, (char*)0);
4047 return TCL_ERROR;
4048 }
4049 sqlite3_bind_value(pStmt, idx, pVal);
4050 #endif
4051
4052 return TCL_OK;
4053 }
4054
4055 /*
4056 ** Usage: sqlite3_bind_value_from_select STMT N SELECT
4057 **
4058 ** Test the sqlite3_bind_value interface. STMT is a prepared statement.
4059 ** N is the index of a wildcard in the prepared statement.
4060 */
4061 static int SQLITE_TCLAPI test_bind_value_from_select(
4062 void * clientData,
4063 Tcl_Interp *interp,
4064 int objc,
4065 Tcl_Obj *CONST objv[]
4066 ){
4067 sqlite3_stmt *pStmt;
4068 sqlite3_stmt *pStmt2;
4069 int idx;
4070 const char *zSql = 0;
4071 sqlite3 *db = 0;
4072 int rc = SQLITE_OK;
4073
4074 if( objc!=4 ){
4075 Tcl_WrongNumArgs(interp, 1, objv, "STMT N SELECT");
4076 return TCL_ERROR;
4077 }
4078
4079 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
4080 if( Tcl_GetIntFromObj(interp, objv[2], &idx) ) return TCL_ERROR;
4081 zSql = Tcl_GetString(objv[3]);
4082 db = sqlite3_db_handle(pStmt);
4083
4084 rc = sqlite3_prepare_v2(db, zSql, -1, &pStmt2, 0);
4085 if( rc!=SQLITE_OK ){
4086 Tcl_AppendResult(interp, "error in SQL: ", sqlite3_errmsg(db), (char*)0);
4087 return TCL_ERROR;
4088 }
4089 if( sqlite3_step(pStmt2)==SQLITE_ROW ){
4090 sqlite3_value *pVal = sqlite3_column_value(pStmt2, 0);
4091 sqlite3_bind_value(pStmt, idx, pVal);
4092 }
4093 rc = sqlite3_finalize(pStmt2);
4094 if( rc!=SQLITE_OK ){
4095 Tcl_AppendResult(interp,
4096 "error runnning SQL: ", sqlite3_errmsg(db), (char*)0
4097 );
4098 return TCL_ERROR;
4099 }
4100
4101 return TCL_OK;
4102 }
4103
4104
4105 #ifndef SQLITE_OMIT_VIRTUALTABLE
4106 /*
4107 ** sqlite3_carray_bind [options...] STMT NAME VALUE ...
4108 **
4109 ** Options:
4110 ** -transient
4111 ** -static
4112 ** -int32
4113 ** -int64
4114 ** -double
4115 ** -text
4116 **
4117 ** Each call clears static data. Called with no options does nothing
4118 ** but clear static data.
4119 */
4120 static int SQLITE_TCLAPI test_carray_bind(
4121 void * clientData,
4122 Tcl_Interp *interp,
4123 int objc,
4124 Tcl_Obj *CONST objv[]
4125 ){
4126 sqlite3_stmt *pStmt;
4127 int eType = 0; /* CARRAY_INT32 */
4128 int nData = 0;
4129 void *aData = 0;
4130 int isTransient = 0;
4131 int isStatic = 0;
4132 int idx;
4133 int i, j;
4134 int rc;
4135 void (*xDel)(void*) = sqlite3_free;
4136 static void *aStaticData = 0;
4137 static int nStaticData = 0;
4138 static int eStaticType = 0;
4139 extern int sqlite3_carray_bind(
4140 sqlite3_stmt *pStmt,
4141 int i,
4142 void *aData,
4143 int nData,
4144 int mFlags,
4145 void (*xDestroy)(void*)
4146 );
4147
4148 if( aStaticData ){
4149 /* Always clear preexisting static data on every call */
4150 if( eStaticType==3 ){
4151 for(i=0; i<nStaticData; i++){
4152 sqlite3_free(((char**)aStaticData)[i]);
4153 }
4154 }
4155 sqlite3_free(aStaticData);
4156 aStaticData = 0;
4157 nStaticData = 0;
4158 eStaticType = 0;
4159 }
4160 if( objc==1 ) return TCL_OK;
4161
4162 for(i=1; i<objc && Tcl_GetString(objv[i])[0]=='-'; i++){
4163 const char *z = Tcl_GetString(objv[i]);
4164 if( strcmp(z, "-transient")==0 ){
4165 isTransient = 1;
4166 xDel = SQLITE_TRANSIENT;
4167 }else
4168 if( strcmp(z, "-static")==0 ){
4169 isStatic = 1;
4170 xDel = SQLITE_STATIC;
4171 }else
4172 if( strcmp(z, "-int32")==0 ){
4173 eType = 0; /* CARRAY_INT32 */
4174 }else
4175 if( strcmp(z, "-int64")==0 ){
4176 eType = 1; /* CARRAY_INT64 */
4177 }else
4178 if( strcmp(z, "-double")==0 ){
4179 eType = 2; /* CARRAY_DOUBLE */
4180 }else
4181 if( strcmp(z, "-text")==0 ){
4182 eType = 3; /* CARRAY_TEXT */
4183 }else
4184 if( strcmp(z, "--")==0 ){
4185 break;
4186 }else
4187 {
4188 Tcl_AppendResult(interp, "unknown option: ", z, (char*)0);
4189 return TCL_ERROR;
4190 }
4191 }
4192 if( eType==3 && !isStatic && !isTransient ){
4193 Tcl_AppendResult(interp, "text data must be either -static or -transient",
4194 (char*)0);
4195 return TCL_ERROR;
4196 }
4197 if( isStatic && isTransient ){
4198 Tcl_AppendResult(interp, "cannot be both -static and -transient",
4199 (char*)0);
4200 return TCL_ERROR;
4201 }
4202 if( objc-i < 2 ){
4203 Tcl_WrongNumArgs(interp, 1, objv, "[OPTIONS] STMT IDX VALUE ...");
4204 return TCL_ERROR;
4205 }
4206 if( getStmtPointer(interp, Tcl_GetString(objv[i]), &pStmt) ) return TCL_ERROR;
4207 i++;
4208 if( Tcl_GetIntFromObj(interp, objv[i], &idx) ) return TCL_ERROR;
4209 i++;
4210 nData = objc - i;
4211 switch( eType + 4*(nData<=0) ){
4212 case 0: { /* INT32 */
4213 int *a = sqlite3_malloc( sizeof(int)*nData );
4214 if( a==0 ){ rc = SQLITE_NOMEM; goto carray_bind_done; }
4215 for(j=0; j<nData; j++){
4216 int v;
4217 if( Tcl_GetIntFromObj(interp, objv[i+j], &v) ){
4218 sqlite3_free(a);
4219 return TCL_ERROR;
4220 }
4221 a[j] = v;
4222 }
4223 aData = a;
4224 break;
4225 }
4226 case 1: { /* INT64 */
4227 sqlite3_int64 *a = sqlite3_malloc( sizeof(sqlite3_int64)*nData );
4228 if( a==0 ){ rc = SQLITE_NOMEM; goto carray_bind_done; }
4229 for(j=0; j<nData; j++){
4230 Tcl_WideInt v;
4231 if( Tcl_GetWideIntFromObj(interp, objv[i+j], &v) ){
4232 sqlite3_free(a);
4233 return TCL_ERROR;
4234 }
4235 a[j] = v;
4236 }
4237 aData = a;
4238 break;
4239 }
4240 case 2: { /* DOUBLE */
4241 double *a = sqlite3_malloc( sizeof(double)*nData );
4242 if( a==0 ){ rc = SQLITE_NOMEM; goto carray_bind_done; }
4243 for(j=0; j<nData; j++){
4244 double v;
4245 if( Tcl_GetDoubleFromObj(interp, objv[i+j], &v) ){
4246 sqlite3_free(a);
4247 return TCL_ERROR;
4248 }
4249 a[j] = v;
4250 }
4251 aData = a;
4252 break;
4253 }
4254 case 3: { /* TEXT */
4255 char **a = sqlite3_malloc( sizeof(char*)*nData );
4256 if( a==0 ){ rc = SQLITE_NOMEM; goto carray_bind_done; }
4257 for(j=0; j<nData; j++){
4258 const char *v = Tcl_GetString(objv[i+j]);
4259 a[j] = sqlite3_mprintf("%s", v);
4260 }
4261 aData = a;
4262 break;
4263 }
4264 case 4: { /* nData==0 */
4265 aData = "";
4266 xDel = SQLITE_STATIC;
4267 isTransient = 0;
4268 isStatic = 0;
4269 break;
4270 }
4271 }
4272 if( isStatic ){
4273 aStaticData = aData;
4274 nStaticData = nData;
4275 eStaticType = eType;
4276 }
4277 rc = sqlite3_carray_bind(pStmt, idx, aData, nData, eType, xDel);
4278 if( isTransient ){
4279 if( eType==3 ){
4280 for(i=0; i<nData; i++) sqlite3_free(((char**)aData)[i]);
4281 }
4282 sqlite3_free(aData);
4283 }
4284 carray_bind_done:
4285 if( rc ){
4286 Tcl_AppendResult(interp, sqlite3_errstr(rc), (char*)0);
4287 return TCL_ERROR;
4288 }
4289 return TCL_OK;
4290 }
4291 #endif /* SQLITE_OMIT_VIRTUALTABLE */
4292
4293 /*
4294 ** Usage: sqlite3_bind_parameter_count STMT
4295 **
4296 ** Return the number of wildcards in the given statement.
4297 */
4298 static int SQLITE_TCLAPI test_bind_parameter_count(
4299 void * clientData,
4300 Tcl_Interp *interp,
4301 int objc,
4302 Tcl_Obj *CONST objv[]
4303 ){
4304 sqlite3_stmt *pStmt;
4305
4306 if( objc!=2 ){
4307 Tcl_WrongNumArgs(interp, 1, objv, "STMT");
4308 return TCL_ERROR;
4309 }
4310 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
4311 Tcl_SetObjResult(interp, Tcl_NewIntObj(sqlite3_bind_parameter_count(pStmt)));
4312 return TCL_OK;
4313 }
4314
4315 /*
4316 ** Usage: sqlite3_bind_parameter_name STMT N
4317 **
4318 ** Return the name of the Nth wildcard. The first wildcard is 1.
4319 ** An empty string is returned if N is out of range or if the wildcard
4320 ** is nameless.
4321 */
4322 static int SQLITE_TCLAPI test_bind_parameter_name(
4323 void * clientData,
4324 Tcl_Interp *interp,
4325 int objc,
4326 Tcl_Obj *CONST objv[]
4327 ){
4328 sqlite3_stmt *pStmt;
4329 int i;
4330
4331 if( objc!=3 ){
4332 Tcl_WrongNumArgs(interp, 1, objv, "STMT N");
4333 return TCL_ERROR;
4334 }
4335 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
4336 if( Tcl_GetIntFromObj(interp, objv[2], &i) ) return TCL_ERROR;
4337 Tcl_SetObjResult(interp,
4338 Tcl_NewStringObj(sqlite3_bind_parameter_name(pStmt,i),-1)
4339 );
4340 return TCL_OK;
4341 }
4342
4343 /*
4344 ** Usage: sqlite3_bind_parameter_index STMT NAME
4345 **
4346 ** Return the index of the wildcard called NAME. Return 0 if there is
4347 ** no such wildcard.
4348 */
4349 static int SQLITE_TCLAPI test_bind_parameter_index(
4350 void * clientData,
4351 Tcl_Interp *interp,
4352 int objc,
4353 Tcl_Obj *CONST objv[]
4354 ){
4355 sqlite3_stmt *pStmt;
4356
4357 if( objc!=3 ){
4358 Tcl_WrongNumArgs(interp, 1, objv, "STMT NAME");
4359 return TCL_ERROR;
4360 }
4361 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
4362 Tcl_SetObjResult(interp,
4363 Tcl_NewIntObj(
4364 sqlite3_bind_parameter_index(pStmt,Tcl_GetString(objv[2]))
4365 )
4366 );
4367 return TCL_OK;
4368 }
4369
4370 /*
4371 ** Usage: sqlite3_clear_bindings STMT
4372 **
4373 */
4374 static int SQLITE_TCLAPI test_clear_bindings(
4375 void * clientData,
4376 Tcl_Interp *interp,
4377 int objc,
4378 Tcl_Obj *CONST objv[]
4379 ){
4380 sqlite3_stmt *pStmt;
4381
4382 if( objc!=2 ){
4383 Tcl_WrongNumArgs(interp, 1, objv, "STMT");
4384 return TCL_ERROR;
4385 }
4386 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
4387 Tcl_SetObjResult(interp, Tcl_NewIntObj(sqlite3_clear_bindings(pStmt)));
4388 return TCL_OK;
4389 }
4390
4391 /*
4392 ** Usage: sqlite3_sleep MILLISECONDS
4393 */
4394 static int SQLITE_TCLAPI test_sleep(
4395 void * clientData,
4396 Tcl_Interp *interp,
4397 int objc,
4398 Tcl_Obj *CONST objv[]
4399 ){
4400 int ms;
4401
4402 if( objc!=2 ){
4403 Tcl_WrongNumArgs(interp, 1, objv, "MILLISECONDS");
4404 return TCL_ERROR;
4405 }
4406 if( Tcl_GetIntFromObj(interp, objv[1], &ms) ){
4407 return TCL_ERROR;
4408 }
4409 Tcl_SetObjResult(interp, Tcl_NewIntObj(sqlite3_sleep(ms)));
4410 return TCL_OK;
4411 }
4412
4413 /*
4414 ** Usage: sqlite3_extended_errcode DB
4415 **
4416 ** Return the string representation of the most recent sqlite3_* API
4417 ** error code. e.g. "SQLITE_ERROR".
4418 */
4419 static int SQLITE_TCLAPI test_ex_errcode(
4420 void * clientData,
4421 Tcl_Interp *interp,
4422 int objc,
4423 Tcl_Obj *CONST objv[]
4424 ){
4425 sqlite3 *db;
4426 int rc;
4427
4428 if( objc!=2 ){
4429 Tcl_AppendResult(interp, "wrong # args: should be \"",
4430 Tcl_GetString(objv[0]), " DB", 0);
4431 return TCL_ERROR;
4432 }
4433 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
4434 rc = sqlite3_extended_errcode(db);
4435 Tcl_AppendResult(interp, (char *)t1ErrorName(rc), 0);
4436 return TCL_OK;
4437 }
4438
4439
4440 /*
4441 ** Usage: sqlite3_errcode DB
4442 **
4443 ** Return the string representation of the most recent sqlite3_* API
4444 ** error code. e.g. "SQLITE_ERROR".
4445 */
4446 static int SQLITE_TCLAPI test_errcode(
4447 void * clientData,
4448 Tcl_Interp *interp,
4449 int objc,
4450 Tcl_Obj *CONST objv[]
4451 ){
4452 sqlite3 *db;
4453 int rc;
4454
4455 if( objc!=2 ){
4456 Tcl_AppendResult(interp, "wrong # args: should be \"",
4457 Tcl_GetString(objv[0]), " DB", 0);
4458 return TCL_ERROR;
4459 }
4460 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
4461 rc = sqlite3_errcode(db);
4462 Tcl_AppendResult(interp, (char *)t1ErrorName(rc), 0);
4463 return TCL_OK;
4464 }
4465
4466 /*
4467 ** Usage: sqlite3_errmsg DB
4468 **
4469 ** Returns the UTF-8 representation of the error message string for the
4470 ** most recent sqlite3_* API call.
4471 */
4472 static int SQLITE_TCLAPI test_errmsg(
4473 void * clientData,
4474 Tcl_Interp *interp,
4475 int objc,
4476 Tcl_Obj *CONST objv[]
4477 ){
4478 sqlite3 *db;
4479 const char *zErr;
4480
4481 if( objc!=2 ){
4482 Tcl_AppendResult(interp, "wrong # args: should be \"",
4483 Tcl_GetString(objv[0]), " DB", 0);
4484 return TCL_ERROR;
4485 }
4486 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
4487
4488 zErr = sqlite3_errmsg(db);
4489 Tcl_SetObjResult(interp, Tcl_NewStringObj(zErr, -1));
4490 return TCL_OK;
4491 }
4492
4493
4494 /*
4495 ** Usage: sqlite3_error_offset DB
4496 **
4497 ** Return the byte offset into the input UTF8 SQL for the most recent
4498 ** error, or -1 of the error does not refer to a specific token.
4499 */
4500 static int SQLITE_TCLAPI test_error_offset(
4501 void * clientData,
4502 Tcl_Interp *interp,
4503 int objc,
4504 Tcl_Obj *CONST objv[]
4505 ){
4506 sqlite3 *db;
4507 int iByteOffset;
4508
4509 if( objc!=2 ){
4510 Tcl_AppendResult(interp, "wrong # args: should be \"",
4511 Tcl_GetString(objv[0]), " DB", 0);
4512 return TCL_ERROR;
4513 }
4514 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
4515
4516 iByteOffset = sqlite3_error_offset(db);
4517 Tcl_SetObjResult(interp, Tcl_NewIntObj(iByteOffset));
4518 return TCL_OK;
4519 }
4520
4521 /*
4522 ** Usage: test_errmsg16 DB
4523 **
4524 ** Returns the UTF-16 representation of the error message string for the
4525 ** most recent sqlite3_* API call. This is a byte array object at the TCL
4526 ** level, and it includes the 0x00 0x00 terminator bytes at the end of the
4527 ** UTF-16 string.
4528 */
4529 static int SQLITE_TCLAPI test_errmsg16(
4530 void * clientData,
4531 Tcl_Interp *interp,
4532 int objc,
4533 Tcl_Obj *CONST objv[]
4534 ){
4535 #ifndef SQLITE_OMIT_UTF16
4536 sqlite3 *db;
4537 const void *zErr;
4538 const char *z;
4539 int bytes = 0;
4540
4541 if( objc!=2 ){
4542 Tcl_AppendResult(interp, "wrong # args: should be \"",
4543 Tcl_GetString(objv[0]), " DB", 0);
4544 return TCL_ERROR;
4545 }
4546 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
4547
4548 zErr = sqlite3_errmsg16(db);
4549 if( zErr ){
4550 z = zErr;
4551 for(bytes=0; z[bytes] || z[bytes+1]; bytes+=2){}
4552 }
4553 Tcl_SetObjResult(interp, Tcl_NewByteArrayObj(zErr, bytes));
4554 #endif /* SQLITE_OMIT_UTF16 */
4555 return TCL_OK;
4556 }
4557
4558 /*
4559 ** Usage: sqlite3_prepare DB sql bytes ?tailvar?
4560 **
4561 ** Compile up to <bytes> bytes of the supplied SQL string <sql> using
4562 ** database handle <DB>. The parameter <tailval> is the name of a global
4563 ** variable that is set to the unused portion of <sql> (if any). A
4564 ** STMT handle is returned.
4565 */
4566 static int SQLITE_TCLAPI test_prepare(
4567 void * clientData,
4568 Tcl_Interp *interp,
4569 int objc,
4570 Tcl_Obj *CONST objv[]
4571 ){
4572 sqlite3 *db;
4573 const char *zSql;
4574 int bytes;
4575 const char *zTail = 0;
4576 sqlite3_stmt *pStmt = 0;
4577 char zBuf[50];
4578 int rc;
4579
4580 if( objc!=5 && objc!=4 ){
4581 Tcl_AppendResult(interp, "wrong # args: should be \"",
4582 Tcl_GetString(objv[0]), " DB sql bytes ?tailvar?", 0);
4583 return TCL_ERROR;
4584 }
4585 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
4586 zSql = Tcl_GetString(objv[2]);
4587 if( Tcl_GetIntFromObj(interp, objv[3], &bytes) ) return TCL_ERROR;
4588
4589 rc = sqlite3_prepare(db, zSql, bytes, &pStmt, objc>=5 ? &zTail : 0);
4590 Tcl_ResetResult(interp);
4591 if( sqlite3TestErrCode(interp, db, rc) ) return TCL_ERROR;
4592 if( zTail && objc>=5 ){
4593 if( bytes>=0 ){
4594 bytes = bytes - (int)(zTail-zSql);
4595 }
4596 if( (int)strlen(zTail)<bytes ){
4597 bytes = (int)strlen(zTail);
4598 }
4599 Tcl_ObjSetVar2(interp, objv[4], 0, Tcl_NewStringObj(zTail, bytes), 0);
4600 }
4601 if( rc!=SQLITE_OK ){
4602 assert( pStmt==0 );
4603 sqlite3_snprintf(sizeof(zBuf), zBuf, "(%d) ", rc);
4604 Tcl_AppendResult(interp, zBuf, sqlite3_errmsg(db), 0);
4605 return TCL_ERROR;
4606 }
4607
4608 if( pStmt ){
4609 if( sqlite3TestMakePointerStr(interp, zBuf, pStmt) ) return TCL_ERROR;
4610 Tcl_AppendResult(interp, zBuf, 0);
4611 }
4612 return TCL_OK;
4613 }
4614
4615 /*
4616 ** Usage: sqlite3_prepare_v2 DB sql bytes ?tailvar?
4617 **
4618 ** Compile up to <bytes> bytes of the supplied SQL string <sql> using
4619 ** database handle <DB>. The parameter <tailval> is the name of a global
4620 ** variable that is set to the unused portion of <sql> (if any). A
4621 ** STMT handle is returned.
4622 */
4623 static int SQLITE_TCLAPI test_prepare_v2(
4624 void * clientData,
4625 Tcl_Interp *interp,
4626 int objc,
4627 Tcl_Obj *CONST objv[]
4628 ){
4629 sqlite3 *db;
4630 const char *zSql;
4631 char *zCopy = 0; /* malloc() copy of zSql */
4632 int bytes;
4633 const char *zTail = 0;
4634 const char **pzTail;
4635 sqlite3_stmt *pStmt = 0;
4636 char zBuf[50];
4637 int rc;
4638
4639 if( objc!=5 && objc!=4 ){
4640 Tcl_AppendResult(interp, "wrong # args: should be \"",
4641 Tcl_GetString(objv[0]), " DB sql bytes tailvar", 0);
4642 return TCL_ERROR;
4643 }
4644 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
4645 zSql = Tcl_GetString(objv[2]);
4646 if( Tcl_GetIntFromObj(interp, objv[3], &bytes) ) return TCL_ERROR;
4647
4648 /* Instead of using zSql directly, make a copy into a buffer obtained
4649 ** directly from malloc(). The idea is to make it easier for valgrind
4650 ** to spot buffer overreads. */
4651 if( bytes>=0 ){
4652 zCopy = malloc(bytes);
4653 memcpy(zCopy, zSql, bytes);
4654 }else{
4655 int n = (int)strlen(zSql) + 1;
4656 zCopy = malloc(n);
4657 memcpy(zCopy, zSql, n);
4658 }
4659 pzTail = objc>=5 ? &zTail : 0;
4660 rc = sqlite3_prepare_v2(db, zCopy, bytes, &pStmt, pzTail);
4661 if( objc>=5 ){
4662 zTail = &zSql[(zTail - zCopy)];
4663 }
4664 free(zCopy);
4665
4666 assert(rc==SQLITE_OK || pStmt==0);
4667 Tcl_ResetResult(interp);
4668 if( sqlite3TestErrCode(interp, db, rc) ) return TCL_ERROR;
4669 if( rc==SQLITE_OK && objc>=5 && zTail ){
4670 if( bytes>=0 ){
4671 bytes = bytes - (int)(zTail-zSql);
4672 }
4673 Tcl_ObjSetVar2(interp, objv[4], 0, Tcl_NewStringObj(zTail, bytes), 0);
4674 }
4675 if( rc!=SQLITE_OK ){
4676 assert( pStmt==0 );
4677 sqlite3_snprintf(sizeof(zBuf), zBuf, "(%d) ", rc);
4678 Tcl_AppendResult(interp, zBuf, sqlite3_errmsg(db), 0);
4679 return TCL_ERROR;
4680 }
4681
4682 if( pStmt ){
4683 if( sqlite3TestMakePointerStr(interp, zBuf, pStmt) ) return TCL_ERROR;
4684 Tcl_AppendResult(interp, zBuf, 0);
4685 }
4686 return TCL_OK;
4687 }
4688
4689 /*
4690 ** Usage: sqlite3_prepare_v3 DB sql bytes flags ?tailvar?
4691 **
4692 ** Compile up to <bytes> bytes of the supplied SQL string <sql> using
4693 ** database handle <DB> and flags <flags>. The parameter <tailval> is
4694 ** the name of a global variable that is set to the unused portion of
4695 ** <sql> (if any). A STMT handle is returned.
4696 */
4697 static int SQLITE_TCLAPI test_prepare_v3(
4698 void * clientData,
4699 Tcl_Interp *interp,
4700 int objc,
4701 Tcl_Obj *CONST objv[]
4702 ){
4703 sqlite3 *db;
4704 const char *zSql;
4705 char *zCopy = 0; /* malloc() copy of zSql */
4706 int bytes, flags;
4707 const char *zTail = 0;
4708 const char **pzTail;
4709 sqlite3_stmt *pStmt = 0;
4710 char zBuf[50];
4711 int rc;
4712
4713 if( objc!=6 && objc!=5 ){
4714 Tcl_AppendResult(interp, "wrong # args: should be \"",
4715 Tcl_GetString(objv[0]), " DB sql bytes flags tailvar", 0);
4716 return TCL_ERROR;
4717 }
4718 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
4719 zSql = Tcl_GetString(objv[2]);
4720 if( Tcl_GetIntFromObj(interp, objv[3], &bytes) ) return TCL_ERROR;
4721 if( Tcl_GetIntFromObj(interp, objv[4], &flags) ) return TCL_ERROR;
4722
4723 /* Instead of using zSql directly, make a copy into a buffer obtained
4724 ** directly from malloc(). The idea is to make it easier for valgrind
4725 ** to spot buffer overreads. */
4726 if( bytes>=0 ){
4727 zCopy = malloc(bytes);
4728 memcpy(zCopy, zSql, bytes);
4729 }else{
4730 int n = (int)strlen(zSql) + 1;
4731 zCopy = malloc(n);
4732 memcpy(zCopy, zSql, n);
4733 }
4734 pzTail = objc>=6 ? &zTail : 0;
4735 rc = sqlite3_prepare_v3(db, zCopy, bytes, (unsigned int)flags,&pStmt,pzTail);
4736 free(zCopy);
4737 zTail = &zSql[(zTail - zCopy)];
4738
4739 assert(rc==SQLITE_OK || pStmt==0);
4740 Tcl_ResetResult(interp);
4741 if( sqlite3TestErrCode(interp, db, rc) ) return TCL_ERROR;
4742 if( rc==SQLITE_OK && zTail && objc>=6 ){
4743 if( bytes>=0 ){
4744 bytes = bytes - (int)(zTail-zSql);
4745 }
4746 Tcl_ObjSetVar2(interp, objv[5], 0, Tcl_NewStringObj(zTail, bytes), 0);
4747 }
4748 if( rc!=SQLITE_OK ){
4749 assert( pStmt==0 );
4750 sqlite3_snprintf(sizeof(zBuf), zBuf, "(%d) ", rc);
4751 Tcl_AppendResult(interp, zBuf, sqlite3_errmsg(db), 0);
4752 return TCL_ERROR;
4753 }
4754
4755 if( pStmt ){
4756 if( sqlite3TestMakePointerStr(interp, zBuf, pStmt) ) return TCL_ERROR;
4757 Tcl_AppendResult(interp, zBuf, 0);
4758 }
4759 return TCL_OK;
4760 }
4761
4762 /*
4763 ** Usage: sqlite3_prepare_tkt3134 DB
4764 **
4765 ** Generate a prepared statement for a zero-byte string as a test
4766 ** for ticket #3134. The string should be preceded by a zero byte.
4767 */
4768 static int SQLITE_TCLAPI test_prepare_tkt3134(
4769 void * clientData,
4770 Tcl_Interp *interp,
4771 int objc,
4772 Tcl_Obj *CONST objv[]
4773 ){
4774 sqlite3 *db;
4775 static const char zSql[] = "\000SELECT 1";
4776 sqlite3_stmt *pStmt = 0;
4777 char zBuf[50];
4778 int rc;
4779
4780 if( objc!=2 ){
4781 Tcl_AppendResult(interp, "wrong # args: should be \"",
4782 Tcl_GetString(objv[0]), " DB sql bytes tailvar", 0);
4783 return TCL_ERROR;
4784 }
4785 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
4786 rc = sqlite3_prepare_v2(db, &zSql[1], 0, &pStmt, 0);
4787 assert(rc==SQLITE_OK || pStmt==0);
4788 if( sqlite3TestErrCode(interp, db, rc) ) return TCL_ERROR;
4789 if( rc!=SQLITE_OK ){
4790 assert( pStmt==0 );
4791 sqlite3_snprintf(sizeof(zBuf), zBuf, "(%d) ", rc);
4792 Tcl_AppendResult(interp, zBuf, sqlite3_errmsg(db), 0);
4793 return TCL_ERROR;
4794 }
4795
4796 if( pStmt ){
4797 if( sqlite3TestMakePointerStr(interp, zBuf, pStmt) ) return TCL_ERROR;
4798 Tcl_AppendResult(interp, zBuf, 0);
4799 }
4800 return TCL_OK;
4801 }
4802
4803 /*
4804 ** Usage: sqlite3_prepare16 DB sql bytes tailvar
4805 **
4806 ** Compile up to <bytes> bytes of the supplied SQL string <sql> using
4807 ** database handle <DB>. The parameter <tailval> is the name of a global
4808 ** variable that is set to the unused portion of <sql> (if any). A
4809 ** STMT handle is returned.
4810 */
4811 static int SQLITE_TCLAPI test_prepare16(
4812 void * clientData,
4813 Tcl_Interp *interp,
4814 int objc,
4815 Tcl_Obj *CONST objv[]
4816 ){
4817 #ifndef SQLITE_OMIT_UTF16
4818 sqlite3 *db;
4819 const void *zSql;
4820 const void *zTail = 0;
4821 Tcl_Obj *pTail = 0;
4822 sqlite3_stmt *pStmt = 0;
4823 char zBuf[50];
4824 int rc;
4825 int bytes; /* The integer specified as arg 3 */
4826 int objlen; /* The byte-array length of arg 2 */
4827
4828 if( objc!=5 && objc!=4 ){
4829 Tcl_AppendResult(interp, "wrong # args: should be \"",
4830 Tcl_GetString(objv[0]), " DB sql bytes ?tailvar?", 0);
4831 return TCL_ERROR;
4832 }
4833 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
4834 zSql = Tcl_GetByteArrayFromObj(objv[2], &objlen);
4835 if( Tcl_GetIntFromObj(interp, objv[3], &bytes) ) return TCL_ERROR;
4836
4837 rc = sqlite3_prepare16(db, zSql, bytes, &pStmt, objc>=5 ? &zTail : 0);
4838 if( sqlite3TestErrCode(interp, db, rc) ) return TCL_ERROR;
4839 if( rc ){
4840 return TCL_ERROR;
4841 }
4842
4843 if( objc>=5 ){
4844 if( zTail ){
4845 objlen = objlen - (int)((u8 *)zTail-(u8 *)zSql);
4846 }else{
4847 objlen = 0;
4848 }
4849 pTail = Tcl_NewByteArrayObj((u8 *)zTail, objlen);
4850 Tcl_IncrRefCount(pTail);
4851 Tcl_ObjSetVar2(interp, objv[4], 0, pTail, 0);
4852 Tcl_DecrRefCount(pTail);
4853 }
4854
4855 if( pStmt ){
4856 if( sqlite3TestMakePointerStr(interp, zBuf, pStmt) ) return TCL_ERROR;
4857 }
4858 Tcl_AppendResult(interp, zBuf, 0);
4859 #endif /* SQLITE_OMIT_UTF16 */
4860 return TCL_OK;
4861 }
4862
4863 /*
4864 ** Usage: sqlite3_prepare16_v2 DB sql bytes ?tailvar?
4865 **
4866 ** Compile up to <bytes> bytes of the supplied SQL string <sql> using
4867 ** database handle <DB>. The parameter <tailval> is the name of a global
4868 ** variable that is set to the unused portion of <sql> (if any). A
4869 ** STMT handle is returned.
4870 */
4871 static int SQLITE_TCLAPI test_prepare16_v2(
4872 void * clientData,
4873 Tcl_Interp *interp,
4874 int objc,
4875 Tcl_Obj *CONST objv[]
4876 ){
4877 #ifndef SQLITE_OMIT_UTF16
4878 sqlite3 *db;
4879 const void *zSql;
4880 const void *zTail = 0;
4881 Tcl_Obj *pTail = 0;
4882 sqlite3_stmt *pStmt = 0;
4883 char zBuf[50];
4884 int rc;
4885 int bytes; /* The integer specified as arg 3 */
4886 int objlen; /* The byte-array length of arg 2 */
4887
4888 if( objc!=5 && objc!=4 ){
4889 Tcl_AppendResult(interp, "wrong # args: should be \"",
4890 Tcl_GetString(objv[0]), " DB sql bytes ?tailvar?", 0);
4891 return TCL_ERROR;
4892 }
4893 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
4894 zSql = Tcl_GetByteArrayFromObj(objv[2], &objlen);
4895 if( Tcl_GetIntFromObj(interp, objv[3], &bytes) ) return TCL_ERROR;
4896
4897 rc = sqlite3_prepare16_v2(db, zSql, bytes, &pStmt, objc>=5 ? &zTail : 0);
4898 if( sqlite3TestErrCode(interp, db, rc) ) return TCL_ERROR;
4899 if( rc ){
4900 return TCL_ERROR;
4901 }
4902
4903 if( objc>=5 ){
4904 if( zTail ){
4905 objlen = objlen - (int)((u8 *)zTail-(u8 *)zSql);
4906 }else{
4907 objlen = 0;
4908 }
4909 pTail = Tcl_NewByteArrayObj((u8 *)zTail, objlen);
4910 Tcl_IncrRefCount(pTail);
4911 Tcl_ObjSetVar2(interp, objv[4], 0, pTail, 0);
4912 Tcl_DecrRefCount(pTail);
4913 }
4914
4915 if( pStmt ){
4916 if( sqlite3TestMakePointerStr(interp, zBuf, pStmt) ) return TCL_ERROR;
4917 }
4918 Tcl_AppendResult(interp, zBuf, 0);
4919 #endif /* SQLITE_OMIT_UTF16 */
4920 return TCL_OK;
4921 }
4922
4923 /*
4924 ** Usage: sqlite3_open filename ?options-list?
4925 */
4926 static int SQLITE_TCLAPI test_open(
4927 void * clientData,
4928 Tcl_Interp *interp,
4929 int objc,
4930 Tcl_Obj *CONST objv[]
4931 ){
4932 const char *zFilename;
4933 sqlite3 *db;
4934 char zBuf[100];
4935
4936 if( objc!=3 && objc!=2 && objc!=1 ){
4937 Tcl_AppendResult(interp, "wrong # args: should be \"",
4938 Tcl_GetString(objv[0]), " filename options-list", 0);
4939 return TCL_ERROR;
4940 }
4941
4942 zFilename = objc>1 ? Tcl_GetString(objv[1]) : 0;
4943 sqlite3_open(zFilename, &db);
4944
4945 if( sqlite3TestMakePointerStr(interp, zBuf, db) ) return TCL_ERROR;
4946 Tcl_AppendResult(interp, zBuf, 0);
4947 return TCL_OK;
4948 }
4949
4950 /*
4951 ** Usage: sqlite3_open_v2 FILENAME FLAGS VFS
4952 */
4953 static int SQLITE_TCLAPI test_open_v2(
4954 void * clientData,
4955 Tcl_Interp *interp,
4956 int objc,
4957 Tcl_Obj *CONST objv[]
4958 ){
4959 const char *zFilename;
4960 const char *zVfs;
4961 int flags = 0;
4962 sqlite3 *db;
4963 int rc;
4964 char zBuf[100];
4965
4966 int nFlag;
4967 Tcl_Obj **apFlag;
4968 int i;
4969
4970 if( objc!=4 ){
4971 Tcl_WrongNumArgs(interp, 1, objv, "FILENAME FLAGS VFS");
4972 return TCL_ERROR;
4973 }
4974 zFilename = Tcl_GetString(objv[1]);
4975 zVfs = Tcl_GetString(objv[3]);
4976 if( zVfs[0]==0x00 ) zVfs = 0;
4977
4978 rc = Tcl_ListObjGetElements(interp, objv[2], &nFlag, &apFlag);
4979 if( rc!=TCL_OK ) return rc;
4980 for(i=0; i<nFlag; i++){
4981 int iFlag;
4982 struct OpenFlag {
4983 const char *zFlag;
4984 int flag;
4985 } aFlag[] = {
4986 { "SQLITE_OPEN_READONLY", SQLITE_OPEN_READONLY },
4987 { "SQLITE_OPEN_READWRITE", SQLITE_OPEN_READWRITE },
4988 { "SQLITE_OPEN_CREATE", SQLITE_OPEN_CREATE },
4989 { "SQLITE_OPEN_DELETEONCLOSE", SQLITE_OPEN_DELETEONCLOSE },
4990 { "SQLITE_OPEN_EXCLUSIVE", SQLITE_OPEN_EXCLUSIVE },
4991 { "SQLITE_OPEN_AUTOPROXY", SQLITE_OPEN_AUTOPROXY },
4992 { "SQLITE_OPEN_MAIN_DB", SQLITE_OPEN_MAIN_DB },
4993 { "SQLITE_OPEN_TEMP_DB", SQLITE_OPEN_TEMP_DB },
4994 { "SQLITE_OPEN_TRANSIENT_DB", SQLITE_OPEN_TRANSIENT_DB },
4995 { "SQLITE_OPEN_MAIN_JOURNAL", SQLITE_OPEN_MAIN_JOURNAL },
4996 { "SQLITE_OPEN_TEMP_JOURNAL", SQLITE_OPEN_TEMP_JOURNAL },
4997 { "SQLITE_OPEN_SUBJOURNAL", SQLITE_OPEN_SUBJOURNAL },
4998 { "SQLITE_OPEN_SUPER_JOURNAL", SQLITE_OPEN_SUPER_JOURNAL },
4999 { "SQLITE_OPEN_NOMUTEX", SQLITE_OPEN_NOMUTEX },
5000 { "SQLITE_OPEN_FULLMUTEX", SQLITE_OPEN_FULLMUTEX },
5001 { "SQLITE_OPEN_SHAREDCACHE", SQLITE_OPEN_SHAREDCACHE },
5002 { "SQLITE_OPEN_PRIVATECACHE", SQLITE_OPEN_PRIVATECACHE },
5003 { "SQLITE_OPEN_WAL", SQLITE_OPEN_WAL },
5004 { "SQLITE_OPEN_URI", SQLITE_OPEN_URI },
5005 { "SQLITE_OPEN_EXRESCODE", SQLITE_OPEN_EXRESCODE },
5006 { 0, 0 }
5007 };
5008 rc = Tcl_GetIndexFromObjStruct(interp, apFlag[i], aFlag, sizeof(aFlag[0]),
5009 "flag", 0, &iFlag
5010 );
5011 if( rc!=TCL_OK ) return rc;
5012 flags |= aFlag[iFlag].flag;
5013 }
5014
5015 rc = sqlite3_open_v2(zFilename, &db, flags, zVfs);
5016 if( sqlite3TestMakePointerStr(interp, zBuf, db) ) return TCL_ERROR;
5017 Tcl_AppendResult(interp, zBuf, 0);
5018 return TCL_OK;
5019 }
5020
5021 /*
5022 ** Usage: sqlite3_open16 filename options
5023 */
5024 static int SQLITE_TCLAPI test_open16(
5025 void * clientData,
5026 Tcl_Interp *interp,
5027 int objc,
5028 Tcl_Obj *CONST objv[]
5029 ){
5030 #ifndef SQLITE_OMIT_UTF16
5031 const void *zFilename;
5032 sqlite3 *db;
5033 char zBuf[100];
5034
5035 if( objc!=3 ){
5036 Tcl_AppendResult(interp, "wrong # args: should be \"",
5037 Tcl_GetString(objv[0]), " filename options-list", 0);
5038 return TCL_ERROR;
5039 }
5040
5041 zFilename = Tcl_GetByteArrayFromObj(objv[1], 0);
5042 sqlite3_open16(zFilename, &db);
5043
5044 if( sqlite3TestMakePointerStr(interp, zBuf, db) ) return TCL_ERROR;
5045 Tcl_AppendResult(interp, zBuf, 0);
5046 #endif /* SQLITE_OMIT_UTF16 */
5047 return TCL_OK;
5048 }
5049
5050 /*
5051 ** Usage: sqlite3_complete16 <UTF-16 string>
5052 **
5053 ** Return 1 if the supplied argument is a complete SQL statement, or zero
5054 ** otherwise.
5055 */
5056 static int SQLITE_TCLAPI test_complete16(
5057 void * clientData,
5058 Tcl_Interp *interp,
5059 int objc,
5060 Tcl_Obj *CONST objv[]
5061 ){
5062 #if !defined(SQLITE_OMIT_COMPLETE) && !defined(SQLITE_OMIT_UTF16)
5063 char *zBuf;
5064
5065 if( objc!=2 ){
5066 Tcl_WrongNumArgs(interp, 1, objv, "<utf-16 sql>");
5067 return TCL_ERROR;
5068 }
5069
5070 zBuf = (char*)Tcl_GetByteArrayFromObj(objv[1], 0);
5071 Tcl_SetObjResult(interp, Tcl_NewIntObj(sqlite3_complete16(zBuf)));
5072 #endif /* SQLITE_OMIT_COMPLETE && SQLITE_OMIT_UTF16 */
5073 return TCL_OK;
5074 }
5075
5076 /*
5077 ** Usage: sqlite3_normalize SQL
5078 **
5079 ** Return the normalized value for an SQL statement.
5080 */
5081 static int SQLITE_TCLAPI test_normalize(
5082 void * clientData,
5083 Tcl_Interp *interp,
5084 int objc,
5085 Tcl_Obj *CONST objv[]
5086 ){
5087 char *zSql;
5088 char *zNorm;
5089 extern char *sqlite3_normalize(const char*);
5090
5091 if( objc!=2 ){
5092 Tcl_WrongNumArgs(interp, 1, objv, "SQL");
5093 return TCL_ERROR;
5094 }
5095
5096 zSql = (char*)Tcl_GetString(objv[1]);
5097 zNorm = sqlite3_normalize(zSql);
5098 if( zNorm ){
5099 Tcl_SetObjResult(interp, Tcl_NewStringObj(zNorm, -1));
5100 sqlite3_free(zNorm);
5101 }
5102 return TCL_OK;
5103 }
5104
5105 /*
5106 ** Usage: sqlite3_step STMT
5107 **
5108 ** Advance the statement to the next row.
5109 */
5110 static int SQLITE_TCLAPI test_step(
5111 void * clientData,
5112 Tcl_Interp *interp,
5113 int objc,
5114 Tcl_Obj *CONST objv[]
5115 ){
5116 sqlite3_stmt *pStmt;
5117 int rc;
5118
5119 if( objc!=2 ){
5120 Tcl_AppendResult(interp, "wrong # args: should be \"",
5121 Tcl_GetString(objv[0]), " STMT", 0);
5122 return TCL_ERROR;
5123 }
5124
5125 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
5126 rc = sqlite3_step(pStmt);
5127
5128 /* if( rc!=SQLITE_DONE && rc!=SQLITE_ROW ) return TCL_ERROR; */
5129 Tcl_SetResult(interp, (char *)t1ErrorName(rc), 0);
5130 return TCL_OK;
5131 }
5132
5133 static int SQLITE_TCLAPI test_sql(
5134 void * clientData,
5135 Tcl_Interp *interp,
5136 int objc,
5137 Tcl_Obj *CONST objv[]
5138 ){
5139 sqlite3_stmt *pStmt;
5140
5141 if( objc!=2 ){
5142 Tcl_WrongNumArgs(interp, 1, objv, "STMT");
5143 return TCL_ERROR;
5144 }
5145
5146 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
5147 Tcl_SetResult(interp, (char *)sqlite3_sql(pStmt), TCL_VOLATILE);
5148 return TCL_OK;
5149 }
5150 static int SQLITE_TCLAPI test_ex_sql(
5151 void * clientData,
5152 Tcl_Interp *interp,
5153 int objc,
5154 Tcl_Obj *CONST objv[]
5155 ){
5156 sqlite3_stmt *pStmt;
5157 char *z;
5158
5159 if( objc!=2 ){
5160 Tcl_WrongNumArgs(interp, 1, objv, "STMT");
5161 return TCL_ERROR;
5162 }
5163
5164 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
5165 z = sqlite3_expanded_sql(pStmt);
5166 Tcl_SetResult(interp, z, TCL_VOLATILE);
5167 sqlite3_free(z);
5168 return TCL_OK;
5169 }
5170 #ifdef SQLITE_ENABLE_NORMALIZE
5171 static int SQLITE_TCLAPI test_norm_sql(
5172 void * clientData,
5173 Tcl_Interp *interp,
5174 int objc,
5175 Tcl_Obj *CONST objv[]
5176 ){
5177 sqlite3_stmt *pStmt;
5178
5179 if( objc!=2 ){
5180 Tcl_WrongNumArgs(interp, 1, objv, "STMT");
5181 return TCL_ERROR;
5182 }
5183
5184 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
5185 Tcl_SetResult(interp, (char *)sqlite3_normalized_sql(pStmt), TCL_VOLATILE);
5186 return TCL_OK;
5187 }
5188 #endif /* SQLITE_ENABLE_NORMALIZE */
5189
5190 /*
5191 ** Usage: sqlite3_column_count STMT
5192 **
5193 ** Return the number of columns returned by the sql statement STMT.
5194 */
5195 static int SQLITE_TCLAPI test_column_count(
5196 void * clientData,
5197 Tcl_Interp *interp,
5198 int objc,
5199 Tcl_Obj *CONST objv[]
5200 ){
5201 sqlite3_stmt *pStmt;
5202
5203 if( objc!=2 ){
5204 Tcl_AppendResult(interp, "wrong # args: should be \"",
5205 Tcl_GetString(objv[0]), " STMT column", 0);
5206 return TCL_ERROR;
5207 }
5208
5209 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
5210
5211 Tcl_SetObjResult(interp, Tcl_NewIntObj(sqlite3_column_count(pStmt)));
5212 return TCL_OK;
5213 }
5214
5215 /*
5216 ** Usage: sqlite3_column_type STMT column
5217 **
5218 ** Return the type of the data in column 'column' of the current row.
5219 */
5220 static int SQLITE_TCLAPI test_column_type(
5221 void * clientData,
5222 Tcl_Interp *interp,
5223 int objc,
5224 Tcl_Obj *CONST objv[]
5225 ){
5226 sqlite3_stmt *pStmt;
5227 int col;
5228 int tp;
5229
5230 if( objc!=3 ){
5231 Tcl_AppendResult(interp, "wrong # args: should be \"",
5232 Tcl_GetString(objv[0]), " STMT column", 0);
5233 return TCL_ERROR;
5234 }
5235
5236 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
5237 if( Tcl_GetIntFromObj(interp, objv[2], &col) ) return TCL_ERROR;
5238
5239 tp = sqlite3_column_type(pStmt, col);
5240 switch( tp ){
5241 case SQLITE_INTEGER:
5242 Tcl_SetResult(interp, "INTEGER", TCL_STATIC);
5243 break;
5244 case SQLITE_NULL:
5245 Tcl_SetResult(interp, "NULL", TCL_STATIC);
5246 break;
5247 case SQLITE_FLOAT:
5248 Tcl_SetResult(interp, "FLOAT", TCL_STATIC);
5249 break;
5250 case SQLITE_TEXT:
5251 Tcl_SetResult(interp, "TEXT", TCL_STATIC);
5252 break;
5253 case SQLITE_BLOB:
5254 Tcl_SetResult(interp, "BLOB", TCL_STATIC);
5255 break;
5256 default:
5257 assert(0);
5258 }
5259
5260 return TCL_OK;
5261 }
5262
5263 /*
5264 ** Usage: sqlite3_column_int64 STMT column
5265 **
5266 ** Return the data in column 'column' of the current row cast as an
5267 ** wide (64-bit) integer.
5268 */
5269 static int SQLITE_TCLAPI test_column_int64(
5270 void * clientData,
5271 Tcl_Interp *interp,
5272 int objc,
5273 Tcl_Obj *CONST objv[]
5274 ){
5275 sqlite3_stmt *pStmt;
5276 int col;
5277 i64 iVal;
5278
5279 if( objc!=3 ){
5280 Tcl_AppendResult(interp, "wrong # args: should be \"",
5281 Tcl_GetString(objv[0]), " STMT column", 0);
5282 return TCL_ERROR;
5283 }
5284
5285 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
5286 if( Tcl_GetIntFromObj(interp, objv[2], &col) ) return TCL_ERROR;
5287
5288 iVal = sqlite3_column_int64(pStmt, col);
5289 Tcl_SetObjResult(interp, Tcl_NewWideIntObj(iVal));
5290 return TCL_OK;
5291 }
5292
5293 /*
5294 ** Usage: sqlite3_column_blob STMT column
5295 */
5296 static int SQLITE_TCLAPI test_column_blob(
5297 void * clientData,
5298 Tcl_Interp *interp,
5299 int objc,
5300 Tcl_Obj *CONST objv[]
5301 ){
5302 sqlite3_stmt *pStmt;
5303 int col;
5304
5305 int len;
5306 const void *pBlob;
5307
5308 if( objc!=3 ){
5309 Tcl_AppendResult(interp, "wrong # args: should be \"",
5310 Tcl_GetString(objv[0]), " STMT column", 0);
5311 return TCL_ERROR;
5312 }
5313
5314 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
5315 if( Tcl_GetIntFromObj(interp, objv[2], &col) ) return TCL_ERROR;
5316
5317 len = sqlite3_column_bytes(pStmt, col);
5318 pBlob = sqlite3_column_blob(pStmt, col);
5319 Tcl_SetObjResult(interp, Tcl_NewByteArrayObj(pBlob, len));
5320 return TCL_OK;
5321 }
5322
5323 /*
5324 ** Usage: sqlite3_column_double STMT column
5325 **
5326 ** Return the data in column 'column' of the current row cast as a double.
5327 */
5328 static int SQLITE_TCLAPI test_column_double(
5329 void * clientData,
5330 Tcl_Interp *interp,
5331 int objc,
5332 Tcl_Obj *CONST objv[]
5333 ){
5334 sqlite3_stmt *pStmt;
5335 int col;
5336 double rVal;
5337
5338 if( objc!=3 ){
5339 Tcl_AppendResult(interp, "wrong # args: should be \"",
5340 Tcl_GetString(objv[0]), " STMT column", 0);
5341 return TCL_ERROR;
5342 }
5343
5344 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
5345 if( Tcl_GetIntFromObj(interp, objv[2], &col) ) return TCL_ERROR;
5346
5347 rVal = sqlite3_column_double(pStmt, col);
5348 Tcl_SetObjResult(interp, Tcl_NewDoubleObj(rVal));
5349 return TCL_OK;
5350 }
5351
5352 /*
5353 ** Usage: sqlite3_data_count STMT
5354 **
5355 ** Return the number of columns returned by the sql statement STMT.
5356 */
5357 static int SQLITE_TCLAPI test_data_count(
5358 void * clientData,
5359 Tcl_Interp *interp,
5360 int objc,
5361 Tcl_Obj *CONST objv[]
5362 ){
5363 sqlite3_stmt *pStmt;
5364
5365 if( objc!=2 ){
5366 Tcl_AppendResult(interp, "wrong # args: should be \"",
5367 Tcl_GetString(objv[0]), " STMT column", 0);
5368 return TCL_ERROR;
5369 }
5370
5371 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
5372
5373 Tcl_SetObjResult(interp, Tcl_NewIntObj(sqlite3_data_count(pStmt)));
5374 return TCL_OK;
5375 }
5376
5377 /*
5378 ** Usage: sqlite3_column_text STMT column
5379 **
5380 ** Usage: sqlite3_column_decltype STMT column
5381 **
5382 ** Usage: sqlite3_column_name STMT column
5383 */
5384 static int SQLITE_TCLAPI test_stmt_utf8(
5385 void * clientData, /* Pointer to SQLite API function to be invoke */
5386 Tcl_Interp *interp,
5387 int objc,
5388 Tcl_Obj *CONST objv[]
5389 ){
5390 sqlite3_stmt *pStmt;
5391 int col;
5392 const char *(*xFunc)(sqlite3_stmt*, int);
5393 const char *zRet;
5394
5395 xFunc = (const char *(*)(sqlite3_stmt*, int))clientData;
5396 if( objc!=3 ){
5397 Tcl_AppendResult(interp, "wrong # args: should be \"",
5398 Tcl_GetString(objv[0]), " STMT column", 0);
5399 return TCL_ERROR;
5400 }
5401
5402 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
5403 if( Tcl_GetIntFromObj(interp, objv[2], &col) ) return TCL_ERROR;
5404 zRet = xFunc(pStmt, col);
5405 if( zRet ){
5406 Tcl_SetResult(interp, (char *)zRet, 0);
5407 }
5408 return TCL_OK;
5409 }
5410
5411 static int SQLITE_TCLAPI test_global_recover(
5412 void * clientData,
5413 Tcl_Interp *interp,
5414 int objc,
5415 Tcl_Obj *CONST objv[]
5416 ){
5417 #ifndef SQLITE_OMIT_DEPRECATED
5418 int rc;
5419 if( objc!=1 ){
5420 Tcl_WrongNumArgs(interp, 1, objv, "");
5421 return TCL_ERROR;
5422 }
5423 rc = sqlite3_global_recover();
5424 Tcl_SetResult(interp, (char *)t1ErrorName(rc), TCL_STATIC);
5425 #endif
5426 return TCL_OK;
5427 }
5428
5429 /*
5430 ** Usage: sqlite3_column_text STMT column
5431 **
5432 ** Usage: sqlite3_column_decltype STMT column
5433 **
5434 ** Usage: sqlite3_column_name STMT column
5435 */
5436 static int SQLITE_TCLAPI test_stmt_utf16(
5437 void * clientData, /* Pointer to SQLite API function to be invoked */
5438 Tcl_Interp *interp,
5439 int objc,
5440 Tcl_Obj *CONST objv[]
5441 ){
5442 #ifndef SQLITE_OMIT_UTF16
5443 sqlite3_stmt *pStmt;
5444 int col;
5445 Tcl_Obj *pRet;
5446 const void *zName16;
5447 const void *(*xFunc)(sqlite3_stmt*, int);
5448
5449 xFunc = (const void *(*)(sqlite3_stmt*, int))clientData;
5450 if( objc!=3 ){
5451 Tcl_AppendResult(interp, "wrong # args: should be \"",
5452 Tcl_GetString(objv[0]), " STMT column", 0);
5453 return TCL_ERROR;
5454 }
5455
5456 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
5457 if( Tcl_GetIntFromObj(interp, objv[2], &col) ) return TCL_ERROR;
5458
5459 zName16 = xFunc(pStmt, col);
5460 if( zName16 ){
5461 int n;
5462 const char *z = zName16;
5463 for(n=0; z[n] || z[n+1]; n+=2){}
5464 pRet = Tcl_NewByteArrayObj(zName16, n+2);
5465 Tcl_SetObjResult(interp, pRet);
5466 }
5467 #endif /* SQLITE_OMIT_UTF16 */
5468
5469 return TCL_OK;
5470 }
5471
5472 /*
5473 ** Usage: sqlite3_column_int STMT column
5474 **
5475 ** Usage: sqlite3_column_bytes STMT column
5476 **
5477 ** Usage: sqlite3_column_bytes16 STMT column
5478 **
5479 */
5480 static int SQLITE_TCLAPI test_stmt_int(
5481 void * clientData, /* Pointer to SQLite API function to be invoked */
5482 Tcl_Interp *interp,
5483 int objc,
5484 Tcl_Obj *CONST objv[]
5485 ){
5486 sqlite3_stmt *pStmt;
5487 int col;
5488 int (*xFunc)(sqlite3_stmt*, int);
5489
5490 xFunc = (int (*)(sqlite3_stmt*, int))clientData;
5491 if( objc!=3 ){
5492 Tcl_AppendResult(interp, "wrong # args: should be \"",
5493 Tcl_GetString(objv[0]), " STMT column", 0);
5494 return TCL_ERROR;
5495 }
5496
5497 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
5498 if( Tcl_GetIntFromObj(interp, objv[2], &col) ) return TCL_ERROR;
5499
5500 Tcl_SetObjResult(interp, Tcl_NewIntObj(xFunc(pStmt, col)));
5501 return TCL_OK;
5502 }
5503
5504
5505 /*
5506 ** Usage: sqlite3_interrupt DB
5507 **
5508 ** Trigger an interrupt on DB
5509 */
5510 static int SQLITE_TCLAPI test_interrupt(
5511 void * clientData,
5512 Tcl_Interp *interp,
5513 int argc,
5514 char **argv
5515 ){
5516 sqlite3 *db;
5517 if( argc!=2 ){
5518 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0], " DB", 0);
5519 return TCL_ERROR;
5520 }
5521 if( getDbPointer(interp, argv[1], &db) ) return TCL_ERROR;
5522 sqlite3_interrupt(db);
5523 return TCL_OK;
5524 }
5525
5526 /*
5527 ** Usage: sqlite_delete_function DB function-name
5528 **
5529 ** Delete the user function 'function-name' from database handle DB. It
5530 ** is assumed that the user function was created as UTF8, any number of
5531 ** arguments (the way the TCL interface does it).
5532 */
5533 static int SQLITE_TCLAPI delete_function(
5534 void * clientData,
5535 Tcl_Interp *interp,
5536 int argc,
5537 char **argv
5538 ){
5539 int rc;
5540 sqlite3 *db;
5541 if( argc!=3 ){
5542 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
5543 " DB function-name", 0);
5544 return TCL_ERROR;
5545 }
5546 if( getDbPointer(interp, argv[1], &db) ) return TCL_ERROR;
5547 rc = sqlite3_create_function(db, argv[2], -1, SQLITE_UTF8, 0, 0, 0, 0);
5548 Tcl_SetResult(interp, (char *)t1ErrorName(rc), TCL_STATIC);
5549 return TCL_OK;
5550 }
5551
5552 /*
5553 ** Usage: sqlite_delete_collation DB collation-name
5554 **
5555 ** Delete the collation sequence 'collation-name' from database handle
5556 ** DB. It is assumed that the collation sequence was created as UTF8 (the
5557 ** way the TCL interface does it).
5558 */
5559 static int SQLITE_TCLAPI delete_collation(
5560 void * clientData,
5561 Tcl_Interp *interp,
5562 int argc,
5563 char **argv
5564 ){
5565 int rc;
5566 sqlite3 *db;
5567 if( argc!=3 ){
5568 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
5569 " DB function-name", 0);
5570 return TCL_ERROR;
5571 }
5572 if( getDbPointer(interp, argv[1], &db) ) return TCL_ERROR;
5573 rc = sqlite3_create_collation(db, argv[2], SQLITE_UTF8, 0, 0);
5574 Tcl_SetResult(interp, (char *)t1ErrorName(rc), TCL_STATIC);
5575 return TCL_OK;
5576 }
5577
5578 /*
5579 ** Usage: sqlite3_get_autocommit DB
5580 **
5581 ** Return true if the database DB is currently in auto-commit mode.
5582 ** Return false if not.
5583 */
5584 static int SQLITE_TCLAPI get_autocommit(
5585 void * clientData,
5586 Tcl_Interp *interp,
5587 int argc,
5588 char **argv
5589 ){
5590 char zBuf[30];
5591 sqlite3 *db;
5592 if( argc!=2 ){
5593 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
5594 " DB", 0);
5595 return TCL_ERROR;
5596 }
5597 if( getDbPointer(interp, argv[1], &db) ) return TCL_ERROR;
5598 sqlite3_snprintf(sizeof(zBuf), zBuf, "%d", sqlite3_get_autocommit(db));
5599 Tcl_AppendResult(interp, zBuf, 0);
5600 return TCL_OK;
5601 }
5602
5603 /*
5604 ** Usage: sqlite3_busy_timeout DB MS
5605 **
5606 ** Set the busy timeout. This is more easily done using the timeout
5607 ** method of the TCL interface. But we need a way to test the case
5608 ** where it returns SQLITE_MISUSE.
5609 */
5610 static int SQLITE_TCLAPI test_busy_timeout(
5611 void * clientData,
5612 Tcl_Interp *interp,
5613 int argc,
5614 char **argv
5615 ){
5616 int rc, ms;
5617 sqlite3 *db;
5618 if( argc!=3 ){
5619 Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
5620 " DB", 0);
5621 return TCL_ERROR;
5622 }
5623 if( getDbPointer(interp, argv[1], &db) ) return TCL_ERROR;
5624 if( Tcl_GetInt(interp, argv[2], &ms) ) return TCL_ERROR;
5625 rc = sqlite3_busy_timeout(db, ms);
5626 Tcl_AppendResult(interp, sqlite3ErrName(rc), 0);
5627 return TCL_OK;
5628 }
5629
5630 /*
5631 ** Usage: tcl_variable_type VARIABLENAME
5632 **
5633 ** Return the name of the internal representation for the
5634 ** value of the given variable.
5635 */
5636 static int SQLITE_TCLAPI tcl_variable_type(
5637 void * clientData,
5638 Tcl_Interp *interp,
5639 int objc,
5640 Tcl_Obj *CONST objv[]
5641 ){
5642 Tcl_Obj *pVar;
5643 if( objc!=2 ){
5644 Tcl_WrongNumArgs(interp, 1, objv, "VARIABLE");
5645 return TCL_ERROR;
5646 }
5647 pVar = Tcl_GetVar2Ex(interp, Tcl_GetString(objv[1]), 0, TCL_LEAVE_ERR_MSG);
5648 if( pVar==0 ) return TCL_ERROR;
5649 if( pVar->typePtr ){
5650 Tcl_SetObjResult(interp, Tcl_NewStringObj(pVar->typePtr->name, -1));
5651 }
5652 return TCL_OK;
5653 }
5654
5655 /*
5656 ** Usage: sqlite3_release_memory ?N?
5657 **
5658 ** Attempt to release memory currently held but not actually required.
5659 ** The integer N is the number of bytes we are trying to release. The
5660 ** return value is the amount of memory actually released.
5661 */
5662 static int SQLITE_TCLAPI test_release_memory(
5663 void * clientData,
5664 Tcl_Interp *interp,
5665 int objc,
5666 Tcl_Obj *CONST objv[]
5667 ){
5668 #if defined(SQLITE_ENABLE_MEMORY_MANAGEMENT) && !defined(SQLITE_OMIT_DISKIO)
5669 int N;
5670 int amt;
5671 if( objc!=1 && objc!=2 ){
5672 Tcl_WrongNumArgs(interp, 1, objv, "?N?");
5673 return TCL_ERROR;
5674 }
5675 if( objc==2 ){
5676 if( Tcl_GetIntFromObj(interp, objv[1], &N) ) return TCL_ERROR;
5677 }else{
5678 N = -1;
5679 }
5680 amt = sqlite3_release_memory(N);
5681 Tcl_SetObjResult(interp, Tcl_NewIntObj(amt));
5682 #endif
5683 return TCL_OK;
5684 }
5685
5686
5687 /*
5688 ** Usage: sqlite3_db_release_memory DB
5689 **
5690 ** Attempt to release memory currently held by database DB. Return the
5691 ** result code (which in the current implementation is always zero).
5692 */
5693 static int SQLITE_TCLAPI test_db_release_memory(
5694 void * clientData,
5695 Tcl_Interp *interp,
5696 int objc,
5697 Tcl_Obj *CONST objv[]
5698 ){
5699 sqlite3 *db;
5700 int rc;
5701 if( objc!=2 ){
5702 Tcl_WrongNumArgs(interp, 1, objv, "DB");
5703 return TCL_ERROR;
5704 }
5705 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
5706 rc = sqlite3_db_release_memory(db);
5707 Tcl_SetObjResult(interp, Tcl_NewIntObj(rc));
5708 return TCL_OK;
5709 }
5710
5711 /*
5712 ** Usage: sqlite3_db_cacheflush DB
5713 **
5714 ** Attempt to flush any dirty pages to disk.
5715 */
5716 static int SQLITE_TCLAPI test_db_cacheflush(
5717 void * clientData,
5718 Tcl_Interp *interp,
5719 int objc,
5720 Tcl_Obj *CONST objv[]
5721 ){
5722 sqlite3 *db;
5723 int rc;
5724 if( objc!=2 ){
5725 Tcl_WrongNumArgs(interp, 1, objv, "DB");
5726 return TCL_ERROR;
5727 }
5728 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
5729 rc = sqlite3_db_cacheflush(db);
5730 if( rc ){
5731 Tcl_SetResult(interp, (char *)sqlite3ErrStr(rc), TCL_STATIC);
5732 return TCL_ERROR;
5733 }
5734
5735 Tcl_ResetResult(interp);
5736 return TCL_OK;
5737 }
5738
5739 /*
5740 ** Usage: sqlite3_system_errno DB
5741 **
5742 ** Return the low-level system errno value.
5743 */
5744 static int SQLITE_TCLAPI test_system_errno(
5745 void * clientData,
5746 Tcl_Interp *interp,
5747 int objc,
5748 Tcl_Obj *CONST objv[]
5749 ){
5750 sqlite3 *db;
5751 int iErrno;
5752 if( objc!=2 ){
5753 Tcl_WrongNumArgs(interp, 1, objv, "DB");
5754 return TCL_ERROR;
5755 }
5756 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
5757 iErrno = sqlite3_system_errno(db);
5758 Tcl_SetObjResult(interp, Tcl_NewIntObj(iErrno));
5759 return TCL_OK;
5760 }
5761
5762 /*
5763 ** Usage: sqlite3_db_filename DB DBNAME
5764 **
5765 ** Return the name of a file associated with a database.
5766 */
5767 static int SQLITE_TCLAPI test_db_filename(
5768 void * clientData,
5769 Tcl_Interp *interp,
5770 int objc,
5771 Tcl_Obj *CONST objv[]
5772 ){
5773 sqlite3 *db;
5774 const char *zDbName;
5775 if( objc!=3 ){
5776 Tcl_WrongNumArgs(interp, 1, objv, "DB DBNAME");
5777 return TCL_ERROR;
5778 }
5779 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
5780 zDbName = Tcl_GetString(objv[2]);
5781 Tcl_AppendResult(interp, sqlite3_db_filename(db, zDbName), (void*)0);
5782 return TCL_OK;
5783 }
5784
5785 /*
5786 ** Usage: sqlite3_db_readonly DB DBNAME
5787 **
5788 ** Return 1 or 0 if DBNAME is readonly or not. Return -1 if DBNAME does
5789 ** not exist.
5790 */
5791 static int SQLITE_TCLAPI test_db_readonly(
5792 void * clientData,
5793 Tcl_Interp *interp,
5794 int objc,
5795 Tcl_Obj *CONST objv[]
5796 ){
5797 sqlite3 *db;
5798 const char *zDbName;
5799 if( objc!=3 ){
5800 Tcl_WrongNumArgs(interp, 1, objv, "DB DBNAME");
5801 return TCL_ERROR;
5802 }
5803 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
5804 zDbName = Tcl_GetString(objv[2]);
5805 Tcl_SetObjResult(interp, Tcl_NewIntObj(sqlite3_db_readonly(db, zDbName)));
5806 return TCL_OK;
5807 }
5808
5809 /*
5810 ** Usage: sqlite3_soft_heap_limit ?N?
5811 **
5812 ** Query or set the soft heap limit for the current thread. The
5813 ** limit is only changed if the N is present. The previous limit
5814 ** is returned.
5815 */
5816 static int SQLITE_TCLAPI test_soft_heap_limit(
5817 void * clientData,
5818 Tcl_Interp *interp,
5819 int objc,
5820 Tcl_Obj *CONST objv[]
5821 ){
5822 sqlite3_int64 amt;
5823 Tcl_WideInt N = -1;
5824 if( objc!=1 && objc!=2 ){
5825 Tcl_WrongNumArgs(interp, 1, objv, "?N?");
5826 return TCL_ERROR;
5827 }
5828 if( objc==2 ){
5829 if( Tcl_GetWideIntFromObj(interp, objv[1], &N) ) return TCL_ERROR;
5830 }
5831 amt = sqlite3_soft_heap_limit64(N);
5832 Tcl_SetObjResult(interp, Tcl_NewWideIntObj(amt));
5833 return TCL_OK;
5834 }
5835
5836 /*
5837 ** Usage: sqlite3_hard_heap_limit ?N?
5838 **
5839 ** Query or set the hard heap limit for the current thread. The
5840 ** limit is only changed if the N is present. The previous limit
5841 ** is returned.
5842 */
5843 static int SQLITE_TCLAPI test_hard_heap_limit(
5844 void * clientData,
5845 Tcl_Interp *interp,
5846 int objc,
5847 Tcl_Obj *CONST objv[]
5848 ){
5849 sqlite3_int64 amt;
5850 Tcl_WideInt N = -1;
5851 if( objc!=1 && objc!=2 ){
5852 Tcl_WrongNumArgs(interp, 1, objv, "?N?");
5853 return TCL_ERROR;
5854 }
5855 if( objc==2 ){
5856 if( Tcl_GetWideIntFromObj(interp, objv[1], &N) ) return TCL_ERROR;
5857 }
5858 amt = sqlite3_hard_heap_limit64(N);
5859 Tcl_SetObjResult(interp, Tcl_NewWideIntObj(amt));
5860 return TCL_OK;
5861 }
5862
5863 /*
5864 ** Usage: sqlite3_thread_cleanup
5865 **
5866 ** Call the sqlite3_thread_cleanup API.
5867 */
5868 static int SQLITE_TCLAPI test_thread_cleanup(
5869 void * clientData,
5870 Tcl_Interp *interp,
5871 int objc,
5872 Tcl_Obj *CONST objv[]
5873 ){
5874 #ifndef SQLITE_OMIT_DEPRECATED
5875 sqlite3_thread_cleanup();
5876 #endif
5877 return TCL_OK;
5878 }
5879
5880 /*
5881 ** Usage: sqlite3_pager_refcounts DB
5882 **
5883 ** Return a list of numbers which are the PagerRefcount for all
5884 ** pagers on each database connection.
5885 */
5886 static int SQLITE_TCLAPI test_pager_refcounts(
5887 void * clientData,
5888 Tcl_Interp *interp,
5889 int objc,
5890 Tcl_Obj *CONST objv[]
5891 ){
5892 sqlite3 *db;
5893 int i;
5894 int v, *a;
5895 Tcl_Obj *pResult;
5896
5897 if( objc!=2 ){
5898 Tcl_AppendResult(interp, "wrong # args: should be \"",
5899 Tcl_GetStringFromObj(objv[0], 0), " DB", 0);
5900 return TCL_ERROR;
5901 }
5902 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
5903 pResult = Tcl_NewObj();
5904 for(i=0; i<db->nDb; i++){
5905 if( db->aDb[i].pBt==0 ){
5906 v = -1;
5907 }else{
5908 sqlite3_mutex_enter(db->mutex);
5909 a = sqlite3PagerStats(sqlite3BtreePager(db->aDb[i].pBt));
5910 v = a[0];
5911 sqlite3_mutex_leave(db->mutex);
5912 }
5913 Tcl_ListObjAppendElement(0, pResult, Tcl_NewIntObj(v));
5914 }
5915 Tcl_SetObjResult(interp, pResult);
5916 return TCL_OK;
5917 }
5918
5919
5920 /*
5921 ** tclcmd: working_64bit_int
5922 **
5923 ** Some TCL builds (ex: cygwin) do not support 64-bit integers. This
5924 ** leads to a number of test failures. The present command checks the
5925 ** TCL build to see whether or not it supports 64-bit integers. It
5926 ** returns TRUE if it does and FALSE if not.
5927 **
5928 ** This command is used to warn users that their TCL build is defective
5929 ** and that the errors they are seeing in the test scripts might be
5930 ** a result of their defective TCL rather than problems in SQLite.
5931 */
5932 static int SQLITE_TCLAPI working_64bit_int(
5933 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
5934 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
5935 int objc, /* Number of arguments */
5936 Tcl_Obj *CONST objv[] /* Command arguments */
5937 ){
5938 Tcl_Obj *pTestObj;
5939 int working = 0;
5940
5941 pTestObj = Tcl_NewWideIntObj(1000000*(i64)1234567890);
5942 working = strcmp(Tcl_GetString(pTestObj), "1234567890000000")==0;
5943 Tcl_DecrRefCount(pTestObj);
5944 Tcl_SetObjResult(interp, Tcl_NewBooleanObj(working));
5945 return TCL_OK;
5946 }
5947
5948
5949 /*
5950 ** tclcmd: vfs_unlink_test
5951 **
5952 ** This TCL command unregisters the primary VFS and then registers
5953 ** it back again. This is used to test the ability to register a
5954 ** VFS when none are previously registered, and the ability to
5955 ** unregister the only available VFS. Ticket #2738
5956 */
5957 static int SQLITE_TCLAPI vfs_unlink_test(
5958 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
5959 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
5960 int objc, /* Number of arguments */
5961 Tcl_Obj *CONST objv[] /* Command arguments */
5962 ){
5963 int i;
5964 sqlite3_vfs *pMain;
5965 sqlite3_vfs *apVfs[20];
5966 sqlite3_vfs one, two;
5967
5968 sqlite3_vfs_unregister(0); /* Unregister of NULL is harmless */
5969 one.zName = "__one";
5970 two.zName = "__two";
5971
5972 /* Calling sqlite3_vfs_register with 2nd argument of 0 does not
5973 ** change the default VFS
5974 */
5975 pMain = sqlite3_vfs_find(0);
5976 sqlite3_vfs_register(&one, 0);
5977 assert( pMain==0 || pMain==sqlite3_vfs_find(0) );
5978 sqlite3_vfs_register(&two, 0);
5979 assert( pMain==0 || pMain==sqlite3_vfs_find(0) );
5980
5981 /* We can find a VFS by its name */
5982 assert( sqlite3_vfs_find("__one")==&one );
5983 assert( sqlite3_vfs_find("__two")==&two );
5984
5985 /* Calling sqlite_vfs_register with non-zero second parameter changes the
5986 ** default VFS, even if the 1st parameter is an existig VFS that is
5987 ** previously registered as the non-default.
5988 */
5989 sqlite3_vfs_register(&one, 1);
5990 assert( sqlite3_vfs_find("__one")==&one );
5991 assert( sqlite3_vfs_find("__two")==&two );
5992 assert( sqlite3_vfs_find(0)==&one );
5993 sqlite3_vfs_register(&two, 1);
5994 assert( sqlite3_vfs_find("__one")==&one );
5995 assert( sqlite3_vfs_find("__two")==&two );
5996 assert( sqlite3_vfs_find(0)==&two );
5997 if( pMain ){
5998 sqlite3_vfs_register(pMain, 1);
5999 assert( sqlite3_vfs_find("__one")==&one );
6000 assert( sqlite3_vfs_find("__two")==&two );
6001 assert( sqlite3_vfs_find(0)==pMain );
6002 }
6003
6004 /* Unlink the default VFS. Repeat until there are no more VFSes
6005 ** registered.
6006 */
6007 for(i=0; i<sizeof(apVfs)/sizeof(apVfs[0]); i++){
6008 apVfs[i] = sqlite3_vfs_find(0);
6009 if( apVfs[i] ){
6010 assert( apVfs[i]==sqlite3_vfs_find(apVfs[i]->zName) );
6011 sqlite3_vfs_unregister(apVfs[i]);
6012 assert( 0==sqlite3_vfs_find(apVfs[i]->zName) );
6013 }
6014 }
6015 assert( 0==sqlite3_vfs_find(0) );
6016
6017 /* Register the main VFS as non-default (will be made default, since
6018 ** it'll be the only one in existence).
6019 */
6020 sqlite3_vfs_register(pMain, 0);
6021 assert( sqlite3_vfs_find(0)==pMain );
6022
6023 /* Un-register the main VFS again to restore an empty VFS list */
6024 sqlite3_vfs_unregister(pMain);
6025 assert( 0==sqlite3_vfs_find(0) );
6026
6027 /* Relink all VFSes in reverse order. */
6028 for(i=sizeof(apVfs)/sizeof(apVfs[0])-1; i>=0; i--){
6029 if( apVfs[i] ){
6030 sqlite3_vfs_register(apVfs[i], 1);
6031 assert( apVfs[i]==sqlite3_vfs_find(0) );
6032 assert( apVfs[i]==sqlite3_vfs_find(apVfs[i]->zName) );
6033 }
6034 }
6035
6036 /* Unregister out sample VFSes. */
6037 sqlite3_vfs_unregister(&one);
6038 sqlite3_vfs_unregister(&two);
6039
6040 /* Unregistering a VFS that is not currently registered is harmless */
6041 sqlite3_vfs_unregister(&one);
6042 sqlite3_vfs_unregister(&two);
6043 assert( sqlite3_vfs_find("__one")==0 );
6044 assert( sqlite3_vfs_find("__two")==0 );
6045
6046 /* We should be left with the original default VFS back as the
6047 ** original */
6048 assert( sqlite3_vfs_find(0)==pMain );
6049
6050 return TCL_OK;
6051 }
6052
6053 /*
6054 ** tclcmd: vfs_initfail_test
6055 **
6056 ** This TCL command attempts to vfs_find and vfs_register when the
6057 ** sqlite3_initialize() interface is failing. All calls should fail.
6058 */
6059 static int SQLITE_TCLAPI vfs_initfail_test(
6060 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6061 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6062 int objc, /* Number of arguments */
6063 Tcl_Obj *CONST objv[] /* Command arguments */
6064 ){
6065 sqlite3_vfs one;
6066 one.zName = "__one";
6067
6068 if( sqlite3_vfs_find(0) ) return TCL_ERROR;
6069 sqlite3_vfs_register(&one, 0);
6070 if( sqlite3_vfs_find(0) ) return TCL_ERROR;
6071 sqlite3_vfs_register(&one, 1);
6072 if( sqlite3_vfs_find(0) ) return TCL_ERROR;
6073 return TCL_OK;
6074 }
6075
6076 /*
6077 ** Saved VFSes
6078 */
6079 static sqlite3_vfs *apVfs[20];
6080 static int nVfs = 0;
6081
6082 /*
6083 ** tclcmd: vfs_unregister_all
6084 **
6085 ** Unregister all VFSes.
6086 */
6087 static int SQLITE_TCLAPI vfs_unregister_all(
6088 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6089 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6090 int objc, /* Number of arguments */
6091 Tcl_Obj *CONST objv[] /* Command arguments */
6092 ){
6093 int i;
6094 for(i=0; i<ArraySize(apVfs); i++){
6095 apVfs[i] = sqlite3_vfs_find(0);
6096 if( apVfs[i]==0 ) break;
6097 sqlite3_vfs_unregister(apVfs[i]);
6098 }
6099 nVfs = i;
6100 return TCL_OK;
6101 }
6102 /*
6103 ** tclcmd: vfs_reregister_all
6104 **
6105 ** Restore all VFSes that were removed using vfs_unregister_all. Taking
6106 ** care to put the linked list back together in the same order as it was
6107 ** in before vfs_unregister_all was invoked.
6108 */
6109 static int SQLITE_TCLAPI vfs_reregister_all(
6110 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6111 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6112 int objc, /* Number of arguments */
6113 Tcl_Obj *CONST objv[] /* Command arguments */
6114 ){
6115 int i;
6116 for(i=nVfs-1; i>=0; i--){
6117 sqlite3_vfs_register(apVfs[i], 1);
6118 }
6119 return TCL_OK;
6120 }
6121
6122
6123 /*
6124 ** tclcmd: file_control_test DB
6125 **
6126 ** This TCL command runs the sqlite3_file_control interface and
6127 ** verifies correct operation of the same.
6128 */
6129 static int SQLITE_TCLAPI file_control_test(
6130 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6131 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6132 int objc, /* Number of arguments */
6133 Tcl_Obj *CONST objv[] /* Command arguments */
6134 ){
6135 int iArg = 0;
6136 sqlite3 *db;
6137 int rc;
6138
6139 if( objc!=2 ){
6140 Tcl_AppendResult(interp, "wrong # args: should be \"",
6141 Tcl_GetStringFromObj(objv[0], 0), " DB", 0);
6142 return TCL_ERROR;
6143 }
6144 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
6145 rc = sqlite3_file_control(db, 0, 0, &iArg);
6146 assert( rc==SQLITE_NOTFOUND );
6147 rc = sqlite3_file_control(db, "notadatabase", SQLITE_FCNTL_LOCKSTATE, &iArg);
6148 assert( rc==SQLITE_ERROR );
6149 rc = sqlite3_file_control(db, "main", -1, &iArg);
6150 assert( rc==SQLITE_NOTFOUND );
6151 rc = sqlite3_file_control(db, "temp", -1, &iArg);
6152 assert( rc==SQLITE_NOTFOUND || rc==SQLITE_ERROR );
6153
6154 return TCL_OK;
6155 }
6156
6157
6158 /*
6159 ** tclcmd: file_control_lasterrno_test DB
6160 **
6161 ** This TCL command runs the sqlite3_file_control interface and
6162 ** verifies correct operation of the SQLITE_LAST_ERRNO verb.
6163 */
6164 static int SQLITE_TCLAPI file_control_lasterrno_test(
6165 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6166 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6167 int objc, /* Number of arguments */
6168 Tcl_Obj *CONST objv[] /* Command arguments */
6169 ){
6170 int iArg = 0;
6171 sqlite3 *db;
6172 int rc;
6173
6174 if( objc!=2 ){
6175 Tcl_AppendResult(interp, "wrong # args: should be \"",
6176 Tcl_GetStringFromObj(objv[0], 0), " DB", 0);
6177 return TCL_ERROR;
6178 }
6179 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ){
6180 return TCL_ERROR;
6181 }
6182 rc = sqlite3_file_control(db, NULL, SQLITE_LAST_ERRNO, &iArg);
6183 if( rc ){
6184 Tcl_SetObjResult(interp, Tcl_NewIntObj(rc));
6185 return TCL_ERROR;
6186 }
6187 if( iArg!=0 ) {
6188 Tcl_AppendResult(interp, "Unexpected non-zero errno: ",
6189 Tcl_GetStringFromObj(Tcl_NewIntObj(iArg), 0), " ", 0);
6190 return TCL_ERROR;
6191 }
6192 return TCL_OK;
6193 }
6194
6195 /*
6196 ** tclcmd: file_control_data_version DB DBNAME
6197 **
6198 ** This TCL command runs the sqlite3_file_control with the
6199 ** SQLITE_FCNTL_DATA_VERSION opcode, returning the result.
6200 */
6201 static int SQLITE_TCLAPI file_control_data_version(
6202 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6203 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6204 int objc, /* Number of arguments */
6205 Tcl_Obj *CONST objv[] /* Command arguments */
6206 ){
6207 unsigned int iVers; /* data version */
6208 char *zDb; /* Db name ("main", "temp" etc.) */
6209 sqlite3 *db; /* Database handle */
6210 int rc; /* file_control() return code */
6211 char zBuf[100];
6212
6213 if( objc!=3 && objc!=2 ){
6214 Tcl_WrongNumArgs(interp, 1, objv, "DB [DBNAME]");
6215 return TCL_ERROR;
6216 }
6217 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ){
6218 return TCL_ERROR;
6219 }
6220 zDb = objc==3 ? Tcl_GetString(objv[2]) : NULL;
6221
6222 rc = sqlite3_file_control(db, zDb, SQLITE_FCNTL_DATA_VERSION, (void *)&iVers);
6223 if( rc ){
6224 Tcl_SetResult(interp, (char *)sqlite3ErrName(rc), TCL_STATIC);
6225 return TCL_ERROR;
6226 }else{
6227 sqlite3_snprintf(sizeof(zBuf),zBuf,"%u",iVers);
6228 Tcl_SetResult(interp, (char *)zBuf, TCL_VOLATILE);
6229 return TCL_OK;
6230 }
6231 }
6232
6233 /*
6234 ** tclcmd: file_control_chunksize_test DB DBNAME SIZE
6235 **
6236 ** This TCL command runs the sqlite3_file_control interface and
6237 ** verifies correct operation of the SQLITE_GET_LOCKPROXYFILE and
6238 ** SQLITE_SET_LOCKPROXYFILE verbs.
6239 */
6240 static int SQLITE_TCLAPI file_control_chunksize_test(
6241 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6242 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6243 int objc, /* Number of arguments */
6244 Tcl_Obj *CONST objv[] /* Command arguments */
6245 ){
6246 int nSize; /* New chunk size */
6247 char *zDb; /* Db name ("main", "temp" etc.) */
6248 sqlite3 *db; /* Database handle */
6249 int rc; /* file_control() return code */
6250
6251 if( objc!=4 ){
6252 Tcl_WrongNumArgs(interp, 1, objv, "DB DBNAME SIZE");
6253 return TCL_ERROR;
6254 }
6255 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db)
6256 || Tcl_GetIntFromObj(interp, objv[3], &nSize)
6257 ){
6258 return TCL_ERROR;
6259 }
6260 zDb = Tcl_GetString(objv[2]);
6261 if( zDb[0]=='\0' ) zDb = NULL;
6262
6263 rc = sqlite3_file_control(db, zDb, SQLITE_FCNTL_CHUNK_SIZE, (void *)&nSize);
6264 if( rc ){
6265 Tcl_SetResult(interp, (char *)sqlite3ErrName(rc), TCL_STATIC);
6266 return TCL_ERROR;
6267 }
6268 return TCL_OK;
6269 }
6270
6271 /*
6272 ** tclcmd: file_control_sizehint_test DB DBNAME SIZE
6273 **
6274 ** This TCL command runs the sqlite3_file_control interface
6275 ** with SQLITE_FCNTL_SIZE_HINT
6276 */
6277 static int SQLITE_TCLAPI file_control_sizehint_test(
6278 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6279 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6280 int objc, /* Number of arguments */
6281 Tcl_Obj *CONST objv[] /* Command arguments */
6282 ){
6283 Tcl_WideInt nSize; /* Hinted size */
6284 char *zDb; /* Db name ("main", "temp" etc.) */
6285 sqlite3 *db; /* Database handle */
6286 int rc; /* file_control() return code */
6287
6288 if( objc!=4 ){
6289 Tcl_WrongNumArgs(interp, 1, objv, "DB DBNAME SIZE");
6290 return TCL_ERROR;
6291 }
6292 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db)
6293 || Tcl_GetWideIntFromObj(interp, objv[3], &nSize)
6294 ){
6295 return TCL_ERROR;
6296 }
6297 zDb = Tcl_GetString(objv[2]);
6298 if( zDb[0]=='\0' ) zDb = NULL;
6299
6300 rc = sqlite3_file_control(db, zDb, SQLITE_FCNTL_SIZE_HINT, (void *)&nSize);
6301 if( rc ){
6302 Tcl_SetResult(interp, (char *)sqlite3ErrName(rc), TCL_STATIC);
6303 return TCL_ERROR;
6304 }
6305 return TCL_OK;
6306 }
6307
6308 /*
6309 ** tclcmd: file_control_lockproxy_test DB PWD
6310 **
6311 ** This TCL command runs the sqlite3_file_control interface and
6312 ** verifies correct operation of the SQLITE_GET_LOCKPROXYFILE and
6313 ** SQLITE_SET_LOCKPROXYFILE verbs.
6314 */
6315 static int SQLITE_TCLAPI file_control_lockproxy_test(
6316 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6317 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6318 int objc, /* Number of arguments */
6319 Tcl_Obj *CONST objv[] /* Command arguments */
6320 ){
6321 sqlite3 *db;
6322
6323 if( objc!=3 ){
6324 Tcl_AppendResult(interp, "wrong # args: should be \"",
6325 Tcl_GetStringFromObj(objv[0], 0), " DB PWD", 0);
6326 return TCL_ERROR;
6327 }
6328 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ){
6329 return TCL_ERROR;
6330 }
6331
6332 #if !defined(SQLITE_ENABLE_LOCKING_STYLE)
6333 # if defined(__APPLE__)
6334 # define SQLITE_ENABLE_LOCKING_STYLE 1
6335 # else
6336 # define SQLITE_ENABLE_LOCKING_STYLE 0
6337 # endif
6338 #endif
6339 #if SQLITE_ENABLE_LOCKING_STYLE && defined(__APPLE__)
6340 {
6341 char *testPath;
6342 int rc;
6343 int nPwd;
6344 const char *zPwd;
6345 char proxyPath[400];
6346
6347 zPwd = Tcl_GetStringFromObj(objv[2], &nPwd);
6348 if( sizeof(proxyPath)<nPwd+20 ){
6349 Tcl_AppendResult(interp, "PWD too big", (void*)0);
6350 return TCL_ERROR;
6351 }
6352 sqlite3_snprintf(sizeof(proxyPath), proxyPath, "%s/test.proxy", zPwd);
6353 rc = sqlite3_file_control(db, NULL, SQLITE_SET_LOCKPROXYFILE, proxyPath);
6354 if( rc ){
6355 Tcl_SetObjResult(interp, Tcl_NewIntObj(rc));
6356 return TCL_ERROR;
6357 }
6358 rc = sqlite3_file_control(db, NULL, SQLITE_GET_LOCKPROXYFILE, &testPath);
6359 if( strncmp(proxyPath,testPath,11) ){
6360 Tcl_AppendResult(interp, "Lock proxy file did not match the "
6361 "previously assigned value", 0);
6362 return TCL_ERROR;
6363 }
6364 if( rc ){
6365 Tcl_SetObjResult(interp, Tcl_NewIntObj(rc));
6366 return TCL_ERROR;
6367 }
6368 rc = sqlite3_file_control(db, NULL, SQLITE_SET_LOCKPROXYFILE, proxyPath);
6369 if( rc ){
6370 Tcl_SetObjResult(interp, Tcl_NewIntObj(rc));
6371 return TCL_ERROR;
6372 }
6373 }
6374 #endif
6375 return TCL_OK;
6376 }
6377
6378 #if SQLITE_OS_WIN
6379 /*
6380 ** tclcmd: file_control_win32_av_retry DB NRETRY DELAY
6381 **
6382 ** This TCL command runs the sqlite3_file_control interface with
6383 ** the SQLITE_FCNTL_WIN32_AV_RETRY opcode.
6384 */
6385 static int SQLITE_TCLAPI file_control_win32_av_retry(
6386 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6387 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6388 int objc, /* Number of arguments */
6389 Tcl_Obj *CONST objv[] /* Command arguments */
6390 ){
6391 sqlite3 *db;
6392 int rc;
6393 int a[2];
6394 char z[100];
6395
6396 if( objc!=4 ){
6397 Tcl_AppendResult(interp, "wrong # args: should be \"",
6398 Tcl_GetStringFromObj(objv[0], 0), " DB NRETRY DELAY", 0);
6399 return TCL_ERROR;
6400 }
6401 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ){
6402 return TCL_ERROR;
6403 }
6404 if( Tcl_GetIntFromObj(interp, objv[2], &a[0]) ) return TCL_ERROR;
6405 if( Tcl_GetIntFromObj(interp, objv[3], &a[1]) ) return TCL_ERROR;
6406 rc = sqlite3_file_control(db, NULL, SQLITE_FCNTL_WIN32_AV_RETRY, (void*)a);
6407 sqlite3_snprintf(sizeof(z), z, "%d %d %d", rc, a[0], a[1]);
6408 Tcl_AppendResult(interp, z, (char*)0);
6409 return TCL_OK;
6410 }
6411
6412 /*
6413 ** tclcmd: file_control_win32_get_handle DB
6414 **
6415 ** This TCL command runs the sqlite3_file_control interface with
6416 ** the SQLITE_FCNTL_WIN32_GET_HANDLE opcode.
6417 */
6418 static int file_control_win32_get_handle(
6419 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6420 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6421 int objc, /* Number of arguments */
6422 Tcl_Obj *CONST objv[] /* Command arguments */
6423 ){
6424 sqlite3 *db;
6425 int rc;
6426 HANDLE hFile = NULL;
6427 char z[100];
6428
6429 if( objc!=2 ){
6430 Tcl_AppendResult(interp, "wrong # args: should be \"",
6431 Tcl_GetStringFromObj(objv[0], 0), " DB", 0);
6432 return TCL_ERROR;
6433 }
6434 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ){
6435 return TCL_ERROR;
6436 }
6437 rc = sqlite3_file_control(db, NULL, SQLITE_FCNTL_WIN32_GET_HANDLE,
6438 (void*)&hFile);
6439 sqlite3_snprintf(sizeof(z), z, "%d %p", rc, (void*)hFile);
6440 Tcl_AppendResult(interp, z, (char*)0);
6441 return TCL_OK;
6442 }
6443
6444 /*
6445 ** tclcmd: file_control_win32_set_handle DB HANDLE
6446 **
6447 ** This TCL command runs the sqlite3_file_control interface with
6448 ** the SQLITE_FCNTL_WIN32_SET_HANDLE opcode.
6449 */
6450 static int SQLITE_TCLAPI file_control_win32_set_handle(
6451 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6452 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6453 int objc, /* Number of arguments */
6454 Tcl_Obj *CONST objv[] /* Command arguments */
6455 ){
6456 sqlite3 *db;
6457 int rc;
6458 HANDLE hFile = NULL;
6459 char z[100];
6460
6461 if( objc!=3 ){
6462 Tcl_AppendResult(interp, "wrong # args: should be \"",
6463 Tcl_GetStringFromObj(objv[0], 0), " DB HANDLE", 0);
6464 return TCL_ERROR;
6465 }
6466 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ){
6467 return TCL_ERROR;
6468 }
6469 if( getWin32Handle(interp, Tcl_GetString(objv[2]), &hFile) ){
6470 return TCL_ERROR;
6471 }
6472 rc = sqlite3_file_control(db, NULL, SQLITE_FCNTL_WIN32_SET_HANDLE,
6473 (void*)&hFile);
6474 sqlite3_snprintf(sizeof(z), z, "%d %p", rc, (void*)hFile);
6475 Tcl_AppendResult(interp, z, (char*)0);
6476 return TCL_OK;
6477 }
6478 #endif
6479
6480 /*
6481 ** tclcmd: file_control_persist_wal DB PERSIST-FLAG
6482 **
6483 ** This TCL command runs the sqlite3_file_control interface with
6484 ** the SQLITE_FCNTL_PERSIST_WAL opcode.
6485 */
6486 static int SQLITE_TCLAPI file_control_persist_wal(
6487 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6488 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6489 int objc, /* Number of arguments */
6490 Tcl_Obj *CONST objv[] /* Command arguments */
6491 ){
6492 sqlite3 *db;
6493 int rc;
6494 int bPersist;
6495 char z[100];
6496
6497 if( objc!=3 ){
6498 Tcl_AppendResult(interp, "wrong # args: should be \"",
6499 Tcl_GetStringFromObj(objv[0], 0), " DB FLAG", 0);
6500 return TCL_ERROR;
6501 }
6502 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ){
6503 return TCL_ERROR;
6504 }
6505 if( Tcl_GetIntFromObj(interp, objv[2], &bPersist) ) return TCL_ERROR;
6506 rc = sqlite3_file_control(db, NULL, SQLITE_FCNTL_PERSIST_WAL, (void*)&bPersist);
6507 sqlite3_snprintf(sizeof(z), z, "%d %d", rc, bPersist);
6508 Tcl_AppendResult(interp, z, (char*)0);
6509 return TCL_OK;
6510 }
6511
6512 /*
6513 ** tclcmd: file_control_powersafe_overwrite DB PSOW-FLAG
6514 **
6515 ** This TCL command runs the sqlite3_file_control interface with
6516 ** the SQLITE_FCNTL_POWERSAFE_OVERWRITE opcode.
6517 */
6518 static int SQLITE_TCLAPI file_control_powersafe_overwrite(
6519 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6520 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6521 int objc, /* Number of arguments */
6522 Tcl_Obj *CONST objv[] /* Command arguments */
6523 ){
6524 sqlite3 *db;
6525 int rc;
6526 int b;
6527 char z[100];
6528
6529 if( objc!=3 ){
6530 Tcl_AppendResult(interp, "wrong # args: should be \"",
6531 Tcl_GetStringFromObj(objv[0], 0), " DB FLAG", 0);
6532 return TCL_ERROR;
6533 }
6534 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ){
6535 return TCL_ERROR;
6536 }
6537 if( Tcl_GetIntFromObj(interp, objv[2], &b) ) return TCL_ERROR;
6538 rc = sqlite3_file_control(db,NULL,SQLITE_FCNTL_POWERSAFE_OVERWRITE,(void*)&b);
6539 sqlite3_snprintf(sizeof(z), z, "%d %d", rc, b);
6540 Tcl_AppendResult(interp, z, (char*)0);
6541 return TCL_OK;
6542 }
6543
6544
6545 /*
6546 ** tclcmd: file_control_vfsname DB ?AUXDB?
6547 **
6548 ** Return a string that describes the stack of VFSes.
6549 */
6550 static int SQLITE_TCLAPI file_control_vfsname(
6551 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6552 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6553 int objc, /* Number of arguments */
6554 Tcl_Obj *CONST objv[] /* Command arguments */
6555 ){
6556 sqlite3 *db;
6557 const char *zDbName = "main";
6558 char *zVfsName = 0;
6559
6560 if( objc!=2 && objc!=3 ){
6561 Tcl_AppendResult(interp, "wrong # args: should be \"",
6562 Tcl_GetStringFromObj(objv[0], 0), " DB ?AUXDB?", 0);
6563 return TCL_ERROR;
6564 }
6565 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ){
6566 return TCL_ERROR;
6567 }
6568 if( objc==3 ){
6569 zDbName = Tcl_GetString(objv[2]);
6570 }
6571 sqlite3_file_control(db, zDbName, SQLITE_FCNTL_VFSNAME,(void*)&zVfsName);
6572 Tcl_AppendResult(interp, zVfsName, (char*)0);
6573 sqlite3_free(zVfsName);
6574 return TCL_OK;
6575 }
6576
6577 /*
6578 ** tclcmd: file_control_reservebytes DB N
6579 */
6580 static int SQLITE_TCLAPI file_control_reservebytes(
6581 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6582 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6583 int objc, /* Number of arguments */
6584 Tcl_Obj *CONST objv[] /* Command arguments */
6585 ){
6586 sqlite3 *db;
6587 const char *zDbName = "main";
6588 int n = 0;
6589 int rc;
6590
6591 if( objc!=3 ){
6592 Tcl_WrongNumArgs(interp, 1, objv, "DB N");
6593 return TCL_ERROR;
6594 }
6595 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db)
6596 || Tcl_GetIntFromObj(interp, objv[2], &n)
6597 ){
6598 return TCL_ERROR;
6599 }
6600
6601 rc = sqlite3_file_control(db, zDbName, SQLITE_FCNTL_RESERVE_BYTES, (void*)&n);
6602 Tcl_SetObjResult(interp, Tcl_NewStringObj(sqlite3ErrName(rc), -1));
6603 return TCL_OK;
6604 }
6605
6606
6607 /*
6608 ** tclcmd: file_control_tempfilename DB ?AUXDB?
6609 **
6610 ** Return a string that is a temporary filename
6611 */
6612 static int SQLITE_TCLAPI file_control_tempfilename(
6613 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6614 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6615 int objc, /* Number of arguments */
6616 Tcl_Obj *CONST objv[] /* Command arguments */
6617 ){
6618 sqlite3 *db;
6619 const char *zDbName = "main";
6620 char *zTName = 0;
6621
6622 if( objc!=2 && objc!=3 ){
6623 Tcl_AppendResult(interp, "wrong # args: should be \"",
6624 Tcl_GetStringFromObj(objv[0], 0), " DB ?AUXDB?", 0);
6625 return TCL_ERROR;
6626 }
6627 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ){
6628 return TCL_ERROR;
6629 }
6630 if( objc==3 ){
6631 zDbName = Tcl_GetString(objv[2]);
6632 }
6633 sqlite3_file_control(db, zDbName, SQLITE_FCNTL_TEMPFILENAME, (void*)&zTName);
6634 Tcl_AppendResult(interp, zTName, (char*)0);
6635 sqlite3_free(zTName);
6636 return TCL_OK;
6637 }
6638
6639 /*
6640 ** tclcmd: file_control_external_reader DB ?AUXDB?
6641 **
6642 ** Return a string that is a temporary filename
6643 */
6644 static int SQLITE_TCLAPI file_control_external_reader(
6645 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6646 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6647 int objc, /* Number of arguments */
6648 Tcl_Obj *CONST objv[] /* Command arguments */
6649 ){
6650 sqlite3 *db;
6651 const char *zName = "main";
6652 int iRes = 0;
6653 int rc = SQLITE_OK;
6654
6655 if( objc!=2 && objc!=3 ){
6656 Tcl_AppendResult(interp, "wrong # args: should be \"",
6657 Tcl_GetStringFromObj(objv[0], 0), " DB ?AUXDB?", 0);
6658 return TCL_ERROR;
6659 }
6660 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ){
6661 return TCL_ERROR;
6662 }
6663 if( objc==3 ){
6664 zName = Tcl_GetString(objv[2]);
6665 }
6666 rc = sqlite3_file_control(db, zName, SQLITE_FCNTL_EXTERNAL_READER, &iRes);
6667 if( rc!=SQLITE_OK ){
6668 Tcl_SetResult(interp, (char *)t1ErrorName(rc), TCL_STATIC);
6669 return TCL_ERROR;
6670 }
6671 Tcl_SetObjResult(interp, Tcl_NewIntObj(iRes));
6672 return TCL_OK;
6673 }
6674
6675
6676 /*
6677 ** tclcmd: sqlite3_vfs_list
6678 **
6679 ** Return a tcl list containing the names of all registered vfs's.
6680 */
6681 static int SQLITE_TCLAPI vfs_list(
6682 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6683 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6684 int objc, /* Number of arguments */
6685 Tcl_Obj *CONST objv[] /* Command arguments */
6686 ){
6687 sqlite3_vfs *pVfs;
6688 Tcl_Obj *pRet = Tcl_NewObj();
6689 if( objc!=1 ){
6690 Tcl_WrongNumArgs(interp, 1, objv, "");
6691 return TCL_ERROR;
6692 }
6693 for(pVfs=sqlite3_vfs_find(0); pVfs; pVfs=pVfs->pNext){
6694 Tcl_ListObjAppendElement(interp, pRet, Tcl_NewStringObj(pVfs->zName, -1));
6695 }
6696 Tcl_SetObjResult(interp, pRet);
6697 return TCL_OK;
6698 }
6699
6700 /*
6701 ** tclcmd: sqlite3_limit DB ID VALUE
6702 **
6703 ** This TCL command runs the sqlite3_limit interface and
6704 ** verifies correct operation of the same.
6705 */
6706 static int SQLITE_TCLAPI test_limit(
6707 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6708 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6709 int objc, /* Number of arguments */
6710 Tcl_Obj *CONST objv[] /* Command arguments */
6711 ){
6712 sqlite3 *db;
6713 int rc;
6714 static const struct {
6715 char *zName;
6716 int id;
6717 } aId[] = {
6718 { "SQLITE_LIMIT_LENGTH", SQLITE_LIMIT_LENGTH },
6719 { "SQLITE_LIMIT_SQL_LENGTH", SQLITE_LIMIT_SQL_LENGTH },
6720 { "SQLITE_LIMIT_COLUMN", SQLITE_LIMIT_COLUMN },
6721 { "SQLITE_LIMIT_EXPR_DEPTH", SQLITE_LIMIT_EXPR_DEPTH },
6722 { "SQLITE_LIMIT_COMPOUND_SELECT", SQLITE_LIMIT_COMPOUND_SELECT },
6723 { "SQLITE_LIMIT_VDBE_OP", SQLITE_LIMIT_VDBE_OP },
6724 { "SQLITE_LIMIT_FUNCTION_ARG", SQLITE_LIMIT_FUNCTION_ARG },
6725 { "SQLITE_LIMIT_ATTACHED", SQLITE_LIMIT_ATTACHED },
6726 { "SQLITE_LIMIT_LIKE_PATTERN_LENGTH", SQLITE_LIMIT_LIKE_PATTERN_LENGTH },
6727 { "SQLITE_LIMIT_VARIABLE_NUMBER", SQLITE_LIMIT_VARIABLE_NUMBER },
6728 { "SQLITE_LIMIT_TRIGGER_DEPTH", SQLITE_LIMIT_TRIGGER_DEPTH },
6729 { "SQLITE_LIMIT_WORKER_THREADS", SQLITE_LIMIT_WORKER_THREADS },
6730
6731 /* Out of range test cases */
6732 { "SQLITE_LIMIT_TOOSMALL", -1, },
6733 { "SQLITE_LIMIT_TOOBIG", SQLITE_LIMIT_WORKER_THREADS+1 },
6734 };
6735 int i, id = 0;
6736 int val;
6737 const char *zId;
6738
6739 if( objc!=4 ){
6740 Tcl_AppendResult(interp, "wrong # args: should be \"",
6741 Tcl_GetStringFromObj(objv[0], 0), " DB ID VALUE", 0);
6742 return TCL_ERROR;
6743 }
6744 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
6745 zId = Tcl_GetString(objv[2]);
6746 for(i=0; i<sizeof(aId)/sizeof(aId[0]); i++){
6747 if( strcmp(zId, aId[i].zName)==0 ){
6748 id = aId[i].id;
6749 break;
6750 }
6751 }
6752 if( i>=sizeof(aId)/sizeof(aId[0]) ){
6753 Tcl_AppendResult(interp, "unknown limit type: ", zId, (char*)0);
6754 return TCL_ERROR;
6755 }
6756 if( Tcl_GetIntFromObj(interp, objv[3], &val) ) return TCL_ERROR;
6757 rc = sqlite3_limit(db, id, val);
6758 Tcl_SetObjResult(interp, Tcl_NewIntObj(rc));
6759 return TCL_OK;
6760 }
6761
6762 /*
6763 ** tclcmd: save_prng_state
6764 **
6765 ** Save the state of the pseudo-random number generator.
6766 ** At the same time, verify that sqlite3_test_control works even when
6767 ** called with an out-of-range opcode.
6768 */
6769 static int SQLITE_TCLAPI save_prng_state(
6770 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6771 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6772 int objc, /* Number of arguments */
6773 Tcl_Obj *CONST objv[] /* Command arguments */
6774 ){
6775 int rc = sqlite3_test_control(9999);
6776 assert( rc==0 );
6777 rc = sqlite3_test_control(-1);
6778 assert( rc==0 );
6779 sqlite3_test_control(SQLITE_TESTCTRL_PRNG_SAVE);
6780 return TCL_OK;
6781 }
6782 /*
6783 ** tclcmd: restore_prng_state
6784 */
6785 static int SQLITE_TCLAPI restore_prng_state(
6786 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6787 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6788 int objc, /* Number of arguments */
6789 Tcl_Obj *CONST objv[] /* Command arguments */
6790 ){
6791 sqlite3_test_control(SQLITE_TESTCTRL_PRNG_RESTORE);
6792 return TCL_OK;
6793 }
6794 /*
6795 ** tclcmd: reset_prng_state
6796 */
6797 static int SQLITE_TCLAPI reset_prng_state(
6798 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6799 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6800 int objc, /* Number of arguments */
6801 Tcl_Obj *CONST objv[] /* Command arguments */
6802 ){
6803 sqlite3_randomness(0,0);
6804 return TCL_OK;
6805 }
6806 /*
6807 ** tclcmd: prng_seed INT ?DB?
6808 **
6809 ** Set up the SQLITE_TESTCTRL_PRNG_SEED pragma with parameter INT and DB.
6810 ** INT is an integer. DB is a database connection, or a NULL pointer if
6811 ** omitted.
6812 **
6813 ** When INT!=0 and DB!=0, set the PRNG seed to the value of the schema
6814 ** cookie for DB, or to INT if the schema cookie happens to be zero.
6815 **
6816 ** When INT!=0 and DB==0, set the PRNG seed to just INT.
6817 **
6818 ** If INT==0 and DB==0 then use the default procedure of calling the
6819 ** xRandomness method on the default VFS to get the PRNG seed.
6820 */
6821 static int SQLITE_TCLAPI prng_seed(
6822 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6823 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6824 int objc, /* Number of arguments */
6825 Tcl_Obj *CONST objv[] /* Command arguments */
6826 ){
6827 int i = 0;
6828 sqlite3 *db = 0;
6829 if( objc!=2 && objc!=3 ){
6830 Tcl_WrongNumArgs(interp, 1, objv, "SEED ?DB?");
6831 return TCL_ERROR;
6832 }
6833 if( Tcl_GetIntFromObj(interp,objv[1],&i) ) return TCL_ERROR;
6834 if( objc==3 && getDbPointer(interp, Tcl_GetString(objv[2]), &db) ){
6835 return TCL_ERROR;
6836 }
6837 sqlite3_test_control(SQLITE_TESTCTRL_PRNG_SEED, i, db);
6838 return TCL_OK;
6839 }
6840
6841 /*
6842 ** tclcmd: extra_schema_checks BOOLEAN
6843 **
6844 ** Enable or disable schema checks when parsing the sqlite_schema file.
6845 ** This is always enabled in production, but it is sometimes useful to
6846 ** disable the checks in order to make some internal error states reachable
6847 ** for testing.
6848 */
6849 static int SQLITE_TCLAPI extra_schema_checks(
6850 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6851 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6852 int objc, /* Number of arguments */
6853 Tcl_Obj *CONST objv[] /* Command arguments */
6854 ){
6855 int i = 0;
6856 if( objc!=2 ){
6857 Tcl_WrongNumArgs(interp, 1, objv, "BOOLEAN");
6858 return TCL_ERROR;
6859 }
6860 if( Tcl_GetBooleanFromObj(interp,objv[1],&i) ) return TCL_ERROR;
6861 sqlite3_test_control(SQLITE_TESTCTRL_EXTRA_SCHEMA_CHECKS, i);
6862 return TCL_OK;
6863 }
6864
6865 /*
6866 ** tclcmd: database_may_be_corrupt
6867 **
6868 ** Indicate that database files might be corrupt. In other words, set the normal
6869 ** state of operation.
6870 */
6871 static int SQLITE_TCLAPI database_may_be_corrupt(
6872 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6873 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6874 int objc, /* Number of arguments */
6875 Tcl_Obj *CONST objv[] /* Command arguments */
6876 ){
6877 sqlite3_test_control(SQLITE_TESTCTRL_NEVER_CORRUPT, 0);
6878 return TCL_OK;
6879 }
6880 /*
6881 ** tclcmd: database_never_corrupt
6882 **
6883 ** Indicate that database files are always well-formed. This enables
6884 ** extra assert() statements that test conditions that are always true
6885 ** for well-formed databases.
6886 */
6887 static int SQLITE_TCLAPI database_never_corrupt(
6888 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6889 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6890 int objc, /* Number of arguments */
6891 Tcl_Obj *CONST objv[] /* Command arguments */
6892 ){
6893 sqlite3_test_control(SQLITE_TESTCTRL_NEVER_CORRUPT, 1);
6894 return TCL_OK;
6895 }
6896
6897 /*
6898 ** tclcmd: pcache_stats
6899 */
6900 static int SQLITE_TCLAPI test_pcache_stats(
6901 ClientData clientData, /* Pointer to sqlite3_enable_XXX function */
6902 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6903 int objc, /* Number of arguments */
6904 Tcl_Obj *CONST objv[] /* Command arguments */
6905 ){
6906 int nMin;
6907 int nMax;
6908 int nCurrent;
6909 int nRecyclable;
6910 Tcl_Obj *pRet;
6911
6912 sqlite3PcacheStats(&nCurrent, &nMax, &nMin, &nRecyclable);
6913
6914 pRet = Tcl_NewObj();
6915 Tcl_ListObjAppendElement(interp, pRet, Tcl_NewStringObj("current", -1));
6916 Tcl_ListObjAppendElement(interp, pRet, Tcl_NewIntObj(nCurrent));
6917 Tcl_ListObjAppendElement(interp, pRet, Tcl_NewStringObj("max", -1));
6918 Tcl_ListObjAppendElement(interp, pRet, Tcl_NewIntObj(nMax));
6919 Tcl_ListObjAppendElement(interp, pRet, Tcl_NewStringObj("min", -1));
6920 Tcl_ListObjAppendElement(interp, pRet, Tcl_NewIntObj(nMin));
6921 Tcl_ListObjAppendElement(interp, pRet, Tcl_NewStringObj("recyclable", -1));
6922 Tcl_ListObjAppendElement(interp, pRet, Tcl_NewIntObj(nRecyclable));
6923
6924 Tcl_SetObjResult(interp, pRet);
6925
6926 return TCL_OK;
6927 }
6928
6929 #ifdef SQLITE_ENABLE_UNLOCK_NOTIFY
6930 static void test_unlock_notify_cb(void **aArg, int nArg){
6931 int ii;
6932 for(ii=0; ii<nArg; ii++){
6933 Tcl_EvalEx((Tcl_Interp *)aArg[ii], "unlock_notify", -1, TCL_EVAL_GLOBAL);
6934 }
6935 }
6936 #endif /* SQLITE_ENABLE_UNLOCK_NOTIFY */
6937
6938 /*
6939 ** tclcmd: sqlite3_unlock_notify db
6940 */
6941 #ifdef SQLITE_ENABLE_UNLOCK_NOTIFY
6942 static int SQLITE_TCLAPI test_unlock_notify(
6943 ClientData clientData, /* Unused */
6944 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6945 int objc, /* Number of arguments */
6946 Tcl_Obj *CONST objv[] /* Command arguments */
6947 ){
6948 sqlite3 *db;
6949 int rc;
6950
6951 if( objc!=2 ){
6952 Tcl_WrongNumArgs(interp, 1, objv, "DB");
6953 return TCL_ERROR;
6954 }
6955
6956 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ){
6957 return TCL_ERROR;
6958 }
6959 rc = sqlite3_unlock_notify(db, test_unlock_notify_cb, (void *)interp);
6960 Tcl_SetResult(interp, (char *)t1ErrorName(rc), TCL_STATIC);
6961 return TCL_OK;
6962 }
6963 #endif
6964
6965 /*
6966 ** tclcmd: sqlite3_wal_checkpoint db ?NAME?
6967 */
6968 static int SQLITE_TCLAPI test_wal_checkpoint(
6969 ClientData clientData, /* Unused */
6970 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
6971 int objc, /* Number of arguments */
6972 Tcl_Obj *CONST objv[] /* Command arguments */
6973 ){
6974 char *zDb = 0;
6975 sqlite3 *db;
6976 int rc;
6977
6978 if( objc!=3 && objc!=2 ){
6979 Tcl_WrongNumArgs(interp, 1, objv, "DB ?NAME?");
6980 return TCL_ERROR;
6981 }
6982
6983 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ){
6984 return TCL_ERROR;
6985 }
6986 if( objc==3 ){
6987 zDb = Tcl_GetString(objv[2]);
6988 }
6989 rc = sqlite3_wal_checkpoint(db, zDb);
6990 Tcl_SetResult(interp, (char *)t1ErrorName(rc), TCL_STATIC);
6991 return TCL_OK;
6992 }
6993
6994 /*
6995 ** tclcmd: sqlite3_wal_checkpoint_v2 db MODE ?NAME?
6996 **
6997 ** This command calls the wal_checkpoint_v2() function with the specified
6998 ** mode argument (passive, full or restart). If present, the database name
6999 ** NAME is passed as the second argument to wal_checkpoint_v2(). If it the
7000 ** NAME argument is not present, a NULL pointer is passed instead.
7001 **
7002 ** If wal_checkpoint_v2() returns any value other than SQLITE_BUSY or
7003 ** SQLITE_OK, then this command returns TCL_ERROR. The Tcl result is set
7004 ** to the error message obtained from sqlite3_errmsg().
7005 **
7006 ** Otherwise, this command returns a list of three integers. The first integer
7007 ** is 1 if SQLITE_BUSY was returned, or 0 otherwise. The following two integers
7008 ** are the values returned via the output parameters by wal_checkpoint_v2() -
7009 ** the number of frames in the log and the number of frames in the log
7010 ** that have been checkpointed.
7011 */
7012 static int SQLITE_TCLAPI test_wal_checkpoint_v2(
7013 ClientData clientData, /* Unused */
7014 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
7015 int objc, /* Number of arguments */
7016 Tcl_Obj *CONST objv[] /* Command arguments */
7017 ){
7018 char *zDb = 0;
7019 sqlite3 *db;
7020 int rc;
7021
7022 int eMode;
7023 int nLog = -555;
7024 int nCkpt = -555;
7025 Tcl_Obj *pRet;
7026
7027 const char * aMode[] = { "passive", "full", "restart", "truncate", 0 };
7028 assert( SQLITE_CHECKPOINT_PASSIVE==0 );
7029 assert( SQLITE_CHECKPOINT_FULL==1 );
7030 assert( SQLITE_CHECKPOINT_RESTART==2 );
7031 assert( SQLITE_CHECKPOINT_TRUNCATE==3 );
7032
7033 if( objc!=3 && objc!=4 ){
7034 Tcl_WrongNumArgs(interp, 1, objv, "DB MODE ?NAME?");
7035 return TCL_ERROR;
7036 }
7037
7038 if( objc==4 ){
7039 zDb = Tcl_GetString(objv[3]);
7040 }
7041 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) || (
7042 TCL_OK!=Tcl_GetIntFromObj(0, objv[2], &eMode)
7043 && TCL_OK!=Tcl_GetIndexFromObj(interp, objv[2], aMode, "mode", 0, &eMode)
7044 )){
7045 return TCL_ERROR;
7046 }
7047
7048 rc = sqlite3_wal_checkpoint_v2(db, zDb, eMode, &nLog, &nCkpt);
7049 if( rc!=SQLITE_OK && rc!=SQLITE_BUSY ){
7050 const char *zErrCode = sqlite3ErrName(rc);
7051 Tcl_ResetResult(interp);
7052 Tcl_AppendResult(interp, zErrCode, " - ", (char *)sqlite3_errmsg(db), 0);
7053 return TCL_ERROR;
7054 }
7055
7056 pRet = Tcl_NewObj();
7057 Tcl_ListObjAppendElement(interp, pRet, Tcl_NewIntObj(rc==SQLITE_BUSY?1:0));
7058 Tcl_ListObjAppendElement(interp, pRet, Tcl_NewIntObj(nLog));
7059 Tcl_ListObjAppendElement(interp, pRet, Tcl_NewIntObj(nCkpt));
7060 Tcl_SetObjResult(interp, pRet);
7061
7062 return TCL_OK;
7063 }
7064
7065 /*
7066 ** tclcmd: sqlite3_wal_autocheckpoint db VALUE
7067 */
7068 static int SQLITE_TCLAPI test_wal_autocheckpoint(
7069 ClientData clientData, /* Unused */
7070 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
7071 int objc, /* Number of arguments */
7072 Tcl_Obj *CONST objv[] /* Command arguments */
7073 ){
7074 sqlite3 *db;
7075 int rc;
7076 int iVal;
7077
7078
7079 if( objc!=3 ){
7080 Tcl_WrongNumArgs(interp, 1, objv, "DB VALUE");
7081 return TCL_ERROR;
7082 }
7083
7084 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db)
7085 || Tcl_GetIntFromObj(0, objv[2], &iVal)
7086 ){
7087 return TCL_ERROR;
7088 }
7089
7090 rc = sqlite3_wal_autocheckpoint(db, iVal);
7091 Tcl_ResetResult(interp);
7092 if( rc!=SQLITE_OK ){
7093 const char *zErrCode = sqlite3ErrName(rc);
7094 Tcl_SetObjResult(interp, Tcl_NewStringObj(zErrCode, -1));
7095 return TCL_ERROR;
7096 }
7097
7098 return TCL_OK;
7099 }
7100
7101
7102 /*
7103 ** tclcmd: test_sqlite3_log ?SCRIPT?
7104 */
7105 static struct LogCallback {
7106 Tcl_Interp *pInterp;
7107 Tcl_Obj *pObj;
7108 } logcallback = {0, 0};
7109 static void xLogcallback(void *unused, int err, char *zMsg){
7110 Tcl_Obj *pNew = Tcl_DuplicateObj(logcallback.pObj);
7111 Tcl_IncrRefCount(pNew);
7112 Tcl_ListObjAppendElement(
7113 0, pNew, Tcl_NewStringObj(sqlite3ErrName(err), -1)
7114 );
7115 Tcl_ListObjAppendElement(0, pNew, Tcl_NewStringObj(zMsg, -1));
7116 Tcl_EvalObjEx(logcallback.pInterp, pNew, TCL_EVAL_GLOBAL|TCL_EVAL_DIRECT);
7117 Tcl_DecrRefCount(pNew);
7118 }
7119 static int SQLITE_TCLAPI test_sqlite3_log(
7120 ClientData clientData,
7121 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
7122 int objc, /* Number of arguments */
7123 Tcl_Obj *CONST objv[] /* Command arguments */
7124 ){
7125 if( objc>2 ){
7126 Tcl_WrongNumArgs(interp, 1, objv, "SCRIPT");
7127 return TCL_ERROR;
7128 }
7129 if( logcallback.pObj ){
7130 Tcl_DecrRefCount(logcallback.pObj);
7131 logcallback.pObj = 0;
7132 logcallback.pInterp = 0;
7133 sqlite3_config(SQLITE_CONFIG_LOG, (void*)0, (void*)0);
7134 }
7135 if( objc>1 ){
7136 logcallback.pObj = objv[1];
7137 Tcl_IncrRefCount(logcallback.pObj);
7138 logcallback.pInterp = interp;
7139 sqlite3_config(SQLITE_CONFIG_LOG, xLogcallback, (void*)0);
7140 }
7141 return TCL_OK;
7142 }
7143
7144 /*
7145 ** tcl_objproc COMMANDNAME ARGS...
7146 **
7147 ** Run a TCL command using its objProc interface. Throw an error if
7148 ** the command has no objProc interface.
7149 */
7150 static int SQLITE_TCLAPI runAsObjProc(
7151 void * clientData,
7152 Tcl_Interp *interp,
7153 int objc,
7154 Tcl_Obj *CONST objv[]
7155 ){
7156 Tcl_CmdInfo cmdInfo;
7157 if( objc<2 ){
7158 Tcl_WrongNumArgs(interp, 1, objv, "COMMAND ...");
7159 return TCL_ERROR;
7160 }
7161 if( !Tcl_GetCommandInfo(interp, Tcl_GetString(objv[1]), &cmdInfo) ){
7162 Tcl_AppendResult(interp, "command not found: ",
7163 Tcl_GetString(objv[1]), (char*)0);
7164 return TCL_ERROR;
7165 }
7166 if( cmdInfo.objProc==0 ){
7167 Tcl_AppendResult(interp, "command has no objProc: ",
7168 Tcl_GetString(objv[1]), (char*)0);
7169 return TCL_ERROR;
7170 }
7171 return cmdInfo.objProc(cmdInfo.objClientData, interp, objc-1, objv+1);
7172 }
7173
7174 #ifndef SQLITE_OMIT_EXPLAIN
7175 /*
7176 ** WARNING: The following function, printExplainQueryPlan() is an exact
7177 ** copy of example code from eqp.in (eqp.html). If this code is modified,
7178 ** then the documentation copy needs to be modified as well.
7179 */
7180 /*
7181 ** Argument pStmt is a prepared SQL statement. This function compiles
7182 ** an EXPLAIN QUERY PLAN command to report on the prepared statement,
7183 ** and prints the report to stdout using printf().
7184 */
7185 int printExplainQueryPlan(sqlite3_stmt *pStmt){
7186 const char *zSql; /* Input SQL */
7187 char *zExplain; /* SQL with EXPLAIN QUERY PLAN prepended */
7188 sqlite3_stmt *pExplain; /* Compiled EXPLAIN QUERY PLAN command */
7189 int rc; /* Return code from sqlite3_prepare_v2() */
7190
7191 zSql = sqlite3_sql(pStmt);
7192 if( zSql==0 ) return SQLITE_ERROR;
7193
7194 zExplain = sqlite3_mprintf("EXPLAIN QUERY PLAN %s", zSql);
7195 if( zExplain==0 ) return SQLITE_NOMEM;
7196
7197 rc = sqlite3_prepare_v2(sqlite3_db_handle(pStmt), zExplain, -1, &pExplain, 0);
7198 sqlite3_free(zExplain);
7199 if( rc!=SQLITE_OK ) return rc;
7200
7201 while( SQLITE_ROW==sqlite3_step(pExplain) ){
7202 int iSelectid = sqlite3_column_int(pExplain, 0);
7203 int iOrder = sqlite3_column_int(pExplain, 1);
7204 int iFrom = sqlite3_column_int(pExplain, 2);
7205 const char *zDetail = (const char *)sqlite3_column_text(pExplain, 3);
7206
7207 printf("%d %d %d %s\n", iSelectid, iOrder, iFrom, zDetail);
7208 }
7209
7210 return sqlite3_finalize(pExplain);
7211 }
7212
7213 static int SQLITE_TCLAPI test_print_eqp(
7214 void * clientData,
7215 Tcl_Interp *interp,
7216 int objc,
7217 Tcl_Obj *CONST objv[]
7218 ){
7219 int rc;
7220 sqlite3_stmt *pStmt;
7221
7222 if( objc!=2 ){
7223 Tcl_WrongNumArgs(interp, 1, objv, "STMT");
7224 return TCL_ERROR;
7225 }
7226 if( getStmtPointer(interp, Tcl_GetString(objv[1]), &pStmt) ) return TCL_ERROR;
7227 rc = printExplainQueryPlan(pStmt);
7228 /* This is needed on Windows so that a test case using this
7229 ** function can open a read pipe and get the output of
7230 ** printExplainQueryPlan() immediately.
7231 */
7232 fflush(stdout);
7233 Tcl_SetResult(interp, (char *)t1ErrorName(rc), 0);
7234 return TCL_OK;
7235 }
7236 #endif /* SQLITE_OMIT_EXPLAIN */
7237
7238 #include <time.h>
7239 /*
7240 ** This is an alternative localtime_r() implementation used for testing
7241 ** the 'localtime' and 'utc' modifiers of date-time functions. Because
7242 ** the OS-supplied localtime_r() is locale-dependent, this alternative is
7243 ** provided as a stable test platform.
7244 **
7245 ** Operation:
7246 **
7247 ** (1) Localtime is 30 minutes earlier than (west of) UTC on
7248 ** even days (counting from 1970-01-01)
7249 **
7250 ** (2) Localtime is 30 minutes later than (east of) UTC on odd days.
7251 **
7252 ** (3) The function fails for the specific date/time value
7253 ** of 2000-05-29 14:16:00 in order to test the ability of
7254 ** SQLite to deal with localtime_r() failures.
7255 */
7256 static int testLocaltime(const void *aliasT, void *aliasTM){
7257 const time_t t = *(const time_t*)aliasT;
7258 struct tm *pTm = (struct tm *)aliasTM;
7259 time_t altT;
7260 sqlite3_int64 iJD;
7261 int Z, A, B, C, D, E, X1, S;
7262
7263 if( (t/86400) & 1 ){
7264 altT = t + 1800; /* 30 minutes later on odd days */
7265 }else{
7266 altT = t - 1800; /* 30 minutes earlier on even days */
7267 }
7268 iJD = (sqlite3_int64)(altT + 210866760000);
7269 Z = (int)((iJD + 43200)/86400);
7270 A = (int)((Z - 1867216.25)/36524.25);
7271 A = Z + 1 + A - (A/4);
7272 B = A + 1524;
7273 C = (int)((B - 122.1)/365.25);
7274 D = (36525*(C&32767))/100;
7275 E = (int)((B-D)/30.6001);
7276 X1 = (int)(30.6001*E);
7277 pTm->tm_mday = B - D - X1;
7278 pTm->tm_mon = E<14 ? E-2 : E-14;
7279 pTm->tm_year = (pTm->tm_mon>1 ? C - 4716 : C - 4715) - 1900;
7280 S = (int)((iJD + 43200)%86400);
7281 pTm->tm_hour = S/3600;
7282 pTm->tm_min = (S/60)%60;
7283 pTm->tm_sec = S % 60;
7284 return t==959609760; /* Special case: 2000-05-29 14:16:00 fails */
7285 }
7286
7287 /*
7288 ** sqlite3_test_control VERB ARGS...
7289 */
7290 static int SQLITE_TCLAPI test_test_control(
7291 void * clientData,
7292 Tcl_Interp *interp,
7293 int objc,
7294 Tcl_Obj *CONST objv[]
7295 ){
7296 struct Verb {
7297 const char *zName;
7298 int i;
7299 } aVerb[] = {
7300 { "SQLITE_TESTCTRL_LOCALTIME_FAULT", SQLITE_TESTCTRL_LOCALTIME_FAULT },
7301 { "SQLITE_TESTCTRL_SORTER_MMAP", SQLITE_TESTCTRL_SORTER_MMAP },
7302 { "SQLITE_TESTCTRL_IMPOSTER", SQLITE_TESTCTRL_IMPOSTER },
7303 { "SQLITE_TESTCTRL_INTERNAL_FUNCTIONS", SQLITE_TESTCTRL_INTERNAL_FUNCTIONS},
7304 };
7305 int iVerb;
7306 int iFlag;
7307 int rc;
7308
7309 if( objc<2 ){
7310 Tcl_WrongNumArgs(interp, 1, objv, "VERB ARGS...");
7311 return TCL_ERROR;
7312 }
7313
7314 rc = Tcl_GetIndexFromObjStruct(
7315 interp, objv[1], aVerb, sizeof(aVerb[0]), "VERB", 0, &iVerb
7316 );
7317 if( rc!=TCL_OK ) return rc;
7318
7319 iFlag = aVerb[iVerb].i;
7320 switch( iFlag ){
7321 case SQLITE_TESTCTRL_INTERNAL_FUNCTIONS: {
7322 sqlite3 *db = 0;
7323 if( objc!=3 ){
7324 Tcl_WrongNumArgs(interp, 2, objv, "DB");
7325 return TCL_ERROR;
7326 }
7327 if( getDbPointer(interp, Tcl_GetString(objv[2]), &db) ) return TCL_ERROR;
7328 sqlite3_test_control(SQLITE_TESTCTRL_INTERNAL_FUNCTIONS, db);
7329 break;
7330 }
7331 case SQLITE_TESTCTRL_LOCALTIME_FAULT: {
7332 int val;
7333 if( objc!=3 ){
7334 Tcl_WrongNumArgs(interp, 2, objv, "0|1|2");
7335 return TCL_ERROR;
7336 }
7337 if( Tcl_GetIntFromObj(interp, objv[2], &val) ) return TCL_ERROR;
7338 sqlite3_test_control(iFlag, val, testLocaltime);
7339 break;
7340 }
7341
7342 case SQLITE_TESTCTRL_SORTER_MMAP: {
7343 int val;
7344 sqlite3 *db;
7345 if( objc!=4 ){
7346 Tcl_WrongNumArgs(interp, 2, objv, "DB LIMIT");
7347 return TCL_ERROR;
7348 }
7349 if( getDbPointer(interp, Tcl_GetString(objv[2]), &db) ) return TCL_ERROR;
7350 if( Tcl_GetIntFromObj(interp, objv[3], &val) ) return TCL_ERROR;
7351 sqlite3_test_control(SQLITE_TESTCTRL_SORTER_MMAP, db, val);
7352 break;
7353 }
7354
7355 case SQLITE_TESTCTRL_IMPOSTER: {
7356 int onOff, tnum;
7357 const char *zDbName;
7358 sqlite3 *db;
7359 if( objc!=6 ){
7360 Tcl_WrongNumArgs(interp, 2, objv, "DB dbName onOff tnum");
7361 return TCL_ERROR;
7362 }
7363 if( getDbPointer(interp, Tcl_GetString(objv[2]), &db) ) return TCL_ERROR;
7364 zDbName = Tcl_GetString(objv[3]);
7365 if( Tcl_GetIntFromObj(interp, objv[4], &onOff) ) return TCL_ERROR;
7366 if( Tcl_GetIntFromObj(interp, objv[5], &tnum) ) return TCL_ERROR;
7367 sqlite3_test_control(SQLITE_TESTCTRL_IMPOSTER, db, zDbName, onOff, tnum);
7368 break;
7369 }
7370 }
7371
7372 Tcl_ResetResult(interp);
7373 return TCL_OK;
7374 }
7375
7376 #if SQLITE_OS_UNIX
7377 #include <sys/time.h>
7378 #include <sys/resource.h>
7379
7380 static int SQLITE_TCLAPI test_getrusage(
7381 void * clientData,
7382 Tcl_Interp *interp,
7383 int objc,
7384 Tcl_Obj *CONST objv[]
7385 ){
7386 char buf[1024];
7387 struct rusage r;
7388 memset(&r, 0, sizeof(r));
7389 getrusage(RUSAGE_SELF, &r);
7390
7391 sqlite3_snprintf(sizeof(buf), buf,
7392 "ru_utime=%d.%06d ru_stime=%d.%06d ru_minflt=%d ru_majflt=%d",
7393 (int)r.ru_utime.tv_sec, (int)r.ru_utime.tv_usec,
7394 (int)r.ru_stime.tv_sec, (int)r.ru_stime.tv_usec,
7395 (int)r.ru_minflt, (int)r.ru_majflt
7396 );
7397 Tcl_SetObjResult(interp, Tcl_NewStringObj(buf, -1));
7398 return TCL_OK;
7399 }
7400 #endif
7401
7402 #if SQLITE_OS_WIN
7403 /*
7404 ** Information passed from the main thread into the windows file locker
7405 ** background thread.
7406 */
7407 struct win32FileLocker {
7408 char *evName; /* Name of event to signal thread startup */
7409 HANDLE h; /* Handle of the file to be locked */
7410 int delay1; /* Delay before locking */
7411 int delay2; /* Delay before unlocking */
7412 int ok; /* Finished ok */
7413 int err; /* True if an error occurs */
7414 };
7415 #endif
7416
7417
7418 #if SQLITE_OS_WIN
7419 #include <process.h>
7420 /*
7421 ** The background thread that does file locking.
7422 */
7423 static void SQLITE_CDECL win32_file_locker(void *pAppData){
7424 struct win32FileLocker *p = (struct win32FileLocker*)pAppData;
7425 if( p->evName ){
7426 HANDLE ev = OpenEvent(EVENT_MODIFY_STATE, FALSE, p->evName);
7427 if ( ev ){
7428 SetEvent(ev);
7429 CloseHandle(ev);
7430 }
7431 }
7432 if( p->delay1 ) Sleep(p->delay1);
7433 if( LockFile(p->h, 0, 0, 100000000, 0) ){
7434 Sleep(p->delay2);
7435 UnlockFile(p->h, 0, 0, 100000000, 0);
7436 p->ok = 1;
7437 }else{
7438 p->err = 1;
7439 }
7440 CloseHandle(p->h);
7441 p->h = 0;
7442 p->delay1 = 0;
7443 p->delay2 = 0;
7444 }
7445 #endif
7446
7447 #if SQLITE_OS_WIN
7448 /*
7449 ** lock_win32_file FILENAME DELAY1 DELAY2
7450 **
7451 ** Get an exclusive manditory lock on file for DELAY2 milliseconds.
7452 ** Wait DELAY1 milliseconds before acquiring the lock.
7453 */
7454 static int SQLITE_TCLAPI win32_file_lock(
7455 void * clientData,
7456 Tcl_Interp *interp,
7457 int objc,
7458 Tcl_Obj *CONST objv[]
7459 ){
7460 static struct win32FileLocker x = { "win32_file_lock", 0, 0, 0, 0, 0 };
7461 const char *zFilename;
7462 char zBuf[200];
7463 int retry = 0;
7464 HANDLE ev;
7465 DWORD wResult;
7466
7467 if( objc!=4 && objc!=1 ){
7468 Tcl_WrongNumArgs(interp, 1, objv, "FILENAME DELAY1 DELAY2");
7469 return TCL_ERROR;
7470 }
7471 if( objc==1 ){
7472 sqlite3_snprintf(sizeof(zBuf), zBuf, "%d %d %d %d %d",
7473 x.ok, x.err, x.delay1, x.delay2, x.h);
7474 Tcl_AppendResult(interp, zBuf, (char*)0);
7475 return TCL_OK;
7476 }
7477 while( x.h && retry<30 ){
7478 retry++;
7479 Sleep(100);
7480 }
7481 if( x.h ){
7482 Tcl_AppendResult(interp, "busy", (char*)0);
7483 return TCL_ERROR;
7484 }
7485 if( Tcl_GetIntFromObj(interp, objv[2], &x.delay1) ) return TCL_ERROR;
7486 if( Tcl_GetIntFromObj(interp, objv[3], &x.delay2) ) return TCL_ERROR;
7487 zFilename = Tcl_GetString(objv[1]);
7488 x.h = CreateFile(zFilename, GENERIC_READ|GENERIC_WRITE,
7489 FILE_SHARE_READ|FILE_SHARE_WRITE, 0, OPEN_ALWAYS,
7490 FILE_ATTRIBUTE_NORMAL, 0);
7491 if( !x.h ){
7492 Tcl_AppendResult(interp, "cannot open file: ", zFilename, (char*)0);
7493 return TCL_ERROR;
7494 }
7495 ev = CreateEvent(NULL, TRUE, FALSE, x.evName);
7496 if ( !ev ){
7497 Tcl_AppendResult(interp, "cannot create event: ", x.evName, (char*)0);
7498 return TCL_ERROR;
7499 }
7500 _beginthread(win32_file_locker, 0, (void*)&x);
7501 Sleep(0);
7502 if ( (wResult = WaitForSingleObject(ev, 10000))!=WAIT_OBJECT_0 ){
7503 sqlite3_snprintf(sizeof(zBuf), zBuf, "0x%x", wResult);
7504 Tcl_AppendResult(interp, "wait failed: ", zBuf, (char*)0);
7505 CloseHandle(ev);
7506 return TCL_ERROR;
7507 }
7508 CloseHandle(ev);
7509 return TCL_OK;
7510 }
7511
7512 /*
7513 ** exists_win32_path PATH
7514 **
7515 ** Returns non-zero if the specified path exists, whose fully qualified name
7516 ** may exceed 260 characters if it is prefixed with "\\?\".
7517 */
7518 static int SQLITE_TCLAPI win32_exists_path(
7519 void *clientData,
7520 Tcl_Interp *interp,
7521 int objc,
7522 Tcl_Obj *CONST objv[]
7523 ){
7524 if( objc!=2 ){
7525 Tcl_WrongNumArgs(interp, 1, objv, "PATH");
7526 return TCL_ERROR;
7527 }
7528 Tcl_SetObjResult(interp, Tcl_NewBooleanObj(
7529 GetFileAttributesW( Tcl_GetUnicode(objv[1]))!=INVALID_FILE_ATTRIBUTES ));
7530 return TCL_OK;
7531 }
7532
7533 /*
7534 ** find_win32_file PATTERN
7535 **
7536 ** Returns a list of entries in a directory that match the specified pattern,
7537 ** whose fully qualified name may exceed 248 characters if it is prefixed with
7538 ** "\\?\".
7539 */
7540 static int SQLITE_TCLAPI win32_find_file(
7541 void *clientData,
7542 Tcl_Interp *interp,
7543 int objc,
7544 Tcl_Obj *CONST objv[]
7545 ){
7546 HANDLE hFindFile = INVALID_HANDLE_VALUE;
7547 WIN32_FIND_DATAW findData;
7548 Tcl_Obj *listObj;
7549 DWORD lastErrno;
7550 if( objc!=2 ){
7551 Tcl_WrongNumArgs(interp, 1, objv, "PATTERN");
7552 return TCL_ERROR;
7553 }
7554 hFindFile = FindFirstFileW(Tcl_GetUnicode(objv[1]), &findData);
7555 if( hFindFile==INVALID_HANDLE_VALUE ){
7556 Tcl_SetObjResult(interp, Tcl_NewWideIntObj(GetLastError()));
7557 return TCL_ERROR;
7558 }
7559 listObj = Tcl_NewObj();
7560 Tcl_IncrRefCount(listObj);
7561 do {
7562 Tcl_ListObjAppendElement(interp, listObj, Tcl_NewUnicodeObj(
7563 findData.cFileName, -1));
7564 Tcl_ListObjAppendElement(interp, listObj, Tcl_NewWideIntObj(
7565 findData.dwFileAttributes));
7566 } while( FindNextFileW(hFindFile, &findData) );
7567 lastErrno = GetLastError();
7568 if( lastErrno!=NO_ERROR && lastErrno!=ERROR_NO_MORE_FILES ){
7569 FindClose(hFindFile);
7570 Tcl_DecrRefCount(listObj);
7571 Tcl_SetObjResult(interp, Tcl_NewWideIntObj(GetLastError()));
7572 return TCL_ERROR;
7573 }
7574 FindClose(hFindFile);
7575 Tcl_SetObjResult(interp, listObj);
7576 return TCL_OK;
7577 }
7578
7579 /*
7580 ** delete_win32_file FILENAME
7581 **
7582 ** Deletes the specified file, whose fully qualified name may exceed 260
7583 ** characters if it is prefixed with "\\?\".
7584 */
7585 static int SQLITE_TCLAPI win32_delete_file(
7586 void *clientData,
7587 Tcl_Interp *interp,
7588 int objc,
7589 Tcl_Obj *CONST objv[]
7590 ){
7591 if( objc!=2 ){
7592 Tcl_WrongNumArgs(interp, 1, objv, "FILENAME");
7593 return TCL_ERROR;
7594 }
7595 if( !DeleteFileW(Tcl_GetUnicode(objv[1])) ){
7596 Tcl_SetObjResult(interp, Tcl_NewWideIntObj(GetLastError()));
7597 return TCL_ERROR;
7598 }
7599 Tcl_ResetResult(interp);
7600 return TCL_OK;
7601 }
7602
7603 /*
7604 ** make_win32_dir DIRECTORY
7605 **
7606 ** Creates the specified directory, whose fully qualified name may exceed 248
7607 ** characters if it is prefixed with "\\?\".
7608 */
7609 static int SQLITE_TCLAPI win32_mkdir(
7610 void *clientData,
7611 Tcl_Interp *interp,
7612 int objc,
7613 Tcl_Obj *CONST objv[]
7614 ){
7615 if( objc!=2 ){
7616 Tcl_WrongNumArgs(interp, 1, objv, "DIRECTORY");
7617 return TCL_ERROR;
7618 }
7619 if( !CreateDirectoryW(Tcl_GetUnicode(objv[1]), NULL) ){
7620 Tcl_SetObjResult(interp, Tcl_NewWideIntObj(GetLastError()));
7621 return TCL_ERROR;
7622 }
7623 Tcl_ResetResult(interp);
7624 return TCL_OK;
7625 }
7626
7627 /*
7628 ** remove_win32_dir DIRECTORY
7629 **
7630 ** Removes the specified directory, whose fully qualified name may exceed 248
7631 ** characters if it is prefixed with "\\?\".
7632 */
7633 static int SQLITE_TCLAPI win32_rmdir(
7634 void *clientData,
7635 Tcl_Interp *interp,
7636 int objc,
7637 Tcl_Obj *CONST objv[]
7638 ){
7639 if( objc!=2 ){
7640 Tcl_WrongNumArgs(interp, 1, objv, "DIRECTORY");
7641 return TCL_ERROR;
7642 }
7643 if( !RemoveDirectoryW(Tcl_GetUnicode(objv[1])) ){
7644 Tcl_SetObjResult(interp, Tcl_NewWideIntObj(GetLastError()));
7645 return TCL_ERROR;
7646 }
7647 Tcl_ResetResult(interp);
7648 return TCL_OK;
7649 }
7650 #endif
7651
7652
7653 /*
7654 ** optimization_control DB OPT BOOLEAN
7655 **
7656 ** Enable or disable query optimizations using the sqlite3_test_control()
7657 ** interface. Disable if BOOLEAN is false and enable if BOOLEAN is true.
7658 ** OPT is the name of the optimization to be disabled.
7659 */
7660 static int SQLITE_TCLAPI optimization_control(
7661 void * clientData,
7662 Tcl_Interp *interp,
7663 int objc,
7664 Tcl_Obj *CONST objv[]
7665 ){
7666 int i;
7667 sqlite3 *db;
7668 const char *zOpt;
7669 int onoff;
7670 int mask = 0;
7671 static const struct {
7672 const char *zOptName;
7673 int mask;
7674 } aOpt[] = {
7675 { "all", SQLITE_AllOpts },
7676 { "none", 0 },
7677 { "query-flattener", SQLITE_QueryFlattener },
7678 { "groupby-order", SQLITE_GroupByOrder },
7679 { "factor-constants", SQLITE_FactorOutConst },
7680 { "distinct-opt", SQLITE_DistinctOpt },
7681 { "cover-idx-scan", SQLITE_CoverIdxScan },
7682 { "order-by-idx-join", SQLITE_OrderByIdxJoin },
7683 { "transitive", SQLITE_Transitive },
7684 { "omit-noop-join", SQLITE_OmitNoopJoin },
7685 { "stat4", SQLITE_Stat4 },
7686 { "skip-scan", SQLITE_SkipScan },
7687 { "push-down", SQLITE_PushDown },
7688 { "balanced-merge", SQLITE_BalancedMerge },
7689 };
7690
7691 if( objc!=4 ){
7692 Tcl_WrongNumArgs(interp, 1, objv, "DB OPT BOOLEAN");
7693 return TCL_ERROR;
7694 }
7695 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
7696 if( Tcl_GetBooleanFromObj(interp, objv[3], &onoff) ) return TCL_ERROR;
7697 zOpt = Tcl_GetString(objv[2]);
7698 for(i=0; i<sizeof(aOpt)/sizeof(aOpt[0]); i++){
7699 if( strcmp(zOpt, aOpt[i].zOptName)==0 ){
7700 mask = aOpt[i].mask;
7701 break;
7702 }
7703 }
7704 if( onoff ) mask = ~mask;
7705 if( i>=sizeof(aOpt)/sizeof(aOpt[0]) ){
7706 Tcl_AppendResult(interp, "unknown optimization - should be one of:",
7707 (char*)0);
7708 for(i=0; i<sizeof(aOpt)/sizeof(aOpt[0]); i++){
7709 Tcl_AppendResult(interp, " ", aOpt[i].zOptName, (char*)0);
7710 }
7711 return TCL_ERROR;
7712 }
7713 sqlite3_test_control(SQLITE_TESTCTRL_OPTIMIZATIONS, db, mask);
7714 return TCL_OK;
7715 }
7716
7717 /*
7718 ** load_static_extension DB NAME ...
7719 **
7720 ** Load one or more statically linked extensions.
7721 */
7722 static int SQLITE_TCLAPI tclLoadStaticExtensionCmd(
7723 void * clientData,
7724 Tcl_Interp *interp,
7725 int objc,
7726 Tcl_Obj *CONST objv[]
7727 ){
7728 extern int sqlite3_amatch_init(sqlite3*,char**,const sqlite3_api_routines*);
7729 extern int sqlite3_appendvfs_init(sqlite3*,char**,const sqlite3_api_routines*);
7730 extern int sqlite3_carray_init(sqlite3*,char**,const sqlite3_api_routines*);
7731 extern int sqlite3_closure_init(sqlite3*,char**,const sqlite3_api_routines*);
7732 extern int sqlite3_csv_init(sqlite3*,char**,const sqlite3_api_routines*);
7733 extern int sqlite3_eval_init(sqlite3*,char**,const sqlite3_api_routines*);
7734 extern int sqlite3_explain_init(sqlite3*,char**,const sqlite3_api_routines*);
7735 extern int sqlite3_fileio_init(sqlite3*,char**,const sqlite3_api_routines*);
7736 extern int sqlite3_decimal_init(sqlite3*,char**,const sqlite3_api_routines*);
7737 extern int sqlite3_fuzzer_init(sqlite3*,char**,const sqlite3_api_routines*);
7738 extern int sqlite3_ieee_init(sqlite3*,char**,const sqlite3_api_routines*);
7739 extern int sqlite3_nextchar_init(sqlite3*,char**,const sqlite3_api_routines*);
7740 extern int sqlite3_percentile_init(sqlite3*,char**,const sqlite3_api_routines*);
7741 #ifndef SQLITE_OMIT_VIRTUALTABLE
7742 extern int sqlite3_prefixes_init(sqlite3*,char**,const sqlite3_api_routines*);
7743 #endif
7744 extern int sqlite3_qpvtab_init(sqlite3*,char**,const sqlite3_api_routines*);
7745 extern int sqlite3_regexp_init(sqlite3*,char**,const sqlite3_api_routines*);
7746 extern int sqlite3_remember_init(sqlite3*,char**,const sqlite3_api_routines*);
7747 extern int sqlite3_series_init(sqlite3*,char**,const sqlite3_api_routines*);
7748 extern int sqlite3_spellfix_init(sqlite3*,char**,const sqlite3_api_routines*);
7749 extern int sqlite3_totype_init(sqlite3*,char**,const sqlite3_api_routines*);
7750 extern int sqlite3_wholenumber_init(sqlite3*,char**,const sqlite3_api_routines*);
7751 extern int sqlite3_unionvtab_init(sqlite3*,char**,const sqlite3_api_routines*);
7752 #ifdef SQLITE_HAVE_ZLIB
7753 extern int sqlite3_zipfile_init(sqlite3*,char**,const sqlite3_api_routines*);
7754 #endif
7755 static const struct {
7756 const char *zExtName;
7757 int (*pInit)(sqlite3*,char**,const sqlite3_api_routines*);
7758 } aExtension[] = {
7759 { "amatch", sqlite3_amatch_init },
7760 { "appendvfs", sqlite3_appendvfs_init },
7761 { "carray", sqlite3_carray_init },
7762 { "closure", sqlite3_closure_init },
7763 { "csv", sqlite3_csv_init },
7764 { "decimal", sqlite3_decimal_init },
7765 { "eval", sqlite3_eval_init },
7766 { "explain", sqlite3_explain_init },
7767 { "fileio", sqlite3_fileio_init },
7768 { "fuzzer", sqlite3_fuzzer_init },
7769 { "ieee754", sqlite3_ieee_init },
7770 { "nextchar", sqlite3_nextchar_init },
7771 { "percentile", sqlite3_percentile_init },
7772 #ifndef SQLITE_OMIT_VIRTUALTABLE
7773 { "prefixes", sqlite3_prefixes_init },
7774 #endif
7775 { "qpvtab", sqlite3_qpvtab_init },
7776 { "regexp", sqlite3_regexp_init },
7777 { "remember", sqlite3_remember_init },
7778 { "series", sqlite3_series_init },
7779 { "spellfix", sqlite3_spellfix_init },
7780 { "totype", sqlite3_totype_init },
7781 { "unionvtab", sqlite3_unionvtab_init },
7782 { "wholenumber", sqlite3_wholenumber_init },
7783 #ifdef SQLITE_HAVE_ZLIB
7784 { "zipfile", sqlite3_zipfile_init },
7785 #endif
7786 };
7787 sqlite3 *db;
7788 const char *zName;
7789 int i, j, rc;
7790 char *zErrMsg = 0;
7791 if( objc<3 ){
7792 Tcl_WrongNumArgs(interp, 1, objv, "DB NAME ...");
7793 return TCL_ERROR;
7794 }
7795 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
7796 for(j=2; j<objc; j++){
7797 zName = Tcl_GetString(objv[j]);
7798 for(i=0; i<ArraySize(aExtension); i++){
7799 if( strcmp(zName, aExtension[i].zExtName)==0 ) break;
7800 }
7801 if( i>=ArraySize(aExtension) ){
7802 Tcl_AppendResult(interp, "no such extension: ", zName, (char*)0);
7803 return TCL_ERROR;
7804 }
7805 if( aExtension[i].pInit ){
7806 rc = aExtension[i].pInit(db, &zErrMsg, 0);
7807 }else{
7808 rc = SQLITE_OK;
7809 }
7810 if( (rc!=SQLITE_OK && rc!=SQLITE_OK_LOAD_PERMANENTLY) || zErrMsg ){
7811 Tcl_AppendResult(interp, "initialization of ", zName, " failed: ", zErrMsg,
7812 (char*)0);
7813 sqlite3_free(zErrMsg);
7814 return TCL_ERROR;
7815 }
7816 }
7817 return TCL_OK;
7818 }
7819
7820 /*
7821 ** sorter_test_fakeheap BOOL
7822 **
7823 */
7824 static int SQLITE_TCLAPI sorter_test_fakeheap(
7825 void * clientData,
7826 Tcl_Interp *interp,
7827 int objc,
7828 Tcl_Obj *CONST objv[]
7829 ){
7830 int bArg;
7831 if( objc!=2 ){
7832 Tcl_WrongNumArgs(interp, 1, objv, "BOOL");
7833 return TCL_ERROR;
7834 }
7835
7836 if( Tcl_GetBooleanFromObj(interp, objv[1], &bArg) ){
7837 return TCL_ERROR;
7838 }
7839
7840 if( bArg ){
7841 if( sqlite3GlobalConfig.pHeap==0 ){
7842 sqlite3GlobalConfig.pHeap = SQLITE_INT_TO_PTR(-1);
7843 }
7844 }else{
7845 if( sqlite3GlobalConfig.pHeap==SQLITE_INT_TO_PTR(-1) ){
7846 sqlite3GlobalConfig.pHeap = 0;
7847 }
7848 }
7849
7850 Tcl_ResetResult(interp);
7851 return TCL_OK;
7852 }
7853
7854 /*
7855 ** sorter_test_sort4_helper DB SQL1 NSTEP SQL2
7856 **
7857 ** Compile SQL statement $SQL1 and step it $NSTEP times. For each row,
7858 ** check that the leftmost and rightmost columns returned are both integers,
7859 ** and that both contain the same value.
7860 **
7861 ** Then execute statement $SQL2. Check that the statement returns the same
7862 ** set of integers in the same order as in the previous step (using $SQL1).
7863 */
7864 static int SQLITE_TCLAPI sorter_test_sort4_helper(
7865 void * clientData,
7866 Tcl_Interp *interp,
7867 int objc,
7868 Tcl_Obj *CONST objv[]
7869 ){
7870 const char *zSql1;
7871 const char *zSql2;
7872 int nStep;
7873 int iStep;
7874 unsigned int iCksum1 = 0;
7875 unsigned int iCksum2 = 0;
7876 int rc;
7877 int iB;
7878 sqlite3 *db;
7879 sqlite3_stmt *pStmt;
7880
7881 if( objc!=5 ){
7882 Tcl_WrongNumArgs(interp, 1, objv, "DB SQL1 NSTEP SQL2");
7883 return TCL_ERROR;
7884 }
7885
7886 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
7887 zSql1 = Tcl_GetString(objv[2]);
7888 if( Tcl_GetIntFromObj(interp, objv[3], &nStep) ) return TCL_ERROR;
7889 zSql2 = Tcl_GetString(objv[4]);
7890
7891 rc = sqlite3_prepare_v2(db, zSql1, -1, &pStmt, 0);
7892 if( rc!=SQLITE_OK ) goto sql_error;
7893
7894 iB = sqlite3_column_count(pStmt)-1;
7895 for(iStep=0; iStep<nStep && SQLITE_ROW==sqlite3_step(pStmt); iStep++){
7896 int a = sqlite3_column_int(pStmt, 0);
7897 if( a!=sqlite3_column_int(pStmt, iB) ){
7898 Tcl_AppendResult(interp, "data error: (a!=b)", 0);
7899 return TCL_ERROR;
7900 }
7901
7902 iCksum1 += (iCksum1 << 3) + (unsigned int)a;
7903 }
7904 rc = sqlite3_finalize(pStmt);
7905 if( rc!=SQLITE_OK ) goto sql_error;
7906
7907 rc = sqlite3_prepare_v2(db, zSql2, -1, &pStmt, 0);
7908 if( rc!=SQLITE_OK ) goto sql_error;
7909 for(iStep=0; SQLITE_ROW==sqlite3_step(pStmt); iStep++){
7910 int a = sqlite3_column_int(pStmt, 0);
7911 iCksum2 += (iCksum2 << 3) + (unsigned int)a;
7912 }
7913 rc = sqlite3_finalize(pStmt);
7914 if( rc!=SQLITE_OK ) goto sql_error;
7915
7916 if( iCksum1!=iCksum2 ){
7917 Tcl_AppendResult(interp, "checksum mismatch", 0);
7918 return TCL_ERROR;
7919 }
7920
7921 return TCL_OK;
7922 sql_error:
7923 Tcl_AppendResult(interp, "sql error: ", sqlite3_errmsg(db), 0);
7924 return TCL_ERROR;
7925 }
7926
7927
7928 #ifdef SQLITE_USER_AUTHENTICATION
7929 #include "sqlite3userauth.h"
7930 /*
7931 ** tclcmd: sqlite3_user_authenticate DB USERNAME PASSWORD
7932 */
7933 static int SQLITE_TCLAPI test_user_authenticate(
7934 ClientData clientData, /* Unused */
7935 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
7936 int objc, /* Number of arguments */
7937 Tcl_Obj *CONST objv[] /* Command arguments */
7938 ){
7939 char *zUser = 0;
7940 char *zPasswd = 0;
7941 int nPasswd = 0;
7942 sqlite3 *db;
7943 int rc;
7944
7945 if( objc!=4 ){
7946 Tcl_WrongNumArgs(interp, 1, objv, "DB USERNAME PASSWORD");
7947 return TCL_ERROR;
7948 }
7949 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ){
7950 return TCL_ERROR;
7951 }
7952 zUser = Tcl_GetString(objv[2]);
7953 zPasswd = Tcl_GetStringFromObj(objv[3], &nPasswd);
7954 rc = sqlite3_user_authenticate(db, zUser, zPasswd, nPasswd);
7955 Tcl_SetResult(interp, (char *)t1ErrorName(rc), TCL_STATIC);
7956 return TCL_OK;
7957 }
7958 #endif /* SQLITE_USER_AUTHENTICATION */
7959
7960 #ifdef SQLITE_USER_AUTHENTICATION
7961 /*
7962 ** tclcmd: sqlite3_user_add DB USERNAME PASSWORD ISADMIN
7963 */
7964 static int SQLITE_TCLAPI test_user_add(
7965 ClientData clientData, /* Unused */
7966 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
7967 int objc, /* Number of arguments */
7968 Tcl_Obj *CONST objv[] /* Command arguments */
7969 ){
7970 char *zUser = 0;
7971 char *zPasswd = 0;
7972 int nPasswd = 0;
7973 int isAdmin = 0;
7974 sqlite3 *db;
7975 int rc;
7976
7977 if( objc!=5 ){
7978 Tcl_WrongNumArgs(interp, 1, objv, "DB USERNAME PASSWORD ISADMIN");
7979 return TCL_ERROR;
7980 }
7981 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ){
7982 return TCL_ERROR;
7983 }
7984 zUser = Tcl_GetString(objv[2]);
7985 zPasswd = Tcl_GetStringFromObj(objv[3], &nPasswd);
7986 Tcl_GetBooleanFromObj(interp, objv[4], &isAdmin);
7987 rc = sqlite3_user_add(db, zUser, zPasswd, nPasswd, isAdmin);
7988 Tcl_SetResult(interp, (char *)t1ErrorName(rc), TCL_STATIC);
7989 return TCL_OK;
7990 }
7991 #endif /* SQLITE_USER_AUTHENTICATION */
7992
7993 #ifdef SQLITE_USER_AUTHENTICATION
7994 /*
7995 ** tclcmd: sqlite3_user_change DB USERNAME PASSWORD ISADMIN
7996 */
7997 static int SQLITE_TCLAPI test_user_change(
7998 ClientData clientData, /* Unused */
7999 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
8000 int objc, /* Number of arguments */
8001 Tcl_Obj *CONST objv[] /* Command arguments */
8002 ){
8003 char *zUser = 0;
8004 char *zPasswd = 0;
8005 int nPasswd = 0;
8006 int isAdmin = 0;
8007 sqlite3 *db;
8008 int rc;
8009
8010 if( objc!=5 ){
8011 Tcl_WrongNumArgs(interp, 1, objv, "DB USERNAME PASSWORD ISADMIN");
8012 return TCL_ERROR;
8013 }
8014 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ){
8015 return TCL_ERROR;
8016 }
8017 zUser = Tcl_GetString(objv[2]);
8018 zPasswd = Tcl_GetStringFromObj(objv[3], &nPasswd);
8019 Tcl_GetBooleanFromObj(interp, objv[4], &isAdmin);
8020 rc = sqlite3_user_change(db, zUser, zPasswd, nPasswd, isAdmin);
8021 Tcl_SetResult(interp, (char *)t1ErrorName(rc), TCL_STATIC);
8022 return TCL_OK;
8023 }
8024 #endif /* SQLITE_USER_AUTHENTICATION */
8025
8026 #ifdef SQLITE_USER_AUTHENTICATION
8027 /*
8028 ** tclcmd: sqlite3_user_delete DB USERNAME
8029 */
8030 static int SQLITE_TCLAPI test_user_delete(
8031 ClientData clientData, /* Unused */
8032 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
8033 int objc, /* Number of arguments */
8034 Tcl_Obj *CONST objv[] /* Command arguments */
8035 ){
8036 char *zUser = 0;
8037 sqlite3 *db;
8038 int rc;
8039
8040 if( objc!=3 ){
8041 Tcl_WrongNumArgs(interp, 1, objv, "DB USERNAME");
8042 return TCL_ERROR;
8043 }
8044 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ){
8045 return TCL_ERROR;
8046 }
8047 zUser = Tcl_GetString(objv[2]);
8048 rc = sqlite3_user_delete(db, zUser);
8049 Tcl_SetResult(interp, (char *)t1ErrorName(rc), TCL_STATIC);
8050 return TCL_OK;
8051 }
8052 #endif /* SQLITE_USER_AUTHENTICATION */
8053
8054 /*
8055 ** tclcmd: bad_behavior TYPE
8056 **
8057 ** Do some things that should trigger a valgrind or -fsanitize=undefined
8058 ** warning. This is used to verify that errors and warnings output by those
8059 ** tools are detected by the test scripts.
8060 **
8061 ** TYPE BEHAVIOR
8062 ** 1 Overflow a signed integer
8063 ** 2 Jump based on an uninitialized variable
8064 ** 3 Read after free
8065 ** 4 Panic
8066 */
8067 static int SQLITE_TCLAPI test_bad_behavior(
8068 ClientData clientData, /* Pointer to an integer containing zero */
8069 Tcl_Interp *interp, /* The TCL interpreter that invoked this command */
8070 int objc, /* Number of arguments */
8071 Tcl_Obj *CONST objv[] /* Command arguments */
8072 ){
8073 int iType;
8074 int xyz;
8075 int i = *(int*)clientData;
8076 int j;
8077 int w[10];
8078 int *a;
8079 if( objc!=2 ){
8080 Tcl_WrongNumArgs(interp, 1, objv, "TYPE");
8081 return TCL_ERROR;
8082 }
8083 if( Tcl_GetIntFromObj(interp, objv[1], &iType) ) return TCL_ERROR;
8084 switch( iType ){
8085 case 1: {
8086 xyz = 0x7fffff00 - i;
8087 xyz += 0x100;
8088 Tcl_SetObjResult(interp, Tcl_NewIntObj(xyz));
8089 break;
8090 }
8091 case 2: {
8092 w[1] = 5;
8093 if( w[i]>0 ) w[1]++;
8094 Tcl_SetObjResult(interp, Tcl_NewIntObj(w[1]));
8095 break;
8096 }
8097 case 3: {
8098 a = malloc( sizeof(int)*10 );
8099 for(j=0; j<10; j++) a[j] = j;
8100 free(a);
8101 Tcl_SetObjResult(interp, Tcl_NewIntObj(a[i]));
8102 break;
8103 }
8104 case 4: {
8105 Tcl_Panic("Deliberate panic");
8106 break;
8107 }
8108 }
8109 return TCL_OK;
8110 }
8111
8112 /*
8113 ** tclcmd: register_dbstat_vtab DB
8114 **
8115 ** Cause the dbstat virtual table to be available on the connection DB
8116 */
8117 static int SQLITE_TCLAPI test_register_dbstat_vtab(
8118 void *clientData,
8119 Tcl_Interp *interp,
8120 int objc,
8121 Tcl_Obj *CONST objv[]
8122 ){
8123 #ifdef SQLITE_OMIT_VIRTUALTABLE
8124 Tcl_AppendResult(interp, "dbstat not available because of "
8125 "SQLITE_OMIT_VIRTUALTABLE", (void*)0);
8126 return TCL_ERROR;
8127 #else
8128 struct SqliteDb { sqlite3 *db; };
8129 char *zDb;
8130 Tcl_CmdInfo cmdInfo;
8131
8132 if( objc!=2 ){
8133 Tcl_WrongNumArgs(interp, 1, objv, "DB");
8134 return TCL_ERROR;
8135 }
8136
8137 zDb = Tcl_GetString(objv[1]);
8138 if( Tcl_GetCommandInfo(interp, zDb, &cmdInfo) ){
8139 sqlite3* db = ((struct SqliteDb*)cmdInfo.objClientData)->db;
8140 sqlite3DbstatRegister(db);
8141 }
8142 return TCL_OK;
8143 #endif /* SQLITE_OMIT_VIRTUALTABLE */
8144 }
8145
8146 /*
8147 ** tclcmd: sqlite3_db_config DB SETTING VALUE
8148 **
8149 ** Invoke sqlite3_db_config() for one of the setting values.
8150 */
8151 static int SQLITE_TCLAPI test_sqlite3_db_config(
8152 void *clientData,
8153 Tcl_Interp *interp,
8154 int objc,
8155 Tcl_Obj *CONST objv[]
8156 ){
8157 static const struct {
8158 const char *zName;
8159 int eVal;
8160 } aSetting[] = {
8161 { "FKEY", SQLITE_DBCONFIG_ENABLE_FKEY },
8162 { "TRIGGER", SQLITE_DBCONFIG_ENABLE_TRIGGER },
8163 { "FTS3_TOKENIZER", SQLITE_DBCONFIG_ENABLE_FTS3_TOKENIZER },
8164 { "LOAD_EXTENSION", SQLITE_DBCONFIG_ENABLE_LOAD_EXTENSION },
8165 { "NO_CKPT_ON_CLOSE", SQLITE_DBCONFIG_NO_CKPT_ON_CLOSE },
8166 { "QPSG", SQLITE_DBCONFIG_ENABLE_QPSG },
8167 { "TRIGGER_EQP", SQLITE_DBCONFIG_TRIGGER_EQP },
8168 { "RESET_DB", SQLITE_DBCONFIG_RESET_DATABASE },
8169 { "DEFENSIVE", SQLITE_DBCONFIG_DEFENSIVE },
8170 { "WRITABLE_SCHEMA", SQLITE_DBCONFIG_WRITABLE_SCHEMA },
8171 { "LEGACY_ALTER_TABLE", SQLITE_DBCONFIG_LEGACY_ALTER_TABLE },
8172 { "DQS_DML", SQLITE_DBCONFIG_DQS_DML },
8173 { "DQS_DDL", SQLITE_DBCONFIG_DQS_DDL },
8174 { "LEGACY_FILE_FORMAT", SQLITE_DBCONFIG_LEGACY_FILE_FORMAT },
8175 };
8176 int i;
8177 int v = 0;
8178 const char *zSetting;
8179 sqlite3 *db;
8180
8181 if( objc!=4 && objc!=3 ){
8182 Tcl_WrongNumArgs(interp, 1, objv, "DB SETTING [VALUE]");
8183 return TCL_ERROR;
8184 }
8185 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
8186 zSetting = Tcl_GetString(objv[2]);
8187 if( sqlite3_strglob("SQLITE_*", zSetting)==0 ) zSetting += 7;
8188 if( sqlite3_strglob("DBCONFIG_*", zSetting)==0 ) zSetting += 9;
8189 if( sqlite3_strglob("ENABLE_*", zSetting)==0 ) zSetting += 7;
8190 for(i=0; i<ArraySize(aSetting); i++){
8191 if( strcmp(zSetting, aSetting[i].zName)==0 ) break;
8192 }
8193 if( i>=ArraySize(aSetting) ){
8194 Tcl_SetObjResult(interp,
8195 Tcl_NewStringObj("unknown sqlite3_db_config setting", -1));
8196 return TCL_ERROR;
8197 }
8198 if( objc==4 ){
8199 if( Tcl_GetIntFromObj(interp, objv[3], &v) ) return TCL_ERROR;
8200 }else{
8201 v = -1;
8202 }
8203 sqlite3_db_config(db, aSetting[i].eVal, v, &v);
8204 Tcl_SetObjResult(interp, Tcl_NewIntObj(v));
8205 return TCL_OK;
8206 }
8207 /*
8208 ** tclcmd: sqlite3_txn_state DB ?SCHEMA?
8209 **
8210 ** Invoke sqlite3_txn_state(DB,SCHEMA) and return the
8211 ** numeric value that results. Use NULL for SCHEMA if the 3 argument
8212 ** is omitted.
8213 */
8214 static int SQLITE_TCLAPI test_sqlite3_txn_state(
8215 void *clientData,
8216 Tcl_Interp *interp,
8217 int objc,
8218 Tcl_Obj *CONST objv[]
8219 ){
8220 sqlite3 *db;
8221 const char *zSchema;
8222 int iTxn;
8223
8224 if( objc!=2 && objc!=3 ){
8225 Tcl_WrongNumArgs(interp, 1, objv, "DB ?SCHEMA?");
8226 return TCL_ERROR;
8227 }
8228 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
8229 zSchema = objc==3 ? Tcl_GetString(objv[2]) : 0;
8230 iTxn = sqlite3_txn_state(db, zSchema);
8231 Tcl_SetObjResult(interp, Tcl_NewIntObj(iTxn));
8232 return TCL_OK;
8233 }
8234
8235 /*
8236 ** Change the name of the main database schema from "main" to "icecube".
8237 */
8238 static int SQLITE_TCLAPI test_dbconfig_maindbname_icecube(
8239 void * clientData,
8240 Tcl_Interp *interp,
8241 int objc,
8242 Tcl_Obj *CONST objv[]
8243 ){
8244 int rc;
8245 sqlite3 *db;
8246 extern int getDbPointer(Tcl_Interp*, const char*, sqlite3**);
8247 if( objc!=2 ){
8248 Tcl_WrongNumArgs(interp, 1, objv, "DB");
8249 return TCL_ERROR;
8250 }else{
8251 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
8252 rc = sqlite3_db_config(db, SQLITE_DBCONFIG_MAINDBNAME, "icecube");
8253 Tcl_SetObjResult(interp, Tcl_NewIntObj(rc));
8254 return TCL_OK;
8255 }
8256 }
8257
8258 /*
8259 ** Usage: sqlite3_mmap_warm DB DBNAME
8260 */
8261 static int SQLITE_TCLAPI test_mmap_warm(
8262 void * clientData,
8263 Tcl_Interp *interp,
8264 int objc,
8265 Tcl_Obj *CONST objv[]
8266 ){
8267 extern int getDbPointer(Tcl_Interp*, const char*, sqlite3**);
8268 extern int sqlite3_mmap_warm(sqlite3 *db, const char *);
8269
8270 if( objc!=2 && objc!=3 ){
8271 Tcl_WrongNumArgs(interp, 1, objv, "DB ?DBNAME?");
8272 return TCL_ERROR;
8273 }else{
8274 int rc;
8275 sqlite3 *db;
8276 const char *zDb = 0;
8277 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
8278 if( objc==3 ){
8279 zDb = Tcl_GetString(objv[2]);
8280 }
8281 rc = sqlite3_mmap_warm(db, zDb);
8282 Tcl_SetObjResult(interp, Tcl_NewStringObj(sqlite3ErrName(rc), -1));
8283 return TCL_OK;
8284 }
8285 }
8286
8287 /*
8288 ** Usage: test_write_db DB OFFSET DATA
8289 **
8290 ** Obtain the sqlite3_file* object for the database file for the "main" db
8291 ** of handle DB. Then invoke its xWrite method to write data DATA to offset
8292 ** OFFSET.
8293 */
8294 static int SQLITE_TCLAPI test_write_db(
8295 void * clientData,
8296 Tcl_Interp *interp,
8297 int objc,
8298 Tcl_Obj *CONST objv[]
8299 ){
8300 sqlite3 *db = 0;
8301 Tcl_WideInt iOff = 0;
8302 const unsigned char *aData = 0;
8303 int nData = 0;
8304 sqlite3_file *pFile = 0;
8305 int rc;
8306
8307 if( objc!=4 ){
8308 Tcl_WrongNumArgs(interp, 1, objv, "DB OFFSET DATA");
8309 return TCL_ERROR;
8310 }
8311 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
8312 if( Tcl_GetWideIntFromObj(interp, objv[2], &iOff) ) return TCL_ERROR;
8313 aData = Tcl_GetByteArrayFromObj(objv[3], &nData);
8314
8315 sqlite3_file_control(db, "main", SQLITE_FCNTL_FILE_POINTER, (void*)&pFile);
8316 rc = pFile->pMethods->xWrite(pFile, aData, nData, iOff);
8317
8318 Tcl_SetResult(interp, (char *)sqlite3ErrName(rc), TCL_VOLATILE);
8319 return TCL_OK;
8320 }
8321
8322 /*
8323 ** Usage: sqlite3_register_cksumvfs
8324 **
8325 */
8326 static int SQLITE_TCLAPI test_register_cksumvfs(
8327 void * clientData,
8328 Tcl_Interp *interp,
8329 int objc,
8330 Tcl_Obj *CONST objv[]
8331 ){
8332 if( objc!=1 ){
8333 Tcl_WrongNumArgs(interp, 1, objv, "");
8334 return TCL_ERROR;
8335 }else{
8336 extern int sqlite3_register_cksumvfs(const char*);
8337 int rc = sqlite3_register_cksumvfs(0);
8338 Tcl_SetResult(interp, (char *)sqlite3ErrName(rc), TCL_VOLATILE);
8339 }
8340 return TCL_OK;
8341 }
8342
8343 /*
8344 ** Usage: sqlite3_unregister_cksumvfs
8345 **
8346 */
8347 static int SQLITE_TCLAPI test_unregister_cksumvfs(
8348 void * clientData,
8349 Tcl_Interp *interp,
8350 int objc,
8351 Tcl_Obj *CONST objv[]
8352 ){
8353 if( objc!=1 ){
8354 Tcl_WrongNumArgs(interp, 1, objv, "");
8355 return TCL_ERROR;
8356 }else{
8357 extern int sqlite3_unregister_cksumvfs(void);
8358 int rc = sqlite3_unregister_cksumvfs();
8359 Tcl_SetResult(interp, (char *)sqlite3ErrName(rc), TCL_VOLATILE);
8360 }
8361 return TCL_OK;
8362 }
8363
8364 /*
8365 ** Usage: decode_hexdb TEXT
8366 **
8367 ** Example: db deserialize [decode_hexdb $output_of_dbtotxt]
8368 **
8369 ** This routine returns a byte-array for an SQLite database file that
8370 ** is constructed from a text input which is the output of the "dbtotxt"
8371 ** utility.
8372 */
8373 static int SQLITE_TCLAPI test_decode_hexdb(
8374 void * clientData,
8375 Tcl_Interp *interp,
8376 int objc,
8377 Tcl_Obj *CONST objv[]
8378 ){
8379 const char *zIn = 0;
8380 unsigned char *a = 0;
8381 int n = 0;
8382 int lineno = 0;
8383 int i, iNext;
8384 int iOffset = 0;
8385 int j, k;
8386 int rc;
8387 unsigned int x[16];
8388 if( objc!=2 ){
8389 Tcl_WrongNumArgs(interp, 1, objv, "HEXDB");
8390 return TCL_ERROR;
8391 }
8392 zIn = Tcl_GetString(objv[1]);
8393 for(i=0; zIn[i]; i=iNext){
8394 lineno++;
8395 for(iNext=i; zIn[iNext] && zIn[iNext]!='\n'; iNext++){}
8396 if( zIn[iNext]=='\n' ) iNext++;
8397 while( zIn[i]==' ' || zIn[i]=='\t' ){ i++; }
8398 if( a==0 ){
8399 int pgsz;
8400 rc = sscanf(zIn+i, "| size %d pagesize %d", &n, &pgsz);
8401 if( rc!=2 ) continue;
8402 if( pgsz<512 || pgsz>65536 || (pgsz&(pgsz-1))!=0 ){
8403 Tcl_AppendResult(interp, "bad 'pagesize' field", (void*)0);
8404 return TCL_ERROR;
8405 }
8406 n = (n+pgsz-1)&~(pgsz-1); /* Round n up to the next multiple of pgsz */
8407 if( n<512 ){
8408 Tcl_AppendResult(interp, "bad 'size' field", (void*)0);
8409 return TCL_ERROR;
8410 }
8411 a = malloc( n );
8412 if( a==0 ){
8413 Tcl_AppendResult(interp, "out of memory", (void*)0);
8414 return TCL_ERROR;
8415 }
8416 memset(a, 0, n);
8417 continue;
8418 }
8419 rc = sscanf(zIn+i, "| page %d offset %d", &j, &k);
8420 if( rc==2 ){
8421 iOffset = k;
8422 continue;
8423 }
8424 rc = sscanf(zIn+i,"| %d: %x %x %x %x %x %x %x %x %x %x %x %x %x %x %x %x",
8425 &j, &x[0], &x[1], &x[2], &x[3], &x[4], &x[5], &x[6], &x[7],
8426 &x[8], &x[9], &x[10], &x[11], &x[12], &x[13], &x[14], &x[15]);
8427 if( rc==17 ){
8428 k = iOffset+j;
8429 if( k+16<=n ){
8430 int ii;
8431 for(ii=0; ii<16; ii++) a[k+ii] = x[ii]&0xff;
8432 }
8433 continue;
8434 }
8435 }
8436 Tcl_SetObjResult(interp, Tcl_NewByteArrayObj(a, n));
8437 free(a);
8438 return TCL_OK;
8439 }
8440
8441 /*
8442 ** Client data for the autovacuum_pages callback.
8443 */
8444 struct AutovacPageData {
8445 Tcl_Interp *interp;
8446 char *zScript;
8447 };
8448 typedef struct AutovacPageData AutovacPageData;
8449
8450 /*
8451 ** Callback functions for sqlite3_autovacuum_pages
8452 */
8453 static unsigned int test_autovacuum_pages_callback(
8454 void *pClientData,
8455 const char *zSchema,
8456 unsigned int nFilePages,
8457 unsigned int nFreePages,
8458 unsigned int nBytePerPage
8459 ){
8460 AutovacPageData *pData = (AutovacPageData*)pClientData;
8461 Tcl_DString str;
8462 unsigned int x;
8463 char zBuf[100];
8464 Tcl_DStringInit(&str);
8465 Tcl_DStringAppend(&str, pData->zScript, -1);
8466 Tcl_DStringAppendElement(&str, zSchema);
8467 sqlite3_snprintf(sizeof(zBuf), zBuf, "%u", nFilePages);
8468 Tcl_DStringAppendElement(&str, zBuf);
8469 sqlite3_snprintf(sizeof(zBuf), zBuf, "%u", nFreePages);
8470 Tcl_DStringAppendElement(&str, zBuf);
8471 sqlite3_snprintf(sizeof(zBuf), zBuf, "%u", nBytePerPage);
8472 Tcl_DStringAppendElement(&str, zBuf);
8473 Tcl_ResetResult(pData->interp);
8474 Tcl_Eval(pData->interp, Tcl_DStringValue(&str));
8475 Tcl_DStringFree(&str);
8476 x = nFreePages;
8477 (void)Tcl_GetIntFromObj(0, Tcl_GetObjResult(pData->interp), (int*)&x);
8478 return x;
8479 }
8480
8481 /*
8482 ** Usage: sqlite3_autovacuum_pages DB SCRIPT
8483 **
8484 ** Add an autovacuum-pages callback to database connection DB. The callback
8485 ** will invoke SCRIPT, after appending parameters.
8486 **
8487 ** If SCRIPT is an empty string or is omitted, then the callback is
8488 ** cancelled.
8489 */
8490 static int SQLITE_TCLAPI test_autovacuum_pages(
8491 void * clientData,
8492 Tcl_Interp *interp,
8493 int objc,
8494 Tcl_Obj *CONST objv[]
8495 ){
8496 AutovacPageData *pData;
8497 sqlite3 *db;
8498 int rc;
8499 const char *zScript;
8500 if( objc!=2 && objc!=3 ){
8501 Tcl_WrongNumArgs(interp, 1, objv, "DB ?SCRIPT?");
8502 return TCL_ERROR;
8503 }
8504 if( getDbPointer(interp, Tcl_GetString(objv[1]), &db) ) return TCL_ERROR;
8505 zScript = objc==3 ? Tcl_GetString(objv[2]) : 0;
8506 if( zScript ){
8507 size_t nScript = strlen(zScript);
8508 pData = sqlite3_malloc64( sizeof(*pData) + nScript + 1 );
8509 if( pData==0 ){
8510 Tcl_AppendResult(interp, "out of memory", (void*)0);
8511 return TCL_ERROR;
8512 }
8513 pData->interp = interp;
8514 pData->zScript = (char*)&pData[1];
8515 memcpy(pData->zScript, zScript, nScript+1);
8516 rc = sqlite3_autovacuum_pages(db,test_autovacuum_pages_callback,
8517 pData, sqlite3_free);
8518 }else{
8519 rc = sqlite3_autovacuum_pages(db, 0, 0, 0);
8520 }
8521 if( rc ){
8522 char zBuf[1000];
8523 sqlite3_snprintf(sizeof(zBuf), zBuf,
8524 "sqlite3_autovacuum_pages() returns %d", rc);
8525 Tcl_AppendResult(interp, zBuf, (void*)0);
8526 return TCL_ERROR;
8527 }
8528 return TCL_OK;
8529 }
8530
8531
8532 /*
8533 ** Register commands with the TCL interpreter.
8534 */
8535 int Sqlitetest1_Init(Tcl_Interp *interp){
8536 extern int sqlite3_search_count;
8537 extern int sqlite3_found_count;
8538 extern int sqlite3_interrupt_count;
8539 extern int sqlite3_open_file_count;
8540 extern int sqlite3_sort_count;
8541 extern int sqlite3_current_time;
8542 #if SQLITE_OS_UNIX && defined(__APPLE__) && SQLITE_ENABLE_LOCKING_STYLE
8543 extern int sqlite3_hostid_num;
8544 #endif
8545 extern int sqlite3_max_blobsize;
8546 extern int SQLITE_TCLAPI sqlite3BtreeSharedCacheReport(void*,
8547 Tcl_Interp*,int,Tcl_Obj*CONST*);
8548 static int iZero = 0;
8549 static struct {
8550 char *zName;
8551 Tcl_CmdProc *xProc;
8552 } aCmd[] = {
8553 { "db_enter", (Tcl_CmdProc*)db_enter },
8554 { "db_leave", (Tcl_CmdProc*)db_leave },
8555 { "sqlite3_mprintf_int", (Tcl_CmdProc*)sqlite3_mprintf_int },
8556 { "sqlite3_mprintf_int64", (Tcl_CmdProc*)sqlite3_mprintf_int64 },
8557 { "sqlite3_mprintf_long", (Tcl_CmdProc*)sqlite3_mprintf_long },
8558 { "sqlite3_mprintf_str", (Tcl_CmdProc*)sqlite3_mprintf_str },
8559 { "sqlite3_snprintf_str", (Tcl_CmdProc*)sqlite3_snprintf_str },
8560 { "sqlite3_mprintf_stronly", (Tcl_CmdProc*)sqlite3_mprintf_stronly},
8561 { "sqlite3_mprintf_double", (Tcl_CmdProc*)sqlite3_mprintf_double },
8562 { "sqlite3_mprintf_scaled", (Tcl_CmdProc*)sqlite3_mprintf_scaled },
8563 { "sqlite3_mprintf_hexdouble", (Tcl_CmdProc*)sqlite3_mprintf_hexdouble},
8564 { "sqlite3_mprintf_z_test", (Tcl_CmdProc*)test_mprintf_z },
8565 { "sqlite3_mprintf_n_test", (Tcl_CmdProc*)test_mprintf_n },
8566 { "sqlite3_snprintf_int", (Tcl_CmdProc*)test_snprintf_int },
8567 { "sqlite3_last_insert_rowid", (Tcl_CmdProc*)test_last_rowid },
8568 { "sqlite3_exec_printf", (Tcl_CmdProc*)test_exec_printf },
8569 { "sqlite3_exec_hex", (Tcl_CmdProc*)test_exec_hex },
8570 { "sqlite3_exec", (Tcl_CmdProc*)test_exec },
8571 { "sqlite3_exec_nr", (Tcl_CmdProc*)test_exec_nr },
8572 #ifndef SQLITE_OMIT_GET_TABLE
8573 { "sqlite3_get_table_printf", (Tcl_CmdProc*)test_get_table_printf },
8574 #endif
8575 { "sqlite3_close", (Tcl_CmdProc*)sqlite_test_close },
8576 { "sqlite3_close_v2", (Tcl_CmdProc*)sqlite_test_close_v2 },
8577 { "sqlite3_create_function", (Tcl_CmdProc*)test_create_function },
8578 { "sqlite3_create_aggregate", (Tcl_CmdProc*)test_create_aggregate },
8579 { "sqlite3_drop_modules", (Tcl_CmdProc*)test_drop_modules },
8580 { "sqlite_register_test_function", (Tcl_CmdProc*)test_register_func },
8581 { "sqlite_abort", (Tcl_CmdProc*)sqlite_abort },
8582 { "sqlite_bind", (Tcl_CmdProc*)test_bind },
8583 { "breakpoint", (Tcl_CmdProc*)test_breakpoint },
8584 { "sqlite3_key", (Tcl_CmdProc*)test_key },
8585 { "sqlite3_rekey", (Tcl_CmdProc*)test_rekey },
8586 { "sqlite3_interrupt", (Tcl_CmdProc*)test_interrupt },
8587 { "sqlite_delete_function", (Tcl_CmdProc*)delete_function },
8588 { "sqlite_delete_collation", (Tcl_CmdProc*)delete_collation },
8589 { "sqlite3_get_autocommit", (Tcl_CmdProc*)get_autocommit },
8590 { "sqlite3_busy_timeout", (Tcl_CmdProc*)test_busy_timeout },
8591 { "printf", (Tcl_CmdProc*)test_printf },
8592 { "sqlite3IoTrace", (Tcl_CmdProc*)test_io_trace },
8593 { "clang_sanitize_address", (Tcl_CmdProc*)clang_sanitize_address },
8594 };
8595 static struct {
8596 char *zName;
8597 Tcl_ObjCmdProc *xProc;
8598 void *clientData;
8599 } aObjCmd[] = {
8600 { "sqlite3_db_config", test_sqlite3_db_config, 0 },
8601 { "sqlite3_txn_state", test_sqlite3_txn_state, 0 },
8602 { "bad_behavior", test_bad_behavior, (void*)&iZero },
8603 { "register_dbstat_vtab", test_register_dbstat_vtab },
8604 { "sqlite3_connection_pointer", get_sqlite_pointer, 0 },
8605 { "intarray_addr", test_intarray_addr, 0 },
8606 { "int64array_addr", test_int64array_addr, 0 },
8607 { "doublearray_addr", test_doublearray_addr, 0 },
8608 { "textarray_addr", test_textarray_addr, 0 },
8609 { "sqlite3_bind_int", test_bind_int, 0 },
8610 { "sqlite3_bind_zeroblob", test_bind_zeroblob, 0 },
8611 { "sqlite3_bind_zeroblob64", test_bind_zeroblob64, 0 },
8612 { "sqlite3_bind_int64", test_bind_int64, 0 },
8613 { "sqlite3_bind_double", test_bind_double, 0 },
8614 { "sqlite3_bind_null", test_bind_null ,0 },
8615 { "sqlite3_bind_text", test_bind_text ,0 },
8616 { "sqlite3_bind_text16", test_bind_text16 ,0 },
8617 { "sqlite3_bind_blob", test_bind_blob ,0 },
8618 { "sqlite3_bind_value_from_select",test_bind_value_from_select ,0 },
8619 { "sqlite3_bind_value_from_preupdate",test_bind_value_from_preupdate ,0 },
8620 #ifndef SQLITE_OMIT_VIRTUALTABLE
8621 { "sqlite3_carray_bind", test_carray_bind ,0 },
8622 #endif
8623 { "sqlite3_bind_parameter_count", test_bind_parameter_count, 0},
8624 { "sqlite3_bind_parameter_name", test_bind_parameter_name, 0},
8625 { "sqlite3_bind_parameter_index", test_bind_parameter_index, 0},
8626 { "sqlite3_clear_bindings", test_clear_bindings, 0},
8627 { "sqlite3_sleep", test_sleep, 0},
8628 { "sqlite3_errcode", test_errcode ,0 },
8629 { "sqlite3_extended_errcode", test_ex_errcode ,0 },
8630 { "sqlite3_errmsg", test_errmsg ,0 },
8631 { "sqlite3_error_offset", test_error_offset ,0 },
8632 { "sqlite3_errmsg16", test_errmsg16 ,0 },
8633 { "sqlite3_open", test_open ,0 },
8634 { "sqlite3_open16", test_open16 ,0 },
8635 { "sqlite3_open_v2", test_open_v2 ,0 },
8636 { "sqlite3_complete16", test_complete16 ,0 },
8637 { "sqlite3_normalize", test_normalize ,0 },
8638
8639 { "sqlite3_prepare", test_prepare ,0 },
8640 { "sqlite3_prepare16", test_prepare16 ,0 },
8641 { "sqlite3_prepare_v2", test_prepare_v2 ,0 },
8642 { "sqlite3_prepare_v3", test_prepare_v3 ,0 },
8643 { "sqlite3_prepare_tkt3134", test_prepare_tkt3134, 0},
8644 { "sqlite3_prepare16_v2", test_prepare16_v2 ,0 },
8645 { "sqlite3_finalize", test_finalize ,0 },
8646 { "sqlite3_stmt_status", test_stmt_status ,0 },
8647 { "sqlite3_reset", test_reset ,0 },
8648 { "sqlite3_expired", test_expired ,0 },
8649 { "sqlite3_transfer_bindings", test_transfer_bind ,0 },
8650 { "sqlite3_changes", test_changes ,0 },
8651 { "sqlite3_step", test_step ,0 },
8652 { "sqlite3_sql", test_sql ,0 },
8653 { "sqlite3_expanded_sql", test_ex_sql ,0 },
8654 #ifdef SQLITE_ENABLE_NORMALIZE
8655 { "sqlite3_normalized_sql", test_norm_sql ,0 },
8656 #endif
8657 { "sqlite3_next_stmt", test_next_stmt ,0 },
8658 { "sqlite3_stmt_readonly", test_stmt_readonly ,0 },
8659 { "sqlite3_stmt_isexplain", test_stmt_isexplain,0 },
8660 { "sqlite3_stmt_busy", test_stmt_busy ,0 },
8661 { "uses_stmt_journal", uses_stmt_journal ,0 },
8662
8663 { "sqlite3_release_memory", test_release_memory, 0},
8664 { "sqlite3_db_release_memory", test_db_release_memory, 0},
8665 { "sqlite3_db_cacheflush", test_db_cacheflush, 0},
8666 { "sqlite3_system_errno", test_system_errno, 0},
8667 { "sqlite3_db_filename", test_db_filename, 0},
8668 { "sqlite3_db_readonly", test_db_readonly, 0},
8669 { "sqlite3_soft_heap_limit", test_soft_heap_limit, 0},
8670 { "sqlite3_soft_heap_limit64", test_soft_heap_limit, 0},
8671 { "sqlite3_hard_heap_limit64", test_hard_heap_limit, 0},
8672 { "sqlite3_thread_cleanup", test_thread_cleanup, 0},
8673 { "sqlite3_pager_refcounts", test_pager_refcounts, 0},
8674
8675 { "sqlite3_load_extension", test_load_extension, 0},
8676 { "sqlite3_enable_load_extension", test_enable_load, 0},
8677 { "sqlite3_extended_result_codes", test_extended_result_codes, 0},
8678 { "sqlite3_limit", test_limit, 0},
8679 { "dbconfig_maindbname_icecube", test_dbconfig_maindbname_icecube },
8680
8681 { "save_prng_state", save_prng_state, 0 },
8682 { "restore_prng_state", restore_prng_state, 0 },
8683 { "reset_prng_state", reset_prng_state, 0 },
8684 { "prng_seed", prng_seed, 0 },
8685 { "extra_schema_checks", extra_schema_checks, 0},
8686 { "database_never_corrupt", database_never_corrupt, 0},
8687 { "database_may_be_corrupt", database_may_be_corrupt, 0},
8688 { "optimization_control", optimization_control,0},
8689 #if SQLITE_OS_WIN
8690 { "lock_win32_file", win32_file_lock, 0 },
8691 { "exists_win32_path", win32_exists_path, 0 },
8692 { "find_win32_file", win32_find_file, 0 },
8693 { "delete_win32_file", win32_delete_file, 0 },
8694 { "make_win32_dir", win32_mkdir, 0 },
8695 { "remove_win32_dir", win32_rmdir, 0 },
8696 #endif
8697 { "tcl_objproc", runAsObjProc, 0 },
8698
8699 /* sqlite3_column_*() API */
8700 { "sqlite3_column_count", test_column_count ,0 },
8701 { "sqlite3_data_count", test_data_count ,0 },
8702 { "sqlite3_column_type", test_column_type ,0 },
8703 { "sqlite3_column_blob", test_column_blob ,0 },
8704 { "sqlite3_column_double", test_column_double ,0 },
8705 { "sqlite3_column_int64", test_column_int64 ,0 },
8706 { "sqlite3_column_text", test_stmt_utf8, (void*)sqlite3_column_text },
8707 { "sqlite3_column_name", test_stmt_utf8, (void*)sqlite3_column_name },
8708 { "sqlite3_column_int", test_stmt_int, (void*)sqlite3_column_int },
8709 { "sqlite3_column_bytes", test_stmt_int, (void*)sqlite3_column_bytes},
8710 #ifndef SQLITE_OMIT_DECLTYPE
8711 { "sqlite3_column_decltype",test_stmt_utf8,(void*)sqlite3_column_decltype},
8712 #endif
8713 #ifdef SQLITE_ENABLE_COLUMN_METADATA
8714 { "sqlite3_column_database_name",test_stmt_utf8,(void*)sqlite3_column_database_name},
8715 { "sqlite3_column_table_name",test_stmt_utf8,(void*)sqlite3_column_table_name},
8716 { "sqlite3_column_origin_name",test_stmt_utf8,(void*)sqlite3_column_origin_name},
8717 #endif
8718
8719 #ifndef SQLITE_OMIT_UTF16
8720 { "sqlite3_column_bytes16", test_stmt_int, (void*)sqlite3_column_bytes16 },
8721 { "sqlite3_column_text16", test_stmt_utf16, (void*)sqlite3_column_text16},
8722 { "sqlite3_column_name16", test_stmt_utf16, (void*)sqlite3_column_name16},
8723 { "add_alignment_test_collations", add_alignment_test_collations, 0 },
8724 #ifndef SQLITE_OMIT_DECLTYPE
8725 { "sqlite3_column_decltype16",test_stmt_utf16,(void*)sqlite3_column_decltype16},
8726 #endif
8727 #ifdef SQLITE_ENABLE_COLUMN_METADATA
8728 {"sqlite3_column_database_name16",
8729 test_stmt_utf16, (void*)sqlite3_column_database_name16},
8730 {"sqlite3_column_table_name16", test_stmt_utf16, (void*)sqlite3_column_table_name16},
8731 {"sqlite3_column_origin_name16", test_stmt_utf16, (void*)sqlite3_column_origin_name16},
8732 #endif
8733 #endif
8734 { "sqlite3_create_collation_v2", test_create_collation_v2, 0 },
8735 { "sqlite3_global_recover", test_global_recover, 0 },
8736 { "working_64bit_int", working_64bit_int, 0 },
8737 { "vfs_unlink_test", vfs_unlink_test, 0 },
8738 { "vfs_initfail_test", vfs_initfail_test, 0 },
8739 { "vfs_unregister_all", vfs_unregister_all, 0 },
8740 { "vfs_reregister_all", vfs_reregister_all, 0 },
8741 { "file_control_test", file_control_test, 0 },
8742 { "file_control_lasterrno_test", file_control_lasterrno_test, 0 },
8743 { "file_control_lockproxy_test", file_control_lockproxy_test, 0 },
8744 { "file_control_chunksize_test", file_control_chunksize_test, 0 },
8745 { "file_control_sizehint_test", file_control_sizehint_test, 0 },
8746 { "file_control_data_version", file_control_data_version, 0 },
8747 #if SQLITE_OS_WIN
8748 { "file_control_win32_av_retry", file_control_win32_av_retry, 0 },
8749 { "file_control_win32_get_handle", file_control_win32_get_handle, 0 },
8750 { "file_control_win32_set_handle", file_control_win32_set_handle, 0 },
8751 #endif
8752 { "file_control_persist_wal", file_control_persist_wal, 0 },
8753 { "file_control_powersafe_overwrite",file_control_powersafe_overwrite,0},
8754 { "file_control_vfsname", file_control_vfsname, 0 },
8755 { "file_control_reservebytes", file_control_reservebytes, 0 },
8756 { "file_control_tempfilename", file_control_tempfilename, 0 },
8757 { "file_control_external_reader", file_control_external_reader, 0 },
8758 { "sqlite3_vfs_list", vfs_list, 0 },
8759 { "sqlite3_create_function_v2", test_create_function_v2, 0 },
8760
8761 /* Functions from os.h */
8762 #ifndef SQLITE_OMIT_UTF16
8763 { "add_test_collate", test_collate, 0 },
8764 { "add_test_collate_needed", test_collate_needed, 0 },
8765 { "add_test_function", test_function, 0 },
8766 { "add_test_utf16bin_collate", test_utf16bin_collate, 0 },
8767 #endif
8768 { "sqlite3_test_errstr", test_errstr, 0 },
8769 { "tcl_variable_type", tcl_variable_type, 0 },
8770 #ifndef SQLITE_OMIT_SHARED_CACHE
8771 { "sqlite3_enable_shared_cache", test_enable_shared, 0 },
8772 { "sqlite3_shared_cache_report", sqlite3BtreeSharedCacheReport, 0},
8773 #endif
8774 { "sqlite3_libversion_number", test_libversion_number, 0 },
8775 { "sqlite3_table_column_metadata", test_table_column_metadata, 0 },
8776 #ifndef SQLITE_OMIT_INCRBLOB
8777 { "sqlite3_blob_reopen", test_blob_reopen, 0 },
8778 #endif
8779 { "pcache_stats", test_pcache_stats, 0 },
8780 #ifdef SQLITE_ENABLE_UNLOCK_NOTIFY
8781 { "sqlite3_unlock_notify", test_unlock_notify, 0 },
8782 #endif
8783 { "sqlite3_wal_checkpoint", test_wal_checkpoint, 0 },
8784 { "sqlite3_wal_checkpoint_v2",test_wal_checkpoint_v2, 0 },
8785 { "sqlite3_wal_autocheckpoint",test_wal_autocheckpoint, 0 },
8786 { "test_sqlite3_log", test_sqlite3_log, 0 },
8787 #ifndef SQLITE_OMIT_EXPLAIN
8788 { "print_explain_query_plan", test_print_eqp, 0 },
8789 #endif
8790 { "sqlite3_test_control", test_test_control },
8791 #if SQLITE_OS_UNIX
8792 { "getrusage", test_getrusage },
8793 #endif
8794 { "load_static_extension", tclLoadStaticExtensionCmd },
8795 { "sorter_test_fakeheap", sorter_test_fakeheap },
8796 { "sorter_test_sort4_helper", sorter_test_sort4_helper },
8797 #ifdef SQLITE_USER_AUTHENTICATION
8798 { "sqlite3_user_authenticate", test_user_authenticate, 0 },
8799 { "sqlite3_user_add", test_user_add, 0 },
8800 { "sqlite3_user_change", test_user_change, 0 },
8801 { "sqlite3_user_delete", test_user_delete, 0 },
8802 #endif
8803 #ifdef SQLITE_ENABLE_STMT_SCANSTATUS
8804 { "sqlite3_stmt_scanstatus", test_stmt_scanstatus, 0 },
8805 { "sqlite3_stmt_scanstatus_reset", test_stmt_scanstatus_reset, 0 },
8806 #endif
8807 #ifdef SQLITE_ENABLE_SQLLOG
8808 { "sqlite3_config_sqllog", test_config_sqllog, 0 },
8809 #endif
8810 { "vfs_current_time_int64", vfsCurrentTimeInt64, 0 },
8811 #ifdef SQLITE_ENABLE_SNAPSHOT
8812 { "sqlite3_snapshot_get", test_snapshot_get, 0 },
8813 { "sqlite3_snapshot_open", test_snapshot_open, 0 },
8814 { "sqlite3_snapshot_free", test_snapshot_free, 0 },
8815 { "sqlite3_snapshot_cmp", test_snapshot_cmp, 0 },
8816 { "sqlite3_snapshot_recover", test_snapshot_recover, 0 },
8817 { "sqlite3_snapshot_get_blob", test_snapshot_get_blob, 0 },
8818 { "sqlite3_snapshot_open_blob", test_snapshot_open_blob, 0 },
8819 { "sqlite3_snapshot_cmp_blob", test_snapshot_cmp_blob, 0 },
8820 #endif
8821 { "sqlite3_delete_database", test_delete_database, 0 },
8822 { "atomic_batch_write", test_atomic_batch_write, 0 },
8823 { "sqlite3_mmap_warm", test_mmap_warm, 0 },
8824 { "sqlite3_config_sorterref", test_config_sorterref, 0 },
8825 { "sqlite3_autovacuum_pages", test_autovacuum_pages, 0 },
8826 { "decode_hexdb", test_decode_hexdb, 0 },
8827 { "test_write_db", test_write_db, 0 },
8828 { "sqlite3_register_cksumvfs", test_register_cksumvfs, 0 },
8829 { "sqlite3_unregister_cksumvfs", test_unregister_cksumvfs, 0 },
8830 };
8831 static int bitmask_size = sizeof(Bitmask)*8;
8832 static int longdouble_size = sizeof(LONGDOUBLE_TYPE);
8833 int i;
8834 extern int sqlite3_sync_count, sqlite3_fullsync_count;
8835 extern int sqlite3_opentemp_count;
8836 extern int sqlite3_like_count;
8837 extern int sqlite3_xferopt_count;
8838 extern int sqlite3_pager_readdb_count;
8839 extern int sqlite3_pager_writedb_count;
8840 extern int sqlite3_pager_writej_count;
8841 #if SQLITE_OS_WIN
8842 extern LONG volatile sqlite3_os_type;
8843 #endif
8844 #ifdef SQLITE_DEBUG
8845 extern u32 sqlite3WhereTrace;
8846 extern int sqlite3OSTrace;
8847 extern int sqlite3WalTrace;
8848 #endif
8849 #ifdef SQLITE_TEST
8850 #ifdef SQLITE_ENABLE_FTS3
8851 extern int sqlite3_fts3_enable_parentheses;
8852 #endif
8853 #endif
8854
8855 for(i=0; i<sizeof(aCmd)/sizeof(aCmd[0]); i++){
8856 Tcl_CreateCommand(interp, aCmd[i].zName, aCmd[i].xProc, 0, 0);
8857 }
8858 for(i=0; i<sizeof(aObjCmd)/sizeof(aObjCmd[0]); i++){
8859 Tcl_CreateObjCommand(interp, aObjCmd[i].zName,
8860 aObjCmd[i].xProc, aObjCmd[i].clientData, 0);
8861 }
8862 Tcl_LinkVar(interp, "sqlite_search_count",
8863 (char*)&sqlite3_search_count, TCL_LINK_INT);
8864 Tcl_LinkVar(interp, "sqlite_found_count",
8865 (char*)&sqlite3_found_count, TCL_LINK_INT);
8866 Tcl_LinkVar(interp, "sqlite_sort_count",
8867 (char*)&sqlite3_sort_count, TCL_LINK_INT);
8868 Tcl_LinkVar(interp, "sqlite3_max_blobsize",
8869 (char*)&sqlite3_max_blobsize, TCL_LINK_INT);
8870 Tcl_LinkVar(interp, "sqlite_like_count",
8871 (char*)&sqlite3_like_count, TCL_LINK_INT);
8872 Tcl_LinkVar(interp, "sqlite_interrupt_count",
8873 (char*)&sqlite3_interrupt_count, TCL_LINK_INT);
8874 Tcl_LinkVar(interp, "sqlite_open_file_count",
8875 (char*)&sqlite3_open_file_count, TCL_LINK_INT);
8876 Tcl_LinkVar(interp, "sqlite_current_time",
8877 (char*)&sqlite3_current_time, TCL_LINK_INT);
8878 #if SQLITE_OS_UNIX && defined(__APPLE__) && SQLITE_ENABLE_LOCKING_STYLE
8879 Tcl_LinkVar(interp, "sqlite_hostid_num",
8880 (char*)&sqlite3_hostid_num, TCL_LINK_INT);
8881 #endif
8882 Tcl_LinkVar(interp, "sqlite3_xferopt_count",
8883 (char*)&sqlite3_xferopt_count, TCL_LINK_INT);
8884 Tcl_LinkVar(interp, "sqlite3_pager_readdb_count",
8885 (char*)&sqlite3_pager_readdb_count, TCL_LINK_INT);
8886 Tcl_LinkVar(interp, "sqlite3_pager_writedb_count",
8887 (char*)&sqlite3_pager_writedb_count, TCL_LINK_INT);
8888 Tcl_LinkVar(interp, "sqlite3_pager_writej_count",
8889 (char*)&sqlite3_pager_writej_count, TCL_LINK_INT);
8890 #ifndef SQLITE_OMIT_UTF16
8891 Tcl_LinkVar(interp, "unaligned_string_counter",
8892 (char*)&unaligned_string_counter, TCL_LINK_INT);
8893 #endif
8894 #ifndef SQLITE_OMIT_UTF16
8895 Tcl_LinkVar(interp, "sqlite_last_needed_collation",
8896 (char*)&pzNeededCollation, TCL_LINK_STRING|TCL_LINK_READ_ONLY);
8897 #endif
8898 #if SQLITE_OS_WIN
8899 Tcl_LinkVar(interp, "sqlite_os_type",
8900 (char*)&sqlite3_os_type, TCL_LINK_LONG);
8901 #endif
8902 #ifdef SQLITE_TEST
8903 {
8904 static const char *query_plan = "*** OBSOLETE VARIABLE ***";
8905 Tcl_LinkVar(interp, "sqlite_query_plan",
8906 (char*)&query_plan, TCL_LINK_STRING|TCL_LINK_READ_ONLY);
8907 }
8908 #endif
8909 #ifdef SQLITE_DEBUG
8910 Tcl_LinkVar(interp, "sqlite_where_trace",
8911 (char*)&sqlite3WhereTrace, TCL_LINK_INT);
8912 Tcl_LinkVar(interp, "sqlite_os_trace",
8913 (char*)&sqlite3OSTrace, TCL_LINK_INT);
8914 #ifndef SQLITE_OMIT_WAL
8915 Tcl_LinkVar(interp, "sqlite_wal_trace",
8916 (char*)&sqlite3WalTrace, TCL_LINK_INT);
8917 #endif
8918 #endif
8919 #ifndef SQLITE_OMIT_DISKIO
8920 Tcl_LinkVar(interp, "sqlite_opentemp_count",
8921 (char*)&sqlite3_opentemp_count, TCL_LINK_INT);
8922 #endif
8923 Tcl_LinkVar(interp, "sqlite_static_bind_value",
8924 (char*)&sqlite_static_bind_value, TCL_LINK_STRING);
8925 Tcl_LinkVar(interp, "sqlite_static_bind_nbyte",
8926 (char*)&sqlite_static_bind_nbyte, TCL_LINK_INT);
8927 Tcl_LinkVar(interp, "sqlite_temp_directory",
8928 (char*)&sqlite3_temp_directory, TCL_LINK_STRING);
8929 Tcl_LinkVar(interp, "sqlite_data_directory",
8930 (char*)&sqlite3_data_directory, TCL_LINK_STRING);
8931 Tcl_LinkVar(interp, "bitmask_size",
8932 (char*)&bitmask_size, TCL_LINK_INT|TCL_LINK_READ_ONLY);
8933 Tcl_LinkVar(interp, "longdouble_size",
8934 (char*)&longdouble_size, TCL_LINK_INT|TCL_LINK_READ_ONLY);
8935 Tcl_LinkVar(interp, "sqlite_sync_count",
8936 (char*)&sqlite3_sync_count, TCL_LINK_INT);
8937 Tcl_LinkVar(interp, "sqlite_fullsync_count",
8938 (char*)&sqlite3_fullsync_count, TCL_LINK_INT);
8939 #if defined(SQLITE_ENABLE_TREETRACE)
8940 Tcl_LinkVar(interp, "sqlite3_unsupported_treetrace",
8941 (char*)&sqlite3TreeTrace, TCL_LINK_INT);
8942 #endif
8943 #if defined(SQLITE_ENABLE_FTS3) && defined(SQLITE_TEST)
8944 Tcl_LinkVar(interp, "sqlite_fts3_enable_parentheses",
8945 (char*)&sqlite3_fts3_enable_parentheses, TCL_LINK_INT);
8946 #endif
8947 return TCL_OK;
8948 }
SQLCipher is an SQLite extension that provides 256 bit AES encryption of database files.