SQLite4
Hex Artifact Content
Not logged in

Artifact 1715fde459415e287d9e1d439c87a38b5a9104d0:


0000: 2f 2a 0a 2a 2a 20 32 30 30 37 20 53 65 70 74 65  /*.** 2007 Septe
0010: 6d 62 65 72 20 39 0a 2a 2a 0a 2a 2a 20 54 68 65  mber 9.**.** The
0020: 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 6d   author disclaim
0030: 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 74  s copyright to t
0040: 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 2e  his source code.
0050: 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a 2a    In place of.**
0060: 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 2c   a legal notice,
0070: 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 73   here is a bless
0080: 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61  ing:.**.**    Ma
0090: 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 6e  y you do good an
00a0: 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 20  d not evil..**  
00b0: 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 66    May you find f
00c0: 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 79  orgiveness for y
00d0: 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 67  ourself and forg
00e0: 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 20  ive others..**  
00f0: 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 20    May you share 
0100: 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 61  freely, never ta
0110: 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 79  king more than y
0120: 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a  ou give..**.****
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0170: 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 54 68 69 73  *****.**.** This
0180: 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e 73 20 74   file contains t
0190: 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  he implementatio
01a0: 6e 20 6f 66 20 73 6f 6d 65 20 54 63 6c 20 63 6f  n of some Tcl co
01b0: 6d 6d 61 6e 64 73 20 75 73 65 64 20 74 6f 0a 2a  mmands used to.*
01c0: 2a 20 74 65 73 74 20 74 68 61 74 20 73 71 6c 69  * test that sqli
01d0: 74 65 34 20 64 61 74 61 62 61 73 65 20 68 61 6e  te4 database han
01e0: 64 6c 65 73 20 6d 61 79 20 62 65 20 63 6f 6e 63  dles may be conc
01f0: 75 72 72 65 6e 74 6c 79 20 61 63 63 65 73 73 65  urrently accesse
0200: 64 20 62 79 20 0a 2a 2a 20 6d 75 6c 74 69 70 6c  d by .** multipl
0210: 65 20 74 68 72 65 61 64 73 2e 20 52 69 67 68 74  e threads. Right
0220: 20 6e 6f 77 20 74 68 69 73 20 6f 6e 6c 79 20 77   now this only w
0230: 6f 72 6b 73 20 6f 6e 20 75 6e 69 78 2e 0a 2a 2f  orks on unix..*/
0240: 0a 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 6c 69  ..#include "sqli
0250: 74 65 49 6e 74 2e 68 22 0a 23 69 6e 63 6c 75 64  teInt.h".#includ
0260: 65 20 3c 74 63 6c 2e 68 3e 0a 0a 23 69 66 20 53  e <tcl.h>..#if S
0270: 51 4c 49 54 45 34 5f 54 48 52 45 41 44 53 41 46  QLITE4_THREADSAF
0280: 45 0a 0a 23 69 6e 63 6c 75 64 65 20 3c 65 72 72  E..#include <err
0290: 6e 6f 2e 68 3e 0a 0a 23 69 66 20 21 64 65 66 69  no.h>..#if !defi
02a0: 6e 65 64 28 5f 4d 53 43 5f 56 45 52 29 0a 23 69  ned(_MSC_VER).#i
02b0: 6e 63 6c 75 64 65 20 3c 75 6e 69 73 74 64 2e 68  nclude <unistd.h
02c0: 3e 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20  >.#endif../*.** 
02d0: 4f 6e 65 20 6f 66 20 74 68 65 73 65 20 69 73 20  One of these is 
02e0: 61 6c 6c 6f 63 61 74 65 64 20 66 6f 72 20 65 61  allocated for ea
02f0: 63 68 20 74 68 72 65 61 64 20 63 72 65 61 74 65  ch thread create
0300: 64 20 62 79 20 5b 73 71 6c 74 68 72 65 61 64 20  d by [sqlthread 
0310: 73 70 61 77 6e 5d 2e 0a 2a 2f 0a 74 79 70 65 64  spawn]..*/.typed
0320: 65 66 20 73 74 72 75 63 74 20 53 71 6c 54 68 72  ef struct SqlThr
0330: 65 61 64 20 53 71 6c 54 68 72 65 61 64 3b 0a 73  ead SqlThread;.s
0340: 74 72 75 63 74 20 53 71 6c 54 68 72 65 61 64 20  truct SqlThread 
0350: 7b 0a 20 20 54 63 6c 5f 54 68 72 65 61 64 49 64  {.  Tcl_ThreadId
0360: 20 70 61 72 65 6e 74 3b 20 20 20 20 20 2f 2a 20   parent;     /* 
0370: 54 68 72 65 61 64 20 69 64 20 6f 66 20 70 61 72  Thread id of par
0380: 65 6e 74 20 74 68 72 65 61 64 20 2a 2f 0a 20 20  ent thread */.  
0390: 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65  Tcl_Interp *inte
03a0: 72 70 3b 20 20 20 20 20 20 2f 2a 20 50 61 72 65  rp;      /* Pare
03b0: 6e 74 20 69 6e 74 65 72 70 72 65 74 65 72 20 2a  nt interpreter *
03c0: 2f 0a 20 20 63 68 61 72 20 2a 7a 53 63 72 69 70  /.  char *zScrip
03d0: 74 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20  t;           /* 
03e0: 54 68 65 20 73 63 72 69 70 74 20 74 6f 20 65 78  The script to ex
03f0: 65 63 75 74 65 2e 20 2a 2f 0a 20 20 63 68 61 72  ecute. */.  char
0400: 20 2a 7a 56 61 72 6e 61 6d 65 3b 20 20 20 20 20   *zVarname;     
0410: 20 20 20 20 20 2f 2a 20 56 61 72 6e 61 6d 65 20       /* Varname 
0420: 69 6e 20 70 61 72 65 6e 74 20 73 63 72 69 70 74  in parent script
0430: 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20   */.};../*.** A 
0440: 63 75 73 74 6f 6d 20 54 63 6c 5f 45 76 65 6e 74  custom Tcl_Event
0450: 20 74 79 70 65 20 75 73 65 64 20 62 79 20 74 68   type used by th
0460: 69 73 20 6d 6f 64 75 6c 65 2e 20 57 68 65 6e 20  is module. When 
0470: 74 68 65 20 65 76 65 6e 74 20 69 73 0a 2a 2a 20  the event is.** 
0480: 68 61 6e 64 6c 65 64 2c 20 73 63 72 69 70 74 20  handled, script 
0490: 7a 53 63 72 69 70 74 20 69 73 20 65 76 61 6c 75  zScript is evalu
04a0: 61 74 65 64 20 69 6e 20 69 6e 74 65 72 70 72 65  ated in interpre
04b0: 74 65 72 20 69 6e 74 65 72 70 2e 20 49 66 0a 2a  ter interp. If.*
04c0: 2a 20 74 68 65 20 65 76 61 6c 75 61 74 69 6f 6e  * the evaluation
04d0: 20 74 68 72 6f 77 73 20 61 6e 20 65 78 63 65 70   throws an excep
04e0: 74 69 6f 6e 20 28 72 65 74 75 72 6e 73 20 54 43  tion (returns TC
04f0: 4c 5f 45 52 52 4f 52 29 2c 20 74 68 65 6e 20 74  L_ERROR), then t
0500: 68 65 0a 2a 2a 20 65 72 72 6f 72 20 69 73 20 68  he.** error is h
0510: 61 6e 64 6c 65 64 20 62 79 20 54 63 6c 5f 42 61  andled by Tcl_Ba
0520: 63 6b 67 72 6f 75 6e 64 45 72 72 6f 72 28 29 2e  ckgroundError().
0530: 20 49 66 20 6e 6f 20 65 72 72 6f 72 20 6f 63 63   If no error occ
0540: 75 72 73 2c 0a 2a 2a 20 74 68 65 20 72 65 73 75  urs,.** the resu
0550: 6c 74 20 69 73 20 73 69 6d 70 6c 79 20 64 69 73  lt is simply dis
0560: 63 61 72 64 65 64 2e 0a 2a 2f 0a 74 79 70 65 64  carded..*/.typed
0570: 65 66 20 73 74 72 75 63 74 20 45 76 61 6c 45 76  ef struct EvalEv
0580: 65 6e 74 20 45 76 61 6c 45 76 65 6e 74 3b 0a 73  ent EvalEvent;.s
0590: 74 72 75 63 74 20 45 76 61 6c 45 76 65 6e 74 20  truct EvalEvent 
05a0: 7b 0a 20 20 54 63 6c 5f 45 76 65 6e 74 20 62 61  {.  Tcl_Event ba
05b0: 73 65 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20  se;          /* 
05c0: 42 61 73 65 20 63 6c 61 73 73 20 6f 66 20 74 79  Base class of ty
05d0: 70 65 20 54 63 6c 5f 45 76 65 6e 74 20 2a 2f 0a  pe Tcl_Event */.
05e0: 20 20 63 68 61 72 20 2a 7a 53 63 72 69 70 74 3b    char *zScript;
05f0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68             /* Th
0600: 65 20 73 63 72 69 70 74 20 74 6f 20 65 78 65 63  e script to exec
0610: 75 74 65 2e 20 2a 2f 0a 20 20 54 63 6c 5f 49 6e  ute. */.  Tcl_In
0620: 74 65 72 70 20 2a 69 6e 74 65 72 70 3b 20 20 20  terp *interp;   
0630: 20 20 20 2f 2a 20 54 68 65 20 69 6e 74 65 72 70     /* The interp
0640: 72 65 74 65 72 20 74 6f 20 65 78 65 63 75 74 65  reter to execute
0650: 20 69 74 20 69 6e 2e 20 2a 2f 0a 7d 3b 0a 0a 73   it in. */.};..s
0660: 74 61 74 69 63 20 54 63 6c 5f 4f 62 6a 43 6d 64  tatic Tcl_ObjCmd
0670: 50 72 6f 63 20 73 71 6c 74 68 72 65 61 64 5f 70  Proc sqlthread_p
0680: 72 6f 63 3b 0a 73 74 61 74 69 63 20 54 63 6c 5f  roc;.static Tcl_
0690: 4f 62 6a 43 6d 64 50 72 6f 63 20 63 6c 6f 63 6b  ObjCmdProc clock
06a0: 5f 73 65 63 6f 6e 64 73 5f 70 72 6f 63 3b 0a 23  _seconds_proc;.#
06b0: 69 66 20 53 51 4c 49 54 45 34 5f 4f 53 5f 55 4e  if SQLITE4_OS_UN
06c0: 49 58 20 26 26 20 64 65 66 69 6e 65 64 28 53 51  IX && defined(SQ
06d0: 4c 49 54 45 34 5f 45 4e 41 42 4c 45 5f 55 4e 4c  LITE4_ENABLE_UNL
06e0: 4f 43 4b 5f 4e 4f 54 49 46 59 29 0a 73 74 61 74  OCK_NOTIFY).stat
06f0: 69 63 20 54 63 6c 5f 4f 62 6a 43 6d 64 50 72 6f  ic Tcl_ObjCmdPro
0700: 63 20 62 6c 6f 63 6b 69 6e 67 5f 73 74 65 70 5f  c blocking_step_
0710: 70 72 6f 63 3b 0a 73 74 61 74 69 63 20 54 63 6c  proc;.static Tcl
0720: 5f 4f 62 6a 43 6d 64 50 72 6f 63 20 62 6c 6f 63  _ObjCmdProc bloc
0730: 6b 69 6e 67 5f 70 72 65 70 61 72 65 5f 70 72 6f  king_prepare_pro
0740: 63 3b 0a 23 65 6e 64 69 66 0a 69 6e 74 20 53 71  c;.#endif.int Sq
0750: 6c 69 74 65 74 65 73 74 31 5f 49 6e 69 74 28 54  litetest1_Init(T
0760: 63 6c 5f 49 6e 74 65 72 70 20 2a 29 3b 0a 69 6e  cl_Interp *);.in
0770: 74 20 53 71 6c 69 74 65 33 5f 49 6e 69 74 28 54  t Sqlite3_Init(T
0780: 63 6c 5f 49 6e 74 65 72 70 20 2a 29 3b 0a 0a 2f  cl_Interp *);../
0790: 2a 20 46 75 6e 63 74 69 6f 6e 73 20 66 72 6f 6d  * Functions from
07a0: 20 74 65 73 74 31 2e 63 20 2a 2f 0a 76 6f 69 64   test1.c */.void
07b0: 20 2a 73 71 6c 69 74 65 34 54 65 73 74 54 65 78   *sqlite4TestTex
07c0: 74 54 6f 50 74 72 28 63 6f 6e 73 74 20 63 68 61  tToPtr(const cha
07d0: 72 20 2a 29 3b 0a 63 6f 6e 73 74 20 63 68 61 72  r *);.const char
07e0: 20 2a 73 71 6c 69 74 65 34 54 65 73 74 45 72 72   *sqlite4TestErr
07f0: 6f 72 4e 61 6d 65 28 69 6e 74 29 3b 0a 69 6e 74  orName(int);.int
0800: 20 67 65 74 44 62 50 6f 69 6e 74 65 72 28 54 63   getDbPointer(Tc
0810: 6c 5f 49 6e 74 65 72 70 20 2a 2c 20 63 6f 6e 73  l_Interp *, cons
0820: 74 20 63 68 61 72 20 2a 2c 20 73 71 6c 69 74 65  t char *, sqlite
0830: 34 20 2a 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74  4 **);.int sqlit
0840: 65 34 54 65 73 74 4d 61 6b 65 50 6f 69 6e 74 65  e4TestMakePointe
0850: 72 53 74 72 28 54 63 6c 5f 49 6e 74 65 72 70 20  rStr(Tcl_Interp 
0860: 2a 2c 20 63 68 61 72 20 2a 2c 20 76 6f 69 64 20  *, char *, void 
0870: 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 34 54  *);.int sqlite4T
0880: 65 73 74 45 72 72 43 6f 64 65 28 54 63 6c 5f 49  estErrCode(Tcl_I
0890: 6e 74 65 72 70 20 2a 2c 20 73 71 6c 69 74 65 34  nterp *, sqlite4
08a0: 20 2a 2c 20 69 6e 74 29 3b 0a 0a 2f 2a 0a 2a 2a   *, int);../*.**
08b0: 20 48 61 6e 64 6c 65 72 20 66 6f 72 20 65 76 65   Handler for eve
08c0: 6e 74 73 20 6f 66 20 74 79 70 65 20 45 76 61 6c  nts of type Eval
08d0: 45 76 65 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 63  Event..*/.static
08e0: 20 69 6e 74 20 74 63 6c 53 63 72 69 70 74 45 76   int tclScriptEv
08f0: 65 6e 74 28 54 63 6c 5f 45 76 65 6e 74 20 2a 65  ent(Tcl_Event *e
0900: 76 50 74 72 2c 20 69 6e 74 20 66 6c 61 67 73 29  vPtr, int flags)
0910: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 45 76  {.  int rc;.  Ev
0920: 61 6c 45 76 65 6e 74 20 2a 70 20 3d 20 28 45 76  alEvent *p = (Ev
0930: 61 6c 45 76 65 6e 74 20 2a 29 65 76 50 74 72 3b  alEvent *)evPtr;
0940: 0a 20 20 72 63 20 3d 20 54 63 6c 5f 45 76 61 6c  .  rc = Tcl_Eval
0950: 28 70 2d 3e 69 6e 74 65 72 70 2c 20 70 2d 3e 7a  (p->interp, p->z
0960: 53 63 72 69 70 74 29 3b 0a 20 20 69 66 28 20 72  Script);.  if( r
0970: 63 21 3d 54 43 4c 5f 4f 4b 20 29 7b 0a 20 20 20  c!=TCL_OK ){.   
0980: 20 54 63 6c 5f 42 61 63 6b 67 72 6f 75 6e 64 45   Tcl_BackgroundE
0990: 72 72 6f 72 28 70 2d 3e 69 6e 74 65 72 70 29 3b  rror(p->interp);
09a0: 0a 20 20 7d 0a 20 20 55 4e 55 53 45 44 5f 50 41  .  }.  UNUSED_PA
09b0: 52 41 4d 45 54 45 52 28 66 6c 61 67 73 29 3b 0a  RAMETER(flags);.
09c0: 20 20 72 65 74 75 72 6e 20 31 3b 0a 7d 0a 0a 2f    return 1;.}../
09d0: 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 6e  *.** Register an
09e0: 20 45 76 61 6c 45 76 65 6e 74 20 74 6f 20 65 76   EvalEvent to ev
09f0: 61 6c 75 61 74 65 20 74 68 65 20 73 63 72 69 70  aluate the scrip
0a00: 74 20 70 53 63 72 69 70 74 20 69 6e 20 74 68 65  t pScript in the
0a10: 0a 2a 2a 20 70 61 72 65 6e 74 20 69 6e 74 65 72  .** parent inter
0a20: 70 72 65 74 65 72 2f 74 68 72 65 61 64 20 6f 66  preter/thread of
0a30: 20 53 71 6c 54 68 72 65 61 64 20 70 2e 0a 2a 2f   SqlThread p..*/
0a40: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 6f 73  .static void pos
0a50: 74 54 6f 50 61 72 65 6e 74 28 53 71 6c 54 68 72  tToParent(SqlThr
0a60: 65 61 64 20 2a 70 2c 20 54 63 6c 5f 4f 62 6a 20  ead *p, Tcl_Obj 
0a70: 2a 70 53 63 72 69 70 74 29 7b 0a 20 20 45 76 61  *pScript){.  Eva
0a80: 6c 45 76 65 6e 74 20 2a 70 45 76 65 6e 74 3b 0a  lEvent *pEvent;.
0a90: 20 20 63 68 61 72 20 2a 7a 4d 73 67 3b 0a 20 20    char *zMsg;.  
0aa0: 69 6e 74 20 6e 4d 73 67 3b 0a 0a 20 20 7a 4d 73  int nMsg;..  zMs
0ab0: 67 20 3d 20 54 63 6c 5f 47 65 74 53 74 72 69 6e  g = Tcl_GetStrin
0ac0: 67 46 72 6f 6d 4f 62 6a 28 70 53 63 72 69 70 74  gFromObj(pScript
0ad0: 2c 20 26 6e 4d 73 67 29 3b 20 0a 20 20 70 45 76  , &nMsg); .  pEv
0ae0: 65 6e 74 20 3d 20 28 45 76 61 6c 45 76 65 6e 74  ent = (EvalEvent
0af0: 20 2a 29 63 6b 61 6c 6c 6f 63 28 73 69 7a 65 6f   *)ckalloc(sizeo
0b00: 66 28 45 76 61 6c 45 76 65 6e 74 29 2b 6e 4d 73  f(EvalEvent)+nMs
0b10: 67 2b 31 29 3b 0a 20 20 70 45 76 65 6e 74 2d 3e  g+1);.  pEvent->
0b20: 62 61 73 65 2e 6e 65 78 74 50 74 72 20 3d 20 30  base.nextPtr = 0
0b30: 3b 0a 20 20 70 45 76 65 6e 74 2d 3e 62 61 73 65  ;.  pEvent->base
0b40: 2e 70 72 6f 63 20 3d 20 74 63 6c 53 63 72 69 70  .proc = tclScrip
0b50: 74 45 76 65 6e 74 3b 0a 20 20 70 45 76 65 6e 74  tEvent;.  pEvent
0b60: 2d 3e 7a 53 63 72 69 70 74 20 3d 20 28 63 68 61  ->zScript = (cha
0b70: 72 20 2a 29 26 70 45 76 65 6e 74 5b 31 5d 3b 0a  r *)&pEvent[1];.
0b80: 20 20 6d 65 6d 63 70 79 28 70 45 76 65 6e 74 2d    memcpy(pEvent-
0b90: 3e 7a 53 63 72 69 70 74 2c 20 7a 4d 73 67 2c 20  >zScript, zMsg, 
0ba0: 6e 4d 73 67 2b 31 29 3b 0a 20 20 70 45 76 65 6e  nMsg+1);.  pEven
0bb0: 74 2d 3e 69 6e 74 65 72 70 20 3d 20 70 2d 3e 69  t->interp = p->i
0bc0: 6e 74 65 72 70 3b 0a 0a 20 20 54 63 6c 5f 54 68  nterp;..  Tcl_Th
0bd0: 72 65 61 64 51 75 65 75 65 45 76 65 6e 74 28 70  readQueueEvent(p
0be0: 2d 3e 70 61 72 65 6e 74 2c 20 28 54 63 6c 5f 45  ->parent, (Tcl_E
0bf0: 76 65 6e 74 20 2a 29 70 45 76 65 6e 74 2c 20 54  vent *)pEvent, T
0c00: 43 4c 5f 51 55 45 55 45 5f 54 41 49 4c 29 3b 0a  CL_QUEUE_TAIL);.
0c10: 20 20 54 63 6c 5f 54 68 72 65 61 64 41 6c 65 72    Tcl_ThreadAler
0c20: 74 28 70 2d 3e 70 61 72 65 6e 74 29 3b 0a 7d 0a  t(p->parent);.}.
0c30: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 6d 61 69 6e 20  ./*.** The main 
0c40: 66 75 6e 63 74 69 6f 6e 20 66 6f 72 20 74 68 72  function for thr
0c50: 65 61 64 73 20 63 72 65 61 74 65 64 20 77 69 74  eads created wit
0c60: 68 20 5b 73 71 6c 74 68 72 65 61 64 20 73 70 61  h [sqlthread spa
0c70: 77 6e 5d 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 54  wn]..*/.static T
0c80: 63 6c 5f 54 68 72 65 61 64 43 72 65 61 74 65 54  cl_ThreadCreateT
0c90: 79 70 65 20 74 63 6c 53 63 72 69 70 74 54 68 72  ype tclScriptThr
0ca0: 65 61 64 28 43 6c 69 65 6e 74 44 61 74 61 20 70  ead(ClientData p
0cb0: 53 71 6c 54 68 72 65 61 64 29 7b 0a 20 20 54 63  SqlThread){.  Tc
0cc0: 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65 72 70  l_Interp *interp
0cd0: 3b 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a 70 52 65  ;.  Tcl_Obj *pRe
0ce0: 73 3b 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a 70 4c  s;.  Tcl_Obj *pL
0cf0: 69 73 74 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20  ist;.  int rc;. 
0d00: 20 53 71 6c 54 68 72 65 61 64 20 2a 70 20 3d 20   SqlThread *p = 
0d10: 28 53 71 6c 54 68 72 65 61 64 20 2a 29 70 53 71  (SqlThread *)pSq
0d20: 6c 54 68 72 65 61 64 3b 0a 20 20 65 78 74 65 72  lThread;.  exter
0d30: 6e 20 69 6e 74 20 53 71 6c 69 74 65 74 65 73 74  n int Sqlitetest
0d40: 5f 6d 75 74 65 78 5f 49 6e 69 74 28 54 63 6c 5f  _mutex_Init(Tcl_
0d50: 49 6e 74 65 72 70 2a 29 3b 0a 0a 20 20 69 6e 74  Interp*);..  int
0d60: 65 72 70 20 3d 20 54 63 6c 5f 43 72 65 61 74 65  erp = Tcl_Create
0d70: 49 6e 74 65 72 70 28 29 3b 0a 20 20 54 63 6c 5f  Interp();.  Tcl_
0d80: 43 72 65 61 74 65 4f 62 6a 43 6f 6d 6d 61 6e 64  CreateObjCommand
0d90: 28 69 6e 74 65 72 70 2c 20 22 63 6c 6f 63 6b 5f  (interp, "clock_
0da0: 73 65 63 6f 6e 64 73 22 2c 20 63 6c 6f 63 6b 5f  seconds", clock_
0db0: 73 65 63 6f 6e 64 73 5f 70 72 6f 63 2c 20 30 2c  seconds_proc, 0,
0dc0: 20 30 29 3b 0a 20 20 54 63 6c 5f 43 72 65 61 74   0);.  Tcl_Creat
0dd0: 65 4f 62 6a 43 6f 6d 6d 61 6e 64 28 69 6e 74 65  eObjCommand(inte
0de0: 72 70 2c 20 22 73 71 6c 74 68 72 65 61 64 22 2c  rp, "sqlthread",
0df0: 20 73 71 6c 74 68 72 65 61 64 5f 70 72 6f 63 2c   sqlthread_proc,
0e00: 20 70 53 71 6c 54 68 72 65 61 64 2c 20 30 29 3b   pSqlThread, 0);
0e10: 0a 23 69 66 20 53 51 4c 49 54 45 34 5f 4f 53 5f  .#if SQLITE4_OS_
0e20: 55 4e 49 58 20 26 26 20 64 65 66 69 6e 65 64 28  UNIX && defined(
0e30: 53 51 4c 49 54 45 34 5f 45 4e 41 42 4c 45 5f 55  SQLITE4_ENABLE_U
0e40: 4e 4c 4f 43 4b 5f 4e 4f 54 49 46 59 29 0a 20 20  NLOCK_NOTIFY).  
0e50: 54 63 6c 5f 43 72 65 61 74 65 4f 62 6a 43 6f 6d  Tcl_CreateObjCom
0e60: 6d 61 6e 64 28 69 6e 74 65 72 70 2c 20 22 73 71  mand(interp, "sq
0e70: 6c 69 74 65 34 5f 62 6c 6f 63 6b 69 6e 67 5f 73  lite4_blocking_s
0e80: 74 65 70 22 2c 20 62 6c 6f 63 6b 69 6e 67 5f 73  tep", blocking_s
0e90: 74 65 70 5f 70 72 6f 63 2c 30 2c 30 29 3b 0a 20  tep_proc,0,0);. 
0ea0: 20 54 63 6c 5f 43 72 65 61 74 65 4f 62 6a 43 6f   Tcl_CreateObjCo
0eb0: 6d 6d 61 6e 64 28 69 6e 74 65 72 70 2c 20 0a 20  mmand(interp, . 
0ec0: 20 20 20 20 20 22 73 71 6c 69 74 65 34 5f 62 6c       "sqlite4_bl
0ed0: 6f 63 6b 69 6e 67 5f 70 72 65 70 61 72 65 22 2c  ocking_prepare",
0ee0: 20 62 6c 6f 63 6b 69 6e 67 5f 70 72 65 70 61 72   blocking_prepar
0ef0: 65 5f 70 72 6f 63 2c 20 28 76 6f 69 64 20 2a 29  e_proc, (void *)
0f00: 31 2c 20 30 29 3b 0a 20 20 54 63 6c 5f 43 72 65  1, 0);.  Tcl_Cre
0f10: 61 74 65 4f 62 6a 43 6f 6d 6d 61 6e 64 28 69 6e  ateObjCommand(in
0f20: 74 65 72 70 2c 20 0a 20 20 20 20 20 20 22 73 71  terp, .      "sq
0f30: 6c 69 74 65 34 5f 6e 6f 6e 62 6c 6f 63 6b 69 6e  lite4_nonblockin
0f40: 67 5f 70 72 65 70 61 72 65 22 2c 20 62 6c 6f 63  g_prepare", bloc
0f50: 6b 69 6e 67 5f 70 72 65 70 61 72 65 5f 70 72 6f  king_prepare_pro
0f60: 63 2c 20 30 2c 20 30 29 3b 0a 23 65 6e 64 69 66  c, 0, 0);.#endif
0f70: 0a 20 20 53 71 6c 69 74 65 74 65 73 74 31 5f 49  .  Sqlitetest1_I
0f80: 6e 69 74 28 69 6e 74 65 72 70 29 3b 0a 20 20 53  nit(interp);.  S
0f90: 71 6c 69 74 65 74 65 73 74 5f 6d 75 74 65 78 5f  qlitetest_mutex_
0fa0: 49 6e 69 74 28 69 6e 74 65 72 70 29 3b 0a 20 20  Init(interp);.  
0fb0: 53 71 6c 69 74 65 33 5f 49 6e 69 74 28 69 6e 74  Sqlite3_Init(int
0fc0: 65 72 70 29 3b 0a 0a 20 20 72 63 20 3d 20 54 63  erp);..  rc = Tc
0fd0: 6c 5f 45 76 61 6c 28 69 6e 74 65 72 70 2c 20 70  l_Eval(interp, p
0fe0: 2d 3e 7a 53 63 72 69 70 74 29 3b 0a 20 20 70 52  ->zScript);.  pR
0ff0: 65 73 20 3d 20 54 63 6c 5f 47 65 74 4f 62 6a 52  es = Tcl_GetObjR
1000: 65 73 75 6c 74 28 69 6e 74 65 72 70 29 3b 0a 20  esult(interp);. 
1010: 20 70 4c 69 73 74 20 3d 20 54 63 6c 5f 4e 65 77   pList = Tcl_New
1020: 4f 62 6a 28 29 3b 0a 20 20 54 63 6c 5f 49 6e 63  Obj();.  Tcl_Inc
1030: 72 52 65 66 43 6f 75 6e 74 28 70 4c 69 73 74 29  rRefCount(pList)
1040: 3b 0a 20 20 54 63 6c 5f 49 6e 63 72 52 65 66 43  ;.  Tcl_IncrRefC
1050: 6f 75 6e 74 28 70 52 65 73 29 3b 0a 0a 20 20 69  ount(pRes);..  i
1060: 66 28 20 72 63 21 3d 54 43 4c 5f 4f 4b 20 29 7b  f( rc!=TCL_OK ){
1070: 0a 20 20 20 20 54 63 6c 5f 4c 69 73 74 4f 62 6a  .    Tcl_ListObj
1080: 41 70 70 65 6e 64 45 6c 65 6d 65 6e 74 28 69 6e  AppendElement(in
1090: 74 65 72 70 2c 20 70 4c 69 73 74 2c 20 54 63 6c  terp, pList, Tcl
10a0: 5f 4e 65 77 53 74 72 69 6e 67 4f 62 6a 28 22 65  _NewStringObj("e
10b0: 72 72 6f 72 22 2c 20 2d 31 29 29 3b 0a 20 20 20  rror", -1));.   
10c0: 20 54 63 6c 5f 4c 69 73 74 4f 62 6a 41 70 70 65   Tcl_ListObjAppe
10d0: 6e 64 45 6c 65 6d 65 6e 74 28 69 6e 74 65 72 70  ndElement(interp
10e0: 2c 20 70 4c 69 73 74 2c 20 70 52 65 73 29 3b 0a  , pList, pRes);.
10f0: 20 20 20 20 70 6f 73 74 54 6f 50 61 72 65 6e 74      postToParent
1100: 28 70 2c 20 70 4c 69 73 74 29 3b 0a 20 20 20 20  (p, pList);.    
1110: 54 63 6c 5f 44 65 63 72 52 65 66 43 6f 75 6e 74  Tcl_DecrRefCount
1120: 28 70 4c 69 73 74 29 3b 0a 20 20 20 20 70 4c 69  (pList);.    pLi
1130: 73 74 20 3d 20 54 63 6c 5f 4e 65 77 4f 62 6a 28  st = Tcl_NewObj(
1140: 29 3b 0a 20 20 7d 0a 0a 20 20 54 63 6c 5f 4c 69  );.  }..  Tcl_Li
1150: 73 74 4f 62 6a 41 70 70 65 6e 64 45 6c 65 6d 65  stObjAppendEleme
1160: 6e 74 28 69 6e 74 65 72 70 2c 20 70 4c 69 73 74  nt(interp, pList
1170: 2c 20 54 63 6c 5f 4e 65 77 53 74 72 69 6e 67 4f  , Tcl_NewStringO
1180: 62 6a 28 22 73 65 74 22 2c 20 2d 31 29 29 3b 0a  bj("set", -1));.
1190: 20 20 54 63 6c 5f 4c 69 73 74 4f 62 6a 41 70 70    Tcl_ListObjApp
11a0: 65 6e 64 45 6c 65 6d 65 6e 74 28 69 6e 74 65 72  endElement(inter
11b0: 70 2c 20 70 4c 69 73 74 2c 20 54 63 6c 5f 4e 65  p, pList, Tcl_Ne
11c0: 77 53 74 72 69 6e 67 4f 62 6a 28 70 2d 3e 7a 56  wStringObj(p->zV
11d0: 61 72 6e 61 6d 65 2c 20 2d 31 29 29 3b 0a 20 20  arname, -1));.  
11e0: 54 63 6c 5f 4c 69 73 74 4f 62 6a 41 70 70 65 6e  Tcl_ListObjAppen
11f0: 64 45 6c 65 6d 65 6e 74 28 69 6e 74 65 72 70 2c  dElement(interp,
1200: 20 70 4c 69 73 74 2c 20 70 52 65 73 29 3b 0a 20   pList, pRes);. 
1210: 20 70 6f 73 74 54 6f 50 61 72 65 6e 74 28 70 2c   postToParent(p,
1220: 20 70 4c 69 73 74 29 3b 0a 0a 20 20 63 6b 66 72   pList);..  ckfr
1230: 65 65 28 28 76 6f 69 64 20 2a 29 70 29 3b 0a 20  ee((void *)p);. 
1240: 20 54 63 6c 5f 44 65 63 72 52 65 66 43 6f 75 6e   Tcl_DecrRefCoun
1250: 74 28 70 4c 69 73 74 29 3b 0a 20 20 54 63 6c 5f  t(pList);.  Tcl_
1260: 44 65 63 72 52 65 66 43 6f 75 6e 74 28 70 52 65  DecrRefCount(pRe
1270: 73 29 3b 0a 20 20 54 63 6c 5f 44 65 6c 65 74 65  s);.  Tcl_Delete
1280: 49 6e 74 65 72 70 28 69 6e 74 65 72 70 29 3b 0a  Interp(interp);.
1290: 20 20 77 68 69 6c 65 28 20 54 63 6c 5f 44 6f 4f    while( Tcl_DoO
12a0: 6e 65 45 76 65 6e 74 28 54 43 4c 5f 41 4c 4c 5f  neEvent(TCL_ALL_
12b0: 45 56 45 4e 54 53 7c 54 43 4c 5f 44 4f 4e 54 5f  EVENTS|TCL_DONT_
12c0: 57 41 49 54 29 20 29 3b 0a 20 20 54 63 6c 5f 45  WAIT) );.  Tcl_E
12d0: 78 69 74 54 68 72 65 61 64 28 30 29 3b 0a 20 20  xitThread(0);.  
12e0: 54 43 4c 5f 54 48 52 45 41 44 5f 43 52 45 41 54  TCL_THREAD_CREAT
12f0: 45 5f 52 45 54 55 52 4e 3b 0a 7d 0a 0a 2f 2a 0a  E_RETURN;.}../*.
1300: 2a 2a 20 73 71 6c 74 68 72 65 61 64 20 73 70 61  ** sqlthread spa
1310: 77 6e 20 56 41 52 4e 41 4d 45 20 53 43 52 49 50  wn VARNAME SCRIP
1320: 54 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 70 61 77  T.**.**     Spaw
1330: 6e 20 61 20 6e 65 77 20 74 68 72 65 61 64 20 77  n a new thread w
1340: 69 74 68 20 69 74 73 20 6f 77 6e 20 54 63 6c 20  ith its own Tcl 
1350: 69 6e 74 65 72 70 72 65 74 65 72 20 61 6e 64 20  interpreter and 
1360: 72 75 6e 20 74 68 65 0a 2a 2a 20 20 20 20 20 73  run the.**     s
1370: 70 65 63 69 66 69 65 64 20 53 43 52 49 50 54 28  pecified SCRIPT(
1380: 73 29 20 69 6e 20 69 74 2e 20 54 68 65 20 74 68  s) in it. The th
1390: 72 65 61 64 20 74 65 72 6d 69 6e 61 74 65 73 20  read terminates 
13a0: 61 66 74 65 72 20 72 75 6e 6e 69 6e 67 0a 2a 2a  after running.**
13b0: 20 20 20 20 20 74 68 65 20 73 63 72 69 70 74 2e       the script.
13c0: 20 54 68 65 20 72 65 73 75 6c 74 20 6f 66 20 74   The result of t
13d0: 68 65 20 73 63 72 69 70 74 20 69 73 20 73 74 6f  he script is sto
13e0: 72 65 64 20 69 6e 20 74 68 65 20 76 61 72 69 61  red in the varia
13f0: 62 6c 65 0a 2a 2a 20 20 20 20 20 56 41 52 4e 41  ble.**     VARNA
1400: 4d 45 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 54 68  ME..**.**     Th
1410: 65 20 63 61 6c 6c 65 72 20 63 61 6e 20 77 61 69  e caller can wai
1420: 74 20 66 6f 72 20 74 68 65 20 73 63 72 69 70 74  t for the script
1430: 20 74 6f 20 74 65 72 6d 69 6e 61 74 65 20 75 73   to terminate us
1440: 69 6e 67 20 5b 76 77 61 69 74 20 56 41 52 4e 41  ing [vwait VARNA
1450: 4d 45 5d 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ME]..*/.static i
1460: 6e 74 20 73 71 6c 74 68 72 65 61 64 5f 73 70 61  nt sqlthread_spa
1470: 77 6e 28 0a 20 20 43 6c 69 65 6e 74 44 61 74 61  wn(.  ClientData
1480: 20 63 6c 69 65 6e 74 44 61 74 61 2c 0a 20 20 54   clientData,.  T
1490: 63 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65 72  cl_Interp *inter
14a0: 70 2c 0a 20 20 69 6e 74 20 6f 62 6a 63 2c 0a 20  p,.  int objc,. 
14b0: 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54 20   Tcl_Obj *CONST 
14c0: 6f 62 6a 76 5b 5d 0a 29 7b 0a 20 20 54 63 6c 5f  objv[].){.  Tcl_
14d0: 54 68 72 65 61 64 49 64 20 78 3b 0a 20 20 53 71  ThreadId x;.  Sq
14e0: 6c 54 68 72 65 61 64 20 2a 70 4e 65 77 3b 0a 20  lThread *pNew;. 
14f0: 20 69 6e 74 20 72 63 3b 0a 0a 20 20 69 6e 74 20   int rc;..  int 
1500: 6e 56 61 72 6e 61 6d 65 3b 20 63 68 61 72 20 2a  nVarname; char *
1510: 7a 56 61 72 6e 61 6d 65 3b 0a 20 20 69 6e 74 20  zVarname;.  int 
1520: 6e 53 63 72 69 70 74 3b 20 63 68 61 72 20 2a 7a  nScript; char *z
1530: 53 63 72 69 70 74 3b 0a 0a 20 20 2f 2a 20 50 61  Script;..  /* Pa
1540: 72 61 6d 65 74 65 72 73 20 66 6f 72 20 74 68 72  rameters for thr
1550: 65 61 64 20 63 72 65 61 74 69 6f 6e 20 2a 2f 0a  ead creation */.
1560: 20 20 63 6f 6e 73 74 20 69 6e 74 20 6e 53 74 61    const int nSta
1570: 63 6b 20 3d 20 54 43 4c 5f 54 48 52 45 41 44 5f  ck = TCL_THREAD_
1580: 53 54 41 43 4b 5f 44 45 46 41 55 4c 54 3b 0a 20  STACK_DEFAULT;. 
1590: 20 63 6f 6e 73 74 20 69 6e 74 20 66 6c 61 67 73   const int flags
15a0: 20 3d 20 54 43 4c 5f 54 48 52 45 41 44 5f 4e 4f   = TCL_THREAD_NO
15b0: 46 4c 41 47 53 3b 0a 0a 20 20 61 73 73 65 72 74  FLAGS;..  assert
15c0: 28 6f 62 6a 63 3d 3d 34 29 3b 0a 20 20 55 4e 55  (objc==4);.  UNU
15d0: 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 63 6c  SED_PARAMETER(cl
15e0: 69 65 6e 74 44 61 74 61 29 3b 0a 20 20 55 4e 55  ientData);.  UNU
15f0: 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 6f 62  SED_PARAMETER(ob
1600: 6a 63 29 3b 0a 0a 20 20 7a 56 61 72 6e 61 6d 65  jc);..  zVarname
1610: 20 3d 20 54 63 6c 5f 47 65 74 53 74 72 69 6e 67   = Tcl_GetString
1620: 46 72 6f 6d 4f 62 6a 28 6f 62 6a 76 5b 32 5d 2c  FromObj(objv[2],
1630: 20 26 6e 56 61 72 6e 61 6d 65 29 3b 0a 20 20 7a   &nVarname);.  z
1640: 53 63 72 69 70 74 20 3d 20 54 63 6c 5f 47 65 74  Script = Tcl_Get
1650: 53 74 72 69 6e 67 46 72 6f 6d 4f 62 6a 28 6f 62  StringFromObj(ob
1660: 6a 76 5b 33 5d 2c 20 26 6e 53 63 72 69 70 74 29  jv[3], &nScript)
1670: 3b 0a 0a 20 20 70 4e 65 77 20 3d 20 28 53 71 6c  ;..  pNew = (Sql
1680: 54 68 72 65 61 64 20 2a 29 63 6b 61 6c 6c 6f 63  Thread *)ckalloc
1690: 28 73 69 7a 65 6f 66 28 53 71 6c 54 68 72 65 61  (sizeof(SqlThrea
16a0: 64 29 2b 6e 56 61 72 6e 61 6d 65 2b 6e 53 63 72  d)+nVarname+nScr
16b0: 69 70 74 2b 32 29 3b 0a 20 20 70 4e 65 77 2d 3e  ipt+2);.  pNew->
16c0: 7a 56 61 72 6e 61 6d 65 20 3d 20 28 63 68 61 72  zVarname = (char
16d0: 20 2a 29 26 70 4e 65 77 5b 31 5d 3b 0a 20 20 70   *)&pNew[1];.  p
16e0: 4e 65 77 2d 3e 7a 53 63 72 69 70 74 20 3d 20 28  New->zScript = (
16f0: 63 68 61 72 20 2a 29 26 70 4e 65 77 2d 3e 7a 56  char *)&pNew->zV
1700: 61 72 6e 61 6d 65 5b 6e 56 61 72 6e 61 6d 65 2b  arname[nVarname+
1710: 31 5d 3b 0a 20 20 6d 65 6d 63 70 79 28 70 4e 65  1];.  memcpy(pNe
1720: 77 2d 3e 7a 56 61 72 6e 61 6d 65 2c 20 7a 56 61  w->zVarname, zVa
1730: 72 6e 61 6d 65 2c 20 6e 56 61 72 6e 61 6d 65 2b  rname, nVarname+
1740: 31 29 3b 0a 20 20 6d 65 6d 63 70 79 28 70 4e 65  1);.  memcpy(pNe
1750: 77 2d 3e 7a 53 63 72 69 70 74 2c 20 7a 53 63 72  w->zScript, zScr
1760: 69 70 74 2c 20 6e 53 63 72 69 70 74 2b 31 29 3b  ipt, nScript+1);
1770: 0a 20 20 70 4e 65 77 2d 3e 70 61 72 65 6e 74 20  .  pNew->parent 
1780: 3d 20 54 63 6c 5f 47 65 74 43 75 72 72 65 6e 74  = Tcl_GetCurrent
1790: 54 68 72 65 61 64 28 29 3b 0a 20 20 70 4e 65 77  Thread();.  pNew
17a0: 2d 3e 69 6e 74 65 72 70 20 3d 20 69 6e 74 65 72  ->interp = inter
17b0: 70 3b 0a 0a 20 20 72 63 20 3d 20 54 63 6c 5f 43  p;..  rc = Tcl_C
17c0: 72 65 61 74 65 54 68 72 65 61 64 28 26 78 2c 20  reateThread(&x, 
17d0: 74 63 6c 53 63 72 69 70 74 54 68 72 65 61 64 2c  tclScriptThread,
17e0: 20 28 76 6f 69 64 20 2a 29 70 4e 65 77 2c 20 6e   (void *)pNew, n
17f0: 53 74 61 63 6b 2c 20 66 6c 61 67 73 29 3b 0a 20  Stack, flags);. 
1800: 20 69 66 28 20 72 63 21 3d 54 43 4c 5f 4f 4b 20   if( rc!=TCL_OK 
1810: 29 7b 0a 20 20 20 20 54 63 6c 5f 41 70 70 65 6e  ){.    Tcl_Appen
1820: 64 52 65 73 75 6c 74 28 69 6e 74 65 72 70 2c 20  dResult(interp, 
1830: 22 45 72 72 6f 72 20 69 6e 20 54 63 6c 5f 43 72  "Error in Tcl_Cr
1840: 65 61 74 65 54 68 72 65 61 64 28 29 22 2c 20 30  eateThread()", 0
1850: 29 3b 0a 20 20 20 20 63 6b 66 72 65 65 28 28 63  );.    ckfree((c
1860: 68 61 72 20 2a 29 70 4e 65 77 29 3b 0a 20 20 20  har *)pNew);.   
1870: 20 72 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f   return TCL_ERRO
1880: 52 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e  R;.  }..  return
1890: 20 54 43 4c 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a   TCL_OK;.}../*.*
18a0: 2a 20 73 71 6c 74 68 72 65 61 64 20 70 61 72 65  * sqlthread pare
18b0: 6e 74 20 53 43 52 49 50 54 0a 2a 2a 0a 2a 2a 20  nt SCRIPT.**.** 
18c0: 20 20 20 20 54 68 69 73 20 63 61 6e 20 62 65 20      This can be 
18d0: 63 61 6c 6c 65 64 20 62 79 20 73 70 61 77 6e 65  called by spawne
18e0: 64 20 74 68 72 65 61 64 73 20 6f 6e 6c 79 2e 20  d threads only. 
18f0: 49 74 20 73 65 6e 64 73 20 74 68 65 20 73 70 65  It sends the spe
1900: 63 69 66 69 65 64 0a 2a 2a 20 20 20 20 20 73 63  cified.**     sc
1910: 72 69 70 74 20 62 61 63 6b 20 74 6f 20 74 68 65  ript back to the
1920: 20 70 61 72 65 6e 74 20 74 68 72 65 61 64 20 66   parent thread f
1930: 6f 72 20 65 78 65 63 75 74 69 6f 6e 2e 20 54 68  or execution. Th
1940: 65 20 72 65 73 75 6c 74 20 6f 66 0a 2a 2a 20 20  e result of.**  
1950: 20 20 20 65 76 61 6c 75 61 74 69 6e 67 20 74 68     evaluating th
1960: 65 20 53 43 52 49 50 54 20 69 73 20 72 65 74 75  e SCRIPT is retu
1970: 72 6e 65 64 2e 20 54 68 65 20 70 61 72 65 6e 74  rned. The parent
1980: 20 74 68 72 65 61 64 20 6d 75 73 74 20 65 6e 74   thread must ent
1990: 65 72 0a 2a 2a 20 20 20 20 20 74 68 65 20 65 76  er.**     the ev
19a0: 65 6e 74 20 6c 6f 6f 70 20 66 6f 72 20 74 68 69  ent loop for thi
19b0: 73 20 74 6f 20 77 6f 72 6b 20 2d 20 6f 74 68 65  s to work - othe
19c0: 72 77 69 73 65 20 74 68 65 20 63 61 6c 6c 65 72  rwise the caller
19d0: 20 77 69 6c 6c 0a 2a 2a 20 20 20 20 20 62 6c 6f   will.**     blo
19e0: 63 6b 20 69 6e 64 65 66 69 6e 69 74 65 6c 79 2e  ck indefinitely.
19f0: 0a 2a 2a 0a 2a 2a 20 20 20 20 20 4e 4f 54 45 3a  .**.**     NOTE:
1a00: 20 41 74 20 74 68 65 20 6d 6f 6d 65 6e 74 2c 20   At the moment, 
1a10: 74 68 69 73 20 64 6f 65 73 6e 27 74 20 77 6f 72  this doesn't wor
1a20: 6b 2e 20 46 49 58 4d 45 2e 0a 2a 2f 0a 73 74 61  k. FIXME..*/.sta
1a30: 74 69 63 20 69 6e 74 20 73 71 6c 74 68 72 65 61  tic int sqlthrea
1a40: 64 5f 70 61 72 65 6e 74 28 0a 20 20 43 6c 69 65  d_parent(.  Clie
1a50: 6e 74 44 61 74 61 20 63 6c 69 65 6e 74 44 61 74  ntData clientDat
1a60: 61 2c 0a 20 20 54 63 6c 5f 49 6e 74 65 72 70 20  a,.  Tcl_Interp 
1a70: 2a 69 6e 74 65 72 70 2c 0a 20 20 69 6e 74 20 6f  *interp,.  int o
1a80: 62 6a 63 2c 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a  bjc,.  Tcl_Obj *
1a90: 43 4f 4e 53 54 20 6f 62 6a 76 5b 5d 0a 29 7b 0a  CONST objv[].){.
1aa0: 20 20 45 76 61 6c 45 76 65 6e 74 20 2a 70 45 76    EvalEvent *pEv
1ab0: 65 6e 74 3b 0a 20 20 63 68 61 72 20 2a 7a 4d 73  ent;.  char *zMs
1ac0: 67 3b 0a 20 20 69 6e 74 20 6e 4d 73 67 3b 0a 20  g;.  int nMsg;. 
1ad0: 20 53 71 6c 54 68 72 65 61 64 20 2a 70 20 3d 20   SqlThread *p = 
1ae0: 28 53 71 6c 54 68 72 65 61 64 20 2a 29 63 6c 69  (SqlThread *)cli
1af0: 65 6e 74 44 61 74 61 3b 0a 0a 20 20 61 73 73 65  entData;..  asse
1b00: 72 74 28 6f 62 6a 63 3d 3d 33 29 3b 0a 20 20 55  rt(objc==3);.  U
1b10: 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28  NUSED_PARAMETER(
1b20: 6f 62 6a 63 29 3b 0a 0a 20 20 69 66 28 20 70 3d  objc);..  if( p=
1b30: 3d 30 20 29 7b 0a 20 20 20 20 54 63 6c 5f 41 70  =0 ){.    Tcl_Ap
1b40: 70 65 6e 64 52 65 73 75 6c 74 28 69 6e 74 65 72  pendResult(inter
1b50: 70 2c 20 22 6e 6f 20 70 61 72 65 6e 74 20 74 68  p, "no parent th
1b60: 72 65 61 64 22 2c 20 30 29 3b 0a 20 20 20 20 72  read", 0);.    r
1b70: 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b  eturn TCL_ERROR;
1b80: 0a 20 20 7d 0a 0a 20 20 7a 4d 73 67 20 3d 20 54  .  }..  zMsg = T
1b90: 63 6c 5f 47 65 74 53 74 72 69 6e 67 46 72 6f 6d  cl_GetStringFrom
1ba0: 4f 62 6a 28 6f 62 6a 76 5b 32 5d 2c 20 26 6e 4d  Obj(objv[2], &nM
1bb0: 73 67 29 3b 0a 20 20 70 45 76 65 6e 74 20 3d 20  sg);.  pEvent = 
1bc0: 28 45 76 61 6c 45 76 65 6e 74 20 2a 29 63 6b 61  (EvalEvent *)cka
1bd0: 6c 6c 6f 63 28 73 69 7a 65 6f 66 28 45 76 61 6c  lloc(sizeof(Eval
1be0: 45 76 65 6e 74 29 2b 6e 4d 73 67 2b 31 29 3b 0a  Event)+nMsg+1);.
1bf0: 20 20 70 45 76 65 6e 74 2d 3e 62 61 73 65 2e 6e    pEvent->base.n
1c00: 65 78 74 50 74 72 20 3d 20 30 3b 0a 20 20 70 45  extPtr = 0;.  pE
1c10: 76 65 6e 74 2d 3e 62 61 73 65 2e 70 72 6f 63 20  vent->base.proc 
1c20: 3d 20 74 63 6c 53 63 72 69 70 74 45 76 65 6e 74  = tclScriptEvent
1c30: 3b 0a 20 20 70 45 76 65 6e 74 2d 3e 7a 53 63 72  ;.  pEvent->zScr
1c40: 69 70 74 20 3d 20 28 63 68 61 72 20 2a 29 26 70  ipt = (char *)&p
1c50: 45 76 65 6e 74 5b 31 5d 3b 0a 20 20 6d 65 6d 63  Event[1];.  memc
1c60: 70 79 28 70 45 76 65 6e 74 2d 3e 7a 53 63 72 69  py(pEvent->zScri
1c70: 70 74 2c 20 7a 4d 73 67 2c 20 6e 4d 73 67 2b 31  pt, zMsg, nMsg+1
1c80: 29 3b 0a 20 20 70 45 76 65 6e 74 2d 3e 69 6e 74  );.  pEvent->int
1c90: 65 72 70 20 3d 20 70 2d 3e 69 6e 74 65 72 70 3b  erp = p->interp;
1ca0: 0a 20 20 54 63 6c 5f 54 68 72 65 61 64 51 75 65  .  Tcl_ThreadQue
1cb0: 75 65 45 76 65 6e 74 28 70 2d 3e 70 61 72 65 6e  ueEvent(p->paren
1cc0: 74 2c 20 28 54 63 6c 5f 45 76 65 6e 74 20 2a 29  t, (Tcl_Event *)
1cd0: 70 45 76 65 6e 74 2c 20 54 43 4c 5f 51 55 45 55  pEvent, TCL_QUEU
1ce0: 45 5f 54 41 49 4c 29 3b 0a 20 20 54 63 6c 5f 54  E_TAIL);.  Tcl_T
1cf0: 68 72 65 61 64 41 6c 65 72 74 28 70 2d 3e 70 61  hreadAlert(p->pa
1d00: 72 65 6e 74 29 3b 0a 0a 20 20 72 65 74 75 72 6e  rent);..  return
1d10: 20 54 43 4c 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a   TCL_OK;.}../*.*
1d20: 2a 20 73 71 6c 74 68 72 65 61 64 20 6f 70 65 6e  * sqlthread open
1d30: 0a 2a 2a 0a 2a 2a 20 20 20 20 20 4f 70 65 6e 20  .**.**     Open 
1d40: 61 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c  a database handl
1d50: 65 20 61 6e 64 20 72 65 74 75 72 6e 20 74 68 65  e and return the
1d60: 20 73 74 72 69 6e 67 20 72 65 70 72 65 73 65 6e   string represen
1d70: 74 61 74 69 6f 6e 20 6f 66 0a 2a 2a 20 20 20 20  tation of.**    
1d80: 20 74 68 65 20 70 6f 69 6e 74 65 72 20 76 61 6c   the pointer val
1d90: 75 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  ue..*/.static in
1da0: 74 20 73 71 6c 74 68 72 65 61 64 5f 6f 70 65 6e  t sqlthread_open
1db0: 28 0a 20 20 43 6c 69 65 6e 74 44 61 74 61 20 63  (.  ClientData c
1dc0: 6c 69 65 6e 74 44 61 74 61 2c 0a 20 20 54 63 6c  lientData,.  Tcl
1dd0: 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65 72 70 2c  _Interp *interp,
1de0: 0a 20 20 69 6e 74 20 6f 62 6a 63 2c 0a 20 20 54  .  int objc,.  T
1df0: 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54 20 6f 62  cl_Obj *CONST ob
1e00: 6a 76 5b 5d 0a 29 7b 0a 20 20 69 6e 74 20 73 71  jv[].){.  int sq
1e10: 6c 69 74 65 34 54 65 73 74 4d 61 6b 65 50 6f 69  lite4TestMakePoi
1e20: 6e 74 65 72 53 74 72 28 54 63 6c 5f 49 6e 74 65  nterStr(Tcl_Inte
1e30: 72 70 20 2a 69 6e 74 65 72 70 2c 20 63 68 61 72  rp *interp, char
1e40: 20 2a 7a 50 74 72 2c 20 76 6f 69 64 20 2a 70 29   *zPtr, void *p)
1e50: 3b 0a 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  ;..  const char 
1e60: 2a 7a 46 69 6c 65 6e 61 6d 65 3b 0a 20 20 73 71  *zFilename;.  sq
1e70: 6c 69 74 65 34 20 2a 64 62 3b 0a 20 20 69 6e 74  lite4 *db;.  int
1e80: 20 72 63 3b 0a 20 20 63 68 61 72 20 7a 42 75 66   rc;.  char zBuf
1e90: 5b 31 30 30 5d 3b 0a 20 20 65 78 74 65 72 6e 20  [100];.  extern 
1ea0: 76 6f 69 64 20 4d 64 35 5f 52 65 67 69 73 74 65  void Md5_Registe
1eb0: 72 28 73 71 6c 69 74 65 34 2a 29 3b 0a 0a 20 20  r(sqlite4*);..  
1ec0: 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52  UNUSED_PARAMETER
1ed0: 28 63 6c 69 65 6e 74 44 61 74 61 29 3b 0a 20 20  (clientData);.  
1ee0: 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52  UNUSED_PARAMETER
1ef0: 28 6f 62 6a 63 29 3b 0a 0a 20 20 7a 46 69 6c 65  (objc);..  zFile
1f00: 6e 61 6d 65 20 3d 20 54 63 6c 5f 47 65 74 53 74  name = Tcl_GetSt
1f10: 72 69 6e 67 28 6f 62 6a 76 5b 32 5d 29 3b 0a 20  ring(objv[2]);. 
1f20: 20 72 63 20 3d 20 73 71 6c 69 74 65 34 5f 6f 70   rc = sqlite4_op
1f30: 65 6e 28 30 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c  en(0, zFilename,
1f40: 20 26 64 62 2c 20 30 29 3b 0a 20 20 4d 64 35 5f   &db, 0);.  Md5_
1f50: 52 65 67 69 73 74 65 72 28 64 62 29 3b 0a 20 20  Register(db);.  
1f60: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 34 54 65  .  if( sqlite4Te
1f70: 73 74 4d 61 6b 65 50 6f 69 6e 74 65 72 53 74 72  stMakePointerStr
1f80: 28 69 6e 74 65 72 70 2c 20 7a 42 75 66 2c 20 64  (interp, zBuf, d
1f90: 62 29 20 29 20 72 65 74 75 72 6e 20 54 43 4c 5f  b) ) return TCL_
1fa0: 45 52 52 4f 52 3b 0a 20 20 54 63 6c 5f 41 70 70  ERROR;.  Tcl_App
1fb0: 65 6e 64 52 65 73 75 6c 74 28 69 6e 74 65 72 70  endResult(interp
1fc0: 2c 20 7a 42 75 66 2c 20 30 29 3b 0a 0a 20 20 72  , zBuf, 0);..  r
1fd0: 65 74 75 72 6e 20 54 43 4c 5f 4f 4b 3b 0a 7d 0a  eturn TCL_OK;.}.
1fe0: 0a 0a 2f 2a 0a 2a 2a 20 73 71 6c 74 68 72 65 61  ../*.** sqlthrea
1ff0: 64 20 6f 70 65 6e 0a 2a 2a 0a 2a 2a 20 20 20 20  d open.**.**    
2000: 20 52 65 74 75 72 6e 20 74 68 65 20 63 75 72 72   Return the curr
2010: 65 6e 74 20 74 68 72 65 61 64 2d 69 64 20 28 54  ent thread-id (T
2020: 63 6c 5f 47 65 74 43 75 72 72 65 6e 74 54 68 72  cl_GetCurrentThr
2030: 65 61 64 28 29 29 20 63 61 73 74 20 74 6f 0a 2a  ead()) cast to.*
2040: 2a 20 20 20 20 20 61 6e 20 69 6e 74 65 67 65 72  *     an integer
2050: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
2060: 73 71 6c 74 68 72 65 61 64 5f 69 64 28 0a 20 20  sqlthread_id(.  
2070: 43 6c 69 65 6e 74 44 61 74 61 20 63 6c 69 65 6e  ClientData clien
2080: 74 44 61 74 61 2c 0a 20 20 54 63 6c 5f 49 6e 74  tData,.  Tcl_Int
2090: 65 72 70 20 2a 69 6e 74 65 72 70 2c 0a 20 20 69  erp *interp,.  i
20a0: 6e 74 20 6f 62 6a 63 2c 0a 20 20 54 63 6c 5f 4f  nt objc,.  Tcl_O
20b0: 62 6a 20 2a 43 4f 4e 53 54 20 6f 62 6a 76 5b 5d  bj *CONST objv[]
20c0: 0a 29 7b 0a 20 20 54 63 6c 5f 54 68 72 65 61 64  .){.  Tcl_Thread
20d0: 49 64 20 69 64 20 3d 20 54 63 6c 5f 47 65 74 43  Id id = Tcl_GetC
20e0: 75 72 72 65 6e 74 54 68 72 65 61 64 28 29 3b 0a  urrentThread();.
20f0: 20 20 54 63 6c 5f 53 65 74 4f 62 6a 52 65 73 75    Tcl_SetObjResu
2100: 6c 74 28 69 6e 74 65 72 70 2c 20 54 63 6c 5f 4e  lt(interp, Tcl_N
2110: 65 77 49 6e 74 4f 62 6a 28 53 51 4c 49 54 45 34  ewIntObj(SQLITE4
2120: 5f 50 54 52 5f 54 4f 5f 49 4e 54 28 69 64 29 29  _PTR_TO_INT(id))
2130: 29 3b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41  );.  UNUSED_PARA
2140: 4d 45 54 45 52 28 63 6c 69 65 6e 74 44 61 74 61  METER(clientData
2150: 29 3b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41  );.  UNUSED_PARA
2160: 4d 45 54 45 52 28 6f 62 6a 63 29 3b 0a 20 20 55  METER(objc);.  U
2170: 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28  NUSED_PARAMETER(
2180: 6f 62 6a 76 29 3b 0a 20 20 72 65 74 75 72 6e 20  objv);.  return 
2190: 54 43 4c 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a  TCL_OK;.}.../*.*
21a0: 2a 20 44 69 73 70 61 74 63 68 20 72 6f 75 74 69  * Dispatch routi
21b0: 6e 65 20 66 6f 72 20 74 68 65 20 73 75 62 2d 63  ne for the sub-c
21c0: 6f 6d 6d 61 6e 64 73 20 6f 66 20 5b 73 71 6c 74  ommands of [sqlt
21d0: 68 72 65 61 64 5d 2e 0a 2a 2f 0a 73 74 61 74 69  hread]..*/.stati
21e0: 63 20 69 6e 74 20 73 71 6c 74 68 72 65 61 64 5f  c int sqlthread_
21f0: 70 72 6f 63 28 0a 20 20 43 6c 69 65 6e 74 44 61  proc(.  ClientDa
2200: 74 61 20 63 6c 69 65 6e 74 44 61 74 61 2c 0a 20  ta clientData,. 
2210: 20 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74   Tcl_Interp *int
2220: 65 72 70 2c 0a 20 20 69 6e 74 20 6f 62 6a 63 2c  erp,.  int objc,
2230: 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53  .  Tcl_Obj *CONS
2240: 54 20 6f 62 6a 76 5b 5d 0a 29 7b 0a 20 20 73 74  T objv[].){.  st
2250: 72 75 63 74 20 53 75 62 43 6f 6d 6d 61 6e 64 20  ruct SubCommand 
2260: 7b 0a 20 20 20 20 63 68 61 72 20 2a 7a 4e 61 6d  {.    char *zNam
2270: 65 3b 0a 20 20 20 20 54 63 6c 5f 4f 62 6a 43 6d  e;.    Tcl_ObjCm
2280: 64 50 72 6f 63 20 2a 78 50 72 6f 63 3b 0a 20 20  dProc *xProc;.  
2290: 20 20 69 6e 74 20 6e 41 72 67 3b 0a 20 20 20 20    int nArg;.    
22a0: 63 68 61 72 20 2a 7a 55 73 61 67 65 3b 0a 20 20  char *zUsage;.  
22b0: 7d 20 61 53 75 62 5b 5d 20 3d 20 7b 0a 20 20 20  } aSub[] = {.   
22c0: 20 7b 22 70 61 72 65 6e 74 22 2c 20 73 71 6c 74   {"parent", sqlt
22d0: 68 72 65 61 64 5f 70 61 72 65 6e 74 2c 20 31 2c  hread_parent, 1,
22e0: 20 22 53 43 52 49 50 54 22 7d 2c 0a 20 20 20 20   "SCRIPT"},.    
22f0: 7b 22 73 70 61 77 6e 22 2c 20 20 73 71 6c 74 68  {"spawn",  sqlth
2300: 72 65 61 64 5f 73 70 61 77 6e 2c 20 20 32 2c 20  read_spawn,  2, 
2310: 22 56 41 52 4e 41 4d 45 20 53 43 52 49 50 54 22  "VARNAME SCRIPT"
2320: 7d 2c 0a 20 20 20 20 7b 22 6f 70 65 6e 22 2c 20  },.    {"open", 
2330: 20 20 73 71 6c 74 68 72 65 61 64 5f 6f 70 65 6e    sqlthread_open
2340: 2c 20 20 20 31 2c 20 22 44 42 4e 41 4d 45 22 7d  ,   1, "DBNAME"}
2350: 2c 0a 20 20 20 20 7b 22 69 64 22 2c 20 20 20 20  ,.    {"id",    
2360: 20 73 71 6c 74 68 72 65 61 64 5f 69 64 2c 20 20   sqlthread_id,  
2370: 20 20 20 30 2c 20 22 22 7d 2c 0a 20 20 20 20 7b     0, ""},.    {
2380: 30 2c 20 30 2c 20 30 7d 0a 20 20 7d 3b 0a 20 20  0, 0, 0}.  };.  
2390: 73 74 72 75 63 74 20 53 75 62 43 6f 6d 6d 61 6e  struct SubComman
23a0: 64 20 2a 70 53 75 62 3b 0a 20 20 69 6e 74 20 72  d *pSub;.  int r
23b0: 63 3b 0a 20 20 69 6e 74 20 69 49 6e 64 65 78 3b  c;.  int iIndex;
23c0: 0a 0a 20 20 69 66 28 20 6f 62 6a 63 3c 32 20 29  ..  if( objc<2 )
23d0: 7b 0a 20 20 20 20 54 63 6c 5f 57 72 6f 6e 67 4e  {.    Tcl_WrongN
23e0: 75 6d 41 72 67 73 28 69 6e 74 65 72 70 2c 20 31  umArgs(interp, 1
23f0: 2c 20 6f 62 6a 76 2c 20 22 53 55 42 2d 43 4f 4d  , objv, "SUB-COM
2400: 4d 41 4e 44 22 29 3b 0a 20 20 20 20 72 65 74 75  MAND");.    retu
2410: 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20  rn TCL_ERROR;.  
2420: 7d 0a 0a 20 20 72 63 20 3d 20 54 63 6c 5f 47 65  }..  rc = Tcl_Ge
2430: 74 49 6e 64 65 78 46 72 6f 6d 4f 62 6a 53 74 72  tIndexFromObjStr
2440: 75 63 74 28 0a 20 20 20 20 20 20 69 6e 74 65 72  uct(.      inter
2450: 70 2c 20 6f 62 6a 76 5b 31 5d 2c 20 61 53 75 62  p, objv[1], aSub
2460: 2c 20 73 69 7a 65 6f 66 28 61 53 75 62 5b 30 5d  , sizeof(aSub[0]
2470: 29 2c 20 22 73 75 62 2d 63 6f 6d 6d 61 6e 64 22  ), "sub-command"
2480: 2c 20 30 2c 20 26 69 49 6e 64 65 78 0a 20 20 29  , 0, &iIndex.  )
2490: 3b 0a 20 20 69 66 28 20 72 63 21 3d 54 43 4c 5f  ;.  if( rc!=TCL_
24a0: 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a  OK ) return rc;.
24b0: 20 20 70 53 75 62 20 3d 20 26 61 53 75 62 5b 69    pSub = &aSub[i
24c0: 49 6e 64 65 78 5d 3b 0a 0a 20 20 69 66 28 20 6f  Index];..  if( o
24d0: 62 6a 63 3c 28 70 53 75 62 2d 3e 6e 41 72 67 2b  bjc<(pSub->nArg+
24e0: 32 29 20 29 7b 0a 20 20 20 20 54 63 6c 5f 57 72  2) ){.    Tcl_Wr
24f0: 6f 6e 67 4e 75 6d 41 72 67 73 28 69 6e 74 65 72  ongNumArgs(inter
2500: 70 2c 20 32 2c 20 6f 62 6a 76 2c 20 70 53 75 62  p, 2, objv, pSub
2510: 2d 3e 7a 55 73 61 67 65 29 3b 0a 20 20 20 20 72  ->zUsage);.    r
2520: 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b  eturn TCL_ERROR;
2530: 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 70  .  }..  return p
2540: 53 75 62 2d 3e 78 50 72 6f 63 28 63 6c 69 65 6e  Sub->xProc(clien
2550: 74 44 61 74 61 2c 20 69 6e 74 65 72 70 2c 20 6f  tData, interp, o
2560: 62 6a 63 2c 20 6f 62 6a 76 29 3b 0a 7d 0a 0a 2f  bjc, objv);.}../
2570: 2a 0a 2a 2a 20 54 68 65 20 5b 63 6c 6f 63 6b 5f  *.** The [clock_
2580: 73 65 63 6f 6e 64 73 5d 20 63 6f 6d 6d 61 6e 64  seconds] command
2590: 2e 20 54 68 69 73 20 69 73 20 6d 6f 72 65 20 6f  . This is more o
25a0: 72 20 6c 65 73 73 20 74 68 65 20 73 61 6d 65 20  r less the same 
25b0: 61 73 20 74 68 65 0a 2a 2a 20 72 65 67 75 6c 61  as the.** regula
25c0: 72 20 74 63 6c 20 5b 63 6c 6f 63 6b 20 73 65 63  r tcl [clock sec
25d0: 6f 6e 64 73 5d 2c 20 65 78 63 65 70 74 20 74 68  onds], except th
25e0: 61 74 20 69 74 20 69 73 20 61 76 61 69 6c 61 62  at it is availab
25f0: 6c 65 20 69 6e 20 74 65 73 74 66 69 78 74 75 72  le in testfixtur
2600: 65 0a 2a 2a 20 77 68 65 6e 20 6c 69 6e 6b 65 64  e.** when linked
2610: 20 61 67 61 69 6e 73 74 20 62 6f 74 68 20 54 63   against both Tc
2620: 6c 20 38 2e 34 20 61 6e 64 20 38 2e 35 2e 20 42  l 8.4 and 8.5. B
2630: 65 63 61 75 73 65 20 5b 63 6c 6f 63 6b 20 73 65  ecause [clock se
2640: 63 6f 6e 64 73 5d 20 69 73 0a 2a 2a 20 69 6d 70  conds] is.** imp
2650: 6c 65 6d 65 6e 74 65 64 20 61 73 20 61 20 73 63  lemented as a sc
2660: 72 69 70 74 20 69 6e 20 54 63 6c 20 38 2e 35 2c  ript in Tcl 8.5,
2670: 20 69 74 20 69 73 20 6e 6f 74 20 75 73 75 61 6c   it is not usual
2680: 6c 79 20 61 76 61 69 6c 61 62 6c 65 20 74 6f 0a  ly available to.
2690: 2a 2a 20 74 65 73 74 66 69 78 74 75 72 65 2e 0a  ** testfixture..
26a0: 2a 2f 20 0a 73 74 61 74 69 63 20 69 6e 74 20 63  */ .static int c
26b0: 6c 6f 63 6b 5f 73 65 63 6f 6e 64 73 5f 70 72 6f  lock_seconds_pro
26c0: 63 28 0a 20 20 43 6c 69 65 6e 74 44 61 74 61 20  c(.  ClientData 
26d0: 63 6c 69 65 6e 74 44 61 74 61 2c 0a 20 20 54 63  clientData,.  Tc
26e0: 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65 72 70  l_Interp *interp
26f0: 2c 0a 20 20 69 6e 74 20 6f 62 6a 63 2c 0a 20 20  ,.  int objc,.  
2700: 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54 20 6f  Tcl_Obj *CONST o
2710: 62 6a 76 5b 5d 0a 29 7b 0a 20 20 54 63 6c 5f 54  bjv[].){.  Tcl_T
2720: 69 6d 65 20 6e 6f 77 3b 0a 20 20 54 63 6c 5f 47  ime now;.  Tcl_G
2730: 65 74 54 69 6d 65 28 26 6e 6f 77 29 3b 0a 20 20  etTime(&now);.  
2740: 54 63 6c 5f 53 65 74 4f 62 6a 52 65 73 75 6c 74  Tcl_SetObjResult
2750: 28 69 6e 74 65 72 70 2c 20 54 63 6c 5f 4e 65 77  (interp, Tcl_New
2760: 49 6e 74 4f 62 6a 28 6e 6f 77 2e 73 65 63 29 29  IntObj(now.sec))
2770: 3b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d  ;.  UNUSED_PARAM
2780: 45 54 45 52 28 63 6c 69 65 6e 74 44 61 74 61 29  ETER(clientData)
2790: 3b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d  ;.  UNUSED_PARAM
27a0: 45 54 45 52 28 6f 62 6a 63 29 3b 0a 20 20 55 4e  ETER(objc);.  UN
27b0: 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 6f  USED_PARAMETER(o
27c0: 62 6a 76 29 3b 0a 20 20 72 65 74 75 72 6e 20 54  bjv);.  return T
27d0: 43 4c 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a  CL_OK;.}../*****
27e0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
27f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2800: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2810: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2820: 2a 2a 2a 2a 0a 2a 2a 20 54 68 69 73 20 62 6c 6f  ****.** This blo
2830: 63 6b 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20  ck contains the 
2840: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  implementation o
2850: 66 20 74 68 65 20 5b 73 71 6c 69 74 65 34 5f 62  f the [sqlite4_b
2860: 6c 6f 63 6b 69 6e 67 5f 73 74 65 70 5d 0a 2a 2a  locking_step].**
2870: 20 63 6f 6d 6d 61 6e 64 20 61 76 61 69 6c 61 62   command availab
2880: 6c 65 20 74 6f 20 74 68 72 65 61 64 73 20 63 72  le to threads cr
2890: 65 61 74 65 64 20 62 79 20 5b 73 71 6c 74 68 72  eated by [sqlthr
28a0: 65 61 64 20 73 70 61 77 6e 5d 20 63 6f 6d 6d 61  ead spawn] comma
28b0: 6e 64 73 2e 20 49 74 0a 2a 2a 20 69 73 20 6f 6e  nds. It.** is on
28c0: 6c 79 20 61 76 61 69 6c 61 62 6c 65 20 6f 6e 20  ly available on 
28d0: 55 4e 49 58 20 66 6f 72 20 6e 6f 77 2e 20 54 68  UNIX for now. Th
28e0: 69 73 20 69 73 20 62 65 63 61 75 73 65 20 70 74  is is because pt
28f0: 68 72 65 61 64 20 63 6f 6e 64 69 74 69 6f 6e 0a  hread condition.
2900: 2a 2a 20 76 61 72 69 61 62 6c 65 73 20 61 72 65  ** variables are
2910: 20 75 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65   used..**.** The
2920: 20 73 6f 75 72 63 65 20 63 6f 64 65 20 66 6f 72   source code for
2930: 20 74 68 65 20 43 20 66 75 6e 63 74 69 6f 6e 73   the C functions
2940: 20 73 71 6c 69 74 65 34 5f 62 6c 6f 63 6b 69 6e   sqlite4_blockin
2950: 67 5f 73 74 65 70 28 29 2c 0a 2a 2a 20 62 6c 6f  g_step(),.** blo
2960: 63 6b 69 6e 67 5f 73 74 65 70 5f 6e 6f 74 69 66  cking_step_notif
2970: 79 28 29 20 61 6e 64 20 74 68 65 20 73 74 72 75  y() and the stru
2980: 63 74 75 72 65 20 55 6e 6c 6f 63 6b 4e 6f 74 69  cture UnlockNoti
2990: 66 69 63 61 74 69 6f 6e 20 69 73 0a 2a 2a 20 61  fication is.** a
29a0: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 65 78 74  utomatically ext
29b0: 72 61 63 74 65 64 20 66 72 6f 6d 20 74 68 69 73  racted from this
29c0: 20 66 69 6c 65 20 61 6e 64 20 75 73 65 64 20 61   file and used a
29d0: 73 20 70 61 72 74 20 6f 66 20 74 68 65 0a 2a 2a  s part of the.**
29e0: 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 66   documentation f
29f0: 6f 72 20 74 68 65 20 73 71 6c 69 74 65 34 5f 75  or the sqlite4_u
2a00: 6e 6c 6f 63 6b 5f 6e 6f 74 69 66 79 28 29 20 41  nlock_notify() A
2a10: 50 49 20 66 75 6e 63 74 69 6f 6e 2e 20 54 68 69  PI function. Thi
2a20: 73 0a 2a 2a 20 73 68 6f 75 6c 64 20 62 65 20 63  s.** should be c
2a30: 6f 6e 73 69 64 65 72 65 64 20 69 66 20 74 68 65  onsidered if the
2a40: 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 61 72 65  se functions are
2a50: 20 74 6f 20 62 65 20 65 78 74 65 6e 64 65 64 20   to be extended 
2a60: 28 69 2e 65 2e 20 74 6f 20 0a 2a 2a 20 73 75 70  (i.e. to .** sup
2a70: 70 6f 72 74 20 77 69 6e 64 6f 77 73 29 20 69 6e  port windows) in
2a80: 20 74 68 65 20 66 75 74 75 72 65 2e 0a 2a 2f 20   the future..*/ 
2a90: 0a 23 69 66 20 53 51 4c 49 54 45 34 5f 4f 53 5f  .#if SQLITE4_OS_
2aa0: 55 4e 49 58 20 26 26 20 64 65 66 69 6e 65 64 28  UNIX && defined(
2ab0: 53 51 4c 49 54 45 34 5f 45 4e 41 42 4c 45 5f 55  SQLITE4_ENABLE_U
2ac0: 4e 4c 4f 43 4b 5f 4e 4f 54 49 46 59 29 0a 0a 2f  NLOCK_NOTIFY)../
2ad0: 2a 20 42 45 47 49 4e 5f 53 51 4c 49 54 45 34 5f  * BEGIN_SQLITE4_
2ae0: 42 4c 4f 43 4b 49 4e 47 5f 53 54 45 50 20 2a 2f  BLOCKING_STEP */
2af0: 0a 2f 2a 20 54 68 69 73 20 65 78 61 6d 70 6c 65  ./* This example
2b00: 20 75 73 65 73 20 74 68 65 20 70 74 68 72 65 61   uses the pthrea
2b10: 64 73 20 41 50 49 20 2a 2f 0a 23 69 6e 63 6c 75  ds API */.#inclu
2b20: 64 65 20 3c 70 74 68 72 65 61 64 2e 68 3e 0a 0a  de <pthread.h>..
2b30: 2f 2a 0a 2a 2a 20 41 20 70 6f 69 6e 74 65 72 20  /*.** A pointer 
2b40: 74 6f 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f  to an instance o
2b50: 66 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65  f this structure
2b60: 20 69 73 20 70 61 73 73 65 64 20 61 73 20 74 68   is passed as th
2b70: 65 20 75 73 65 72 2d 63 6f 6e 74 65 78 74 0a 2a  e user-context.*
2b80: 2a 20 70 6f 69 6e 74 65 72 20 77 68 65 6e 20 72  * pointer when r
2b90: 65 67 69 73 74 65 72 69 6e 67 20 66 6f 72 20 61  egistering for a
2ba0: 6e 20 75 6e 6c 6f 63 6b 2d 6e 6f 74 69 66 79 20  n unlock-notify 
2bb0: 63 61 6c 6c 62 61 63 6b 2e 0a 2a 2f 0a 74 79 70  callback..*/.typ
2bc0: 65 64 65 66 20 73 74 72 75 63 74 20 55 6e 6c 6f  edef struct Unlo
2bd0: 63 6b 4e 6f 74 69 66 69 63 61 74 69 6f 6e 20 55  ckNotification U
2be0: 6e 6c 6f 63 6b 4e 6f 74 69 66 69 63 61 74 69 6f  nlockNotificatio
2bf0: 6e 3b 0a 73 74 72 75 63 74 20 55 6e 6c 6f 63 6b  n;.struct Unlock
2c00: 4e 6f 74 69 66 69 63 61 74 69 6f 6e 20 7b 0a 20  Notification {. 
2c10: 20 69 6e 74 20 66 69 72 65 64 3b 20 20 20 20 20   int fired;     
2c20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2c30: 20 20 20 20 2f 2a 20 54 72 75 65 20 61 66 74 65      /* True afte
2c40: 72 20 75 6e 6c 6f 63 6b 20 65 76 65 6e 74 20 68  r unlock event h
2c50: 61 73 20 6f 63 63 75 72 72 65 64 20 2a 2f 0a 20  as occurred */. 
2c60: 20 70 74 68 72 65 61 64 5f 63 6f 6e 64 5f 74 20   pthread_cond_t 
2c70: 63 6f 6e 64 3b 20 20 20 20 20 20 20 20 20 20 20  cond;           
2c80: 20 20 20 20 2f 2a 20 43 6f 6e 64 69 74 69 6f 6e      /* Condition
2c90: 20 76 61 72 69 61 62 6c 65 20 74 6f 20 77 61 69   variable to wai
2ca0: 74 20 6f 6e 20 2a 2f 0a 20 20 70 74 68 72 65 61  t on */.  pthrea
2cb0: 64 5f 6d 75 74 65 78 5f 74 20 6d 75 74 65 78 3b  d_mutex_t mutex;
2cc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
2cd0: 4d 75 74 65 78 20 74 6f 20 70 72 6f 74 65 63 74  Mutex to protect
2ce0: 20 73 74 72 75 63 74 75 72 65 20 2a 2f 0a 7d 3b   structure */.};
2cf0: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e  ../*.** This fun
2d00: 63 74 69 6f 6e 20 69 73 20 61 6e 20 75 6e 6c 6f  ction is an unlo
2d10: 63 6b 2d 6e 6f 74 69 66 79 20 63 61 6c 6c 62 61  ck-notify callba
2d20: 63 6b 20 72 65 67 69 73 74 65 72 65 64 20 77 69  ck registered wi
2d30: 74 68 20 53 51 4c 69 74 65 2e 0a 2a 2f 0a 73 74  th SQLite..*/.st
2d40: 61 74 69 63 20 76 6f 69 64 20 75 6e 6c 6f 63 6b  atic void unlock
2d50: 5f 6e 6f 74 69 66 79 5f 63 62 28 76 6f 69 64 20  _notify_cb(void 
2d60: 2a 2a 61 70 41 72 67 2c 20 69 6e 74 20 6e 41 72  **apArg, int nAr
2d70: 67 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 66  g){.  int i;.  f
2d80: 6f 72 28 69 3d 30 3b 20 69 3c 6e 41 72 67 3b 20  or(i=0; i<nArg; 
2d90: 69 2b 2b 29 7b 0a 20 20 20 20 55 6e 6c 6f 63 6b  i++){.    Unlock
2da0: 4e 6f 74 69 66 69 63 61 74 69 6f 6e 20 2a 70 20  Notification *p 
2db0: 3d 20 28 55 6e 6c 6f 63 6b 4e 6f 74 69 66 69 63  = (UnlockNotific
2dc0: 61 74 69 6f 6e 20 2a 29 61 70 41 72 67 5b 69 5d  ation *)apArg[i]
2dd0: 3b 0a 20 20 20 20 70 74 68 72 65 61 64 5f 6d 75  ;.    pthread_mu
2de0: 74 65 78 5f 6c 6f 63 6b 28 26 70 2d 3e 6d 75 74  tex_lock(&p->mut
2df0: 65 78 29 3b 0a 20 20 20 20 70 2d 3e 66 69 72 65  ex);.    p->fire
2e00: 64 20 3d 20 31 3b 0a 20 20 20 20 70 74 68 72 65  d = 1;.    pthre
2e10: 61 64 5f 63 6f 6e 64 5f 73 69 67 6e 61 6c 28 26  ad_cond_signal(&
2e20: 70 2d 3e 63 6f 6e 64 29 3b 0a 20 20 20 20 70 74  p->cond);.    pt
2e30: 68 72 65 61 64 5f 6d 75 74 65 78 5f 75 6e 6c 6f  hread_mutex_unlo
2e40: 63 6b 28 26 70 2d 3e 6d 75 74 65 78 29 3b 0a 20  ck(&p->mutex);. 
2e50: 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73   }.}../*.** This
2e60: 20 66 75 6e 63 74 69 6f 6e 20 61 73 73 75 6d 65   function assume
2e70: 73 20 74 68 61 74 20 61 6e 20 53 51 4c 69 74 65  s that an SQLite
2e80: 20 41 50 49 20 63 61 6c 6c 20 28 65 69 74 68 65   API call (eithe
2e90: 72 20 73 71 6c 69 74 65 34 5f 70 72 65 70 61 72  r sqlite4_prepar
2ea0: 65 28 29 20 0a 2a 2a 20 6f 72 20 73 71 6c 69 74  e() .** or sqlit
2eb0: 65 34 5f 73 74 65 70 28 29 29 20 68 61 73 20 6a  e4_step()) has j
2ec0: 75 73 74 20 72 65 74 75 72 6e 65 64 20 53 51 4c  ust returned SQL
2ed0: 49 54 45 34 5f 4c 4f 43 4b 45 44 2e 20 54 68 65  ITE4_LOCKED. The
2ee0: 20 61 72 67 75 6d 65 6e 74 20 69 73 20 74 68 65   argument is the
2ef0: 0a 2a 2a 20 61 73 73 6f 63 69 61 74 65 64 20 64  .** associated d
2f00: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69  atabase connecti
2f10: 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66  on..**.** This f
2f20: 75 6e 63 74 69 6f 6e 20 63 61 6c 6c 73 20 73 71  unction calls sq
2f30: 6c 69 74 65 34 5f 75 6e 6c 6f 63 6b 5f 6e 6f 74  lite4_unlock_not
2f40: 69 66 79 28 29 20 74 6f 20 72 65 67 69 73 74 65  ify() to registe
2f50: 72 20 66 6f 72 20 61 6e 20 0a 2a 2a 20 75 6e 6c  r for an .** unl
2f60: 6f 63 6b 2d 6e 6f 74 69 66 79 20 63 61 6c 6c 62  ock-notify callb
2f70: 61 63 6b 2c 20 74 68 65 6e 20 62 6c 6f 63 6b 73  ack, then blocks
2f80: 20 75 6e 74 69 6c 20 74 68 61 74 20 63 61 6c 6c   until that call
2f90: 62 61 63 6b 20 69 73 20 64 65 6c 69 76 65 72 65  back is delivere
2fa0: 64 20 0a 2a 2a 20 61 6e 64 20 72 65 74 75 72 6e  d .** and return
2fb0: 73 20 53 51 4c 49 54 45 34 5f 4f 4b 2e 20 54 68  s SQLITE4_OK. Th
2fc0: 65 20 63 61 6c 6c 65 72 20 73 68 6f 75 6c 64 20  e caller should 
2fd0: 74 68 65 6e 20 72 65 74 72 79 20 74 68 65 20 66  then retry the f
2fe0: 61 69 6c 65 64 20 6f 70 65 72 61 74 69 6f 6e 2e  ailed operation.
2ff0: 0a 2a 2a 0a 2a 2a 20 4f 72 2c 20 69 66 20 73 71  .**.** Or, if sq
3000: 6c 69 74 65 34 5f 75 6e 6c 6f 63 6b 5f 6e 6f 74  lite4_unlock_not
3010: 69 66 79 28 29 20 69 6e 64 69 63 61 74 65 73 20  ify() indicates 
3020: 74 68 61 74 20 74 6f 20 62 6c 6f 63 6b 20 77 6f  that to block wo
3030: 75 6c 64 20 64 65 61 64 6c 6f 63 6b 20 0a 2a 2a  uld deadlock .**
3040: 20 74 68 65 20 73 79 73 74 65 6d 2c 20 74 68 65   the system, the
3050: 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  n this function 
3060: 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45 34 5f  returns SQLITE4_
3070: 4c 4f 43 4b 45 44 20 69 6d 6d 65 64 69 61 74 65  LOCKED immediate
3080: 6c 79 2e 20 49 6e 20 0a 2a 2a 20 74 68 69 73 20  ly. In .** this 
3090: 63 61 73 65 20 74 68 65 20 63 61 6c 6c 65 72 20  case the caller 
30a0: 73 68 6f 75 6c 64 20 6e 6f 74 20 72 65 74 72 79  should not retry
30b0: 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 61   the operation a
30c0: 6e 64 20 73 68 6f 75 6c 64 20 72 6f 6c 6c 20 0a  nd should roll .
30d0: 2a 2a 20 62 61 63 6b 20 74 68 65 20 63 75 72 72  ** back the curr
30e0: 65 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  ent transaction 
30f0: 28 69 66 20 61 6e 79 29 2e 0a 2a 2f 0a 73 74 61  (if any)..*/.sta
3100: 74 69 63 20 69 6e 74 20 77 61 69 74 5f 66 6f 72  tic int wait_for
3110: 5f 75 6e 6c 6f 63 6b 5f 6e 6f 74 69 66 79 28 73  _unlock_notify(s
3120: 71 6c 69 74 65 34 20 2a 64 62 29 7b 0a 20 20 69  qlite4 *db){.  i
3130: 6e 74 20 72 63 3b 0a 20 20 55 6e 6c 6f 63 6b 4e  nt rc;.  UnlockN
3140: 6f 74 69 66 69 63 61 74 69 6f 6e 20 75 6e 3b 0a  otification un;.
3150: 0a 20 20 2f 2a 20 49 6e 69 74 69 61 6c 69 7a 65  .  /* Initialize
3160: 20 74 68 65 20 55 6e 6c 6f 63 6b 4e 6f 74 69 66   the UnlockNotif
3170: 69 63 61 74 69 6f 6e 20 73 74 72 75 63 74 75 72  ication structur
3180: 65 2e 20 2a 2f 0a 20 20 75 6e 2e 66 69 72 65 64  e. */.  un.fired
3190: 20 3d 20 30 3b 0a 20 20 70 74 68 72 65 61 64 5f   = 0;.  pthread_
31a0: 6d 75 74 65 78 5f 69 6e 69 74 28 26 75 6e 2e 6d  mutex_init(&un.m
31b0: 75 74 65 78 2c 20 30 29 3b 0a 20 20 70 74 68 72  utex, 0);.  pthr
31c0: 65 61 64 5f 63 6f 6e 64 5f 69 6e 69 74 28 26 75  ead_cond_init(&u
31d0: 6e 2e 63 6f 6e 64 2c 20 30 29 3b 0a 0a 20 20 2f  n.cond, 0);..  /
31e0: 2a 20 52 65 67 69 73 74 65 72 20 66 6f 72 20 61  * Register for a
31f0: 6e 20 75 6e 6c 6f 63 6b 2d 6e 6f 74 69 66 79 20  n unlock-notify 
3200: 63 61 6c 6c 62 61 63 6b 2e 20 2a 2f 0a 20 20 72  callback. */.  r
3210: 63 20 3d 20 73 71 6c 69 74 65 34 5f 75 6e 6c 6f  c = sqlite4_unlo
3220: 63 6b 5f 6e 6f 74 69 66 79 28 64 62 2c 20 75 6e  ck_notify(db, un
3230: 6c 6f 63 6b 5f 6e 6f 74 69 66 79 5f 63 62 2c 20  lock_notify_cb, 
3240: 28 76 6f 69 64 20 2a 29 26 75 6e 29 3b 0a 20 20  (void *)&un);.  
3250: 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49  assert( rc==SQLI
3260: 54 45 34 5f 4c 4f 43 4b 45 44 20 7c 7c 20 72 63  TE4_LOCKED || rc
3270: 3d 3d 53 51 4c 49 54 45 34 5f 4f 4b 20 29 3b 0a  ==SQLITE4_OK );.
3280: 0a 20 20 2f 2a 20 54 68 65 20 63 61 6c 6c 20 74  .  /* The call t
3290: 6f 20 73 71 6c 69 74 65 34 5f 75 6e 6c 6f 63 6b  o sqlite4_unlock
32a0: 5f 6e 6f 74 69 66 79 28 29 20 61 6c 77 61 79 73  _notify() always
32b0: 20 72 65 74 75 72 6e 73 20 65 69 74 68 65 72 20   returns either 
32c0: 53 51 4c 49 54 45 34 5f 4c 4f 43 4b 45 44 20 0a  SQLITE4_LOCKED .
32d0: 20 20 2a 2a 20 6f 72 20 53 51 4c 49 54 45 34 5f    ** or SQLITE4_
32e0: 4f 4b 2e 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49  OK. .  **.  ** I
32f0: 66 20 53 51 4c 49 54 45 34 5f 4c 4f 43 4b 45 44  f SQLITE4_LOCKED
3300: 20 77 61 73 20 72 65 74 75 72 6e 65 64 2c 20 74   was returned, t
3310: 68 65 6e 20 74 68 65 20 73 79 73 74 65 6d 20 69  hen the system i
3320: 73 20 64 65 61 64 6c 6f 63 6b 65 64 2e 20 49 6e  s deadlocked. In
3330: 20 74 68 69 73 0a 20 20 2a 2a 20 63 61 73 65 20   this.  ** case 
3340: 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6e 65  this function ne
3350: 65 64 73 20 74 6f 20 72 65 74 75 72 6e 20 53 51  eds to return SQ
3360: 4c 49 54 45 34 5f 4c 4f 43 4b 45 44 20 74 6f 20  LITE4_LOCKED to 
3370: 74 68 65 20 63 61 6c 6c 65 72 20 73 6f 20 0a 20  the caller so . 
3380: 20 2a 2a 20 74 68 61 74 20 74 68 65 20 63 75 72   ** that the cur
3390: 72 65 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e  rent transaction
33a0: 20 63 61 6e 20 62 65 20 72 6f 6c 6c 65 64 20 62   can be rolled b
33b0: 61 63 6b 2e 20 4f 74 68 65 72 77 69 73 65 2c 20  ack. Otherwise, 
33c0: 62 6c 6f 63 6b 0a 20 20 2a 2a 20 75 6e 74 69 6c  block.  ** until
33d0: 20 74 68 65 20 75 6e 6c 6f 63 6b 2d 6e 6f 74 69   the unlock-noti
33e0: 66 79 20 63 61 6c 6c 62 61 63 6b 20 69 73 20 69  fy callback is i
33f0: 6e 76 6f 6b 65 64 2c 20 74 68 65 6e 20 72 65 74  nvoked, then ret
3400: 75 72 6e 20 53 51 4c 49 54 45 34 5f 4f 4b 2e 0a  urn SQLITE4_OK..
3410: 20 20 2a 2f 0a 20 20 69 66 28 20 72 63 3d 3d 53    */.  if( rc==S
3420: 51 4c 49 54 45 34 5f 4f 4b 20 29 7b 0a 20 20 20  QLITE4_OK ){.   
3430: 20 70 74 68 72 65 61 64 5f 6d 75 74 65 78 5f 6c   pthread_mutex_l
3440: 6f 63 6b 28 26 75 6e 2e 6d 75 74 65 78 29 3b 0a  ock(&un.mutex);.
3450: 20 20 20 20 69 66 28 20 21 75 6e 2e 66 69 72 65      if( !un.fire
3460: 64 20 29 7b 0a 20 20 20 20 20 20 70 74 68 72 65  d ){.      pthre
3470: 61 64 5f 63 6f 6e 64 5f 77 61 69 74 28 26 75 6e  ad_cond_wait(&un
3480: 2e 63 6f 6e 64 2c 20 26 75 6e 2e 6d 75 74 65 78  .cond, &un.mutex
3490: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 74 68  );.    }.    pth
34a0: 72 65 61 64 5f 6d 75 74 65 78 5f 75 6e 6c 6f 63  read_mutex_unloc
34b0: 6b 28 26 75 6e 2e 6d 75 74 65 78 29 3b 0a 20 20  k(&un.mutex);.  
34c0: 7d 0a 0a 20 20 2f 2a 20 44 65 73 74 72 6f 79 20  }..  /* Destroy 
34d0: 74 68 65 20 6d 75 74 65 78 20 61 6e 64 20 63 6f  the mutex and co
34e0: 6e 64 69 74 69 6f 6e 20 76 61 72 69 61 62 6c 65  ndition variable
34f0: 73 2e 20 2a 2f 0a 20 20 70 74 68 72 65 61 64 5f  s. */.  pthread_
3500: 63 6f 6e 64 5f 64 65 73 74 72 6f 79 28 26 75 6e  cond_destroy(&un
3510: 2e 63 6f 6e 64 29 3b 0a 20 20 70 74 68 72 65 61  .cond);.  pthrea
3520: 64 5f 6d 75 74 65 78 5f 64 65 73 74 72 6f 79 28  d_mutex_destroy(
3530: 26 75 6e 2e 6d 75 74 65 78 29 3b 0a 0a 20 20 72  &un.mutex);..  r
3540: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
3550: 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e  ** This function
3560: 20 69 73 20 61 20 77 72 61 70 70 65 72 20 61 72   is a wrapper ar
3570: 6f 75 6e 64 20 74 68 65 20 53 51 4c 69 74 65 20  ound the SQLite 
3580: 66 75 6e 63 74 69 6f 6e 20 73 71 6c 69 74 65 34  function sqlite4
3590: 5f 73 74 65 70 28 29 2e 0a 2a 2f 0a 69 6e 74 20  _step()..*/.int 
35a0: 73 71 6c 69 74 65 34 5f 62 6c 6f 63 6b 69 6e 67  sqlite4_blocking
35b0: 5f 73 74 65 70 28 73 71 6c 69 74 65 34 5f 73 74  _step(sqlite4_st
35c0: 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 69 6e  mt *pStmt){.  in
35d0: 74 20 72 63 3b 0a 20 20 77 68 69 6c 65 28 20 53  t rc;.  while( S
35e0: 51 4c 49 54 45 34 5f 4c 4f 43 4b 45 44 3d 3d 28  QLITE4_LOCKED==(
35f0: 72 63 20 3d 20 73 71 6c 69 74 65 34 5f 73 74 65  rc = sqlite4_ste
3600: 70 28 70 53 74 6d 74 29 29 20 29 7b 0a 20 20 20  p(pStmt)) ){.   
3610: 20 72 63 20 3d 20 77 61 69 74 5f 66 6f 72 5f 75   rc = wait_for_u
3620: 6e 6c 6f 63 6b 5f 6e 6f 74 69 66 79 28 73 71 6c  nlock_notify(sql
3630: 69 74 65 34 5f 64 62 5f 68 61 6e 64 6c 65 28 70  ite4_db_handle(p
3640: 53 74 6d 74 29 29 3b 0a 20 20 20 20 69 66 28 20  Stmt));.    if( 
3650: 72 63 21 3d 53 51 4c 49 54 45 34 5f 4f 4b 20 29  rc!=SQLITE4_OK )
3660: 20 62 72 65 61 6b 3b 0a 20 20 20 20 73 71 6c 69   break;.    sqli
3670: 74 65 34 5f 72 65 73 65 74 28 70 53 74 6d 74 29  te4_reset(pStmt)
3680: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72  ;.  }.  return r
3690: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  c;.}../*.** This
36a0: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 77   function is a w
36b0: 72 61 70 70 65 72 20 61 72 6f 75 6e 64 20 74 68  rapper around th
36c0: 65 20 53 51 4c 69 74 65 20 66 75 6e 63 74 69 6f  e SQLite functio
36d0: 6e 20 73 71 6c 69 74 65 34 5f 70 72 65 70 61 72  n sqlite4_prepar
36e0: 65 28 29 2e 0a 2a 2a 20 49 74 20 66 75 6e 63 74  e()..** It funct
36f0: 69 6f 6e 73 20 69 6e 20 74 68 65 20 73 61 6d 65  ions in the same
3700: 20 77 61 79 20 61 73 20 70 72 65 70 61 72 65 5f   way as prepare_
3710: 76 32 28 29 2c 20 65 78 63 65 70 74 20 74 68 61  v2(), except tha
3720: 74 20 69 66 20 61 20 72 65 71 75 69 72 65 64 0a  t if a required.
3730: 2a 2a 20 73 68 61 72 65 64 2d 63 61 63 68 65 20  ** shared-cache 
3740: 6c 6f 63 6b 20 63 61 6e 6e 6f 74 20 62 65 20 6f  lock cannot be o
3750: 62 74 61 69 6e 65 64 2c 20 74 68 69 73 20 66 75  btained, this fu
3760: 6e 63 74 69 6f 6e 20 6d 61 79 20 62 6c 6f 63 6b  nction may block
3770: 20 77 61 69 74 69 6e 67 20 66 6f 72 0a 2a 2a 20   waiting for.** 
3780: 74 68 65 20 6c 6f 63 6b 20 74 6f 20 62 65 63 6f  the lock to beco
3790: 6d 65 20 61 76 61 69 6c 61 62 6c 65 2e 20 49 6e  me available. In
37a0: 20 74 68 69 73 20 73 63 65 6e 61 72 69 6f 20 74   this scenario t
37b0: 68 65 20 6e 6f 72 6d 61 6c 20 41 50 49 20 70 72  he normal API pr
37c0: 65 70 61 72 65 5f 76 32 28 29 0a 2a 2a 20 66 75  epare_v2().** fu
37d0: 6e 63 74 69 6f 6e 20 61 6c 77 61 79 73 20 72 65  nction always re
37e0: 74 75 72 6e 73 20 53 51 4c 49 54 45 34 5f 4c 4f  turns SQLITE4_LO
37f0: 43 4b 45 44 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74  CKED..**.** If t
3800: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74  his function ret
3810: 75 72 6e 73 20 53 51 4c 49 54 45 34 5f 4c 4f 43  urns SQLITE4_LOC
3820: 4b 45 44 2c 20 74 68 65 20 63 61 6c 6c 65 72 20  KED, the caller 
3830: 73 68 6f 75 6c 64 20 72 6f 6c 6c 62 61 63 6b 0a  should rollback.
3840: 2a 2a 20 74 68 65 20 63 75 72 72 65 6e 74 20 74  ** the current t
3850: 72 61 6e 73 61 63 74 69 6f 6e 20 28 69 66 20 61  ransaction (if a
3860: 6e 79 29 20 61 6e 64 20 74 72 79 20 61 67 61 69  ny) and try agai
3870: 6e 20 6c 61 74 65 72 2e 20 4f 74 68 65 72 77 69  n later. Otherwi
3880: 73 65 2c 20 74 68 65 0a 2a 2a 20 73 79 73 74 65  se, the.** syste
3890: 6d 20 6d 61 79 20 62 65 63 6f 6d 65 20 64 65 61  m may become dea
38a0: 64 6c 6f 63 6b 65 64 2e 0a 2a 2f 0a 69 6e 74 20  dlocked..*/.int 
38b0: 73 71 6c 69 74 65 34 5f 62 6c 6f 63 6b 69 6e 67  sqlite4_blocking
38c0: 5f 70 72 65 70 61 72 65 28 0a 20 20 73 71 6c 69  _prepare(.  sqli
38d0: 74 65 34 20 2a 64 62 2c 20 20 20 20 20 20 20 20  te4 *db,        
38e0: 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73        /* Databas
38f0: 65 20 68 61 6e 64 6c 65 2e 20 2a 2f 0a 20 20 63  e handle. */.  c
3900: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 53 71 6c 2c  onst char *zSql,
3910: 20 20 20 20 20 20 20 20 20 2f 2a 20 55 54 46 2d           /* UTF-
3920: 38 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74  8 encoded SQL st
3930: 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e  atement. */.  in
3940: 74 20 6e 53 71 6c 2c 20 20 20 20 20 20 20 20 20  t nSql,         
3950: 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74          /* Lengt
3960: 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79 74  h of zSql in byt
3970: 65 73 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 34  es. */.  sqlite4
3980: 5f 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20  _stmt **ppStmt, 
3990: 20 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69     /* OUT: A poi
39a0: 6e 74 65 72 20 74 6f 20 74 68 65 20 70 72 65 70  nter to the prep
39b0: 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a  ared statement *
39c0: 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  /.  const char *
39d0: 2a 70 7a 20 20 20 20 20 20 20 20 20 20 20 2f 2a  *pz           /*
39e0: 20 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72   OUT: End of par
39f0: 73 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b  sed string */.){
3a00: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 77 68 69  .  int rc;.  whi
3a10: 6c 65 28 20 53 51 4c 49 54 45 34 5f 4c 4f 43 4b  le( SQLITE4_LOCK
3a20: 45 44 3d 3d 28 72 63 20 3d 20 73 71 6c 69 74 65  ED==(rc = sqlite
3a30: 34 5f 70 72 65 70 61 72 65 28 64 62 2c 20 7a 53  4_prepare(db, zS
3a40: 71 6c 2c 20 6e 53 71 6c 2c 20 70 70 53 74 6d 74  ql, nSql, ppStmt
3a50: 2c 20 70 7a 29 29 20 29 7b 0a 20 20 20 20 72 63  , pz)) ){.    rc
3a60: 20 3d 20 77 61 69 74 5f 66 6f 72 5f 75 6e 6c 6f   = wait_for_unlo
3a70: 63 6b 5f 6e 6f 74 69 66 79 28 64 62 29 3b 0a 20  ck_notify(db);. 
3a80: 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54     if( rc!=SQLIT
3a90: 45 34 5f 4f 4b 20 29 20 62 72 65 61 6b 3b 0a 20  E4_OK ) break;. 
3aa0: 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a   }.  return rc;.
3ab0: 7d 0a 2f 2a 20 45 4e 44 5f 53 51 4c 49 54 45 34  }./* END_SQLITE4
3ac0: 5f 42 4c 4f 43 4b 49 4e 47 5f 53 54 45 50 20 2a  _BLOCKING_STEP *
3ad0: 2f 0a 0a 2f 2a 0a 2a 2a 20 55 73 61 67 65 3a 20  /../*.** Usage: 
3ae0: 73 71 6c 69 74 65 34 5f 62 6c 6f 63 6b 69 6e 67  sqlite4_blocking
3af0: 5f 73 74 65 70 20 53 54 4d 54 0a 2a 2a 0a 2a 2a  _step STMT.**.**
3b00: 20 41 64 76 61 6e 63 65 20 74 68 65 20 73 74 61   Advance the sta
3b10: 74 65 6d 65 6e 74 20 74 6f 20 74 68 65 20 6e 65  tement to the ne
3b20: 78 74 20 72 6f 77 2e 0a 2a 2f 0a 73 74 61 74 69  xt row..*/.stati
3b30: 63 20 69 6e 74 20 62 6c 6f 63 6b 69 6e 67 5f 73  c int blocking_s
3b40: 74 65 70 5f 70 72 6f 63 28 0a 20 20 76 6f 69 64  tep_proc(.  void
3b50: 20 2a 20 63 6c 69 65 6e 74 44 61 74 61 2c 0a 20   * clientData,. 
3b60: 20 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74   Tcl_Interp *int
3b70: 65 72 70 2c 0a 20 20 69 6e 74 20 6f 62 6a 63 2c  erp,.  int objc,
3b80: 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53  .  Tcl_Obj *CONS
3b90: 54 20 6f 62 6a 76 5b 5d 0a 29 7b 0a 0a 20 20 73  T objv[].){..  s
3ba0: 71 6c 69 74 65 34 5f 73 74 6d 74 20 2a 70 53 74  qlite4_stmt *pSt
3bb0: 6d 74 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20  mt;.  int rc;.. 
3bc0: 20 69 66 28 20 6f 62 6a 63 21 3d 32 20 29 7b 0a   if( objc!=2 ){.
3bd0: 20 20 20 20 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d      Tcl_WrongNum
3be0: 41 72 67 73 28 69 6e 74 65 72 70 2c 20 31 2c 20  Args(interp, 1, 
3bf0: 6f 62 6a 76 2c 20 22 53 54 4d 54 22 29 3b 0a 20  objv, "STMT");. 
3c00: 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45 52     return TCL_ER
3c10: 52 4f 52 3b 0a 20 20 7d 0a 0a 20 20 70 53 74 6d  ROR;.  }..  pStm
3c20: 74 20 3d 20 28 73 71 6c 69 74 65 34 5f 73 74 6d  t = (sqlite4_stm
3c30: 74 2a 29 73 71 6c 69 74 65 34 54 65 73 74 54 65  t*)sqlite4TestTe
3c40: 78 74 54 6f 50 74 72 28 54 63 6c 5f 47 65 74 53  xtToPtr(Tcl_GetS
3c50: 74 72 69 6e 67 28 6f 62 6a 76 5b 31 5d 29 29 3b  tring(objv[1]));
3c60: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 34 5f  .  rc = sqlite4_
3c70: 62 6c 6f 63 6b 69 6e 67 5f 73 74 65 70 28 70 53  blocking_step(pS
3c80: 74 6d 74 29 3b 0a 0a 20 20 54 63 6c 5f 53 65 74  tmt);..  Tcl_Set
3c90: 52 65 73 75 6c 74 28 69 6e 74 65 72 70 2c 20 28  Result(interp, (
3ca0: 63 68 61 72 20 2a 29 73 71 6c 69 74 65 34 54 65  char *)sqlite4Te
3cb0: 73 74 45 72 72 6f 72 4e 61 6d 65 28 72 63 29 2c  stErrorName(rc),
3cc0: 20 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 54 43   0);.  return TC
3cd0: 4c 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55  L_OK;.}../*.** U
3ce0: 73 61 67 65 3a 20 73 71 6c 69 74 65 34 5f 62 6c  sage: sqlite4_bl
3cf0: 6f 63 6b 69 6e 67 5f 70 72 65 70 61 72 65 20 44  ocking_prepare D
3d00: 42 20 73 71 6c 20 62 79 74 65 73 20 3f 74 61 69  B sql bytes ?tai
3d10: 6c 76 61 72 3f 0a 2a 2a 20 55 73 61 67 65 3a 20  lvar?.** Usage: 
3d20: 73 71 6c 69 74 65 34 5f 6e 6f 6e 62 6c 6f 63 6b  sqlite4_nonblock
3d30: 69 6e 67 5f 70 72 65 70 61 72 65 20 44 42 20 73  ing_prepare DB s
3d40: 71 6c 20 62 79 74 65 73 20 3f 74 61 69 6c 76 61  ql bytes ?tailva
3d50: 72 3f 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  r?.*/.static int
3d60: 20 62 6c 6f 63 6b 69 6e 67 5f 70 72 65 70 61 72   blocking_prepar
3d70: 65 5f 70 72 6f 63 28 0a 20 20 76 6f 69 64 20 2a  e_proc(.  void *
3d80: 20 63 6c 69 65 6e 74 44 61 74 61 2c 0a 20 20 54   clientData,.  T
3d90: 63 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65 72  cl_Interp *inter
3da0: 70 2c 0a 20 20 69 6e 74 20 6f 62 6a 63 2c 0a 20  p,.  int objc,. 
3db0: 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54 20   Tcl_Obj *CONST 
3dc0: 6f 62 6a 76 5b 5d 0a 29 7b 0a 20 20 73 71 6c 69  objv[].){.  sqli
3dd0: 74 65 34 20 2a 64 62 3b 0a 20 20 63 6f 6e 73 74  te4 *db;.  const
3de0: 20 63 68 61 72 20 2a 7a 53 71 6c 3b 0a 20 20 69   char *zSql;.  i
3df0: 6e 74 20 62 79 74 65 73 3b 0a 20 20 63 6f 6e 73  nt bytes;.  cons
3e00: 74 20 63 68 61 72 20 2a 7a 54 61 69 6c 20 3d 20  t char *zTail = 
3e10: 30 3b 0a 20 20 73 71 6c 69 74 65 34 5f 73 74 6d  0;.  sqlite4_stm
3e20: 74 20 2a 70 53 74 6d 74 20 3d 20 30 3b 0a 20 20  t *pStmt = 0;.  
3e30: 63 68 61 72 20 7a 42 75 66 5b 35 30 5d 3b 0a 20  char zBuf[50];. 
3e40: 20 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74 20 69   int rc;.  int i
3e50: 73 42 6c 6f 63 6b 69 6e 67 20 3d 20 21 28 63 6c  sBlocking = !(cl
3e60: 69 65 6e 74 44 61 74 61 3d 3d 30 29 3b 0a 0a 20  ientData==0);.. 
3e70: 20 69 66 28 20 6f 62 6a 63 21 3d 35 20 26 26 20   if( objc!=5 && 
3e80: 6f 62 6a 63 21 3d 34 20 29 7b 0a 20 20 20 20 54  objc!=4 ){.    T
3e90: 63 6c 5f 41 70 70 65 6e 64 52 65 73 75 6c 74 28  cl_AppendResult(
3ea0: 69 6e 74 65 72 70 2c 20 22 77 72 6f 6e 67 20 23  interp, "wrong #
3eb0: 20 61 72 67 73 3a 20 73 68 6f 75 6c 64 20 62 65   args: should be
3ec0: 20 5c 22 22 2c 20 0a 20 20 20 20 20 20 20 54 63   \"", .       Tc
3ed0: 6c 5f 47 65 74 53 74 72 69 6e 67 28 6f 62 6a 76  l_GetString(objv
3ee0: 5b 30 5d 29 2c 20 22 20 44 42 20 73 71 6c 20 62  [0]), " DB sql b
3ef0: 79 74 65 73 20 74 61 69 6c 76 61 72 22 2c 20 30  ytes tailvar", 0
3f00: 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 54 43  );.    return TC
3f10: 4c 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 69  L_ERROR;.  }.  i
3f20: 66 28 20 67 65 74 44 62 50 6f 69 6e 74 65 72 28  f( getDbPointer(
3f30: 69 6e 74 65 72 70 2c 20 54 63 6c 5f 47 65 74 53  interp, Tcl_GetS
3f40: 74 72 69 6e 67 28 6f 62 6a 76 5b 31 5d 29 2c 20  tring(objv[1]), 
3f50: 26 64 62 29 20 29 20 72 65 74 75 72 6e 20 54 43  &db) ) return TC
3f60: 4c 5f 45 52 52 4f 52 3b 0a 20 20 7a 53 71 6c 20  L_ERROR;.  zSql 
3f70: 3d 20 54 63 6c 5f 47 65 74 53 74 72 69 6e 67 28  = Tcl_GetString(
3f80: 6f 62 6a 76 5b 32 5d 29 3b 0a 20 20 69 66 28 20  objv[2]);.  if( 
3f90: 54 63 6c 5f 47 65 74 49 6e 74 46 72 6f 6d 4f 62  Tcl_GetIntFromOb
3fa0: 6a 28 69 6e 74 65 72 70 2c 20 6f 62 6a 76 5b 33  j(interp, objv[3
3fb0: 5d 2c 20 26 62 79 74 65 73 29 20 29 20 72 65 74  ], &bytes) ) ret
3fc0: 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 0a  urn TCL_ERROR;..
3fd0: 20 20 69 66 28 20 69 73 42 6c 6f 63 6b 69 6e 67    if( isBlocking
3fe0: 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c   ){.    rc = sql
3ff0: 69 74 65 34 5f 62 6c 6f 63 6b 69 6e 67 5f 70 72  ite4_blocking_pr
4000: 65 70 61 72 65 28 64 62 2c 20 7a 53 71 6c 2c 20  epare(db, zSql, 
4010: 62 79 74 65 73 2c 20 26 70 53 74 6d 74 2c 20 26  bytes, &pStmt, &
4020: 7a 54 61 69 6c 29 3b 0a 20 20 7d 65 6c 73 65 7b  zTail);.  }else{
4030: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65  .    rc = sqlite
4040: 34 5f 70 72 65 70 61 72 65 28 64 62 2c 20 7a 53  4_prepare(db, zS
4050: 71 6c 2c 20 62 79 74 65 73 2c 20 26 70 53 74 6d  ql, bytes, &pStm
4060: 74 2c 20 26 7a 54 61 69 6c 29 3b 0a 20 20 7d 0a  t, &zTail);.  }.
4070: 0a 20 20 61 73 73 65 72 74 28 72 63 3d 3d 53 51  .  assert(rc==SQ
4080: 4c 49 54 45 34 5f 4f 4b 20 7c 7c 20 70 53 74 6d  LITE4_OK || pStm
4090: 74 3d 3d 30 29 3b 0a 20 20 69 66 28 20 7a 54 61  t==0);.  if( zTa
40a0: 69 6c 20 26 26 20 6f 62 6a 63 3e 3d 35 20 29 7b  il && objc>=5 ){
40b0: 0a 20 20 20 20 69 66 28 20 62 79 74 65 73 3e 3d  .    if( bytes>=
40c0: 30 20 29 7b 0a 20 20 20 20 20 20 62 79 74 65 73  0 ){.      bytes
40d0: 20 3d 20 62 79 74 65 73 20 2d 20 28 7a 54 61 69   = bytes - (zTai
40e0: 6c 2d 7a 53 71 6c 29 3b 0a 20 20 20 20 7d 0a 20  l-zSql);.    }. 
40f0: 20 20 20 54 63 6c 5f 4f 62 6a 53 65 74 56 61 72     Tcl_ObjSetVar
4100: 32 28 69 6e 74 65 72 70 2c 20 6f 62 6a 76 5b 34  2(interp, objv[4
4110: 5d 2c 20 30 2c 20 54 63 6c 5f 4e 65 77 53 74 72  ], 0, Tcl_NewStr
4120: 69 6e 67 4f 62 6a 28 7a 54 61 69 6c 2c 20 62 79  ingObj(zTail, by
4130: 74 65 73 29 2c 20 30 29 3b 0a 20 20 7d 0a 20 20  tes), 0);.  }.  
4140: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 34 5f  if( rc!=SQLITE4_
4150: 4f 4b 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74  OK ){.    assert
4160: 28 20 70 53 74 6d 74 3d 3d 30 20 29 3b 0a 20 20  ( pStmt==0 );.  
4170: 20 20 73 70 72 69 6e 74 66 28 7a 42 75 66 2c 20    sprintf(zBuf, 
4180: 22 25 73 20 22 2c 20 28 63 68 61 72 20 2a 29 73  "%s ", (char *)s
4190: 71 6c 69 74 65 34 54 65 73 74 45 72 72 6f 72 4e  qlite4TestErrorN
41a0: 61 6d 65 28 72 63 29 29 3b 0a 20 20 20 20 54 63  ame(rc));.    Tc
41b0: 6c 5f 41 70 70 65 6e 64 52 65 73 75 6c 74 28 69  l_AppendResult(i
41c0: 6e 74 65 72 70 2c 20 7a 42 75 66 2c 20 73 71 6c  nterp, zBuf, sql
41d0: 69 74 65 34 5f 65 72 72 6d 73 67 28 64 62 29 2c  ite4_errmsg(db),
41e0: 20 30 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20   0);.    return 
41f0: 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 0a  TCL_ERROR;.  }..
4200: 20 20 69 66 28 20 70 53 74 6d 74 20 29 7b 0a 20    if( pStmt ){. 
4210: 20 20 20 69 66 28 20 73 71 6c 69 74 65 34 54 65     if( sqlite4Te
4220: 73 74 4d 61 6b 65 50 6f 69 6e 74 65 72 53 74 72  stMakePointerStr
4230: 28 69 6e 74 65 72 70 2c 20 7a 42 75 66 2c 20 70  (interp, zBuf, p
4240: 53 74 6d 74 29 20 29 20 72 65 74 75 72 6e 20 54  Stmt) ) return T
4250: 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 20 20 54 63  CL_ERROR;.    Tc
4260: 6c 5f 41 70 70 65 6e 64 52 65 73 75 6c 74 28 69  l_AppendResult(i
4270: 6e 74 65 72 70 2c 20 7a 42 75 66 2c 20 30 29 3b  nterp, zBuf, 0);
4280: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 54 43  .  }.  return TC
4290: 4c 5f 4f 4b 3b 0a 7d 0a 0a 23 65 6e 64 69 66 20  L_OK;.}..#endif 
42a0: 2f 2a 20 53 51 4c 49 54 45 34 5f 4f 53 5f 55 4e  /* SQLITE4_OS_UN
42b0: 49 58 20 26 26 20 53 51 4c 49 54 45 34 5f 45 4e  IX && SQLITE4_EN
42c0: 41 42 4c 45 5f 55 4e 4c 4f 43 4b 5f 4e 4f 54 49  ABLE_UNLOCK_NOTI
42d0: 46 59 20 2a 2f 0a 2f 2a 0a 2a 2a 20 45 6e 64 20  FY */./*.** End 
42e0: 6f 66 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  of implementatio
42f0: 6e 20 6f 66 20 5b 73 71 6c 69 74 65 34 5f 62 6c  n of [sqlite4_bl
4300: 6f 63 6b 69 6e 67 5f 73 74 65 70 5d 2e 0a 2a 2a  ocking_step]..**
4310: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4320: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4330: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4340: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4350: 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52  ******/../*.** R
4360: 65 67 69 73 74 65 72 20 63 6f 6d 6d 61 6e 64 73  egister commands
4370: 20 77 69 74 68 20 74 68 65 20 54 43 4c 20 69 6e   with the TCL in
4380: 74 65 72 70 72 65 74 65 72 2e 0a 2a 2f 0a 69 6e  terpreter..*/.in
4390: 74 20 53 71 6c 69 74 65 74 65 73 74 54 68 72 65  t SqlitetestThre
43a0: 61 64 5f 49 6e 69 74 28 54 63 6c 5f 49 6e 74 65  ad_Init(Tcl_Inte
43b0: 72 70 20 2a 69 6e 74 65 72 70 29 7b 0a 20 20 54  rp *interp){.  T
43c0: 63 6c 5f 43 72 65 61 74 65 4f 62 6a 43 6f 6d 6d  cl_CreateObjComm
43d0: 61 6e 64 28 69 6e 74 65 72 70 2c 20 22 73 71 6c  and(interp, "sql
43e0: 74 68 72 65 61 64 22 2c 20 73 71 6c 74 68 72 65  thread", sqlthre
43f0: 61 64 5f 70 72 6f 63 2c 20 30 2c 20 30 29 3b 0a  ad_proc, 0, 0);.
4400: 20 20 54 63 6c 5f 43 72 65 61 74 65 4f 62 6a 43    Tcl_CreateObjC
4410: 6f 6d 6d 61 6e 64 28 69 6e 74 65 72 70 2c 20 22  ommand(interp, "
4420: 63 6c 6f 63 6b 5f 73 65 63 6f 6e 64 73 22 2c 20  clock_seconds", 
4430: 63 6c 6f 63 6b 5f 73 65 63 6f 6e 64 73 5f 70 72  clock_seconds_pr
4440: 6f 63 2c 20 30 2c 20 30 29 3b 0a 23 69 66 20 53  oc, 0, 0);.#if S
4450: 51 4c 49 54 45 34 5f 4f 53 5f 55 4e 49 58 20 26  QLITE4_OS_UNIX &
4460: 26 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45  & defined(SQLITE
4470: 34 5f 45 4e 41 42 4c 45 5f 55 4e 4c 4f 43 4b 5f  4_ENABLE_UNLOCK_
4480: 4e 4f 54 49 46 59 29 0a 20 20 54 63 6c 5f 43 72  NOTIFY).  Tcl_Cr
4490: 65 61 74 65 4f 62 6a 43 6f 6d 6d 61 6e 64 28 69  eateObjCommand(i
44a0: 6e 74 65 72 70 2c 20 22 73 71 6c 69 74 65 34 5f  nterp, "sqlite4_
44b0: 62 6c 6f 63 6b 69 6e 67 5f 73 74 65 70 22 2c 20  blocking_step", 
44c0: 62 6c 6f 63 6b 69 6e 67 5f 73 74 65 70 5f 70 72  blocking_step_pr
44d0: 6f 63 2c 30 2c 30 29 3b 0a 20 20 54 63 6c 5f 43  oc,0,0);.  Tcl_C
44e0: 72 65 61 74 65 4f 62 6a 43 6f 6d 6d 61 6e 64 28  reateObjCommand(
44f0: 69 6e 74 65 72 70 2c 20 0a 20 20 20 20 20 20 22  interp, .      "
4500: 73 71 6c 69 74 65 34 5f 62 6c 6f 63 6b 69 6e 67  sqlite4_blocking
4510: 5f 70 72 65 70 61 72 65 22 2c 20 62 6c 6f 63 6b  _prepare", block
4520: 69 6e 67 5f 70 72 65 70 61 72 65 5f 70 72 6f 63  ing_prepare_proc
4530: 2c 20 28 76 6f 69 64 20 2a 29 31 2c 20 30 29 3b  , (void *)1, 0);
4540: 0a 20 20 54 63 6c 5f 43 72 65 61 74 65 4f 62 6a  .  Tcl_CreateObj
4550: 43 6f 6d 6d 61 6e 64 28 69 6e 74 65 72 70 2c 20  Command(interp, 
4560: 0a 20 20 20 20 20 20 22 73 71 6c 69 74 65 34 5f  .      "sqlite4_
4570: 6e 6f 6e 62 6c 6f 63 6b 69 6e 67 5f 70 72 65 70  nonblocking_prep
4580: 61 72 65 22 2c 20 62 6c 6f 63 6b 69 6e 67 5f 70  are", blocking_p
4590: 72 65 70 61 72 65 5f 70 72 6f 63 2c 20 30 2c 20  repare_proc, 0, 
45a0: 30 29 3b 0a 23 65 6e 64 69 66 0a 20 20 72 65 74  0);.#endif.  ret
45b0: 75 72 6e 20 54 43 4c 5f 4f 4b 3b 0a 7d 0a 23 65  urn TCL_OK;.}.#e
45c0: 6c 73 65 0a 69 6e 74 20 53 71 6c 69 74 65 74 65  lse.int Sqlitete
45d0: 73 74 54 68 72 65 61 64 5f 49 6e 69 74 28 54 63  stThread_Init(Tc
45e0: 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65 72 70  l_Interp *interp
45f0: 29 7b 0a 20 20 72 65 74 75 72 6e 20 54 43 4c 5f  ){.  return TCL_
4600: 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 66 0a           OK;.}.#endif.