/ Hex Artifact Content
Login

Artifact 9d7dc6a52aa13ba3639eb40c573dd7adb3a16813:


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 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71  .*/.#include "sq
01c0: 6c 69 74 65 49 6e 74 2e 68 22 0a 23 69 6e 63 6c  liteInt.h".#incl
01d0: 75 64 65 20 3c 73 74 64 61 72 67 2e 68 3e 0a 0a  ude <stdarg.h>..
01e0: 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69  /*.** This routi
01f0: 6e 65 20 72 75 6e 73 20 77 68 65 6e 20 74 68 65  ne runs when the
0200: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f   memory allocato
0210: 72 20 73 65 65 73 20 74 68 61 74 20 74 68 65 0a  r sees that the.
0220: 2a 2a 20 74 6f 74 61 6c 20 6d 65 6d 6f 72 79 20  ** total memory 
0230: 61 6c 6c 6f 63 61 74 69 6f 6e 20 69 73 20 61 62  allocation is ab
0240: 6f 75 74 20 74 6f 20 65 78 63 65 65 64 20 74 68  out to exceed th
0250: 65 20 73 6f 66 74 20 68 65 61 70 0a 2a 2a 20 6c  e soft heap.** l
0260: 69 6d 69 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  imit..*/.static 
0270: 76 6f 69 64 20 73 6f 66 74 48 65 61 70 4c 69 6d  void softHeapLim
0280: 69 74 45 6e 66 6f 72 63 65 72 28 0a 20 20 76 6f  itEnforcer(.  vo
0290: 69 64 20 2a 4e 6f 74 55 73 65 64 2c 20 0a 20 20  id *NotUsed, .  
02a0: 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 4e 6f  sqlite3_int64 No
02b0: 74 55 73 65 64 32 2c 0a 20 20 69 6e 74 20 61 6c  tUsed2,.  int al
02c0: 6c 6f 63 53 69 7a 65 0a 29 7b 0a 20 20 55 4e 55  locSize.){.  UNU
02d0: 53 45 44 5f 50 41 52 41 4d 45 54 45 52 32 28 4e  SED_PARAMETER2(N
02e0: 6f 74 55 73 65 64 2c 20 4e 6f 74 55 73 65 64 32  otUsed, NotUsed2
02f0: 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 72 65 6c  );.  sqlite3_rel
0300: 65 61 73 65 5f 6d 65 6d 6f 72 79 28 61 6c 6c 6f  ease_memory(allo
0310: 63 53 69 7a 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  cSize);.}../*.**
0320: 20 53 65 74 20 74 68 65 20 73 6f 66 74 20 68 65   Set the soft he
0330: 61 70 2d 73 69 7a 65 20 6c 69 6d 69 74 20 66 6f  ap-size limit fo
0340: 72 20 74 68 65 20 6c 69 62 72 61 72 79 2e 20 50  r the library. P
0350: 61 73 73 69 6e 67 20 61 20 7a 65 72 6f 20 6f 72  assing a zero or
0360: 20 0a 2a 2a 20 6e 65 67 61 74 69 76 65 20 76 61   .** negative va
0370: 6c 75 65 20 69 6e 64 69 63 61 74 65 73 20 6e 6f  lue indicates no
0380: 20 6c 69 6d 69 74 2e 0a 2a 2f 0a 76 6f 69 64 20   limit..*/.void 
0390: 73 71 6c 69 74 65 33 5f 73 6f 66 74 5f 68 65 61  sqlite3_soft_hea
03a0: 70 5f 6c 69 6d 69 74 28 69 6e 74 20 6e 29 7b 0a  p_limit(int n){.
03b0: 20 20 73 71 6c 69 74 65 33 5f 75 69 6e 74 36 34    sqlite3_uint64
03c0: 20 69 4c 69 6d 69 74 3b 0a 20 20 69 6e 74 20 6f   iLimit;.  int o
03d0: 76 65 72 61 67 65 3b 0a 20 20 69 66 28 20 6e 3c  verage;.  if( n<
03e0: 30 20 29 7b 0a 20 20 20 20 69 4c 69 6d 69 74 20  0 ){.    iLimit 
03f0: 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  = 0;.  }else{.  
0400: 20 20 69 4c 69 6d 69 74 20 3d 20 6e 3b 0a 20 20    iLimit = n;.  
0410: 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45  }.#ifndef SQLITE
0420: 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e 49 54 0a 20  _OMIT_AUTOINIT. 
0430: 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c   sqlite3_initial
0440: 69 7a 65 28 29 3b 0a 23 65 6e 64 69 66 0a 20 20  ize();.#endif.  
0450: 69 66 28 20 69 4c 69 6d 69 74 3e 30 20 29 7b 0a  if( iLimit>0 ){.
0460: 20 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 6f 72      sqlite3Memor
0470: 79 41 6c 61 72 6d 28 73 6f 66 74 48 65 61 70 4c  yAlarm(softHeapL
0480: 69 6d 69 74 45 6e 66 6f 72 63 65 72 2c 20 30 2c  imitEnforcer, 0,
0490: 20 69 4c 69 6d 69 74 29 3b 0a 20 20 7d 65 6c 73   iLimit);.  }els
04a0: 65 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 4d 65  e{.    sqlite3Me
04b0: 6d 6f 72 79 41 6c 61 72 6d 28 30 2c 20 30 2c 20  moryAlarm(0, 0, 
04c0: 30 29 3b 0a 20 20 7d 0a 20 20 6f 76 65 72 61 67  0);.  }.  overag
04d0: 65 20 3d 20 28 69 6e 74 29 28 73 71 6c 69 74 65  e = (int)(sqlite
04e0: 33 5f 6d 65 6d 6f 72 79 5f 75 73 65 64 28 29 20  3_memory_used() 
04f0: 2d 20 28 69 36 34 29 6e 29 3b 0a 20 20 69 66 28  - (i64)n);.  if(
0500: 20 6f 76 65 72 61 67 65 3e 30 20 29 7b 0a 20 20   overage>0 ){.  
0510: 20 20 73 71 6c 69 74 65 33 5f 72 65 6c 65 61 73    sqlite3_releas
0520: 65 5f 6d 65 6d 6f 72 79 28 6f 76 65 72 61 67 65  e_memory(overage
0530: 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  );.  }.}../*.** 
0540: 41 74 74 65 6d 70 74 20 74 6f 20 72 65 6c 65 61  Attempt to relea
0550: 73 65 20 75 70 20 74 6f 20 6e 20 62 79 74 65 73  se up to n bytes
0560: 20 6f 66 20 6e 6f 6e 2d 65 73 73 65 6e 74 69 61   of non-essentia
0570: 6c 20 6d 65 6d 6f 72 79 20 63 75 72 72 65 6e 74  l memory current
0580: 6c 79 0a 2a 2a 20 68 65 6c 64 20 62 79 20 53 51  ly.** held by SQ
0590: 4c 69 74 65 2e 20 41 6e 20 65 78 61 6d 70 6c 65  Lite. An example
05a0: 20 6f 66 20 6e 6f 6e 2d 65 73 73 65 6e 74 69 61   of non-essentia
05b0: 6c 20 6d 65 6d 6f 72 79 20 69 73 20 6d 65 6d 6f  l memory is memo
05c0: 72 79 20 75 73 65 64 20 74 6f 0a 2a 2a 20 63 61  ry used to.** ca
05d0: 63 68 65 20 64 61 74 61 62 61 73 65 20 70 61 67  che database pag
05e0: 65 73 20 74 68 61 74 20 61 72 65 20 6e 6f 74 20  es that are not 
05f0: 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 75 73 65  currently in use
0600: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
0610: 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f 72 79 28  _release_memory(
0620: 69 6e 74 20 6e 29 7b 0a 23 69 66 64 65 66 20 53  int n){.#ifdef S
0630: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d  QLITE_ENABLE_MEM
0640: 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 20  ORY_MANAGEMENT. 
0650: 20 69 6e 74 20 6e 52 65 74 20 3d 20 30 3b 0a 20   int nRet = 0;. 
0660: 20 6e 52 65 74 20 2b 3d 20 73 71 6c 69 74 65 33   nRet += sqlite3
0670: 50 63 61 63 68 65 52 65 6c 65 61 73 65 4d 65 6d  PcacheReleaseMem
0680: 6f 72 79 28 6e 2d 6e 52 65 74 29 3b 0a 20 20 72  ory(n-nRet);.  r
0690: 65 74 75 72 6e 20 6e 52 65 74 3b 0a 23 65 6c 73  eturn nRet;.#els
06a0: 65 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d  e.  UNUSED_PARAM
06b0: 45 54 45 52 28 6e 29 3b 0a 20 20 72 65 74 75 72  ETER(n);.  retur
06c0: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 23 65 6e  n SQLITE_OK;.#en
06d0: 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 74 61  dif.}../*.** Sta
06e0: 74 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6c  te information l
06f0: 6f 63 61 6c 20 74 6f 20 74 68 65 20 6d 65 6d 6f  ocal to the memo
0700: 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 73 75  ry allocation su
0710: 62 73 79 73 74 65 6d 2e 0a 2a 2f 0a 73 74 61 74  bsystem..*/.stat
0720: 69 63 20 53 51 4c 49 54 45 5f 57 53 44 20 73 74  ic SQLITE_WSD st
0730: 72 75 63 74 20 4d 65 6d 30 47 6c 6f 62 61 6c 20  ruct Mem0Global 
0740: 7b 0a 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66  {.  /* Number of
0750: 20 66 72 65 65 20 70 61 67 65 73 20 66 6f 72 20   free pages for 
0760: 73 63 72 61 74 63 68 20 61 6e 64 20 70 61 67 65  scratch and page
0770: 2d 63 61 63 68 65 20 6d 65 6d 6f 72 79 20 2a 2f  -cache memory */
0780: 0a 20 20 75 33 32 20 6e 53 63 72 61 74 63 68 46  .  u32 nScratchF
0790: 72 65 65 3b 0a 20 20 75 33 32 20 6e 50 61 67 65  ree;.  u32 nPage
07a0: 46 72 65 65 3b 0a 0a 20 20 73 71 6c 69 74 65 33  Free;..  sqlite3
07b0: 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 3b 20 20  _mutex *mutex;  
07c0: 20 20 20 20 20 20 20 2f 2a 20 4d 75 74 65 78 20         /* Mutex 
07d0: 74 6f 20 73 65 72 69 61 6c 69 7a 65 20 61 63 63  to serialize acc
07e0: 65 73 73 20 2a 2f 0a 0a 20 20 2f 2a 0a 20 20 2a  ess */..  /*.  *
07f0: 2a 20 54 68 65 20 61 6c 61 72 6d 20 63 61 6c 6c  * The alarm call
0800: 62 61 63 6b 20 61 6e 64 20 69 74 73 20 61 72 67  back and its arg
0810: 75 6d 65 6e 74 73 2e 20 20 54 68 65 20 6d 65 6d  uments.  The mem
0820: 30 2e 6d 75 74 65 78 20 6c 6f 63 6b 20 77 69 6c  0.mutex lock wil
0830: 6c 0a 20 20 2a 2a 20 62 65 20 68 65 6c 64 20 77  l.  ** be held w
0840: 68 69 6c 65 20 74 68 65 20 63 61 6c 6c 62 61 63  hile the callbac
0850: 6b 20 69 73 20 72 75 6e 6e 69 6e 67 2e 20 20 52  k is running.  R
0860: 65 63 75 72 73 69 76 65 20 63 61 6c 6c 73 20 69  ecursive calls i
0870: 6e 74 6f 0a 20 20 2a 2a 20 74 68 65 20 6d 65 6d  nto.  ** the mem
0880: 6f 72 79 20 73 75 62 73 79 73 74 65 6d 20 61 72  ory subsystem ar
0890: 65 20 61 6c 6c 6f 77 65 64 2c 20 62 75 74 20 6e  e allowed, but n
08a0: 6f 20 6e 65 77 20 63 61 6c 6c 62 61 63 6b 73 20  o new callbacks 
08b0: 77 69 6c 6c 20 62 65 0a 20 20 2a 2a 20 69 73 73  will be.  ** iss
08c0: 75 65 64 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69  ued..  */.  sqli
08d0: 74 65 33 5f 69 6e 74 36 34 20 61 6c 61 72 6d 54  te3_int64 alarmT
08e0: 68 72 65 73 68 6f 6c 64 3b 0a 20 20 76 6f 69 64  hreshold;.  void
08f0: 20 28 2a 61 6c 61 72 6d 43 61 6c 6c 62 61 63 6b   (*alarmCallback
0900: 29 28 76 6f 69 64 2a 2c 20 73 71 6c 69 74 65 33  )(void*, sqlite3
0910: 5f 69 6e 74 36 34 2c 69 6e 74 29 3b 0a 20 20 76  _int64,int);.  v
0920: 6f 69 64 20 2a 61 6c 61 72 6d 41 72 67 3b 0a 0a  oid *alarmArg;..
0930: 20 20 2f 2a 0a 20 20 2a 2a 20 50 6f 69 6e 74 65    /*.  ** Pointe
0940: 72 73 20 74 6f 20 74 68 65 20 65 6e 64 20 6f 66  rs to the end of
0950: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f   sqlite3GlobalCo
0960: 6e 66 69 67 2e 70 53 63 72 61 74 63 68 20 61 6e  nfig.pScratch an
0970: 64 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33 47 6c  d.  ** sqlite3Gl
0980: 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65  obalConfig.pPage
0990: 20 74 6f 20 61 20 62 6c 6f 63 6b 20 6f 66 20 6d   to a block of m
09a0: 65 6d 6f 72 79 20 74 68 61 74 20 72 65 63 6f 72  emory that recor
09b0: 64 73 0a 20 20 2a 2a 20 77 68 69 63 68 20 70 61  ds.  ** which pa
09c0: 67 65 73 20 61 72 65 20 61 76 61 69 6c 61 62 6c  ges are availabl
09d0: 65 2e 0a 20 20 2a 2f 0a 20 20 75 33 32 20 2a 61  e..  */.  u32 *a
09e0: 53 63 72 61 74 63 68 46 72 65 65 3b 0a 20 20 75  ScratchFree;.  u
09f0: 33 32 20 2a 61 50 61 67 65 46 72 65 65 3b 0a 7d  32 *aPageFree;.}
0a00: 20 6d 65 6d 30 20 3d 20 7b 20 30 2c 20 30 2c 20   mem0 = { 0, 0, 
0a10: 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30  0, 0, 0, 0, 0, 0
0a20: 20 7d 3b 0a 0a 23 64 65 66 69 6e 65 20 6d 65 6d   };..#define mem
0a30: 30 20 47 4c 4f 42 41 4c 28 73 74 72 75 63 74 20  0 GLOBAL(struct 
0a40: 4d 65 6d 30 47 6c 6f 62 61 6c 2c 20 6d 65 6d 30  Mem0Global, mem0
0a50: 29 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 69 61 6c  )../*.** Initial
0a60: 69 7a 65 20 74 68 65 20 6d 65 6d 6f 72 79 20 61  ize the memory a
0a70: 6c 6c 6f 63 61 74 69 6f 6e 20 73 75 62 73 79 73  llocation subsys
0a80: 74 65 6d 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  tem..*/.int sqli
0a90: 74 65 33 4d 61 6c 6c 6f 63 49 6e 69 74 28 76 6f  te3MallocInit(vo
0aa0: 69 64 29 7b 0a 20 20 69 66 28 20 73 71 6c 69 74  id){.  if( sqlit
0ab0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d  e3GlobalConfig.m
0ac0: 2e 78 4d 61 6c 6c 6f 63 3d 3d 30 20 29 7b 0a 20  .xMalloc==0 ){. 
0ad0: 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 53 65 74     sqlite3MemSet
0ae0: 44 65 66 61 75 6c 74 28 29 3b 0a 20 20 7d 0a 20  Default();.  }. 
0af0: 20 6d 65 6d 73 65 74 28 26 6d 65 6d 30 2c 20 30   memset(&mem0, 0
0b00: 2c 20 73 69 7a 65 6f 66 28 6d 65 6d 30 29 29 3b  , sizeof(mem0));
0b10: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c  .  if( sqlite3Gl
0b20: 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65  obalConfig.bCore
0b30: 4d 75 74 65 78 20 29 7b 0a 20 20 20 20 6d 65 6d  Mutex ){.    mem
0b40: 30 2e 6d 75 74 65 78 20 3d 20 73 71 6c 69 74 65  0.mutex = sqlite
0b50: 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49  3MutexAlloc(SQLI
0b60: 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f  TE_MUTEX_STATIC_
0b70: 4d 45 4d 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20  MEM);.  }.  if( 
0b80: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
0b90: 66 69 67 2e 70 53 63 72 61 74 63 68 20 26 26 20  fig.pScratch && 
0ba0: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
0bb0: 66 69 67 2e 73 7a 53 63 72 61 74 63 68 3e 3d 31  fig.szScratch>=1
0bc0: 30 30 0a 20 20 20 20 20 20 26 26 20 73 71 6c 69  00.      && sqli
0bd0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e  te3GlobalConfig.
0be0: 6e 53 63 72 61 74 63 68 3e 3d 30 20 29 7b 0a 20  nScratch>=0 ){. 
0bf0: 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 73 71     int i;.    sq
0c00: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69  lite3GlobalConfi
0c10: 67 2e 73 7a 53 63 72 61 74 63 68 20 3d 20 52 4f  g.szScratch = RO
0c20: 55 4e 44 44 4f 57 4e 38 28 73 71 6c 69 74 65 33  UNDDOWN8(sqlite3
0c30: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 53  GlobalConfig.szS
0c40: 63 72 61 74 63 68 2d 34 29 3b 0a 20 20 20 20 6d  cratch-4);.    m
0c50: 65 6d 30 2e 61 53 63 72 61 74 63 68 46 72 65 65  em0.aScratchFree
0c60: 20 3d 20 28 75 33 32 2a 29 26 28 28 63 68 61 72   = (u32*)&((char
0c70: 2a 29 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43  *)sqlite3GlobalC
0c80: 6f 6e 66 69 67 2e 70 53 63 72 61 74 63 68 29 0a  onfig.pScratch).
0c90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0ca0: 20 20 5b 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c    [sqlite3Global
0cb0: 43 6f 6e 66 69 67 2e 73 7a 53 63 72 61 74 63 68  Config.szScratch
0cc0: 2a 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f  *sqlite3GlobalCo
0cd0: 6e 66 69 67 2e 6e 53 63 72 61 74 63 68 5d 3b 0a  nfig.nScratch];.
0ce0: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 73      for(i=0; i<s
0cf0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66  qlite3GlobalConf
0d00: 69 67 2e 6e 53 63 72 61 74 63 68 3b 20 69 2b 2b  ig.nScratch; i++
0d10: 29 7b 20 6d 65 6d 30 2e 61 53 63 72 61 74 63 68  ){ mem0.aScratch
0d20: 46 72 65 65 5b 69 5d 20 3d 20 69 3b 20 7d 0a 20  Free[i] = i; }. 
0d30: 20 20 20 6d 65 6d 30 2e 6e 53 63 72 61 74 63 68     mem0.nScratch
0d40: 46 72 65 65 20 3d 20 73 71 6c 69 74 65 33 47 6c  Free = sqlite3Gl
0d50: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 53 63 72 61  obalConfig.nScra
0d60: 74 63 68 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  tch;.  }else{.  
0d70: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43    sqlite3GlobalC
0d80: 6f 6e 66 69 67 2e 70 53 63 72 61 74 63 68 20 3d  onfig.pScratch =
0d90: 20 30 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 47   0;.    sqlite3G
0da0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 53 63  lobalConfig.szSc
0db0: 72 61 74 63 68 20 3d 20 30 3b 0a 20 20 7d 0a 20  ratch = 0;.  }. 
0dc0: 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62   if( sqlite3Glob
0dd0: 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65 20 26  alConfig.pPage &
0de0: 26 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43  & sqlite3GlobalC
0df0: 6f 6e 66 69 67 2e 73 7a 50 61 67 65 3e 3d 35 31  onfig.szPage>=51
0e00: 32 0a 20 20 20 20 20 20 26 26 20 73 71 6c 69 74  2.      && sqlit
0e10: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e  e3GlobalConfig.n
0e20: 50 61 67 65 3e 3d 31 20 29 7b 0a 20 20 20 20 69  Page>=1 ){.    i
0e30: 6e 74 20 69 3b 0a 20 20 20 20 69 6e 74 20 6f 76  nt i;.    int ov
0e40: 65 72 68 65 61 64 3b 0a 20 20 20 20 69 6e 74 20  erhead;.    int 
0e50: 73 7a 20 3d 20 52 4f 55 4e 44 44 4f 57 4e 38 28  sz = ROUNDDOWN8(
0e60: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
0e70: 66 69 67 2e 73 7a 50 61 67 65 29 3b 0a 20 20 20  fig.szPage);.   
0e80: 20 69 6e 74 20 6e 20 3d 20 73 71 6c 69 74 65 33   int n = sqlite3
0e90: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 50 61  GlobalConfig.nPa
0ea0: 67 65 3b 0a 20 20 20 20 6f 76 65 72 68 65 61 64  ge;.    overhead
0eb0: 20 3d 20 28 34 2a 6e 20 2b 20 73 7a 20 2d 20 31   = (4*n + sz - 1
0ec0: 29 2f 73 7a 3b 0a 20 20 20 20 73 71 6c 69 74 65  )/sz;.    sqlite
0ed0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 50  3GlobalConfig.nP
0ee0: 61 67 65 20 2d 3d 20 6f 76 65 72 68 65 61 64 3b  age -= overhead;
0ef0: 0a 20 20 20 20 6d 65 6d 30 2e 61 50 61 67 65 46  .    mem0.aPageF
0f00: 72 65 65 20 3d 20 28 75 33 32 2a 29 26 28 28 63  ree = (u32*)&((c
0f10: 68 61 72 2a 29 73 71 6c 69 74 65 33 47 6c 6f 62  har*)sqlite3Glob
0f20: 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65 29 0a  alConfig.pPage).
0f30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0f40: 20 20 5b 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c    [sqlite3Global
0f50: 43 6f 6e 66 69 67 2e 73 7a 50 61 67 65 2a 73 71  Config.szPage*sq
0f60: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69  lite3GlobalConfi
0f70: 67 2e 6e 50 61 67 65 5d 3b 0a 20 20 20 20 66 6f  g.nPage];.    fo
0f80: 72 28 69 3d 30 3b 20 69 3c 73 71 6c 69 74 65 33  r(i=0; i<sqlite3
0f90: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 50 61  GlobalConfig.nPa
0fa0: 67 65 3b 20 69 2b 2b 29 7b 20 6d 65 6d 30 2e 61  ge; i++){ mem0.a
0fb0: 50 61 67 65 46 72 65 65 5b 69 5d 20 3d 20 69 3b  PageFree[i] = i;
0fc0: 20 7d 0a 20 20 20 20 6d 65 6d 30 2e 6e 50 61 67   }.    mem0.nPag
0fd0: 65 46 72 65 65 20 3d 20 73 71 6c 69 74 65 33 47  eFree = sqlite3G
0fe0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 50 61 67  lobalConfig.nPag
0ff0: 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  e;.  }else{.    
1000: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
1010: 66 69 67 2e 70 50 61 67 65 20 3d 20 30 3b 0a 20  fig.pPage = 0;. 
1020: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c     sqlite3Global
1030: 43 6f 6e 66 69 67 2e 73 7a 50 61 67 65 20 3d 20  Config.szPage = 
1040: 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  0;.  }.  return 
1050: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
1060: 66 69 67 2e 6d 2e 78 49 6e 69 74 28 73 71 6c 69  fig.m.xInit(sqli
1070: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e  te3GlobalConfig.
1080: 6d 2e 70 41 70 70 44 61 74 61 29 3b 0a 7d 0a 0a  m.pAppData);.}..
1090: 2f 2a 0a 2a 2a 20 44 65 69 6e 69 74 69 61 6c 69  /*.** Deinitiali
10a0: 7a 65 20 74 68 65 20 6d 65 6d 6f 72 79 20 61 6c  ze the memory al
10b0: 6c 6f 63 61 74 69 6f 6e 20 73 75 62 73 79 73 74  location subsyst
10c0: 65 6d 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  em..*/.void sqli
10d0: 74 65 33 4d 61 6c 6c 6f 63 45 6e 64 28 76 6f 69  te3MallocEnd(voi
10e0: 64 29 7b 0a 20 20 69 66 28 20 73 71 6c 69 74 65  d){.  if( sqlite
10f0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e  3GlobalConfig.m.
1100: 78 53 68 75 74 64 6f 77 6e 20 29 7b 0a 20 20 20  xShutdown ){.   
1110: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f   sqlite3GlobalCo
1120: 6e 66 69 67 2e 6d 2e 78 53 68 75 74 64 6f 77 6e  nfig.m.xShutdown
1130: 28 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f  (sqlite3GlobalCo
1140: 6e 66 69 67 2e 6d 2e 70 41 70 70 44 61 74 61 29  nfig.m.pAppData)
1150: 3b 0a 20 20 7d 0a 20 20 6d 65 6d 73 65 74 28 26  ;.  }.  memset(&
1160: 6d 65 6d 30 2c 20 30 2c 20 73 69 7a 65 6f 66 28  mem0, 0, sizeof(
1170: 6d 65 6d 30 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  mem0));.}../*.**
1180: 20 52 65 74 75 72 6e 20 74 68 65 20 61 6d 6f 75   Return the amou
1190: 6e 74 20 6f 66 20 6d 65 6d 6f 72 79 20 63 75 72  nt of memory cur
11a0: 72 65 6e 74 6c 79 20 63 68 65 63 6b 65 64 20 6f  rently checked o
11b0: 75 74 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f 69  ut..*/.sqlite3_i
11c0: 6e 74 36 34 20 73 71 6c 69 74 65 33 5f 6d 65 6d  nt64 sqlite3_mem
11d0: 6f 72 79 5f 75 73 65 64 28 76 6f 69 64 29 7b 0a  ory_used(void){.
11e0: 20 20 69 6e 74 20 6e 2c 20 6d 78 3b 0a 20 20 73    int n, mx;.  s
11f0: 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 72 65 73  qlite3_int64 res
1200: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 61 74  ;.  sqlite3_stat
1210: 75 73 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53  us(SQLITE_STATUS
1220: 5f 4d 45 4d 4f 52 59 5f 55 53 45 44 2c 20 26 6e  _MEMORY_USED, &n
1230: 2c 20 26 6d 78 2c 20 30 29 3b 0a 20 20 72 65 73  , &mx, 0);.  res
1240: 20 3d 20 28 73 71 6c 69 74 65 33 5f 69 6e 74 36   = (sqlite3_int6
1250: 34 29 6e 3b 20 20 2f 2a 20 57 6f 72 6b 20 61 72  4)n;  /* Work ar
1260: 6f 75 6e 64 20 62 75 67 20 69 6e 20 42 6f 72 6c  ound bug in Borl
1270: 61 6e 64 20 43 2e 20 54 69 63 6b 65 74 20 23 33  and C. Ticket #3
1280: 32 31 36 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20  216 */.  return 
1290: 72 65 73 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  res;.}../*.** Re
12a0: 74 75 72 6e 20 74 68 65 20 6d 61 78 69 6d 75 6d  turn the maximum
12b0: 20 61 6d 6f 75 6e 74 20 6f 66 20 6d 65 6d 6f 72   amount of memor
12c0: 79 20 74 68 61 74 20 68 61 73 20 65 76 65 72 20  y that has ever 
12d0: 62 65 65 6e 0a 2a 2a 20 63 68 65 63 6b 65 64 20  been.** checked 
12e0: 6f 75 74 20 73 69 6e 63 65 20 65 69 74 68 65 72  out since either
12f0: 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f   the beginning o
1300: 66 20 74 68 69 73 20 70 72 6f 63 65 73 73 0a 2a  f this process.*
1310: 2a 20 6f 72 20 73 69 6e 63 65 20 74 68 65 20 6d  * or since the m
1320: 6f 73 74 20 72 65 63 65 6e 74 20 72 65 73 65 74  ost recent reset
1330: 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f 69 6e 74  ..*/.sqlite3_int
1340: 36 34 20 73 71 6c 69 74 65 33 5f 6d 65 6d 6f 72  64 sqlite3_memor
1350: 79 5f 68 69 67 68 77 61 74 65 72 28 69 6e 74 20  y_highwater(int 
1360: 72 65 73 65 74 46 6c 61 67 29 7b 0a 20 20 69 6e  resetFlag){.  in
1370: 74 20 6e 2c 20 6d 78 3b 0a 20 20 73 71 6c 69 74  t n, mx;.  sqlit
1380: 65 33 5f 69 6e 74 36 34 20 72 65 73 3b 0a 20 20  e3_int64 res;.  
1390: 73 71 6c 69 74 65 33 5f 73 74 61 74 75 73 28 53  sqlite3_status(S
13a0: 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d 45 4d  QLITE_STATUS_MEM
13b0: 4f 52 59 5f 55 53 45 44 2c 20 26 6e 2c 20 26 6d  ORY_USED, &n, &m
13c0: 78 2c 20 72 65 73 65 74 46 6c 61 67 29 3b 0a 20  x, resetFlag);. 
13d0: 20 72 65 73 20 3d 20 28 73 71 6c 69 74 65 33 5f   res = (sqlite3_
13e0: 69 6e 74 36 34 29 6d 78 3b 20 20 2f 2a 20 57 6f  int64)mx;  /* Wo
13f0: 72 6b 20 61 72 6f 75 6e 64 20 62 75 67 20 69 6e  rk around bug in
1400: 20 42 6f 72 6c 61 6e 64 20 43 2e 20 54 69 63 6b   Borland C. Tick
1410: 65 74 20 23 33 32 31 36 20 2a 2f 0a 20 20 72 65  et #3216 */.  re
1420: 74 75 72 6e 20 72 65 73 3b 0a 7d 0a 0a 2f 2a 0a  turn res;.}../*.
1430: 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 61 6c  ** Change the al
1440: 61 72 6d 20 63 61 6c 6c 62 61 63 6b 0a 2a 2f 0a  arm callback.*/.
1450: 69 6e 74 20 73 71 6c 69 74 65 33 4d 65 6d 6f 72  int sqlite3Memor
1460: 79 41 6c 61 72 6d 28 0a 20 20 76 6f 69 64 28 2a  yAlarm(.  void(*
1470: 78 43 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 20  xCallback)(void 
1480: 2a 70 41 72 67 2c 20 73 71 6c 69 74 65 33 5f 69  *pArg, sqlite3_i
1490: 6e 74 36 34 20 75 73 65 64 2c 69 6e 74 20 4e 29  nt64 used,int N)
14a0: 2c 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 2c 0a  ,.  void *pArg,.
14b0: 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20    sqlite3_int64 
14c0: 69 54 68 72 65 73 68 6f 6c 64 0a 29 7b 0a 20 20  iThreshold.){.  
14d0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e  sqlite3_mutex_en
14e0: 74 65 72 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b  ter(mem0.mutex);
14f0: 0a 20 20 6d 65 6d 30 2e 61 6c 61 72 6d 43 61 6c  .  mem0.alarmCal
1500: 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61 63  lback = xCallbac
1510: 6b 3b 0a 20 20 6d 65 6d 30 2e 61 6c 61 72 6d 41  k;.  mem0.alarmA
1520: 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 6d 65 6d  rg = pArg;.  mem
1530: 30 2e 61 6c 61 72 6d 54 68 72 65 73 68 6f 6c 64  0.alarmThreshold
1540: 20 3d 20 69 54 68 72 65 73 68 6f 6c 64 3b 0a 20   = iThreshold;. 
1550: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c   sqlite3_mutex_l
1560: 65 61 76 65 28 6d 65 6d 30 2e 6d 75 74 65 78 29  eave(mem0.mutex)
1570: 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54  ;.  return SQLIT
1580: 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66  E_OK;.}..#ifndef
1590: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 50   SQLITE_OMIT_DEP
15a0: 52 45 43 41 54 45 44 0a 2f 2a 0a 2a 2a 20 44 65  RECATED./*.** De
15b0: 70 72 65 63 61 74 65 64 20 65 78 74 65 72 6e 61  precated externa
15c0: 6c 20 69 6e 74 65 72 66 61 63 65 2e 20 20 49 6e  l interface.  In
15d0: 74 65 72 6e 61 6c 2f 63 6f 72 65 20 53 51 4c 69  ternal/core SQLi
15e0: 74 65 20 63 6f 64 65 0a 2a 2a 20 73 68 6f 75 6c  te code.** shoul
15f0: 64 20 63 61 6c 6c 20 73 71 6c 69 74 65 33 4d 65  d call sqlite3Me
1600: 6d 6f 72 79 41 6c 61 72 6d 2e 0a 2a 2f 0a 69 6e  moryAlarm..*/.in
1610: 74 20 73 71 6c 69 74 65 33 5f 6d 65 6d 6f 72 79  t sqlite3_memory
1620: 5f 61 6c 61 72 6d 28 0a 20 20 76 6f 69 64 28 2a  _alarm(.  void(*
1630: 78 43 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 20  xCallback)(void 
1640: 2a 70 41 72 67 2c 20 73 71 6c 69 74 65 33 5f 69  *pArg, sqlite3_i
1650: 6e 74 36 34 20 75 73 65 64 2c 69 6e 74 20 4e 29  nt64 used,int N)
1660: 2c 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 2c 0a  ,.  void *pArg,.
1670: 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20    sqlite3_int64 
1680: 69 54 68 72 65 73 68 6f 6c 64 0a 29 7b 0a 20 20  iThreshold.){.  
1690: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 4d 65  return sqlite3Me
16a0: 6d 6f 72 79 41 6c 61 72 6d 28 78 43 61 6c 6c 62  moryAlarm(xCallb
16b0: 61 63 6b 2c 20 70 41 72 67 2c 20 69 54 68 72 65  ack, pArg, iThre
16c0: 73 68 6f 6c 64 29 3b 0a 7d 0a 23 65 6e 64 69 66  shold);.}.#endif
16d0: 0a 0a 2f 2a 0a 2a 2a 20 54 72 69 67 67 65 72 20  ../*.** Trigger 
16e0: 74 68 65 20 61 6c 61 72 6d 20 0a 2a 2f 0a 73 74  the alarm .*/.st
16f0: 61 74 69 63 20 76 6f 69 64 20 73 71 6c 69 74 65  atic void sqlite
1700: 33 4d 61 6c 6c 6f 63 41 6c 61 72 6d 28 69 6e 74  3MallocAlarm(int
1710: 20 6e 42 79 74 65 29 7b 0a 20 20 76 6f 69 64 20   nByte){.  void 
1720: 28 2a 78 43 61 6c 6c 62 61 63 6b 29 28 76 6f 69  (*xCallback)(voi
1730: 64 2a 2c 73 71 6c 69 74 65 33 5f 69 6e 74 36 34  d*,sqlite3_int64
1740: 2c 69 6e 74 29 3b 0a 20 20 73 71 6c 69 74 65 33  ,int);.  sqlite3
1750: 5f 69 6e 74 36 34 20 6e 6f 77 55 73 65 64 3b 0a  _int64 nowUsed;.
1760: 20 20 76 6f 69 64 20 2a 70 41 72 67 3b 0a 20 20    void *pArg;.  
1770: 69 66 28 20 6d 65 6d 30 2e 61 6c 61 72 6d 43 61  if( mem0.alarmCa
1780: 6c 6c 62 61 63 6b 3d 3d 30 20 29 20 72 65 74 75  llback==0 ) retu
1790: 72 6e 3b 0a 20 20 78 43 61 6c 6c 62 61 63 6b 20  rn;.  xCallback 
17a0: 3d 20 6d 65 6d 30 2e 61 6c 61 72 6d 43 61 6c 6c  = mem0.alarmCall
17b0: 62 61 63 6b 3b 0a 20 20 6e 6f 77 55 73 65 64 20  back;.  nowUsed 
17c0: 3d 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 56  = sqlite3StatusV
17d0: 61 6c 75 65 28 53 51 4c 49 54 45 5f 53 54 41 54  alue(SQLITE_STAT
17e0: 55 53 5f 4d 45 4d 4f 52 59 5f 55 53 45 44 29 3b  US_MEMORY_USED);
17f0: 0a 20 20 70 41 72 67 20 3d 20 6d 65 6d 30 2e 61  .  pArg = mem0.a
1800: 6c 61 72 6d 41 72 67 3b 0a 20 20 6d 65 6d 30 2e  larmArg;.  mem0.
1810: 61 6c 61 72 6d 43 61 6c 6c 62 61 63 6b 20 3d 20  alarmCallback = 
1820: 30 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  0;.  sqlite3_mut
1830: 65 78 5f 6c 65 61 76 65 28 6d 65 6d 30 2e 6d 75  ex_leave(mem0.mu
1840: 74 65 78 29 3b 0a 20 20 78 43 61 6c 6c 62 61 63  tex);.  xCallbac
1850: 6b 28 70 41 72 67 2c 20 6e 6f 77 55 73 65 64 2c  k(pArg, nowUsed,
1860: 20 6e 42 79 74 65 29 3b 0a 20 20 73 71 6c 69 74   nByte);.  sqlit
1870: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d  e3_mutex_enter(m
1880: 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 6d 65  em0.mutex);.  me
1890: 6d 30 2e 61 6c 61 72 6d 43 61 6c 6c 62 61 63 6b  m0.alarmCallback
18a0: 20 3d 20 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 20   = xCallback;.  
18b0: 6d 65 6d 30 2e 61 6c 61 72 6d 41 72 67 20 3d 20  mem0.alarmArg = 
18c0: 70 41 72 67 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44  pArg;.}../*.** D
18d0: 6f 20 61 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63  o a memory alloc
18e0: 61 74 69 6f 6e 20 77 69 74 68 20 73 74 61 74 69  ation with stati
18f0: 73 74 69 63 73 20 61 6e 64 20 61 6c 61 72 6d 73  stics and alarms
1900: 2e 20 20 41 73 73 75 6d 65 20 74 68 65 0a 2a 2a  .  Assume the.**
1910: 20 6c 6f 63 6b 20 69 73 20 61 6c 72 65 61 64 79   lock is already
1920: 20 68 65 6c 64 2e 0a 2a 2f 0a 73 74 61 74 69 63   held..*/.static
1930: 20 69 6e 74 20 6d 61 6c 6c 6f 63 57 69 74 68 41   int mallocWithA
1940: 6c 61 72 6d 28 69 6e 74 20 6e 2c 20 76 6f 69 64  larm(int n, void
1950: 20 2a 2a 70 70 29 7b 0a 20 20 69 6e 74 20 6e 46   **pp){.  int nF
1960: 75 6c 6c 3b 0a 20 20 76 6f 69 64 20 2a 70 3b 0a  ull;.  void *p;.
1970: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
1980: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 6d 65 6d  3_mutex_held(mem
1990: 30 2e 6d 75 74 65 78 29 20 29 3b 0a 20 20 6e 46  0.mutex) );.  nF
19a0: 75 6c 6c 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f  ull = sqlite3Glo
19b0: 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78 52 6f 75  balConfig.m.xRou
19c0: 6e 64 75 70 28 6e 29 3b 0a 20 20 73 71 6c 69 74  ndup(n);.  sqlit
19d0: 65 33 53 74 61 74 75 73 53 65 74 28 53 51 4c 49  e3StatusSet(SQLI
19e0: 54 45 5f 53 54 41 54 55 53 5f 4d 41 4c 4c 4f 43  TE_STATUS_MALLOC
19f0: 5f 53 49 5a 45 2c 20 6e 29 3b 0a 20 20 69 66 28  _SIZE, n);.  if(
1a00: 20 6d 65 6d 30 2e 61 6c 61 72 6d 43 61 6c 6c 62   mem0.alarmCallb
1a10: 61 63 6b 21 3d 30 20 29 7b 0a 20 20 20 20 69 6e  ack!=0 ){.    in
1a20: 74 20 6e 55 73 65 64 20 3d 20 73 71 6c 69 74 65  t nUsed = sqlite
1a30: 33 53 74 61 74 75 73 56 61 6c 75 65 28 53 51 4c  3StatusValue(SQL
1a40: 49 54 45 5f 53 54 41 54 55 53 5f 4d 45 4d 4f 52  ITE_STATUS_MEMOR
1a50: 59 5f 55 53 45 44 29 3b 0a 20 20 20 20 69 66 28  Y_USED);.    if(
1a60: 20 6e 55 73 65 64 2b 6e 46 75 6c 6c 20 3e 3d 20   nUsed+nFull >= 
1a70: 6d 65 6d 30 2e 61 6c 61 72 6d 54 68 72 65 73 68  mem0.alarmThresh
1a80: 6f 6c 64 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  old ){.      sql
1a90: 69 74 65 33 4d 61 6c 6c 6f 63 41 6c 61 72 6d 28  ite3MallocAlarm(
1aa0: 6e 46 75 6c 6c 29 3b 0a 20 20 20 20 7d 0a 20 20  nFull);.    }.  
1ab0: 7d 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 33 47  }.  p = sqlite3G
1ac0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78 4d  lobalConfig.m.xM
1ad0: 61 6c 6c 6f 63 28 6e 46 75 6c 6c 29 3b 0a 20 20  alloc(nFull);.  
1ae0: 69 66 28 20 70 3d 3d 30 20 26 26 20 6d 65 6d 30  if( p==0 && mem0
1af0: 2e 61 6c 61 72 6d 43 61 6c 6c 62 61 63 6b 20 29  .alarmCallback )
1b00: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 4d 61 6c  {.    sqlite3Mal
1b10: 6c 6f 63 41 6c 61 72 6d 28 6e 46 75 6c 6c 29 3b  locAlarm(nFull);
1b20: 0a 20 20 20 20 70 20 3d 20 73 71 6c 69 74 65 33  .    p = sqlite3
1b30: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78  GlobalConfig.m.x
1b40: 4d 61 6c 6c 6f 63 28 6e 46 75 6c 6c 29 3b 0a 20  Malloc(nFull);. 
1b50: 20 7d 0a 20 20 69 66 28 20 70 20 29 7b 0a 20 20   }.  if( p ){.  
1b60: 20 20 6e 46 75 6c 6c 20 3d 20 73 71 6c 69 74 65    nFull = sqlite
1b70: 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 29 3b 0a  3MallocSize(p);.
1b80: 20 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75      sqlite3Statu
1b90: 73 41 64 64 28 53 51 4c 49 54 45 5f 53 54 41 54  sAdd(SQLITE_STAT
1ba0: 55 53 5f 4d 45 4d 4f 52 59 5f 55 53 45 44 2c 20  US_MEMORY_USED, 
1bb0: 6e 46 75 6c 6c 29 3b 0a 20 20 7d 0a 20 20 2a 70  nFull);.  }.  *p
1bc0: 70 20 3d 20 70 3b 0a 20 20 72 65 74 75 72 6e 20  p = p;.  return 
1bd0: 6e 46 75 6c 6c 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  nFull;.}../*.** 
1be0: 41 6c 6c 6f 63 61 74 65 20 6d 65 6d 6f 72 79 2e  Allocate memory.
1bf0: 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69    This routine i
1c00: 73 20 6c 69 6b 65 20 73 71 6c 69 74 65 33 5f 6d  s like sqlite3_m
1c10: 61 6c 6c 6f 63 28 29 20 65 78 63 65 70 74 20 74  alloc() except t
1c20: 68 61 74 20 69 74 0a 2a 2a 20 61 73 73 75 6d 65  hat it.** assume
1c30: 73 20 74 68 65 20 6d 65 6d 6f 72 79 20 73 75 62  s the memory sub
1c40: 73 79 73 74 65 6d 20 68 61 73 20 61 6c 72 65 61  system has alrea
1c50: 64 79 20 62 65 65 6e 20 69 6e 69 74 69 61 6c 69  dy been initiali
1c60: 7a 65 64 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71  zed..*/.void *sq
1c70: 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 69 6e 74 20  lite3Malloc(int 
1c80: 6e 29 7b 0a 20 20 76 6f 69 64 20 2a 70 3b 0a 20  n){.  void *p;. 
1c90: 20 69 66 28 20 6e 3c 3d 30 20 7c 7c 20 6e 3e 3d   if( n<=0 || n>=
1ca0: 30 78 37 66 66 66 66 66 30 30 20 29 7b 0a 20 20  0x7fffff00 ){.  
1cb0: 20 20 2f 2a 20 41 20 6d 65 6d 6f 72 79 20 61 6c    /* A memory al
1cc0: 6c 6f 63 61 74 69 6f 6e 20 6f 66 20 61 20 6e 75  location of a nu
1cd0: 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 77 68  mber of bytes wh
1ce0: 69 63 68 20 69 73 20 6e 65 61 72 20 74 68 65 20  ich is near the 
1cf0: 6d 61 78 69 6d 75 6d 0a 20 20 20 20 2a 2a 20 73  maximum.    ** s
1d00: 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20 76 61  igned integer va
1d10: 6c 75 65 20 6d 69 67 68 74 20 63 61 75 73 65 20  lue might cause 
1d20: 61 6e 20 69 6e 74 65 67 65 72 20 6f 76 65 72 66  an integer overf
1d30: 6c 6f 77 20 69 6e 73 69 64 65 20 6f 66 20 74 68  low inside of th
1d40: 65 0a 20 20 20 20 2a 2a 20 78 4d 61 6c 6c 6f 63  e.    ** xMalloc
1d50: 28 29 2e 20 20 48 65 6e 63 65 20 77 65 20 6c 69  ().  Hence we li
1d60: 6d 69 74 20 74 68 65 20 6d 61 78 69 6d 75 6d 20  mit the maximum 
1d70: 73 69 7a 65 20 74 6f 20 30 78 37 66 66 66 66 66  size to 0x7fffff
1d80: 30 30 2c 20 67 69 76 69 6e 67 0a 20 20 20 20 2a  00, giving.    *
1d90: 2a 20 32 35 35 20 62 79 74 65 73 20 6f 66 20 6f  * 255 bytes of o
1da0: 76 65 72 68 65 61 64 2e 20 20 53 51 4c 69 74 65  verhead.  SQLite
1db0: 20 69 74 73 65 6c 66 20 77 69 6c 6c 20 6e 65 76   itself will nev
1dc0: 65 72 20 75 73 65 20 61 6e 79 74 68 69 6e 67 20  er use anything 
1dd0: 6e 65 61 72 0a 20 20 20 20 2a 2a 20 74 68 69 73  near.    ** this
1de0: 20 61 6d 6f 75 6e 74 2e 20 20 54 68 65 20 6f 6e   amount.  The on
1df0: 6c 79 20 77 61 79 20 74 6f 20 72 65 61 63 68 20  ly way to reach 
1e00: 74 68 65 20 6c 69 6d 69 74 20 69 73 20 77 69 74  the limit is wit
1e10: 68 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63  h sqlite3_malloc
1e20: 28 29 20 2a 2f 0a 20 20 20 20 70 20 3d 20 30 3b  () */.    p = 0;
1e30: 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 73 71 6c  .  }else if( sql
1e40: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67  ite3GlobalConfig
1e50: 2e 62 4d 65 6d 73 74 61 74 20 29 7b 0a 20 20 20  .bMemstat ){.   
1e60: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65   sqlite3_mutex_e
1e70: 6e 74 65 72 28 6d 65 6d 30 2e 6d 75 74 65 78 29  nter(mem0.mutex)
1e80: 3b 0a 20 20 20 20 6d 61 6c 6c 6f 63 57 69 74 68  ;.    mallocWith
1e90: 41 6c 61 72 6d 28 6e 2c 20 26 70 29 3b 0a 20 20  Alarm(n, &p);.  
1ea0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f    sqlite3_mutex_
1eb0: 6c 65 61 76 65 28 6d 65 6d 30 2e 6d 75 74 65 78  leave(mem0.mutex
1ec0: 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  );.  }else{.    
1ed0: 70 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61  p = sqlite3Globa
1ee0: 6c 43 6f 6e 66 69 67 2e 6d 2e 78 4d 61 6c 6c 6f  lConfig.m.xMallo
1ef0: 63 28 6e 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75  c(n);.  }.  retu
1f00: 72 6e 20 70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  rn p;.}../*.** T
1f10: 68 69 73 20 76 65 72 73 69 6f 6e 20 6f 66 20 74  his version of t
1f20: 68 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61  he memory alloca
1f30: 74 69 6f 6e 20 69 73 20 66 6f 72 20 75 73 65 20  tion is for use 
1f40: 62 79 20 74 68 65 20 61 70 70 6c 69 63 61 74 69  by the applicati
1f50: 6f 6e 2e 0a 2a 2a 20 46 69 72 73 74 20 6d 61 6b  on..** First mak
1f60: 65 20 73 75 72 65 20 74 68 65 20 6d 65 6d 6f 72  e sure the memor
1f70: 79 20 73 75 62 73 79 73 74 65 6d 20 69 73 20 69  y subsystem is i
1f80: 6e 69 74 69 61 6c 69 7a 65 64 2c 20 74 68 65 6e  nitialized, then
1f90: 20 64 6f 20 74 68 65 0a 2a 2a 20 61 6c 6c 6f 63   do the.** alloc
1fa0: 61 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 2a  ation..*/.void *
1fb0: 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 69  sqlite3_malloc(i
1fc0: 6e 74 20 6e 29 7b 0a 23 69 66 6e 64 65 66 20 53  nt n){.#ifndef S
1fd0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49  QLITE_OMIT_AUTOI
1fe0: 4e 49 54 0a 20 20 69 66 28 20 73 71 6c 69 74 65  NIT.  if( sqlite
1ff0: 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 20 29  3_initialize() )
2000: 20 72 65 74 75 72 6e 20 30 3b 0a 23 65 6e 64 69   return 0;.#endi
2010: 66 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74  f.  return sqlit
2020: 65 33 4d 61 6c 6c 6f 63 28 6e 29 3b 0a 7d 0a 0a  e3Malloc(n);.}..
2030: 2f 2a 0a 2a 2a 20 45 61 63 68 20 74 68 72 65 61  /*.** Each threa
2040: 64 20 6d 61 79 20 6f 6e 6c 79 20 68 61 76 65 20  d may only have 
2050: 61 20 73 69 6e 67 6c 65 20 6f 75 74 73 74 61 6e  a single outstan
2060: 64 69 6e 67 20 61 6c 6c 6f 63 61 74 69 6f 6e 20  ding allocation 
2070: 66 72 6f 6d 0a 2a 2a 20 78 53 63 72 61 74 63 68  from.** xScratch
2080: 4d 61 6c 6c 6f 63 28 29 2e 20 20 57 65 20 76 65  Malloc().  We ve
2090: 72 69 66 79 20 74 68 69 73 20 63 6f 6e 73 74 72  rify this constr
20a0: 61 69 6e 74 20 69 6e 20 74 68 65 20 73 69 6e 67  aint in the sing
20b0: 6c 65 2d 74 68 72 65 61 64 65 64 0a 2a 2a 20 63  le-threaded.** c
20c0: 61 73 65 20 62 79 20 73 65 74 74 69 6e 67 20 73  ase by setting s
20d0: 63 72 61 74 63 68 41 6c 6c 6f 63 4f 75 74 20 74  cratchAllocOut t
20e0: 6f 20 31 20 77 68 65 6e 20 61 6e 20 61 6c 6c 6f  o 1 when an allo
20f0: 63 61 74 69 6f 6e 0a 2a 2a 20 69 73 20 6f 75 74  cation.** is out
2100: 73 74 61 6e 64 69 6e 67 20 63 6c 65 61 72 69 6e  standing clearin
2110: 67 20 69 74 20 77 68 65 6e 20 74 68 65 20 61 6c  g it when the al
2120: 6c 6f 63 61 74 69 6f 6e 20 69 73 20 66 72 65 65  location is free
2130: 64 2e 0a 2a 2f 0a 23 69 66 20 53 51 4c 49 54 45  d..*/.#if SQLITE
2140: 5f 54 48 52 45 41 44 53 41 46 45 3d 3d 30 20 26  _THREADSAFE==0 &
2150: 26 20 21 64 65 66 69 6e 65 64 28 4e 44 45 42 55  & !defined(NDEBU
2160: 47 29 0a 73 74 61 74 69 63 20 69 6e 74 20 73 63  G).static int sc
2170: 72 61 74 63 68 41 6c 6c 6f 63 4f 75 74 20 3d 20  ratchAllocOut = 
2180: 30 3b 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a  0;.#endif.../*.*
2190: 2a 20 41 6c 6c 6f 63 61 74 65 20 6d 65 6d 6f 72  * Allocate memor
21a0: 79 20 74 68 61 74 20 69 73 20 74 6f 20 62 65 20  y that is to be 
21b0: 75 73 65 64 20 61 6e 64 20 72 65 6c 65 61 73 65  used and release
21c0: 64 20 72 69 67 68 74 20 61 77 61 79 2e 0a 2a 2a  d right away..**
21d0: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73   This routine is
21e0: 20 73 69 6d 69 6c 61 72 20 74 6f 20 61 6c 6c 6f   similar to allo
21f0: 63 61 28 29 20 69 6e 20 74 68 61 74 20 69 74 20  ca() in that it 
2200: 69 73 20 6e 6f 74 20 69 6e 74 65 6e 64 65 64 0a  is not intended.
2210: 2a 2a 20 66 6f 72 20 73 69 74 75 61 74 69 6f 6e  ** for situation
2220: 73 20 77 68 65 72 65 20 74 68 65 20 6d 65 6d 6f  s where the memo
2230: 72 79 20 6d 69 67 68 74 20 62 65 20 68 65 6c 64  ry might be held
2240: 20 6c 6f 6e 67 2d 74 65 72 6d 2e 20 20 54 68 69   long-term.  Thi
2250: 73 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 69 73 20  s.** routine is 
2260: 69 6e 74 65 6e 64 65 64 20 74 6f 20 67 65 74 20  intended to get 
2270: 6d 65 6d 6f 72 79 20 74 6f 20 6f 6c 64 20 6c 61  memory to old la
2280: 72 67 65 20 74 72 61 6e 73 69 65 6e 74 20 64 61  rge transient da
2290: 74 61 0a 2a 2a 20 73 74 72 75 63 74 75 72 65 73  ta.** structures
22a0: 20 74 68 61 74 20 77 6f 75 6c 64 20 6e 6f 74 20   that would not 
22b0: 6e 6f 72 6d 61 6c 6c 79 20 66 69 74 20 6f 6e 20  normally fit on 
22c0: 74 68 65 20 73 74 61 63 6b 20 6f 66 20 61 6e 0a  the stack of an.
22d0: 2a 2a 20 65 6d 62 65 64 64 65 64 20 70 72 6f 63  ** embedded proc
22e0: 65 73 73 6f 72 2e 0a 2a 2f 0a 76 6f 69 64 20 2a  essor..*/.void *
22f0: 73 71 6c 69 74 65 33 53 63 72 61 74 63 68 4d 61  sqlite3ScratchMa
2300: 6c 6c 6f 63 28 69 6e 74 20 6e 29 7b 0a 20 20 76  lloc(int n){.  v
2310: 6f 69 64 20 2a 70 3b 0a 20 20 61 73 73 65 72 74  oid *p;.  assert
2320: 28 20 6e 3e 30 20 29 3b 0a 0a 23 69 66 20 53 51  ( n>0 );..#if SQ
2330: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d  LITE_THREADSAFE=
2340: 3d 30 20 26 26 20 21 64 65 66 69 6e 65 64 28 4e  =0 && !defined(N
2350: 44 45 42 55 47 29 0a 20 20 2f 2a 20 56 65 72 69  DEBUG).  /* Veri
2360: 66 79 20 74 68 61 74 20 6e 6f 20 6d 6f 72 65 20  fy that no more 
2370: 74 68 61 6e 20 74 77 6f 20 73 63 72 61 74 63 68  than two scratch
2380: 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 70 65 72 20   allocation per 
2390: 74 68 72 65 61 64 0a 20 20 2a 2a 20 69 73 20 6f  thread.  ** is o
23a0: 75 74 73 74 61 6e 64 69 6e 67 20 61 74 20 6f 6e  utstanding at on
23b0: 65 20 74 69 6d 65 2e 20 20 28 54 68 69 73 20 69  e time.  (This i
23c0: 73 20 6f 6e 6c 79 20 63 68 65 63 6b 65 64 20 69  s only checked i
23d0: 6e 20 74 68 65 0a 20 20 2a 2a 20 73 69 6e 67 6c  n the.  ** singl
23e0: 65 2d 74 68 72 65 61 64 65 64 20 63 61 73 65 20  e-threaded case 
23f0: 73 69 6e 63 65 20 63 68 65 63 6b 69 6e 67 20 69  since checking i
2400: 6e 20 74 68 65 20 6d 75 6c 74 69 2d 74 68 72 65  n the multi-thre
2410: 61 64 65 64 20 63 61 73 65 0a 20 20 2a 2a 20 77  aded case.  ** w
2420: 6f 75 6c 64 20 62 65 20 6d 75 63 68 20 6d 6f 72  ould be much mor
2430: 65 20 63 6f 6d 70 6c 69 63 61 74 65 64 2e 29 20  e complicated.) 
2440: 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 73 63 72  */.  assert( scr
2450: 61 74 63 68 41 6c 6c 6f 63 4f 75 74 3c 3d 31 20  atchAllocOut<=1 
2460: 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 69 66 28  );.#endif..  if(
2470: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f   sqlite3GlobalCo
2480: 6e 66 69 67 2e 73 7a 53 63 72 61 74 63 68 3c 6e  nfig.szScratch<n
2490: 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 73 63 72   ){.    goto scr
24a0: 61 74 63 68 5f 6f 76 65 72 66 6c 6f 77 3b 0a 20  atch_overflow;. 
24b0: 20 7d 65 6c 73 65 7b 20 20 0a 20 20 20 20 73 71   }else{  .    sq
24c0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
24d0: 72 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20  r(mem0.mutex);. 
24e0: 20 20 20 69 66 28 20 6d 65 6d 30 2e 6e 53 63 72     if( mem0.nScr
24f0: 61 74 63 68 46 72 65 65 3d 3d 30 20 29 7b 0a 20  atchFree==0 ){. 
2500: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74       sqlite3_mut
2510: 65 78 5f 6c 65 61 76 65 28 6d 65 6d 30 2e 6d 75  ex_leave(mem0.mu
2520: 74 65 78 29 3b 0a 20 20 20 20 20 20 67 6f 74 6f  tex);.      goto
2530: 20 73 63 72 61 74 63 68 5f 6f 76 65 72 66 6c 6f   scratch_overflo
2540: 77 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  w;.    }else{.  
2550: 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 20      int i;.     
2560: 20 69 20 3d 20 6d 65 6d 30 2e 61 53 63 72 61 74   i = mem0.aScrat
2570: 63 68 46 72 65 65 5b 2d 2d 6d 65 6d 30 2e 6e 53  chFree[--mem0.nS
2580: 63 72 61 74 63 68 46 72 65 65 5d 3b 0a 20 20 20  cratchFree];.   
2590: 20 20 20 69 20 2a 3d 20 73 71 6c 69 74 65 33 47     i *= sqlite3G
25a0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 53 63  lobalConfig.szSc
25b0: 72 61 74 63 68 3b 0a 20 20 20 20 20 20 73 71 6c  ratch;.      sql
25c0: 69 74 65 33 53 74 61 74 75 73 41 64 64 28 53 51  ite3StatusAdd(SQ
25d0: 4c 49 54 45 5f 53 54 41 54 55 53 5f 53 43 52 41  LITE_STATUS_SCRA
25e0: 54 43 48 5f 55 53 45 44 2c 20 31 29 3b 0a 20 20  TCH_USED, 1);.  
25f0: 20 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75      sqlite3Statu
2600: 73 53 65 74 28 53 51 4c 49 54 45 5f 53 54 41 54  sSet(SQLITE_STAT
2610: 55 53 5f 53 43 52 41 54 43 48 5f 53 49 5a 45 2c  US_SCRATCH_SIZE,
2620: 20 6e 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74   n);.      sqlit
2630: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d  e3_mutex_leave(m
2640: 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20  em0.mutex);.    
2650: 20 20 70 20 3d 20 28 76 6f 69 64 2a 29 26 28 28    p = (void*)&((
2660: 63 68 61 72 2a 29 73 71 6c 69 74 65 33 47 6c 6f  char*)sqlite3Glo
2670: 62 61 6c 43 6f 6e 66 69 67 2e 70 53 63 72 61 74  balConfig.pScrat
2680: 63 68 29 5b 69 5d 3b 0a 20 20 20 20 20 20 61 73  ch)[i];.      as
2690: 73 65 72 74 28 20 20 28 28 28 75 38 2a 29 70 20  sert(  (((u8*)p 
26a0: 2d 20 28 75 38 2a 29 30 29 20 26 20 37 29 3d 3d  - (u8*)0) & 7)==
26b0: 30 20 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23  0 );.    }.  }.#
26c0: 69 66 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44  if SQLITE_THREAD
26d0: 53 41 46 45 3d 3d 30 20 26 26 20 21 64 65 66 69  SAFE==0 && !defi
26e0: 6e 65 64 28 4e 44 45 42 55 47 29 0a 20 20 73 63  ned(NDEBUG).  sc
26f0: 72 61 74 63 68 41 6c 6c 6f 63 4f 75 74 20 3d 20  ratchAllocOut = 
2700: 70 21 3d 30 3b 0a 23 65 6e 64 69 66 0a 0a 20 20  p!=0;.#endif..  
2710: 72 65 74 75 72 6e 20 70 3b 0a 0a 73 63 72 61 74  return p;..scrat
2720: 63 68 5f 6f 76 65 72 66 6c 6f 77 3a 0a 20 20 69  ch_overflow:.  i
2730: 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c  f( sqlite3Global
2740: 43 6f 6e 66 69 67 2e 62 4d 65 6d 73 74 61 74 20  Config.bMemstat 
2750: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d  ){.    sqlite3_m
2760: 75 74 65 78 5f 65 6e 74 65 72 28 6d 65 6d 30 2e  utex_enter(mem0.
2770: 6d 75 74 65 78 29 3b 0a 20 20 20 20 73 71 6c 69  mutex);.    sqli
2780: 74 65 33 53 74 61 74 75 73 53 65 74 28 53 51 4c  te3StatusSet(SQL
2790: 49 54 45 5f 53 54 41 54 55 53 5f 53 43 52 41 54  ITE_STATUS_SCRAT
27a0: 43 48 5f 53 49 5a 45 2c 20 6e 29 3b 0a 20 20 20  CH_SIZE, n);.   
27b0: 20 6e 20 3d 20 6d 61 6c 6c 6f 63 57 69 74 68 41   n = mallocWithA
27c0: 6c 61 72 6d 28 6e 2c 20 26 70 29 3b 0a 20 20 20  larm(n, &p);.   
27d0: 20 69 66 28 20 70 20 29 20 73 71 6c 69 74 65 33   if( p ) sqlite3
27e0: 53 74 61 74 75 73 41 64 64 28 53 51 4c 49 54 45  StatusAdd(SQLITE
27f0: 5f 53 54 41 54 55 53 5f 53 43 52 41 54 43 48 5f  _STATUS_SCRATCH_
2800: 4f 56 45 52 46 4c 4f 57 2c 20 6e 29 3b 0a 20 20  OVERFLOW, n);.  
2810: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f    sqlite3_mutex_
2820: 6c 65 61 76 65 28 6d 65 6d 30 2e 6d 75 74 65 78  leave(mem0.mutex
2830: 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  );.  }else{.    
2840: 70 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61  p = sqlite3Globa
2850: 6c 43 6f 6e 66 69 67 2e 6d 2e 78 4d 61 6c 6c 6f  lConfig.m.xMallo
2860: 63 28 6e 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69  c(n);.  }.  sqli
2870: 74 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79  te3MemdebugSetTy
2880: 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 53 43  pe(p, MEMTYPE_SC
2890: 52 41 54 43 48 29 3b 0a 23 69 66 20 53 51 4c 49  RATCH);.#if SQLI
28a0: 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d 3d 30  TE_THREADSAFE==0
28b0: 20 26 26 20 21 64 65 66 69 6e 65 64 28 4e 44 45   && !defined(NDE
28c0: 42 55 47 29 0a 20 20 73 63 72 61 74 63 68 41 6c  BUG).  scratchAl
28d0: 6c 6f 63 4f 75 74 20 3d 20 70 21 3d 30 3b 0a 23  locOut = p!=0;.#
28e0: 65 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20 70  endif.  return p
28f0: 3b 20 20 20 20 0a 7d 0a 76 6f 69 64 20 73 71 6c  ;    .}.void sql
2900: 69 74 65 33 53 63 72 61 74 63 68 46 72 65 65 28  ite3ScratchFree(
2910: 76 6f 69 64 20 2a 70 29 7b 0a 20 20 69 66 28 20  void *p){.  if( 
2920: 70 20 29 7b 0a 20 20 20 20 69 66 28 20 73 71 6c  p ){.    if( sql
2930: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67  ite3GlobalConfig
2940: 2e 70 53 63 72 61 74 63 68 3d 3d 30 0a 20 20 20  .pScratch==0.   
2950: 20 20 20 20 20 20 20 20 7c 7c 20 70 3c 73 71 6c          || p<sql
2960: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67  ite3GlobalConfig
2970: 2e 70 53 63 72 61 74 63 68 0a 20 20 20 20 20 20  .pScratch.      
2980: 20 20 20 20 20 7c 7c 20 70 3e 3d 28 76 6f 69 64       || p>=(void
2990: 2a 29 6d 65 6d 30 2e 61 53 63 72 61 74 63 68 46  *)mem0.aScratchF
29a0: 72 65 65 20 29 7b 0a 20 20 20 20 20 20 61 73 73  ree ){.      ass
29b0: 65 72 74 28 20 73 71 6c 69 74 65 33 4d 65 6d 64  ert( sqlite3Memd
29c0: 65 62 75 67 48 61 73 54 79 70 65 28 70 2c 20 4d  ebugHasType(p, M
29d0: 45 4d 54 59 50 45 5f 53 43 52 41 54 43 48 29 20  EMTYPE_SCRATCH) 
29e0: 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28  );.      assert(
29f0: 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67   sqlite3Memdebug
2a00: 4e 6f 54 79 70 65 28 70 2c 20 7e 4d 45 4d 54 59  NoType(p, ~MEMTY
2a10: 50 45 5f 53 43 52 41 54 43 48 29 20 29 3b 0a 20  PE_SCRATCH) );. 
2a20: 20 20 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 64       sqlite3Memd
2a30: 65 62 75 67 53 65 74 54 79 70 65 28 70 2c 20 4d  ebugSetType(p, M
2a40: 45 4d 54 59 50 45 5f 48 45 41 50 29 3b 0a 20 20  EMTYPE_HEAP);.  
2a50: 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 47      if( sqlite3G
2a60: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 4d 65 6d  lobalConfig.bMem
2a70: 73 74 61 74 20 29 7b 0a 20 20 20 20 20 20 20 20  stat ){.        
2a80: 69 6e 74 20 69 53 69 7a 65 20 3d 20 73 71 6c 69  int iSize = sqli
2a90: 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 29  te3MallocSize(p)
2aa0: 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65  ;.        sqlite
2ab0: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d 65  3_mutex_enter(me
2ac0: 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 20  m0.mutex);.     
2ad0: 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73     sqlite3Status
2ae0: 41 64 64 28 53 51 4c 49 54 45 5f 53 54 41 54 55  Add(SQLITE_STATU
2af0: 53 5f 53 43 52 41 54 43 48 5f 4f 56 45 52 46 4c  S_SCRATCH_OVERFL
2b00: 4f 57 2c 20 2d 69 53 69 7a 65 29 3b 0a 20 20 20  OW, -iSize);.   
2b10: 20 20 20 20 20 73 71 6c 69 74 65 33 53 74 61 74       sqlite3Stat
2b20: 75 73 41 64 64 28 53 51 4c 49 54 45 5f 53 54 41  usAdd(SQLITE_STA
2b30: 54 55 53 5f 4d 45 4d 4f 52 59 5f 55 53 45 44 2c  TUS_MEMORY_USED,
2b40: 20 2d 69 53 69 7a 65 29 3b 0a 20 20 20 20 20 20   -iSize);.      
2b50: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43    sqlite3GlobalC
2b60: 6f 6e 66 69 67 2e 6d 2e 78 46 72 65 65 28 70 29  onfig.m.xFree(p)
2b70: 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65  ;.        sqlite
2b80: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 65  3_mutex_leave(me
2b90: 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 20  m0.mutex);.     
2ba0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20   }else{.        
2bb0: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
2bc0: 66 69 67 2e 6d 2e 78 46 72 65 65 28 70 29 3b 0a  fig.m.xFree(p);.
2bd0: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73        }.    }els
2be0: 65 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 3b 0a  e{.      int i;.
2bf0: 20 20 20 20 20 20 69 20 3d 20 28 69 6e 74 29 28        i = (int)(
2c00: 28 75 38 2a 29 70 20 2d 20 28 75 38 2a 29 73 71  (u8*)p - (u8*)sq
2c10: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69  lite3GlobalConfi
2c20: 67 2e 70 53 63 72 61 74 63 68 29 3b 0a 20 20 20  g.pScratch);.   
2c30: 20 20 20 69 20 2f 3d 20 73 71 6c 69 74 65 33 47     i /= sqlite3G
2c40: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 53 63  lobalConfig.szSc
2c50: 72 61 74 63 68 3b 0a 20 20 20 20 20 20 61 73 73  ratch;.      ass
2c60: 65 72 74 28 20 69 3e 3d 30 20 26 26 20 69 3c 73  ert( i>=0 && i<s
2c70: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66  qlite3GlobalConf
2c80: 69 67 2e 6e 53 63 72 61 74 63 68 20 29 3b 0a 20  ig.nScratch );. 
2c90: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74       sqlite3_mut
2ca0: 65 78 5f 65 6e 74 65 72 28 6d 65 6d 30 2e 6d 75  ex_enter(mem0.mu
2cb0: 74 65 78 29 3b 0a 20 20 20 20 20 20 61 73 73 65  tex);.      asse
2cc0: 72 74 28 20 6d 65 6d 30 2e 6e 53 63 72 61 74 63  rt( mem0.nScratc
2cd0: 68 46 72 65 65 3c 28 75 33 32 29 73 71 6c 69 74  hFree<(u32)sqlit
2ce0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e  e3GlobalConfig.n
2cf0: 53 63 72 61 74 63 68 20 29 3b 0a 20 20 20 20 20  Scratch );.     
2d00: 20 6d 65 6d 30 2e 61 53 63 72 61 74 63 68 46 72   mem0.aScratchFr
2d10: 65 65 5b 6d 65 6d 30 2e 6e 53 63 72 61 74 63 68  ee[mem0.nScratch
2d20: 46 72 65 65 2b 2b 5d 20 3d 20 69 3b 0a 20 20 20  Free++] = i;.   
2d30: 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73     sqlite3Status
2d40: 41 64 64 28 53 51 4c 49 54 45 5f 53 54 41 54 55  Add(SQLITE_STATU
2d50: 53 5f 53 43 52 41 54 43 48 5f 55 53 45 44 2c 20  S_SCRATCH_USED, 
2d60: 2d 31 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74  -1);.      sqlit
2d70: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d  e3_mutex_leave(m
2d80: 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 0a 23 69 66  em0.mutex);..#if
2d90: 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41   SQLITE_THREADSA
2da0: 46 45 3d 3d 30 20 26 26 20 21 64 65 66 69 6e 65  FE==0 && !define
2db0: 64 28 4e 44 45 42 55 47 29 0a 20 20 20 20 2f 2a  d(NDEBUG).    /*
2dc0: 20 56 65 72 69 66 79 20 74 68 61 74 20 6e 6f 20   Verify that no 
2dd0: 6d 6f 72 65 20 74 68 61 6e 20 74 77 6f 20 73 63  more than two sc
2de0: 72 61 74 63 68 20 61 6c 6c 6f 63 61 74 69 6f 6e  ratch allocation
2df0: 20 70 65 72 20 74 68 72 65 61 64 0a 20 20 20 20   per thread.    
2e00: 2a 2a 20 69 73 20 6f 75 74 73 74 61 6e 64 69 6e  ** is outstandin
2e10: 67 20 61 74 20 6f 6e 65 20 74 69 6d 65 2e 20 20  g at one time.  
2e20: 28 54 68 69 73 20 69 73 20 6f 6e 6c 79 20 63 68  (This is only ch
2e30: 65 63 6b 65 64 20 69 6e 20 74 68 65 0a 20 20 20  ecked in the.   
2e40: 20 2a 2a 20 73 69 6e 67 6c 65 2d 74 68 72 65 61   ** single-threa
2e50: 64 65 64 20 63 61 73 65 20 73 69 6e 63 65 20 63  ded case since c
2e60: 68 65 63 6b 69 6e 67 20 69 6e 20 74 68 65 20 6d  hecking in the m
2e70: 75 6c 74 69 2d 74 68 72 65 61 64 65 64 20 63 61  ulti-threaded ca
2e80: 73 65 0a 20 20 20 20 2a 2a 20 77 6f 75 6c 64 20  se.    ** would 
2e90: 62 65 20 6d 75 63 68 20 6d 6f 72 65 20 63 6f 6d  be much more com
2ea0: 70 6c 69 63 61 74 65 64 2e 29 20 2a 2f 0a 20 20  plicated.) */.  
2eb0: 20 20 61 73 73 65 72 74 28 20 73 63 72 61 74 63    assert( scratc
2ec0: 68 41 6c 6c 6f 63 4f 75 74 3e 3d 31 20 26 26 20  hAllocOut>=1 && 
2ed0: 73 63 72 61 74 63 68 41 6c 6c 6f 63 4f 75 74 3c  scratchAllocOut<
2ee0: 3d 32 20 29 3b 0a 20 20 20 20 73 63 72 61 74 63  =2 );.    scratc
2ef0: 68 41 6c 6c 6f 63 4f 75 74 20 3d 20 30 3b 0a 23  hAllocOut = 0;.#
2f00: 65 6e 64 69 66 0a 0a 20 20 20 20 7d 0a 20 20 7d  endif..    }.  }
2f10: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 52 55 45 20 69  .}../*.** TRUE i
2f20: 66 20 70 20 69 73 20 61 20 6c 6f 6f 6b 61 73 69  f p is a lookasi
2f30: 64 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61  de memory alloca
2f40: 74 69 6f 6e 20 66 72 6f 6d 20 64 62 0a 2a 2f 0a  tion from db.*/.
2f50: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
2f60: 4d 49 54 5f 4c 4f 4f 4b 41 53 49 44 45 0a 73 74  MIT_LOOKASIDE.st
2f70: 61 74 69 63 20 69 6e 74 20 69 73 4c 6f 6f 6b 61  atic int isLooka
2f80: 73 69 64 65 28 73 71 6c 69 74 65 33 20 2a 64 62  side(sqlite3 *db
2f90: 2c 20 76 6f 69 64 20 2a 70 29 7b 0a 20 20 72 65  , void *p){.  re
2fa0: 74 75 72 6e 20 70 20 26 26 20 70 3e 3d 64 62 2d  turn p && p>=db-
2fb0: 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 53 74 61 72  >lookaside.pStar
2fc0: 74 20 26 26 20 70 3c 64 62 2d 3e 6c 6f 6f 6b 61  t && p<db->looka
2fd0: 73 69 64 65 2e 70 45 6e 64 3b 0a 7d 0a 23 65 6c  side.pEnd;.}.#el
2fe0: 73 65 0a 23 64 65 66 69 6e 65 20 69 73 4c 6f 6f  se.#define isLoo
2ff0: 6b 61 73 69 64 65 28 41 2c 42 29 20 30 0a 23 65  kaside(A,B) 0.#e
3000: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  ndif../*.** Retu
3010: 72 6e 20 74 68 65 20 73 69 7a 65 20 6f 66 20 61  rn the size of a
3020: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69   memory allocati
3030: 6f 6e 20 70 72 65 76 69 6f 75 73 6c 79 20 6f 62  on previously ob
3040: 74 61 69 6e 65 64 20 66 72 6f 6d 0a 2a 2a 20 73  tained from.** s
3050: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 29 20 6f  qlite3Malloc() o
3060: 72 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63  r sqlite3_malloc
3070: 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  ()..*/.int sqlit
3080: 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 76 6f 69  e3MallocSize(voi
3090: 64 20 2a 70 29 7b 0a 20 20 61 73 73 65 72 74 28  d *p){.  assert(
30a0: 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67   sqlite3Memdebug
30b0: 48 61 73 54 79 70 65 28 70 2c 20 4d 45 4d 54 59  HasType(p, MEMTY
30c0: 50 45 5f 48 45 41 50 29 20 29 3b 0a 20 20 61 73  PE_HEAP) );.  as
30d0: 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d 65 6d  sert( sqlite3Mem
30e0: 64 65 62 75 67 4e 6f 54 79 70 65 28 70 2c 20 4d  debugNoType(p, M
30f0: 45 4d 54 59 50 45 5f 44 42 29 20 29 3b 0a 20 20  EMTYPE_DB) );.  
3100: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 47 6c  return sqlite3Gl
3110: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78 53 69  obalConfig.m.xSi
3120: 7a 65 28 70 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c  ze(p);.}.int sql
3130: 69 74 65 33 44 62 4d 61 6c 6c 6f 63 53 69 7a 65  ite3DbMallocSize
3140: 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 76 6f  (sqlite3 *db, vo
3150: 69 64 20 2a 70 29 7b 0a 20 20 61 73 73 65 72 74  id *p){.  assert
3160: 28 20 64 62 3d 3d 30 20 7c 7c 20 73 71 6c 69 74  ( db==0 || sqlit
3170: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62  e3_mutex_held(db
3180: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66  ->mutex) );.  if
3190: 28 20 64 62 20 26 26 20 69 73 4c 6f 6f 6b 61 73  ( db && isLookas
31a0: 69 64 65 28 64 62 2c 20 70 29 20 29 7b 0a 20 20  ide(db, p) ){.  
31b0: 20 20 72 65 74 75 72 6e 20 64 62 2d 3e 6c 6f 6f    return db->loo
31c0: 6b 61 73 69 64 65 2e 73 7a 3b 0a 20 20 7d 65 6c  kaside.sz;.  }el
31d0: 73 65 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20  se{.    assert( 
31e0: 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 48  sqlite3MemdebugH
31f0: 61 73 54 79 70 65 28 70 2c 20 4d 45 4d 54 59 50  asType(p, MEMTYP
3200: 45 5f 44 42 29 20 29 3b 0a 20 20 20 20 61 73 73  E_DB) );.    ass
3210: 65 72 74 28 20 73 71 6c 69 74 65 33 4d 65 6d 64  ert( sqlite3Memd
3220: 65 62 75 67 48 61 73 54 79 70 65 28 70 2c 20 4d  ebugHasType(p, M
3230: 45 4d 54 59 50 45 5f 4c 4f 4f 4b 41 53 49 44 45  EMTYPE_LOOKASIDE
3240: 7c 4d 45 4d 54 59 50 45 5f 48 45 41 50 29 20 29  |MEMTYPE_HEAP) )
3250: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 64 62  ;.    assert( db
3260: 21 3d 30 20 7c 7c 20 73 71 6c 69 74 65 33 4d 65  !=0 || sqlite3Me
3270: 6d 64 65 62 75 67 4e 6f 54 79 70 65 28 70 2c 20  mdebugNoType(p, 
3280: 4d 45 4d 54 59 50 45 5f 4c 4f 4f 4b 41 53 49 44  MEMTYPE_LOOKASID
3290: 45 29 20 29 3b 0a 20 20 20 20 72 65 74 75 72 6e  E) );.    return
32a0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f   sqlite3GlobalCo
32b0: 6e 66 69 67 2e 6d 2e 78 53 69 7a 65 28 70 29 3b  nfig.m.xSize(p);
32c0: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72  .  }.}../*.** Fr
32d0: 65 65 20 6d 65 6d 6f 72 79 20 70 72 65 76 69 6f  ee memory previo
32e0: 75 73 6c 79 20 6f 62 74 61 69 6e 65 64 20 66 72  usly obtained fr
32f0: 6f 6d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63  om sqlite3Malloc
3300: 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  ()..*/.void sqli
3310: 74 65 33 5f 66 72 65 65 28 76 6f 69 64 20 2a 70  te3_free(void *p
3320: 29 7b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20  ){.  if( p==0 ) 
3330: 72 65 74 75 72 6e 3b 0a 20 20 61 73 73 65 72 74  return;.  assert
3340: 28 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75  ( sqlite3Memdebu
3350: 67 4e 6f 54 79 70 65 28 70 2c 20 4d 45 4d 54 59  gNoType(p, MEMTY
3360: 50 45 5f 44 42 29 20 29 3b 0a 20 20 61 73 73 65  PE_DB) );.  asse
3370: 72 74 28 20 73 71 6c 69 74 65 33 4d 65 6d 64 65  rt( sqlite3Memde
3380: 62 75 67 48 61 73 54 79 70 65 28 70 2c 20 4d 45  bugHasType(p, ME
3390: 4d 54 59 50 45 5f 48 45 41 50 29 20 29 3b 0a 20  MTYPE_HEAP) );. 
33a0: 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62   if( sqlite3Glob
33b0: 61 6c 43 6f 6e 66 69 67 2e 62 4d 65 6d 73 74 61  alConfig.bMemsta
33c0: 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  t ){.    sqlite3
33d0: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d 65 6d  _mutex_enter(mem
33e0: 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 73 71  0.mutex);.    sq
33f0: 6c 69 74 65 33 53 74 61 74 75 73 41 64 64 28 53  lite3StatusAdd(S
3400: 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d 45 4d  QLITE_STATUS_MEM
3410: 4f 52 59 5f 55 53 45 44 2c 20 2d 73 71 6c 69 74  ORY_USED, -sqlit
3420: 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 29 29  e3MallocSize(p))
3430: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f  ;.    sqlite3Glo
3440: 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78 46 72 65  balConfig.m.xFre
3450: 65 28 70 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  e(p);.    sqlite
3460: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 65  3_mutex_leave(me
3470: 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 7d 65 6c  m0.mutex);.  }el
3480: 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 47  se{.    sqlite3G
3490: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78 46  lobalConfig.m.xF
34a0: 72 65 65 28 70 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f  ree(p);.  }.}../
34b0: 2a 0a 2a 2a 20 46 72 65 65 20 6d 65 6d 6f 72 79  *.** Free memory
34c0: 20 74 68 61 74 20 6d 69 67 68 74 20 62 65 20 61   that might be a
34d0: 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 61  ssociated with a
34e0: 20 70 61 72 74 69 63 75 6c 61 72 20 64 61 74 61   particular data
34f0: 62 61 73 65 0a 2a 2a 20 63 6f 6e 6e 65 63 74 69  base.** connecti
3500: 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  on..*/.void sqli
3510: 74 65 33 44 62 46 72 65 65 28 73 71 6c 69 74 65  te3DbFree(sqlite
3520: 33 20 2a 64 62 2c 20 76 6f 69 64 20 2a 70 29 7b  3 *db, void *p){
3530: 0a 20 20 61 73 73 65 72 74 28 20 64 62 3d 3d 30  .  assert( db==0
3540: 20 7c 7c 20 73 71 6c 69 74 65 33 5f 6d 75 74 65   || sqlite3_mute
3550: 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78  x_held(db->mutex
3560: 29 20 29 3b 0a 20 20 69 66 28 20 64 62 20 29 7b  ) );.  if( db ){
3570: 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 70 6e 42  .    if( db->pnB
3580: 79 74 65 73 46 72 65 65 64 20 29 7b 0a 20 20 20  ytesFreed ){.   
3590: 20 20 20 2a 64 62 2d 3e 70 6e 42 79 74 65 73 46     *db->pnBytesF
35a0: 72 65 65 64 20 2b 3d 20 73 71 6c 69 74 65 33 44  reed += sqlite3D
35b0: 62 4d 61 6c 6c 6f 63 53 69 7a 65 28 64 62 2c 20  bMallocSize(db, 
35c0: 70 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e  p);.      return
35d0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20  ;.    }.    if( 
35e0: 69 73 4c 6f 6f 6b 61 73 69 64 65 28 64 62 2c 20  isLookaside(db, 
35f0: 70 29 20 29 7b 0a 20 20 20 20 20 20 4c 6f 6f 6b  p) ){.      Look
3600: 61 73 69 64 65 53 6c 6f 74 20 2a 70 42 75 66 20  asideSlot *pBuf 
3610: 3d 20 28 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74  = (LookasideSlot
3620: 2a 29 70 3b 0a 20 20 20 20 20 20 70 42 75 66 2d  *)p;.      pBuf-
3630: 3e 70 4e 65 78 74 20 3d 20 64 62 2d 3e 6c 6f 6f  >pNext = db->loo
3640: 6b 61 73 69 64 65 2e 70 46 72 65 65 3b 0a 20 20  kaside.pFree;.  
3650: 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64      db->lookasid
3660: 65 2e 70 46 72 65 65 20 3d 20 70 42 75 66 3b 0a  e.pFree = pBuf;.
3670: 20 20 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73        db->lookas
3680: 69 64 65 2e 6e 4f 75 74 2d 2d 3b 0a 20 20 20 20  ide.nOut--;.    
3690: 20 20 72 65 74 75 72 6e 3b 0a 20 20 20 20 7d 0a    return;.    }.
36a0: 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 73 71    }.  assert( sq
36b0: 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 48 61 73  lite3MemdebugHas
36c0: 54 79 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f  Type(p, MEMTYPE_
36d0: 44 42 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28  DB) );.  assert(
36e0: 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67   sqlite3Memdebug
36f0: 48 61 73 54 79 70 65 28 70 2c 20 4d 45 4d 54 59  HasType(p, MEMTY
3700: 50 45 5f 4c 4f 4f 4b 41 53 49 44 45 7c 4d 45 4d  PE_LOOKASIDE|MEM
3710: 54 59 50 45 5f 48 45 41 50 29 20 29 3b 0a 20 20  TYPE_HEAP) );.  
3720: 61 73 73 65 72 74 28 20 64 62 21 3d 30 20 7c 7c  assert( db!=0 ||
3730: 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67   sqlite3Memdebug
3740: 4e 6f 54 79 70 65 28 70 2c 20 4d 45 4d 54 59 50  NoType(p, MEMTYP
3750: 45 5f 4c 4f 4f 4b 41 53 49 44 45 29 20 29 3b 0a  E_LOOKASIDE) );.
3760: 20 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75    sqlite3Memdebu
3770: 67 53 65 74 54 79 70 65 28 70 2c 20 4d 45 4d 54  gSetType(p, MEMT
3780: 59 50 45 5f 48 45 41 50 29 3b 0a 20 20 73 71 6c  YPE_HEAP);.  sql
3790: 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 7d 0a  ite3_free(p);.}.
37a0: 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68  ./*.** Change th
37b0: 65 20 73 69 7a 65 20 6f 66 20 61 6e 20 65 78 69  e size of an exi
37c0: 73 74 69 6e 67 20 6d 65 6d 6f 72 79 20 61 6c 6c  sting memory all
37d0: 6f 63 61 74 69 6f 6e 0a 2a 2f 0a 76 6f 69 64 20  ocation.*/.void 
37e0: 2a 73 71 6c 69 74 65 33 52 65 61 6c 6c 6f 63 28  *sqlite3Realloc(
37f0: 76 6f 69 64 20 2a 70 4f 6c 64 2c 20 69 6e 74 20  void *pOld, int 
3800: 6e 42 79 74 65 73 29 7b 0a 20 20 69 6e 74 20 6e  nBytes){.  int n
3810: 4f 6c 64 2c 20 6e 4e 65 77 3b 0a 20 20 76 6f 69  Old, nNew;.  voi
3820: 64 20 2a 70 4e 65 77 3b 0a 20 20 69 66 28 20 70  d *pNew;.  if( p
3830: 4f 6c 64 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65  Old==0 ){.    re
3840: 74 75 72 6e 20 73 71 6c 69 74 65 33 4d 61 6c 6c  turn sqlite3Mall
3850: 6f 63 28 6e 42 79 74 65 73 29 3b 0a 20 20 7d 0a  oc(nBytes);.  }.
3860: 20 20 69 66 28 20 6e 42 79 74 65 73 3c 3d 30 20    if( nBytes<=0 
3870: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66  ){.    sqlite3_f
3880: 72 65 65 28 70 4f 6c 64 29 3b 0a 20 20 20 20 72  ree(pOld);.    r
3890: 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 69  eturn 0;.  }.  i
38a0: 66 28 20 6e 42 79 74 65 73 3e 3d 30 78 37 66 66  f( nBytes>=0x7ff
38b0: 66 66 66 30 30 20 29 7b 0a 20 20 20 20 2f 2a 20  fff00 ){.    /* 
38c0: 54 68 65 20 30 78 37 66 66 66 66 30 30 20 6c 69  The 0x7ffff00 li
38d0: 6d 69 74 20 74 65 72 6d 20 69 73 20 65 78 70 6c  mit term is expl
38e0: 61 69 6e 65 64 20 69 6e 20 63 6f 6d 6d 65 6e 74  ained in comment
38f0: 73 20 6f 6e 20 73 71 6c 69 74 65 33 4d 61 6c 6c  s on sqlite3Mall
3900: 6f 63 28 29 20 2a 2f 0a 20 20 20 20 72 65 74 75  oc() */.    retu
3910: 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 6e 4f 6c 64  rn 0;.  }.  nOld
3920: 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63   = sqlite3Malloc
3930: 53 69 7a 65 28 70 4f 6c 64 29 3b 0a 20 20 6e 4e  Size(pOld);.  nN
3940: 65 77 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62  ew = sqlite3Glob
3950: 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78 52 6f 75 6e  alConfig.m.xRoun
3960: 64 75 70 28 6e 42 79 74 65 73 29 3b 0a 20 20 69  dup(nBytes);.  i
3970: 66 28 20 6e 4f 6c 64 3d 3d 6e 4e 65 77 20 29 7b  f( nOld==nNew ){
3980: 0a 20 20 20 20 70 4e 65 77 20 3d 20 70 4f 6c 64  .    pNew = pOld
3990: 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 73 71  ;.  }else if( sq
39a0: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69  lite3GlobalConfi
39b0: 67 2e 62 4d 65 6d 73 74 61 74 20 29 7b 0a 20 20  g.bMemstat ){.  
39c0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f    sqlite3_mutex_
39d0: 65 6e 74 65 72 28 6d 65 6d 30 2e 6d 75 74 65 78  enter(mem0.mutex
39e0: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 53 74  );.    sqlite3St
39f0: 61 74 75 73 53 65 74 28 53 51 4c 49 54 45 5f 53  atusSet(SQLITE_S
3a00: 54 41 54 55 53 5f 4d 41 4c 4c 4f 43 5f 53 49 5a  TATUS_MALLOC_SIZ
3a10: 45 2c 20 6e 42 79 74 65 73 29 3b 0a 20 20 20 20  E, nBytes);.    
3a20: 69 66 28 20 73 71 6c 69 74 65 33 53 74 61 74 75  if( sqlite3Statu
3a30: 73 56 61 6c 75 65 28 53 51 4c 49 54 45 5f 53 54  sValue(SQLITE_ST
3a40: 41 54 55 53 5f 4d 45 4d 4f 52 59 5f 55 53 45 44  ATUS_MEMORY_USED
3a50: 29 2b 6e 4e 65 77 2d 6e 4f 6c 64 20 3e 3d 20 0a  )+nNew-nOld >= .
3a60: 20 20 20 20 20 20 20 20 20 20 6d 65 6d 30 2e 61            mem0.a
3a70: 6c 61 72 6d 54 68 72 65 73 68 6f 6c 64 20 29 7b  larmThreshold ){
3a80: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 4d 61  .      sqlite3Ma
3a90: 6c 6c 6f 63 41 6c 61 72 6d 28 6e 4e 65 77 2d 6e  llocAlarm(nNew-n
3aa0: 4f 6c 64 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20  Old);.    }.    
3ab0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d  assert( sqlite3M
3ac0: 65 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 70  emdebugHasType(p
3ad0: 4f 6c 64 2c 20 4d 45 4d 54 59 50 45 5f 48 45 41  Old, MEMTYPE_HEA
3ae0: 50 29 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74  P) );.    assert
3af0: 28 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75  ( sqlite3Memdebu
3b00: 67 4e 6f 54 79 70 65 28 70 4f 6c 64 2c 20 7e 4d  gNoType(pOld, ~M
3b10: 45 4d 54 59 50 45 5f 48 45 41 50 29 20 29 3b 0a  EMTYPE_HEAP) );.
3b20: 20 20 20 20 70 4e 65 77 20 3d 20 73 71 6c 69 74      pNew = sqlit
3b30: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d  e3GlobalConfig.m
3b40: 2e 78 52 65 61 6c 6c 6f 63 28 70 4f 6c 64 2c 20  .xRealloc(pOld, 
3b50: 6e 4e 65 77 29 3b 0a 20 20 20 20 69 66 28 20 70  nNew);.    if( p
3b60: 4e 65 77 3d 3d 30 20 26 26 20 6d 65 6d 30 2e 61  New==0 && mem0.a
3b70: 6c 61 72 6d 43 61 6c 6c 62 61 63 6b 20 29 7b 0a  larmCallback ){.
3b80: 20 20 20 20 20 20 73 71 6c 69 74 65 33 4d 61 6c        sqlite3Mal
3b90: 6c 6f 63 41 6c 61 72 6d 28 6e 42 79 74 65 73 29  locAlarm(nBytes)
3ba0: 3b 0a 20 20 20 20 20 20 70 4e 65 77 20 3d 20 73  ;.      pNew = s
3bb0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66  qlite3GlobalConf
3bc0: 69 67 2e 6d 2e 78 52 65 61 6c 6c 6f 63 28 70 4f  ig.m.xRealloc(pO
3bd0: 6c 64 2c 20 6e 4e 65 77 29 3b 0a 20 20 20 20 7d  ld, nNew);.    }
3be0: 0a 20 20 20 20 69 66 28 20 70 4e 65 77 20 29 7b  .    if( pNew ){
3bf0: 0a 20 20 20 20 20 20 6e 4e 65 77 20 3d 20 73 71  .      nNew = sq
3c00: 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28  lite3MallocSize(
3c10: 70 4e 65 77 29 3b 0a 20 20 20 20 20 20 73 71 6c  pNew);.      sql
3c20: 69 74 65 33 53 74 61 74 75 73 41 64 64 28 53 51  ite3StatusAdd(SQ
3c30: 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d 45 4d 4f  LITE_STATUS_MEMO
3c40: 52 59 5f 55 53 45 44 2c 20 6e 4e 65 77 2d 6e 4f  RY_USED, nNew-nO
3c50: 6c 64 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73  ld);.    }.    s
3c60: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
3c70: 76 65 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a  ve(mem0.mutex);.
3c80: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 4e 65    }else{.    pNe
3c90: 77 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61  w = sqlite3Globa
3ca0: 6c 43 6f 6e 66 69 67 2e 6d 2e 78 52 65 61 6c 6c  lConfig.m.xReall
3cb0: 6f 63 28 70 4f 6c 64 2c 20 6e 4e 65 77 29 3b 0a  oc(pOld, nNew);.
3cc0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 4e 65    }.  return pNe
3cd0: 77 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20  w;.}../*.** The 
3ce0: 70 75 62 6c 69 63 20 69 6e 74 65 72 66 61 63 65  public interface
3cf0: 20 74 6f 20 73 71 6c 69 74 65 33 52 65 61 6c 6c   to sqlite3Reall
3d00: 6f 63 2e 20 20 4d 61 6b 65 20 73 75 72 65 20 74  oc.  Make sure t
3d10: 68 61 74 20 74 68 65 20 6d 65 6d 6f 72 79 0a 2a  hat the memory.*
3d20: 2a 20 73 75 62 73 79 73 74 65 6d 20 69 73 20 69  * subsystem is i
3d30: 6e 69 74 69 61 6c 69 7a 65 64 20 70 72 69 6f 72  nitialized prior
3d40: 20 74 6f 20 69 6e 76 6f 6b 69 6e 67 20 73 71 6c   to invoking sql
3d50: 69 74 65 52 65 61 6c 6c 6f 63 2e 0a 2a 2f 0a 76  iteRealloc..*/.v
3d60: 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 72 65 61  oid *sqlite3_rea
3d70: 6c 6c 6f 63 28 76 6f 69 64 20 2a 70 4f 6c 64 2c  lloc(void *pOld,
3d80: 20 69 6e 74 20 6e 29 7b 0a 23 69 66 6e 64 65 66   int n){.#ifndef
3d90: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54   SQLITE_OMIT_AUT
3da0: 4f 49 4e 49 54 0a 20 20 69 66 28 20 73 71 6c 69  OINIT.  if( sqli
3db0: 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29  te3_initialize()
3dc0: 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 23 65 6e   ) return 0;.#en
3dd0: 64 69 66 0a 20 20 72 65 74 75 72 6e 20 73 71 6c  dif.  return sql
3de0: 69 74 65 33 52 65 61 6c 6c 6f 63 28 70 4f 6c 64  ite3Realloc(pOld
3df0: 2c 20 6e 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20  , n);.}.../*.** 
3e00: 41 6c 6c 6f 63 61 74 65 20 61 6e 64 20 7a 65 72  Allocate and zer
3e10: 6f 20 6d 65 6d 6f 72 79 2e 0a 2a 2f 20 0a 76 6f  o memory..*/ .vo
3e20: 69 64 20 2a 73 71 6c 69 74 65 33 4d 61 6c 6c 6f  id *sqlite3Mallo
3e30: 63 5a 65 72 6f 28 69 6e 74 20 6e 29 7b 0a 20 20  cZero(int n){.  
3e40: 76 6f 69 64 20 2a 70 20 3d 20 73 71 6c 69 74 65  void *p = sqlite
3e50: 33 4d 61 6c 6c 6f 63 28 6e 29 3b 0a 20 20 69 66  3Malloc(n);.  if
3e60: 28 20 70 20 29 7b 0a 20 20 20 20 6d 65 6d 73 65  ( p ){.    memse
3e70: 74 28 70 2c 20 30 2c 20 6e 29 3b 0a 20 20 7d 0a  t(p, 0, n);.  }.
3e80: 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 2f    return p;.}../
3e90: 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 61 6e  *.** Allocate an
3ea0: 64 20 7a 65 72 6f 20 6d 65 6d 6f 72 79 2e 20 20  d zero memory.  
3eb0: 49 66 20 74 68 65 20 61 6c 6c 6f 63 61 74 69 6f  If the allocatio
3ec0: 6e 20 66 61 69 6c 73 2c 20 6d 61 6b 65 0a 2a 2a  n fails, make.**
3ed0: 20 74 68 65 20 6d 61 6c 6c 6f 63 46 61 69 6c 65   the mallocFaile
3ee0: 64 20 66 6c 61 67 20 69 6e 20 74 68 65 20 63 6f  d flag in the co
3ef0: 6e 6e 65 63 74 69 6f 6e 20 70 6f 69 6e 74 65 72  nnection pointer
3f00: 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74  ..*/.void *sqlit
3f10: 65 33 44 62 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73  e3DbMallocZero(s
3f20: 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20  qlite3 *db, int 
3f30: 6e 29 7b 0a 20 20 76 6f 69 64 20 2a 70 20 3d 20  n){.  void *p = 
3f40: 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 52  sqlite3DbMallocR
3f50: 61 77 28 64 62 2c 20 6e 29 3b 0a 20 20 69 66 28  aw(db, n);.  if(
3f60: 20 70 20 29 7b 0a 20 20 20 20 6d 65 6d 73 65 74   p ){.    memset
3f70: 28 70 2c 20 30 2c 20 6e 29 3b 0a 20 20 7d 0a 20  (p, 0, n);.  }. 
3f80: 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 2f 2a   return p;.}../*
3f90: 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 61 6e 64  .** Allocate and
3fa0: 20 7a 65 72 6f 20 6d 65 6d 6f 72 79 2e 20 20 49   zero memory.  I
3fb0: 66 20 74 68 65 20 61 6c 6c 6f 63 61 74 69 6f 6e  f the allocation
3fc0: 20 66 61 69 6c 73 2c 20 6d 61 6b 65 0a 2a 2a 20   fails, make.** 
3fd0: 74 68 65 20 6d 61 6c 6c 6f 63 46 61 69 6c 65 64  the mallocFailed
3fe0: 20 66 6c 61 67 20 69 6e 20 74 68 65 20 63 6f 6e   flag in the con
3ff0: 6e 65 63 74 69 6f 6e 20 70 6f 69 6e 74 65 72 2e  nection pointer.
4000: 0a 2a 2a 0a 2a 2a 20 49 66 20 64 62 21 3d 30 20  .**.** If db!=0 
4010: 61 6e 64 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61  and db->mallocFa
4020: 69 6c 65 64 20 69 73 20 74 72 75 65 20 28 69 6e  iled is true (in
4030: 64 69 63 61 74 69 6e 67 20 61 20 70 72 69 6f 72  dicating a prior
4040: 20 6d 61 6c 6c 6f 63 0a 2a 2a 20 66 61 69 6c 75   malloc.** failu
4050: 72 65 20 6f 6e 20 74 68 65 20 73 61 6d 65 20 64  re on the same d
4060: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69  atabase connecti
4070: 6f 6e 29 20 74 68 65 6e 20 61 6c 77 61 79 73 20  on) then always 
4080: 72 65 74 75 72 6e 20 30 2e 0a 2a 2a 20 48 65 6e  return 0..** Hen
4090: 63 65 20 66 6f 72 20 61 20 70 61 72 74 69 63 75  ce for a particu
40a0: 6c 61 72 20 64 61 74 61 62 61 73 65 20 63 6f 6e  lar database con
40b0: 6e 65 63 74 69 6f 6e 2c 20 6f 6e 63 65 20 6d 61  nection, once ma
40c0: 6c 6c 6f 63 20 73 74 61 72 74 73 0a 2a 2a 20 66  lloc starts.** f
40d0: 61 69 6c 69 6e 67 2c 20 69 74 20 66 61 69 6c 73  ailing, it fails
40e0: 20 63 6f 6e 73 69 73 74 65 6e 74 6c 79 20 75 6e   consistently un
40f0: 74 69 6c 20 6d 61 6c 6c 6f 63 46 61 69 6c 65 64  til mallocFailed
4100: 20 69 73 20 72 65 73 65 74 2e 0a 2a 2a 20 54 68   is reset..** Th
4110: 69 73 20 69 73 20 61 6e 20 69 6d 70 6f 72 74 61  is is an importa
4120: 6e 74 20 61 73 73 75 6d 70 74 69 6f 6e 2e 20 20  nt assumption.  
4130: 54 68 65 72 65 20 61 72 65 20 6d 61 6e 79 20 70  There are many p
4140: 6c 61 63 65 73 20 69 6e 20 74 68 65 0a 2a 2a 20  laces in the.** 
4150: 63 6f 64 65 20 74 68 61 74 20 64 6f 20 74 68 69  code that do thi
4160: 6e 67 73 20 6c 69 6b 65 20 74 68 69 73 3a 0a 2a  ngs like this:.*
4170: 2a 0a 2a 2a 20 20 20 20 20 20 20 20 20 69 6e 74  *.**         int
4180: 20 2a 61 20 3d 20 28 69 6e 74 2a 29 73 71 6c 69   *a = (int*)sqli
4190: 74 65 33 44 62 4d 61 6c 6c 6f 63 52 61 77 28 64  te3DbMallocRaw(d
41a0: 62 2c 20 31 30 30 29 3b 0a 2a 2a 20 20 20 20 20  b, 100);.**     
41b0: 20 20 20 20 69 6e 74 20 2a 62 20 3d 20 28 69 6e      int *b = (in
41c0: 74 2a 29 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c  t*)sqlite3DbMall
41d0: 6f 63 52 61 77 28 64 62 2c 20 32 30 30 29 3b 0a  ocRaw(db, 200);.
41e0: 2a 2a 20 20 20 20 20 20 20 20 20 69 66 28 20 62  **         if( b
41f0: 20 29 20 61 5b 31 30 5d 20 3d 20 39 3b 0a 2a 2a   ) a[10] = 9;.**
4200: 0a 2a 2a 20 49 6e 20 6f 74 68 65 72 20 77 6f 72  .** In other wor
4210: 64 73 2c 20 69 66 20 61 20 73 75 62 73 65 71 75  ds, if a subsequ
4220: 65 6e 74 20 6d 61 6c 6c 6f 63 20 28 65 78 3a 20  ent malloc (ex: 
4230: 22 62 22 29 20 77 6f 72 6b 65 64 2c 20 69 74 20  "b") worked, it 
4240: 69 73 20 61 73 73 75 6d 65 64 0a 2a 2a 20 74 68  is assumed.** th
4250: 61 74 20 61 6c 6c 20 70 72 69 6f 72 20 6d 61 6c  at all prior mal
4260: 6c 6f 63 73 20 28 65 78 3a 20 22 61 22 29 20 77  locs (ex: "a") w
4270: 6f 72 6b 65 64 20 74 6f 6f 2e 0a 2a 2f 0a 76 6f  orked too..*/.vo
4280: 69 64 20 2a 73 71 6c 69 74 65 33 44 62 4d 61 6c  id *sqlite3DbMal
4290: 6c 6f 63 52 61 77 28 73 71 6c 69 74 65 33 20 2a  locRaw(sqlite3 *
42a0: 64 62 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 76 6f  db, int n){.  vo
42b0: 69 64 20 2a 70 3b 0a 20 20 61 73 73 65 72 74 28  id *p;.  assert(
42c0: 20 64 62 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65   db==0 || sqlite
42d0: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d  3_mutex_held(db-
42e0: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73  >mutex) );.  ass
42f0: 65 72 74 28 20 64 62 3d 3d 30 20 7c 7c 20 64 62  ert( db==0 || db
4300: 2d 3e 70 6e 42 79 74 65 73 46 72 65 65 64 3d 3d  ->pnBytesFreed==
4310: 30 20 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c  0 );.#ifndef SQL
4320: 49 54 45 5f 4f 4d 49 54 5f 4c 4f 4f 4b 41 53 49  ITE_OMIT_LOOKASI
4330: 44 45 0a 20 20 69 66 28 20 64 62 20 29 7b 0a 20  DE.  if( db ){. 
4340: 20 20 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74     LookasideSlot
4350: 20 2a 70 42 75 66 3b 0a 20 20 20 20 69 66 28 20   *pBuf;.    if( 
4360: 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64  db->mallocFailed
4370: 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e   ){.      return
4380: 20 30 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66   0;.    }.    if
4390: 28 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e  ( db->lookaside.
43a0: 62 45 6e 61 62 6c 65 64 20 26 26 20 6e 3c 3d 64  bEnabled && n<=d
43b0: 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 73 7a 0a  b->lookaside.sz.
43c0: 20 20 20 20 20 20 20 20 20 26 26 20 28 70 42 75           && (pBu
43d0: 66 20 3d 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64  f = db->lookasid
43e0: 65 2e 70 46 72 65 65 29 21 3d 30 20 29 7b 0a 20  e.pFree)!=0 ){. 
43f0: 20 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69       db->lookasi
4400: 64 65 2e 70 46 72 65 65 20 3d 20 70 42 75 66 2d  de.pFree = pBuf-
4410: 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 64 62  >pNext;.      db
4420: 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 6e 4f 75 74  ->lookaside.nOut
4430: 2b 2b 3b 0a 20 20 20 20 20 20 69 66 28 20 64 62  ++;.      if( db
4440: 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 6e 4f 75 74  ->lookaside.nOut
4450: 3e 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 6d  >db->lookaside.m
4460: 78 4f 75 74 20 29 7b 0a 20 20 20 20 20 20 20 20  xOut ){.        
4470: 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 6d 78  db->lookaside.mx
4480: 4f 75 74 20 3d 20 64 62 2d 3e 6c 6f 6f 6b 61 73  Out = db->lookas
4490: 69 64 65 2e 6e 4f 75 74 3b 0a 20 20 20 20 20 20  ide.nOut;.      
44a0: 7d 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 28  }.      return (
44b0: 76 6f 69 64 2a 29 70 42 75 66 3b 0a 20 20 20 20  void*)pBuf;.    
44c0: 7d 0a 20 20 7d 0a 23 65 6c 73 65 0a 20 20 69 66  }.  }.#else.  if
44d0: 28 20 64 62 20 26 26 20 64 62 2d 3e 6d 61 6c 6c  ( db && db->mall
44e0: 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 20 20  ocFailed ){.    
44f0: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 65  return 0;.  }.#e
4500: 6e 64 69 66 0a 20 20 70 20 3d 20 73 71 6c 69 74  ndif.  p = sqlit
4510: 65 33 4d 61 6c 6c 6f 63 28 6e 29 3b 0a 20 20 69  e3Malloc(n);.  i
4520: 66 28 20 21 70 20 26 26 20 64 62 20 29 7b 0a 20  f( !p && db ){. 
4530: 20 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69     db->mallocFai
4540: 6c 65 64 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 73  led = 1;.  }.  s
4550: 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 53 65  qlite3MemdebugSe
4560: 74 54 79 70 65 28 70 2c 20 4d 45 4d 54 59 50 45  tType(p, MEMTYPE
4570: 5f 44 42 20 7c 0a 20 20 20 20 20 20 20 20 20 28  _DB |.         (
4580: 28 64 62 20 26 26 20 64 62 2d 3e 6c 6f 6f 6b 61  (db && db->looka
4590: 73 69 64 65 2e 62 45 6e 61 62 6c 65 64 29 20 3f  side.bEnabled) ?
45a0: 20 4d 45 4d 54 59 50 45 5f 4c 4f 4f 4b 41 53 49   MEMTYPE_LOOKASI
45b0: 44 45 20 3a 20 4d 45 4d 54 59 50 45 5f 48 45 41  DE : MEMTYPE_HEA
45c0: 50 29 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 3b  P));.  return p;
45d0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 73 69 7a 65  .}../*.** Resize
45e0: 20 74 68 65 20 62 6c 6f 63 6b 20 6f 66 20 6d 65   the block of me
45f0: 6d 6f 72 79 20 70 6f 69 6e 74 65 64 20 74 6f 20  mory pointed to 
4600: 62 79 20 70 20 74 6f 20 6e 20 62 79 74 65 73 2e  by p to n bytes.
4610: 20 49 66 20 74 68 65 0a 2a 2a 20 72 65 73 69 7a   If the.** resiz
4620: 65 20 66 61 69 6c 73 2c 20 73 65 74 20 74 68 65  e fails, set the
4630: 20 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 66 6c   mallocFailed fl
4640: 61 67 20 69 6e 20 74 68 65 20 63 6f 6e 6e 65 63  ag in the connec
4650: 74 69 6f 6e 20 6f 62 6a 65 63 74 2e 0a 2a 2f 0a  tion object..*/.
4660: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 44 62 52  void *sqlite3DbR
4670: 65 61 6c 6c 6f 63 28 73 71 6c 69 74 65 33 20 2a  ealloc(sqlite3 *
4680: 64 62 2c 20 76 6f 69 64 20 2a 70 2c 20 69 6e 74  db, void *p, int
4690: 20 6e 29 7b 0a 20 20 76 6f 69 64 20 2a 70 4e 65   n){.  void *pNe
46a0: 77 20 3d 20 30 3b 0a 20 20 61 73 73 65 72 74 28  w = 0;.  assert(
46b0: 20 64 62 21 3d 30 20 29 3b 0a 20 20 61 73 73 65   db!=0 );.  asse
46c0: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  rt( sqlite3_mute
46d0: 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78  x_held(db->mutex
46e0: 29 20 29 3b 0a 20 20 69 66 28 20 64 62 2d 3e 6d  ) );.  if( db->m
46f0: 61 6c 6c 6f 63 46 61 69 6c 65 64 3d 3d 30 20 29  allocFailed==0 )
4700: 7b 0a 20 20 20 20 69 66 28 20 70 3d 3d 30 20 29  {.    if( p==0 )
4710: 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 73  {.      return s
4720: 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 52 61  qlite3DbMallocRa
4730: 77 28 64 62 2c 20 6e 29 3b 0a 20 20 20 20 7d 0a  w(db, n);.    }.
4740: 20 20 20 20 69 66 28 20 69 73 4c 6f 6f 6b 61 73      if( isLookas
4750: 69 64 65 28 64 62 2c 20 70 29 20 29 7b 0a 20 20  ide(db, p) ){.  
4760: 20 20 20 20 69 66 28 20 6e 3c 3d 64 62 2d 3e 6c      if( n<=db->l
4770: 6f 6f 6b 61 73 69 64 65 2e 73 7a 20 29 7b 0a 20  ookaside.sz ){. 
4780: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 70 3b         return p;
4790: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70  .      }.      p
47a0: 4e 65 77 20 3d 20 73 71 6c 69 74 65 33 44 62 4d  New = sqlite3DbM
47b0: 61 6c 6c 6f 63 52 61 77 28 64 62 2c 20 6e 29 3b  allocRaw(db, n);
47c0: 0a 20 20 20 20 20 20 69 66 28 20 70 4e 65 77 20  .      if( pNew 
47d0: 29 7b 0a 20 20 20 20 20 20 20 20 6d 65 6d 63 70  ){.        memcp
47e0: 79 28 70 4e 65 77 2c 20 70 2c 20 64 62 2d 3e 6c  y(pNew, p, db->l
47f0: 6f 6f 6b 61 73 69 64 65 2e 73 7a 29 3b 0a 20 20  ookaside.sz);.  
4800: 20 20 20 20 20 20 73 71 6c 69 74 65 33 44 62 46        sqlite3DbF
4810: 72 65 65 28 64 62 2c 20 70 29 3b 0a 20 20 20 20  ree(db, p);.    
4820: 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20    }.    }else{. 
4830: 20 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c       assert( sql
4840: 69 74 65 33 4d 65 6d 64 65 62 75 67 48 61 73 54  ite3MemdebugHasT
4850: 79 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 44  ype(p, MEMTYPE_D
4860: 42 29 20 29 3b 0a 20 20 20 20 20 20 61 73 73 65  B) );.      asse
4870: 72 74 28 20 73 71 6c 69 74 65 33 4d 65 6d 64 65  rt( sqlite3Memde
4880: 62 75 67 48 61 73 54 79 70 65 28 70 2c 20 4d 45  bugHasType(p, ME
4890: 4d 54 59 50 45 5f 4c 4f 4f 4b 41 53 49 44 45 7c  MTYPE_LOOKASIDE|
48a0: 4d 45 4d 54 59 50 45 5f 48 45 41 50 29 20 29 3b  MEMTYPE_HEAP) );
48b0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 4d 65  .      sqlite3Me
48c0: 6d 64 65 62 75 67 53 65 74 54 79 70 65 28 70 2c  mdebugSetType(p,
48d0: 20 4d 45 4d 54 59 50 45 5f 48 45 41 50 29 3b 0a   MEMTYPE_HEAP);.
48e0: 20 20 20 20 20 20 70 4e 65 77 20 3d 20 73 71 6c        pNew = sql
48f0: 69 74 65 33 5f 72 65 61 6c 6c 6f 63 28 70 2c 20  ite3_realloc(p, 
4900: 6e 29 3b 0a 20 20 20 20 20 20 69 66 28 20 21 70  n);.      if( !p
4910: 4e 65 77 20 29 7b 0a 20 20 20 20 20 20 20 20 73  New ){.        s
4920: 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 53 65  qlite3MemdebugSe
4930: 74 54 79 70 65 28 70 2c 20 4d 45 4d 54 59 50 45  tType(p, MEMTYPE
4940: 5f 44 42 7c 4d 45 4d 54 59 50 45 5f 48 45 41 50  _DB|MEMTYPE_HEAP
4950: 29 3b 0a 20 20 20 20 20 20 20 20 64 62 2d 3e 6d  );.        db->m
4960: 61 6c 6c 6f 63 46 61 69 6c 65 64 20 3d 20 31 3b  allocFailed = 1;
4970: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 73  .      }.      s
4980: 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 53 65  qlite3MemdebugSe
4990: 74 54 79 70 65 28 70 4e 65 77 2c 20 4d 45 4d 54  tType(pNew, MEMT
49a0: 59 50 45 5f 44 42 20 7c 20 0a 20 20 20 20 20 20  YPE_DB | .      
49b0: 20 20 20 20 20 20 28 64 62 2d 3e 6c 6f 6f 6b 61        (db->looka
49c0: 73 69 64 65 2e 62 45 6e 61 62 6c 65 64 20 3f 20  side.bEnabled ? 
49d0: 4d 45 4d 54 59 50 45 5f 4c 4f 4f 4b 41 53 49 44  MEMTYPE_LOOKASID
49e0: 45 20 3a 20 4d 45 4d 54 59 50 45 5f 48 45 41 50  E : MEMTYPE_HEAP
49f0: 29 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20  ));.    }.  }.  
4a00: 72 65 74 75 72 6e 20 70 4e 65 77 3b 0a 7d 0a 0a  return pNew;.}..
4a10: 2f 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f  /*.** Attempt to
4a20: 20 72 65 61 6c 6c 6f 63 61 74 65 20 70 2e 20 20   reallocate p.  
4a30: 49 66 20 74 68 65 20 72 65 61 6c 6c 6f 63 61 74  If the reallocat
4a40: 69 6f 6e 20 66 61 69 6c 73 2c 20 74 68 65 6e 20  ion fails, then 
4a50: 66 72 65 65 20 70 0a 2a 2a 20 61 6e 64 20 73 65  free p.** and se
4a60: 74 20 74 68 65 20 6d 61 6c 6c 6f 63 46 61 69 6c  t the mallocFail
4a70: 65 64 20 66 6c 61 67 20 69 6e 20 74 68 65 20 64  ed flag in the d
4a80: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69  atabase connecti
4a90: 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c  on..*/.void *sql
4aa0: 69 74 65 33 44 62 52 65 61 6c 6c 6f 63 4f 72 46  ite3DbReallocOrF
4ab0: 72 65 65 28 73 71 6c 69 74 65 33 20 2a 64 62 2c  ree(sqlite3 *db,
4ac0: 20 76 6f 69 64 20 2a 70 2c 20 69 6e 74 20 6e 29   void *p, int n)
4ad0: 7b 0a 20 20 76 6f 69 64 20 2a 70 4e 65 77 3b 0a  {.  void *pNew;.
4ae0: 20 20 70 4e 65 77 20 3d 20 73 71 6c 69 74 65 33    pNew = sqlite3
4af0: 44 62 52 65 61 6c 6c 6f 63 28 64 62 2c 20 70 2c  DbRealloc(db, p,
4b00: 20 6e 29 3b 0a 20 20 69 66 28 20 21 70 4e 65 77   n);.  if( !pNew
4b10: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 44   ){.    sqlite3D
4b20: 62 46 72 65 65 28 64 62 2c 20 70 29 3b 0a 20 20  bFree(db, p);.  
4b30: 7d 0a 20 20 72 65 74 75 72 6e 20 70 4e 65 77 3b  }.  return pNew;
4b40: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b 65 20 61  .}../*.** Make a
4b50: 20 63 6f 70 79 20 6f 66 20 61 20 73 74 72 69 6e   copy of a strin
4b60: 67 20 69 6e 20 6d 65 6d 6f 72 79 20 6f 62 74 61  g in memory obta
4b70: 69 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 65  ined from sqlite
4b80: 4d 61 6c 6c 6f 63 28 29 2e 20 54 68 65 73 65 20  Malloc(). These 
4b90: 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 73 20 63 61  .** functions ca
4ba0: 6c 6c 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63  ll sqlite3Malloc
4bb0: 52 61 77 28 29 20 64 69 72 65 63 74 6c 79 20 69  Raw() directly i
4bc0: 6e 73 74 65 61 64 20 6f 66 20 73 71 6c 69 74 65  nstead of sqlite
4bd0: 4d 61 6c 6c 6f 63 28 29 2e 20 54 68 69 73 0a 2a  Malloc(). This.*
4be0: 2a 20 69 73 20 62 65 63 61 75 73 65 20 77 68 65  * is because whe
4bf0: 6e 20 6d 65 6d 6f 72 79 20 64 65 62 75 67 67 69  n memory debuggi
4c00: 6e 67 20 69 73 20 74 75 72 6e 65 64 20 6f 6e 2c  ng is turned on,
4c10: 20 74 68 65 73 65 20 74 77 6f 20 66 75 6e 63 74   these two funct
4c20: 69 6f 6e 73 20 61 72 65 20 0a 2a 2a 20 63 61 6c  ions are .** cal
4c30: 6c 65 64 20 76 69 61 20 6d 61 63 72 6f 73 20 74  led via macros t
4c40: 68 61 74 20 72 65 63 6f 72 64 20 74 68 65 20 63  hat record the c
4c50: 75 72 72 65 6e 74 20 66 69 6c 65 20 61 6e 64 20  urrent file and 
4c60: 6c 69 6e 65 20 6e 75 6d 62 65 72 20 69 6e 20 74  line number in t
4c70: 68 65 0a 2a 2a 20 54 68 72 65 61 64 44 61 74 61  he.** ThreadData
4c80: 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 63   structure..*/.c
4c90: 68 61 72 20 2a 73 71 6c 69 74 65 33 44 62 53 74  har *sqlite3DbSt
4ca0: 72 44 75 70 28 73 71 6c 69 74 65 33 20 2a 64 62  rDup(sqlite3 *db
4cb0: 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 29  , const char *z)
4cc0: 7b 0a 20 20 63 68 61 72 20 2a 7a 4e 65 77 3b 0a  {.  char *zNew;.
4cd0: 20 20 73 69 7a 65 5f 74 20 6e 3b 0a 20 20 69 66    size_t n;.  if
4ce0: 28 20 7a 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65  ( z==0 ){.    re
4cf0: 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 6e 20  turn 0;.  }.  n 
4d00: 3d 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33  = sqlite3Strlen3
4d10: 30 28 7a 29 20 2b 20 31 3b 0a 20 20 61 73 73 65  0(z) + 1;.  asse
4d20: 72 74 28 20 28 6e 26 30 78 37 66 66 66 66 66 66  rt( (n&0x7ffffff
4d30: 66 29 3d 3d 6e 20 29 3b 0a 20 20 7a 4e 65 77 20  f)==n );.  zNew 
4d40: 3d 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f  = sqlite3DbMallo
4d50: 63 52 61 77 28 64 62 2c 20 28 69 6e 74 29 6e 29  cRaw(db, (int)n)
4d60: 3b 0a 20 20 69 66 28 20 7a 4e 65 77 20 29 7b 0a  ;.  if( zNew ){.
4d70: 20 20 20 20 6d 65 6d 63 70 79 28 7a 4e 65 77 2c      memcpy(zNew,
4d80: 20 7a 2c 20 6e 29 3b 0a 20 20 7d 0a 20 20 72 65   z, n);.  }.  re
4d90: 74 75 72 6e 20 7a 4e 65 77 3b 0a 7d 0a 63 68 61  turn zNew;.}.cha
4da0: 72 20 2a 73 71 6c 69 74 65 33 44 62 53 74 72 4e  r *sqlite3DbStrN
4db0: 44 75 70 28 73 71 6c 69 74 65 33 20 2a 64 62 2c  Dup(sqlite3 *db,
4dc0: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 2c 20   const char *z, 
4dd0: 69 6e 74 20 6e 29 7b 0a 20 20 63 68 61 72 20 2a  int n){.  char *
4de0: 7a 4e 65 77 3b 0a 20 20 69 66 28 20 7a 3d 3d 30  zNew;.  if( z==0
4df0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30   ){.    return 0
4e00: 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20  ;.  }.  assert( 
4e10: 28 6e 26 30 78 37 66 66 66 66 66 66 66 29 3d 3d  (n&0x7fffffff)==
4e20: 6e 20 29 3b 0a 20 20 7a 4e 65 77 20 3d 20 73 71  n );.  zNew = sq
4e30: 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 52 61 77  lite3DbMallocRaw
4e40: 28 64 62 2c 20 6e 2b 31 29 3b 0a 20 20 69 66 28  (db, n+1);.  if(
4e50: 20 7a 4e 65 77 20 29 7b 0a 20 20 20 20 6d 65 6d   zNew ){.    mem
4e60: 63 70 79 28 7a 4e 65 77 2c 20 7a 2c 20 6e 29 3b  cpy(zNew, z, n);
4e70: 0a 20 20 20 20 7a 4e 65 77 5b 6e 5d 20 3d 20 30  .    zNew[n] = 0
4e80: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 7a  ;.  }.  return z
4e90: 4e 65 77 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72  New;.}../*.** Cr
4ea0: 65 61 74 65 20 61 20 73 74 72 69 6e 67 20 66 72  eate a string fr
4eb0: 6f 6d 20 74 68 65 20 7a 46 72 6f 6d 61 74 20 61  om the zFromat a
4ec0: 72 67 75 6d 65 6e 74 20 61 6e 64 20 74 68 65 20  rgument and the 
4ed0: 76 61 5f 6c 69 73 74 20 74 68 61 74 20 66 6f 6c  va_list that fol
4ee0: 6c 6f 77 73 2e 0a 2a 2a 20 53 74 6f 72 65 20 74  lows..** Store t
4ef0: 68 65 20 73 74 72 69 6e 67 20 69 6e 20 6d 65 6d  he string in mem
4f00: 6f 72 79 20 6f 62 74 61 69 6e 65 64 20 66 72 6f  ory obtained fro
4f10: 6d 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 29  m sqliteMalloc()
4f20: 20 61 6e 64 20 6d 61 6b 65 20 2a 70 7a 0a 2a 2a   and make *pz.**
4f30: 20 70 6f 69 6e 74 20 74 6f 20 74 68 61 74 20 73   point to that s
4f40: 74 72 69 6e 67 2e 0a 2a 2f 0a 76 6f 69 64 20 73  tring..*/.void s
4f50: 71 6c 69 74 65 33 53 65 74 53 74 72 69 6e 67 28  qlite3SetString(
4f60: 63 68 61 72 20 2a 2a 70 7a 2c 20 73 71 6c 69 74  char **pz, sqlit
4f70: 65 33 20 2a 64 62 2c 20 63 6f 6e 73 74 20 63 68  e3 *db, const ch
4f80: 61 72 20 2a 7a 46 6f 72 6d 61 74 2c 20 2e 2e 2e  ar *zFormat, ...
4f90: 29 7b 0a 20 20 76 61 5f 6c 69 73 74 20 61 70 3b  ){.  va_list ap;
4fa0: 0a 20 20 63 68 61 72 20 2a 7a 3b 0a 0a 20 20 76  .  char *z;..  v
4fb0: 61 5f 73 74 61 72 74 28 61 70 2c 20 7a 46 6f 72  a_start(ap, zFor
4fc0: 6d 61 74 29 3b 0a 20 20 7a 20 3d 20 73 71 6c 69  mat);.  z = sqli
4fd0: 74 65 33 56 4d 50 72 69 6e 74 66 28 64 62 2c 20  te3VMPrintf(db, 
4fe0: 7a 46 6f 72 6d 61 74 2c 20 61 70 29 3b 0a 20 20  zFormat, ap);.  
4ff0: 76 61 5f 65 6e 64 28 61 70 29 3b 0a 20 20 73 71  va_end(ap);.  sq
5000: 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20  lite3DbFree(db, 
5010: 2a 70 7a 29 3b 0a 20 20 2a 70 7a 20 3d 20 7a 3b  *pz);.  *pz = z;
5020: 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  .}.../*.** This 
5030: 66 75 6e 63 74 69 6f 6e 20 6d 75 73 74 20 62 65  function must be
5040: 20 63 61 6c 6c 65 64 20 62 65 66 6f 72 65 20 65   called before e
5050: 78 69 74 69 6e 67 20 61 6e 79 20 41 50 49 20 66  xiting any API f
5060: 75 6e 63 74 69 6f 6e 20 28 69 2e 65 2e 20 0a 2a  unction (i.e. .*
5070: 2a 20 72 65 74 75 72 6e 69 6e 67 20 63 6f 6e 74  * returning cont
5080: 72 6f 6c 20 74 6f 20 74 68 65 20 75 73 65 72 29  rol to the user)
5090: 20 74 68 61 74 20 68 61 73 20 63 61 6c 6c 65 64   that has called
50a0: 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 20   sqlite3_malloc 
50b0: 6f 72 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 72 65  or.** sqlite3_re
50c0: 61 6c 6c 6f 63 2e 0a 2a 2a 0a 2a 2a 20 54 68 65  alloc..**.** The
50d0: 20 72 65 74 75 72 6e 65 64 20 76 61 6c 75 65 20   returned value 
50e0: 69 73 20 6e 6f 72 6d 61 6c 6c 79 20 61 20 63 6f  is normally a co
50f0: 70 79 20 6f 66 20 74 68 65 20 73 65 63 6f 6e 64  py of the second
5100: 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 69   argument to thi
5110: 73 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 2e 20 48  s.** function. H
5120: 6f 77 65 76 65 72 2c 20 69 66 20 61 20 6d 61 6c  owever, if a mal
5130: 6c 6f 63 28 29 20 66 61 69 6c 75 72 65 20 68 61  loc() failure ha
5140: 73 20 6f 63 63 75 72 72 65 64 20 73 69 6e 63 65  s occurred since
5150: 20 74 68 65 20 70 72 65 76 69 6f 75 73 0a 2a 2a   the previous.**
5160: 20 69 6e 76 6f 63 61 74 69 6f 6e 20 53 51 4c 49   invocation SQLI
5170: 54 45 5f 4e 4f 4d 45 4d 20 69 73 20 72 65 74 75  TE_NOMEM is retu
5180: 72 6e 65 64 20 69 6e 73 74 65 61 64 2e 20 0a 2a  rned instead. .*
5190: 2a 0a 2a 2a 20 49 66 20 74 68 65 20 66 69 72 73  *.** If the firs
51a0: 74 20 61 72 67 75 6d 65 6e 74 2c 20 64 62 2c 20  t argument, db, 
51b0: 69 73 20 6e 6f 74 20 4e 55 4c 4c 20 61 6e 64 20  is not NULL and 
51c0: 61 20 6d 61 6c 6c 6f 63 28 29 20 65 72 72 6f 72  a malloc() error
51d0: 20 68 61 73 20 6f 63 63 75 72 72 65 64 2c 0a 2a   has occurred,.*
51e0: 2a 20 74 68 65 6e 20 74 68 65 20 63 6f 6e 6e 65  * then the conne
51f0: 63 74 69 6f 6e 20 65 72 72 6f 72 2d 63 6f 64 65  ction error-code
5200: 20 28 74 68 65 20 76 61 6c 75 65 20 72 65 74 75   (the value retu
5210: 72 6e 65 64 20 62 79 20 73 71 6c 69 74 65 33 5f  rned by sqlite3_
5220: 65 72 72 63 6f 64 65 28 29 29 0a 2a 2a 20 69 73  errcode()).** is
5230: 20 73 65 74 20 74 6f 20 53 51 4c 49 54 45 5f 4e   set to SQLITE_N
5240: 4f 4d 45 4d 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  OMEM..*/.int sql
5250: 69 74 65 33 41 70 69 45 78 69 74 28 73 71 6c 69  ite3ApiExit(sqli
5260: 74 65 33 2a 20 64 62 2c 20 69 6e 74 20 72 63 29  te3* db, int rc)
5270: 7b 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 64 62  {.  /* If the db
5280: 20 68 61 6e 64 6c 65 20 69 73 20 6e 6f 74 20 4e   handle is not N
5290: 55 4c 4c 2c 20 74 68 65 6e 20 77 65 20 6d 75 73  ULL, then we mus
52a0: 74 20 68 6f 6c 64 20 74 68 65 20 63 6f 6e 6e 65  t hold the conne
52b0: 63 74 69 6f 6e 20 68 61 6e 64 6c 65 0a 20 20 2a  ction handle.  *
52c0: 2a 20 6d 75 74 65 78 20 68 65 72 65 2e 20 4f 74  * mutex here. Ot
52d0: 68 65 72 77 69 73 65 20 74 68 65 20 72 65 61 64  herwise the read
52e0: 20 28 61 6e 64 20 70 6f 73 73 69 62 6c 65 20 77   (and possible w
52f0: 72 69 74 65 29 20 6f 66 20 64 62 2d 3e 6d 61 6c  rite) of db->mal
5300: 6c 6f 63 46 61 69 6c 65 64 20 0a 20 20 2a 2a 20  locFailed .  ** 
5310: 69 73 20 75 6e 73 61 66 65 2c 20 61 73 20 69 73  is unsafe, as is
5320: 20 74 68 65 20 63 61 6c 6c 20 74 6f 20 73 71 6c   the call to sql
5330: 69 74 65 33 45 72 72 6f 72 28 29 2e 0a 20 20 2a  ite3Error()..  *
5340: 2f 0a 20 20 61 73 73 65 72 74 28 20 21 64 62 20  /.  assert( !db 
5350: 7c 7c 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  || sqlite3_mutex
5360: 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29  _held(db->mutex)
5370: 20 29 3b 0a 20 20 69 66 28 20 64 62 20 26 26 20   );.  if( db && 
5380: 28 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65  (db->mallocFaile
5390: 64 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f  d || rc==SQLITE_
53a0: 49 4f 45 52 52 5f 4e 4f 4d 45 4d 29 20 29 7b 0a  IOERR_NOMEM) ){.
53b0: 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72      sqlite3Error
53c0: 28 64 62 2c 20 53 51 4c 49 54 45 5f 4e 4f 4d 45  (db, SQLITE_NOME
53d0: 4d 2c 20 30 29 3b 0a 20 20 20 20 64 62 2d 3e 6d  M, 0);.    db->m
53e0: 61 6c 6c 6f 63 46 61 69 6c 65 64 20 3d 20 30 3b  allocFailed = 0;
53f0: 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45  .    rc = SQLITE
5400: 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 72 65  _NOMEM;.  }.  re
5410: 74 75 72 6e 20 72 63 20 26 20 28 64 62 20 3f 20  turn rc & (db ? 
5420: 64 62 2d 3e 65 72 72 4d 61 73 6b 20 3a 20 30 78  db->errMask : 0x
5430: 66 66 29 3b 0a 7d 0a                             ff);.}.