/ Hex Artifact Content
Login

Artifact 591aedb20ae40813f1045f2ef253438a334775d9:


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 73 71 6c  T_AUTOINIT.  sql
0e50: 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28  ite3_initialize(
0e60: 29 3b 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69  );.#endif.  sqli
0e70: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28  te3_mutex_enter(
0e80: 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 70  mem0.mutex);.  p
0e90: 72 69 6f 72 4c 69 6d 69 74 20 3d 20 6d 65 6d 30  riorLimit = mem0
0ea0: 2e 61 6c 61 72 6d 54 68 72 65 73 68 6f 6c 64 3b  .alarmThreshold;
0eb0: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  .  sqlite3_mutex
0ec0: 5f 6c 65 61 76 65 28 6d 65 6d 30 2e 6d 75 74 65  _leave(mem0.mute
0ed0: 78 29 3b 0a 20 20 69 66 28 20 6e 3c 30 20 29 20  x);.  if( n<0 ) 
0ee0: 72 65 74 75 72 6e 20 70 72 69 6f 72 4c 69 6d 69  return priorLimi
0ef0: 74 3b 0a 20 20 69 66 28 20 6e 3e 30 20 29 7b 0a  t;.  if( n>0 ){.
0f00: 20 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 6f 72      sqlite3Memor
0f10: 79 41 6c 61 72 6d 28 73 6f 66 74 48 65 61 70 4c  yAlarm(softHeapL
0f20: 69 6d 69 74 45 6e 66 6f 72 63 65 72 2c 20 30 2c  imitEnforcer, 0,
0f30: 20 6e 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20   n);.  }else{.  
0f40: 20 20 73 71 6c 69 74 65 33 4d 65 6d 6f 72 79 41    sqlite3MemoryA
0f50: 6c 61 72 6d 28 30 2c 20 30 2c 20 30 29 3b 0a 20  larm(0, 0, 0);. 
0f60: 20 7d 0a 20 20 65 78 63 65 73 73 20 3d 20 73 71   }.  excess = sq
0f70: 6c 69 74 65 33 5f 6d 65 6d 6f 72 79 5f 75 73 65  lite3_memory_use
0f80: 64 28 29 20 2d 20 6e 3b 0a 20 20 69 66 28 20 65  d() - n;.  if( e
0f90: 78 63 65 73 73 3e 30 20 29 20 73 71 6c 69 74 65  xcess>0 ) sqlite
0fa0: 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f 72 79  3_release_memory
0fb0: 28 28 69 6e 74 29 28 65 78 63 65 73 73 20 26 20  ((int)(excess & 
0fc0: 30 78 37 66 66 66 66 66 66 66 29 29 3b 0a 20 20  0x7fffffff));.  
0fd0: 72 65 74 75 72 6e 20 70 72 69 6f 72 4c 69 6d 69  return priorLimi
0fe0: 74 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65  t;.}.void sqlite
0ff0: 33 5f 73 6f 66 74 5f 68 65 61 70 5f 6c 69 6d 69  3_soft_heap_limi
1000: 74 28 69 6e 74 20 6e 29 7b 0a 20 20 69 66 28 20  t(int n){.  if( 
1010: 6e 3c 30 20 29 20 6e 20 3d 20 30 3b 0a 20 20 73  n<0 ) n = 0;.  s
1020: 71 6c 69 74 65 33 5f 73 6f 66 74 5f 68 65 61 70  qlite3_soft_heap
1030: 5f 6c 69 6d 69 74 36 34 28 6e 29 3b 0a 7d 0a 0a  _limit64(n);.}..
1040: 2f 2a 0a 2a 2a 20 49 6e 69 74 69 61 6c 69 7a 65  /*.** Initialize
1050: 20 74 68 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f   the memory allo
1060: 63 61 74 69 6f 6e 20 73 75 62 73 79 73 74 65 6d  cation subsystem
1070: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
1080: 4d 61 6c 6c 6f 63 49 6e 69 74 28 76 6f 69 64 29  MallocInit(void)
1090: 7b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 47  {.  if( sqlite3G
10a0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78 4d  lobalConfig.m.xM
10b0: 61 6c 6c 6f 63 3d 3d 30 20 29 7b 0a 20 20 20 20  alloc==0 ){.    
10c0: 73 71 6c 69 74 65 33 4d 65 6d 53 65 74 44 65 66  sqlite3MemSetDef
10d0: 61 75 6c 74 28 29 3b 0a 20 20 7d 0a 20 20 6d 65  ault();.  }.  me
10e0: 6d 73 65 74 28 26 6d 65 6d 30 2c 20 30 2c 20 73  mset(&mem0, 0, s
10f0: 69 7a 65 6f 66 28 6d 65 6d 30 29 29 3b 0a 20 20  izeof(mem0));.  
1100: 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61  if( sqlite3Globa
1110: 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74  lConfig.bCoreMut
1120: 65 78 20 29 7b 0a 20 20 20 20 6d 65 6d 30 2e 6d  ex ){.    mem0.m
1130: 75 74 65 78 20 3d 20 73 71 6c 69 74 65 33 4d 75  utex = sqlite3Mu
1140: 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f  texAlloc(SQLITE_
1150: 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4d 45 4d  MUTEX_STATIC_MEM
1160: 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 71 6c  );.  }.  if( sql
1170: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67  ite3GlobalConfig
1180: 2e 70 53 63 72 61 74 63 68 20 26 26 20 73 71 6c  .pScratch && sql
1190: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67  ite3GlobalConfig
11a0: 2e 73 7a 53 63 72 61 74 63 68 3e 3d 31 30 30 0a  .szScratch>=100.
11b0: 20 20 20 20 20 20 26 26 20 73 71 6c 69 74 65 33        && sqlite3
11c0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 53 63  GlobalConfig.nSc
11d0: 72 61 74 63 68 3e 30 20 29 7b 0a 20 20 20 20 69  ratch>0 ){.    i
11e0: 6e 74 20 69 2c 20 6e 2c 20 73 7a 3b 0a 20 20 20  nt i, n, sz;.   
11f0: 20 53 63 72 61 74 63 68 46 72 65 65 73 6c 6f 74   ScratchFreeslot
1200: 20 2a 70 53 6c 6f 74 3b 0a 20 20 20 20 73 7a 20   *pSlot;.    sz 
1210: 3d 20 52 4f 55 4e 44 44 4f 57 4e 38 28 73 71 6c  = ROUNDDOWN8(sql
1220: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67  ite3GlobalConfig
1230: 2e 73 7a 53 63 72 61 74 63 68 29 3b 0a 20 20 20  .szScratch);.   
1240: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f   sqlite3GlobalCo
1250: 6e 66 69 67 2e 73 7a 53 63 72 61 74 63 68 20 3d  nfig.szScratch =
1260: 20 73 7a 3b 0a 20 20 20 20 70 53 6c 6f 74 20 3d   sz;.    pSlot =
1270: 20 28 53 63 72 61 74 63 68 46 72 65 65 73 6c 6f   (ScratchFreeslo
1280: 74 2a 29 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c  t*)sqlite3Global
1290: 43 6f 6e 66 69 67 2e 70 53 63 72 61 74 63 68 3b  Config.pScratch;
12a0: 0a 20 20 20 20 6e 20 3d 20 73 71 6c 69 74 65 33  .    n = sqlite3
12b0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 53 63  GlobalConfig.nSc
12c0: 72 61 74 63 68 3b 0a 20 20 20 20 6d 65 6d 30 2e  ratch;.    mem0.
12d0: 70 53 63 72 61 74 63 68 46 72 65 65 20 3d 20 70  pScratchFree = p
12e0: 53 6c 6f 74 3b 0a 20 20 20 20 6d 65 6d 30 2e 6e  Slot;.    mem0.n
12f0: 53 63 72 61 74 63 68 46 72 65 65 20 3d 20 6e 3b  ScratchFree = n;
1300: 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c  .    for(i=0; i<
1310: 6e 2d 31 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20  n-1; i++){.     
1320: 20 70 53 6c 6f 74 2d 3e 70 4e 65 78 74 20 3d 20   pSlot->pNext = 
1330: 28 53 63 72 61 74 63 68 46 72 65 65 73 6c 6f 74  (ScratchFreeslot
1340: 2a 29 28 73 7a 2b 28 63 68 61 72 2a 29 70 53 6c  *)(sz+(char*)pSl
1350: 6f 74 29 3b 0a 20 20 20 20 20 20 70 53 6c 6f 74  ot);.      pSlot
1360: 20 3d 20 70 53 6c 6f 74 2d 3e 70 4e 65 78 74 3b   = pSlot->pNext;
1370: 0a 20 20 20 20 7d 0a 20 20 20 20 70 53 6c 6f 74  .    }.    pSlot
1380: 2d 3e 70 4e 65 78 74 20 3d 20 30 3b 0a 20 20 20  ->pNext = 0;.   
1390: 20 6d 65 6d 30 2e 70 53 63 72 61 74 63 68 45 6e   mem0.pScratchEn
13a0: 64 20 3d 20 28 76 6f 69 64 2a 29 26 70 53 6c 6f  d = (void*)&pSlo
13b0: 74 5b 31 5d 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  t[1];.  }else{. 
13c0: 20 20 20 6d 65 6d 30 2e 70 53 63 72 61 74 63 68     mem0.pScratch
13d0: 45 6e 64 20 3d 20 30 3b 0a 20 20 20 20 73 71 6c  End = 0;.    sql
13e0: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67  ite3GlobalConfig
13f0: 2e 70 53 63 72 61 74 63 68 20 3d 20 30 3b 0a 20  .pScratch = 0;. 
1400: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c     sqlite3Global
1410: 43 6f 6e 66 69 67 2e 73 7a 53 63 72 61 74 63 68  Config.szScratch
1420: 20 3d 20 30 3b 0a 20 20 20 20 73 71 6c 69 74 65   = 0;.    sqlite
1430: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 53  3GlobalConfig.nS
1440: 63 72 61 74 63 68 20 3d 20 30 3b 0a 20 20 7d 0a  cratch = 0;.  }.
1450: 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f    if( sqlite3Glo
1460: 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65 3d  balConfig.pPage=
1470: 3d 30 20 7c 7c 20 73 71 6c 69 74 65 33 47 6c 6f  =0 || sqlite3Glo
1480: 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 50 61 67 65  balConfig.szPage
1490: 3c 35 31 32 0a 20 20 20 20 20 20 7c 7c 20 73 71  <512.      || sq
14a0: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69  lite3GlobalConfi
14b0: 67 2e 6e 50 61 67 65 3c 31 20 29 7b 0a 20 20 20  g.nPage<1 ){.   
14c0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f   sqlite3GlobalCo
14d0: 6e 66 69 67 2e 70 50 61 67 65 20 3d 20 30 3b 0a  nfig.pPage = 0;.
14e0: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61      sqlite3Globa
14f0: 6c 43 6f 6e 66 69 67 2e 73 7a 50 61 67 65 20 3d  lConfig.szPage =
1500: 20 30 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 47   0;.    sqlite3G
1510: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 50 61 67  lobalConfig.nPag
1520: 65 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74  e = 0;.  }.  ret
1530: 75 72 6e 20 73 71 6c 69 74 65 33 47 6c 6f 62 61  urn sqlite3Globa
1540: 6c 43 6f 6e 66 69 67 2e 6d 2e 78 49 6e 69 74 28  lConfig.m.xInit(
1550: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
1560: 66 69 67 2e 6d 2e 70 41 70 70 44 61 74 61 29 3b  fig.m.pAppData);
1570: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  .}../*.** Return
1580: 20 74 72 75 65 20 69 66 20 74 68 65 20 68 65 61   true if the hea
1590: 70 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 75  p is currently u
15a0: 6e 64 65 72 20 6d 65 6d 6f 72 79 20 70 72 65 73  nder memory pres
15b0: 73 75 72 65 20 2d 20 69 6e 20 6f 74 68 65 72 0a  sure - in other.
15c0: 2a 2a 20 77 6f 72 64 73 20 69 66 20 74 68 65 20  ** words if the 
15d0: 61 6d 6f 75 6e 74 20 6f 66 20 68 65 61 70 20 75  amount of heap u
15e0: 73 65 64 20 69 73 20 63 6c 6f 73 65 20 74 6f 20  sed is close to 
15f0: 74 68 65 20 6c 69 6d 69 74 20 73 65 74 20 62 79  the limit set by
1600: 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 73 6f 66 74  .** sqlite3_soft
1610: 5f 68 65 61 70 5f 6c 69 6d 69 74 28 29 2e 0a 2a  _heap_limit()..*
1620: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 48 65 61  /.int sqlite3Hea
1630: 70 4e 65 61 72 6c 79 46 75 6c 6c 28 76 6f 69 64  pNearlyFull(void
1640: 29 7b 0a 20 20 72 65 74 75 72 6e 20 6d 65 6d 30  ){.  return mem0
1650: 2e 6e 65 61 72 6c 79 46 75 6c 6c 3b 0a 7d 0a 0a  .nearlyFull;.}..
1660: 2f 2a 0a 2a 2a 20 44 65 69 6e 69 74 69 61 6c 69  /*.** Deinitiali
1670: 7a 65 20 74 68 65 20 6d 65 6d 6f 72 79 20 61 6c  ze the memory al
1680: 6c 6f 63 61 74 69 6f 6e 20 73 75 62 73 79 73 74  location subsyst
1690: 65 6d 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  em..*/.void sqli
16a0: 74 65 33 4d 61 6c 6c 6f 63 45 6e 64 28 76 6f 69  te3MallocEnd(voi
16b0: 64 29 7b 0a 20 20 69 66 28 20 73 71 6c 69 74 65  d){.  if( sqlite
16c0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e  3GlobalConfig.m.
16d0: 78 53 68 75 74 64 6f 77 6e 20 29 7b 0a 20 20 20  xShutdown ){.   
16e0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f   sqlite3GlobalCo
16f0: 6e 66 69 67 2e 6d 2e 78 53 68 75 74 64 6f 77 6e  nfig.m.xShutdown
1700: 28 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f  (sqlite3GlobalCo
1710: 6e 66 69 67 2e 6d 2e 70 41 70 70 44 61 74 61 29  nfig.m.pAppData)
1720: 3b 0a 20 20 7d 0a 20 20 6d 65 6d 73 65 74 28 26  ;.  }.  memset(&
1730: 6d 65 6d 30 2c 20 30 2c 20 73 69 7a 65 6f 66 28  mem0, 0, sizeof(
1740: 6d 65 6d 30 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  mem0));.}../*.**
1750: 20 52 65 74 75 72 6e 20 74 68 65 20 61 6d 6f 75   Return the amou
1760: 6e 74 20 6f 66 20 6d 65 6d 6f 72 79 20 63 75 72  nt of memory cur
1770: 72 65 6e 74 6c 79 20 63 68 65 63 6b 65 64 20 6f  rently checked o
1780: 75 74 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f 69  ut..*/.sqlite3_i
1790: 6e 74 36 34 20 73 71 6c 69 74 65 33 5f 6d 65 6d  nt64 sqlite3_mem
17a0: 6f 72 79 5f 75 73 65 64 28 76 6f 69 64 29 7b 0a  ory_used(void){.
17b0: 20 20 69 6e 74 20 6e 2c 20 6d 78 3b 0a 20 20 73    int n, mx;.  s
17c0: 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 72 65 73  qlite3_int64 res
17d0: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 61 74  ;.  sqlite3_stat
17e0: 75 73 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53  us(SQLITE_STATUS
17f0: 5f 4d 45 4d 4f 52 59 5f 55 53 45 44 2c 20 26 6e  _MEMORY_USED, &n
1800: 2c 20 26 6d 78 2c 20 30 29 3b 0a 20 20 72 65 73  , &mx, 0);.  res
1810: 20 3d 20 28 73 71 6c 69 74 65 33 5f 69 6e 74 36   = (sqlite3_int6
1820: 34 29 6e 3b 20 20 2f 2a 20 57 6f 72 6b 20 61 72  4)n;  /* Work ar
1830: 6f 75 6e 64 20 62 75 67 20 69 6e 20 42 6f 72 6c  ound bug in Borl
1840: 61 6e 64 20 43 2e 20 54 69 63 6b 65 74 20 23 33  and C. Ticket #3
1850: 32 31 36 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20  216 */.  return 
1860: 72 65 73 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  res;.}../*.** Re
1870: 74 75 72 6e 20 74 68 65 20 6d 61 78 69 6d 75 6d  turn the maximum
1880: 20 61 6d 6f 75 6e 74 20 6f 66 20 6d 65 6d 6f 72   amount of memor
1890: 79 20 74 68 61 74 20 68 61 73 20 65 76 65 72 20  y that has ever 
18a0: 62 65 65 6e 0a 2a 2a 20 63 68 65 63 6b 65 64 20  been.** checked 
18b0: 6f 75 74 20 73 69 6e 63 65 20 65 69 74 68 65 72  out since either
18c0: 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f   the beginning o
18d0: 66 20 74 68 69 73 20 70 72 6f 63 65 73 73 0a 2a  f this process.*
18e0: 2a 20 6f 72 20 73 69 6e 63 65 20 74 68 65 20 6d  * or since the m
18f0: 6f 73 74 20 72 65 63 65 6e 74 20 72 65 73 65 74  ost recent reset
1900: 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f 69 6e 74  ..*/.sqlite3_int
1910: 36 34 20 73 71 6c 69 74 65 33 5f 6d 65 6d 6f 72  64 sqlite3_memor
1920: 79 5f 68 69 67 68 77 61 74 65 72 28 69 6e 74 20  y_highwater(int 
1930: 72 65 73 65 74 46 6c 61 67 29 7b 0a 20 20 69 6e  resetFlag){.  in
1940: 74 20 6e 2c 20 6d 78 3b 0a 20 20 73 71 6c 69 74  t n, mx;.  sqlit
1950: 65 33 5f 69 6e 74 36 34 20 72 65 73 3b 0a 20 20  e3_int64 res;.  
1960: 73 71 6c 69 74 65 33 5f 73 74 61 74 75 73 28 53  sqlite3_status(S
1970: 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d 45 4d  QLITE_STATUS_MEM
1980: 4f 52 59 5f 55 53 45 44 2c 20 26 6e 2c 20 26 6d  ORY_USED, &n, &m
1990: 78 2c 20 72 65 73 65 74 46 6c 61 67 29 3b 0a 20  x, resetFlag);. 
19a0: 20 72 65 73 20 3d 20 28 73 71 6c 69 74 65 33 5f   res = (sqlite3_
19b0: 69 6e 74 36 34 29 6d 78 3b 20 20 2f 2a 20 57 6f  int64)mx;  /* Wo
19c0: 72 6b 20 61 72 6f 75 6e 64 20 62 75 67 20 69 6e  rk around bug in
19d0: 20 42 6f 72 6c 61 6e 64 20 43 2e 20 54 69 63 6b   Borland C. Tick
19e0: 65 74 20 23 33 32 31 36 20 2a 2f 0a 20 20 72 65  et #3216 */.  re
19f0: 74 75 72 6e 20 72 65 73 3b 0a 7d 0a 0a 2f 2a 0a  turn res;.}../*.
1a00: 2a 2a 20 54 72 69 67 67 65 72 20 74 68 65 20 61  ** Trigger the a
1a10: 6c 61 72 6d 20 0a 2a 2f 0a 73 74 61 74 69 63 20  larm .*/.static 
1a20: 76 6f 69 64 20 73 71 6c 69 74 65 33 4d 61 6c 6c  void sqlite3Mall
1a30: 6f 63 41 6c 61 72 6d 28 69 6e 74 20 6e 42 79 74  ocAlarm(int nByt
1a40: 65 29 7b 0a 20 20 76 6f 69 64 20 28 2a 78 43 61  e){.  void (*xCa
1a50: 6c 6c 62 61 63 6b 29 28 76 6f 69 64 2a 2c 73 71  llback)(void*,sq
1a60: 6c 69 74 65 33 5f 69 6e 74 36 34 2c 69 6e 74 29  lite3_int64,int)
1a70: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36  ;.  sqlite3_int6
1a80: 34 20 6e 6f 77 55 73 65 64 3b 0a 20 20 76 6f 69  4 nowUsed;.  voi
1a90: 64 20 2a 70 41 72 67 3b 0a 20 20 69 66 28 20 6d  d *pArg;.  if( m
1aa0: 65 6d 30 2e 61 6c 61 72 6d 43 61 6c 6c 62 61 63  em0.alarmCallbac
1ab0: 6b 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a 20  k==0 ) return;. 
1ac0: 20 78 43 61 6c 6c 62 61 63 6b 20 3d 20 6d 65 6d   xCallback = mem
1ad0: 30 2e 61 6c 61 72 6d 43 61 6c 6c 62 61 63 6b 3b  0.alarmCallback;
1ae0: 0a 20 20 6e 6f 77 55 73 65 64 20 3d 20 73 71 6c  .  nowUsed = sql
1af0: 69 74 65 33 53 74 61 74 75 73 56 61 6c 75 65 28  ite3StatusValue(
1b00: 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d 45  SQLITE_STATUS_ME
1b10: 4d 4f 52 59 5f 55 53 45 44 29 3b 0a 20 20 70 41  MORY_USED);.  pA
1b20: 72 67 20 3d 20 6d 65 6d 30 2e 61 6c 61 72 6d 41  rg = mem0.alarmA
1b30: 72 67 3b 0a 20 20 6d 65 6d 30 2e 61 6c 61 72 6d  rg;.  mem0.alarm
1b40: 43 61 6c 6c 62 61 63 6b 20 3d 20 30 3b 0a 20 20  Callback = 0;.  
1b50: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65  sqlite3_mutex_le
1b60: 61 76 65 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b  ave(mem0.mutex);
1b70: 0a 20 20 78 43 61 6c 6c 62 61 63 6b 28 70 41 72  .  xCallback(pAr
1b80: 67 2c 20 6e 6f 77 55 73 65 64 2c 20 6e 42 79 74  g, nowUsed, nByt
1b90: 65 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75  e);.  sqlite3_mu
1ba0: 74 65 78 5f 65 6e 74 65 72 28 6d 65 6d 30 2e 6d  tex_enter(mem0.m
1bb0: 75 74 65 78 29 3b 0a 20 20 6d 65 6d 30 2e 61 6c  utex);.  mem0.al
1bc0: 61 72 6d 43 61 6c 6c 62 61 63 6b 20 3d 20 78 43  armCallback = xC
1bd0: 61 6c 6c 62 61 63 6b 3b 0a 20 20 6d 65 6d 30 2e  allback;.  mem0.
1be0: 61 6c 61 72 6d 41 72 67 20 3d 20 70 41 72 67 3b  alarmArg = pArg;
1bf0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 6f 20 61 20 6d  .}../*.** Do a m
1c00: 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e  emory allocation
1c10: 20 77 69 74 68 20 73 74 61 74 69 73 74 69 63 73   with statistics
1c20: 20 61 6e 64 20 61 6c 61 72 6d 73 2e 20 20 41 73   and alarms.  As
1c30: 73 75 6d 65 20 74 68 65 0a 2a 2a 20 6c 6f 63 6b  sume the.** lock
1c40: 20 69 73 20 61 6c 72 65 61 64 79 20 68 65 6c 64   is already held
1c50: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
1c60: 6d 61 6c 6c 6f 63 57 69 74 68 41 6c 61 72 6d 28  mallocWithAlarm(
1c70: 69 6e 74 20 6e 2c 20 76 6f 69 64 20 2a 2a 70 70  int n, void **pp
1c80: 29 7b 0a 20 20 69 6e 74 20 6e 46 75 6c 6c 3b 0a  ){.  int nFull;.
1c90: 20 20 76 6f 69 64 20 2a 70 3b 0a 20 20 61 73 73    void *p;.  ass
1ca0: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74  ert( sqlite3_mut
1cb0: 65 78 5f 68 65 6c 64 28 6d 65 6d 30 2e 6d 75 74  ex_held(mem0.mut
1cc0: 65 78 29 20 29 3b 0a 20 20 6e 46 75 6c 6c 20 3d  ex) );.  nFull =
1cd0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f   sqlite3GlobalCo
1ce0: 6e 66 69 67 2e 6d 2e 78 52 6f 75 6e 64 75 70 28  nfig.m.xRoundup(
1cf0: 6e 29 3b 0a 20 20 73 71 6c 69 74 65 33 53 74 61  n);.  sqlite3Sta
1d00: 74 75 73 53 65 74 28 53 51 4c 49 54 45 5f 53 54  tusSet(SQLITE_ST
1d10: 41 54 55 53 5f 4d 41 4c 4c 4f 43 5f 53 49 5a 45  ATUS_MALLOC_SIZE
1d20: 2c 20 6e 29 3b 0a 20 20 69 66 28 20 6d 65 6d 30  , n);.  if( mem0
1d30: 2e 61 6c 61 72 6d 43 61 6c 6c 62 61 63 6b 21 3d  .alarmCallback!=
1d40: 30 20 29 7b 0a 20 20 20 20 69 6e 74 20 6e 55 73  0 ){.    int nUs
1d50: 65 64 20 3d 20 73 71 6c 69 74 65 33 53 74 61 74  ed = sqlite3Stat
1d60: 75 73 56 61 6c 75 65 28 53 51 4c 49 54 45 5f 53  usValue(SQLITE_S
1d70: 54 41 54 55 53 5f 4d 45 4d 4f 52 59 5f 55 53 45  TATUS_MEMORY_USE
1d80: 44 29 3b 0a 20 20 20 20 69 66 28 20 6e 55 73 65  D);.    if( nUse
1d90: 64 20 3e 3d 20 6d 65 6d 30 2e 61 6c 61 72 6d 54  d >= mem0.alarmT
1da0: 68 72 65 73 68 6f 6c 64 20 2d 20 6e 46 75 6c 6c  hreshold - nFull
1db0: 20 29 7b 0a 20 20 20 20 20 20 6d 65 6d 30 2e 6e   ){.      mem0.n
1dc0: 65 61 72 6c 79 46 75 6c 6c 20 3d 20 31 3b 0a 20  earlyFull = 1;. 
1dd0: 20 20 20 20 20 73 71 6c 69 74 65 33 4d 61 6c 6c       sqlite3Mall
1de0: 6f 63 41 6c 61 72 6d 28 6e 46 75 6c 6c 29 3b 0a  ocAlarm(nFull);.
1df0: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
1e00: 20 6d 65 6d 30 2e 6e 65 61 72 6c 79 46 75 6c 6c   mem0.nearlyFull
1e10: 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a   = 0;.    }.  }.
1e20: 20 20 70 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f    p = sqlite3Glo
1e30: 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78 4d 61 6c  balConfig.m.xMal
1e40: 6c 6f 63 28 6e 46 75 6c 6c 29 3b 0a 23 69 66 64  loc(nFull);.#ifd
1e50: 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  ef SQLITE_ENABLE
1e60: 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45  _MEMORY_MANAGEME
1e70: 4e 54 0a 20 20 69 66 28 20 70 3d 3d 30 20 26 26  NT.  if( p==0 &&
1e80: 20 6d 65 6d 30 2e 61 6c 61 72 6d 43 61 6c 6c 62   mem0.alarmCallb
1e90: 61 63 6b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  ack ){.    sqlit
1ea0: 65 33 4d 61 6c 6c 6f 63 41 6c 61 72 6d 28 6e 46  e3MallocAlarm(nF
1eb0: 75 6c 6c 29 3b 0a 20 20 20 20 70 20 3d 20 73 71  ull);.    p = sq
1ec0: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69  lite3GlobalConfi
1ed0: 67 2e 6d 2e 78 4d 61 6c 6c 6f 63 28 6e 46 75 6c  g.m.xMalloc(nFul
1ee0: 6c 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20  l);.  }.#endif. 
1ef0: 20 69 66 28 20 70 20 29 7b 0a 20 20 20 20 6e 46   if( p ){.    nF
1f00: 75 6c 6c 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c  ull = sqlite3Mal
1f10: 6c 6f 63 53 69 7a 65 28 70 29 3b 0a 20 20 20 20  locSize(p);.    
1f20: 73 71 6c 69 74 65 33 53 74 61 74 75 73 41 64 64  sqlite3StatusAdd
1f30: 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d  (SQLITE_STATUS_M
1f40: 45 4d 4f 52 59 5f 55 53 45 44 2c 20 6e 46 75 6c  EMORY_USED, nFul
1f50: 6c 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 53  l);.    sqlite3S
1f60: 74 61 74 75 73 41 64 64 28 53 51 4c 49 54 45 5f  tatusAdd(SQLITE_
1f70: 53 54 41 54 55 53 5f 4d 41 4c 4c 4f 43 5f 43 4f  STATUS_MALLOC_CO
1f80: 55 4e 54 2c 20 31 29 3b 0a 20 20 7d 0a 20 20 2a  UNT, 1);.  }.  *
1f90: 70 70 20 3d 20 70 3b 0a 20 20 72 65 74 75 72 6e  pp = p;.  return
1fa0: 20 6e 46 75 6c 6c 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a   nFull;.}../*.**
1fb0: 20 41 6c 6c 6f 63 61 74 65 20 6d 65 6d 6f 72 79   Allocate memory
1fc0: 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  .  This routine 
1fd0: 69 73 20 6c 69 6b 65 20 73 71 6c 69 74 65 33 5f  is like sqlite3_
1fe0: 6d 61 6c 6c 6f 63 28 29 20 65 78 63 65 70 74 20  malloc() except 
1ff0: 74 68 61 74 20 69 74 0a 2a 2a 20 61 73 73 75 6d  that it.** assum
2000: 65 73 20 74 68 65 20 6d 65 6d 6f 72 79 20 73 75  es the memory su
2010: 62 73 79 73 74 65 6d 20 68 61 73 20 61 6c 72 65  bsystem has alre
2020: 61 64 79 20 62 65 65 6e 20 69 6e 69 74 69 61 6c  ady been initial
2030: 69 7a 65 64 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73  ized..*/.void *s
2040: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 69 6e 74  qlite3Malloc(int
2050: 20 6e 29 7b 0a 20 20 76 6f 69 64 20 2a 70 3b 0a   n){.  void *p;.
2060: 20 20 69 66 28 20 6e 3c 3d 30 20 20 20 20 20 20    if( n<=0      
2070: 20 20 20 20 20 20 20 20 20 2f 2a 20 49 4d 50 3a           /* IMP:
2080: 20 52 2d 36 35 33 31 32 2d 30 34 39 31 37 20 2a   R-65312-04917 *
2090: 2f 20 0a 20 20 20 7c 7c 20 6e 3e 3d 30 78 37 66  / .   || n>=0x7f
20a0: 66 66 66 66 30 30 0a 20 20 29 7b 0a 20 20 20 20  ffff00.  ){.    
20b0: 2f 2a 20 41 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f  /* A memory allo
20c0: 63 61 74 69 6f 6e 20 6f 66 20 61 20 6e 75 6d 62  cation of a numb
20d0: 65 72 20 6f 66 20 62 79 74 65 73 20 77 68 69 63  er of bytes whic
20e0: 68 20 69 73 20 6e 65 61 72 20 74 68 65 20 6d 61  h is near the ma
20f0: 78 69 6d 75 6d 0a 20 20 20 20 2a 2a 20 73 69 67  ximum.    ** sig
2100: 6e 65 64 20 69 6e 74 65 67 65 72 20 76 61 6c 75  ned integer valu
2110: 65 20 6d 69 67 68 74 20 63 61 75 73 65 20 61 6e  e might cause an
2120: 20 69 6e 74 65 67 65 72 20 6f 76 65 72 66 6c 6f   integer overflo
2130: 77 20 69 6e 73 69 64 65 20 6f 66 20 74 68 65 0a  w inside of the.
2140: 20 20 20 20 2a 2a 20 78 4d 61 6c 6c 6f 63 28 29      ** xMalloc()
2150: 2e 20 20 48 65 6e 63 65 20 77 65 20 6c 69 6d 69  .  Hence we limi
2160: 74 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 73 69  t the maximum si
2170: 7a 65 20 74 6f 20 30 78 37 66 66 66 66 66 30 30  ze to 0x7fffff00
2180: 2c 20 67 69 76 69 6e 67 0a 20 20 20 20 2a 2a 20  , giving.    ** 
2190: 32 35 35 20 62 79 74 65 73 20 6f 66 20 6f 76 65  255 bytes of ove
21a0: 72 68 65 61 64 2e 20 20 53 51 4c 69 74 65 20 69  rhead.  SQLite i
21b0: 74 73 65 6c 66 20 77 69 6c 6c 20 6e 65 76 65 72  tself will never
21c0: 20 75 73 65 20 61 6e 79 74 68 69 6e 67 20 6e 65   use anything ne
21d0: 61 72 0a 20 20 20 20 2a 2a 20 74 68 69 73 20 61  ar.    ** this a
21e0: 6d 6f 75 6e 74 2e 20 20 54 68 65 20 6f 6e 6c 79  mount.  The only
21f0: 20 77 61 79 20 74 6f 20 72 65 61 63 68 20 74 68   way to reach th
2200: 65 20 6c 69 6d 69 74 20 69 73 20 77 69 74 68 20  e limit is with 
2210: 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 29  sqlite3_malloc()
2220: 20 2a 2f 0a 20 20 20 20 70 20 3d 20 30 3b 0a 20   */.    p = 0;. 
2230: 20 7d 65 6c 73 65 20 69 66 28 20 73 71 6c 69 74   }else if( sqlit
2240: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62  e3GlobalConfig.b
2250: 4d 65 6d 73 74 61 74 20 29 7b 0a 20 20 20 20 73  Memstat ){.    s
2260: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74  qlite3_mutex_ent
2270: 65 72 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a  er(mem0.mutex);.
2280: 20 20 20 20 6d 61 6c 6c 6f 63 57 69 74 68 41 6c      mallocWithAl
2290: 61 72 6d 28 6e 2c 20 26 70 29 3b 0a 20 20 20 20  arm(n, &p);.    
22a0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65  sqlite3_mutex_le
22b0: 61 76 65 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b  ave(mem0.mutex);
22c0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 20  .  }else{.    p 
22d0: 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43  = sqlite3GlobalC
22e0: 6f 6e 66 69 67 2e 6d 2e 78 4d 61 6c 6c 6f 63 28  onfig.m.xMalloc(
22f0: 6e 29 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74  n);.  }.  assert
2300: 28 20 45 49 47 48 54 5f 42 59 54 45 5f 41 4c 49  ( EIGHT_BYTE_ALI
2310: 47 4e 4d 45 4e 54 28 70 29 20 29 3b 20 20 2f 2a  GNMENT(p) );  /*
2320: 20 49 4d 50 3a 20 52 2d 30 34 36 37 35 2d 34 34   IMP: R-04675-44
2330: 38 35 30 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20  850 */.  return 
2340: 70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  p;.}../*.** This
2350: 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20   version of the 
2360: 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f  memory allocatio
2370: 6e 20 69 73 20 66 6f 72 20 75 73 65 20 62 79 20  n is for use by 
2380: 74 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 2e  the application.
2390: 0a 2a 2a 20 46 69 72 73 74 20 6d 61 6b 65 20 73  .** First make s
23a0: 75 72 65 20 74 68 65 20 6d 65 6d 6f 72 79 20 73  ure the memory s
23b0: 75 62 73 79 73 74 65 6d 20 69 73 20 69 6e 69 74  ubsystem is init
23c0: 69 61 6c 69 7a 65 64 2c 20 74 68 65 6e 20 64 6f  ialized, then do
23d0: 20 74 68 65 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69   the.** allocati
23e0: 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c  on..*/.void *sql
23f0: 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 69 6e 74 20  ite3_malloc(int 
2400: 6e 29 7b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49  n){.#ifndef SQLI
2410: 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e 49 54  TE_OMIT_AUTOINIT
2420: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 5f 69  .  if( sqlite3_i
2430: 6e 69 74 69 61 6c 69 7a 65 28 29 20 29 20 72 65  nitialize() ) re
2440: 74 75 72 6e 20 30 3b 0a 23 65 6e 64 69 66 0a 20  turn 0;.#endif. 
2450: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 4d   return sqlite3M
2460: 61 6c 6c 6f 63 28 6e 29 3b 0a 7d 0a 0a 2f 2a 0a  alloc(n);.}../*.
2470: 2a 2a 20 45 61 63 68 20 74 68 72 65 61 64 20 6d  ** Each thread m
2480: 61 79 20 6f 6e 6c 79 20 68 61 76 65 20 61 20 73  ay only have a s
2490: 69 6e 67 6c 65 20 6f 75 74 73 74 61 6e 64 69 6e  ingle outstandin
24a0: 67 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 66 72 6f  g allocation fro
24b0: 6d 0a 2a 2a 20 78 53 63 72 61 74 63 68 4d 61 6c  m.** xScratchMal
24c0: 6c 6f 63 28 29 2e 20 20 57 65 20 76 65 72 69 66  loc().  We verif
24d0: 79 20 74 68 69 73 20 63 6f 6e 73 74 72 61 69 6e  y this constrain
24e0: 74 20 69 6e 20 74 68 65 20 73 69 6e 67 6c 65 2d  t in the single-
24f0: 74 68 72 65 61 64 65 64 0a 2a 2a 20 63 61 73 65  threaded.** case
2500: 20 62 79 20 73 65 74 74 69 6e 67 20 73 63 72 61   by setting scra
2510: 74 63 68 41 6c 6c 6f 63 4f 75 74 20 74 6f 20 31  tchAllocOut to 1
2520: 20 77 68 65 6e 20 61 6e 20 61 6c 6c 6f 63 61 74   when an allocat
2530: 69 6f 6e 0a 2a 2a 20 69 73 20 6f 75 74 73 74 61  ion.** is outsta
2540: 6e 64 69 6e 67 20 63 6c 65 61 72 69 6e 67 20 69  nding clearing i
2550: 74 20 77 68 65 6e 20 74 68 65 20 61 6c 6c 6f 63  t when the alloc
2560: 61 74 69 6f 6e 20 69 73 20 66 72 65 65 64 2e 0a  ation is freed..
2570: 2a 2f 0a 23 69 66 20 53 51 4c 49 54 45 5f 54 48  */.#if SQLITE_TH
2580: 52 45 41 44 53 41 46 45 3d 3d 30 20 26 26 20 21  READSAFE==0 && !
2590: 64 65 66 69 6e 65 64 28 4e 44 45 42 55 47 29 0a  defined(NDEBUG).
25a0: 73 74 61 74 69 63 20 69 6e 74 20 73 63 72 61 74  static int scrat
25b0: 63 68 41 6c 6c 6f 63 4f 75 74 20 3d 20 30 3b 0a  chAllocOut = 0;.
25c0: 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 41  #endif.../*.** A
25d0: 6c 6c 6f 63 61 74 65 20 6d 65 6d 6f 72 79 20 74  llocate memory t
25e0: 68 61 74 20 69 73 20 74 6f 20 62 65 20 75 73 65  hat is to be use
25f0: 64 20 61 6e 64 20 72 65 6c 65 61 73 65 64 20 72  d and released r
2600: 69 67 68 74 20 61 77 61 79 2e 0a 2a 2a 20 54 68  ight away..** Th
2610: 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 73 69  is routine is si
2620: 6d 69 6c 61 72 20 74 6f 20 61 6c 6c 6f 63 61 28  milar to alloca(
2630: 29 20 69 6e 20 74 68 61 74 20 69 74 20 69 73 20  ) in that it is 
2640: 6e 6f 74 20 69 6e 74 65 6e 64 65 64 0a 2a 2a 20  not intended.** 
2650: 66 6f 72 20 73 69 74 75 61 74 69 6f 6e 73 20 77  for situations w
2660: 68 65 72 65 20 74 68 65 20 6d 65 6d 6f 72 79 20  here the memory 
2670: 6d 69 67 68 74 20 62 65 20 68 65 6c 64 20 6c 6f  might be held lo
2680: 6e 67 2d 74 65 72 6d 2e 20 20 54 68 69 73 0a 2a  ng-term.  This.*
2690: 2a 20 72 6f 75 74 69 6e 65 20 69 73 20 69 6e 74  * routine is int
26a0: 65 6e 64 65 64 20 74 6f 20 67 65 74 20 6d 65 6d  ended to get mem
26b0: 6f 72 79 20 74 6f 20 6f 6c 64 20 6c 61 72 67 65  ory to old large
26c0: 20 74 72 61 6e 73 69 65 6e 74 20 64 61 74 61 0a   transient data.
26d0: 2a 2a 20 73 74 72 75 63 74 75 72 65 73 20 74 68  ** structures th
26e0: 61 74 20 77 6f 75 6c 64 20 6e 6f 74 20 6e 6f 72  at would not nor
26f0: 6d 61 6c 6c 79 20 66 69 74 20 6f 6e 20 74 68 65  mally fit on the
2700: 20 73 74 61 63 6b 20 6f 66 20 61 6e 0a 2a 2a 20   stack of an.** 
2710: 65 6d 62 65 64 64 65 64 20 70 72 6f 63 65 73 73  embedded process
2720: 6f 72 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c  or..*/.void *sql
2730: 69 74 65 33 53 63 72 61 74 63 68 4d 61 6c 6c 6f  ite3ScratchMallo
2740: 63 28 69 6e 74 20 6e 29 7b 0a 20 20 76 6f 69 64  c(int n){.  void
2750: 20 2a 70 3b 0a 20 20 61 73 73 65 72 74 28 20 6e   *p;.  assert( n
2760: 3e 30 20 29 3b 0a 0a 20 20 73 71 6c 69 74 65 33  >0 );..  sqlite3
2770: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d 65 6d  _mutex_enter(mem
2780: 30 2e 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20  0.mutex);.  if( 
2790: 6d 65 6d 30 2e 6e 53 63 72 61 74 63 68 46 72 65  mem0.nScratchFre
27a0: 65 20 26 26 20 73 71 6c 69 74 65 33 47 6c 6f 62  e && sqlite3Glob
27b0: 61 6c 43 6f 6e 66 69 67 2e 73 7a 53 63 72 61 74  alConfig.szScrat
27c0: 63 68 3e 3d 6e 20 29 7b 0a 20 20 20 20 70 20 3d  ch>=n ){.    p =
27d0: 20 6d 65 6d 30 2e 70 53 63 72 61 74 63 68 46 72   mem0.pScratchFr
27e0: 65 65 3b 0a 20 20 20 20 6d 65 6d 30 2e 70 53 63  ee;.    mem0.pSc
27f0: 72 61 74 63 68 46 72 65 65 20 3d 20 6d 65 6d 30  ratchFree = mem0
2800: 2e 70 53 63 72 61 74 63 68 46 72 65 65 2d 3e 70  .pScratchFree->p
2810: 4e 65 78 74 3b 0a 20 20 20 20 6d 65 6d 30 2e 6e  Next;.    mem0.n
2820: 53 63 72 61 74 63 68 46 72 65 65 2d 2d 3b 0a 20  ScratchFree--;. 
2830: 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73     sqlite3Status
2840: 41 64 64 28 53 51 4c 49 54 45 5f 53 54 41 54 55  Add(SQLITE_STATU
2850: 53 5f 53 43 52 41 54 43 48 5f 55 53 45 44 2c 20  S_SCRATCH_USED, 
2860: 31 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 53  1);.    sqlite3S
2870: 74 61 74 75 73 53 65 74 28 53 51 4c 49 54 45 5f  tatusSet(SQLITE_
2880: 53 54 41 54 55 53 5f 53 43 52 41 54 43 48 5f 53  STATUS_SCRATCH_S
2890: 49 5a 45 2c 20 6e 29 3b 0a 20 20 20 20 73 71 6c  IZE, n);.    sql
28a0: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65  ite3_mutex_leave
28b0: 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20  (mem0.mutex);.  
28c0: 7d 65 6c 73 65 7b 0a 20 20 20 20 69 66 28 20 73  }else{.    if( s
28d0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66  qlite3GlobalConf
28e0: 69 67 2e 62 4d 65 6d 73 74 61 74 20 29 7b 0a 20  ig.bMemstat ){. 
28f0: 20 20 20 20 20 73 71 6c 69 74 65 33 53 74 61 74       sqlite3Stat
2900: 75 73 53 65 74 28 53 51 4c 49 54 45 5f 53 54 41  usSet(SQLITE_STA
2910: 54 55 53 5f 53 43 52 41 54 43 48 5f 53 49 5a 45  TUS_SCRATCH_SIZE
2920: 2c 20 6e 29 3b 0a 20 20 20 20 20 20 6e 20 3d 20  , n);.      n = 
2930: 6d 61 6c 6c 6f 63 57 69 74 68 41 6c 61 72 6d 28  mallocWithAlarm(
2940: 6e 2c 20 26 70 29 3b 0a 20 20 20 20 20 20 69 66  n, &p);.      if
2950: 28 20 70 20 29 20 73 71 6c 69 74 65 33 53 74 61  ( p ) sqlite3Sta
2960: 74 75 73 41 64 64 28 53 51 4c 49 54 45 5f 53 54  tusAdd(SQLITE_ST
2970: 41 54 55 53 5f 53 43 52 41 54 43 48 5f 4f 56 45  ATUS_SCRATCH_OVE
2980: 52 46 4c 4f 57 2c 20 6e 29 3b 0a 20 20 20 20 20  RFLOW, n);.     
2990: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c   sqlite3_mutex_l
29a0: 65 61 76 65 28 6d 65 6d 30 2e 6d 75 74 65 78 29  eave(mem0.mutex)
29b0: 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ;.    }else{.   
29c0: 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78     sqlite3_mutex
29d0: 5f 6c 65 61 76 65 28 6d 65 6d 30 2e 6d 75 74 65  _leave(mem0.mute
29e0: 78 29 3b 0a 20 20 20 20 20 20 70 20 3d 20 73 71  x);.      p = sq
29f0: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69  lite3GlobalConfi
2a00: 67 2e 6d 2e 78 4d 61 6c 6c 6f 63 28 6e 29 3b 0a  g.m.xMalloc(n);.
2a10: 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65      }.    sqlite
2a20: 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65  3MemdebugSetType
2a30: 28 70 2c 20 4d 45 4d 54 59 50 45 5f 53 43 52 41  (p, MEMTYPE_SCRA
2a40: 54 43 48 29 3b 0a 20 20 7d 0a 20 20 61 73 73 65  TCH);.  }.  asse
2a50: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  rt( sqlite3_mute
2a60: 78 5f 6e 6f 74 68 65 6c 64 28 6d 65 6d 30 2e 6d  x_notheld(mem0.m
2a70: 75 74 65 78 29 20 29 3b 0a 0a 0a 23 69 66 20 53  utex) );...#if S
2a80: 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45  QLITE_THREADSAFE
2a90: 3d 3d 30 20 26 26 20 21 64 65 66 69 6e 65 64 28  ==0 && !defined(
2aa0: 4e 44 45 42 55 47 29 0a 20 20 2f 2a 20 56 65 72  NDEBUG).  /* Ver
2ab0: 69 66 79 20 74 68 61 74 20 6e 6f 20 6d 6f 72 65  ify that no more
2ac0: 20 74 68 61 6e 20 74 77 6f 20 73 63 72 61 74 63   than two scratc
2ad0: 68 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 70 65  h allocations pe
2ae0: 72 20 74 68 72 65 61 64 0a 20 20 2a 2a 20 61 72  r thread.  ** ar
2af0: 65 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 61 74  e outstanding at
2b00: 20 6f 6e 65 20 74 69 6d 65 2e 20 20 28 54 68 69   one time.  (Thi
2b10: 73 20 69 73 20 6f 6e 6c 79 20 63 68 65 63 6b 65  s is only checke
2b20: 64 20 69 6e 20 74 68 65 0a 20 20 2a 2a 20 73 69  d in the.  ** si
2b30: 6e 67 6c 65 2d 74 68 72 65 61 64 65 64 20 63 61  ngle-threaded ca
2b40: 73 65 20 73 69 6e 63 65 20 63 68 65 63 6b 69 6e  se since checkin
2b50: 67 20 69 6e 20 74 68 65 20 6d 75 6c 74 69 2d 74  g in the multi-t
2b60: 68 72 65 61 64 65 64 20 63 61 73 65 0a 20 20 2a  hreaded case.  *
2b70: 2a 20 77 6f 75 6c 64 20 62 65 20 6d 75 63 68 20  * would be much 
2b80: 6d 6f 72 65 20 63 6f 6d 70 6c 69 63 61 74 65 64  more complicated
2b90: 2e 29 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20  .) */.  assert( 
2ba0: 73 63 72 61 74 63 68 41 6c 6c 6f 63 4f 75 74 3c  scratchAllocOut<
2bb0: 3d 31 20 29 3b 0a 20 20 69 66 28 20 70 20 29 20  =1 );.  if( p ) 
2bc0: 73 63 72 61 74 63 68 41 6c 6c 6f 63 4f 75 74 2b  scratchAllocOut+
2bd0: 2b 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 72 65 74  +;.#endif..  ret
2be0: 75 72 6e 20 70 3b 0a 7d 0a 76 6f 69 64 20 73 71  urn p;.}.void sq
2bf0: 6c 69 74 65 33 53 63 72 61 74 63 68 46 72 65 65  lite3ScratchFree
2c00: 28 76 6f 69 64 20 2a 70 29 7b 0a 20 20 69 66 28  (void *p){.  if(
2c10: 20 70 20 29 7b 0a 0a 23 69 66 20 53 51 4c 49 54   p ){..#if SQLIT
2c20: 45 5f 54 48 52 45 41 44 53 41 46 45 3d 3d 30 20  E_THREADSAFE==0 
2c30: 26 26 20 21 64 65 66 69 6e 65 64 28 4e 44 45 42  && !defined(NDEB
2c40: 55 47 29 0a 20 20 20 20 2f 2a 20 56 65 72 69 66  UG).    /* Verif
2c50: 79 20 74 68 61 74 20 6e 6f 20 6d 6f 72 65 20 74  y that no more t
2c60: 68 61 6e 20 74 77 6f 20 73 63 72 61 74 63 68 20  han two scratch 
2c70: 61 6c 6c 6f 63 61 74 69 6f 6e 20 70 65 72 20 74  allocation per t
2c80: 68 72 65 61 64 0a 20 20 20 20 2a 2a 20 69 73 20  hread.    ** is 
2c90: 6f 75 74 73 74 61 6e 64 69 6e 67 20 61 74 20 6f  outstanding at o
2ca0: 6e 65 20 74 69 6d 65 2e 20 20 28 54 68 69 73 20  ne time.  (This 
2cb0: 69 73 20 6f 6e 6c 79 20 63 68 65 63 6b 65 64 20  is only checked 
2cc0: 69 6e 20 74 68 65 0a 20 20 20 20 2a 2a 20 73 69  in the.    ** si
2cd0: 6e 67 6c 65 2d 74 68 72 65 61 64 65 64 20 63 61  ngle-threaded ca
2ce0: 73 65 20 73 69 6e 63 65 20 63 68 65 63 6b 69 6e  se since checkin
2cf0: 67 20 69 6e 20 74 68 65 20 6d 75 6c 74 69 2d 74  g in the multi-t
2d00: 68 72 65 61 64 65 64 20 63 61 73 65 0a 20 20 20  hreaded case.   
2d10: 20 2a 2a 20 77 6f 75 6c 64 20 62 65 20 6d 75 63   ** would be muc
2d20: 68 20 6d 6f 72 65 20 63 6f 6d 70 6c 69 63 61 74  h more complicat
2d30: 65 64 2e 29 20 2a 2f 0a 20 20 20 20 61 73 73 65  ed.) */.    asse
2d40: 72 74 28 20 73 63 72 61 74 63 68 41 6c 6c 6f 63  rt( scratchAlloc
2d50: 4f 75 74 3e 3d 31 20 26 26 20 73 63 72 61 74 63  Out>=1 && scratc
2d60: 68 41 6c 6c 6f 63 4f 75 74 3c 3d 32 20 29 3b 0a  hAllocOut<=2 );.
2d70: 20 20 20 20 73 63 72 61 74 63 68 41 6c 6c 6f 63      scratchAlloc
2d80: 4f 75 74 2d 2d 3b 0a 23 65 6e 64 69 66 0a 0a 20  Out--;.#endif.. 
2d90: 20 20 20 69 66 28 20 70 3e 3d 73 71 6c 69 74 65     if( p>=sqlite
2da0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 53  3GlobalConfig.pS
2db0: 63 72 61 74 63 68 20 26 26 20 70 3c 6d 65 6d 30  cratch && p<mem0
2dc0: 2e 70 53 63 72 61 74 63 68 45 6e 64 20 29 7b 0a  .pScratchEnd ){.
2dd0: 20 20 20 20 20 20 2f 2a 20 52 65 6c 65 61 73 65        /* Release
2de0: 20 6d 65 6d 6f 72 79 20 66 72 6f 6d 20 74 68 65   memory from the
2df0: 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53   SQLITE_CONFIG_S
2e00: 43 52 41 54 43 48 20 61 6c 6c 6f 63 61 74 69 6f  CRATCH allocatio
2e10: 6e 20 2a 2f 0a 20 20 20 20 20 20 53 63 72 61 74  n */.      Scrat
2e20: 63 68 46 72 65 65 73 6c 6f 74 20 2a 70 53 6c 6f  chFreeslot *pSlo
2e30: 74 3b 0a 20 20 20 20 20 20 70 53 6c 6f 74 20 3d  t;.      pSlot =
2e40: 20 28 53 63 72 61 74 63 68 46 72 65 65 73 6c 6f   (ScratchFreeslo
2e50: 74 2a 29 70 3b 0a 20 20 20 20 20 20 73 71 6c 69  t*)p;.      sqli
2e60: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28  te3_mutex_enter(
2e70: 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20  mem0.mutex);.   
2e80: 20 20 20 70 53 6c 6f 74 2d 3e 70 4e 65 78 74 20     pSlot->pNext 
2e90: 3d 20 6d 65 6d 30 2e 70 53 63 72 61 74 63 68 46  = mem0.pScratchF
2ea0: 72 65 65 3b 0a 20 20 20 20 20 20 6d 65 6d 30 2e  ree;.      mem0.
2eb0: 70 53 63 72 61 74 63 68 46 72 65 65 20 3d 20 70  pScratchFree = p
2ec0: 53 6c 6f 74 3b 0a 20 20 20 20 20 20 6d 65 6d 30  Slot;.      mem0
2ed0: 2e 6e 53 63 72 61 74 63 68 46 72 65 65 2b 2b 3b  .nScratchFree++;
2ee0: 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 6d  .      assert( m
2ef0: 65 6d 30 2e 6e 53 63 72 61 74 63 68 46 72 65 65  em0.nScratchFree
2f00: 20 3c 3d 20 28 75 33 32 29 73 71 6c 69 74 65 33   <= (u32)sqlite3
2f10: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 53 63  GlobalConfig.nSc
2f20: 72 61 74 63 68 20 29 3b 0a 20 20 20 20 20 20 73  ratch );.      s
2f30: 71 6c 69 74 65 33 53 74 61 74 75 73 41 64 64 28  qlite3StatusAdd(
2f40: 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 53 43  SQLITE_STATUS_SC
2f50: 52 41 54 43 48 5f 55 53 45 44 2c 20 2d 31 29 3b  RATCH_USED, -1);
2f60: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d  .      sqlite3_m
2f70: 75 74 65 78 5f 6c 65 61 76 65 28 6d 65 6d 30 2e  utex_leave(mem0.
2f80: 6d 75 74 65 78 29 3b 0a 20 20 20 20 7d 65 6c 73  mutex);.    }els
2f90: 65 7b 0a 20 20 20 20 20 20 2f 2a 20 52 65 6c 65  e{.      /* Rele
2fa0: 61 73 65 20 6d 65 6d 6f 72 79 20 62 61 63 6b 20  ase memory back 
2fb0: 74 6f 20 74 68 65 20 68 65 61 70 20 2a 2f 0a 20  to the heap */. 
2fc0: 20 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c       assert( sql
2fd0: 69 74 65 33 4d 65 6d 64 65 62 75 67 48 61 73 54  ite3MemdebugHasT
2fe0: 79 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 53  ype(p, MEMTYPE_S
2ff0: 43 52 41 54 43 48 29 20 29 3b 0a 20 20 20 20 20  CRATCH) );.     
3000: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
3010: 4d 65 6d 64 65 62 75 67 4e 6f 54 79 70 65 28 70  MemdebugNoType(p
3020: 2c 20 7e 4d 45 4d 54 59 50 45 5f 53 43 52 41 54  , ~MEMTYPE_SCRAT
3030: 43 48 29 20 29 3b 0a 20 20 20 20 20 20 73 71 6c  CH) );.      sql
3040: 69 74 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54  ite3MemdebugSetT
3050: 79 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 48  ype(p, MEMTYPE_H
3060: 45 41 50 29 3b 0a 20 20 20 20 20 20 69 66 28 20  EAP);.      if( 
3070: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
3080: 66 69 67 2e 62 4d 65 6d 73 74 61 74 20 29 7b 0a  fig.bMemstat ){.
3090: 20 20 20 20 20 20 20 20 69 6e 74 20 69 53 69 7a          int iSiz
30a0: 65 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f  e = sqlite3Mallo
30b0: 63 53 69 7a 65 28 70 29 3b 0a 20 20 20 20 20 20  cSize(p);.      
30c0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f    sqlite3_mutex_
30d0: 65 6e 74 65 72 28 6d 65 6d 30 2e 6d 75 74 65 78  enter(mem0.mutex
30e0: 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74  );.        sqlit
30f0: 65 33 53 74 61 74 75 73 41 64 64 28 53 51 4c 49  e3StatusAdd(SQLI
3100: 54 45 5f 53 54 41 54 55 53 5f 53 43 52 41 54 43  TE_STATUS_SCRATC
3110: 48 5f 4f 56 45 52 46 4c 4f 57 2c 20 2d 69 53 69  H_OVERFLOW, -iSi
3120: 7a 65 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c  ze);.        sql
3130: 69 74 65 33 53 74 61 74 75 73 41 64 64 28 53 51  ite3StatusAdd(SQ
3140: 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d 45 4d 4f  LITE_STATUS_MEMO
3150: 52 59 5f 55 53 45 44 2c 20 2d 69 53 69 7a 65 29  RY_USED, -iSize)
3160: 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65  ;.        sqlite
3170: 33 53 74 61 74 75 73 41 64 64 28 53 51 4c 49 54  3StatusAdd(SQLIT
3180: 45 5f 53 54 41 54 55 53 5f 4d 41 4c 4c 4f 43 5f  E_STATUS_MALLOC_
3190: 43 4f 55 4e 54 2c 20 2d 31 29 3b 0a 20 20 20 20  COUNT, -1);.    
31a0: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61      sqlite3Globa
31b0: 6c 43 6f 6e 66 69 67 2e 6d 2e 78 46 72 65 65 28  lConfig.m.xFree(
31c0: 70 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69  p);.        sqli
31d0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
31e0: 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20  mem0.mutex);.   
31f0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
3200: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43    sqlite3GlobalC
3210: 6f 6e 66 69 67 2e 6d 2e 78 46 72 65 65 28 70 29  onfig.m.xFree(p)
3220: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
3230: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 52 55    }.}../*.** TRU
3240: 45 20 69 66 20 70 20 69 73 20 61 20 6c 6f 6f 6b  E if p is a look
3250: 61 73 69 64 65 20 6d 65 6d 6f 72 79 20 61 6c 6c  aside memory all
3260: 6f 63 61 74 69 6f 6e 20 66 72 6f 6d 20 64 62 0a  ocation from db.
3270: 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54  */.#ifndef SQLIT
3280: 45 5f 4f 4d 49 54 5f 4c 4f 4f 4b 41 53 49 44 45  E_OMIT_LOOKASIDE
3290: 0a 73 74 61 74 69 63 20 69 6e 74 20 69 73 4c 6f  .static int isLo
32a0: 6f 6b 61 73 69 64 65 28 73 71 6c 69 74 65 33 20  okaside(sqlite3 
32b0: 2a 64 62 2c 20 76 6f 69 64 20 2a 70 29 7b 0a 20  *db, void *p){. 
32c0: 20 72 65 74 75 72 6e 20 70 20 26 26 20 70 3e 3d   return p && p>=
32d0: 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 53  db->lookaside.pS
32e0: 74 61 72 74 20 26 26 20 70 3c 64 62 2d 3e 6c 6f  tart && p<db->lo
32f0: 6f 6b 61 73 69 64 65 2e 70 45 6e 64 3b 0a 7d 0a  okaside.pEnd;.}.
3300: 23 65 6c 73 65 0a 23 64 65 66 69 6e 65 20 69 73  #else.#define is
3310: 4c 6f 6f 6b 61 73 69 64 65 28 41 2c 42 29 20 30  Lookaside(A,B) 0
3320: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52  .#endif../*.** R
3330: 65 74 75 72 6e 20 74 68 65 20 73 69 7a 65 20 6f  eturn the size o
3340: 66 20 61 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63  f a memory alloc
3350: 61 74 69 6f 6e 20 70 72 65 76 69 6f 75 73 6c 79  ation previously
3360: 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 0a 2a   obtained from.*
3370: 2a 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28  * sqlite3Malloc(
3380: 29 20 6f 72 20 73 71 6c 69 74 65 33 5f 6d 61 6c  ) or sqlite3_mal
3390: 6c 6f 63 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71  loc()..*/.int sq
33a0: 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28  lite3MallocSize(
33b0: 76 6f 69 64 20 2a 70 29 7b 0a 20 20 61 73 73 65  void *p){.  asse
33c0: 72 74 28 20 73 71 6c 69 74 65 33 4d 65 6d 64 65  rt( sqlite3Memde
33d0: 62 75 67 48 61 73 54 79 70 65 28 70 2c 20 4d 45  bugHasType(p, ME
33e0: 4d 54 59 50 45 5f 48 45 41 50 29 20 29 3b 0a 20  MTYPE_HEAP) );. 
33f0: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
3400: 4d 65 6d 64 65 62 75 67 4e 6f 54 79 70 65 28 70  MemdebugNoType(p
3410: 2c 20 4d 45 4d 54 59 50 45 5f 44 42 29 20 29 3b  , MEMTYPE_DB) );
3420: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65  .  return sqlite
3430: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e  3GlobalConfig.m.
3440: 78 53 69 7a 65 28 70 29 3b 0a 7d 0a 69 6e 74 20  xSize(p);.}.int 
3450: 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 53  sqlite3DbMallocS
3460: 69 7a 65 28 73 71 6c 69 74 65 33 20 2a 64 62 2c  ize(sqlite3 *db,
3470: 20 76 6f 69 64 20 2a 70 29 7b 0a 20 20 61 73 73   void *p){.  ass
3480: 65 72 74 28 20 64 62 3d 3d 30 20 7c 7c 20 73 71  ert( db==0 || sq
3490: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64  lite3_mutex_held
34a0: 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20  (db->mutex) );. 
34b0: 20 69 66 28 20 64 62 20 26 26 20 69 73 4c 6f 6f   if( db && isLoo
34c0: 6b 61 73 69 64 65 28 64 62 2c 20 70 29 20 29 7b  kaside(db, p) ){
34d0: 0a 20 20 20 20 72 65 74 75 72 6e 20 64 62 2d 3e  .    return db->
34e0: 6c 6f 6f 6b 61 73 69 64 65 2e 73 7a 3b 0a 20 20  lookaside.sz;.  
34f0: 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 72  }else{.    asser
3500: 74 28 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62  t( sqlite3Memdeb
3510: 75 67 48 61 73 54 79 70 65 28 70 2c 20 4d 45 4d  ugHasType(p, MEM
3520: 54 59 50 45 5f 44 42 29 20 29 3b 0a 20 20 20 20  TYPE_DB) );.    
3530: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d  assert( sqlite3M
3540: 65 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 70  emdebugHasType(p
3550: 2c 20 4d 45 4d 54 59 50 45 5f 4c 4f 4f 4b 41 53  , MEMTYPE_LOOKAS
3560: 49 44 45 7c 4d 45 4d 54 59 50 45 5f 48 45 41 50  IDE|MEMTYPE_HEAP
3570: 29 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28  ) );.    assert(
3580: 20 64 62 21 3d 30 20 7c 7c 20 73 71 6c 69 74 65   db!=0 || sqlite
3590: 33 4d 65 6d 64 65 62 75 67 4e 6f 54 79 70 65 28  3MemdebugNoType(
35a0: 70 2c 20 4d 45 4d 54 59 50 45 5f 4c 4f 4f 4b 41  p, MEMTYPE_LOOKA
35b0: 53 49 44 45 29 20 29 3b 0a 20 20 20 20 72 65 74  SIDE) );.    ret
35c0: 75 72 6e 20 73 71 6c 69 74 65 33 47 6c 6f 62 61  urn sqlite3Globa
35d0: 6c 43 6f 6e 66 69 67 2e 6d 2e 78 53 69 7a 65 28  lConfig.m.xSize(
35e0: 70 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a  p);.  }.}../*.**
35f0: 20 46 72 65 65 20 6d 65 6d 6f 72 79 20 70 72 65   Free memory pre
3600: 76 69 6f 75 73 6c 79 20 6f 62 74 61 69 6e 65 64  viously obtained
3610: 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 4d 61 6c   from sqlite3Mal
3620: 6c 6f 63 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 73  loc()..*/.void s
3630: 71 6c 69 74 65 33 5f 66 72 65 65 28 76 6f 69 64  qlite3_free(void
3640: 20 2a 70 29 7b 0a 20 20 69 66 28 20 70 3d 3d 30   *p){.  if( p==0
3650: 20 29 20 72 65 74 75 72 6e 3b 20 20 2f 2a 20 49   ) return;  /* I
3660: 4d 50 3a 20 52 2d 34 39 30 35 33 2d 35 34 35 35  MP: R-49053-5455
3670: 34 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 73  4 */.  assert( s
3680: 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 4e 6f  qlite3MemdebugNo
3690: 54 79 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f  Type(p, MEMTYPE_
36a0: 44 42 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28  DB) );.  assert(
36b0: 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67   sqlite3Memdebug
36c0: 48 61 73 54 79 70 65 28 70 2c 20 4d 45 4d 54 59  HasType(p, MEMTY
36d0: 50 45 5f 48 45 41 50 29 20 29 3b 0a 20 20 69 66  PE_HEAP) );.  if
36e0: 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43  ( sqlite3GlobalC
36f0: 6f 6e 66 69 67 2e 62 4d 65 6d 73 74 61 74 20 29  onfig.bMemstat )
3700: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75  {.    sqlite3_mu
3710: 74 65 78 5f 65 6e 74 65 72 28 6d 65 6d 30 2e 6d  tex_enter(mem0.m
3720: 75 74 65 78 29 3b 0a 20 20 20 20 73 71 6c 69 74  utex);.    sqlit
3730: 65 33 53 74 61 74 75 73 41 64 64 28 53 51 4c 49  e3StatusAdd(SQLI
3740: 54 45 5f 53 54 41 54 55 53 5f 4d 45 4d 4f 52 59  TE_STATUS_MEMORY
3750: 5f 55 53 45 44 2c 20 2d 73 71 6c 69 74 65 33 4d  _USED, -sqlite3M
3760: 61 6c 6c 6f 63 53 69 7a 65 28 70 29 29 3b 0a 20  allocSize(p));. 
3770: 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73     sqlite3Status
3780: 41 64 64 28 53 51 4c 49 54 45 5f 53 54 41 54 55  Add(SQLITE_STATU
3790: 53 5f 4d 41 4c 4c 4f 43 5f 43 4f 55 4e 54 2c 20  S_MALLOC_COUNT, 
37a0: 2d 31 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  -1);.    sqlite3
37b0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78  GlobalConfig.m.x
37c0: 46 72 65 65 28 70 29 3b 0a 20 20 20 20 73 71 6c  Free(p);.    sql
37d0: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65  ite3_mutex_leave
37e0: 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20  (mem0.mutex);.  
37f0: 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74  }else{.    sqlit
3800: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d  e3GlobalConfig.m
3810: 2e 78 46 72 65 65 28 70 29 3b 0a 20 20 7d 0a 7d  .xFree(p);.  }.}
3820: 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 6d 65 6d  ../*.** Free mem
3830: 6f 72 79 20 74 68 61 74 20 6d 69 67 68 74 20 62  ory that might b
3840: 65 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74  e associated wit
3850: 68 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 64  h a particular d
3860: 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f 6e 6e 65  atabase.** conne
3870: 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73  ction..*/.void s
3880: 71 6c 69 74 65 33 44 62 46 72 65 65 28 73 71 6c  qlite3DbFree(sql
3890: 69 74 65 33 20 2a 64 62 2c 20 76 6f 69 64 20 2a  ite3 *db, void *
38a0: 70 29 7b 0a 20 20 61 73 73 65 72 74 28 20 64 62  p){.  assert( db
38b0: 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65 33 5f 6d  ==0 || sqlite3_m
38c0: 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75  utex_held(db->mu
38d0: 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 64 62  tex) );.  if( db
38e0: 20 29 7b 0a 20 20 20 20 69 66 28 20 64 62 2d 3e   ){.    if( db->
38f0: 70 6e 42 79 74 65 73 46 72 65 65 64 20 29 7b 0a  pnBytesFreed ){.
3900: 20 20 20 20 20 20 2a 64 62 2d 3e 70 6e 42 79 74        *db->pnByt
3910: 65 73 46 72 65 65 64 20 2b 3d 20 73 71 6c 69 74  esFreed += sqlit
3920: 65 33 44 62 4d 61 6c 6c 6f 63 53 69 7a 65 28 64  e3DbMallocSize(d
3930: 62 2c 20 70 29 3b 0a 20 20 20 20 20 20 72 65 74  b, p);.      ret
3940: 75 72 6e 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69  urn;.    }.    i
3950: 66 28 20 69 73 4c 6f 6f 6b 61 73 69 64 65 28 64  f( isLookaside(d
3960: 62 2c 20 70 29 20 29 7b 0a 20 20 20 20 20 20 4c  b, p) ){.      L
3970: 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 20 2a 70 42  ookasideSlot *pB
3980: 75 66 20 3d 20 28 4c 6f 6f 6b 61 73 69 64 65 53  uf = (LookasideS
3990: 6c 6f 74 2a 29 70 3b 0a 20 20 20 20 20 20 70 42  lot*)p;.      pB
39a0: 75 66 2d 3e 70 4e 65 78 74 20 3d 20 64 62 2d 3e  uf->pNext = db->
39b0: 6c 6f 6f 6b 61 73 69 64 65 2e 70 46 72 65 65 3b  lookaside.pFree;
39c0: 0a 20 20 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61  .      db->looka
39d0: 73 69 64 65 2e 70 46 72 65 65 20 3d 20 70 42 75  side.pFree = pBu
39e0: 66 3b 0a 20 20 20 20 20 20 64 62 2d 3e 6c 6f 6f  f;.      db->loo
39f0: 6b 61 73 69 64 65 2e 6e 4f 75 74 2d 2d 3b 0a 20  kaside.nOut--;. 
3a00: 20 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 20       return;.   
3a10: 20 7d 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28   }.  }.  assert(
3a20: 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67   sqlite3Memdebug
3a30: 48 61 73 54 79 70 65 28 70 2c 20 4d 45 4d 54 59  HasType(p, MEMTY
3a40: 50 45 5f 44 42 29 20 29 3b 0a 20 20 61 73 73 65  PE_DB) );.  asse
3a50: 72 74 28 20 73 71 6c 69 74 65 33 4d 65 6d 64 65  rt( sqlite3Memde
3a60: 62 75 67 48 61 73 54 79 70 65 28 70 2c 20 4d 45  bugHasType(p, ME
3a70: 4d 54 59 50 45 5f 4c 4f 4f 4b 41 53 49 44 45 7c  MTYPE_LOOKASIDE|
3a80: 4d 45 4d 54 59 50 45 5f 48 45 41 50 29 20 29 3b  MEMTYPE_HEAP) );
3a90: 0a 20 20 61 73 73 65 72 74 28 20 64 62 21 3d 30  .  assert( db!=0
3aa0: 20 7c 7c 20 73 71 6c 69 74 65 33 4d 65 6d 64 65   || sqlite3Memde
3ab0: 62 75 67 4e 6f 54 79 70 65 28 70 2c 20 4d 45 4d  bugNoType(p, MEM
3ac0: 54 59 50 45 5f 4c 4f 4f 4b 41 53 49 44 45 29 20  TYPE_LOOKASIDE) 
3ad0: 29 3b 0a 20 20 73 71 6c 69 74 65 33 4d 65 6d 64  );.  sqlite3Memd
3ae0: 65 62 75 67 53 65 74 54 79 70 65 28 70 2c 20 4d  ebugSetType(p, M
3af0: 45 4d 54 59 50 45 5f 48 45 41 50 29 3b 0a 20 20  EMTYPE_HEAP);.  
3b00: 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b  sqlite3_free(p);
3b10: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65  .}../*.** Change
3b20: 20 74 68 65 20 73 69 7a 65 20 6f 66 20 61 6e 20   the size of an 
3b30: 65 78 69 73 74 69 6e 67 20 6d 65 6d 6f 72 79 20  existing memory 
3b40: 61 6c 6c 6f 63 61 74 69 6f 6e 0a 2a 2f 0a 76 6f  allocation.*/.vo
3b50: 69 64 20 2a 73 71 6c 69 74 65 33 52 65 61 6c 6c  id *sqlite3Reall
3b60: 6f 63 28 76 6f 69 64 20 2a 70 4f 6c 64 2c 20 69  oc(void *pOld, i
3b70: 6e 74 20 6e 42 79 74 65 73 29 7b 0a 20 20 69 6e  nt nBytes){.  in
3b80: 74 20 6e 4f 6c 64 2c 20 6e 4e 65 77 2c 20 6e 44  t nOld, nNew, nD
3b90: 69 66 66 3b 0a 20 20 76 6f 69 64 20 2a 70 4e 65  iff;.  void *pNe
3ba0: 77 3b 0a 20 20 69 66 28 20 70 4f 6c 64 3d 3d 30  w;.  if( pOld==0
3bb0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 73   ){.    return s
3bc0: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 6e 42 79  qlite3Malloc(nBy
3bd0: 74 65 73 29 3b 20 2f 2a 20 49 4d 50 3a 20 52 2d  tes); /* IMP: R-
3be0: 32 38 33 35 34 2d 32 35 37 36 39 20 2a 2f 0a 20  28354-25769 */. 
3bf0: 20 7d 0a 20 20 69 66 28 20 6e 42 79 74 65 73 3c   }.  if( nBytes<
3c00: 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  =0 ){.    sqlite
3c10: 33 5f 66 72 65 65 28 70 4f 6c 64 29 3b 20 2f 2a  3_free(pOld); /*
3c20: 20 49 4d 50 3a 20 52 2d 33 31 35 39 33 2d 31 30   IMP: R-31593-10
3c30: 35 37 34 20 2a 2f 0a 20 20 20 20 72 65 74 75 72  574 */.    retur
3c40: 6e 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6e  n 0;.  }.  if( n
3c50: 42 79 74 65 73 3e 3d 30 78 37 66 66 66 66 66 30  Bytes>=0x7fffff0
3c60: 30 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20  0 ){.    /* The 
3c70: 30 78 37 66 66 66 66 30 30 20 6c 69 6d 69 74 20  0x7ffff00 limit 
3c80: 74 65 72 6d 20 69 73 20 65 78 70 6c 61 69 6e 65  term is explaine
3c90: 64 20 69 6e 20 63 6f 6d 6d 65 6e 74 73 20 6f 6e  d in comments on
3ca0: 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 29   sqlite3Malloc()
3cb0: 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 30   */.    return 0
3cc0: 3b 0a 20 20 7d 0a 20 20 6e 4f 6c 64 20 3d 20 73  ;.  }.  nOld = s
3cd0: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65  qlite3MallocSize
3ce0: 28 70 4f 6c 64 29 3b 0a 20 20 2f 2a 20 49 4d 50  (pOld);.  /* IMP
3cf0: 4c 45 4d 45 4e 54 41 54 49 4f 4e 2d 4f 46 3a 20  LEMENTATION-OF: 
3d00: 52 2d 34 36 31 39 39 2d 33 30 32 34 39 20 53 51  R-46199-30249 SQ
3d10: 4c 69 74 65 20 67 75 61 72 61 6e 74 65 65 73 20  Lite guarantees 
3d20: 74 68 61 74 20 74 68 65 20 73 65 63 6f 6e 64 0a  that the second.
3d30: 20 20 2a 2a 20 61 72 67 75 6d 65 6e 74 20 74 6f    ** argument to
3d40: 20 78 52 65 61 6c 6c 6f 63 20 69 73 20 61 6c 77   xRealloc is alw
3d50: 61 79 73 20 61 20 76 61 6c 75 65 20 72 65 74 75  ays a value retu
3d60: 72 6e 65 64 20 62 79 20 61 20 70 72 69 6f 72 20  rned by a prior 
3d70: 63 61 6c 6c 20 74 6f 0a 20 20 2a 2a 20 78 52 6f  call to.  ** xRo
3d80: 75 6e 64 75 70 2e 20 2a 2f 0a 20 20 6e 4e 65 77  undup. */.  nNew
3d90: 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c   = sqlite3Global
3da0: 43 6f 6e 66 69 67 2e 6d 2e 78 52 6f 75 6e 64 75  Config.m.xRoundu
3db0: 70 28 6e 42 79 74 65 73 29 3b 0a 20 20 69 66 28  p(nBytes);.  if(
3dc0: 20 6e 4f 6c 64 3d 3d 6e 4e 65 77 20 29 7b 0a 20   nOld==nNew ){. 
3dd0: 20 20 20 70 4e 65 77 20 3d 20 70 4f 6c 64 3b 0a     pNew = pOld;.
3de0: 20 20 7d 65 6c 73 65 20 69 66 28 20 73 71 6c 69    }else if( sqli
3df0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e  te3GlobalConfig.
3e00: 62 4d 65 6d 73 74 61 74 20 29 7b 0a 20 20 20 20  bMemstat ){.    
3e10: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e  sqlite3_mutex_en
3e20: 74 65 72 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b  ter(mem0.mutex);
3e30: 0a 20 20 20 20 73 71 6c 69 74 65 33 53 74 61 74  .    sqlite3Stat
3e40: 75 73 53 65 74 28 53 51 4c 49 54 45 5f 53 54 41  usSet(SQLITE_STA
3e50: 54 55 53 5f 4d 41 4c 4c 4f 43 5f 53 49 5a 45 2c  TUS_MALLOC_SIZE,
3e60: 20 6e 42 79 74 65 73 29 3b 0a 20 20 20 20 6e 44   nBytes);.    nD
3e70: 69 66 66 20 3d 20 6e 4e 65 77 20 2d 20 6e 4f 6c  iff = nNew - nOl
3e80: 64 3b 0a 20 20 20 20 69 66 28 20 73 71 6c 69 74  d;.    if( sqlit
3e90: 65 33 53 74 61 74 75 73 56 61 6c 75 65 28 53 51  e3StatusValue(SQ
3ea0: 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d 45 4d 4f  LITE_STATUS_MEMO
3eb0: 52 59 5f 55 53 45 44 29 20 3e 3d 20 0a 20 20 20  RY_USED) >= .   
3ec0: 20 20 20 20 20 20 20 6d 65 6d 30 2e 61 6c 61 72         mem0.alar
3ed0: 6d 54 68 72 65 73 68 6f 6c 64 2d 6e 44 69 66 66  mThreshold-nDiff
3ee0: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   ){.      sqlite
3ef0: 33 4d 61 6c 6c 6f 63 41 6c 61 72 6d 28 6e 44 69  3MallocAlarm(nDi
3f00: 66 66 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61  ff);.    }.    a
3f10: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d 65  ssert( sqlite3Me
3f20: 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 70 4f  mdebugHasType(pO
3f30: 6c 64 2c 20 4d 45 4d 54 59 50 45 5f 48 45 41 50  ld, MEMTYPE_HEAP
3f40: 29 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28  ) );.    assert(
3f50: 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67   sqlite3Memdebug
3f60: 4e 6f 54 79 70 65 28 70 4f 6c 64 2c 20 7e 4d 45  NoType(pOld, ~ME
3f70: 4d 54 59 50 45 5f 48 45 41 50 29 20 29 3b 0a 20  MTYPE_HEAP) );. 
3f80: 20 20 20 70 4e 65 77 20 3d 20 73 71 6c 69 74 65     pNew = sqlite
3f90: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e  3GlobalConfig.m.
3fa0: 78 52 65 61 6c 6c 6f 63 28 70 4f 6c 64 2c 20 6e  xRealloc(pOld, n
3fb0: 4e 65 77 29 3b 0a 20 20 20 20 69 66 28 20 70 4e  New);.    if( pN
3fc0: 65 77 3d 3d 30 20 26 26 20 6d 65 6d 30 2e 61 6c  ew==0 && mem0.al
3fd0: 61 72 6d 43 61 6c 6c 62 61 63 6b 20 29 7b 0a 20  armCallback ){. 
3fe0: 20 20 20 20 20 73 71 6c 69 74 65 33 4d 61 6c 6c       sqlite3Mall
3ff0: 6f 63 41 6c 61 72 6d 28 6e 42 79 74 65 73 29 3b  ocAlarm(nBytes);
4000: 0a 20 20 20 20 20 20 70 4e 65 77 20 3d 20 73 71  .      pNew = sq
4010: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69  lite3GlobalConfi
4020: 67 2e 6d 2e 78 52 65 61 6c 6c 6f 63 28 70 4f 6c  g.m.xRealloc(pOl
4030: 64 2c 20 6e 4e 65 77 29 3b 0a 20 20 20 20 7d 0a  d, nNew);.    }.
4040: 20 20 20 20 69 66 28 20 70 4e 65 77 20 29 7b 0a      if( pNew ){.
4050: 20 20 20 20 20 20 6e 4e 65 77 20 3d 20 73 71 6c        nNew = sql
4060: 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70  ite3MallocSize(p
4070: 4e 65 77 29 3b 0a 20 20 20 20 20 20 73 71 6c 69  New);.      sqli
4080: 74 65 33 53 74 61 74 75 73 41 64 64 28 53 51 4c  te3StatusAdd(SQL
4090: 49 54 45 5f 53 54 41 54 55 53 5f 4d 45 4d 4f 52  ITE_STATUS_MEMOR
40a0: 59 5f 55 53 45 44 2c 20 6e 4e 65 77 2d 6e 4f 6c  Y_USED, nNew-nOl
40b0: 64 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71  d);.    }.    sq
40c0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76  lite3_mutex_leav
40d0: 65 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20  e(mem0.mutex);. 
40e0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 4e 65 77   }else{.    pNew
40f0: 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c   = sqlite3Global
4100: 43 6f 6e 66 69 67 2e 6d 2e 78 52 65 61 6c 6c 6f  Config.m.xReallo
4110: 63 28 70 4f 6c 64 2c 20 6e 4e 65 77 29 3b 0a 20  c(pOld, nNew);. 
4120: 20 7d 0a 20 20 61 73 73 65 72 74 28 20 45 49 47   }.  assert( EIG
4130: 48 54 5f 42 59 54 45 5f 41 4c 49 47 4e 4d 45 4e  HT_BYTE_ALIGNMEN
4140: 54 28 70 4e 65 77 29 20 29 3b 20 2f 2a 20 49 4d  T(pNew) ); /* IM
4150: 50 3a 20 52 2d 30 34 36 37 35 2d 34 34 38 35 30  P: R-04675-44850
4160: 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 70 4e 65   */.  return pNe
4170: 77 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20  w;.}../*.** The 
4180: 70 75 62 6c 69 63 20 69 6e 74 65 72 66 61 63 65  public interface
4190: 20 74 6f 20 73 71 6c 69 74 65 33 52 65 61 6c 6c   to sqlite3Reall
41a0: 6f 63 2e 20 20 4d 61 6b 65 20 73 75 72 65 20 74  oc.  Make sure t
41b0: 68 61 74 20 74 68 65 20 6d 65 6d 6f 72 79 0a 2a  hat the memory.*
41c0: 2a 20 73 75 62 73 79 73 74 65 6d 20 69 73 20 69  * subsystem is i
41d0: 6e 69 74 69 61 6c 69 7a 65 64 20 70 72 69 6f 72  nitialized prior
41e0: 20 74 6f 20 69 6e 76 6f 6b 69 6e 67 20 73 71 6c   to invoking sql
41f0: 69 74 65 52 65 61 6c 6c 6f 63 2e 0a 2a 2f 0a 76  iteRealloc..*/.v
4200: 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 72 65 61  oid *sqlite3_rea
4210: 6c 6c 6f 63 28 76 6f 69 64 20 2a 70 4f 6c 64 2c  lloc(void *pOld,
4220: 20 69 6e 74 20 6e 29 7b 0a 23 69 66 6e 64 65 66   int n){.#ifndef
4230: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54   SQLITE_OMIT_AUT
4240: 4f 49 4e 49 54 0a 20 20 69 66 28 20 73 71 6c 69  OINIT.  if( sqli
4250: 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29  te3_initialize()
4260: 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 23 65 6e   ) return 0;.#en
4270: 64 69 66 0a 20 20 72 65 74 75 72 6e 20 73 71 6c  dif.  return sql
4280: 69 74 65 33 52 65 61 6c 6c 6f 63 28 70 4f 6c 64  ite3Realloc(pOld
4290: 2c 20 6e 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20  , n);.}.../*.** 
42a0: 41 6c 6c 6f 63 61 74 65 20 61 6e 64 20 7a 65 72  Allocate and zer
42b0: 6f 20 6d 65 6d 6f 72 79 2e 0a 2a 2f 20 0a 76 6f  o memory..*/ .vo
42c0: 69 64 20 2a 73 71 6c 69 74 65 33 4d 61 6c 6c 6f  id *sqlite3Mallo
42d0: 63 5a 65 72 6f 28 69 6e 74 20 6e 29 7b 0a 20 20  cZero(int n){.  
42e0: 76 6f 69 64 20 2a 70 20 3d 20 73 71 6c 69 74 65  void *p = sqlite
42f0: 33 4d 61 6c 6c 6f 63 28 6e 29 3b 0a 20 20 69 66  3Malloc(n);.  if
4300: 28 20 70 20 29 7b 0a 20 20 20 20 6d 65 6d 73 65  ( p ){.    memse
4310: 74 28 70 2c 20 30 2c 20 6e 29 3b 0a 20 20 7d 0a  t(p, 0, n);.  }.
4320: 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 2f    return p;.}../
4330: 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 61 6e  *.** Allocate an
4340: 64 20 7a 65 72 6f 20 6d 65 6d 6f 72 79 2e 20 20  d zero memory.  
4350: 49 66 20 74 68 65 20 61 6c 6c 6f 63 61 74 69 6f  If the allocatio
4360: 6e 20 66 61 69 6c 73 2c 20 6d 61 6b 65 0a 2a 2a  n fails, make.**
4370: 20 74 68 65 20 6d 61 6c 6c 6f 63 46 61 69 6c 65   the mallocFaile
4380: 64 20 66 6c 61 67 20 69 6e 20 74 68 65 20 63 6f  d flag in the co
4390: 6e 6e 65 63 74 69 6f 6e 20 70 6f 69 6e 74 65 72  nnection pointer
43a0: 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74  ..*/.void *sqlit
43b0: 65 33 44 62 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73  e3DbMallocZero(s
43c0: 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20  qlite3 *db, int 
43d0: 6e 29 7b 0a 20 20 76 6f 69 64 20 2a 70 20 3d 20  n){.  void *p = 
43e0: 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 52  sqlite3DbMallocR
43f0: 61 77 28 64 62 2c 20 6e 29 3b 0a 20 20 69 66 28  aw(db, n);.  if(
4400: 20 70 20 29 7b 0a 20 20 20 20 6d 65 6d 73 65 74   p ){.    memset
4410: 28 70 2c 20 30 2c 20 6e 29 3b 0a 20 20 7d 0a 20  (p, 0, n);.  }. 
4420: 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 2f 2a   return p;.}../*
4430: 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 61 6e 64  .** Allocate and
4440: 20 7a 65 72 6f 20 6d 65 6d 6f 72 79 2e 20 20 49   zero memory.  I
4450: 66 20 74 68 65 20 61 6c 6c 6f 63 61 74 69 6f 6e  f the allocation
4460: 20 66 61 69 6c 73 2c 20 6d 61 6b 65 0a 2a 2a 20   fails, make.** 
4470: 74 68 65 20 6d 61 6c 6c 6f 63 46 61 69 6c 65 64  the mallocFailed
4480: 20 66 6c 61 67 20 69 6e 20 74 68 65 20 63 6f 6e   flag in the con
4490: 6e 65 63 74 69 6f 6e 20 70 6f 69 6e 74 65 72 2e  nection pointer.
44a0: 0a 2a 2a 0a 2a 2a 20 49 66 20 64 62 21 3d 30 20  .**.** If db!=0 
44b0: 61 6e 64 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61  and db->mallocFa
44c0: 69 6c 65 64 20 69 73 20 74 72 75 65 20 28 69 6e  iled is true (in
44d0: 64 69 63 61 74 69 6e 67 20 61 20 70 72 69 6f 72  dicating a prior
44e0: 20 6d 61 6c 6c 6f 63 0a 2a 2a 20 66 61 69 6c 75   malloc.** failu
44f0: 72 65 20 6f 6e 20 74 68 65 20 73 61 6d 65 20 64  re on the same d
4500: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69  atabase connecti
4510: 6f 6e 29 20 74 68 65 6e 20 61 6c 77 61 79 73 20  on) then always 
4520: 72 65 74 75 72 6e 20 30 2e 0a 2a 2a 20 48 65 6e  return 0..** Hen
4530: 63 65 20 66 6f 72 20 61 20 70 61 72 74 69 63 75  ce for a particu
4540: 6c 61 72 20 64 61 74 61 62 61 73 65 20 63 6f 6e  lar database con
4550: 6e 65 63 74 69 6f 6e 2c 20 6f 6e 63 65 20 6d 61  nection, once ma
4560: 6c 6c 6f 63 20 73 74 61 72 74 73 0a 2a 2a 20 66  lloc starts.** f
4570: 61 69 6c 69 6e 67 2c 20 69 74 20 66 61 69 6c 73  ailing, it fails
4580: 20 63 6f 6e 73 69 73 74 65 6e 74 6c 79 20 75 6e   consistently un
4590: 74 69 6c 20 6d 61 6c 6c 6f 63 46 61 69 6c 65 64  til mallocFailed
45a0: 20 69 73 20 72 65 73 65 74 2e 0a 2a 2a 20 54 68   is reset..** Th
45b0: 69 73 20 69 73 20 61 6e 20 69 6d 70 6f 72 74 61  is is an importa
45c0: 6e 74 20 61 73 73 75 6d 70 74 69 6f 6e 2e 20 20  nt assumption.  
45d0: 54 68 65 72 65 20 61 72 65 20 6d 61 6e 79 20 70  There are many p
45e0: 6c 61 63 65 73 20 69 6e 20 74 68 65 0a 2a 2a 20  laces in the.** 
45f0: 63 6f 64 65 20 74 68 61 74 20 64 6f 20 74 68 69  code that do thi
4600: 6e 67 73 20 6c 69 6b 65 20 74 68 69 73 3a 0a 2a  ngs like this:.*
4610: 2a 0a 2a 2a 20 20 20 20 20 20 20 20 20 69 6e 74  *.**         int
4620: 20 2a 61 20 3d 20 28 69 6e 74 2a 29 73 71 6c 69   *a = (int*)sqli
4630: 74 65 33 44 62 4d 61 6c 6c 6f 63 52 61 77 28 64  te3DbMallocRaw(d
4640: 62 2c 20 31 30 30 29 3b 0a 2a 2a 20 20 20 20 20  b, 100);.**     
4650: 20 20 20 20 69 6e 74 20 2a 62 20 3d 20 28 69 6e      int *b = (in
4660: 74 2a 29 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c  t*)sqlite3DbMall
4670: 6f 63 52 61 77 28 64 62 2c 20 32 30 30 29 3b 0a  ocRaw(db, 200);.
4680: 2a 2a 20 20 20 20 20 20 20 20 20 69 66 28 20 62  **         if( b
4690: 20 29 20 61 5b 31 30 5d 20 3d 20 39 3b 0a 2a 2a   ) a[10] = 9;.**
46a0: 0a 2a 2a 20 49 6e 20 6f 74 68 65 72 20 77 6f 72  .** In other wor
46b0: 64 73 2c 20 69 66 20 61 20 73 75 62 73 65 71 75  ds, if a subsequ
46c0: 65 6e 74 20 6d 61 6c 6c 6f 63 20 28 65 78 3a 20  ent malloc (ex: 
46d0: 22 62 22 29 20 77 6f 72 6b 65 64 2c 20 69 74 20  "b") worked, it 
46e0: 69 73 20 61 73 73 75 6d 65 64 0a 2a 2a 20 74 68  is assumed.** th
46f0: 61 74 20 61 6c 6c 20 70 72 69 6f 72 20 6d 61 6c  at all prior mal
4700: 6c 6f 63 73 20 28 65 78 3a 20 22 61 22 29 20 77  locs (ex: "a") w
4710: 6f 72 6b 65 64 20 74 6f 6f 2e 0a 2a 2f 0a 76 6f  orked too..*/.vo
4720: 69 64 20 2a 73 71 6c 69 74 65 33 44 62 4d 61 6c  id *sqlite3DbMal
4730: 6c 6f 63 52 61 77 28 73 71 6c 69 74 65 33 20 2a  locRaw(sqlite3 *
4740: 64 62 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 76 6f  db, int n){.  vo
4750: 69 64 20 2a 70 3b 0a 20 20 61 73 73 65 72 74 28  id *p;.  assert(
4760: 20 64 62 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65   db==0 || sqlite
4770: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d  3_mutex_held(db-
4780: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73  >mutex) );.  ass
4790: 65 72 74 28 20 64 62 3d 3d 30 20 7c 7c 20 64 62  ert( db==0 || db
47a0: 2d 3e 70 6e 42 79 74 65 73 46 72 65 65 64 3d 3d  ->pnBytesFreed==
47b0: 30 20 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c  0 );.#ifndef SQL
47c0: 49 54 45 5f 4f 4d 49 54 5f 4c 4f 4f 4b 41 53 49  ITE_OMIT_LOOKASI
47d0: 44 45 0a 20 20 69 66 28 20 64 62 20 29 7b 0a 20  DE.  if( db ){. 
47e0: 20 20 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74     LookasideSlot
47f0: 20 2a 70 42 75 66 3b 0a 20 20 20 20 69 66 28 20   *pBuf;.    if( 
4800: 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64  db->mallocFailed
4810: 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e   ){.      return
4820: 20 30 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66   0;.    }.    if
4830: 28 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e  ( db->lookaside.
4840: 62 45 6e 61 62 6c 65 64 20 29 7b 0a 20 20 20 20  bEnabled ){.    
4850: 20 20 69 66 28 20 6e 3e 64 62 2d 3e 6c 6f 6f 6b    if( n>db->look
4860: 61 73 69 64 65 2e 73 7a 20 29 7b 0a 20 20 20 20  aside.sz ){.    
4870: 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64      db->lookasid
4880: 65 2e 61 6e 53 74 61 74 5b 31 5d 2b 2b 3b 0a 20  e.anStat[1]++;. 
4890: 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 28       }else if( (
48a0: 70 42 75 66 20 3d 20 64 62 2d 3e 6c 6f 6f 6b 61  pBuf = db->looka
48b0: 73 69 64 65 2e 70 46 72 65 65 29 3d 3d 30 20 29  side.pFree)==0 )
48c0: 7b 0a 20 20 20 20 20 20 20 20 64 62 2d 3e 6c 6f  {.        db->lo
48d0: 6f 6b 61 73 69 64 65 2e 61 6e 53 74 61 74 5b 32  okaside.anStat[2
48e0: 5d 2b 2b 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65  ]++;.      }else
48f0: 7b 0a 20 20 20 20 20 20 20 20 64 62 2d 3e 6c 6f  {.        db->lo
4900: 6f 6b 61 73 69 64 65 2e 70 46 72 65 65 20 3d 20  okaside.pFree = 
4910: 70 42 75 66 2d 3e 70 4e 65 78 74 3b 0a 20 20 20  pBuf->pNext;.   
4920: 20 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69       db->lookasi
4930: 64 65 2e 6e 4f 75 74 2b 2b 3b 0a 20 20 20 20 20  de.nOut++;.     
4940: 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65     db->lookaside
4950: 2e 61 6e 53 74 61 74 5b 30 5d 2b 2b 3b 0a 20 20  .anStat[0]++;.  
4960: 20 20 20 20 20 20 69 66 28 20 64 62 2d 3e 6c 6f        if( db->lo
4970: 6f 6b 61 73 69 64 65 2e 6e 4f 75 74 3e 64 62 2d  okaside.nOut>db-
4980: 3e 6c 6f 6f 6b 61 73 69 64 65 2e 6d 78 4f 75 74  >lookaside.mxOut
4990: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 64 62   ){.          db
49a0: 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 6d 78 4f 75  ->lookaside.mxOu
49b0: 74 20 3d 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64  t = db->lookasid
49c0: 65 2e 6e 4f 75 74 3b 0a 20 20 20 20 20 20 20 20  e.nOut;.        
49d0: 7d 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e  }.        return
49e0: 20 28 76 6f 69 64 2a 29 70 42 75 66 3b 0a 20 20   (void*)pBuf;.  
49f0: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a      }.    }.  }.
4a00: 23 65 6c 73 65 0a 20 20 69 66 28 20 64 62 20 26  #else.  if( db &
4a10: 26 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c  & db->mallocFail
4a20: 65 64 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  ed ){.    return
4a30: 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20   0;.  }.#endif. 
4a40: 20 70 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c   p = sqlite3Mall
4a50: 6f 63 28 6e 29 3b 0a 20 20 69 66 28 20 21 70 20  oc(n);.  if( !p 
4a60: 26 26 20 64 62 20 29 7b 0a 20 20 20 20 64 62 2d  && db ){.    db-
4a70: 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 3d 20  >mallocFailed = 
4a80: 31 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33  1;.  }.  sqlite3
4a90: 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 28  MemdebugSetType(
4aa0: 70 2c 20 4d 45 4d 54 59 50 45 5f 44 42 20 7c 0a  p, MEMTYPE_DB |.
4ab0: 20 20 20 20 20 20 20 20 20 28 28 64 62 20 26 26           ((db &&
4ac0: 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62   db->lookaside.b
4ad0: 45 6e 61 62 6c 65 64 29 20 3f 20 4d 45 4d 54 59  Enabled) ? MEMTY
4ae0: 50 45 5f 4c 4f 4f 4b 41 53 49 44 45 20 3a 20 4d  PE_LOOKASIDE : M
4af0: 45 4d 54 59 50 45 5f 48 45 41 50 29 29 3b 0a 20  EMTYPE_HEAP));. 
4b00: 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 2f 2a   return p;.}../*
4b10: 0a 2a 2a 20 52 65 73 69 7a 65 20 74 68 65 20 62  .** Resize the b
4b20: 6c 6f 63 6b 20 6f 66 20 6d 65 6d 6f 72 79 20 70  lock of memory p
4b30: 6f 69 6e 74 65 64 20 74 6f 20 62 79 20 70 20 74  ointed to by p t
4b40: 6f 20 6e 20 62 79 74 65 73 2e 20 49 66 20 74 68  o n bytes. If th
4b50: 65 0a 2a 2a 20 72 65 73 69 7a 65 20 66 61 69 6c  e.** resize fail
4b60: 73 2c 20 73 65 74 20 74 68 65 20 6d 61 6c 6c 6f  s, set the mallo
4b70: 63 46 61 69 6c 65 64 20 66 6c 61 67 20 69 6e 20  cFailed flag in 
4b80: 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6f  the connection o
4b90: 62 6a 65 63 74 2e 0a 2a 2f 0a 76 6f 69 64 20 2a  bject..*/.void *
4ba0: 73 71 6c 69 74 65 33 44 62 52 65 61 6c 6c 6f 63  sqlite3DbRealloc
4bb0: 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 76 6f  (sqlite3 *db, vo
4bc0: 69 64 20 2a 70 2c 20 69 6e 74 20 6e 29 7b 0a 20  id *p, int n){. 
4bd0: 20 76 6f 69 64 20 2a 70 4e 65 77 20 3d 20 30 3b   void *pNew = 0;
4be0: 0a 20 20 61 73 73 65 72 74 28 20 64 62 21 3d 30  .  assert( db!=0
4bf0: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71   );.  assert( sq
4c00: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64  lite3_mutex_held
4c10: 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20  (db->mutex) );. 
4c20: 20 69 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46   if( db->mallocF
4c30: 61 69 6c 65 64 3d 3d 30 20 29 7b 0a 20 20 20 20  ailed==0 ){.    
4c40: 69 66 28 20 70 3d 3d 30 20 29 7b 0a 20 20 20 20  if( p==0 ){.    
4c50: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33    return sqlite3
4c60: 44 62 4d 61 6c 6c 6f 63 52 61 77 28 64 62 2c 20  DbMallocRaw(db, 
4c70: 6e 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66  n);.    }.    if
4c80: 28 20 69 73 4c 6f 6f 6b 61 73 69 64 65 28 64 62  ( isLookaside(db
4c90: 2c 20 70 29 20 29 7b 0a 20 20 20 20 20 20 69 66  , p) ){.      if
4ca0: 28 20 6e 3c 3d 64 62 2d 3e 6c 6f 6f 6b 61 73 69  ( n<=db->lookasi
4cb0: 64 65 2e 73 7a 20 29 7b 0a 20 20 20 20 20 20 20  de.sz ){.       
4cc0: 20 72 65 74 75 72 6e 20 70 3b 0a 20 20 20 20 20   return p;.     
4cd0: 20 7d 0a 20 20 20 20 20 20 70 4e 65 77 20 3d 20   }.      pNew = 
4ce0: 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 52  sqlite3DbMallocR
4cf0: 61 77 28 64 62 2c 20 6e 29 3b 0a 20 20 20 20 20  aw(db, n);.     
4d00: 20 69 66 28 20 70 4e 65 77 20 29 7b 0a 20 20 20   if( pNew ){.   
4d10: 20 20 20 20 20 6d 65 6d 63 70 79 28 70 4e 65 77       memcpy(pNew
4d20: 2c 20 70 2c 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69  , p, db->lookasi
4d30: 64 65 2e 73 7a 29 3b 0a 20 20 20 20 20 20 20 20  de.sz);.        
4d40: 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62  sqlite3DbFree(db
4d50: 2c 20 70 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20  , p);.      }.  
4d60: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 61    }else{.      a
4d70: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d 65  ssert( sqlite3Me
4d80: 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 70 2c  mdebugHasType(p,
4d90: 20 4d 45 4d 54 59 50 45 5f 44 42 29 20 29 3b 0a   MEMTYPE_DB) );.
4da0: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 73 71        assert( sq
4db0: 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 48 61 73  lite3MemdebugHas
4dc0: 54 79 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f  Type(p, MEMTYPE_
4dd0: 4c 4f 4f 4b 41 53 49 44 45 7c 4d 45 4d 54 59 50  LOOKASIDE|MEMTYP
4de0: 45 5f 48 45 41 50 29 20 29 3b 0a 20 20 20 20 20  E_HEAP) );.     
4df0: 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67   sqlite3Memdebug
4e00: 53 65 74 54 79 70 65 28 70 2c 20 4d 45 4d 54 59  SetType(p, MEMTY
4e10: 50 45 5f 48 45 41 50 29 3b 0a 20 20 20 20 20 20  PE_HEAP);.      
4e20: 70 4e 65 77 20 3d 20 73 71 6c 69 74 65 33 5f 72  pNew = sqlite3_r
4e30: 65 61 6c 6c 6f 63 28 70 2c 20 6e 29 3b 0a 20 20  ealloc(p, n);.  
4e40: 20 20 20 20 69 66 28 20 21 70 4e 65 77 20 29 7b      if( !pNew ){
4e50: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  .        sqlite3
4e60: 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 28  MemdebugSetType(
4e70: 70 2c 20 4d 45 4d 54 59 50 45 5f 44 42 7c 4d 45  p, MEMTYPE_DB|ME
4e80: 4d 54 59 50 45 5f 48 45 41 50 29 3b 0a 20 20 20  MTYPE_HEAP);.   
4e90: 20 20 20 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46       db->mallocF
4ea0: 61 69 6c 65 64 20 3d 20 31 3b 0a 20 20 20 20 20  ailed = 1;.     
4eb0: 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33   }.      sqlite3
4ec0: 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 28  MemdebugSetType(
4ed0: 70 4e 65 77 2c 20 4d 45 4d 54 59 50 45 5f 44 42  pNew, MEMTYPE_DB
4ee0: 20 7c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20   | .            
4ef0: 28 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62  (db->lookaside.b
4f00: 45 6e 61 62 6c 65 64 20 3f 20 4d 45 4d 54 59 50  Enabled ? MEMTYP
4f10: 45 5f 4c 4f 4f 4b 41 53 49 44 45 20 3a 20 4d 45  E_LOOKASIDE : ME
4f20: 4d 54 59 50 45 5f 48 45 41 50 29 29 3b 0a 20 20  MTYPE_HEAP));.  
4f30: 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e    }.  }.  return
4f40: 20 70 4e 65 77 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20   pNew;.}../*.** 
4f50: 41 74 74 65 6d 70 74 20 74 6f 20 72 65 61 6c 6c  Attempt to reall
4f60: 6f 63 61 74 65 20 70 2e 20 20 49 66 20 74 68 65  ocate p.  If the
4f70: 20 72 65 61 6c 6c 6f 63 61 74 69 6f 6e 20 66 61   reallocation fa
4f80: 69 6c 73 2c 20 74 68 65 6e 20 66 72 65 65 20 70  ils, then free p
4f90: 0a 2a 2a 20 61 6e 64 20 73 65 74 20 74 68 65 20  .** and set the 
4fa0: 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 66 6c 61  mallocFailed fla
4fb0: 67 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73  g in the databas
4fc0: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f  e connection..*/
4fd0: 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 44 62  .void *sqlite3Db
4fe0: 52 65 61 6c 6c 6f 63 4f 72 46 72 65 65 28 73 71  ReallocOrFree(sq
4ff0: 6c 69 74 65 33 20 2a 64 62 2c 20 76 6f 69 64 20  lite3 *db, void 
5000: 2a 70 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 76 6f  *p, int n){.  vo
5010: 69 64 20 2a 70 4e 65 77 3b 0a 20 20 70 4e 65 77  id *pNew;.  pNew
5020: 20 3d 20 73 71 6c 69 74 65 33 44 62 52 65 61 6c   = sqlite3DbReal
5030: 6c 6f 63 28 64 62 2c 20 70 2c 20 6e 29 3b 0a 20  loc(db, p, n);. 
5040: 20 69 66 28 20 21 70 4e 65 77 20 29 7b 0a 20 20   if( !pNew ){.  
5050: 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28    sqlite3DbFree(
5060: 64 62 2c 20 70 29 3b 0a 20 20 7d 0a 20 20 72 65  db, p);.  }.  re
5070: 74 75 72 6e 20 70 4e 65 77 3b 0a 7d 0a 0a 2f 2a  turn pNew;.}../*
5080: 0a 2a 2a 20 4d 61 6b 65 20 61 20 63 6f 70 79 20  .** Make a copy 
5090: 6f 66 20 61 20 73 74 72 69 6e 67 20 69 6e 20 6d  of a string in m
50a0: 65 6d 6f 72 79 20 6f 62 74 61 69 6e 65 64 20 66  emory obtained f
50b0: 72 6f 6d 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63  rom sqliteMalloc
50c0: 28 29 2e 20 54 68 65 73 65 20 0a 2a 2a 20 66 75  (). These .** fu
50d0: 6e 63 74 69 6f 6e 73 20 63 61 6c 6c 20 73 71 6c  nctions call sql
50e0: 69 74 65 33 4d 61 6c 6c 6f 63 52 61 77 28 29 20  ite3MallocRaw() 
50f0: 64 69 72 65 63 74 6c 79 20 69 6e 73 74 65 61 64  directly instead
5100: 20 6f 66 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63   of sqliteMalloc
5110: 28 29 2e 20 54 68 69 73 0a 2a 2a 20 69 73 20 62  (). This.** is b
5120: 65 63 61 75 73 65 20 77 68 65 6e 20 6d 65 6d 6f  ecause when memo
5130: 72 79 20 64 65 62 75 67 67 69 6e 67 20 69 73 20  ry debugging is 
5140: 74 75 72 6e 65 64 20 6f 6e 2c 20 74 68 65 73 65  turned on, these
5150: 20 74 77 6f 20 66 75 6e 63 74 69 6f 6e 73 20 61   two functions a
5160: 72 65 20 0a 2a 2a 20 63 61 6c 6c 65 64 20 76 69  re .** called vi
5170: 61 20 6d 61 63 72 6f 73 20 74 68 61 74 20 72 65  a macros that re
5180: 63 6f 72 64 20 74 68 65 20 63 75 72 72 65 6e 74  cord the current
5190: 20 66 69 6c 65 20 61 6e 64 20 6c 69 6e 65 20 6e   file and line n
51a0: 75 6d 62 65 72 20 69 6e 20 74 68 65 0a 2a 2a 20  umber in the.** 
51b0: 54 68 72 65 61 64 44 61 74 61 20 73 74 72 75 63  ThreadData struc
51c0: 74 75 72 65 2e 0a 2a 2f 0a 63 68 61 72 20 2a 73  ture..*/.char *s
51d0: 71 6c 69 74 65 33 44 62 53 74 72 44 75 70 28 73  qlite3DbStrDup(s
51e0: 71 6c 69 74 65 33 20 2a 64 62 2c 20 63 6f 6e 73  qlite3 *db, cons
51f0: 74 20 63 68 61 72 20 2a 7a 29 7b 0a 20 20 63 68  t char *z){.  ch
5200: 61 72 20 2a 7a 4e 65 77 3b 0a 20 20 73 69 7a 65  ar *zNew;.  size
5210: 5f 74 20 6e 3b 0a 20 20 69 66 28 20 7a 3d 3d 30  _t n;.  if( z==0
5220: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30   ){.    return 0
5230: 3b 0a 20 20 7d 0a 20 20 6e 20 3d 20 73 71 6c 69  ;.  }.  n = sqli
5240: 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 29 20 2b  te3Strlen30(z) +
5250: 20 31 3b 0a 20 20 61 73 73 65 72 74 28 20 28 6e   1;.  assert( (n
5260: 26 30 78 37 66 66 66 66 66 66 66 29 3d 3d 6e 20  &0x7fffffff)==n 
5270: 29 3b 0a 20 20 7a 4e 65 77 20 3d 20 73 71 6c 69  );.  zNew = sqli
5280: 74 65 33 44 62 4d 61 6c 6c 6f 63 52 61 77 28 64  te3DbMallocRaw(d
5290: 62 2c 20 28 69 6e 74 29 6e 29 3b 0a 20 20 69 66  b, (int)n);.  if
52a0: 28 20 7a 4e 65 77 20 29 7b 0a 20 20 20 20 6d 65  ( zNew ){.    me
52b0: 6d 63 70 79 28 7a 4e 65 77 2c 20 7a 2c 20 6e 29  mcpy(zNew, z, n)
52c0: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 7a  ;.  }.  return z
52d0: 4e 65 77 3b 0a 7d 0a 63 68 61 72 20 2a 73 71 6c  New;.}.char *sql
52e0: 69 74 65 33 44 62 53 74 72 4e 44 75 70 28 73 71  ite3DbStrNDup(sq
52f0: 6c 69 74 65 33 20 2a 64 62 2c 20 63 6f 6e 73 74  lite3 *db, const
5300: 20 63 68 61 72 20 2a 7a 2c 20 69 6e 74 20 6e 29   char *z, int n)
5310: 7b 0a 20 20 63 68 61 72 20 2a 7a 4e 65 77 3b 0a  {.  char *zNew;.
5320: 20 20 69 66 28 20 7a 3d 3d 30 20 29 7b 0a 20 20    if( z==0 ){.  
5330: 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a    return 0;.  }.
5340: 20 20 61 73 73 65 72 74 28 20 28 6e 26 30 78 37    assert( (n&0x7
5350: 66 66 66 66 66 66 66 29 3d 3d 6e 20 29 3b 0a 20  fffffff)==n );. 
5360: 20 7a 4e 65 77 20 3d 20 73 71 6c 69 74 65 33 44   zNew = sqlite3D
5370: 62 4d 61 6c 6c 6f 63 52 61 77 28 64 62 2c 20 6e  bMallocRaw(db, n
5380: 2b 31 29 3b 0a 20 20 69 66 28 20 7a 4e 65 77 20  +1);.  if( zNew 
5390: 29 7b 0a 20 20 20 20 6d 65 6d 63 70 79 28 7a 4e  ){.    memcpy(zN
53a0: 65 77 2c 20 7a 2c 20 6e 29 3b 0a 20 20 20 20 7a  ew, z, n);.    z
53b0: 4e 65 77 5b 6e 5d 20 3d 20 30 3b 0a 20 20 7d 0a  New[n] = 0;.  }.
53c0: 20 20 72 65 74 75 72 6e 20 7a 4e 65 77 3b 0a 7d    return zNew;.}
53d0: 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61  ../*.** Create a
53e0: 20 73 74 72 69 6e 67 20 66 72 6f 6d 20 74 68 65   string from the
53f0: 20 7a 46 72 6f 6d 61 74 20 61 72 67 75 6d 65 6e   zFromat argumen
5400: 74 20 61 6e 64 20 74 68 65 20 76 61 5f 6c 69 73  t and the va_lis
5410: 74 20 74 68 61 74 20 66 6f 6c 6c 6f 77 73 2e 0a  t that follows..
5420: 2a 2a 20 53 74 6f 72 65 20 74 68 65 20 73 74 72  ** Store the str
5430: 69 6e 67 20 69 6e 20 6d 65 6d 6f 72 79 20 6f 62  ing in memory ob
5440: 74 61 69 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69  tained from sqli
5450: 74 65 4d 61 6c 6c 6f 63 28 29 20 61 6e 64 20 6d  teMalloc() and m
5460: 61 6b 65 20 2a 70 7a 0a 2a 2a 20 70 6f 69 6e 74  ake *pz.** point
5470: 20 74 6f 20 74 68 61 74 20 73 74 72 69 6e 67 2e   to that string.
5480: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
5490: 53 65 74 53 74 72 69 6e 67 28 63 68 61 72 20 2a  SetString(char *
54a0: 2a 70 7a 2c 20 73 71 6c 69 74 65 33 20 2a 64 62  *pz, sqlite3 *db
54b0: 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46  , const char *zF
54c0: 6f 72 6d 61 74 2c 20 2e 2e 2e 29 7b 0a 20 20 76  ormat, ...){.  v
54d0: 61 5f 6c 69 73 74 20 61 70 3b 0a 20 20 63 68 61  a_list ap;.  cha
54e0: 72 20 2a 7a 3b 0a 0a 20 20 76 61 5f 73 74 61 72  r *z;..  va_star
54f0: 74 28 61 70 2c 20 7a 46 6f 72 6d 61 74 29 3b 0a  t(ap, zFormat);.
5500: 20 20 7a 20 3d 20 73 71 6c 69 74 65 33 56 4d 50    z = sqlite3VMP
5510: 72 69 6e 74 66 28 64 62 2c 20 7a 46 6f 72 6d 61  rintf(db, zForma
5520: 74 2c 20 61 70 29 3b 0a 20 20 76 61 5f 65 6e 64  t, ap);.  va_end
5530: 28 61 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 44  (ap);.  sqlite3D
5540: 62 46 72 65 65 28 64 62 2c 20 2a 70 7a 29 3b 0a  bFree(db, *pz);.
5550: 20 20 2a 70 7a 20 3d 20 7a 3b 0a 7d 0a 0a 0a 2f    *pz = z;.}.../
5560: 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69  *.** This functi
5570: 6f 6e 20 6d 75 73 74 20 62 65 20 63 61 6c 6c 65  on must be calle
5580: 64 20 62 65 66 6f 72 65 20 65 78 69 74 69 6e 67  d before exiting
5590: 20 61 6e 79 20 41 50 49 20 66 75 6e 63 74 69 6f   any API functio
55a0: 6e 20 28 69 2e 65 2e 20 0a 2a 2a 20 72 65 74 75  n (i.e. .** retu
55b0: 72 6e 69 6e 67 20 63 6f 6e 74 72 6f 6c 20 74 6f  rning control to
55c0: 20 74 68 65 20 75 73 65 72 29 20 74 68 61 74 20   the user) that 
55d0: 68 61 73 20 63 61 6c 6c 65 64 20 73 71 6c 69 74  has called sqlit
55e0: 65 33 5f 6d 61 6c 6c 6f 63 20 6f 72 0a 2a 2a 20  e3_malloc or.** 
55f0: 73 71 6c 69 74 65 33 5f 72 65 61 6c 6c 6f 63 2e  sqlite3_realloc.
5600: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 72 65 74 75 72  .**.** The retur
5610: 6e 65 64 20 76 61 6c 75 65 20 69 73 20 6e 6f 72  ned value is nor
5620: 6d 61 6c 6c 79 20 61 20 63 6f 70 79 20 6f 66 20  mally a copy of 
5630: 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d  the second argum
5640: 65 6e 74 20 74 6f 20 74 68 69 73 0a 2a 2a 20 66  ent to this.** f
5650: 75 6e 63 74 69 6f 6e 2e 20 48 6f 77 65 76 65 72  unction. However
5660: 2c 20 69 66 20 61 20 6d 61 6c 6c 6f 63 28 29 20  , if a malloc() 
5670: 66 61 69 6c 75 72 65 20 68 61 73 20 6f 63 63 75  failure has occu
5680: 72 72 65 64 20 73 69 6e 63 65 20 74 68 65 20 70  rred since the p
5690: 72 65 76 69 6f 75 73 0a 2a 2a 20 69 6e 76 6f 63  revious.** invoc
56a0: 61 74 69 6f 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d  ation SQLITE_NOM
56b0: 45 4d 20 69 73 20 72 65 74 75 72 6e 65 64 20 69  EM is returned i
56c0: 6e 73 74 65 61 64 2e 20 0a 2a 2a 0a 2a 2a 20 49  nstead. .**.** I
56d0: 66 20 74 68 65 20 66 69 72 73 74 20 61 72 67 75  f the first argu
56e0: 6d 65 6e 74 2c 20 64 62 2c 20 69 73 20 6e 6f 74  ment, db, is not
56f0: 20 4e 55 4c 4c 20 61 6e 64 20 61 20 6d 61 6c 6c   NULL and a mall
5700: 6f 63 28 29 20 65 72 72 6f 72 20 68 61 73 20 6f  oc() error has o
5710: 63 63 75 72 72 65 64 2c 0a 2a 2a 20 74 68 65 6e  ccurred,.** then
5720: 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20   the connection 
5730: 65 72 72 6f 72 2d 63 6f 64 65 20 28 74 68 65 20  error-code (the 
5740: 76 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 62  value returned b
5750: 79 20 73 71 6c 69 74 65 33 5f 65 72 72 63 6f 64  y sqlite3_errcod
5760: 65 28 29 29 0a 2a 2a 20 69 73 20 73 65 74 20 74  e()).** is set t
5770: 6f 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 2e 0a  o SQLITE_NOMEM..
5780: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 41 70  */.int sqlite3Ap
5790: 69 45 78 69 74 28 73 71 6c 69 74 65 33 2a 20 64  iExit(sqlite3* d
57a0: 62 2c 20 69 6e 74 20 72 63 29 7b 0a 20 20 2f 2a  b, int rc){.  /*
57b0: 20 49 66 20 74 68 65 20 64 62 20 68 61 6e 64 6c   If the db handl
57c0: 65 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74  e is not NULL, t
57d0: 68 65 6e 20 77 65 20 6d 75 73 74 20 68 6f 6c 64  hen we must hold
57e0: 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20   the connection 
57f0: 68 61 6e 64 6c 65 0a 20 20 2a 2a 20 6d 75 74 65  handle.  ** mute
5800: 78 20 68 65 72 65 2e 20 4f 74 68 65 72 77 69 73  x here. Otherwis
5810: 65 20 74 68 65 20 72 65 61 64 20 28 61 6e 64 20  e the read (and 
5820: 70 6f 73 73 69 62 6c 65 20 77 72 69 74 65 29 20  possible write) 
5830: 6f 66 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69  of db->mallocFai
5840: 6c 65 64 20 0a 20 20 2a 2a 20 69 73 20 75 6e 73  led .  ** is uns
5850: 61 66 65 2c 20 61 73 20 69 73 20 74 68 65 20 63  afe, as is the c
5860: 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 45 72  all to sqlite3Er
5870: 72 6f 72 28 29 2e 0a 20 20 2a 2f 0a 20 20 61 73  ror()..  */.  as
5880: 73 65 72 74 28 20 21 64 62 20 7c 7c 20 73 71 6c  sert( !db || sql
5890: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28  ite3_mutex_held(
58a0: 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20  db->mutex) );.  
58b0: 69 66 28 20 64 62 20 26 26 20 28 64 62 2d 3e 6d  if( db && (db->m
58c0: 61 6c 6c 6f 63 46 61 69 6c 65 64 20 7c 7c 20 72  allocFailed || r
58d0: 63 3d 3d 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f  c==SQLITE_IOERR_
58e0: 4e 4f 4d 45 4d 29 20 29 7b 0a 20 20 20 20 73 71  NOMEM) ){.    sq
58f0: 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53  lite3Error(db, S
5900: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 2c 20 30 29 3b  QLITE_NOMEM, 0);
5910: 0a 20 20 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46  .    db->mallocF
5920: 61 69 6c 65 64 20 3d 20 30 3b 0a 20 20 20 20 72  ailed = 0;.    r
5930: 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  c = SQLITE_NOMEM
5940: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72  ;.  }.  return r
5950: 63 20 26 20 28 64 62 20 3f 20 64 62 2d 3e 65 72  c & (db ? db->er
5960: 72 4d 61 73 6b 20 3a 20 30 78 66 66 29 3b 0a 7d  rMask : 0xff);.}
5970: 0a                                               .