/ Hex Artifact Content
Login

Artifact 66c0b17a6611547f630b6ea67e14e575b9431507:


0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65  /*.** 2001 Septe
0010: 6d 62 65 72 20 31 35 0a 2a 2a 0a 2a 2a 20 54 68  mber 15.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69  e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20  ms copyright to 
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65  this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a  .  In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65  * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73  , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d  sing:.**.**    M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61  ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20  nd not evil..** 
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20     May you find 
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20  forgiveness for 
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72  yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20  give others..** 
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65     May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74   freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20  aking more than 
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a  you give..**.***
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0170: 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 4d 65 6d  ******.**.** Mem
0180: 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 66  ory allocation f
0190: 75 6e 63 74 69 6f 6e 73 20 75 73 65 64 20 74 68  unctions used th
01a0: 72 6f 75 67 68 6f 75 74 20 73 71 6c 69 74 65 2e  roughout sqlite.
01b0: 0a 2a 2a 0a 2a 2a 20 24 49 64 3a 20 6d 61 6c 6c  .**.** $Id: mall
01c0: 6f 63 2e 63 2c 76 20 31 2e 32 32 20 32 30 30 38  oc.c,v 1.22 2008
01d0: 2f 30 36 2f 31 39 20 31 38 3a 31 37 3a 35 30 20  /06/19 18:17:50 
01e0: 64 61 6e 69 65 6c 6b 31 39 37 37 20 45 78 70 20  danielk1977 Exp 
01f0: 24 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73  $.*/.#include "s
0200: 71 6c 69 74 65 49 6e 74 2e 68 22 0a 23 69 6e 63  qliteInt.h".#inc
0210: 6c 75 64 65 20 3c 73 74 64 61 72 67 2e 68 3e 0a  lude <stdarg.h>.
0220: 23 69 6e 63 6c 75 64 65 20 3c 63 74 79 70 65 2e  #include <ctype.
0230: 68 3e 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72  h>../*.** This r
0240: 6f 75 74 69 6e 65 20 72 75 6e 73 20 77 68 65 6e  outine runs when
0250: 20 74 68 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f   the memory allo
0260: 63 61 74 6f 72 20 73 65 65 73 20 74 68 61 74 20  cator sees that 
0270: 74 68 65 0a 2a 2a 20 74 6f 74 61 6c 20 6d 65 6d  the.** total mem
0280: 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69  ory allocation i
0290: 73 20 61 62 6f 75 74 20 74 6f 20 65 78 63 65 65  s about to excee
02a0: 64 20 74 68 65 20 73 6f 66 74 20 68 65 61 70 0a  d the soft heap.
02b0: 2a 2a 20 6c 69 6d 69 74 2e 0a 2a 2f 0a 73 74 61  ** limit..*/.sta
02c0: 74 69 63 20 76 6f 69 64 20 73 6f 66 74 48 65 61  tic void softHea
02d0: 70 4c 69 6d 69 74 45 6e 66 6f 72 63 65 72 28 0a  pLimitEnforcer(.
02e0: 20 20 76 6f 69 64 20 2a 4e 6f 74 55 73 65 64 2c    void *NotUsed,
02f0: 20 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36   .  sqlite3_int6
0300: 34 20 69 6e 55 73 65 2c 0a 20 20 69 6e 74 20 61  4 inUse,.  int a
0310: 6c 6c 6f 63 53 69 7a 65 0a 29 7b 0a 20 20 73 71  llocSize.){.  sq
0320: 6c 69 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65  lite3_release_me
0330: 6d 6f 72 79 28 61 6c 6c 6f 63 53 69 7a 65 29 3b  mory(allocSize);
0340: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68  .}../*.** Set th
0350: 65 20 73 6f 66 74 20 68 65 61 70 2d 73 69 7a 65  e soft heap-size
0360: 20 6c 69 6d 69 74 20 66 6f 72 20 74 68 65 20 63   limit for the c
0370: 75 72 72 65 6e 74 20 74 68 72 65 61 64 2e 20 50  urrent thread. P
0380: 61 73 73 69 6e 67 20 61 0a 2a 2a 20 7a 65 72 6f  assing a.** zero
0390: 20 6f 72 20 6e 65 67 61 74 69 76 65 20 76 61 6c   or negative val
03a0: 75 65 20 69 6e 64 69 63 61 74 65 73 20 6e 6f 20  ue indicates no 
03b0: 6c 69 6d 69 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73  limit..*/.void s
03c0: 71 6c 69 74 65 33 5f 73 6f 66 74 5f 68 65 61 70  qlite3_soft_heap
03d0: 5f 6c 69 6d 69 74 28 69 6e 74 20 6e 29 7b 0a 20  _limit(int n){. 
03e0: 20 73 71 6c 69 74 65 33 5f 75 69 6e 74 36 34 20   sqlite3_uint64 
03f0: 69 4c 69 6d 69 74 3b 0a 20 20 69 6e 74 20 6f 76  iLimit;.  int ov
0400: 65 72 61 67 65 3b 0a 20 20 69 66 28 20 6e 3c 30  erage;.  if( n<0
0410: 20 29 7b 0a 20 20 20 20 69 4c 69 6d 69 74 20 3d   ){.    iLimit =
0420: 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20   0;.  }else{.   
0430: 20 69 4c 69 6d 69 74 20 3d 20 6e 3b 0a 20 20 7d   iLimit = n;.  }
0440: 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 69  .  sqlite3_initi
0450: 61 6c 69 7a 65 28 29 3b 0a 20 20 69 66 28 20 69  alize();.  if( i
0460: 4c 69 6d 69 74 3e 30 20 29 7b 0a 20 20 20 20 73  Limit>0 ){.    s
0470: 71 6c 69 74 65 33 5f 6d 65 6d 6f 72 79 5f 61 6c  qlite3_memory_al
0480: 61 72 6d 28 73 6f 66 74 48 65 61 70 4c 69 6d 69  arm(softHeapLimi
0490: 74 45 6e 66 6f 72 63 65 72 2c 20 30 2c 20 69 4c  tEnforcer, 0, iL
04a0: 69 6d 69 74 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a  imit);.  }else{.
04b0: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 65 6d 6f      sqlite3_memo
04c0: 72 79 5f 61 6c 61 72 6d 28 30 2c 20 30 2c 20 30  ry_alarm(0, 0, 0
04d0: 29 3b 0a 20 20 7d 0a 20 20 6f 76 65 72 61 67 65  );.  }.  overage
04e0: 20 3d 20 73 71 6c 69 74 65 33 5f 6d 65 6d 6f 72   = sqlite3_memor
04f0: 79 5f 75 73 65 64 28 29 20 2d 20 6e 3b 0a 20 20  y_used() - n;.  
0500: 69 66 28 20 6f 76 65 72 61 67 65 3e 30 20 29 7b  if( overage>0 ){
0510: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 72 65 6c  .    sqlite3_rel
0520: 65 61 73 65 5f 6d 65 6d 6f 72 79 28 6f 76 65 72  ease_memory(over
0530: 61 67 65 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a  age);.  }.}../*.
0540: 2a 2a 20 52 65 6c 65 61 73 65 20 6d 65 6d 6f 72  ** Release memor
0550: 79 20 68 65 6c 64 20 62 79 20 53 51 4c 69 74 65  y held by SQLite
0560: 20 69 6e 73 74 61 6e 63 65 73 20 63 72 65 61 74   instances creat
0570: 65 64 20 62 79 20 74 68 65 20 63 75 72 72 65 6e  ed by the curren
0580: 74 20 74 68 72 65 61 64 2e 0a 2a 2f 0a 69 6e 74  t thread..*/.int
0590: 20 73 71 6c 69 74 65 33 5f 72 65 6c 65 61 73 65   sqlite3_release
05a0: 5f 6d 65 6d 6f 72 79 28 69 6e 74 20 6e 29 7b 0a  _memory(int n){.
05b0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e  #ifdef SQLITE_EN
05c0: 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41  ABLE_MEMORY_MANA
05d0: 47 45 4d 45 4e 54 0a 20 20 69 6e 74 20 6e 52 65  GEMENT.  int nRe
05e0: 74 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 52  t = sqlite3VdbeR
05f0: 65 6c 65 61 73 65 4d 65 6d 6f 72 79 28 6e 29 3b  eleaseMemory(n);
0600: 0a 20 20 6e 52 65 74 20 2b 3d 20 73 71 6c 69 74  .  nRet += sqlit
0610: 65 33 50 61 67 65 72 52 65 6c 65 61 73 65 4d 65  e3PagerReleaseMe
0620: 6d 6f 72 79 28 6e 2d 6e 52 65 74 29 3b 0a 20 20  mory(n-nRet);.  
0630: 72 65 74 75 72 6e 20 6e 52 65 74 3b 0a 23 65 6c  return nRet;.#el
0640: 73 65 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49  se.  return SQLI
0650: 54 45 5f 4f 4b 3b 0a 23 65 6e 64 69 66 0a 7d 0a  TE_OK;.#endif.}.
0660: 0a 2f 2a 0a 2a 2a 20 53 74 61 74 65 20 69 6e 66  ./*.** State inf
0670: 6f 72 6d 61 74 69 6f 6e 20 6c 6f 63 61 6c 20 74  ormation local t
0680: 6f 20 74 68 65 20 6d 65 6d 6f 72 79 20 61 6c 6c  o the memory all
0690: 6f 63 61 74 69 6f 6e 20 73 75 62 73 79 73 74 65  ocation subsyste
06a0: 6d 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 73 74 72  m..*/.static str
06b0: 75 63 74 20 7b 0a 20 20 73 71 6c 69 74 65 33 5f  uct {.  sqlite3_
06c0: 6d 75 74 65 78 20 2a 6d 75 74 65 78 3b 20 20 20  mutex *mutex;   
06d0: 20 20 20 20 20 20 2f 2a 20 4d 75 74 65 78 20 74        /* Mutex t
06e0: 6f 20 73 65 72 69 61 6c 69 7a 65 20 61 63 63 65  o serialize acce
06f0: 73 73 20 2a 2f 0a 0a 20 20 2f 2a 0a 20 20 2a 2a  ss */..  /*.  **
0700: 20 54 68 65 20 61 6c 61 72 6d 20 63 61 6c 6c 62   The alarm callb
0710: 61 63 6b 20 61 6e 64 20 69 74 73 20 61 72 67 75  ack and its argu
0720: 6d 65 6e 74 73 2e 20 20 54 68 65 20 6d 65 6d 30  ments.  The mem0
0730: 2e 6d 75 74 65 78 20 6c 6f 63 6b 20 77 69 6c 6c  .mutex lock will
0740: 0a 20 20 2a 2a 20 62 65 20 68 65 6c 64 20 77 68  .  ** be held wh
0750: 69 6c 65 20 74 68 65 20 63 61 6c 6c 62 61 63 6b  ile the callback
0760: 20 69 73 20 72 75 6e 6e 69 6e 67 2e 20 20 52 65   is running.  Re
0770: 63 75 72 73 69 76 65 20 63 61 6c 6c 73 20 69 6e  cursive calls in
0780: 74 6f 0a 20 20 2a 2a 20 74 68 65 20 6d 65 6d 6f  to.  ** the memo
0790: 72 79 20 73 75 62 73 79 73 74 65 6d 20 61 72 65  ry subsystem are
07a0: 20 61 6c 6c 6f 77 65 64 2c 20 62 75 74 20 6e 6f   allowed, but no
07b0: 20 6e 65 77 20 63 61 6c 6c 62 61 63 6b 73 20 77   new callbacks w
07c0: 69 6c 6c 20 62 65 0a 20 20 2a 2a 20 69 73 73 75  ill be.  ** issu
07d0: 65 64 2e 20 20 54 68 65 20 61 6c 61 72 6d 42 75  ed.  The alarmBu
07e0: 73 79 20 76 61 72 69 61 62 6c 65 20 69 73 20 73  sy variable is s
07f0: 65 74 20 74 6f 20 70 72 65 76 65 6e 74 20 72 65  et to prevent re
0800: 63 75 72 73 69 76 65 0a 20 20 2a 2a 20 63 61 6c  cursive.  ** cal
0810: 6c 62 61 63 6b 73 2e 0a 20 20 2a 2f 0a 20 20 73  lbacks..  */.  s
0820: 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 61 6c 61  qlite3_int64 ala
0830: 72 6d 54 68 72 65 73 68 6f 6c 64 3b 0a 20 20 76  rmThreshold;.  v
0840: 6f 69 64 20 28 2a 61 6c 61 72 6d 43 61 6c 6c 62  oid (*alarmCallb
0850: 61 63 6b 29 28 76 6f 69 64 2a 2c 20 73 71 6c 69  ack)(void*, sqli
0860: 74 65 33 5f 69 6e 74 36 34 2c 69 6e 74 29 3b 0a  te3_int64,int);.
0870: 20 20 76 6f 69 64 20 2a 61 6c 61 72 6d 41 72 67    void *alarmArg
0880: 3b 0a 20 20 69 6e 74 20 61 6c 61 72 6d 42 75 73  ;.  int alarmBus
0890: 79 3b 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 50 6f  y;..  /*.  ** Po
08a0: 69 6e 74 65 72 73 20 74 6f 20 74 68 65 20 65 6e  inters to the en
08b0: 64 20 6f 66 20 73 71 6c 69 74 65 33 43 6f 6e 66  d of sqlite3Conf
08c0: 69 67 2e 70 53 63 72 61 74 63 68 20 61 6e 64 0a  ig.pScratch and.
08d0: 20 20 2a 2a 20 73 71 6c 69 74 65 33 43 6f 6e 66    ** sqlite3Conf
08e0: 69 67 2e 70 50 61 67 65 20 74 6f 20 61 20 62 6c  ig.pPage to a bl
08f0: 6f 63 6b 20 6f 66 20 6d 65 6d 6f 72 79 20 74 68  ock of memory th
0900: 61 74 20 72 65 63 6f 72 64 73 0a 20 20 2a 2a 20  at records.  ** 
0910: 77 68 69 63 68 20 70 61 67 65 73 20 61 72 65 20  which pages are 
0920: 61 76 61 69 6c 61 62 6c 65 2e 0a 20 20 2a 2f 0a  available..  */.
0930: 20 20 75 33 32 20 2a 61 53 63 72 61 74 63 68 46    u32 *aScratchF
0940: 72 65 65 3b 0a 20 20 75 33 32 20 2a 61 50 61 67  ree;.  u32 *aPag
0950: 65 46 72 65 65 3b 0a 0a 20 20 2f 2a 20 4e 75 6d  eFree;..  /* Num
0960: 62 65 72 20 6f 66 20 66 72 65 65 20 70 61 67 65  ber of free page
0970: 73 20 66 6f 72 20 73 63 72 61 74 63 68 20 61 6e  s for scratch an
0980: 64 20 70 61 67 65 2d 63 61 63 68 65 20 6d 65 6d  d page-cache mem
0990: 6f 72 79 20 2a 2f 0a 20 20 75 33 32 20 6e 53 63  ory */.  u32 nSc
09a0: 72 61 74 63 68 46 72 65 65 3b 0a 20 20 75 33 32  ratchFree;.  u32
09b0: 20 6e 50 61 67 65 46 72 65 65 3b 0a 7d 20 6d 65   nPageFree;.} me
09c0: 6d 30 3b 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 69  m0;../*.** Initi
09d0: 61 6c 69 7a 65 20 74 68 65 20 6d 65 6d 6f 72 79  alize the memory
09e0: 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 73 75 62 73   allocation subs
09f0: 79 73 74 65 6d 2e 0a 2a 2f 0a 69 6e 74 20 73 71  ystem..*/.int sq
0a00: 6c 69 74 65 33 4d 61 6c 6c 6f 63 49 6e 69 74 28  lite3MallocInit(
0a10: 76 6f 69 64 29 7b 0a 20 20 69 66 28 20 73 71 6c  void){.  if( sql
0a20: 69 74 65 33 43 6f 6e 66 69 67 2e 6d 2e 78 4d 61  ite3Config.m.xMa
0a30: 6c 6c 6f 63 3d 3d 30 20 29 7b 0a 20 20 20 20 73  lloc==0 ){.    s
0a40: 71 6c 69 74 65 33 4d 65 6d 53 65 74 44 65 66 61  qlite3MemSetDefa
0a50: 75 6c 74 28 29 3b 0a 20 20 7d 0a 20 20 6d 65 6d  ult();.  }.  mem
0a60: 73 65 74 28 26 6d 65 6d 30 2c 20 30 2c 20 73 69  set(&mem0, 0, si
0a70: 7a 65 6f 66 28 6d 65 6d 30 29 29 3b 0a 20 20 69  zeof(mem0));.  i
0a80: 66 28 20 73 71 6c 69 74 65 33 43 6f 6e 66 69 67  f( sqlite3Config
0a90: 2e 62 43 6f 72 65 4d 75 74 65 78 20 29 7b 0a 20  .bCoreMutex ){. 
0aa0: 20 20 20 6d 65 6d 30 2e 6d 75 74 65 78 20 3d 20     mem0.mutex = 
0ab0: 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f  sqlite3MutexAllo
0ac0: 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53  c(SQLITE_MUTEX_S
0ad0: 54 41 54 49 43 5f 4d 45 4d 29 3b 0a 20 20 7d 0a  TATIC_MEM);.  }.
0ae0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 43 6f 6e    if( sqlite3Con
0af0: 66 69 67 2e 70 53 63 72 61 74 63 68 20 26 26 20  fig.pScratch && 
0b00: 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 2e 73 7a  sqlite3Config.sz
0b10: 53 63 72 61 74 63 68 3e 3d 33 30 30 30 0a 20 20  Scratch>=3000.  
0b20: 20 20 20 20 26 26 20 73 71 6c 69 74 65 33 43 6f      && sqlite3Co
0b30: 6e 66 69 67 2e 6e 53 63 72 61 74 63 68 3e 30 20  nfig.nScratch>0 
0b40: 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 20  ){.    int i;.  
0b50: 20 20 6d 65 6d 30 2e 61 53 63 72 61 74 63 68 46    mem0.aScratchF
0b60: 72 65 65 20 3d 20 28 75 33 32 2a 29 26 28 28 63  ree = (u32*)&((c
0b70: 68 61 72 2a 29 73 71 6c 69 74 65 33 43 6f 6e 66  har*)sqlite3Conf
0b80: 69 67 2e 70 53 63 72 61 74 63 68 29 0a 20 20 20  ig.pScratch).   
0b90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5b                 [
0ba0: 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 2e 73 7a  sqlite3Config.sz
0bb0: 53 63 72 61 74 63 68 2a 73 71 6c 69 74 65 33 43  Scratch*sqlite3C
0bc0: 6f 6e 66 69 67 2e 6e 53 63 72 61 74 63 68 5d 3b  onfig.nScratch];
0bd0: 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c  .    for(i=0; i<
0be0: 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 2e 6e 53  sqlite3Config.nS
0bf0: 63 72 61 74 63 68 3b 20 69 2b 2b 29 7b 20 6d 65  cratch; i++){ me
0c00: 6d 30 2e 61 53 63 72 61 74 63 68 46 72 65 65 5b  m0.aScratchFree[
0c10: 69 5d 20 3d 20 69 3b 20 7d 0a 20 20 20 20 6d 65  i] = i; }.    me
0c20: 6d 30 2e 6e 53 63 72 61 74 63 68 46 72 65 65 20  m0.nScratchFree 
0c30: 3d 20 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 2e  = sqlite3Config.
0c40: 6e 53 63 72 61 74 63 68 3b 0a 20 20 7d 65 6c 73  nScratch;.  }els
0c50: 65 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 43 6f  e{.    sqlite3Co
0c60: 6e 66 69 67 2e 70 53 63 72 61 74 63 68 20 3d 20  nfig.pScratch = 
0c70: 30 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 43 6f  0;.    sqlite3Co
0c80: 6e 66 69 67 2e 73 7a 53 63 72 61 74 63 68 20 3d  nfig.szScratch =
0c90: 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 71   0;.  }.  if( sq
0ca0: 6c 69 74 65 33 43 6f 6e 66 69 67 2e 70 50 61 67  lite3Config.pPag
0cb0: 65 20 26 26 20 73 71 6c 69 74 65 33 43 6f 6e 66  e && sqlite3Conf
0cc0: 69 67 2e 73 7a 50 61 67 65 3e 3d 35 31 32 0a 20  ig.szPage>=512. 
0cd0: 20 20 20 20 20 26 26 20 73 71 6c 69 74 65 33 43       && sqlite3C
0ce0: 6f 6e 66 69 67 2e 6e 50 61 67 65 3e 30 20 29 7b  onfig.nPage>0 ){
0cf0: 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20  .    int i;.    
0d00: 6d 65 6d 30 2e 61 50 61 67 65 46 72 65 65 20 3d  mem0.aPageFree =
0d10: 20 28 75 33 32 2a 29 26 28 28 63 68 61 72 2a 29   (u32*)&((char*)
0d20: 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 2e 70 50  sqlite3Config.pP
0d30: 61 67 65 29 0a 20 20 20 20 20 20 20 20 20 20 20  age).           
0d40: 20 20 20 20 20 20 20 5b 73 71 6c 69 74 65 33 43         [sqlite3C
0d50: 6f 6e 66 69 67 2e 73 7a 50 61 67 65 2a 73 71 6c  onfig.szPage*sql
0d60: 69 74 65 33 43 6f 6e 66 69 67 2e 6e 50 61 67 65  ite3Config.nPage
0d70: 5d 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20  ];.    for(i=0; 
0d80: 69 3c 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 2e  i<sqlite3Config.
0d90: 6e 50 61 67 65 3b 20 69 2b 2b 29 7b 20 6d 65 6d  nPage; i++){ mem
0da0: 30 2e 61 50 61 67 65 46 72 65 65 5b 69 5d 20 3d  0.aPageFree[i] =
0db0: 20 69 3b 20 7d 0a 20 20 20 20 6d 65 6d 30 2e 6e   i; }.    mem0.n
0dc0: 50 61 67 65 46 72 65 65 20 3d 20 73 71 6c 69 74  PageFree = sqlit
0dd0: 65 33 43 6f 6e 66 69 67 2e 6e 50 61 67 65 3b 0a  e3Config.nPage;.
0de0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c    }else{.    sql
0df0: 69 74 65 33 43 6f 6e 66 69 67 2e 70 50 61 67 65  ite3Config.pPage
0e00: 20 3d 20 30 3b 0a 20 20 20 20 73 71 6c 69 74 65   = 0;.    sqlite
0e10: 33 43 6f 6e 66 69 67 2e 73 7a 50 61 67 65 20 3d  3Config.szPage =
0e20: 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e   0;.  }.  return
0e30: 20 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 2e 6d   sqlite3Config.m
0e40: 2e 78 49 6e 69 74 28 73 71 6c 69 74 65 33 43 6f  .xInit(sqlite3Co
0e50: 6e 66 69 67 2e 6d 2e 70 41 70 70 44 61 74 61 29  nfig.m.pAppData)
0e60: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65 69 6e 69  ;.}../*.** Deini
0e70: 74 69 61 6c 69 7a 65 20 74 68 65 20 6d 65 6d 6f  tialize the memo
0e80: 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 73 75  ry allocation su
0e90: 62 73 79 73 74 65 6d 2e 0a 2a 2f 0a 76 6f 69 64  bsystem..*/.void
0ea0: 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 45 6e   sqlite3MallocEn
0eb0: 64 28 76 6f 69 64 29 7b 0a 20 20 73 71 6c 69 74  d(void){.  sqlit
0ec0: 65 33 43 6f 6e 66 69 67 2e 6d 2e 78 53 68 75 74  e3Config.m.xShut
0ed0: 64 6f 77 6e 28 73 71 6c 69 74 65 33 43 6f 6e 66  down(sqlite3Conf
0ee0: 69 67 2e 6d 2e 70 41 70 70 44 61 74 61 29 3b 0a  ig.m.pAppData);.
0ef0: 20 20 6d 65 6d 73 65 74 28 26 6d 65 6d 30 2c 20    memset(&mem0, 
0f00: 30 2c 20 73 69 7a 65 6f 66 28 6d 65 6d 30 29 29  0, sizeof(mem0))
0f10: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  ;.}../*.** Retur
0f20: 6e 20 74 68 65 20 61 6d 6f 75 6e 74 20 6f 66 20  n the amount of 
0f30: 6d 65 6d 6f 72 79 20 63 75 72 72 65 6e 74 6c 79  memory currently
0f40: 20 63 68 65 63 6b 65 64 20 6f 75 74 2e 0a 2a 2f   checked out..*/
0f50: 0a 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 73  .sqlite3_int64 s
0f60: 71 6c 69 74 65 33 5f 6d 65 6d 6f 72 79 5f 75 73  qlite3_memory_us
0f70: 65 64 28 76 6f 69 64 29 7b 0a 20 20 69 6e 74 20  ed(void){.  int 
0f80: 6e 2c 20 6d 78 3b 0a 20 20 73 71 6c 69 74 65 33  n, mx;.  sqlite3
0f90: 5f 73 74 61 74 75 73 28 53 51 4c 49 54 45 5f 53  _status(SQLITE_S
0fa0: 54 41 54 55 53 5f 4d 45 4d 4f 52 59 5f 55 53 45  TATUS_MEMORY_USE
0fb0: 44 2c 20 26 6e 2c 20 26 6d 78 2c 20 30 29 3b 0a  D, &n, &mx, 0);.
0fc0: 20 20 72 65 74 75 72 6e 20 28 73 71 6c 69 74 65    return (sqlite
0fd0: 33 5f 69 6e 74 36 34 29 6e 3b 0a 7d 0a 0a 2f 2a  3_int64)n;.}../*
0fe0: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6d  .** Return the m
0ff0: 61 78 69 6d 75 6d 20 61 6d 6f 75 6e 74 20 6f 66  aximum amount of
1000: 20 6d 65 6d 6f 72 79 20 74 68 61 74 20 68 61 73   memory that has
1010: 20 65 76 65 72 20 62 65 65 6e 0a 2a 2a 20 63 68   ever been.** ch
1020: 65 63 6b 65 64 20 6f 75 74 20 73 69 6e 63 65 20  ecked out since 
1030: 65 69 74 68 65 72 20 74 68 65 20 62 65 67 69 6e  either the begin
1040: 6e 69 6e 67 20 6f 66 20 74 68 69 73 20 70 72 6f  ning of this pro
1050: 63 65 73 73 0a 2a 2a 20 6f 72 20 73 69 6e 63 65  cess.** or since
1060: 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74   the most recent
1070: 20 72 65 73 65 74 2e 0a 2a 2f 0a 73 71 6c 69 74   reset..*/.sqlit
1080: 65 33 5f 69 6e 74 36 34 20 73 71 6c 69 74 65 33  e3_int64 sqlite3
1090: 5f 6d 65 6d 6f 72 79 5f 68 69 67 68 77 61 74 65  _memory_highwate
10a0: 72 28 69 6e 74 20 72 65 73 65 74 46 6c 61 67 29  r(int resetFlag)
10b0: 7b 0a 20 20 69 6e 74 20 6e 2c 20 6d 78 3b 0a 20  {.  int n, mx;. 
10c0: 20 73 71 6c 69 74 65 33 5f 73 74 61 74 75 73 28   sqlite3_status(
10d0: 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d 45  SQLITE_STATUS_ME
10e0: 4d 4f 52 59 5f 55 53 45 44 2c 20 26 6e 2c 20 26  MORY_USED, &n, &
10f0: 6d 78 2c 20 72 65 73 65 74 46 6c 61 67 29 3b 0a  mx, resetFlag);.
1100: 20 20 72 65 74 75 72 6e 20 28 73 71 6c 69 74 65    return (sqlite
1110: 33 5f 69 6e 74 36 34 29 6d 78 3b 0a 7d 0a 0a 2f  3_int64)mx;.}../
1120: 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20  *.** Change the 
1130: 61 6c 61 72 6d 20 63 61 6c 6c 62 61 63 6b 0a 2a  alarm callback.*
1140: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6d 65  /.int sqlite3_me
1150: 6d 6f 72 79 5f 61 6c 61 72 6d 28 0a 20 20 76 6f  mory_alarm(.  vo
1160: 69 64 28 2a 78 43 61 6c 6c 62 61 63 6b 29 28 76  id(*xCallback)(v
1170: 6f 69 64 20 2a 70 41 72 67 2c 20 73 71 6c 69 74  oid *pArg, sqlit
1180: 65 33 5f 69 6e 74 36 34 20 75 73 65 64 2c 69 6e  e3_int64 used,in
1190: 74 20 4e 29 2c 0a 20 20 76 6f 69 64 20 2a 70 41  t N),.  void *pA
11a0: 72 67 2c 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e  rg,.  sqlite3_in
11b0: 74 36 34 20 69 54 68 72 65 73 68 6f 6c 64 0a 29  t64 iThreshold.)
11c0: 7b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  {.  sqlite3_mute
11d0: 78 5f 65 6e 74 65 72 28 6d 65 6d 30 2e 6d 75 74  x_enter(mem0.mut
11e0: 65 78 29 3b 0a 20 20 6d 65 6d 30 2e 61 6c 61 72  ex);.  mem0.alar
11f0: 6d 43 61 6c 6c 62 61 63 6b 20 3d 20 78 43 61 6c  mCallback = xCal
1200: 6c 62 61 63 6b 3b 0a 20 20 6d 65 6d 30 2e 61 6c  lback;.  mem0.al
1210: 61 72 6d 41 72 67 20 3d 20 70 41 72 67 3b 0a 20  armArg = pArg;. 
1220: 20 6d 65 6d 30 2e 61 6c 61 72 6d 54 68 72 65 73   mem0.alarmThres
1230: 68 6f 6c 64 20 3d 20 69 54 68 72 65 73 68 6f 6c  hold = iThreshol
1240: 64 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  d;.  sqlite3_mut
1250: 65 78 5f 6c 65 61 76 65 28 6d 65 6d 30 2e 6d 75  ex_leave(mem0.mu
1260: 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 53  tex);.  return S
1270: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a  QLITE_OK;.}../*.
1280: 2a 2a 20 54 72 69 67 67 65 72 20 74 68 65 20 61  ** Trigger the a
1290: 6c 61 72 6d 20 0a 2a 2f 0a 73 74 61 74 69 63 20  larm .*/.static 
12a0: 76 6f 69 64 20 73 71 6c 69 74 65 33 4d 61 6c 6c  void sqlite3Mall
12b0: 6f 63 41 6c 61 72 6d 28 69 6e 74 20 6e 42 79 74  ocAlarm(int nByt
12c0: 65 29 7b 0a 20 20 76 6f 69 64 20 28 2a 78 43 61  e){.  void (*xCa
12d0: 6c 6c 62 61 63 6b 29 28 76 6f 69 64 2a 2c 73 71  llback)(void*,sq
12e0: 6c 69 74 65 33 5f 69 6e 74 36 34 2c 69 6e 74 29  lite3_int64,int)
12f0: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36  ;.  sqlite3_int6
1300: 34 20 6e 6f 77 55 73 65 64 3b 0a 20 20 76 6f 69  4 nowUsed;.  voi
1310: 64 20 2a 70 41 72 67 3b 0a 20 20 69 66 28 20 6d  d *pArg;.  if( m
1320: 65 6d 30 2e 61 6c 61 72 6d 43 61 6c 6c 62 61 63  em0.alarmCallbac
1330: 6b 3d 3d 30 20 7c 7c 20 6d 65 6d 30 2e 61 6c 61  k==0 || mem0.ala
1340: 72 6d 42 75 73 79 20 20 29 20 72 65 74 75 72 6e  rmBusy  ) return
1350: 3b 0a 20 20 6d 65 6d 30 2e 61 6c 61 72 6d 42 75  ;.  mem0.alarmBu
1360: 73 79 20 3d 20 31 3b 0a 20 20 78 43 61 6c 6c 62  sy = 1;.  xCallb
1370: 61 63 6b 20 3d 20 6d 65 6d 30 2e 61 6c 61 72 6d  ack = mem0.alarm
1380: 43 61 6c 6c 62 61 63 6b 3b 0a 20 20 6e 6f 77 55  Callback;.  nowU
1390: 73 65 64 20 3d 20 73 71 6c 69 74 65 33 53 74 61  sed = sqlite3Sta
13a0: 74 75 73 56 61 6c 75 65 28 53 51 4c 49 54 45 5f  tusValue(SQLITE_
13b0: 53 54 41 54 55 53 5f 4d 45 4d 4f 52 59 5f 55 53  STATUS_MEMORY_US
13c0: 45 44 29 3b 0a 20 20 70 41 72 67 20 3d 20 6d 65  ED);.  pArg = me
13d0: 6d 30 2e 61 6c 61 72 6d 41 72 67 3b 0a 20 20 73  m0.alarmArg;.  s
13e0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
13f0: 76 65 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a  ve(mem0.mutex);.
1400: 20 20 78 43 61 6c 6c 62 61 63 6b 28 70 41 72 67    xCallback(pArg
1410: 2c 20 6e 6f 77 55 73 65 64 2c 20 6e 42 79 74 65  , nowUsed, nByte
1420: 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  );.  sqlite3_mut
1430: 65 78 5f 65 6e 74 65 72 28 6d 65 6d 30 2e 6d 75  ex_enter(mem0.mu
1440: 74 65 78 29 3b 0a 20 20 6d 65 6d 30 2e 61 6c 61  tex);.  mem0.ala
1450: 72 6d 42 75 73 79 20 3d 20 30 3b 0a 7d 0a 0a 2f  rmBusy = 0;.}../
1460: 2a 0a 2a 2a 20 44 6f 20 61 20 6d 65 6d 6f 72 79  *.** Do a memory
1470: 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 77 69 74 68   allocation with
1480: 20 73 74 61 74 69 73 74 69 63 73 20 61 6e 64 20   statistics and 
1490: 61 6c 61 72 6d 73 2e 20 20 41 73 73 75 6d 65 20  alarms.  Assume 
14a0: 74 68 65 0a 2a 2a 20 6c 6f 63 6b 20 69 73 20 61  the.** lock is a
14b0: 6c 72 65 61 64 79 20 68 65 6c 64 2e 0a 2a 2f 0a  lready held..*/.
14c0: 73 74 61 74 69 63 20 69 6e 74 20 6d 61 6c 6c 6f  static int mallo
14d0: 63 57 69 74 68 41 6c 61 72 6d 28 69 6e 74 20 6e  cWithAlarm(int n
14e0: 2c 20 76 6f 69 64 20 2a 2a 70 70 29 7b 0a 20 20  , void **pp){.  
14f0: 69 6e 74 20 6e 46 75 6c 6c 3b 0a 20 20 76 6f 69  int nFull;.  voi
1500: 64 20 2a 70 3b 0a 20 20 61 73 73 65 72 74 28 20  d *p;.  assert( 
1510: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65  sqlite3_mutex_he
1520: 6c 64 28 6d 65 6d 30 2e 6d 75 74 65 78 29 20 29  ld(mem0.mutex) )
1530: 3b 0a 20 20 6e 46 75 6c 6c 20 3d 20 73 71 6c 69  ;.  nFull = sqli
1540: 74 65 33 43 6f 6e 66 69 67 2e 6d 2e 78 52 6f 75  te3Config.m.xRou
1550: 6e 64 75 70 28 6e 29 3b 0a 20 20 73 71 6c 69 74  ndup(n);.  sqlit
1560: 65 33 53 74 61 74 75 73 53 65 74 28 53 51 4c 49  e3StatusSet(SQLI
1570: 54 45 5f 53 54 41 54 55 53 5f 4d 41 4c 4c 4f 43  TE_STATUS_MALLOC
1580: 5f 53 49 5a 45 2c 20 6e 29 3b 0a 20 20 69 66 28  _SIZE, n);.  if(
1590: 20 6d 65 6d 30 2e 61 6c 61 72 6d 43 61 6c 6c 62   mem0.alarmCallb
15a0: 61 63 6b 21 3d 30 20 29 7b 0a 20 20 20 20 69 6e  ack!=0 ){.    in
15b0: 74 20 6e 55 73 65 64 20 3d 20 73 71 6c 69 74 65  t nUsed = sqlite
15c0: 33 53 74 61 74 75 73 56 61 6c 75 65 28 53 51 4c  3StatusValue(SQL
15d0: 49 54 45 5f 53 54 41 54 55 53 5f 4d 45 4d 4f 52  ITE_STATUS_MEMOR
15e0: 59 5f 55 53 45 44 29 3b 0a 20 20 20 20 69 66 28  Y_USED);.    if(
15f0: 20 6e 55 73 65 64 2b 6e 46 75 6c 6c 20 3e 3d 20   nUsed+nFull >= 
1600: 6d 65 6d 30 2e 61 6c 61 72 6d 54 68 72 65 73 68  mem0.alarmThresh
1610: 6f 6c 64 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  old ){.      sql
1620: 69 74 65 33 4d 61 6c 6c 6f 63 41 6c 61 72 6d 28  ite3MallocAlarm(
1630: 6e 46 75 6c 6c 29 3b 0a 20 20 20 20 7d 0a 20 20  nFull);.    }.  
1640: 7d 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 33 43  }.  p = sqlite3C
1650: 6f 6e 66 69 67 2e 6d 2e 78 4d 61 6c 6c 6f 63 28  onfig.m.xMalloc(
1660: 6e 46 75 6c 6c 29 3b 0a 20 20 69 66 28 20 70 3d  nFull);.  if( p=
1670: 3d 30 20 26 26 20 6d 65 6d 30 2e 61 6c 61 72 6d  =0 && mem0.alarm
1680: 43 61 6c 6c 62 61 63 6b 20 29 7b 0a 20 20 20 20  Callback ){.    
1690: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 41 6c 61  sqlite3MallocAla
16a0: 72 6d 28 6e 46 75 6c 6c 29 3b 0a 20 20 20 20 70  rm(nFull);.    p
16b0: 20 3d 20 73 71 6c 69 74 65 33 43 6f 6e 66 69 67   = sqlite3Config
16c0: 2e 6d 2e 78 4d 61 6c 6c 6f 63 28 6e 46 75 6c 6c  .m.xMalloc(nFull
16d0: 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 20 29  );.  }.  if( p )
16e0: 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 41 64   sqlite3StatusAd
16f0: 64 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f  d(SQLITE_STATUS_
1700: 4d 45 4d 4f 52 59 5f 55 53 45 44 2c 20 6e 46 75  MEMORY_USED, nFu
1710: 6c 6c 29 3b 0a 20 20 2a 70 70 20 3d 20 70 3b 0a  ll);.  *pp = p;.
1720: 20 20 72 65 74 75 72 6e 20 6e 46 75 6c 6c 3b 0a    return nFull;.
1730: 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74  }../*.** Allocat
1740: 65 20 6d 65 6d 6f 72 79 2e 20 20 54 68 69 73 20  e memory.  This 
1750: 72 6f 75 74 69 6e 65 20 69 73 20 6c 69 6b 65 20  routine is like 
1760: 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 29  sqlite3_malloc()
1770: 20 65 78 63 65 70 74 20 74 68 61 74 20 69 74 0a   except that it.
1780: 2a 2a 20 61 73 73 75 6d 65 73 20 74 68 65 20 6d  ** assumes the m
1790: 65 6d 6f 72 79 20 73 75 62 73 79 73 74 65 6d 20  emory subsystem 
17a0: 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 65 6e  has already been
17b0: 20 69 6e 69 74 69 61 6c 69 7a 65 64 2e 0a 2a 2f   initialized..*/
17c0: 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 4d 61  .void *sqlite3Ma
17d0: 6c 6c 6f 63 28 69 6e 74 20 6e 29 7b 0a 20 20 76  lloc(int n){.  v
17e0: 6f 69 64 20 2a 70 3b 0a 20 20 69 66 28 20 6e 3c  oid *p;.  if( n<
17f0: 3d 30 20 29 7b 0a 20 20 20 20 70 20 3d 20 30 3b  =0 ){.    p = 0;
1800: 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 73 71 6c  .  }else if( sql
1810: 69 74 65 33 43 6f 6e 66 69 67 2e 62 4d 65 6d 73  ite3Config.bMems
1820: 74 61 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  tat ){.    sqlit
1830: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d  e3_mutex_enter(m
1840: 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20  em0.mutex);.    
1850: 6d 61 6c 6c 6f 63 57 69 74 68 41 6c 61 72 6d 28  mallocWithAlarm(
1860: 6e 2c 20 26 70 29 3b 0a 20 20 20 20 73 71 6c 69  n, &p);.    sqli
1870: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
1880: 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 7d  mem0.mutex);.  }
1890: 65 6c 73 65 7b 0a 20 20 20 20 70 20 3d 20 73 71  else{.    p = sq
18a0: 6c 69 74 65 33 43 6f 6e 66 69 67 2e 6d 2e 78 4d  lite3Config.m.xM
18b0: 61 6c 6c 6f 63 28 6e 29 3b 0a 20 20 7d 0a 20 20  alloc(n);.  }.  
18c0: 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 2f 2a 0a  return p;.}../*.
18d0: 2a 2a 20 54 68 69 73 20 76 65 72 73 69 6f 6e 20  ** This version 
18e0: 6f 66 20 74 68 65 20 6d 65 6d 6f 72 79 20 61 6c  of the memory al
18f0: 6c 6f 63 61 74 69 6f 6e 20 69 73 20 66 6f 72 20  location is for 
1900: 75 73 65 20 62 79 20 74 68 65 20 61 70 70 6c 69  use by the appli
1910: 63 61 74 69 6f 6e 2e 0a 2a 2a 20 46 69 72 73 74  cation..** First
1920: 20 6d 61 6b 65 20 73 75 72 65 20 74 68 65 20 6d   make sure the m
1930: 65 6d 6f 72 79 20 73 75 62 73 79 73 74 65 6d 20  emory subsystem 
1940: 69 73 20 69 6e 69 74 69 61 6c 69 7a 65 64 2c 20  is initialized, 
1950: 74 68 65 6e 20 64 6f 20 74 68 65 0a 2a 2a 20 61  then do the.** a
1960: 6c 6c 6f 63 61 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f  llocation..*/.vo
1970: 69 64 20 2a 73 71 6c 69 74 65 33 5f 6d 61 6c 6c  id *sqlite3_mall
1980: 6f 63 28 69 6e 74 20 6e 29 7b 0a 23 69 66 6e 64  oc(int n){.#ifnd
1990: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41  ef SQLITE_OMIT_A
19a0: 55 54 4f 49 4e 49 54 0a 20 20 69 66 28 20 73 71  UTOINIT.  if( sq
19b0: 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65  lite3_initialize
19c0: 28 29 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 23  () ) return 0;.#
19d0: 65 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20 73  endif.  return s
19e0: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 6e 29 3b  qlite3Malloc(n);
19f0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 74  .}../*.** Each t
1a00: 68 72 65 61 64 20 6d 61 79 20 6f 6e 6c 79 20 68  hread may only h
1a10: 61 76 65 20 61 20 73 69 6e 67 6c 65 20 6f 75 74  ave a single out
1a20: 73 74 61 6e 64 69 6e 67 20 61 6c 6c 6f 63 61 74  standing allocat
1a30: 69 6f 6e 20 66 72 6f 6d 0a 2a 2a 20 78 53 63 72  ion from.** xScr
1a40: 61 74 63 68 4d 61 6c 6c 6f 63 28 29 2e 20 20 57  atchMalloc().  W
1a50: 65 20 76 65 72 69 66 79 20 74 68 69 73 20 63 6f  e verify this co
1a60: 6e 73 74 72 61 69 6e 74 20 69 6e 20 74 68 65 20  nstraint in the 
1a70: 73 69 6e 67 6c 65 2d 74 68 72 65 61 64 65 64 0a  single-threaded.
1a80: 2a 2a 20 63 61 73 65 20 62 79 20 73 65 74 74 69  ** case by setti
1a90: 6e 67 20 73 63 72 61 74 63 68 41 6c 6c 6f 63 4f  ng scratchAllocO
1aa0: 75 74 20 74 6f 20 31 20 77 68 65 6e 20 61 6e 20  ut to 1 when an 
1ab0: 61 6c 6c 6f 63 61 74 69 6f 6e 0a 2a 2a 20 69 73  allocation.** is
1ac0: 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 63 6c 65   outstanding cle
1ad0: 61 72 69 6e 67 20 69 74 20 77 68 65 6e 20 74 68  aring it when th
1ae0: 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69 73 20  e allocation is 
1af0: 66 72 65 65 64 2e 0a 2a 2f 0a 23 69 66 20 53 51  freed..*/.#if SQ
1b00: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d  LITE_THREADSAFE=
1b10: 3d 30 20 26 26 20 21 64 65 66 69 6e 65 64 28 4e  =0 && !defined(N
1b20: 44 45 42 55 47 29 0a 73 74 61 74 69 63 20 69 6e  DEBUG).static in
1b30: 74 20 73 63 72 61 74 63 68 41 6c 6c 6f 63 4f 75  t scratchAllocOu
1b40: 74 20 3d 20 30 3b 0a 23 65 6e 64 69 66 0a 0a 0a  t = 0;.#endif...
1b50: 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 6d  /*.** Allocate m
1b60: 65 6d 6f 72 79 20 74 68 61 74 20 69 73 20 74 6f  emory that is to
1b70: 20 62 65 20 75 73 65 64 20 61 6e 64 20 72 65 6c   be used and rel
1b80: 65 61 73 65 64 20 72 69 67 68 74 20 61 77 61 79  eased right away
1b90: 2e 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  ..** This routin
1ba0: 65 20 69 73 20 73 69 6d 69 6c 61 72 20 74 6f 20  e is similar to 
1bb0: 61 6c 6c 6f 63 61 28 29 20 69 6e 20 74 68 61 74  alloca() in that
1bc0: 20 69 74 20 69 73 20 6e 6f 74 20 69 6e 74 65 6e   it is not inten
1bd0: 64 65 64 0a 2a 2a 20 66 6f 72 20 73 69 74 75 61  ded.** for situa
1be0: 74 69 6f 6e 73 20 77 68 65 72 65 20 74 68 65 20  tions where the 
1bf0: 6d 65 6d 6f 72 79 20 6d 69 67 68 74 20 62 65 20  memory might be 
1c00: 68 65 6c 64 20 6c 6f 6e 67 2d 74 65 72 6d 2e 20  held long-term. 
1c10: 20 54 68 69 73 0a 2a 2a 20 72 6f 75 74 69 6e 65   This.** routine
1c20: 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20   is intended to 
1c30: 67 65 74 20 6d 65 6d 6f 72 79 20 74 6f 20 6f 6c  get memory to ol
1c40: 64 20 6c 61 72 67 65 20 74 72 61 6e 73 69 65 6e  d large transien
1c50: 74 20 64 61 74 61 0a 2a 2a 20 73 74 72 75 63 74  t data.** struct
1c60: 75 72 65 73 20 74 68 61 74 20 77 6f 75 6c 64 20  ures that would 
1c70: 6e 6f 74 20 6e 6f 72 6d 61 6c 6c 79 20 66 69 74  not normally fit
1c80: 20 6f 6e 20 74 68 65 20 73 74 61 63 6b 20 6f 66   on the stack of
1c90: 20 61 6e 0a 2a 2a 20 65 6d 62 65 64 64 65 64 20   an.** embedded 
1ca0: 70 72 6f 63 65 73 73 6f 72 2e 0a 2a 2f 0a 76 6f  processor..*/.vo
1cb0: 69 64 20 2a 73 71 6c 69 74 65 33 53 63 72 61 74  id *sqlite3Scrat
1cc0: 63 68 4d 61 6c 6c 6f 63 28 69 6e 74 20 6e 29 7b  chMalloc(int n){
1cd0: 0a 20 20 76 6f 69 64 20 2a 70 3b 0a 20 20 61 73  .  void *p;.  as
1ce0: 73 65 72 74 28 20 6e 3e 30 20 29 3b 0a 0a 23 69  sert( n>0 );..#i
1cf0: 66 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53  f SQLITE_THREADS
1d00: 41 46 45 3d 3d 30 20 26 26 20 21 64 65 66 69 6e  AFE==0 && !defin
1d10: 65 64 28 4e 44 45 42 55 47 29 0a 20 20 2f 2a 20  ed(NDEBUG).  /* 
1d20: 56 65 72 69 66 79 20 74 68 61 74 20 6e 6f 20 6d  Verify that no m
1d30: 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 73 63 72  ore than one scr
1d40: 61 74 63 68 20 61 6c 6c 6f 63 61 74 69 6f 6e 20  atch allocation 
1d50: 70 65 72 20 74 68 72 65 61 64 0a 20 20 2a 2a 20  per thread.  ** 
1d60: 69 73 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 61  is outstanding a
1d70: 74 20 6f 6e 65 20 74 69 6d 65 2e 20 20 28 54 68  t one time.  (Th
1d80: 69 73 20 69 73 20 6f 6e 6c 79 20 63 68 65 63 6b  is is only check
1d90: 65 64 20 69 6e 20 74 68 65 0a 20 20 2a 2a 20 73  ed in the.  ** s
1da0: 69 6e 67 6c 65 2d 74 68 72 65 61 64 65 64 20 63  ingle-threaded c
1db0: 61 73 65 20 73 69 6e 63 65 20 63 68 65 63 6b 69  ase since checki
1dc0: 6e 67 20 69 6e 20 74 68 65 20 6d 75 6c 74 69 2d  ng in the multi-
1dd0: 74 68 72 65 61 64 65 64 20 63 61 73 65 0a 20 20  threaded case.  
1de0: 2a 2a 20 77 6f 75 6c 64 20 62 65 20 6d 75 63 68  ** would be much
1df0: 20 6d 6f 72 65 20 63 6f 6d 70 6c 69 63 61 74 65   more complicate
1e00: 64 2e 29 20 2a 2f 0a 20 20 61 73 73 65 72 74 28  d.) */.  assert(
1e10: 20 73 63 72 61 74 63 68 41 6c 6c 6f 63 4f 75 74   scratchAllocOut
1e20: 3d 3d 30 20 29 3b 0a 23 65 6e 64 69 66 0a 0a 20  ==0 );.#endif.. 
1e30: 20 69 66 28 20 73 71 6c 69 74 65 33 43 6f 6e 66   if( sqlite3Conf
1e40: 69 67 2e 73 7a 53 63 72 61 74 63 68 3c 6e 20 29  ig.szScratch<n )
1e50: 7b 0a 20 20 20 20 67 6f 74 6f 20 73 63 72 61 74  {.    goto scrat
1e60: 63 68 5f 6f 76 65 72 66 6c 6f 77 3b 0a 20 20 7d  ch_overflow;.  }
1e70: 65 6c 73 65 7b 20 20 0a 20 20 20 20 73 71 6c 69  else{  .    sqli
1e80: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28  te3_mutex_enter(
1e90: 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20  mem0.mutex);.   
1ea0: 20 69 66 28 20 6d 65 6d 30 2e 6e 53 63 72 61 74   if( mem0.nScrat
1eb0: 63 68 46 72 65 65 3d 3d 30 20 29 7b 0a 20 20 20  chFree==0 ){.   
1ec0: 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78     sqlite3_mutex
1ed0: 5f 6c 65 61 76 65 28 6d 65 6d 30 2e 6d 75 74 65  _leave(mem0.mute
1ee0: 78 29 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 73  x);.      goto s
1ef0: 63 72 61 74 63 68 5f 6f 76 65 72 66 6c 6f 77 3b  cratch_overflow;
1f00: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  .    }else{.    
1f10: 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 20 20 69    int i;.      i
1f20: 20 3d 20 6d 65 6d 30 2e 61 53 63 72 61 74 63 68   = mem0.aScratch
1f30: 46 72 65 65 5b 2d 2d 6d 65 6d 30 2e 6e 53 63 72  Free[--mem0.nScr
1f40: 61 74 63 68 46 72 65 65 5d 3b 0a 20 20 20 20 20  atchFree];.     
1f50: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c   sqlite3_mutex_l
1f60: 65 61 76 65 28 6d 65 6d 30 2e 6d 75 74 65 78 29  eave(mem0.mutex)
1f70: 3b 0a 20 20 20 20 20 20 69 20 2a 3d 20 73 71 6c  ;.      i *= sql
1f80: 69 74 65 33 43 6f 6e 66 69 67 2e 73 7a 53 63 72  ite3Config.szScr
1f90: 61 74 63 68 3b 0a 20 20 20 20 20 20 73 71 6c 69  atch;.      sqli
1fa0: 74 65 33 53 74 61 74 75 73 41 64 64 28 53 51 4c  te3StatusAdd(SQL
1fb0: 49 54 45 5f 53 54 41 54 55 53 5f 53 43 52 41 54  ITE_STATUS_SCRAT
1fc0: 43 48 5f 55 53 45 44 2c 20 31 29 3b 0a 20 20 20  CH_USED, 1);.   
1fd0: 20 20 20 70 20 3d 20 28 76 6f 69 64 2a 29 26 28     p = (void*)&(
1fe0: 28 63 68 61 72 2a 29 73 71 6c 69 74 65 33 43 6f  (char*)sqlite3Co
1ff0: 6e 66 69 67 2e 70 53 63 72 61 74 63 68 29 5b 69  nfig.pScratch)[i
2000: 5d 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 69 66  ];.    }.  }.#if
2010: 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41   SQLITE_THREADSA
2020: 46 45 3d 3d 30 20 26 26 20 21 64 65 66 69 6e 65  FE==0 && !define
2030: 64 28 4e 44 45 42 55 47 29 0a 20 20 73 63 72 61  d(NDEBUG).  scra
2040: 74 63 68 41 6c 6c 6f 63 4f 75 74 20 3d 20 70 21  tchAllocOut = p!
2050: 3d 30 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 72 65  =0;.#endif..  re
2060: 74 75 72 6e 20 70 3b 0a 0a 73 63 72 61 74 63 68  turn p;..scratch
2070: 5f 6f 76 65 72 66 6c 6f 77 3a 0a 20 20 69 66 28  _overflow:.  if(
2080: 20 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 2e 62   sqlite3Config.b
2090: 4d 65 6d 73 74 61 74 20 29 7b 0a 20 20 20 20 73  Memstat ){.    s
20a0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74  qlite3_mutex_ent
20b0: 65 72 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a  er(mem0.mutex);.
20c0: 20 20 20 20 6e 20 3d 20 6d 61 6c 6c 6f 63 57 69      n = mallocWi
20d0: 74 68 41 6c 61 72 6d 28 6e 2c 20 26 70 29 3b 0a  thAlarm(n, &p);.
20e0: 20 20 20 20 69 66 28 20 70 20 29 20 73 71 6c 69      if( p ) sqli
20f0: 74 65 33 53 74 61 74 75 73 41 64 64 28 53 51 4c  te3StatusAdd(SQL
2100: 49 54 45 5f 53 54 41 54 55 53 5f 53 43 52 41 54  ITE_STATUS_SCRAT
2110: 43 48 5f 4f 56 45 52 46 4c 4f 57 2c 20 6e 29 3b  CH_OVERFLOW, n);
2120: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  .    sqlite3_mut
2130: 65 78 5f 6c 65 61 76 65 28 6d 65 6d 30 2e 6d 75  ex_leave(mem0.mu
2140: 74 65 78 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  tex);.  }else{. 
2150: 20 20 20 70 20 3d 20 73 71 6c 69 74 65 33 43 6f     p = sqlite3Co
2160: 6e 66 69 67 2e 6d 2e 78 4d 61 6c 6c 6f 63 28 6e  nfig.m.xMalloc(n
2170: 29 3b 0a 20 20 7d 0a 23 69 66 20 53 51 4c 49 54  );.  }.#if SQLIT
2180: 45 5f 54 48 52 45 41 44 53 41 46 45 3d 3d 30 20  E_THREADSAFE==0 
2190: 26 26 20 21 64 65 66 69 6e 65 64 28 4e 44 45 42  && !defined(NDEB
21a0: 55 47 29 0a 20 20 73 63 72 61 74 63 68 41 6c 6c  UG).  scratchAll
21b0: 6f 63 4f 75 74 20 3d 20 70 21 3d 30 3b 0a 23 65  ocOut = p!=0;.#e
21c0: 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20 70 3b  ndif.  return p;
21d0: 20 20 20 20 0a 7d 0a 76 6f 69 64 20 73 71 6c 69      .}.void sqli
21e0: 74 65 33 53 63 72 61 74 63 68 46 72 65 65 28 76  te3ScratchFree(v
21f0: 6f 69 64 20 2a 70 29 7b 0a 20 20 69 66 28 20 70  oid *p){.  if( p
2200: 20 29 7b 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f   ){..#if SQLITE_
2210: 54 48 52 45 41 44 53 41 46 45 3d 3d 30 20 26 26  THREADSAFE==0 &&
2220: 20 21 64 65 66 69 6e 65 64 28 4e 44 45 42 55 47   !defined(NDEBUG
2230: 29 0a 20 20 20 20 2f 2a 20 56 65 72 69 66 79 20  ).    /* Verify 
2240: 74 68 61 74 20 6e 6f 20 6d 6f 72 65 20 74 68 61  that no more tha
2250: 6e 20 6f 6e 65 20 73 63 72 61 74 63 68 20 61 6c  n one scratch al
2260: 6c 6f 63 61 74 69 6f 6e 20 70 65 72 20 74 68 72  location per thr
2270: 65 61 64 0a 20 20 20 20 2a 2a 20 69 73 20 6f 75  ead.    ** is ou
2280: 74 73 74 61 6e 64 69 6e 67 20 61 74 20 6f 6e 65  tstanding at one
2290: 20 74 69 6d 65 2e 20 20 28 54 68 69 73 20 69 73   time.  (This is
22a0: 20 6f 6e 6c 79 20 63 68 65 63 6b 65 64 20 69 6e   only checked in
22b0: 20 74 68 65 0a 20 20 20 20 2a 2a 20 73 69 6e 67   the.    ** sing
22c0: 6c 65 2d 74 68 72 65 61 64 65 64 20 63 61 73 65  le-threaded case
22d0: 20 73 69 6e 63 65 20 63 68 65 63 6b 69 6e 67 20   since checking 
22e0: 69 6e 20 74 68 65 20 6d 75 6c 74 69 2d 74 68 72  in the multi-thr
22f0: 65 61 64 65 64 20 63 61 73 65 0a 20 20 20 20 2a  eaded case.    *
2300: 2a 20 77 6f 75 6c 64 20 62 65 20 6d 75 63 68 20  * would be much 
2310: 6d 6f 72 65 20 63 6f 6d 70 6c 69 63 61 74 65 64  more complicated
2320: 2e 29 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74  .) */.    assert
2330: 28 20 73 63 72 61 74 63 68 41 6c 6c 6f 63 4f 75  ( scratchAllocOu
2340: 74 3d 3d 31 20 29 3b 0a 20 20 20 20 73 63 72 61  t==1 );.    scra
2350: 74 63 68 41 6c 6c 6f 63 4f 75 74 20 3d 20 30 3b  tchAllocOut = 0;
2360: 0a 23 65 6e 64 69 66 0a 0a 20 20 20 20 69 66 28  .#endif..    if(
2370: 20 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 2e 70   sqlite3Config.p
2380: 53 63 72 61 74 63 68 3d 3d 30 0a 20 20 20 20 20  Scratch==0.     
2390: 20 20 20 20 20 20 7c 7c 20 70 3c 73 71 6c 69 74        || p<sqlit
23a0: 65 33 43 6f 6e 66 69 67 2e 70 53 63 72 61 74 63  e3Config.pScratc
23b0: 68 0a 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20  h.           || 
23c0: 70 3e 3d 28 76 6f 69 64 2a 29 6d 65 6d 30 2e 61  p>=(void*)mem0.a
23d0: 53 63 72 61 74 63 68 46 72 65 65 20 29 7b 0a 20  ScratchFree ){. 
23e0: 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33       if( sqlite3
23f0: 43 6f 6e 66 69 67 2e 62 4d 65 6d 73 74 61 74 20  Config.bMemstat 
2400: 29 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 69  ){.        int i
2410: 53 69 7a 65 20 3d 20 73 71 6c 69 74 65 33 4d 61  Size = sqlite3Ma
2420: 6c 6c 6f 63 53 69 7a 65 28 70 29 3b 0a 20 20 20  llocSize(p);.   
2430: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74       sqlite3_mut
2440: 65 78 5f 65 6e 74 65 72 28 6d 65 6d 30 2e 6d 75  ex_enter(mem0.mu
2450: 74 65 78 29 3b 0a 20 20 20 20 20 20 20 20 73 71  tex);.        sq
2460: 6c 69 74 65 33 53 74 61 74 75 73 41 64 64 28 53  lite3StatusAdd(S
2470: 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 53 43 52  QLITE_STATUS_SCR
2480: 41 54 43 48 5f 4f 56 45 52 46 4c 4f 57 2c 20 2d  ATCH_OVERFLOW, -
2490: 69 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 20 20  iSize);.        
24a0: 73 71 6c 69 74 65 33 53 74 61 74 75 73 41 64 64  sqlite3StatusAdd
24b0: 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d  (SQLITE_STATUS_M
24c0: 45 4d 4f 52 59 5f 55 53 45 44 2c 20 2d 69 53 69  EMORY_USED, -iSi
24d0: 7a 65 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c  ze);.        sql
24e0: 69 74 65 33 43 6f 6e 66 69 67 2e 6d 2e 78 46 72  ite3Config.m.xFr
24f0: 65 65 28 70 29 3b 0a 20 20 20 20 20 20 20 20 73  ee(p);.        s
2500: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
2510: 76 65 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a  ve(mem0.mutex);.
2520: 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20        }else{.   
2530: 20 20 20 20 20 73 71 6c 69 74 65 33 43 6f 6e 66       sqlite3Conf
2540: 69 67 2e 6d 2e 78 46 72 65 65 28 70 29 3b 0a 20  ig.m.xFree(p);. 
2550: 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65       }.    }else
2560: 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 3b 0a 20  {.      int i;. 
2570: 20 20 20 20 20 69 20 3d 20 70 20 2d 20 73 71 6c       i = p - sql
2580: 69 74 65 33 43 6f 6e 66 69 67 2e 70 53 63 72 61  ite3Config.pScra
2590: 74 63 68 3b 0a 20 20 20 20 20 20 69 20 2f 3d 20  tch;.      i /= 
25a0: 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 2e 73 7a  sqlite3Config.sz
25b0: 53 63 72 61 74 63 68 3b 0a 20 20 20 20 20 20 61  Scratch;.      a
25c0: 73 73 65 72 74 28 20 69 3e 3d 30 20 26 26 20 69  ssert( i>=0 && i
25d0: 3c 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 2e 6e  <sqlite3Config.n
25e0: 53 63 72 61 74 63 68 20 29 3b 0a 20 20 20 20 20  Scratch );.     
25f0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65   sqlite3_mutex_e
2600: 6e 74 65 72 28 6d 65 6d 30 2e 6d 75 74 65 78 29  nter(mem0.mutex)
2610: 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20  ;.      assert( 
2620: 6d 65 6d 30 2e 6e 53 63 72 61 74 63 68 46 72 65  mem0.nScratchFre
2630: 65 3c 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 2e  e<sqlite3Config.
2640: 6e 53 63 72 61 74 63 68 20 29 3b 0a 20 20 20 20  nScratch );.    
2650: 20 20 6d 65 6d 30 2e 61 53 63 72 61 74 63 68 46    mem0.aScratchF
2660: 72 65 65 5b 6d 65 6d 30 2e 6e 53 63 72 61 74 63  ree[mem0.nScratc
2670: 68 46 72 65 65 2b 2b 5d 20 3d 20 69 3b 0a 20 20  hFree++] = i;.  
2680: 20 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75      sqlite3Statu
2690: 73 41 64 64 28 53 51 4c 49 54 45 5f 53 54 41 54  sAdd(SQLITE_STAT
26a0: 55 53 5f 53 43 52 41 54 43 48 5f 55 53 45 44 2c  US_SCRATCH_USED,
26b0: 20 2d 31 29 3b 0a 20 20 20 20 20 20 73 71 6c 69   -1);.      sqli
26c0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
26d0: 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20  mem0.mutex);.   
26e0: 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20   }.  }.}../*.** 
26f0: 41 6c 6c 6f 63 61 74 65 20 6d 65 6d 6f 72 79 20  Allocate memory 
2700: 74 6f 20 62 65 20 75 73 65 64 20 62 79 20 74 68  to be used by th
2710: 65 20 70 61 67 65 20 63 61 63 68 65 2e 20 20 4d  e page cache.  M
2720: 61 6b 65 20 75 73 65 20 6f 66 20 74 68 65 0a 2a  ake use of the.*
2730: 2a 20 6d 65 6d 6f 72 79 20 62 75 66 66 65 72 20  * memory buffer 
2740: 70 72 6f 76 69 64 65 64 20 62 79 20 53 51 4c 49  provided by SQLI
2750: 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41  TE_CONFIG_PAGECA
2760: 43 48 45 20 69 66 20 74 68 65 72 65 20 69 73 20  CHE if there is 
2770: 6f 6e 65 0a 2a 2a 20 61 6e 64 20 74 68 61 74 20  one.** and that 
2780: 6d 65 6d 6f 72 79 20 69 73 20 6f 66 20 74 68 65  memory is of the
2790: 20 72 69 67 68 74 20 73 69 7a 65 20 61 6e 64 20   right size and 
27a0: 69 73 20 6e 6f 74 20 63 6f 6d 70 6c 65 74 65 6c  is not completel
27b0: 79 0a 2a 2a 20 63 6f 6e 73 75 6d 65 64 2e 20 20  y.** consumed.  
27c0: 4f 74 68 65 72 77 69 73 65 2c 20 66 61 69 6c 6f  Otherwise, failo
27d0: 76 65 72 20 74 6f 20 73 71 6c 69 74 65 33 4d 61  ver to sqlite3Ma
27e0: 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20  lloc()..*/.void 
27f0: 2a 73 71 6c 69 74 65 33 50 61 67 65 4d 61 6c 6c  *sqlite3PageMall
2800: 6f 63 28 69 6e 74 20 6e 29 7b 0a 20 20 76 6f 69  oc(int n){.  voi
2810: 64 20 2a 70 3b 0a 20 20 61 73 73 65 72 74 28 20  d *p;.  assert( 
2820: 6e 3e 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28  n>0 );.  assert(
2830: 20 28 6e 20 26 20 28 6e 2d 31 29 29 3d 3d 30 20   (n & (n-1))==0 
2840: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 6e 3e 3d  );.  assert( n>=
2850: 35 31 32 20 26 26 20 6e 3c 3d 33 32 37 36 38 20  512 && n<=32768 
2860: 29 3b 0a 0a 20 20 69 66 28 20 73 71 6c 69 74 65  );..  if( sqlite
2870: 33 43 6f 6e 66 69 67 2e 73 7a 50 61 67 65 3c 6e  3Config.szPage<n
2880: 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 70 61 67   ){.    goto pag
2890: 65 5f 6f 76 65 72 66 6c 6f 77 3b 0a 20 20 7d 65  e_overflow;.  }e
28a0: 6c 73 65 7b 20 20 0a 20 20 20 20 73 71 6c 69 74  lse{  .    sqlit
28b0: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d  e3_mutex_enter(m
28c0: 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20  em0.mutex);.    
28d0: 69 66 28 20 6d 65 6d 30 2e 6e 50 61 67 65 46 72  if( mem0.nPageFr
28e0: 65 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 73  ee==0 ){.      s
28f0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
2900: 76 65 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a  ve(mem0.mutex);.
2910: 20 20 20 20 20 20 67 6f 74 6f 20 70 61 67 65 5f        goto page_
2920: 6f 76 65 72 66 6c 6f 77 3b 0a 20 20 20 20 7d 65  overflow;.    }e
2930: 6c 73 65 7b 0a 20 20 20 20 20 20 69 6e 74 20 69  lse{.      int i
2940: 3b 0a 20 20 20 20 20 20 69 20 3d 20 6d 65 6d 30  ;.      i = mem0
2950: 2e 61 50 61 67 65 46 72 65 65 5b 2d 2d 6d 65 6d  .aPageFree[--mem
2960: 30 2e 6e 50 61 67 65 46 72 65 65 5d 3b 0a 20 20  0.nPageFree];.  
2970: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65      sqlite3_mute
2980: 78 5f 6c 65 61 76 65 28 6d 65 6d 30 2e 6d 75 74  x_leave(mem0.mut
2990: 65 78 29 3b 0a 20 20 20 20 20 20 69 20 2a 3d 20  ex);.      i *= 
29a0: 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 2e 73 7a  sqlite3Config.sz
29b0: 50 61 67 65 3b 0a 20 20 20 20 20 20 73 71 6c 69  Page;.      sqli
29c0: 74 65 33 53 74 61 74 75 73 41 64 64 28 53 51 4c  te3StatusAdd(SQL
29d0: 49 54 45 5f 53 54 41 54 55 53 5f 50 41 47 45 43  ITE_STATUS_PAGEC
29e0: 41 43 48 45 5f 55 53 45 44 2c 20 31 29 3b 0a 20  ACHE_USED, 1);. 
29f0: 20 20 20 20 20 70 20 3d 20 28 76 6f 69 64 2a 29       p = (void*)
2a00: 26 28 28 63 68 61 72 2a 29 73 71 6c 69 74 65 33  &((char*)sqlite3
2a10: 43 6f 6e 66 69 67 2e 70 50 61 67 65 29 5b 69 5d  Config.pPage)[i]
2a20: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65  ;.    }.  }.  re
2a30: 74 75 72 6e 20 70 3b 0a 0a 70 61 67 65 5f 6f 76  turn p;..page_ov
2a40: 65 72 66 6c 6f 77 3a 0a 20 20 69 66 28 20 73 71  erflow:.  if( sq
2a50: 6c 69 74 65 33 43 6f 6e 66 69 67 2e 62 4d 65 6d  lite3Config.bMem
2a60: 73 74 61 74 20 29 7b 0a 20 20 20 20 73 71 6c 69  stat ){.    sqli
2a70: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28  te3_mutex_enter(
2a80: 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20  mem0.mutex);.   
2a90: 20 6e 20 3d 20 6d 61 6c 6c 6f 63 57 69 74 68 41   n = mallocWithA
2aa0: 6c 61 72 6d 28 6e 2c 20 26 70 29 3b 0a 20 20 20  larm(n, &p);.   
2ab0: 20 69 66 28 20 70 20 29 20 73 71 6c 69 74 65 33   if( p ) sqlite3
2ac0: 53 74 61 74 75 73 41 64 64 28 53 51 4c 49 54 45  StatusAdd(SQLITE
2ad0: 5f 53 54 41 54 55 53 5f 50 41 47 45 43 41 43 48  _STATUS_PAGECACH
2ae0: 45 5f 4f 56 45 52 46 4c 4f 57 2c 20 6e 29 3b 0a  E_OVERFLOW, n);.
2af0: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65      sqlite3_mute
2b00: 78 5f 6c 65 61 76 65 28 6d 65 6d 30 2e 6d 75 74  x_leave(mem0.mut
2b10: 65 78 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  ex);.  }else{.  
2b20: 20 20 70 20 3d 20 73 71 6c 69 74 65 33 43 6f 6e    p = sqlite3Con
2b30: 66 69 67 2e 6d 2e 78 4d 61 6c 6c 6f 63 28 6e 29  fig.m.xMalloc(n)
2b40: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70  ;.  }.  return p
2b50: 3b 20 20 20 20 0a 7d 0a 76 6f 69 64 20 73 71 6c  ;    .}.void sql
2b60: 69 74 65 33 50 61 67 65 46 72 65 65 28 76 6f 69  ite3PageFree(voi
2b70: 64 20 2a 70 29 7b 0a 20 20 69 66 28 20 70 20 29  d *p){.  if( p )
2b80: 7b 0a 20 20 20 20 69 66 28 20 73 71 6c 69 74 65  {.    if( sqlite
2b90: 33 43 6f 6e 66 69 67 2e 70 50 61 67 65 3d 3d 30  3Config.pPage==0
2ba0: 0a 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 70  .           || p
2bb0: 3c 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 2e 70  <sqlite3Config.p
2bc0: 50 61 67 65 0a 20 20 20 20 20 20 20 20 20 20 20  Page.           
2bd0: 7c 7c 20 70 3e 3d 28 76 6f 69 64 2a 29 6d 65 6d  || p>=(void*)mem
2be0: 30 2e 61 50 61 67 65 46 72 65 65 20 29 7b 0a 20  0.aPageFree ){. 
2bf0: 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33       if( sqlite3
2c00: 43 6f 6e 66 69 67 2e 62 4d 65 6d 73 74 61 74 20  Config.bMemstat 
2c10: 29 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 69  ){.        int i
2c20: 53 69 7a 65 20 3d 20 73 71 6c 69 74 65 33 4d 61  Size = sqlite3Ma
2c30: 6c 6c 6f 63 53 69 7a 65 28 70 29 3b 0a 20 20 20  llocSize(p);.   
2c40: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74       sqlite3_mut
2c50: 65 78 5f 65 6e 74 65 72 28 6d 65 6d 30 2e 6d 75  ex_enter(mem0.mu
2c60: 74 65 78 29 3b 0a 20 20 20 20 20 20 20 20 73 71  tex);.        sq
2c70: 6c 69 74 65 33 53 74 61 74 75 73 41 64 64 28 53  lite3StatusAdd(S
2c80: 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 50 41 47  QLITE_STATUS_PAG
2c90: 45 43 41 43 48 45 5f 4f 56 45 52 46 4c 4f 57 2c  ECACHE_OVERFLOW,
2ca0: 20 2d 69 53 69 7a 65 29 3b 0a 20 20 20 20 20 20   -iSize);.      
2cb0: 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 41    sqlite3StatusA
2cc0: 64 64 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53  dd(SQLITE_STATUS
2cd0: 5f 4d 45 4d 4f 52 59 5f 55 53 45 44 2c 20 2d 69  _MEMORY_USED, -i
2ce0: 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 20 20 73  Size);.        s
2cf0: 71 6c 69 74 65 33 43 6f 6e 66 69 67 2e 6d 2e 78  qlite3Config.m.x
2d00: 46 72 65 65 28 70 29 3b 0a 20 20 20 20 20 20 20  Free(p);.       
2d10: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c   sqlite3_mutex_l
2d20: 65 61 76 65 28 6d 65 6d 30 2e 6d 75 74 65 78 29  eave(mem0.mutex)
2d30: 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20  ;.      }else{. 
2d40: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 43 6f         sqlite3Co
2d50: 6e 66 69 67 2e 6d 2e 78 46 72 65 65 28 70 29 3b  nfig.m.xFree(p);
2d60: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c  .      }.    }el
2d70: 73 65 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 3b  se{.      int i;
2d80: 0a 20 20 20 20 20 20 69 20 3d 20 70 20 2d 20 73  .      i = p - s
2d90: 71 6c 69 74 65 33 43 6f 6e 66 69 67 2e 70 50 61  qlite3Config.pPa
2da0: 67 65 3b 0a 20 20 20 20 20 20 69 20 2f 3d 20 73  ge;.      i /= s
2db0: 71 6c 69 74 65 33 43 6f 6e 66 69 67 2e 73 7a 50  qlite3Config.szP
2dc0: 61 67 65 3b 0a 20 20 20 20 20 20 61 73 73 65 72  age;.      asser
2dd0: 74 28 20 69 3e 3d 30 20 26 26 20 69 3c 73 71 6c  t( i>=0 && i<sql
2de0: 69 74 65 33 43 6f 6e 66 69 67 2e 6e 50 61 67 65  ite3Config.nPage
2df0: 20 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   );.      sqlite
2e00: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d 65  3_mutex_enter(me
2e10: 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 20  m0.mutex);.     
2e20: 20 61 73 73 65 72 74 28 20 6d 65 6d 30 2e 6e 50   assert( mem0.nP
2e30: 61 67 65 46 72 65 65 3c 73 71 6c 69 74 65 33 43  ageFree<sqlite3C
2e40: 6f 6e 66 69 67 2e 6e 50 61 67 65 20 29 3b 0a 20  onfig.nPage );. 
2e50: 20 20 20 20 20 6d 65 6d 30 2e 61 50 61 67 65 46       mem0.aPageF
2e60: 72 65 65 5b 6d 65 6d 30 2e 6e 50 61 67 65 46 72  ree[mem0.nPageFr
2e70: 65 65 2b 2b 5d 20 3d 20 69 3b 0a 20 20 20 20 20  ee++] = i;.     
2e80: 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 41 64   sqlite3StatusAd
2e90: 64 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f  d(SQLITE_STATUS_
2ea0: 50 41 47 45 43 41 43 48 45 5f 55 53 45 44 2c 20  PAGECACHE_USED, 
2eb0: 2d 31 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74  -1);.      sqlit
2ec0: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d  e3_mutex_leave(m
2ed0: 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20  em0.mutex);.    
2ee0: 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52  }.  }.}../*.** R
2ef0: 65 74 75 72 6e 20 74 68 65 20 73 69 7a 65 20 6f  eturn the size o
2f00: 66 20 61 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63  f a memory alloc
2f10: 61 74 69 6f 6e 20 70 72 65 76 69 6f 75 73 6c 79  ation previously
2f20: 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 0a 2a   obtained from.*
2f30: 2a 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28  * sqlite3Malloc(
2f40: 29 20 6f 72 20 73 71 6c 69 74 65 33 5f 6d 61 6c  ) or sqlite3_mal
2f50: 6c 6f 63 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71  loc()..*/.int sq
2f60: 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28  lite3MallocSize(
2f70: 76 6f 69 64 20 2a 70 29 7b 0a 20 20 72 65 74 75  void *p){.  retu
2f80: 72 6e 20 73 71 6c 69 74 65 33 43 6f 6e 66 69 67  rn sqlite3Config
2f90: 2e 6d 2e 78 53 69 7a 65 28 70 29 3b 0a 7d 0a 0a  .m.xSize(p);.}..
2fa0: 2f 2a 0a 2a 2a 20 46 72 65 65 20 6d 65 6d 6f 72  /*.** Free memor
2fb0: 79 20 70 72 65 76 69 6f 75 73 6c 79 20 6f 62 74  y previously obt
2fc0: 61 69 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74  ained from sqlit
2fd0: 65 33 4d 61 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a 76  e3Malloc()..*/.v
2fe0: 6f 69 64 20 73 71 6c 69 74 65 33 5f 66 72 65 65  oid sqlite3_free
2ff0: 28 76 6f 69 64 20 2a 70 29 7b 0a 20 20 69 66 28  (void *p){.  if(
3000: 20 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a   p==0 ) return;.
3010: 20 20 69 66 28 20 73 71 6c 69 74 65 33 43 6f 6e    if( sqlite3Con
3020: 66 69 67 2e 62 4d 65 6d 73 74 61 74 20 29 7b 0a  fig.bMemstat ){.
3030: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65      sqlite3_mute
3040: 78 5f 65 6e 74 65 72 28 6d 65 6d 30 2e 6d 75 74  x_enter(mem0.mut
3050: 65 78 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  ex);.    sqlite3
3060: 53 74 61 74 75 73 41 64 64 28 53 51 4c 49 54 45  StatusAdd(SQLITE
3070: 5f 53 54 41 54 55 53 5f 4d 45 4d 4f 52 59 5f 55  _STATUS_MEMORY_U
3080: 53 45 44 2c 20 2d 73 71 6c 69 74 65 33 4d 61 6c  SED, -sqlite3Mal
3090: 6c 6f 63 53 69 7a 65 28 70 29 29 3b 0a 20 20 20  locSize(p));.   
30a0: 20 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 2e 6d   sqlite3Config.m
30b0: 2e 78 46 72 65 65 28 70 29 3b 0a 20 20 20 20 73  .xFree(p);.    s
30c0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
30d0: 76 65 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a  ve(mem0.mutex);.
30e0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c    }else{.    sql
30f0: 69 74 65 33 43 6f 6e 66 69 67 2e 6d 2e 78 46 72  ite3Config.m.xFr
3100: 65 65 28 70 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a  ee(p);.  }.}../*
3110: 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 73  .** Change the s
3120: 69 7a 65 20 6f 66 20 61 6e 20 65 78 69 73 74 69  ize of an existi
3130: 6e 67 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61  ng memory alloca
3140: 74 69 6f 6e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71  tion.*/.void *sq
3150: 6c 69 74 65 33 52 65 61 6c 6c 6f 63 28 76 6f 69  lite3Realloc(voi
3160: 64 20 2a 70 4f 6c 64 2c 20 69 6e 74 20 6e 42 79  d *pOld, int nBy
3170: 74 65 73 29 7b 0a 20 20 69 6e 74 20 6e 4f 6c 64  tes){.  int nOld
3180: 2c 20 6e 4e 65 77 3b 0a 20 20 76 6f 69 64 20 2a  , nNew;.  void *
3190: 70 4e 65 77 3b 0a 20 20 69 66 28 20 70 4f 6c 64  pNew;.  if( pOld
31a0: 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72  ==0 ){.    retur
31b0: 6e 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28  n sqlite3Malloc(
31c0: 6e 42 79 74 65 73 29 3b 0a 20 20 7d 0a 20 20 69  nBytes);.  }.  i
31d0: 66 28 20 6e 42 79 74 65 73 3c 3d 30 20 29 7b 0a  f( nBytes<=0 ){.
31e0: 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65      sqlite3_free
31f0: 28 70 4f 6c 64 29 3b 0a 20 20 20 20 72 65 74 75  (pOld);.    retu
3200: 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 6e 4f 6c 64  rn 0;.  }.  nOld
3210: 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63   = sqlite3Malloc
3220: 53 69 7a 65 28 70 4f 6c 64 29 3b 0a 20 20 69 66  Size(pOld);.  if
3230: 28 20 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 2e  ( sqlite3Config.
3240: 62 4d 65 6d 73 74 61 74 20 29 7b 0a 20 20 20 20  bMemstat ){.    
3250: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e  sqlite3_mutex_en
3260: 74 65 72 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b  ter(mem0.mutex);
3270: 0a 20 20 20 20 73 71 6c 69 74 65 33 53 74 61 74  .    sqlite3Stat
3280: 75 73 53 65 74 28 53 51 4c 49 54 45 5f 53 54 41  usSet(SQLITE_STA
3290: 54 55 53 5f 4d 41 4c 4c 4f 43 5f 53 49 5a 45 2c  TUS_MALLOC_SIZE,
32a0: 20 6e 42 79 74 65 73 29 3b 0a 20 20 20 20 6e 4e   nBytes);.    nN
32b0: 65 77 20 3d 20 73 71 6c 69 74 65 33 43 6f 6e 66  ew = sqlite3Conf
32c0: 69 67 2e 6d 2e 78 52 6f 75 6e 64 75 70 28 6e 42  ig.m.xRoundup(nB
32d0: 79 74 65 73 29 3b 0a 20 20 20 20 69 66 28 20 6e  ytes);.    if( n
32e0: 4f 6c 64 3d 3d 6e 4e 65 77 20 29 7b 0a 20 20 20  Old==nNew ){.   
32f0: 20 20 20 70 4e 65 77 20 3d 20 70 4f 6c 64 3b 0a     pNew = pOld;.
3300: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
3310: 20 69 66 28 20 73 71 6c 69 74 65 33 53 74 61 74   if( sqlite3Stat
3320: 75 73 56 61 6c 75 65 28 53 51 4c 49 54 45 5f 53  usValue(SQLITE_S
3330: 54 41 54 55 53 5f 4d 45 4d 4f 52 59 5f 55 53 45  TATUS_MEMORY_USE
3340: 44 29 2b 6e 4e 65 77 2d 6e 4f 6c 64 20 3e 3d 20  D)+nNew-nOld >= 
3350: 0a 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d  .            mem
3360: 30 2e 61 6c 61 72 6d 54 68 72 65 73 68 6f 6c 64  0.alarmThreshold
3370: 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69   ){.        sqli
3380: 74 65 33 4d 61 6c 6c 6f 63 41 6c 61 72 6d 28 6e  te3MallocAlarm(n
3390: 4e 65 77 2d 6e 4f 6c 64 29 3b 0a 20 20 20 20 20  New-nOld);.     
33a0: 20 7d 0a 20 20 20 20 20 20 70 4e 65 77 20 3d 20   }.      pNew = 
33b0: 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 2e 6d 2e  sqlite3Config.m.
33c0: 78 52 65 61 6c 6c 6f 63 28 70 4f 6c 64 2c 20 6e  xRealloc(pOld, n
33d0: 4e 65 77 29 3b 0a 20 20 20 20 20 20 69 66 28 20  New);.      if( 
33e0: 70 4e 65 77 3d 3d 30 20 26 26 20 6d 65 6d 30 2e  pNew==0 && mem0.
33f0: 61 6c 61 72 6d 43 61 6c 6c 62 61 63 6b 20 29 7b  alarmCallback ){
3400: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  .        sqlite3
3410: 4d 61 6c 6c 6f 63 41 6c 61 72 6d 28 6e 42 79 74  MallocAlarm(nByt
3420: 65 73 29 3b 0a 20 20 20 20 20 20 20 20 70 4e 65  es);.        pNe
3430: 77 20 3d 20 73 71 6c 69 74 65 33 43 6f 6e 66 69  w = sqlite3Confi
3440: 67 2e 6d 2e 78 52 65 61 6c 6c 6f 63 28 70 4f 6c  g.m.xRealloc(pOl
3450: 64 2c 20 6e 4e 65 77 29 3b 0a 20 20 20 20 20 20  d, nNew);.      
3460: 7d 0a 20 20 20 20 20 20 69 66 28 20 70 4e 65 77  }.      if( pNew
3470: 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69   ){.        sqli
3480: 74 65 33 53 74 61 74 75 73 41 64 64 28 53 51 4c  te3StatusAdd(SQL
3490: 49 54 45 5f 53 54 41 54 55 53 5f 4d 45 4d 4f 52  ITE_STATUS_MEMOR
34a0: 59 5f 55 53 45 44 2c 20 6e 4e 65 77 2d 6e 4f 6c  Y_USED, nNew-nOl
34b0: 64 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  d);.      }.    
34c0: 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75  }.    sqlite3_mu
34d0: 74 65 78 5f 6c 65 61 76 65 28 6d 65 6d 30 2e 6d  tex_leave(mem0.m
34e0: 75 74 65 78 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a  utex);.  }else{.
34f0: 20 20 20 20 70 4e 65 77 20 3d 20 73 71 6c 69 74      pNew = sqlit
3500: 65 33 43 6f 6e 66 69 67 2e 6d 2e 78 52 65 61 6c  e3Config.m.xReal
3510: 6c 6f 63 28 70 4f 6c 64 2c 20 6e 42 79 74 65 73  loc(pOld, nBytes
3520: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  );.  }.  return 
3530: 70 4e 65 77 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  pNew;.}../*.** T
3540: 68 65 20 70 75 62 6c 69 63 20 69 6e 74 65 72 66  he public interf
3550: 61 63 65 20 74 6f 20 73 71 6c 69 74 65 33 52 65  ace to sqlite3Re
3560: 61 6c 6c 6f 63 2e 20 20 4d 61 6b 65 20 73 75 72  alloc.  Make sur
3570: 65 20 74 68 61 74 20 74 68 65 20 6d 65 6d 6f 72  e that the memor
3580: 79 0a 2a 2a 20 73 75 62 73 79 73 74 65 6d 20 69  y.** subsystem i
3590: 73 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 70 72  s initialized pr
35a0: 69 6f 72 20 74 6f 20 69 6e 76 6f 6b 69 6e 67 20  ior to invoking 
35b0: 73 71 6c 69 74 65 52 65 61 6c 6c 6f 63 2e 0a 2a  sqliteRealloc..*
35c0: 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f  /.void *sqlite3_
35d0: 72 65 61 6c 6c 6f 63 28 76 6f 69 64 20 2a 70 4f  realloc(void *pO
35e0: 6c 64 2c 20 69 6e 74 20 6e 29 7b 0a 23 69 66 6e  ld, int n){.#ifn
35f0: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  def SQLITE_OMIT_
3600: 41 55 54 4f 49 4e 49 54 0a 20 20 69 66 28 20 73  AUTOINIT.  if( s
3610: 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a  qlite3_initializ
3620: 65 28 29 20 29 20 72 65 74 75 72 6e 20 30 3b 0a  e() ) return 0;.
3630: 23 65 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20  #endif.  return 
3640: 73 71 6c 69 74 65 33 52 65 61 6c 6c 6f 63 28 70  sqlite3Realloc(p
3650: 4f 6c 64 2c 20 6e 29 3b 0a 7d 0a 0a 0a 2f 2a 0a  Old, n);.}.../*.
3660: 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 61 6e 64 20  ** Allocate and 
3670: 7a 65 72 6f 20 6d 65 6d 6f 72 79 2e 0a 2a 2f 20  zero memory..*/ 
3680: 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 4d 61  .void *sqlite3Ma
3690: 6c 6c 6f 63 5a 65 72 6f 28 69 6e 74 20 6e 29 7b  llocZero(int n){
36a0: 0a 20 20 76 6f 69 64 20 2a 70 20 3d 20 73 71 6c  .  void *p = sql
36b0: 69 74 65 33 4d 61 6c 6c 6f 63 28 6e 29 3b 0a 20  ite3Malloc(n);. 
36c0: 20 69 66 28 20 70 20 29 7b 0a 20 20 20 20 6d 65   if( p ){.    me
36d0: 6d 73 65 74 28 70 2c 20 30 2c 20 6e 29 3b 0a 20  mset(p, 0, n);. 
36e0: 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d   }.  return p;.}
36f0: 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65  ../*.** Allocate
3700: 20 61 6e 64 20 7a 65 72 6f 20 6d 65 6d 6f 72 79   and zero memory
3710: 2e 20 20 49 66 20 74 68 65 20 61 6c 6c 6f 63 61  .  If the alloca
3720: 74 69 6f 6e 20 66 61 69 6c 73 2c 20 6d 61 6b 65  tion fails, make
3730: 0a 2a 2a 20 74 68 65 20 6d 61 6c 6c 6f 63 46 61  .** the mallocFa
3740: 69 6c 65 64 20 66 6c 61 67 20 69 6e 20 74 68 65  iled flag in the
3750: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 70 6f 69 6e   connection poin
3760: 74 65 72 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71  ter..*/.void *sq
3770: 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 5a 65 72  lite3DbMallocZer
3780: 6f 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69  o(sqlite3 *db, i
3790: 6e 74 20 6e 29 7b 0a 20 20 76 6f 69 64 20 2a 70  nt n){.  void *p
37a0: 20 3d 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c   = sqlite3DbMall
37b0: 6f 63 52 61 77 28 64 62 2c 20 6e 29 3b 0a 20 20  ocRaw(db, n);.  
37c0: 69 66 28 20 70 20 29 7b 0a 20 20 20 20 6d 65 6d  if( p ){.    mem
37d0: 73 65 74 28 70 2c 20 30 2c 20 6e 29 3b 0a 20 20  set(p, 0, n);.  
37e0: 7d 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a  }.  return p;.}.
37f0: 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20  ./*.** Allocate 
3800: 61 6e 64 20 7a 65 72 6f 20 6d 65 6d 6f 72 79 2e  and zero memory.
3810: 20 20 49 66 20 74 68 65 20 61 6c 6c 6f 63 61 74    If the allocat
3820: 69 6f 6e 20 66 61 69 6c 73 2c 20 6d 61 6b 65 0a  ion fails, make.
3830: 2a 2a 20 74 68 65 20 6d 61 6c 6c 6f 63 46 61 69  ** the mallocFai
3840: 6c 65 64 20 66 6c 61 67 20 69 6e 20 74 68 65 20  led flag in the 
3850: 63 6f 6e 6e 65 63 74 69 6f 6e 20 70 6f 69 6e 74  connection point
3860: 65 72 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c  er..*/.void *sql
3870: 69 74 65 33 44 62 4d 61 6c 6c 6f 63 52 61 77 28  ite3DbMallocRaw(
3880: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74  sqlite3 *db, int
3890: 20 6e 29 7b 0a 20 20 76 6f 69 64 20 2a 70 20 3d   n){.  void *p =
38a0: 20 30 3b 0a 20 20 69 66 28 20 21 64 62 20 7c 7c   0;.  if( !db ||
38b0: 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65   db->mallocFaile
38c0: 64 3d 3d 30 20 29 7b 0a 20 20 20 20 70 20 3d 20  d==0 ){.    p = 
38d0: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 6e 29  sqlite3Malloc(n)
38e0: 3b 0a 20 20 20 20 69 66 28 20 21 70 20 26 26 20  ;.    if( !p && 
38f0: 64 62 20 29 7b 0a 20 20 20 20 20 20 64 62 2d 3e  db ){.      db->
3900: 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 3d 20 31  mallocFailed = 1
3910: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65  ;.    }.  }.  re
3920: 74 75 72 6e 20 70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  turn p;.}../*.**
3930: 20 52 65 73 69 7a 65 20 74 68 65 20 62 6c 6f 63   Resize the bloc
3940: 6b 20 6f 66 20 6d 65 6d 6f 72 79 20 70 6f 69 6e  k of memory poin
3950: 74 65 64 20 74 6f 20 62 79 20 70 20 74 6f 20 6e  ted to by p to n
3960: 20 62 79 74 65 73 2e 20 49 66 20 74 68 65 0a 2a   bytes. If the.*
3970: 2a 20 72 65 73 69 7a 65 20 66 61 69 6c 73 2c 20  * resize fails, 
3980: 73 65 74 20 74 68 65 20 6d 61 6c 6c 6f 63 46 61  set the mallocFa
3990: 69 6c 65 64 20 66 6c 61 67 20 69 6e 74 68 65 20  iled flag inthe 
39a0: 63 6f 6e 6e 65 63 74 69 6f 6e 20 6f 62 6a 65 63  connection objec
39b0: 74 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69  t..*/.void *sqli
39c0: 74 65 33 44 62 52 65 61 6c 6c 6f 63 28 73 71 6c  te3DbRealloc(sql
39d0: 69 74 65 33 20 2a 64 62 2c 20 76 6f 69 64 20 2a  ite3 *db, void *
39e0: 70 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 76 6f 69  p, int n){.  voi
39f0: 64 20 2a 70 4e 65 77 20 3d 20 30 3b 0a 20 20 69  d *pNew = 0;.  i
3a00: 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69  f( db->mallocFai
3a10: 6c 65 64 3d 3d 30 20 29 7b 0a 20 20 20 20 70 4e  led==0 ){.    pN
3a20: 65 77 20 3d 20 73 71 6c 69 74 65 33 5f 72 65 61  ew = sqlite3_rea
3a30: 6c 6c 6f 63 28 70 2c 20 6e 29 3b 0a 20 20 20 20  lloc(p, n);.    
3a40: 69 66 28 20 21 70 4e 65 77 20 29 7b 0a 20 20 20  if( !pNew ){.   
3a50: 20 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69     db->mallocFai
3a60: 6c 65 64 20 3d 20 31 3b 0a 20 20 20 20 7d 0a 20  led = 1;.    }. 
3a70: 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 4e 65 77   }.  return pNew
3a80: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 65 6d  ;.}../*.** Attem
3a90: 70 74 20 74 6f 20 72 65 61 6c 6c 6f 63 61 74 65  pt to reallocate
3aa0: 20 70 2e 20 20 49 66 20 74 68 65 20 72 65 61 6c   p.  If the real
3ab0: 6c 6f 63 61 74 69 6f 6e 20 66 61 69 6c 73 2c 20  location fails, 
3ac0: 74 68 65 6e 20 66 72 65 65 20 70 0a 2a 2a 20 61  then free p.** a
3ad0: 6e 64 20 73 65 74 20 74 68 65 20 6d 61 6c 6c 6f  nd set the mallo
3ae0: 63 46 61 69 6c 65 64 20 66 6c 61 67 20 69 6e 20  cFailed flag in 
3af0: 74 68 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e  the database con
3b00: 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64  nection..*/.void
3b10: 20 2a 73 71 6c 69 74 65 33 44 62 52 65 61 6c 6c   *sqlite3DbReall
3b20: 6f 63 4f 72 46 72 65 65 28 73 71 6c 69 74 65 33  ocOrFree(sqlite3
3b30: 20 2a 64 62 2c 20 76 6f 69 64 20 2a 70 2c 20 69   *db, void *p, i
3b40: 6e 74 20 6e 29 7b 0a 20 20 76 6f 69 64 20 2a 70  nt n){.  void *p
3b50: 4e 65 77 3b 0a 20 20 70 4e 65 77 20 3d 20 73 71  New;.  pNew = sq
3b60: 6c 69 74 65 33 44 62 52 65 61 6c 6c 6f 63 28 64  lite3DbRealloc(d
3b70: 62 2c 20 70 2c 20 6e 29 3b 0a 20 20 69 66 28 20  b, p, n);.  if( 
3b80: 21 70 4e 65 77 20 29 7b 0a 20 20 20 20 73 71 6c  !pNew ){.    sql
3b90: 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 20  ite3_free(p);.  
3ba0: 7d 0a 20 20 72 65 74 75 72 6e 20 70 4e 65 77 3b  }.  return pNew;
3bb0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b 65 20 61  .}../*.** Make a
3bc0: 20 63 6f 70 79 20 6f 66 20 61 20 73 74 72 69 6e   copy of a strin
3bd0: 67 20 69 6e 20 6d 65 6d 6f 72 79 20 6f 62 74 61  g in memory obta
3be0: 69 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 65  ined from sqlite
3bf0: 4d 61 6c 6c 6f 63 28 29 2e 20 54 68 65 73 65 20  Malloc(). These 
3c00: 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 73 20 63 61  .** functions ca
3c10: 6c 6c 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63  ll sqlite3Malloc
3c20: 52 61 77 28 29 20 64 69 72 65 63 74 6c 79 20 69  Raw() directly i
3c30: 6e 73 74 65 61 64 20 6f 66 20 73 71 6c 69 74 65  nstead of sqlite
3c40: 4d 61 6c 6c 6f 63 28 29 2e 20 54 68 69 73 0a 2a  Malloc(). This.*
3c50: 2a 20 69 73 20 62 65 63 61 75 73 65 20 77 68 65  * is because whe
3c60: 6e 20 6d 65 6d 6f 72 79 20 64 65 62 75 67 67 69  n memory debuggi
3c70: 6e 67 20 69 73 20 74 75 72 6e 65 64 20 6f 6e 2c  ng is turned on,
3c80: 20 74 68 65 73 65 20 74 77 6f 20 66 75 6e 63 74   these two funct
3c90: 69 6f 6e 73 20 61 72 65 20 0a 2a 2a 20 63 61 6c  ions are .** cal
3ca0: 6c 65 64 20 76 69 61 20 6d 61 63 72 6f 73 20 74  led via macros t
3cb0: 68 61 74 20 72 65 63 6f 72 64 20 74 68 65 20 63  hat record the c
3cc0: 75 72 72 65 6e 74 20 66 69 6c 65 20 61 6e 64 20  urrent file and 
3cd0: 6c 69 6e 65 20 6e 75 6d 62 65 72 20 69 6e 20 74  line number in t
3ce0: 68 65 0a 2a 2a 20 54 68 72 65 61 64 44 61 74 61  he.** ThreadData
3cf0: 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 63   structure..*/.c
3d00: 68 61 72 20 2a 73 71 6c 69 74 65 33 53 74 72 44  har *sqlite3StrD
3d10: 75 70 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  up(const char *z
3d20: 29 7b 0a 20 20 63 68 61 72 20 2a 7a 4e 65 77 3b  ){.  char *zNew;
3d30: 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 69 66 28 20  .  int n;.  if( 
3d40: 7a 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b  z==0 ) return 0;
3d50: 0a 20 20 6e 20 3d 20 73 74 72 6c 65 6e 28 7a 29  .  n = strlen(z)
3d60: 2b 31 3b 0a 20 20 7a 4e 65 77 20 3d 20 73 71 6c  +1;.  zNew = sql
3d70: 69 74 65 33 4d 61 6c 6c 6f 63 28 6e 29 3b 0a 20  ite3Malloc(n);. 
3d80: 20 69 66 28 20 7a 4e 65 77 20 29 20 6d 65 6d 63   if( zNew ) memc
3d90: 70 79 28 7a 4e 65 77 2c 20 7a 2c 20 6e 29 3b 0a  py(zNew, z, n);.
3da0: 20 20 72 65 74 75 72 6e 20 7a 4e 65 77 3b 0a 7d    return zNew;.}
3db0: 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 53 74  .char *sqlite3St
3dc0: 72 4e 44 75 70 28 63 6f 6e 73 74 20 63 68 61 72  rNDup(const char
3dd0: 20 2a 7a 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 63   *z, int n){.  c
3de0: 68 61 72 20 2a 7a 4e 65 77 3b 0a 20 20 69 66 28  har *zNew;.  if(
3df0: 20 7a 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 30   z==0 ) return 0
3e00: 3b 0a 20 20 7a 4e 65 77 20 3d 20 73 71 6c 69 74  ;.  zNew = sqlit
3e10: 65 33 4d 61 6c 6c 6f 63 28 6e 2b 31 29 3b 0a 20  e3Malloc(n+1);. 
3e20: 20 69 66 28 20 7a 4e 65 77 20 29 7b 0a 20 20 20   if( zNew ){.   
3e30: 20 6d 65 6d 63 70 79 28 7a 4e 65 77 2c 20 7a 2c   memcpy(zNew, z,
3e40: 20 6e 29 3b 0a 20 20 20 20 7a 4e 65 77 5b 6e 5d   n);.    zNew[n]
3e50: 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75   = 0;.  }.  retu
3e60: 72 6e 20 7a 4e 65 77 3b 0a 7d 0a 0a 63 68 61 72  rn zNew;.}..char
3e70: 20 2a 73 71 6c 69 74 65 33 44 62 53 74 72 44 75   *sqlite3DbStrDu
3e80: 70 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 63  p(sqlite3 *db, c
3e90: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 29 7b 0a 20  onst char *z){. 
3ea0: 20 63 68 61 72 20 2a 7a 4e 65 77 20 3d 20 73 71   char *zNew = sq
3eb0: 6c 69 74 65 33 53 74 72 44 75 70 28 7a 29 3b 0a  lite3StrDup(z);.
3ec0: 20 20 69 66 28 20 7a 20 26 26 20 21 7a 4e 65 77    if( z && !zNew
3ed0: 20 29 7b 0a 20 20 20 20 64 62 2d 3e 6d 61 6c 6c   ){.    db->mall
3ee0: 6f 63 46 61 69 6c 65 64 20 3d 20 31 3b 0a 20 20  ocFailed = 1;.  
3ef0: 7d 0a 20 20 72 65 74 75 72 6e 20 7a 4e 65 77 3b  }.  return zNew;
3f00: 0a 7d 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33  .}.char *sqlite3
3f10: 44 62 53 74 72 4e 44 75 70 28 73 71 6c 69 74 65  DbStrNDup(sqlite
3f20: 33 20 2a 64 62 2c 20 63 6f 6e 73 74 20 63 68 61  3 *db, const cha
3f30: 72 20 2a 7a 2c 20 69 6e 74 20 6e 29 7b 0a 20 20  r *z, int n){.  
3f40: 63 68 61 72 20 2a 7a 4e 65 77 20 3d 20 73 71 6c  char *zNew = sql
3f50: 69 74 65 33 53 74 72 4e 44 75 70 28 7a 2c 20 6e  ite3StrNDup(z, n
3f60: 29 3b 0a 20 20 69 66 28 20 7a 20 26 26 20 21 7a  );.  if( z && !z
3f70: 4e 65 77 20 29 7b 0a 20 20 20 20 64 62 2d 3e 6d  New ){.    db->m
3f80: 61 6c 6c 6f 63 46 61 69 6c 65 64 20 3d 20 31 3b  allocFailed = 1;
3f90: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 7a 4e  .  }.  return zN
3fa0: 65 77 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65  ew;.}../*.** Cre
3fb0: 61 74 65 20 61 20 73 74 72 69 6e 67 20 66 72 6f  ate a string fro
3fc0: 6d 20 74 68 65 20 32 6e 64 20 61 6e 64 20 73 75  m the 2nd and su
3fd0: 62 73 65 71 75 65 6e 74 20 61 72 67 75 6d 65 6e  bsequent argumen
3fe0: 74 73 20 28 75 70 20 74 6f 20 74 68 65 0a 2a 2a  ts (up to the.**
3ff0: 20 66 69 72 73 74 20 4e 55 4c 4c 20 61 72 67 75   first NULL argu
4000: 6d 65 6e 74 29 2c 20 73 74 6f 72 65 20 74 68 65  ment), store the
4010: 20 73 74 72 69 6e 67 20 69 6e 20 6d 65 6d 6f 72   string in memor
4020: 79 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 0a  y obtained from.
4030: 2a 2a 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28  ** sqliteMalloc(
4040: 29 20 61 6e 64 20 6d 61 6b 65 20 74 68 65 20 70  ) and make the p
4050: 6f 69 6e 74 65 72 20 69 6e 64 69 63 61 74 65 64  ointer indicated
4060: 20 62 79 20 74 68 65 20 31 73 74 20 61 72 67 75   by the 1st argu
4070: 6d 65 6e 74 0a 2a 2a 20 70 6f 69 6e 74 20 74 6f  ment.** point to
4080: 20 74 68 61 74 20 73 74 72 69 6e 67 2e 20 20 54   that string.  T
4090: 68 65 20 31 73 74 20 61 72 67 75 6d 65 6e 74 20  he 1st argument 
40a0: 6d 75 73 74 20 65 69 74 68 65 72 20 62 65 20 4e  must either be N
40b0: 55 4c 4c 20 6f 72 20 0a 2a 2a 20 70 6f 69 6e 74  ULL or .** point
40c0: 20 74 6f 20 6d 65 6d 6f 72 79 20 6f 62 74 61 69   to memory obtai
40d0: 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 65 4d  ned from sqliteM
40e0: 61 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a 76 6f 69 64  alloc()..*/.void
40f0: 20 73 71 6c 69 74 65 33 53 65 74 53 74 72 69 6e   sqlite3SetStrin
4100: 67 28 63 68 61 72 20 2a 2a 70 7a 2c 20 2e 2e 2e  g(char **pz, ...
4110: 29 7b 0a 20 20 76 61 5f 6c 69 73 74 20 61 70 3b  ){.  va_list ap;
4120: 0a 20 20 69 6e 74 20 6e 42 79 74 65 3b 0a 20 20  .  int nByte;.  
4130: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 3b 0a 20  const char *z;. 
4140: 20 63 68 61 72 20 2a 7a 52 65 73 75 6c 74 3b 0a   char *zResult;.
4150: 0a 20 20 61 73 73 65 72 74 28 20 70 7a 21 3d 30  .  assert( pz!=0
4160: 20 29 3b 0a 20 20 6e 42 79 74 65 20 3d 20 31 3b   );.  nByte = 1;
4170: 0a 20 20 76 61 5f 73 74 61 72 74 28 61 70 2c 20  .  va_start(ap, 
4180: 70 7a 29 3b 0a 20 20 77 68 69 6c 65 28 20 28 7a  pz);.  while( (z
4190: 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 63 6f   = va_arg(ap, co
41a0: 6e 73 74 20 63 68 61 72 2a 29 29 21 3d 30 20 29  nst char*))!=0 )
41b0: 7b 0a 20 20 20 20 6e 42 79 74 65 20 2b 3d 20 73  {.    nByte += s
41c0: 74 72 6c 65 6e 28 7a 29 3b 0a 20 20 7d 0a 20 20  trlen(z);.  }.  
41d0: 76 61 5f 65 6e 64 28 61 70 29 3b 0a 20 20 73 71  va_end(ap);.  sq
41e0: 6c 69 74 65 33 5f 66 72 65 65 28 2a 70 7a 29 3b  lite3_free(*pz);
41f0: 0a 20 20 2a 70 7a 20 3d 20 7a 52 65 73 75 6c 74  .  *pz = zResult
4200: 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63   = sqlite3Malloc
4210: 28 6e 42 79 74 65 29 3b 0a 20 20 69 66 28 20 7a  (nByte);.  if( z
4220: 52 65 73 75 6c 74 3d 3d 30 20 29 7b 0a 20 20 20  Result==0 ){.   
4230: 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 2a   return;.  }.  *
4240: 7a 52 65 73 75 6c 74 20 3d 20 30 3b 0a 20 20 76  zResult = 0;.  v
4250: 61 5f 73 74 61 72 74 28 61 70 2c 20 70 7a 29 3b  a_start(ap, pz);
4260: 0a 20 20 77 68 69 6c 65 28 20 28 7a 20 3d 20 76  .  while( (z = v
4270: 61 5f 61 72 67 28 61 70 2c 20 63 6f 6e 73 74 20  a_arg(ap, const 
4280: 63 68 61 72 2a 29 29 21 3d 30 20 29 7b 0a 20 20  char*))!=0 ){.  
4290: 20 20 69 6e 74 20 6e 20 3d 20 73 74 72 6c 65 6e    int n = strlen
42a0: 28 7a 29 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28  (z);.    memcpy(
42b0: 7a 52 65 73 75 6c 74 2c 20 7a 2c 20 6e 29 3b 0a  zResult, z, n);.
42c0: 20 20 20 20 7a 52 65 73 75 6c 74 20 2b 3d 20 6e      zResult += n
42d0: 3b 0a 20 20 7d 0a 20 20 7a 52 65 73 75 6c 74 5b  ;.  }.  zResult[
42e0: 30 5d 20 3d 20 30 3b 0a 20 20 76 61 5f 65 6e 64  0] = 0;.  va_end
42f0: 28 61 70 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20  (ap);.}.../*.** 
4300: 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6d 75  This function mu
4310: 73 74 20 62 65 20 63 61 6c 6c 65 64 20 62 65 66  st be called bef
4320: 6f 72 65 20 65 78 69 74 69 6e 67 20 61 6e 79 20  ore exiting any 
4330: 41 50 49 20 66 75 6e 63 74 69 6f 6e 20 28 69 2e  API function (i.
4340: 65 2e 20 0a 2a 2a 20 72 65 74 75 72 6e 69 6e 67  e. .** returning
4350: 20 63 6f 6e 74 72 6f 6c 20 74 6f 20 74 68 65 20   control to the 
4360: 75 73 65 72 29 20 74 68 61 74 20 68 61 73 20 63  user) that has c
4370: 61 6c 6c 65 64 20 73 71 6c 69 74 65 33 5f 6d 61  alled sqlite3_ma
4380: 6c 6c 6f 63 20 6f 72 0a 2a 2a 20 73 71 6c 69 74  lloc or.** sqlit
4390: 65 33 5f 72 65 61 6c 6c 6f 63 2e 0a 2a 2a 0a 2a  e3_realloc..**.*
43a0: 2a 20 54 68 65 20 72 65 74 75 72 6e 65 64 20 76  * The returned v
43b0: 61 6c 75 65 20 69 73 20 6e 6f 72 6d 61 6c 6c 79  alue is normally
43c0: 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 73   a copy of the s
43d0: 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 74  econd argument t
43e0: 6f 20 74 68 69 73 0a 2a 2a 20 66 75 6e 63 74 69  o this.** functi
43f0: 6f 6e 2e 20 48 6f 77 65 76 65 72 2c 20 69 66 20  on. However, if 
4400: 61 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 75  a malloc() failu
4410: 72 65 20 68 61 73 20 6f 63 63 75 72 65 64 20 73  re has occured s
4420: 69 6e 63 65 20 74 68 65 20 70 72 65 76 69 6f 75  ince the previou
4430: 73 0a 2a 2a 20 69 6e 76 6f 63 61 74 69 6f 6e 20  s.** invocation 
4440: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 69 73 20  SQLITE_NOMEM is 
4450: 72 65 74 75 72 6e 65 64 20 69 6e 73 74 65 61 64  returned instead
4460: 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20  . .**.** If the 
4470: 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 2c 20  first argument, 
4480: 64 62 2c 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 20  db, is not NULL 
4490: 61 6e 64 20 61 20 6d 61 6c 6c 6f 63 28 29 20 65  and a malloc() e
44a0: 72 72 6f 72 20 68 61 73 20 6f 63 63 75 72 65 64  rror has occured
44b0: 2c 0a 2a 2a 20 74 68 65 6e 20 74 68 65 20 63 6f  ,.** then the co
44c0: 6e 6e 65 63 74 69 6f 6e 20 65 72 72 6f 72 2d 63  nnection error-c
44d0: 6f 64 65 20 28 74 68 65 20 76 61 6c 75 65 20 72  ode (the value r
44e0: 65 74 75 72 6e 65 64 20 62 79 20 73 71 6c 69 74  eturned by sqlit
44f0: 65 33 5f 65 72 72 63 6f 64 65 28 29 29 0a 2a 2a  e3_errcode()).**
4500: 20 69 73 20 73 65 74 20 74 6f 20 53 51 4c 49 54   is set to SQLIT
4510: 45 5f 4e 4f 4d 45 4d 2e 0a 2a 2f 0a 69 6e 74 20  E_NOMEM..*/.int 
4520: 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 73  sqlite3ApiExit(s
4530: 71 6c 69 74 65 33 2a 20 64 62 2c 20 69 6e 74 20  qlite3* db, int 
4540: 72 63 29 7b 0a 20 20 2f 2a 20 49 66 20 74 68 65  rc){.  /* If the
4550: 20 64 62 20 68 61 6e 64 6c 65 20 69 73 20 6e 6f   db handle is no
4560: 74 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 77 65 20  t NULL, then we 
4570: 6d 75 73 74 20 68 6f 6c 64 20 74 68 65 20 63 6f  must hold the co
4580: 6e 6e 65 63 74 69 6f 6e 20 68 61 6e 64 6c 65 0a  nnection handle.
4590: 20 20 2a 2a 20 6d 75 74 65 78 20 68 65 72 65 2e    ** mutex here.
45a0: 20 4f 74 68 65 72 77 69 73 65 20 74 68 65 20 72   Otherwise the r
45b0: 65 61 64 20 28 61 6e 64 20 70 6f 73 73 69 62 6c  ead (and possibl
45c0: 65 20 77 72 69 74 65 29 20 6f 66 20 64 62 2d 3e  e write) of db->
45d0: 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 0a 20 20  mallocFailed .  
45e0: 2a 2a 20 69 73 20 75 6e 73 61 66 65 2c 20 61 73  ** is unsafe, as
45f0: 20 69 73 20 74 68 65 20 63 61 6c 6c 20 74 6f 20   is the call to 
4600: 73 71 6c 69 74 65 33 45 72 72 6f 72 28 29 2e 0a  sqlite3Error()..
4610: 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 21    */.  assert( !
4620: 64 62 20 7c 7c 20 73 71 6c 69 74 65 33 5f 6d 75  db || sqlite3_mu
4630: 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74  tex_held(db->mut
4640: 65 78 29 20 29 3b 0a 20 20 69 66 28 20 64 62 20  ex) );.  if( db 
4650: 26 26 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69  && db->mallocFai
4660: 6c 65 64 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  led ){.    sqlit
4670: 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49  e3Error(db, SQLI
4680: 54 45 5f 4e 4f 4d 45 4d 2c 20 30 29 3b 0a 20 20  TE_NOMEM, 0);.  
4690: 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c    db->mallocFail
46a0: 65 64 20 3d 20 30 3b 0a 20 20 20 20 72 63 20 3d  ed = 0;.    rc =
46b0: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20   SQLITE_NOMEM;. 
46c0: 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 20 26   }.  return rc &
46d0: 20 28 64 62 20 3f 20 64 62 2d 3e 65 72 72 4d 61   (db ? db->errMa
46e0: 73 6b 20 3a 20 30 78 66 66 29 3b 0a 7d 0a        sk : 0xff);.}.