/ Hex Artifact Content
Login

Artifact 7b023d45dd71944414db469c742457239e24d74d:


0000: 2f 2a 0a 2a 2a 20 32 30 30 37 20 41 75 67 75 73  /*.** 2007 Augus
0010: 74 20 31 34 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61  t 14.**.** The a
0020: 75 74 68 6f 72 20 64 69 73 63 6c 61 69 6d 73 20  uthor disclaims 
0030: 63 6f 70 79 72 69 67 68 74 20 74 6f 20 74 68 69  copyright to thi
0040: 73 20 73 6f 75 72 63 65 20 63 6f 64 65 2e 20 20  s source code.  
0050: 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61  In place of.** a
0060: 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68   legal notice, h
0070: 65 72 65 20 69 73 20 61 20 62 6c 65 73 73 69 6e  ere is a blessin
0080: 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20  g:.**.**    May 
0090: 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20  you do good and 
00a0: 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20  not evil..**    
00b0: 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 66 6f 72  May you find for
00c0: 67 69 76 65 6e 65 73 73 20 66 6f 72 20 79 6f 75  giveness for you
00d0: 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 67 69 76  rself and forgiv
00e0: 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20  e others..**    
00f0: 4d 61 79 20 79 6f 75 20 73 68 61 72 65 20 66 72  May you share fr
0100: 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 61 6b 69  eely, never taki
0110: 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75  ng more than you
0120: 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a   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 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65  ***.** This file
0180: 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 43 20   contains the C 
0190: 66 75 6e 63 74 69 6f 6e 73 20 74 68 61 74 20 69  functions that i
01a0: 6d 70 6c 65 6d 65 6e 74 20 61 20 6d 65 6d 6f 72  mplement a memor
01b0: 79 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e 20  y.** allocation 
01c0: 73 75 62 73 79 73 74 65 6d 20 66 6f 72 20 75 73  subsystem for us
01d0: 65 20 62 79 20 53 51 4c 69 74 65 2e 20 20 0a 2a  e by SQLite.  .*
01e0: 2a 0a 2a 2a 20 24 49 64 3a 20 6d 65 6d 31 2e 63  *.** $Id: mem1.c
01f0: 2c 76 20 31 2e 37 20 32 30 30 37 2f 30 38 2f 32  ,v 1.7 2007/08/2
0200: 32 20 32 30 3a 31 38 3a 32 32 20 64 72 68 20 45  2 20:18:22 drh E
0210: 78 70 20 24 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54  xp $.*/../*.** T
0220: 68 69 73 20 76 65 72 73 69 6f 6e 20 6f 66 20 74  his version of t
0230: 68 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61  he memory alloca
0240: 74 6f 72 20 69 73 20 74 68 65 20 64 65 66 61 75  tor is the defau
0250: 6c 74 2e 20 20 49 74 20 69 73 0a 2a 2a 20 75 73  lt.  It is.** us
0260: 65 64 20 77 68 65 6e 20 6e 6f 20 6f 74 68 65 72  ed when no other
0270: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f   memory allocato
0280: 72 20 69 73 20 73 70 65 63 69 66 69 65 64 20 75  r is specified u
0290: 73 69 6e 67 20 63 6f 6d 70 69 6c 65 2d 74 69 6d  sing compile-tim
02a0: 65 0a 2a 2a 20 6d 61 63 72 6f 73 2e 0a 2a 2f 0a  e.** macros..*/.
02b0: 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c  #if !defined(SQL
02c0: 49 54 45 5f 4d 45 4d 44 45 42 55 47 29 20 26 26  ITE_MEMDEBUG) &&
02d0: 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45   !defined(SQLITE
02e0: 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 5f 41 4c 4c  _OMIT_MEMORY_ALL
02f0: 4f 43 41 54 49 4f 4e 29 0a 0a 2f 2a 0a 2a 2a 20  OCATION)../*.** 
0300: 57 65 20 77 69 6c 6c 20 65 76 65 6e 74 75 61 6c  We will eventual
0310: 6c 79 20 63 6f 6e 73 74 72 75 63 74 20 6d 75 6c  ly construct mul
0320: 74 69 70 6c 65 20 6d 65 6d 6f 72 79 20 61 6c 6c  tiple memory all
0330: 6f 63 61 74 69 6f 6e 20 73 75 62 73 79 73 74 65  ocation subsyste
0340: 6d 73 0a 2a 2a 20 73 75 69 74 61 62 6c 65 20 66  ms.** suitable f
0350: 6f 72 20 75 73 65 20 69 6e 20 76 61 72 69 6f 75  or use in variou
0360: 73 20 63 6f 6e 74 65 78 74 73 3a 0a 2a 2a 0a 2a  s contexts:.**.*
0370: 2a 20 20 20 20 2a 20 20 4e 6f 72 6d 61 6c 20 6d  *    *  Normal m
0380: 75 6c 74 69 2d 74 68 72 65 61 64 65 64 20 62 75  ulti-threaded bu
0390: 69 6c 64 73 0a 2a 2a 20 20 20 20 2a 20 20 4e 6f  ilds.**    *  No
03a0: 72 6d 61 6c 20 73 69 6e 67 6c 65 2d 74 68 72 65  rmal single-thre
03b0: 61 64 65 64 20 62 75 69 6c 64 73 0a 2a 2a 20 20  aded builds.**  
03c0: 20 20 2a 20 20 44 65 62 75 67 67 69 6e 67 20 62    *  Debugging b
03d0: 75 69 6c 64 73 0a 2a 2a 0a 2a 2a 20 54 68 69 73  uilds.**.** This
03e0: 20 69 6e 69 74 69 61 6c 20 76 65 72 73 69 6f 6e   initial version
03f0: 20 69 73 20 73 75 69 74 61 62 6c 65 20 66 6f 72   is suitable for
0400: 20 75 73 65 20 69 6e 20 6e 6f 72 6d 61 6c 20 6d   use in normal m
0410: 75 6c 74 69 2d 74 68 72 65 61 64 65 64 0a 2a 2a  ulti-threaded.**
0420: 20 62 75 69 6c 64 73 2e 20 20 57 65 20 65 6e 76   builds.  We env
0430: 69 73 69 6f 6e 20 74 68 61 74 20 61 6c 74 65 72  ision that alter
0440: 6e 61 74 69 76 65 20 76 65 72 73 69 6f 6e 73 20  native versions 
0450: 77 69 6c 6c 20 62 65 20 73 74 6f 72 65 64 20 69  will be stored i
0460: 6e 0a 2a 2a 20 73 65 70 61 72 61 74 65 20 73 6f  n.** separate so
0470: 75 72 63 65 20 66 69 6c 65 73 2e 20 20 23 69 66  urce files.  #if
0480: 64 65 66 73 20 77 69 6c 6c 20 62 65 20 75 73 65  defs will be use
0490: 64 20 74 6f 20 73 65 6c 65 63 74 20 74 68 65 20  d to select the 
04a0: 63 6f 64 65 20 66 72 6f 6d 0a 2a 2a 20 6f 6e 65  code from.** one
04b0: 20 6f 66 20 74 68 65 20 76 61 72 69 6f 75 73 20   of the various 
04c0: 6d 65 6d 4e 2e 63 20 73 6f 75 72 63 65 20 66 69  memN.c source fi
04d0: 6c 65 73 20 66 6f 72 20 75 73 65 20 69 6e 20 61  les for use in a
04e0: 6e 79 20 67 69 76 65 6e 20 62 75 69 6c 64 2e 0a  ny given build..
04f0: 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 6c  */.#include "sql
0500: 69 74 65 49 6e 74 2e 68 22 0a 0a 2f 2a 0a 2a 2a  iteInt.h"../*.**
0510: 20 41 6c 6c 20 6f 66 20 74 68 65 20 73 74 61 74   All of the stat
0520: 69 63 20 76 61 72 69 61 62 6c 65 73 20 75 73 65  ic variables use
0530: 64 20 62 79 20 74 68 69 73 20 6d 6f 64 75 6c 65  d by this module
0540: 20 61 72 65 20 63 6f 6c 6c 65 63 74 65 64 0a 2a   are collected.*
0550: 2a 20 69 6e 74 6f 20 61 20 73 69 6e 67 6c 65 20  * into a single 
0560: 73 74 72 75 63 74 75 72 65 20 6e 61 6d 65 64 20  structure named 
0570: 22 6d 65 6d 22 2e 20 20 54 68 69 73 20 69 73 20  "mem".  This is 
0580: 74 6f 20 6b 65 65 70 20 74 68 65 0a 2a 2a 20 73  to keep the.** s
0590: 74 61 74 69 63 20 76 61 72 69 61 62 6c 65 73 20  tatic variables 
05a0: 6f 72 67 61 6e 69 7a 65 64 20 61 6e 64 20 74 6f  organized and to
05b0: 20 72 65 64 75 63 65 20 6e 61 6d 65 73 70 61 63   reduce namespac
05c0: 65 20 70 6f 6c 6c 75 74 69 6f 6e 0a 2a 2a 20 77  e pollution.** w
05d0: 68 65 6e 20 74 68 69 73 20 6d 6f 64 75 6c 65 20  hen this module 
05e0: 69 73 20 63 6f 6d 62 69 6e 65 64 20 77 69 74 68  is combined with
05f0: 20 6f 74 68 65 72 20 69 6e 20 74 68 65 20 61 6d   other in the am
0600: 61 6c 67 61 6d 61 74 69 6f 6e 2e 0a 2a 2f 0a 73  algamation..*/.s
0610: 74 61 74 69 63 20 73 74 72 75 63 74 20 7b 0a 20  tatic struct {. 
0620: 20 2f 2a 0a 20 20 2a 2a 20 54 68 65 20 61 6c 61   /*.  ** The ala
0630: 72 6d 20 63 61 6c 6c 62 61 63 6b 20 61 6e 64 20  rm callback and 
0640: 69 74 73 20 61 72 67 75 6d 65 6e 74 73 2e 20 20  its arguments.  
0650: 54 68 65 20 6d 65 6d 2e 6d 75 74 65 78 20 6c 6f  The mem.mutex lo
0660: 63 6b 20 77 69 6c 6c 0a 20 20 2a 2a 20 62 65 20  ck will.  ** be 
0670: 68 65 6c 64 20 77 68 69 6c 65 20 74 68 65 20 63  held while the c
0680: 61 6c 6c 62 61 63 6b 20 69 73 20 72 75 6e 6e 69  allback is runni
0690: 6e 67 2e 20 20 52 65 63 75 72 73 69 76 65 20 63  ng.  Recursive c
06a0: 61 6c 6c 73 20 69 6e 74 6f 0a 20 20 2a 2a 20 74  alls into.  ** t
06b0: 68 65 20 6d 65 6d 6f 72 79 20 73 75 62 73 79 73  he memory subsys
06c0: 74 65 6d 20 61 72 65 20 61 6c 6c 6f 77 65 64 2c  tem are allowed,
06d0: 20 62 75 74 20 6e 6f 20 6e 65 77 20 63 61 6c 6c   but no new call
06e0: 62 61 63 6b 73 20 77 69 6c 6c 20 62 65 0a 20 20  backs will be.  
06f0: 2a 2a 20 69 73 73 75 65 64 2e 20 20 54 68 65 20  ** issued.  The 
0700: 61 6c 61 72 6d 42 75 73 79 20 76 61 72 69 61 62  alarmBusy variab
0710: 6c 65 20 69 73 20 73 65 74 20 74 6f 20 70 72 65  le is set to pre
0720: 76 65 6e 74 20 72 65 63 75 72 73 69 76 65 0a 20  vent recursive. 
0730: 20 2a 2a 20 63 61 6c 6c 62 61 63 6b 73 2e 0a 20   ** callbacks.. 
0740: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 75 69   */.  sqlite3_ui
0750: 6e 74 36 34 20 61 6c 61 72 6d 54 68 72 65 73 68  nt64 alarmThresh
0760: 6f 6c 64 3b 0a 20 20 76 6f 69 64 20 28 2a 61 6c  old;.  void (*al
0770: 61 72 6d 43 61 6c 6c 62 61 63 6b 29 28 76 6f 69  armCallback)(voi
0780: 64 2a 2c 20 73 71 6c 69 74 65 33 5f 75 69 6e 74  d*, sqlite3_uint
0790: 36 34 2c 20 75 6e 73 69 67 6e 65 64 29 3b 0a 20  64, unsigned);. 
07a0: 20 76 6f 69 64 20 2a 61 6c 61 72 6d 41 72 67 3b   void *alarmArg;
07b0: 0a 20 20 69 6e 74 20 61 6c 61 72 6d 42 75 73 79  .  int alarmBusy
07c0: 3b 0a 20 20 0a 20 20 2f 2a 0a 20 20 2a 2a 20 4d  ;.  .  /*.  ** M
07d0: 75 74 65 78 20 74 6f 20 63 6f 6e 74 72 6f 6c 20  utex to control 
07e0: 61 63 63 65 73 73 20 74 6f 20 74 68 65 20 6d 65  access to the me
07f0: 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20  mory allocation 
0800: 73 75 62 73 79 73 74 65 6d 2e 0a 20 20 2a 2f 0a  subsystem..  */.
0810: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20    sqlite3_mutex 
0820: 2a 6d 75 74 65 78 3b 0a 20 20 0a 20 20 2f 2a 0a  *mutex;.  .  /*.
0830: 20 20 2a 2a 20 43 75 72 72 65 6e 74 20 61 6c 6c    ** Current all
0840: 6f 63 61 74 69 6f 6e 20 61 6e 64 20 68 69 67 68  ocation and high
0850: 2d 77 61 74 65 72 20 6d 61 72 6b 2e 0a 20 20 2a  -water mark..  *
0860: 2f 0a 20 20 73 71 6c 69 74 65 33 5f 75 69 6e 74  /.  sqlite3_uint
0870: 36 34 20 6e 6f 77 55 73 65 64 3b 0a 20 20 73 71  64 nowUsed;.  sq
0880: 6c 69 74 65 33 5f 75 69 6e 74 36 34 20 6d 78 55  lite3_uint64 mxU
0890: 73 65 64 3b 0a 20 20 0a 20 0a 7d 20 6d 65 6d 20  sed;.  . .} mem 
08a0: 3d 20 7b 20 20 2f 2a 20 54 68 69 73 20 76 61 72  = {  /* This var
08b0: 69 61 62 6c 65 20 68 6f 6c 64 73 20 61 6c 6c 20  iable holds all 
08c0: 6f 66 20 74 68 65 20 6c 6f 63 61 6c 20 64 61 74  of the local dat
08d0: 61 20 2a 2f 0a 20 20 20 28 28 73 71 6c 69 74 65  a */.   ((sqlite
08e0: 33 5f 75 69 6e 74 36 34 29 31 29 3c 3c 36 33 2c  3_uint64)1)<<63,
08f0: 20 20 20 20 2f 2a 20 61 6c 61 72 6d 54 68 72 65      /* alarmThre
0900: 73 68 6f 6c 64 20 2a 2f 0a 20 20 20 2f 2a 20 45  shold */.   /* E
0910: 76 65 72 79 74 68 69 6e 67 20 65 6c 73 65 20 69  verything else i
0920: 73 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 74 6f  s initialized to
0930: 20 7a 65 72 6f 20 2a 2f 0a 7d 3b 0a 0a 0a 0a 2f   zero */.};..../
0940: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
0950: 61 6d 6f 75 6e 74 20 6f 66 20 6d 65 6d 6f 72 79  amount of memory
0960: 20 63 75 72 72 65 6e 74 6c 79 20 63 68 65 63 6b   currently check
0970: 65 64 20 6f 75 74 2e 0a 2a 2f 0a 73 71 6c 69 74  ed out..*/.sqlit
0980: 65 33 5f 75 69 6e 74 36 34 20 73 71 6c 69 74 65  e3_uint64 sqlite
0990: 33 5f 6d 65 6d 6f 72 79 5f 75 73 65 64 28 76 6f  3_memory_used(vo
09a0: 69 64 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f 75  id){.  sqlite3_u
09b0: 69 6e 74 36 34 20 6e 3b 0a 20 20 69 66 28 20 6d  int64 n;.  if( m
09c0: 65 6d 2e 6d 75 74 65 78 3d 3d 30 20 29 7b 0a 20  em.mutex==0 ){. 
09d0: 20 20 20 6d 65 6d 2e 6d 75 74 65 78 20 3d 20 73     mem.mutex = s
09e0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 61 6c 6c  qlite3_mutex_all
09f0: 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f  oc(SQLITE_MUTEX_
0a00: 53 54 41 54 49 43 5f 4d 45 4d 29 3b 0a 20 20 7d  STATIC_MEM);.  }
0a10: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  .  sqlite3_mutex
0a20: 5f 65 6e 74 65 72 28 6d 65 6d 2e 6d 75 74 65 78  _enter(mem.mutex
0a30: 29 3b 0a 20 20 6e 20 3d 20 6d 65 6d 2e 6e 6f 77  );.  n = mem.now
0a40: 55 73 65 64 3b 0a 20 20 73 71 6c 69 74 65 33 5f  Used;.  sqlite3_
0a50: 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 65 6d 2e  mutex_leave(mem.
0a60: 6d 75 74 65 78 29 3b 20 20 0a 20 20 72 65 74 75  mutex);  .  retu
0a70: 72 6e 20 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52  rn n;.}../*.** R
0a80: 65 74 75 72 6e 20 74 68 65 20 6d 61 78 69 6d 75  eturn the maximu
0a90: 6d 20 61 6d 6f 75 6e 74 20 6f 66 20 6d 65 6d 6f  m amount of memo
0aa0: 72 79 20 74 68 61 74 20 68 61 73 20 65 76 65 72  ry that has ever
0ab0: 20 62 65 65 6e 0a 2a 2a 20 63 68 65 63 6b 65 64   been.** checked
0ac0: 20 6f 75 74 20 73 69 6e 63 65 20 65 69 74 68 65   out since eithe
0ad0: 72 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20  r the beginning 
0ae0: 6f 66 20 74 68 69 73 20 70 72 6f 63 65 73 73 0a  of this process.
0af0: 2a 2a 20 6f 72 20 73 69 6e 63 65 20 74 68 65 20  ** or since the 
0b00: 6d 6f 73 74 20 72 65 63 65 6e 74 20 72 65 73 65  most recent rese
0b10: 74 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f 75 69  t..*/.sqlite3_ui
0b20: 6e 74 36 34 20 73 71 6c 69 74 65 33 5f 6d 65 6d  nt64 sqlite3_mem
0b30: 6f 72 79 5f 68 69 67 68 77 61 74 65 72 28 69 6e  ory_highwater(in
0b40: 74 20 72 65 73 65 74 46 6c 61 67 29 7b 0a 20 20  t resetFlag){.  
0b50: 73 71 6c 69 74 65 33 5f 75 69 6e 74 36 34 20 6e  sqlite3_uint64 n
0b60: 3b 0a 20 20 69 66 28 20 6d 65 6d 2e 6d 75 74 65  ;.  if( mem.mute
0b70: 78 3d 3d 30 20 29 7b 0a 20 20 20 20 6d 65 6d 2e  x==0 ){.    mem.
0b80: 6d 75 74 65 78 20 3d 20 73 71 6c 69 74 65 33 5f  mutex = sqlite3_
0b90: 6d 75 74 65 78 5f 61 6c 6c 6f 63 28 53 51 4c 49  mutex_alloc(SQLI
0ba0: 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f  TE_MUTEX_STATIC_
0bb0: 4d 45 4d 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69  MEM);.  }.  sqli
0bc0: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28  te3_mutex_enter(
0bd0: 6d 65 6d 2e 6d 75 74 65 78 29 3b 0a 20 20 6e 20  mem.mutex);.  n 
0be0: 3d 20 6d 65 6d 2e 6d 78 55 73 65 64 3b 0a 20 20  = mem.mxUsed;.  
0bf0: 69 66 28 20 72 65 73 65 74 46 6c 61 67 20 29 7b  if( resetFlag ){
0c00: 0a 20 20 20 20 6d 65 6d 2e 6d 78 55 73 65 64 20  .    mem.mxUsed 
0c10: 3d 20 6d 65 6d 2e 6e 6f 77 55 73 65 64 3b 0a 20  = mem.nowUsed;. 
0c20: 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74   }.  sqlite3_mut
0c30: 65 78 5f 6c 65 61 76 65 28 6d 65 6d 2e 6d 75 74  ex_leave(mem.mut
0c40: 65 78 29 3b 20 20 0a 20 20 72 65 74 75 72 6e 20  ex);  .  return 
0c50: 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e  n;.}../*.** Chan
0c60: 67 65 20 74 68 65 20 61 6c 61 72 6d 20 63 61 6c  ge the alarm cal
0c70: 6c 62 61 63 6b 0a 2a 2f 0a 69 6e 74 20 73 71 6c  lback.*/.int sql
0c80: 69 74 65 33 5f 6d 65 6d 6f 72 79 5f 61 6c 61 72  ite3_memory_alar
0c90: 6d 28 0a 20 20 76 6f 69 64 28 2a 78 43 61 6c 6c  m(.  void(*xCall
0ca0: 62 61 63 6b 29 28 76 6f 69 64 20 2a 70 41 72 67  back)(void *pArg
0cb0: 2c 20 73 71 6c 69 74 65 33 5f 75 69 6e 74 36 34  , sqlite3_uint64
0cc0: 20 75 73 65 64 2c 20 75 6e 73 69 67 6e 65 64 20   used, unsigned 
0cd0: 69 6e 74 20 4e 29 2c 0a 20 20 76 6f 69 64 20 2a  int N),.  void *
0ce0: 70 41 72 67 2c 0a 20 20 73 71 6c 69 74 65 33 5f  pArg,.  sqlite3_
0cf0: 75 69 6e 74 36 34 20 69 54 68 72 65 73 68 6f 6c  uint64 iThreshol
0d00: 64 0a 29 7b 0a 20 20 69 66 28 20 6d 65 6d 2e 6d  d.){.  if( mem.m
0d10: 75 74 65 78 3d 3d 30 20 29 7b 0a 20 20 20 20 6d  utex==0 ){.    m
0d20: 65 6d 2e 6d 75 74 65 78 20 3d 20 73 71 6c 69 74  em.mutex = sqlit
0d30: 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 28 53  e3_mutex_alloc(S
0d40: 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54  QLITE_MUTEX_STAT
0d50: 49 43 5f 4d 45 4d 29 3b 0a 20 20 7d 0a 20 20 73  IC_MEM);.  }.  s
0d60: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74  qlite3_mutex_ent
0d70: 65 72 28 6d 65 6d 2e 6d 75 74 65 78 29 3b 0a 20  er(mem.mutex);. 
0d80: 20 6d 65 6d 2e 61 6c 61 72 6d 43 61 6c 6c 62 61   mem.alarmCallba
0d90: 63 6b 20 3d 20 78 43 61 6c 6c 62 61 63 6b 3b 0a  ck = xCallback;.
0da0: 20 20 6d 65 6d 2e 61 6c 61 72 6d 41 72 67 20 3d    mem.alarmArg =
0db0: 20 70 41 72 67 3b 0a 20 20 6d 65 6d 2e 61 6c 61   pArg;.  mem.ala
0dc0: 72 6d 54 68 72 65 73 68 6f 6c 64 20 3d 20 69 54  rmThreshold = iT
0dd0: 68 72 65 73 68 6f 6c 64 3b 0a 20 20 73 71 6c 69  hreshold;.  sqli
0de0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
0df0: 6d 65 6d 2e 6d 75 74 65 78 29 3b 0a 20 20 72 65  mem.mutex);.  re
0e00: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
0e10: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 72 69 67 67 65 72  }../*.** Trigger
0e20: 20 74 68 65 20 61 6c 61 72 6d 20 0a 2a 2f 0a 73   the alarm .*/.s
0e30: 74 61 74 69 63 20 76 6f 69 64 20 73 71 6c 69 74  tatic void sqlit
0e40: 65 33 4d 65 6d 73 79 73 41 6c 61 72 6d 28 75 6e  e3MemsysAlarm(un
0e50: 73 69 67 6e 65 64 20 6e 42 79 74 65 29 7b 0a 20  signed nByte){. 
0e60: 20 76 6f 69 64 20 28 2a 78 43 61 6c 6c 62 61 63   void (*xCallbac
0e70: 6b 29 28 76 6f 69 64 2a 2c 73 71 6c 69 74 65 33  k)(void*,sqlite3
0e80: 5f 75 69 6e 74 36 34 2c 75 6e 73 69 67 6e 65 64  _uint64,unsigned
0e90: 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 75 69 6e  );.  sqlite3_uin
0ea0: 74 36 34 20 6e 6f 77 55 73 65 64 3b 0a 20 20 76  t64 nowUsed;.  v
0eb0: 6f 69 64 20 2a 70 41 72 67 3b 0a 20 20 69 66 28  oid *pArg;.  if(
0ec0: 20 6d 65 6d 2e 61 6c 61 72 6d 43 61 6c 6c 62 61   mem.alarmCallba
0ed0: 63 6b 3d 3d 30 20 7c 7c 20 6d 65 6d 2e 61 6c 61  ck==0 || mem.ala
0ee0: 72 6d 42 75 73 79 20 20 29 20 72 65 74 75 72 6e  rmBusy  ) return
0ef0: 3b 0a 20 20 6d 65 6d 2e 61 6c 61 72 6d 42 75 73  ;.  mem.alarmBus
0f00: 79 20 3d 20 31 3b 0a 20 20 78 43 61 6c 6c 62 61  y = 1;.  xCallba
0f10: 63 6b 20 3d 20 6d 65 6d 2e 61 6c 61 72 6d 43 61  ck = mem.alarmCa
0f20: 6c 6c 62 61 63 6b 3b 0a 20 20 6e 6f 77 55 73 65  llback;.  nowUse
0f30: 64 20 3d 20 6d 65 6d 2e 6e 6f 77 55 73 65 64 3b  d = mem.nowUsed;
0f40: 0a 20 20 70 41 72 67 20 3d 20 6d 65 6d 2e 61 6c  .  pArg = mem.al
0f50: 61 72 6d 41 72 67 3b 0a 20 20 73 71 6c 69 74 65  armArg;.  sqlite
0f60: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 65  3_mutex_leave(me
0f70: 6d 2e 6d 75 74 65 78 29 3b 0a 20 20 78 43 61 6c  m.mutex);.  xCal
0f80: 6c 62 61 63 6b 28 70 41 72 67 2c 20 6e 6f 77 55  lback(pArg, nowU
0f90: 73 65 64 2c 20 6e 42 79 74 65 29 3b 0a 20 20 73  sed, nByte);.  s
0fa0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74  qlite3_mutex_ent
0fb0: 65 72 28 6d 65 6d 2e 6d 75 74 65 78 29 3b 0a 20  er(mem.mutex);. 
0fc0: 20 6d 65 6d 2e 61 6c 61 72 6d 42 75 73 79 20 3d   mem.alarmBusy =
0fd0: 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c   0;.}../*.** All
0fe0: 6f 63 61 74 65 20 6e 42 79 74 65 73 20 6f 66 20  ocate nBytes of 
0ff0: 6d 65 6d 6f 72 79 0a 2a 2f 0a 76 6f 69 64 20 2a  memory.*/.void *
1000: 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 69  sqlite3_malloc(i
1010: 6e 74 20 6e 42 79 74 65 73 29 7b 0a 20 20 73 71  nt nBytes){.  sq
1020: 6c 69 74 65 33 5f 75 69 6e 74 36 34 20 2a 70 3b  lite3_uint64 *p;
1030: 0a 20 20 69 66 28 20 6e 42 79 74 65 73 3c 3d 30  .  if( nBytes<=0
1040: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30   ){.    return 0
1050: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6d 65 6d 2e  ;.  }.  if( mem.
1060: 6d 75 74 65 78 3d 3d 30 20 29 7b 0a 20 20 20 20  mutex==0 ){.    
1070: 6d 65 6d 2e 6d 75 74 65 78 20 3d 20 73 71 6c 69  mem.mutex = sqli
1080: 74 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 28  te3_mutex_alloc(
1090: 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41  SQLITE_MUTEX_STA
10a0: 54 49 43 5f 4d 45 4d 29 3b 0a 20 20 7d 0a 20 20  TIC_MEM);.  }.  
10b0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e  sqlite3_mutex_en
10c0: 74 65 72 28 6d 65 6d 2e 6d 75 74 65 78 29 3b 0a  ter(mem.mutex);.
10d0: 20 20 69 66 28 20 6d 65 6d 2e 6e 6f 77 55 73 65    if( mem.nowUse
10e0: 64 2b 6e 42 79 74 65 73 3e 3d 6d 65 6d 2e 61 6c  d+nBytes>=mem.al
10f0: 61 72 6d 54 68 72 65 73 68 6f 6c 64 20 29 7b 0a  armThreshold ){.
1100: 20 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 73 79      sqlite3Memsy
1110: 73 41 6c 61 72 6d 28 6e 42 79 74 65 73 29 3b 0a  sAlarm(nBytes);.
1120: 20 20 7d 0a 20 20 70 20 3d 20 6d 61 6c 6c 6f 63    }.  p = malloc
1130: 28 6e 42 79 74 65 73 2b 38 29 3b 0a 20 20 69 66  (nBytes+8);.  if
1140: 28 20 70 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71  ( p==0 ){.    sq
1150: 6c 69 74 65 33 4d 65 6d 73 79 73 41 6c 61 72 6d  lite3MemsysAlarm
1160: 28 6e 42 79 74 65 73 29 3b 0a 20 20 20 20 70 20  (nBytes);.    p 
1170: 3d 20 6d 61 6c 6c 6f 63 28 6e 42 79 74 65 73 2b  = malloc(nBytes+
1180: 38 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 20  8);.  }.  if( p 
1190: 29 7b 0a 20 20 20 20 70 5b 30 5d 20 3d 20 6e 42  ){.    p[0] = nB
11a0: 79 74 65 73 3b 0a 20 20 20 20 70 2b 2b 3b 0a 20  ytes;.    p++;. 
11b0: 20 20 20 6d 65 6d 2e 6e 6f 77 55 73 65 64 20 2b     mem.nowUsed +
11c0: 3d 20 6e 42 79 74 65 73 3b 0a 20 20 20 20 69 66  = nBytes;.    if
11d0: 28 20 6d 65 6d 2e 6e 6f 77 55 73 65 64 3e 6d 65  ( mem.nowUsed>me
11e0: 6d 2e 6d 78 55 73 65 64 20 29 7b 0a 20 20 20 20  m.mxUsed ){.    
11f0: 20 20 6d 65 6d 2e 6d 78 55 73 65 64 20 3d 20 6d    mem.mxUsed = m
1200: 65 6d 2e 6e 6f 77 55 73 65 64 3b 0a 20 20 20 20  em.nowUsed;.    
1210: 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f  }.  }.  sqlite3_
1220: 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 65 6d 2e  mutex_leave(mem.
1230: 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e  mutex);.  return
1240: 20 28 76 6f 69 64 2a 29 70 3b 20 0a 7d 0a 0a 2f   (void*)p; .}../
1250: 2a 0a 2a 2a 20 46 72 65 65 20 6d 65 6d 6f 72 79  *.** Free memory
1260: 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65  ..*/.void sqlite
1270: 33 5f 66 72 65 65 28 76 6f 69 64 20 2a 70 50 72  3_free(void *pPr
1280: 69 6f 72 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f  ior){.  sqlite3_
1290: 75 69 6e 74 36 34 20 2a 70 3b 0a 20 20 75 6e 73  uint64 *p;.  uns
12a0: 69 67 6e 65 64 20 6e 42 79 74 65 3b 0a 20 20 69  igned nByte;.  i
12b0: 66 28 20 70 50 72 69 6f 72 3d 3d 30 20 29 7b 0a  f( pPrior==0 ){.
12c0: 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a      return;.  }.
12d0: 20 20 61 73 73 65 72 74 28 20 6d 65 6d 2e 6d 75    assert( mem.mu
12e0: 74 65 78 21 3d 30 20 29 3b 0a 20 20 70 20 3d 20  tex!=0 );.  p = 
12f0: 70 50 72 69 6f 72 3b 0a 20 20 70 2d 2d 3b 0a 20  pPrior;.  p--;. 
1300: 20 6e 42 79 74 65 20 3d 20 28 75 6e 73 69 67 6e   nByte = (unsign
1310: 65 64 20 69 6e 74 29 2a 70 3b 0a 20 20 73 71 6c  ed int)*p;.  sql
1320: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72  ite3_mutex_enter
1330: 28 6d 65 6d 2e 6d 75 74 65 78 29 3b 0a 20 20 6d  (mem.mutex);.  m
1340: 65 6d 2e 6e 6f 77 55 73 65 64 20 2d 3d 20 6e 42  em.nowUsed -= nB
1350: 79 74 65 3b 0a 20 20 66 72 65 65 28 70 29 3b 0a  yte;.  free(p);.
1360: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f    sqlite3_mutex_
1370: 6c 65 61 76 65 28 6d 65 6d 2e 6d 75 74 65 78 29  leave(mem.mutex)
1380: 3b 20 20 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61  ;  .}../*.** Cha
1390: 6e 67 65 20 74 68 65 20 73 69 7a 65 20 6f 66 20  nge the size of 
13a0: 61 6e 20 65 78 69 73 74 69 6e 67 20 6d 65 6d 6f  an existing memo
13b0: 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 0a 2a 2f  ry allocation.*/
13c0: 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 72  .void *sqlite3_r
13d0: 65 61 6c 6c 6f 63 28 76 6f 69 64 20 2a 70 50 72  ealloc(void *pPr
13e0: 69 6f 72 2c 20 69 6e 74 20 6e 42 79 74 65 73 29  ior, int nBytes)
13f0: 7b 0a 20 20 75 6e 73 69 67 6e 65 64 20 6e 4f 6c  {.  unsigned nOl
1400: 64 3b 0a 20 20 73 71 6c 69 74 65 33 5f 75 69 6e  d;.  sqlite3_uin
1410: 74 36 34 20 2a 70 3b 0a 20 20 69 66 28 20 70 50  t64 *p;.  if( pP
1420: 72 69 6f 72 3d 3d 30 20 29 7b 0a 20 20 20 20 72  rior==0 ){.    r
1430: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 6d 61  eturn sqlite3_ma
1440: 6c 6c 6f 63 28 6e 42 79 74 65 73 29 3b 0a 20 20  lloc(nBytes);.  
1450: 7d 0a 20 20 69 66 28 20 6e 42 79 74 65 73 3c 3d  }.  if( nBytes<=
1460: 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  0 ){.    sqlite3
1470: 5f 66 72 65 65 28 70 50 72 69 6f 72 29 3b 0a 20  _free(pPrior);. 
1480: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d     return 0;.  }
1490: 0a 20 20 70 20 3d 20 70 50 72 69 6f 72 3b 0a 20  .  p = pPrior;. 
14a0: 20 70 2d 2d 3b 0a 20 20 6e 4f 6c 64 20 3d 20 28   p--;.  nOld = (
14b0: 75 6e 73 69 67 6e 65 64 20 69 6e 74 29 70 5b 30  unsigned int)p[0
14c0: 5d 3b 0a 20 20 61 73 73 65 72 74 28 20 6d 65 6d  ];.  assert( mem
14d0: 2e 6d 75 74 65 78 21 3d 30 20 29 3b 0a 20 20 73  .mutex!=0 );.  s
14e0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74  qlite3_mutex_ent
14f0: 65 72 28 6d 65 6d 2e 6d 75 74 65 78 29 3b 0a 20  er(mem.mutex);. 
1500: 20 69 66 28 20 6d 65 6d 2e 6e 6f 77 55 73 65 64   if( mem.nowUsed
1510: 2b 6e 42 79 74 65 73 2d 6e 4f 6c 64 3e 3d 6d 65  +nBytes-nOld>=me
1520: 6d 2e 61 6c 61 72 6d 54 68 72 65 73 68 6f 6c 64  m.alarmThreshold
1530: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 4d   ){.    sqlite3M
1540: 65 6d 73 79 73 41 6c 61 72 6d 28 6e 42 79 74 65  emsysAlarm(nByte
1550: 73 2d 6e 4f 6c 64 29 3b 0a 20 20 7d 0a 20 20 70  s-nOld);.  }.  p
1560: 20 3d 20 72 65 61 6c 6c 6f 63 28 70 2c 20 6e 42   = realloc(p, nB
1570: 79 74 65 73 2b 38 29 3b 0a 20 20 69 66 28 20 70  ytes+8);.  if( p
1580: 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  ==0 ){.    sqlit
1590: 65 33 4d 65 6d 73 79 73 41 6c 61 72 6d 28 6e 42  e3MemsysAlarm(nB
15a0: 79 74 65 73 29 3b 0a 20 20 20 20 70 20 3d 20 72  ytes);.    p = r
15b0: 65 61 6c 6c 6f 63 28 70 2c 20 6e 42 79 74 65 73  ealloc(p, nBytes
15c0: 2b 38 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70  +8);.  }.  if( p
15d0: 20 29 7b 0a 20 20 20 20 70 5b 30 5d 20 3d 20 6e   ){.    p[0] = n
15e0: 42 79 74 65 73 3b 0a 20 20 20 20 70 2b 2b 3b 0a  Bytes;.    p++;.
15f0: 20 20 20 20 6d 65 6d 2e 6e 6f 77 55 73 65 64 20      mem.nowUsed 
1600: 2b 3d 20 6e 42 79 74 65 73 2d 6e 4f 6c 64 3b 0a  += nBytes-nOld;.
1610: 20 20 20 20 69 66 28 20 6d 65 6d 2e 6e 6f 77 55      if( mem.nowU
1620: 73 65 64 3e 6d 65 6d 2e 6d 78 55 73 65 64 20 29  sed>mem.mxUsed )
1630: 7b 0a 20 20 20 20 20 20 6d 65 6d 2e 6d 78 55 73  {.      mem.mxUs
1640: 65 64 20 3d 20 6d 65 6d 2e 6e 6f 77 55 73 65 64  ed = mem.nowUsed
1650: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71  ;.    }.  }.  sq
1660: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76  lite3_mutex_leav
1670: 65 28 6d 65 6d 2e 6d 75 74 65 78 29 3b 0a 20 20  e(mem.mutex);.  
1680: 72 65 74 75 72 6e 20 28 76 6f 69 64 2a 29 70 3b  return (void*)p;
1690: 0a 7d 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 21 53  .}..#endif /* !S
16a0: 51 4c 49 54 45 5f 4d 45 4d 44 45 42 55 47 20 26  QLITE_MEMDEBUG &
16b0: 26 20 21 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d  & !SQLITE_OMIT_M
16c0: 45 4d 4f 52 59 5f 41 4c 4c 4f 43 41 54 49 4f 4e  EMORY_ALLOCATION
16d0: 20 2a 2f 0a                                       */.