/ Hex Artifact Content
Login

Artifact 6bd9604ef98b253fe607f6e8357e003511665a2488dd76f385784f628c53b05c:


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 20 20 73 71 6c 69  access */.  sqli
0590: 74 65 33 5f 69 6e 74 36 34 20 61 6c 61 72 6d 54  te3_int64 alarmT
05a0: 68 72 65 73 68 6f 6c 64 3b 20 2f 2a 20 54 68 65  hreshold; /* The
05b0: 20 73 6f 66 74 20 68 65 61 70 20 6c 69 6d 69 74   soft heap limit
05c0: 20 2a 2f 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 50   */..  /*.  ** P
05d0: 6f 69 6e 74 65 72 73 20 74 6f 20 74 68 65 20 65  ointers to the e
05e0: 6e 64 20 6f 66 20 73 71 6c 69 74 65 33 47 6c 6f  nd of sqlite3Glo
05f0: 62 61 6c 43 6f 6e 66 69 67 2e 70 53 63 72 61 74  balConfig.pScrat
0600: 63 68 20 6d 65 6d 6f 72 79 0a 20 20 2a 2a 20 28  ch memory.  ** (
0610: 73 6f 20 74 68 61 74 20 61 20 72 61 6e 67 65 20  so that a range 
0620: 74 65 73 74 20 63 61 6e 20 62 65 20 75 73 65 64  test can be used
0630: 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 69 66   to determine if
0640: 20 61 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e 0a 20   an allocation. 
0650: 20 2a 2a 20 62 65 69 6e 67 20 66 72 65 65 64 20   ** being freed 
0660: 63 61 6d 65 20 66 72 6f 6d 20 70 53 63 72 61 74  came from pScrat
0670: 63 68 29 20 61 6e 64 20 61 20 70 6f 69 6e 74 65  ch) and a pointe
0680: 72 20 74 6f 20 74 68 65 20 6c 69 73 74 20 6f 66  r to the list of
0690: 0a 20 20 2a 2a 20 75 6e 75 73 65 64 20 73 63 72  .  ** unused scr
06a0: 61 74 63 68 20 61 6c 6c 6f 63 61 74 69 6f 6e 73  atch allocations
06b0: 2e 0a 20 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70  ..  */.  void *p
06c0: 53 63 72 61 74 63 68 45 6e 64 3b 0a 20 20 53 63  ScratchEnd;.  Sc
06d0: 72 61 74 63 68 46 72 65 65 73 6c 6f 74 20 2a 70  ratchFreeslot *p
06e0: 53 63 72 61 74 63 68 46 72 65 65 3b 0a 20 20 75  ScratchFree;.  u
06f0: 33 32 20 6e 53 63 72 61 74 63 68 46 72 65 65 3b  32 nScratchFree;
0700: 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54 72 75 65  ..  /*.  ** True
0710: 20 69 66 20 68 65 61 70 20 69 73 20 6e 65 61 72   if heap is near
0720: 6c 79 20 22 66 75 6c 6c 22 20 77 68 65 72 65 20  ly "full" where 
0730: 22 66 75 6c 6c 22 20 69 73 20 64 65 66 69 6e 65  "full" is define
0740: 64 20 62 79 20 74 68 65 0a 20 20 2a 2a 20 73 71  d by the.  ** sq
0750: 6c 69 74 65 33 5f 73 6f 66 74 5f 68 65 61 70 5f  lite3_soft_heap_
0760: 6c 69 6d 69 74 28 29 20 73 65 74 74 69 6e 67 2e  limit() setting.
0770: 0a 20 20 2a 2f 0a 20 20 69 6e 74 20 6e 65 61 72  .  */.  int near
0780: 6c 79 46 75 6c 6c 3b 0a 7d 20 6d 65 6d 30 20 3d  lyFull;.} mem0 =
0790: 20 7b 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30   { 0, 0, 0, 0, 0
07a0: 2c 20 30 20 7d 3b 0a 0a 23 64 65 66 69 6e 65 20  , 0 };..#define 
07b0: 6d 65 6d 30 20 47 4c 4f 42 41 4c 28 73 74 72 75  mem0 GLOBAL(stru
07c0: 63 74 20 4d 65 6d 30 47 6c 6f 62 61 6c 2c 20 6d  ct Mem0Global, m
07d0: 65 6d 30 29 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  em0)../*.** Retu
07e0: 72 6e 20 74 68 65 20 6d 65 6d 6f 72 79 20 61 6c  rn the memory al
07f0: 6c 6f 63 61 74 6f 72 20 6d 75 74 65 78 2e 20 73  locator mutex. s
0800: 71 6c 69 74 65 33 5f 73 74 61 74 75 73 28 29 20  qlite3_status() 
0810: 6e 65 65 64 73 20 69 74 2e 0a 2a 2f 0a 73 71 6c  needs it..*/.sql
0820: 69 74 65 33 5f 6d 75 74 65 78 20 2a 73 71 6c 69  ite3_mutex *sqli
0830: 74 65 33 4d 61 6c 6c 6f 63 4d 75 74 65 78 28 76  te3MallocMutex(v
0840: 6f 69 64 29 7b 0a 20 20 72 65 74 75 72 6e 20 6d  oid){.  return m
0850: 65 6d 30 2e 6d 75 74 65 78 3b 0a 7d 0a 0a 23 69  em0.mutex;.}..#i
0860: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
0870: 54 5f 44 45 50 52 45 43 41 54 45 44 0a 2f 2a 0a  T_DEPRECATED./*.
0880: 2a 2a 20 44 65 70 72 65 63 61 74 65 64 20 65 78  ** Deprecated ex
0890: 74 65 72 6e 61 6c 20 69 6e 74 65 72 66 61 63 65  ternal interface
08a0: 2e 20 20 49 74 20 75 73 65 64 20 74 6f 20 73 65  .  It used to se
08b0: 74 20 61 6e 20 61 6c 61 72 6d 20 63 61 6c 6c 62  t an alarm callb
08c0: 61 63 6b 0a 2a 2a 20 74 68 61 74 20 77 61 73 20  ack.** that was 
08d0: 69 6e 76 6f 6b 65 64 20 77 68 65 6e 20 6d 65 6d  invoked when mem
08e0: 6f 72 79 20 75 73 61 67 65 20 67 72 65 77 20 74  ory usage grew t
08f0: 6f 6f 20 6c 61 72 67 65 2e 20 20 4e 6f 77 20 69  oo large.  Now i
0900: 74 20 69 73 20 61 0a 2a 2a 20 6e 6f 2d 6f 70 2e  t is a.** no-op.
0910: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  .*/.int sqlite3_
0920: 6d 65 6d 6f 72 79 5f 61 6c 61 72 6d 28 0a 20 20  memory_alarm(.  
0930: 76 6f 69 64 28 2a 78 43 61 6c 6c 62 61 63 6b 29  void(*xCallback)
0940: 28 76 6f 69 64 20 2a 70 41 72 67 2c 20 73 71 6c  (void *pArg, sql
0950: 69 74 65 33 5f 69 6e 74 36 34 20 75 73 65 64 2c  ite3_int64 used,
0960: 69 6e 74 20 4e 29 2c 0a 20 20 76 6f 69 64 20 2a  int N),.  void *
0970: 70 41 72 67 2c 0a 20 20 73 71 6c 69 74 65 33 5f  pArg,.  sqlite3_
0980: 69 6e 74 36 34 20 69 54 68 72 65 73 68 6f 6c 64  int64 iThreshold
0990: 0a 29 7b 0a 20 20 28 76 6f 69 64 29 78 43 61 6c  .){.  (void)xCal
09a0: 6c 62 61 63 6b 3b 0a 20 20 28 76 6f 69 64 29 70  lback;.  (void)p
09b0: 41 72 67 3b 0a 20 20 28 76 6f 69 64 29 69 54 68  Arg;.  (void)iTh
09c0: 72 65 73 68 6f 6c 64 3b 0a 20 20 72 65 74 75 72  reshold;.  retur
09d0: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23  n SQLITE_OK;.}.#
09e0: 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 53 65 74  endif../*.** Set
09f0: 20 74 68 65 20 73 6f 66 74 20 68 65 61 70 2d 73   the soft heap-s
0a00: 69 7a 65 20 6c 69 6d 69 74 20 66 6f 72 20 74 68  ize limit for th
0a10: 65 20 6c 69 62 72 61 72 79 2e 20 50 61 73 73 69  e library. Passi
0a20: 6e 67 20 61 20 7a 65 72 6f 20 6f 72 20 0a 2a 2a  ng a zero or .**
0a30: 20 6e 65 67 61 74 69 76 65 20 76 61 6c 75 65 20   negative value 
0a40: 69 6e 64 69 63 61 74 65 73 20 6e 6f 20 6c 69 6d  indicates no lim
0a50: 69 74 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f 69  it..*/.sqlite3_i
0a60: 6e 74 36 34 20 73 71 6c 69 74 65 33 5f 73 6f 66  nt64 sqlite3_sof
0a70: 74 5f 68 65 61 70 5f 6c 69 6d 69 74 36 34 28 73  t_heap_limit64(s
0a80: 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 6e 29 7b  qlite3_int64 n){
0a90: 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34  .  sqlite3_int64
0aa0: 20 70 72 69 6f 72 4c 69 6d 69 74 3b 0a 20 20 73   priorLimit;.  s
0ab0: 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 65 78 63  qlite3_int64 exc
0ac0: 65 73 73 3b 0a 20 20 73 71 6c 69 74 65 33 5f 69  ess;.  sqlite3_i
0ad0: 6e 74 36 34 20 6e 55 73 65 64 3b 0a 23 69 66 6e  nt64 nUsed;.#ifn
0ae0: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  def SQLITE_OMIT_
0af0: 41 55 54 4f 49 4e 49 54 0a 20 20 69 6e 74 20 72  AUTOINIT.  int r
0b00: 63 20 3d 20 73 71 6c 69 74 65 33 5f 69 6e 69 74  c = sqlite3_init
0b10: 69 61 6c 69 7a 65 28 29 3b 0a 20 20 69 66 28 20  ialize();.  if( 
0b20: 72 63 20 29 20 72 65 74 75 72 6e 20 2d 31 3b 0a  rc ) return -1;.
0b30: 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 33  #endif.  sqlite3
0b40: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d 65 6d  _mutex_enter(mem
0b50: 30 2e 6d 75 74 65 78 29 3b 0a 20 20 70 72 69 6f  0.mutex);.  prio
0b60: 72 4c 69 6d 69 74 20 3d 20 6d 65 6d 30 2e 61 6c  rLimit = mem0.al
0b70: 61 72 6d 54 68 72 65 73 68 6f 6c 64 3b 0a 20 20  armThreshold;.  
0b80: 69 66 28 20 6e 3c 30 20 29 7b 0a 20 20 20 20 73  if( n<0 ){.    s
0b90: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
0ba0: 76 65 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a  ve(mem0.mutex);.
0bb0: 20 20 20 20 72 65 74 75 72 6e 20 70 72 69 6f 72      return prior
0bc0: 4c 69 6d 69 74 3b 0a 20 20 7d 0a 20 20 6d 65 6d  Limit;.  }.  mem
0bd0: 30 2e 61 6c 61 72 6d 54 68 72 65 73 68 6f 6c 64  0.alarmThreshold
0be0: 20 3d 20 6e 3b 0a 20 20 6e 55 73 65 64 20 3d 20   = n;.  nUsed = 
0bf0: 73 71 6c 69 74 65 33 53 74 61 74 75 73 56 61 6c  sqlite3StatusVal
0c00: 75 65 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53  ue(SQLITE_STATUS
0c10: 5f 4d 45 4d 4f 52 59 5f 55 53 45 44 29 3b 0a 20  _MEMORY_USED);. 
0c20: 20 6d 65 6d 30 2e 6e 65 61 72 6c 79 46 75 6c 6c   mem0.nearlyFull
0c30: 20 3d 20 28 6e 3e 30 20 26 26 20 6e 3c 3d 6e 55   = (n>0 && n<=nU
0c40: 73 65 64 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f  sed);.  sqlite3_
0c50: 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 65 6d 30  mutex_leave(mem0
0c60: 2e 6d 75 74 65 78 29 3b 0a 20 20 65 78 63 65 73  .mutex);.  exces
0c70: 73 20 3d 20 73 71 6c 69 74 65 33 5f 6d 65 6d 6f  s = sqlite3_memo
0c80: 72 79 5f 75 73 65 64 28 29 20 2d 20 6e 3b 0a 20  ry_used() - n;. 
0c90: 20 69 66 28 20 65 78 63 65 73 73 3e 30 20 29 20   if( excess>0 ) 
0ca0: 73 71 6c 69 74 65 33 5f 72 65 6c 65 61 73 65 5f  sqlite3_release_
0cb0: 6d 65 6d 6f 72 79 28 28 69 6e 74 29 28 65 78 63  memory((int)(exc
0cc0: 65 73 73 20 26 20 30 78 37 66 66 66 66 66 66 66  ess & 0x7fffffff
0cd0: 29 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 72 69  ));.  return pri
0ce0: 6f 72 4c 69 6d 69 74 3b 0a 7d 0a 76 6f 69 64 20  orLimit;.}.void 
0cf0: 73 71 6c 69 74 65 33 5f 73 6f 66 74 5f 68 65 61  sqlite3_soft_hea
0d00: 70 5f 6c 69 6d 69 74 28 69 6e 74 20 6e 29 7b 0a  p_limit(int n){.
0d10: 20 20 69 66 28 20 6e 3c 30 20 29 20 6e 20 3d 20    if( n<0 ) n = 
0d20: 30 3b 0a 20 20 73 71 6c 69 74 65 33 5f 73 6f 66  0;.  sqlite3_sof
0d30: 74 5f 68 65 61 70 5f 6c 69 6d 69 74 36 34 28 6e  t_heap_limit64(n
0d40: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74  );.}../*.** Init
0d50: 69 61 6c 69 7a 65 20 74 68 65 20 6d 65 6d 6f 72  ialize the memor
0d60: 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 73 75 62  y allocation sub
0d70: 73 79 73 74 65 6d 2e 0a 2a 2f 0a 69 6e 74 20 73  system..*/.int s
0d80: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 49 6e 69 74  qlite3MallocInit
0d90: 28 76 6f 69 64 29 7b 0a 20 20 69 6e 74 20 72 63  (void){.  int rc
0da0: 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 47  ;.  if( sqlite3G
0db0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78 4d  lobalConfig.m.xM
0dc0: 61 6c 6c 6f 63 3d 3d 30 20 29 7b 0a 20 20 20 20  alloc==0 ){.    
0dd0: 73 71 6c 69 74 65 33 4d 65 6d 53 65 74 44 65 66  sqlite3MemSetDef
0de0: 61 75 6c 74 28 29 3b 0a 20 20 7d 0a 20 20 6d 65  ault();.  }.  me
0df0: 6d 73 65 74 28 26 6d 65 6d 30 2c 20 30 2c 20 73  mset(&mem0, 0, s
0e00: 69 7a 65 6f 66 28 6d 65 6d 30 29 29 3b 0a 20 20  izeof(mem0));.  
0e10: 6d 65 6d 30 2e 6d 75 74 65 78 20 3d 20 73 71 6c  mem0.mutex = sql
0e20: 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53  ite3MutexAlloc(S
0e30: 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54  QLITE_MUTEX_STAT
0e40: 49 43 5f 4d 45 4d 29 3b 0a 20 20 69 66 28 20 73  IC_MEM);.  if( s
0e50: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66  qlite3GlobalConf
0e60: 69 67 2e 70 53 63 72 61 74 63 68 20 26 26 20 73  ig.pScratch && s
0e70: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66  qlite3GlobalConf
0e80: 69 67 2e 73 7a 53 63 72 61 74 63 68 3e 3d 31 30  ig.szScratch>=10
0e90: 30 0a 20 20 20 20 20 20 26 26 20 73 71 6c 69 74  0.      && sqlit
0ea0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e  e3GlobalConfig.n
0eb0: 53 63 72 61 74 63 68 3e 30 20 29 7b 0a 20 20 20  Scratch>0 ){.   
0ec0: 20 69 6e 74 20 69 2c 20 6e 2c 20 73 7a 3b 0a 20   int i, n, sz;. 
0ed0: 20 20 20 53 63 72 61 74 63 68 46 72 65 65 73 6c     ScratchFreesl
0ee0: 6f 74 20 2a 70 53 6c 6f 74 3b 0a 20 20 20 20 73  ot *pSlot;.    s
0ef0: 7a 20 3d 20 52 4f 55 4e 44 44 4f 57 4e 38 28 73  z = ROUNDDOWN8(s
0f00: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66  qlite3GlobalConf
0f10: 69 67 2e 73 7a 53 63 72 61 74 63 68 29 3b 0a 20  ig.szScratch);. 
0f20: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c     sqlite3Global
0f30: 43 6f 6e 66 69 67 2e 73 7a 53 63 72 61 74 63 68  Config.szScratch
0f40: 20 3d 20 73 7a 3b 0a 20 20 20 20 70 53 6c 6f 74   = sz;.    pSlot
0f50: 20 3d 20 28 53 63 72 61 74 63 68 46 72 65 65 73   = (ScratchFrees
0f60: 6c 6f 74 2a 29 73 71 6c 69 74 65 33 47 6c 6f 62  lot*)sqlite3Glob
0f70: 61 6c 43 6f 6e 66 69 67 2e 70 53 63 72 61 74 63  alConfig.pScratc
0f80: 68 3b 0a 20 20 20 20 6e 20 3d 20 73 71 6c 69 74  h;.    n = sqlit
0f90: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e  e3GlobalConfig.n
0fa0: 53 63 72 61 74 63 68 3b 0a 20 20 20 20 6d 65 6d  Scratch;.    mem
0fb0: 30 2e 70 53 63 72 61 74 63 68 46 72 65 65 20 3d  0.pScratchFree =
0fc0: 20 70 53 6c 6f 74 3b 0a 20 20 20 20 6d 65 6d 30   pSlot;.    mem0
0fd0: 2e 6e 53 63 72 61 74 63 68 46 72 65 65 20 3d 20  .nScratchFree = 
0fe0: 6e 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20  n;.    for(i=0; 
0ff0: 69 3c 6e 2d 31 3b 20 69 2b 2b 29 7b 0a 20 20 20  i<n-1; i++){.   
1000: 20 20 20 70 53 6c 6f 74 2d 3e 70 4e 65 78 74 20     pSlot->pNext 
1010: 3d 20 28 53 63 72 61 74 63 68 46 72 65 65 73 6c  = (ScratchFreesl
1020: 6f 74 2a 29 28 73 7a 2b 28 63 68 61 72 2a 29 70  ot*)(sz+(char*)p
1030: 53 6c 6f 74 29 3b 0a 20 20 20 20 20 20 70 53 6c  Slot);.      pSl
1040: 6f 74 20 3d 20 70 53 6c 6f 74 2d 3e 70 4e 65 78  ot = pSlot->pNex
1050: 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 53 6c  t;.    }.    pSl
1060: 6f 74 2d 3e 70 4e 65 78 74 20 3d 20 30 3b 0a 20  ot->pNext = 0;. 
1070: 20 20 20 6d 65 6d 30 2e 70 53 63 72 61 74 63 68     mem0.pScratch
1080: 45 6e 64 20 3d 20 28 76 6f 69 64 2a 29 26 70 53  End = (void*)&pS
1090: 6c 6f 74 5b 31 5d 3b 0a 20 20 7d 65 6c 73 65 7b  lot[1];.  }else{
10a0: 0a 20 20 20 20 6d 65 6d 30 2e 70 53 63 72 61 74  .    mem0.pScrat
10b0: 63 68 45 6e 64 20 3d 20 30 3b 0a 20 20 20 20 73  chEnd = 0;.    s
10c0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66  qlite3GlobalConf
10d0: 69 67 2e 70 53 63 72 61 74 63 68 20 3d 20 30 3b  ig.pScratch = 0;
10e0: 0a 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62  .    sqlite3Glob
10f0: 61 6c 43 6f 6e 66 69 67 2e 73 7a 53 63 72 61 74  alConfig.szScrat
1100: 63 68 20 3d 20 30 3b 0a 20 20 20 20 73 71 6c 69  ch = 0;.    sqli
1110: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e  te3GlobalConfig.
1120: 6e 53 63 72 61 74 63 68 20 3d 20 30 3b 0a 20 20  nScratch = 0;.  
1130: 7d 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 47  }.  if( sqlite3G
1140: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67  lobalConfig.pPag
1150: 65 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65 33 47  e==0 || sqlite3G
1160: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 50 61  lobalConfig.szPa
1170: 67 65 3c 35 31 32 0a 20 20 20 20 20 20 7c 7c 20  ge<512.      || 
1180: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
1190: 66 69 67 2e 6e 50 61 67 65 3c 3d 30 20 29 7b 0a  fig.nPage<=0 ){.
11a0: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61      sqlite3Globa
11b0: 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65 20 3d 20  lConfig.pPage = 
11c0: 30 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 47 6c  0;.    sqlite3Gl
11d0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 50 61 67  obalConfig.szPag
11e0: 65 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 63 20  e = 0;.  }.  rc 
11f0: 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43  = sqlite3GlobalC
1200: 6f 6e 66 69 67 2e 6d 2e 78 49 6e 69 74 28 73 71  onfig.m.xInit(sq
1210: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69  lite3GlobalConfi
1220: 67 2e 6d 2e 70 41 70 70 44 61 74 61 29 3b 0a 20  g.m.pAppData);. 
1230: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f   if( rc!=SQLITE_
1240: 4f 4b 20 29 20 6d 65 6d 73 65 74 28 26 6d 65 6d  OK ) memset(&mem
1250: 30 2c 20 30 2c 20 73 69 7a 65 6f 66 28 6d 65 6d  0, 0, sizeof(mem
1260: 30 29 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63  0));.  return rc
1270: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  ;.}../*.** Retur
1280: 6e 20 74 72 75 65 20 69 66 20 74 68 65 20 68 65  n true if the he
1290: 61 70 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20  ap is currently 
12a0: 75 6e 64 65 72 20 6d 65 6d 6f 72 79 20 70 72 65  under memory pre
12b0: 73 73 75 72 65 20 2d 20 69 6e 20 6f 74 68 65 72  ssure - in other
12c0: 0a 2a 2a 20 77 6f 72 64 73 20 69 66 20 74 68 65  .** words if the
12d0: 20 61 6d 6f 75 6e 74 20 6f 66 20 68 65 61 70 20   amount of heap 
12e0: 75 73 65 64 20 69 73 20 63 6c 6f 73 65 20 74 6f  used is close to
12f0: 20 74 68 65 20 6c 69 6d 69 74 20 73 65 74 20 62   the limit set b
1300: 79 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 73 6f 66  y.** sqlite3_sof
1310: 74 5f 68 65 61 70 5f 6c 69 6d 69 74 28 29 2e 0a  t_heap_limit()..
1320: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 48 65  */.int sqlite3He
1330: 61 70 4e 65 61 72 6c 79 46 75 6c 6c 28 76 6f 69  apNearlyFull(voi
1340: 64 29 7b 0a 20 20 72 65 74 75 72 6e 20 6d 65 6d  d){.  return mem
1350: 30 2e 6e 65 61 72 6c 79 46 75 6c 6c 3b 0a 7d 0a  0.nearlyFull;.}.
1360: 0a 2f 2a 0a 2a 2a 20 44 65 69 6e 69 74 69 61 6c  ./*.** Deinitial
1370: 69 7a 65 20 74 68 65 20 6d 65 6d 6f 72 79 20 61  ize the memory a
1380: 6c 6c 6f 63 61 74 69 6f 6e 20 73 75 62 73 79 73  llocation subsys
1390: 74 65 6d 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  tem..*/.void sql
13a0: 69 74 65 33 4d 61 6c 6c 6f 63 45 6e 64 28 76 6f  ite3MallocEnd(vo
13b0: 69 64 29 7b 0a 20 20 69 66 28 20 73 71 6c 69 74  id){.  if( sqlit
13c0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d  e3GlobalConfig.m
13d0: 2e 78 53 68 75 74 64 6f 77 6e 20 29 7b 0a 20 20  .xShutdown ){.  
13e0: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43    sqlite3GlobalC
13f0: 6f 6e 66 69 67 2e 6d 2e 78 53 68 75 74 64 6f 77  onfig.m.xShutdow
1400: 6e 28 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43  n(sqlite3GlobalC
1410: 6f 6e 66 69 67 2e 6d 2e 70 41 70 70 44 61 74 61  onfig.m.pAppData
1420: 29 3b 0a 20 20 7d 0a 20 20 6d 65 6d 73 65 74 28  );.  }.  memset(
1430: 26 6d 65 6d 30 2c 20 30 2c 20 73 69 7a 65 6f 66  &mem0, 0, sizeof
1440: 28 6d 65 6d 30 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  (mem0));.}../*.*
1450: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 61 6d 6f  * Return the amo
1460: 75 6e 74 20 6f 66 20 6d 65 6d 6f 72 79 20 63 75  unt of memory cu
1470: 72 72 65 6e 74 6c 79 20 63 68 65 63 6b 65 64 20  rrently checked 
1480: 6f 75 74 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f  out..*/.sqlite3_
1490: 69 6e 74 36 34 20 73 71 6c 69 74 65 33 5f 6d 65  int64 sqlite3_me
14a0: 6d 6f 72 79 5f 75 73 65 64 28 76 6f 69 64 29 7b  mory_used(void){
14b0: 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34  .  sqlite3_int64
14c0: 20 72 65 73 2c 20 6d 78 3b 0a 20 20 73 71 6c 69   res, mx;.  sqli
14d0: 74 65 33 5f 73 74 61 74 75 73 36 34 28 53 51 4c  te3_status64(SQL
14e0: 49 54 45 5f 53 54 41 54 55 53 5f 4d 45 4d 4f 52  ITE_STATUS_MEMOR
14f0: 59 5f 55 53 45 44 2c 20 26 72 65 73 2c 20 26 6d  Y_USED, &res, &m
1500: 78 2c 20 30 29 3b 0a 20 20 72 65 74 75 72 6e 20  x, 0);.  return 
1510: 72 65 73 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  res;.}../*.** Re
1520: 74 75 72 6e 20 74 68 65 20 6d 61 78 69 6d 75 6d  turn the maximum
1530: 20 61 6d 6f 75 6e 74 20 6f 66 20 6d 65 6d 6f 72   amount of memor
1540: 79 20 74 68 61 74 20 68 61 73 20 65 76 65 72 20  y that has ever 
1550: 62 65 65 6e 0a 2a 2a 20 63 68 65 63 6b 65 64 20  been.** checked 
1560: 6f 75 74 20 73 69 6e 63 65 20 65 69 74 68 65 72  out since either
1570: 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f   the beginning o
1580: 66 20 74 68 69 73 20 70 72 6f 63 65 73 73 0a 2a  f this process.*
1590: 2a 20 6f 72 20 73 69 6e 63 65 20 74 68 65 20 6d  * or since the m
15a0: 6f 73 74 20 72 65 63 65 6e 74 20 72 65 73 65 74  ost recent reset
15b0: 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f 69 6e 74  ..*/.sqlite3_int
15c0: 36 34 20 73 71 6c 69 74 65 33 5f 6d 65 6d 6f 72  64 sqlite3_memor
15d0: 79 5f 68 69 67 68 77 61 74 65 72 28 69 6e 74 20  y_highwater(int 
15e0: 72 65 73 65 74 46 6c 61 67 29 7b 0a 20 20 73 71  resetFlag){.  sq
15f0: 6c 69 74 65 33 5f 69 6e 74 36 34 20 72 65 73 2c  lite3_int64 res,
1600: 20 6d 78 3b 0a 20 20 73 71 6c 69 74 65 33 5f 73   mx;.  sqlite3_s
1610: 74 61 74 75 73 36 34 28 53 51 4c 49 54 45 5f 53  tatus64(SQLITE_S
1620: 54 41 54 55 53 5f 4d 45 4d 4f 52 59 5f 55 53 45  TATUS_MEMORY_USE
1630: 44 2c 20 26 72 65 73 2c 20 26 6d 78 2c 20 72 65  D, &res, &mx, re
1640: 73 65 74 46 6c 61 67 29 3b 0a 20 20 72 65 74 75  setFlag);.  retu
1650: 72 6e 20 6d 78 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  rn mx;.}../*.** 
1660: 54 72 69 67 67 65 72 20 74 68 65 20 61 6c 61 72  Trigger the alar
1670: 6d 20 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  m .*/.static voi
1680: 64 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 41  d sqlite3MallocA
1690: 6c 61 72 6d 28 69 6e 74 20 6e 42 79 74 65 29 7b  larm(int nByte){
16a0: 0a 20 20 69 66 28 20 6d 65 6d 30 2e 61 6c 61 72  .  if( mem0.alar
16b0: 6d 54 68 72 65 73 68 6f 6c 64 3c 3d 30 20 29 20  mThreshold<=0 ) 
16c0: 72 65 74 75 72 6e 3b 0a 20 20 73 71 6c 69 74 65  return;.  sqlite
16d0: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 65  3_mutex_leave(me
16e0: 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 73 71 6c  m0.mutex);.  sql
16f0: 69 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d  ite3_release_mem
1700: 6f 72 79 28 6e 42 79 74 65 29 3b 0a 20 20 73 71  ory(nByte);.  sq
1710: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
1720: 72 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 7d  r(mem0.mutex);.}
1730: 0a 0a 2f 2a 0a 2a 2a 20 44 6f 20 61 20 6d 65 6d  ../*.** Do a mem
1740: 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 77  ory allocation w
1750: 69 74 68 20 73 74 61 74 69 73 74 69 63 73 20 61  ith statistics a
1760: 6e 64 20 61 6c 61 72 6d 73 2e 20 20 41 73 73 75  nd alarms.  Assu
1770: 6d 65 20 74 68 65 0a 2a 2a 20 6c 6f 63 6b 20 69  me the.** lock i
1780: 73 20 61 6c 72 65 61 64 79 20 68 65 6c 64 2e 0a  s already held..
1790: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 6d  */.static void m
17a0: 61 6c 6c 6f 63 57 69 74 68 41 6c 61 72 6d 28 69  allocWithAlarm(i
17b0: 6e 74 20 6e 2c 20 76 6f 69 64 20 2a 2a 70 70 29  nt n, void **pp)
17c0: 7b 0a 20 20 76 6f 69 64 20 2a 70 3b 0a 20 20 69  {.  void *p;.  i
17d0: 6e 74 20 6e 46 75 6c 6c 3b 0a 20 20 61 73 73 65  nt nFull;.  asse
17e0: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  rt( sqlite3_mute
17f0: 78 5f 68 65 6c 64 28 6d 65 6d 30 2e 6d 75 74 65  x_held(mem0.mute
1800: 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  x) );.  assert( 
1810: 6e 3e 30 20 29 3b 0a 0a 20 20 2f 2a 20 49 6e 20  n>0 );..  /* In 
1820: 46 69 72 65 66 6f 78 20 28 63 69 72 63 61 20 32  Firefox (circa 2
1830: 30 31 37 2d 30 32 2d 30 38 29 2c 20 78 52 6f 75  017-02-08), xRou
1840: 6e 64 75 70 28 29 20 69 73 20 72 65 6d 61 70 70  ndup() is remapp
1850: 65 64 20 74 6f 20 61 6e 20 69 6e 74 65 72 6e 61  ed to an interna
1860: 6c 0a 20 20 2a 2a 20 69 6d 70 6c 65 6d 65 6e 74  l.  ** implement
1870: 61 74 69 6f 6e 20 6f 66 20 6d 61 6c 6c 6f 63 5f  ation of malloc_
1880: 67 6f 6f 64 5f 73 69 7a 65 28 29 2c 20 77 68 69  good_size(), whi
1890: 63 68 20 6d 75 73 74 20 62 65 20 63 61 6c 6c 65  ch must be calle
18a0: 64 20 69 6e 20 64 65 62 75 67 0a 20 20 2a 2a 20  d in debug.  ** 
18b0: 6d 6f 64 65 20 61 6e 64 20 73 70 65 63 69 66 69  mode and specifi
18c0: 63 61 6c 6c 79 20 77 68 65 6e 20 74 68 65 20 44  cally when the D
18d0: 4d 44 20 22 44 61 72 6b 20 4d 61 74 74 65 72 20  MD "Dark Matter 
18e0: 44 65 74 65 63 74 6f 72 22 20 69 73 20 65 6e 61  Detector" is ena
18f0: 62 6c 65 64 0a 20 20 2a 2a 20 6f 72 20 65 6c 73  bled.  ** or els
1900: 65 20 61 20 63 72 61 73 68 20 72 65 73 75 6c 74  e a crash result
1910: 73 2e 20 20 48 65 6e 63 65 2c 20 64 6f 20 6e 6f  s.  Hence, do no
1920: 74 20 61 74 74 65 6d 70 74 20 74 6f 20 6f 70 74  t attempt to opt
1930: 69 6d 69 7a 65 20 6f 75 74 20 74 68 65 0a 20 20  imize out the.  
1940: 2a 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 78 52 6f  ** following xRo
1950: 75 6e 64 75 70 28 29 20 63 61 6c 6c 2e 20 2a 2f  undup() call. */
1960: 0a 20 20 6e 46 75 6c 6c 20 3d 20 73 71 6c 69 74  .  nFull = sqlit
1970: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d  e3GlobalConfig.m
1980: 2e 78 52 6f 75 6e 64 75 70 28 6e 29 3b 0a 0a 23  .xRoundup(n);..#
1990: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4d 41 58  ifdef SQLITE_MAX
19a0: 5f 4d 45 4d 4f 52 59 0a 20 20 69 66 28 20 73 71  _MEMORY.  if( sq
19b0: 6c 69 74 65 33 53 74 61 74 75 73 56 61 6c 75 65  lite3StatusValue
19c0: 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d  (SQLITE_STATUS_M
19d0: 45 4d 4f 52 59 5f 55 53 45 44 29 2b 6e 46 75 6c  EMORY_USED)+nFul
19e0: 6c 3e 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 45 4d  l>SQLITE_MAX_MEM
19f0: 4f 52 59 20 29 7b 0a 20 20 20 20 2a 70 70 20 3d  ORY ){.    *pp =
1a00: 20 30 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a   0;.    return;.
1a10: 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 73 71    }.#endif..  sq
1a20: 6c 69 74 65 33 53 74 61 74 75 73 48 69 67 68 77  lite3StatusHighw
1a30: 61 74 65 72 28 53 51 4c 49 54 45 5f 53 54 41 54  ater(SQLITE_STAT
1a40: 55 53 5f 4d 41 4c 4c 4f 43 5f 53 49 5a 45 2c 20  US_MALLOC_SIZE, 
1a50: 6e 29 3b 0a 20 20 69 66 28 20 6d 65 6d 30 2e 61  n);.  if( mem0.a
1a60: 6c 61 72 6d 54 68 72 65 73 68 6f 6c 64 3e 30 20  larmThreshold>0 
1a70: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 69  ){.    sqlite3_i
1a80: 6e 74 36 34 20 6e 55 73 65 64 20 3d 20 73 71 6c  nt64 nUsed = sql
1a90: 69 74 65 33 53 74 61 74 75 73 56 61 6c 75 65 28  ite3StatusValue(
1aa0: 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d 45  SQLITE_STATUS_ME
1ab0: 4d 4f 52 59 5f 55 53 45 44 29 3b 0a 20 20 20 20  MORY_USED);.    
1ac0: 69 66 28 20 6e 55 73 65 64 20 3e 3d 20 6d 65 6d  if( nUsed >= mem
1ad0: 30 2e 61 6c 61 72 6d 54 68 72 65 73 68 6f 6c 64  0.alarmThreshold
1ae0: 20 2d 20 6e 46 75 6c 6c 20 29 7b 0a 20 20 20 20   - nFull ){.    
1af0: 20 20 6d 65 6d 30 2e 6e 65 61 72 6c 79 46 75 6c    mem0.nearlyFul
1b00: 6c 20 3d 20 31 3b 0a 20 20 20 20 20 20 73 71 6c  l = 1;.      sql
1b10: 69 74 65 33 4d 61 6c 6c 6f 63 41 6c 61 72 6d 28  ite3MallocAlarm(
1b20: 6e 46 75 6c 6c 29 3b 0a 20 20 20 20 7d 65 6c 73  nFull);.    }els
1b30: 65 7b 0a 20 20 20 20 20 20 6d 65 6d 30 2e 6e 65  e{.      mem0.ne
1b40: 61 72 6c 79 46 75 6c 6c 20 3d 20 30 3b 0a 20 20  arlyFull = 0;.  
1b50: 20 20 7d 0a 20 20 7d 0a 20 20 70 20 3d 20 73 71    }.  }.  p = sq
1b60: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69  lite3GlobalConfi
1b70: 67 2e 6d 2e 78 4d 61 6c 6c 6f 63 28 6e 46 75 6c  g.m.xMalloc(nFul
1b80: 6c 29 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54  l);.#ifdef SQLIT
1b90: 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f  E_ENABLE_MEMORY_
1ba0: 4d 41 4e 41 47 45 4d 45 4e 54 0a 20 20 69 66 28  MANAGEMENT.  if(
1bb0: 20 70 3d 3d 30 20 26 26 20 6d 65 6d 30 2e 61 6c   p==0 && mem0.al
1bc0: 61 72 6d 54 68 72 65 73 68 6f 6c 64 3e 30 20 29  armThreshold>0 )
1bd0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 4d 61 6c  {.    sqlite3Mal
1be0: 6c 6f 63 41 6c 61 72 6d 28 6e 46 75 6c 6c 29 3b  locAlarm(nFull);
1bf0: 0a 20 20 20 20 70 20 3d 20 73 71 6c 69 74 65 33  .    p = sqlite3
1c00: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78  GlobalConfig.m.x
1c10: 4d 61 6c 6c 6f 63 28 6e 46 75 6c 6c 29 3b 0a 20  Malloc(nFull);. 
1c20: 20 7d 0a 23 65 6e 64 69 66 0a 20 20 69 66 28 20   }.#endif.  if( 
1c30: 70 20 29 7b 0a 20 20 20 20 6e 46 75 6c 6c 20 3d  p ){.    nFull =
1c40: 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69   sqlite3MallocSi
1c50: 7a 65 28 70 29 3b 0a 20 20 20 20 73 71 6c 69 74  ze(p);.    sqlit
1c60: 65 33 53 74 61 74 75 73 55 70 28 53 51 4c 49 54  e3StatusUp(SQLIT
1c70: 45 5f 53 54 41 54 55 53 5f 4d 45 4d 4f 52 59 5f  E_STATUS_MEMORY_
1c80: 55 53 45 44 2c 20 6e 46 75 6c 6c 29 3b 0a 20 20  USED, nFull);.  
1c90: 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 55    sqlite3StatusU
1ca0: 70 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f  p(SQLITE_STATUS_
1cb0: 4d 41 4c 4c 4f 43 5f 43 4f 55 4e 54 2c 20 31 29  MALLOC_COUNT, 1)
1cc0: 3b 0a 20 20 7d 0a 20 20 2a 70 70 20 3d 20 70 3b  ;.  }.  *pp = p;
1cd0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61  .}../*.** Alloca
1ce0: 74 65 20 6d 65 6d 6f 72 79 2e 20 20 54 68 69 73  te memory.  This
1cf0: 20 72 6f 75 74 69 6e 65 20 69 73 20 6c 69 6b 65   routine is like
1d00: 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28   sqlite3_malloc(
1d10: 29 20 65 78 63 65 70 74 20 74 68 61 74 20 69 74  ) except that it
1d20: 0a 2a 2a 20 61 73 73 75 6d 65 73 20 74 68 65 20  .** assumes the 
1d30: 6d 65 6d 6f 72 79 20 73 75 62 73 79 73 74 65 6d  memory subsystem
1d40: 20 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 65   has already bee
1d50: 6e 20 69 6e 69 74 69 61 6c 69 7a 65 64 2e 0a 2a  n initialized..*
1d60: 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 4d  /.void *sqlite3M
1d70: 61 6c 6c 6f 63 28 75 36 34 20 6e 29 7b 0a 20 20  alloc(u64 n){.  
1d80: 76 6f 69 64 20 2a 70 3b 0a 20 20 69 66 28 20 6e  void *p;.  if( n
1d90: 3d 3d 30 20 7c 7c 20 6e 3e 3d 30 78 37 66 66 66  ==0 || n>=0x7fff
1da0: 66 66 30 30 20 29 7b 0a 20 20 20 20 2f 2a 20 41  ff00 ){.    /* A
1db0: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69   memory allocati
1dc0: 6f 6e 20 6f 66 20 61 20 6e 75 6d 62 65 72 20 6f  on of a number o
1dd0: 66 20 62 79 74 65 73 20 77 68 69 63 68 20 69 73  f bytes which is
1de0: 20 6e 65 61 72 20 74 68 65 20 6d 61 78 69 6d 75   near the maximu
1df0: 6d 0a 20 20 20 20 2a 2a 20 73 69 67 6e 65 64 20  m.    ** signed 
1e00: 69 6e 74 65 67 65 72 20 76 61 6c 75 65 20 6d 69  integer value mi
1e10: 67 68 74 20 63 61 75 73 65 20 61 6e 20 69 6e 74  ght cause an int
1e20: 65 67 65 72 20 6f 76 65 72 66 6c 6f 77 20 69 6e  eger overflow in
1e30: 73 69 64 65 20 6f 66 20 74 68 65 0a 20 20 20 20  side of the.    
1e40: 2a 2a 20 78 4d 61 6c 6c 6f 63 28 29 2e 20 20 48  ** xMalloc().  H
1e50: 65 6e 63 65 20 77 65 20 6c 69 6d 69 74 20 74 68  ence we limit th
1e60: 65 20 6d 61 78 69 6d 75 6d 20 73 69 7a 65 20 74  e maximum size t
1e70: 6f 20 30 78 37 66 66 66 66 66 30 30 2c 20 67 69  o 0x7fffff00, gi
1e80: 76 69 6e 67 0a 20 20 20 20 2a 2a 20 32 35 35 20  ving.    ** 255 
1e90: 62 79 74 65 73 20 6f 66 20 6f 76 65 72 68 65 61  bytes of overhea
1ea0: 64 2e 20 20 53 51 4c 69 74 65 20 69 74 73 65 6c  d.  SQLite itsel
1eb0: 66 20 77 69 6c 6c 20 6e 65 76 65 72 20 75 73 65  f will never use
1ec0: 20 61 6e 79 74 68 69 6e 67 20 6e 65 61 72 0a 20   anything near. 
1ed0: 20 20 20 2a 2a 20 74 68 69 73 20 61 6d 6f 75 6e     ** this amoun
1ee0: 74 2e 20 20 54 68 65 20 6f 6e 6c 79 20 77 61 79  t.  The only way
1ef0: 20 74 6f 20 72 65 61 63 68 20 74 68 65 20 6c 69   to reach the li
1f00: 6d 69 74 20 69 73 20 77 69 74 68 20 73 71 6c 69  mit is with sqli
1f10: 74 65 33 5f 6d 61 6c 6c 6f 63 28 29 20 2a 2f 0a  te3_malloc() */.
1f20: 20 20 20 20 70 20 3d 20 30 3b 0a 20 20 7d 65 6c      p = 0;.  }el
1f30: 73 65 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c  se if( sqlite3Gl
1f40: 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 4d 65 6d 73  obalConfig.bMems
1f50: 74 61 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  tat ){.    sqlit
1f60: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d  e3_mutex_enter(m
1f70: 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20  em0.mutex);.    
1f80: 6d 61 6c 6c 6f 63 57 69 74 68 41 6c 61 72 6d 28  mallocWithAlarm(
1f90: 28 69 6e 74 29 6e 2c 20 26 70 29 3b 0a 20 20 20  (int)n, &p);.   
1fa0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c   sqlite3_mutex_l
1fb0: 65 61 76 65 28 6d 65 6d 30 2e 6d 75 74 65 78 29  eave(mem0.mutex)
1fc0: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70  ;.  }else{.    p
1fd0: 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c   = sqlite3Global
1fe0: 43 6f 6e 66 69 67 2e 6d 2e 78 4d 61 6c 6c 6f 63  Config.m.xMalloc
1ff0: 28 28 69 6e 74 29 6e 29 3b 0a 20 20 7d 0a 20 20  ((int)n);.  }.  
2000: 61 73 73 65 72 74 28 20 45 49 47 48 54 5f 42 59  assert( EIGHT_BY
2010: 54 45 5f 41 4c 49 47 4e 4d 45 4e 54 28 70 29 20  TE_ALIGNMENT(p) 
2020: 29 3b 20 20 2f 2a 20 49 4d 50 3a 20 52 2d 31 31  );  /* IMP: R-11
2030: 31 34 38 2d 34 30 39 39 35 20 2a 2f 0a 20 20 72  148-40995 */.  r
2040: 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 2f 2a 0a 2a  eturn p;.}../*.*
2050: 2a 20 54 68 69 73 20 76 65 72 73 69 6f 6e 20 6f  * This version o
2060: 66 20 74 68 65 20 6d 65 6d 6f 72 79 20 61 6c 6c  f the memory all
2070: 6f 63 61 74 69 6f 6e 20 69 73 20 66 6f 72 20 75  ocation is for u
2080: 73 65 20 62 79 20 74 68 65 20 61 70 70 6c 69 63  se by the applic
2090: 61 74 69 6f 6e 2e 0a 2a 2a 20 46 69 72 73 74 20  ation..** First 
20a0: 6d 61 6b 65 20 73 75 72 65 20 74 68 65 20 6d 65  make sure the me
20b0: 6d 6f 72 79 20 73 75 62 73 79 73 74 65 6d 20 69  mory subsystem i
20c0: 73 20 69 6e 69 74 69 61 6c 69 7a 65 64 2c 20 74  s initialized, t
20d0: 68 65 6e 20 64 6f 20 74 68 65 0a 2a 2a 20 61 6c  hen do the.** al
20e0: 6c 6f 63 61 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69  location..*/.voi
20f0: 64 20 2a 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f  d *sqlite3_mallo
2100: 63 28 69 6e 74 20 6e 29 7b 0a 23 69 66 6e 64 65  c(int n){.#ifnde
2110: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55  f SQLITE_OMIT_AU
2120: 54 4f 49 4e 49 54 0a 20 20 69 66 28 20 73 71 6c  TOINIT.  if( sql
2130: 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28  ite3_initialize(
2140: 29 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 23 65  ) ) return 0;.#e
2150: 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20 6e 3c  ndif.  return n<
2160: 3d 30 20 3f 20 30 20 3a 20 73 71 6c 69 74 65 33  =0 ? 0 : sqlite3
2170: 4d 61 6c 6c 6f 63 28 6e 29 3b 0a 7d 0a 76 6f 69  Malloc(n);.}.voi
2180: 64 20 2a 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f  d *sqlite3_mallo
2190: 63 36 34 28 73 71 6c 69 74 65 33 5f 75 69 6e 74  c64(sqlite3_uint
21a0: 36 34 20 6e 29 7b 0a 23 69 66 6e 64 65 66 20 53  64 n){.#ifndef S
21b0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49  QLITE_OMIT_AUTOI
21c0: 4e 49 54 0a 20 20 69 66 28 20 73 71 6c 69 74 65  NIT.  if( sqlite
21d0: 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 20 29  3_initialize() )
21e0: 20 72 65 74 75 72 6e 20 30 3b 0a 23 65 6e 64 69   return 0;.#endi
21f0: 66 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74  f.  return sqlit
2200: 65 33 4d 61 6c 6c 6f 63 28 6e 29 3b 0a 7d 0a 0a  e3Malloc(n);.}..
2210: 2f 2a 0a 2a 2a 20 45 61 63 68 20 74 68 72 65 61  /*.** Each threa
2220: 64 20 6d 61 79 20 6f 6e 6c 79 20 68 61 76 65 20  d may only have 
2230: 61 20 73 69 6e 67 6c 65 20 6f 75 74 73 74 61 6e  a single outstan
2240: 64 69 6e 67 20 61 6c 6c 6f 63 61 74 69 6f 6e 20  ding allocation 
2250: 66 72 6f 6d 0a 2a 2a 20 78 53 63 72 61 74 63 68  from.** xScratch
2260: 4d 61 6c 6c 6f 63 28 29 2e 20 20 57 65 20 76 65  Malloc().  We ve
2270: 72 69 66 79 20 74 68 69 73 20 63 6f 6e 73 74 72  rify this constr
2280: 61 69 6e 74 20 69 6e 20 74 68 65 20 73 69 6e 67  aint in the sing
2290: 6c 65 2d 74 68 72 65 61 64 65 64 0a 2a 2a 20 63  le-threaded.** c
22a0: 61 73 65 20 62 79 20 73 65 74 74 69 6e 67 20 73  ase by setting s
22b0: 63 72 61 74 63 68 41 6c 6c 6f 63 4f 75 74 20 74  cratchAllocOut t
22c0: 6f 20 31 20 77 68 65 6e 20 61 6e 20 61 6c 6c 6f  o 1 when an allo
22d0: 63 61 74 69 6f 6e 0a 2a 2a 20 69 73 20 6f 75 74  cation.** is out
22e0: 73 74 61 6e 64 69 6e 67 20 63 6c 65 61 72 69 6e  standing clearin
22f0: 67 20 69 74 20 77 68 65 6e 20 74 68 65 20 61 6c  g it when the al
2300: 6c 6f 63 61 74 69 6f 6e 20 69 73 20 66 72 65 65  location is free
2310: 64 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51  d..*/.#ifndef SQ
2320: 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f 53 43 52  LITE_DISABLE_SCR
2330: 41 54 43 48 5f 4d 41 4c 4c 4f 43 0a 23 69 66 20  ATCH_MALLOC.#if 
2340: 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46  SQLITE_THREADSAF
2350: 45 3d 3d 30 20 26 26 20 21 64 65 66 69 6e 65 64  E==0 && !defined
2360: 28 4e 44 45 42 55 47 29 0a 73 74 61 74 69 63 20  (NDEBUG).static 
2370: 69 6e 74 20 73 63 72 61 74 63 68 41 6c 6c 6f 63  int scratchAlloc
2380: 4f 75 74 20 3d 20 30 3b 0a 23 65 6e 64 69 66 0a  Out = 0;.#endif.
2390: 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 41  #endif.../*.** A
23a0: 6c 6c 6f 63 61 74 65 20 6d 65 6d 6f 72 79 20 74  llocate memory t
23b0: 68 61 74 20 69 73 20 74 6f 20 62 65 20 75 73 65  hat is to be use
23c0: 64 20 61 6e 64 20 72 65 6c 65 61 73 65 64 20 72  d and released r
23d0: 69 67 68 74 20 61 77 61 79 2e 0a 2a 2a 20 54 68  ight away..** Th
23e0: 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 73 69  is routine is si
23f0: 6d 69 6c 61 72 20 74 6f 20 61 6c 6c 6f 63 61 28  milar to alloca(
2400: 29 20 69 6e 20 74 68 61 74 20 69 74 20 69 73 20  ) in that it is 
2410: 6e 6f 74 20 69 6e 74 65 6e 64 65 64 0a 2a 2a 20  not intended.** 
2420: 66 6f 72 20 73 69 74 75 61 74 69 6f 6e 73 20 77  for situations w
2430: 68 65 72 65 20 74 68 65 20 6d 65 6d 6f 72 79 20  here the memory 
2440: 6d 69 67 68 74 20 62 65 20 68 65 6c 64 20 6c 6f  might be held lo
2450: 6e 67 2d 74 65 72 6d 2e 20 20 54 68 69 73 0a 2a  ng-term.  This.*
2460: 2a 20 72 6f 75 74 69 6e 65 20 69 73 20 69 6e 74  * routine is int
2470: 65 6e 64 65 64 20 74 6f 20 67 65 74 20 6d 65 6d  ended to get mem
2480: 6f 72 79 20 74 6f 20 6f 6c 64 20 6c 61 72 67 65  ory to old large
2490: 20 74 72 61 6e 73 69 65 6e 74 20 64 61 74 61 0a   transient data.
24a0: 2a 2a 20 73 74 72 75 63 74 75 72 65 73 20 74 68  ** structures th
24b0: 61 74 20 77 6f 75 6c 64 20 6e 6f 74 20 6e 6f 72  at would not nor
24c0: 6d 61 6c 6c 79 20 66 69 74 20 6f 6e 20 74 68 65  mally fit on the
24d0: 20 73 74 61 63 6b 20 6f 66 20 61 6e 0a 2a 2a 20   stack of an.** 
24e0: 65 6d 62 65 64 64 65 64 20 70 72 6f 63 65 73 73  embedded process
24f0: 6f 72 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c  or..*/.void *sql
2500: 69 74 65 33 53 63 72 61 74 63 68 4d 61 6c 6c 6f  ite3ScratchMallo
2510: 63 28 69 6e 74 20 6e 29 7b 0a 23 69 66 64 65 66  c(int n){.#ifdef
2520: 20 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f   SQLITE_DISABLE_
2530: 53 43 52 41 54 43 48 5f 4d 41 4c 4c 4f 43 0a 20  SCRATCH_MALLOC. 
2540: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 4d   return sqlite3M
2550: 61 6c 6c 6f 63 28 6e 29 3b 0a 23 65 6c 73 65 20  alloc(n);.#else 
2560: 20 0a 20 20 76 6f 69 64 20 2a 70 3b 0a 20 20 61   .  void *p;.  a
2570: 73 73 65 72 74 28 20 6e 3e 30 20 29 3b 0a 0a 20  ssert( n>0 );.. 
2580: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65   sqlite3_mutex_e
2590: 6e 74 65 72 28 6d 65 6d 30 2e 6d 75 74 65 78 29  nter(mem0.mutex)
25a0: 3b 0a 20 20 73 71 6c 69 74 65 33 53 74 61 74 75  ;.  sqlite3Statu
25b0: 73 48 69 67 68 77 61 74 65 72 28 53 51 4c 49 54  sHighwater(SQLIT
25c0: 45 5f 53 54 41 54 55 53 5f 53 43 52 41 54 43 48  E_STATUS_SCRATCH
25d0: 5f 53 49 5a 45 2c 20 6e 29 3b 0a 20 20 69 66 28  _SIZE, n);.  if(
25e0: 20 6d 65 6d 30 2e 6e 53 63 72 61 74 63 68 46 72   mem0.nScratchFr
25f0: 65 65 20 26 26 20 73 71 6c 69 74 65 33 47 6c 6f  ee && sqlite3Glo
2600: 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 53 63 72 61  balConfig.szScra
2610: 74 63 68 3e 3d 6e 20 29 7b 0a 20 20 20 20 70 20  tch>=n ){.    p 
2620: 3d 20 6d 65 6d 30 2e 70 53 63 72 61 74 63 68 46  = mem0.pScratchF
2630: 72 65 65 3b 0a 20 20 20 20 6d 65 6d 30 2e 70 53  ree;.    mem0.pS
2640: 63 72 61 74 63 68 46 72 65 65 20 3d 20 6d 65 6d  cratchFree = mem
2650: 30 2e 70 53 63 72 61 74 63 68 46 72 65 65 2d 3e  0.pScratchFree->
2660: 70 4e 65 78 74 3b 0a 20 20 20 20 6d 65 6d 30 2e  pNext;.    mem0.
2670: 6e 53 63 72 61 74 63 68 46 72 65 65 2d 2d 3b 0a  nScratchFree--;.
2680: 20 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75      sqlite3Statu
2690: 73 55 70 28 53 51 4c 49 54 45 5f 53 54 41 54 55  sUp(SQLITE_STATU
26a0: 53 5f 53 43 52 41 54 43 48 5f 55 53 45 44 2c 20  S_SCRATCH_USED, 
26b0: 31 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f  1);.    sqlite3_
26c0: 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 65 6d 30  mutex_leave(mem0
26d0: 2e 6d 75 74 65 78 29 3b 0a 20 20 7d 65 6c 73 65  .mutex);.  }else
26e0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75  {.    sqlite3_mu
26f0: 74 65 78 5f 6c 65 61 76 65 28 6d 65 6d 30 2e 6d  tex_leave(mem0.m
2700: 75 74 65 78 29 3b 0a 20 20 20 20 70 20 3d 20 73  utex);.    p = s
2710: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 6e 29 3b  qlite3Malloc(n);
2720: 0a 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33  .    if( sqlite3
2730: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 4d 65  GlobalConfig.bMe
2740: 6d 73 74 61 74 20 26 26 20 70 20 29 7b 0a 20 20  mstat && p ){.  
2750: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65      sqlite3_mute
2760: 78 5f 65 6e 74 65 72 28 6d 65 6d 30 2e 6d 75 74  x_enter(mem0.mut
2770: 65 78 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74  ex);.      sqlit
2780: 65 33 53 74 61 74 75 73 55 70 28 53 51 4c 49 54  e3StatusUp(SQLIT
2790: 45 5f 53 54 41 54 55 53 5f 53 43 52 41 54 43 48  E_STATUS_SCRATCH
27a0: 5f 4f 56 45 52 46 4c 4f 57 2c 20 73 71 6c 69 74  _OVERFLOW, sqlit
27b0: 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 29 29  e3MallocSize(p))
27c0: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f  ;.      sqlite3_
27d0: 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 65 6d 30  mutex_leave(mem0
27e0: 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 7d 0a 20  .mutex);.    }. 
27f0: 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62     sqlite3Memdeb
2800: 75 67 53 65 74 54 79 70 65 28 70 2c 20 4d 45 4d  ugSetType(p, MEM
2810: 54 59 50 45 5f 53 43 52 41 54 43 48 29 3b 0a 20  TYPE_SCRATCH);. 
2820: 20 7d 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c   }.  assert( sql
2830: 69 74 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65  ite3_mutex_nothe
2840: 6c 64 28 6d 65 6d 30 2e 6d 75 74 65 78 29 20 29  ld(mem0.mutex) )
2850: 3b 0a 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f 54  ;...#if SQLITE_T
2860: 48 52 45 41 44 53 41 46 45 3d 3d 30 20 26 26 20  HREADSAFE==0 && 
2870: 21 64 65 66 69 6e 65 64 28 4e 44 45 42 55 47 29  !defined(NDEBUG)
2880: 0a 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f  .  /* EVIDENCE-O
2890: 46 3a 20 52 2d 31 32 39 37 30 2d 30 35 38 38 30  F: R-12970-05880
28a0: 20 53 51 4c 69 74 65 20 77 69 6c 6c 20 6e 6f 74   SQLite will not
28b0: 20 75 73 65 20 6d 6f 72 65 20 74 68 61 6e 20 6f   use more than o
28c0: 6e 65 20 73 63 72 61 74 63 68 0a 20 20 2a 2a 20  ne scratch.  ** 
28d0: 62 75 66 66 65 72 73 20 70 65 72 20 74 68 72 65  buffers per thre
28e0: 61 64 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68  ad..  **.  ** Th
28f0: 69 73 20 63 61 6e 20 6f 6e 6c 79 20 62 65 20 63  is can only be c
2900: 68 65 63 6b 65 64 20 69 6e 20 73 69 6e 67 6c 65  hecked in single
2910: 2d 74 68 72 65 61 64 65 64 20 6d 6f 64 65 2e 0a  -threaded mode..
2920: 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 73    */.  assert( s
2930: 63 72 61 74 63 68 41 6c 6c 6f 63 4f 75 74 3d 3d  cratchAllocOut==
2940: 30 20 29 3b 0a 20 20 69 66 28 20 70 20 29 20 73  0 );.  if( p ) s
2950: 63 72 61 74 63 68 41 6c 6c 6f 63 4f 75 74 2b 2b  cratchAllocOut++
2960: 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 72 65 74 75  ;.#endif..  retu
2970: 72 6e 20 70 3b 0a 23 65 6e 64 69 66 20 2f 2a 20  rn p;.#endif /* 
2980: 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f 53  SQLITE_DISABLE_S
2990: 43 52 41 54 43 48 5f 4d 41 4c 4c 4f 43 20 2a 2f  CRATCH_MALLOC */
29a0: 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53  .}.void sqlite3S
29b0: 63 72 61 74 63 68 46 72 65 65 28 76 6f 69 64 20  cratchFree(void 
29c0: 2a 70 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49  *p){.#ifdef SQLI
29d0: 54 45 5f 44 49 53 41 42 4c 45 5f 53 43 52 41 54  TE_DISABLE_SCRAT
29e0: 43 48 5f 4d 41 4c 4c 4f 43 0a 20 20 73 71 6c 69  CH_MALLOC.  sqli
29f0: 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 23 65 6c  te3_free(p);.#el
2a00: 73 65 0a 20 20 69 66 28 20 70 20 29 7b 0a 0a 23  se.  if( p ){..#
2a10: 69 66 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44  if SQLITE_THREAD
2a20: 53 41 46 45 3d 3d 30 20 26 26 20 21 64 65 66 69  SAFE==0 && !defi
2a30: 6e 65 64 28 4e 44 45 42 55 47 29 0a 20 20 20 20  ned(NDEBUG).    
2a40: 2f 2a 20 56 65 72 69 66 79 20 74 68 61 74 20 6e  /* Verify that n
2a50: 6f 20 6d 6f 72 65 20 74 68 61 6e 20 74 77 6f 20  o more than two 
2a60: 73 63 72 61 74 63 68 20 61 6c 6c 6f 63 61 74 69  scratch allocati
2a70: 6f 6e 20 70 65 72 20 74 68 72 65 61 64 0a 20 20  on per thread.  
2a80: 20 20 2a 2a 20 69 73 20 6f 75 74 73 74 61 6e 64    ** is outstand
2a90: 69 6e 67 20 61 74 20 6f 6e 65 20 74 69 6d 65 2e  ing at one time.
2aa0: 20 20 28 54 68 69 73 20 69 73 20 6f 6e 6c 79 20    (This is only 
2ab0: 63 68 65 63 6b 65 64 20 69 6e 20 74 68 65 0a 20  checked in the. 
2ac0: 20 20 20 2a 2a 20 73 69 6e 67 6c 65 2d 74 68 72     ** single-thr
2ad0: 65 61 64 65 64 20 63 61 73 65 20 73 69 6e 63 65  eaded case since
2ae0: 20 63 68 65 63 6b 69 6e 67 20 69 6e 20 74 68 65   checking in the
2af0: 20 6d 75 6c 74 69 2d 74 68 72 65 61 64 65 64 20   multi-threaded 
2b00: 63 61 73 65 0a 20 20 20 20 2a 2a 20 77 6f 75 6c  case.    ** woul
2b10: 64 20 62 65 20 6d 75 63 68 20 6d 6f 72 65 20 63  d be much more c
2b20: 6f 6d 70 6c 69 63 61 74 65 64 2e 29 20 2a 2f 0a  omplicated.) */.
2b30: 20 20 20 20 61 73 73 65 72 74 28 20 73 63 72 61      assert( scra
2b40: 74 63 68 41 6c 6c 6f 63 4f 75 74 3e 3d 31 20 26  tchAllocOut>=1 &
2b50: 26 20 73 63 72 61 74 63 68 41 6c 6c 6f 63 4f 75  & scratchAllocOu
2b60: 74 3c 3d 32 20 29 3b 0a 20 20 20 20 73 63 72 61  t<=2 );.    scra
2b70: 74 63 68 41 6c 6c 6f 63 4f 75 74 2d 2d 3b 0a 23  tchAllocOut--;.#
2b80: 65 6e 64 69 66 0a 0a 20 20 20 20 69 66 28 20 53  endif..    if( S
2b90: 51 4c 49 54 45 5f 57 49 54 48 49 4e 28 70 2c 20  QLITE_WITHIN(p, 
2ba0: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
2bb0: 66 69 67 2e 70 53 63 72 61 74 63 68 2c 20 6d 65  fig.pScratch, me
2bc0: 6d 30 2e 70 53 63 72 61 74 63 68 45 6e 64 29 20  m0.pScratchEnd) 
2bd0: 29 7b 0a 20 20 20 20 20 20 2f 2a 20 52 65 6c 65  ){.      /* Rele
2be0: 61 73 65 20 6d 65 6d 6f 72 79 20 66 72 6f 6d 20  ase memory from 
2bf0: 74 68 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49  the SQLITE_CONFI
2c00: 47 5f 53 43 52 41 54 43 48 20 61 6c 6c 6f 63 61  G_SCRATCH alloca
2c10: 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 20 20 53 63  tion */.      Sc
2c20: 72 61 74 63 68 46 72 65 65 73 6c 6f 74 20 2a 70  ratchFreeslot *p
2c30: 53 6c 6f 74 3b 0a 20 20 20 20 20 20 70 53 6c 6f  Slot;.      pSlo
2c40: 74 20 3d 20 28 53 63 72 61 74 63 68 46 72 65 65  t = (ScratchFree
2c50: 73 6c 6f 74 2a 29 70 3b 0a 20 20 20 20 20 20 73  slot*)p;.      s
2c60: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74  qlite3_mutex_ent
2c70: 65 72 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a  er(mem0.mutex);.
2c80: 20 20 20 20 20 20 70 53 6c 6f 74 2d 3e 70 4e 65        pSlot->pNe
2c90: 78 74 20 3d 20 6d 65 6d 30 2e 70 53 63 72 61 74  xt = mem0.pScrat
2ca0: 63 68 46 72 65 65 3b 0a 20 20 20 20 20 20 6d 65  chFree;.      me
2cb0: 6d 30 2e 70 53 63 72 61 74 63 68 46 72 65 65 20  m0.pScratchFree 
2cc0: 3d 20 70 53 6c 6f 74 3b 0a 20 20 20 20 20 20 6d  = pSlot;.      m
2cd0: 65 6d 30 2e 6e 53 63 72 61 74 63 68 46 72 65 65  em0.nScratchFree
2ce0: 2b 2b 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74  ++;.      assert
2cf0: 28 20 6d 65 6d 30 2e 6e 53 63 72 61 74 63 68 46  ( mem0.nScratchF
2d00: 72 65 65 20 3c 3d 20 28 75 33 32 29 73 71 6c 69  ree <= (u32)sqli
2d10: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e  te3GlobalConfig.
2d20: 6e 53 63 72 61 74 63 68 20 29 3b 0a 20 20 20 20  nScratch );.    
2d30: 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 44    sqlite3StatusD
2d40: 6f 77 6e 28 53 51 4c 49 54 45 5f 53 54 41 54 55  own(SQLITE_STATU
2d50: 53 5f 53 43 52 41 54 43 48 5f 55 53 45 44 2c 20  S_SCRATCH_USED, 
2d60: 31 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  1);.      sqlite
2d70: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 65  3_mutex_leave(me
2d80: 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 7d  m0.mutex);.    }
2d90: 65 6c 73 65 7b 0a 20 20 20 20 20 20 2f 2a 20 52  else{.      /* R
2da0: 65 6c 65 61 73 65 20 6d 65 6d 6f 72 79 20 62 61  elease memory ba
2db0: 63 6b 20 74 6f 20 74 68 65 20 68 65 61 70 20 2a  ck to the heap *
2dc0: 2f 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20  /.      assert( 
2dd0: 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 48  sqlite3MemdebugH
2de0: 61 73 54 79 70 65 28 70 2c 20 4d 45 4d 54 59 50  asType(p, MEMTYP
2df0: 45 5f 53 43 52 41 54 43 48 29 20 29 3b 0a 20 20  E_SCRATCH) );.  
2e00: 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69      assert( sqli
2e10: 74 65 33 4d 65 6d 64 65 62 75 67 4e 6f 54 79 70  te3MemdebugNoTyp
2e20: 65 28 70 2c 20 28 75 38 29 7e 4d 45 4d 54 59 50  e(p, (u8)~MEMTYP
2e30: 45 5f 53 43 52 41 54 43 48 29 20 29 3b 0a 20 20  E_SCRATCH) );.  
2e40: 20 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 64 65      sqlite3Memde
2e50: 62 75 67 53 65 74 54 79 70 65 28 70 2c 20 4d 45  bugSetType(p, ME
2e60: 4d 54 59 50 45 5f 48 45 41 50 29 3b 0a 20 20 20  MTYPE_HEAP);.   
2e70: 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c     if( sqlite3Gl
2e80: 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 4d 65 6d 73  obalConfig.bMems
2e90: 74 61 74 20 29 7b 0a 20 20 20 20 20 20 20 20 69  tat ){.        i
2ea0: 6e 74 20 69 53 69 7a 65 20 3d 20 73 71 6c 69 74  nt iSize = sqlit
2eb0: 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 29 3b  e3MallocSize(p);
2ec0: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  .        sqlite3
2ed0: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d 65 6d  _mutex_enter(mem
2ee0: 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 20 20  0.mutex);.      
2ef0: 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 44    sqlite3StatusD
2f00: 6f 77 6e 28 53 51 4c 49 54 45 5f 53 54 41 54 55  own(SQLITE_STATU
2f10: 53 5f 53 43 52 41 54 43 48 5f 4f 56 45 52 46 4c  S_SCRATCH_OVERFL
2f20: 4f 57 2c 20 69 53 69 7a 65 29 3b 0a 20 20 20 20  OW, iSize);.    
2f30: 20 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75      sqlite3Statu
2f40: 73 44 6f 77 6e 28 53 51 4c 49 54 45 5f 53 54 41  sDown(SQLITE_STA
2f50: 54 55 53 5f 4d 45 4d 4f 52 59 5f 55 53 45 44 2c  TUS_MEMORY_USED,
2f60: 20 69 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 20   iSize);.       
2f70: 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 44 6f   sqlite3StatusDo
2f80: 77 6e 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53  wn(SQLITE_STATUS
2f90: 5f 4d 41 4c 4c 4f 43 5f 43 4f 55 4e 54 2c 20 31  _MALLOC_COUNT, 1
2fa0: 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74  );.        sqlit
2fb0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d  e3GlobalConfig.m
2fc0: 2e 78 46 72 65 65 28 70 29 3b 0a 20 20 20 20 20  .xFree(p);.     
2fd0: 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78     sqlite3_mutex
2fe0: 5f 6c 65 61 76 65 28 6d 65 6d 30 2e 6d 75 74 65  _leave(mem0.mute
2ff0: 78 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b  x);.      }else{
3000: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  .        sqlite3
3010: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78  GlobalConfig.m.x
3020: 46 72 65 65 28 70 29 3b 0a 20 20 20 20 20 20 7d  Free(p);.      }
3030: 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69  .    }.  }.#endi
3040: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 44 49 53 41  f /* SQLITE_DISA
3050: 42 4c 45 5f 53 43 52 41 54 43 48 5f 4d 41 4c 4c  BLE_SCRATCH_MALL
3060: 4f 43 20 2a 2f 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  OC */.}../*.** T
3070: 52 55 45 20 69 66 20 70 20 69 73 20 61 20 6c 6f  RUE if p is a lo
3080: 6f 6b 61 73 69 64 65 20 6d 65 6d 6f 72 79 20 61  okaside memory a
3090: 6c 6c 6f 63 61 74 69 6f 6e 20 66 72 6f 6d 20 64  llocation from d
30a0: 62 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c  b.*/.#ifndef SQL
30b0: 49 54 45 5f 4f 4d 49 54 5f 4c 4f 4f 4b 41 53 49  ITE_OMIT_LOOKASI
30c0: 44 45 0a 73 74 61 74 69 63 20 69 6e 74 20 69 73  DE.static int is
30d0: 4c 6f 6f 6b 61 73 69 64 65 28 73 71 6c 69 74 65  Lookaside(sqlite
30e0: 33 20 2a 64 62 2c 20 76 6f 69 64 20 2a 70 29 7b  3 *db, void *p){
30f0: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
3100: 5f 57 49 54 48 49 4e 28 70 2c 20 64 62 2d 3e 6c  _WITHIN(p, db->l
3110: 6f 6f 6b 61 73 69 64 65 2e 70 53 74 61 72 74 2c  ookaside.pStart,
3120: 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70   db->lookaside.p
3130: 45 6e 64 29 3b 0a 7d 0a 23 65 6c 73 65 0a 23 64  End);.}.#else.#d
3140: 65 66 69 6e 65 20 69 73 4c 6f 6f 6b 61 73 69 64  efine isLookasid
3150: 65 28 41 2c 42 29 20 30 0a 23 65 6e 64 69 66 0a  e(A,B) 0.#endif.
3160: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68  ./*.** Return th
3170: 65 20 73 69 7a 65 20 6f 66 20 61 20 6d 65 6d 6f  e size of a memo
3180: 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 70 72  ry allocation pr
3190: 65 76 69 6f 75 73 6c 79 20 6f 62 74 61 69 6e 65  eviously obtaine
31a0: 64 20 66 72 6f 6d 0a 2a 2a 20 73 71 6c 69 74 65  d from.** sqlite
31b0: 33 4d 61 6c 6c 6f 63 28 29 20 6f 72 20 73 71 6c  3Malloc() or sql
31c0: 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 29 2e 0a 2a  ite3_malloc()..*
31d0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d 61 6c  /.int sqlite3Mal
31e0: 6c 6f 63 53 69 7a 65 28 76 6f 69 64 20 2a 70 29  locSize(void *p)
31f0: 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69  {.  assert( sqli
3200: 74 65 33 4d 65 6d 64 65 62 75 67 48 61 73 54 79  te3MemdebugHasTy
3210: 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 48 45  pe(p, MEMTYPE_HE
3220: 41 50 29 20 29 3b 0a 20 20 72 65 74 75 72 6e 20  AP) );.  return 
3230: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
3240: 66 69 67 2e 6d 2e 78 53 69 7a 65 28 70 29 3b 0a  fig.m.xSize(p);.
3250: 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 44 62 4d  }.int sqlite3DbM
3260: 61 6c 6c 6f 63 53 69 7a 65 28 73 71 6c 69 74 65  allocSize(sqlite
3270: 33 20 2a 64 62 2c 20 76 6f 69 64 20 2a 70 29 7b  3 *db, void *p){
3280: 0a 20 20 61 73 73 65 72 74 28 20 70 21 3d 30 20  .  assert( p!=0 
3290: 29 3b 0a 20 20 69 66 28 20 64 62 3d 3d 30 20 7c  );.  if( db==0 |
32a0: 7c 20 21 69 73 4c 6f 6f 6b 61 73 69 64 65 28 64  | !isLookaside(d
32b0: 62 2c 70 29 20 29 7b 0a 23 69 66 64 65 66 20 53  b,p) ){.#ifdef S
32c0: 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 20 20  QLITE_DEBUG.    
32d0: 69 66 28 20 64 62 3d 3d 30 20 29 7b 0a 20 20 20  if( db==0 ){.   
32e0: 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74     assert( sqlit
32f0: 65 33 4d 65 6d 64 65 62 75 67 4e 6f 54 79 70 65  e3MemdebugNoType
3300: 28 70 2c 20 28 75 38 29 7e 4d 45 4d 54 59 50 45  (p, (u8)~MEMTYPE
3310: 5f 48 45 41 50 29 20 29 3b 0a 20 20 20 20 20 20  _HEAP) );.      
3320: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d  assert( sqlite3M
3330: 65 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 70  emdebugHasType(p
3340: 2c 20 4d 45 4d 54 59 50 45 5f 48 45 41 50 29 20  , MEMTYPE_HEAP) 
3350: 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  );.    }else{.  
3360: 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69      assert( sqli
3370: 74 65 33 4d 65 6d 64 65 62 75 67 48 61 73 54 79  te3MemdebugHasTy
3380: 70 65 28 70 2c 20 28 4d 45 4d 54 59 50 45 5f 4c  pe(p, (MEMTYPE_L
3390: 4f 4f 4b 41 53 49 44 45 7c 4d 45 4d 54 59 50 45  OOKASIDE|MEMTYPE
33a0: 5f 48 45 41 50 29 29 20 29 3b 0a 20 20 20 20 20  _HEAP)) );.     
33b0: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
33c0: 4d 65 6d 64 65 62 75 67 4e 6f 54 79 70 65 28 70  MemdebugNoType(p
33d0: 2c 20 28 75 38 29 7e 28 4d 45 4d 54 59 50 45 5f  , (u8)~(MEMTYPE_
33e0: 4c 4f 4f 4b 41 53 49 44 45 7c 4d 45 4d 54 59 50  LOOKASIDE|MEMTYP
33f0: 45 5f 48 45 41 50 29 29 20 29 3b 0a 20 20 20 20  E_HEAP)) );.    
3400: 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 72 65 74  }.#endif.    ret
3410: 75 72 6e 20 73 71 6c 69 74 65 33 47 6c 6f 62 61  urn sqlite3Globa
3420: 6c 43 6f 6e 66 69 67 2e 6d 2e 78 53 69 7a 65 28  lConfig.m.xSize(
3430: 70 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  p);.  }else{.   
3440: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
3450: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e  _mutex_held(db->
3460: 6d 75 74 65 78 29 20 29 3b 0a 20 20 20 20 72 65  mutex) );.    re
3470: 74 75 72 6e 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69  turn db->lookasi
3480: 64 65 2e 73 7a 3b 0a 20 20 7d 0a 7d 0a 73 71 6c  de.sz;.  }.}.sql
3490: 69 74 65 33 5f 75 69 6e 74 36 34 20 73 71 6c 69  ite3_uint64 sqli
34a0: 74 65 33 5f 6d 73 69 7a 65 28 76 6f 69 64 20 2a  te3_msize(void *
34b0: 70 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71  p){.  assert( sq
34c0: 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 4e 6f 54  lite3MemdebugNoT
34d0: 79 70 65 28 70 2c 20 28 75 38 29 7e 4d 45 4d 54  ype(p, (u8)~MEMT
34e0: 59 50 45 5f 48 45 41 50 29 20 29 3b 0a 20 20 61  YPE_HEAP) );.  a
34f0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d 65  ssert( sqlite3Me
3500: 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 70 2c  mdebugHasType(p,
3510: 20 4d 45 4d 54 59 50 45 5f 48 45 41 50 29 20 29   MEMTYPE_HEAP) )
3520: 3b 0a 20 20 72 65 74 75 72 6e 20 70 20 3f 20 73  ;.  return p ? s
3530: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66  qlite3GlobalConf
3540: 69 67 2e 6d 2e 78 53 69 7a 65 28 70 29 20 3a 20  ig.m.xSize(p) : 
3550: 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65  0;.}../*.** Free
3560: 20 6d 65 6d 6f 72 79 20 70 72 65 76 69 6f 75 73   memory previous
3570: 6c 79 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d  ly obtained from
3580: 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 29   sqlite3Malloc()
3590: 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65  ..*/.void sqlite
35a0: 33 5f 66 72 65 65 28 76 6f 69 64 20 2a 70 29 7b  3_free(void *p){
35b0: 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20 72 65  .  if( p==0 ) re
35c0: 74 75 72 6e 3b 20 20 2f 2a 20 49 4d 50 3a 20 52  turn;  /* IMP: R
35d0: 2d 34 39 30 35 33 2d 35 34 35 35 34 20 2a 2f 0a  -49053-54554 */.
35e0: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
35f0: 33 4d 65 6d 64 65 62 75 67 48 61 73 54 79 70 65  3MemdebugHasType
3600: 28 70 2c 20 4d 45 4d 54 59 50 45 5f 48 45 41 50  (p, MEMTYPE_HEAP
3610: 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73  ) );.  assert( s
3620: 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 4e 6f  qlite3MemdebugNo
3630: 54 79 70 65 28 70 2c 20 28 75 38 29 7e 4d 45 4d  Type(p, (u8)~MEM
3640: 54 59 50 45 5f 48 45 41 50 29 20 29 3b 0a 20 20  TYPE_HEAP) );.  
3650: 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61  if( sqlite3Globa
3660: 6c 43 6f 6e 66 69 67 2e 62 4d 65 6d 73 74 61 74  lConfig.bMemstat
3670: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f   ){.    sqlite3_
3680: 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d 65 6d 30  mutex_enter(mem0
3690: 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 73 71 6c  .mutex);.    sql
36a0: 69 74 65 33 53 74 61 74 75 73 44 6f 77 6e 28 53  ite3StatusDown(S
36b0: 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d 45 4d  QLITE_STATUS_MEM
36c0: 4f 52 59 5f 55 53 45 44 2c 20 73 71 6c 69 74 65  ORY_USED, sqlite
36d0: 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 29 29 3b  3MallocSize(p));
36e0: 0a 20 20 20 20 73 71 6c 69 74 65 33 53 74 61 74  .    sqlite3Stat
36f0: 75 73 44 6f 77 6e 28 53 51 4c 49 54 45 5f 53 54  usDown(SQLITE_ST
3700: 41 54 55 53 5f 4d 41 4c 4c 4f 43 5f 43 4f 55 4e  ATUS_MALLOC_COUN
3710: 54 2c 20 31 29 3b 0a 20 20 20 20 73 71 6c 69 74  T, 1);.    sqlit
3720: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d  e3GlobalConfig.m
3730: 2e 78 46 72 65 65 28 70 29 3b 0a 20 20 20 20 73  .xFree(p);.    s
3740: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
3750: 76 65 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a  ve(mem0.mutex);.
3760: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c    }else{.    sql
3770: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67  ite3GlobalConfig
3780: 2e 6d 2e 78 46 72 65 65 28 70 29 3b 0a 20 20 7d  .m.xFree(p);.  }
3790: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 20 74 68  .}../*.** Add th
37a0: 65 20 73 69 7a 65 20 6f 66 20 6d 65 6d 6f 72 79  e size of memory
37b0: 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 22 70 22 20   allocation "p" 
37c0: 74 6f 20 74 68 65 20 63 6f 75 6e 74 20 69 6e 0a  to the count in.
37d0: 2a 2a 20 2a 64 62 2d 3e 70 6e 42 79 74 65 73 46  ** *db->pnBytesF
37e0: 72 65 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  reed..*/.static 
37f0: 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20  SQLITE_NOINLINE 
3800: 76 6f 69 64 20 6d 65 61 73 75 72 65 41 6c 6c 6f  void measureAllo
3810: 63 61 74 69 6f 6e 53 69 7a 65 28 73 71 6c 69 74  cationSize(sqlit
3820: 65 33 20 2a 64 62 2c 20 76 6f 69 64 20 2a 70 29  e3 *db, void *p)
3830: 7b 0a 20 20 2a 64 62 2d 3e 70 6e 42 79 74 65 73  {.  *db->pnBytes
3840: 46 72 65 65 64 20 2b 3d 20 73 71 6c 69 74 65 33  Freed += sqlite3
3850: 44 62 4d 61 6c 6c 6f 63 53 69 7a 65 28 64 62 2c  DbMallocSize(db,
3860: 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65  p);.}../*.** Fre
3870: 65 20 6d 65 6d 6f 72 79 20 74 68 61 74 20 6d 69  e memory that mi
3880: 67 68 74 20 62 65 20 61 73 73 6f 63 69 61 74 65  ght be associate
3890: 64 20 77 69 74 68 20 61 20 70 61 72 74 69 63 75  d with a particu
38a0: 6c 61 72 20 64 61 74 61 62 61 73 65 0a 2a 2a 20  lar database.** 
38b0: 63 6f 6e 6e 65 63 74 69 6f 6e 2e 20 20 43 61 6c  connection.  Cal
38c0: 6c 69 6e 67 20 73 71 6c 69 74 65 33 44 62 46 72  ling sqlite3DbFr
38d0: 65 65 28 44 2c 58 29 20 66 6f 72 20 58 3d 3d 30  ee(D,X) for X==0
38e0: 20 69 73 20 61 20 68 61 72 6d 6c 65 73 73 20 6e   is a harmless n
38f0: 6f 2d 6f 70 2e 0a 2a 2a 20 54 68 65 20 73 71 6c  o-op..** The sql
3900: 69 74 65 33 44 62 46 72 65 65 4e 4e 28 44 2c 58  ite3DbFreeNN(D,X
3910: 29 20 76 65 72 73 69 6f 6e 20 72 65 71 75 69 72  ) version requir
3920: 65 73 20 74 68 61 74 20 58 20 62 65 20 6e 6f 6e  es that X be non
3930: 2d 4e 55 4c 4c 2e 0a 2a 2f 0a 76 6f 69 64 20 73  -NULL..*/.void s
3940: 71 6c 69 74 65 33 44 62 46 72 65 65 4e 4e 28 73  qlite3DbFreeNN(s
3950: 71 6c 69 74 65 33 20 2a 64 62 2c 20 76 6f 69 64  qlite3 *db, void
3960: 20 2a 70 29 7b 0a 20 20 61 73 73 65 72 74 28 20   *p){.  assert( 
3970: 64 62 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65 33  db==0 || sqlite3
3980: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e  _mutex_held(db->
3990: 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65  mutex) );.  asse
39a0: 72 74 28 20 70 21 3d 30 20 29 3b 0a 20 20 69 66  rt( p!=0 );.  if
39b0: 28 20 64 62 20 29 7b 0a 20 20 20 20 69 66 28 20  ( db ){.    if( 
39c0: 64 62 2d 3e 70 6e 42 79 74 65 73 46 72 65 65 64  db->pnBytesFreed
39d0: 20 29 7b 0a 20 20 20 20 20 20 6d 65 61 73 75 72   ){.      measur
39e0: 65 41 6c 6c 6f 63 61 74 69 6f 6e 53 69 7a 65 28  eAllocationSize(
39f0: 64 62 2c 20 70 29 3b 0a 20 20 20 20 20 20 72 65  db, p);.      re
3a00: 74 75 72 6e 3b 0a 20 20 20 20 7d 0a 20 20 20 20  turn;.    }.    
3a10: 69 66 28 20 69 73 4c 6f 6f 6b 61 73 69 64 65 28  if( isLookaside(
3a20: 64 62 2c 20 70 29 20 29 7b 0a 20 20 20 20 20 20  db, p) ){.      
3a30: 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 20 2a 70  LookasideSlot *p
3a40: 42 75 66 20 3d 20 28 4c 6f 6f 6b 61 73 69 64 65  Buf = (Lookaside
3a50: 53 6c 6f 74 2a 29 70 3b 0a 23 69 66 64 65 66 20  Slot*)p;.#ifdef 
3a60: 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 20  SQLITE_DEBUG.   
3a70: 20 20 20 2f 2a 20 54 72 61 73 68 20 61 6c 6c 20     /* Trash all 
3a80: 63 6f 6e 74 65 6e 74 20 69 6e 20 74 68 65 20 62  content in the b
3a90: 75 66 66 65 72 20 62 65 69 6e 67 20 66 72 65 65  uffer being free
3aa0: 64 20 2a 2f 0a 20 20 20 20 20 20 6d 65 6d 73 65  d */.      memse
3ab0: 74 28 70 2c 20 30 78 61 61 2c 20 64 62 2d 3e 6c  t(p, 0xaa, db->l
3ac0: 6f 6f 6b 61 73 69 64 65 2e 73 7a 29 3b 0a 23 65  ookaside.sz);.#e
3ad0: 6e 64 69 66 0a 20 20 20 20 20 20 70 42 75 66 2d  ndif.      pBuf-
3ae0: 3e 70 4e 65 78 74 20 3d 20 64 62 2d 3e 6c 6f 6f  >pNext = db->loo
3af0: 6b 61 73 69 64 65 2e 70 46 72 65 65 3b 0a 20 20  kaside.pFree;.  
3b00: 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64      db->lookasid
3b10: 65 2e 70 46 72 65 65 20 3d 20 70 42 75 66 3b 0a  e.pFree = pBuf;.
3b20: 20 20 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73        db->lookas
3b30: 69 64 65 2e 6e 4f 75 74 2d 2d 3b 0a 20 20 20 20  ide.nOut--;.    
3b40: 20 20 72 65 74 75 72 6e 3b 0a 20 20 20 20 7d 0a    return;.    }.
3b50: 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 73 71    }.  assert( sq
3b60: 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 48 61 73  lite3MemdebugHas
3b70: 54 79 70 65 28 70 2c 20 28 4d 45 4d 54 59 50 45  Type(p, (MEMTYPE
3b80: 5f 4c 4f 4f 4b 41 53 49 44 45 7c 4d 45 4d 54 59  _LOOKASIDE|MEMTY
3b90: 50 45 5f 48 45 41 50 29 29 20 29 3b 0a 20 20 61  PE_HEAP)) );.  a
3ba0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d 65  ssert( sqlite3Me
3bb0: 6d 64 65 62 75 67 4e 6f 54 79 70 65 28 70 2c 20  mdebugNoType(p, 
3bc0: 28 75 38 29 7e 28 4d 45 4d 54 59 50 45 5f 4c 4f  (u8)~(MEMTYPE_LO
3bd0: 4f 4b 41 53 49 44 45 7c 4d 45 4d 54 59 50 45 5f  OKASIDE|MEMTYPE_
3be0: 48 45 41 50 29 29 20 29 3b 0a 20 20 61 73 73 65  HEAP)) );.  asse
3bf0: 72 74 28 20 64 62 21 3d 30 20 7c 7c 20 73 71 6c  rt( db!=0 || sql
3c00: 69 74 65 33 4d 65 6d 64 65 62 75 67 4e 6f 54 79  ite3MemdebugNoTy
3c10: 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 4c 4f  pe(p, MEMTYPE_LO
3c20: 4f 4b 41 53 49 44 45 29 20 29 3b 0a 20 20 73 71  OKASIDE) );.  sq
3c30: 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 53 65 74  lite3MemdebugSet
3c40: 54 79 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f  Type(p, MEMTYPE_
3c50: 48 45 41 50 29 3b 0a 20 20 73 71 6c 69 74 65 33  HEAP);.  sqlite3
3c60: 5f 66 72 65 65 28 70 29 3b 0a 7d 0a 76 6f 69 64  _free(p);.}.void
3c70: 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 73   sqlite3DbFree(s
3c80: 71 6c 69 74 65 33 20 2a 64 62 2c 20 76 6f 69 64  qlite3 *db, void
3c90: 20 2a 70 29 7b 0a 20 20 61 73 73 65 72 74 28 20   *p){.  assert( 
3ca0: 64 62 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65 33  db==0 || sqlite3
3cb0: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e  _mutex_held(db->
3cc0: 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20  mutex) );.  if( 
3cd0: 70 20 29 20 73 71 6c 69 74 65 33 44 62 46 72 65  p ) sqlite3DbFre
3ce0: 65 4e 4e 28 64 62 2c 20 70 29 3b 0a 7d 0a 0a 2f  eNN(db, p);.}../
3cf0: 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20  *.** Change the 
3d00: 73 69 7a 65 20 6f 66 20 61 6e 20 65 78 69 73 74  size of an exist
3d10: 69 6e 67 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63  ing memory alloc
3d20: 61 74 69 6f 6e 0a 2a 2f 0a 76 6f 69 64 20 2a 73  ation.*/.void *s
3d30: 71 6c 69 74 65 33 52 65 61 6c 6c 6f 63 28 76 6f  qlite3Realloc(vo
3d40: 69 64 20 2a 70 4f 6c 64 2c 20 75 36 34 20 6e 42  id *pOld, u64 nB
3d50: 79 74 65 73 29 7b 0a 20 20 69 6e 74 20 6e 4f 6c  ytes){.  int nOl
3d60: 64 2c 20 6e 4e 65 77 2c 20 6e 44 69 66 66 3b 0a  d, nNew, nDiff;.
3d70: 20 20 76 6f 69 64 20 2a 70 4e 65 77 3b 0a 20 20    void *pNew;.  
3d80: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d  assert( sqlite3M
3d90: 65 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 70  emdebugHasType(p
3da0: 4f 6c 64 2c 20 4d 45 4d 54 59 50 45 5f 48 45 41  Old, MEMTYPE_HEA
3db0: 50 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  P) );.  assert( 
3dc0: 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 4e  sqlite3MemdebugN
3dd0: 6f 54 79 70 65 28 70 4f 6c 64 2c 20 28 75 38 29  oType(pOld, (u8)
3de0: 7e 4d 45 4d 54 59 50 45 5f 48 45 41 50 29 20 29  ~MEMTYPE_HEAP) )
3df0: 3b 0a 20 20 69 66 28 20 70 4f 6c 64 3d 3d 30 20  ;.  if( pOld==0 
3e00: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 73 71  ){.    return sq
3e10: 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 6e 42 79 74  lite3Malloc(nByt
3e20: 65 73 29 3b 20 2f 2a 20 49 4d 50 3a 20 52 2d 30  es); /* IMP: R-0
3e30: 34 33 30 30 2d 35 36 37 31 32 20 2a 2f 0a 20 20  4300-56712 */.  
3e40: 7d 0a 20 20 69 66 28 20 6e 42 79 74 65 73 3d 3d  }.  if( nBytes==
3e50: 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  0 ){.    sqlite3
3e60: 5f 66 72 65 65 28 70 4f 6c 64 29 3b 20 2f 2a 20  _free(pOld); /* 
3e70: 49 4d 50 3a 20 52 2d 32 36 35 30 37 2d 34 37 34  IMP: R-26507-474
3e80: 33 31 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e  31 */.    return
3e90: 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6e 42   0;.  }.  if( nB
3ea0: 79 74 65 73 3e 3d 30 78 37 66 66 66 66 66 30 30  ytes>=0x7fffff00
3eb0: 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 30   ){.    /* The 0
3ec0: 78 37 66 66 66 66 30 30 20 6c 69 6d 69 74 20 74  x7ffff00 limit t
3ed0: 65 72 6d 20 69 73 20 65 78 70 6c 61 69 6e 65 64  erm is explained
3ee0: 20 69 6e 20 63 6f 6d 6d 65 6e 74 73 20 6f 6e 20   in comments on 
3ef0: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 29 20  sqlite3Malloc() 
3f00: 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b  */.    return 0;
3f10: 0a 20 20 7d 0a 20 20 6e 4f 6c 64 20 3d 20 73 71  .  }.  nOld = sq
3f20: 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28  lite3MallocSize(
3f30: 70 4f 6c 64 29 3b 0a 20 20 2f 2a 20 49 4d 50 4c  pOld);.  /* IMPL
3f40: 45 4d 45 4e 54 41 54 49 4f 4e 2d 4f 46 3a 20 52  EMENTATION-OF: R
3f50: 2d 34 36 31 39 39 2d 33 30 32 34 39 20 53 51 4c  -46199-30249 SQL
3f60: 69 74 65 20 67 75 61 72 61 6e 74 65 65 73 20 74  ite guarantees t
3f70: 68 61 74 20 74 68 65 20 73 65 63 6f 6e 64 0a 20  hat the second. 
3f80: 20 2a 2a 20 61 72 67 75 6d 65 6e 74 20 74 6f 20   ** argument to 
3f90: 78 52 65 61 6c 6c 6f 63 20 69 73 20 61 6c 77 61  xRealloc is alwa
3fa0: 79 73 20 61 20 76 61 6c 75 65 20 72 65 74 75 72  ys a value retur
3fb0: 6e 65 64 20 62 79 20 61 20 70 72 69 6f 72 20 63  ned by a prior c
3fc0: 61 6c 6c 20 74 6f 0a 20 20 2a 2a 20 78 52 6f 75  all to.  ** xRou
3fd0: 6e 64 75 70 2e 20 2a 2f 0a 20 20 6e 4e 65 77 20  ndup. */.  nNew 
3fe0: 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43  = sqlite3GlobalC
3ff0: 6f 6e 66 69 67 2e 6d 2e 78 52 6f 75 6e 64 75 70  onfig.m.xRoundup
4000: 28 28 69 6e 74 29 6e 42 79 74 65 73 29 3b 0a 20  ((int)nBytes);. 
4010: 20 69 66 28 20 6e 4f 6c 64 3d 3d 6e 4e 65 77 20   if( nOld==nNew 
4020: 29 7b 0a 20 20 20 20 70 4e 65 77 20 3d 20 70 4f  ){.    pNew = pO
4030: 6c 64 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20  ld;.  }else if( 
4040: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
4050: 66 69 67 2e 62 4d 65 6d 73 74 61 74 20 29 7b 0a  fig.bMemstat ){.
4060: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65      sqlite3_mute
4070: 78 5f 65 6e 74 65 72 28 6d 65 6d 30 2e 6d 75 74  x_enter(mem0.mut
4080: 65 78 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  ex);.    sqlite3
4090: 53 74 61 74 75 73 48 69 67 68 77 61 74 65 72 28  StatusHighwater(
40a0: 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d 41  SQLITE_STATUS_MA
40b0: 4c 4c 4f 43 5f 53 49 5a 45 2c 20 28 69 6e 74 29  LLOC_SIZE, (int)
40c0: 6e 42 79 74 65 73 29 3b 0a 20 20 20 20 6e 44 69  nBytes);.    nDi
40d0: 66 66 20 3d 20 6e 4e 65 77 20 2d 20 6e 4f 6c 64  ff = nNew - nOld
40e0: 3b 0a 20 20 20 20 69 66 28 20 6e 44 69 66 66 3e  ;.    if( nDiff>
40f0: 30 20 26 26 20 73 71 6c 69 74 65 33 53 74 61 74  0 && sqlite3Stat
4100: 75 73 56 61 6c 75 65 28 53 51 4c 49 54 45 5f 53  usValue(SQLITE_S
4110: 54 41 54 55 53 5f 4d 45 4d 4f 52 59 5f 55 53 45  TATUS_MEMORY_USE
4120: 44 29 20 3e 3d 20 0a 20 20 20 20 20 20 20 20 20  D) >= .         
4130: 20 6d 65 6d 30 2e 61 6c 61 72 6d 54 68 72 65 73   mem0.alarmThres
4140: 68 6f 6c 64 2d 6e 44 69 66 66 20 29 7b 0a 20 20  hold-nDiff ){.  
4150: 20 20 20 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f      sqlite3Mallo
4160: 63 41 6c 61 72 6d 28 6e 44 69 66 66 29 3b 0a 20  cAlarm(nDiff);. 
4170: 20 20 20 7d 0a 20 20 20 20 70 4e 65 77 20 3d 20     }.    pNew = 
4180: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
4190: 66 69 67 2e 6d 2e 78 52 65 61 6c 6c 6f 63 28 70  fig.m.xRealloc(p
41a0: 4f 6c 64 2c 20 6e 4e 65 77 29 3b 0a 20 20 20 20  Old, nNew);.    
41b0: 69 66 28 20 70 4e 65 77 3d 3d 30 20 26 26 20 6d  if( pNew==0 && m
41c0: 65 6d 30 2e 61 6c 61 72 6d 54 68 72 65 73 68 6f  em0.alarmThresho
41d0: 6c 64 3e 30 20 29 7b 0a 20 20 20 20 20 20 73 71  ld>0 ){.      sq
41e0: 6c 69 74 65 33 4d 61 6c 6c 6f 63 41 6c 61 72 6d  lite3MallocAlarm
41f0: 28 28 69 6e 74 29 6e 42 79 74 65 73 29 3b 0a 20  ((int)nBytes);. 
4200: 20 20 20 20 20 70 4e 65 77 20 3d 20 73 71 6c 69       pNew = sqli
4210: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e  te3GlobalConfig.
4220: 6d 2e 78 52 65 61 6c 6c 6f 63 28 70 4f 6c 64 2c  m.xRealloc(pOld,
4230: 20 6e 4e 65 77 29 3b 0a 20 20 20 20 7d 0a 20 20   nNew);.    }.  
4240: 20 20 69 66 28 20 70 4e 65 77 20 29 7b 0a 20 20    if( pNew ){.  
4250: 20 20 20 20 6e 4e 65 77 20 3d 20 73 71 6c 69 74      nNew = sqlit
4260: 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 4e 65  e3MallocSize(pNe
4270: 77 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  w);.      sqlite
4280: 33 53 74 61 74 75 73 55 70 28 53 51 4c 49 54 45  3StatusUp(SQLITE
4290: 5f 53 54 41 54 55 53 5f 4d 45 4d 4f 52 59 5f 55  _STATUS_MEMORY_U
42a0: 53 45 44 2c 20 6e 4e 65 77 2d 6e 4f 6c 64 29 3b  SED, nNew-nOld);
42b0: 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74  .    }.    sqlit
42c0: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d  e3_mutex_leave(m
42d0: 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 7d 65  em0.mutex);.  }e
42e0: 6c 73 65 7b 0a 20 20 20 20 70 4e 65 77 20 3d 20  lse{.    pNew = 
42f0: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
4300: 66 69 67 2e 6d 2e 78 52 65 61 6c 6c 6f 63 28 70  fig.m.xRealloc(p
4310: 4f 6c 64 2c 20 6e 4e 65 77 29 3b 0a 20 20 7d 0a  Old, nNew);.  }.
4320: 20 20 61 73 73 65 72 74 28 20 45 49 47 48 54 5f    assert( EIGHT_
4330: 42 59 54 45 5f 41 4c 49 47 4e 4d 45 4e 54 28 70  BYTE_ALIGNMENT(p
4340: 4e 65 77 29 20 29 3b 20 2f 2a 20 49 4d 50 3a 20  New) ); /* IMP: 
4350: 52 2d 31 31 31 34 38 2d 34 30 39 39 35 20 2a 2f  R-11148-40995 */
4360: 0a 20 20 72 65 74 75 72 6e 20 70 4e 65 77 3b 0a  .  return pNew;.
4370: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 70 75 62  }../*.** The pub
4380: 6c 69 63 20 69 6e 74 65 72 66 61 63 65 20 74 6f  lic interface to
4390: 20 73 71 6c 69 74 65 33 52 65 61 6c 6c 6f 63 2e   sqlite3Realloc.
43a0: 20 20 4d 61 6b 65 20 73 75 72 65 20 74 68 61 74    Make sure that
43b0: 20 74 68 65 20 6d 65 6d 6f 72 79 0a 2a 2a 20 73   the memory.** s
43c0: 75 62 73 79 73 74 65 6d 20 69 73 20 69 6e 69 74  ubsystem is init
43d0: 69 61 6c 69 7a 65 64 20 70 72 69 6f 72 20 74 6f  ialized prior to
43e0: 20 69 6e 76 6f 6b 69 6e 67 20 73 71 6c 69 74 65   invoking sqlite
43f0: 52 65 61 6c 6c 6f 63 2e 0a 2a 2f 0a 76 6f 69 64  Realloc..*/.void
4400: 20 2a 73 71 6c 69 74 65 33 5f 72 65 61 6c 6c 6f   *sqlite3_reallo
4410: 63 28 76 6f 69 64 20 2a 70 4f 6c 64 2c 20 69 6e  c(void *pOld, in
4420: 74 20 6e 29 7b 0a 23 69 66 6e 64 65 66 20 53 51  t n){.#ifndef SQ
4430: 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e  LITE_OMIT_AUTOIN
4440: 49 54 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33  IT.  if( sqlite3
4450: 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 20 29 20  _initialize() ) 
4460: 72 65 74 75 72 6e 20 30 3b 0a 23 65 6e 64 69 66  return 0;.#endif
4470: 0a 20 20 69 66 28 20 6e 3c 30 20 29 20 6e 20 3d  .  if( n<0 ) n =
4480: 20 30 3b 20 20 2f 2a 20 49 4d 50 3a 20 52 2d 32   0;  /* IMP: R-2
4490: 36 35 30 37 2d 34 37 34 33 31 20 2a 2f 0a 20 20  6507-47431 */.  
44a0: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 52 65  return sqlite3Re
44b0: 61 6c 6c 6f 63 28 70 4f 6c 64 2c 20 6e 29 3b 0a  alloc(pOld, n);.
44c0: 7d 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f  }.void *sqlite3_
44d0: 72 65 61 6c 6c 6f 63 36 34 28 76 6f 69 64 20 2a  realloc64(void *
44e0: 70 4f 6c 64 2c 20 73 71 6c 69 74 65 33 5f 75 69  pOld, sqlite3_ui
44f0: 6e 74 36 34 20 6e 29 7b 0a 23 69 66 6e 64 65 66  nt64 n){.#ifndef
4500: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54   SQLITE_OMIT_AUT
4510: 4f 49 4e 49 54 0a 20 20 69 66 28 20 73 71 6c 69  OINIT.  if( sqli
4520: 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29  te3_initialize()
4530: 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 23 65 6e   ) return 0;.#en
4540: 64 69 66 0a 20 20 72 65 74 75 72 6e 20 73 71 6c  dif.  return sql
4550: 69 74 65 33 52 65 61 6c 6c 6f 63 28 70 4f 6c 64  ite3Realloc(pOld
4560: 2c 20 6e 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20  , n);.}.../*.** 
4570: 41 6c 6c 6f 63 61 74 65 20 61 6e 64 20 7a 65 72  Allocate and zer
4580: 6f 20 6d 65 6d 6f 72 79 2e 0a 2a 2f 20 0a 76 6f  o memory..*/ .vo
4590: 69 64 20 2a 73 71 6c 69 74 65 33 4d 61 6c 6c 6f  id *sqlite3Mallo
45a0: 63 5a 65 72 6f 28 75 36 34 20 6e 29 7b 0a 20 20  cZero(u64 n){.  
45b0: 76 6f 69 64 20 2a 70 20 3d 20 73 71 6c 69 74 65  void *p = sqlite
45c0: 33 4d 61 6c 6c 6f 63 28 6e 29 3b 0a 20 20 69 66  3Malloc(n);.  if
45d0: 28 20 70 20 29 7b 0a 20 20 20 20 6d 65 6d 73 65  ( p ){.    memse
45e0: 74 28 70 2c 20 30 2c 20 28 73 69 7a 65 5f 74 29  t(p, 0, (size_t)
45f0: 6e 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e  n);.  }.  return
4600: 20 70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c   p;.}../*.** All
4610: 6f 63 61 74 65 20 61 6e 64 20 7a 65 72 6f 20 6d  ocate and zero m
4620: 65 6d 6f 72 79 2e 20 20 49 66 20 74 68 65 20 61  emory.  If the a
4630: 6c 6c 6f 63 61 74 69 6f 6e 20 66 61 69 6c 73 2c  llocation fails,
4640: 20 6d 61 6b 65 0a 2a 2a 20 74 68 65 20 6d 61 6c   make.** the mal
4650: 6c 6f 63 46 61 69 6c 65 64 20 66 6c 61 67 20 69  locFailed flag i
4660: 6e 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  n the connection
4670: 20 70 6f 69 6e 74 65 72 2e 0a 2a 2f 0a 76 6f 69   pointer..*/.voi
4680: 64 20 2a 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c  d *sqlite3DbMall
4690: 6f 63 5a 65 72 6f 28 73 71 6c 69 74 65 33 20 2a  ocZero(sqlite3 *
46a0: 64 62 2c 20 75 36 34 20 6e 29 7b 0a 20 20 76 6f  db, u64 n){.  vo
46b0: 69 64 20 2a 70 3b 0a 20 20 74 65 73 74 63 61 73  id *p;.  testcas
46c0: 65 28 20 64 62 3d 3d 30 20 29 3b 0a 20 20 70 20  e( db==0 );.  p 
46d0: 3d 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f  = sqlite3DbMallo
46e0: 63 52 61 77 28 64 62 2c 20 6e 29 3b 0a 20 20 69  cRaw(db, n);.  i
46f0: 66 28 20 70 20 29 20 6d 65 6d 73 65 74 28 70 2c  f( p ) memset(p,
4700: 20 30 2c 20 28 73 69 7a 65 5f 74 29 6e 29 3b 0a   0, (size_t)n);.
4710: 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 0a    return p;.}...
4720: 2f 2a 20 46 69 6e 69 73 68 20 74 68 65 20 77 6f  /* Finish the wo
4730: 72 6b 20 6f 66 20 73 71 6c 69 74 65 33 44 62 4d  rk of sqlite3DbM
4740: 61 6c 6c 6f 63 52 61 77 4e 4e 20 66 6f 72 20 74  allocRawNN for t
4750: 68 65 20 75 6e 75 73 75 61 6c 20 61 6e 64 0a 2a  he unusual and.*
4760: 2a 20 73 6c 6f 77 65 72 20 63 61 73 65 20 77 68  * slower case wh
4770: 65 6e 20 74 68 65 20 61 6c 6c 6f 63 61 74 69 6f  en the allocatio
4780: 6e 20 63 61 6e 6e 6f 74 20 62 65 20 66 75 6c 66  n cannot be fulf
4790: 69 6c 6c 65 64 20 75 73 69 6e 67 20 6c 6f 6f 6b  illed using look
47a0: 61 73 69 64 65 2e 0a 2a 2f 0a 73 74 61 74 69 63  aside..*/.static
47b0: 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45   SQLITE_NOINLINE
47c0: 20 76 6f 69 64 20 2a 64 62 4d 61 6c 6c 6f 63 52   void *dbMallocR
47d0: 61 77 46 69 6e 69 73 68 28 73 71 6c 69 74 65 33  awFinish(sqlite3
47e0: 20 2a 64 62 2c 20 75 36 34 20 6e 29 7b 0a 20 20   *db, u64 n){.  
47f0: 76 6f 69 64 20 2a 70 3b 0a 20 20 61 73 73 65 72  void *p;.  asser
4800: 74 28 20 64 62 21 3d 30 20 29 3b 0a 20 20 70 20  t( db!=0 );.  p 
4810: 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28  = sqlite3Malloc(
4820: 6e 29 3b 0a 20 20 69 66 28 20 21 70 20 29 20 73  n);.  if( !p ) s
4830: 71 6c 69 74 65 33 4f 6f 6d 46 61 75 6c 74 28 64  qlite3OomFault(d
4840: 62 29 3b 0a 20 20 73 71 6c 69 74 65 33 4d 65 6d  b);.  sqlite3Mem
4850: 64 65 62 75 67 53 65 74 54 79 70 65 28 70 2c 20  debugSetType(p, 
4860: 0a 20 20 20 20 20 20 20 20 20 28 64 62 2d 3e 6c  .         (db->l
4870: 6f 6f 6b 61 73 69 64 65 2e 62 44 69 73 61 62 6c  ookaside.bDisabl
4880: 65 3d 3d 30 29 20 3f 20 4d 45 4d 54 59 50 45 5f  e==0) ? MEMTYPE_
4890: 4c 4f 4f 4b 41 53 49 44 45 20 3a 20 4d 45 4d 54  LOOKASIDE : MEMT
48a0: 59 50 45 5f 48 45 41 50 29 3b 0a 20 20 72 65 74  YPE_HEAP);.  ret
48b0: 75 72 6e 20 70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  urn p;.}../*.** 
48c0: 41 6c 6c 6f 63 61 74 65 20 6d 65 6d 6f 72 79 2c  Allocate memory,
48d0: 20 65 69 74 68 65 72 20 6c 6f 6f 6b 61 73 69 64   either lookasid
48e0: 65 20 28 69 66 20 70 6f 73 73 69 62 6c 65 29 20  e (if possible) 
48f0: 6f 72 20 68 65 61 70 2e 20 20 0a 2a 2a 20 49 66  or heap.  .** If
4900: 20 74 68 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 20   the allocation 
4910: 66 61 69 6c 73 2c 20 73 65 74 20 74 68 65 20 6d  fails, set the m
4920: 61 6c 6c 6f 63 46 61 69 6c 65 64 20 66 6c 61 67  allocFailed flag
4930: 20 69 6e 0a 2a 2a 20 74 68 65 20 63 6f 6e 6e 65   in.** the conne
4940: 63 74 69 6f 6e 20 70 6f 69 6e 74 65 72 2e 0a 2a  ction pointer..*
4950: 2a 0a 2a 2a 20 49 66 20 64 62 21 3d 30 20 61 6e  *.** If db!=0 an
4960: 64 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c  d db->mallocFail
4970: 65 64 20 69 73 20 74 72 75 65 20 28 69 6e 64 69  ed is true (indi
4980: 63 61 74 69 6e 67 20 61 20 70 72 69 6f 72 20 6d  cating a prior m
4990: 61 6c 6c 6f 63 0a 2a 2a 20 66 61 69 6c 75 72 65  alloc.** failure
49a0: 20 6f 6e 20 74 68 65 20 73 61 6d 65 20 64 61 74   on the same dat
49b0: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  abase connection
49c0: 29 20 74 68 65 6e 20 61 6c 77 61 79 73 20 72 65  ) then always re
49d0: 74 75 72 6e 20 30 2e 0a 2a 2a 20 48 65 6e 63 65  turn 0..** Hence
49e0: 20 66 6f 72 20 61 20 70 61 72 74 69 63 75 6c 61   for a particula
49f0: 72 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65  r database conne
4a00: 63 74 69 6f 6e 2c 20 6f 6e 63 65 20 6d 61 6c 6c  ction, once mall
4a10: 6f 63 20 73 74 61 72 74 73 0a 2a 2a 20 66 61 69  oc starts.** fai
4a20: 6c 69 6e 67 2c 20 69 74 20 66 61 69 6c 73 20 63  ling, it fails c
4a30: 6f 6e 73 69 73 74 65 6e 74 6c 79 20 75 6e 74 69  onsistently unti
4a40: 6c 20 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 69  l mallocFailed i
4a50: 73 20 72 65 73 65 74 2e 0a 2a 2a 20 54 68 69 73  s reset..** This
4a60: 20 69 73 20 61 6e 20 69 6d 70 6f 72 74 61 6e 74   is an important
4a70: 20 61 73 73 75 6d 70 74 69 6f 6e 2e 20 20 54 68   assumption.  Th
4a80: 65 72 65 20 61 72 65 20 6d 61 6e 79 20 70 6c 61  ere are many pla
4a90: 63 65 73 20 69 6e 20 74 68 65 0a 2a 2a 20 63 6f  ces in the.** co
4aa0: 64 65 20 74 68 61 74 20 64 6f 20 74 68 69 6e 67  de that do thing
4ab0: 73 20 6c 69 6b 65 20 74 68 69 73 3a 0a 2a 2a 0a  s like this:.**.
4ac0: 2a 2a 20 20 20 20 20 20 20 20 20 69 6e 74 20 2a  **         int *
4ad0: 61 20 3d 20 28 69 6e 74 2a 29 73 71 6c 69 74 65  a = (int*)sqlite
4ae0: 33 44 62 4d 61 6c 6c 6f 63 52 61 77 28 64 62 2c  3DbMallocRaw(db,
4af0: 20 31 30 30 29 3b 0a 2a 2a 20 20 20 20 20 20 20   100);.**       
4b00: 20 20 69 6e 74 20 2a 62 20 3d 20 28 69 6e 74 2a    int *b = (int*
4b10: 29 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63  )sqlite3DbMalloc
4b20: 52 61 77 28 64 62 2c 20 32 30 30 29 3b 0a 2a 2a  Raw(db, 200);.**
4b30: 20 20 20 20 20 20 20 20 20 69 66 28 20 62 20 29           if( b )
4b40: 20 61 5b 31 30 5d 20 3d 20 39 3b 0a 2a 2a 0a 2a   a[10] = 9;.**.*
4b50: 2a 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73  * In other words
4b60: 2c 20 69 66 20 61 20 73 75 62 73 65 71 75 65 6e  , if a subsequen
4b70: 74 20 6d 61 6c 6c 6f 63 20 28 65 78 3a 20 22 62  t malloc (ex: "b
4b80: 22 29 20 77 6f 72 6b 65 64 2c 20 69 74 20 69 73  ") worked, it is
4b90: 20 61 73 73 75 6d 65 64 0a 2a 2a 20 74 68 61 74   assumed.** that
4ba0: 20 61 6c 6c 20 70 72 69 6f 72 20 6d 61 6c 6c 6f   all prior mallo
4bb0: 63 73 20 28 65 78 3a 20 22 61 22 29 20 77 6f 72  cs (ex: "a") wor
4bc0: 6b 65 64 20 74 6f 6f 2e 0a 2a 2a 0a 2a 2a 20 54  ked too..**.** T
4bd0: 68 65 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63  he sqlite3Malloc
4be0: 52 61 77 4e 4e 28 29 20 76 61 72 69 61 6e 74 20  RawNN() variant 
4bf0: 67 75 61 72 61 6e 74 65 65 73 20 74 68 61 74 20  guarantees that 
4c00: 74 68 65 20 22 64 62 22 20 70 61 72 61 6d 65 74  the "db" paramet
4c10: 65 72 20 69 73 0a 2a 2a 20 6e 6f 74 20 61 20 4e  er is.** not a N
4c20: 55 4c 4c 20 70 6f 69 6e 74 65 72 2e 0a 2a 2f 0a  ULL pointer..*/.
4c30: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 44 62 4d  void *sqlite3DbM
4c40: 61 6c 6c 6f 63 52 61 77 28 73 71 6c 69 74 65 33  allocRaw(sqlite3
4c50: 20 2a 64 62 2c 20 75 36 34 20 6e 29 7b 0a 20 20   *db, u64 n){.  
4c60: 76 6f 69 64 20 2a 70 3b 0a 20 20 69 66 28 20 64  void *p;.  if( d
4c70: 62 20 29 20 72 65 74 75 72 6e 20 73 71 6c 69 74  b ) return sqlit
4c80: 65 33 44 62 4d 61 6c 6c 6f 63 52 61 77 4e 4e 28  e3DbMallocRawNN(
4c90: 64 62 2c 20 6e 29 3b 0a 20 20 70 20 3d 20 73 71  db, n);.  p = sq
4ca0: 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 6e 29 3b 0a  lite3Malloc(n);.
4cb0: 20 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75    sqlite3Memdebu
4cc0: 67 53 65 74 54 79 70 65 28 70 2c 20 4d 45 4d 54  gSetType(p, MEMT
4cd0: 59 50 45 5f 48 45 41 50 29 3b 0a 20 20 72 65 74  YPE_HEAP);.  ret
4ce0: 75 72 6e 20 70 3b 0a 7d 0a 76 6f 69 64 20 2a 73  urn p;.}.void *s
4cf0: 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 52 61  qlite3DbMallocRa
4d00: 77 4e 4e 28 73 71 6c 69 74 65 33 20 2a 64 62 2c  wNN(sqlite3 *db,
4d10: 20 75 36 34 20 6e 29 7b 0a 23 69 66 6e 64 65 66   u64 n){.#ifndef
4d20: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4c 4f 4f   SQLITE_OMIT_LOO
4d30: 4b 41 53 49 44 45 0a 20 20 4c 6f 6f 6b 61 73 69  KASIDE.  Lookasi
4d40: 64 65 53 6c 6f 74 20 2a 70 42 75 66 3b 0a 20 20  deSlot *pBuf;.  
4d50: 61 73 73 65 72 74 28 20 64 62 21 3d 30 20 29 3b  assert( db!=0 );
4d60: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74  .  assert( sqlit
4d70: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62  e3_mutex_held(db
4d80: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73  ->mutex) );.  as
4d90: 73 65 72 74 28 20 64 62 2d 3e 70 6e 42 79 74 65  sert( db->pnByte
4da0: 73 46 72 65 65 64 3d 3d 30 20 29 3b 0a 20 20 69  sFreed==0 );.  i
4db0: 66 28 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65  f( db->lookaside
4dc0: 2e 62 44 69 73 61 62 6c 65 3d 3d 30 20 29 7b 0a  .bDisable==0 ){.
4dd0: 20 20 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e      assert( db->
4de0: 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 3d 3d 30 20  mallocFailed==0 
4df0: 29 3b 0a 20 20 20 20 69 66 28 20 6e 3e 64 62 2d  );.    if( n>db-
4e00: 3e 6c 6f 6f 6b 61 73 69 64 65 2e 73 7a 20 29 7b  >lookaside.sz ){
4e10: 0a 20 20 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61  .      db->looka
4e20: 73 69 64 65 2e 61 6e 53 74 61 74 5b 31 5d 2b 2b  side.anStat[1]++
4e30: 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20  ;.    }else if( 
4e40: 28 70 42 75 66 20 3d 20 64 62 2d 3e 6c 6f 6f 6b  (pBuf = db->look
4e50: 61 73 69 64 65 2e 70 46 72 65 65 29 3d 3d 30 20  aside.pFree)==0 
4e60: 29 7b 0a 20 20 20 20 20 20 64 62 2d 3e 6c 6f 6f  ){.      db->loo
4e70: 6b 61 73 69 64 65 2e 61 6e 53 74 61 74 5b 32 5d  kaside.anStat[2]
4e80: 2b 2b 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20  ++;.    }else{. 
4e90: 20 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69       db->lookasi
4ea0: 64 65 2e 70 46 72 65 65 20 3d 20 70 42 75 66 2d  de.pFree = pBuf-
4eb0: 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 64 62  >pNext;.      db
4ec0: 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 6e 4f 75 74  ->lookaside.nOut
4ed0: 2b 2b 3b 0a 20 20 20 20 20 20 64 62 2d 3e 6c 6f  ++;.      db->lo
4ee0: 6f 6b 61 73 69 64 65 2e 61 6e 53 74 61 74 5b 30  okaside.anStat[0
4ef0: 5d 2b 2b 3b 0a 20 20 20 20 20 20 69 66 28 20 64  ]++;.      if( d
4f00: 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 6e 4f 75  b->lookaside.nOu
4f10: 74 3e 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e  t>db->lookaside.
4f20: 6d 78 4f 75 74 20 29 7b 0a 20 20 20 20 20 20 20  mxOut ){.       
4f30: 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 6d   db->lookaside.m
4f40: 78 4f 75 74 20 3d 20 64 62 2d 3e 6c 6f 6f 6b 61  xOut = db->looka
4f50: 73 69 64 65 2e 6e 4f 75 74 3b 0a 20 20 20 20 20  side.nOut;.     
4f60: 20 7d 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20   }.      return 
4f70: 28 76 6f 69 64 2a 29 70 42 75 66 3b 0a 20 20 20  (void*)pBuf;.   
4f80: 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 64   }.  }else if( d
4f90: 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20  b->mallocFailed 
4fa0: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b  ){.    return 0;
4fb0: 0a 20 20 7d 0a 23 65 6c 73 65 0a 20 20 61 73 73  .  }.#else.  ass
4fc0: 65 72 74 28 20 64 62 21 3d 30 20 29 3b 0a 20 20  ert( db!=0 );.  
4fd0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f  assert( sqlite3_
4fe0: 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d  mutex_held(db->m
4ff0: 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72  utex) );.  asser
5000: 74 28 20 64 62 2d 3e 70 6e 42 79 74 65 73 46 72  t( db->pnBytesFr
5010: 65 65 64 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20  eed==0 );.  if( 
5020: 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64  db->mallocFailed
5030: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30   ){.    return 0
5040: 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 72  ;.  }.#endif.  r
5050: 65 74 75 72 6e 20 64 62 4d 61 6c 6c 6f 63 52 61  eturn dbMallocRa
5060: 77 46 69 6e 69 73 68 28 64 62 2c 20 6e 29 3b 0a  wFinish(db, n);.
5070: 7d 0a 0a 2f 2a 20 46 6f 72 77 61 72 64 20 64 65  }../* Forward de
5080: 63 6c 61 72 61 74 69 6f 6e 20 2a 2f 0a 73 74 61  claration */.sta
5090: 74 69 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c  tic SQLITE_NOINL
50a0: 49 4e 45 20 76 6f 69 64 20 2a 64 62 52 65 61 6c  INE void *dbReal
50b0: 6c 6f 63 46 69 6e 69 73 68 28 73 71 6c 69 74 65  locFinish(sqlite
50c0: 33 20 2a 64 62 2c 20 76 6f 69 64 20 2a 70 2c 20  3 *db, void *p, 
50d0: 75 36 34 20 6e 29 3b 0a 0a 2f 2a 0a 2a 2a 20 52  u64 n);../*.** R
50e0: 65 73 69 7a 65 20 74 68 65 20 62 6c 6f 63 6b 20  esize the block 
50f0: 6f 66 20 6d 65 6d 6f 72 79 20 70 6f 69 6e 74 65  of memory pointe
5100: 64 20 74 6f 20 62 79 20 70 20 74 6f 20 6e 20 62  d to by p to n b
5110: 79 74 65 73 2e 20 49 66 20 74 68 65 0a 2a 2a 20  ytes. If the.** 
5120: 72 65 73 69 7a 65 20 66 61 69 6c 73 2c 20 73 65  resize fails, se
5130: 74 20 74 68 65 20 6d 61 6c 6c 6f 63 46 61 69 6c  t the mallocFail
5140: 65 64 20 66 6c 61 67 20 69 6e 20 74 68 65 20 63  ed flag in the c
5150: 6f 6e 6e 65 63 74 69 6f 6e 20 6f 62 6a 65 63 74  onnection object
5160: 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74  ..*/.void *sqlit
5170: 65 33 44 62 52 65 61 6c 6c 6f 63 28 73 71 6c 69  e3DbRealloc(sqli
5180: 74 65 33 20 2a 64 62 2c 20 76 6f 69 64 20 2a 70  te3 *db, void *p
5190: 2c 20 75 36 34 20 6e 29 7b 0a 20 20 61 73 73 65  , u64 n){.  asse
51a0: 72 74 28 20 64 62 21 3d 30 20 29 3b 0a 20 20 69  rt( db!=0 );.  i
51b0: 66 28 20 70 3d 3d 30 20 29 20 72 65 74 75 72 6e  f( p==0 ) return
51c0: 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63   sqlite3DbMalloc
51d0: 52 61 77 4e 4e 28 64 62 2c 20 6e 29 3b 0a 20 20  RawNN(db, n);.  
51e0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f  assert( sqlite3_
51f0: 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d  mutex_held(db->m
5200: 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 69  utex) );.  if( i
5210: 73 4c 6f 6f 6b 61 73 69 64 65 28 64 62 2c 70 29  sLookaside(db,p)
5220: 20 26 26 20 6e 3c 3d 64 62 2d 3e 6c 6f 6f 6b 61   && n<=db->looka
5230: 73 69 64 65 2e 73 7a 20 29 20 72 65 74 75 72 6e  side.sz ) return
5240: 20 70 3b 0a 20 20 72 65 74 75 72 6e 20 64 62 52   p;.  return dbR
5250: 65 61 6c 6c 6f 63 46 69 6e 69 73 68 28 64 62 2c  eallocFinish(db,
5260: 20 70 2c 20 6e 29 3b 0a 7d 0a 73 74 61 74 69 63   p, n);.}.static
5270: 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45   SQLITE_NOINLINE
5280: 20 76 6f 69 64 20 2a 64 62 52 65 61 6c 6c 6f 63   void *dbRealloc
5290: 46 69 6e 69 73 68 28 73 71 6c 69 74 65 33 20 2a  Finish(sqlite3 *
52a0: 64 62 2c 20 76 6f 69 64 20 2a 70 2c 20 75 36 34  db, void *p, u64
52b0: 20 6e 29 7b 0a 20 20 76 6f 69 64 20 2a 70 4e 65   n){.  void *pNe
52c0: 77 20 3d 20 30 3b 0a 20 20 61 73 73 65 72 74 28  w = 0;.  assert(
52d0: 20 64 62 21 3d 30 20 29 3b 0a 20 20 61 73 73 65   db!=0 );.  asse
52e0: 72 74 28 20 70 21 3d 30 20 29 3b 0a 20 20 69 66  rt( p!=0 );.  if
52f0: 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c  ( db->mallocFail
5300: 65 64 3d 3d 30 20 29 7b 0a 20 20 20 20 69 66 28  ed==0 ){.    if(
5310: 20 69 73 4c 6f 6f 6b 61 73 69 64 65 28 64 62 2c   isLookaside(db,
5320: 20 70 29 20 29 7b 0a 20 20 20 20 20 20 70 4e 65   p) ){.      pNe
5330: 77 20 3d 20 73 71 6c 69 74 65 33 44 62 4d 61 6c  w = sqlite3DbMal
5340: 6c 6f 63 52 61 77 4e 4e 28 64 62 2c 20 6e 29 3b  locRawNN(db, n);
5350: 0a 20 20 20 20 20 20 69 66 28 20 70 4e 65 77 20  .      if( pNew 
5360: 29 7b 0a 20 20 20 20 20 20 20 20 6d 65 6d 63 70  ){.        memcp
5370: 79 28 70 4e 65 77 2c 20 70 2c 20 64 62 2d 3e 6c  y(pNew, p, db->l
5380: 6f 6f 6b 61 73 69 64 65 2e 73 7a 29 3b 0a 20 20  ookaside.sz);.  
5390: 20 20 20 20 20 20 73 71 6c 69 74 65 33 44 62 46        sqlite3DbF
53a0: 72 65 65 28 64 62 2c 20 70 29 3b 0a 20 20 20 20  ree(db, p);.    
53b0: 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20    }.    }else{. 
53c0: 20 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c       assert( sql
53d0: 69 74 65 33 4d 65 6d 64 65 62 75 67 48 61 73 54  ite3MemdebugHasT
53e0: 79 70 65 28 70 2c 20 28 4d 45 4d 54 59 50 45 5f  ype(p, (MEMTYPE_
53f0: 4c 4f 4f 4b 41 53 49 44 45 7c 4d 45 4d 54 59 50  LOOKASIDE|MEMTYP
5400: 45 5f 48 45 41 50 29 29 20 29 3b 0a 20 20 20 20  E_HEAP)) );.    
5410: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
5420: 33 4d 65 6d 64 65 62 75 67 4e 6f 54 79 70 65 28  3MemdebugNoType(
5430: 70 2c 20 28 75 38 29 7e 28 4d 45 4d 54 59 50 45  p, (u8)~(MEMTYPE
5440: 5f 4c 4f 4f 4b 41 53 49 44 45 7c 4d 45 4d 54 59  _LOOKASIDE|MEMTY
5450: 50 45 5f 48 45 41 50 29 29 20 29 3b 0a 20 20 20  PE_HEAP)) );.   
5460: 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62     sqlite3Memdeb
5470: 75 67 53 65 74 54 79 70 65 28 70 2c 20 4d 45 4d  ugSetType(p, MEM
5480: 54 59 50 45 5f 48 45 41 50 29 3b 0a 20 20 20 20  TYPE_HEAP);.    
5490: 20 20 70 4e 65 77 20 3d 20 73 71 6c 69 74 65 33    pNew = sqlite3
54a0: 5f 72 65 61 6c 6c 6f 63 36 34 28 70 2c 20 6e 29  _realloc64(p, n)
54b0: 3b 0a 20 20 20 20 20 20 69 66 28 20 21 70 4e 65  ;.      if( !pNe
54c0: 77 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c  w ){.        sql
54d0: 69 74 65 33 4f 6f 6d 46 61 75 6c 74 28 64 62 29  ite3OomFault(db)
54e0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
54f0: 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 53  sqlite3MemdebugS
5500: 65 74 54 79 70 65 28 70 4e 65 77 2c 0a 20 20 20  etType(pNew,.   
5510: 20 20 20 20 20 20 20 20 20 28 64 62 2d 3e 6c 6f           (db->lo
5520: 6f 6b 61 73 69 64 65 2e 62 44 69 73 61 62 6c 65  okaside.bDisable
5530: 3d 3d 30 20 3f 20 4d 45 4d 54 59 50 45 5f 4c 4f  ==0 ? MEMTYPE_LO
5540: 4f 4b 41 53 49 44 45 20 3a 20 4d 45 4d 54 59 50  OKASIDE : MEMTYP
5550: 45 5f 48 45 41 50 29 29 3b 0a 20 20 20 20 7d 0a  E_HEAP));.    }.
5560: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 4e 65    }.  return pNe
5570: 77 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 65  w;.}../*.** Atte
5580: 6d 70 74 20 74 6f 20 72 65 61 6c 6c 6f 63 61 74  mpt to reallocat
5590: 65 20 70 2e 20 20 49 66 20 74 68 65 20 72 65 61  e p.  If the rea
55a0: 6c 6c 6f 63 61 74 69 6f 6e 20 66 61 69 6c 73 2c  llocation fails,
55b0: 20 74 68 65 6e 20 66 72 65 65 20 70 0a 2a 2a 20   then free p.** 
55c0: 61 6e 64 20 73 65 74 20 74 68 65 20 6d 61 6c 6c  and set the mall
55d0: 6f 63 46 61 69 6c 65 64 20 66 6c 61 67 20 69 6e  ocFailed flag in
55e0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 63 6f   the database co
55f0: 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69  nnection..*/.voi
5600: 64 20 2a 73 71 6c 69 74 65 33 44 62 52 65 61 6c  d *sqlite3DbReal
5610: 6c 6f 63 4f 72 46 72 65 65 28 73 71 6c 69 74 65  locOrFree(sqlite
5620: 33 20 2a 64 62 2c 20 76 6f 69 64 20 2a 70 2c 20  3 *db, void *p, 
5630: 75 36 34 20 6e 29 7b 0a 20 20 76 6f 69 64 20 2a  u64 n){.  void *
5640: 70 4e 65 77 3b 0a 20 20 70 4e 65 77 20 3d 20 73  pNew;.  pNew = s
5650: 71 6c 69 74 65 33 44 62 52 65 61 6c 6c 6f 63 28  qlite3DbRealloc(
5660: 64 62 2c 20 70 2c 20 6e 29 3b 0a 20 20 69 66 28  db, p, n);.  if(
5670: 20 21 70 4e 65 77 20 29 7b 0a 20 20 20 20 73 71   !pNew ){.    sq
5680: 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20  lite3DbFree(db, 
5690: 70 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e  p);.  }.  return
56a0: 20 70 4e 65 77 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20   pNew;.}../*.** 
56b0: 4d 61 6b 65 20 61 20 63 6f 70 79 20 6f 66 20 61  Make a copy of a
56c0: 20 73 74 72 69 6e 67 20 69 6e 20 6d 65 6d 6f 72   string in memor
56d0: 79 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20  y obtained from 
56e0: 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 29 2e 20  sqliteMalloc(). 
56f0: 54 68 65 73 65 20 0a 2a 2a 20 66 75 6e 63 74 69  These .** functi
5700: 6f 6e 73 20 63 61 6c 6c 20 73 71 6c 69 74 65 33  ons call sqlite3
5710: 4d 61 6c 6c 6f 63 52 61 77 28 29 20 64 69 72 65  MallocRaw() dire
5720: 63 74 6c 79 20 69 6e 73 74 65 61 64 20 6f 66 20  ctly instead of 
5730: 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 29 2e 20  sqliteMalloc(). 
5740: 54 68 69 73 0a 2a 2a 20 69 73 20 62 65 63 61 75  This.** is becau
5750: 73 65 20 77 68 65 6e 20 6d 65 6d 6f 72 79 20 64  se when memory d
5760: 65 62 75 67 67 69 6e 67 20 69 73 20 74 75 72 6e  ebugging is turn
5770: 65 64 20 6f 6e 2c 20 74 68 65 73 65 20 74 77 6f  ed on, these two
5780: 20 66 75 6e 63 74 69 6f 6e 73 20 61 72 65 20 0a   functions are .
5790: 2a 2a 20 63 61 6c 6c 65 64 20 76 69 61 20 6d 61  ** called via ma
57a0: 63 72 6f 73 20 74 68 61 74 20 72 65 63 6f 72 64  cros that record
57b0: 20 74 68 65 20 63 75 72 72 65 6e 74 20 66 69 6c   the current fil
57c0: 65 20 61 6e 64 20 6c 69 6e 65 20 6e 75 6d 62 65  e and line numbe
57d0: 72 20 69 6e 20 74 68 65 0a 2a 2a 20 54 68 72 65  r in the.** Thre
57e0: 61 64 44 61 74 61 20 73 74 72 75 63 74 75 72 65  adData structure
57f0: 2e 0a 2a 2f 0a 63 68 61 72 20 2a 73 71 6c 69 74  ..*/.char *sqlit
5800: 65 33 44 62 53 74 72 44 75 70 28 73 71 6c 69 74  e3DbStrDup(sqlit
5810: 65 33 20 2a 64 62 2c 20 63 6f 6e 73 74 20 63 68  e3 *db, const ch
5820: 61 72 20 2a 7a 29 7b 0a 20 20 63 68 61 72 20 2a  ar *z){.  char *
5830: 7a 4e 65 77 3b 0a 20 20 73 69 7a 65 5f 74 20 6e  zNew;.  size_t n
5840: 3b 0a 20 20 69 66 28 20 7a 3d 3d 30 20 29 7b 0a  ;.  if( z==0 ){.
5850: 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20      return 0;.  
5860: 7d 0a 20 20 6e 20 3d 20 73 74 72 6c 65 6e 28 7a  }.  n = strlen(z
5870: 29 20 2b 20 31 3b 0a 20 20 7a 4e 65 77 20 3d 20  ) + 1;.  zNew = 
5880: 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 52  sqlite3DbMallocR
5890: 61 77 28 64 62 2c 20 6e 29 3b 0a 20 20 69 66 28  aw(db, n);.  if(
58a0: 20 7a 4e 65 77 20 29 7b 0a 20 20 20 20 6d 65 6d   zNew ){.    mem
58b0: 63 70 79 28 7a 4e 65 77 2c 20 7a 2c 20 6e 29 3b  cpy(zNew, z, n);
58c0: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 7a 4e  .  }.  return zN
58d0: 65 77 3b 0a 7d 0a 63 68 61 72 20 2a 73 71 6c 69  ew;.}.char *sqli
58e0: 74 65 33 44 62 53 74 72 4e 44 75 70 28 73 71 6c  te3DbStrNDup(sql
58f0: 69 74 65 33 20 2a 64 62 2c 20 63 6f 6e 73 74 20  ite3 *db, const 
5900: 63 68 61 72 20 2a 7a 2c 20 75 36 34 20 6e 29 7b  char *z, u64 n){
5910: 0a 20 20 63 68 61 72 20 2a 7a 4e 65 77 3b 0a 20  .  char *zNew;. 
5920: 20 61 73 73 65 72 74 28 20 64 62 21 3d 30 20 29   assert( db!=0 )
5930: 3b 0a 20 20 69 66 28 20 7a 3d 3d 30 20 29 7b 0a  ;.  if( z==0 ){.
5940: 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20      return 0;.  
5950: 7d 0a 20 20 61 73 73 65 72 74 28 20 28 6e 26 30  }.  assert( (n&0
5960: 78 37 66 66 66 66 66 66 66 29 3d 3d 6e 20 29 3b  x7fffffff)==n );
5970: 0a 20 20 7a 4e 65 77 20 3d 20 73 71 6c 69 74 65  .  zNew = sqlite
5980: 33 44 62 4d 61 6c 6c 6f 63 52 61 77 4e 4e 28 64  3DbMallocRawNN(d
5990: 62 2c 20 6e 2b 31 29 3b 0a 20 20 69 66 28 20 7a  b, n+1);.  if( z
59a0: 4e 65 77 20 29 7b 0a 20 20 20 20 6d 65 6d 63 70  New ){.    memcp
59b0: 79 28 7a 4e 65 77 2c 20 7a 2c 20 28 73 69 7a 65  y(zNew, z, (size
59c0: 5f 74 29 6e 29 3b 0a 20 20 20 20 7a 4e 65 77 5b  _t)n);.    zNew[
59d0: 6e 5d 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65  n] = 0;.  }.  re
59e0: 74 75 72 6e 20 7a 4e 65 77 3b 0a 7d 0a 0a 2f 2a  turn zNew;.}../*
59f0: 0a 2a 2a 20 46 72 65 65 20 61 6e 79 20 70 72 69  .** Free any pri
5a00: 6f 72 20 63 6f 6e 74 65 6e 74 20 69 6e 20 2a 70  or content in *p
5a10: 7a 20 61 6e 64 20 72 65 70 6c 61 63 65 20 69 74  z and replace it
5a20: 20 77 69 74 68 20 61 20 63 6f 70 79 20 6f 66 20   with a copy of 
5a30: 7a 4e 65 77 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  zNew..*/.void sq
5a40: 6c 69 74 65 33 53 65 74 53 74 72 69 6e 67 28 63  lite3SetString(c
5a50: 68 61 72 20 2a 2a 70 7a 2c 20 73 71 6c 69 74 65  har **pz, sqlite
5a60: 33 20 2a 64 62 2c 20 63 6f 6e 73 74 20 63 68 61  3 *db, const cha
5a70: 72 20 2a 7a 4e 65 77 29 7b 0a 20 20 73 71 6c 69  r *zNew){.  sqli
5a80: 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 2a 70  te3DbFree(db, *p
5a90: 7a 29 3b 0a 20 20 2a 70 7a 20 3d 20 73 71 6c 69  z);.  *pz = sqli
5aa0: 74 65 33 44 62 53 74 72 44 75 70 28 64 62 2c 20  te3DbStrDup(db, 
5ab0: 7a 4e 65 77 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  zNew);.}../*.** 
5ac0: 43 61 6c 6c 20 74 68 69 73 20 72 6f 75 74 69 6e  Call this routin
5ad0: 65 20 74 6f 20 72 65 63 6f 72 64 20 74 68 65 20  e to record the 
5ae0: 66 61 63 74 20 74 68 61 74 20 61 6e 20 4f 4f 4d  fact that an OOM
5af0: 20 28 6f 75 74 2d 6f 66 2d 6d 65 6d 6f 72 79 29   (out-of-memory)
5b00: 20 65 72 72 6f 72 0a 2a 2a 20 68 61 73 20 68 61   error.** has ha
5b10: 70 70 65 6e 65 64 2e 20 20 54 68 69 73 20 72 6f  ppened.  This ro
5b20: 75 74 69 6e 65 20 77 69 6c 6c 20 73 65 74 20 64  utine will set d
5b30: 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 2c  b->mallocFailed,
5b40: 20 61 6e 64 20 61 6c 73 6f 0a 2a 2a 20 74 65 6d   and also.** tem
5b50: 70 6f 72 61 72 69 6c 79 20 64 69 73 61 62 6c 65  porarily disable
5b60: 20 74 68 65 20 6c 6f 6f 6b 61 73 69 64 65 20 6d   the lookaside m
5b70: 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 20  emory allocator 
5b80: 61 6e 64 20 69 6e 74 65 72 72 75 70 74 0a 2a 2a  and interrupt.**
5b90: 20 61 6e 79 20 72 75 6e 6e 69 6e 67 20 56 44 42   any running VDB
5ba0: 45 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  Es..*/.void sqli
5bb0: 74 65 33 4f 6f 6d 46 61 75 6c 74 28 73 71 6c 69  te3OomFault(sqli
5bc0: 74 65 33 20 2a 64 62 29 7b 0a 20 20 69 66 28 20  te3 *db){.  if( 
5bd0: 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64  db->mallocFailed
5be0: 3d 3d 30 20 26 26 20 64 62 2d 3e 62 42 65 6e 69  ==0 && db->bBeni
5bf0: 67 6e 4d 61 6c 6c 6f 63 3d 3d 30 20 29 7b 0a 20  gnMalloc==0 ){. 
5c00: 20 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69     db->mallocFai
5c10: 6c 65 64 20 3d 20 31 3b 0a 20 20 20 20 69 66 28  led = 1;.    if(
5c20: 20 64 62 2d 3e 6e 56 64 62 65 45 78 65 63 3e 30   db->nVdbeExec>0
5c30: 20 29 7b 0a 20 20 20 20 20 20 64 62 2d 3e 75 31   ){.      db->u1
5c40: 2e 69 73 49 6e 74 65 72 72 75 70 74 65 64 20 3d  .isInterrupted =
5c50: 20 31 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 62   1;.    }.    db
5c60: 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 44 69 73  ->lookaside.bDis
5c70: 61 62 6c 65 2b 2b 3b 0a 20 20 7d 0a 7d 0a 0a 2f  able++;.  }.}../
5c80: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
5c90: 65 20 72 65 61 63 74 69 76 61 74 65 73 20 74 68  e reactivates th
5ca0: 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74  e memory allocat
5cb0: 6f 72 20 61 6e 64 20 63 6c 65 61 72 73 20 74 68  or and clears th
5cc0: 65 0a 2a 2a 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46  e.** db->mallocF
5cd0: 61 69 6c 65 64 20 66 6c 61 67 20 61 73 20 6e 65  ailed flag as ne
5ce0: 63 65 73 73 61 72 79 2e 0a 2a 2a 0a 2a 2a 20 54  cessary..**.** T
5cf0: 68 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61  he memory alloca
5d00: 74 6f 72 20 69 73 20 6e 6f 74 20 72 65 73 74 61  tor is not resta
5d10: 72 74 65 64 20 69 66 20 74 68 65 72 65 20 61 72  rted if there ar
5d20: 65 20 72 75 6e 6e 69 6e 67 0a 2a 2a 20 56 44 42  e running.** VDB
5d30: 45 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  Es..*/.void sqli
5d40: 74 65 33 4f 6f 6d 43 6c 65 61 72 28 73 71 6c 69  te3OomClear(sqli
5d50: 74 65 33 20 2a 64 62 29 7b 0a 20 20 69 66 28 20  te3 *db){.  if( 
5d60: 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64  db->mallocFailed
5d70: 20 26 26 20 64 62 2d 3e 6e 56 64 62 65 45 78 65   && db->nVdbeExe
5d80: 63 3d 3d 30 20 29 7b 0a 20 20 20 20 64 62 2d 3e  c==0 ){.    db->
5d90: 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 3d 20 30  mallocFailed = 0
5da0: 3b 0a 20 20 20 20 64 62 2d 3e 75 31 2e 69 73 49  ;.    db->u1.isI
5db0: 6e 74 65 72 72 75 70 74 65 64 20 3d 20 30 3b 0a  nterrupted = 0;.
5dc0: 20 20 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e      assert( db->
5dd0: 6c 6f 6f 6b 61 73 69 64 65 2e 62 44 69 73 61 62  lookaside.bDisab
5de0: 6c 65 3e 30 20 29 3b 0a 20 20 20 20 64 62 2d 3e  le>0 );.    db->
5df0: 6c 6f 6f 6b 61 73 69 64 65 2e 62 44 69 73 61 62  lookaside.bDisab
5e00: 6c 65 2d 2d 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a  le--;.  }.}../*.
5e10: 2a 2a 20 54 61 6b 65 20 61 63 74 69 6f 6e 73 20  ** Take actions 
5e20: 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 61 6e  at the end of an
5e30: 20 41 50 49 20 63 61 6c 6c 20 74 6f 20 69 6e 64   API call to ind
5e40: 69 63 61 74 65 20 61 6e 20 4f 4f 4d 20 65 72 72  icate an OOM err
5e50: 6f 72 0a 2a 2f 0a 73 74 61 74 69 63 20 53 51 4c  or.*/.static SQL
5e60: 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20 69 6e 74  ITE_NOINLINE int
5e70: 20 61 70 69 4f 6f 6d 45 72 72 6f 72 28 73 71 6c   apiOomError(sql
5e80: 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 73 71 6c  ite3 *db){.  sql
5e90: 69 74 65 33 4f 6f 6d 43 6c 65 61 72 28 64 62 29  ite3OomClear(db)
5ea0: 3b 0a 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72  ;.  sqlite3Error
5eb0: 28 64 62 2c 20 53 51 4c 49 54 45 5f 4e 4f 4d 45  (db, SQLITE_NOME
5ec0: 4d 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c  M);.  return SQL
5ed0: 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a  ITE_NOMEM_BKPT;.
5ee0: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75  }../*.** This fu
5ef0: 6e 63 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 63  nction must be c
5f00: 61 6c 6c 65 64 20 62 65 66 6f 72 65 20 65 78 69  alled before exi
5f10: 74 69 6e 67 20 61 6e 79 20 41 50 49 20 66 75 6e  ting any API fun
5f20: 63 74 69 6f 6e 20 28 69 2e 65 2e 20 0a 2a 2a 20  ction (i.e. .** 
5f30: 72 65 74 75 72 6e 69 6e 67 20 63 6f 6e 74 72 6f  returning contro
5f40: 6c 20 74 6f 20 74 68 65 20 75 73 65 72 29 20 74  l to the user) t
5f50: 68 61 74 20 68 61 73 20 63 61 6c 6c 65 64 20 73  hat has called s
5f60: 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 20 6f 72  qlite3_malloc or
5f70: 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 72 65 61 6c  .** sqlite3_real
5f80: 6c 6f 63 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 72  loc..**.** The r
5f90: 65 74 75 72 6e 65 64 20 76 61 6c 75 65 20 69 73  eturned value is
5fa0: 20 6e 6f 72 6d 61 6c 6c 79 20 61 20 63 6f 70 79   normally a copy
5fb0: 20 6f 66 20 74 68 65 20 73 65 63 6f 6e 64 20 61   of the second a
5fc0: 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 69 73 0a  rgument to this.
5fd0: 2a 2a 20 66 75 6e 63 74 69 6f 6e 2e 20 48 6f 77  ** function. How
5fe0: 65 76 65 72 2c 20 69 66 20 61 20 6d 61 6c 6c 6f  ever, if a mallo
5ff0: 63 28 29 20 66 61 69 6c 75 72 65 20 68 61 73 20  c() failure has 
6000: 6f 63 63 75 72 72 65 64 20 73 69 6e 63 65 20 74  occurred since t
6010: 68 65 20 70 72 65 76 69 6f 75 73 0a 2a 2a 20 69  he previous.** i
6020: 6e 76 6f 63 61 74 69 6f 6e 20 53 51 4c 49 54 45  nvocation SQLITE
6030: 5f 4e 4f 4d 45 4d 20 69 73 20 72 65 74 75 72 6e  _NOMEM is return
6040: 65 64 20 69 6e 73 74 65 61 64 2e 20 0a 2a 2a 0a  ed instead. .**.
6050: 2a 2a 20 49 66 20 61 6e 20 4f 4f 4d 20 61 73 20  ** If an OOM as 
6060: 6f 63 63 75 72 72 65 64 2c 20 74 68 65 6e 20 74  occurred, then t
6070: 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 65 72  he connection er
6080: 72 6f 72 2d 63 6f 64 65 20 28 74 68 65 20 76 61  ror-code (the va
6090: 6c 75 65 0a 2a 2a 20 72 65 74 75 72 6e 65 64 20  lue.** returned 
60a0: 62 79 20 73 71 6c 69 74 65 33 5f 65 72 72 63 6f  by sqlite3_errco
60b0: 64 65 28 29 29 20 69 73 20 73 65 74 20 74 6f 20  de()) is set to 
60c0: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 2e 0a 2a 2f  SQLITE_NOMEM..*/
60d0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 41 70 69 45  .int sqlite3ApiE
60e0: 78 69 74 28 73 71 6c 69 74 65 33 2a 20 64 62 2c  xit(sqlite3* db,
60f0: 20 69 6e 74 20 72 63 29 7b 0a 20 20 2f 2a 20 49   int rc){.  /* I
6100: 66 20 74 68 65 20 64 62 20 68 61 6e 64 6c 65 20  f the db handle 
6110: 6d 75 73 74 20 68 6f 6c 64 20 74 68 65 20 63 6f  must hold the co
6120: 6e 6e 65 63 74 69 6f 6e 20 68 61 6e 64 6c 65 20  nnection handle 
6130: 6d 75 74 65 78 20 68 65 72 65 2e 0a 20 20 2a 2a  mutex here..  **
6140: 20 4f 74 68 65 72 77 69 73 65 20 74 68 65 20 72   Otherwise the r
6150: 65 61 64 20 28 61 6e 64 20 70 6f 73 73 69 62 6c  ead (and possibl
6160: 65 20 77 72 69 74 65 29 20 6f 66 20 64 62 2d 3e  e write) of db->
6170: 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 0a 20 20  mallocFailed .  
6180: 2a 2a 20 69 73 20 75 6e 73 61 66 65 2c 20 61 73  ** is unsafe, as
6190: 20 69 73 20 74 68 65 20 63 61 6c 6c 20 74 6f 20   is the call to 
61a0: 73 71 6c 69 74 65 33 45 72 72 6f 72 28 29 2e 0a  sqlite3Error()..
61b0: 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 64    */.  assert( d
61c0: 62 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74  b!=0 );.  assert
61d0: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
61e0: 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20  held(db->mutex) 
61f0: 29 3b 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61 6c  );.  if( db->mal
6200: 6c 6f 63 46 61 69 6c 65 64 20 7c 7c 20 72 63 3d  locFailed || rc=
6210: 3d 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4e 4f  =SQLITE_IOERR_NO
6220: 4d 45 4d 20 29 7b 0a 20 20 20 20 72 65 74 75 72  MEM ){.    retur
6230: 6e 20 61 70 69 4f 6f 6d 45 72 72 6f 72 28 64 62  n apiOomError(db
6240: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  );.  }.  return 
6250: 72 63 20 26 20 64 62 2d 3e 65 72 72 4d 61 73 6b  rc & db->errMask
6260: 3b 0a 7d 0a                                      ;.}.