/ Hex Artifact Content
Login

Artifact 57121e3ef46431b95a73651f9b5653f96867e358:


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 41 74 74 65 6d 70 74 20 74 6f  /*.** Attempt to
01f0: 20 72 65 6c 65 61 73 65 20 75 70 20 74 6f 20 6e   release up to n
0200: 20 62 79 74 65 73 20 6f 66 20 6e 6f 6e 2d 65 73   bytes of non-es
0210: 73 65 6e 74 69 61 6c 20 6d 65 6d 6f 72 79 20 63  sential memory c
0220: 75 72 72 65 6e 74 6c 79 0a 2a 2a 20 68 65 6c 64  urrently.** held
0230: 20 62 79 20 53 51 4c 69 74 65 2e 20 41 6e 20 65   by SQLite. An e
0240: 78 61 6d 70 6c 65 20 6f 66 20 6e 6f 6e 2d 65 73  xample of non-es
0250: 73 65 6e 74 69 61 6c 20 6d 65 6d 6f 72 79 20 69  sential memory i
0260: 73 20 6d 65 6d 6f 72 79 20 75 73 65 64 20 74 6f  s memory used to
0270: 0a 2a 2a 20 63 61 63 68 65 20 64 61 74 61 62 61  .** cache databa
0280: 73 65 20 70 61 67 65 73 20 74 68 61 74 20 61 72  se pages that ar
0290: 65 20 6e 6f 74 20 63 75 72 72 65 6e 74 6c 79 20  e not currently 
02a0: 69 6e 20 75 73 65 2e 0a 2a 2f 0a 69 6e 74 20 73  in use..*/.int s
02b0: 71 6c 69 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d  qlite3_release_m
02c0: 65 6d 6f 72 79 28 69 6e 74 20 6e 29 7b 0a 23 69  emory(int n){.#i
02d0: 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42  fdef SQLITE_ENAB
02e0: 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45  LE_MEMORY_MANAGE
02f0: 4d 45 4e 54 0a 20 20 72 65 74 75 72 6e 20 73 71  MENT.  return sq
0300: 6c 69 74 65 33 50 63 61 63 68 65 52 65 6c 65 61  lite3PcacheRelea
0310: 73 65 4d 65 6d 6f 72 79 28 6e 29 3b 0a 23 65 6c  seMemory(n);.#el
0320: 73 65 0a 20 20 2f 2a 20 49 4d 50 4c 45 4d 45 4e  se.  /* IMPLEMEN
0330: 54 41 54 49 4f 4e 2d 4f 46 3a 20 52 2d 33 34 33  TATION-OF: R-343
0340: 39 31 2d 32 34 39 32 31 20 54 68 65 20 73 71 6c  91-24921 The sql
0350: 69 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d  ite3_release_mem
0360: 6f 72 79 28 29 20 72 6f 75 74 69 6e 65 0a 20 20  ory() routine.  
0370: 2a 2a 20 69 73 20 61 20 6e 6f 2d 6f 70 20 72 65  ** is a no-op re
0380: 74 75 72 6e 69 6e 67 20 7a 65 72 6f 20 69 66 20  turning zero if 
0390: 53 51 4c 69 74 65 20 69 73 20 6e 6f 74 20 63 6f  SQLite is not co
03a0: 6d 70 69 6c 65 64 20 77 69 74 68 0a 20 20 2a 2a  mpiled with.  **
03b0: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d   SQLITE_ENABLE_M
03c0: 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54  EMORY_MANAGEMENT
03d0: 2e 20 2a 2f 0a 20 20 55 4e 55 53 45 44 5f 50 41  . */.  UNUSED_PA
03e0: 52 41 4d 45 54 45 52 28 6e 29 3b 0a 20 20 72 65  RAMETER(n);.  re
03f0: 74 75 72 6e 20 30 3b 0a 23 65 6e 64 69 66 0a 7d  turn 0;.#endif.}
0400: 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61  ../*.** An insta
0410: 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f  nce of the follo
0420: 77 69 6e 67 20 6f 62 6a 65 63 74 20 72 65 63 6f  wing object reco
0430: 72 64 73 20 74 68 65 20 6c 6f 63 61 74 69 6f 6e  rds the location
0440: 20 6f 66 0a 2a 2a 20 65 61 63 68 20 75 6e 75 73   of.** each unus
0450: 65 64 20 73 63 72 61 74 63 68 20 62 75 66 66 65  ed scratch buffe
0460: 72 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74  r..*/.typedef st
0470: 72 75 63 74 20 53 63 72 61 74 63 68 46 72 65 65  ruct ScratchFree
0480: 73 6c 6f 74 20 7b 0a 20 20 73 74 72 75 63 74 20  slot {.  struct 
0490: 53 63 72 61 74 63 68 46 72 65 65 73 6c 6f 74 20  ScratchFreeslot 
04a0: 2a 70 4e 65 78 74 3b 20 20 20 2f 2a 20 4e 65 78  *pNext;   /* Nex
04b0: 74 20 75 6e 75 73 65 64 20 73 63 72 61 74 63 68  t unused scratch
04c0: 20 62 75 66 66 65 72 20 2a 2f 0a 7d 20 53 63 72   buffer */.} Scr
04d0: 61 74 63 68 46 72 65 65 73 6c 6f 74 3b 0a 0a 2f  atchFreeslot;../
04e0: 2a 0a 2a 2a 20 53 74 61 74 65 20 69 6e 66 6f 72  *.** State infor
04f0: 6d 61 74 69 6f 6e 20 6c 6f 63 61 6c 20 74 6f 20  mation local to 
0500: 74 68 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63  the memory alloc
0510: 61 74 69 6f 6e 20 73 75 62 73 79 73 74 65 6d 2e  ation subsystem.
0520: 0a 2a 2f 0a 73 74 61 74 69 63 20 53 51 4c 49 54  .*/.static SQLIT
0530: 45 5f 57 53 44 20 73 74 72 75 63 74 20 4d 65 6d  E_WSD struct Mem
0540: 30 47 6c 6f 62 61 6c 20 7b 0a 20 20 73 71 6c 69  0Global {.  sqli
0550: 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78  te3_mutex *mutex
0560: 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 75 74  ;         /* Mut
0570: 65 78 20 74 6f 20 73 65 72 69 61 6c 69 7a 65 20  ex to serialize 
0580: 61 63 63 65 73 73 20 2a 2f 0a 0a 20 20 2f 2a 0a  access */..  /*.
0590: 20 20 2a 2a 20 54 68 65 20 61 6c 61 72 6d 20 63    ** The alarm c
05a0: 61 6c 6c 62 61 63 6b 20 61 6e 64 20 69 74 73 20  allback and its 
05b0: 61 72 67 75 6d 65 6e 74 73 2e 20 20 54 68 65 20  arguments.  The 
05c0: 6d 65 6d 30 2e 6d 75 74 65 78 20 6c 6f 63 6b 20  mem0.mutex lock 
05d0: 77 69 6c 6c 0a 20 20 2a 2a 20 62 65 20 68 65 6c  will.  ** be hel
05e0: 64 20 77 68 69 6c 65 20 74 68 65 20 63 61 6c 6c  d while the call
05f0: 62 61 63 6b 20 69 73 20 72 75 6e 6e 69 6e 67 2e  back is running.
0600: 20 20 52 65 63 75 72 73 69 76 65 20 63 61 6c 6c    Recursive call
0610: 73 20 69 6e 74 6f 0a 20 20 2a 2a 20 74 68 65 20  s into.  ** the 
0620: 6d 65 6d 6f 72 79 20 73 75 62 73 79 73 74 65 6d  memory subsystem
0630: 20 61 72 65 20 61 6c 6c 6f 77 65 64 2c 20 62 75   are allowed, bu
0640: 74 20 6e 6f 20 6e 65 77 20 63 61 6c 6c 62 61 63  t no new callbac
0650: 6b 73 20 77 69 6c 6c 20 62 65 0a 20 20 2a 2a 20  ks will be.  ** 
0660: 69 73 73 75 65 64 2e 0a 20 20 2a 2f 0a 20 20 73  issued..  */.  s
0670: 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 61 6c 61  qlite3_int64 ala
0680: 72 6d 54 68 72 65 73 68 6f 6c 64 3b 0a 20 20 76  rmThreshold;.  v
0690: 6f 69 64 20 28 2a 61 6c 61 72 6d 43 61 6c 6c 62  oid (*alarmCallb
06a0: 61 63 6b 29 28 76 6f 69 64 2a 2c 20 73 71 6c 69  ack)(void*, sqli
06b0: 74 65 33 5f 69 6e 74 36 34 2c 69 6e 74 29 3b 0a  te3_int64,int);.
06c0: 20 20 76 6f 69 64 20 2a 61 6c 61 72 6d 41 72 67    void *alarmArg
06d0: 3b 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 50 6f 69  ;..  /*.  ** Poi
06e0: 6e 74 65 72 73 20 74 6f 20 74 68 65 20 65 6e 64  nters to the end
06f0: 20 6f 66 20 73 71 6c 69 74 65 33 47 6c 6f 62 61   of sqlite3Globa
0700: 6c 43 6f 6e 66 69 67 2e 70 53 63 72 61 74 63 68  lConfig.pScratch
0710: 20 6d 65 6d 6f 72 79 0a 20 20 2a 2a 20 28 73 6f   memory.  ** (so
0720: 20 74 68 61 74 20 61 20 72 61 6e 67 65 20 74 65   that a range te
0730: 73 74 20 63 61 6e 20 62 65 20 75 73 65 64 20 74  st can be used t
0740: 6f 20 64 65 74 65 72 6d 69 6e 65 20 69 66 20 61  o determine if a
0750: 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e 0a 20 20 2a  n allocation.  *
0760: 2a 20 62 65 69 6e 67 20 66 72 65 65 64 20 63 61  * being freed ca
0770: 6d 65 20 66 72 6f 6d 20 70 53 63 72 61 74 63 68  me from pScratch
0780: 29 20 61 6e 64 20 61 20 70 6f 69 6e 74 65 72 20  ) and a pointer 
0790: 74 6f 20 74 68 65 20 6c 69 73 74 20 6f 66 0a 20  to the list of. 
07a0: 20 2a 2a 20 75 6e 75 73 65 64 20 73 63 72 61 74   ** unused scrat
07b0: 63 68 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 2e 0a  ch allocations..
07c0: 20 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 53 63    */.  void *pSc
07d0: 72 61 74 63 68 45 6e 64 3b 0a 20 20 53 63 72 61  ratchEnd;.  Scra
07e0: 74 63 68 46 72 65 65 73 6c 6f 74 20 2a 70 53 63  tchFreeslot *pSc
07f0: 72 61 74 63 68 46 72 65 65 3b 0a 20 20 75 33 32  ratchFree;.  u32
0800: 20 6e 53 63 72 61 74 63 68 46 72 65 65 3b 0a 0a   nScratchFree;..
0810: 20 20 2f 2a 0a 20 20 2a 2a 20 54 72 75 65 20 69    /*.  ** True i
0820: 66 20 68 65 61 70 20 69 73 20 6e 65 61 72 6c 79  f heap is nearly
0830: 20 22 66 75 6c 6c 22 20 77 68 65 72 65 20 22 66   "full" where "f
0840: 75 6c 6c 22 20 69 73 20 64 65 66 69 6e 65 64 20  ull" is defined 
0850: 62 79 20 74 68 65 0a 20 20 2a 2a 20 73 71 6c 69  by the.  ** sqli
0860: 74 65 33 5f 73 6f 66 74 5f 68 65 61 70 5f 6c 69  te3_soft_heap_li
0870: 6d 69 74 28 29 20 73 65 74 74 69 6e 67 2e 0a 20  mit() setting.. 
0880: 20 2a 2f 0a 20 20 69 6e 74 20 6e 65 61 72 6c 79   */.  int nearly
0890: 46 75 6c 6c 3b 0a 7d 20 6d 65 6d 30 20 3d 20 7b  Full;.} mem0 = {
08a0: 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20   0, 0, 0, 0, 0, 
08b0: 30 2c 20 30 2c 20 30 20 7d 3b 0a 0a 23 64 65 66  0, 0, 0 };..#def
08c0: 69 6e 65 20 6d 65 6d 30 20 47 4c 4f 42 41 4c 28  ine mem0 GLOBAL(
08d0: 73 74 72 75 63 74 20 4d 65 6d 30 47 6c 6f 62 61  struct Mem0Globa
08e0: 6c 2c 20 6d 65 6d 30 29 0a 0a 2f 2a 0a 2a 2a 20  l, mem0)../*.** 
08f0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 72 75 6e  This routine run
0900: 73 20 77 68 65 6e 20 74 68 65 20 6d 65 6d 6f 72  s when the memor
0910: 79 20 61 6c 6c 6f 63 61 74 6f 72 20 73 65 65 73  y allocator sees
0920: 20 74 68 61 74 20 74 68 65 0a 2a 2a 20 74 6f 74   that the.** tot
0930: 61 6c 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61  al memory alloca
0940: 74 69 6f 6e 20 69 73 20 61 62 6f 75 74 20 74 6f  tion is about to
0950: 20 65 78 63 65 65 64 20 74 68 65 20 73 6f 66 74   exceed the soft
0960: 20 68 65 61 70 0a 2a 2a 20 6c 69 6d 69 74 2e 0a   heap.** limit..
0970: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 73  */.static void s
0980: 6f 66 74 48 65 61 70 4c 69 6d 69 74 45 6e 66 6f  oftHeapLimitEnfo
0990: 72 63 65 72 28 0a 20 20 76 6f 69 64 20 2a 4e 6f  rcer(.  void *No
09a0: 74 55 73 65 64 2c 20 0a 20 20 73 71 6c 69 74 65  tUsed, .  sqlite
09b0: 33 5f 69 6e 74 36 34 20 4e 6f 74 55 73 65 64 32  3_int64 NotUsed2
09c0: 2c 0a 20 20 69 6e 74 20 61 6c 6c 6f 63 53 69 7a  ,.  int allocSiz
09d0: 65 0a 29 7b 0a 20 20 55 4e 55 53 45 44 5f 50 41  e.){.  UNUSED_PA
09e0: 52 41 4d 45 54 45 52 32 28 4e 6f 74 55 73 65 64  RAMETER2(NotUsed
09f0: 2c 20 4e 6f 74 55 73 65 64 32 29 3b 0a 20 20 73  , NotUsed2);.  s
0a00: 71 6c 69 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d  qlite3_release_m
0a10: 65 6d 6f 72 79 28 61 6c 6c 6f 63 53 69 7a 65 29  emory(allocSize)
0a20: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67  ;.}../*.** Chang
0a30: 65 20 74 68 65 20 61 6c 61 72 6d 20 63 61 6c 6c  e the alarm call
0a40: 62 61 63 6b 0a 2a 2f 0a 73 74 61 74 69 63 20 69  back.*/.static i
0a50: 6e 74 20 73 71 6c 69 74 65 33 4d 65 6d 6f 72 79  nt sqlite3Memory
0a60: 41 6c 61 72 6d 28 0a 20 20 76 6f 69 64 28 2a 78  Alarm(.  void(*x
0a70: 43 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 20 2a  Callback)(void *
0a80: 70 41 72 67 2c 20 73 71 6c 69 74 65 33 5f 69 6e  pArg, sqlite3_in
0a90: 74 36 34 20 75 73 65 64 2c 69 6e 74 20 4e 29 2c  t64 used,int N),
0aa0: 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 2c 0a 20  .  void *pArg,. 
0ab0: 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 69   sqlite3_int64 i
0ac0: 54 68 72 65 73 68 6f 6c 64 0a 29 7b 0a 20 20 69  Threshold.){.  i
0ad0: 6e 74 20 6e 55 73 65 64 3b 0a 20 20 73 71 6c 69  nt nUsed;.  sqli
0ae0: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28  te3_mutex_enter(
0af0: 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 6d  mem0.mutex);.  m
0b00: 65 6d 30 2e 61 6c 61 72 6d 43 61 6c 6c 62 61 63  em0.alarmCallbac
0b10: 6b 20 3d 20 78 43 61 6c 6c 62 61 63 6b 3b 0a 20  k = xCallback;. 
0b20: 20 6d 65 6d 30 2e 61 6c 61 72 6d 41 72 67 20 3d   mem0.alarmArg =
0b30: 20 70 41 72 67 3b 0a 20 20 6d 65 6d 30 2e 61 6c   pArg;.  mem0.al
0b40: 61 72 6d 54 68 72 65 73 68 6f 6c 64 20 3d 20 69  armThreshold = i
0b50: 54 68 72 65 73 68 6f 6c 64 3b 0a 20 20 6e 55 73  Threshold;.  nUs
0b60: 65 64 20 3d 20 73 71 6c 69 74 65 33 53 74 61 74  ed = sqlite3Stat
0b70: 75 73 56 61 6c 75 65 28 53 51 4c 49 54 45 5f 53  usValue(SQLITE_S
0b80: 54 41 54 55 53 5f 4d 45 4d 4f 52 59 5f 55 53 45  TATUS_MEMORY_USE
0b90: 44 29 3b 0a 20 20 6d 65 6d 30 2e 6e 65 61 72 6c  D);.  mem0.nearl
0ba0: 79 46 75 6c 6c 20 3d 20 28 69 54 68 72 65 73 68  yFull = (iThresh
0bb0: 6f 6c 64 3e 30 20 26 26 20 69 54 68 72 65 73 68  old>0 && iThresh
0bc0: 6f 6c 64 3c 3d 6e 55 73 65 64 29 3b 0a 20 20 73  old<=nUsed);.  s
0bd0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
0be0: 76 65 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a  ve(mem0.mutex);.
0bf0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
0c00: 4f 4b 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53  OK;.}..#ifndef S
0c10: 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 50 52 45  QLITE_OMIT_DEPRE
0c20: 43 41 54 45 44 0a 2f 2a 0a 2a 2a 20 44 65 70 72  CATED./*.** Depr
0c30: 65 63 61 74 65 64 20 65 78 74 65 72 6e 61 6c 20  ecated external 
0c40: 69 6e 74 65 72 66 61 63 65 2e 20 20 49 6e 74 65  interface.  Inte
0c50: 72 6e 61 6c 2f 63 6f 72 65 20 53 51 4c 69 74 65  rnal/core SQLite
0c60: 20 63 6f 64 65 0a 2a 2a 20 73 68 6f 75 6c 64 20   code.** should 
0c70: 63 61 6c 6c 20 73 71 6c 69 74 65 33 4d 65 6d 6f  call sqlite3Memo
0c80: 72 79 41 6c 61 72 6d 2e 0a 2a 2f 0a 69 6e 74 20  ryAlarm..*/.int 
0c90: 73 71 6c 69 74 65 33 5f 6d 65 6d 6f 72 79 5f 61  sqlite3_memory_a
0ca0: 6c 61 72 6d 28 0a 20 20 76 6f 69 64 28 2a 78 43  larm(.  void(*xC
0cb0: 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 20 2a 70  allback)(void *p
0cc0: 41 72 67 2c 20 73 71 6c 69 74 65 33 5f 69 6e 74  Arg, sqlite3_int
0cd0: 36 34 20 75 73 65 64 2c 69 6e 74 20 4e 29 2c 0a  64 used,int N),.
0ce0: 20 20 76 6f 69 64 20 2a 70 41 72 67 2c 0a 20 20    void *pArg,.  
0cf0: 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 69 54  sqlite3_int64 iT
0d00: 68 72 65 73 68 6f 6c 64 0a 29 7b 0a 20 20 72 65  hreshold.){.  re
0d10: 74 75 72 6e 20 73 71 6c 69 74 65 33 4d 65 6d 6f  turn sqlite3Memo
0d20: 72 79 41 6c 61 72 6d 28 78 43 61 6c 6c 62 61 63  ryAlarm(xCallbac
0d30: 6b 2c 20 70 41 72 67 2c 20 69 54 68 72 65 73 68  k, pArg, iThresh
0d40: 6f 6c 64 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a  old);.}.#endif..
0d50: 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 73 6f  /*.** Set the so
0d60: 66 74 20 68 65 61 70 2d 73 69 7a 65 20 6c 69 6d  ft heap-size lim
0d70: 69 74 20 66 6f 72 20 74 68 65 20 6c 69 62 72 61  it for the libra
0d80: 72 79 2e 20 50 61 73 73 69 6e 67 20 61 20 7a 65  ry. Passing a ze
0d90: 72 6f 20 6f 72 20 0a 2a 2a 20 6e 65 67 61 74 69  ro or .** negati
0da0: 76 65 20 76 61 6c 75 65 20 69 6e 64 69 63 61 74  ve value indicat
0db0: 65 73 20 6e 6f 20 6c 69 6d 69 74 2e 0a 2a 2f 0a  es no limit..*/.
0dc0: 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 73 71  sqlite3_int64 sq
0dd0: 6c 69 74 65 33 5f 73 6f 66 74 5f 68 65 61 70 5f  lite3_soft_heap_
0de0: 6c 69 6d 69 74 36 34 28 73 71 6c 69 74 65 33 5f  limit64(sqlite3_
0df0: 69 6e 74 36 34 20 6e 29 7b 0a 20 20 73 71 6c 69  int64 n){.  sqli
0e00: 74 65 33 5f 69 6e 74 36 34 20 70 72 69 6f 72 4c  te3_int64 priorL
0e10: 69 6d 69 74 3b 0a 20 20 73 71 6c 69 74 65 33 5f  imit;.  sqlite3_
0e20: 69 6e 74 36 34 20 65 78 63 65 73 73 3b 0a 23 69  int64 excess;.#i
0e30: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
0e40: 54 5f 41 55 54 4f 49 4e 49 54 0a 20 20 69 6e 74  T_AUTOINIT.  int
0e50: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 69 6e   rc = sqlite3_in
0e60: 69 74 69 61 6c 69 7a 65 28 29 3b 0a 20 20 69 66  itialize();.  if
0e70: 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 2d 31  ( rc ) return -1
0e80: 3b 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74  ;.#endif.  sqlit
0e90: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d  e3_mutex_enter(m
0ea0: 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 70 72  em0.mutex);.  pr
0eb0: 69 6f 72 4c 69 6d 69 74 20 3d 20 6d 65 6d 30 2e  iorLimit = mem0.
0ec0: 61 6c 61 72 6d 54 68 72 65 73 68 6f 6c 64 3b 0a  alarmThreshold;.
0ed0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f    sqlite3_mutex_
0ee0: 6c 65 61 76 65 28 6d 65 6d 30 2e 6d 75 74 65 78  leave(mem0.mutex
0ef0: 29 3b 0a 20 20 69 66 28 20 6e 3c 30 20 29 20 72  );.  if( n<0 ) r
0f00: 65 74 75 72 6e 20 70 72 69 6f 72 4c 69 6d 69 74  eturn priorLimit
0f10: 3b 0a 20 20 69 66 28 20 6e 3e 30 20 29 7b 0a 20  ;.  if( n>0 ){. 
0f20: 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 6f 72 79     sqlite3Memory
0f30: 41 6c 61 72 6d 28 73 6f 66 74 48 65 61 70 4c 69  Alarm(softHeapLi
0f40: 6d 69 74 45 6e 66 6f 72 63 65 72 2c 20 30 2c 20  mitEnforcer, 0, 
0f50: 6e 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  n);.  }else{.   
0f60: 20 73 71 6c 69 74 65 33 4d 65 6d 6f 72 79 41 6c   sqlite3MemoryAl
0f70: 61 72 6d 28 30 2c 20 30 2c 20 30 29 3b 0a 20 20  arm(0, 0, 0);.  
0f80: 7d 0a 20 20 65 78 63 65 73 73 20 3d 20 73 71 6c  }.  excess = sql
0f90: 69 74 65 33 5f 6d 65 6d 6f 72 79 5f 75 73 65 64  ite3_memory_used
0fa0: 28 29 20 2d 20 6e 3b 0a 20 20 69 66 28 20 65 78  () - n;.  if( ex
0fb0: 63 65 73 73 3e 30 20 29 20 73 71 6c 69 74 65 33  cess>0 ) sqlite3
0fc0: 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f 72 79 28  _release_memory(
0fd0: 28 69 6e 74 29 28 65 78 63 65 73 73 20 26 20 30  (int)(excess & 0
0fe0: 78 37 66 66 66 66 66 66 66 29 29 3b 0a 20 20 72  x7fffffff));.  r
0ff0: 65 74 75 72 6e 20 70 72 69 6f 72 4c 69 6d 69 74  eturn priorLimit
1000: 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  ;.}.void sqlite3
1010: 5f 73 6f 66 74 5f 68 65 61 70 5f 6c 69 6d 69 74  _soft_heap_limit
1020: 28 69 6e 74 20 6e 29 7b 0a 20 20 69 66 28 20 6e  (int n){.  if( n
1030: 3c 30 20 29 20 6e 20 3d 20 30 3b 0a 20 20 73 71  <0 ) n = 0;.  sq
1040: 6c 69 74 65 33 5f 73 6f 66 74 5f 68 65 61 70 5f  lite3_soft_heap_
1050: 6c 69 6d 69 74 36 34 28 6e 29 3b 0a 7d 0a 0a 2f  limit64(n);.}../
1060: 2a 0a 2a 2a 20 49 6e 69 74 69 61 6c 69 7a 65 20  *.** Initialize 
1070: 74 68 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63  the memory alloc
1080: 61 74 69 6f 6e 20 73 75 62 73 79 73 74 65 6d 2e  ation subsystem.
1090: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d  .*/.int sqlite3M
10a0: 61 6c 6c 6f 63 49 6e 69 74 28 76 6f 69 64 29 7b  allocInit(void){
10b0: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c  .  if( sqlite3Gl
10c0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78 4d 61  obalConfig.m.xMa
10d0: 6c 6c 6f 63 3d 3d 30 20 29 7b 0a 20 20 20 20 73  lloc==0 ){.    s
10e0: 71 6c 69 74 65 33 4d 65 6d 53 65 74 44 65 66 61  qlite3MemSetDefa
10f0: 75 6c 74 28 29 3b 0a 20 20 7d 0a 20 20 6d 65 6d  ult();.  }.  mem
1100: 73 65 74 28 26 6d 65 6d 30 2c 20 30 2c 20 73 69  set(&mem0, 0, si
1110: 7a 65 6f 66 28 6d 65 6d 30 29 29 3b 0a 20 20 69  zeof(mem0));.  i
1120: 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c  f( sqlite3Global
1130: 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 65  Config.bCoreMute
1140: 78 20 29 7b 0a 20 20 20 20 6d 65 6d 30 2e 6d 75  x ){.    mem0.mu
1150: 74 65 78 20 3d 20 73 71 6c 69 74 65 33 4d 75 74  tex = sqlite3Mut
1160: 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d  exAlloc(SQLITE_M
1170: 55 54 45 58 5f 53 54 41 54 49 43 5f 4d 45 4d 29  UTEX_STATIC_MEM)
1180: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 71 6c 69  ;.  }.  if( sqli
1190: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e  te3GlobalConfig.
11a0: 70 53 63 72 61 74 63 68 20 26 26 20 73 71 6c 69  pScratch && sqli
11b0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e  te3GlobalConfig.
11c0: 73 7a 53 63 72 61 74 63 68 3e 3d 31 30 30 0a 20  szScratch>=100. 
11d0: 20 20 20 20 20 26 26 20 73 71 6c 69 74 65 33 47       && sqlite3G
11e0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 53 63 72  lobalConfig.nScr
11f0: 61 74 63 68 3e 30 20 29 7b 0a 20 20 20 20 69 6e  atch>0 ){.    in
1200: 74 20 69 2c 20 6e 2c 20 73 7a 3b 0a 20 20 20 20  t i, n, sz;.    
1210: 53 63 72 61 74 63 68 46 72 65 65 73 6c 6f 74 20  ScratchFreeslot 
1220: 2a 70 53 6c 6f 74 3b 0a 20 20 20 20 73 7a 20 3d  *pSlot;.    sz =
1230: 20 52 4f 55 4e 44 44 4f 57 4e 38 28 73 71 6c 69   ROUNDDOWN8(sqli
1240: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e  te3GlobalConfig.
1250: 73 7a 53 63 72 61 74 63 68 29 3b 0a 20 20 20 20  szScratch);.    
1260: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
1270: 66 69 67 2e 73 7a 53 63 72 61 74 63 68 20 3d 20  fig.szScratch = 
1280: 73 7a 3b 0a 20 20 20 20 70 53 6c 6f 74 20 3d 20  sz;.    pSlot = 
1290: 28 53 63 72 61 74 63 68 46 72 65 65 73 6c 6f 74  (ScratchFreeslot
12a0: 2a 29 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43  *)sqlite3GlobalC
12b0: 6f 6e 66 69 67 2e 70 53 63 72 61 74 63 68 3b 0a  onfig.pScratch;.
12c0: 20 20 20 20 6e 20 3d 20 73 71 6c 69 74 65 33 47      n = sqlite3G
12d0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 53 63 72  lobalConfig.nScr
12e0: 61 74 63 68 3b 0a 20 20 20 20 6d 65 6d 30 2e 70  atch;.    mem0.p
12f0: 53 63 72 61 74 63 68 46 72 65 65 20 3d 20 70 53  ScratchFree = pS
1300: 6c 6f 74 3b 0a 20 20 20 20 6d 65 6d 30 2e 6e 53  lot;.    mem0.nS
1310: 63 72 61 74 63 68 46 72 65 65 20 3d 20 6e 3b 0a  cratchFree = n;.
1320: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e      for(i=0; i<n
1330: 2d 31 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20  -1; i++){.      
1340: 70 53 6c 6f 74 2d 3e 70 4e 65 78 74 20 3d 20 28  pSlot->pNext = (
1350: 53 63 72 61 74 63 68 46 72 65 65 73 6c 6f 74 2a  ScratchFreeslot*
1360: 29 28 73 7a 2b 28 63 68 61 72 2a 29 70 53 6c 6f  )(sz+(char*)pSlo
1370: 74 29 3b 0a 20 20 20 20 20 20 70 53 6c 6f 74 20  t);.      pSlot 
1380: 3d 20 70 53 6c 6f 74 2d 3e 70 4e 65 78 74 3b 0a  = pSlot->pNext;.
1390: 20 20 20 20 7d 0a 20 20 20 20 70 53 6c 6f 74 2d      }.    pSlot-
13a0: 3e 70 4e 65 78 74 20 3d 20 30 3b 0a 20 20 20 20  >pNext = 0;.    
13b0: 6d 65 6d 30 2e 70 53 63 72 61 74 63 68 45 6e 64  mem0.pScratchEnd
13c0: 20 3d 20 28 76 6f 69 64 2a 29 26 70 53 6c 6f 74   = (void*)&pSlot
13d0: 5b 31 5d 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  [1];.  }else{.  
13e0: 20 20 6d 65 6d 30 2e 70 53 63 72 61 74 63 68 45    mem0.pScratchE
13f0: 6e 64 20 3d 20 30 3b 0a 20 20 20 20 73 71 6c 69  nd = 0;.    sqli
1400: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e  te3GlobalConfig.
1410: 70 53 63 72 61 74 63 68 20 3d 20 30 3b 0a 20 20  pScratch = 0;.  
1420: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43    sqlite3GlobalC
1430: 6f 6e 66 69 67 2e 73 7a 53 63 72 61 74 63 68 20  onfig.szScratch 
1440: 3d 20 30 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  = 0;.    sqlite3
1450: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 53 63  GlobalConfig.nSc
1460: 72 61 74 63 68 20 3d 20 30 3b 0a 20 20 7d 0a 20  ratch = 0;.  }. 
1470: 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62   if( sqlite3Glob
1480: 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65 3d 3d  alConfig.pPage==
1490: 30 20 7c 7c 20 73 71 6c 69 74 65 33 47 6c 6f 62  0 || sqlite3Glob
14a0: 61 6c 43 6f 6e 66 69 67 2e 73 7a 50 61 67 65 3c  alConfig.szPage<
14b0: 35 31 32 0a 20 20 20 20 20 20 7c 7c 20 73 71 6c  512.      || sql
14c0: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67  ite3GlobalConfig
14d0: 2e 6e 50 61 67 65 3c 31 20 29 7b 0a 20 20 20 20  .nPage<1 ){.    
14e0: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
14f0: 66 69 67 2e 70 50 61 67 65 20 3d 20 30 3b 0a 20  fig.pPage = 0;. 
1500: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c     sqlite3Global
1510: 43 6f 6e 66 69 67 2e 73 7a 50 61 67 65 20 3d 20  Config.szPage = 
1520: 30 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 47 6c  0;.    sqlite3Gl
1530: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 50 61 67 65  obalConfig.nPage
1540: 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75   = 0;.  }.  retu
1550: 72 6e 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c  rn sqlite3Global
1560: 43 6f 6e 66 69 67 2e 6d 2e 78 49 6e 69 74 28 73  Config.m.xInit(s
1570: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66  qlite3GlobalConf
1580: 69 67 2e 6d 2e 70 41 70 70 44 61 74 61 29 3b 0a  ig.m.pAppData);.
1590: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
15a0: 74 72 75 65 20 69 66 20 74 68 65 20 68 65 61 70  true if the heap
15b0: 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 75 6e   is currently un
15c0: 64 65 72 20 6d 65 6d 6f 72 79 20 70 72 65 73 73  der memory press
15d0: 75 72 65 20 2d 20 69 6e 20 6f 74 68 65 72 0a 2a  ure - in other.*
15e0: 2a 20 77 6f 72 64 73 20 69 66 20 74 68 65 20 61  * words if the a
15f0: 6d 6f 75 6e 74 20 6f 66 20 68 65 61 70 20 75 73  mount of heap us
1600: 65 64 20 69 73 20 63 6c 6f 73 65 20 74 6f 20 74  ed is close to t
1610: 68 65 20 6c 69 6d 69 74 20 73 65 74 20 62 79 0a  he limit set by.
1620: 2a 2a 20 73 71 6c 69 74 65 33 5f 73 6f 66 74 5f  ** sqlite3_soft_
1630: 68 65 61 70 5f 6c 69 6d 69 74 28 29 2e 0a 2a 2f  heap_limit()..*/
1640: 0a 69 6e 74 20 73 71 6c 69 74 65 33 48 65 61 70  .int sqlite3Heap
1650: 4e 65 61 72 6c 79 46 75 6c 6c 28 76 6f 69 64 29  NearlyFull(void)
1660: 7b 0a 20 20 72 65 74 75 72 6e 20 6d 65 6d 30 2e  {.  return mem0.
1670: 6e 65 61 72 6c 79 46 75 6c 6c 3b 0a 7d 0a 0a 2f  nearlyFull;.}../
1680: 2a 0a 2a 2a 20 44 65 69 6e 69 74 69 61 6c 69 7a  *.** Deinitializ
1690: 65 20 74 68 65 20 6d 65 6d 6f 72 79 20 61 6c 6c  e the memory all
16a0: 6f 63 61 74 69 6f 6e 20 73 75 62 73 79 73 74 65  ocation subsyste
16b0: 6d 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  m..*/.void sqlit
16c0: 65 33 4d 61 6c 6c 6f 63 45 6e 64 28 76 6f 69 64  e3MallocEnd(void
16d0: 29 7b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33  ){.  if( sqlite3
16e0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78  GlobalConfig.m.x
16f0: 53 68 75 74 64 6f 77 6e 20 29 7b 0a 20 20 20 20  Shutdown ){.    
1700: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
1710: 66 69 67 2e 6d 2e 78 53 68 75 74 64 6f 77 6e 28  fig.m.xShutdown(
1720: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
1730: 66 69 67 2e 6d 2e 70 41 70 70 44 61 74 61 29 3b  fig.m.pAppData);
1740: 0a 20 20 7d 0a 20 20 6d 65 6d 73 65 74 28 26 6d  .  }.  memset(&m
1750: 65 6d 30 2c 20 30 2c 20 73 69 7a 65 6f 66 28 6d  em0, 0, sizeof(m
1760: 65 6d 30 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  em0));.}../*.** 
1770: 52 65 74 75 72 6e 20 74 68 65 20 61 6d 6f 75 6e  Return the amoun
1780: 74 20 6f 66 20 6d 65 6d 6f 72 79 20 63 75 72 72  t of memory curr
1790: 65 6e 74 6c 79 20 63 68 65 63 6b 65 64 20 6f 75  ently checked ou
17a0: 74 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f 69 6e  t..*/.sqlite3_in
17b0: 74 36 34 20 73 71 6c 69 74 65 33 5f 6d 65 6d 6f  t64 sqlite3_memo
17c0: 72 79 5f 75 73 65 64 28 76 6f 69 64 29 7b 0a 20  ry_used(void){. 
17d0: 20 69 6e 74 20 6e 2c 20 6d 78 3b 0a 20 20 73 71   int n, mx;.  sq
17e0: 6c 69 74 65 33 5f 69 6e 74 36 34 20 72 65 73 3b  lite3_int64 res;
17f0: 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 61 74 75  .  sqlite3_statu
1800: 73 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f  s(SQLITE_STATUS_
1810: 4d 45 4d 4f 52 59 5f 55 53 45 44 2c 20 26 6e 2c  MEMORY_USED, &n,
1820: 20 26 6d 78 2c 20 30 29 3b 0a 20 20 72 65 73 20   &mx, 0);.  res 
1830: 3d 20 28 73 71 6c 69 74 65 33 5f 69 6e 74 36 34  = (sqlite3_int64
1840: 29 6e 3b 20 20 2f 2a 20 57 6f 72 6b 20 61 72 6f  )n;  /* Work aro
1850: 75 6e 64 20 62 75 67 20 69 6e 20 42 6f 72 6c 61  und bug in Borla
1860: 6e 64 20 43 2e 20 54 69 63 6b 65 74 20 23 33 32  nd C. Ticket #32
1870: 31 36 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 72  16 */.  return r
1880: 65 73 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74  es;.}../*.** Ret
1890: 75 72 6e 20 74 68 65 20 6d 61 78 69 6d 75 6d 20  urn the maximum 
18a0: 61 6d 6f 75 6e 74 20 6f 66 20 6d 65 6d 6f 72 79  amount of memory
18b0: 20 74 68 61 74 20 68 61 73 20 65 76 65 72 20 62   that has ever b
18c0: 65 65 6e 0a 2a 2a 20 63 68 65 63 6b 65 64 20 6f  een.** checked o
18d0: 75 74 20 73 69 6e 63 65 20 65 69 74 68 65 72 20  ut since either 
18e0: 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66  the beginning of
18f0: 20 74 68 69 73 20 70 72 6f 63 65 73 73 0a 2a 2a   this process.**
1900: 20 6f 72 20 73 69 6e 63 65 20 74 68 65 20 6d 6f   or since the mo
1910: 73 74 20 72 65 63 65 6e 74 20 72 65 73 65 74 2e  st recent reset.
1920: 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f 69 6e 74 36  .*/.sqlite3_int6
1930: 34 20 73 71 6c 69 74 65 33 5f 6d 65 6d 6f 72 79  4 sqlite3_memory
1940: 5f 68 69 67 68 77 61 74 65 72 28 69 6e 74 20 72  _highwater(int r
1950: 65 73 65 74 46 6c 61 67 29 7b 0a 20 20 69 6e 74  esetFlag){.  int
1960: 20 6e 2c 20 6d 78 3b 0a 20 20 73 71 6c 69 74 65   n, mx;.  sqlite
1970: 33 5f 69 6e 74 36 34 20 72 65 73 3b 0a 20 20 73  3_int64 res;.  s
1980: 71 6c 69 74 65 33 5f 73 74 61 74 75 73 28 53 51  qlite3_status(SQ
1990: 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d 45 4d 4f  LITE_STATUS_MEMO
19a0: 52 59 5f 55 53 45 44 2c 20 26 6e 2c 20 26 6d 78  RY_USED, &n, &mx
19b0: 2c 20 72 65 73 65 74 46 6c 61 67 29 3b 0a 20 20  , resetFlag);.  
19c0: 72 65 73 20 3d 20 28 73 71 6c 69 74 65 33 5f 69  res = (sqlite3_i
19d0: 6e 74 36 34 29 6d 78 3b 20 20 2f 2a 20 57 6f 72  nt64)mx;  /* Wor
19e0: 6b 20 61 72 6f 75 6e 64 20 62 75 67 20 69 6e 20  k around bug in 
19f0: 42 6f 72 6c 61 6e 64 20 43 2e 20 54 69 63 6b 65  Borland C. Ticke
1a00: 74 20 23 33 32 31 36 20 2a 2f 0a 20 20 72 65 74  t #3216 */.  ret
1a10: 75 72 6e 20 72 65 73 3b 0a 7d 0a 0a 2f 2a 0a 2a  urn res;.}../*.*
1a20: 2a 20 54 72 69 67 67 65 72 20 74 68 65 20 61 6c  * Trigger the al
1a30: 61 72 6d 20 0a 2a 2f 0a 73 74 61 74 69 63 20 76  arm .*/.static v
1a40: 6f 69 64 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f  oid sqlite3Mallo
1a50: 63 41 6c 61 72 6d 28 69 6e 74 20 6e 42 79 74 65  cAlarm(int nByte
1a60: 29 7b 0a 20 20 76 6f 69 64 20 28 2a 78 43 61 6c  ){.  void (*xCal
1a70: 6c 62 61 63 6b 29 28 76 6f 69 64 2a 2c 73 71 6c  lback)(void*,sql
1a80: 69 74 65 33 5f 69 6e 74 36 34 2c 69 6e 74 29 3b  ite3_int64,int);
1a90: 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34  .  sqlite3_int64
1aa0: 20 6e 6f 77 55 73 65 64 3b 0a 20 20 76 6f 69 64   nowUsed;.  void
1ab0: 20 2a 70 41 72 67 3b 0a 20 20 69 66 28 20 6d 65   *pArg;.  if( me
1ac0: 6d 30 2e 61 6c 61 72 6d 43 61 6c 6c 62 61 63 6b  m0.alarmCallback
1ad0: 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a 20 20  ==0 ) return;.  
1ae0: 78 43 61 6c 6c 62 61 63 6b 20 3d 20 6d 65 6d 30  xCallback = mem0
1af0: 2e 61 6c 61 72 6d 43 61 6c 6c 62 61 63 6b 3b 0a  .alarmCallback;.
1b00: 20 20 6e 6f 77 55 73 65 64 20 3d 20 73 71 6c 69    nowUsed = sqli
1b10: 74 65 33 53 74 61 74 75 73 56 61 6c 75 65 28 53  te3StatusValue(S
1b20: 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d 45 4d  QLITE_STATUS_MEM
1b30: 4f 52 59 5f 55 53 45 44 29 3b 0a 20 20 70 41 72  ORY_USED);.  pAr
1b40: 67 20 3d 20 6d 65 6d 30 2e 61 6c 61 72 6d 41 72  g = mem0.alarmAr
1b50: 67 3b 0a 20 20 6d 65 6d 30 2e 61 6c 61 72 6d 43  g;.  mem0.alarmC
1b60: 61 6c 6c 62 61 63 6b 20 3d 20 30 3b 0a 20 20 73  allback = 0;.  s
1b70: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
1b80: 76 65 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a  ve(mem0.mutex);.
1b90: 20 20 78 43 61 6c 6c 62 61 63 6b 28 70 41 72 67    xCallback(pArg
1ba0: 2c 20 6e 6f 77 55 73 65 64 2c 20 6e 42 79 74 65  , nowUsed, nByte
1bb0: 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  );.  sqlite3_mut
1bc0: 65 78 5f 65 6e 74 65 72 28 6d 65 6d 30 2e 6d 75  ex_enter(mem0.mu
1bd0: 74 65 78 29 3b 0a 20 20 6d 65 6d 30 2e 61 6c 61  tex);.  mem0.ala
1be0: 72 6d 43 61 6c 6c 62 61 63 6b 20 3d 20 78 43 61  rmCallback = xCa
1bf0: 6c 6c 62 61 63 6b 3b 0a 20 20 6d 65 6d 30 2e 61  llback;.  mem0.a
1c00: 6c 61 72 6d 41 72 67 20 3d 20 70 41 72 67 3b 0a  larmArg = pArg;.
1c10: 7d 0a 0a 2f 2a 0a 2a 2a 20 44 6f 20 61 20 6d 65  }../*.** Do a me
1c20: 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20  mory allocation 
1c30: 77 69 74 68 20 73 74 61 74 69 73 74 69 63 73 20  with statistics 
1c40: 61 6e 64 20 61 6c 61 72 6d 73 2e 20 20 41 73 73  and alarms.  Ass
1c50: 75 6d 65 20 74 68 65 0a 2a 2a 20 6c 6f 63 6b 20  ume the.** lock 
1c60: 69 73 20 61 6c 72 65 61 64 79 20 68 65 6c 64 2e  is already held.
1c70: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
1c80: 2a 6d 61 6c 6c 6f 63 57 69 74 68 41 6c 61 72 6d  *mallocWithAlarm
1c90: 28 0a 20 20 76 6f 69 64 20 2a 28 2a 78 41 6c 6c  (.  void *(*xAll
1ca0: 6f 63 29 28 69 6e 74 29 2c 20 20 20 20 20 20 20  oc)(int),       
1cb0: 20 20 20 2f 2a 20 4d 65 6d 6f 72 79 20 61 6c 6c     /* Memory all
1cc0: 6f 63 61 74 69 6f 6e 20 66 75 6e 63 74 69 6f 6e  ocation function
1cd0: 20 2a 2f 0a 20 20 69 6e 74 20 6e 20 20 20 20 20   */.  int n     
1ce0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1cf0: 20 20 20 20 20 2f 2a 20 42 79 74 65 73 20 6f 66       /* Bytes of
1d00: 20 6d 65 6d 6f 72 79 20 74 6f 20 61 6c 6c 6f 63   memory to alloc
1d10: 61 74 65 20 2a 2f 0a 29 7b 0a 20 20 76 6f 69 64  ate */.){.  void
1d20: 20 2a 70 3b 20 20 20 20 20 20 20 20 20 20 20 20   *p;            
1d30: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f             /* Po
1d40: 69 6e 74 65 72 20 74 6f 20 61 6c 6c 6f 63 61 74  inter to allocat
1d50: 65 64 20 6d 65 6d 6f 72 79 20 2a 2f 0a 20 20 69  ed memory */.  i
1d60: 6e 74 20 6e 46 75 6c 6c 3b 20 20 20 20 20 20 20  nt nFull;       
1d70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
1d80: 20 56 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20   Value returned 
1d90: 62 79 20 78 52 6f 75 6e 64 75 70 20 28 69 66 20  by xRoundup (if 
1da0: 72 65 71 75 69 72 65 64 29 20 2a 2f 0a 0a 20 20  required) */..  
1db0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f  assert( sqlite3_
1dc0: 6d 75 74 65 78 5f 68 65 6c 64 28 6d 65 6d 30 2e  mutex_held(mem0.
1dd0: 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65  mutex) );.  asse
1de0: 72 74 28 20 78 41 6c 6c 6f 63 3d 3d 73 71 6c 69  rt( xAlloc==sqli
1df0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e  te3GlobalConfig.
1e00: 6d 2e 78 4d 61 6c 6c 6f 63 20 0a 20 20 20 20 20  m.xMalloc .     
1e10: 20 20 7c 7c 20 78 41 6c 6c 6f 63 3d 3d 73 71 6c    || xAlloc==sql
1e20: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67  ite3GlobalConfig
1e30: 2e 6d 2e 78 43 61 6c 6c 6f 63 20 0a 20 20 29 3b  .m.xCalloc .  );
1e40: 0a 0a 20 20 2f 2a 20 4e 6f 74 65 3a 20 41 74 20  ..  /* Note: At 
1e50: 6f 6e 65 20 70 6f 69 6e 74 20 74 68 69 73 20 66  one point this f
1e60: 75 6e 63 74 69 6f 6e 20 77 6f 75 6c 64 20 63 61  unction would ca
1e70: 6c 6c 20 78 52 6f 75 6e 64 75 70 28 29 20 61 6e  ll xRoundup() an
1e80: 64 20 75 73 65 20 74 68 65 0a 20 20 2a 2a 20 72  d use the.  ** r
1e90: 65 73 75 6c 74 69 6e 67 20 76 61 6c 75 65 20 61  esulting value a
1ea0: 73 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 74  s the argument t
1eb0: 6f 20 78 41 6c 6c 6f 63 28 29 2e 20 48 6f 77 65  o xAlloc(). Howe
1ec0: 76 65 72 2c 20 74 68 69 73 20 69 73 20 6e 6f 74  ver, this is not
1ed0: 0a 20 20 2a 2a 20 72 65 71 75 69 72 65 64 2e 20  .  ** required. 
1ee0: 41 6e 64 20 69 74 20 69 73 20 61 20 28 73 6d 61  And it is a (sma
1ef0: 6c 6c 29 20 64 72 61 67 20 6f 6e 20 70 65 72 66  ll) drag on perf
1f00: 6f 72 6d 61 6e 63 65 2e 20 20 2a 2f 0a 20 20 2f  ormance.  */.  /
1f10: 2a 20 6e 46 75 6c 6c 20 3d 20 73 71 6c 69 74 65  * nFull = sqlite
1f20: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e  3GlobalConfig.m.
1f30: 78 52 6f 75 6e 64 75 70 28 6e 29 3b 20 2a 2f 0a  xRoundup(n); */.
1f40: 0a 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73  .  sqlite3Status
1f50: 53 65 74 28 53 51 4c 49 54 45 5f 53 54 41 54 55  Set(SQLITE_STATU
1f60: 53 5f 4d 41 4c 4c 4f 43 5f 53 49 5a 45 2c 20 6e  S_MALLOC_SIZE, n
1f70: 29 3b 0a 20 20 69 66 28 20 6d 65 6d 30 2e 61 6c  );.  if( mem0.al
1f80: 61 72 6d 43 61 6c 6c 62 61 63 6b 20 29 7b 0a 20  armCallback ){. 
1f90: 20 20 20 69 6e 74 20 6e 55 73 65 64 20 3d 20 73     int nUsed = s
1fa0: 71 6c 69 74 65 33 53 74 61 74 75 73 56 61 6c 75  qlite3StatusValu
1fb0: 65 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f  e(SQLITE_STATUS_
1fc0: 4d 45 4d 4f 52 59 5f 55 53 45 44 29 3b 0a 20 20  MEMORY_USED);.  
1fd0: 20 20 6e 46 75 6c 6c 20 3d 20 73 71 6c 69 74 65    nFull = sqlite
1fe0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e  3GlobalConfig.m.
1ff0: 78 52 6f 75 6e 64 75 70 28 6e 29 3b 0a 20 20 20  xRoundup(n);.   
2000: 20 69 66 28 20 6e 55 73 65 64 20 3e 3d 20 6d 65   if( nUsed >= me
2010: 6d 30 2e 61 6c 61 72 6d 54 68 72 65 73 68 6f 6c  m0.alarmThreshol
2020: 64 20 2d 20 6e 46 75 6c 6c 20 29 7b 0a 20 20 20  d - nFull ){.   
2030: 20 20 20 6d 65 6d 30 2e 6e 65 61 72 6c 79 46 75     mem0.nearlyFu
2040: 6c 6c 20 3d 20 31 3b 0a 20 20 20 20 20 20 73 71  ll = 1;.      sq
2050: 6c 69 74 65 33 4d 61 6c 6c 6f 63 41 6c 61 72 6d  lite3MallocAlarm
2060: 28 6e 46 75 6c 6c 29 3b 0a 20 20 20 20 7d 65 6c  (nFull);.    }el
2070: 73 65 7b 0a 20 20 20 20 20 20 6d 65 6d 30 2e 6e  se{.      mem0.n
2080: 65 61 72 6c 79 46 75 6c 6c 20 3d 20 30 3b 0a 20  earlyFull = 0;. 
2090: 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 70 20 3d 20     }.  }..  p = 
20a0: 78 41 6c 6c 6f 63 28 6e 29 3b 0a 23 69 66 64 65  xAlloc(n);.#ifde
20b0: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  f SQLITE_ENABLE_
20c0: 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e  MEMORY_MANAGEMEN
20d0: 54 0a 20 20 69 66 28 20 70 3d 3d 30 20 26 26 20  T.  if( p==0 && 
20e0: 6d 65 6d 30 2e 61 6c 61 72 6d 43 61 6c 6c 62 61  mem0.alarmCallba
20f0: 63 6b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  ck ){.    sqlite
2100: 33 4d 61 6c 6c 6f 63 41 6c 61 72 6d 28 6e 46 75  3MallocAlarm(nFu
2110: 6c 6c 29 3b 0a 20 20 20 20 70 20 3d 20 78 41 6c  ll);.    p = xAl
2120: 6c 6f 63 28 6e 46 75 6c 6c 29 3b 0a 20 20 7d 0a  loc(nFull);.  }.
2130: 23 65 6e 64 69 66 0a 20 20 69 66 28 20 70 20 29  #endif.  if( p )
2140: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 53 74 61  {.    sqlite3Sta
2150: 74 75 73 41 64 64 28 53 51 4c 49 54 45 5f 53 54  tusAdd(SQLITE_ST
2160: 41 54 55 53 5f 4d 45 4d 4f 52 59 5f 55 53 45 44  ATUS_MEMORY_USED
2170: 2c 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53  , sqlite3MallocS
2180: 69 7a 65 28 70 29 29 3b 0a 20 20 20 20 73 71 6c  ize(p));.    sql
2190: 69 74 65 33 53 74 61 74 75 73 41 64 64 28 53 51  ite3StatusAdd(SQ
21a0: 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d 41 4c 4c  LITE_STATUS_MALL
21b0: 4f 43 5f 43 4f 55 4e 54 2c 20 31 29 3b 0a 20 20  OC_COUNT, 1);.  
21c0: 7d 65 6c 73 65 7b 0a 20 20 20 20 74 65 73 74 63  }else{.    testc
21d0: 61 73 65 28 20 73 71 6c 69 74 65 33 47 6c 6f 62  ase( sqlite3Glob
21e0: 61 6c 43 6f 6e 66 69 67 2e 78 4c 6f 67 21 3d 30  alConfig.xLog!=0
21f0: 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f   );.    sqlite3_
2200: 6c 6f 67 28 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  log(SQLITE_NOMEM
2210: 2c 20 22 66 61 69 6c 65 64 20 74 6f 20 61 6c 6c  , "failed to all
2220: 6f 63 61 74 65 20 25 64 20 62 79 74 65 73 20 6f  ocate %d bytes o
2230: 66 20 6d 65 6d 6f 72 79 22 2c 20 6e 29 3b 0a 20  f memory", n);. 
2240: 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a   }..  return p;.
2250: 7d 0a 0a 2f 2a 0a 2a 2a 20 55 73 65 20 61 6c 6c  }../*.** Use all
2260: 6f 63 61 74 6f 72 20 66 75 6e 63 74 69 6f 6e 20  ocator function 
2270: 78 41 6c 6c 6f 63 20 74 6f 20 61 6c 6c 6f 63 61  xAlloc to alloca
2280: 74 65 20 6e 20 62 79 74 65 73 20 6f 66 20 6d 65  te n bytes of me
2290: 6d 6f 72 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  mory..*/.static 
22a0: 76 6f 69 64 20 2a 6d 65 6d 41 6c 6c 6f 63 61 74  void *memAllocat
22b0: 65 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62  e(.  sqlite3 *db
22c0: 2c 0a 20 20 76 6f 69 64 20 2a 28 2a 78 41 6c 6c  ,.  void *(*xAll
22d0: 6f 63 29 28 69 6e 74 29 2c 20 20 20 20 20 20 20  oc)(int),       
22e0: 20 20 20 20 2f 2a 20 4d 65 6d 6f 72 79 20 61 6c      /* Memory al
22f0: 6c 6f 63 61 74 69 6f 6e 20 66 75 6e 63 74 69 6f  location functio
2300: 6e 20 2a 2f 0a 20 20 69 6e 74 20 6e 20 20 20 20  n */.  int n    
2310: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2320: 20 20 20 20 20 20 20 2f 2a 20 42 79 74 65 73 20         /* Bytes 
2330: 6f 66 20 73 70 61 63 65 20 74 6f 20 61 6c 6c 6f  of space to allo
2340: 63 61 74 65 20 2a 2f 0a 29 7b 0a 20 20 76 6f 69  cate */.){.  voi
2350: 64 20 2a 70 3b 0a 20 20 69 66 28 20 6e 3c 3d 30  d *p;.  if( n<=0
2360: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
2370: 2a 20 49 4d 50 3a 20 52 2d 36 35 33 31 32 2d 30  * IMP: R-65312-0
2380: 34 39 31 37 20 2a 2f 20 0a 20 20 20 7c 7c 20 6e  4917 */ .   || n
2390: 3e 3d 30 78 37 66 66 66 66 66 30 30 0a 20 20 29  >=0x7fffff00.  )
23a0: 7b 0a 20 20 20 20 2f 2a 20 41 20 6d 65 6d 6f 72  {.    /* A memor
23b0: 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 6f 66 20  y allocation of 
23c0: 61 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65  a number of byte
23d0: 73 20 77 68 69 63 68 20 69 73 20 6e 65 61 72 20  s which is near 
23e0: 74 68 65 20 6d 61 78 69 6d 75 6d 0a 20 20 20 20  the maximum.    
23f0: 2a 2a 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65  ** signed intege
2400: 72 20 76 61 6c 75 65 20 6d 69 67 68 74 20 63 61  r value might ca
2410: 75 73 65 20 61 6e 20 69 6e 74 65 67 65 72 20 6f  use an integer o
2420: 76 65 72 66 6c 6f 77 20 69 6e 73 69 64 65 20 6f  verflow inside o
2430: 66 20 74 68 65 0a 20 20 20 20 2a 2a 20 78 4d 61  f the.    ** xMa
2440: 6c 6c 6f 63 28 29 2e 20 20 48 65 6e 63 65 20 77  lloc().  Hence w
2450: 65 20 6c 69 6d 69 74 20 74 68 65 20 6d 61 78 69  e limit the maxi
2460: 6d 75 6d 20 73 69 7a 65 20 74 6f 20 30 78 37 66  mum size to 0x7f
2470: 66 66 66 66 30 30 2c 20 67 69 76 69 6e 67 0a 20  ffff00, giving. 
2480: 20 20 20 2a 2a 20 32 35 35 20 62 79 74 65 73 20     ** 255 bytes 
2490: 6f 66 20 6f 76 65 72 68 65 61 64 2e 20 20 53 51  of overhead.  SQ
24a0: 4c 69 74 65 20 69 74 73 65 6c 66 20 77 69 6c 6c  Lite itself will
24b0: 20 6e 65 76 65 72 20 75 73 65 20 61 6e 79 74 68   never use anyth
24c0: 69 6e 67 20 6e 65 61 72 0a 20 20 20 20 2a 2a 20  ing near.    ** 
24d0: 74 68 69 73 20 61 6d 6f 75 6e 74 2e 20 20 54 68  this amount.  Th
24e0: 65 20 6f 6e 6c 79 20 77 61 79 20 74 6f 20 72 65  e only way to re
24f0: 61 63 68 20 74 68 65 20 6c 69 6d 69 74 20 69 73  ach the limit is
2500: 20 77 69 74 68 20 73 71 6c 69 74 65 33 5f 6d 61   with sqlite3_ma
2510: 6c 6c 6f 63 28 29 20 2a 2f 0a 20 20 20 20 70 20  lloc() */.    p 
2520: 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  = 0;.  }else{.  
2530: 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f    if( sqlite3Glo
2540: 62 61 6c 43 6f 6e 66 69 67 2e 62 4d 65 6d 73 74  balConfig.bMemst
2550: 61 74 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69  at ){.      sqli
2560: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28  te3_mutex_enter(
2570: 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20  mem0.mutex);.   
2580: 20 20 20 70 20 3d 20 6d 61 6c 6c 6f 63 57 69 74     p = mallocWit
2590: 68 41 6c 61 72 6d 28 78 41 6c 6c 6f 63 2c 20 6e  hAlarm(xAlloc, n
25a0: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  );.      sqlite3
25b0: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 65 6d  _mutex_leave(mem
25c0: 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 7d 65  0.mutex);.    }e
25d0: 6c 73 65 7b 0a 20 20 20 20 20 20 70 20 3d 20 78  lse{.      p = x
25e0: 41 6c 6c 6f 63 28 6e 29 3b 0a 20 20 20 20 7d 0a  Alloc(n);.    }.
25f0: 20 20 20 20 69 66 28 20 21 70 20 26 26 20 64 62      if( !p && db
2600: 20 29 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69   ) db->mallocFai
2610: 6c 65 64 20 3d 20 31 3b 0a 20 20 7d 0a 0a 20 20  led = 1;.  }..  
2620: 61 73 73 65 72 74 28 20 45 49 47 48 54 5f 42 59  assert( EIGHT_BY
2630: 54 45 5f 41 4c 49 47 4e 4d 45 4e 54 28 70 29 20  TE_ALIGNMENT(p) 
2640: 29 3b 20 20 2f 2a 20 49 4d 50 3a 20 52 2d 30 34  );  /* IMP: R-04
2650: 36 37 35 2d 34 34 38 35 30 20 2a 2f 0a 20 20 69  675-44850 */.  i
2660: 66 28 20 64 62 20 29 7b 0a 20 20 20 20 73 71 6c  f( db ){.    sql
2670: 69 74 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54  ite3MemdebugSetT
2680: 79 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 44  ype(p, MEMTYPE_D
2690: 42 20 7c 20 0a 20 20 20 20 20 20 20 20 28 28 64  B | .        ((d
26a0: 62 20 26 26 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69  b && db->lookasi
26b0: 64 65 2e 73 7a 29 20 3f 20 4d 45 4d 54 59 50 45  de.sz) ? MEMTYPE
26c0: 5f 4c 4f 4f 4b 41 53 49 44 45 20 3a 20 4d 45 4d  _LOOKASIDE : MEM
26d0: 54 59 50 45 5f 48 45 41 50 29 0a 20 20 20 20 29  TYPE_HEAP).    )
26e0: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70  ;.  }.  return p
26f0: 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f  ;.}.../*.** Allo
2700: 63 61 74 65 20 6d 65 6d 6f 72 79 2e 20 20 54 68  cate memory.  Th
2710: 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 6c 69  is routine is li
2720: 6b 65 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f  ke sqlite3_mallo
2730: 63 28 29 20 65 78 63 65 70 74 20 74 68 61 74 20  c() except that 
2740: 69 74 0a 2a 2a 20 61 73 73 75 6d 65 73 20 74 68  it.** assumes th
2750: 65 20 6d 65 6d 6f 72 79 20 73 75 62 73 79 73 74  e memory subsyst
2760: 65 6d 20 68 61 73 20 61 6c 72 65 61 64 79 20 62  em has already b
2770: 65 65 6e 20 69 6e 69 74 69 61 6c 69 7a 65 64 2e  een initialized.
2780: 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65  .*/.void *sqlite
2790: 33 4d 61 6c 6c 6f 63 28 69 6e 74 20 6e 29 7b 0a  3Malloc(int n){.
27a0: 20 20 72 65 74 75 72 6e 20 6d 65 6d 41 6c 6c 6f    return memAllo
27b0: 63 61 74 65 28 30 2c 20 73 71 6c 69 74 65 33 47  cate(0, sqlite3G
27c0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78 4d  lobalConfig.m.xM
27d0: 61 6c 6c 6f 63 2c 20 6e 29 3b 0a 7d 0a 0a 2f 2a  alloc, n);.}../*
27e0: 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 61 6e 64  .** Allocate and
27f0: 20 7a 65 72 6f 20 6d 65 6d 6f 72 79 2e 0a 2a 2f   zero memory..*/
2800: 20 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 4d   .void *sqlite3M
2810: 61 6c 6c 6f 63 5a 65 72 6f 28 69 6e 74 20 6e 29  allocZero(int n)
2820: 7b 0a 20 20 72 65 74 75 72 6e 20 6d 65 6d 41 6c  {.  return memAl
2830: 6c 6f 63 61 74 65 28 30 2c 20 73 71 6c 69 74 65  locate(0, sqlite
2840: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e  3GlobalConfig.m.
2850: 78 43 61 6c 6c 6f 63 2c 20 6e 29 3b 0a 7d 0a 0a  xCalloc, n);.}..
2860: 2f 2a 0a 2a 2a 20 54 68 69 73 20 76 65 72 73 69  /*.** This versi
2870: 6f 6e 20 6f 66 20 74 68 65 20 6d 65 6d 6f 72 79  on of the memory
2880: 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69 73 20 66   allocation is f
2890: 6f 72 20 75 73 65 20 62 79 20 74 68 65 20 61 70  or use by the ap
28a0: 70 6c 69 63 61 74 69 6f 6e 2e 0a 2a 2a 20 46 69  plication..** Fi
28b0: 72 73 74 20 6d 61 6b 65 20 73 75 72 65 20 74 68  rst make sure th
28c0: 65 20 6d 65 6d 6f 72 79 20 73 75 62 73 79 73 74  e memory subsyst
28d0: 65 6d 20 69 73 20 69 6e 69 74 69 61 6c 69 7a 65  em is initialize
28e0: 64 2c 20 74 68 65 6e 20 64 6f 20 74 68 65 0a 2a  d, then do the.*
28f0: 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e 2e 0a 2a 2f  * allocation..*/
2900: 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 6d  .void *sqlite3_m
2910: 61 6c 6c 6f 63 28 69 6e 74 20 6e 29 7b 0a 23 69  alloc(int n){.#i
2920: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
2930: 54 5f 41 55 54 4f 49 4e 49 54 0a 20 20 69 66 28  T_AUTOINIT.  if(
2940: 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c   sqlite3_initial
2950: 69 7a 65 28 29 20 29 20 72 65 74 75 72 6e 20 30  ize() ) return 0
2960: 3b 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 75 72  ;.#endif.  retur
2970: 6e 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28  n sqlite3Malloc(
2980: 6e 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 61 63  n);.}../*.** Eac
2990: 68 20 74 68 72 65 61 64 20 6d 61 79 20 6f 6e 6c  h thread may onl
29a0: 79 20 68 61 76 65 20 61 20 73 69 6e 67 6c 65 20  y have a single 
29b0: 6f 75 74 73 74 61 6e 64 69 6e 67 20 61 6c 6c 6f  outstanding allo
29c0: 63 61 74 69 6f 6e 20 66 72 6f 6d 0a 2a 2a 20 78  cation from.** x
29d0: 53 63 72 61 74 63 68 4d 61 6c 6c 6f 63 28 29 2e  ScratchMalloc().
29e0: 20 20 57 65 20 76 65 72 69 66 79 20 74 68 69 73    We verify this
29f0: 20 63 6f 6e 73 74 72 61 69 6e 74 20 69 6e 20 74   constraint in t
2a00: 68 65 20 73 69 6e 67 6c 65 2d 74 68 72 65 61 64  he single-thread
2a10: 65 64 0a 2a 2a 20 63 61 73 65 20 62 79 20 73 65  ed.** case by se
2a20: 74 74 69 6e 67 20 73 63 72 61 74 63 68 41 6c 6c  tting scratchAll
2a30: 6f 63 4f 75 74 20 74 6f 20 31 20 77 68 65 6e 20  ocOut to 1 when 
2a40: 61 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e 0a 2a 2a  an allocation.**
2a50: 20 69 73 20 6f 75 74 73 74 61 6e 64 69 6e 67 20   is outstanding 
2a60: 63 6c 65 61 72 69 6e 67 20 69 74 20 77 68 65 6e  clearing it when
2a70: 20 74 68 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 20   the allocation 
2a80: 69 73 20 66 72 65 65 64 2e 0a 2a 2f 0a 23 69 66  is freed..*/.#if
2a90: 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41   SQLITE_THREADSA
2aa0: 46 45 3d 3d 30 20 26 26 20 21 64 65 66 69 6e 65  FE==0 && !define
2ab0: 64 28 4e 44 45 42 55 47 29 0a 73 74 61 74 69 63  d(NDEBUG).static
2ac0: 20 69 6e 74 20 73 63 72 61 74 63 68 41 6c 6c 6f   int scratchAllo
2ad0: 63 4f 75 74 20 3d 20 30 3b 0a 23 65 6e 64 69 66  cOut = 0;.#endif
2ae0: 0a 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74  .../*.** Allocat
2af0: 65 20 6d 65 6d 6f 72 79 20 74 68 61 74 20 69 73  e memory that is
2b00: 20 74 6f 20 62 65 20 75 73 65 64 20 61 6e 64 20   to be used and 
2b10: 72 65 6c 65 61 73 65 64 20 72 69 67 68 74 20 61  released right a
2b20: 77 61 79 2e 0a 2a 2a 20 54 68 69 73 20 72 6f 75  way..** This rou
2b30: 74 69 6e 65 20 69 73 20 73 69 6d 69 6c 61 72 20  tine is similar 
2b40: 74 6f 20 61 6c 6c 6f 63 61 28 29 20 69 6e 20 74  to alloca() in t
2b50: 68 61 74 20 69 74 20 69 73 20 6e 6f 74 20 69 6e  hat it is not in
2b60: 74 65 6e 64 65 64 0a 2a 2a 20 66 6f 72 20 73 69  tended.** for si
2b70: 74 75 61 74 69 6f 6e 73 20 77 68 65 72 65 20 74  tuations where t
2b80: 68 65 20 6d 65 6d 6f 72 79 20 6d 69 67 68 74 20  he memory might 
2b90: 62 65 20 68 65 6c 64 20 6c 6f 6e 67 2d 74 65 72  be held long-ter
2ba0: 6d 2e 20 20 54 68 69 73 0a 2a 2a 20 72 6f 75 74  m.  This.** rout
2bb0: 69 6e 65 20 69 73 20 69 6e 74 65 6e 64 65 64 20  ine is intended 
2bc0: 74 6f 20 67 65 74 20 6d 65 6d 6f 72 79 20 74 6f  to get memory to
2bd0: 20 6f 6c 64 20 6c 61 72 67 65 20 74 72 61 6e 73   old large trans
2be0: 69 65 6e 74 20 64 61 74 61 0a 2a 2a 20 73 74 72  ient data.** str
2bf0: 75 63 74 75 72 65 73 20 74 68 61 74 20 77 6f 75  uctures that wou
2c00: 6c 64 20 6e 6f 74 20 6e 6f 72 6d 61 6c 6c 79 20  ld not normally 
2c10: 66 69 74 20 6f 6e 20 74 68 65 20 73 74 61 63 6b  fit on the stack
2c20: 20 6f 66 20 61 6e 0a 2a 2a 20 65 6d 62 65 64 64   of an.** embedd
2c30: 65 64 20 70 72 6f 63 65 73 73 6f 72 2e 0a 2a 2f  ed processor..*/
2c40: 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 53 63  .void *sqlite3Sc
2c50: 72 61 74 63 68 4d 61 6c 6c 6f 63 28 69 6e 74 20  ratchMalloc(int 
2c60: 6e 29 7b 0a 20 20 76 6f 69 64 20 2a 70 3b 0a 20  n){.  void *p;. 
2c70: 20 61 73 73 65 72 74 28 20 6e 3e 30 20 29 3b 0a   assert( n>0 );.
2c80: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  .  sqlite3_mutex
2c90: 5f 65 6e 74 65 72 28 6d 65 6d 30 2e 6d 75 74 65  _enter(mem0.mute
2ca0: 78 29 3b 0a 20 20 69 66 28 20 6d 65 6d 30 2e 6e  x);.  if( mem0.n
2cb0: 53 63 72 61 74 63 68 46 72 65 65 20 26 26 20 73  ScratchFree && s
2cc0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66  qlite3GlobalConf
2cd0: 69 67 2e 73 7a 53 63 72 61 74 63 68 3e 3d 6e 20  ig.szScratch>=n 
2ce0: 29 7b 0a 20 20 20 20 70 20 3d 20 6d 65 6d 30 2e  ){.    p = mem0.
2cf0: 70 53 63 72 61 74 63 68 46 72 65 65 3b 0a 20 20  pScratchFree;.  
2d00: 20 20 6d 65 6d 30 2e 70 53 63 72 61 74 63 68 46    mem0.pScratchF
2d10: 72 65 65 20 3d 20 6d 65 6d 30 2e 70 53 63 72 61  ree = mem0.pScra
2d20: 74 63 68 46 72 65 65 2d 3e 70 4e 65 78 74 3b 0a  tchFree->pNext;.
2d30: 20 20 20 20 6d 65 6d 30 2e 6e 53 63 72 61 74 63      mem0.nScratc
2d40: 68 46 72 65 65 2d 2d 3b 0a 20 20 20 20 73 71 6c  hFree--;.    sql
2d50: 69 74 65 33 53 74 61 74 75 73 41 64 64 28 53 51  ite3StatusAdd(SQ
2d60: 4c 49 54 45 5f 53 54 41 54 55 53 5f 53 43 52 41  LITE_STATUS_SCRA
2d70: 54 43 48 5f 55 53 45 44 2c 20 31 29 3b 0a 20 20  TCH_USED, 1);.  
2d80: 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 53    sqlite3StatusS
2d90: 65 74 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53  et(SQLITE_STATUS
2da0: 5f 53 43 52 41 54 43 48 5f 53 49 5a 45 2c 20 6e  _SCRATCH_SIZE, n
2db0: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d  );.    sqlite3_m
2dc0: 75 74 65 78 5f 6c 65 61 76 65 28 6d 65 6d 30 2e  utex_leave(mem0.
2dd0: 6d 75 74 65 78 29 3b 0a 20 20 7d 65 6c 73 65 7b  mutex);.  }else{
2de0: 0a 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33  .    if( sqlite3
2df0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 4d 65  GlobalConfig.bMe
2e00: 6d 73 74 61 74 20 29 7b 0a 20 20 20 20 20 20 73  mstat ){.      s
2e10: 71 6c 69 74 65 33 53 74 61 74 75 73 53 65 74 28  qlite3StatusSet(
2e20: 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 53 43  SQLITE_STATUS_SC
2e30: 52 41 54 43 48 5f 53 49 5a 45 2c 20 6e 29 3b 0a  RATCH_SIZE, n);.
2e40: 20 20 20 20 20 20 70 20 3d 20 6d 61 6c 6c 6f 63        p = malloc
2e50: 57 69 74 68 41 6c 61 72 6d 28 73 71 6c 69 74 65  WithAlarm(sqlite
2e60: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e  3GlobalConfig.m.
2e70: 78 4d 61 6c 6c 6f 63 2c 20 6e 29 3b 0a 20 20 20  xMalloc, n);.   
2e80: 20 20 20 69 66 28 20 70 20 29 7b 0a 20 20 20 20     if( p ){.    
2e90: 20 20 20 20 6e 20 3d 20 73 71 6c 69 74 65 33 4d      n = sqlite3M
2ea0: 61 6c 6c 6f 63 53 69 7a 65 28 70 29 3b 0a 20 20  allocSize(p);.  
2eb0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 53 74 61        sqlite3Sta
2ec0: 74 75 73 41 64 64 28 53 51 4c 49 54 45 5f 53 54  tusAdd(SQLITE_ST
2ed0: 41 54 55 53 5f 53 43 52 41 54 43 48 5f 4f 56 45  ATUS_SCRATCH_OVE
2ee0: 52 46 4c 4f 57 2c 20 6e 29 3b 0a 20 20 20 20 20  RFLOW, n);.     
2ef0: 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33   }.      sqlite3
2f00: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 65 6d  _mutex_leave(mem
2f10: 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 7d 65  0.mutex);.    }e
2f20: 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  lse{.      sqlit
2f30: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d  e3_mutex_leave(m
2f40: 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20  em0.mutex);.    
2f50: 20 20 70 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f    p = sqlite3Glo
2f60: 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78 4d 61 6c  balConfig.m.xMal
2f70: 6c 6f 63 28 6e 29 3b 0a 20 20 20 20 7d 0a 20 20  loc(n);.    }.  
2f80: 20 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75    sqlite3Memdebu
2f90: 67 53 65 74 54 79 70 65 28 70 2c 20 4d 45 4d 54  gSetType(p, MEMT
2fa0: 59 50 45 5f 53 43 52 41 54 43 48 29 3b 0a 20 20  YPE_SCRATCH);.  
2fb0: 7d 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69  }.  assert( sqli
2fc0: 74 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c  te3_mutex_nothel
2fd0: 64 28 6d 65 6d 30 2e 6d 75 74 65 78 29 20 29 3b  d(mem0.mutex) );
2fe0: 0a 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f 54 48  ...#if SQLITE_TH
2ff0: 52 45 41 44 53 41 46 45 3d 3d 30 20 26 26 20 21  READSAFE==0 && !
3000: 64 65 66 69 6e 65 64 28 4e 44 45 42 55 47 29 0a  defined(NDEBUG).
3010: 20 20 2f 2a 20 56 65 72 69 66 79 20 74 68 61 74    /* Verify that
3020: 20 6e 6f 20 6d 6f 72 65 20 74 68 61 6e 20 74 77   no more than tw
3030: 6f 20 73 63 72 61 74 63 68 20 61 6c 6c 6f 63 61  o scratch alloca
3040: 74 69 6f 6e 73 20 70 65 72 20 74 68 72 65 61 64  tions per thread
3050: 0a 20 20 2a 2a 20 61 72 65 20 6f 75 74 73 74 61  .  ** are outsta
3060: 6e 64 69 6e 67 20 61 74 20 6f 6e 65 20 74 69 6d  nding at one tim
3070: 65 2e 20 20 28 54 68 69 73 20 69 73 20 6f 6e 6c  e.  (This is onl
3080: 79 20 63 68 65 63 6b 65 64 20 69 6e 20 74 68 65  y checked in the
3090: 0a 20 20 2a 2a 20 73 69 6e 67 6c 65 2d 74 68 72  .  ** single-thr
30a0: 65 61 64 65 64 20 63 61 73 65 20 73 69 6e 63 65  eaded case since
30b0: 20 63 68 65 63 6b 69 6e 67 20 69 6e 20 74 68 65   checking in the
30c0: 20 6d 75 6c 74 69 2d 74 68 72 65 61 64 65 64 20   multi-threaded 
30d0: 63 61 73 65 0a 20 20 2a 2a 20 77 6f 75 6c 64 20  case.  ** would 
30e0: 62 65 20 6d 75 63 68 20 6d 6f 72 65 20 63 6f 6d  be much more com
30f0: 70 6c 69 63 61 74 65 64 2e 29 20 2a 2f 0a 20 20  plicated.) */.  
3100: 61 73 73 65 72 74 28 20 73 63 72 61 74 63 68 41  assert( scratchA
3110: 6c 6c 6f 63 4f 75 74 3c 3d 31 20 29 3b 0a 20 20  llocOut<=1 );.  
3120: 69 66 28 20 70 20 29 20 73 63 72 61 74 63 68 41  if( p ) scratchA
3130: 6c 6c 6f 63 4f 75 74 2b 2b 3b 0a 23 65 6e 64 69  llocOut++;.#endi
3140: 66 0a 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d  f..  return p;.}
3150: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 63 72  .void sqlite3Scr
3160: 61 74 63 68 46 72 65 65 28 76 6f 69 64 20 2a 70  atchFree(void *p
3170: 29 7b 0a 20 20 69 66 28 20 70 20 29 7b 0a 0a 23  ){.  if( p ){..#
3180: 69 66 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44  if SQLITE_THREAD
3190: 53 41 46 45 3d 3d 30 20 26 26 20 21 64 65 66 69  SAFE==0 && !defi
31a0: 6e 65 64 28 4e 44 45 42 55 47 29 0a 20 20 20 20  ned(NDEBUG).    
31b0: 2f 2a 20 56 65 72 69 66 79 20 74 68 61 74 20 6e  /* Verify that n
31c0: 6f 20 6d 6f 72 65 20 74 68 61 6e 20 74 77 6f 20  o more than two 
31d0: 73 63 72 61 74 63 68 20 61 6c 6c 6f 63 61 74 69  scratch allocati
31e0: 6f 6e 20 70 65 72 20 74 68 72 65 61 64 0a 20 20  on per thread.  
31f0: 20 20 2a 2a 20 69 73 20 6f 75 74 73 74 61 6e 64    ** is outstand
3200: 69 6e 67 20 61 74 20 6f 6e 65 20 74 69 6d 65 2e  ing at one time.
3210: 20 20 28 54 68 69 73 20 69 73 20 6f 6e 6c 79 20    (This is only 
3220: 63 68 65 63 6b 65 64 20 69 6e 20 74 68 65 0a 20  checked in the. 
3230: 20 20 20 2a 2a 20 73 69 6e 67 6c 65 2d 74 68 72     ** single-thr
3240: 65 61 64 65 64 20 63 61 73 65 20 73 69 6e 63 65  eaded case since
3250: 20 63 68 65 63 6b 69 6e 67 20 69 6e 20 74 68 65   checking in the
3260: 20 6d 75 6c 74 69 2d 74 68 72 65 61 64 65 64 20   multi-threaded 
3270: 63 61 73 65 0a 20 20 20 20 2a 2a 20 77 6f 75 6c  case.    ** woul
3280: 64 20 62 65 20 6d 75 63 68 20 6d 6f 72 65 20 63  d be much more c
3290: 6f 6d 70 6c 69 63 61 74 65 64 2e 29 20 2a 2f 0a  omplicated.) */.
32a0: 20 20 20 20 61 73 73 65 72 74 28 20 73 63 72 61      assert( scra
32b0: 74 63 68 41 6c 6c 6f 63 4f 75 74 3e 3d 31 20 26  tchAllocOut>=1 &
32c0: 26 20 73 63 72 61 74 63 68 41 6c 6c 6f 63 4f 75  & scratchAllocOu
32d0: 74 3c 3d 32 20 29 3b 0a 20 20 20 20 73 63 72 61  t<=2 );.    scra
32e0: 74 63 68 41 6c 6c 6f 63 4f 75 74 2d 2d 3b 0a 23  tchAllocOut--;.#
32f0: 65 6e 64 69 66 0a 0a 20 20 20 20 69 66 28 20 70  endif..    if( p
3300: 3e 3d 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43  >=sqlite3GlobalC
3310: 6f 6e 66 69 67 2e 70 53 63 72 61 74 63 68 20 26  onfig.pScratch &
3320: 26 20 70 3c 6d 65 6d 30 2e 70 53 63 72 61 74 63  & p<mem0.pScratc
3330: 68 45 6e 64 20 29 7b 0a 20 20 20 20 20 20 2f 2a  hEnd ){.      /*
3340: 20 52 65 6c 65 61 73 65 20 6d 65 6d 6f 72 79 20   Release memory 
3350: 66 72 6f 6d 20 74 68 65 20 53 51 4c 49 54 45 5f  from the SQLITE_
3360: 43 4f 4e 46 49 47 5f 53 43 52 41 54 43 48 20 61  CONFIG_SCRATCH a
3370: 6c 6c 6f 63 61 74 69 6f 6e 20 2a 2f 0a 20 20 20  llocation */.   
3380: 20 20 20 53 63 72 61 74 63 68 46 72 65 65 73 6c     ScratchFreesl
3390: 6f 74 20 2a 70 53 6c 6f 74 3b 0a 20 20 20 20 20  ot *pSlot;.     
33a0: 20 70 53 6c 6f 74 20 3d 20 28 53 63 72 61 74 63   pSlot = (Scratc
33b0: 68 46 72 65 65 73 6c 6f 74 2a 29 70 3b 0a 20 20  hFreeslot*)p;.  
33c0: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65      sqlite3_mute
33d0: 78 5f 65 6e 74 65 72 28 6d 65 6d 30 2e 6d 75 74  x_enter(mem0.mut
33e0: 65 78 29 3b 0a 20 20 20 20 20 20 70 53 6c 6f 74  ex);.      pSlot
33f0: 2d 3e 70 4e 65 78 74 20 3d 20 6d 65 6d 30 2e 70  ->pNext = mem0.p
3400: 53 63 72 61 74 63 68 46 72 65 65 3b 0a 20 20 20  ScratchFree;.   
3410: 20 20 20 6d 65 6d 30 2e 70 53 63 72 61 74 63 68     mem0.pScratch
3420: 46 72 65 65 20 3d 20 70 53 6c 6f 74 3b 0a 20 20  Free = pSlot;.  
3430: 20 20 20 20 6d 65 6d 30 2e 6e 53 63 72 61 74 63      mem0.nScratc
3440: 68 46 72 65 65 2b 2b 3b 0a 20 20 20 20 20 20 61  hFree++;.      a
3450: 73 73 65 72 74 28 20 6d 65 6d 30 2e 6e 53 63 72  ssert( mem0.nScr
3460: 61 74 63 68 46 72 65 65 20 3c 3d 20 28 75 33 32  atchFree <= (u32
3470: 29 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f  )sqlite3GlobalCo
3480: 6e 66 69 67 2e 6e 53 63 72 61 74 63 68 20 29 3b  nfig.nScratch );
3490: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 53 74  .      sqlite3St
34a0: 61 74 75 73 41 64 64 28 53 51 4c 49 54 45 5f 53  atusAdd(SQLITE_S
34b0: 54 41 54 55 53 5f 53 43 52 41 54 43 48 5f 55 53  TATUS_SCRATCH_US
34c0: 45 44 2c 20 2d 31 29 3b 0a 20 20 20 20 20 20 73  ED, -1);.      s
34d0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
34e0: 76 65 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a  ve(mem0.mutex);.
34f0: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
3500: 20 2f 2a 20 52 65 6c 65 61 73 65 20 6d 65 6d 6f   /* Release memo
3510: 72 79 20 62 61 63 6b 20 74 6f 20 74 68 65 20 68  ry back to the h
3520: 65 61 70 20 2a 2f 0a 20 20 20 20 20 20 61 73 73  eap */.      ass
3530: 65 72 74 28 20 73 71 6c 69 74 65 33 4d 65 6d 64  ert( sqlite3Memd
3540: 65 62 75 67 48 61 73 54 79 70 65 28 70 2c 20 4d  ebugHasType(p, M
3550: 45 4d 54 59 50 45 5f 53 43 52 41 54 43 48 29 20  EMTYPE_SCRATCH) 
3560: 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28  );.      assert(
3570: 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67   sqlite3Memdebug
3580: 4e 6f 54 79 70 65 28 70 2c 20 7e 4d 45 4d 54 59  NoType(p, ~MEMTY
3590: 50 45 5f 53 43 52 41 54 43 48 29 20 29 3b 0a 20  PE_SCRATCH) );. 
35a0: 20 20 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 64       sqlite3Memd
35b0: 65 62 75 67 53 65 74 54 79 70 65 28 70 2c 20 4d  ebugSetType(p, M
35c0: 45 4d 54 59 50 45 5f 48 45 41 50 29 3b 0a 20 20  EMTYPE_HEAP);.  
35d0: 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 47      if( sqlite3G
35e0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 4d 65 6d  lobalConfig.bMem
35f0: 73 74 61 74 20 29 7b 0a 20 20 20 20 20 20 20 20  stat ){.        
3600: 69 6e 74 20 69 53 69 7a 65 20 3d 20 73 71 6c 69  int iSize = sqli
3610: 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 29  te3MallocSize(p)
3620: 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65  ;.        sqlite
3630: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d 65  3_mutex_enter(me
3640: 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 20  m0.mutex);.     
3650: 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73     sqlite3Status
3660: 41 64 64 28 53 51 4c 49 54 45 5f 53 54 41 54 55  Add(SQLITE_STATU
3670: 53 5f 53 43 52 41 54 43 48 5f 4f 56 45 52 46 4c  S_SCRATCH_OVERFL
3680: 4f 57 2c 20 2d 69 53 69 7a 65 29 3b 0a 20 20 20  OW, -iSize);.   
3690: 20 20 20 20 20 73 71 6c 69 74 65 33 53 74 61 74       sqlite3Stat
36a0: 75 73 41 64 64 28 53 51 4c 49 54 45 5f 53 54 41  usAdd(SQLITE_STA
36b0: 54 55 53 5f 4d 45 4d 4f 52 59 5f 55 53 45 44 2c  TUS_MEMORY_USED,
36c0: 20 2d 69 53 69 7a 65 29 3b 0a 20 20 20 20 20 20   -iSize);.      
36d0: 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 41    sqlite3StatusA
36e0: 64 64 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53  dd(SQLITE_STATUS
36f0: 5f 4d 41 4c 4c 4f 43 5f 43 4f 55 4e 54 2c 20 2d  _MALLOC_COUNT, -
3700: 31 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69  1);.        sqli
3710: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e  te3GlobalConfig.
3720: 6d 2e 78 46 72 65 65 28 70 29 3b 0a 20 20 20 20  m.xFree(p);.    
3730: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65      sqlite3_mute
3740: 78 5f 6c 65 61 76 65 28 6d 65 6d 30 2e 6d 75 74  x_leave(mem0.mut
3750: 65 78 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65  ex);.      }else
3760: 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65  {.        sqlite
3770: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e  3GlobalConfig.m.
3780: 78 46 72 65 65 28 70 29 3b 0a 20 20 20 20 20 20  xFree(p);.      
3790: 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f  }.    }.  }.}../
37a0: 2a 0a 2a 2a 20 54 52 55 45 20 69 66 20 70 20 69  *.** TRUE if p i
37b0: 73 20 61 20 6c 6f 6f 6b 61 73 69 64 65 20 6d 65  s a lookaside me
37c0: 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20  mory allocation 
37d0: 66 72 6f 6d 20 64 62 0a 2a 2f 0a 23 69 66 6e 64  from db.*/.#ifnd
37e0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4c  ef SQLITE_OMIT_L
37f0: 4f 4f 4b 41 53 49 44 45 0a 73 74 61 74 69 63 20  OOKASIDE.static 
3800: 69 6e 74 20 69 73 4c 6f 6f 6b 61 73 69 64 65 28  int isLookaside(
3810: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 76 6f 69  sqlite3 *db, voi
3820: 64 20 2a 70 29 7b 0a 20 20 72 65 74 75 72 6e 20  d *p){.  return 
3830: 70 20 26 26 20 70 3e 3d 64 62 2d 3e 6c 6f 6f 6b  p && p>=db->look
3840: 61 73 69 64 65 2e 70 53 74 61 72 74 20 26 26 20  aside.pStart && 
3850: 70 3c 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e  p<db->lookaside.
3860: 70 45 6e 64 3b 0a 7d 0a 23 65 6c 73 65 0a 23 64  pEnd;.}.#else.#d
3870: 65 66 69 6e 65 20 69 73 4c 6f 6f 6b 61 73 69 64  efine isLookasid
3880: 65 28 41 2c 42 29 20 30 0a 23 65 6e 64 69 66 0a  e(A,B) 0.#endif.
3890: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68  ./*.** Return th
38a0: 65 20 73 69 7a 65 20 6f 66 20 61 20 6d 65 6d 6f  e size of a memo
38b0: 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 70 72  ry allocation pr
38c0: 65 76 69 6f 75 73 6c 79 20 6f 62 74 61 69 6e 65  eviously obtaine
38d0: 64 20 66 72 6f 6d 0a 2a 2a 20 73 71 6c 69 74 65  d from.** sqlite
38e0: 33 4d 61 6c 6c 6f 63 28 29 20 6f 72 20 73 71 6c  3Malloc() or sql
38f0: 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 29 2e 0a 2a  ite3_malloc()..*
3900: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d 61 6c  /.int sqlite3Mal
3910: 6c 6f 63 53 69 7a 65 28 76 6f 69 64 20 2a 70 29  locSize(void *p)
3920: 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69  {.  assert( sqli
3930: 74 65 33 4d 65 6d 64 65 62 75 67 48 61 73 54 79  te3MemdebugHasTy
3940: 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 48 45  pe(p, MEMTYPE_HE
3950: 41 50 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28  AP) );.  assert(
3960: 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67   sqlite3Memdebug
3970: 4e 6f 54 79 70 65 28 70 2c 20 4d 45 4d 54 59 50  NoType(p, MEMTYP
3980: 45 5f 44 42 29 20 29 3b 0a 20 20 72 65 74 75 72  E_DB) );.  retur
3990: 6e 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43  n sqlite3GlobalC
39a0: 6f 6e 66 69 67 2e 6d 2e 78 53 69 7a 65 28 70 29  onfig.m.xSize(p)
39b0: 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 44  ;.}.int sqlite3D
39c0: 62 4d 61 6c 6c 6f 63 53 69 7a 65 28 73 71 6c 69  bMallocSize(sqli
39d0: 74 65 33 20 2a 64 62 2c 20 76 6f 69 64 20 2a 70  te3 *db, void *p
39e0: 29 7b 0a 20 20 61 73 73 65 72 74 28 20 64 62 3d  ){.  assert( db=
39f0: 3d 30 20 7c 7c 20 73 71 6c 69 74 65 33 5f 6d 75  =0 || sqlite3_mu
3a00: 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74  tex_held(db->mut
3a10: 65 78 29 20 29 3b 0a 20 20 69 66 28 20 64 62 20  ex) );.  if( db 
3a20: 26 26 20 69 73 4c 6f 6f 6b 61 73 69 64 65 28 64  && isLookaside(d
3a30: 62 2c 20 70 29 20 29 7b 0a 20 20 20 20 72 65 74  b, p) ){.    ret
3a40: 75 72 6e 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64  urn db->lookasid
3a50: 65 2e 73 7a 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  e.sz;.  }else{. 
3a60: 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74     assert( sqlit
3a70: 65 33 4d 65 6d 64 65 62 75 67 48 61 73 54 79 70  e3MemdebugHasTyp
3a80: 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 44 42 29  e(p, MEMTYPE_DB)
3a90: 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20   );.    assert( 
3aa0: 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 48  sqlite3MemdebugH
3ab0: 61 73 54 79 70 65 28 70 2c 20 4d 45 4d 54 59 50  asType(p, MEMTYP
3ac0: 45 5f 4c 4f 4f 4b 41 53 49 44 45 7c 4d 45 4d 54  E_LOOKASIDE|MEMT
3ad0: 59 50 45 5f 48 45 41 50 29 20 29 3b 0a 20 20 20  YPE_HEAP) );.   
3ae0: 20 61 73 73 65 72 74 28 20 64 62 21 3d 30 20 7c   assert( db!=0 |
3af0: 7c 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 2c 20 4d 45 4d 54 59  gNoType(p, MEMTY
3b10: 50 45 5f 4c 4f 4f 4b 41 53 49 44 45 29 20 29 3b  PE_LOOKASIDE) );
3b20: 0a 20 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69  .    return sqli
3b30: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e  te3GlobalConfig.
3b40: 6d 2e 78 53 69 7a 65 28 70 29 3b 0a 20 20 7d 0a  m.xSize(p);.  }.
3b50: 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 6d 65  }../*.** Free me
3b60: 6d 6f 72 79 20 70 72 65 76 69 6f 75 73 6c 79 20  mory previously 
3b70: 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 73 71  obtained from sq
3b80: 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 29 2e 0a 2a  lite3Malloc()..*
3b90: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 66  /.void sqlite3_f
3ba0: 72 65 65 28 76 6f 69 64 20 2a 70 29 7b 0a 20 20  ree(void *p){.  
3bb0: 69 66 28 20 70 3d 3d 30 20 29 20 72 65 74 75 72  if( p==0 ) retur
3bc0: 6e 3b 20 20 2f 2a 20 49 4d 50 3a 20 52 2d 34 39  n;  /* IMP: R-49
3bd0: 30 35 33 2d 35 34 35 35 34 20 2a 2f 0a 20 20 61  053-54554 */.  a
3be0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d 65  ssert( sqlite3Me
3bf0: 6d 64 65 62 75 67 4e 6f 54 79 70 65 28 70 2c 20  mdebugNoType(p, 
3c00: 4d 45 4d 54 59 50 45 5f 44 42 29 20 29 3b 0a 20  MEMTYPE_DB) );. 
3c10: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
3c20: 4d 65 6d 64 65 62 75 67 48 61 73 54 79 70 65 28  MemdebugHasType(
3c30: 70 2c 20 4d 45 4d 54 59 50 45 5f 48 45 41 50 29  p, MEMTYPE_HEAP)
3c40: 20 29 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65   );.  if( sqlite
3c50: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 4d  3GlobalConfig.bM
3c60: 65 6d 73 74 61 74 20 29 7b 0a 20 20 20 20 73 71  emstat ){.    sq
3c70: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
3c80: 72 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20  r(mem0.mutex);. 
3c90: 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73     sqlite3Status
3ca0: 41 64 64 28 53 51 4c 49 54 45 5f 53 54 41 54 55  Add(SQLITE_STATU
3cb0: 53 5f 4d 45 4d 4f 52 59 5f 55 53 45 44 2c 20 2d  S_MEMORY_USED, -
3cc0: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a  sqlite3MallocSiz
3cd0: 65 28 70 29 29 3b 0a 20 20 20 20 73 71 6c 69 74  e(p));.    sqlit
3ce0: 65 33 53 74 61 74 75 73 41 64 64 28 53 51 4c 49  e3StatusAdd(SQLI
3cf0: 54 45 5f 53 54 41 54 55 53 5f 4d 41 4c 4c 4f 43  TE_STATUS_MALLOC
3d00: 5f 43 4f 55 4e 54 2c 20 2d 31 29 3b 0a 20 20 20  _COUNT, -1);.   
3d10: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f   sqlite3GlobalCo
3d20: 6e 66 69 67 2e 6d 2e 78 46 72 65 65 28 70 29 3b  nfig.m.xFree(p);
3d30: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  .    sqlite3_mut
3d40: 65 78 5f 6c 65 61 76 65 28 6d 65 6d 30 2e 6d 75  ex_leave(mem0.mu
3d50: 74 65 78 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  tex);.  }else{. 
3d60: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c     sqlite3Global
3d70: 43 6f 6e 66 69 67 2e 6d 2e 78 46 72 65 65 28 70  Config.m.xFree(p
3d80: 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  );.  }.}../*.** 
3d90: 46 72 65 65 20 6d 65 6d 6f 72 79 20 74 68 61 74  Free memory that
3da0: 20 6d 69 67 68 74 20 62 65 20 61 73 73 6f 63 69   might be associ
3db0: 61 74 65 64 20 77 69 74 68 20 61 20 70 61 72 74  ated with a part
3dc0: 69 63 75 6c 61 72 20 64 61 74 61 62 61 73 65 0a  icular database.
3dd0: 2a 2a 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a  ** connection..*
3de0: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 44 62  /.void sqlite3Db
3df0: 46 72 65 65 28 73 71 6c 69 74 65 33 20 2a 64 62  Free(sqlite3 *db
3e00: 2c 20 76 6f 69 64 20 2a 70 29 7b 0a 20 20 61 73  , void *p){.  as
3e10: 73 65 72 74 28 20 64 62 3d 3d 30 20 7c 7c 20 73  sert( db==0 || s
3e20: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c  qlite3_mutex_hel
3e30: 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a  d(db->mutex) );.
3e40: 20 20 69 66 28 20 64 62 20 29 7b 0a 20 20 20 20    if( db ){.    
3e50: 69 66 28 20 64 62 2d 3e 70 6e 42 79 74 65 73 46  if( db->pnBytesF
3e60: 72 65 65 64 20 29 7b 0a 20 20 20 20 20 20 2a 64  reed ){.      *d
3e70: 62 2d 3e 70 6e 42 79 74 65 73 46 72 65 65 64 20  b->pnBytesFreed 
3e80: 2b 3d 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c  += sqlite3DbMall
3e90: 6f 63 53 69 7a 65 28 64 62 2c 20 70 29 3b 0a 20  ocSize(db, p);. 
3ea0: 20 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 20       return;.   
3eb0: 20 7d 0a 20 20 20 20 69 66 28 20 69 73 4c 6f 6f   }.    if( isLoo
3ec0: 6b 61 73 69 64 65 28 64 62 2c 20 70 29 20 29 7b  kaside(db, p) ){
3ed0: 0a 20 20 20 20 20 20 4c 6f 6f 6b 61 73 69 64 65  .      Lookaside
3ee0: 53 6c 6f 74 20 2a 70 42 75 66 20 3d 20 28 4c 6f  Slot *pBuf = (Lo
3ef0: 6f 6b 61 73 69 64 65 53 6c 6f 74 2a 29 70 3b 0a  okasideSlot*)p;.
3f00: 23 69 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47  #if SQLITE_DEBUG
3f10: 0a 20 20 20 20 20 20 2f 2a 20 54 72 61 73 68 20  .      /* Trash 
3f20: 61 6c 6c 20 63 6f 6e 74 65 6e 74 20 69 6e 20 74  all content in t
3f30: 68 65 20 62 75 66 66 65 72 20 62 65 69 6e 67 20  he buffer being 
3f40: 66 72 65 65 64 20 2a 2f 0a 20 20 20 20 20 20 6d  freed */.      m
3f50: 65 6d 73 65 74 28 70 2c 20 30 78 61 61 2c 20 64  emset(p, 0xaa, d
3f60: 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 73 7a 29  b->lookaside.sz)
3f70: 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 70  ;.#endif.      p
3f80: 42 75 66 2d 3e 70 4e 65 78 74 20 3d 20 64 62 2d  Buf->pNext = db-
3f90: 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 46 72 65 65  >lookaside.pFree
3fa0: 3b 0a 20 20 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b  ;.      db->look
3fb0: 61 73 69 64 65 2e 70 46 72 65 65 20 3d 20 70 42  aside.pFree = pB
3fc0: 75 66 3b 0a 20 20 20 20 20 20 64 62 2d 3e 6c 6f  uf;.      db->lo
3fd0: 6f 6b 61 73 69 64 65 2e 6e 4f 75 74 2d 2d 3b 0a  okaside.nOut--;.
3fe0: 20 20 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20        return;.  
3ff0: 20 20 7d 0a 20 20 7d 0a 20 20 61 73 73 65 72 74    }.  }.  assert
4000: 28 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75  ( sqlite3Memdebu
4010: 67 48 61 73 54 79 70 65 28 70 2c 20 4d 45 4d 54  gHasType(p, MEMT
4020: 59 50 45 5f 44 42 29 20 29 3b 0a 20 20 61 73 73  YPE_DB) );.  ass
4030: 65 72 74 28 20 73 71 6c 69 74 65 33 4d 65 6d 64  ert( sqlite3Memd
4040: 65 62 75 67 48 61 73 54 79 70 65 28 70 2c 20 4d  ebugHasType(p, M
4050: 45 4d 54 59 50 45 5f 4c 4f 4f 4b 41 53 49 44 45  EMTYPE_LOOKASIDE
4060: 7c 4d 45 4d 54 59 50 45 5f 48 45 41 50 29 20 29  |MEMTYPE_HEAP) )
4070: 3b 0a 20 20 61 73 73 65 72 74 28 20 64 62 21 3d  ;.  assert( db!=
4080: 30 20 7c 7c 20 73 71 6c 69 74 65 33 4d 65 6d 64  0 || sqlite3Memd
4090: 65 62 75 67 4e 6f 54 79 70 65 28 70 2c 20 4d 45  ebugNoType(p, ME
40a0: 4d 54 59 50 45 5f 4c 4f 4f 4b 41 53 49 44 45 29  MTYPE_LOOKASIDE)
40b0: 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 4d 65 6d   );.  sqlite3Mem
40c0: 64 65 62 75 67 53 65 74 54 79 70 65 28 70 2c 20  debugSetType(p, 
40d0: 4d 45 4d 54 59 50 45 5f 48 45 41 50 29 3b 0a 20  MEMTYPE_HEAP);. 
40e0: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 29   sqlite3_free(p)
40f0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67  ;.}../*.** Chang
4100: 65 20 74 68 65 20 73 69 7a 65 20 6f 66 20 61 6e  e the size of an
4110: 20 65 78 69 73 74 69 6e 67 20 6d 65 6d 6f 72 79   existing memory
4120: 20 61 6c 6c 6f 63 61 74 69 6f 6e 0a 2a 2f 0a 76   allocation.*/.v
4130: 6f 69 64 20 2a 73 71 6c 69 74 65 33 52 65 61 6c  oid *sqlite3Real
4140: 6c 6f 63 28 76 6f 69 64 20 2a 70 4f 6c 64 2c 20  loc(void *pOld, 
4150: 69 6e 74 20 6e 42 79 74 65 73 29 7b 0a 20 20 69  int nBytes){.  i
4160: 6e 74 20 6e 4f 6c 64 2c 20 6e 4e 65 77 2c 20 6e  nt nOld, nNew, n
4170: 44 69 66 66 3b 0a 20 20 76 6f 69 64 20 2a 70 4e  Diff;.  void *pN
4180: 65 77 3b 0a 20 20 69 66 28 20 70 4f 6c 64 3d 3d  ew;.  if( pOld==
4190: 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  0 ){.    return 
41a0: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 6e 42  sqlite3Malloc(nB
41b0: 79 74 65 73 29 3b 20 2f 2a 20 49 4d 50 3a 20 52  ytes); /* IMP: R
41c0: 2d 32 38 33 35 34 2d 32 35 37 36 39 20 2a 2f 0a  -28354-25769 */.
41d0: 20 20 7d 0a 20 20 69 66 28 20 6e 42 79 74 65 73    }.  if( nBytes
41e0: 3c 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  <=0 ){.    sqlit
41f0: 65 33 5f 66 72 65 65 28 70 4f 6c 64 29 3b 20 2f  e3_free(pOld); /
4200: 2a 20 49 4d 50 3a 20 52 2d 33 31 35 39 33 2d 31  * IMP: R-31593-1
4210: 30 35 37 34 20 2a 2f 0a 20 20 20 20 72 65 74 75  0574 */.    retu
4220: 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20  rn 0;.  }.  if( 
4230: 6e 42 79 74 65 73 3e 3d 30 78 37 66 66 66 66 66  nBytes>=0x7fffff
4240: 30 30 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65  00 ){.    /* The
4250: 20 30 78 37 66 66 66 66 30 30 20 6c 69 6d 69 74   0x7ffff00 limit
4260: 20 74 65 72 6d 20 69 73 20 65 78 70 6c 61 69 6e   term is explain
4270: 65 64 20 69 6e 20 63 6f 6d 6d 65 6e 74 73 20 6f  ed in comments o
4280: 6e 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28  n sqlite3Malloc(
4290: 29 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e 20  ) */.    return 
42a0: 30 3b 0a 20 20 7d 0a 20 20 6e 4f 6c 64 20 3d 20  0;.  }.  nOld = 
42b0: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a  sqlite3MallocSiz
42c0: 65 28 70 4f 6c 64 29 3b 0a 20 20 2f 2a 20 49 4d  e(pOld);.  /* IM
42d0: 50 4c 45 4d 45 4e 54 41 54 49 4f 4e 2d 4f 46 3a  PLEMENTATION-OF:
42e0: 20 52 2d 34 36 31 39 39 2d 33 30 32 34 39 20 53   R-46199-30249 S
42f0: 51 4c 69 74 65 20 67 75 61 72 61 6e 74 65 65 73  QLite guarantees
4300: 20 74 68 61 74 20 74 68 65 20 73 65 63 6f 6e 64   that the second
4310: 0a 20 20 2a 2a 20 61 72 67 75 6d 65 6e 74 20 74  .  ** argument t
4320: 6f 20 78 52 65 61 6c 6c 6f 63 20 69 73 20 61 6c  o xRealloc is al
4330: 77 61 79 73 20 61 20 76 61 6c 75 65 20 72 65 74  ways a value ret
4340: 75 72 6e 65 64 20 62 79 20 61 20 70 72 69 6f 72  urned by a prior
4350: 20 63 61 6c 6c 20 74 6f 0a 20 20 2a 2a 20 78 52   call to.  ** xR
4360: 6f 75 6e 64 75 70 2e 20 2a 2f 0a 20 20 6e 4e 65  oundup. */.  nNe
4370: 77 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61  w = sqlite3Globa
4380: 6c 43 6f 6e 66 69 67 2e 6d 2e 78 52 6f 75 6e 64  lConfig.m.xRound
4390: 75 70 28 6e 42 79 74 65 73 29 3b 0a 20 20 69 66  up(nBytes);.  if
43a0: 28 20 6e 4f 6c 64 3d 3d 6e 4e 65 77 20 29 7b 0a  ( nOld==nNew ){.
43b0: 20 20 20 20 70 4e 65 77 20 3d 20 70 4f 6c 64 3b      pNew = pOld;
43c0: 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 73 71 6c  .  }else if( sql
43d0: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67  ite3GlobalConfig
43e0: 2e 62 4d 65 6d 73 74 61 74 20 29 7b 0a 20 20 20  .bMemstat ){.   
43f0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65   sqlite3_mutex_e
4400: 6e 74 65 72 28 6d 65 6d 30 2e 6d 75 74 65 78 29  nter(mem0.mutex)
4410: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 53 74 61  ;.    sqlite3Sta
4420: 74 75 73 53 65 74 28 53 51 4c 49 54 45 5f 53 54  tusSet(SQLITE_ST
4430: 41 54 55 53 5f 4d 41 4c 4c 4f 43 5f 53 49 5a 45  ATUS_MALLOC_SIZE
4440: 2c 20 6e 42 79 74 65 73 29 3b 0a 20 20 20 20 6e  , nBytes);.    n
4450: 44 69 66 66 20 3d 20 6e 4e 65 77 20 2d 20 6e 4f  Diff = nNew - nO
4460: 6c 64 3b 0a 20 20 20 20 69 66 28 20 73 71 6c 69  ld;.    if( sqli
4470: 74 65 33 53 74 61 74 75 73 56 61 6c 75 65 28 53  te3StatusValue(S
4480: 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d 45 4d  QLITE_STATUS_MEM
4490: 4f 52 59 5f 55 53 45 44 29 20 3e 3d 20 0a 20 20  ORY_USED) >= .  
44a0: 20 20 20 20 20 20 20 20 6d 65 6d 30 2e 61 6c 61          mem0.ala
44b0: 72 6d 54 68 72 65 73 68 6f 6c 64 2d 6e 44 69 66  rmThreshold-nDif
44c0: 66 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  f ){.      sqlit
44d0: 65 33 4d 61 6c 6c 6f 63 41 6c 61 72 6d 28 6e 44  e3MallocAlarm(nD
44e0: 69 66 66 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20  iff);.    }.    
44f0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d  assert( sqlite3M
4500: 65 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 70  emdebugHasType(p
4510: 4f 6c 64 2c 20 4d 45 4d 54 59 50 45 5f 48 45 41  Old, MEMTYPE_HEA
4520: 50 29 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74  P) );.    assert
4530: 28 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75  ( sqlite3Memdebu
4540: 67 4e 6f 54 79 70 65 28 70 4f 6c 64 2c 20 7e 4d  gNoType(pOld, ~M
4550: 45 4d 54 59 50 45 5f 48 45 41 50 29 20 29 3b 0a  EMTYPE_HEAP) );.
4560: 20 20 20 20 70 4e 65 77 20 3d 20 73 71 6c 69 74      pNew = sqlit
4570: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d  e3GlobalConfig.m
4580: 2e 78 52 65 61 6c 6c 6f 63 28 70 4f 6c 64 2c 20  .xRealloc(pOld, 
4590: 6e 4e 65 77 29 3b 0a 20 20 20 20 69 66 28 20 70  nNew);.    if( p
45a0: 4e 65 77 3d 3d 30 20 26 26 20 6d 65 6d 30 2e 61  New==0 && mem0.a
45b0: 6c 61 72 6d 43 61 6c 6c 62 61 63 6b 20 29 7b 0a  larmCallback ){.
45c0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 4d 61 6c        sqlite3Mal
45d0: 6c 6f 63 41 6c 61 72 6d 28 6e 42 79 74 65 73 29  locAlarm(nBytes)
45e0: 3b 0a 20 20 20 20 20 20 70 4e 65 77 20 3d 20 73  ;.      pNew = s
45f0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66  qlite3GlobalConf
4600: 69 67 2e 6d 2e 78 52 65 61 6c 6c 6f 63 28 70 4f  ig.m.xRealloc(pO
4610: 6c 64 2c 20 6e 4e 65 77 29 3b 0a 20 20 20 20 7d  ld, nNew);.    }
4620: 0a 20 20 20 20 69 66 28 20 70 4e 65 77 20 29 7b  .    if( pNew ){
4630: 0a 20 20 20 20 20 20 6e 4e 65 77 20 3d 20 73 71  .      nNew = sq
4640: 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28  lite3MallocSize(
4650: 70 4e 65 77 29 3b 0a 20 20 20 20 20 20 73 71 6c  pNew);.      sql
4660: 69 74 65 33 53 74 61 74 75 73 41 64 64 28 53 51  ite3StatusAdd(SQ
4670: 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d 45 4d 4f  LITE_STATUS_MEMO
4680: 52 59 5f 55 53 45 44 2c 20 6e 4e 65 77 2d 6e 4f  RY_USED, nNew-nO
4690: 6c 64 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73  ld);.    }.    s
46a0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
46b0: 76 65 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a  ve(mem0.mutex);.
46c0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 4e 65    }else{.    pNe
46d0: 77 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61  w = sqlite3Globa
46e0: 6c 43 6f 6e 66 69 67 2e 6d 2e 78 52 65 61 6c 6c  lConfig.m.xReall
46f0: 6f 63 28 70 4f 6c 64 2c 20 6e 4e 65 77 29 3b 0a  oc(pOld, nNew);.
4700: 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 45 49    }.  assert( EI
4710: 47 48 54 5f 42 59 54 45 5f 41 4c 49 47 4e 4d 45  GHT_BYTE_ALIGNME
4720: 4e 54 28 70 4e 65 77 29 20 29 3b 20 2f 2a 20 49  NT(pNew) ); /* I
4730: 4d 50 3a 20 52 2d 30 34 36 37 35 2d 34 34 38 35  MP: R-04675-4485
4740: 30 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 70 4e  0 */.  return pN
4750: 65 77 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65  ew;.}../*.** The
4760: 20 70 75 62 6c 69 63 20 69 6e 74 65 72 66 61 63   public interfac
4770: 65 20 74 6f 20 73 71 6c 69 74 65 33 52 65 61 6c  e to sqlite3Real
4780: 6c 6f 63 2e 20 20 4d 61 6b 65 20 73 75 72 65 20  loc.  Make sure 
4790: 74 68 61 74 20 74 68 65 20 6d 65 6d 6f 72 79 0a  that the memory.
47a0: 2a 2a 20 73 75 62 73 79 73 74 65 6d 20 69 73 20  ** subsystem is 
47b0: 69 6e 69 74 69 61 6c 69 7a 65 64 20 70 72 69 6f  initialized prio
47c0: 72 20 74 6f 20 69 6e 76 6f 6b 69 6e 67 20 73 71  r to invoking sq
47d0: 6c 69 74 65 52 65 61 6c 6c 6f 63 2e 0a 2a 2f 0a  liteRealloc..*/.
47e0: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 72 65  void *sqlite3_re
47f0: 61 6c 6c 6f 63 28 76 6f 69 64 20 2a 70 4f 6c 64  alloc(void *pOld
4800: 2c 20 69 6e 74 20 6e 29 7b 0a 23 69 66 6e 64 65  , int n){.#ifnde
4810: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55  f SQLITE_OMIT_AU
4820: 54 4f 49 4e 49 54 0a 20 20 69 66 28 20 73 71 6c  TOINIT.  if( sql
4830: 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28  ite3_initialize(
4840: 29 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 23 65  ) ) return 0;.#e
4850: 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20 73 71  ndif.  return sq
4860: 6c 69 74 65 33 52 65 61 6c 6c 6f 63 28 70 4f 6c  lite3Realloc(pOl
4870: 64 2c 20 6e 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  d, n);.}../*.** 
4880: 41 74 74 65 6d 70 74 20 74 6f 20 61 6c 6c 6f 63  Attempt to alloc
4890: 61 74 65 20 61 6e 20 6e 20 62 79 74 65 20 62 6c  ate an n byte bl
48a0: 6f 63 6b 20 66 72 6f 6d 20 74 68 65 20 6c 6f 6f  ock from the loo
48b0: 6b 61 73 69 64 65 20 62 75 66 66 65 72 20 6f 66  kaside buffer of
48c0: 0a 2a 2a 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 64  .** connection d
48d0: 62 2e 20 49 66 20 73 75 63 63 65 73 73 66 75 6c  b. If successful
48e0: 2c 20 72 65 74 75 72 6e 20 61 20 70 6f 69 6e 74  , return a point
48f0: 65 72 20 74 6f 20 74 68 65 20 6e 65 77 20 61 6c  er to the new al
4900: 6c 6f 63 61 74 69 6f 6e 2e 0a 2a 2a 20 4f 74 68  location..** Oth
4910: 65 72 77 69 73 65 2c 20 72 65 74 75 72 6e 20 61  erwise, return a
4920: 20 4e 55 4c 4c 20 70 6f 69 6e 74 65 72 2e 0a 2a   NULL pointer..*
4930: 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45  /.#ifndef SQLITE
4940: 5f 4f 4d 49 54 5f 4c 4f 4f 4b 41 53 49 44 45 0a  _OMIT_LOOKASIDE.
4950: 73 74 61 74 69 63 20 76 6f 69 64 20 2a 6c 6f 6f  static void *loo
4960: 6b 61 73 69 64 65 41 6c 6c 6f 63 28 73 71 6c 69  kasideAlloc(sqli
4970: 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 6e 29 7b  te3 *db, int n){
4980: 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e 6c  .  assert( db->l
4990: 6f 6f 6b 61 73 69 64 65 2e 73 7a 3d 3d 30 20 7c  ookaside.sz==0 |
49a0: 7c 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e  | db->lookaside.
49b0: 73 7a 3d 3d 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64  sz==db->lookasid
49c0: 65 2e 73 7a 45 6e 61 62 6c 65 64 20 29 3b 0a 20  e.szEnabled );. 
49d0: 20 69 66 28 20 6e 3e 64 62 2d 3e 6c 6f 6f 6b 61   if( n>db->looka
49e0: 73 69 64 65 2e 73 7a 20 29 7b 0a 20 20 20 20 2f  side.sz ){.    /
49f0: 2a 20 49 66 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69  * If db->lookasi
4a00: 64 65 2e 73 7a 20 69 73 20 30 2c 20 74 68 65 6e  de.sz is 0, then
4a10: 20 74 68 65 20 6c 6f 6f 6b 61 73 69 64 65 20 62   the lookaside b
4a20: 75 66 66 65 72 20 69 73 20 63 75 72 72 65 6e 74  uffer is current
4a30: 6c 79 0a 20 20 20 20 2a 2a 20 64 69 73 61 62 6c  ly.    ** disabl
4a40: 65 64 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65  ed. In this case
4a50: 20 64 6f 20 6e 6f 74 20 69 6e 63 72 65 6d 65 6e   do not incremen
4a60: 74 20 74 68 65 20 22 73 69 7a 65 20 6d 69 73 73  t the "size miss
4a70: 65 73 22 20 73 74 61 74 2e 20 20 2a 2f 0a 20 20  es" stat.  */.  
4a80: 20 20 69 66 28 20 64 62 2d 3e 6c 6f 6f 6b 61 73    if( db->lookas
4a90: 69 64 65 2e 73 7a 20 29 20 64 62 2d 3e 6c 6f 6f  ide.sz ) db->loo
4aa0: 6b 61 73 69 64 65 2e 61 6e 53 74 61 74 5b 31 5d  kaside.anStat[1]
4ab0: 2b 2b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ++;.  }else{.   
4ac0: 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 20 2a   LookasideSlot *
4ad0: 70 42 75 66 3b 0a 20 20 20 20 69 66 28 20 28 70  pBuf;.    if( (p
4ae0: 42 75 66 20 3d 20 64 62 2d 3e 6c 6f 6f 6b 61 73  Buf = db->lookas
4af0: 69 64 65 2e 70 46 72 65 65 29 3d 3d 30 20 29 7b  ide.pFree)==0 ){
4b00: 0a 20 20 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61  .      db->looka
4b10: 73 69 64 65 2e 61 6e 53 74 61 74 5b 32 5d 2b 2b  side.anStat[2]++
4b20: 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ;.    }else{.   
4b30: 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65     db->lookaside
4b40: 2e 70 46 72 65 65 20 3d 20 70 42 75 66 2d 3e 70  .pFree = pBuf->p
4b50: 4e 65 78 74 3b 0a 20 20 20 20 20 20 64 62 2d 3e  Next;.      db->
4b60: 6c 6f 6f 6b 61 73 69 64 65 2e 6e 4f 75 74 2b 2b  lookaside.nOut++
4b70: 3b 0a 20 20 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b  ;.      db->look
4b80: 61 73 69 64 65 2e 61 6e 53 74 61 74 5b 30 5d 2b  aside.anStat[0]+
4b90: 2b 3b 0a 20 20 20 20 20 20 69 66 28 20 64 62 2d  +;.      if( db-
4ba0: 3e 6c 6f 6f 6b 61 73 69 64 65 2e 6e 4f 75 74 3e  >lookaside.nOut>
4bb0: 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 6d 78  db->lookaside.mx
4bc0: 4f 75 74 20 29 7b 0a 20 20 20 20 20 20 20 20 64  Out ){.        d
4bd0: 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 6d 78 4f  b->lookaside.mxO
4be0: 75 74 20 3d 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69  ut = db->lookasi
4bf0: 64 65 2e 6e 4f 75 74 3b 0a 20 20 20 20 20 20 7d  de.nOut;.      }
4c00: 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74  .    }.    sqlit
4c10: 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70  e3MemdebugSetTyp
4c20: 65 28 28 76 6f 69 64 20 2a 29 70 42 75 66 2c 20  e((void *)pBuf, 
4c30: 4d 45 4d 54 59 50 45 5f 44 42 20 7c 20 4d 45 4d  MEMTYPE_DB | MEM
4c40: 54 59 50 45 5f 4c 4f 4f 4b 41 53 49 44 45 29 3b  TYPE_LOOKASIDE);
4c50: 0a 20 20 20 20 72 65 74 75 72 6e 20 28 76 6f 69  .    return (voi
4c60: 64 2a 29 70 42 75 66 3b 0a 20 20 7d 0a 20 20 72  d*)pBuf;.  }.  r
4c70: 65 74 75 72 6e 20 30 3b 0a 7d 0a 23 65 6c 73 65  eturn 0;.}.#else
4c80: 0a 23 20 64 65 66 69 6e 65 20 6c 6f 6f 6b 61 73  .# define lookas
4c90: 69 64 65 41 6c 6c 6f 63 28 78 2c 79 29 20 30 0a  ideAlloc(x,y) 0.
4ca0: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 6c  #endif../*.** Al
4cb0: 6c 6f 63 61 74 65 20 61 6e 64 20 7a 65 72 6f 20  locate and zero 
4cc0: 6d 65 6d 6f 72 79 2e 20 49 66 20 74 68 65 20 61  memory. If the a
4cd0: 6c 6c 6f 63 61 74 69 6f 6e 20 66 61 69 6c 73 2c  llocation fails,
4ce0: 20 73 65 74 20 74 68 65 20 0a 2a 2a 20 6d 61 6c   set the .** mal
4cf0: 6c 6f 63 46 61 69 6c 65 64 20 66 6c 61 67 20 69  locFailed flag i
4d00: 6e 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  n the connection
4d10: 20 70 6f 69 6e 74 65 72 2e 0a 2a 2a 0a 2a 2a 20   pointer..**.** 
4d20: 49 66 20 64 62 21 3d 30 20 61 6e 64 20 64 62 2d  If db!=0 and db-
4d30: 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 69 73  >mallocFailed is
4d40: 20 74 72 75 65 20 28 69 6e 64 69 63 61 74 69 6e   true (indicatin
4d50: 67 20 61 20 70 72 69 6f 72 20 6d 61 6c 6c 6f 63  g a prior malloc
4d60: 0a 2a 2a 20 66 61 69 6c 75 72 65 20 6f 6e 20 74  .** failure on t
4d70: 68 65 20 73 61 6d 65 20 64 61 74 61 62 61 73 65  he same database
4d80: 20 63 6f 6e 6e 65 63 74 69 6f 6e 29 20 74 68 65   connection) the
4d90: 6e 20 61 6c 77 61 79 73 20 72 65 74 75 72 6e 20  n always return 
4da0: 30 2e 0a 2a 2a 20 48 65 6e 63 65 20 66 6f 72 20  0..** Hence for 
4db0: 61 20 70 61 72 74 69 63 75 6c 61 72 20 64 61 74  a particular dat
4dc0: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  abase connection
4dd0: 2c 20 6f 6e 63 65 20 6d 61 6c 6c 6f 63 20 73 74  , once malloc st
4de0: 61 72 74 73 0a 2a 2a 20 66 61 69 6c 69 6e 67 2c  arts.** failing,
4df0: 20 69 74 20 66 61 69 6c 73 20 63 6f 6e 73 69 73   it fails consis
4e00: 74 65 6e 74 6c 79 20 75 6e 74 69 6c 20 6d 61 6c  tently until mal
4e10: 6c 6f 63 46 61 69 6c 65 64 20 69 73 20 72 65 73  locFailed is res
4e20: 65 74 2e 0a 2a 2a 20 54 68 69 73 20 69 73 20 61  et..** This is a
4e30: 6e 20 69 6d 70 6f 72 74 61 6e 74 20 61 73 73 75  n important assu
4e40: 6d 70 74 69 6f 6e 2e 20 20 54 68 65 72 65 20 61  mption.  There a
4e50: 72 65 20 6d 61 6e 79 20 70 6c 61 63 65 73 20 69  re many places i
4e60: 6e 20 74 68 65 0a 2a 2a 20 63 6f 64 65 20 74 68  n the.** code th
4e70: 61 74 20 64 6f 20 74 68 69 6e 67 73 20 6c 69 6b  at do things lik
4e80: 65 20 74 68 69 73 3a 0a 2a 2a 0a 2a 2a 20 20 20  e this:.**.**   
4e90: 20 20 20 20 20 20 69 6e 74 20 2a 61 20 3d 20 28        int *a = (
4ea0: 69 6e 74 2a 29 73 71 6c 69 74 65 33 44 62 4d 61  int*)sqlite3DbMa
4eb0: 6c 6c 6f 63 52 61 77 28 64 62 2c 20 31 30 30 29  llocRaw(db, 100)
4ec0: 3b 0a 2a 2a 20 20 20 20 20 20 20 20 20 69 6e 74  ;.**         int
4ed0: 20 2a 62 20 3d 20 28 69 6e 74 2a 29 73 71 6c 69   *b = (int*)sqli
4ee0: 74 65 33 44 62 4d 61 6c 6c 6f 63 52 61 77 28 64  te3DbMallocRaw(d
4ef0: 62 2c 20 32 30 30 29 3b 0a 2a 2a 20 20 20 20 20  b, 200);.**     
4f00: 20 20 20 20 69 66 28 20 62 20 29 20 61 5b 31 30      if( b ) a[10
4f10: 5d 20 3d 20 39 3b 0a 2a 2a 0a 2a 2a 20 49 6e 20  ] = 9;.**.** In 
4f20: 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 69 66 20  other words, if 
4f30: 61 20 73 75 62 73 65 71 75 65 6e 74 20 6d 61 6c  a subsequent mal
4f40: 6c 6f 63 20 28 65 78 3a 20 22 62 22 29 20 77 6f  loc (ex: "b") wo
4f50: 72 6b 65 64 2c 20 69 74 20 69 73 20 61 73 73 75  rked, it is assu
4f60: 6d 65 64 0a 2a 2a 20 74 68 61 74 20 61 6c 6c 20  med.** that all 
4f70: 70 72 69 6f 72 20 6d 61 6c 6c 6f 63 73 20 28 65  prior mallocs (e
4f80: 78 3a 20 22 61 22 29 20 77 6f 72 6b 65 64 20 74  x: "a") worked t
4f90: 6f 6f 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c  oo..*/.void *sql
4fa0: 69 74 65 33 44 62 4d 61 6c 6c 6f 63 5a 65 72 6f  ite3DbMallocZero
4fb0: 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e  (sqlite3 *db, in
4fc0: 74 20 6e 29 7b 0a 20 20 76 6f 69 64 20 2a 70 3b  t n){.  void *p;
4fd0: 0a 20 20 69 66 28 20 64 62 20 29 7b 0a 20 20 20  .  if( db ){.   
4fe0: 20 69 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46   if( db->mallocF
4ff0: 61 69 6c 65 64 20 29 20 72 65 74 75 72 6e 20 30  ailed ) return 0
5000: 3b 0a 20 20 20 20 69 66 28 20 28 70 20 3d 20 6c  ;.    if( (p = l
5010: 6f 6f 6b 61 73 69 64 65 41 6c 6c 6f 63 28 64 62  ookasideAlloc(db
5020: 2c 20 6e 29 29 20 29 7b 0a 20 20 20 20 20 20 6d  , n)) ){.      m
5030: 65 6d 73 65 74 28 70 2c 20 30 2c 20 6e 29 3b 0a  emset(p, 0, n);.
5040: 20 20 20 20 20 20 72 65 74 75 72 6e 20 70 3b 0a        return p;.
5050: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 72 65 74      }.  }..  ret
5060: 75 72 6e 20 6d 65 6d 41 6c 6c 6f 63 61 74 65 28  urn memAllocate(
5070: 64 62 2c 20 73 71 6c 69 74 65 33 47 6c 6f 62 61  db, sqlite3Globa
5080: 6c 43 6f 6e 66 69 67 2e 6d 2e 78 43 61 6c 6c 6f  lConfig.m.xCallo
5090: 63 2c 20 6e 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  c, n);.}../*.** 
50a0: 41 6c 6c 6f 63 61 74 65 20 6d 65 6d 6f 72 79 2e  Allocate memory.
50b0: 20 49 66 20 74 68 65 20 61 6c 6c 6f 63 61 74 69   If the allocati
50c0: 6f 6e 20 66 61 69 6c 73 2c 20 6d 61 6b 65 20 74  on fails, make t
50d0: 68 65 20 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20  he mallocFailed 
50e0: 0a 2a 2a 20 66 6c 61 67 20 69 6e 20 74 68 65 20  .** flag in the 
50f0: 63 6f 6e 6e 65 63 74 69 6f 6e 20 70 6f 69 6e 74  connection point
5100: 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 64 62 21  er..**.** If db!
5110: 3d 30 20 61 6e 64 20 64 62 2d 3e 6d 61 6c 6c 6f  =0 and db->mallo
5120: 63 46 61 69 6c 65 64 20 69 73 20 74 72 75 65 20  cFailed is true 
5130: 28 69 6e 64 69 63 61 74 69 6e 67 20 61 20 70 72  (indicating a pr
5140: 69 6f 72 20 6d 61 6c 6c 6f 63 0a 2a 2a 20 66 61  ior malloc.** fa
5150: 69 6c 75 72 65 20 6f 6e 20 74 68 65 20 73 61 6d  ilure on the sam
5160: 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65  e database conne
5170: 63 74 69 6f 6e 29 20 74 68 65 6e 20 61 6c 77 61  ction) then alwa
5180: 79 73 20 72 65 74 75 72 6e 20 30 2e 0a 2a 2a 20  ys return 0..** 
5190: 53 65 65 20 61 6c 73 6f 20 63 6f 6d 6d 65 6e 74  See also comment
51a0: 73 20 61 62 6f 76 65 20 73 71 6c 69 74 65 33 44  s above sqlite3D
51b0: 62 4d 61 6c 6c 6f 63 5a 65 72 6f 28 29 20 66 6f  bMallocZero() fo
51c0: 72 20 64 65 74 61 69 6c 73 2e 0a 2a 2f 0a 76 6f  r details..*/.vo
51d0: 69 64 20 2a 73 71 6c 69 74 65 33 44 62 4d 61 6c  id *sqlite3DbMal
51e0: 6c 6f 63 52 61 77 28 73 71 6c 69 74 65 33 20 2a  locRaw(sqlite3 *
51f0: 64 62 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 76 6f  db, int n){.  vo
5200: 69 64 20 2a 70 3b 0a 20 20 69 66 28 20 64 62 20  id *p;.  if( db 
5210: 29 7b 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 6d  ){.    if( db->m
5220: 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 20 72 65  allocFailed ) re
5230: 74 75 72 6e 20 30 3b 0a 20 20 20 20 69 66 28 20  turn 0;.    if( 
5240: 28 70 20 3d 20 6c 6f 6f 6b 61 73 69 64 65 41 6c  (p = lookasideAl
5250: 6c 6f 63 28 64 62 2c 20 6e 29 29 20 29 7b 0a 20  loc(db, n)) ){. 
5260: 20 20 20 20 20 72 65 74 75 72 6e 20 70 3b 0a 20       return p;. 
5270: 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 72 65 74 75     }.  }..  retu
5280: 72 6e 20 6d 65 6d 41 6c 6c 6f 63 61 74 65 28 64  rn memAllocate(d
5290: 62 2c 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c  b, sqlite3Global
52a0: 43 6f 6e 66 69 67 2e 6d 2e 78 4d 61 6c 6c 6f 63  Config.m.xMalloc
52b0: 2c 20 6e 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52  , n);.}../*.** R
52c0: 65 73 69 7a 65 20 74 68 65 20 62 6c 6f 63 6b 20  esize the block 
52d0: 6f 66 20 6d 65 6d 6f 72 79 20 70 6f 69 6e 74 65  of memory pointe
52e0: 64 20 74 6f 20 62 79 20 70 20 74 6f 20 6e 20 62  d to by p to n b
52f0: 79 74 65 73 2e 20 49 66 20 74 68 65 0a 2a 2a 20  ytes. If the.** 
5300: 72 65 73 69 7a 65 20 66 61 69 6c 73 2c 20 73 65  resize fails, se
5310: 74 20 74 68 65 20 6d 61 6c 6c 6f 63 46 61 69 6c  t the mallocFail
5320: 65 64 20 66 6c 61 67 20 69 6e 20 74 68 65 20 63  ed flag in the c
5330: 6f 6e 6e 65 63 74 69 6f 6e 20 6f 62 6a 65 63 74  onnection object
5340: 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74  ..*/.void *sqlit
5350: 65 33 44 62 52 65 61 6c 6c 6f 63 28 73 71 6c 69  e3DbRealloc(sqli
5360: 74 65 33 20 2a 64 62 2c 20 76 6f 69 64 20 2a 70  te3 *db, void *p
5370: 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 76 6f 69 64  , int n){.  void
5380: 20 2a 70 4e 65 77 20 3d 20 30 3b 0a 20 20 61 73   *pNew = 0;.  as
5390: 73 65 72 74 28 20 64 62 21 3d 30 20 29 3b 0a 20  sert( db!=0 );. 
53a0: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
53b0: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e  _mutex_held(db->
53c0: 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20  mutex) );.  if( 
53d0: 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64  db->mallocFailed
53e0: 3d 3d 30 20 29 7b 0a 20 20 20 20 69 66 28 20 70  ==0 ){.    if( p
53f0: 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 72 65 74  ==0 ){.      ret
5400: 75 72 6e 20 73 71 6c 69 74 65 33 44 62 4d 61 6c  urn sqlite3DbMal
5410: 6c 6f 63 52 61 77 28 64 62 2c 20 6e 29 3b 0a 20  locRaw(db, n);. 
5420: 20 20 20 7d 0a 20 20 20 20 69 66 28 20 69 73 4c     }.    if( isL
5430: 6f 6f 6b 61 73 69 64 65 28 64 62 2c 20 70 29 20  ookaside(db, p) 
5440: 29 7b 0a 20 20 20 20 20 20 69 66 28 20 6e 3c 3d  ){.      if( n<=
5450: 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 73 7a  db->lookaside.sz
5460: 45 6e 61 62 6c 65 64 20 29 7b 0a 20 20 20 20 20  Enabled ){.     
5470: 20 20 20 72 65 74 75 72 6e 20 70 3b 0a 20 20 20     return p;.   
5480: 20 20 20 7d 0a 20 20 20 20 20 20 70 4e 65 77 20     }.      pNew 
5490: 3d 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f  = sqlite3DbMallo
54a0: 63 52 61 77 28 64 62 2c 20 6e 29 3b 0a 20 20 20  cRaw(db, n);.   
54b0: 20 20 20 69 66 28 20 70 4e 65 77 20 29 7b 0a 20     if( pNew ){. 
54c0: 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 70 4e         memcpy(pN
54d0: 65 77 2c 20 70 2c 20 64 62 2d 3e 6c 6f 6f 6b 61  ew, p, db->looka
54e0: 73 69 64 65 2e 73 7a 45 6e 61 62 6c 65 64 29 3b  side.szEnabled);
54f0: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  .        sqlite3
5500: 44 62 46 72 65 65 28 64 62 2c 20 70 29 3b 0a 20  DbFree(db, p);. 
5510: 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65       }.    }else
5520: 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20  {.      assert( 
5530: 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 48  sqlite3MemdebugH
5540: 61 73 54 79 70 65 28 70 2c 20 4d 45 4d 54 59 50  asType(p, MEMTYP
5550: 45 5f 44 42 29 20 29 3b 0a 20 20 20 20 20 20 61  E_DB) );.      a
5560: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d 65  ssert( sqlite3Me
5570: 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 70 2c  mdebugHasType(p,
5580: 20 4d 45 4d 54 59 50 45 5f 4c 4f 4f 4b 41 53 49   MEMTYPE_LOOKASI
5590: 44 45 7c 4d 45 4d 54 59 50 45 5f 48 45 41 50 29  DE|MEMTYPE_HEAP)
55a0: 20 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   );.      sqlite
55b0: 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65  3MemdebugSetType
55c0: 28 70 2c 20 4d 45 4d 54 59 50 45 5f 48 45 41 50  (p, MEMTYPE_HEAP
55d0: 29 3b 0a 20 20 20 20 20 20 70 4e 65 77 20 3d 20  );.      pNew = 
55e0: 73 71 6c 69 74 65 33 5f 72 65 61 6c 6c 6f 63 28  sqlite3_realloc(
55f0: 70 2c 20 6e 29 3b 0a 20 20 20 20 20 20 69 66 28  p, n);.      if(
5600: 20 21 70 4e 65 77 20 29 7b 0a 20 20 20 20 20 20   !pNew ){.      
5610: 20 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75    sqlite3Memdebu
5620: 67 53 65 74 54 79 70 65 28 70 2c 20 4d 45 4d 54  gSetType(p, MEMT
5630: 59 50 45 5f 44 42 7c 4d 45 4d 54 59 50 45 5f 48  YPE_DB|MEMTYPE_H
5640: 45 41 50 29 3b 0a 20 20 20 20 20 20 20 20 64 62  EAP);.        db
5650: 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 3d  ->mallocFailed =
5660: 20 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20   1;.      }.    
5670: 20 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75    sqlite3Memdebu
5680: 67 53 65 74 54 79 70 65 28 70 4e 65 77 2c 20 4d  gSetType(pNew, M
5690: 45 4d 54 59 50 45 5f 44 42 20 7c 20 0a 20 20 20  EMTYPE_DB | .   
56a0: 20 20 20 20 20 20 20 20 20 28 64 62 2d 3e 6c 6f           (db->lo
56b0: 6f 6b 61 73 69 64 65 2e 73 7a 20 3f 20 4d 45 4d  okaside.sz ? MEM
56c0: 54 59 50 45 5f 4c 4f 4f 4b 41 53 49 44 45 20 3a  TYPE_LOOKASIDE :
56d0: 20 4d 45 4d 54 59 50 45 5f 48 45 41 50 29 29 3b   MEMTYPE_HEAP));
56e0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74  .    }.  }.  ret
56f0: 75 72 6e 20 70 4e 65 77 3b 0a 7d 0a 0a 2f 2a 0a  urn pNew;.}../*.
5700: 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f 20 72 65  ** Attempt to re
5710: 61 6c 6c 6f 63 61 74 65 20 70 2e 20 20 49 66 20  allocate p.  If 
5720: 74 68 65 20 72 65 61 6c 6c 6f 63 61 74 69 6f 6e  the reallocation
5730: 20 66 61 69 6c 73 2c 20 74 68 65 6e 20 66 72 65   fails, then fre
5740: 65 20 70 0a 2a 2a 20 61 6e 64 20 73 65 74 20 74  e p.** and set t
5750: 68 65 20 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20  he mallocFailed 
5760: 66 6c 61 67 20 69 6e 20 74 68 65 20 64 61 74 61  flag in the data
5770: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e  base connection.
5780: 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65  .*/.void *sqlite
5790: 33 44 62 52 65 61 6c 6c 6f 63 4f 72 46 72 65 65  3DbReallocOrFree
57a0: 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 76 6f  (sqlite3 *db, vo
57b0: 69 64 20 2a 70 2c 20 69 6e 74 20 6e 29 7b 0a 20  id *p, int n){. 
57c0: 20 76 6f 69 64 20 2a 70 4e 65 77 3b 0a 20 20 70   void *pNew;.  p
57d0: 4e 65 77 20 3d 20 73 71 6c 69 74 65 33 44 62 52  New = sqlite3DbR
57e0: 65 61 6c 6c 6f 63 28 64 62 2c 20 70 2c 20 6e 29  ealloc(db, p, n)
57f0: 3b 0a 20 20 69 66 28 20 21 70 4e 65 77 20 29 7b  ;.  if( !pNew ){
5800: 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72  .    sqlite3DbFr
5810: 65 65 28 64 62 2c 20 70 29 3b 0a 20 20 7d 0a 20  ee(db, p);.  }. 
5820: 20 72 65 74 75 72 6e 20 70 4e 65 77 3b 0a 7d 0a   return pNew;.}.
5830: 0a 2f 2a 0a 2a 2a 20 4d 61 6b 65 20 61 20 63 6f  ./*.** Make a co
5840: 70 79 20 6f 66 20 61 20 73 74 72 69 6e 67 20 69  py of a string i
5850: 6e 20 6d 65 6d 6f 72 79 20 6f 62 74 61 69 6e 65  n memory obtaine
5860: 64 20 66 72 6f 6d 20 73 71 6c 69 74 65 4d 61 6c  d from sqliteMal
5870: 6c 6f 63 28 29 2e 20 54 68 65 73 65 20 0a 2a 2a  loc(). These .**
5880: 20 66 75 6e 63 74 69 6f 6e 73 20 63 61 6c 6c 20   functions call 
5890: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 52 61 77  sqlite3MallocRaw
58a0: 28 29 20 64 69 72 65 63 74 6c 79 20 69 6e 73 74  () directly inst
58b0: 65 61 64 20 6f 66 20 73 71 6c 69 74 65 4d 61 6c  ead of sqliteMal
58c0: 6c 6f 63 28 29 2e 20 54 68 69 73 0a 2a 2a 20 69  loc(). This.** i
58d0: 73 20 62 65 63 61 75 73 65 20 77 68 65 6e 20 6d  s because when m
58e0: 65 6d 6f 72 79 20 64 65 62 75 67 67 69 6e 67 20  emory debugging 
58f0: 69 73 20 74 75 72 6e 65 64 20 6f 6e 2c 20 74 68  is turned on, th
5900: 65 73 65 20 74 77 6f 20 66 75 6e 63 74 69 6f 6e  ese two function
5910: 73 20 61 72 65 20 0a 2a 2a 20 63 61 6c 6c 65 64  s are .** called
5920: 20 76 69 61 20 6d 61 63 72 6f 73 20 74 68 61 74   via macros that
5930: 20 72 65 63 6f 72 64 20 74 68 65 20 63 75 72 72   record the curr
5940: 65 6e 74 20 66 69 6c 65 20 61 6e 64 20 6c 69 6e  ent file and lin
5950: 65 20 6e 75 6d 62 65 72 20 69 6e 20 74 68 65 0a  e number in the.
5960: 2a 2a 20 54 68 72 65 61 64 44 61 74 61 20 73 74  ** ThreadData st
5970: 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 63 68 61 72  ructure..*/.char
5980: 20 2a 73 71 6c 69 74 65 33 44 62 53 74 72 44 75   *sqlite3DbStrDu
5990: 70 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 63  p(sqlite3 *db, c
59a0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 29 7b 0a 20  onst char *z){. 
59b0: 20 63 68 61 72 20 2a 7a 4e 65 77 3b 0a 20 20 73   char *zNew;.  s
59c0: 69 7a 65 5f 74 20 6e 3b 0a 20 20 69 66 28 20 7a  ize_t n;.  if( z
59d0: 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72  ==0 ){.    retur
59e0: 6e 20 30 3b 0a 20 20 7d 0a 20 20 6e 20 3d 20 73  n 0;.  }.  n = s
59f0: 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a  qlite3Strlen30(z
5a00: 29 20 2b 20 31 3b 0a 20 20 61 73 73 65 72 74 28  ) + 1;.  assert(
5a10: 20 28 6e 26 30 78 37 66 66 66 66 66 66 66 29 3d   (n&0x7fffffff)=
5a20: 3d 6e 20 29 3b 0a 20 20 7a 4e 65 77 20 3d 20 73  =n );.  zNew = s
5a30: 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 52 61  qlite3DbMallocRa
5a40: 77 28 64 62 2c 20 28 69 6e 74 29 6e 29 3b 0a 20  w(db, (int)n);. 
5a50: 20 69 66 28 20 7a 4e 65 77 20 29 7b 0a 20 20 20   if( zNew ){.   
5a60: 20 6d 65 6d 63 70 79 28 7a 4e 65 77 2c 20 7a 2c   memcpy(zNew, z,
5a70: 20 6e 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72   n);.  }.  retur
5a80: 6e 20 7a 4e 65 77 3b 0a 7d 0a 63 68 61 72 20 2a  n zNew;.}.char *
5a90: 73 71 6c 69 74 65 33 44 62 53 74 72 4e 44 75 70  sqlite3DbStrNDup
5aa0: 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 63 6f  (sqlite3 *db, co
5ab0: 6e 73 74 20 63 68 61 72 20 2a 7a 2c 20 69 6e 74  nst char *z, int
5ac0: 20 6e 29 7b 0a 20 20 63 68 61 72 20 2a 7a 4e 65   n){.  char *zNe
5ad0: 77 3b 0a 20 20 69 66 28 20 7a 3d 3d 30 20 29 7b  w;.  if( z==0 ){
5ae0: 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20  .    return 0;. 
5af0: 20 7d 0a 20 20 61 73 73 65 72 74 28 20 28 6e 26   }.  assert( (n&
5b00: 30 78 37 66 66 66 66 66 66 66 29 3d 3d 6e 20 29  0x7fffffff)==n )
5b10: 3b 0a 20 20 7a 4e 65 77 20 3d 20 73 71 6c 69 74  ;.  zNew = sqlit
5b20: 65 33 44 62 4d 61 6c 6c 6f 63 52 61 77 28 64 62  e3DbMallocRaw(db
5b30: 2c 20 6e 2b 31 29 3b 0a 20 20 69 66 28 20 7a 4e  , n+1);.  if( zN
5b40: 65 77 20 29 7b 0a 20 20 20 20 6d 65 6d 63 70 79  ew ){.    memcpy
5b50: 28 7a 4e 65 77 2c 20 7a 2c 20 6e 29 3b 0a 20 20  (zNew, z, n);.  
5b60: 20 20 7a 4e 65 77 5b 6e 5d 20 3d 20 30 3b 0a 20    zNew[n] = 0;. 
5b70: 20 7d 0a 20 20 72 65 74 75 72 6e 20 7a 4e 65 77   }.  return zNew
5b80: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74  ;.}../*.** Creat
5b90: 65 20 61 20 73 74 72 69 6e 67 20 66 72 6f 6d 20  e a string from 
5ba0: 74 68 65 20 7a 46 72 6f 6d 61 74 20 61 72 67 75  the zFromat argu
5bb0: 6d 65 6e 74 20 61 6e 64 20 74 68 65 20 76 61 5f  ment and the va_
5bc0: 6c 69 73 74 20 74 68 61 74 20 66 6f 6c 6c 6f 77  list that follow
5bd0: 73 2e 0a 2a 2a 20 53 74 6f 72 65 20 74 68 65 20  s..** Store the 
5be0: 73 74 72 69 6e 67 20 69 6e 20 6d 65 6d 6f 72 79  string in memory
5bf0: 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 73   obtained from s
5c00: 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 29 20 61 6e  qliteMalloc() an
5c10: 64 20 6d 61 6b 65 20 2a 70 7a 0a 2a 2a 20 70 6f  d make *pz.** po
5c20: 69 6e 74 20 74 6f 20 74 68 61 74 20 73 74 72 69  int to that stri
5c30: 6e 67 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  ng..*/.void sqli
5c40: 74 65 33 53 65 74 53 74 72 69 6e 67 28 63 68 61  te3SetString(cha
5c50: 72 20 2a 2a 70 7a 2c 20 73 71 6c 69 74 65 33 20  r **pz, sqlite3 
5c60: 2a 64 62 2c 20 63 6f 6e 73 74 20 63 68 61 72 20  *db, const char 
5c70: 2a 7a 46 6f 72 6d 61 74 2c 20 2e 2e 2e 29 7b 0a  *zFormat, ...){.
5c80: 20 20 76 61 5f 6c 69 73 74 20 61 70 3b 0a 20 20    va_list ap;.  
5c90: 63 68 61 72 20 2a 7a 3b 0a 0a 20 20 76 61 5f 73  char *z;..  va_s
5ca0: 74 61 72 74 28 61 70 2c 20 7a 46 6f 72 6d 61 74  tart(ap, zFormat
5cb0: 29 3b 0a 20 20 7a 20 3d 20 73 71 6c 69 74 65 33  );.  z = sqlite3
5cc0: 56 4d 50 72 69 6e 74 66 28 64 62 2c 20 7a 46 6f  VMPrintf(db, zFo
5cd0: 72 6d 61 74 2c 20 61 70 29 3b 0a 20 20 76 61 5f  rmat, ap);.  va_
5ce0: 65 6e 64 28 61 70 29 3b 0a 20 20 73 71 6c 69 74  end(ap);.  sqlit
5cf0: 65 33 44 62 46 72 65 65 28 64 62 2c 20 2a 70 7a  e3DbFree(db, *pz
5d00: 29 3b 0a 20 20 2a 70 7a 20 3d 20 7a 3b 0a 7d 0a  );.  *pz = z;.}.
5d10: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e  ../*.** This fun
5d20: 63 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 63 61  ction must be ca
5d30: 6c 6c 65 64 20 62 65 66 6f 72 65 20 65 78 69 74  lled before exit
5d40: 69 6e 67 20 61 6e 79 20 41 50 49 20 66 75 6e 63  ing any API func
5d50: 74 69 6f 6e 20 28 69 2e 65 2e 20 0a 2a 2a 20 72  tion (i.e. .** r
5d60: 65 74 75 72 6e 69 6e 67 20 63 6f 6e 74 72 6f 6c  eturning control
5d70: 20 74 6f 20 74 68 65 20 75 73 65 72 29 20 74 68   to the user) th
5d80: 61 74 20 68 61 73 20 63 61 6c 6c 65 64 20 73 71  at has called sq
5d90: 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 20 6f 72 0a  lite3_malloc or.
5da0: 2a 2a 20 73 71 6c 69 74 65 33 5f 72 65 61 6c 6c  ** sqlite3_reall
5db0: 6f 63 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 72 65  oc..**.** The re
5dc0: 74 75 72 6e 65 64 20 76 61 6c 75 65 20 69 73 20  turned value is 
5dd0: 6e 6f 72 6d 61 6c 6c 79 20 61 20 63 6f 70 79 20  normally a copy 
5de0: 6f 66 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72  of the second ar
5df0: 67 75 6d 65 6e 74 20 74 6f 20 74 68 69 73 0a 2a  gument to this.*
5e00: 2a 20 66 75 6e 63 74 69 6f 6e 2e 20 48 6f 77 65  * function. Howe
5e10: 76 65 72 2c 20 69 66 20 61 20 6d 61 6c 6c 6f 63  ver, if a malloc
5e20: 28 29 20 66 61 69 6c 75 72 65 20 68 61 73 20 6f  () failure has o
5e30: 63 63 75 72 72 65 64 20 73 69 6e 63 65 20 74 68  ccurred since th
5e40: 65 20 70 72 65 76 69 6f 75 73 0a 2a 2a 20 69 6e  e previous.** in
5e50: 76 6f 63 61 74 69 6f 6e 20 53 51 4c 49 54 45 5f  vocation SQLITE_
5e60: 4e 4f 4d 45 4d 20 69 73 20 72 65 74 75 72 6e 65  NOMEM is returne
5e70: 64 20 69 6e 73 74 65 61 64 2e 20 0a 2a 2a 0a 2a  d instead. .**.*
5e80: 2a 20 49 66 20 74 68 65 20 66 69 72 73 74 20 61  * If the first a
5e90: 72 67 75 6d 65 6e 74 2c 20 64 62 2c 20 69 73 20  rgument, db, is 
5ea0: 6e 6f 74 20 4e 55 4c 4c 20 61 6e 64 20 61 20 6d  not NULL and a m
5eb0: 61 6c 6c 6f 63 28 29 20 65 72 72 6f 72 20 68 61  alloc() error ha
5ec0: 73 20 6f 63 63 75 72 72 65 64 2c 0a 2a 2a 20 74  s occurred,.** t
5ed0: 68 65 6e 20 74 68 65 20 63 6f 6e 6e 65 63 74 69  hen the connecti
5ee0: 6f 6e 20 65 72 72 6f 72 2d 63 6f 64 65 20 28 74  on error-code (t
5ef0: 68 65 20 76 61 6c 75 65 20 72 65 74 75 72 6e 65  he value returne
5f00: 64 20 62 79 20 73 71 6c 69 74 65 33 5f 65 72 72  d by sqlite3_err
5f10: 63 6f 64 65 28 29 29 0a 2a 2a 20 69 73 20 73 65  code()).** is se
5f20: 74 20 74 6f 20 53 51 4c 49 54 45 5f 4e 4f 4d 45  t to SQLITE_NOME
5f30: 4d 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  M..*/.int sqlite
5f40: 33 41 70 69 45 78 69 74 28 73 71 6c 69 74 65 33  3ApiExit(sqlite3
5f50: 2a 20 64 62 2c 20 69 6e 74 20 72 63 29 7b 0a 20  * db, int rc){. 
5f60: 20 2f 2a 20 49 66 20 74 68 65 20 64 62 20 68 61   /* If the db ha
5f70: 6e 64 6c 65 20 69 73 20 6e 6f 74 20 4e 55 4c 4c  ndle is not NULL
5f80: 2c 20 74 68 65 6e 20 77 65 20 6d 75 73 74 20 68  , then we must h
5f90: 6f 6c 64 20 74 68 65 20 63 6f 6e 6e 65 63 74 69  old the connecti
5fa0: 6f 6e 20 68 61 6e 64 6c 65 0a 20 20 2a 2a 20 6d  on handle.  ** m
5fb0: 75 74 65 78 20 68 65 72 65 2e 20 4f 74 68 65 72  utex here. Other
5fc0: 77 69 73 65 20 74 68 65 20 72 65 61 64 20 28 61  wise the read (a
5fd0: 6e 64 20 70 6f 73 73 69 62 6c 65 20 77 72 69 74  nd possible writ
5fe0: 65 29 20 6f 66 20 64 62 2d 3e 6d 61 6c 6c 6f 63  e) of db->malloc
5ff0: 46 61 69 6c 65 64 20 0a 20 20 2a 2a 20 69 73 20  Failed .  ** is 
6000: 75 6e 73 61 66 65 2c 20 61 73 20 69 73 20 74 68  unsafe, as is th
6010: 65 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65  e call to sqlite
6020: 33 45 72 72 6f 72 28 29 2e 0a 20 20 2a 2f 0a 20  3Error()..  */. 
6030: 20 61 73 73 65 72 74 28 20 21 64 62 20 7c 7c 20   assert( !db || 
6040: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65  sqlite3_mutex_he
6050: 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b  ld(db->mutex) );
6060: 0a 20 20 69 66 28 20 64 62 20 26 26 20 28 64 62  .  if( db && (db
6070: 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 7c  ->mallocFailed |
6080: 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f 49 4f 45  | rc==SQLITE_IOE
6090: 52 52 5f 4e 4f 4d 45 4d 29 20 29 7b 0a 20 20 20  RR_NOMEM) ){.   
60a0: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62   sqlite3Error(db
60b0: 2c 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 2c 20  , SQLITE_NOMEM, 
60c0: 30 29 3b 0a 20 20 20 20 64 62 2d 3e 6d 61 6c 6c  0);.    db->mall
60d0: 6f 63 46 61 69 6c 65 64 20 3d 20 30 3b 0a 20 20  ocFailed = 0;.  
60e0: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f    rc = SQLITE_NO
60f0: 4d 45 4d 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72  MEM;.  }.  retur
6100: 6e 20 72 63 20 26 20 28 64 62 20 3f 20 64 62 2d  n rc & (db ? db-
6110: 3e 65 72 72 4d 61 73 6b 20 3a 20 30 78 66 66 29  >errMask : 0xff)
6120: 3b 0a 7d 0a                                      ;.}.