/ Hex Artifact Content
Login
SQLite training in Houston TX on 2019-11-05 (details)
Part of the 2019 Tcl Conference

Artifact c05f6c40bd6c8bfe5f1718212f81fd5687f91766:


0000: 2f 2a 0a 2a 2a 20 32 30 30 37 20 41 75 67 75 73  /*.** 2007 Augus
0010: 74 20 31 35 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61  t 15.**.** The a
0020: 75 74 68 6f 72 20 64 69 73 63 6c 61 69 6d 73 20  uthor disclaims 
0030: 63 6f 70 79 72 69 67 68 74 20 74 6f 20 74 68 69  copyright to thi
0040: 73 20 73 6f 75 72 63 65 20 63 6f 64 65 2e 20 20  s source code.  
0050: 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61  In place of.** a
0060: 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68   legal notice, h
0070: 65 72 65 20 69 73 20 61 20 62 6c 65 73 73 69 6e  ere is a blessin
0080: 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20  g:.**.**    May 
0090: 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20  you do good and 
00a0: 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20  not evil..**    
00b0: 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 66 6f 72  May you find for
00c0: 67 69 76 65 6e 65 73 73 20 66 6f 72 20 79 6f 75  giveness for you
00d0: 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 67 69 76  rself and forgiv
00e0: 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20  e others..**    
00f0: 4d 61 79 20 79 6f 75 20 73 68 61 72 65 20 66 72  May you share fr
0100: 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 61 6b 69  eely, never taki
0110: 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75  ng more than you
0120: 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a   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 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66  ***.**.** This f
0180: 69 6c 65 20 63 6f 6e 74 61 69 6e 73 20 63 6f 64  ile contains cod
0190: 65 20 75 73 65 64 20 74 6f 20 69 6d 70 6c 65 6d  e used to implem
01a0: 65 6e 74 20 74 65 73 74 20 69 6e 74 65 72 66 61  ent test interfa
01b0: 63 65 73 20 74 6f 20 74 68 65 0a 2a 2a 20 6d 65  ces to the.** me
01c0: 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20  mory allocation 
01d0: 73 75 62 73 79 73 74 65 6d 2e 0a 2a 2f 0a 23 69  subsystem..*/.#i
01e0: 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 49 6e  nclude "sqliteIn
01f0: 74 2e 68 22 0a 23 69 66 20 64 65 66 69 6e 65 64  t.h".#if defined
0200: 28 49 4e 43 4c 55 44 45 5f 53 51 4c 49 54 45 5f  (INCLUDE_SQLITE_
0210: 54 43 4c 5f 48 29 0a 23 20 20 69 6e 63 6c 75 64  TCL_H).#  includ
0220: 65 20 22 73 71 6c 69 74 65 5f 74 63 6c 2e 68 22  e "sqlite_tcl.h"
0230: 0a 23 65 6c 73 65 0a 23 20 20 69 6e 63 6c 75 64  .#else.#  includ
0240: 65 20 22 74 63 6c 2e 68 22 0a 23 65 6e 64 69 66  e "tcl.h".#endif
0250: 0a 23 69 6e 63 6c 75 64 65 20 3c 73 74 64 6c 69  .#include <stdli
0260: 62 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 20 3c 73  b.h>.#include <s
0270: 74 72 69 6e 67 2e 68 3e 0a 23 69 6e 63 6c 75 64  tring.h>.#includ
0280: 65 20 3c 61 73 73 65 72 74 2e 68 3e 0a 0a 2f 2a  e <assert.h>../*
0290: 0a 2a 2a 20 54 68 69 73 20 73 74 72 75 63 74 75  .** This structu
02a0: 72 65 20 69 73 20 75 73 65 64 20 74 6f 20 65 6e  re is used to en
02b0: 63 61 70 73 75 6c 61 74 65 20 74 68 65 20 67 6c  capsulate the gl
02c0: 6f 62 61 6c 20 73 74 61 74 65 20 76 61 72 69 61  obal state varia
02d0: 62 6c 65 73 20 75 73 65 64 20 0a 2a 2a 20 62 79  bles used .** by
02e0: 20 6d 61 6c 6c 6f 63 28 29 20 66 61 75 6c 74 20   malloc() fault 
02f0: 73 69 6d 75 6c 61 74 69 6f 6e 2e 0a 2a 2f 0a 73  simulation..*/.s
0300: 74 61 74 69 63 20 73 74 72 75 63 74 20 4d 65 6d  tatic struct Mem
0310: 46 61 75 6c 74 20 7b 0a 20 20 69 6e 74 20 69 43  Fault {.  int iC
0320: 6f 75 6e 74 64 6f 77 6e 3b 20 20 20 20 20 20 20  ountdown;       
0330: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70    /* Number of p
0340: 65 6e 64 69 6e 67 20 73 75 63 63 65 73 73 65 73  ending successes
0350: 20 62 65 66 6f 72 65 20 61 20 66 61 69 6c 75 72   before a failur
0360: 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 70 65  e */.  int nRepe
0370: 61 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f  at;            /
0380: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 69 6d 65  * Number of time
0390: 73 20 74 6f 20 72 65 70 65 61 74 20 74 68 65 20  s to repeat the 
03a0: 66 61 69 6c 75 72 65 20 2a 2f 0a 20 20 69 6e 74  failure */.  int
03b0: 20 6e 42 65 6e 69 67 6e 3b 20 20 20 20 20 20 20   nBenign;       
03c0: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f       /* Number o
03d0: 66 20 62 65 6e 69 67 6e 20 66 61 69 6c 75 72 65  f benign failure
03e0: 73 20 73 65 65 6e 20 73 69 6e 63 65 20 6c 61 73  s seen since las
03f0: 74 20 63 6f 6e 66 69 67 20 2a 2f 0a 20 20 69 6e  t config */.  in
0400: 74 20 6e 46 61 69 6c 3b 20 20 20 20 20 20 20 20  t nFail;        
0410: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20        /* Number 
0420: 6f 66 20 66 61 69 6c 75 72 65 73 20 73 65 65 6e  of failures seen
0430: 20 73 69 6e 63 65 20 6c 61 73 74 20 63 6f 6e 66   since last conf
0440: 69 67 20 2a 2f 0a 20 20 75 38 20 65 6e 61 62 6c  ig */.  u8 enabl
0450: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  e;              
0460: 2f 2a 20 54 72 75 65 20 69 66 20 65 6e 61 62 6c  /* True if enabl
0470: 65 64 20 2a 2f 0a 20 20 69 6e 74 20 69 73 49 6e  ed */.  int isIn
0480: 73 74 61 6c 6c 65 64 3b 20 20 20 20 20 20 20 20  stalled;        
0490: 2f 2a 20 54 72 75 65 20 69 66 20 74 68 65 20 66  /* True if the f
04a0: 61 75 6c 74 20 73 69 6d 75 6c 61 74 69 6f 6e 20  ault simulation 
04b0: 6c 61 79 65 72 20 69 73 20 69 6e 73 74 61 6c 6c  layer is install
04c0: 65 64 20 2a 2f 0a 20 20 69 6e 74 20 69 73 42 65  ed */.  int isBe
04d0: 6e 69 67 6e 4d 6f 64 65 3b 20 20 20 20 20 20 20  nignMode;       
04e0: 2f 2a 20 54 72 75 65 20 69 66 20 6d 61 6c 6c 6f  /* True if mallo
04f0: 63 20 66 61 69 6c 75 72 65 73 20 61 72 65 20 63  c failures are c
0500: 6f 6e 73 69 64 65 72 65 64 20 62 65 6e 69 67 6e  onsidered benign
0510: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6d 65   */.  sqlite3_me
0520: 6d 5f 6d 65 74 68 6f 64 73 20 6d 3b 20 20 2f 2a  m_methods m;  /*
0530: 20 27 52 65 61 6c 27 20 6d 61 6c 6c 6f 63 20 69   'Real' malloc i
0540: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 2a 2f  mplementation */
0550: 0a 7d 20 6d 65 6d 66 61 75 6c 74 3b 0a 0a 2f 2a  .} memfault;../*
0560: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
0570: 20 65 78 69 73 74 73 20 61 73 20 61 20 70 6c 61   exists as a pla
0580: 63 65 20 74 6f 20 73 65 74 20 61 20 62 72 65 61  ce to set a brea
0590: 6b 70 6f 69 6e 74 20 74 68 61 74 20 77 69 6c 6c  kpoint that will
05a0: 0a 2a 2a 20 66 69 72 65 20 6f 6e 20 61 6e 79 20  .** fire on any 
05b0: 73 69 6d 75 6c 61 74 65 64 20 6d 61 6c 6c 6f 63  simulated malloc
05c0: 28 29 20 66 61 69 6c 75 72 65 2e 0a 2a 2f 0a 73  () failure..*/.s
05d0: 74 61 74 69 63 20 76 6f 69 64 20 73 71 6c 69 74  tatic void sqlit
05e0: 65 33 46 61 75 6c 74 28 76 6f 69 64 29 7b 0a 20  e3Fault(void){. 
05f0: 20 73 74 61 74 69 63 20 69 6e 74 20 63 6e 74 20   static int cnt 
0600: 3d 20 30 3b 0a 20 20 63 6e 74 2b 2b 3b 0a 7d 0a  = 0;.  cnt++;.}.
0610: 0a 2f 2a 0a 2a 2a 20 43 68 65 63 6b 20 74 6f 20  ./*.** Check to 
0620: 73 65 65 20 69 66 20 61 20 66 61 75 6c 74 20 73  see if a fault s
0630: 68 6f 75 6c 64 20 62 65 20 73 69 6d 75 6c 61 74  hould be simulat
0640: 65 64 2e 20 20 52 65 74 75 72 6e 20 74 72 75 65  ed.  Return true
0650: 20 74 6f 20 73 69 6d 75 6c 61 74 65 0a 2a 2a 20   to simulate.** 
0660: 74 68 65 20 66 61 75 6c 74 2e 20 20 52 65 74 75  the fault.  Retu
0670: 72 6e 20 66 61 6c 73 65 20 69 66 20 74 68 65 20  rn false if the 
0680: 66 61 75 6c 74 20 73 68 6f 75 6c 64 20 6e 6f 74  fault should not
0690: 20 62 65 20 73 69 6d 75 6c 61 74 65 64 2e 0a 2a   be simulated..*
06a0: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 66 61 75  /.static int fau
06b0: 6c 74 73 69 6d 53 74 65 70 28 76 6f 69 64 29 7b  ltsimStep(void){
06c0: 0a 20 20 69 66 28 20 6c 69 6b 65 6c 79 28 21 6d  .  if( likely(!m
06d0: 65 6d 66 61 75 6c 74 2e 65 6e 61 62 6c 65 29 20  emfault.enable) 
06e0: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b  ){.    return 0;
06f0: 0a 20 20 7d 0a 20 20 69 66 28 20 6d 65 6d 66 61  .  }.  if( memfa
0700: 75 6c 74 2e 69 43 6f 75 6e 74 64 6f 77 6e 3e 30  ult.iCountdown>0
0710: 20 29 7b 0a 20 20 20 20 6d 65 6d 66 61 75 6c 74   ){.    memfault
0720: 2e 69 43 6f 75 6e 74 64 6f 77 6e 2d 2d 3b 0a 20  .iCountdown--;. 
0730: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d     return 0;.  }
0740: 0a 20 20 73 71 6c 69 74 65 33 46 61 75 6c 74 28  .  sqlite3Fault(
0750: 29 3b 0a 20 20 6d 65 6d 66 61 75 6c 74 2e 6e 46  );.  memfault.nF
0760: 61 69 6c 2b 2b 3b 0a 20 20 69 66 28 20 6d 65 6d  ail++;.  if( mem
0770: 66 61 75 6c 74 2e 69 73 42 65 6e 69 67 6e 4d 6f  fault.isBenignMo
0780: 64 65 3e 30 20 29 7b 0a 20 20 20 20 6d 65 6d 66  de>0 ){.    memf
0790: 61 75 6c 74 2e 6e 42 65 6e 69 67 6e 2b 2b 3b 0a  ault.nBenign++;.
07a0: 20 20 7d 0a 20 20 6d 65 6d 66 61 75 6c 74 2e 6e    }.  memfault.n
07b0: 52 65 70 65 61 74 2d 2d 3b 0a 20 20 69 66 28 20  Repeat--;.  if( 
07c0: 6d 65 6d 66 61 75 6c 74 2e 6e 52 65 70 65 61 74  memfault.nRepeat
07d0: 3c 3d 30 20 29 7b 0a 20 20 20 20 6d 65 6d 66 61  <=0 ){.    memfa
07e0: 75 6c 74 2e 65 6e 61 62 6c 65 20 3d 20 30 3b 0a  ult.enable = 0;.
07f0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 31 3b 20    }.  return 1; 
0800: 20 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 20 76 65 72   .}../*.** A ver
0810: 73 69 6f 6e 20 6f 66 20 73 71 6c 69 74 65 33 5f  sion of sqlite3_
0820: 6d 65 6d 5f 6d 65 74 68 6f 64 73 2e 78 4d 61 6c  mem_methods.xMal
0830: 6c 6f 63 28 29 20 74 68 61 74 20 69 6e 63 6c 75  loc() that inclu
0840: 64 65 73 20 66 61 75 6c 74 20 73 69 6d 75 6c 61  des fault simula
0850: 74 69 6f 6e 0a 2a 2a 20 6c 6f 67 69 63 2e 0a 2a  tion.** logic..*
0860: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 2a 66  /.static void *f
0870: 61 75 6c 74 73 69 6d 4d 61 6c 6c 6f 63 28 69 6e  aultsimMalloc(in
0880: 74 20 6e 29 7b 0a 20 20 76 6f 69 64 20 2a 70 20  t n){.  void *p 
0890: 3d 20 30 3b 0a 20 20 69 66 28 20 21 66 61 75 6c  = 0;.  if( !faul
08a0: 74 73 69 6d 53 74 65 70 28 29 20 29 7b 0a 20 20  tsimStep() ){.  
08b0: 20 20 70 20 3d 20 6d 65 6d 66 61 75 6c 74 2e 6d    p = memfault.m
08c0: 2e 78 4d 61 6c 6c 6f 63 28 6e 29 3b 0a 20 20 7d  .xMalloc(n);.  }
08d0: 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a  .  return p;.}..
08e0: 0a 2f 2a 0a 2a 2a 20 41 20 76 65 72 73 69 6f 6e  ./*.** A version
08f0: 20 6f 66 20 73 71 6c 69 74 65 33 5f 6d 65 6d 5f   of sqlite3_mem_
0900: 6d 65 74 68 6f 64 73 2e 78 52 65 61 6c 6c 6f 63  methods.xRealloc
0910: 28 29 20 74 68 61 74 20 69 6e 63 6c 75 64 65 73  () that includes
0920: 20 66 61 75 6c 74 20 73 69 6d 75 6c 61 74 69 6f   fault simulatio
0930: 6e 0a 2a 2a 20 6c 6f 67 69 63 2e 0a 2a 2f 0a 73  n.** logic..*/.s
0940: 74 61 74 69 63 20 76 6f 69 64 20 2a 66 61 75 6c  tatic void *faul
0950: 74 73 69 6d 52 65 61 6c 6c 6f 63 28 76 6f 69 64  tsimRealloc(void
0960: 20 2a 70 4f 6c 64 2c 20 69 6e 74 20 6e 29 7b 0a   *pOld, int n){.
0970: 20 20 76 6f 69 64 20 2a 70 20 3d 20 30 3b 0a 20    void *p = 0;. 
0980: 20 69 66 28 20 21 66 61 75 6c 74 73 69 6d 53 74   if( !faultsimSt
0990: 65 70 28 29 20 29 7b 0a 20 20 20 20 70 20 3d 20  ep() ){.    p = 
09a0: 6d 65 6d 66 61 75 6c 74 2e 6d 2e 78 52 65 61 6c  memfault.m.xReal
09b0: 6c 6f 63 28 70 4f 6c 64 2c 20 6e 29 3b 0a 20 20  loc(pOld, n);.  
09c0: 7d 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a  }.  return p;.}.
09d0: 0a 2f 2a 20 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c  ./* .** The foll
09e0: 6f 77 69 6e 67 20 6d 65 74 68 6f 64 20 63 61 6c  owing method cal
09f0: 6c 73 20 61 72 65 20 70 61 73 73 65 64 20 64 69  ls are passed di
0a00: 72 65 63 74 6c 79 20 74 68 72 6f 75 67 68 20 74  rectly through t
0a10: 6f 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67  o the underlying
0a20: 0a 2a 2a 20 6d 61 6c 6c 6f 63 20 73 79 73 74 65  .** malloc syste
0a30: 6d 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 78 46 72  m:.**.**     xFr
0a40: 65 65 0a 2a 2a 20 20 20 20 20 78 53 69 7a 65 0a  ee.**     xSize.
0a50: 2a 2a 20 20 20 20 20 78 52 6f 75 6e 64 75 70 0a  **     xRoundup.
0a60: 2a 2a 20 20 20 20 20 78 49 6e 69 74 0a 2a 2a 20  **     xInit.** 
0a70: 20 20 20 20 78 53 68 75 74 64 6f 77 6e 0a 2a 2f      xShutdown.*/
0a80: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 66 61 75  .static void fau
0a90: 6c 74 73 69 6d 46 72 65 65 28 76 6f 69 64 20 2a  ltsimFree(void *
0aa0: 70 29 7b 0a 20 20 6d 65 6d 66 61 75 6c 74 2e 6d  p){.  memfault.m
0ab0: 2e 78 46 72 65 65 28 70 29 3b 0a 7d 0a 73 74 61  .xFree(p);.}.sta
0ac0: 74 69 63 20 69 6e 74 20 66 61 75 6c 74 73 69 6d  tic int faultsim
0ad0: 53 69 7a 65 28 76 6f 69 64 20 2a 70 29 7b 0a 20  Size(void *p){. 
0ae0: 20 72 65 74 75 72 6e 20 6d 65 6d 66 61 75 6c 74   return memfault
0af0: 2e 6d 2e 78 53 69 7a 65 28 70 29 3b 0a 7d 0a 73  .m.xSize(p);.}.s
0b00: 74 61 74 69 63 20 69 6e 74 20 66 61 75 6c 74 73  tatic int faults
0b10: 69 6d 52 6f 75 6e 64 75 70 28 69 6e 74 20 6e 29  imRoundup(int n)
0b20: 7b 0a 20 20 72 65 74 75 72 6e 20 6d 65 6d 66 61  {.  return memfa
0b30: 75 6c 74 2e 6d 2e 78 52 6f 75 6e 64 75 70 28 6e  ult.m.xRoundup(n
0b40: 29 3b 0a 7d 0a 73 74 61 74 69 63 20 69 6e 74 20  );.}.static int 
0b50: 66 61 75 6c 74 73 69 6d 49 6e 69 74 28 76 6f 69  faultsimInit(voi
0b60: 64 20 2a 70 29 7b 0a 20 20 72 65 74 75 72 6e 20  d *p){.  return 
0b70: 6d 65 6d 66 61 75 6c 74 2e 6d 2e 78 49 6e 69 74  memfault.m.xInit
0b80: 28 6d 65 6d 66 61 75 6c 74 2e 6d 2e 70 41 70 70  (memfault.m.pApp
0b90: 44 61 74 61 29 3b 0a 7d 0a 73 74 61 74 69 63 20  Data);.}.static 
0ba0: 76 6f 69 64 20 66 61 75 6c 74 73 69 6d 53 68 75  void faultsimShu
0bb0: 74 64 6f 77 6e 28 76 6f 69 64 20 2a 70 29 7b 0a  tdown(void *p){.
0bc0: 20 20 6d 65 6d 66 61 75 6c 74 2e 6d 2e 78 53 68    memfault.m.xSh
0bd0: 75 74 64 6f 77 6e 28 6d 65 6d 66 61 75 6c 74 2e  utdown(memfault.
0be0: 6d 2e 70 41 70 70 44 61 74 61 29 3b 0a 7d 0a 0a  m.pAppData);.}..
0bf0: 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69  /*.** This routi
0c00: 6e 65 20 63 6f 6e 66 69 67 75 72 65 73 20 74 68  ne configures th
0c10: 65 20 6d 61 6c 6c 6f 63 20 66 61 69 6c 75 72 65  e malloc failure
0c20: 20 73 69 6d 75 6c 61 74 69 6f 6e 2e 20 20 41 66   simulation.  Af
0c30: 74 65 72 0a 2a 2a 20 63 61 6c 6c 69 6e 67 20 74  ter.** calling t
0c40: 68 69 73 20 72 6f 75 74 69 6e 65 2c 20 74 68 65  his routine, the
0c50: 20 6e 65 78 74 20 6e 44 65 6c 61 79 20 6d 61 6c   next nDelay mal
0c60: 6c 6f 63 73 20 77 69 6c 6c 20 73 75 63 63 65 65  locs will succee
0c70: 64 2c 20 66 6f 6c 6c 6f 77 65 64 0a 2a 2a 20 62  d, followed.** b
0c80: 79 20 61 20 62 6c 6f 63 6b 20 6f 66 20 6e 52 65  y a block of nRe
0c90: 70 65 61 74 20 66 61 69 6c 75 72 65 73 2c 20 61  peat failures, a
0ca0: 66 74 65 72 20 77 68 69 63 68 20 6d 61 6c 6c 6f  fter which mallo
0cb0: 63 28 29 20 63 61 6c 6c 73 20 77 69 6c 6c 20 62  c() calls will b
0cc0: 65 67 69 6e 0a 2a 2a 20 74 6f 20 73 75 63 63 65  egin.** to succe
0cd0: 65 64 20 61 67 61 69 6e 2e 0a 2a 2f 0a 73 74 61  ed again..*/.sta
0ce0: 74 69 63 20 76 6f 69 64 20 66 61 75 6c 74 73 69  tic void faultsi
0cf0: 6d 43 6f 6e 66 69 67 28 69 6e 74 20 6e 44 65 6c  mConfig(int nDel
0d00: 61 79 2c 20 69 6e 74 20 6e 52 65 70 65 61 74 29  ay, int nRepeat)
0d10: 7b 0a 20 20 6d 65 6d 66 61 75 6c 74 2e 69 43 6f  {.  memfault.iCo
0d20: 75 6e 74 64 6f 77 6e 20 3d 20 6e 44 65 6c 61 79  untdown = nDelay
0d30: 3b 0a 20 20 6d 65 6d 66 61 75 6c 74 2e 6e 52 65  ;.  memfault.nRe
0d40: 70 65 61 74 20 3d 20 6e 52 65 70 65 61 74 3b 0a  peat = nRepeat;.
0d50: 20 20 6d 65 6d 66 61 75 6c 74 2e 6e 42 65 6e 69    memfault.nBeni
0d60: 67 6e 20 3d 20 30 3b 0a 20 20 6d 65 6d 66 61 75  gn = 0;.  memfau
0d70: 6c 74 2e 6e 46 61 69 6c 20 3d 20 30 3b 0a 20 20  lt.nFail = 0;.  
0d80: 6d 65 6d 66 61 75 6c 74 2e 65 6e 61 62 6c 65 20  memfault.enable 
0d90: 3d 20 6e 44 65 6c 61 79 3e 3d 30 3b 0a 0a 20 20  = nDelay>=0;..  
0da0: 2f 2a 20 53 6f 6d 65 74 69 6d 65 73 2c 20 77 68  /* Sometimes, wh
0db0: 65 6e 20 72 75 6e 6e 69 6e 67 20 6d 75 6c 74 69  en running multi
0dc0: 2d 74 68 72 65 61 64 65 64 20 74 65 73 74 73 2c  -threaded tests,
0dd0: 20 74 68 65 20 69 73 42 65 6e 69 67 6e 4d 6f 64   the isBenignMod
0de0: 65 20 0a 20 20 2a 2a 20 76 61 72 69 61 62 6c 65  e .  ** variable
0df0: 20 69 73 20 6e 6f 74 20 70 72 6f 70 65 72 6c 79   is not properly
0e00: 20 69 6e 63 72 65 6d 65 6e 74 65 64 2f 64 65 63   incremented/dec
0e10: 72 65 6d 65 6e 74 65 64 20 73 6f 20 74 68 61 74  remented so that
0e20: 20 69 74 20 69 73 0a 20 20 2a 2a 20 30 20 77 68   it is.  ** 0 wh
0e30: 65 6e 20 6e 6f 74 20 69 6e 73 69 64 65 20 61 20  en not inside a 
0e40: 62 65 6e 69 67 6e 20 6d 61 6c 6c 6f 63 20 62 6c  benign malloc bl
0e50: 6f 63 6b 2e 20 54 68 69 73 20 64 6f 65 73 6e 27  ock. This doesn'
0e60: 74 20 61 66 66 65 63 74 0a 20 20 2a 2a 20 74 68  t affect.  ** th
0e70: 65 20 6d 75 6c 74 69 2d 74 68 72 65 61 64 65 64  e multi-threaded
0e80: 20 74 65 73 74 73 2c 20 61 73 20 74 68 65 79 20   tests, as they 
0e90: 64 6f 20 6e 6f 74 20 75 73 65 20 74 68 69 73 20  do not use this 
0ea0: 73 79 73 74 65 6d 2e 20 42 75 74 0a 20 20 2a 2a  system. But.  **
0eb0: 20 69 74 20 64 6f 65 73 20 61 66 66 65 63 74 20   it does affect 
0ec0: 4f 4f 4d 20 74 65 73 74 73 20 72 75 6e 20 6c 61  OOM tests run la
0ed0: 74 65 72 20 69 6e 20 74 68 65 20 73 61 6d 65 20  ter in the same 
0ee0: 70 72 6f 63 65 73 73 2e 20 53 6f 0a 20 20 2a 2a  process. So.  **
0ef0: 20 7a 65 72 6f 20 74 68 65 20 76 61 72 69 61 62   zero the variab
0f00: 6c 65 20 68 65 72 65 2c 20 6a 75 73 74 20 74 6f  le here, just to
0f10: 20 62 65 20 73 75 72 65 2e 0a 20 20 2a 2f 0a 20   be sure..  */. 
0f20: 20 6d 65 6d 66 61 75 6c 74 2e 69 73 42 65 6e 69   memfault.isBeni
0f30: 67 6e 4d 6f 64 65 20 3d 20 30 3b 0a 7d 0a 0a 2f  gnMode = 0;.}../
0f40: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
0f50: 6e 75 6d 62 65 72 20 6f 66 20 66 61 75 6c 74 73  number of faults
0f60: 20 28 62 6f 74 68 20 68 61 72 64 20 61 6e 64 20   (both hard and 
0f70: 62 65 6e 69 67 6e 20 66 61 75 6c 74 73 29 20 74  benign faults) t
0f80: 68 61 74 20 68 61 76 65 0a 2a 2a 20 6f 63 63 75  hat have.** occu
0f90: 72 72 65 64 20 73 69 6e 63 65 20 74 68 65 20 69  rred since the i
0fa0: 6e 6a 65 63 74 6f 72 20 77 61 73 20 6c 61 73 74  njector was last
0fb0: 20 63 6f 6e 66 69 67 75 72 65 64 2e 0a 2a 2f 0a   configured..*/.
0fc0: 73 74 61 74 69 63 20 69 6e 74 20 66 61 75 6c 74  static int fault
0fd0: 73 69 6d 46 61 69 6c 75 72 65 73 28 76 6f 69 64  simFailures(void
0fe0: 29 7b 0a 20 20 72 65 74 75 72 6e 20 6d 65 6d 66  ){.  return memf
0ff0: 61 75 6c 74 2e 6e 46 61 69 6c 3b 0a 7d 0a 0a 2f  ault.nFail;.}../
1000: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
1010: 6e 75 6d 62 65 72 20 6f 66 20 62 65 6e 69 67 6e  number of benign
1020: 20 66 61 75 6c 74 73 20 74 68 61 74 20 68 61 76   faults that hav
1030: 65 20 6f 63 63 75 72 72 65 64 20 73 69 6e 63 65  e occurred since
1040: 20 74 68 65 0a 2a 2a 20 69 6e 6a 65 63 74 6f 72   the.** injector
1050: 20 77 61 73 20 6c 61 73 74 20 63 6f 6e 66 69 67   was last config
1060: 75 72 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  ured..*/.static 
1070: 69 6e 74 20 66 61 75 6c 74 73 69 6d 42 65 6e 69  int faultsimBeni
1080: 67 6e 46 61 69 6c 75 72 65 73 28 76 6f 69 64 29  gnFailures(void)
1090: 7b 0a 20 20 72 65 74 75 72 6e 20 6d 65 6d 66 61  {.  return memfa
10a0: 75 6c 74 2e 6e 42 65 6e 69 67 6e 3b 0a 7d 0a 0a  ult.nBenign;.}..
10b0: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65  /*.** Return the
10c0: 20 6e 75 6d 62 65 72 20 6f 66 20 73 75 63 63 65   number of succe
10d0: 73 73 65 73 20 74 68 61 74 20 77 69 6c 6c 20 6f  sses that will o
10e0: 63 63 75 72 20 62 65 66 6f 72 65 20 74 68 65 20  ccur before the 
10f0: 6e 65 78 74 20 66 61 69 6c 75 72 65 2e 0a 2a 2a  next failure..**
1100: 20 49 66 20 6e 6f 20 66 61 69 6c 75 72 65 73 20   If no failures 
1110: 61 72 65 20 73 63 68 65 64 75 6c 65 64 2c 20 72  are scheduled, r
1120: 65 74 75 72 6e 20 2d 31 2e 0a 2a 2f 0a 73 74 61  eturn -1..*/.sta
1130: 74 69 63 20 69 6e 74 20 66 61 75 6c 74 73 69 6d  tic int faultsim
1140: 50 65 6e 64 69 6e 67 28 76 6f 69 64 29 7b 0a 20  Pending(void){. 
1150: 20 69 66 28 20 6d 65 6d 66 61 75 6c 74 2e 65 6e   if( memfault.en
1160: 61 62 6c 65 20 29 7b 0a 20 20 20 20 72 65 74 75  able ){.    retu
1170: 72 6e 20 6d 65 6d 66 61 75 6c 74 2e 69 43 6f 75  rn memfault.iCou
1180: 6e 74 64 6f 77 6e 3b 0a 20 20 7d 65 6c 73 65 7b  ntdown;.  }else{
1190: 0a 20 20 20 20 72 65 74 75 72 6e 20 2d 31 3b 0a  .    return -1;.
11a0: 20 20 7d 0a 7d 0a 0a 0a 73 74 61 74 69 63 20 76    }.}...static v
11b0: 6f 69 64 20 66 61 75 6c 74 73 69 6d 42 65 67 69  oid faultsimBegi
11c0: 6e 42 65 6e 69 67 6e 28 76 6f 69 64 29 7b 0a 20  nBenign(void){. 
11d0: 20 6d 65 6d 66 61 75 6c 74 2e 69 73 42 65 6e 69   memfault.isBeni
11e0: 67 6e 4d 6f 64 65 2b 2b 3b 0a 7d 0a 73 74 61 74  gnMode++;.}.stat
11f0: 69 63 20 76 6f 69 64 20 66 61 75 6c 74 73 69 6d  ic void faultsim
1200: 45 6e 64 42 65 6e 69 67 6e 28 76 6f 69 64 29 7b  EndBenign(void){
1210: 0a 20 20 6d 65 6d 66 61 75 6c 74 2e 69 73 42 65  .  memfault.isBe
1220: 6e 69 67 6e 4d 6f 64 65 2d 2d 3b 0a 7d 0a 0a 2f  nignMode--;.}../
1230: 2a 0a 2a 2a 20 41 64 64 20 6f 72 20 72 65 6d 6f  *.** Add or remo
1240: 76 65 20 74 68 65 20 66 61 75 6c 74 2d 73 69 6d  ve the fault-sim
1250: 75 6c 61 74 69 6f 6e 20 6c 61 79 65 72 20 75 73  ulation layer us
1260: 69 6e 67 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66  ing sqlite3_conf
1270: 69 67 28 29 2e 20 49 66 0a 2a 2a 20 74 68 65 20  ig(). If.** the 
1280: 61 72 67 75 6d 65 6e 74 20 69 73 20 6e 6f 6e 2d  argument is non-
1290: 7a 65 72 6f 2c 20 74 68 65 20 0a 2a 2f 0a 73 74  zero, the .*/.st
12a0: 61 74 69 63 20 69 6e 74 20 66 61 75 6c 74 73 69  atic int faultsi
12b0: 6d 49 6e 73 74 61 6c 6c 28 69 6e 74 20 69 6e 73  mInstall(int ins
12c0: 74 61 6c 6c 29 7b 0a 20 20 73 74 61 74 69 63 20  tall){.  static 
12d0: 73 74 72 75 63 74 20 73 71 6c 69 74 65 33 5f 6d  struct sqlite3_m
12e0: 65 6d 5f 6d 65 74 68 6f 64 73 20 6d 20 3d 20 7b  em_methods m = {
12f0: 0a 20 20 20 20 66 61 75 6c 74 73 69 6d 4d 61 6c  .    faultsimMal
1300: 6c 6f 63 2c 20 20 20 20 20 20 20 20 20 20 20 20  loc,            
1310: 20 20 20 20 20 20 20 2f 2a 20 78 4d 61 6c 6c 6f         /* xMallo
1320: 63 20 2a 2f 0a 20 20 20 20 66 61 75 6c 74 73 69  c */.    faultsi
1330: 6d 46 72 65 65 2c 20 20 20 20 20 20 20 20 20 20  mFree,          
1340: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 46             /* xF
1350: 72 65 65 20 2a 2f 0a 20 20 20 20 66 61 75 6c 74  ree */.    fault
1360: 73 69 6d 52 65 61 6c 6c 6f 63 2c 20 20 20 20 20  simRealloc,     
1370: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1380: 78 52 65 61 6c 6c 6f 63 20 2a 2f 0a 20 20 20 20  xRealloc */.    
1390: 66 61 75 6c 74 73 69 6d 53 69 7a 65 2c 20 20 20  faultsimSize,   
13a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
13b0: 20 20 2f 2a 20 78 53 69 7a 65 20 2a 2f 0a 20 20    /* xSize */.  
13c0: 20 20 66 61 75 6c 74 73 69 6d 52 6f 75 6e 64 75    faultsimRoundu
13d0: 70 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  p,              
13e0: 20 20 20 20 2f 2a 20 78 52 6f 75 6e 64 75 70 20      /* xRoundup 
13f0: 2a 2f 0a 20 20 20 20 66 61 75 6c 74 73 69 6d 49  */.    faultsimI
1400: 6e 69 74 2c 20 20 20 20 20 20 20 20 20 20 20 20  nit,            
1410: 20 20 20 20 20 20 20 20 20 2f 2a 20 78 49 6e 69           /* xIni
1420: 74 20 2a 2f 0a 20 20 20 20 66 61 75 6c 74 73 69  t */.    faultsi
1430: 6d 53 68 75 74 64 6f 77 6e 2c 20 20 20 20 20 20  mShutdown,      
1440: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 53             /* xS
1450: 68 75 74 64 6f 77 6e 20 2a 2f 0a 20 20 20 20 30  hutdown */.    0
1460: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1470: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1480: 20 2f 2a 20 70 41 70 70 44 61 74 61 20 2a 2f 0a   /* pAppData */.
1490: 20 20 7d 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a    };.  int rc;..
14a0: 20 20 69 6e 73 74 61 6c 6c 20 3d 20 28 69 6e 73    install = (ins
14b0: 74 61 6c 6c 20 3f 20 31 20 3a 20 30 29 3b 0a 20  tall ? 1 : 0);. 
14c0: 20 61 73 73 65 72 74 28 6d 65 6d 66 61 75 6c 74   assert(memfault
14d0: 2e 69 73 49 6e 73 74 61 6c 6c 65 64 3d 3d 31 20  .isInstalled==1 
14e0: 7c 7c 20 6d 65 6d 66 61 75 6c 74 2e 69 73 49 6e  || memfault.isIn
14f0: 73 74 61 6c 6c 65 64 3d 3d 30 29 3b 0a 0a 20 20  stalled==0);..  
1500: 69 66 28 20 69 6e 73 74 61 6c 6c 3d 3d 6d 65 6d  if( install==mem
1510: 66 61 75 6c 74 2e 69 73 49 6e 73 74 61 6c 6c 65  fault.isInstalle
1520: 64 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  d ){.    return 
1530: 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20  SQLITE_ERROR;.  
1540: 7d 0a 0a 20 20 69 66 28 20 69 6e 73 74 61 6c 6c  }..  if( install
1550: 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c   ){.    rc = sql
1560: 69 74 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49  ite3_config(SQLI
1570: 54 45 5f 43 4f 4e 46 49 47 5f 47 45 54 4d 41 4c  TE_CONFIG_GETMAL
1580: 4c 4f 43 2c 20 26 6d 65 6d 66 61 75 6c 74 2e 6d  LOC, &memfault.m
1590: 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 6d 65  );.    assert(me
15a0: 6d 66 61 75 6c 74 2e 6d 2e 78 4d 61 6c 6c 6f 63  mfault.m.xMalloc
15b0: 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53  );.    if( rc==S
15c0: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
15d0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 63    rc = sqlite3_c
15e0: 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e  onfig(SQLITE_CON
15f0: 46 49 47 5f 4d 41 4c 4c 4f 43 2c 20 26 6d 29 3b  FIG_MALLOC, &m);
1600: 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74  .    }.    sqlit
1610: 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28  e3_test_control(
1620: 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f  SQLITE_TESTCTRL_
1630: 42 45 4e 49 47 4e 5f 4d 41 4c 4c 4f 43 5f 48 4f  BENIGN_MALLOC_HO
1640: 4f 4b 53 2c 20 0a 20 20 20 20 20 20 20 20 66 61  OKS, .        fa
1650: 75 6c 74 73 69 6d 42 65 67 69 6e 42 65 6e 69 67  ultsimBeginBenig
1660: 6e 2c 20 66 61 75 6c 74 73 69 6d 45 6e 64 42 65  n, faultsimEndBe
1670: 6e 69 67 6e 0a 20 20 20 20 29 3b 0a 20 20 7d 65  nign.    );.  }e
1680: 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  lse{.    sqlite3
1690: 5f 6d 65 6d 5f 6d 65 74 68 6f 64 73 20 6d 32 3b  _mem_methods m2;
16a0: 0a 20 20 20 20 61 73 73 65 72 74 28 6d 65 6d 66  .    assert(memf
16b0: 61 75 6c 74 2e 6d 2e 78 4d 61 6c 6c 6f 63 29 3b  ault.m.xMalloc);
16c0: 0a 0a 20 20 20 20 2f 2a 20 4f 6e 65 20 73 68 6f  ..    /* One sho
16d0: 75 6c 64 20 62 65 20 61 62 6c 65 20 74 6f 20 72  uld be able to r
16e0: 65 73 65 74 20 74 68 65 20 64 65 66 61 75 6c 74  eset the default
16f0: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f   memory allocato
1700: 72 20 62 79 20 73 74 6f 72 69 6e 67 0a 20 20 20  r by storing.   
1710: 20 2a 2a 20 61 20 7a 65 72 6f 65 64 20 61 6c 6c   ** a zeroed all
1720: 6f 63 61 74 6f 72 20 74 68 65 6e 20 63 61 6c 6c  ocator then call
1730: 69 6e 67 20 47 45 54 4d 41 4c 4c 4f 43 2e 20 2a  ing GETMALLOC. *
1740: 2f 0a 20 20 20 20 6d 65 6d 73 65 74 28 26 6d 32  /.    memset(&m2
1750: 2c 20 30 2c 20 73 69 7a 65 6f 66 28 6d 32 29 29  , 0, sizeof(m2))
1760: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f  ;.    sqlite3_co
1770: 6e 66 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46  nfig(SQLITE_CONF
1780: 49 47 5f 4d 41 4c 4c 4f 43 2c 20 26 6d 32 29 3b  IG_MALLOC, &m2);
1790: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e  .    sqlite3_con
17a0: 66 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49  fig(SQLITE_CONFI
17b0: 47 5f 47 45 54 4d 41 4c 4c 4f 43 2c 20 26 6d 32  G_GETMALLOC, &m2
17c0: 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 6d  );.    assert( m
17d0: 65 6d 63 6d 70 28 26 6d 32 2c 20 26 6d 65 6d 66  emcmp(&m2, &memf
17e0: 61 75 6c 74 2e 6d 2c 20 73 69 7a 65 6f 66 28 6d  ault.m, sizeof(m
17f0: 32 29 29 3d 3d 30 20 29 3b 0a 0a 20 20 20 20 72  2))==0 );..    r
1800: 63 20 3d 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66  c = sqlite3_conf
1810: 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47  ig(SQLITE_CONFIG
1820: 5f 4d 41 4c 4c 4f 43 2c 20 26 6d 65 6d 66 61 75  _MALLOC, &memfau
1830: 6c 74 2e 6d 29 3b 0a 20 20 20 20 73 71 6c 69 74  lt.m);.    sqlit
1840: 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28  e3_test_control(
1850: 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f  SQLITE_TESTCTRL_
1860: 42 45 4e 49 47 4e 5f 4d 41 4c 4c 4f 43 5f 48 4f  BENIGN_MALLOC_HO
1870: 4f 4b 53 2c 0a 20 20 20 20 20 20 20 20 28 76 6f  OKS,.        (vo
1880: 69 64 2a 29 30 2c 20 28 76 6f 69 64 2a 29 30 29  id*)0, (void*)0)
1890: 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 72 63 3d  ;.  }..  if( rc=
18a0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
18b0: 20 20 6d 65 6d 66 61 75 6c 74 2e 69 73 49 6e 73    memfault.isIns
18c0: 74 61 6c 6c 65 64 20 3d 20 31 3b 0a 20 20 7d 0a  talled = 1;.  }.
18d0: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
18e0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45  #ifdef SQLITE_TE
18f0: 53 54 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66  ST../*.** This f
1900: 75 6e 63 74 69 6f 6e 20 69 73 20 69 6d 70 6c 65  unction is imple
1910: 6d 65 6e 74 65 64 20 69 6e 20 6d 61 69 6e 2e 63  mented in main.c
1920: 2e 20 52 65 74 75 72 6e 73 20 61 20 70 6f 69 6e  . Returns a poin
1930: 74 65 72 20 74 6f 20 61 20 73 74 61 74 69 63 0a  ter to a static.
1940: 2a 2a 20 62 75 66 66 65 72 20 63 6f 6e 74 61 69  ** buffer contai
1950: 6e 69 6e 67 20 74 68 65 20 73 79 6d 62 6f 6c 69  ning the symboli
1960: 63 20 53 51 4c 69 74 65 20 65 72 72 6f 72 20 63  c SQLite error c
1970: 6f 64 65 20 74 68 61 74 20 63 6f 72 72 65 73 70  ode that corresp
1980: 6f 6e 64 73 20 74 6f 0a 2a 2a 20 74 68 65 20 6c  onds to.** the l
1990: 65 61 73 74 2d 73 69 67 6e 69 66 69 63 61 6e 74  east-significant
19a0: 20 38 2d 62 69 74 73 20 6f 66 20 74 68 65 20 69   8-bits of the i
19b0: 6e 74 65 67 65 72 20 70 61 73 73 65 64 20 61 73  nteger passed as
19c0: 20 61 6e 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2a   an argument..**
19d0: 20 46 6f 72 20 65 78 61 6d 70 6c 65 3a 0a 2a 2a   For example:.**
19e0: 0a 2a 2a 20 20 20 73 71 6c 69 74 65 33 45 72 72  .**   sqlite3Err
19f0: 4e 61 6d 65 28 31 29 20 2d 3e 20 22 53 51 4c 49  Name(1) -> "SQLI
1a00: 54 45 5f 45 52 52 4f 52 22 0a 2a 2f 0a 65 78 74  TE_ERROR".*/.ext
1a10: 65 72 6e 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  ern const char *
1a20: 73 71 6c 69 74 65 33 45 72 72 4e 61 6d 65 28 69  sqlite3ErrName(i
1a30: 6e 74 29 3b 0a 0a 2f 2a 0a 2a 2a 20 54 72 61 6e  nt);../*.** Tran
1a40: 73 66 6f 72 6d 20 70 6f 69 6e 74 65 72 73 20 74  sform pointers t
1a50: 6f 20 74 65 78 74 20 61 6e 64 20 62 61 63 6b 20  o text and back 
1a60: 61 67 61 69 6e 0a 2a 2f 0a 73 74 61 74 69 63 20  again.*/.static 
1a70: 76 6f 69 64 20 70 6f 69 6e 74 65 72 54 6f 54 65  void pointerToTe
1a80: 78 74 28 76 6f 69 64 20 2a 70 2c 20 63 68 61 72  xt(void *p, char
1a90: 20 2a 7a 29 7b 0a 20 20 73 74 61 74 69 63 20 63   *z){.  static c
1aa0: 6f 6e 73 74 20 63 68 61 72 20 7a 48 65 78 5b 5d  onst char zHex[]
1ab0: 20 3d 20 22 30 31 32 33 34 35 36 37 38 39 61 62   = "0123456789ab
1ac0: 63 64 65 66 22 3b 0a 20 20 69 6e 74 20 69 2c 20  cdef";.  int i, 
1ad0: 6b 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e  k;.  unsigned in
1ae0: 74 20 75 3b 0a 20 20 73 71 6c 69 74 65 33 5f 75  t u;.  sqlite3_u
1af0: 69 6e 74 36 34 20 6e 3b 0a 20 20 69 66 28 20 70  int64 n;.  if( p
1b00: 3d 3d 30 20 29 7b 0a 20 20 20 20 73 74 72 63 70  ==0 ){.    strcp
1b10: 79 28 7a 2c 20 22 30 22 29 3b 0a 20 20 20 20 72  y(z, "0");.    r
1b20: 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 69 66 28  eturn;.  }.  if(
1b30: 20 73 69 7a 65 6f 66 28 6e 29 3d 3d 73 69 7a 65   sizeof(n)==size
1b40: 6f 66 28 70 29 20 29 7b 0a 20 20 20 20 6d 65 6d  of(p) ){.    mem
1b50: 63 70 79 28 26 6e 2c 20 26 70 2c 20 73 69 7a 65  cpy(&n, &p, size
1b60: 6f 66 28 70 29 29 3b 0a 20 20 7d 65 6c 73 65 20  of(p));.  }else 
1b70: 69 66 28 20 73 69 7a 65 6f 66 28 75 29 3d 3d 73  if( sizeof(u)==s
1b80: 69 7a 65 6f 66 28 70 29 20 29 7b 0a 20 20 20 20  izeof(p) ){.    
1b90: 6d 65 6d 63 70 79 28 26 75 2c 20 26 70 2c 20 73  memcpy(&u, &p, s
1ba0: 69 7a 65 6f 66 28 75 29 29 3b 0a 20 20 20 20 6e  izeof(u));.    n
1bb0: 20 3d 20 75 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20   = u;.  }else{. 
1bc0: 20 20 20 61 73 73 65 72 74 28 20 30 20 29 3b 0a     assert( 0 );.
1bd0: 20 20 7d 0a 20 20 66 6f 72 28 69 3d 30 2c 20 6b    }.  for(i=0, k
1be0: 3d 73 69 7a 65 6f 66 28 70 29 2a 32 2d 31 3b 20  =sizeof(p)*2-1; 
1bf0: 69 3c 73 69 7a 65 6f 66 28 70 29 2a 32 3b 20 69  i<sizeof(p)*2; i
1c00: 2b 2b 2c 20 6b 2d 2d 29 7b 0a 20 20 20 20 7a 5b  ++, k--){.    z[
1c10: 6b 5d 20 3d 20 7a 48 65 78 5b 6e 26 30 78 66 5d  k] = zHex[n&0xf]
1c20: 3b 0a 20 20 20 20 6e 20 3e 3e 3d 20 34 3b 0a 20  ;.    n >>= 4;. 
1c30: 20 7d 0a 20 20 7a 5b 73 69 7a 65 6f 66 28 70 29   }.  z[sizeof(p)
1c40: 2a 32 5d 20 3d 20 30 3b 0a 7d 0a 73 74 61 74 69  *2] = 0;.}.stati
1c50: 63 20 69 6e 74 20 68 65 78 54 6f 49 6e 74 28 69  c int hexToInt(i
1c60: 6e 74 20 68 29 7b 0a 20 20 69 66 28 20 68 3e 3d  nt h){.  if( h>=
1c70: 27 30 27 20 26 26 20 68 3c 3d 27 39 27 20 29 7b  '0' && h<='9' ){
1c80: 0a 20 20 20 20 72 65 74 75 72 6e 20 68 20 2d 20  .    return h - 
1c90: 27 30 27 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28  '0';.  }else if(
1ca0: 20 68 3e 3d 27 61 27 20 26 26 20 68 3c 3d 27 66   h>='a' && h<='f
1cb0: 27 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  ' ){.    return 
1cc0: 68 20 2d 20 27 61 27 20 2b 20 31 30 3b 0a 20 20  h - 'a' + 10;.  
1cd0: 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72  }else{.    retur
1ce0: 6e 20 2d 31 3b 0a 20 20 7d 0a 7d 0a 73 74 61 74  n -1;.  }.}.stat
1cf0: 69 63 20 69 6e 74 20 74 65 78 74 54 6f 50 6f 69  ic int textToPoi
1d00: 6e 74 65 72 28 63 6f 6e 73 74 20 63 68 61 72 20  nter(const char 
1d10: 2a 7a 2c 20 76 6f 69 64 20 2a 2a 70 70 29 7b 0a  *z, void **pp){.
1d20: 20 20 73 71 6c 69 74 65 33 5f 75 69 6e 74 36 34    sqlite3_uint64
1d30: 20 6e 20 3d 20 30 3b 0a 20 20 69 6e 74 20 69 3b   n = 0;.  int i;
1d40: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
1d50: 75 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c  u;.  for(i=0; i<
1d60: 73 69 7a 65 6f 66 28 76 6f 69 64 2a 29 2a 32 20  sizeof(void*)*2 
1d70: 26 26 20 7a 5b 30 5d 3b 20 69 2b 2b 29 7b 0a 20  && z[0]; i++){. 
1d80: 20 20 20 69 6e 74 20 76 3b 0a 20 20 20 20 76 20     int v;.    v 
1d90: 3d 20 68 65 78 54 6f 49 6e 74 28 2a 7a 2b 2b 29  = hexToInt(*z++)
1da0: 3b 0a 20 20 20 20 69 66 28 20 76 3c 30 20 29 20  ;.    if( v<0 ) 
1db0: 72 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52  return TCL_ERROR
1dc0: 3b 0a 20 20 20 20 6e 20 3d 20 6e 2a 31 36 20 2b  ;.    n = n*16 +
1dd0: 20 76 3b 0a 20 20 7d 0a 20 20 69 66 28 20 2a 7a   v;.  }.  if( *z
1de0: 21 3d 30 20 29 20 72 65 74 75 72 6e 20 54 43 4c  !=0 ) return TCL
1df0: 5f 45 52 52 4f 52 3b 0a 20 20 69 66 28 20 73 69  _ERROR;.  if( si
1e00: 7a 65 6f 66 28 6e 29 3d 3d 73 69 7a 65 6f 66 28  zeof(n)==sizeof(
1e10: 2a 70 70 29 20 29 7b 0a 20 20 20 20 6d 65 6d 63  *pp) ){.    memc
1e20: 70 79 28 70 70 2c 20 26 6e 2c 20 73 69 7a 65 6f  py(pp, &n, sizeo
1e30: 66 28 6e 29 29 3b 0a 20 20 7d 65 6c 73 65 20 69  f(n));.  }else i
1e40: 66 28 20 73 69 7a 65 6f 66 28 75 29 3d 3d 73 69  f( sizeof(u)==si
1e50: 7a 65 6f 66 28 2a 70 70 29 20 29 7b 0a 20 20 20  zeof(*pp) ){.   
1e60: 20 75 20 3d 20 28 75 6e 73 69 67 6e 65 64 20 69   u = (unsigned i
1e70: 6e 74 29 6e 3b 0a 20 20 20 20 6d 65 6d 63 70 79  nt)n;.    memcpy
1e80: 28 70 70 2c 20 26 75 2c 20 73 69 7a 65 6f 66 28  (pp, &u, sizeof(
1e90: 75 29 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  u));.  }else{.  
1ea0: 20 20 61 73 73 65 72 74 28 20 30 20 29 3b 0a 20    assert( 0 );. 
1eb0: 20 7d 0a 20 20 72 65 74 75 72 6e 20 54 43 4c 5f   }.  return TCL_
1ec0: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55 73 61  OK;.}../*.** Usa
1ed0: 67 65 3a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d  ge:    sqlite3_m
1ee0: 61 6c 6c 6f 63 20 20 4e 42 59 54 45 53 0a 2a 2a  alloc  NBYTES.**
1ef0: 0a 2a 2a 20 52 61 77 20 74 65 73 74 20 69 6e 74  .** Raw test int
1f00: 65 72 66 61 63 65 20 66 6f 72 20 73 71 6c 69 74  erface for sqlit
1f10: 65 33 5f 6d 61 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a  e3_malloc()..*/.
1f20: 73 74 61 74 69 63 20 69 6e 74 20 53 51 4c 49 54  static int SQLIT
1f30: 45 5f 54 43 4c 41 50 49 20 74 65 73 74 5f 6d 61  E_TCLAPI test_ma
1f40: 6c 6c 6f 63 28 0a 20 20 76 6f 69 64 20 2a 20 63  lloc(.  void * c
1f50: 6c 69 65 6e 74 44 61 74 61 2c 0a 20 20 54 63 6c  lientData,.  Tcl
1f60: 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65 72 70 2c  _Interp *interp,
1f70: 0a 20 20 69 6e 74 20 6f 62 6a 63 2c 0a 20 20 54  .  int objc,.  T
1f80: 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54 20 6f 62  cl_Obj *CONST ob
1f90: 6a 76 5b 5d 0a 29 7b 0a 20 20 69 6e 74 20 6e 42  jv[].){.  int nB
1fa0: 79 74 65 3b 0a 20 20 76 6f 69 64 20 2a 70 3b 0a  yte;.  void *p;.
1fb0: 20 20 63 68 61 72 20 7a 4f 75 74 5b 31 30 30 5d    char zOut[100]
1fc0: 3b 0a 20 20 69 66 28 20 6f 62 6a 63 21 3d 32 20  ;.  if( objc!=2 
1fd0: 29 7b 0a 20 20 20 20 54 63 6c 5f 57 72 6f 6e 67  ){.    Tcl_Wrong
1fe0: 4e 75 6d 41 72 67 73 28 69 6e 74 65 72 70 2c 20  NumArgs(interp, 
1ff0: 31 2c 20 6f 62 6a 76 2c 20 22 4e 42 59 54 45 53  1, objv, "NBYTES
2000: 22 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 54  ");.    return T
2010: 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20  CL_ERROR;.  }.  
2020: 69 66 28 20 54 63 6c 5f 47 65 74 49 6e 74 46 72  if( Tcl_GetIntFr
2030: 6f 6d 4f 62 6a 28 69 6e 74 65 72 70 2c 20 6f 62  omObj(interp, ob
2040: 6a 76 5b 31 5d 2c 20 26 6e 42 79 74 65 29 20 29  jv[1], &nByte) )
2050: 20 72 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f   return TCL_ERRO
2060: 52 3b 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 33  R;.  p = sqlite3
2070: 5f 6d 61 6c 6c 6f 63 28 28 75 6e 73 69 67 6e 65  _malloc((unsigne
2080: 64 29 6e 42 79 74 65 29 3b 0a 20 20 70 6f 69 6e  d)nByte);.  poin
2090: 74 65 72 54 6f 54 65 78 74 28 70 2c 20 7a 4f 75  terToText(p, zOu
20a0: 74 29 3b 0a 20 20 54 63 6c 5f 41 70 70 65 6e 64  t);.  Tcl_Append
20b0: 52 65 73 75 6c 74 28 69 6e 74 65 72 70 2c 20 7a  Result(interp, z
20c0: 4f 75 74 2c 20 4e 55 4c 4c 29 3b 0a 20 20 72 65  Out, NULL);.  re
20d0: 74 75 72 6e 20 54 43 4c 5f 4f 4b 3b 0a 7d 0a 0a  turn TCL_OK;.}..
20e0: 2f 2a 0a 2a 2a 20 55 73 61 67 65 3a 20 20 20 20  /*.** Usage:    
20f0: 73 71 6c 69 74 65 33 5f 72 65 61 6c 6c 6f 63 20  sqlite3_realloc 
2100: 20 50 52 49 4f 52 20 20 4e 42 59 54 45 53 0a 2a   PRIOR  NBYTES.*
2110: 2a 0a 2a 2a 20 52 61 77 20 74 65 73 74 20 69 6e  *.** Raw test in
2120: 74 65 72 66 61 63 65 20 66 6f 72 20 73 71 6c 69  terface for sqli
2130: 74 65 33 5f 72 65 61 6c 6c 6f 63 28 29 2e 0a 2a  te3_realloc()..*
2140: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 53 51 4c  /.static int SQL
2150: 49 54 45 5f 54 43 4c 41 50 49 20 74 65 73 74 5f  ITE_TCLAPI test_
2160: 72 65 61 6c 6c 6f 63 28 0a 20 20 76 6f 69 64 20  realloc(.  void 
2170: 2a 20 63 6c 69 65 6e 74 44 61 74 61 2c 0a 20 20  * clientData,.  
2180: 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65  Tcl_Interp *inte
2190: 72 70 2c 0a 20 20 69 6e 74 20 6f 62 6a 63 2c 0a  rp,.  int objc,.
21a0: 20 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54    Tcl_Obj *CONST
21b0: 20 6f 62 6a 76 5b 5d 0a 29 7b 0a 20 20 69 6e 74   objv[].){.  int
21c0: 20 6e 42 79 74 65 3b 0a 20 20 76 6f 69 64 20 2a   nByte;.  void *
21d0: 70 50 72 69 6f 72 2c 20 2a 70 3b 0a 20 20 63 68  pPrior, *p;.  ch
21e0: 61 72 20 7a 4f 75 74 5b 31 30 30 5d 3b 0a 20 20  ar zOut[100];.  
21f0: 69 66 28 20 6f 62 6a 63 21 3d 33 20 29 7b 0a 20  if( objc!=3 ){. 
2200: 20 20 20 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d 41     Tcl_WrongNumA
2210: 72 67 73 28 69 6e 74 65 72 70 2c 20 31 2c 20 6f  rgs(interp, 1, o
2220: 62 6a 76 2c 20 22 50 52 49 4f 52 20 4e 42 59 54  bjv, "PRIOR NBYT
2230: 45 53 22 29 3b 0a 20 20 20 20 72 65 74 75 72 6e  ES");.    return
2240: 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a   TCL_ERROR;.  }.
2250: 20 20 69 66 28 20 54 63 6c 5f 47 65 74 49 6e 74    if( Tcl_GetInt
2260: 46 72 6f 6d 4f 62 6a 28 69 6e 74 65 72 70 2c 20  FromObj(interp, 
2270: 6f 62 6a 76 5b 32 5d 2c 20 26 6e 42 79 74 65 29  objv[2], &nByte)
2280: 20 29 20 72 65 74 75 72 6e 20 54 43 4c 5f 45 52   ) return TCL_ER
2290: 52 4f 52 3b 0a 20 20 69 66 28 20 74 65 78 74 54  ROR;.  if( textT
22a0: 6f 50 6f 69 6e 74 65 72 28 54 63 6c 5f 47 65 74  oPointer(Tcl_Get
22b0: 53 74 72 69 6e 67 28 6f 62 6a 76 5b 31 5d 29 2c  String(objv[1]),
22c0: 20 26 70 50 72 69 6f 72 29 20 29 7b 0a 20 20 20   &pPrior) ){.   
22d0: 20 54 63 6c 5f 41 70 70 65 6e 64 52 65 73 75 6c   Tcl_AppendResul
22e0: 74 28 69 6e 74 65 72 70 2c 20 22 62 61 64 20 70  t(interp, "bad p
22f0: 6f 69 6e 74 65 72 3a 20 22 2c 20 54 63 6c 5f 47  ointer: ", Tcl_G
2300: 65 74 53 74 72 69 6e 67 28 6f 62 6a 76 5b 31 5d  etString(objv[1]
2310: 29 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 20  ), (char*)0);.  
2320: 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45 52 52    return TCL_ERR
2330: 4f 52 3b 0a 20 20 7d 0a 20 20 70 20 3d 20 73 71  OR;.  }.  p = sq
2340: 6c 69 74 65 33 5f 72 65 61 6c 6c 6f 63 28 70 50  lite3_realloc(pP
2350: 72 69 6f 72 2c 20 28 75 6e 73 69 67 6e 65 64 29  rior, (unsigned)
2360: 6e 42 79 74 65 29 3b 0a 20 20 70 6f 69 6e 74 65  nByte);.  pointe
2370: 72 54 6f 54 65 78 74 28 70 2c 20 7a 4f 75 74 29  rToText(p, zOut)
2380: 3b 0a 20 20 54 63 6c 5f 41 70 70 65 6e 64 52 65  ;.  Tcl_AppendRe
2390: 73 75 6c 74 28 69 6e 74 65 72 70 2c 20 7a 4f 75  sult(interp, zOu
23a0: 74 2c 20 4e 55 4c 4c 29 3b 0a 20 20 72 65 74 75  t, NULL);.  retu
23b0: 72 6e 20 54 43 4c 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a  rn TCL_OK;.}../*
23c0: 0a 2a 2a 20 55 73 61 67 65 3a 20 20 20 20 73 71  .** Usage:    sq
23d0: 6c 69 74 65 33 5f 66 72 65 65 20 20 50 52 49 4f  lite3_free  PRIO
23e0: 52 0a 2a 2a 0a 2a 2a 20 52 61 77 20 74 65 73 74  R.**.** Raw test
23f0: 20 69 6e 74 65 72 66 61 63 65 20 66 6f 72 20 73   interface for s
2400: 71 6c 69 74 65 33 5f 66 72 65 65 28 29 2e 0a 2a  qlite3_free()..*
2410: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 53 51 4c  /.static int SQL
2420: 49 54 45 5f 54 43 4c 41 50 49 20 74 65 73 74 5f  ITE_TCLAPI test_
2430: 66 72 65 65 28 0a 20 20 76 6f 69 64 20 2a 20 63  free(.  void * c
2440: 6c 69 65 6e 74 44 61 74 61 2c 0a 20 20 54 63 6c  lientData,.  Tcl
2450: 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65 72 70 2c  _Interp *interp,
2460: 0a 20 20 69 6e 74 20 6f 62 6a 63 2c 0a 20 20 54  .  int objc,.  T
2470: 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54 20 6f 62  cl_Obj *CONST ob
2480: 6a 76 5b 5d 0a 29 7b 0a 20 20 76 6f 69 64 20 2a  jv[].){.  void *
2490: 70 50 72 69 6f 72 3b 0a 20 20 69 66 28 20 6f 62  pPrior;.  if( ob
24a0: 6a 63 21 3d 32 20 29 7b 0a 20 20 20 20 54 63 6c  jc!=2 ){.    Tcl
24b0: 5f 57 72 6f 6e 67 4e 75 6d 41 72 67 73 28 69 6e  _WrongNumArgs(in
24c0: 74 65 72 70 2c 20 31 2c 20 6f 62 6a 76 2c 20 22  terp, 1, objv, "
24d0: 50 52 49 4f 52 22 29 3b 0a 20 20 20 20 72 65 74  PRIOR");.    ret
24e0: 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20  urn TCL_ERROR;. 
24f0: 20 7d 0a 20 20 69 66 28 20 74 65 78 74 54 6f 50   }.  if( textToP
2500: 6f 69 6e 74 65 72 28 54 63 6c 5f 47 65 74 53 74  ointer(Tcl_GetSt
2510: 72 69 6e 67 28 6f 62 6a 76 5b 31 5d 29 2c 20 26  ring(objv[1]), &
2520: 70 50 72 69 6f 72 29 20 29 7b 0a 20 20 20 20 54  pPrior) ){.    T
2530: 63 6c 5f 41 70 70 65 6e 64 52 65 73 75 6c 74 28  cl_AppendResult(
2540: 69 6e 74 65 72 70 2c 20 22 62 61 64 20 70 6f 69  interp, "bad poi
2550: 6e 74 65 72 3a 20 22 2c 20 54 63 6c 5f 47 65 74  nter: ", Tcl_Get
2560: 53 74 72 69 6e 67 28 6f 62 6a 76 5b 31 5d 29 2c  String(objv[1]),
2570: 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 20 20 20   (char*)0);.    
2580: 72 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52  return TCL_ERROR
2590: 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f  ;.  }.  sqlite3_
25a0: 66 72 65 65 28 70 50 72 69 6f 72 29 3b 0a 20 20  free(pPrior);.  
25b0: 72 65 74 75 72 6e 20 54 43 4c 5f 4f 4b 3b 0a 7d  return TCL_OK;.}
25c0: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 73 65 20 72 6f  ../*.** These ro
25d0: 75 74 69 6e 65 73 20 61 72 65 20 69 6e 20 74 65  utines are in te
25e0: 73 74 5f 68 65 78 69 6f 2e 63 0a 2a 2f 0a 69 6e  st_hexio.c.*/.in
25f0: 74 20 73 71 6c 69 74 65 33 54 65 73 74 48 65 78  t sqlite3TestHex
2600: 54 6f 42 69 6e 28 63 6f 6e 73 74 20 63 68 61 72  ToBin(const char
2610: 20 2a 2c 20 69 6e 74 2c 20 63 68 61 72 20 2a 29   *, int, char *)
2620: 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 54 65 73  ;.int sqlite3Tes
2630: 74 42 69 6e 54 6f 48 65 78 28 63 68 61 72 2a 2c  tBinToHex(char*,
2640: 69 6e 74 29 3b 0a 0a 2f 2a 0a 2a 2a 20 55 73 61  int);../*.** Usa
2650: 67 65 3a 20 20 20 20 6d 65 6d 73 65 74 20 20 41  ge:    memset  A
2660: 44 44 52 45 53 53 20 20 53 49 5a 45 20 20 48 45  DDRESS  SIZE  HE
2670: 58 0a 2a 2a 0a 2a 2a 20 53 65 74 20 61 20 63 68  X.**.** Set a ch
2680: 75 6e 6b 20 6f 66 20 6d 65 6d 6f 72 79 20 28 6f  unk of memory (o
2690: 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 6d 61 6c  btained from mal
26a0: 6c 6f 63 2c 20 70 72 6f 62 61 62 6c 79 29 20 74  loc, probably) t
26b0: 6f 20 61 0a 2a 2a 20 73 70 65 63 69 66 69 65 64  o a.** specified
26c0: 20 68 65 78 20 70 61 74 74 65 72 6e 2e 0a 2a 2f   hex pattern..*/
26d0: 0a 73 74 61 74 69 63 20 69 6e 74 20 53 51 4c 49  .static int SQLI
26e0: 54 45 5f 54 43 4c 41 50 49 20 74 65 73 74 5f 6d  TE_TCLAPI test_m
26f0: 65 6d 73 65 74 28 0a 20 20 76 6f 69 64 20 2a 20  emset(.  void * 
2700: 63 6c 69 65 6e 74 44 61 74 61 2c 0a 20 20 54 63  clientData,.  Tc
2710: 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65 72 70  l_Interp *interp
2720: 2c 0a 20 20 69 6e 74 20 6f 62 6a 63 2c 0a 20 20  ,.  int objc,.  
2730: 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54 20 6f  Tcl_Obj *CONST o
2740: 62 6a 76 5b 5d 0a 29 7b 0a 20 20 76 6f 69 64 20  bjv[].){.  void 
2750: 2a 70 3b 0a 20 20 69 6e 74 20 73 69 7a 65 2c 20  *p;.  int size, 
2760: 6e 2c 20 69 3b 0a 20 20 63 68 61 72 20 2a 7a 48  n, i;.  char *zH
2770: 65 78 3b 0a 20 20 63 68 61 72 20 2a 7a 4f 75 74  ex;.  char *zOut
2780: 3b 0a 20 20 63 68 61 72 20 7a 42 69 6e 5b 31 30  ;.  char zBin[10
2790: 30 5d 3b 0a 0a 20 20 69 66 28 20 6f 62 6a 63 21  0];..  if( objc!
27a0: 3d 34 20 29 7b 0a 20 20 20 20 54 63 6c 5f 57 72  =4 ){.    Tcl_Wr
27b0: 6f 6e 67 4e 75 6d 41 72 67 73 28 69 6e 74 65 72  ongNumArgs(inter
27c0: 70 2c 20 31 2c 20 6f 62 6a 76 2c 20 22 41 44 44  p, 1, objv, "ADD
27d0: 52 45 53 53 20 53 49 5a 45 20 48 45 58 22 29 3b  RESS SIZE HEX");
27e0: 0a 20 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f  .    return TCL_
27f0: 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 69 66 28  ERROR;.  }.  if(
2800: 20 74 65 78 74 54 6f 50 6f 69 6e 74 65 72 28 54   textToPointer(T
2810: 63 6c 5f 47 65 74 53 74 72 69 6e 67 28 6f 62 6a  cl_GetString(obj
2820: 76 5b 31 5d 29 2c 20 26 70 29 20 29 7b 0a 20 20  v[1]), &p) ){.  
2830: 20 20 54 63 6c 5f 41 70 70 65 6e 64 52 65 73 75    Tcl_AppendResu
2840: 6c 74 28 69 6e 74 65 72 70 2c 20 22 62 61 64 20  lt(interp, "bad 
2850: 70 6f 69 6e 74 65 72 3a 20 22 2c 20 54 63 6c 5f  pointer: ", Tcl_
2860: 47 65 74 53 74 72 69 6e 67 28 6f 62 6a 76 5b 31  GetString(objv[1
2870: 5d 29 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 20  ]), (char*)0);. 
2880: 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45 52     return TCL_ER
2890: 52 4f 52 3b 0a 20 20 7d 0a 20 20 69 66 28 20 54  ROR;.  }.  if( T
28a0: 63 6c 5f 47 65 74 49 6e 74 46 72 6f 6d 4f 62 6a  cl_GetIntFromObj
28b0: 28 69 6e 74 65 72 70 2c 20 6f 62 6a 76 5b 32 5d  (interp, objv[2]
28c0: 2c 20 26 73 69 7a 65 29 20 29 7b 0a 20 20 20 20  , &size) ){.    
28d0: 72 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52  return TCL_ERROR
28e0: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 69 7a 65  ;.  }.  if( size
28f0: 3c 3d 30 20 29 7b 0a 20 20 20 20 54 63 6c 5f 41  <=0 ){.    Tcl_A
2900: 70 70 65 6e 64 52 65 73 75 6c 74 28 69 6e 74 65  ppendResult(inte
2910: 72 70 2c 20 22 73 69 7a 65 20 6d 75 73 74 20 62  rp, "size must b
2920: 65 20 70 6f 73 69 74 69 76 65 22 2c 20 28 63 68  e positive", (ch
2930: 61 72 2a 29 30 29 3b 0a 20 20 20 20 72 65 74 75  ar*)0);.    retu
2940: 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20  rn TCL_ERROR;.  
2950: 7d 0a 20 20 7a 48 65 78 20 3d 20 54 63 6c 5f 47  }.  zHex = Tcl_G
2960: 65 74 53 74 72 69 6e 67 46 72 6f 6d 4f 62 6a 28  etStringFromObj(
2970: 6f 62 6a 76 5b 33 5d 2c 20 26 6e 29 3b 0a 20 20  objv[3], &n);.  
2980: 69 66 28 20 6e 3e 73 69 7a 65 6f 66 28 7a 42 69  if( n>sizeof(zBi
2990: 6e 29 2a 32 20 29 20 6e 20 3d 20 73 69 7a 65 6f  n)*2 ) n = sizeo
29a0: 66 28 7a 42 69 6e 29 2a 32 3b 0a 20 20 6e 20 3d  f(zBin)*2;.  n =
29b0: 20 73 71 6c 69 74 65 33 54 65 73 74 48 65 78 54   sqlite3TestHexT
29c0: 6f 42 69 6e 28 7a 48 65 78 2c 20 6e 2c 20 7a 42  oBin(zHex, n, zB
29d0: 69 6e 29 3b 0a 20 20 69 66 28 20 6e 3d 3d 30 20  in);.  if( n==0 
29e0: 29 7b 0a 20 20 20 20 54 63 6c 5f 41 70 70 65 6e  ){.    Tcl_Appen
29f0: 64 52 65 73 75 6c 74 28 69 6e 74 65 72 70 2c 20  dResult(interp, 
2a00: 22 6e 6f 20 64 61 74 61 22 2c 20 28 63 68 61 72  "no data", (char
2a10: 2a 29 30 29 3b 0a 20 20 20 20 72 65 74 75 72 6e  *)0);.    return
2a20: 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a   TCL_ERROR;.  }.
2a30: 20 20 7a 4f 75 74 20 3d 20 70 3b 0a 20 20 66 6f    zOut = p;.  fo
2a40: 72 28 69 3d 30 3b 20 69 3c 73 69 7a 65 3b 20 69  r(i=0; i<size; i
2a50: 2b 2b 29 7b 0a 20 20 20 20 7a 4f 75 74 5b 69 5d  ++){.    zOut[i]
2a60: 20 3d 20 7a 42 69 6e 5b 69 25 6e 5d 3b 0a 20 20   = zBin[i%n];.  
2a70: 7d 0a 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 4f  }.  return TCL_O
2a80: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55 73 61 67  K;.}../*.** Usag
2a90: 65 3a 20 20 20 20 6d 65 6d 67 65 74 20 20 41 44  e:    memget  AD
2aa0: 44 52 45 53 53 20 20 53 49 5a 45 0a 2a 2a 0a 2a  DRESS  SIZE.**.*
2ab0: 2a 20 52 65 74 75 72 6e 20 6d 65 6d 6f 72 79 20  * Return memory 
2ac0: 61 73 20 68 65 78 61 64 65 63 69 6d 61 6c 20 74  as hexadecimal t
2ad0: 65 78 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ext..*/.static i
2ae0: 6e 74 20 53 51 4c 49 54 45 5f 54 43 4c 41 50 49  nt SQLITE_TCLAPI
2af0: 20 74 65 73 74 5f 6d 65 6d 67 65 74 28 0a 20 20   test_memget(.  
2b00: 76 6f 69 64 20 2a 20 63 6c 69 65 6e 74 44 61 74  void * clientDat
2b10: 61 2c 0a 20 20 54 63 6c 5f 49 6e 74 65 72 70 20  a,.  Tcl_Interp 
2b20: 2a 69 6e 74 65 72 70 2c 0a 20 20 69 6e 74 20 6f  *interp,.  int o
2b30: 62 6a 63 2c 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a  bjc,.  Tcl_Obj *
2b40: 43 4f 4e 53 54 20 6f 62 6a 76 5b 5d 0a 29 7b 0a  CONST objv[].){.
2b50: 20 20 76 6f 69 64 20 2a 70 3b 0a 20 20 69 6e 74    void *p;.  int
2b60: 20 73 69 7a 65 2c 20 6e 3b 0a 20 20 63 68 61 72   size, n;.  char
2b70: 20 2a 7a 42 69 6e 3b 0a 20 20 63 68 61 72 20 7a   *zBin;.  char z
2b80: 48 65 78 5b 31 30 30 5d 3b 0a 0a 20 20 69 66 28  Hex[100];..  if(
2b90: 20 6f 62 6a 63 21 3d 33 20 29 7b 0a 20 20 20 20   objc!=3 ){.    
2ba0: 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d 41 72 67 73  Tcl_WrongNumArgs
2bb0: 28 69 6e 74 65 72 70 2c 20 31 2c 20 6f 62 6a 76  (interp, 1, objv
2bc0: 2c 20 22 41 44 44 52 45 53 53 20 53 49 5a 45 22  , "ADDRESS SIZE"
2bd0: 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 54 43  );.    return TC
2be0: 4c 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 69  L_ERROR;.  }.  i
2bf0: 66 28 20 74 65 78 74 54 6f 50 6f 69 6e 74 65 72  f( textToPointer
2c00: 28 54 63 6c 5f 47 65 74 53 74 72 69 6e 67 28 6f  (Tcl_GetString(o
2c10: 62 6a 76 5b 31 5d 29 2c 20 26 70 29 20 29 7b 0a  bjv[1]), &p) ){.
2c20: 20 20 20 20 54 63 6c 5f 41 70 70 65 6e 64 52 65      Tcl_AppendRe
2c30: 73 75 6c 74 28 69 6e 74 65 72 70 2c 20 22 62 61  sult(interp, "ba
2c40: 64 20 70 6f 69 6e 74 65 72 3a 20 22 2c 20 54 63  d pointer: ", Tc
2c50: 6c 5f 47 65 74 53 74 72 69 6e 67 28 6f 62 6a 76  l_GetString(objv
2c60: 5b 31 5d 29 2c 20 28 63 68 61 72 2a 29 30 29 3b  [1]), (char*)0);
2c70: 0a 20 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f  .    return TCL_
2c80: 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 69 66 28  ERROR;.  }.  if(
2c90: 20 54 63 6c 5f 47 65 74 49 6e 74 46 72 6f 6d 4f   Tcl_GetIntFromO
2ca0: 62 6a 28 69 6e 74 65 72 70 2c 20 6f 62 6a 76 5b  bj(interp, objv[
2cb0: 32 5d 2c 20 26 73 69 7a 65 29 20 29 7b 0a 20 20  2], &size) ){.  
2cc0: 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45 52 52    return TCL_ERR
2cd0: 4f 52 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 69  OR;.  }.  if( si
2ce0: 7a 65 3c 3d 30 20 29 7b 0a 20 20 20 20 54 63 6c  ze<=0 ){.    Tcl
2cf0: 5f 41 70 70 65 6e 64 52 65 73 75 6c 74 28 69 6e  _AppendResult(in
2d00: 74 65 72 70 2c 20 22 73 69 7a 65 20 6d 75 73 74  terp, "size must
2d10: 20 62 65 20 70 6f 73 69 74 69 76 65 22 2c 20 28   be positive", (
2d20: 63 68 61 72 2a 29 30 29 3b 0a 20 20 20 20 72 65  char*)0);.    re
2d30: 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a  turn TCL_ERROR;.
2d40: 20 20 7d 0a 20 20 7a 42 69 6e 20 3d 20 70 3b 0a    }.  zBin = p;.
2d50: 20 20 77 68 69 6c 65 28 20 73 69 7a 65 3e 30 20    while( size>0 
2d60: 29 7b 0a 20 20 20 20 69 66 28 20 73 69 7a 65 3e  ){.    if( size>
2d70: 28 73 69 7a 65 6f 66 28 7a 48 65 78 29 2d 31 29  (sizeof(zHex)-1)
2d80: 2f 32 20 29 7b 0a 20 20 20 20 20 20 6e 20 3d 20  /2 ){.      n = 
2d90: 28 73 69 7a 65 6f 66 28 7a 48 65 78 29 2d 31 29  (sizeof(zHex)-1)
2da0: 2f 32 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20  /2;.    }else{. 
2db0: 20 20 20 20 20 6e 20 3d 20 73 69 7a 65 3b 0a 20       n = size;. 
2dc0: 20 20 20 7d 0a 20 20 20 20 6d 65 6d 63 70 79 28     }.    memcpy(
2dd0: 7a 48 65 78 2c 20 7a 42 69 6e 2c 20 6e 29 3b 0a  zHex, zBin, n);.
2de0: 20 20 20 20 7a 42 69 6e 20 2b 3d 20 6e 3b 0a 20      zBin += n;. 
2df0: 20 20 20 73 69 7a 65 20 2d 3d 20 6e 3b 0a 20 20     size -= n;.  
2e00: 20 20 73 71 6c 69 74 65 33 54 65 73 74 42 69 6e    sqlite3TestBin
2e10: 54 6f 48 65 78 28 7a 48 65 78 2c 20 6e 29 3b 0a  ToHex(zHex, n);.
2e20: 20 20 20 20 54 63 6c 5f 41 70 70 65 6e 64 52 65      Tcl_AppendRe
2e30: 73 75 6c 74 28 69 6e 74 65 72 70 2c 20 7a 48 65  sult(interp, zHe
2e40: 78 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 20  x, (char*)0);.  
2e50: 7d 0a 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 4f  }.  return TCL_O
2e60: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55 73 61 67  K;.}../*.** Usag
2e70: 65 3a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 65  e:    sqlite3_me
2e80: 6d 6f 72 79 5f 75 73 65 64 0a 2a 2a 0a 2a 2a 20  mory_used.**.** 
2e90: 52 61 77 20 74 65 73 74 20 69 6e 74 65 72 66 61  Raw test interfa
2ea0: 63 65 20 66 6f 72 20 73 71 6c 69 74 65 33 5f 6d  ce for sqlite3_m
2eb0: 65 6d 6f 72 79 5f 75 73 65 64 28 29 2e 0a 2a 2f  emory_used()..*/
2ec0: 0a 73 74 61 74 69 63 20 69 6e 74 20 53 51 4c 49  .static int SQLI
2ed0: 54 45 5f 54 43 4c 41 50 49 20 74 65 73 74 5f 6d  TE_TCLAPI test_m
2ee0: 65 6d 6f 72 79 5f 75 73 65 64 28 0a 20 20 76 6f  emory_used(.  vo
2ef0: 69 64 20 2a 20 63 6c 69 65 6e 74 44 61 74 61 2c  id * clientData,
2f00: 0a 20 20 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69  .  Tcl_Interp *i
2f10: 6e 74 65 72 70 2c 0a 20 20 69 6e 74 20 6f 62 6a  nterp,.  int obj
2f20: 63 2c 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f  c,.  Tcl_Obj *CO
2f30: 4e 53 54 20 6f 62 6a 76 5b 5d 0a 29 7b 0a 20 20  NST objv[].){.  
2f40: 54 63 6c 5f 53 65 74 4f 62 6a 52 65 73 75 6c 74  Tcl_SetObjResult
2f50: 28 69 6e 74 65 72 70 2c 20 54 63 6c 5f 4e 65 77  (interp, Tcl_New
2f60: 57 69 64 65 49 6e 74 4f 62 6a 28 73 71 6c 69 74  WideIntObj(sqlit
2f70: 65 33 5f 6d 65 6d 6f 72 79 5f 75 73 65 64 28 29  e3_memory_used()
2f80: 29 29 3b 0a 20 20 72 65 74 75 72 6e 20 54 43 4c  ));.  return TCL
2f90: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55 73  _OK;.}../*.** Us
2fa0: 61 67 65 3a 20 20 20 20 73 71 6c 69 74 65 33 5f  age:    sqlite3_
2fb0: 6d 65 6d 6f 72 79 5f 68 69 67 68 77 61 74 65 72  memory_highwater
2fc0: 20 3f 52 45 53 45 54 46 4c 41 47 3f 0a 2a 2a 0a   ?RESETFLAG?.**.
2fd0: 2a 2a 20 52 61 77 20 74 65 73 74 20 69 6e 74 65  ** Raw test inte
2fe0: 72 66 61 63 65 20 66 6f 72 20 73 71 6c 69 74 65  rface for sqlite
2ff0: 33 5f 6d 65 6d 6f 72 79 5f 68 69 67 68 77 61 74  3_memory_highwat
3000: 65 72 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  er()..*/.static 
3010: 69 6e 74 20 53 51 4c 49 54 45 5f 54 43 4c 41 50  int SQLITE_TCLAP
3020: 49 20 74 65 73 74 5f 6d 65 6d 6f 72 79 5f 68 69  I test_memory_hi
3030: 67 68 77 61 74 65 72 28 0a 20 20 76 6f 69 64 20  ghwater(.  void 
3040: 2a 20 63 6c 69 65 6e 74 44 61 74 61 2c 0a 20 20  * clientData,.  
3050: 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65  Tcl_Interp *inte
3060: 72 70 2c 0a 20 20 69 6e 74 20 6f 62 6a 63 2c 0a  rp,.  int objc,.
3070: 20 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54    Tcl_Obj *CONST
3080: 20 6f 62 6a 76 5b 5d 0a 29 7b 0a 20 20 69 6e 74   objv[].){.  int
3090: 20 72 65 73 65 74 46 6c 61 67 20 3d 20 30 3b 0a   resetFlag = 0;.
30a0: 20 20 69 66 28 20 6f 62 6a 63 21 3d 31 20 26 26    if( objc!=1 &&
30b0: 20 6f 62 6a 63 21 3d 32 20 29 7b 0a 20 20 20 20   objc!=2 ){.    
30c0: 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d 41 72 67 73  Tcl_WrongNumArgs
30d0: 28 69 6e 74 65 72 70 2c 20 31 2c 20 6f 62 6a 76  (interp, 1, objv
30e0: 2c 20 22 3f 52 45 53 45 54 3f 22 29 3b 0a 20 20  , "?RESET?");.  
30f0: 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45 52 52    return TCL_ERR
3100: 4f 52 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6f 62  OR;.  }.  if( ob
3110: 6a 63 3d 3d 32 20 29 7b 0a 20 20 20 20 69 66 28  jc==2 ){.    if(
3120: 20 54 63 6c 5f 47 65 74 42 6f 6f 6c 65 61 6e 46   Tcl_GetBooleanF
3130: 72 6f 6d 4f 62 6a 28 69 6e 74 65 72 70 2c 20 6f  romObj(interp, o
3140: 62 6a 76 5b 31 5d 2c 20 26 72 65 73 65 74 46 6c  bjv[1], &resetFl
3150: 61 67 29 20 29 20 72 65 74 75 72 6e 20 54 43 4c  ag) ) return TCL
3160: 5f 45 52 52 4f 52 3b 0a 20 20 7d 20 0a 20 20 54  _ERROR;.  } .  T
3170: 63 6c 5f 53 65 74 4f 62 6a 52 65 73 75 6c 74 28  cl_SetObjResult(
3180: 69 6e 74 65 72 70 2c 20 0a 20 20 20 20 20 54 63  interp, .     Tc
3190: 6c 5f 4e 65 77 57 69 64 65 49 6e 74 4f 62 6a 28  l_NewWideIntObj(
31a0: 73 71 6c 69 74 65 33 5f 6d 65 6d 6f 72 79 5f 68  sqlite3_memory_h
31b0: 69 67 68 77 61 74 65 72 28 72 65 73 65 74 46 6c  ighwater(resetFl
31c0: 61 67 29 29 29 3b 0a 20 20 72 65 74 75 72 6e 20  ag)));.  return 
31d0: 54 43 4c 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  TCL_OK;.}../*.**
31e0: 20 55 73 61 67 65 3a 20 20 20 20 73 71 6c 69 74   Usage:    sqlit
31f0: 65 33 5f 6d 65 6d 64 65 62 75 67 5f 62 61 63 6b  e3_memdebug_back
3200: 74 72 61 63 65 20 44 45 50 54 48 0a 2a 2a 0a 2a  trace DEPTH.**.*
3210: 2a 20 53 65 74 20 74 68 65 20 64 65 70 74 68 20  * Set the depth 
3220: 6f 66 20 62 61 63 6b 74 72 61 63 69 6e 67 2e 20  of backtracing. 
3230: 20 49 66 20 53 51 4c 49 54 45 5f 4d 45 4d 44 45   If SQLITE_MEMDE
3240: 42 55 47 20 69 73 20 6e 6f 74 20 64 65 66 69 6e  BUG is not defin
3250: 65 64 0a 2a 2a 20 74 68 65 6e 20 74 68 69 73 20  ed.** then this 
3260: 72 6f 75 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d  routine is a no-
3270: 6f 70 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  op..*/.static in
3280: 74 20 53 51 4c 49 54 45 5f 54 43 4c 41 50 49 20  t SQLITE_TCLAPI 
3290: 74 65 73 74 5f 6d 65 6d 64 65 62 75 67 5f 62 61  test_memdebug_ba
32a0: 63 6b 74 72 61 63 65 28 0a 20 20 76 6f 69 64 20  cktrace(.  void 
32b0: 2a 20 63 6c 69 65 6e 74 44 61 74 61 2c 0a 20 20  * clientData,.  
32c0: 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65  Tcl_Interp *inte
32d0: 72 70 2c 0a 20 20 69 6e 74 20 6f 62 6a 63 2c 0a  rp,.  int objc,.
32e0: 20 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54    Tcl_Obj *CONST
32f0: 20 6f 62 6a 76 5b 5d 0a 29 7b 0a 20 20 69 6e 74   objv[].){.  int
3300: 20 64 65 70 74 68 3b 0a 20 20 69 66 28 20 6f 62   depth;.  if( ob
3310: 6a 63 21 3d 32 20 29 7b 0a 20 20 20 20 54 63 6c  jc!=2 ){.    Tcl
3320: 5f 57 72 6f 6e 67 4e 75 6d 41 72 67 73 28 69 6e  _WrongNumArgs(in
3330: 74 65 72 70 2c 20 31 2c 20 6f 62 6a 76 2c 20 22  terp, 1, objv, "
3340: 44 45 50 54 22 29 3b 0a 20 20 20 20 72 65 74 75  DEPT");.    retu
3350: 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20  rn TCL_ERROR;.  
3360: 7d 0a 20 20 69 66 28 20 54 63 6c 5f 47 65 74 49  }.  if( Tcl_GetI
3370: 6e 74 46 72 6f 6d 4f 62 6a 28 69 6e 74 65 72 70  ntFromObj(interp
3380: 2c 20 6f 62 6a 76 5b 31 5d 2c 20 26 64 65 70 74  , objv[1], &dept
3390: 68 29 20 29 20 72 65 74 75 72 6e 20 54 43 4c 5f  h) ) return TCL_
33a0: 45 52 52 4f 52 3b 0a 23 69 66 64 65 66 20 53 51  ERROR;.#ifdef SQ
33b0: 4c 49 54 45 5f 4d 45 4d 44 45 42 55 47 0a 20 20  LITE_MEMDEBUG.  
33c0: 7b 0a 20 20 20 20 65 78 74 65 72 6e 20 76 6f 69  {.    extern voi
33d0: 64 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75  d sqlite3Memdebu
33e0: 67 42 61 63 6b 74 72 61 63 65 28 69 6e 74 29 3b  gBacktrace(int);
33f0: 0a 20 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 64  .    sqlite3Memd
3400: 65 62 75 67 42 61 63 6b 74 72 61 63 65 28 64 65  ebugBacktrace(de
3410: 70 74 68 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66  pth);.  }.#endif
3420: 0a 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 4f 4b  .  return TCL_OK
3430: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55 73 61 67 65  ;.}../*.** Usage
3440: 3a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 65 6d  :    sqlite3_mem
3450: 64 65 62 75 67 5f 64 75 6d 70 20 20 46 49 4c 45  debug_dump  FILE
3460: 4e 41 4d 45 0a 2a 2a 0a 2a 2a 20 57 72 69 74 65  NAME.**.** Write
3470: 20 61 20 73 75 6d 6d 61 72 79 20 6f 66 20 75 6e   a summary of un
3480: 66 72 65 65 64 20 6d 65 6d 6f 72 79 20 74 6f 20  freed memory to 
3490: 46 49 4c 45 4e 41 4d 45 2e 0a 2a 2f 0a 73 74 61  FILENAME..*/.sta
34a0: 74 69 63 20 69 6e 74 20 53 51 4c 49 54 45 5f 54  tic int SQLITE_T
34b0: 43 4c 41 50 49 20 74 65 73 74 5f 6d 65 6d 64 65  CLAPI test_memde
34c0: 62 75 67 5f 64 75 6d 70 28 0a 20 20 76 6f 69 64  bug_dump(.  void
34d0: 20 2a 20 63 6c 69 65 6e 74 44 61 74 61 2c 0a 20   * clientData,. 
34e0: 20 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74   Tcl_Interp *int
34f0: 65 72 70 2c 0a 20 20 69 6e 74 20 6f 62 6a 63 2c  erp,.  int objc,
3500: 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53  .  Tcl_Obj *CONS
3510: 54 20 6f 62 6a 76 5b 5d 0a 29 7b 0a 20 20 69 66  T objv[].){.  if
3520: 28 20 6f 62 6a 63 21 3d 32 20 29 7b 0a 20 20 20  ( objc!=2 ){.   
3530: 20 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d 41 72 67   Tcl_WrongNumArg
3540: 73 28 69 6e 74 65 72 70 2c 20 31 2c 20 6f 62 6a  s(interp, 1, obj
3550: 76 2c 20 22 46 49 4c 45 4e 41 4d 45 22 29 3b 0a  v, "FILENAME");.
3560: 20 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45      return TCL_E
3570: 52 52 4f 52 3b 0a 20 20 7d 0a 23 69 66 20 64 65  RROR;.  }.#if de
3580: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4d 45 4d  fined(SQLITE_MEM
3590: 44 45 42 55 47 29 20 7c 7c 20 64 65 66 69 6e 65  DEBUG) || define
35a0: 64 28 53 51 4c 49 54 45 5f 4d 45 4d 4f 52 59 5f  d(SQLITE_MEMORY_
35b0: 53 49 5a 45 29 20 5c 0a 20 20 20 20 20 7c 7c 20  SIZE) \.     || 
35c0: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 50  defined(SQLITE_P
35d0: 4f 57 32 5f 4d 45 4d 4f 52 59 5f 53 49 5a 45 29  OW2_MEMORY_SIZE)
35e0: 0a 20 20 7b 0a 20 20 20 20 65 78 74 65 72 6e 20  .  {.    extern 
35f0: 76 6f 69 64 20 73 71 6c 69 74 65 33 4d 65 6d 64  void sqlite3Memd
3600: 65 62 75 67 44 75 6d 70 28 63 6f 6e 73 74 20 63  ebugDump(const c
3610: 68 61 72 2a 29 3b 0a 20 20 20 20 73 71 6c 69 74  har*);.    sqlit
3620: 65 33 4d 65 6d 64 65 62 75 67 44 75 6d 70 28 54  e3MemdebugDump(T
3630: 63 6c 5f 47 65 74 53 74 72 69 6e 67 28 6f 62 6a  cl_GetString(obj
3640: 76 5b 31 5d 29 29 3b 0a 20 20 7d 0a 23 65 6e 64  v[1]));.  }.#end
3650: 69 66 0a 20 20 72 65 74 75 72 6e 20 54 43 4c 5f  if.  return TCL_
3660: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55 73 61  OK;.}../*.** Usa
3670: 67 65 3a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d  ge:    sqlite3_m
3680: 65 6d 64 65 62 75 67 5f 6d 61 6c 6c 6f 63 5f 63  emdebug_malloc_c
3690: 6f 75 6e 74 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72  ount.**.** Retur
36a0: 6e 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62  n the total numb
36b0: 65 72 20 6f 66 20 74 69 6d 65 73 20 6d 61 6c 6c  er of times mall
36c0: 6f 63 28 29 20 68 61 73 20 62 65 65 6e 20 63 61  oc() has been ca
36d0: 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  lled..*/.static 
36e0: 69 6e 74 20 53 51 4c 49 54 45 5f 54 43 4c 41 50  int SQLITE_TCLAP
36f0: 49 20 74 65 73 74 5f 6d 65 6d 64 65 62 75 67 5f  I test_memdebug_
3700: 6d 61 6c 6c 6f 63 5f 63 6f 75 6e 74 28 0a 20 20  malloc_count(.  
3710: 76 6f 69 64 20 2a 20 63 6c 69 65 6e 74 44 61 74  void * clientDat
3720: 61 2c 0a 20 20 54 63 6c 5f 49 6e 74 65 72 70 20  a,.  Tcl_Interp 
3730: 2a 69 6e 74 65 72 70 2c 0a 20 20 69 6e 74 20 6f  *interp,.  int o
3740: 62 6a 63 2c 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a  bjc,.  Tcl_Obj *
3750: 43 4f 4e 53 54 20 6f 62 6a 76 5b 5d 0a 29 7b 0a  CONST objv[].){.
3760: 20 20 69 6e 74 20 6e 4d 61 6c 6c 6f 63 20 3d 20    int nMalloc = 
3770: 2d 31 3b 0a 20 20 69 66 28 20 6f 62 6a 63 21 3d  -1;.  if( objc!=
3780: 31 20 29 7b 0a 20 20 20 20 54 63 6c 5f 57 72 6f  1 ){.    Tcl_Wro
3790: 6e 67 4e 75 6d 41 72 67 73 28 69 6e 74 65 72 70  ngNumArgs(interp
37a0: 2c 20 31 2c 20 6f 62 6a 76 2c 20 22 22 29 3b 0a  , 1, objv, "");.
37b0: 20 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45      return TCL_E
37c0: 52 52 4f 52 3b 0a 20 20 7d 0a 23 69 66 20 64 65  RROR;.  }.#if de
37d0: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4d 45 4d  fined(SQLITE_MEM
37e0: 44 45 42 55 47 29 0a 20 20 7b 0a 20 20 20 20 65  DEBUG).  {.    e
37f0: 78 74 65 72 6e 20 69 6e 74 20 73 71 6c 69 74 65  xtern int sqlite
3800: 33 4d 65 6d 64 65 62 75 67 4d 61 6c 6c 6f 63 43  3MemdebugMallocC
3810: 6f 75 6e 74 28 29 3b 0a 20 20 20 20 6e 4d 61 6c  ount();.    nMal
3820: 6c 6f 63 20 3d 20 73 71 6c 69 74 65 33 4d 65 6d  loc = sqlite3Mem
3830: 64 65 62 75 67 4d 61 6c 6c 6f 63 43 6f 75 6e 74  debugMallocCount
3840: 28 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20  ();.  }.#endif. 
3850: 20 54 63 6c 5f 53 65 74 4f 62 6a 52 65 73 75 6c   Tcl_SetObjResul
3860: 74 28 69 6e 74 65 72 70 2c 20 54 63 6c 5f 4e 65  t(interp, Tcl_Ne
3870: 77 49 6e 74 4f 62 6a 28 6e 4d 61 6c 6c 6f 63 29  wIntObj(nMalloc)
3880: 29 3b 0a 20 20 72 65 74 75 72 6e 20 54 43 4c 5f  );.  return TCL_
3890: 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 55 73  OK;.}.../*.** Us
38a0: 61 67 65 3a 20 20 20 20 73 71 6c 69 74 65 33 5f  age:    sqlite3_
38b0: 6d 65 6d 64 65 62 75 67 5f 66 61 69 6c 20 20 43  memdebug_fail  C
38c0: 4f 55 4e 54 45 52 20 20 3f 4f 50 54 49 4f 4e 53  OUNTER  ?OPTIONS
38d0: 3f 0a 2a 2a 0a 2a 2a 20 77 68 65 72 65 20 6f 70  ?.**.** where op
38e0: 74 69 6f 6e 73 20 61 72 65 3a 0a 2a 2a 0a 2a 2a  tions are:.**.**
38f0: 20 20 20 20 20 2d 72 65 70 65 61 74 20 20 20 20       -repeat    
3900: 3c 63 6f 75 6e 74 3e 0a 2a 2a 20 20 20 20 20 2d  <count>.**     -
3910: 62 65 6e 69 67 6e 63 6e 74 20 3c 76 61 72 6e 61  benigncnt <varna
3920: 6d 65 3e 0a 2a 2a 0a 2a 2a 20 41 72 72 61 6e 67  me>.**.** Arrang
3930: 65 20 66 6f 72 20 61 20 73 69 6d 75 6c 61 74 65  e for a simulate
3940: 64 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 75  d malloc() failu
3950: 72 65 20 61 66 74 65 72 20 43 4f 55 4e 54 45 52  re after COUNTER
3960: 20 73 75 63 63 65 73 73 65 73 2e 0a 2a 2a 20 49   successes..** I
3970: 66 20 61 20 72 65 70 65 61 74 20 63 6f 75 6e 74  f a repeat count
3980: 20 69 73 20 73 70 65 63 69 66 69 65 64 2c 20 74   is specified, t
3990: 68 65 20 66 61 75 6c 74 20 69 73 20 72 65 70 65  he fault is repe
39a0: 61 74 65 64 20 74 68 61 74 20 6d 61 6e 79 0a 2a  ated that many.*
39b0: 2a 20 74 69 6d 65 73 2e 0a 2a 2a 0a 2a 2a 20 45  * times..**.** E
39c0: 61 63 68 20 63 61 6c 6c 20 74 6f 20 74 68 69 73  ach call to this
39d0: 20 72 6f 75 74 69 6e 65 20 6f 76 65 72 72 69 64   routine overrid
39e0: 65 73 20 74 68 65 20 70 72 69 6f 72 20 63 6f 75  es the prior cou
39f0: 6e 74 65 72 20 76 61 6c 75 65 2e 0a 2a 2a 20 54  nter value..** T
3a00: 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 74 75  his routine retu
3a10: 72 6e 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f  rns the number o
3a20: 66 20 73 69 6d 75 6c 61 74 65 64 20 66 61 69 6c  f simulated fail
3a30: 75 72 65 73 20 74 68 61 74 20 68 61 76 65 0a 2a  ures that have.*
3a40: 2a 20 68 61 70 70 65 6e 65 64 20 73 69 6e 63 65  * happened since
3a50: 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 63 61   the previous ca
3a60: 6c 6c 20 74 6f 20 74 68 69 73 20 72 6f 75 74 69  ll to this routi
3a70: 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 6f 20 64 69 73  ne..**.** To dis
3a80: 61 62 6c 65 20 73 69 6d 75 6c 61 74 65 64 20 66  able simulated f
3a90: 61 69 6c 75 72 65 73 2c 20 75 73 65 20 61 20 43  ailures, use a C
3aa0: 4f 55 4e 54 45 52 20 6f 66 20 2d 31 2e 0a 2a 2f  OUNTER of -1..*/
3ab0: 0a 73 74 61 74 69 63 20 69 6e 74 20 53 51 4c 49  .static int SQLI
3ac0: 54 45 5f 54 43 4c 41 50 49 20 74 65 73 74 5f 6d  TE_TCLAPI test_m
3ad0: 65 6d 64 65 62 75 67 5f 66 61 69 6c 28 0a 20 20  emdebug_fail(.  
3ae0: 76 6f 69 64 20 2a 20 63 6c 69 65 6e 74 44 61 74  void * clientDat
3af0: 61 2c 0a 20 20 54 63 6c 5f 49 6e 74 65 72 70 20  a,.  Tcl_Interp 
3b00: 2a 69 6e 74 65 72 70 2c 0a 20 20 69 6e 74 20 6f  *interp,.  int o
3b10: 62 6a 63 2c 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a  bjc,.  Tcl_Obj *
3b20: 43 4f 4e 53 54 20 6f 62 6a 76 5b 5d 0a 29 7b 0a  CONST objv[].){.
3b30: 20 20 69 6e 74 20 69 69 3b 0a 20 20 69 6e 74 20    int ii;.  int 
3b40: 69 46 61 69 6c 3b 0a 20 20 69 6e 74 20 6e 52 65  iFail;.  int nRe
3b50: 70 65 61 74 20 3d 20 31 3b 0a 20 20 54 63 6c 5f  peat = 1;.  Tcl_
3b60: 4f 62 6a 20 2a 70 42 65 6e 69 67 6e 43 6e 74 20  Obj *pBenignCnt 
3b70: 3d 20 30 3b 0a 20 20 69 6e 74 20 6e 42 65 6e 69  = 0;.  int nBeni
3b80: 67 6e 3b 0a 20 20 69 6e 74 20 6e 46 61 69 6c 20  gn;.  int nFail 
3b90: 3d 20 30 3b 0a 0a 20 20 69 66 28 20 6f 62 6a 63  = 0;..  if( objc
3ba0: 3c 32 20 29 7b 0a 20 20 20 20 54 63 6c 5f 57 72  <2 ){.    Tcl_Wr
3bb0: 6f 6e 67 4e 75 6d 41 72 67 73 28 69 6e 74 65 72  ongNumArgs(inter
3bc0: 70 2c 20 31 2c 20 6f 62 6a 76 2c 20 22 43 4f 55  p, 1, objv, "COU
3bd0: 4e 54 45 52 20 3f 4f 50 54 49 4f 4e 53 3f 22 29  NTER ?OPTIONS?")
3be0: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 54 43 4c  ;.    return TCL
3bf0: 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 69 66  _ERROR;.  }.  if
3c00: 28 20 54 63 6c 5f 47 65 74 49 6e 74 46 72 6f 6d  ( Tcl_GetIntFrom
3c10: 4f 62 6a 28 69 6e 74 65 72 70 2c 20 6f 62 6a 76  Obj(interp, objv
3c20: 5b 31 5d 2c 20 26 69 46 61 69 6c 29 20 29 20 72  [1], &iFail) ) r
3c30: 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b  eturn TCL_ERROR;
3c40: 0a 0a 20 20 66 6f 72 28 69 69 3d 32 3b 20 69 69  ..  for(ii=2; ii
3c50: 3c 6f 62 6a 63 3b 20 69 69 2b 3d 32 29 7b 0a 20  <objc; ii+=2){. 
3c60: 20 20 20 69 6e 74 20 6e 4f 70 74 69 6f 6e 3b 0a     int nOption;.
3c70: 20 20 20 20 63 68 61 72 20 2a 7a 4f 70 74 69 6f      char *zOptio
3c80: 6e 20 3d 20 54 63 6c 5f 47 65 74 53 74 72 69 6e  n = Tcl_GetStrin
3c90: 67 46 72 6f 6d 4f 62 6a 28 6f 62 6a 76 5b 69 69  gFromObj(objv[ii
3ca0: 5d 2c 20 26 6e 4f 70 74 69 6f 6e 29 3b 0a 20 20  ], &nOption);.  
3cb0: 20 20 63 68 61 72 20 2a 7a 45 72 72 20 3d 20 30    char *zErr = 0
3cc0: 3b 0a 0a 20 20 20 20 69 66 28 20 6e 4f 70 74 69  ;..    if( nOpti
3cd0: 6f 6e 3e 31 20 26 26 20 73 74 72 6e 63 6d 70 28  on>1 && strncmp(
3ce0: 7a 4f 70 74 69 6f 6e 2c 20 22 2d 72 65 70 65 61  zOption, "-repea
3cf0: 74 22 2c 20 6e 4f 70 74 69 6f 6e 29 3d 3d 30 20  t", nOption)==0 
3d00: 29 7b 0a 20 20 20 20 20 20 69 66 28 20 69 69 3d  ){.      if( ii=
3d10: 3d 28 6f 62 6a 63 2d 31 29 20 29 7b 0a 20 20 20  =(objc-1) ){.   
3d20: 20 20 20 20 20 7a 45 72 72 20 3d 20 22 6f 70 74       zErr = "opt
3d30: 69 6f 6e 20 72 65 71 75 69 72 65 73 20 61 6e 20  ion requires an 
3d40: 61 72 67 75 6d 65 6e 74 3a 20 22 3b 0a 20 20 20  argument: ";.   
3d50: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
3d60: 20 20 69 66 28 20 54 63 6c 5f 47 65 74 49 6e 74    if( Tcl_GetInt
3d70: 46 72 6f 6d 4f 62 6a 28 69 6e 74 65 72 70 2c 20  FromObj(interp, 
3d80: 6f 62 6a 76 5b 69 69 2b 31 5d 2c 20 26 6e 52 65  objv[ii+1], &nRe
3d90: 70 65 61 74 29 20 29 7b 0a 20 20 20 20 20 20 20  peat) ){.       
3da0: 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45 52     return TCL_ER
3db0: 52 4f 52 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20  ROR;.        }. 
3dc0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65       }.    }else
3dd0: 20 69 66 28 20 6e 4f 70 74 69 6f 6e 3e 31 20 26   if( nOption>1 &
3de0: 26 20 73 74 72 6e 63 6d 70 28 7a 4f 70 74 69 6f  & strncmp(zOptio
3df0: 6e 2c 20 22 2d 62 65 6e 69 67 6e 63 6e 74 22 2c  n, "-benigncnt",
3e00: 20 6e 4f 70 74 69 6f 6e 29 3d 3d 30 20 29 7b 0a   nOption)==0 ){.
3e10: 20 20 20 20 20 20 69 66 28 20 69 69 3d 3d 28 6f        if( ii==(o
3e20: 62 6a 63 2d 31 29 20 29 7b 0a 20 20 20 20 20 20  bjc-1) ){.      
3e30: 20 20 7a 45 72 72 20 3d 20 22 6f 70 74 69 6f 6e    zErr = "option
3e40: 20 72 65 71 75 69 72 65 73 20 61 6e 20 61 72 67   requires an arg
3e50: 75 6d 65 6e 74 3a 20 22 3b 0a 20 20 20 20 20 20  ument: ";.      
3e60: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70  }else{.        p
3e70: 42 65 6e 69 67 6e 43 6e 74 20 3d 20 6f 62 6a 76  BenignCnt = objv
3e80: 5b 69 69 2b 31 5d 3b 0a 20 20 20 20 20 20 7d 0a  [ii+1];.      }.
3e90: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
3ea0: 20 7a 45 72 72 20 3d 20 22 75 6e 6b 6e 6f 77 6e   zErr = "unknown
3eb0: 20 6f 70 74 69 6f 6e 3a 20 22 3b 0a 20 20 20 20   option: ";.    
3ec0: 7d 0a 0a 20 20 20 20 69 66 28 20 7a 45 72 72 20  }..    if( zErr 
3ed0: 29 7b 0a 20 20 20 20 20 20 54 63 6c 5f 41 70 70  ){.      Tcl_App
3ee0: 65 6e 64 52 65 73 75 6c 74 28 69 6e 74 65 72 70  endResult(interp
3ef0: 2c 20 7a 45 72 72 2c 20 7a 4f 70 74 69 6f 6e 2c  , zErr, zOption,
3f00: 20 30 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72   0);.      retur
3f10: 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 20  n TCL_ERROR;.   
3f20: 20 7d 0a 20 20 7d 0a 20 20 0a 20 20 6e 42 65 6e   }.  }.  .  nBen
3f30: 69 67 6e 20 3d 20 66 61 75 6c 74 73 69 6d 42 65  ign = faultsimBe
3f40: 6e 69 67 6e 46 61 69 6c 75 72 65 73 28 29 3b 0a  nignFailures();.
3f50: 20 20 6e 46 61 69 6c 20 3d 20 66 61 75 6c 74 73    nFail = faults
3f60: 69 6d 46 61 69 6c 75 72 65 73 28 29 3b 0a 20 20  imFailures();.  
3f70: 66 61 75 6c 74 73 69 6d 43 6f 6e 66 69 67 28 69  faultsimConfig(i
3f80: 46 61 69 6c 2c 20 6e 52 65 70 65 61 74 29 3b 0a  Fail, nRepeat);.
3f90: 0a 20 20 69 66 28 20 70 42 65 6e 69 67 6e 43 6e  .  if( pBenignCn
3fa0: 74 20 29 7b 0a 20 20 20 20 54 63 6c 5f 4f 62 6a  t ){.    Tcl_Obj
3fb0: 53 65 74 56 61 72 32 28 69 6e 74 65 72 70 2c 20  SetVar2(interp, 
3fc0: 70 42 65 6e 69 67 6e 43 6e 74 2c 20 30 2c 20 54  pBenignCnt, 0, T
3fd0: 63 6c 5f 4e 65 77 49 6e 74 4f 62 6a 28 6e 42 65  cl_NewIntObj(nBe
3fe0: 6e 69 67 6e 29 2c 20 30 29 3b 0a 20 20 7d 0a 20  nign), 0);.  }. 
3ff0: 20 54 63 6c 5f 53 65 74 4f 62 6a 52 65 73 75 6c   Tcl_SetObjResul
4000: 74 28 69 6e 74 65 72 70 2c 20 54 63 6c 5f 4e 65  t(interp, Tcl_Ne
4010: 77 49 6e 74 4f 62 6a 28 6e 46 61 69 6c 29 29 3b  wIntObj(nFail));
4020: 0a 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 4f 4b  .  return TCL_OK
4030: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55 73 61 67 65  ;.}../*.** Usage
4040: 3a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 65 6d  :    sqlite3_mem
4050: 64 65 62 75 67 5f 70 65 6e 64 69 6e 67 0a 2a 2a  debug_pending.**
4060: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e  .** Return the n
4070: 75 6d 62 65 72 20 6f 66 20 6d 61 6c 6c 6f 63 28  umber of malloc(
4080: 29 20 63 61 6c 6c 73 20 74 68 61 74 20 77 69 6c  ) calls that wil
4090: 6c 20 73 75 63 63 65 65 64 20 62 65 66 6f 72 65  l succeed before
40a0: 20 61 20 0a 2a 2a 20 73 69 6d 75 6c 61 74 65 64   a .** simulated
40b0: 20 66 61 69 6c 75 72 65 20 6f 63 63 75 72 73 2e   failure occurs.
40c0: 20 41 20 6e 65 67 61 74 69 76 65 20 72 65 74 75   A negative retu
40d0: 72 6e 20 76 61 6c 75 65 20 69 6e 64 69 63 61 74  rn value indicat
40e0: 65 73 20 74 68 61 74 0a 2a 2a 20 6e 6f 20 6d 61  es that.** no ma
40f0: 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72 65 20 69  lloc() failure i
4100: 73 20 73 63 68 65 64 75 6c 65 64 2e 0a 2a 2f 0a  s scheduled..*/.
4110: 73 74 61 74 69 63 20 69 6e 74 20 53 51 4c 49 54  static int SQLIT
4120: 45 5f 54 43 4c 41 50 49 20 74 65 73 74 5f 6d 65  E_TCLAPI test_me
4130: 6d 64 65 62 75 67 5f 70 65 6e 64 69 6e 67 28 0a  mdebug_pending(.
4140: 20 20 76 6f 69 64 20 2a 20 63 6c 69 65 6e 74 44    void * clientD
4150: 61 74 61 2c 0a 20 20 54 63 6c 5f 49 6e 74 65 72  ata,.  Tcl_Inter
4160: 70 20 2a 69 6e 74 65 72 70 2c 0a 20 20 69 6e 74  p *interp,.  int
4170: 20 6f 62 6a 63 2c 0a 20 20 54 63 6c 5f 4f 62 6a   objc,.  Tcl_Obj
4180: 20 2a 43 4f 4e 53 54 20 6f 62 6a 76 5b 5d 0a 29   *CONST objv[].)
4190: 7b 0a 20 20 69 6e 74 20 6e 50 65 6e 64 69 6e 67  {.  int nPending
41a0: 3b 0a 20 20 69 66 28 20 6f 62 6a 63 21 3d 31 20  ;.  if( objc!=1 
41b0: 29 7b 0a 20 20 20 20 54 63 6c 5f 57 72 6f 6e 67  ){.    Tcl_Wrong
41c0: 4e 75 6d 41 72 67 73 28 69 6e 74 65 72 70 2c 20  NumArgs(interp, 
41d0: 31 2c 20 6f 62 6a 76 2c 20 22 22 29 3b 0a 20 20  1, objv, "");.  
41e0: 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45 52 52    return TCL_ERR
41f0: 4f 52 3b 0a 20 20 7d 0a 20 20 6e 50 65 6e 64 69  OR;.  }.  nPendi
4200: 6e 67 20 3d 20 66 61 75 6c 74 73 69 6d 50 65 6e  ng = faultsimPen
4210: 64 69 6e 67 28 29 3b 0a 20 20 54 63 6c 5f 53 65  ding();.  Tcl_Se
4220: 74 4f 62 6a 52 65 73 75 6c 74 28 69 6e 74 65 72  tObjResult(inter
4230: 70 2c 20 54 63 6c 5f 4e 65 77 49 6e 74 4f 62 6a  p, Tcl_NewIntObj
4240: 28 6e 50 65 6e 64 69 6e 67 29 29 3b 0a 20 20 72  (nPending));.  r
4250: 65 74 75 72 6e 20 54 43 4c 5f 4f 4b 3b 0a 7d 0a  eturn TCL_OK;.}.
4260: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f  ./*.** The follo
4270: 77 69 6e 67 20 67 6c 6f 62 61 6c 20 76 61 72 69  wing global vari
4280: 61 62 6c 65 20 6b 65 65 70 73 20 74 72 61 63 6b  able keeps track
4290: 20 6f 66 20 74 68 65 20 6e 75 6d 62 65 72 20 6f   of the number o
42a0: 66 20 74 65 73 74 73 0a 2a 2a 20 74 68 61 74 20  f tests.** that 
42b0: 68 61 76 65 20 72 75 6e 2e 20 20 54 68 69 73 20  have run.  This 
42c0: 76 61 72 69 61 62 6c 65 20 69 73 20 6f 6e 6c 79  variable is only
42d0: 20 75 73 65 66 75 6c 20 77 68 65 6e 20 72 75 6e   useful when run
42e0: 6e 69 6e 67 20 69 6e 20 74 68 65 0a 2a 2a 20 64  ning in the.** d
42f0: 65 62 75 67 67 65 72 2e 0a 2a 2f 0a 73 74 61 74  ebugger..*/.stat
4300: 69 63 20 69 6e 74 20 73 71 6c 69 74 65 33 5f 6d  ic int sqlite3_m
4310: 65 6d 64 65 62 75 67 5f 74 69 74 6c 65 5f 63 6f  emdebug_title_co
4320: 75 6e 74 20 3d 20 30 3b 0a 0a 2f 2a 0a 2a 2a 20  unt = 0;../*.** 
4330: 55 73 61 67 65 3a 20 20 20 20 73 71 6c 69 74 65  Usage:    sqlite
4340: 33 5f 6d 65 6d 64 65 62 75 67 5f 73 65 74 74 69  3_memdebug_setti
4350: 74 6c 65 20 54 49 54 4c 45 0a 2a 2a 0a 2a 2a 20  tle TITLE.**.** 
4360: 53 65 74 20 61 20 74 69 74 6c 65 20 73 74 72 69  Set a title stri
4370: 6e 67 20 73 74 6f 72 65 64 20 77 69 74 68 20 65  ng stored with e
4380: 61 63 68 20 61 6c 6c 6f 63 61 74 69 6f 6e 2e 20  ach allocation. 
4390: 20 54 68 65 20 54 49 54 4c 45 20 69 73 0a 2a 2a   The TITLE is.**
43a0: 20 74 79 70 69 63 61 6c 6c 79 20 74 68 65 20 6e   typically the n
43b0: 61 6d 65 20 6f 66 20 74 68 65 20 74 65 73 74 20  ame of the test 
43c0: 74 68 61 74 20 77 61 73 20 72 75 6e 6e 69 6e 67  that was running
43d0: 20 77 68 65 6e 20 74 68 65 0a 2a 2a 20 61 6c 6c   when the.** all
43e0: 6f 63 61 74 69 6f 6e 20 6f 63 63 75 72 72 65 64  ocation occurred
43f0: 2e 20 20 54 68 65 20 54 49 54 4c 45 20 69 73 20  .  The TITLE is 
4400: 73 74 6f 72 65 64 20 77 69 74 68 20 74 68 65 20  stored with the 
4410: 61 6c 6c 6f 63 61 74 69 6f 6e 0a 2a 2a 20 61 6e  allocation.** an
4420: 64 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f  d can be used to
4430: 20 66 69 67 75 72 65 20 6f 75 74 20 77 68 69 63   figure out whic
4440: 68 20 74 65 73 74 73 20 61 72 65 20 6c 65 61 6b  h tests are leak
4450: 69 6e 67 20 6d 65 6d 6f 72 79 2e 0a 2a 2a 0a 2a  ing memory..**.*
4460: 2a 20 45 61 63 68 20 74 69 74 6c 65 20 6f 76 65  * Each title ove
4470: 72 77 72 69 74 65 20 74 68 65 20 70 72 65 76 69  rwrite the previ
4480: 6f 75 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ous..*/.static i
4490: 6e 74 20 53 51 4c 49 54 45 5f 54 43 4c 41 50 49  nt SQLITE_TCLAPI
44a0: 20 74 65 73 74 5f 6d 65 6d 64 65 62 75 67 5f 73   test_memdebug_s
44b0: 65 74 74 69 74 6c 65 28 0a 20 20 76 6f 69 64 20  ettitle(.  void 
44c0: 2a 20 63 6c 69 65 6e 74 44 61 74 61 2c 0a 20 20  * clientData,.  
44d0: 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65  Tcl_Interp *inte
44e0: 72 70 2c 0a 20 20 69 6e 74 20 6f 62 6a 63 2c 0a  rp,.  int objc,.
44f0: 20 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54    Tcl_Obj *CONST
4500: 20 6f 62 6a 76 5b 5d 0a 29 7b 0a 20 20 73 71 6c   objv[].){.  sql
4510: 69 74 65 33 5f 6d 65 6d 64 65 62 75 67 5f 74 69  ite3_memdebug_ti
4520: 74 6c 65 5f 63 6f 75 6e 74 2b 2b 3b 0a 20 20 69  tle_count++;.  i
4530: 66 28 20 6f 62 6a 63 21 3d 32 20 29 7b 0a 20 20  f( objc!=2 ){.  
4540: 20 20 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d 41 72    Tcl_WrongNumAr
4550: 67 73 28 69 6e 74 65 72 70 2c 20 31 2c 20 6f 62  gs(interp, 1, ob
4560: 6a 76 2c 20 22 54 49 54 4c 45 22 29 3b 0a 20 20  jv, "TITLE");.  
4570: 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45 52 52    return TCL_ERR
4580: 4f 52 3b 0a 20 20 7d 0a 23 69 66 64 65 66 20 53  OR;.  }.#ifdef S
4590: 51 4c 49 54 45 5f 4d 45 4d 44 45 42 55 47 0a 20  QLITE_MEMDEBUG. 
45a0: 20 7b 0a 20 20 20 20 63 6f 6e 73 74 20 63 68 61   {.    const cha
45b0: 72 20 2a 7a 54 69 74 6c 65 3b 0a 20 20 20 20 65  r *zTitle;.    e
45c0: 78 74 65 72 6e 20 69 6e 74 20 73 71 6c 69 74 65  xtern int sqlite
45d0: 33 4d 65 6d 64 65 62 75 67 53 65 74 74 69 74 6c  3MemdebugSettitl
45e0: 65 28 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a  e(const char*);.
45f0: 20 20 20 20 7a 54 69 74 6c 65 20 3d 20 54 63 6c      zTitle = Tcl
4600: 5f 47 65 74 53 74 72 69 6e 67 28 6f 62 6a 76 5b  _GetString(objv[
4610: 31 5d 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  1]);.    sqlite3
4620: 4d 65 6d 64 65 62 75 67 53 65 74 74 69 74 6c 65  MemdebugSettitle
4630: 28 7a 54 69 74 6c 65 29 3b 0a 20 20 7d 0a 23 65  (zTitle);.  }.#e
4640: 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20 54 43  ndif.  return TC
4650: 4c 5f 4f 4b 3b 0a 7d 0a 0a 23 64 65 66 69 6e 65  L_OK;.}..#define
4660: 20 4d 41 4c 4c 4f 43 5f 4c 4f 47 5f 46 52 41 4d   MALLOC_LOG_FRAM
4670: 45 53 20 20 31 30 20 0a 23 64 65 66 69 6e 65 20  ES  10 .#define 
4680: 4d 41 4c 4c 4f 43 5f 4c 4f 47 5f 4b 45 59 49 4e  MALLOC_LOG_KEYIN
4690: 54 53 20 28 20 20 20 20 20 20 20 20 20 20 20 20  TS (            
46a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
46b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
46c0: 20 20 5c 0a 20 20 20 20 31 30 20 2a 20 28 28 73    \.    10 * ((s
46d0: 69 7a 65 6f 66 28 69 6e 74 29 3e 3d 73 69 7a 65  izeof(int)>=size
46e0: 6f 66 28 76 6f 69 64 2a 29 29 20 3f 20 31 20 3a  of(void*)) ? 1 :
46f0: 20 73 69 7a 65 6f 66 28 76 6f 69 64 2a 29 2f 73   sizeof(void*)/s
4700: 69 7a 65 6f 66 28 69 6e 74 29 29 20 20 20 5c 0a  izeof(int))   \.
4710: 29 0a 73 74 61 74 69 63 20 54 63 6c 5f 48 61 73  ).static Tcl_Has
4720: 68 54 61 62 6c 65 20 61 4d 61 6c 6c 6f 63 4c 6f  hTable aMallocLo
4730: 67 3b 0a 73 74 61 74 69 63 20 69 6e 74 20 6d 61  g;.static int ma
4740: 6c 6c 6f 63 4c 6f 67 45 6e 61 62 6c 65 64 20 3d  llocLogEnabled =
4750: 20 30 3b 0a 0a 74 79 70 65 64 65 66 20 73 74 72   0;..typedef str
4760: 75 63 74 20 4d 61 6c 6c 6f 63 4c 6f 67 20 4d 61  uct MallocLog Ma
4770: 6c 6c 6f 63 4c 6f 67 3b 0a 73 74 72 75 63 74 20  llocLog;.struct 
4780: 4d 61 6c 6c 6f 63 4c 6f 67 20 7b 0a 20 20 69 6e  MallocLog {.  in
4790: 74 20 6e 43 61 6c 6c 3b 0a 20 20 69 6e 74 20 6e  t nCall;.  int n
47a0: 42 79 74 65 3b 0a 7d 3b 0a 0a 23 69 66 64 65 66  Byte;.};..#ifdef
47b0: 20 53 51 4c 49 54 45 5f 4d 45 4d 44 45 42 55 47   SQLITE_MEMDEBUG
47c0: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 74 65 73  .static void tes
47d0: 74 5f 6d 65 6d 64 65 62 75 67 5f 63 61 6c 6c 62  t_memdebug_callb
47e0: 61 63 6b 28 69 6e 74 20 6e 42 79 74 65 2c 20 69  ack(int nByte, i
47f0: 6e 74 20 6e 46 72 61 6d 65 2c 20 76 6f 69 64 20  nt nFrame, void 
4800: 2a 2a 61 46 72 61 6d 65 29 7b 0a 20 20 69 66 28  **aFrame){.  if(
4810: 20 6d 61 6c 6c 6f 63 4c 6f 67 45 6e 61 62 6c 65   mallocLogEnable
4820: 64 20 29 7b 0a 20 20 20 20 4d 61 6c 6c 6f 63 4c  d ){.    MallocL
4830: 6f 67 20 2a 70 4c 6f 67 3b 0a 20 20 20 20 54 63  og *pLog;.    Tc
4840: 6c 5f 48 61 73 68 45 6e 74 72 79 20 2a 70 45 6e  l_HashEntry *pEn
4850: 74 72 79 3b 0a 20 20 20 20 69 6e 74 20 69 73 4e  try;.    int isN
4860: 65 77 3b 0a 0a 20 20 20 20 69 6e 74 20 61 4b 65  ew;..    int aKe
4870: 79 5b 4d 41 4c 4c 4f 43 5f 4c 4f 47 5f 4b 45 59  y[MALLOC_LOG_KEY
4880: 49 4e 54 53 5d 3b 0a 20 20 20 20 75 6e 73 69 67  INTS];.    unsig
4890: 6e 65 64 20 69 6e 74 20 6e 4b 65 79 20 3d 20 73  ned int nKey = s
48a0: 69 7a 65 6f 66 28 69 6e 74 29 2a 4d 41 4c 4c 4f  izeof(int)*MALLO
48b0: 43 5f 4c 4f 47 5f 4b 45 59 49 4e 54 53 3b 0a 0a  C_LOG_KEYINTS;..
48c0: 20 20 20 20 6d 65 6d 73 65 74 28 61 4b 65 79 2c      memset(aKey,
48d0: 20 30 2c 20 6e 4b 65 79 29 3b 0a 20 20 20 20 69   0, nKey);.    i
48e0: 66 28 20 28 73 69 7a 65 6f 66 28 76 6f 69 64 2a  f( (sizeof(void*
48f0: 29 2a 6e 46 72 61 6d 65 29 3c 6e 4b 65 79 20 29  )*nFrame)<nKey )
4900: 7b 0a 20 20 20 20 20 20 6e 4b 65 79 20 3d 20 6e  {.      nKey = n
4910: 46 72 61 6d 65 2a 73 69 7a 65 6f 66 28 76 6f 69  Frame*sizeof(voi
4920: 64 2a 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6d  d*);.    }.    m
4930: 65 6d 63 70 79 28 61 4b 65 79 2c 20 61 46 72 61  emcpy(aKey, aFra
4940: 6d 65 2c 20 6e 4b 65 79 29 3b 0a 0a 20 20 20 20  me, nKey);..    
4950: 70 45 6e 74 72 79 20 3d 20 54 63 6c 5f 43 72 65  pEntry = Tcl_Cre
4960: 61 74 65 48 61 73 68 45 6e 74 72 79 28 26 61 4d  ateHashEntry(&aM
4970: 61 6c 6c 6f 63 4c 6f 67 2c 20 28 63 6f 6e 73 74  allocLog, (const
4980: 20 63 68 61 72 20 2a 29 61 4b 65 79 2c 20 26 69   char *)aKey, &i
4990: 73 4e 65 77 29 3b 0a 20 20 20 20 69 66 28 20 69  sNew);.    if( i
49a0: 73 4e 65 77 20 29 7b 0a 20 20 20 20 20 20 70 4c  sNew ){.      pL
49b0: 6f 67 20 3d 20 28 4d 61 6c 6c 6f 63 4c 6f 67 20  og = (MallocLog 
49c0: 2a 29 54 63 6c 5f 41 6c 6c 6f 63 28 73 69 7a 65  *)Tcl_Alloc(size
49d0: 6f 66 28 4d 61 6c 6c 6f 63 4c 6f 67 29 29 3b 0a  of(MallocLog));.
49e0: 20 20 20 20 20 20 6d 65 6d 73 65 74 28 70 4c 6f        memset(pLo
49f0: 67 2c 20 30 2c 20 73 69 7a 65 6f 66 28 4d 61 6c  g, 0, sizeof(Mal
4a00: 6c 6f 63 4c 6f 67 29 29 3b 0a 20 20 20 20 20 20  locLog));.      
4a10: 54 63 6c 5f 53 65 74 48 61 73 68 56 61 6c 75 65  Tcl_SetHashValue
4a20: 28 70 45 6e 74 72 79 2c 20 28 43 6c 69 65 6e 74  (pEntry, (Client
4a30: 44 61 74 61 29 70 4c 6f 67 29 3b 0a 20 20 20 20  Data)pLog);.    
4a40: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 4c 6f  }else{.      pLo
4a50: 67 20 3d 20 28 4d 61 6c 6c 6f 63 4c 6f 67 20 2a  g = (MallocLog *
4a60: 29 54 63 6c 5f 47 65 74 48 61 73 68 56 61 6c 75  )Tcl_GetHashValu
4a70: 65 28 70 45 6e 74 72 79 29 3b 0a 20 20 20 20 7d  e(pEntry);.    }
4a80: 0a 0a 20 20 20 20 70 4c 6f 67 2d 3e 6e 43 61 6c  ..    pLog->nCal
4a90: 6c 2b 2b 3b 0a 20 20 20 20 70 4c 6f 67 2d 3e 6e  l++;.    pLog->n
4aa0: 42 79 74 65 20 2b 3d 20 6e 42 79 74 65 3b 0a 20  Byte += nByte;. 
4ab0: 20 7d 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53   }.}.#endif /* S
4ac0: 51 4c 49 54 45 5f 4d 45 4d 44 45 42 55 47 20 2a  QLITE_MEMDEBUG *
4ad0: 2f 0a 0a 73 74 61 74 69 63 20 76 6f 69 64 20 74  /..static void t
4ae0: 65 73 74 5f 6d 65 6d 64 65 62 75 67 5f 6c 6f 67  est_memdebug_log
4af0: 5f 63 6c 65 61 72 28 76 6f 69 64 29 7b 0a 20 20  _clear(void){.  
4b00: 54 63 6c 5f 48 61 73 68 53 65 61 72 63 68 20 73  Tcl_HashSearch s
4b10: 65 61 72 63 68 3b 0a 20 20 54 63 6c 5f 48 61 73  earch;.  Tcl_Has
4b20: 68 45 6e 74 72 79 20 2a 70 45 6e 74 72 79 3b 0a  hEntry *pEntry;.
4b30: 20 20 66 6f 72 28 0a 20 20 20 20 70 45 6e 74 72    for(.    pEntr
4b40: 79 3d 54 63 6c 5f 46 69 72 73 74 48 61 73 68 45  y=Tcl_FirstHashE
4b50: 6e 74 72 79 28 26 61 4d 61 6c 6c 6f 63 4c 6f 67  ntry(&aMallocLog
4b60: 2c 20 26 73 65 61 72 63 68 29 3b 0a 20 20 20 20  , &search);.    
4b70: 70 45 6e 74 72 79 3b 0a 20 20 20 20 70 45 6e 74  pEntry;.    pEnt
4b80: 72 79 3d 54 63 6c 5f 4e 65 78 74 48 61 73 68 45  ry=Tcl_NextHashE
4b90: 6e 74 72 79 28 26 73 65 61 72 63 68 29 0a 20 20  ntry(&search).  
4ba0: 29 7b 0a 20 20 20 20 4d 61 6c 6c 6f 63 4c 6f 67  ){.    MallocLog
4bb0: 20 2a 70 4c 6f 67 20 3d 20 28 4d 61 6c 6c 6f 63   *pLog = (Malloc
4bc0: 4c 6f 67 20 2a 29 54 63 6c 5f 47 65 74 48 61 73  Log *)Tcl_GetHas
4bd0: 68 56 61 6c 75 65 28 70 45 6e 74 72 79 29 3b 0a  hValue(pEntry);.
4be0: 20 20 20 20 54 63 6c 5f 46 72 65 65 28 28 63 68      Tcl_Free((ch
4bf0: 61 72 20 2a 29 70 4c 6f 67 29 3b 0a 20 20 7d 0a  ar *)pLog);.  }.
4c00: 20 20 54 63 6c 5f 44 65 6c 65 74 65 48 61 73 68    Tcl_DeleteHash
4c10: 54 61 62 6c 65 28 26 61 4d 61 6c 6c 6f 63 4c 6f  Table(&aMallocLo
4c20: 67 29 3b 0a 20 20 54 63 6c 5f 49 6e 69 74 48 61  g);.  Tcl_InitHa
4c30: 73 68 54 61 62 6c 65 28 26 61 4d 61 6c 6c 6f 63  shTable(&aMalloc
4c40: 4c 6f 67 2c 20 4d 41 4c 4c 4f 43 5f 4c 4f 47 5f  Log, MALLOC_LOG_
4c50: 4b 45 59 49 4e 54 53 29 3b 0a 7d 0a 0a 73 74 61  KEYINTS);.}..sta
4c60: 74 69 63 20 69 6e 74 20 53 51 4c 49 54 45 5f 54  tic int SQLITE_T
4c70: 43 4c 41 50 49 20 74 65 73 74 5f 6d 65 6d 64 65  CLAPI test_memde
4c80: 62 75 67 5f 6c 6f 67 28 0a 20 20 76 6f 69 64 20  bug_log(.  void 
4c90: 2a 20 63 6c 69 65 6e 74 44 61 74 61 2c 0a 20 20  * clientData,.  
4ca0: 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65  Tcl_Interp *inte
4cb0: 72 70 2c 0a 20 20 69 6e 74 20 6f 62 6a 63 2c 0a  rp,.  int objc,.
4cc0: 20 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54    Tcl_Obj *CONST
4cd0: 20 6f 62 6a 76 5b 5d 0a 29 7b 0a 20 20 73 74 61   objv[].){.  sta
4ce0: 74 69 63 20 69 6e 74 20 69 73 49 6e 69 74 20 3d  tic int isInit =
4cf0: 20 30 3b 0a 20 20 69 6e 74 20 69 53 75 62 3b 0a   0;.  int iSub;.
4d00: 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20  .  static const 
4d10: 63 68 61 72 20 2a 4d 42 5f 73 74 72 73 5b 5d 20  char *MB_strs[] 
4d20: 3d 20 7b 20 22 73 74 61 72 74 22 2c 20 22 73 74  = { "start", "st
4d30: 6f 70 22 2c 20 22 64 75 6d 70 22 2c 20 22 63 6c  op", "dump", "cl
4d40: 65 61 72 22 2c 20 22 73 79 6e 63 22 20 7d 3b 0a  ear", "sync" };.
4d50: 20 20 65 6e 75 6d 20 4d 42 5f 65 6e 75 6d 20 7b    enum MB_enum {
4d60: 20 0a 20 20 20 20 20 20 4d 42 5f 4c 4f 47 5f 53   .      MB_LOG_S
4d70: 54 41 52 54 2c 20 4d 42 5f 4c 4f 47 5f 53 54 4f  TART, MB_LOG_STO
4d80: 50 2c 20 4d 42 5f 4c 4f 47 5f 44 55 4d 50 2c 20  P, MB_LOG_DUMP, 
4d90: 4d 42 5f 4c 4f 47 5f 43 4c 45 41 52 2c 20 4d 42  MB_LOG_CLEAR, MB
4da0: 5f 4c 4f 47 5f 53 59 4e 43 20 0a 20 20 7d 3b 0a  _LOG_SYNC .  };.
4db0: 0a 20 20 69 66 28 20 21 69 73 49 6e 69 74 20 29  .  if( !isInit )
4dc0: 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  {.#ifdef SQLITE_
4dd0: 4d 45 4d 44 45 42 55 47 0a 20 20 20 20 65 78 74  MEMDEBUG.    ext
4de0: 65 72 6e 20 76 6f 69 64 20 73 71 6c 69 74 65 33  ern void sqlite3
4df0: 4d 65 6d 64 65 62 75 67 42 61 63 6b 74 72 61 63  MemdebugBacktrac
4e00: 65 43 61 6c 6c 62 61 63 6b 28 0a 20 20 20 20 20  eCallback(.     
4e10: 20 20 20 76 6f 69 64 20 28 2a 78 42 61 63 6b 74     void (*xBackt
4e20: 72 61 63 65 29 28 69 6e 74 2c 20 69 6e 74 2c 20  race)(int, int, 
4e30: 76 6f 69 64 20 2a 2a 29 29 3b 0a 20 20 20 20 73  void **));.    s
4e40: 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 42 61  qlite3MemdebugBa
4e50: 63 6b 74 72 61 63 65 43 61 6c 6c 62 61 63 6b 28  cktraceCallback(
4e60: 74 65 73 74 5f 6d 65 6d 64 65 62 75 67 5f 63 61  test_memdebug_ca
4e70: 6c 6c 62 61 63 6b 29 3b 0a 23 65 6e 64 69 66 0a  llback);.#endif.
4e80: 20 20 20 20 54 63 6c 5f 49 6e 69 74 48 61 73 68      Tcl_InitHash
4e90: 54 61 62 6c 65 28 26 61 4d 61 6c 6c 6f 63 4c 6f  Table(&aMallocLo
4ea0: 67 2c 20 4d 41 4c 4c 4f 43 5f 4c 4f 47 5f 4b 45  g, MALLOC_LOG_KE
4eb0: 59 49 4e 54 53 29 3b 0a 20 20 20 20 69 73 49 6e  YINTS);.    isIn
4ec0: 69 74 20 3d 20 31 3b 0a 20 20 7d 0a 0a 20 20 69  it = 1;.  }..  i
4ed0: 66 28 20 6f 62 6a 63 3c 32 20 29 7b 0a 20 20 20  f( objc<2 ){.   
4ee0: 20 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d 41 72 67   Tcl_WrongNumArg
4ef0: 73 28 69 6e 74 65 72 70 2c 20 31 2c 20 6f 62 6a  s(interp, 1, obj
4f00: 76 2c 20 22 53 55 42 2d 43 4f 4d 4d 41 4e 44 20  v, "SUB-COMMAND 
4f10: 2e 2e 2e 22 29 3b 0a 20 20 7d 0a 20 20 69 66 28  ...");.  }.  if(
4f20: 20 54 63 6c 5f 47 65 74 49 6e 64 65 78 46 72 6f   Tcl_GetIndexFro
4f30: 6d 4f 62 6a 28 69 6e 74 65 72 70 2c 20 6f 62 6a  mObj(interp, obj
4f40: 76 5b 31 5d 2c 20 4d 42 5f 73 74 72 73 2c 20 22  v[1], MB_strs, "
4f50: 73 75 62 2d 63 6f 6d 6d 61 6e 64 22 2c 20 30 2c  sub-command", 0,
4f60: 20 26 69 53 75 62 29 20 29 7b 0a 20 20 20 20 72   &iSub) ){.    r
4f70: 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b  eturn TCL_ERROR;
4f80: 0a 20 20 7d 0a 0a 20 20 73 77 69 74 63 68 28 20  .  }..  switch( 
4f90: 28 65 6e 75 6d 20 4d 42 5f 65 6e 75 6d 29 69 53  (enum MB_enum)iS
4fa0: 75 62 20 29 7b 0a 20 20 20 20 63 61 73 65 20 4d  ub ){.    case M
4fb0: 42 5f 4c 4f 47 5f 53 54 41 52 54 3a 0a 20 20 20  B_LOG_START:.   
4fc0: 20 20 20 6d 61 6c 6c 6f 63 4c 6f 67 45 6e 61 62     mallocLogEnab
4fd0: 6c 65 64 20 3d 20 31 3b 0a 20 20 20 20 20 20 62  led = 1;.      b
4fe0: 72 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 4d  reak;.    case M
4ff0: 42 5f 4c 4f 47 5f 53 54 4f 50 3a 0a 20 20 20 20  B_LOG_STOP:.    
5000: 20 20 6d 61 6c 6c 6f 63 4c 6f 67 45 6e 61 62 6c    mallocLogEnabl
5010: 65 64 20 3d 20 30 3b 0a 20 20 20 20 20 20 62 72  ed = 0;.      br
5020: 65 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 4d 42  eak;.    case MB
5030: 5f 4c 4f 47 5f 44 55 4d 50 3a 20 7b 0a 20 20 20  _LOG_DUMP: {.   
5040: 20 20 20 54 63 6c 5f 48 61 73 68 53 65 61 72 63     Tcl_HashSearc
5050: 68 20 73 65 61 72 63 68 3b 0a 20 20 20 20 20 20  h search;.      
5060: 54 63 6c 5f 48 61 73 68 45 6e 74 72 79 20 2a 70  Tcl_HashEntry *p
5070: 45 6e 74 72 79 3b 0a 20 20 20 20 20 20 54 63 6c  Entry;.      Tcl
5080: 5f 4f 62 6a 20 2a 70 52 65 74 20 3d 20 54 63 6c  _Obj *pRet = Tcl
5090: 5f 4e 65 77 4f 62 6a 28 29 3b 0a 0a 20 20 20 20  _NewObj();..    
50a0: 20 20 61 73 73 65 72 74 28 73 69 7a 65 6f 66 28    assert(sizeof(
50b0: 54 63 6c 5f 57 69 64 65 49 6e 74 29 3e 3d 73 69  Tcl_WideInt)>=si
50c0: 7a 65 6f 66 28 76 6f 69 64 2a 29 29 3b 0a 0a 20  zeof(void*));.. 
50d0: 20 20 20 20 20 66 6f 72 28 0a 20 20 20 20 20 20       for(.      
50e0: 20 20 70 45 6e 74 72 79 3d 54 63 6c 5f 46 69 72    pEntry=Tcl_Fir
50f0: 73 74 48 61 73 68 45 6e 74 72 79 28 26 61 4d 61  stHashEntry(&aMa
5100: 6c 6c 6f 63 4c 6f 67 2c 20 26 73 65 61 72 63 68  llocLog, &search
5110: 29 3b 0a 20 20 20 20 20 20 20 20 70 45 6e 74 72  );.        pEntr
5120: 79 3b 0a 20 20 20 20 20 20 20 20 70 45 6e 74 72  y;.        pEntr
5130: 79 3d 54 63 6c 5f 4e 65 78 74 48 61 73 68 45 6e  y=Tcl_NextHashEn
5140: 74 72 79 28 26 73 65 61 72 63 68 29 0a 20 20 20  try(&search).   
5150: 20 20 20 29 7b 0a 20 20 20 20 20 20 20 20 54 63     ){.        Tc
5160: 6c 5f 4f 62 6a 20 2a 61 70 45 6c 65 6d 5b 4d 41  l_Obj *apElem[MA
5170: 4c 4c 4f 43 5f 4c 4f 47 5f 46 52 41 4d 45 53 2b  LLOC_LOG_FRAMES+
5180: 32 5d 3b 0a 20 20 20 20 20 20 20 20 4d 61 6c 6c  2];.        Mall
5190: 6f 63 4c 6f 67 20 2a 70 4c 6f 67 20 3d 20 28 4d  ocLog *pLog = (M
51a0: 61 6c 6c 6f 63 4c 6f 67 20 2a 29 54 63 6c 5f 47  allocLog *)Tcl_G
51b0: 65 74 48 61 73 68 56 61 6c 75 65 28 70 45 6e 74  etHashValue(pEnt
51c0: 72 79 29 3b 0a 20 20 20 20 20 20 20 20 54 63 6c  ry);.        Tcl
51d0: 5f 57 69 64 65 49 6e 74 20 2a 61 4b 65 79 20 3d  _WideInt *aKey =
51e0: 20 28 54 63 6c 5f 57 69 64 65 49 6e 74 20 2a 29   (Tcl_WideInt *)
51f0: 54 63 6c 5f 47 65 74 48 61 73 68 4b 65 79 28 26  Tcl_GetHashKey(&
5200: 61 4d 61 6c 6c 6f 63 4c 6f 67 2c 20 70 45 6e 74  aMallocLog, pEnt
5210: 72 79 29 3b 0a 20 20 20 20 20 20 20 20 69 6e 74  ry);.        int
5220: 20 69 69 3b 0a 20 20 0a 20 20 20 20 20 20 20 20   ii;.  .        
5230: 61 70 45 6c 65 6d 5b 30 5d 20 3d 20 54 63 6c 5f  apElem[0] = Tcl_
5240: 4e 65 77 49 6e 74 4f 62 6a 28 70 4c 6f 67 2d 3e  NewIntObj(pLog->
5250: 6e 43 61 6c 6c 29 3b 0a 20 20 20 20 20 20 20 20  nCall);.        
5260: 61 70 45 6c 65 6d 5b 31 5d 20 3d 20 54 63 6c 5f  apElem[1] = Tcl_
5270: 4e 65 77 49 6e 74 4f 62 6a 28 70 4c 6f 67 2d 3e  NewIntObj(pLog->
5280: 6e 42 79 74 65 29 3b 0a 20 20 20 20 20 20 20 20  nByte);.        
5290: 66 6f 72 28 69 69 3d 30 3b 20 69 69 3c 4d 41 4c  for(ii=0; ii<MAL
52a0: 4c 4f 43 5f 4c 4f 47 5f 46 52 41 4d 45 53 3b 20  LOC_LOG_FRAMES; 
52b0: 69 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 20  ii++){.         
52c0: 20 61 70 45 6c 65 6d 5b 69 69 2b 32 5d 20 3d 20   apElem[ii+2] = 
52d0: 54 63 6c 5f 4e 65 77 57 69 64 65 49 6e 74 4f 62  Tcl_NewWideIntOb
52e0: 6a 28 61 4b 65 79 5b 69 69 5d 29 3b 0a 20 20 20  j(aKey[ii]);.   
52f0: 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 20 20       }..        
5300: 54 63 6c 5f 4c 69 73 74 4f 62 6a 41 70 70 65 6e  Tcl_ListObjAppen
5310: 64 45 6c 65 6d 65 6e 74 28 69 6e 74 65 72 70 2c  dElement(interp,
5320: 20 70 52 65 74 2c 0a 20 20 20 20 20 20 20 20 20   pRet,.         
5330: 20 20 20 54 63 6c 5f 4e 65 77 4c 69 73 74 4f 62     Tcl_NewListOb
5340: 6a 28 4d 41 4c 4c 4f 43 5f 4c 4f 47 5f 46 52 41  j(MALLOC_LOG_FRA
5350: 4d 45 53 2b 32 2c 20 61 70 45 6c 65 6d 29 0a 20  MES+2, apElem). 
5360: 20 20 20 20 20 20 20 29 3b 0a 20 20 20 20 20 20         );.      
5370: 7d 0a 0a 20 20 20 20 20 20 54 63 6c 5f 53 65 74  }..      Tcl_Set
5380: 4f 62 6a 52 65 73 75 6c 74 28 69 6e 74 65 72 70  ObjResult(interp
5390: 2c 20 70 52 65 74 29 3b 0a 20 20 20 20 20 20 62  , pRet);.      b
53a0: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20  reak;.    }.    
53b0: 63 61 73 65 20 4d 42 5f 4c 4f 47 5f 43 4c 45 41  case MB_LOG_CLEA
53c0: 52 3a 20 7b 0a 20 20 20 20 20 20 74 65 73 74 5f  R: {.      test_
53d0: 6d 65 6d 64 65 62 75 67 5f 6c 6f 67 5f 63 6c 65  memdebug_log_cle
53e0: 61 72 28 29 3b 0a 20 20 20 20 20 20 62 72 65 61  ar();.      brea
53f0: 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 63 61  k;.    }..    ca
5400: 73 65 20 4d 42 5f 4c 4f 47 5f 53 59 4e 43 3a 20  se MB_LOG_SYNC: 
5410: 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  {.#ifdef SQLITE_
5420: 4d 45 4d 44 45 42 55 47 0a 20 20 20 20 20 20 65  MEMDEBUG.      e
5430: 78 74 65 72 6e 20 76 6f 69 64 20 73 71 6c 69 74  xtern void sqlit
5440: 65 33 4d 65 6d 64 65 62 75 67 53 79 6e 63 28 29  e3MemdebugSync()
5450: 3b 0a 20 20 20 20 20 20 74 65 73 74 5f 6d 65 6d  ;.      test_mem
5460: 64 65 62 75 67 5f 6c 6f 67 5f 63 6c 65 61 72 28  debug_log_clear(
5470: 29 3b 0a 20 20 20 20 20 20 6d 61 6c 6c 6f 63 4c  );.      mallocL
5480: 6f 67 45 6e 61 62 6c 65 64 20 3d 20 31 3b 0a 20  ogEnabled = 1;. 
5490: 20 20 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 64       sqlite3Memd
54a0: 65 62 75 67 53 79 6e 63 28 29 3b 0a 23 65 6e 64  ebugSync();.#end
54b0: 69 66 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a  if.      break;.
54c0: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 72 65 74      }.  }..  ret
54d0: 75 72 6e 20 54 43 4c 5f 4f 4b 3b 0a 7d 0a 0a 2f  urn TCL_OK;.}../
54e0: 2a 0a 2a 2a 20 55 73 61 67 65 3a 20 20 20 20 73  *.** Usage:    s
54f0: 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 5f 73 63  qlite3_config_sc
5500: 72 61 74 63 68 20 53 49 5a 45 20 4e 0a 2a 2a 0a  ratch SIZE N.**.
5510: 2a 2a 20 53 65 74 20 74 68 65 20 73 63 72 61 74  ** Set the scrat
5520: 63 68 20 6d 65 6d 6f 72 79 20 62 75 66 66 65 72  ch memory buffer
5530: 20 75 73 69 6e 67 20 53 51 4c 49 54 45 5f 43 4f   using SQLITE_CO
5540: 4e 46 49 47 5f 53 43 52 41 54 43 48 2e 0a 2a 2a  NFIG_SCRATCH..**
5550: 20 54 68 65 20 62 75 66 66 65 72 20 69 73 20 73   The buffer is s
5560: 74 61 74 69 63 20 61 6e 64 20 69 73 20 6f 66 20  tatic and is of 
5570: 6c 69 6d 69 74 65 64 20 73 69 7a 65 2e 20 20 4e  limited size.  N
5580: 20 6d 69 67 68 74 20 62 65 0a 2a 2a 20 61 64 6a   might be.** adj
5590: 75 73 74 65 64 20 64 6f 77 6e 77 61 72 64 20 61  usted downward a
55a0: 73 20 6e 65 65 64 65 64 20 74 6f 20 61 63 63 6f  s needed to acco
55b0: 6d 6d 6f 64 61 74 65 20 74 68 65 20 72 65 71 75  mmodate the requ
55c0: 65 73 74 65 64 20 73 69 7a 65 2e 0a 2a 2a 20 54  ested size..** T
55d0: 68 65 20 72 65 76 69 73 65 64 20 76 61 6c 75 65  he revised value
55e0: 20 6f 66 20 4e 20 69 73 20 72 65 74 75 72 6e 65   of N is returne
55f0: 64 2e 0a 2a 2a 0a 2a 2a 20 41 20 6e 65 67 61 74  d..**.** A negat
5600: 69 76 65 20 53 49 5a 45 20 63 61 75 73 65 73 20  ive SIZE causes 
5610: 74 68 65 20 62 75 66 66 65 72 20 70 6f 69 6e 74  the buffer point
5620: 65 72 20 74 6f 20 62 65 20 4e 55 4c 4c 2e 0a 2a  er to be NULL..*
5630: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 53 51 4c  /.static int SQL
5640: 49 54 45 5f 54 43 4c 41 50 49 20 74 65 73 74 5f  ITE_TCLAPI test_
5650: 63 6f 6e 66 69 67 5f 73 63 72 61 74 63 68 28 0a  config_scratch(.
5660: 20 20 76 6f 69 64 20 2a 20 63 6c 69 65 6e 74 44    void * clientD
5670: 61 74 61 2c 0a 20 20 54 63 6c 5f 49 6e 74 65 72  ata,.  Tcl_Inter
5680: 70 20 2a 69 6e 74 65 72 70 2c 0a 20 20 69 6e 74  p *interp,.  int
5690: 20 6f 62 6a 63 2c 0a 20 20 54 63 6c 5f 4f 62 6a   objc,.  Tcl_Obj
56a0: 20 2a 43 4f 4e 53 54 20 6f 62 6a 76 5b 5d 0a 29   *CONST objv[].)
56b0: 7b 0a 20 20 69 6e 74 20 73 7a 2c 20 4e 2c 20 72  {.  int sz, N, r
56c0: 63 3b 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a 70 52  c;.  Tcl_Obj *pR
56d0: 65 73 75 6c 74 3b 0a 20 20 73 74 61 74 69 63 20  esult;.  static 
56e0: 63 68 61 72 20 2a 62 75 66 20 3d 20 30 3b 0a 20  char *buf = 0;. 
56f0: 20 69 66 28 20 6f 62 6a 63 21 3d 33 20 29 7b 0a   if( objc!=3 ){.
5700: 20 20 20 20 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d      Tcl_WrongNum
5710: 41 72 67 73 28 69 6e 74 65 72 70 2c 20 31 2c 20  Args(interp, 1, 
5720: 6f 62 6a 76 2c 20 22 53 49 5a 45 20 4e 22 29 3b  objv, "SIZE N");
5730: 0a 20 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f  .    return TCL_
5740: 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 69 66 28  ERROR;.  }.  if(
5750: 20 54 63 6c 5f 47 65 74 49 6e 74 46 72 6f 6d 4f   Tcl_GetIntFromO
5760: 62 6a 28 69 6e 74 65 72 70 2c 20 6f 62 6a 76 5b  bj(interp, objv[
5770: 31 5d 2c 20 26 73 7a 29 20 29 20 72 65 74 75 72  1], &sz) ) retur
5780: 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 69  n TCL_ERROR;.  i
5790: 66 28 20 54 63 6c 5f 47 65 74 49 6e 74 46 72 6f  f( Tcl_GetIntFro
57a0: 6d 4f 62 6a 28 69 6e 74 65 72 70 2c 20 6f 62 6a  mObj(interp, obj
57b0: 76 5b 32 5d 2c 20 26 4e 29 20 29 20 72 65 74 75  v[2], &N) ) retu
57c0: 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20  rn TCL_ERROR;.  
57d0: 66 72 65 65 28 62 75 66 29 3b 0a 20 20 69 66 28  free(buf);.  if(
57e0: 20 73 7a 3c 30 20 29 7b 0a 20 20 20 20 62 75 66   sz<0 ){.    buf
57f0: 20 3d 20 30 3b 0a 20 20 20 20 72 63 20 3d 20 73   = 0;.    rc = s
5800: 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 53 51  qlite3_config(SQ
5810: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53 43 52 41  LITE_CONFIG_SCRA
5820: 54 43 48 2c 20 28 76 6f 69 64 2a 29 30 2c 20 30  TCH, (void*)0, 0
5830: 2c 20 30 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  , 0);.  }else{. 
5840: 20 20 20 62 75 66 20 3d 20 6d 61 6c 6c 6f 63 28     buf = malloc(
5850: 20 73 7a 2a 4e 20 2b 20 31 20 29 3b 0a 20 20 20   sz*N + 1 );.   
5860: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 63 6f   rc = sqlite3_co
5870: 6e 66 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46  nfig(SQLITE_CONF
5880: 49 47 5f 53 43 52 41 54 43 48 2c 20 62 75 66 2c  IG_SCRATCH, buf,
5890: 20 73 7a 2c 20 4e 29 3b 0a 20 20 7d 0a 20 20 70   sz, N);.  }.  p
58a0: 52 65 73 75 6c 74 20 3d 20 54 63 6c 5f 4e 65 77  Result = Tcl_New
58b0: 4f 62 6a 28 29 3b 0a 20 20 54 63 6c 5f 4c 69 73  Obj();.  Tcl_Lis
58c0: 74 4f 62 6a 41 70 70 65 6e 64 45 6c 65 6d 65 6e  tObjAppendElemen
58d0: 74 28 30 2c 20 70 52 65 73 75 6c 74 2c 20 54 63  t(0, pResult, Tc
58e0: 6c 5f 4e 65 77 49 6e 74 4f 62 6a 28 72 63 29 29  l_NewIntObj(rc))
58f0: 3b 0a 20 20 54 63 6c 5f 4c 69 73 74 4f 62 6a 41  ;.  Tcl_ListObjA
5900: 70 70 65 6e 64 45 6c 65 6d 65 6e 74 28 30 2c 20  ppendElement(0, 
5910: 70 52 65 73 75 6c 74 2c 20 54 63 6c 5f 4e 65 77  pResult, Tcl_New
5920: 49 6e 74 4f 62 6a 28 4e 29 29 3b 0a 20 20 54 63  IntObj(N));.  Tc
5930: 6c 5f 53 65 74 4f 62 6a 52 65 73 75 6c 74 28 69  l_SetObjResult(i
5940: 6e 74 65 72 70 2c 20 70 52 65 73 75 6c 74 29 3b  nterp, pResult);
5950: 0a 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 4f 4b  .  return TCL_OK
5960: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55 73 61 67 65  ;.}../*.** Usage
5970: 3a 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e  :    sqlite3_con
5980: 66 69 67 5f 70 61 67 65 63 61 63 68 65 20 53 49  fig_pagecache SI
5990: 5a 45 20 4e 0a 2a 2a 0a 2a 2a 20 53 65 74 20 74  ZE N.**.** Set t
59a0: 68 65 20 70 61 67 65 2d 63 61 63 68 65 20 6d 65  he page-cache me
59b0: 6d 6f 72 79 20 62 75 66 66 65 72 20 75 73 69 6e  mory buffer usin
59c0: 67 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f  g SQLITE_CONFIG_
59d0: 50 41 47 45 43 41 43 48 45 2e 0a 2a 2a 20 54 68  PAGECACHE..** Th
59e0: 65 20 62 75 66 66 65 72 20 69 73 20 73 74 61 74  e buffer is stat
59f0: 69 63 20 61 6e 64 20 69 73 20 6f 66 20 6c 69 6d  ic and is of lim
5a00: 69 74 65 64 20 73 69 7a 65 2e 20 20 4e 20 6d 69  ited size.  N mi
5a10: 67 68 74 20 62 65 0a 2a 2a 20 61 64 6a 75 73 74  ght be.** adjust
5a20: 65 64 20 64 6f 77 6e 77 61 72 64 20 61 73 20 6e  ed downward as n
5a30: 65 65 64 65 64 20 74 6f 20 61 63 63 6f 6d 6d 6f  eeded to accommo
5a40: 64 61 74 65 20 74 68 65 20 72 65 71 75 65 73 74  date the request
5a50: 65 64 20 73 69 7a 65 2e 0a 2a 2a 20 54 68 65 20  ed size..** The 
5a60: 72 65 76 69 73 65 64 20 76 61 6c 75 65 20 6f 66  revised value of
5a70: 20 4e 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a   N is returned..
5a80: 2a 2a 0a 2a 2a 20 41 20 6e 65 67 61 74 69 76 65  **.** A negative
5a90: 20 53 49 5a 45 20 63 61 75 73 65 73 20 74 68 65   SIZE causes the
5aa0: 20 62 75 66 66 65 72 20 70 6f 69 6e 74 65 72 20   buffer pointer 
5ab0: 74 6f 20 62 65 20 4e 55 4c 4c 2e 0a 2a 2f 0a 73  to be NULL..*/.s
5ac0: 74 61 74 69 63 20 69 6e 74 20 53 51 4c 49 54 45  tatic int SQLITE
5ad0: 5f 54 43 4c 41 50 49 20 74 65 73 74 5f 63 6f 6e  _TCLAPI test_con
5ae0: 66 69 67 5f 70 61 67 65 63 61 63 68 65 28 0a 20  fig_pagecache(. 
5af0: 20 76 6f 69 64 20 2a 20 63 6c 69 65 6e 74 44 61   void * clientDa
5b00: 74 61 2c 0a 20 20 54 63 6c 5f 49 6e 74 65 72 70  ta,.  Tcl_Interp
5b10: 20 2a 69 6e 74 65 72 70 2c 0a 20 20 69 6e 74 20   *interp,.  int 
5b20: 6f 62 6a 63 2c 0a 20 20 54 63 6c 5f 4f 62 6a 20  objc,.  Tcl_Obj 
5b30: 2a 43 4f 4e 53 54 20 6f 62 6a 76 5b 5d 0a 29 7b  *CONST objv[].){
5b40: 0a 20 20 69 6e 74 20 73 7a 2c 20 4e 3b 0a 20 20  .  int sz, N;.  
5b50: 54 63 6c 5f 4f 62 6a 20 2a 70 52 65 73 3b 0a 20  Tcl_Obj *pRes;. 
5b60: 20 73 74 61 74 69 63 20 63 68 61 72 20 2a 62 75   static char *bu
5b70: 66 20 3d 20 30 3b 0a 20 20 69 66 28 20 6f 62 6a  f = 0;.  if( obj
5b80: 63 21 3d 33 20 29 7b 0a 20 20 20 20 54 63 6c 5f  c!=3 ){.    Tcl_
5b90: 57 72 6f 6e 67 4e 75 6d 41 72 67 73 28 69 6e 74  WrongNumArgs(int
5ba0: 65 72 70 2c 20 31 2c 20 6f 62 6a 76 2c 20 22 53  erp, 1, objv, "S
5bb0: 49 5a 45 20 4e 22 29 3b 0a 20 20 20 20 72 65 74  IZE N");.    ret
5bc0: 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20  urn TCL_ERROR;. 
5bd0: 20 7d 0a 20 20 69 66 28 20 54 63 6c 5f 47 65 74   }.  if( Tcl_Get
5be0: 49 6e 74 46 72 6f 6d 4f 62 6a 28 69 6e 74 65 72  IntFromObj(inter
5bf0: 70 2c 20 6f 62 6a 76 5b 31 5d 2c 20 26 73 7a 29  p, objv[1], &sz)
5c00: 20 29 20 72 65 74 75 72 6e 20 54 43 4c 5f 45 52   ) return TCL_ER
5c10: 52 4f 52 3b 0a 20 20 69 66 28 20 54 63 6c 5f 47  ROR;.  if( Tcl_G
5c20: 65 74 49 6e 74 46 72 6f 6d 4f 62 6a 28 69 6e 74  etIntFromObj(int
5c30: 65 72 70 2c 20 6f 62 6a 76 5b 32 5d 2c 20 26 4e  erp, objv[2], &N
5c40: 29 20 29 20 72 65 74 75 72 6e 20 54 43 4c 5f 45  ) ) return TCL_E
5c50: 52 52 4f 52 3b 0a 20 20 66 72 65 65 28 62 75 66  RROR;.  free(buf
5c60: 29 3b 0a 20 20 62 75 66 20 3d 20 30 3b 0a 0a 20  );.  buf = 0;.. 
5c70: 20 2f 2a 20 53 65 74 20 74 68 65 20 72 65 74 75   /* Set the retu
5c80: 72 6e 20 76 61 6c 75 65 20 2a 2f 0a 20 20 70 52  rn value */.  pR
5c90: 65 73 20 3d 20 54 63 6c 5f 4e 65 77 4f 62 6a 28  es = Tcl_NewObj(
5ca0: 29 3b 0a 20 20 54 63 6c 5f 4c 69 73 74 4f 62 6a  );.  Tcl_ListObj
5cb0: 41 70 70 65 6e 64 45 6c 65 6d 65 6e 74 28 30 2c  AppendElement(0,
5cc0: 20 70 52 65 73 2c 20 54 63 6c 5f 4e 65 77 49 6e   pRes, Tcl_NewIn
5cd0: 74 4f 62 6a 28 73 71 6c 69 74 65 33 47 6c 6f 62  tObj(sqlite3Glob
5ce0: 61 6c 43 6f 6e 66 69 67 2e 73 7a 50 61 67 65 29  alConfig.szPage)
5cf0: 29 3b 0a 20 20 54 63 6c 5f 4c 69 73 74 4f 62 6a  );.  Tcl_ListObj
5d00: 41 70 70 65 6e 64 45 6c 65 6d 65 6e 74 28 30 2c  AppendElement(0,
5d10: 20 70 52 65 73 2c 20 54 63 6c 5f 4e 65 77 49 6e   pRes, Tcl_NewIn
5d20: 74 4f 62 6a 28 73 71 6c 69 74 65 33 47 6c 6f 62  tObj(sqlite3Glob
5d30: 61 6c 43 6f 6e 66 69 67 2e 6e 50 61 67 65 29 29  alConfig.nPage))
5d40: 3b 0a 20 20 54 63 6c 5f 53 65 74 4f 62 6a 52 65  ;.  Tcl_SetObjRe
5d50: 73 75 6c 74 28 69 6e 74 65 72 70 2c 20 70 52 65  sult(interp, pRe
5d60: 73 29 3b 0a 0a 20 20 69 66 28 20 73 7a 3c 30 20  s);..  if( sz<0 
5d70: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 63  ){.    sqlite3_c
5d80: 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e  onfig(SQLITE_CON
5d90: 46 49 47 5f 50 41 47 45 43 41 43 48 45 2c 20 28  FIG_PAGECACHE, (
5da0: 76 6f 69 64 2a 29 30 2c 20 30 2c 20 30 29 3b 0a  void*)0, 0, 0);.
5db0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 62 75 66    }else{.    buf
5dc0: 20 3d 20 6d 61 6c 6c 6f 63 28 20 73 7a 2a 4e 20   = malloc( sz*N 
5dd0: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 63  );.    sqlite3_c
5de0: 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e  onfig(SQLITE_CON
5df0: 46 49 47 5f 50 41 47 45 43 41 43 48 45 2c 20 62  FIG_PAGECACHE, b
5e00: 75 66 2c 20 73 7a 2c 20 4e 29 3b 0a 20 20 7d 0a  uf, sz, N);.  }.
5e10: 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 4f 4b 3b    return TCL_OK;
5e20: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55 73 61 67 65 3a  .}../*.** Usage:
5e30: 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66      sqlite3_conf
5e40: 69 67 5f 61 6c 74 5f 70 63 61 63 68 65 20 49 4e  ig_alt_pcache IN
5e50: 53 54 41 4c 4c 5f 46 4c 41 47 20 44 49 53 43 41  STALL_FLAG DISCA
5e60: 52 44 5f 43 48 41 4e 43 45 20 50 52 4e 47 5f 53  RD_CHANCE PRNG_S
5e70: 45 45 44 0a 2a 2a 0a 2a 2a 20 53 65 74 20 75 70  EED.**.** Set up
5e80: 20 74 68 65 20 61 6c 74 65 72 6e 61 74 69 76 65   the alternative
5e90: 20 74 65 73 74 20 70 61 67 65 20 63 61 63 68 65   test page cache
5ea0: 2e 20 20 49 6e 73 74 61 6c 6c 20 69 66 20 49 4e  .  Install if IN
5eb0: 53 54 41 4c 4c 5f 46 4c 41 47 20 69 73 0a 2a 2a  STALL_FLAG is.**
5ec0: 20 74 72 75 65 20 61 6e 64 20 75 6e 69 6e 73 74   true and uninst
5ed0: 61 6c 6c 20 28 72 65 76 65 72 74 69 6e 67 20 74  all (reverting t
5ee0: 6f 20 74 68 65 20 64 65 66 61 75 6c 74 20 70 61  o the default pa
5ef0: 67 65 20 63 61 63 68 65 29 20 69 66 20 49 4e 53  ge cache) if INS
5f00: 54 41 4c 4c 5f 46 4c 41 47 0a 2a 2a 20 69 73 20  TALL_FLAG.** is 
5f10: 66 61 6c 73 65 2e 20 20 44 49 53 43 41 52 44 5f  false.  DISCARD_
5f20: 43 48 41 4e 47 45 20 69 73 20 61 6e 20 69 6e 74  CHANGE is an int
5f30: 65 67 65 72 20 62 65 74 77 65 65 6e 20 30 20 61  eger between 0 a
5f40: 6e 64 20 31 30 30 20 69 6e 63 6c 75 73 69 76 65  nd 100 inclusive
5f50: 0a 2a 2a 20 77 68 69 63 68 20 64 65 74 65 72 6d  .** which determ
5f60: 69 6e 65 73 20 74 68 65 20 63 68 61 6e 63 65 20  ines the chance 
5f70: 6f 66 20 64 69 73 63 61 72 64 69 6e 67 20 61 20  of discarding a 
5f80: 70 61 67 65 20 77 68 65 6e 20 75 6e 70 69 6e 6e  page when unpinn
5f90: 65 64 2e 20 20 31 30 30 0a 2a 2a 20 69 73 20 63  ed.  100.** is c
5fa0: 65 72 74 61 69 6e 74 79 2e 20 20 30 20 69 73 20  ertainty.  0 is 
5fb0: 6e 65 76 65 72 2e 20 20 50 52 4e 47 5f 53 45 45  never.  PRNG_SEE
5fc0: 44 20 69 73 20 74 68 65 20 70 73 65 75 64 6f 2d  D is the pseudo-
5fd0: 72 61 6e 64 6f 6d 20 6e 75 6d 62 65 72 20 67 65  random number ge
5fe0: 6e 65 72 61 74 6f 72 0a 2a 2a 20 73 65 65 64 2e  nerator.** seed.
5ff0: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 53  .*/.static int S
6000: 51 4c 49 54 45 5f 54 43 4c 41 50 49 20 74 65 73  QLITE_TCLAPI tes
6010: 74 5f 61 6c 74 5f 70 63 61 63 68 65 28 0a 20 20  t_alt_pcache(.  
6020: 76 6f 69 64 20 2a 20 63 6c 69 65 6e 74 44 61 74  void * clientDat
6030: 61 2c 0a 20 20 54 63 6c 5f 49 6e 74 65 72 70 20  a,.  Tcl_Interp 
6040: 2a 69 6e 74 65 72 70 2c 0a 20 20 69 6e 74 20 6f  *interp,.  int o
6050: 62 6a 63 2c 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a  bjc,.  Tcl_Obj *
6060: 43 4f 4e 53 54 20 6f 62 6a 76 5b 5d 0a 29 7b 0a  CONST objv[].){.
6070: 20 20 69 6e 74 20 69 6e 73 74 61 6c 6c 46 6c 61    int installFla
6080: 67 3b 0a 20 20 69 6e 74 20 64 69 73 63 61 72 64  g;.  int discard
6090: 43 68 61 6e 63 65 20 3d 20 30 3b 0a 20 20 69 6e  Chance = 0;.  in
60a0: 74 20 70 72 6e 67 53 65 65 64 20 3d 20 30 3b 0a  t prngSeed = 0;.
60b0: 20 20 69 6e 74 20 68 69 67 68 53 74 72 65 73 73    int highStress
60c0: 20 3d 20 30 3b 0a 20 20 65 78 74 65 72 6e 20 76   = 0;.  extern v
60d0: 6f 69 64 20 69 6e 73 74 61 6c 6c 54 65 73 74 50  oid installTestP
60e0: 43 61 63 68 65 28 69 6e 74 2c 75 6e 73 69 67 6e  Cache(int,unsign
60f0: 65 64 2c 75 6e 73 69 67 6e 65 64 2c 75 6e 73 69  ed,unsigned,unsi
6100: 67 6e 65 64 29 3b 0a 20 20 69 66 28 20 6f 62 6a  gned);.  if( obj
6110: 63 3c 32 20 7c 7c 20 6f 62 6a 63 3e 35 20 29 7b  c<2 || objc>5 ){
6120: 0a 20 20 20 20 54 63 6c 5f 57 72 6f 6e 67 4e 75  .    Tcl_WrongNu
6130: 6d 41 72 67 73 28 69 6e 74 65 72 70 2c 20 31 2c  mArgs(interp, 1,
6140: 20 6f 62 6a 76 2c 20 0a 20 20 20 20 20 20 20 20   objv, .        
6150: 22 49 4e 53 54 41 4c 4c 46 4c 41 47 20 44 49 53  "INSTALLFLAG DIS
6160: 43 41 52 44 43 48 41 4e 43 45 20 50 52 4e 47 53  CARDCHANCE PRNGS
6170: 45 45 45 44 20 48 49 47 48 53 54 52 45 53 53 22  EEED HIGHSTRESS"
6180: 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 54 43  );.    return TC
6190: 4c 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 69  L_ERROR;.  }.  i
61a0: 66 28 20 54 63 6c 5f 47 65 74 49 6e 74 46 72 6f  f( Tcl_GetIntFro
61b0: 6d 4f 62 6a 28 69 6e 74 65 72 70 2c 20 6f 62 6a  mObj(interp, obj
61c0: 76 5b 31 5d 2c 20 26 69 6e 73 74 61 6c 6c 46 6c  v[1], &installFl
61d0: 61 67 29 20 29 20 72 65 74 75 72 6e 20 54 43 4c  ag) ) return TCL
61e0: 5f 45 52 52 4f 52 3b 0a 20 20 69 66 28 20 6f 62  _ERROR;.  if( ob
61f0: 6a 63 3e 3d 33 20 26 26 20 54 63 6c 5f 47 65 74  jc>=3 && Tcl_Get
6200: 49 6e 74 46 72 6f 6d 4f 62 6a 28 69 6e 74 65 72  IntFromObj(inter
6210: 70 2c 20 6f 62 6a 76 5b 32 5d 2c 20 26 64 69 73  p, objv[2], &dis
6220: 63 61 72 64 43 68 61 6e 63 65 29 20 29 7b 0a 20  cardChance) ){. 
6230: 20 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45      return TCL_E
6240: 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 69 66 28 20  RROR;.  }.  if( 
6250: 6f 62 6a 63 3e 3d 34 20 26 26 20 54 63 6c 5f 47  objc>=4 && Tcl_G
6260: 65 74 49 6e 74 46 72 6f 6d 4f 62 6a 28 69 6e 74  etIntFromObj(int
6270: 65 72 70 2c 20 6f 62 6a 76 5b 33 5d 2c 20 26 70  erp, objv[3], &p
6280: 72 6e 67 53 65 65 64 29 20 29 7b 0a 20 20 20 20  rngSeed) ){.    
6290: 20 72 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f   return TCL_ERRO
62a0: 52 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6f 62 6a  R;.  }.  if( obj
62b0: 63 3e 3d 35 20 26 26 20 54 63 6c 5f 47 65 74 49  c>=5 && Tcl_GetI
62c0: 6e 74 46 72 6f 6d 4f 62 6a 28 69 6e 74 65 72 70  ntFromObj(interp
62d0: 2c 20 6f 62 6a 76 5b 34 5d 2c 20 26 68 69 67 68  , objv[4], &high
62e0: 53 74 72 65 73 73 29 20 29 7b 0a 20 20 20 20 72  Stress) ){.    r
62f0: 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b  eturn TCL_ERROR;
6300: 0a 20 20 7d 0a 20 20 69 66 28 20 64 69 73 63 61  .  }.  if( disca
6310: 72 64 43 68 61 6e 63 65 3c 30 20 7c 7c 20 64 69  rdChance<0 || di
6320: 73 63 61 72 64 43 68 61 6e 63 65 3e 31 30 30 20  scardChance>100 
6330: 29 7b 0a 20 20 20 20 54 63 6c 5f 41 70 70 65 6e  ){.    Tcl_Appen
6340: 64 52 65 73 75 6c 74 28 69 6e 74 65 72 70 2c 20  dResult(interp, 
6350: 22 64 69 73 63 61 72 64 2d 63 68 61 6e 63 65 20  "discard-chance 
6360: 73 68 6f 75 6c 64 20 62 65 20 62 65 74 77 65 65  should be betwee
6370: 6e 20 30 20 61 6e 64 20 31 30 30 22 2c 0a 20 20  n 0 and 100",.  
6380: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6390: 20 20 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 20     (char*)0);.  
63a0: 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45 52 52    return TCL_ERR
63b0: 4f 52 3b 0a 20 20 7d 0a 20 20 69 6e 73 74 61 6c  OR;.  }.  instal
63c0: 6c 54 65 73 74 50 43 61 63 68 65 28 69 6e 73 74  lTestPCache(inst
63d0: 61 6c 6c 46 6c 61 67 2c 20 28 75 6e 73 69 67 6e  allFlag, (unsign
63e0: 65 64 29 64 69 73 63 61 72 64 43 68 61 6e 63 65  ed)discardChance
63f0: 2c 20 28 75 6e 73 69 67 6e 65 64 29 70 72 6e 67  , (unsigned)prng
6400: 53 65 65 64 2c 0a 20 20 20 20 20 20 20 20 20 20  Seed,.          
6410: 20 20 20 20 20 20 20 20 20 20 28 75 6e 73 69 67            (unsig
6420: 6e 65 64 29 68 69 67 68 53 74 72 65 73 73 29 3b  ned)highStress);
6430: 0a 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 4f 4b  .  return TCL_OK
6440: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55 73 61 67 65  ;.}../*.** Usage
6450: 3a 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e  :    sqlite3_con
6460: 66 69 67 5f 6d 65 6d 73 74 61 74 75 73 20 42 4f  fig_memstatus BO
6470: 4f 4c 45 41 4e 0a 2a 2a 0a 2a 2a 20 45 6e 61 62  OLEAN.**.** Enab
6480: 6c 65 20 6f 72 20 64 69 73 61 62 6c 65 20 6d 65  le or disable me
6490: 6d 6f 72 79 20 73 74 61 74 75 73 20 72 65 70 6f  mory status repo
64a0: 72 74 69 6e 67 20 75 73 69 6e 67 20 53 51 4c 49  rting using SQLI
64b0: 54 45 5f 43 4f 4e 46 49 47 5f 4d 45 4d 53 54 41  TE_CONFIG_MEMSTA
64c0: 54 55 53 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  TUS..*/.static i
64d0: 6e 74 20 53 51 4c 49 54 45 5f 54 43 4c 41 50 49  nt SQLITE_TCLAPI
64e0: 20 74 65 73 74 5f 63 6f 6e 66 69 67 5f 6d 65 6d   test_config_mem
64f0: 73 74 61 74 75 73 28 0a 20 20 76 6f 69 64 20 2a  status(.  void *
6500: 20 63 6c 69 65 6e 74 44 61 74 61 2c 0a 20 20 54   clientData,.  T
6510: 63 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65 72  cl_Interp *inter
6520: 70 2c 0a 20 20 69 6e 74 20 6f 62 6a 63 2c 0a 20  p,.  int objc,. 
6530: 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54 20   Tcl_Obj *CONST 
6540: 6f 62 6a 76 5b 5d 0a 29 7b 0a 20 20 69 6e 74 20  objv[].){.  int 
6550: 65 6e 61 62 6c 65 2c 20 72 63 3b 0a 20 20 69 66  enable, rc;.  if
6560: 28 20 6f 62 6a 63 21 3d 32 20 29 7b 0a 20 20 20  ( objc!=2 ){.   
6570: 20 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d 41 72 67   Tcl_WrongNumArg
6580: 73 28 69 6e 74 65 72 70 2c 20 31 2c 20 6f 62 6a  s(interp, 1, obj
6590: 76 2c 20 22 42 4f 4f 4c 45 41 4e 22 29 3b 0a 20  v, "BOOLEAN");. 
65a0: 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45 52     return TCL_ER
65b0: 52 4f 52 3b 0a 20 20 7d 0a 20 20 69 66 28 20 54  ROR;.  }.  if( T
65c0: 63 6c 5f 47 65 74 42 6f 6f 6c 65 61 6e 46 72 6f  cl_GetBooleanFro
65d0: 6d 4f 62 6a 28 69 6e 74 65 72 70 2c 20 6f 62 6a  mObj(interp, obj
65e0: 76 5b 31 5d 2c 20 26 65 6e 61 62 6c 65 29 20 29  v[1], &enable) )
65f0: 20 72 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f   return TCL_ERRO
6600: 52 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65  R;.  rc = sqlite
6610: 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f  3_config(SQLITE_
6620: 43 4f 4e 46 49 47 5f 4d 45 4d 53 54 41 54 55 53  CONFIG_MEMSTATUS
6630: 2c 20 65 6e 61 62 6c 65 29 3b 0a 20 20 54 63 6c  , enable);.  Tcl
6640: 5f 53 65 74 4f 62 6a 52 65 73 75 6c 74 28 69 6e  _SetObjResult(in
6650: 74 65 72 70 2c 20 54 63 6c 5f 4e 65 77 49 6e 74  terp, Tcl_NewInt
6660: 4f 62 6a 28 72 63 29 29 3b 0a 20 20 72 65 74 75  Obj(rc));.  retu
6670: 72 6e 20 54 43 4c 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a  rn TCL_OK;.}../*
6680: 0a 2a 2a 20 55 73 61 67 65 3a 20 20 20 20 73 71  .** Usage:    sq
6690: 6c 69 74 65 33 5f 63 6f 6e 66 69 67 5f 6c 6f 6f  lite3_config_loo
66a0: 6b 61 73 69 64 65 20 20 53 49 5a 45 20 20 43 4f  kaside  SIZE  CO
66b0: 55 4e 54 0a 2a 2a 0a 2a 2f 0a 73 74 61 74 69 63  UNT.**.*/.static
66c0: 20 69 6e 74 20 53 51 4c 49 54 45 5f 54 43 4c 41   int SQLITE_TCLA
66d0: 50 49 20 74 65 73 74 5f 63 6f 6e 66 69 67 5f 6c  PI test_config_l
66e0: 6f 6f 6b 61 73 69 64 65 28 0a 20 20 76 6f 69 64  ookaside(.  void
66f0: 20 2a 20 63 6c 69 65 6e 74 44 61 74 61 2c 0a 20   * clientData,. 
6700: 20 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74   Tcl_Interp *int
6710: 65 72 70 2c 0a 20 20 69 6e 74 20 6f 62 6a 63 2c  erp,.  int objc,
6720: 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53  .  Tcl_Obj *CONS
6730: 54 20 6f 62 6a 76 5b 5d 0a 29 7b 0a 20 20 69 6e  T objv[].){.  in
6740: 74 20 73 7a 2c 20 63 6e 74 3b 0a 20 20 54 63 6c  t sz, cnt;.  Tcl
6750: 5f 4f 62 6a 20 2a 70 52 65 74 3b 0a 20 20 69 66  _Obj *pRet;.  if
6760: 28 20 6f 62 6a 63 21 3d 33 20 29 7b 0a 20 20 20  ( objc!=3 ){.   
6770: 20 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d 41 72 67   Tcl_WrongNumArg
6780: 73 28 69 6e 74 65 72 70 2c 20 31 2c 20 6f 62 6a  s(interp, 1, obj
6790: 76 2c 20 22 53 49 5a 45 20 43 4f 55 4e 54 22 29  v, "SIZE COUNT")
67a0: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 54 43 4c  ;.    return TCL
67b0: 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 69 66  _ERROR;.  }.  if
67c0: 28 20 54 63 6c 5f 47 65 74 49 6e 74 46 72 6f 6d  ( Tcl_GetIntFrom
67d0: 4f 62 6a 28 69 6e 74 65 72 70 2c 20 6f 62 6a 76  Obj(interp, objv
67e0: 5b 31 5d 2c 20 26 73 7a 29 20 29 20 72 65 74 75  [1], &sz) ) retu
67f0: 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20  rn TCL_ERROR;.  
6800: 69 66 28 20 54 63 6c 5f 47 65 74 49 6e 74 46 72  if( Tcl_GetIntFr
6810: 6f 6d 4f 62 6a 28 69 6e 74 65 72 70 2c 20 6f 62  omObj(interp, ob
6820: 6a 76 5b 32 5d 2c 20 26 63 6e 74 29 20 29 20 72  jv[2], &cnt) ) r
6830: 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b  eturn TCL_ERROR;
6840: 0a 20 20 70 52 65 74 20 3d 20 54 63 6c 5f 4e 65  .  pRet = Tcl_Ne
6850: 77 4f 62 6a 28 29 3b 0a 20 20 54 63 6c 5f 4c 69  wObj();.  Tcl_Li
6860: 73 74 4f 62 6a 41 70 70 65 6e 64 45 6c 65 6d 65  stObjAppendEleme
6870: 6e 74 28 0a 20 20 20 20 20 20 69 6e 74 65 72 70  nt(.      interp
6880: 2c 20 70 52 65 74 2c 20 54 63 6c 5f 4e 65 77 49  , pRet, Tcl_NewI
6890: 6e 74 4f 62 6a 28 73 71 6c 69 74 65 33 47 6c 6f  ntObj(sqlite3Glo
68a0: 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 4c 6f 6f 6b  balConfig.szLook
68b0: 61 73 69 64 65 29 0a 20 20 29 3b 0a 20 20 54 63  aside).  );.  Tc
68c0: 6c 5f 4c 69 73 74 4f 62 6a 41 70 70 65 6e 64 45  l_ListObjAppendE
68d0: 6c 65 6d 65 6e 74 28 0a 20 20 20 20 20 20 69 6e  lement(.      in
68e0: 74 65 72 70 2c 20 70 52 65 74 2c 20 54 63 6c 5f  terp, pRet, Tcl_
68f0: 4e 65 77 49 6e 74 4f 62 6a 28 73 71 6c 69 74 65  NewIntObj(sqlite
6900: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 4c  3GlobalConfig.nL
6910: 6f 6f 6b 61 73 69 64 65 29 0a 20 20 29 3b 0a 20  ookaside).  );. 
6920: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28   sqlite3_config(
6930: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4c 4f  SQLITE_CONFIG_LO
6940: 4f 4b 41 53 49 44 45 2c 20 73 7a 2c 20 63 6e 74  OKASIDE, sz, cnt
6950: 29 3b 0a 20 20 54 63 6c 5f 53 65 74 4f 62 6a 52  );.  Tcl_SetObjR
6960: 65 73 75 6c 74 28 69 6e 74 65 72 70 2c 20 70 52  esult(interp, pR
6970: 65 74 29 3b 0a 20 20 72 65 74 75 72 6e 20 54 43  et);.  return TC
6980: 4c 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20  L_OK;.}.../*.** 
6990: 55 73 61 67 65 3a 20 20 20 20 73 71 6c 69 74 65  Usage:    sqlite
69a0: 33 5f 64 62 5f 63 6f 6e 66 69 67 5f 6c 6f 6f 6b  3_db_config_look
69b0: 61 73 69 64 65 20 20 43 4f 4e 4e 45 43 54 49 4f  aside  CONNECTIO
69c0: 4e 20 20 42 55 46 49 44 20 20 53 49 5a 45 20 20  N  BUFID  SIZE  
69d0: 43 4f 55 4e 54 0a 2a 2a 0a 2a 2a 20 54 68 65 72  COUNT.**.** Ther
69e0: 65 20 61 72 65 20 74 77 6f 20 73 74 61 74 69 63  e are two static
69f0: 20 62 75 66 66 65 72 73 20 77 69 74 68 20 42 55   buffers with BU
6a00: 46 49 44 20 31 20 61 6e 64 20 32 2e 20 20 20 45  FID 1 and 2.   E
6a10: 61 63 68 20 73 74 61 74 69 63 20 62 75 66 66 65  ach static buffe
6a20: 72 0a 2a 2a 20 69 73 20 31 30 4b 42 20 69 6e 20  r.** is 10KB in 
6a30: 73 69 7a 65 2e 20 20 41 20 42 55 46 49 44 20 6f  size.  A BUFID o
6a40: 66 20 30 20 69 6e 64 69 63 61 74 65 73 20 74 68  f 0 indicates th
6a50: 61 74 20 74 68 65 20 62 75 66 66 65 72 20 73 68  at the buffer sh
6a60: 6f 75 6c 64 20 62 65 20 4e 55 4c 4c 0a 2a 2a 20  ould be NULL.** 
6a70: 77 68 69 63 68 20 77 69 6c 6c 20 63 61 75 73 65  which will cause
6a80: 20 73 71 6c 69 74 65 33 5f 64 62 5f 63 6f 6e 66   sqlite3_db_conf
6a90: 69 67 28 29 20 74 6f 20 61 6c 6c 6f 63 61 74 65  ig() to allocate
6aa0: 20 73 70 61 63 65 20 6f 6e 20 69 74 73 20 6f 77   space on its ow
6ab0: 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  n..*/.static int
6ac0: 20 53 51 4c 49 54 45 5f 54 43 4c 41 50 49 20 74   SQLITE_TCLAPI t
6ad0: 65 73 74 5f 64 62 5f 63 6f 6e 66 69 67 5f 6c 6f  est_db_config_lo
6ae0: 6f 6b 61 73 69 64 65 28 0a 20 20 76 6f 69 64 20  okaside(.  void 
6af0: 2a 20 63 6c 69 65 6e 74 44 61 74 61 2c 0a 20 20  * clientData,.  
6b00: 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65  Tcl_Interp *inte
6b10: 72 70 2c 0a 20 20 69 6e 74 20 6f 62 6a 63 2c 0a  rp,.  int objc,.
6b20: 20 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54    Tcl_Obj *CONST
6b30: 20 6f 62 6a 76 5b 5d 0a 29 7b 0a 20 20 69 6e 74   objv[].){.  int
6b40: 20 72 63 3b 0a 20 20 69 6e 74 20 73 7a 2c 20 63   rc;.  int sz, c
6b50: 6e 74 3b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64  nt;.  sqlite3 *d
6b60: 62 3b 0a 20 20 69 6e 74 20 62 75 66 69 64 3b 0a  b;.  int bufid;.
6b70: 20 20 73 74 61 74 69 63 20 63 68 61 72 20 61 7a    static char az
6b80: 42 75 66 5b 32 5d 5b 31 30 30 30 30 5d 3b 0a 20  Buf[2][10000];. 
6b90: 20 65 78 74 65 72 6e 20 69 6e 74 20 67 65 74 44   extern int getD
6ba0: 62 50 6f 69 6e 74 65 72 28 54 63 6c 5f 49 6e 74  bPointer(Tcl_Int
6bb0: 65 72 70 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72  erp*, const char
6bc0: 2a 2c 20 73 71 6c 69 74 65 33 2a 2a 29 3b 0a 20  *, sqlite3**);. 
6bd0: 20 69 66 28 20 6f 62 6a 63 21 3d 35 20 29 7b 0a   if( objc!=5 ){.
6be0: 20 20 20 20 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d      Tcl_WrongNum
6bf0: 41 72 67 73 28 69 6e 74 65 72 70 2c 20 31 2c 20  Args(interp, 1, 
6c00: 6f 62 6a 76 2c 20 22 42 55 46 49 44 20 53 49 5a  objv, "BUFID SIZ
6c10: 45 20 43 4f 55 4e 54 22 29 3b 0a 20 20 20 20 72  E COUNT");.    r
6c20: 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b  eturn TCL_ERROR;
6c30: 0a 20 20 7d 0a 20 20 69 66 28 20 67 65 74 44 62  .  }.  if( getDb
6c40: 50 6f 69 6e 74 65 72 28 69 6e 74 65 72 70 2c 20  Pointer(interp, 
6c50: 54 63 6c 5f 47 65 74 53 74 72 69 6e 67 28 6f 62  Tcl_GetString(ob
6c60: 6a 76 5b 31 5d 29 2c 20 26 64 62 29 20 29 20 72  jv[1]), &db) ) r
6c70: 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b  eturn TCL_ERROR;
6c80: 0a 20 20 69 66 28 20 54 63 6c 5f 47 65 74 49 6e  .  if( Tcl_GetIn
6c90: 74 46 72 6f 6d 4f 62 6a 28 69 6e 74 65 72 70 2c  tFromObj(interp,
6ca0: 20 6f 62 6a 76 5b 32 5d 2c 20 26 62 75 66 69 64   objv[2], &bufid
6cb0: 29 20 29 20 72 65 74 75 72 6e 20 54 43 4c 5f 45  ) ) return TCL_E
6cc0: 52 52 4f 52 3b 0a 20 20 69 66 28 20 54 63 6c 5f  RROR;.  if( Tcl_
6cd0: 47 65 74 49 6e 74 46 72 6f 6d 4f 62 6a 28 69 6e  GetIntFromObj(in
6ce0: 74 65 72 70 2c 20 6f 62 6a 76 5b 33 5d 2c 20 26  terp, objv[3], &
6cf0: 73 7a 29 20 29 20 72 65 74 75 72 6e 20 54 43 4c  sz) ) return TCL
6d00: 5f 45 52 52 4f 52 3b 0a 20 20 69 66 28 20 54 63  _ERROR;.  if( Tc
6d10: 6c 5f 47 65 74 49 6e 74 46 72 6f 6d 4f 62 6a 28  l_GetIntFromObj(
6d20: 69 6e 74 65 72 70 2c 20 6f 62 6a 76 5b 34 5d 2c  interp, objv[4],
6d30: 20 26 63 6e 74 29 20 29 20 72 65 74 75 72 6e 20   &cnt) ) return 
6d40: 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 69 66 28  TCL_ERROR;.  if(
6d50: 20 62 75 66 69 64 3d 3d 30 20 29 7b 0a 20 20 20   bufid==0 ){.   
6d60: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 64 62   rc = sqlite3_db
6d70: 5f 63 6f 6e 66 69 67 28 64 62 2c 20 53 51 4c 49  _config(db, SQLI
6d80: 54 45 5f 44 42 43 4f 4e 46 49 47 5f 4c 4f 4f 4b  TE_DBCONFIG_LOOK
6d90: 41 53 49 44 45 2c 20 28 76 6f 69 64 2a 29 30 2c  ASIDE, (void*)0,
6da0: 20 73 7a 2c 20 63 6e 74 29 3b 0a 20 20 7d 65 6c   sz, cnt);.  }el
6db0: 73 65 20 69 66 28 20 62 75 66 69 64 3e 3d 31 20  se if( bufid>=1 
6dc0: 26 26 20 62 75 66 69 64 3c 3d 32 20 26 26 20 73  && bufid<=2 && s
6dd0: 7a 2a 63 6e 74 3c 3d 73 69 7a 65 6f 66 28 61 7a  z*cnt<=sizeof(az
6de0: 42 75 66 5b 30 5d 29 20 29 7b 0a 20 20 20 20 72  Buf[0]) ){.    r
6df0: 63 20 3d 20 73 71 6c 69 74 65 33 5f 64 62 5f 63  c = sqlite3_db_c
6e00: 6f 6e 66 69 67 28 64 62 2c 20 53 51 4c 49 54 45  onfig(db, SQLITE
6e10: 5f 44 42 43 4f 4e 46 49 47 5f 4c 4f 4f 4b 41 53  _DBCONFIG_LOOKAS
6e20: 49 44 45 2c 20 61 7a 42 75 66 5b 62 75 66 69 64  IDE, azBuf[bufid
6e30: 5d 2c 20 73 7a 2c 63 6e 74 29 3b 0a 20 20 7d 65  ], sz,cnt);.  }e
6e40: 6c 73 65 7b 0a 20 20 20 20 54 63 6c 5f 41 70 70  lse{.    Tcl_App
6e50: 65 6e 64 52 65 73 75 6c 74 28 69 6e 74 65 72 70  endResult(interp
6e60: 2c 20 22 69 6c 6c 65 67 61 6c 20 61 72 67 75 6d  , "illegal argum
6e70: 65 6e 74 73 20 2d 20 73 65 65 20 64 6f 63 75 6d  ents - see docum
6e80: 65 6e 74 61 74 69 6f 6e 22 2c 20 28 63 68 61 72  entation", (char
6e90: 2a 29 30 29 3b 0a 20 20 20 20 72 65 74 75 72 6e  *)0);.    return
6ea0: 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a   TCL_ERROR;.  }.
6eb0: 20 20 54 63 6c 5f 53 65 74 4f 62 6a 52 65 73 75    Tcl_SetObjResu
6ec0: 6c 74 28 69 6e 74 65 72 70 2c 20 54 63 6c 5f 4e  lt(interp, Tcl_N
6ed0: 65 77 49 6e 74 4f 62 6a 28 72 63 29 29 3b 0a 20  ewIntObj(rc));. 
6ee0: 20 72 65 74 75 72 6e 20 54 43 4c 5f 4f 4b 3b 0a   return TCL_OK;.
6ef0: 7d 0a 0a 2f 2a 0a 2a 2a 20 55 73 61 67 65 3a 20  }../*.** Usage: 
6f00: 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69     sqlite3_confi
6f10: 67 5f 68 65 61 70 20 4e 42 59 54 45 20 4e 4d 49  g_heap NBYTE NMI
6f20: 4e 41 4c 4c 4f 43 0a 2a 2f 0a 73 74 61 74 69 63  NALLOC.*/.static
6f30: 20 69 6e 74 20 53 51 4c 49 54 45 5f 54 43 4c 41   int SQLITE_TCLA
6f40: 50 49 20 74 65 73 74 5f 63 6f 6e 66 69 67 5f 68  PI test_config_h
6f50: 65 61 70 28 0a 20 20 76 6f 69 64 20 2a 20 63 6c  eap(.  void * cl
6f60: 69 65 6e 74 44 61 74 61 2c 20 0a 20 20 54 63 6c  ientData, .  Tcl
6f70: 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65 72 70 2c  _Interp *interp,
6f80: 0a 20 20 69 6e 74 20 6f 62 6a 63 2c 0a 20 20 54  .  int objc,.  T
6f90: 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54 20 6f 62  cl_Obj *CONST ob
6fa0: 6a 76 5b 5d 0a 29 7b 0a 20 20 73 74 61 74 69 63  jv[].){.  static
6fb0: 20 63 68 61 72 20 2a 7a 42 75 66 3b 20 2f 2a 20   char *zBuf; /* 
6fc0: 55 73 65 20 74 68 69 73 20 6d 65 6d 6f 72 79 20  Use this memory 
6fd0: 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 74 65 3b 20  */.  int nByte; 
6fe0: 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20          /* Size 
6ff0: 6f 66 20 62 75 66 66 65 72 20 74 6f 20 70 61 73  of buffer to pas
7000: 73 20 74 6f 20 73 71 6c 69 74 65 33 5f 63 6f 6e  s to sqlite3_con
7010: 66 69 67 28 29 20 2a 2f 0a 20 20 69 6e 74 20 6e  fig() */.  int n
7020: 4d 69 6e 41 6c 6c 6f 63 3b 20 20 20 20 20 2f 2a  MinAlloc;     /*
7030: 20 53 69 7a 65 20 6f 66 20 6d 69 6e 69 6d 75 6d   Size of minimum
7040: 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 2a 2f 0a 20   allocation */. 
7050: 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20   int rc;        
7060: 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f      /* Return co
7070: 64 65 20 6f 66 20 73 71 6c 69 74 65 33 5f 63 6f  de of sqlite3_co
7080: 6e 66 69 67 28 29 20 2a 2f 0a 0a 20 20 54 63 6c  nfig() */..  Tcl
7090: 5f 4f 62 6a 20 2a 20 43 4f 4e 53 54 20 2a 61 41  _Obj * CONST *aA
70a0: 72 67 20 3d 20 26 6f 62 6a 76 5b 31 5d 3b 0a 20  rg = &objv[1];. 
70b0: 20 69 6e 74 20 6e 41 72 67 20 3d 20 6f 62 6a 63   int nArg = objc
70c0: 2d 31 3b 0a 0a 20 20 69 66 28 20 6e 41 72 67 21  -1;..  if( nArg!
70d0: 3d 32 20 29 7b 0a 20 20 20 20 54 63 6c 5f 57 72  =2 ){.    Tcl_Wr
70e0: 6f 6e 67 4e 75 6d 41 72 67 73 28 69 6e 74 65 72  ongNumArgs(inter
70f0: 70 2c 20 31 2c 20 6f 62 6a 76 2c 20 22 4e 42 59  p, 1, objv, "NBY
7100: 54 45 20 4e 4d 49 4e 41 4c 4c 4f 43 22 29 3b 0a  TE NMINALLOC");.
7110: 20 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45      return TCL_E
7120: 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 69 66 28 20  RROR;.  }.  if( 
7130: 54 63 6c 5f 47 65 74 49 6e 74 46 72 6f 6d 4f 62  Tcl_GetIntFromOb
7140: 6a 28 69 6e 74 65 72 70 2c 20 61 41 72 67 5b 30  j(interp, aArg[0
7150: 5d 2c 20 26 6e 42 79 74 65 29 20 29 20 72 65 74  ], &nByte) ) ret
7160: 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20  urn TCL_ERROR;. 
7170: 20 69 66 28 20 54 63 6c 5f 47 65 74 49 6e 74 46   if( Tcl_GetIntF
7180: 72 6f 6d 4f 62 6a 28 69 6e 74 65 72 70 2c 20 61  romObj(interp, a
7190: 41 72 67 5b 31 5d 2c 20 26 6e 4d 69 6e 41 6c 6c  Arg[1], &nMinAll
71a0: 6f 63 29 20 29 20 72 65 74 75 72 6e 20 54 43 4c  oc) ) return TCL
71b0: 5f 45 52 52 4f 52 3b 0a 0a 20 20 69 66 28 20 6e  _ERROR;..  if( n
71c0: 42 79 74 65 3d 3d 30 20 29 7b 0a 20 20 20 20 66  Byte==0 ){.    f
71d0: 72 65 65 28 20 7a 42 75 66 20 29 3b 0a 20 20 20  ree( zBuf );.   
71e0: 20 7a 42 75 66 20 3d 20 30 3b 0a 20 20 20 20 72   zBuf = 0;.    r
71f0: 63 20 3d 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66  c = sqlite3_conf
7200: 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47  ig(SQLITE_CONFIG
7210: 5f 48 45 41 50 2c 20 28 76 6f 69 64 2a 29 30 2c  _HEAP, (void*)0,
7220: 20 30 2c 20 30 29 3b 0a 20 20 7d 65 6c 73 65 7b   0, 0);.  }else{
7230: 0a 20 20 20 20 7a 42 75 66 20 3d 20 72 65 61 6c  .    zBuf = real
7240: 6c 6f 63 28 7a 42 75 66 2c 20 6e 42 79 74 65 29  loc(zBuf, nByte)
7250: 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74  ;.    rc = sqlit
7260: 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54 45  e3_config(SQLITE
7270: 5f 43 4f 4e 46 49 47 5f 48 45 41 50 2c 20 7a 42  _CONFIG_HEAP, zB
7280: 75 66 2c 20 6e 42 79 74 65 2c 20 6e 4d 69 6e 41  uf, nByte, nMinA
7290: 6c 6c 6f 63 29 3b 0a 20 20 7d 0a 0a 20 20 54 63  lloc);.  }..  Tc
72a0: 6c 5f 53 65 74 52 65 73 75 6c 74 28 69 6e 74 65  l_SetResult(inte
72b0: 72 70 2c 20 28 63 68 61 72 20 2a 29 73 71 6c 69  rp, (char *)sqli
72c0: 74 65 33 45 72 72 4e 61 6d 65 28 72 63 29 2c 20  te3ErrName(rc), 
72d0: 54 43 4c 5f 56 4f 4c 41 54 49 4c 45 29 3b 0a 20  TCL_VOLATILE);. 
72e0: 20 72 65 74 75 72 6e 20 54 43 4c 5f 4f 4b 3b 0a   return TCL_OK;.
72f0: 7d 0a 0a 2f 2a 0a 2a 2a 20 55 73 61 67 65 3a 20  }../*.** Usage: 
7300: 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69     sqlite3_confi
7310: 67 5f 68 65 61 70 5f 73 69 7a 65 20 4e 42 59 54  g_heap_size NBYT
7320: 45 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  E.*/.static int 
7330: 53 51 4c 49 54 45 5f 54 43 4c 41 50 49 20 74 65  SQLITE_TCLAPI te
7340: 73 74 5f 63 6f 6e 66 69 67 5f 68 65 61 70 5f 73  st_config_heap_s
7350: 69 7a 65 28 0a 20 20 76 6f 69 64 20 2a 20 63 6c  ize(.  void * cl
7360: 69 65 6e 74 44 61 74 61 2c 20 0a 20 20 54 63 6c  ientData, .  Tcl
7370: 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65 72 70 2c  _Interp *interp,
7380: 0a 20 20 69 6e 74 20 6f 62 6a 63 2c 0a 20 20 54  .  int objc,.  T
7390: 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54 20 6f 62  cl_Obj *CONST ob
73a0: 6a 76 5b 5d 0a 29 7b 0a 20 20 69 6e 74 20 6e 42  jv[].){.  int nB
73b0: 79 74 65 3b 20 20 20 20 20 20 20 20 20 2f 2a 20  yte;         /* 
73c0: 53 69 7a 65 20 74 6f 20 70 61 73 73 20 74 6f 20  Size to pass to 
73d0: 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 29  sqlite3_config()
73e0: 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b 20 20 20   */.  int rc;   
73f0: 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75           /* Retu
7400: 72 6e 20 63 6f 64 65 20 6f 66 20 73 71 6c 69 74  rn code of sqlit
7410: 65 33 5f 63 6f 6e 66 69 67 28 29 20 2a 2f 0a 0a  e3_config() */..
7420: 20 20 54 63 6c 5f 4f 62 6a 20 2a 20 43 4f 4e 53    Tcl_Obj * CONS
7430: 54 20 2a 61 41 72 67 20 3d 20 26 6f 62 6a 76 5b  T *aArg = &objv[
7440: 31 5d 3b 0a 20 20 69 6e 74 20 6e 41 72 67 20 3d  1];.  int nArg =
7450: 20 6f 62 6a 63 2d 31 3b 0a 0a 20 20 69 66 28 20   objc-1;..  if( 
7460: 6e 41 72 67 21 3d 31 20 29 7b 0a 20 20 20 20 54  nArg!=1 ){.    T
7470: 63 6c 5f 57 72 6f 6e 67 4e 75 6d 41 72 67 73 28  cl_WrongNumArgs(
7480: 69 6e 74 65 72 70 2c 20 31 2c 20 6f 62 6a 76 2c  interp, 1, objv,
7490: 20 22 4e 42 59 54 45 22 29 3b 0a 20 20 20 20 72   "NBYTE");.    r
74a0: 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b  eturn TCL_ERROR;
74b0: 0a 20 20 7d 0a 20 20 69 66 28 20 54 63 6c 5f 47  .  }.  if( Tcl_G
74c0: 65 74 49 6e 74 46 72 6f 6d 4f 62 6a 28 69 6e 74  etIntFromObj(int
74d0: 65 72 70 2c 20 61 41 72 67 5b 30 5d 2c 20 26 6e  erp, aArg[0], &n
74e0: 42 79 74 65 29 20 29 20 72 65 74 75 72 6e 20 54  Byte) ) return T
74f0: 43 4c 5f 45 52 52 4f 52 3b 0a 0a 20 20 72 63 20  CL_ERROR;..  rc 
7500: 3d 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67  = sqlite3_config
7510: 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 57  (SQLITE_CONFIG_W
7520: 49 4e 33 32 5f 48 45 41 50 53 49 5a 45 2c 20 6e  IN32_HEAPSIZE, n
7530: 42 79 74 65 29 3b 0a 0a 20 20 54 63 6c 5f 53 65  Byte);..  Tcl_Se
7540: 74 52 65 73 75 6c 74 28 69 6e 74 65 72 70 2c 20  tResult(interp, 
7550: 28 63 68 61 72 20 2a 29 73 71 6c 69 74 65 33 45  (char *)sqlite3E
7560: 72 72 4e 61 6d 65 28 72 63 29 2c 20 54 43 4c 5f  rrName(rc), TCL_
7570: 56 4f 4c 41 54 49 4c 45 29 3b 0a 20 20 72 65 74  VOLATILE);.  ret
7580: 75 72 6e 20 54 43 4c 5f 4f 4b 3b 0a 7d 0a 0a 2f  urn TCL_OK;.}../
7590: 2a 0a 2a 2a 20 55 73 61 67 65 3a 20 20 20 20 73  *.** Usage:    s
75a0: 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 5f 65 72  qlite3_config_er
75b0: 72 6f 72 20 20 5b 44 42 5d 0a 2a 2a 0a 2a 2a 20  ror  [DB].**.** 
75c0: 49 6e 76 6f 6b 65 20 73 71 6c 69 74 65 33 5f 63  Invoke sqlite3_c
75d0: 6f 6e 66 69 67 28 29 20 6f 72 20 73 71 6c 69 74  onfig() or sqlit
75e0: 65 33 5f 64 62 5f 63 6f 6e 66 69 67 28 29 20 77  e3_db_config() w
75f0: 69 74 68 20 69 6e 76 61 6c 69 64 0a 2a 2a 20 6f  ith invalid.** o
7600: 70 63 6f 64 65 73 20 61 6e 64 20 76 65 72 69 66  pcodes and verif
7610: 79 20 74 68 61 74 20 74 68 65 79 20 72 65 74 75  y that they retu
7620: 72 6e 20 65 72 72 6f 72 73 2e 0a 2a 2f 0a 73 74  rn errors..*/.st
7630: 61 74 69 63 20 69 6e 74 20 53 51 4c 49 54 45 5f  atic int SQLITE_
7640: 54 43 4c 41 50 49 20 74 65 73 74 5f 63 6f 6e 66  TCLAPI test_conf
7650: 69 67 5f 65 72 72 6f 72 28 0a 20 20 76 6f 69 64  ig_error(.  void
7660: 20 2a 20 63 6c 69 65 6e 74 44 61 74 61 2c 20 0a   * clientData, .
7670: 20 20 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69 6e    Tcl_Interp *in
7680: 74 65 72 70 2c 0a 20 20 69 6e 74 20 6f 62 6a 63  terp,.  int objc
7690: 2c 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e  ,.  Tcl_Obj *CON
76a0: 53 54 20 6f 62 6a 76 5b 5d 0a 29 7b 0a 20 20 73  ST objv[].){.  s
76b0: 71 6c 69 74 65 33 20 2a 64 62 3b 0a 20 20 65 78  qlite3 *db;.  ex
76c0: 74 65 72 6e 20 69 6e 74 20 67 65 74 44 62 50 6f  tern int getDbPo
76d0: 69 6e 74 65 72 28 54 63 6c 5f 49 6e 74 65 72 70  inter(Tcl_Interp
76e0: 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20  *, const char*, 
76f0: 73 71 6c 69 74 65 33 2a 2a 29 3b 0a 0a 20 20 69  sqlite3**);..  i
7700: 66 28 20 6f 62 6a 63 21 3d 32 20 26 26 20 6f 62  f( objc!=2 && ob
7710: 6a 63 21 3d 31 20 29 7b 0a 20 20 20 20 54 63 6c  jc!=1 ){.    Tcl
7720: 5f 57 72 6f 6e 67 4e 75 6d 41 72 67 73 28 69 6e  _WrongNumArgs(in
7730: 74 65 72 70 2c 20 31 2c 20 6f 62 6a 76 2c 20 22  terp, 1, objv, "
7740: 5b 44 42 5d 22 29 3b 0a 20 20 20 20 72 65 74 75  [DB]");.    retu
7750: 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20  rn TCL_ERROR;.  
7760: 7d 0a 20 20 69 66 28 20 6f 62 6a 63 3d 3d 32 20  }.  if( objc==2 
7770: 29 7b 0a 20 20 20 20 69 66 28 20 67 65 74 44 62  ){.    if( getDb
7780: 50 6f 69 6e 74 65 72 28 69 6e 74 65 72 70 2c 20  Pointer(interp, 
7790: 54 63 6c 5f 47 65 74 53 74 72 69 6e 67 28 6f 62  Tcl_GetString(ob
77a0: 6a 76 5b 31 5d 29 2c 20 26 64 62 29 20 29 20 72  jv[1]), &db) ) r
77b0: 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b  eturn TCL_ERROR;
77c0: 0a 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33  .    if( sqlite3
77d0: 5f 64 62 5f 63 6f 6e 66 69 67 28 64 62 2c 20 39  _db_config(db, 9
77e0: 39 39 39 39 29 21 3d 53 51 4c 49 54 45 5f 45 52  9999)!=SQLITE_ER
77f0: 52 4f 52 20 29 7b 0a 20 20 20 20 20 20 54 63 6c  ROR ){.      Tcl
7800: 5f 41 70 70 65 6e 64 52 65 73 75 6c 74 28 69 6e  _AppendResult(in
7810: 74 65 72 70 2c 20 0a 20 20 20 20 20 20 20 20 20  terp, .         
7820: 20 20 20 22 73 71 6c 69 74 65 33 5f 64 62 5f 63     "sqlite3_db_c
7830: 6f 6e 66 69 67 28 64 62 2c 20 39 39 39 39 39 29  onfig(db, 99999)
7840: 20 64 6f 65 73 20 6e 6f 74 20 72 65 74 75 72 6e   does not return
7850: 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 22 2c 0a   SQLITE_ERROR",.
7860: 20 20 20 20 20 20 20 20 20 20 20 20 28 63 68 61              (cha
7870: 72 2a 29 30 29 3b 0a 20 20 20 20 20 20 72 65 74  r*)0);.      ret
7880: 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20  urn TCL_ERROR;. 
7890: 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20     }.  }else{.  
78a0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 5f 63 6f    if( sqlite3_co
78b0: 6e 66 69 67 28 39 39 39 39 39 29 21 3d 53 51 4c  nfig(99999)!=SQL
78c0: 49 54 45 5f 45 52 52 4f 52 20 29 7b 0a 20 20 20  ITE_ERROR ){.   
78d0: 20 20 20 54 63 6c 5f 41 70 70 65 6e 64 52 65 73     Tcl_AppendRes
78e0: 75 6c 74 28 69 6e 74 65 72 70 2c 20 0a 20 20 20  ult(interp, .   
78f0: 20 20 20 20 20 20 20 22 73 71 6c 69 74 65 33 5f         "sqlite3_
7900: 63 6f 6e 66 69 67 28 39 39 39 39 39 29 20 64 6f  config(99999) do
7910: 65 73 20 6e 6f 74 20 72 65 74 75 72 6e 20 53 51  es not return SQ
7920: 4c 49 54 45 5f 45 52 52 4f 52 22 2c 0a 20 20 20  LITE_ERROR",.   
7930: 20 20 20 20 20 20 20 28 63 68 61 72 2a 29 30 29         (char*)0)
7940: 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 54  ;.      return T
7950: 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 20 20 7d 0a  CL_ERROR;.    }.
7960: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 54 43 4c    }.  return TCL
7970: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55 73  _OK;.}../*.** Us
7980: 61 67 65 3a 20 20 20 20 73 71 6c 69 74 65 33 5f  age:    sqlite3_
7990: 63 6f 6e 66 69 67 5f 75 72 69 20 20 42 4f 4f 4c  config_uri  BOOL
79a0: 45 41 4e 0a 2a 2a 0a 2a 2a 20 45 6e 61 62 6c 65  EAN.**.** Enable
79b0: 73 20 6f 72 20 64 69 73 61 62 6c 65 73 20 69 6e  s or disables in
79c0: 74 65 72 70 72 65 74 61 74 69 6f 6e 20 6f 66 20  terpretation of 
79d0: 55 52 49 20 70 61 72 61 6d 65 74 65 72 73 20 62  URI parameters b
79e0: 79 20 64 65 66 61 75 6c 74 20 75 73 69 6e 67 0a  y default using.
79f0: 2a 2a 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47  ** SQLITE_CONFIG
7a00: 5f 55 52 49 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  _URI..*/.static 
7a10: 69 6e 74 20 53 51 4c 49 54 45 5f 54 43 4c 41 50  int SQLITE_TCLAP
7a20: 49 20 74 65 73 74 5f 63 6f 6e 66 69 67 5f 75 72  I test_config_ur
7a30: 69 28 0a 20 20 76 6f 69 64 20 2a 20 63 6c 69 65  i(.  void * clie
7a40: 6e 74 44 61 74 61 2c 20 0a 20 20 54 63 6c 5f 49  ntData, .  Tcl_I
7a50: 6e 74 65 72 70 20 2a 69 6e 74 65 72 70 2c 0a 20  nterp *interp,. 
7a60: 20 69 6e 74 20 6f 62 6a 63 2c 0a 20 20 54 63 6c   int objc,.  Tcl
7a70: 5f 4f 62 6a 20 2a 43 4f 4e 53 54 20 6f 62 6a 76  _Obj *CONST objv
7a80: 5b 5d 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a  [].){.  int rc;.
7a90: 20 20 69 6e 74 20 62 4f 70 65 6e 55 72 69 3b 0a    int bOpenUri;.
7aa0: 0a 20 20 69 66 28 20 6f 62 6a 63 21 3d 32 20 29  .  if( objc!=2 )
7ab0: 7b 0a 20 20 20 20 54 63 6c 5f 57 72 6f 6e 67 4e  {.    Tcl_WrongN
7ac0: 75 6d 41 72 67 73 28 69 6e 74 65 72 70 2c 20 31  umArgs(interp, 1
7ad0: 2c 20 6f 62 6a 76 2c 20 22 42 4f 4f 4c 22 29 3b  , objv, "BOOL");
7ae0: 0a 20 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f  .    return TCL_
7af0: 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 69 66 28  ERROR;.  }.  if(
7b00: 20 54 63 6c 5f 47 65 74 42 6f 6f 6c 65 61 6e 46   Tcl_GetBooleanF
7b10: 72 6f 6d 4f 62 6a 28 69 6e 74 65 72 70 2c 20 6f  romObj(interp, o
7b20: 62 6a 76 5b 31 5d 2c 20 26 62 4f 70 65 6e 55 72  bjv[1], &bOpenUr
7b30: 69 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  i) ){.    return
7b40: 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a   TCL_ERROR;.  }.
7b50: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f  .  rc = sqlite3_
7b60: 63 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f 43 4f  config(SQLITE_CO
7b70: 4e 46 49 47 5f 55 52 49 2c 20 62 4f 70 65 6e 55  NFIG_URI, bOpenU
7b80: 72 69 29 3b 0a 20 20 54 63 6c 5f 53 65 74 52 65  ri);.  Tcl_SetRe
7b90: 73 75 6c 74 28 69 6e 74 65 72 70 2c 20 28 63 68  sult(interp, (ch
7ba0: 61 72 20 2a 29 73 71 6c 69 74 65 33 45 72 72 4e  ar *)sqlite3ErrN
7bb0: 61 6d 65 28 72 63 29 2c 20 54 43 4c 5f 56 4f 4c  ame(rc), TCL_VOL
7bc0: 41 54 49 4c 45 29 3b 0a 0a 20 20 72 65 74 75 72  ATILE);..  retur
7bd0: 6e 20 54 43 4c 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a  n TCL_OK;.}../*.
7be0: 2a 2a 20 55 73 61 67 65 3a 20 20 20 20 73 71 6c  ** Usage:    sql
7bf0: 69 74 65 33 5f 63 6f 6e 66 69 67 5f 63 69 73 20  ite3_config_cis 
7c00: 20 42 4f 4f 4c 45 41 4e 0a 2a 2a 0a 2a 2a 20 45   BOOLEAN.**.** E
7c10: 6e 61 62 6c 65 73 20 6f 72 20 64 69 73 61 62 6c  nables or disabl
7c20: 65 73 20 74 68 65 20 75 73 65 20 6f 66 20 74 68  es the use of th
7c30: 65 20 63 6f 76 65 72 69 6e 67 2d 69 6e 64 65 78  e covering-index
7c40: 20 73 63 61 6e 20 6f 70 74 69 6d 69 7a 61 74 69   scan optimizati
7c50: 6f 6e 2e 0a 2a 2a 20 53 51 4c 49 54 45 5f 43 4f  on..** SQLITE_CO
7c60: 4e 46 49 47 5f 43 4f 56 45 52 49 4e 47 5f 49 4e  NFIG_COVERING_IN
7c70: 44 45 58 5f 53 43 41 4e 2e 0a 2a 2f 0a 73 74 61  DEX_SCAN..*/.sta
7c80: 74 69 63 20 69 6e 74 20 53 51 4c 49 54 45 5f 54  tic int SQLITE_T
7c90: 43 4c 41 50 49 20 74 65 73 74 5f 63 6f 6e 66 69  CLAPI test_confi
7ca0: 67 5f 63 69 73 28 0a 20 20 76 6f 69 64 20 2a 20  g_cis(.  void * 
7cb0: 63 6c 69 65 6e 74 44 61 74 61 2c 20 0a 20 20 54  clientData, .  T
7cc0: 63 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65 72  cl_Interp *inter
7cd0: 70 2c 0a 20 20 69 6e 74 20 6f 62 6a 63 2c 0a 20  p,.  int objc,. 
7ce0: 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54 20   Tcl_Obj *CONST 
7cf0: 6f 62 6a 76 5b 5d 0a 29 7b 0a 20 20 69 6e 74 20  objv[].){.  int 
7d00: 72 63 3b 0a 20 20 69 6e 74 20 62 55 73 65 43 69  rc;.  int bUseCi
7d10: 73 3b 0a 0a 20 20 69 66 28 20 6f 62 6a 63 21 3d  s;..  if( objc!=
7d20: 32 20 29 7b 0a 20 20 20 20 54 63 6c 5f 57 72 6f  2 ){.    Tcl_Wro
7d30: 6e 67 4e 75 6d 41 72 67 73 28 69 6e 74 65 72 70  ngNumArgs(interp
7d40: 2c 20 31 2c 20 6f 62 6a 76 2c 20 22 42 4f 4f 4c  , 1, objv, "BOOL
7d50: 22 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 54  ");.    return T
7d60: 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20  CL_ERROR;.  }.  
7d70: 69 66 28 20 54 63 6c 5f 47 65 74 42 6f 6f 6c 65  if( Tcl_GetBoole
7d80: 61 6e 46 72 6f 6d 4f 62 6a 28 69 6e 74 65 72 70  anFromObj(interp
7d90: 2c 20 6f 62 6a 76 5b 31 5d 2c 20 26 62 55 73 65  , objv[1], &bUse
7da0: 43 69 73 29 20 29 7b 0a 20 20 20 20 72 65 74 75  Cis) ){.    retu
7db0: 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20  rn TCL_ERROR;.  
7dc0: 7d 0a 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65  }..  rc = sqlite
7dd0: 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f  3_config(SQLITE_
7de0: 43 4f 4e 46 49 47 5f 43 4f 56 45 52 49 4e 47 5f  CONFIG_COVERING_
7df0: 49 4e 44 45 58 5f 53 43 41 4e 2c 20 62 55 73 65  INDEX_SCAN, bUse
7e00: 43 69 73 29 3b 0a 20 20 54 63 6c 5f 53 65 74 52  Cis);.  Tcl_SetR
7e10: 65 73 75 6c 74 28 69 6e 74 65 72 70 2c 20 28 63  esult(interp, (c
7e20: 68 61 72 20 2a 29 73 71 6c 69 74 65 33 45 72 72  har *)sqlite3Err
7e30: 4e 61 6d 65 28 72 63 29 2c 20 54 43 4c 5f 56 4f  Name(rc), TCL_VO
7e40: 4c 41 54 49 4c 45 29 3b 0a 0a 20 20 72 65 74 75  LATILE);..  retu
7e50: 72 6e 20 54 43 4c 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a  rn TCL_OK;.}../*
7e60: 0a 2a 2a 20 55 73 61 67 65 3a 20 20 20 20 73 71  .** Usage:    sq
7e70: 6c 69 74 65 33 5f 63 6f 6e 66 69 67 5f 70 6d 61  lite3_config_pma
7e80: 73 7a 20 20 49 4e 54 45 47 45 52 0a 2a 2a 0a 2a  sz  INTEGER.**.*
7e90: 2a 20 53 65 74 20 74 68 65 20 6d 69 6e 69 6d 75  * Set the minimu
7ea0: 6d 20 50 4d 41 20 73 69 7a 65 2e 0a 2a 2f 0a 73  m PMA size..*/.s
7eb0: 74 61 74 69 63 20 69 6e 74 20 53 51 4c 49 54 45  tatic int SQLITE
7ec0: 5f 54 43 4c 41 50 49 20 74 65 73 74 5f 63 6f 6e  _TCLAPI test_con
7ed0: 66 69 67 5f 70 6d 61 73 7a 28 0a 20 20 76 6f 69  fig_pmasz(.  voi
7ee0: 64 20 2a 20 63 6c 69 65 6e 74 44 61 74 61 2c 20  d * clientData, 
7ef0: 0a 20 20 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69  .  Tcl_Interp *i
7f00: 6e 74 65 72 70 2c 0a 20 20 69 6e 74 20 6f 62 6a  nterp,.  int obj
7f10: 63 2c 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f  c,.  Tcl_Obj *CO
7f20: 4e 53 54 20 6f 62 6a 76 5b 5d 0a 29 7b 0a 20 20  NST objv[].){.  
7f30: 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74 20 69 50  int rc;.  int iP
7f40: 6d 61 53 7a 3b 0a 0a 20 20 69 66 28 20 6f 62 6a  maSz;..  if( obj
7f50: 63 21 3d 32 20 29 7b 0a 20 20 20 20 54 63 6c 5f  c!=2 ){.    Tcl_
7f60: 57 72 6f 6e 67 4e 75 6d 41 72 67 73 28 69 6e 74  WrongNumArgs(int
7f70: 65 72 70 2c 20 31 2c 20 6f 62 6a 76 2c 20 22 42  erp, 1, objv, "B
7f80: 4f 4f 4c 22 29 3b 0a 20 20 20 20 72 65 74 75 72  OOL");.    retur
7f90: 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 7d  n TCL_ERROR;.  }
7fa0: 0a 20 20 69 66 28 20 54 63 6c 5f 47 65 74 49 6e  .  if( Tcl_GetIn
7fb0: 74 46 72 6f 6d 4f 62 6a 28 69 6e 74 65 72 70 2c  tFromObj(interp,
7fc0: 20 6f 62 6a 76 5b 31 5d 2c 20 26 69 50 6d 61 53   objv[1], &iPmaS
7fd0: 7a 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  z) ){.    return
7fe0: 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a   TCL_ERROR;.  }.
7ff0: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f  .  rc = sqlite3_
8000: 63 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f 43 4f  config(SQLITE_CO
8010: 4e 46 49 47 5f 50 4d 41 53 5a 2c 20 69 50 6d 61  NFIG_PMASZ, iPma
8020: 53 7a 29 3b 0a 20 20 54 63 6c 5f 53 65 74 52 65  Sz);.  Tcl_SetRe
8030: 73 75 6c 74 28 69 6e 74 65 72 70 2c 20 28 63 68  sult(interp, (ch
8040: 61 72 20 2a 29 73 71 6c 69 74 65 33 45 72 72 4e  ar *)sqlite3ErrN
8050: 61 6d 65 28 72 63 29 2c 20 54 43 4c 5f 56 4f 4c  ame(rc), TCL_VOL
8060: 41 54 49 4c 45 29 3b 0a 0a 20 20 72 65 74 75 72  ATILE);..  retur
8070: 6e 20 54 43 4c 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a  n TCL_OK;.}.../*
8080: 0a 2a 2a 20 55 73 61 67 65 3a 20 20 20 20 73 71  .** Usage:    sq
8090: 6c 69 74 65 33 5f 64 75 6d 70 5f 6d 65 6d 73 79  lite3_dump_memsy
80a0: 73 33 20 20 46 49 4c 45 4e 41 4d 45 0a 2a 2a 20  s3  FILENAME.** 
80b0: 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65            sqlite
80c0: 33 5f 64 75 6d 70 5f 6d 65 6d 73 79 73 35 20 20  3_dump_memsys5  
80d0: 46 49 4c 45 4e 41 4d 45 0a 2a 2a 0a 2a 2a 20 57  FILENAME.**.** W
80e0: 72 69 74 65 20 61 20 73 75 6d 6d 61 72 79 20 6f  rite a summary o
80f0: 66 20 75 6e 66 72 65 65 64 20 6d 65 6d 73 79 73  f unfreed memsys
8100: 33 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 74 6f  3 allocations to
8110: 20 46 49 4c 45 4e 41 4d 45 2e 0a 2a 2f 0a 73 74   FILENAME..*/.st
8120: 61 74 69 63 20 69 6e 74 20 53 51 4c 49 54 45 5f  atic int SQLITE_
8130: 54 43 4c 41 50 49 20 74 65 73 74 5f 64 75 6d 70  TCLAPI test_dump
8140: 5f 6d 65 6d 73 79 73 33 28 0a 20 20 76 6f 69 64  _memsys3(.  void
8150: 20 2a 20 63 6c 69 65 6e 74 44 61 74 61 2c 0a 20   * clientData,. 
8160: 20 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74   Tcl_Interp *int
8170: 65 72 70 2c 0a 20 20 69 6e 74 20 6f 62 6a 63 2c  erp,.  int objc,
8180: 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53  .  Tcl_Obj *CONS
8190: 54 20 6f 62 6a 76 5b 5d 0a 29 7b 0a 20 20 69 66  T objv[].){.  if
81a0: 28 20 6f 62 6a 63 21 3d 32 20 29 7b 0a 20 20 20  ( objc!=2 ){.   
81b0: 20 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d 41 72 67   Tcl_WrongNumArg
81c0: 73 28 69 6e 74 65 72 70 2c 20 31 2c 20 6f 62 6a  s(interp, 1, obj
81d0: 76 2c 20 22 46 49 4c 45 4e 41 4d 45 22 29 3b 0a  v, "FILENAME");.
81e0: 20 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45      return TCL_E
81f0: 52 52 4f 52 3b 0a 20 20 7d 0a 0a 20 20 73 77 69  RROR;.  }..  swi
8200: 74 63 68 28 20 53 51 4c 49 54 45 5f 50 54 52 5f  tch( SQLITE_PTR_
8210: 54 4f 5f 49 4e 54 28 63 6c 69 65 6e 74 44 61 74  TO_INT(clientDat
8220: 61 29 20 29 7b 0a 20 20 20 20 63 61 73 65 20 33  a) ){.    case 3
8230: 3a 20 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54  : {.#ifdef SQLIT
8240: 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 33  E_ENABLE_MEMSYS3
8250: 0a 20 20 20 20 20 20 65 78 74 65 72 6e 20 76 6f  .      extern vo
8260: 69 64 20 73 71 6c 69 74 65 33 4d 65 6d 73 79 73  id sqlite3Memsys
8270: 33 44 75 6d 70 28 63 6f 6e 73 74 20 63 68 61 72  3Dump(const char
8280: 2a 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  *);.      sqlite
8290: 33 4d 65 6d 73 79 73 33 44 75 6d 70 28 54 63 6c  3Memsys3Dump(Tcl
82a0: 5f 47 65 74 53 74 72 69 6e 67 28 6f 62 6a 76 5b  _GetString(objv[
82b0: 31 5d 29 29 3b 0a 20 20 20 20 20 20 62 72 65 61  1]));.      brea
82c0: 6b 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 7d 0a  k;.#endif.    }.
82d0: 20 20 20 20 63 61 73 65 20 35 3a 20 7b 0a 23 69      case 5: {.#i
82e0: 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42  fdef SQLITE_ENAB
82f0: 4c 45 5f 4d 45 4d 53 59 53 35 0a 20 20 20 20 20  LE_MEMSYS5.     
8300: 20 65 78 74 65 72 6e 20 76 6f 69 64 20 73 71 6c   extern void sql
8310: 69 74 65 33 4d 65 6d 73 79 73 35 44 75 6d 70 28  ite3Memsys5Dump(
8320: 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 20 20  const char*);.  
8330: 20 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 73 79      sqlite3Memsy
8340: 73 35 44 75 6d 70 28 54 63 6c 5f 47 65 74 53 74  s5Dump(Tcl_GetSt
8350: 72 69 6e 67 28 6f 62 6a 76 5b 31 5d 29 29 3b 0a  ring(objv[1]));.
8360: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 23 65 6e        break;.#en
8370: 64 69 66 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20  dif.    }.  }.  
8380: 72 65 74 75 72 6e 20 54 43 4c 5f 4f 4b 3b 0a 7d  return TCL_OK;.}
8390: 0a 0a 2f 2a 0a 2a 2a 20 55 73 61 67 65 3a 20 20  ../*.** Usage:  
83a0: 20 20 73 71 6c 69 74 65 33 5f 73 74 61 74 75 73    sqlite3_status
83b0: 20 20 4f 50 43 4f 44 45 20 20 52 45 53 45 54 46    OPCODE  RESETF
83c0: 4c 41 47 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e  LAG.**.** Return
83d0: 20 61 20 6c 69 73 74 20 6f 66 20 74 68 72 65 65   a list of three
83e0: 20 65 6c 65 6d 65 6e 74 73 20 77 68 69 63 68 20   elements which 
83f0: 61 72 65 20 74 68 65 20 73 71 6c 69 74 65 33 5f  are the sqlite3_
8400: 73 74 61 74 75 73 28 29 20 72 65 74 75 72 6e 0a  status() return.
8410: 2a 2a 20 63 6f 64 65 2c 20 74 68 65 20 63 75 72  ** code, the cur
8420: 72 65 6e 74 20 76 61 6c 75 65 2c 20 61 6e 64 20  rent value, and 
8430: 74 68 65 20 68 69 67 68 2d 77 61 74 65 72 20 6d  the high-water m
8440: 61 72 6b 20 76 61 6c 75 65 2e 0a 2a 2f 0a 73 74  ark value..*/.st
8450: 61 74 69 63 20 69 6e 74 20 53 51 4c 49 54 45 5f  atic int SQLITE_
8460: 54 43 4c 41 50 49 20 74 65 73 74 5f 73 74 61 74  TCLAPI test_stat
8470: 75 73 28 0a 20 20 76 6f 69 64 20 2a 20 63 6c 69  us(.  void * cli
8480: 65 6e 74 44 61 74 61 2c 0a 20 20 54 63 6c 5f 49  entData,.  Tcl_I
8490: 6e 74 65 72 70 20 2a 69 6e 74 65 72 70 2c 0a 20  nterp *interp,. 
84a0: 20 69 6e 74 20 6f 62 6a 63 2c 0a 20 20 54 63 6c   int objc,.  Tcl
84b0: 5f 4f 62 6a 20 2a 43 4f 4e 53 54 20 6f 62 6a 76  _Obj *CONST objv
84c0: 5b 5d 0a 29 7b 0a 20 20 69 6e 74 20 72 63 2c 20  [].){.  int rc, 
84d0: 69 56 61 6c 75 65 2c 20 6d 78 56 61 6c 75 65 3b  iValue, mxValue;
84e0: 0a 20 20 69 6e 74 20 69 2c 20 6f 70 20 3d 20 30  .  int i, op = 0
84f0: 2c 20 72 65 73 65 74 46 6c 61 67 3b 0a 20 20 63  , resetFlag;.  c
8500: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4f 70 4e 61  onst char *zOpNa
8510: 6d 65 3b 0a 20 20 73 74 61 74 69 63 20 63 6f 6e  me;.  static con
8520: 73 74 20 73 74 72 75 63 74 20 7b 0a 20 20 20 20  st struct {.    
8530: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d  const char *zNam
8540: 65 3b 0a 20 20 20 20 69 6e 74 20 6f 70 3b 0a 20  e;.    int op;. 
8550: 20 7d 20 61 4f 70 5b 5d 20 3d 20 7b 0a 20 20 20   } aOp[] = {.   
8560: 20 7b 20 22 53 51 4c 49 54 45 5f 53 54 41 54 55   { "SQLITE_STATU
8570: 53 5f 4d 45 4d 4f 52 59 5f 55 53 45 44 22 2c 20  S_MEMORY_USED", 
8580: 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 53          SQLITE_S
8590: 54 41 54 55 53 5f 4d 45 4d 4f 52 59 5f 55 53 45  TATUS_MEMORY_USE
85a0: 44 20 20 20 20 20 20 20 20 20 7d 2c 0a 20 20 20  D         },.   
85b0: 20 7b 20 22 53 51 4c 49 54 45 5f 53 54 41 54 55   { "SQLITE_STATU
85c0: 53 5f 4d 41 4c 4c 4f 43 5f 53 49 5a 45 22 2c 20  S_MALLOC_SIZE", 
85d0: 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 53          SQLITE_S
85e0: 54 41 54 55 53 5f 4d 41 4c 4c 4f 43 5f 53 49 5a  TATUS_MALLOC_SIZ
85f0: 45 20 20 20 20 20 20 20 20 20 7d 2c 0a 20 20 20  E         },.   
8600: 20 7b 20 22 53 51 4c 49 54 45 5f 53 54 41 54 55   { "SQLITE_STATU
8610: 53 5f 50 41 47 45 43 41 43 48 45 5f 55 53 45 44  S_PAGECACHE_USED
8620: 22 2c 20 20 20 20 20 20 53 51 4c 49 54 45 5f 53  ",      SQLITE_S
8630: 54 41 54 55 53 5f 50 41 47 45 43 41 43 48 45 5f  TATUS_PAGECACHE_
8640: 55 53 45 44 20 20 20 20 20 20 7d 2c 0a 20 20 20  USED      },.   
8650: 20 7b 20 22 53 51 4c 49 54 45 5f 53 54 41 54 55   { "SQLITE_STATU
8660: 53 5f 50 41 47 45 43 41 43 48 45 5f 4f 56 45 52  S_PAGECACHE_OVER
8670: 46 4c 4f 57 22 2c 20 20 53 51 4c 49 54 45 5f 53  FLOW",  SQLITE_S
8680: 54 41 54 55 53 5f 50 41 47 45 43 41 43 48 45 5f  TATUS_PAGECACHE_
8690: 4f 56 45 52 46 4c 4f 57 20 20 7d 2c 0a 20 20 20  OVERFLOW  },.   
86a0: 20 7b 20 22 53 51 4c 49 54 45 5f 53 54 41 54 55   { "SQLITE_STATU
86b0: 53 5f 50 41 47 45 43 41 43 48 45 5f 53 49 5a 45  S_PAGECACHE_SIZE
86c0: 22 2c 20 20 20 20 20 20 53 51 4c 49 54 45 5f 53  ",      SQLITE_S
86d0: 54 41 54 55 53 5f 50 41 47 45 43 41 43 48 45 5f  TATUS_PAGECACHE_
86e0: 53 49 5a 45 20 20 20 20 20 20 7d 2c 0a 20 20 20  SIZE      },.   
86f0: 20 7b 20 22 53 51 4c 49 54 45 5f 53 54 41 54 55   { "SQLITE_STATU
8700: 53 5f 53 43 52 41 54 43 48 5f 55 53 45 44 22 2c  S_SCRATCH_USED",
8710: 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 53          SQLITE_S
8720: 54 41 54 55 53 5f 53 43 52 41 54 43 48 5f 55 53  TATUS_SCRATCH_US
8730: 45 44 20 20 20 20 20 20 20 20 7d 2c 0a 20 20 20  ED        },.   
8740: 20 7b 20 22 53 51 4c 49 54 45 5f 53 54 41 54 55   { "SQLITE_STATU
8750: 53 5f 53 43 52 41 54 43 48 5f 4f 56 45 52 46 4c  S_SCRATCH_OVERFL
8760: 4f 57 22 2c 20 20 20 20 53 51 4c 49 54 45 5f 53  OW",    SQLITE_S
8770: 54 41 54 55 53 5f 53 43 52 41 54 43 48 5f 4f 56  TATUS_SCRATCH_OV
8780: 45 52 46 4c 4f 57 20 20 20 20 7d 2c 0a 20 20 20  ERFLOW    },.   
8790: 20 7b 20 22 53 51 4c 49 54 45 5f 53 54 41 54 55   { "SQLITE_STATU
87a0: 53 5f 53 43 52 41 54 43 48 5f 53 49 5a 45 22 2c  S_SCRATCH_SIZE",
87b0: 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 53          SQLITE_S
87c0: 54 41 54 55 53 5f 53 43 52 41 54 43 48 5f 53 49  TATUS_SCRATCH_SI
87d0: 5a 45 20 20 20 20 20 20 20 20 7d 2c 0a 20 20 20  ZE        },.   
87e0: 20 7b 20 22 53 51 4c 49 54 45 5f 53 54 41 54 55   { "SQLITE_STATU
87f0: 53 5f 50 41 52 53 45 52 5f 53 54 41 43 4b 22 2c  S_PARSER_STACK",
8800: 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 53          SQLITE_S
8810: 54 41 54 55 53 5f 50 41 52 53 45 52 5f 53 54 41  TATUS_PARSER_STA
8820: 43 4b 20 20 20 20 20 20 20 20 7d 2c 0a 20 20 20  CK        },.   
8830: 20 7b 20 22 53 51 4c 49 54 45 5f 53 54 41 54 55   { "SQLITE_STATU
8840: 53 5f 4d 41 4c 4c 4f 43 5f 43 4f 55 4e 54 22 2c  S_MALLOC_COUNT",
8850: 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 53          SQLITE_S
8860: 54 41 54 55 53 5f 4d 41 4c 4c 4f 43 5f 43 4f 55  TATUS_MALLOC_COU
8870: 4e 54 20 20 20 20 20 20 20 20 7d 2c 0a 20 20 7d  NT        },.  }
8880: 3b 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a 70 52 65  ;.  Tcl_Obj *pRe
8890: 73 75 6c 74 3b 0a 20 20 69 66 28 20 6f 62 6a 63  sult;.  if( objc
88a0: 21 3d 33 20 29 7b 0a 20 20 20 20 54 63 6c 5f 57  !=3 ){.    Tcl_W
88b0: 72 6f 6e 67 4e 75 6d 41 72 67 73 28 69 6e 74 65  rongNumArgs(inte
88c0: 72 70 2c 20 31 2c 20 6f 62 6a 76 2c 20 22 50 41  rp, 1, objv, "PA
88d0: 52 41 4d 45 54 45 52 20 52 45 53 45 54 46 4c 41  RAMETER RESETFLA
88e0: 47 22 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20  G");.    return 
88f0: 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20  TCL_ERROR;.  }. 
8900: 20 7a 4f 70 4e 61 6d 65 20 3d 20 54 63 6c 5f 47   zOpName = Tcl_G
8910: 65 74 53 74 72 69 6e 67 28 6f 62 6a 76 5b 31 5d  etString(objv[1]
8920: 29 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c  );.  for(i=0; i<
8930: 41 72 72 61 79 53 69 7a 65 28 61 4f 70 29 3b 20  ArraySize(aOp); 
8940: 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 73 74  i++){.    if( st
8950: 72 63 6d 70 28 61 4f 70 5b 69 5d 2e 7a 4e 61 6d  rcmp(aOp[i].zNam
8960: 65 2c 20 7a 4f 70 4e 61 6d 65 29 3d 3d 30 20 29  e, zOpName)==0 )
8970: 7b 0a 20 20 20 20 20 20 6f 70 20 3d 20 61 4f 70  {.      op = aOp
8980: 5b 69 5d 2e 6f 70 3b 0a 20 20 20 20 20 20 62 72  [i].op;.      br
8990: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20  eak;.    }.  }. 
89a0: 20 69 66 28 20 69 3e 3d 41 72 72 61 79 53 69 7a   if( i>=ArraySiz
89b0: 65 28 61 4f 70 29 20 29 7b 0a 20 20 20 20 69 66  e(aOp) ){.    if
89c0: 28 20 54 63 6c 5f 47 65 74 49 6e 74 46 72 6f 6d  ( Tcl_GetIntFrom
89d0: 4f 62 6a 28 69 6e 74 65 72 70 2c 20 6f 62 6a 76  Obj(interp, objv
89e0: 5b 31 5d 2c 20 26 6f 70 29 20 29 20 72 65 74 75  [1], &op) ) retu
89f0: 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20  rn TCL_ERROR;.  
8a00: 7d 0a 20 20 69 66 28 20 54 63 6c 5f 47 65 74 42  }.  if( Tcl_GetB
8a10: 6f 6f 6c 65 61 6e 46 72 6f 6d 4f 62 6a 28 69 6e  ooleanFromObj(in
8a20: 74 65 72 70 2c 20 6f 62 6a 76 5b 32 5d 2c 20 26  terp, objv[2], &
8a30: 72 65 73 65 74 46 6c 61 67 29 20 29 20 72 65 74  resetFlag) ) ret
8a40: 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20  urn TCL_ERROR;. 
8a50: 20 69 56 61 6c 75 65 20 3d 20 30 3b 0a 20 20 6d   iValue = 0;.  m
8a60: 78 56 61 6c 75 65 20 3d 20 30 3b 0a 20 20 72 63  xValue = 0;.  rc
8a70: 20 3d 20 73 71 6c 69 74 65 33 5f 73 74 61 74 75   = sqlite3_statu
8a80: 73 28 6f 70 2c 20 26 69 56 61 6c 75 65 2c 20 26  s(op, &iValue, &
8a90: 6d 78 56 61 6c 75 65 2c 20 72 65 73 65 74 46 6c  mxValue, resetFl
8aa0: 61 67 29 3b 0a 20 20 70 52 65 73 75 6c 74 20 3d  ag);.  pResult =
8ab0: 20 54 63 6c 5f 4e 65 77 4f 62 6a 28 29 3b 0a 20   Tcl_NewObj();. 
8ac0: 20 54 63 6c 5f 4c 69 73 74 4f 62 6a 41 70 70 65   Tcl_ListObjAppe
8ad0: 6e 64 45 6c 65 6d 65 6e 74 28 30 2c 20 70 52 65  ndElement(0, pRe
8ae0: 73 75 6c 74 2c 20 54 63 6c 5f 4e 65 77 49 6e 74  sult, Tcl_NewInt
8af0: 4f 62 6a 28 72 63 29 29 3b 0a 20 20 54 63 6c 5f  Obj(rc));.  Tcl_
8b00: 4c 69 73 74 4f 62 6a 41 70 70 65 6e 64 45 6c 65  ListObjAppendEle
8b10: 6d 65 6e 74 28 30 2c 20 70 52 65 73 75 6c 74 2c  ment(0, pResult,
8b20: 20 54 63 6c 5f 4e 65 77 49 6e 74 4f 62 6a 28 69   Tcl_NewIntObj(i
8b30: 56 61 6c 75 65 29 29 3b 0a 20 20 54 63 6c 5f 4c  Value));.  Tcl_L
8b40: 69 73 74 4f 62 6a 41 70 70 65 6e 64 45 6c 65 6d  istObjAppendElem
8b50: 65 6e 74 28 30 2c 20 70 52 65 73 75 6c 74 2c 20  ent(0, pResult, 
8b60: 54 63 6c 5f 4e 65 77 49 6e 74 4f 62 6a 28 6d 78  Tcl_NewIntObj(mx
8b70: 56 61 6c 75 65 29 29 3b 0a 20 20 54 63 6c 5f 53  Value));.  Tcl_S
8b80: 65 74 4f 62 6a 52 65 73 75 6c 74 28 69 6e 74 65  etObjResult(inte
8b90: 72 70 2c 20 70 52 65 73 75 6c 74 29 3b 0a 20 20  rp, pResult);.  
8ba0: 72 65 74 75 72 6e 20 54 43 4c 5f 4f 4b 3b 0a 7d  return TCL_OK;.}
8bb0: 0a 0a 2f 2a 0a 2a 2a 20 55 73 61 67 65 3a 20 20  ../*.** Usage:  
8bc0: 20 20 73 71 6c 69 74 65 33 5f 64 62 5f 73 74 61    sqlite3_db_sta
8bd0: 74 75 73 20 20 44 41 54 41 42 41 53 45 20 20 4f  tus  DATABASE  O
8be0: 50 43 4f 44 45 20 20 52 45 53 45 54 46 4c 41 47  PCODE  RESETFLAG
8bf0: 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20  .**.** Return a 
8c00: 6c 69 73 74 20 6f 66 20 74 68 72 65 65 20 65 6c  list of three el
8c10: 65 6d 65 6e 74 73 20 77 68 69 63 68 20 61 72 65  ements which are
8c20: 20 74 68 65 20 73 71 6c 69 74 65 33 5f 64 62 5f   the sqlite3_db_
8c30: 73 74 61 74 75 73 28 29 20 72 65 74 75 72 6e 0a  status() return.
8c40: 2a 2a 20 63 6f 64 65 2c 20 74 68 65 20 63 75 72  ** code, the cur
8c50: 72 65 6e 74 20 76 61 6c 75 65 2c 20 61 6e 64 20  rent value, and 
8c60: 74 68 65 20 68 69 67 68 2d 77 61 74 65 72 20 6d  the high-water m
8c70: 61 72 6b 20 76 61 6c 75 65 2e 0a 2a 2f 0a 73 74  ark value..*/.st
8c80: 61 74 69 63 20 69 6e 74 20 53 51 4c 49 54 45 5f  atic int SQLITE_
8c90: 54 43 4c 41 50 49 20 74 65 73 74 5f 64 62 5f 73  TCLAPI test_db_s
8ca0: 74 61 74 75 73 28 0a 20 20 76 6f 69 64 20 2a 20  tatus(.  void * 
8cb0: 63 6c 69 65 6e 74 44 61 74 61 2c 0a 20 20 54 63  clientData,.  Tc
8cc0: 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65 72 70  l_Interp *interp
8cd0: 2c 0a 20 20 69 6e 74 20 6f 62 6a 63 2c 0a 20 20  ,.  int objc,.  
8ce0: 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54 20 6f  Tcl_Obj *CONST o
8cf0: 62 6a 76 5b 5d 0a 29 7b 0a 20 20 69 6e 74 20 72  bjv[].){.  int r
8d00: 63 2c 20 69 56 61 6c 75 65 2c 20 6d 78 56 61 6c  c, iValue, mxVal
8d10: 75 65 3b 0a 20 20 69 6e 74 20 69 2c 20 6f 70 20  ue;.  int i, op 
8d20: 3d 20 30 2c 20 72 65 73 65 74 46 6c 61 67 3b 0a  = 0, resetFlag;.
8d30: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4f    const char *zO
8d40: 70 4e 61 6d 65 3b 0a 20 20 73 71 6c 69 74 65 33  pName;.  sqlite3
8d50: 20 2a 64 62 3b 0a 20 20 65 78 74 65 72 6e 20 69   *db;.  extern i
8d60: 6e 74 20 67 65 74 44 62 50 6f 69 6e 74 65 72 28  nt getDbPointer(
8d70: 54 63 6c 5f 49 6e 74 65 72 70 2a 2c 20 63 6f 6e  Tcl_Interp*, con
8d80: 73 74 20 63 68 61 72 2a 2c 20 73 71 6c 69 74 65  st char*, sqlite
8d90: 33 2a 2a 29 3b 0a 20 20 73 74 61 74 69 63 20 63  3**);.  static c
8da0: 6f 6e 73 74 20 73 74 72 75 63 74 20 7b 0a 20 20  onst struct {.  
8db0: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e    const char *zN
8dc0: 61 6d 65 3b 0a 20 20 20 20 69 6e 74 20 6f 70 3b  ame;.    int op;
8dd0: 0a 20 20 7d 20 61 4f 70 5b 5d 20 3d 20 7b 0a 20  .  } aOp[] = {. 
8de0: 20 20 20 7b 20 22 4c 4f 4f 4b 41 53 49 44 45 5f     { "LOOKASIDE_
8df0: 55 53 45 44 22 2c 20 20 20 20 20 20 53 51 4c 49  USED",      SQLI
8e00: 54 45 5f 44 42 53 54 41 54 55 53 5f 4c 4f 4f 4b  TE_DBSTATUS_LOOK
8e10: 41 53 49 44 45 5f 55 53 45 44 20 20 20 20 20 20  ASIDE_USED      
8e20: 7d 2c 0a 20 20 20 20 7b 20 22 43 41 43 48 45 5f  },.    { "CACHE_
8e30: 55 53 45 44 22 2c 20 20 20 20 20 20 20 20 20 20  USED",          
8e40: 53 51 4c 49 54 45 5f 44 42 53 54 41 54 55 53 5f  SQLITE_DBSTATUS_
8e50: 43 41 43 48 45 5f 55 53 45 44 20 20 20 20 20 20  CACHE_USED      
8e60: 20 20 20 20 7d 2c 0a 20 20 20 20 7b 20 22 53 43      },.    { "SC
8e70: 48 45 4d 41 5f 55 53 45 44 22 2c 20 20 20 20 20  HEMA_USED",     
8e80: 20 20 20 20 53 51 4c 49 54 45 5f 44 42 53 54 41      SQLITE_DBSTA
8e90: 54 55 53 5f 53 43 48 45 4d 41 5f 55 53 45 44 20  TUS_SCHEMA_USED 
8ea0: 20 20 20 20 20 20 20 20 7d 2c 0a 20 20 20 20 7b          },.    {
8eb0: 20 22 53 54 4d 54 5f 55 53 45 44 22 2c 20 20 20   "STMT_USED",   
8ec0: 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 44          SQLITE_D
8ed0: 42 53 54 41 54 55 53 5f 53 54 4d 54 5f 55 53 45  BSTATUS_STMT_USE
8ee0: 44 20 20 20 20 20 20 20 20 20 20 20 7d 2c 0a 20  D           },. 
8ef0: 20 20 20 7b 20 22 4c 4f 4f 4b 41 53 49 44 45 5f     { "LOOKASIDE_
8f00: 48 49 54 22 2c 20 20 20 20 20 20 20 53 51 4c 49  HIT",       SQLI
8f10: 54 45 5f 44 42 53 54 41 54 55 53 5f 4c 4f 4f 4b  TE_DBSTATUS_LOOK
8f20: 41 53 49 44 45 5f 48 49 54 20 20 20 20 20 20 20  ASIDE_HIT       
8f30: 7d 2c 0a 20 20 20 20 7b 20 22 4c 4f 4f 4b 41 53  },.    { "LOOKAS
8f40: 49 44 45 5f 4d 49 53 53 5f 53 49 5a 45 22 2c 20  IDE_MISS_SIZE", 
8f50: 53 51 4c 49 54 45 5f 44 42 53 54 41 54 55 53 5f  SQLITE_DBSTATUS_
8f60: 4c 4f 4f 4b 41 53 49 44 45 5f 4d 49 53 53 5f 53  LOOKASIDE_MISS_S
8f70: 49 5a 45 20 7d 2c 0a 20 20 20 20 7b 20 22 4c 4f  IZE },.    { "LO
8f80: 4f 4b 41 53 49 44 45 5f 4d 49 53 53 5f 46 55 4c  OKASIDE_MISS_FUL
8f90: 4c 22 2c 20 53 51 4c 49 54 45 5f 44 42 53 54 41  L", SQLITE_DBSTA
8fa0: 54 55 53 5f 4c 4f 4f 4b 41 53 49 44 45 5f 4d 49  TUS_LOOKASIDE_MI
8fb0: 53 53 5f 46 55 4c 4c 20 7d 2c 0a 20 20 20 20 7b  SS_FULL },.    {
8fc0: 20 22 43 41 43 48 45 5f 48 49 54 22 2c 20 20 20   "CACHE_HIT",   
8fd0: 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 44          SQLITE_D
8fe0: 42 53 54 41 54 55 53 5f 43 41 43 48 45 5f 48 49  BSTATUS_CACHE_HI
8ff0: 54 20 20 20 20 20 20 20 20 20 20 20 7d 2c 0a 20  T           },. 
9000: 20 20 20 7b 20 22 43 41 43 48 45 5f 4d 49 53 53     { "CACHE_MISS
9010: 22 2c 20 20 20 20 20 20 20 20 20 20 53 51 4c 49  ",          SQLI
9020: 54 45 5f 44 42 53 54 41 54 55 53 5f 43 41 43 48  TE_DBSTATUS_CACH
9030: 45 5f 4d 49 53 53 20 20 20 20 20 20 20 20 20 20  E_MISS          
9040: 7d 2c 0a 20 20 20 20 7b 20 22 43 41 43 48 45 5f  },.    { "CACHE_
9050: 57 52 49 54 45 22 2c 20 20 20 20 20 20 20 20 20  WRITE",         
9060: 53 51 4c 49 54 45 5f 44 42 53 54 41 54 55 53 5f  SQLITE_DBSTATUS_
9070: 43 41 43 48 45 5f 57 52 49 54 45 20 20 20 20 20  CACHE_WRITE     
9080: 20 20 20 20 7d 2c 0a 20 20 20 20 7b 20 22 44 45      },.    { "DE
9090: 46 45 52 52 45 44 5f 46 4b 53 22 2c 20 20 20 20  FERRED_FKS",    
90a0: 20 20 20 20 53 51 4c 49 54 45 5f 44 42 53 54 41      SQLITE_DBSTA
90b0: 54 55 53 5f 44 45 46 45 52 52 45 44 5f 46 4b 53  TUS_DEFERRED_FKS
90c0: 20 20 20 20 20 20 20 20 7d 2c 0a 20 20 20 20 7b          },.    {
90d0: 20 22 43 41 43 48 45 5f 55 53 45 44 5f 53 48 41   "CACHE_USED_SHA
90e0: 52 45 44 22 2c 20 20 20 53 51 4c 49 54 45 5f 44  RED",   SQLITE_D
90f0: 42 53 54 41 54 55 53 5f 43 41 43 48 45 5f 55 53  BSTATUS_CACHE_US
9100: 45 44 5f 53 48 41 52 45 44 20 20 20 7d 2c 0a 20  ED_SHARED   },. 
9110: 20 7d 3b 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a 70   };.  Tcl_Obj *p
9120: 52 65 73 75 6c 74 3b 0a 20 20 69 66 28 20 6f 62  Result;.  if( ob
9130: 6a 63 21 3d 34 20 29 7b 0a 20 20 20 20 54 63 6c  jc!=4 ){.    Tcl
9140: 5f 57 72 6f 6e 67 4e 75 6d 41 72 67 73 28 69 6e  _WrongNumArgs(in
9150: 74 65 72 70 2c 20 31 2c 20 6f 62 6a 76 2c 20 22  terp, 1, objv, "
9160: 44 42 20 50 41 52 41 4d 45 54 45 52 20 52 45 53  DB PARAMETER RES
9170: 45 54 46 4c 41 47 22 29 3b 0a 20 20 20 20 72 65  ETFLAG");.    re
9180: 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a  turn TCL_ERROR;.
9190: 20 20 7d 0a 20 20 69 66 28 20 67 65 74 44 62 50    }.  if( getDbP
91a0: 6f 69 6e 74 65 72 28 69 6e 74 65 72 70 2c 20 54  ointer(interp, T
91b0: 63 6c 5f 47 65 74 53 74 72 69 6e 67 28 6f 62 6a  cl_GetString(obj
91c0: 76 5b 31 5d 29 2c 20 26 64 62 29 20 29 20 72 65  v[1]), &db) ) re
91d0: 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a  turn TCL_ERROR;.
91e0: 20 20 7a 4f 70 4e 61 6d 65 20 3d 20 54 63 6c 5f    zOpName = Tcl_
91f0: 47 65 74 53 74 72 69 6e 67 28 6f 62 6a 76 5b 32  GetString(objv[2
9200: 5d 29 3b 0a 20 20 69 66 28 20 6d 65 6d 63 6d 70  ]);.  if( memcmp
9210: 28 7a 4f 70 4e 61 6d 65 2c 20 22 53 51 4c 49 54  (zOpName, "SQLIT
9220: 45 5f 22 2c 20 37 29 3d 3d 30 20 29 20 7a 4f 70  E_", 7)==0 ) zOp
9230: 4e 61 6d 65 20 2b 3d 20 37 3b 0a 20 20 69 66 28  Name += 7;.  if(
9240: 20 6d 65 6d 63 6d 70 28 7a 4f 70 4e 61 6d 65 2c   memcmp(zOpName,
9250: 20 22 44 42 53 54 41 54 55 53 5f 22 2c 20 39 29   "DBSTATUS_", 9)
9260: 3d 3d 30 20 29 20 7a 4f 70 4e 61 6d 65 20 2b 3d  ==0 ) zOpName +=
9270: 20 39 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69   9;.  for(i=0; i
9280: 3c 41 72 72 61 79 53 69 7a 65 28 61 4f 70 29 3b  <ArraySize(aOp);
9290: 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 73   i++){.    if( s
92a0: 74 72 63 6d 70 28 61 4f 70 5b 69 5d 2e 7a 4e 61  trcmp(aOp[i].zNa
92b0: 6d 65 2c 20 7a 4f 70 4e 61 6d 65 29 3d 3d 30 20  me, zOpName)==0 
92c0: 29 7b 0a 20 20 20 20 20 20 6f 70 20 3d 20 61 4f  ){.      op = aO
92d0: 70 5b 69 5d 2e 6f 70 3b 0a 20 20 20 20 20 20 62  p[i].op;.      b
92e0: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  reak;.    }.  }.
92f0: 20 20 69 66 28 20 69 3e 3d 41 72 72 61 79 53 69    if( i>=ArraySi
9300: 7a 65 28 61 4f 70 29 20 29 7b 0a 20 20 20 20 69  ze(aOp) ){.    i
9310: 66 28 20 54 63 6c 5f 47 65 74 49 6e 74 46 72 6f  f( Tcl_GetIntFro
9320: 6d 4f 62 6a 28 69 6e 74 65 72 70 2c 20 6f 62 6a  mObj(interp, obj
9330: 76 5b 32 5d 2c 20 26 6f 70 29 20 29 20 72 65 74  v[2], &op) ) ret
9340: 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20  urn TCL_ERROR;. 
9350: 20 7d 0a 20 20 69 66 28 20 54 63 6c 5f 47 65 74   }.  if( Tcl_Get
9360: 42 6f 6f 6c 65 61 6e 46 72 6f 6d 4f 62 6a 28 69  BooleanFromObj(i
9370: 6e 74 65 72 70 2c 20 6f 62 6a 76 5b 33 5d 2c 20  nterp, objv[3], 
9380: 26 72 65 73 65 74 46 6c 61 67 29 20 29 20 72 65  &resetFlag) ) re
9390: 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a  turn TCL_ERROR;.
93a0: 20 20 69 56 61 6c 75 65 20 3d 20 30 3b 0a 20 20    iValue = 0;.  
93b0: 6d 78 56 61 6c 75 65 20 3d 20 30 3b 0a 20 20 72  mxValue = 0;.  r
93c0: 63 20 3d 20 73 71 6c 69 74 65 33 5f 64 62 5f 73  c = sqlite3_db_s
93d0: 74 61 74 75 73 28 64 62 2c 20 6f 70 2c 20 26 69  tatus(db, op, &i
93e0: 56 61 6c 75 65 2c 20 26 6d 78 56 61 6c 75 65 2c  Value, &mxValue,
93f0: 20 72 65 73 65 74 46 6c 61 67 29 3b 0a 20 20 70   resetFlag);.  p
9400: 52 65 73 75 6c 74 20 3d 20 54 63 6c 5f 4e 65 77  Result = Tcl_New
9410: 4f 62 6a 28 29 3b 0a 20 20 54 63 6c 5f 4c 69 73  Obj();.  Tcl_Lis
9420: 74 4f 62 6a 41 70 70 65 6e 64 45 6c 65 6d 65 6e  tObjAppendElemen
9430: 74 28 30 2c 20 70 52 65 73 75 6c 74 2c 20 54 63  t(0, pResult, Tc
9440: 6c 5f 4e 65 77 49 6e 74 4f 62 6a 28 72 63 29 29  l_NewIntObj(rc))
9450: 3b 0a 20 20 54 63 6c 5f 4c 69 73 74 4f 62 6a 41  ;.  Tcl_ListObjA
9460: 70 70 65 6e 64 45 6c 65 6d 65 6e 74 28 30 2c 20  ppendElement(0, 
9470: 70 52 65 73 75 6c 74 2c 20 54 63 6c 5f 4e 65 77  pResult, Tcl_New
9480: 49 6e 74 4f 62 6a 28 69 56 61 6c 75 65 29 29 3b  IntObj(iValue));
9490: 0a 20 20 54 63 6c 5f 4c 69 73 74 4f 62 6a 41 70  .  Tcl_ListObjAp
94a0: 70 65 6e 64 45 6c 65 6d 65 6e 74 28 30 2c 20 70  pendElement(0, p
94b0: 52 65 73 75 6c 74 2c 20 54 63 6c 5f 4e 65 77 49  Result, Tcl_NewI
94c0: 6e 74 4f 62 6a 28 6d 78 56 61 6c 75 65 29 29 3b  ntObj(mxValue));
94d0: 0a 20 20 54 63 6c 5f 53 65 74 4f 62 6a 52 65 73  .  Tcl_SetObjRes
94e0: 75 6c 74 28 69 6e 74 65 72 70 2c 20 70 52 65 73  ult(interp, pRes
94f0: 75 6c 74 29 3b 0a 20 20 72 65 74 75 72 6e 20 54  ult);.  return T
9500: 43 4c 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  CL_OK;.}../*.** 
9510: 69 6e 73 74 61 6c 6c 5f 6d 61 6c 6c 6f 63 5f 66  install_malloc_f
9520: 61 75 6c 74 73 69 6d 20 42 4f 4f 4c 45 41 4e 0a  aultsim BOOLEAN.
9530: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 53 51  */.static int SQ
9540: 4c 49 54 45 5f 54 43 4c 41 50 49 20 74 65 73 74  LITE_TCLAPI test
9550: 5f 69 6e 73 74 61 6c 6c 5f 6d 61 6c 6c 6f 63 5f  _install_malloc_
9560: 66 61 75 6c 74 73 69 6d 28 0a 20 20 76 6f 69 64  faultsim(.  void
9570: 20 2a 20 63 6c 69 65 6e 74 44 61 74 61 2c 0a 20   * clientData,. 
9580: 20 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74   Tcl_Interp *int
9590: 65 72 70 2c 0a 20 20 69 6e 74 20 6f 62 6a 63 2c  erp,.  int objc,
95a0: 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53  .  Tcl_Obj *CONS
95b0: 54 20 6f 62 6a 76 5b 5d 0a 29 7b 0a 20 20 69 6e  T objv[].){.  in
95c0: 74 20 72 63 3b 0a 20 20 69 6e 74 20 69 73 49 6e  t rc;.  int isIn
95d0: 73 74 61 6c 6c 3b 0a 0a 20 20 69 66 28 20 6f 62  stall;..  if( ob
95e0: 6a 63 21 3d 32 20 29 7b 0a 20 20 20 20 54 63 6c  jc!=2 ){.    Tcl
95f0: 5f 57 72 6f 6e 67 4e 75 6d 41 72 67 73 28 69 6e  _WrongNumArgs(in
9600: 74 65 72 70 2c 20 31 2c 20 6f 62 6a 76 2c 20 22  terp, 1, objv, "
9610: 42 4f 4f 4c 45 41 4e 22 29 3b 0a 20 20 20 20 72  BOOLEAN");.    r
9620: 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b  eturn TCL_ERROR;
9630: 0a 20 20 7d 0a 20 20 69 66 28 20 54 43 4c 5f 4f  .  }.  if( TCL_O
9640: 4b 21 3d 54 63 6c 5f 47 65 74 42 6f 6f 6c 65 61  K!=Tcl_GetBoolea
9650: 6e 46 72 6f 6d 4f 62 6a 28 69 6e 74 65 72 70 2c  nFromObj(interp,
9660: 20 6f 62 6a 76 5b 31 5d 2c 20 26 69 73 49 6e 73   objv[1], &isIns
9670: 74 61 6c 6c 29 20 29 7b 0a 20 20 20 20 72 65 74  tall) ){.    ret
9680: 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20  urn TCL_ERROR;. 
9690: 20 7d 0a 20 20 72 63 20 3d 20 66 61 75 6c 74 73   }.  rc = faults
96a0: 69 6d 49 6e 73 74 61 6c 6c 28 69 73 49 6e 73 74  imInstall(isInst
96b0: 61 6c 6c 29 3b 0a 20 20 54 63 6c 5f 53 65 74 52  all);.  Tcl_SetR
96c0: 65 73 75 6c 74 28 69 6e 74 65 72 70 2c 20 28 63  esult(interp, (c
96d0: 68 61 72 20 2a 29 73 71 6c 69 74 65 33 45 72 72  har *)sqlite3Err
96e0: 4e 61 6d 65 28 72 63 29 2c 20 54 43 4c 5f 56 4f  Name(rc), TCL_VO
96f0: 4c 41 54 49 4c 45 29 3b 0a 20 20 72 65 74 75 72  LATILE);.  retur
9700: 6e 20 54 43 4c 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a  n TCL_OK;.}../*.
9710: 2a 2a 20 73 71 6c 69 74 65 33 5f 69 6e 73 74 61  ** sqlite3_insta
9720: 6c 6c 5f 6d 65 6d 73 79 73 33 0a 2a 2f 0a 73 74  ll_memsys3.*/.st
9730: 61 74 69 63 20 69 6e 74 20 53 51 4c 49 54 45 5f  atic int SQLITE_
9740: 54 43 4c 41 50 49 20 74 65 73 74 5f 69 6e 73 74  TCLAPI test_inst
9750: 61 6c 6c 5f 6d 65 6d 73 79 73 33 28 0a 20 20 76  all_memsys3(.  v
9760: 6f 69 64 20 2a 20 63 6c 69 65 6e 74 44 61 74 61  oid * clientData
9770: 2c 0a 20 20 54 63 6c 5f 49 6e 74 65 72 70 20 2a  ,.  Tcl_Interp *
9780: 69 6e 74 65 72 70 2c 0a 20 20 69 6e 74 20 6f 62  interp,.  int ob
9790: 6a 63 2c 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a 43  jc,.  Tcl_Obj *C
97a0: 4f 4e 53 54 20 6f 62 6a 76 5b 5d 0a 29 7b 0a 20  ONST objv[].){. 
97b0: 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45   int rc = SQLITE
97c0: 5f 4d 49 53 55 53 45 3b 0a 23 69 66 64 65 66 20  _MISUSE;.#ifdef 
97d0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45  SQLITE_ENABLE_ME
97e0: 4d 53 59 53 33 0a 20 20 63 6f 6e 73 74 20 73 71  MSYS3.  const sq
97f0: 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 6f 64  lite3_mem_method
9800: 73 20 2a 73 71 6c 69 74 65 33 4d 65 6d 47 65 74  s *sqlite3MemGet
9810: 4d 65 6d 73 79 73 33 28 76 6f 69 64 29 3b 0a 20  Memsys3(void);. 
9820: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 63 6f   rc = sqlite3_co
9830: 6e 66 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46  nfig(SQLITE_CONF
9840: 49 47 5f 4d 41 4c 4c 4f 43 2c 20 73 71 6c 69 74  IG_MALLOC, sqlit
9850: 65 33 4d 65 6d 47 65 74 4d 65 6d 73 79 73 33 28  e3MemGetMemsys3(
9860: 29 29 3b 0a 23 65 6e 64 69 66 0a 20 20 54 63 6c  ));.#endif.  Tcl
9870: 5f 53 65 74 52 65 73 75 6c 74 28 69 6e 74 65 72  _SetResult(inter
9880: 70 2c 20 28 63 68 61 72 20 2a 29 73 71 6c 69 74  p, (char *)sqlit
9890: 65 33 45 72 72 4e 61 6d 65 28 72 63 29 2c 20 54  e3ErrName(rc), T
98a0: 43 4c 5f 56 4f 4c 41 54 49 4c 45 29 3b 0a 20 20  CL_VOLATILE);.  
98b0: 72 65 74 75 72 6e 20 54 43 4c 5f 4f 4b 3b 0a 7d  return TCL_OK;.}
98c0: 0a 0a 73 74 61 74 69 63 20 69 6e 74 20 53 51 4c  ..static int SQL
98d0: 49 54 45 5f 54 43 4c 41 50 49 20 74 65 73 74 5f  ITE_TCLAPI test_
98e0: 76 66 73 5f 6f 6f 6d 5f 74 65 73 74 28 0a 20 20  vfs_oom_test(.  
98f0: 76 6f 69 64 20 2a 20 63 6c 69 65 6e 74 44 61 74  void * clientDat
9900: 61 2c 0a 20 20 54 63 6c 5f 49 6e 74 65 72 70 20  a,.  Tcl_Interp 
9910: 2a 69 6e 74 65 72 70 2c 0a 20 20 69 6e 74 20 6f  *interp,.  int o
9920: 62 6a 63 2c 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a  bjc,.  Tcl_Obj *
9930: 43 4f 4e 53 54 20 6f 62 6a 76 5b 5d 0a 29 7b 0a  CONST objv[].){.
9940: 20 20 65 78 74 65 72 6e 20 69 6e 74 20 73 71 6c    extern int sql
9950: 69 74 65 33 5f 6d 65 6d 64 65 62 75 67 5f 76 66  ite3_memdebug_vf
9960: 73 5f 6f 6f 6d 5f 74 65 73 74 3b 0a 20 20 69 66  s_oom_test;.  if
9970: 28 20 6f 62 6a 63 3e 32 20 29 7b 0a 20 20 20 20  ( objc>2 ){.    
9980: 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d 41 72 67 73  Tcl_WrongNumArgs
9990: 28 69 6e 74 65 72 70 2c 20 31 2c 20 6f 62 6a 76  (interp, 1, objv
99a0: 2c 20 22 3f 49 4e 54 45 47 45 52 3f 22 29 3b 0a  , "?INTEGER?");.
99b0: 20 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45      return TCL_E
99c0: 52 52 4f 52 3b 0a 20 20 7d 65 6c 73 65 20 69 66  RROR;.  }else if
99d0: 28 20 6f 62 6a 63 3d 3d 32 20 29 7b 0a 20 20 20  ( objc==2 ){.   
99e0: 20 69 6e 74 20 69 4e 65 77 3b 0a 20 20 20 20 69   int iNew;.    i
99f0: 66 28 20 54 63 6c 5f 47 65 74 49 6e 74 46 72 6f  f( Tcl_GetIntFro
9a00: 6d 4f 62 6a 28 69 6e 74 65 72 70 2c 20 6f 62 6a  mObj(interp, obj
9a10: 76 5b 31 5d 2c 20 26 69 4e 65 77 29 20 29 20 72  v[1], &iNew) ) r
9a20: 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b  eturn TCL_ERROR;
9a30: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 65 6d  .    sqlite3_mem
9a40: 64 65 62 75 67 5f 76 66 73 5f 6f 6f 6d 5f 74 65  debug_vfs_oom_te
9a50: 73 74 20 3d 20 69 4e 65 77 3b 0a 20 20 7d 0a 20  st = iNew;.  }. 
9a60: 20 54 63 6c 5f 53 65 74 4f 62 6a 52 65 73 75 6c   Tcl_SetObjResul
9a70: 74 28 69 6e 74 65 72 70 2c 20 54 63 6c 5f 4e 65  t(interp, Tcl_Ne
9a80: 77 49 6e 74 4f 62 6a 28 73 71 6c 69 74 65 33 5f  wIntObj(sqlite3_
9a90: 6d 65 6d 64 65 62 75 67 5f 76 66 73 5f 6f 6f 6d  memdebug_vfs_oom
9aa0: 5f 74 65 73 74 29 29 3b 0a 20 20 72 65 74 75 72  _test));.  retur
9ab0: 6e 20 54 43 4c 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a  n TCL_OK;.}../*.
9ac0: 2a 2a 20 52 65 67 69 73 74 65 72 20 63 6f 6d 6d  ** Register comm
9ad0: 61 6e 64 73 20 77 69 74 68 20 74 68 65 20 54 43  ands with the TC
9ae0: 4c 20 69 6e 74 65 72 70 72 65 74 65 72 2e 0a 2a  L interpreter..*
9af0: 2f 0a 69 6e 74 20 53 71 6c 69 74 65 74 65 73 74  /.int Sqlitetest
9b00: 5f 6d 61 6c 6c 6f 63 5f 49 6e 69 74 28 54 63 6c  _malloc_Init(Tcl
9b10: 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65 72 70 29  _Interp *interp)
9b20: 7b 0a 20 20 73 74 61 74 69 63 20 73 74 72 75 63  {.  static struc
9b30: 74 20 7b 0a 20 20 20 20 20 63 68 61 72 20 2a 7a  t {.     char *z
9b40: 4e 61 6d 65 3b 0a 20 20 20 20 20 54 63 6c 5f 4f  Name;.     Tcl_O
9b50: 62 6a 43 6d 64 50 72 6f 63 20 2a 78 50 72 6f 63  bjCmdProc *xProc
9b60: 3b 0a 20 20 20 20 20 69 6e 74 20 63 6c 69 65 6e  ;.     int clien
9b70: 74 44 61 74 61 3b 0a 20 20 7d 20 61 4f 62 6a 43  tData;.  } aObjC
9b80: 6d 64 5b 5d 20 3d 20 7b 0a 20 20 20 20 20 7b 20  md[] = {.     { 
9b90: 22 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 22  "sqlite3_malloc"
9ba0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 74 65  ,             te
9bb0: 73 74 5f 6d 61 6c 6c 6f 63 20 20 20 20 20 20 20  st_malloc       
9bc0: 20 20 20 20 20 20 20 20 20 20 20 20 2c 30 20 7d              ,0 }
9bd0: 2c 0a 20 20 20 20 20 7b 20 22 73 71 6c 69 74 65  ,.     { "sqlite
9be0: 33 5f 72 65 61 6c 6c 6f 63 22 2c 20 20 20 20 20  3_realloc",     
9bf0: 20 20 20 20 20 20 20 74 65 73 74 5f 72 65 61 6c         test_real
9c00: 6c 6f 63 20 20 20 20 20 20 20 20 20 20 20 20 20  loc             
9c10: 20 20 20 20 20 2c 30 20 7d 2c 0a 20 20 20 20 20       ,0 },.     
9c20: 7b 20 22 73 71 6c 69 74 65 33 5f 66 72 65 65 22  { "sqlite3_free"
9c30: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
9c40: 74 65 73 74 5f 66 72 65 65 20 20 20 20 20 20 20  test_free       
9c50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2c 30                ,0
9c60: 20 7d 2c 0a 20 20 20 20 20 7b 20 22 6d 65 6d 73   },.     { "mems
9c70: 65 74 22 2c 20 20 20 20 20 20 20 20 20 20 20 20  et",            
9c80: 20 20 20 20 20 20 20 20 20 74 65 73 74 5f 6d 65           test_me
9c90: 6d 73 65 74 20 20 20 20 20 20 20 20 20 20 20 20  mset            
9ca0: 20 20 20 20 20 20 20 2c 30 20 7d 2c 0a 20 20 20         ,0 },.   
9cb0: 20 20 7b 20 22 6d 65 6d 67 65 74 22 2c 20 20 20    { "memget",   
9cc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
9cd0: 20 20 74 65 73 74 5f 6d 65 6d 67 65 74 20 20 20    test_memget   
9ce0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
9cf0: 2c 30 20 7d 2c 0a 20 20 20 20 20 7b 20 22 73 71  ,0 },.     { "sq
9d00: 6c 69 74 65 33 5f 6d 65 6d 6f 72 79 5f 75 73 65  lite3_memory_use
9d10: 64 22 2c 20 20 20 20 20 20 20 20 74 65 73 74 5f  d",        test_
9d20: 6d 65 6d 6f 72 79 5f 75 73 65 64 20 20 20 20 20  memory_used     
9d30: 20 20 20 20 20 20 20 20 20 2c 30 20 7d 2c 0a 20           ,0 },. 
9d40: 20 20 20 20 7b 20 22 73 71 6c 69 74 65 33 5f 6d      { "sqlite3_m
9d50: 65 6d 6f 72 79 5f 68 69 67 68 77 61 74 65 72 22  emory_highwater"
9d60: 2c 20 20 20 74 65 73 74 5f 6d 65 6d 6f 72 79 5f  ,   test_memory_
9d70: 68 69 67 68 77 61 74 65 72 20 20 20 20 20 20 20  highwater       
9d80: 20 20 2c 30 20 7d 2c 0a 20 20 20 20 20 7b 20 22    ,0 },.     { "
9d90: 73 71 6c 69 74 65 33 5f 6d 65 6d 64 65 62 75 67  sqlite3_memdebug
9da0: 5f 62 61 63 6b 74 72 61 63 65 22 2c 20 74 65 73  _backtrace", tes
9db0: 74 5f 6d 65 6d 64 65 62 75 67 5f 62 61 63 6b 74  t_memdebug_backt
9dc0: 72 61 63 65 20 20 20 20 20 20 20 2c 30 20 7d 2c  race       ,0 },
9dd0: 0a 20 20 20 20 20 7b 20 22 73 71 6c 69 74 65 33  .     { "sqlite3
9de0: 5f 6d 65 6d 64 65 62 75 67 5f 64 75 6d 70 22 2c  _memdebug_dump",
9df0: 20 20 20 20 20 20 74 65 73 74 5f 6d 65 6d 64 65        test_memde
9e00: 62 75 67 5f 64 75 6d 70 20 20 20 20 20 20 20 20  bug_dump        
9e10: 20 20 20 20 2c 30 20 7d 2c 0a 20 20 20 20 20 7b      ,0 },.     {
9e20: 20 22 73 71 6c 69 74 65 33 5f 6d 65 6d 64 65 62   "sqlite3_memdeb
9e30: 75 67 5f 66 61 69 6c 22 2c 20 20 20 20 20 20 74  ug_fail",      t
9e40: 65 73 74 5f 6d 65 6d 64 65 62 75 67 5f 66 61 69  est_memdebug_fai
9e50: 6c 20 20 20 20 20 20 20 20 20 20 20 20 2c 30 20  l            ,0 
9e60: 7d 2c 0a 20 20 20 20 20 7b 20 22 73 71 6c 69 74  },.     { "sqlit
9e70: 65 33 5f 6d 65 6d 64 65 62 75 67 5f 70 65 6e 64  e3_memdebug_pend
9e80: 69 6e 67 22 2c 20 20 20 74 65 73 74 5f 6d 65 6d  ing",   test_mem
9e90: 64 65 62 75 67 5f 70 65 6e 64 69 6e 67 20 20 20  debug_pending   
9ea0: 20 20 20 20 20 20 2c 30 20 7d 2c 0a 20 20 20 20        ,0 },.    
9eb0: 20 7b 20 22 73 71 6c 69 74 65 33 5f 6d 65 6d 64   { "sqlite3_memd
9ec0: 65 62 75 67 5f 73 65 74 74 69 74 6c 65 22 2c 20  ebug_settitle", 
9ed0: 20 74 65 73 74 5f 6d 65 6d 64 65 62 75 67 5f 73   test_memdebug_s
9ee0: 65 74 74 69 74 6c 65 20 20 20 20 20 20 20 20 2c  ettitle        ,
9ef0: 30 20 7d 2c 0a 20 20 20 20 20 7b 20 22 73 71 6c  0 },.     { "sql
9f00: 69 74 65 33 5f 6d 65 6d 64 65 62 75 67 5f 6d 61  ite3_memdebug_ma
9f10: 6c 6c 6f 63 5f 63 6f 75 6e 74 22 2c 20 74 65 73  lloc_count", tes
9f20: 74 5f 6d 65 6d 64 65 62 75 67 5f 6d 61 6c 6c 6f  t_memdebug_mallo
9f30: 63 5f 63 6f 75 6e 74 20 2c 30 20 7d 2c 0a 20 20  c_count ,0 },.  
9f40: 20 20 20 7b 20 22 73 71 6c 69 74 65 33 5f 6d 65     { "sqlite3_me
9f50: 6d 64 65 62 75 67 5f 6c 6f 67 22 2c 20 20 20 20  mdebug_log",    
9f60: 20 20 20 74 65 73 74 5f 6d 65 6d 64 65 62 75 67     test_memdebug
9f70: 5f 6c 6f 67 20 20 20 20 20 20 20 20 20 20 20 20  _log            
9f80: 20 2c 30 20 7d 2c 0a 20 20 20 20 20 7b 20 22 73   ,0 },.     { "s
9f90: 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 5f 73 63  qlite3_config_sc
9fa0: 72 61 74 63 68 22 2c 20 20 20 20 20 74 65 73 74  ratch",     test
9fb0: 5f 63 6f 6e 66 69 67 5f 73 63 72 61 74 63 68 20  _config_scratch 
9fc0: 20 20 20 20 20 20 20 20 20 20 2c 30 20 7d 2c 0a            ,0 },.
9fd0: 20 20 20 20 20 7b 20 22 73 71 6c 69 74 65 33 5f       { "sqlite3_
9fe0: 63 6f 6e 66 69 67 5f 70 61 67 65 63 61 63 68 65  config_pagecache
9ff0: 22 2c 20 20 20 74 65 73 74 5f 63 6f 6e 66 69 67  ",   test_config
a000: 5f 70 61 67 65 63 61 63 68 65 20 20 20 20 20 20  _pagecache      
a010: 20 20 20 2c 30 20 7d 2c 0a 20 20 20 20 20 7b 20     ,0 },.     { 
a020: 22 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 5f  "sqlite3_config_
a030: 61 6c 74 5f 70 63 61 63 68 65 22 2c 20 20 74 65  alt_pcache",  te
a040: 73 74 5f 61 6c 74 5f 70 63 61 63 68 65 20 20 20  st_alt_pcache   
a050: 20 20 20 20 20 20 20 20 20 20 20 20 2c 30 20 7d              ,0 }
a060: 2c 0a 20 20 20 20 20 7b 20 22 73 71 6c 69 74 65  ,.     { "sqlite
a070: 33 5f 73 74 61 74 75 73 22 2c 20 20 20 20 20 20  3_status",      
a080: 20 20 20 20 20 20 20 74 65 73 74 5f 73 74 61 74         test_stat
a090: 75 73 20 20 20 20 20 20 20 20 20 20 20 20 20 20  us              
a0a0: 20 20 20 20 20 2c 30 20 7d 2c 0a 20 20 20 20 20       ,0 },.     
a0b0: 7b 20 22 73 71 6c 69 74 65 33 5f 64 62 5f 73 74  { "sqlite3_db_st
a0c0: 61 74 75 73 22 2c 20 20 20 20 20 20 20 20 20 20  atus",          
a0d0: 74 65 73 74 5f 64 62 5f 73 74 61 74 75 73 20 20  test_db_status  
a0e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2c 30                ,0
a0f0: 20 7d 2c 0a 20 20 20 20 20 7b 20 22 69 6e 73 74   },.     { "inst
a100: 61 6c 6c 5f 6d 61 6c 6c 6f 63 5f 66 61 75 6c 74  all_malloc_fault
a110: 73 69 6d 22 2c 20 20 20 20 74 65 73 74 5f 69 6e  sim",    test_in
a120: 73 74 61 6c 6c 5f 6d 61 6c 6c 6f 63 5f 66 61 75  stall_malloc_fau
a130: 6c 74 73 69 6d 20 20 2c 30 20 7d 2c 0a 20 20 20  ltsim  ,0 },.   
a140: 20 20 7b 20 22 73 71 6c 69 74 65 33 5f 63 6f 6e    { "sqlite3_con
a150: 66 69 67 5f 68 65 61 70 22 2c 20 20 20 20 20 20  fig_heap",      
a160: 20 20 74 65 73 74 5f 63 6f 6e 66 69 67 5f 68 65    test_config_he
a170: 61 70 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ap              
a180: 2c 30 20 7d 2c 0a 20 20 20 20 20 7b 20 22 73 71  ,0 },.     { "sq
a190: 6c 69 74 65 33 5f 63 6f 6e 66 69 67 5f 68 65 61  lite3_config_hea
a1a0: 70 5f 73 69 7a 65 22 2c 20 20 20 74 65 73 74 5f  p_size",   test_
a1b0: 63 6f 6e 66 69 67 5f 68 65 61 70 5f 73 69 7a 65  config_heap_size
a1c0: 20 20 20 20 20 20 20 20 20 2c 30 20 7d 2c 0a 20           ,0 },. 
a1d0: 20 20 20 20 7b 20 22 73 71 6c 69 74 65 33 5f 63      { "sqlite3_c
a1e0: 6f 6e 66 69 67 5f 6d 65 6d 73 74 61 74 75 73 22  onfig_memstatus"
a1f0: 2c 20 20 20 74 65 73 74 5f 63 6f 6e 66 69 67 5f  ,   test_config_
a200: 6d 65 6d 73 74 61 74 75 73 20 20 20 20 20 20 20  memstatus       
a210: 20 20 2c 30 20 7d 2c 0a 20 20 20 20 20 7b 20 22    ,0 },.     { "
a220: 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 5f 6c  sqlite3_config_l
a230: 6f 6f 6b 61 73 69 64 65 22 2c 20 20 20 74 65 73  ookaside",   tes
a240: 74 5f 63 6f 6e 66 69 67 5f 6c 6f 6f 6b 61 73 69  t_config_lookasi
a250: 64 65 20 20 20 20 20 20 20 20 20 2c 30 20 7d 2c  de         ,0 },
a260: 0a 20 20 20 20 20 7b 20 22 73 71 6c 69 74 65 33  .     { "sqlite3
a270: 5f 63 6f 6e 66 69 67 5f 65 72 72 6f 72 22 2c 20  _config_error", 
a280: 20 20 20 20 20 20 74 65 73 74 5f 63 6f 6e 66 69        test_confi
a290: 67 5f 65 72 72 6f 72 20 20 20 20 20 20 20 20 20  g_error         
a2a0: 20 20 20 20 2c 30 20 7d 2c 0a 20 20 20 20 20 7b      ,0 },.     {
a2b0: 20 22 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67   "sqlite3_config
a2c0: 5f 75 72 69 22 2c 20 20 20 20 20 20 20 20 20 74  _uri",         t
a2d0: 65 73 74 5f 63 6f 6e 66 69 67 5f 75 72 69 20 20  est_config_uri  
a2e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2c 30 20               ,0 
a2f0: 7d 2c 0a 20 20 20 20 20 7b 20 22 73 71 6c 69 74  },.     { "sqlit
a300: 65 33 5f 63 6f 6e 66 69 67 5f 63 69 73 22 2c 20  e3_config_cis", 
a310: 20 20 20 20 20 20 20 20 74 65 73 74 5f 63 6f 6e          test_con
a320: 66 69 67 5f 63 69 73 20 20 20 20 20 20 20 20 20  fig_cis         
a330: 20 20 20 20 20 20 2c 30 20 7d 2c 0a 20 20 20 20        ,0 },.    
a340: 20 7b 20 22 73 71 6c 69 74 65 33 5f 63 6f 6e 66   { "sqlite3_conf
a350: 69 67 5f 70 6d 61 73 7a 22 2c 20 20 20 20 20 20  ig_pmasz",      
a360: 20 74 65 73 74 5f 63 6f 6e 66 69 67 5f 70 6d 61   test_config_pma
a370: 73 7a 20 20 20 20 20 20 20 20 20 20 20 20 20 2c  sz             ,
a380: 30 20 7d 2c 0a 20 20 20 20 20 7b 20 22 73 71 6c  0 },.     { "sql
a390: 69 74 65 33 5f 64 62 5f 63 6f 6e 66 69 67 5f 6c  ite3_db_config_l
a3a0: 6f 6f 6b 61 73 69 64 65 22 2c 74 65 73 74 5f 64  ookaside",test_d
a3b0: 62 5f 63 6f 6e 66 69 67 5f 6c 6f 6f 6b 61 73 69  b_config_lookasi
a3c0: 64 65 20 20 20 20 20 20 2c 30 20 7d 2c 0a 20 20  de      ,0 },.  
a3d0: 20 20 20 7b 20 22 73 71 6c 69 74 65 33 5f 64 75     { "sqlite3_du
a3e0: 6d 70 5f 6d 65 6d 73 79 73 33 22 2c 20 20 20 20  mp_memsys3",    
a3f0: 20 20 20 74 65 73 74 5f 64 75 6d 70 5f 6d 65 6d     test_dump_mem
a400: 73 79 73 33 20 20 20 20 20 20 20 20 20 20 20 20  sys3            
a410: 20 2c 33 20 7d 2c 0a 20 20 20 20 20 7b 20 22 73   ,3 },.     { "s
a420: 71 6c 69 74 65 33 5f 64 75 6d 70 5f 6d 65 6d 73  qlite3_dump_mems
a430: 79 73 35 22 2c 20 20 20 20 20 20 20 74 65 73 74  ys5",       test
a440: 5f 64 75 6d 70 5f 6d 65 6d 73 79 73 33 20 20 20  _dump_memsys3   
a450: 20 20 20 20 20 20 20 20 20 20 2c 35 20 7d 2c 0a            ,5 },.
a460: 20 20 20 20 20 7b 20 22 73 71 6c 69 74 65 33 5f       { "sqlite3_
a470: 69 6e 73 74 61 6c 6c 5f 6d 65 6d 73 79 73 33 22  install_memsys3"
a480: 2c 20 20 20 20 74 65 73 74 5f 69 6e 73 74 61 6c  ,    test_instal
a490: 6c 5f 6d 65 6d 73 79 73 33 20 20 20 20 20 20 20  l_memsys3       
a4a0: 20 20 20 2c 30 20 7d 2c 0a 20 20 20 20 20 7b 20     ,0 },.     { 
a4b0: 22 73 71 6c 69 74 65 33 5f 6d 65 6d 64 65 62 75  "sqlite3_memdebu
a4c0: 67 5f 76 66 73 5f 6f 6f 6d 5f 74 65 73 74 22 2c  g_vfs_oom_test",
a4d0: 20 74 65 73 74 5f 76 66 73 5f 6f 6f 6d 5f 74 65   test_vfs_oom_te
a4e0: 73 74 20 20 20 20 20 20 20 20 20 20 2c 30 20 7d  st          ,0 }
a4f0: 2c 0a 20 20 7d 3b 0a 20 20 69 6e 74 20 69 3b 0a  ,.  };.  int i;.
a500: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 73 69 7a    for(i=0; i<siz
a510: 65 6f 66 28 61 4f 62 6a 43 6d 64 29 2f 73 69 7a  eof(aObjCmd)/siz
a520: 65 6f 66 28 61 4f 62 6a 43 6d 64 5b 30 5d 29 3b  eof(aObjCmd[0]);
a530: 20 69 2b 2b 29 7b 0a 20 20 20 20 43 6c 69 65 6e   i++){.    Clien
a540: 74 44 61 74 61 20 63 20 3d 20 28 43 6c 69 65 6e  tData c = (Clien
a550: 74 44 61 74 61 29 53 51 4c 49 54 45 5f 49 4e 54  tData)SQLITE_INT
a560: 5f 54 4f 5f 50 54 52 28 61 4f 62 6a 43 6d 64 5b  _TO_PTR(aObjCmd[
a570: 69 5d 2e 63 6c 69 65 6e 74 44 61 74 61 29 3b 0a  i].clientData);.
a580: 20 20 20 20 54 63 6c 5f 43 72 65 61 74 65 4f 62      Tcl_CreateOb
a590: 6a 43 6f 6d 6d 61 6e 64 28 69 6e 74 65 72 70 2c  jCommand(interp,
a5a0: 20 61 4f 62 6a 43 6d 64 5b 69 5d 2e 7a 4e 61 6d   aObjCmd[i].zNam
a5b0: 65 2c 20 61 4f 62 6a 43 6d 64 5b 69 5d 2e 78 50  e, aObjCmd[i].xP
a5c0: 72 6f 63 2c 20 63 2c 20 30 29 3b 0a 20 20 7d 0a  roc, c, 0);.  }.
a5d0: 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 4f 4b 3b    return TCL_OK;
a5e0: 0a 7d 0a 23 65 6e 64 69 66 0a                    .}.#endif.