0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65 /*.** 2001 Septe
0010: 6d 62 65 72 20 31 35 0a 2a 2a 0a 2a 2a 20 54 68 mber 15.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 ms copyright to
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a . In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d sing:.**.** M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 nd not evil..**
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 May you find
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 forgiveness for
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 give others..**
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 aking more than
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a you give..**.***
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0170: 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 4d 65 6d ******.**.** Mem
0180: 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 66 ory allocation f
0190: 75 6e 63 74 69 6f 6e 73 20 75 73 65 64 20 74 68 unctions used th
01a0: 72 6f 75 67 68 6f 75 74 20 73 71 6c 69 74 65 2e roughout sqlite.
01b0: 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 .*/.#include "sq
01c0: 6c 69 74 65 49 6e 74 2e 68 22 0a 23 69 6e 63 6c liteInt.h".#incl
01d0: 75 64 65 20 3c 73 74 64 61 72 67 2e 68 3e 0a 0a ude <stdarg.h>..
01e0: 2f 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f /*.** Attempt to
01f0: 20 72 65 6c 65 61 73 65 20 75 70 20 74 6f 20 6e release up to n
0200: 20 62 79 74 65 73 20 6f 66 20 6e 6f 6e 2d 65 73 bytes of non-es
0210: 73 65 6e 74 69 61 6c 20 6d 65 6d 6f 72 79 20 63 sential memory c
0220: 75 72 72 65 6e 74 6c 79 0a 2a 2a 20 68 65 6c 64 urrently.** held
0230: 20 62 79 20 53 51 4c 69 74 65 2e 20 41 6e 20 65 by SQLite. An e
0240: 78 61 6d 70 6c 65 20 6f 66 20 6e 6f 6e 2d 65 73 xample of non-es
0250: 73 65 6e 74 69 61 6c 20 6d 65 6d 6f 72 79 20 69 sential memory i
0260: 73 20 6d 65 6d 6f 72 79 20 75 73 65 64 20 74 6f s memory used to
0270: 0a 2a 2a 20 63 61 63 68 65 20 64 61 74 61 62 61 .** cache databa
0280: 73 65 20 70 61 67 65 73 20 74 68 61 74 20 61 72 se pages that ar
0290: 65 20 6e 6f 74 20 63 75 72 72 65 6e 74 6c 79 20 e not currently
02a0: 69 6e 20 75 73 65 2e 0a 2a 2f 0a 69 6e 74 20 73 in use..*/.int s
02b0: 71 6c 69 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d qlite3_release_m
02c0: 65 6d 6f 72 79 28 69 6e 74 20 6e 29 7b 0a 23 69 emory(int n){.#i
02d0: 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
02e0: 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 LE_MEMORY_MANAGE
02f0: 4d 45 4e 54 0a 20 20 72 65 74 75 72 6e 20 73 71 MENT. return sq
0300: 6c 69 74 65 33 50 63 61 63 68 65 52 65 6c 65 61 lite3PcacheRelea
0310: 73 65 4d 65 6d 6f 72 79 28 6e 29 3b 0a 23 65 6c seMemory(n);.#el
0320: 73 65 0a 20 20 2f 2a 20 49 4d 50 4c 45 4d 45 4e se. /* IMPLEMEN
0330: 54 41 54 49 4f 4e 2d 4f 46 3a 20 52 2d 33 34 33 TATION-OF: R-343
0340: 39 31 2d 32 34 39 32 31 20 54 68 65 20 73 71 6c 91-24921 The sql
0350: 69 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d ite3_release_mem
0360: 6f 72 79 28 29 20 72 6f 75 74 69 6e 65 0a 20 20 ory() routine.
0370: 2a 2a 20 69 73 20 61 20 6e 6f 2d 6f 70 20 72 65 ** is a no-op re
0380: 74 75 72 6e 69 6e 67 20 7a 65 72 6f 20 69 66 20 turning zero if
0390: 53 51 4c 69 74 65 20 69 73 20 6e 6f 74 20 63 6f SQLite is not co
03a0: 6d 70 69 6c 65 64 20 77 69 74 68 0a 20 20 2a 2a mpiled with. **
03b0: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d SQLITE_ENABLE_M
03c0: 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 EMORY_MANAGEMENT
03d0: 2e 20 2a 2f 0a 20 20 55 4e 55 53 45 44 5f 50 41 . */. UNUSED_PA
03e0: 52 41 4d 45 54 45 52 28 6e 29 3b 0a 20 20 72 65 RAMETER(n);. re
03f0: 74 75 72 6e 20 30 3b 0a 23 65 6e 64 69 66 0a 7d turn 0;.#endif.}
0400: 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 ../*.** An insta
0410: 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f nce of the follo
0420: 77 69 6e 67 20 6f 62 6a 65 63 74 20 72 65 63 6f wing object reco
0430: 72 64 73 20 74 68 65 20 6c 6f 63 61 74 69 6f 6e rds the location
0440: 20 6f 66 0a 2a 2a 20 65 61 63 68 20 75 6e 75 73 of.** each unus
0450: 65 64 20 73 63 72 61 74 63 68 20 62 75 66 66 65 ed scratch buffe
0460: 72 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 r..*/.typedef st
0470: 72 75 63 74 20 53 63 72 61 74 63 68 46 72 65 65 ruct ScratchFree
0480: 73 6c 6f 74 20 7b 0a 20 20 73 74 72 75 63 74 20 slot {. struct
0490: 53 63 72 61 74 63 68 46 72 65 65 73 6c 6f 74 20 ScratchFreeslot
04a0: 2a 70 4e 65 78 74 3b 20 20 20 2f 2a 20 4e 65 78 *pNext; /* Nex
04b0: 74 20 75 6e 75 73 65 64 20 73 63 72 61 74 63 68 t unused scratch
04c0: 20 62 75 66 66 65 72 20 2a 2f 0a 7d 20 53 63 72 buffer */.} Scr
04d0: 61 74 63 68 46 72 65 65 73 6c 6f 74 3b 0a 0a 2f atchFreeslot;../
04e0: 2a 0a 2a 2a 20 53 74 61 74 65 20 69 6e 66 6f 72 *.** State infor
04f0: 6d 61 74 69 6f 6e 20 6c 6f 63 61 6c 20 74 6f 20 mation local to
0500: 74 68 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 the memory alloc
0510: 61 74 69 6f 6e 20 73 75 62 73 79 73 74 65 6d 2e ation subsystem.
0520: 0a 2a 2f 0a 73 74 61 74 69 63 20 53 51 4c 49 54 .*/.static SQLIT
0530: 45 5f 57 53 44 20 73 74 72 75 63 74 20 4d 65 6d E_WSD struct Mem
0540: 30 47 6c 6f 62 61 6c 20 7b 0a 20 20 73 71 6c 69 0Global {. sqli
0550: 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 te3_mutex *mutex
0560: 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 75 74 ; /* Mut
0570: 65 78 20 74 6f 20 73 65 72 69 61 6c 69 7a 65 20 ex to serialize
0580: 61 63 63 65 73 73 20 2a 2f 0a 0a 20 20 2f 2a 0a access */.. /*.
0590: 20 20 2a 2a 20 54 68 65 20 61 6c 61 72 6d 20 63 ** The alarm c
05a0: 61 6c 6c 62 61 63 6b 20 61 6e 64 20 69 74 73 20 allback and its
05b0: 61 72 67 75 6d 65 6e 74 73 2e 20 20 54 68 65 20 arguments. The
05c0: 6d 65 6d 30 2e 6d 75 74 65 78 20 6c 6f 63 6b 20 mem0.mutex lock
05d0: 77 69 6c 6c 0a 20 20 2a 2a 20 62 65 20 68 65 6c will. ** be hel
05e0: 64 20 77 68 69 6c 65 20 74 68 65 20 63 61 6c 6c d while the call
05f0: 62 61 63 6b 20 69 73 20 72 75 6e 6e 69 6e 67 2e back is running.
0600: 20 20 52 65 63 75 72 73 69 76 65 20 63 61 6c 6c Recursive call
0610: 73 20 69 6e 74 6f 0a 20 20 2a 2a 20 74 68 65 20 s into. ** the
0620: 6d 65 6d 6f 72 79 20 73 75 62 73 79 73 74 65 6d memory subsystem
0630: 20 61 72 65 20 61 6c 6c 6f 77 65 64 2c 20 62 75 are allowed, bu
0640: 74 20 6e 6f 20 6e 65 77 20 63 61 6c 6c 62 61 63 t no new callbac
0650: 6b 73 20 77 69 6c 6c 20 62 65 0a 20 20 2a 2a 20 ks will be. **
0660: 69 73 73 75 65 64 2e 0a 20 20 2a 2f 0a 20 20 73 issued.. */. s
0670: 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 61 6c 61 qlite3_int64 ala
0680: 72 6d 54 68 72 65 73 68 6f 6c 64 3b 0a 20 20 76 rmThreshold;. v
0690: 6f 69 64 20 28 2a 61 6c 61 72 6d 43 61 6c 6c 62 oid (*alarmCallb
06a0: 61 63 6b 29 28 76 6f 69 64 2a 2c 20 73 71 6c 69 ack)(void*, sqli
06b0: 74 65 33 5f 69 6e 74 36 34 2c 69 6e 74 29 3b 0a te3_int64,int);.
06c0: 20 20 76 6f 69 64 20 2a 61 6c 61 72 6d 41 72 67 void *alarmArg
06d0: 3b 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 50 6f 69 ;.. /*. ** Poi
06e0: 6e 74 65 72 73 20 74 6f 20 74 68 65 20 65 6e 64 nters to the end
06f0: 20 6f 66 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 of sqlite3Globa
0700: 6c 43 6f 6e 66 69 67 2e 70 53 63 72 61 74 63 68 lConfig.pScratch
0710: 20 6d 65 6d 6f 72 79 0a 20 20 2a 2a 20 28 73 6f memory. ** (so
0720: 20 74 68 61 74 20 61 20 72 61 6e 67 65 20 74 65 that a range te
0730: 73 74 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 st can be used t
0740: 6f 20 64 65 74 65 72 6d 69 6e 65 20 69 66 20 61 o determine if a
0750: 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e 0a 20 20 2a n allocation. *
0760: 2a 20 62 65 69 6e 67 20 66 72 65 65 64 20 63 61 * being freed ca
0770: 6d 65 20 66 72 6f 6d 20 70 53 63 72 61 74 63 68 me from pScratch
0780: 29 20 61 6e 64 20 61 20 70 6f 69 6e 74 65 72 20 ) and a pointer
0790: 74 6f 20 74 68 65 20 6c 69 73 74 20 6f 66 0a 20 to the list of.
07a0: 20 2a 2a 20 75 6e 75 73 65 64 20 73 63 72 61 74 ** unused scrat
07b0: 63 68 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 2e 0a ch allocations..
07c0: 20 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 53 63 */. void *pSc
07d0: 72 61 74 63 68 45 6e 64 3b 0a 20 20 53 63 72 61 ratchEnd;. Scra
07e0: 74 63 68 46 72 65 65 73 6c 6f 74 20 2a 70 53 63 tchFreeslot *pSc
07f0: 72 61 74 63 68 46 72 65 65 3b 0a 20 20 75 33 32 ratchFree;. u32
0800: 20 6e 53 63 72 61 74 63 68 46 72 65 65 3b 0a 0a nScratchFree;..
0810: 20 20 2f 2a 0a 20 20 2a 2a 20 54 72 75 65 20 69 /*. ** True i
0820: 66 20 68 65 61 70 20 69 73 20 6e 65 61 72 6c 79 f heap is nearly
0830: 20 22 66 75 6c 6c 22 20 77 68 65 72 65 20 22 66 "full" where "f
0840: 75 6c 6c 22 20 69 73 20 64 65 66 69 6e 65 64 20 ull" is defined
0850: 62 79 20 74 68 65 0a 20 20 2a 2a 20 73 71 6c 69 by the. ** sqli
0860: 74 65 33 5f 73 6f 66 74 5f 68 65 61 70 5f 6c 69 te3_soft_heap_li
0870: 6d 69 74 28 29 20 73 65 74 74 69 6e 67 2e 0a 20 mit() setting..
0880: 20 2a 2f 0a 20 20 69 6e 74 20 6e 65 61 72 6c 79 */. int nearly
0890: 46 75 6c 6c 3b 0a 7d 20 6d 65 6d 30 20 3d 20 7b Full;.} mem0 = {
08a0: 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 0, 0, 0, 0, 0,
08b0: 30 2c 20 30 2c 20 30 20 7d 3b 0a 0a 23 64 65 66 0, 0, 0 };..#def
08c0: 69 6e 65 20 6d 65 6d 30 20 47 4c 4f 42 41 4c 28 ine mem0 GLOBAL(
08d0: 73 74 72 75 63 74 20 4d 65 6d 30 47 6c 6f 62 61 struct Mem0Globa
08e0: 6c 2c 20 6d 65 6d 30 29 0a 0a 2f 2a 0a 2a 2a 20 l, mem0)../*.**
08f0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 72 75 6e This routine run
0900: 73 20 77 68 65 6e 20 74 68 65 20 6d 65 6d 6f 72 s when the memor
0910: 79 20 61 6c 6c 6f 63 61 74 6f 72 20 73 65 65 73 y allocator sees
0920: 20 74 68 61 74 20 74 68 65 0a 2a 2a 20 74 6f 74 that the.** tot
0930: 61 6c 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 al memory alloca
0940: 74 69 6f 6e 20 69 73 20 61 62 6f 75 74 20 74 6f tion is about to
0950: 20 65 78 63 65 65 64 20 74 68 65 20 73 6f 66 74 exceed the soft
0960: 20 68 65 61 70 0a 2a 2a 20 6c 69 6d 69 74 2e 0a heap.** limit..
0970: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 73 */.static void s
0980: 6f 66 74 48 65 61 70 4c 69 6d 69 74 45 6e 66 6f oftHeapLimitEnfo
0990: 72 63 65 72 28 0a 20 20 76 6f 69 64 20 2a 4e 6f rcer(. void *No
09a0: 74 55 73 65 64 2c 20 0a 20 20 73 71 6c 69 74 65 tUsed, . sqlite
09b0: 33 5f 69 6e 74 36 34 20 4e 6f 74 55 73 65 64 32 3_int64 NotUsed2
09c0: 2c 0a 20 20 69 6e 74 20 61 6c 6c 6f 63 53 69 7a ,. int allocSiz
09d0: 65 0a 29 7b 0a 20 20 55 4e 55 53 45 44 5f 50 41 e.){. UNUSED_PA
09e0: 52 41 4d 45 54 45 52 32 28 4e 6f 74 55 73 65 64 RAMETER2(NotUsed
09f0: 2c 20 4e 6f 74 55 73 65 64 32 29 3b 0a 20 20 73 , NotUsed2);. s
0a00: 71 6c 69 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d qlite3_release_m
0a10: 65 6d 6f 72 79 28 61 6c 6c 6f 63 53 69 7a 65 29 emory(allocSize)
0a20: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 ;.}../*.** Chang
0a30: 65 20 74 68 65 20 61 6c 61 72 6d 20 63 61 6c 6c e the alarm call
0a40: 62 61 63 6b 0a 2a 2f 0a 73 74 61 74 69 63 20 69 back.*/.static i
0a50: 6e 74 20 73 71 6c 69 74 65 33 4d 65 6d 6f 72 79 nt sqlite3Memory
0a60: 41 6c 61 72 6d 28 0a 20 20 76 6f 69 64 28 2a 78 Alarm(. void(*x
0a70: 43 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 20 2a Callback)(void *
0a80: 70 41 72 67 2c 20 73 71 6c 69 74 65 33 5f 69 6e pArg, sqlite3_in
0a90: 74 36 34 20 75 73 65 64 2c 69 6e 74 20 4e 29 2c t64 used,int N),
0aa0: 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 2c 0a 20 . void *pArg,.
0ab0: 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 69 sqlite3_int64 i
0ac0: 54 68 72 65 73 68 6f 6c 64 0a 29 7b 0a 20 20 69 Threshold.){. i
0ad0: 6e 74 20 6e 55 73 65 64 3b 0a 20 20 73 71 6c 69 nt nUsed;. sqli
0ae0: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
0af0: 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 6d mem0.mutex);. m
0b00: 65 6d 30 2e 61 6c 61 72 6d 43 61 6c 6c 62 61 63 em0.alarmCallbac
0b10: 6b 20 3d 20 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 k = xCallback;.
0b20: 20 6d 65 6d 30 2e 61 6c 61 72 6d 41 72 67 20 3d mem0.alarmArg =
0b30: 20 70 41 72 67 3b 0a 20 20 6d 65 6d 30 2e 61 6c pArg;. mem0.al
0b40: 61 72 6d 54 68 72 65 73 68 6f 6c 64 20 3d 20 69 armThreshold = i
0b50: 54 68 72 65 73 68 6f 6c 64 3b 0a 20 20 6e 55 73 Threshold;. nUs
0b60: 65 64 20 3d 20 73 71 6c 69 74 65 33 53 74 61 74 ed = sqlite3Stat
0b70: 75 73 56 61 6c 75 65 28 53 51 4c 49 54 45 5f 53 usValue(SQLITE_S
0b80: 54 41 54 55 53 5f 4d 45 4d 4f 52 59 5f 55 53 45 TATUS_MEMORY_USE
0b90: 44 29 3b 0a 20 20 6d 65 6d 30 2e 6e 65 61 72 6c D);. mem0.nearl
0ba0: 79 46 75 6c 6c 20 3d 20 28 69 54 68 72 65 73 68 yFull = (iThresh
0bb0: 6f 6c 64 3e 30 20 26 26 20 69 54 68 72 65 73 68 old>0 && iThresh
0bc0: 6f 6c 64 3c 3d 6e 55 73 65 64 29 3b 0a 20 20 73 old<=nUsed);. s
0bd0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
0be0: 76 65 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a ve(mem0.mutex);.
0bf0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
0c00: 4f 4b 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 OK;.}..#ifndef S
0c10: 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 50 52 45 QLITE_OMIT_DEPRE
0c20: 43 41 54 45 44 0a 2f 2a 0a 2a 2a 20 44 65 70 72 CATED./*.** Depr
0c30: 65 63 61 74 65 64 20 65 78 74 65 72 6e 61 6c 20 ecated external
0c40: 69 6e 74 65 72 66 61 63 65 2e 20 20 49 6e 74 65 interface. Inte
0c50: 72 6e 61 6c 2f 63 6f 72 65 20 53 51 4c 69 74 65 rnal/core SQLite
0c60: 20 63 6f 64 65 0a 2a 2a 20 73 68 6f 75 6c 64 20 code.** should
0c70: 63 61 6c 6c 20 73 71 6c 69 74 65 33 4d 65 6d 6f call sqlite3Memo
0c80: 72 79 41 6c 61 72 6d 2e 0a 2a 2f 0a 69 6e 74 20 ryAlarm..*/.int
0c90: 73 71 6c 69 74 65 33 5f 6d 65 6d 6f 72 79 5f 61 sqlite3_memory_a
0ca0: 6c 61 72 6d 28 0a 20 20 76 6f 69 64 28 2a 78 43 larm(. void(*xC
0cb0: 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 20 2a 70 allback)(void *p
0cc0: 41 72 67 2c 20 73 71 6c 69 74 65 33 5f 69 6e 74 Arg, sqlite3_int
0cd0: 36 34 20 75 73 65 64 2c 69 6e 74 20 4e 29 2c 0a 64 used,int N),.
0ce0: 20 20 76 6f 69 64 20 2a 70 41 72 67 2c 0a 20 20 void *pArg,.
0cf0: 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 69 54 sqlite3_int64 iT
0d00: 68 72 65 73 68 6f 6c 64 0a 29 7b 0a 20 20 72 65 hreshold.){. re
0d10: 74 75 72 6e 20 73 71 6c 69 74 65 33 4d 65 6d 6f turn sqlite3Memo
0d20: 72 79 41 6c 61 72 6d 28 78 43 61 6c 6c 62 61 63 ryAlarm(xCallbac
0d30: 6b 2c 20 70 41 72 67 2c 20 69 54 68 72 65 73 68 k, pArg, iThresh
0d40: 6f 6c 64 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a old);.}.#endif..
0d50: 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 73 6f /*.** Set the so
0d60: 66 74 20 68 65 61 70 2d 73 69 7a 65 20 6c 69 6d ft heap-size lim
0d70: 69 74 20 66 6f 72 20 74 68 65 20 6c 69 62 72 61 it for the libra
0d80: 72 79 2e 20 50 61 73 73 69 6e 67 20 61 20 7a 65 ry. Passing a ze
0d90: 72 6f 20 6f 72 20 0a 2a 2a 20 6e 65 67 61 74 69 ro or .** negati
0da0: 76 65 20 76 61 6c 75 65 20 69 6e 64 69 63 61 74 ve value indicat
0db0: 65 73 20 6e 6f 20 6c 69 6d 69 74 2e 0a 2a 2f 0a es no limit..*/.
0dc0: 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 73 71 sqlite3_int64 sq
0dd0: 6c 69 74 65 33 5f 73 6f 66 74 5f 68 65 61 70 5f lite3_soft_heap_
0de0: 6c 69 6d 69 74 36 34 28 73 71 6c 69 74 65 33 5f limit64(sqlite3_
0df0: 69 6e 74 36 34 20 6e 29 7b 0a 20 20 73 71 6c 69 int64 n){. sqli
0e00: 74 65 33 5f 69 6e 74 36 34 20 70 72 69 6f 72 4c te3_int64 priorL
0e10: 69 6d 69 74 3b 0a 20 20 73 71 6c 69 74 65 33 5f imit;. sqlite3_
0e20: 69 6e 74 36 34 20 65 78 63 65 73 73 3b 0a 23 69 int64 excess;.#i
0e30: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
0e40: 54 5f 41 55 54 4f 49 4e 49 54 0a 20 20 73 71 6c T_AUTOINIT. sql
0e50: 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 ite3_initialize(
0e60: 29 3b 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 );.#endif. sqli
0e70: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
0e80: 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 70 mem0.mutex);. p
0e90: 72 69 6f 72 4c 69 6d 69 74 20 3d 20 6d 65 6d 30 riorLimit = mem0
0ea0: 2e 61 6c 61 72 6d 54 68 72 65 73 68 6f 6c 64 3b .alarmThreshold;
0eb0: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
0ec0: 5f 6c 65 61 76 65 28 6d 65 6d 30 2e 6d 75 74 65 _leave(mem0.mute
0ed0: 78 29 3b 0a 20 20 69 66 28 20 6e 3c 30 20 29 20 x);. if( n<0 )
0ee0: 72 65 74 75 72 6e 20 70 72 69 6f 72 4c 69 6d 69 return priorLimi
0ef0: 74 3b 0a 20 20 69 66 28 20 6e 3e 30 20 29 7b 0a t;. if( n>0 ){.
0f00: 20 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 6f 72 sqlite3Memor
0f10: 79 41 6c 61 72 6d 28 73 6f 66 74 48 65 61 70 4c yAlarm(softHeapL
0f20: 69 6d 69 74 45 6e 66 6f 72 63 65 72 2c 20 30 2c imitEnforcer, 0,
0f30: 20 6e 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 n);. }else{.
0f40: 20 20 73 71 6c 69 74 65 33 4d 65 6d 6f 72 79 41 sqlite3MemoryA
0f50: 6c 61 72 6d 28 30 2c 20 30 2c 20 30 29 3b 0a 20 larm(0, 0, 0);.
0f60: 20 7d 0a 20 20 65 78 63 65 73 73 20 3d 20 73 71 }. excess = sq
0f70: 6c 69 74 65 33 5f 6d 65 6d 6f 72 79 5f 75 73 65 lite3_memory_use
0f80: 64 28 29 20 2d 20 6e 3b 0a 20 20 69 66 28 20 65 d() - n;. if( e
0f90: 78 63 65 73 73 3e 30 20 29 20 73 71 6c 69 74 65 xcess>0 ) sqlite
0fa0: 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f 72 79 3_release_memory
0fb0: 28 65 78 63 65 73 73 20 26 20 30 78 37 66 66 66 (excess & 0x7fff
0fc0: 66 66 66 66 29 3b 0a 20 20 72 65 74 75 72 6e 20 ffff);. return
0fd0: 70 72 69 6f 72 4c 69 6d 69 74 3b 0a 7d 0a 76 6f priorLimit;.}.vo
0fe0: 69 64 20 73 71 6c 69 74 65 33 5f 73 6f 66 74 5f id sqlite3_soft_
0ff0: 68 65 61 70 5f 6c 69 6d 69 74 28 69 6e 74 20 6e heap_limit(int n
1000: 29 7b 0a 20 20 69 66 28 20 6e 3c 30 20 29 20 6e ){. if( n<0 ) n
1010: 20 3d 20 30 3b 0a 20 20 73 71 6c 69 74 65 33 5f = 0;. sqlite3_
1020: 73 6f 66 74 5f 68 65 61 70 5f 6c 69 6d 69 74 36 soft_heap_limit6
1030: 34 28 6e 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 4(n);.}../*.** I
1040: 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 6d 65 nitialize the me
1050: 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 mory allocation
1060: 73 75 62 73 79 73 74 65 6d 2e 0a 2a 2f 0a 69 6e subsystem..*/.in
1070: 74 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 49 t sqlite3MallocI
1080: 6e 69 74 28 76 6f 69 64 29 7b 0a 20 20 69 66 28 nit(void){. if(
1090: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
10a0: 6e 66 69 67 2e 6d 2e 78 4d 61 6c 6c 6f 63 3d 3d nfig.m.xMalloc==
10b0: 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 0 ){. sqlite3
10c0: 4d 65 6d 53 65 74 44 65 66 61 75 6c 74 28 29 3b MemSetDefault();
10d0: 0a 20 20 7d 0a 20 20 6d 65 6d 73 65 74 28 26 6d . }. memset(&m
10e0: 65 6d 30 2c 20 30 2c 20 73 69 7a 65 6f 66 28 6d em0, 0, sizeof(m
10f0: 65 6d 30 29 29 3b 0a 20 20 69 66 28 20 73 71 6c em0));. if( sql
1100: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
1110: 2e 62 43 6f 72 65 4d 75 74 65 78 20 29 7b 0a 20 .bCoreMutex ){.
1120: 20 20 20 6d 65 6d 30 2e 6d 75 74 65 78 20 3d 20 mem0.mutex =
1130: 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f sqlite3MutexAllo
1140: 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 c(SQLITE_MUTEX_S
1150: 54 41 54 49 43 5f 4d 45 4d 29 3b 0a 20 20 7d 0a TATIC_MEM);. }.
1160: 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f if( sqlite3Glo
1170: 62 61 6c 43 6f 6e 66 69 67 2e 70 53 63 72 61 74 balConfig.pScrat
1180: 63 68 20 26 26 20 73 71 6c 69 74 65 33 47 6c 6f ch && sqlite3Glo
1190: 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 53 63 72 61 balConfig.szScra
11a0: 74 63 68 3e 3d 31 30 30 0a 20 20 20 20 20 20 26 tch>=100. &
11b0: 26 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 & sqlite3GlobalC
11c0: 6f 6e 66 69 67 2e 6e 53 63 72 61 74 63 68 3e 30 onfig.nScratch>0
11d0: 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 2c 20 6e ){. int i, n
11e0: 2c 20 73 7a 3b 0a 20 20 20 20 53 63 72 61 74 63 , sz;. Scratc
11f0: 68 46 72 65 65 73 6c 6f 74 20 2a 70 53 6c 6f 74 hFreeslot *pSlot
1200: 3b 0a 20 20 20 20 73 7a 20 3d 20 52 4f 55 4e 44 ;. sz = ROUND
1210: 44 4f 57 4e 38 28 73 71 6c 69 74 65 33 47 6c 6f DOWN8(sqlite3Glo
1220: 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 53 63 72 61 balConfig.szScra
1230: 74 63 68 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 tch);. sqlite
1240: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 3GlobalConfig.sz
1250: 53 63 72 61 74 63 68 20 3d 20 73 7a 3b 0a 20 20 Scratch = sz;.
1260: 20 20 70 53 6c 6f 74 20 3d 20 28 53 63 72 61 74 pSlot = (Scrat
1270: 63 68 46 72 65 65 73 6c 6f 74 2a 29 73 71 6c 69 chFreeslot*)sqli
1280: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
1290: 70 53 63 72 61 74 63 68 3b 0a 20 20 20 20 6e 20 pScratch;. n
12a0: 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 = sqlite3GlobalC
12b0: 6f 6e 66 69 67 2e 6e 53 63 72 61 74 63 68 3b 0a onfig.nScratch;.
12c0: 20 20 20 20 6d 65 6d 30 2e 70 53 63 72 61 74 63 mem0.pScratc
12d0: 68 46 72 65 65 20 3d 20 70 53 6c 6f 74 3b 0a 20 hFree = pSlot;.
12e0: 20 20 20 6d 65 6d 30 2e 6e 53 63 72 61 74 63 68 mem0.nScratch
12f0: 46 72 65 65 20 3d 20 6e 3b 0a 20 20 20 20 66 6f Free = n;. fo
1300: 72 28 69 3d 30 3b 20 69 3c 6e 2d 31 3b 20 69 2b r(i=0; i<n-1; i+
1310: 2b 29 7b 0a 20 20 20 20 20 20 70 53 6c 6f 74 2d +){. pSlot-
1320: 3e 70 4e 65 78 74 20 3d 20 28 53 63 72 61 74 63 >pNext = (Scratc
1330: 68 46 72 65 65 73 6c 6f 74 2a 29 28 73 7a 2b 28 hFreeslot*)(sz+(
1340: 63 68 61 72 2a 29 70 53 6c 6f 74 29 3b 0a 20 20 char*)pSlot);.
1350: 20 20 20 20 70 53 6c 6f 74 20 3d 20 70 53 6c 6f pSlot = pSlo
1360: 74 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 7d 0a t->pNext;. }.
1370: 20 20 20 20 70 53 6c 6f 74 2d 3e 70 4e 65 78 74 pSlot->pNext
1380: 20 3d 20 30 3b 0a 20 20 20 20 6d 65 6d 30 2e 70 = 0;. mem0.p
1390: 53 63 72 61 74 63 68 45 6e 64 20 3d 20 28 76 6f ScratchEnd = (vo
13a0: 69 64 2a 29 26 70 53 6c 6f 74 5b 31 5d 3b 0a 20 id*)&pSlot[1];.
13b0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 6d 65 6d 30 }else{. mem0
13c0: 2e 70 53 63 72 61 74 63 68 45 6e 64 20 3d 20 30 .pScratchEnd = 0
13d0: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f ;. sqlite3Glo
13e0: 62 61 6c 43 6f 6e 66 69 67 2e 70 53 63 72 61 74 balConfig.pScrat
13f0: 63 68 20 3d 20 30 3b 0a 20 20 20 20 73 71 6c 69 ch = 0;. sqli
1400: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
1410: 73 7a 53 63 72 61 74 63 68 20 3d 20 30 3b 0a 20 szScratch = 0;.
1420: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
1430: 43 6f 6e 66 69 67 2e 6e 53 63 72 61 74 63 68 20 Config.nScratch
1440: 3d 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 = 0;. }. if( s
1450: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
1460: 69 67 2e 70 50 61 67 65 3d 3d 30 20 7c 7c 20 73 ig.pPage==0 || s
1470: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
1480: 69 67 2e 73 7a 50 61 67 65 3c 35 31 32 0a 20 20 ig.szPage<512.
1490: 20 20 20 20 7c 7c 20 73 71 6c 69 74 65 33 47 6c || sqlite3Gl
14a0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 50 61 67 65 obalConfig.nPage
14b0: 3c 31 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 <1 ){. sqlite
14c0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 50 3GlobalConfig.pP
14d0: 61 67 65 20 3d 20 30 3b 0a 20 20 20 20 73 71 6c age = 0;. sql
14e0: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
14f0: 2e 73 7a 50 61 67 65 20 3d 20 30 3b 0a 20 20 20 .szPage = 0;.
1500: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
1510: 6e 66 69 67 2e 6e 50 61 67 65 20 3d 20 30 3b 0a nfig.nPage = 0;.
1520: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 73 71 6c }. return sql
1530: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
1540: 2e 6d 2e 78 49 6e 69 74 28 73 71 6c 69 74 65 33 .m.xInit(sqlite3
1550: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 70 GlobalConfig.m.p
1560: 41 70 70 44 61 74 61 29 3b 0a 7d 0a 0a 2f 2a 0a AppData);.}../*.
1570: 2a 2a 20 52 65 74 75 72 6e 20 74 72 75 65 20 69 ** Return true i
1580: 66 20 74 68 65 20 68 65 61 70 20 69 73 20 63 75 f the heap is cu
1590: 72 72 65 6e 74 6c 79 20 75 6e 64 65 72 20 6d 65 rrently under me
15a0: 6d 6f 72 79 20 70 72 65 73 73 75 72 65 20 2d 20 mory pressure -
15b0: 69 6e 20 6f 74 68 65 72 0a 2a 2a 20 77 6f 72 64 in other.** word
15c0: 73 20 69 66 20 74 68 65 20 61 6d 6f 75 6e 74 20 s if the amount
15d0: 6f 66 20 68 65 61 70 20 75 73 65 64 20 69 73 20 of heap used is
15e0: 63 6c 6f 73 65 20 74 6f 20 74 68 65 20 6c 69 6d close to the lim
15f0: 69 74 20 73 65 74 20 62 79 0a 2a 2a 20 73 71 6c it set by.** sql
1600: 69 74 65 33 5f 73 6f 66 74 5f 68 65 61 70 5f 6c ite3_soft_heap_l
1610: 69 6d 69 74 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 imit()..*/.int s
1620: 71 6c 69 74 65 33 48 65 61 70 4e 65 61 72 6c 79 qlite3HeapNearly
1630: 46 75 6c 6c 28 76 6f 69 64 29 7b 0a 20 20 72 65 Full(void){. re
1640: 74 75 72 6e 20 6d 65 6d 30 2e 6e 65 61 72 6c 79 turn mem0.nearly
1650: 46 75 6c 6c 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 Full;.}../*.** D
1660: 65 69 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 einitialize the
1670: 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f memory allocatio
1680: 6e 20 73 75 62 73 79 73 74 65 6d 2e 0a 2a 2f 0a n subsystem..*/.
1690: 76 6f 69 64 20 73 71 6c 69 74 65 33 4d 61 6c 6c void sqlite3Mall
16a0: 6f 63 45 6e 64 28 76 6f 69 64 29 7b 0a 20 20 69 ocEnd(void){. i
16b0: 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c f( sqlite3Global
16c0: 43 6f 6e 66 69 67 2e 6d 2e 78 53 68 75 74 64 6f Config.m.xShutdo
16d0: 77 6e 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 wn ){. sqlite
16e0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 3GlobalConfig.m.
16f0: 78 53 68 75 74 64 6f 77 6e 28 73 71 6c 69 74 65 xShutdown(sqlite
1700: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 3GlobalConfig.m.
1710: 70 41 70 70 44 61 74 61 29 3b 0a 20 20 7d 0a 20 pAppData);. }.
1720: 20 6d 65 6d 73 65 74 28 26 6d 65 6d 30 2c 20 30 memset(&mem0, 0
1730: 2c 20 73 69 7a 65 6f 66 28 6d 65 6d 30 29 29 3b , sizeof(mem0));
1740: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e .}../*.** Return
1750: 20 74 68 65 20 61 6d 6f 75 6e 74 20 6f 66 20 6d the amount of m
1760: 65 6d 6f 72 79 20 63 75 72 72 65 6e 74 6c 79 20 emory currently
1770: 63 68 65 63 6b 65 64 20 6f 75 74 2e 0a 2a 2f 0a checked out..*/.
1780: 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 73 71 sqlite3_int64 sq
1790: 6c 69 74 65 33 5f 6d 65 6d 6f 72 79 5f 75 73 65 lite3_memory_use
17a0: 64 28 76 6f 69 64 29 7b 0a 20 20 69 6e 74 20 6e d(void){. int n
17b0: 2c 20 6d 78 3b 0a 20 20 73 71 6c 69 74 65 33 5f , mx;. sqlite3_
17c0: 69 6e 74 36 34 20 72 65 73 3b 0a 20 20 73 71 6c int64 res;. sql
17d0: 69 74 65 33 5f 73 74 61 74 75 73 28 53 51 4c 49 ite3_status(SQLI
17e0: 54 45 5f 53 54 41 54 55 53 5f 4d 45 4d 4f 52 59 TE_STATUS_MEMORY
17f0: 5f 55 53 45 44 2c 20 26 6e 2c 20 26 6d 78 2c 20 _USED, &n, &mx,
1800: 30 29 3b 0a 20 20 72 65 73 20 3d 20 28 73 71 6c 0);. res = (sql
1810: 69 74 65 33 5f 69 6e 74 36 34 29 6e 3b 20 20 2f ite3_int64)n; /
1820: 2a 20 57 6f 72 6b 20 61 72 6f 75 6e 64 20 62 75 * Work around bu
1830: 67 20 69 6e 20 42 6f 72 6c 61 6e 64 20 43 2e 20 g in Borland C.
1840: 54 69 63 6b 65 74 20 23 33 32 31 36 20 2a 2f 0a Ticket #3216 */.
1850: 20 20 72 65 74 75 72 6e 20 72 65 73 3b 0a 7d 0a return res;.}.
1860: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 ./*.** Return th
1870: 65 20 6d 61 78 69 6d 75 6d 20 61 6d 6f 75 6e 74 e maximum amount
1880: 20 6f 66 20 6d 65 6d 6f 72 79 20 74 68 61 74 20 of memory that
1890: 68 61 73 20 65 76 65 72 20 62 65 65 6e 0a 2a 2a has ever been.**
18a0: 20 63 68 65 63 6b 65 64 20 6f 75 74 20 73 69 6e checked out sin
18b0: 63 65 20 65 69 74 68 65 72 20 74 68 65 20 62 65 ce either the be
18c0: 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68 69 73 20 ginning of this
18d0: 70 72 6f 63 65 73 73 0a 2a 2a 20 6f 72 20 73 69 process.** or si
18e0: 6e 63 65 20 74 68 65 20 6d 6f 73 74 20 72 65 63 nce the most rec
18f0: 65 6e 74 20 72 65 73 65 74 2e 0a 2a 2f 0a 73 71 ent reset..*/.sq
1900: 6c 69 74 65 33 5f 69 6e 74 36 34 20 73 71 6c 69 lite3_int64 sqli
1910: 74 65 33 5f 6d 65 6d 6f 72 79 5f 68 69 67 68 77 te3_memory_highw
1920: 61 74 65 72 28 69 6e 74 20 72 65 73 65 74 46 6c ater(int resetFl
1930: 61 67 29 7b 0a 20 20 69 6e 74 20 6e 2c 20 6d 78 ag){. int n, mx
1940: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 ;. sqlite3_int6
1950: 34 20 72 65 73 3b 0a 20 20 73 71 6c 69 74 65 33 4 res;. sqlite3
1960: 5f 73 74 61 74 75 73 28 53 51 4c 49 54 45 5f 53 _status(SQLITE_S
1970: 54 41 54 55 53 5f 4d 45 4d 4f 52 59 5f 55 53 45 TATUS_MEMORY_USE
1980: 44 2c 20 26 6e 2c 20 26 6d 78 2c 20 72 65 73 65 D, &n, &mx, rese
1990: 74 46 6c 61 67 29 3b 0a 20 20 72 65 73 20 3d 20 tFlag);. res =
19a0: 28 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 29 6d (sqlite3_int64)m
19b0: 78 3b 20 20 2f 2a 20 57 6f 72 6b 20 61 72 6f 75 x; /* Work arou
19c0: 6e 64 20 62 75 67 20 69 6e 20 42 6f 72 6c 61 6e nd bug in Borlan
19d0: 64 20 43 2e 20 54 69 63 6b 65 74 20 23 33 32 31 d C. Ticket #321
19e0: 36 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 72 65 6 */. return re
19f0: 73 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 72 69 67 s;.}../*.** Trig
1a00: 67 65 72 20 74 68 65 20 61 6c 61 72 6d 20 0a 2a ger the alarm .*
1a10: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 73 71 /.static void sq
1a20: 6c 69 74 65 33 4d 61 6c 6c 6f 63 41 6c 61 72 6d lite3MallocAlarm
1a30: 28 69 6e 74 20 6e 42 79 74 65 29 7b 0a 20 20 76 (int nByte){. v
1a40: 6f 69 64 20 28 2a 78 43 61 6c 6c 62 61 63 6b 29 oid (*xCallback)
1a50: 28 76 6f 69 64 2a 2c 73 71 6c 69 74 65 33 5f 69 (void*,sqlite3_i
1a60: 6e 74 36 34 2c 69 6e 74 29 3b 0a 20 20 73 71 6c nt64,int);. sql
1a70: 69 74 65 33 5f 69 6e 74 36 34 20 6e 6f 77 55 73 ite3_int64 nowUs
1a80: 65 64 3b 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 ed;. void *pArg
1a90: 3b 0a 20 20 69 66 28 20 6d 65 6d 30 2e 61 6c 61 ;. if( mem0.ala
1aa0: 72 6d 43 61 6c 6c 62 61 63 6b 3d 3d 30 20 29 20 rmCallback==0 )
1ab0: 72 65 74 75 72 6e 3b 0a 20 20 78 43 61 6c 6c 62 return;. xCallb
1ac0: 61 63 6b 20 3d 20 6d 65 6d 30 2e 61 6c 61 72 6d ack = mem0.alarm
1ad0: 43 61 6c 6c 62 61 63 6b 3b 0a 20 20 6e 6f 77 55 Callback;. nowU
1ae0: 73 65 64 20 3d 20 73 71 6c 69 74 65 33 53 74 61 sed = sqlite3Sta
1af0: 74 75 73 56 61 6c 75 65 28 53 51 4c 49 54 45 5f tusValue(SQLITE_
1b00: 53 54 41 54 55 53 5f 4d 45 4d 4f 52 59 5f 55 53 STATUS_MEMORY_US
1b10: 45 44 29 3b 0a 20 20 70 41 72 67 20 3d 20 6d 65 ED);. pArg = me
1b20: 6d 30 2e 61 6c 61 72 6d 41 72 67 3b 0a 20 20 6d m0.alarmArg;. m
1b30: 65 6d 30 2e 61 6c 61 72 6d 43 61 6c 6c 62 61 63 em0.alarmCallbac
1b40: 6b 20 3d 20 30 3b 0a 20 20 73 71 6c 69 74 65 33 k = 0;. sqlite3
1b50: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 65 6d _mutex_leave(mem
1b60: 30 2e 6d 75 74 65 78 29 3b 0a 20 20 78 43 61 6c 0.mutex);. xCal
1b70: 6c 62 61 63 6b 28 70 41 72 67 2c 20 6e 6f 77 55 lback(pArg, nowU
1b80: 73 65 64 2c 20 6e 42 79 74 65 29 3b 0a 20 20 73 sed, nByte);. s
1b90: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
1ba0: 65 72 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a er(mem0.mutex);.
1bb0: 20 20 6d 65 6d 30 2e 61 6c 61 72 6d 43 61 6c 6c mem0.alarmCall
1bc0: 62 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61 63 6b back = xCallback
1bd0: 3b 0a 20 20 6d 65 6d 30 2e 61 6c 61 72 6d 41 72 ;. mem0.alarmAr
1be0: 67 20 3d 20 70 41 72 67 3b 0a 7d 0a 0a 2f 2a 0a g = pArg;.}../*.
1bf0: 2a 2a 20 44 6f 20 61 20 6d 65 6d 6f 72 79 20 61 ** Do a memory a
1c00: 6c 6c 6f 63 61 74 69 6f 6e 20 77 69 74 68 20 73 llocation with s
1c10: 74 61 74 69 73 74 69 63 73 20 61 6e 64 20 61 6c tatistics and al
1c20: 61 72 6d 73 2e 20 20 41 73 73 75 6d 65 20 74 68 arms. Assume th
1c30: 65 0a 2a 2a 20 6c 6f 63 6b 20 69 73 20 61 6c 72 e.** lock is alr
1c40: 65 61 64 79 20 68 65 6c 64 2e 0a 2a 2f 0a 73 74 eady held..*/.st
1c50: 61 74 69 63 20 69 6e 74 20 6d 61 6c 6c 6f 63 57 atic int mallocW
1c60: 69 74 68 41 6c 61 72 6d 28 69 6e 74 20 6e 2c 20 ithAlarm(int n,
1c70: 76 6f 69 64 20 2a 2a 70 70 29 7b 0a 20 20 69 6e void **pp){. in
1c80: 74 20 6e 46 75 6c 6c 3b 0a 20 20 76 6f 69 64 20 t nFull;. void
1c90: 2a 70 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 *p;. assert( sq
1ca0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
1cb0: 28 6d 65 6d 30 2e 6d 75 74 65 78 29 20 29 3b 0a (mem0.mutex) );.
1cc0: 20 20 6e 46 75 6c 6c 20 3d 20 73 71 6c 69 74 65 nFull = sqlite
1cd0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 3GlobalConfig.m.
1ce0: 78 52 6f 75 6e 64 75 70 28 6e 29 3b 0a 20 20 73 xRoundup(n);. s
1cf0: 71 6c 69 74 65 33 53 74 61 74 75 73 53 65 74 28 qlite3StatusSet(
1d00: 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d 41 SQLITE_STATUS_MA
1d10: 4c 4c 4f 43 5f 53 49 5a 45 2c 20 6e 29 3b 0a 20 LLOC_SIZE, n);.
1d20: 20 69 66 28 20 6d 65 6d 30 2e 61 6c 61 72 6d 43 if( mem0.alarmC
1d30: 61 6c 6c 62 61 63 6b 21 3d 30 20 29 7b 0a 20 20 allback!=0 ){.
1d40: 20 20 69 6e 74 20 6e 55 73 65 64 20 3d 20 73 71 int nUsed = sq
1d50: 6c 69 74 65 33 53 74 61 74 75 73 56 61 6c 75 65 lite3StatusValue
1d60: 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d (SQLITE_STATUS_M
1d70: 45 4d 4f 52 59 5f 55 53 45 44 29 3b 0a 20 20 20 EMORY_USED);.
1d80: 20 69 66 28 20 6e 55 73 65 64 2b 6e 46 75 6c 6c if( nUsed+nFull
1d90: 20 3e 3d 20 6d 65 6d 30 2e 61 6c 61 72 6d 54 68 >= mem0.alarmTh
1da0: 72 65 73 68 6f 6c 64 20 29 7b 0a 20 20 20 20 20 reshold ){.
1db0: 20 6d 65 6d 30 2e 6e 65 61 72 6c 79 46 75 6c 6c mem0.nearlyFull
1dc0: 20 3d 20 31 3b 0a 20 20 20 20 20 20 73 71 6c 69 = 1;. sqli
1dd0: 74 65 33 4d 61 6c 6c 6f 63 41 6c 61 72 6d 28 6e te3MallocAlarm(n
1de0: 46 75 6c 6c 29 3b 0a 20 20 20 20 7d 65 6c 73 65 Full);. }else
1df0: 7b 0a 20 20 20 20 20 20 6d 65 6d 30 2e 6e 65 61 {. mem0.nea
1e00: 72 6c 79 46 75 6c 6c 20 3d 20 30 3b 0a 20 20 20 rlyFull = 0;.
1e10: 20 7d 0a 20 20 7d 0a 20 20 70 20 3d 20 73 71 6c }. }. p = sql
1e20: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
1e30: 2e 6d 2e 78 4d 61 6c 6c 6f 63 28 6e 46 75 6c 6c .m.xMalloc(nFull
1e40: 29 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 );.#ifdef SQLITE
1e50: 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d _ENABLE_MEMORY_M
1e60: 41 4e 41 47 45 4d 45 4e 54 0a 20 20 69 66 28 20 ANAGEMENT. if(
1e70: 70 3d 3d 30 20 26 26 20 6d 65 6d 30 2e 61 6c 61 p==0 && mem0.ala
1e80: 72 6d 43 61 6c 6c 62 61 63 6b 20 29 7b 0a 20 20 rmCallback ){.
1e90: 20 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 41 sqlite3MallocA
1ea0: 6c 61 72 6d 28 6e 46 75 6c 6c 29 3b 0a 20 20 20 larm(nFull);.
1eb0: 20 70 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 p = sqlite3Glob
1ec0: 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78 4d 61 6c 6c alConfig.m.xMall
1ed0: 6f 63 28 6e 46 75 6c 6c 29 3b 0a 20 20 7d 0a 23 oc(nFull);. }.#
1ee0: 65 6e 64 69 66 0a 20 20 69 66 28 20 70 20 29 7b endif. if( p ){
1ef0: 0a 20 20 20 20 6e 46 75 6c 6c 20 3d 20 73 71 6c . nFull = sql
1f00: 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 ite3MallocSize(p
1f10: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 53 74 );. sqlite3St
1f20: 61 74 75 73 41 64 64 28 53 51 4c 49 54 45 5f 53 atusAdd(SQLITE_S
1f30: 54 41 54 55 53 5f 4d 45 4d 4f 52 59 5f 55 53 45 TATUS_MEMORY_USE
1f40: 44 2c 20 6e 46 75 6c 6c 29 3b 0a 20 20 20 20 73 D, nFull);. s
1f50: 71 6c 69 74 65 33 53 74 61 74 75 73 41 64 64 28 qlite3StatusAdd(
1f60: 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d 41 SQLITE_STATUS_MA
1f70: 4c 4c 4f 43 5f 43 4f 55 4e 54 2c 20 31 29 3b 0a LLOC_COUNT, 1);.
1f80: 20 20 7d 0a 20 20 2a 70 70 20 3d 20 70 3b 0a 20 }. *pp = p;.
1f90: 20 72 65 74 75 72 6e 20 6e 46 75 6c 6c 3b 0a 7d return nFull;.}
1fa0: 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 ../*.** Allocate
1fb0: 20 6d 65 6d 6f 72 79 2e 20 20 54 68 69 73 20 72 memory. This r
1fc0: 6f 75 74 69 6e 65 20 69 73 20 6c 69 6b 65 20 73 outine is like s
1fd0: 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 29 20 qlite3_malloc()
1fe0: 65 78 63 65 70 74 20 74 68 61 74 20 69 74 0a 2a except that it.*
1ff0: 2a 20 61 73 73 75 6d 65 73 20 74 68 65 20 6d 65 * assumes the me
2000: 6d 6f 72 79 20 73 75 62 73 79 73 74 65 6d 20 68 mory subsystem h
2010: 61 73 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 as already been
2020: 69 6e 69 74 69 61 6c 69 7a 65 64 2e 0a 2a 2f 0a initialized..*/.
2030: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 4d 61 6c void *sqlite3Mal
2040: 6c 6f 63 28 69 6e 74 20 6e 29 7b 0a 20 20 76 6f loc(int n){. vo
2050: 69 64 20 2a 70 3b 0a 20 20 69 66 28 20 6e 3c 3d id *p;. if( n<=
2060: 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0
2070: 2f 2a 20 49 4d 50 3a 20 52 2d 36 35 33 31 32 2d /* IMP: R-65312-
2080: 30 34 39 31 37 20 2a 2f 20 0a 20 20 20 7c 7c 20 04917 */ . ||
2090: 6e 3e 3d 30 78 37 66 66 66 66 66 30 30 0a 20 20 n>=0x7fffff00.
20a0: 29 7b 0a 20 20 20 20 2f 2a 20 41 20 6d 65 6d 6f ){. /* A memo
20b0: 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 6f 66 ry allocation of
20c0: 20 61 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 a number of byt
20d0: 65 73 20 77 68 69 63 68 20 69 73 20 6e 65 61 72 es which is near
20e0: 20 74 68 65 20 6d 61 78 69 6d 75 6d 0a 20 20 20 the maximum.
20f0: 20 2a 2a 20 73 69 67 6e 65 64 20 69 6e 74 65 67 ** signed integ
2100: 65 72 20 76 61 6c 75 65 20 6d 69 67 68 74 20 63 er value might c
2110: 61 75 73 65 20 61 6e 20 69 6e 74 65 67 65 72 20 ause an integer
2120: 6f 76 65 72 66 6c 6f 77 20 69 6e 73 69 64 65 20 overflow inside
2130: 6f 66 20 74 68 65 0a 20 20 20 20 2a 2a 20 78 4d of the. ** xM
2140: 61 6c 6c 6f 63 28 29 2e 20 20 48 65 6e 63 65 20 alloc(). Hence
2150: 77 65 20 6c 69 6d 69 74 20 74 68 65 20 6d 61 78 we limit the max
2160: 69 6d 75 6d 20 73 69 7a 65 20 74 6f 20 30 78 37 imum size to 0x7
2170: 66 66 66 66 66 30 30 2c 20 67 69 76 69 6e 67 0a fffff00, giving.
2180: 20 20 20 20 2a 2a 20 32 35 35 20 62 79 74 65 73 ** 255 bytes
2190: 20 6f 66 20 6f 76 65 72 68 65 61 64 2e 20 20 53 of overhead. S
21a0: 51 4c 69 74 65 20 69 74 73 65 6c 66 20 77 69 6c QLite itself wil
21b0: 6c 20 6e 65 76 65 72 20 75 73 65 20 61 6e 79 74 l never use anyt
21c0: 68 69 6e 67 20 6e 65 61 72 0a 20 20 20 20 2a 2a hing near. **
21d0: 20 74 68 69 73 20 61 6d 6f 75 6e 74 2e 20 20 54 this amount. T
21e0: 68 65 20 6f 6e 6c 79 20 77 61 79 20 74 6f 20 72 he only way to r
21f0: 65 61 63 68 20 74 68 65 20 6c 69 6d 69 74 20 69 each the limit i
2200: 73 20 77 69 74 68 20 73 71 6c 69 74 65 33 5f 6d s with sqlite3_m
2210: 61 6c 6c 6f 63 28 29 20 2a 2f 0a 20 20 20 20 70 alloc() */. p
2220: 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 20 69 66 = 0;. }else if
2230: 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 ( sqlite3GlobalC
2240: 6f 6e 66 69 67 2e 62 4d 65 6d 73 74 61 74 20 29 onfig.bMemstat )
2250: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 {. sqlite3_mu
2260: 74 65 78 5f 65 6e 74 65 72 28 6d 65 6d 30 2e 6d tex_enter(mem0.m
2270: 75 74 65 78 29 3b 0a 20 20 20 20 6d 61 6c 6c 6f utex);. mallo
2280: 63 57 69 74 68 41 6c 61 72 6d 28 6e 2c 20 26 70 cWithAlarm(n, &p
2290: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d );. sqlite3_m
22a0: 75 74 65 78 5f 6c 65 61 76 65 28 6d 65 6d 30 2e utex_leave(mem0.
22b0: 6d 75 74 65 78 29 3b 0a 20 20 7d 65 6c 73 65 7b mutex);. }else{
22c0: 0a 20 20 20 20 70 20 3d 20 73 71 6c 69 74 65 33 . p = sqlite3
22d0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78 GlobalConfig.m.x
22e0: 4d 61 6c 6c 6f 63 28 6e 29 3b 0a 20 20 7d 0a 20 Malloc(n);. }.
22f0: 20 61 73 73 65 72 74 28 20 45 49 47 48 54 5f 42 assert( EIGHT_B
2300: 59 54 45 5f 41 4c 49 47 4e 4d 45 4e 54 28 70 29 YTE_ALIGNMENT(p)
2310: 20 29 3b 20 20 2f 2a 20 49 4d 50 3a 20 52 2d 30 ); /* IMP: R-0
2320: 34 36 37 35 2d 34 34 38 35 30 20 2a 2f 0a 20 20 4675-44850 */.
2330: 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 2f 2a 0a return p;.}../*.
2340: 2a 2a 20 54 68 69 73 20 76 65 72 73 69 6f 6e 20 ** This version
2350: 6f 66 20 74 68 65 20 6d 65 6d 6f 72 79 20 61 6c of the memory al
2360: 6c 6f 63 61 74 69 6f 6e 20 69 73 20 66 6f 72 20 location is for
2370: 75 73 65 20 62 79 20 74 68 65 20 61 70 70 6c 69 use by the appli
2380: 63 61 74 69 6f 6e 2e 0a 2a 2a 20 46 69 72 73 74 cation..** First
2390: 20 6d 61 6b 65 20 73 75 72 65 20 74 68 65 20 6d make sure the m
23a0: 65 6d 6f 72 79 20 73 75 62 73 79 73 74 65 6d 20 emory subsystem
23b0: 69 73 20 69 6e 69 74 69 61 6c 69 7a 65 64 2c 20 is initialized,
23c0: 74 68 65 6e 20 64 6f 20 74 68 65 0a 2a 2a 20 61 then do the.** a
23d0: 6c 6c 6f 63 61 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f llocation..*/.vo
23e0: 69 64 20 2a 73 71 6c 69 74 65 33 5f 6d 61 6c 6c id *sqlite3_mall
23f0: 6f 63 28 69 6e 74 20 6e 29 7b 0a 23 69 66 6e 64 oc(int n){.#ifnd
2400: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 ef SQLITE_OMIT_A
2410: 55 54 4f 49 4e 49 54 0a 20 20 69 66 28 20 73 71 UTOINIT. if( sq
2420: 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 lite3_initialize
2430: 28 29 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 23 () ) return 0;.#
2440: 65 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20 73 endif. return s
2450: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 6e 29 3b qlite3Malloc(n);
2460: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 74 .}../*.** Each t
2470: 68 72 65 61 64 20 6d 61 79 20 6f 6e 6c 79 20 68 hread may only h
2480: 61 76 65 20 61 20 73 69 6e 67 6c 65 20 6f 75 74 ave a single out
2490: 73 74 61 6e 64 69 6e 67 20 61 6c 6c 6f 63 61 74 standing allocat
24a0: 69 6f 6e 20 66 72 6f 6d 0a 2a 2a 20 78 53 63 72 ion from.** xScr
24b0: 61 74 63 68 4d 61 6c 6c 6f 63 28 29 2e 20 20 57 atchMalloc(). W
24c0: 65 20 76 65 72 69 66 79 20 74 68 69 73 20 63 6f e verify this co
24d0: 6e 73 74 72 61 69 6e 74 20 69 6e 20 74 68 65 20 nstraint in the
24e0: 73 69 6e 67 6c 65 2d 74 68 72 65 61 64 65 64 0a single-threaded.
24f0: 2a 2a 20 63 61 73 65 20 62 79 20 73 65 74 74 69 ** case by setti
2500: 6e 67 20 73 63 72 61 74 63 68 41 6c 6c 6f 63 4f ng scratchAllocO
2510: 75 74 20 74 6f 20 31 20 77 68 65 6e 20 61 6e 20 ut to 1 when an
2520: 61 6c 6c 6f 63 61 74 69 6f 6e 0a 2a 2a 20 69 73 allocation.** is
2530: 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 63 6c 65 outstanding cle
2540: 61 72 69 6e 67 20 69 74 20 77 68 65 6e 20 74 68 aring it when th
2550: 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69 73 20 e allocation is
2560: 66 72 65 65 64 2e 0a 2a 2f 0a 23 69 66 20 53 51 freed..*/.#if SQ
2570: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d LITE_THREADSAFE=
2580: 3d 30 20 26 26 20 21 64 65 66 69 6e 65 64 28 4e =0 && !defined(N
2590: 44 45 42 55 47 29 0a 73 74 61 74 69 63 20 69 6e DEBUG).static in
25a0: 74 20 73 63 72 61 74 63 68 41 6c 6c 6f 63 4f 75 t scratchAllocOu
25b0: 74 20 3d 20 30 3b 0a 23 65 6e 64 69 66 0a 0a 0a t = 0;.#endif...
25c0: 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 6d /*.** Allocate m
25d0: 65 6d 6f 72 79 20 74 68 61 74 20 69 73 20 74 6f emory that is to
25e0: 20 62 65 20 75 73 65 64 20 61 6e 64 20 72 65 6c be used and rel
25f0: 65 61 73 65 64 20 72 69 67 68 74 20 61 77 61 79 eased right away
2600: 2e 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e ..** This routin
2610: 65 20 69 73 20 73 69 6d 69 6c 61 72 20 74 6f 20 e is similar to
2620: 61 6c 6c 6f 63 61 28 29 20 69 6e 20 74 68 61 74 alloca() in that
2630: 20 69 74 20 69 73 20 6e 6f 74 20 69 6e 74 65 6e it is not inten
2640: 64 65 64 0a 2a 2a 20 66 6f 72 20 73 69 74 75 61 ded.** for situa
2650: 74 69 6f 6e 73 20 77 68 65 72 65 20 74 68 65 20 tions where the
2660: 6d 65 6d 6f 72 79 20 6d 69 67 68 74 20 62 65 20 memory might be
2670: 68 65 6c 64 20 6c 6f 6e 67 2d 74 65 72 6d 2e 20 held long-term.
2680: 20 54 68 69 73 0a 2a 2a 20 72 6f 75 74 69 6e 65 This.** routine
2690: 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 is intended to
26a0: 67 65 74 20 6d 65 6d 6f 72 79 20 74 6f 20 6f 6c get memory to ol
26b0: 64 20 6c 61 72 67 65 20 74 72 61 6e 73 69 65 6e d large transien
26c0: 74 20 64 61 74 61 0a 2a 2a 20 73 74 72 75 63 74 t data.** struct
26d0: 75 72 65 73 20 74 68 61 74 20 77 6f 75 6c 64 20 ures that would
26e0: 6e 6f 74 20 6e 6f 72 6d 61 6c 6c 79 20 66 69 74 not normally fit
26f0: 20 6f 6e 20 74 68 65 20 73 74 61 63 6b 20 6f 66 on the stack of
2700: 20 61 6e 0a 2a 2a 20 65 6d 62 65 64 64 65 64 20 an.** embedded
2710: 70 72 6f 63 65 73 73 6f 72 2e 0a 2a 2f 0a 76 6f processor..*/.vo
2720: 69 64 20 2a 73 71 6c 69 74 65 33 53 63 72 61 74 id *sqlite3Scrat
2730: 63 68 4d 61 6c 6c 6f 63 28 69 6e 74 20 6e 29 7b chMalloc(int n){
2740: 0a 20 20 76 6f 69 64 20 2a 70 3b 0a 20 20 61 73 . void *p;. as
2750: 73 65 72 74 28 20 6e 3e 30 20 29 3b 0a 0a 20 20 sert( n>0 );..
2760: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e sqlite3_mutex_en
2770: 74 65 72 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b ter(mem0.mutex);
2780: 0a 20 20 69 66 28 20 6d 65 6d 30 2e 6e 53 63 72 . if( mem0.nScr
2790: 61 74 63 68 46 72 65 65 20 26 26 20 73 71 6c 69 atchFree && sqli
27a0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
27b0: 73 7a 53 63 72 61 74 63 68 3e 3d 6e 20 29 7b 0a szScratch>=n ){.
27c0: 20 20 20 20 70 20 3d 20 6d 65 6d 30 2e 70 53 63 p = mem0.pSc
27d0: 72 61 74 63 68 46 72 65 65 3b 0a 20 20 20 20 6d ratchFree;. m
27e0: 65 6d 30 2e 70 53 63 72 61 74 63 68 46 72 65 65 em0.pScratchFree
27f0: 20 3d 20 6d 65 6d 30 2e 70 53 63 72 61 74 63 68 = mem0.pScratch
2800: 46 72 65 65 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 Free->pNext;.
2810: 20 6d 65 6d 30 2e 6e 53 63 72 61 74 63 68 46 72 mem0.nScratchFr
2820: 65 65 2d 2d 3b 0a 20 20 20 20 73 71 6c 69 74 65 ee--;. sqlite
2830: 33 53 74 61 74 75 73 41 64 64 28 53 51 4c 49 54 3StatusAdd(SQLIT
2840: 45 5f 53 54 41 54 55 53 5f 53 43 52 41 54 43 48 E_STATUS_SCRATCH
2850: 5f 55 53 45 44 2c 20 31 29 3b 0a 20 20 20 20 73 _USED, 1);. s
2860: 71 6c 69 74 65 33 53 74 61 74 75 73 53 65 74 28 qlite3StatusSet(
2870: 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 53 43 SQLITE_STATUS_SC
2880: 52 41 54 43 48 5f 53 49 5a 45 2c 20 6e 29 3b 0a RATCH_SIZE, n);.
2890: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 sqlite3_mute
28a0: 78 5f 6c 65 61 76 65 28 6d 65 6d 30 2e 6d 75 74 x_leave(mem0.mut
28b0: 65 78 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 ex);. }else{.
28c0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f if( sqlite3Glo
28d0: 62 61 6c 43 6f 6e 66 69 67 2e 62 4d 65 6d 73 74 balConfig.bMemst
28e0: 61 74 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 at ){. sqli
28f0: 74 65 33 53 74 61 74 75 73 53 65 74 28 53 51 4c te3StatusSet(SQL
2900: 49 54 45 5f 53 54 41 54 55 53 5f 53 43 52 41 54 ITE_STATUS_SCRAT
2910: 43 48 5f 53 49 5a 45 2c 20 6e 29 3b 0a 20 20 20 CH_SIZE, n);.
2920: 20 20 20 6e 20 3d 20 6d 61 6c 6c 6f 63 57 69 74 n = mallocWit
2930: 68 41 6c 61 72 6d 28 6e 2c 20 26 70 29 3b 0a 20 hAlarm(n, &p);.
2940: 20 20 20 20 20 69 66 28 20 70 20 29 20 73 71 6c if( p ) sql
2950: 69 74 65 33 53 74 61 74 75 73 41 64 64 28 53 51 ite3StatusAdd(SQ
2960: 4c 49 54 45 5f 53 54 41 54 55 53 5f 53 43 52 41 LITE_STATUS_SCRA
2970: 54 43 48 5f 4f 56 45 52 46 4c 4f 57 2c 20 6e 29 TCH_OVERFLOW, n)
2980: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f ;. sqlite3_
2990: 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 65 6d 30 mutex_leave(mem0
29a0: 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 7d 65 6c .mutex);. }el
29b0: 73 65 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 se{. sqlite
29c0: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 65 3_mutex_leave(me
29d0: 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 20 m0.mutex);.
29e0: 20 70 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 p = sqlite3Glob
29f0: 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78 4d 61 6c 6c alConfig.m.xMall
2a00: 6f 63 28 6e 29 3b 0a 20 20 20 20 7d 0a 20 20 20 oc(n);. }.
2a10: 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 sqlite3Memdebug
2a20: 53 65 74 54 79 70 65 28 70 2c 20 4d 45 4d 54 59 SetType(p, MEMTY
2a30: 50 45 5f 53 43 52 41 54 43 48 29 3b 0a 20 20 7d PE_SCRATCH);. }
2a40: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
2a50: 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c 64 e3_mutex_notheld
2a60: 28 6d 65 6d 30 2e 6d 75 74 65 78 29 20 29 3b 0a (mem0.mutex) );.
2a70: 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f 54 48 52 ..#if SQLITE_THR
2a80: 45 41 44 53 41 46 45 3d 3d 30 20 26 26 20 21 64 EADSAFE==0 && !d
2a90: 65 66 69 6e 65 64 28 4e 44 45 42 55 47 29 0a 20 efined(NDEBUG).
2aa0: 20 2f 2a 20 56 65 72 69 66 79 20 74 68 61 74 20 /* Verify that
2ab0: 6e 6f 20 6d 6f 72 65 20 74 68 61 6e 20 74 77 6f no more than two
2ac0: 20 73 63 72 61 74 63 68 20 61 6c 6c 6f 63 61 74 scratch allocat
2ad0: 69 6f 6e 73 20 70 65 72 20 74 68 72 65 61 64 0a ions per thread.
2ae0: 20 20 2a 2a 20 61 72 65 20 6f 75 74 73 74 61 6e ** are outstan
2af0: 64 69 6e 67 20 61 74 20 6f 6e 65 20 74 69 6d 65 ding at one time
2b00: 2e 20 20 28 54 68 69 73 20 69 73 20 6f 6e 6c 79 . (This is only
2b10: 20 63 68 65 63 6b 65 64 20 69 6e 20 74 68 65 0a checked in the.
2b20: 20 20 2a 2a 20 73 69 6e 67 6c 65 2d 74 68 72 65 ** single-thre
2b30: 61 64 65 64 20 63 61 73 65 20 73 69 6e 63 65 20 aded case since
2b40: 63 68 65 63 6b 69 6e 67 20 69 6e 20 74 68 65 20 checking in the
2b50: 6d 75 6c 74 69 2d 74 68 72 65 61 64 65 64 20 63 multi-threaded c
2b60: 61 73 65 0a 20 20 2a 2a 20 77 6f 75 6c 64 20 62 ase. ** would b
2b70: 65 20 6d 75 63 68 20 6d 6f 72 65 20 63 6f 6d 70 e much more comp
2b80: 6c 69 63 61 74 65 64 2e 29 20 2a 2f 0a 20 20 61 licated.) */. a
2b90: 73 73 65 72 74 28 20 73 63 72 61 74 63 68 41 6c ssert( scratchAl
2ba0: 6c 6f 63 4f 75 74 3c 3d 31 20 29 3b 0a 20 20 69 locOut<=1 );. i
2bb0: 66 28 20 70 20 29 20 73 63 72 61 74 63 68 41 6c f( p ) scratchAl
2bc0: 6c 6f 63 4f 75 74 2b 2b 3b 0a 23 65 6e 64 69 66 locOut++;.#endif
2bd0: 0a 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a .. return p;.}.
2be0: 76 6f 69 64 20 73 71 6c 69 74 65 33 53 63 72 61 void sqlite3Scra
2bf0: 74 63 68 46 72 65 65 28 76 6f 69 64 20 2a 70 29 tchFree(void *p)
2c00: 7b 0a 20 20 69 66 28 20 70 20 29 7b 0a 0a 23 69 {. if( p ){..#i
2c10: 66 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 f SQLITE_THREADS
2c20: 41 46 45 3d 3d 30 20 26 26 20 21 64 65 66 69 6e AFE==0 && !defin
2c30: 65 64 28 4e 44 45 42 55 47 29 0a 20 20 20 20 2f ed(NDEBUG). /
2c40: 2a 20 56 65 72 69 66 79 20 74 68 61 74 20 6e 6f * Verify that no
2c50: 20 6d 6f 72 65 20 74 68 61 6e 20 74 77 6f 20 73 more than two s
2c60: 63 72 61 74 63 68 20 61 6c 6c 6f 63 61 74 69 6f cratch allocatio
2c70: 6e 20 70 65 72 20 74 68 72 65 61 64 0a 20 20 20 n per thread.
2c80: 20 2a 2a 20 69 73 20 6f 75 74 73 74 61 6e 64 69 ** is outstandi
2c90: 6e 67 20 61 74 20 6f 6e 65 20 74 69 6d 65 2e 20 ng at one time.
2ca0: 20 28 54 68 69 73 20 69 73 20 6f 6e 6c 79 20 63 (This is only c
2cb0: 68 65 63 6b 65 64 20 69 6e 20 74 68 65 0a 20 20 hecked in the.
2cc0: 20 20 2a 2a 20 73 69 6e 67 6c 65 2d 74 68 72 65 ** single-thre
2cd0: 61 64 65 64 20 63 61 73 65 20 73 69 6e 63 65 20 aded case since
2ce0: 63 68 65 63 6b 69 6e 67 20 69 6e 20 74 68 65 20 checking in the
2cf0: 6d 75 6c 74 69 2d 74 68 72 65 61 64 65 64 20 63 multi-threaded c
2d00: 61 73 65 0a 20 20 20 20 2a 2a 20 77 6f 75 6c 64 ase. ** would
2d10: 20 62 65 20 6d 75 63 68 20 6d 6f 72 65 20 63 6f be much more co
2d20: 6d 70 6c 69 63 61 74 65 64 2e 29 20 2a 2f 0a 20 mplicated.) */.
2d30: 20 20 20 61 73 73 65 72 74 28 20 73 63 72 61 74 assert( scrat
2d40: 63 68 41 6c 6c 6f 63 4f 75 74 3e 3d 31 20 26 26 chAllocOut>=1 &&
2d50: 20 73 63 72 61 74 63 68 41 6c 6c 6f 63 4f 75 74 scratchAllocOut
2d60: 3c 3d 32 20 29 3b 0a 20 20 20 20 73 63 72 61 74 <=2 );. scrat
2d70: 63 68 41 6c 6c 6f 63 4f 75 74 2d 2d 3b 0a 23 65 chAllocOut--;.#e
2d80: 6e 64 69 66 0a 0a 20 20 20 20 69 66 28 20 70 3e ndif.. if( p>
2d90: 3d 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f =sqlite3GlobalCo
2da0: 6e 66 69 67 2e 70 53 63 72 61 74 63 68 20 26 26 nfig.pScratch &&
2db0: 20 70 3c 6d 65 6d 30 2e 70 53 63 72 61 74 63 68 p<mem0.pScratch
2dc0: 45 6e 64 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 End ){. /*
2dd0: 52 65 6c 65 61 73 65 20 6d 65 6d 6f 72 79 20 66 Release memory f
2de0: 72 6f 6d 20 74 68 65 20 53 51 4c 49 54 45 5f 43 rom the SQLITE_C
2df0: 4f 4e 46 49 47 5f 53 43 52 41 54 43 48 20 61 6c ONFIG_SCRATCH al
2e00: 6c 6f 63 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 location */.
2e10: 20 20 53 63 72 61 74 63 68 46 72 65 65 73 6c 6f ScratchFreeslo
2e20: 74 20 2a 70 53 6c 6f 74 3b 0a 20 20 20 20 20 20 t *pSlot;.
2e30: 70 53 6c 6f 74 20 3d 20 28 53 63 72 61 74 63 68 pSlot = (Scratch
2e40: 46 72 65 65 73 6c 6f 74 2a 29 70 3b 0a 20 20 20 Freeslot*)p;.
2e50: 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 sqlite3_mutex
2e60: 5f 65 6e 74 65 72 28 6d 65 6d 30 2e 6d 75 74 65 _enter(mem0.mute
2e70: 78 29 3b 0a 20 20 20 20 20 20 70 53 6c 6f 74 2d x);. pSlot-
2e80: 3e 70 4e 65 78 74 20 3d 20 6d 65 6d 30 2e 70 53 >pNext = mem0.pS
2e90: 63 72 61 74 63 68 46 72 65 65 3b 0a 20 20 20 20 cratchFree;.
2ea0: 20 20 6d 65 6d 30 2e 70 53 63 72 61 74 63 68 46 mem0.pScratchF
2eb0: 72 65 65 20 3d 20 70 53 6c 6f 74 3b 0a 20 20 20 ree = pSlot;.
2ec0: 20 20 20 6d 65 6d 30 2e 6e 53 63 72 61 74 63 68 mem0.nScratch
2ed0: 46 72 65 65 2b 2b 3b 0a 20 20 20 20 20 20 61 73 Free++;. as
2ee0: 73 65 72 74 28 20 6d 65 6d 30 2e 6e 53 63 72 61 sert( mem0.nScra
2ef0: 74 63 68 46 72 65 65 3c 3d 73 71 6c 69 74 65 33 tchFree<=sqlite3
2f00: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 53 63 GlobalConfig.nSc
2f10: 72 61 74 63 68 20 29 3b 0a 20 20 20 20 20 20 73 ratch );. s
2f20: 71 6c 69 74 65 33 53 74 61 74 75 73 41 64 64 28 qlite3StatusAdd(
2f30: 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 53 43 SQLITE_STATUS_SC
2f40: 52 41 54 43 48 5f 55 53 45 44 2c 20 2d 31 29 3b RATCH_USED, -1);
2f50: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d . sqlite3_m
2f60: 75 74 65 78 5f 6c 65 61 76 65 28 6d 65 6d 30 2e utex_leave(mem0.
2f70: 6d 75 74 65 78 29 3b 0a 20 20 20 20 7d 65 6c 73 mutex);. }els
2f80: 65 7b 0a 20 20 20 20 20 20 2f 2a 20 52 65 6c 65 e{. /* Rele
2f90: 61 73 65 20 6d 65 6d 6f 72 79 20 62 61 63 6b 20 ase memory back
2fa0: 74 6f 20 74 68 65 20 68 65 61 70 20 2a 2f 0a 20 to the heap */.
2fb0: 20 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c assert( sql
2fc0: 69 74 65 33 4d 65 6d 64 65 62 75 67 48 61 73 54 ite3MemdebugHasT
2fd0: 79 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 53 ype(p, MEMTYPE_S
2fe0: 43 52 41 54 43 48 29 20 29 3b 0a 20 20 20 20 20 CRATCH) );.
2ff0: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
3000: 4d 65 6d 64 65 62 75 67 4e 6f 54 79 70 65 28 70 MemdebugNoType(p
3010: 2c 20 7e 4d 45 4d 54 59 50 45 5f 53 43 52 41 54 , ~MEMTYPE_SCRAT
3020: 43 48 29 20 29 3b 0a 20 20 20 20 20 20 73 71 6c CH) );. sql
3030: 69 74 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54 ite3MemdebugSetT
3040: 79 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 48 ype(p, MEMTYPE_H
3050: 45 41 50 29 3b 0a 20 20 20 20 20 20 69 66 28 20 EAP);. if(
3060: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
3070: 66 69 67 2e 62 4d 65 6d 73 74 61 74 20 29 7b 0a fig.bMemstat ){.
3080: 20 20 20 20 20 20 20 20 69 6e 74 20 69 53 69 7a int iSiz
3090: 65 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f e = sqlite3Mallo
30a0: 63 53 69 7a 65 28 70 29 3b 0a 20 20 20 20 20 20 cSize(p);.
30b0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
30c0: 65 6e 74 65 72 28 6d 65 6d 30 2e 6d 75 74 65 78 enter(mem0.mutex
30d0: 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 );. sqlit
30e0: 65 33 53 74 61 74 75 73 41 64 64 28 53 51 4c 49 e3StatusAdd(SQLI
30f0: 54 45 5f 53 54 41 54 55 53 5f 53 43 52 41 54 43 TE_STATUS_SCRATC
3100: 48 5f 4f 56 45 52 46 4c 4f 57 2c 20 2d 69 53 69 H_OVERFLOW, -iSi
3110: 7a 65 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c ze);. sql
3120: 69 74 65 33 53 74 61 74 75 73 41 64 64 28 53 51 ite3StatusAdd(SQ
3130: 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d 45 4d 4f LITE_STATUS_MEMO
3140: 52 59 5f 55 53 45 44 2c 20 2d 69 53 69 7a 65 29 RY_USED, -iSize)
3150: 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 ;. sqlite
3160: 33 53 74 61 74 75 73 41 64 64 28 53 51 4c 49 54 3StatusAdd(SQLIT
3170: 45 5f 53 54 41 54 55 53 5f 4d 41 4c 4c 4f 43 5f E_STATUS_MALLOC_
3180: 43 4f 55 4e 54 2c 20 2d 31 29 3b 0a 20 20 20 20 COUNT, -1);.
3190: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
31a0: 6c 43 6f 6e 66 69 67 2e 6d 2e 78 46 72 65 65 28 lConfig.m.xFree(
31b0: 70 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 p);. sqli
31c0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
31d0: 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20 mem0.mutex);.
31e0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
31f0: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 sqlite3GlobalC
3200: 6f 6e 66 69 67 2e 6d 2e 78 46 72 65 65 28 70 29 onfig.m.xFree(p)
3210: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a ;. }. }.
3220: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 52 55 }.}../*.** TRU
3230: 45 20 69 66 20 70 20 69 73 20 61 20 6c 6f 6f 6b E if p is a look
3240: 61 73 69 64 65 20 6d 65 6d 6f 72 79 20 61 6c 6c aside memory all
3250: 6f 63 61 74 69 6f 6e 20 66 72 6f 6d 20 64 62 0a ocation from db.
3260: 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 */.#ifndef SQLIT
3270: 45 5f 4f 4d 49 54 5f 4c 4f 4f 4b 41 53 49 44 45 E_OMIT_LOOKASIDE
3280: 0a 73 74 61 74 69 63 20 69 6e 74 20 69 73 4c 6f .static int isLo
3290: 6f 6b 61 73 69 64 65 28 73 71 6c 69 74 65 33 20 okaside(sqlite3
32a0: 2a 64 62 2c 20 76 6f 69 64 20 2a 70 29 7b 0a 20 *db, void *p){.
32b0: 20 72 65 74 75 72 6e 20 70 20 26 26 20 70 3e 3d return p && p>=
32c0: 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 53 db->lookaside.pS
32d0: 74 61 72 74 20 26 26 20 70 3c 64 62 2d 3e 6c 6f tart && p<db->lo
32e0: 6f 6b 61 73 69 64 65 2e 70 45 6e 64 3b 0a 7d 0a okaside.pEnd;.}.
32f0: 23 65 6c 73 65 0a 23 64 65 66 69 6e 65 20 69 73 #else.#define is
3300: 4c 6f 6f 6b 61 73 69 64 65 28 41 2c 42 29 20 30 Lookaside(A,B) 0
3310: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 .#endif../*.** R
3320: 65 74 75 72 6e 20 74 68 65 20 73 69 7a 65 20 6f eturn the size o
3330: 66 20 61 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 f a memory alloc
3340: 61 74 69 6f 6e 20 70 72 65 76 69 6f 75 73 6c 79 ation previously
3350: 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 0a 2a obtained from.*
3360: 2a 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 * sqlite3Malloc(
3370: 29 20 6f 72 20 73 71 6c 69 74 65 33 5f 6d 61 6c ) or sqlite3_mal
3380: 6c 6f 63 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 loc()..*/.int sq
3390: 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 lite3MallocSize(
33a0: 76 6f 69 64 20 2a 70 29 7b 0a 20 20 61 73 73 65 void *p){. asse
33b0: 72 74 28 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 rt( sqlite3Memde
33c0: 62 75 67 48 61 73 54 79 70 65 28 70 2c 20 4d 45 bugHasType(p, ME
33d0: 4d 54 59 50 45 5f 48 45 41 50 29 20 29 3b 0a 20 MTYPE_HEAP) );.
33e0: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
33f0: 4d 65 6d 64 65 62 75 67 4e 6f 54 79 70 65 28 70 MemdebugNoType(p
3400: 2c 20 4d 45 4d 54 59 50 45 5f 44 42 29 20 29 3b , MEMTYPE_DB) );
3410: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 . return sqlite
3420: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 3GlobalConfig.m.
3430: 78 53 69 7a 65 28 70 29 3b 0a 7d 0a 69 6e 74 20 xSize(p);.}.int
3440: 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 53 sqlite3DbMallocS
3450: 69 7a 65 28 73 71 6c 69 74 65 33 20 2a 64 62 2c ize(sqlite3 *db,
3460: 20 76 6f 69 64 20 2a 70 29 7b 0a 20 20 61 73 73 void *p){. ass
3470: 65 72 74 28 20 64 62 3d 3d 30 20 7c 7c 20 73 71 ert( db==0 || sq
3480: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
3490: 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 (db->mutex) );.
34a0: 20 69 66 28 20 64 62 20 26 26 20 69 73 4c 6f 6f if( db && isLoo
34b0: 6b 61 73 69 64 65 28 64 62 2c 20 70 29 20 29 7b kaside(db, p) ){
34c0: 0a 20 20 20 20 72 65 74 75 72 6e 20 64 62 2d 3e . return db->
34d0: 6c 6f 6f 6b 61 73 69 64 65 2e 73 7a 3b 0a 20 20 lookaside.sz;.
34e0: 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 72 }else{. asser
34f0: 74 28 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 t( sqlite3Memdeb
3500: 75 67 48 61 73 54 79 70 65 28 70 2c 20 4d 45 4d ugHasType(p, MEM
3510: 54 59 50 45 5f 44 42 29 20 29 3b 0a 20 20 20 20 TYPE_DB) );.
3520: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d assert( sqlite3M
3530: 65 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 70 emdebugHasType(p
3540: 2c 20 4d 45 4d 54 59 50 45 5f 4c 4f 4f 4b 41 53 , MEMTYPE_LOOKAS
3550: 49 44 45 7c 4d 45 4d 54 59 50 45 5f 48 45 41 50 IDE|MEMTYPE_HEAP
3560: 29 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 ) );. assert(
3570: 20 64 62 21 3d 30 20 7c 7c 20 73 71 6c 69 74 65 db!=0 || sqlite
3580: 33 4d 65 6d 64 65 62 75 67 4e 6f 54 79 70 65 28 3MemdebugNoType(
3590: 70 2c 20 4d 45 4d 54 59 50 45 5f 4c 4f 4f 4b 41 p, MEMTYPE_LOOKA
35a0: 53 49 44 45 29 20 29 3b 0a 20 20 20 20 72 65 74 SIDE) );. ret
35b0: 75 72 6e 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 urn sqlite3Globa
35c0: 6c 43 6f 6e 66 69 67 2e 6d 2e 78 53 69 7a 65 28 lConfig.m.xSize(
35d0: 70 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a p);. }.}../*.**
35e0: 20 46 72 65 65 20 6d 65 6d 6f 72 79 20 70 72 65 Free memory pre
35f0: 76 69 6f 75 73 6c 79 20 6f 62 74 61 69 6e 65 64 viously obtained
3600: 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 4d 61 6c from sqlite3Mal
3610: 6c 6f 63 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 73 loc()..*/.void s
3620: 71 6c 69 74 65 33 5f 66 72 65 65 28 76 6f 69 64 qlite3_free(void
3630: 20 2a 70 29 7b 0a 20 20 69 66 28 20 70 3d 3d 30 *p){. if( p==0
3640: 20 29 20 72 65 74 75 72 6e 3b 20 20 2f 2a 20 49 ) return; /* I
3650: 4d 50 3a 20 52 2d 34 39 30 35 33 2d 35 34 35 35 MP: R-49053-5455
3660: 34 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 73 4 */. assert( s
3670: 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 4e 6f qlite3MemdebugNo
3680: 54 79 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f Type(p, MEMTYPE_
3690: 44 42 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 DB) );. assert(
36a0: 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 sqlite3Memdebug
36b0: 48 61 73 54 79 70 65 28 70 2c 20 4d 45 4d 54 59 HasType(p, MEMTY
36c0: 50 45 5f 48 45 41 50 29 20 29 3b 0a 20 20 69 66 PE_HEAP) );. if
36d0: 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 ( sqlite3GlobalC
36e0: 6f 6e 66 69 67 2e 62 4d 65 6d 73 74 61 74 20 29 onfig.bMemstat )
36f0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 {. sqlite3_mu
3700: 74 65 78 5f 65 6e 74 65 72 28 6d 65 6d 30 2e 6d tex_enter(mem0.m
3710: 75 74 65 78 29 3b 0a 20 20 20 20 73 71 6c 69 74 utex);. sqlit
3720: 65 33 53 74 61 74 75 73 41 64 64 28 53 51 4c 49 e3StatusAdd(SQLI
3730: 54 45 5f 53 54 41 54 55 53 5f 4d 45 4d 4f 52 59 TE_STATUS_MEMORY
3740: 5f 55 53 45 44 2c 20 2d 73 71 6c 69 74 65 33 4d _USED, -sqlite3M
3750: 61 6c 6c 6f 63 53 69 7a 65 28 70 29 29 3b 0a 20 allocSize(p));.
3760: 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 sqlite3Status
3770: 41 64 64 28 53 51 4c 49 54 45 5f 53 54 41 54 55 Add(SQLITE_STATU
3780: 53 5f 4d 41 4c 4c 4f 43 5f 43 4f 55 4e 54 2c 20 S_MALLOC_COUNT,
3790: 2d 31 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 -1);. sqlite3
37a0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78 GlobalConfig.m.x
37b0: 46 72 65 65 28 70 29 3b 0a 20 20 20 20 73 71 6c Free(p);. sql
37c0: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
37d0: 28 6d 65 6d 30 2e 6d 75 74 65 78 29 3b 0a 20 20 (mem0.mutex);.
37e0: 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 }else{. sqlit
37f0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d e3GlobalConfig.m
3800: 2e 78 46 72 65 65 28 70 29 3b 0a 20 20 7d 0a 7d .xFree(p);. }.}
3810: 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 6d 65 6d ../*.** Free mem
3820: 6f 72 79 20 74 68 61 74 20 6d 69 67 68 74 20 62 ory that might b
3830: 65 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 e associated wit
3840: 68 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 64 h a particular d
3850: 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f 6e 6e 65 atabase.** conne
3860: 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 ction..*/.void s
3870: 71 6c 69 74 65 33 44 62 46 72 65 65 28 73 71 6c qlite3DbFree(sql
3880: 69 74 65 33 20 2a 64 62 2c 20 76 6f 69 64 20 2a ite3 *db, void *
3890: 70 29 7b 0a 20 20 61 73 73 65 72 74 28 20 64 62 p){. assert( db
38a0: 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65 33 5f 6d ==0 || sqlite3_m
38b0: 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 utex_held(db->mu
38c0: 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 64 62 tex) );. if( db
38d0: 20 29 7b 0a 20 20 20 20 69 66 28 20 64 62 2d 3e ){. if( db->
38e0: 70 6e 42 79 74 65 73 46 72 65 65 64 20 29 7b 0a pnBytesFreed ){.
38f0: 20 20 20 20 20 20 2a 64 62 2d 3e 70 6e 42 79 74 *db->pnByt
3900: 65 73 46 72 65 65 64 20 2b 3d 20 73 71 6c 69 74 esFreed += sqlit
3910: 65 33 44 62 4d 61 6c 6c 6f 63 53 69 7a 65 28 64 e3DbMallocSize(d
3920: 62 2c 20 70 29 3b 0a 20 20 20 20 20 20 72 65 74 b, p);. ret
3930: 75 72 6e 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 urn;. }. i
3940: 66 28 20 69 73 4c 6f 6f 6b 61 73 69 64 65 28 64 f( isLookaside(d
3950: 62 2c 20 70 29 20 29 7b 0a 20 20 20 20 20 20 4c b, p) ){. L
3960: 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 20 2a 70 42 ookasideSlot *pB
3970: 75 66 20 3d 20 28 4c 6f 6f 6b 61 73 69 64 65 53 uf = (LookasideS
3980: 6c 6f 74 2a 29 70 3b 0a 20 20 20 20 20 20 70 42 lot*)p;. pB
3990: 75 66 2d 3e 70 4e 65 78 74 20 3d 20 64 62 2d 3e uf->pNext = db->
39a0: 6c 6f 6f 6b 61 73 69 64 65 2e 70 46 72 65 65 3b lookaside.pFree;
39b0: 0a 20 20 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 . db->looka
39c0: 73 69 64 65 2e 70 46 72 65 65 20 3d 20 70 42 75 side.pFree = pBu
39d0: 66 3b 0a 20 20 20 20 20 20 64 62 2d 3e 6c 6f 6f f;. db->loo
39e0: 6b 61 73 69 64 65 2e 6e 4f 75 74 2d 2d 3b 0a 20 kaside.nOut--;.
39f0: 20 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 20 return;.
3a00: 20 7d 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 }. }. assert(
3a10: 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 sqlite3Memdebug
3a20: 48 61 73 54 79 70 65 28 70 2c 20 4d 45 4d 54 59 HasType(p, MEMTY
3a30: 50 45 5f 44 42 29 20 29 3b 0a 20 20 61 73 73 65 PE_DB) );. asse
3a40: 72 74 28 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 rt( sqlite3Memde
3a50: 62 75 67 48 61 73 54 79 70 65 28 70 2c 20 4d 45 bugHasType(p, ME
3a60: 4d 54 59 50 45 5f 4c 4f 4f 4b 41 53 49 44 45 7c MTYPE_LOOKASIDE|
3a70: 4d 45 4d 54 59 50 45 5f 48 45 41 50 29 20 29 3b MEMTYPE_HEAP) );
3a80: 0a 20 20 61 73 73 65 72 74 28 20 64 62 21 3d 30 . assert( db!=0
3a90: 20 7c 7c 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 || sqlite3Memde
3aa0: 62 75 67 4e 6f 54 79 70 65 28 70 2c 20 4d 45 4d bugNoType(p, MEM
3ab0: 54 59 50 45 5f 4c 4f 4f 4b 41 53 49 44 45 29 20 TYPE_LOOKASIDE)
3ac0: 29 3b 0a 20 20 73 71 6c 69 74 65 33 4d 65 6d 64 );. sqlite3Memd
3ad0: 65 62 75 67 53 65 74 54 79 70 65 28 70 2c 20 4d ebugSetType(p, M
3ae0: 45 4d 54 59 50 45 5f 48 45 41 50 29 3b 0a 20 20 EMTYPE_HEAP);.
3af0: 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b sqlite3_free(p);
3b00: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 .}../*.** Change
3b10: 20 74 68 65 20 73 69 7a 65 20 6f 66 20 61 6e 20 the size of an
3b20: 65 78 69 73 74 69 6e 67 20 6d 65 6d 6f 72 79 20 existing memory
3b30: 61 6c 6c 6f 63 61 74 69 6f 6e 0a 2a 2f 0a 76 6f allocation.*/.vo
3b40: 69 64 20 2a 73 71 6c 69 74 65 33 52 65 61 6c 6c id *sqlite3Reall
3b50: 6f 63 28 76 6f 69 64 20 2a 70 4f 6c 64 2c 20 69 oc(void *pOld, i
3b60: 6e 74 20 6e 42 79 74 65 73 29 7b 0a 20 20 69 6e nt nBytes){. in
3b70: 74 20 6e 4f 6c 64 2c 20 6e 4e 65 77 3b 0a 20 20 t nOld, nNew;.
3b80: 76 6f 69 64 20 2a 70 4e 65 77 3b 0a 20 20 69 66 void *pNew;. if
3b90: 28 20 70 4f 6c 64 3d 3d 30 20 29 7b 0a 20 20 20 ( pOld==0 ){.
3ba0: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 4d return sqlite3M
3bb0: 61 6c 6c 6f 63 28 6e 42 79 74 65 73 29 3b 20 2f alloc(nBytes); /
3bc0: 2a 20 49 4d 50 3a 20 52 2d 32 38 33 35 34 2d 32 * IMP: R-28354-2
3bd0: 35 37 36 39 20 2a 2f 0a 20 20 7d 0a 20 20 69 66 5769 */. }. if
3be0: 28 20 6e 42 79 74 65 73 3c 3d 30 20 29 7b 0a 20 ( nBytes<=0 ){.
3bf0: 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 sqlite3_free(
3c00: 70 4f 6c 64 29 3b 20 2f 2a 20 49 4d 50 3a 20 52 pOld); /* IMP: R
3c10: 2d 33 31 35 39 33 2d 31 30 35 37 34 20 2a 2f 0a -31593-10574 */.
3c20: 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 return 0;.
3c30: 7d 0a 20 20 69 66 28 20 6e 42 79 74 65 73 3e 3d }. if( nBytes>=
3c40: 30 78 37 66 66 66 66 66 30 30 20 29 7b 0a 20 20 0x7fffff00 ){.
3c50: 20 20 2f 2a 20 54 68 65 20 30 78 37 66 66 66 66 /* The 0x7ffff
3c60: 30 30 20 6c 69 6d 69 74 20 74 65 72 6d 20 69 73 00 limit term is
3c70: 20 65 78 70 6c 61 69 6e 65 64 20 69 6e 20 63 6f explained in co
3c80: 6d 6d 65 6e 74 73 20 6f 6e 20 73 71 6c 69 74 65 mments on sqlite
3c90: 33 4d 61 6c 6c 6f 63 28 29 20 2a 2f 0a 20 20 20 3Malloc() */.
3ca0: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 return 0;. }.
3cb0: 20 6e 4f 6c 64 20 3d 20 73 71 6c 69 74 65 33 4d nOld = sqlite3M
3cc0: 61 6c 6c 6f 63 53 69 7a 65 28 70 4f 6c 64 29 3b allocSize(pOld);
3cd0: 0a 20 20 2f 2a 20 49 4d 50 4c 45 4d 45 4e 54 41 . /* IMPLEMENTA
3ce0: 54 49 4f 4e 2d 4f 46 3a 20 52 2d 34 36 31 39 39 TION-OF: R-46199
3cf0: 2d 33 30 32 34 39 20 53 51 4c 69 74 65 20 67 75 -30249 SQLite gu
3d00: 61 72 61 6e 74 65 65 73 20 74 68 61 74 20 74 68 arantees that th
3d10: 65 20 73 65 63 6f 6e 64 0a 20 20 2a 2a 20 61 72 e second. ** ar
3d20: 67 75 6d 65 6e 74 20 74 6f 20 78 52 65 61 6c 6c gument to xReall
3d30: 6f 63 20 69 73 20 61 6c 77 61 79 73 20 61 20 76 oc is always a v
3d40: 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 62 79 alue returned by
3d50: 20 61 20 70 72 69 6f 72 20 63 61 6c 6c 20 74 6f a prior call to
3d60: 0a 20 20 2a 2a 20 78 52 6f 75 6e 64 75 70 2e 20 . ** xRoundup.
3d70: 2a 2f 0a 20 20 6e 4e 65 77 20 3d 20 73 71 6c 69 */. nNew = sqli
3d80: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
3d90: 6d 2e 78 52 6f 75 6e 64 75 70 28 6e 42 79 74 65 m.xRoundup(nByte
3da0: 73 29 3b 0a 20 20 69 66 28 20 6e 4f 6c 64 3d 3d s);. if( nOld==
3db0: 6e 4e 65 77 20 29 7b 0a 20 20 20 20 70 4e 65 77 nNew ){. pNew
3dc0: 20 3d 20 70 4f 6c 64 3b 0a 20 20 7d 65 6c 73 65 = pOld;. }else
3dd0: 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 if( sqlite3Glob
3de0: 61 6c 43 6f 6e 66 69 67 2e 62 4d 65 6d 73 74 61 alConfig.bMemsta
3df0: 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 t ){. sqlite3
3e00: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d 65 6d _mutex_enter(mem
3e10: 30 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 73 71 0.mutex);. sq
3e20: 6c 69 74 65 33 53 74 61 74 75 73 53 65 74 28 53 lite3StatusSet(S
3e30: 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d 41 4c QLITE_STATUS_MAL
3e40: 4c 4f 43 5f 53 49 5a 45 2c 20 6e 42 79 74 65 73 LOC_SIZE, nBytes
3e50: 29 3b 0a 20 20 20 20 69 66 28 20 73 71 6c 69 74 );. if( sqlit
3e60: 65 33 53 74 61 74 75 73 56 61 6c 75 65 28 53 51 e3StatusValue(SQ
3e70: 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d 45 4d 4f LITE_STATUS_MEMO
3e80: 52 59 5f 55 53 45 44 29 2b 6e 4e 65 77 2d 6e 4f RY_USED)+nNew-nO
3e90: 6c 64 20 3e 3d 20 0a 20 20 20 20 20 20 20 20 20 ld >= .
3ea0: 20 6d 65 6d 30 2e 61 6c 61 72 6d 54 68 72 65 73 mem0.alarmThres
3eb0: 68 6f 6c 64 20 29 7b 0a 20 20 20 20 20 20 73 71 hold ){. sq
3ec0: 6c 69 74 65 33 4d 61 6c 6c 6f 63 41 6c 61 72 6d lite3MallocAlarm
3ed0: 28 6e 4e 65 77 2d 6e 4f 6c 64 29 3b 0a 20 20 20 (nNew-nOld);.
3ee0: 20 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 }. assert( s
3ef0: 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 48 61 qlite3MemdebugHa
3f00: 73 54 79 70 65 28 70 4f 6c 64 2c 20 4d 45 4d 54 sType(pOld, MEMT
3f10: 59 50 45 5f 48 45 41 50 29 20 29 3b 0a 20 20 20 YPE_HEAP) );.
3f20: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
3f30: 4d 65 6d 64 65 62 75 67 4e 6f 54 79 70 65 28 70 MemdebugNoType(p
3f40: 4f 6c 64 2c 20 7e 4d 45 4d 54 59 50 45 5f 48 45 Old, ~MEMTYPE_HE
3f50: 41 50 29 20 29 3b 0a 20 20 20 20 70 4e 65 77 20 AP) );. pNew
3f60: 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 = sqlite3GlobalC
3f70: 6f 6e 66 69 67 2e 6d 2e 78 52 65 61 6c 6c 6f 63 onfig.m.xRealloc
3f80: 28 70 4f 6c 64 2c 20 6e 4e 65 77 29 3b 0a 20 20 (pOld, nNew);.
3f90: 20 20 69 66 28 20 70 4e 65 77 3d 3d 30 20 26 26 if( pNew==0 &&
3fa0: 20 6d 65 6d 30 2e 61 6c 61 72 6d 43 61 6c 6c 62 mem0.alarmCallb
3fb0: 61 63 6b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c ack ){. sql
3fc0: 69 74 65 33 4d 61 6c 6c 6f 63 41 6c 61 72 6d 28 ite3MallocAlarm(
3fd0: 6e 42 79 74 65 73 29 3b 0a 20 20 20 20 20 20 70 nBytes);. p
3fe0: 4e 65 77 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f New = sqlite3Glo
3ff0: 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78 52 65 61 balConfig.m.xRea
4000: 6c 6c 6f 63 28 70 4f 6c 64 2c 20 6e 4e 65 77 29 lloc(pOld, nNew)
4010: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
4020: 70 4e 65 77 20 29 7b 0a 20 20 20 20 20 20 6e 4e pNew ){. nN
4030: 65 77 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c ew = sqlite3Mall
4040: 6f 63 53 69 7a 65 28 70 4e 65 77 29 3b 0a 20 20 ocSize(pNew);.
4050: 20 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 sqlite3Statu
4060: 73 41 64 64 28 53 51 4c 49 54 45 5f 53 54 41 54 sAdd(SQLITE_STAT
4070: 55 53 5f 4d 45 4d 4f 52 59 5f 55 53 45 44 2c 20 US_MEMORY_USED,
4080: 6e 4e 65 77 2d 6e 4f 6c 64 29 3b 0a 20 20 20 20 nNew-nOld);.
4090: 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 }. sqlite3_mu
40a0: 74 65 78 5f 6c 65 61 76 65 28 6d 65 6d 30 2e 6d tex_leave(mem0.m
40b0: 75 74 65 78 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a utex);. }else{.
40c0: 20 20 20 20 70 4e 65 77 20 3d 20 73 71 6c 69 74 pNew = sqlit
40d0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d e3GlobalConfig.m
40e0: 2e 78 52 65 61 6c 6c 6f 63 28 70 4f 6c 64 2c 20 .xRealloc(pOld,
40f0: 6e 4e 65 77 29 3b 0a 20 20 7d 0a 20 20 61 73 73 nNew);. }. ass
4100: 65 72 74 28 20 45 49 47 48 54 5f 42 59 54 45 5f ert( EIGHT_BYTE_
4110: 41 4c 49 47 4e 4d 45 4e 54 28 70 4e 65 77 29 20 ALIGNMENT(pNew)
4120: 29 3b 20 2f 2a 20 49 4d 50 3a 20 52 2d 30 34 36 ); /* IMP: R-046
4130: 37 35 2d 34 34 38 35 30 20 2a 2f 0a 20 20 72 65 75-44850 */. re
4140: 74 75 72 6e 20 70 4e 65 77 3b 0a 7d 0a 0a 2f 2a turn pNew;.}../*
4150: 0a 2a 2a 20 54 68 65 20 70 75 62 6c 69 63 20 69 .** The public i
4160: 6e 74 65 72 66 61 63 65 20 74 6f 20 73 71 6c 69 nterface to sqli
4170: 74 65 33 52 65 61 6c 6c 6f 63 2e 20 20 4d 61 6b te3Realloc. Mak
4180: 65 20 73 75 72 65 20 74 68 61 74 20 74 68 65 20 e sure that the
4190: 6d 65 6d 6f 72 79 0a 2a 2a 20 73 75 62 73 79 73 memory.** subsys
41a0: 74 65 6d 20 69 73 20 69 6e 69 74 69 61 6c 69 7a tem is initializ
41b0: 65 64 20 70 72 69 6f 72 20 74 6f 20 69 6e 76 6f ed prior to invo
41c0: 6b 69 6e 67 20 73 71 6c 69 74 65 52 65 61 6c 6c king sqliteReall
41d0: 6f 63 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c oc..*/.void *sql
41e0: 69 74 65 33 5f 72 65 61 6c 6c 6f 63 28 76 6f 69 ite3_realloc(voi
41f0: 64 20 2a 70 4f 6c 64 2c 20 69 6e 74 20 6e 29 7b d *pOld, int n){
4200: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
4210: 4f 4d 49 54 5f 41 55 54 4f 49 4e 49 54 0a 20 20 OMIT_AUTOINIT.
4220: 69 66 28 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 if( sqlite3_init
4230: 69 61 6c 69 7a 65 28 29 20 29 20 72 65 74 75 72 ialize() ) retur
4240: 6e 20 30 3b 0a 23 65 6e 64 69 66 0a 20 20 72 65 n 0;.#endif. re
4250: 74 75 72 6e 20 73 71 6c 69 74 65 33 52 65 61 6c turn sqlite3Real
4260: 6c 6f 63 28 70 4f 6c 64 2c 20 6e 29 3b 0a 7d 0a loc(pOld, n);.}.
4270: 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 ../*.** Allocate
4280: 20 61 6e 64 20 7a 65 72 6f 20 6d 65 6d 6f 72 79 and zero memory
4290: 2e 0a 2a 2f 20 0a 76 6f 69 64 20 2a 73 71 6c 69 ..*/ .void *sqli
42a0: 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 69 6e te3MallocZero(in
42b0: 74 20 6e 29 7b 0a 20 20 76 6f 69 64 20 2a 70 20 t n){. void *p
42c0: 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 = sqlite3Malloc(
42d0: 6e 29 3b 0a 20 20 69 66 28 20 70 20 29 7b 0a 20 n);. if( p ){.
42e0: 20 20 20 6d 65 6d 73 65 74 28 70 2c 20 30 2c 20 memset(p, 0,
42f0: 6e 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e n);. }. return
4300: 20 70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c p;.}../*.** All
4310: 6f 63 61 74 65 20 61 6e 64 20 7a 65 72 6f 20 6d ocate and zero m
4320: 65 6d 6f 72 79 2e 20 20 49 66 20 74 68 65 20 61 emory. If the a
4330: 6c 6c 6f 63 61 74 69 6f 6e 20 66 61 69 6c 73 2c llocation fails,
4340: 20 6d 61 6b 65 0a 2a 2a 20 74 68 65 20 6d 61 6c make.** the mal
4350: 6c 6f 63 46 61 69 6c 65 64 20 66 6c 61 67 20 69 locFailed flag i
4360: 6e 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e n the connection
4370: 20 70 6f 69 6e 74 65 72 2e 0a 2a 2f 0a 76 6f 69 pointer..*/.voi
4380: 64 20 2a 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c d *sqlite3DbMall
4390: 6f 63 5a 65 72 6f 28 73 71 6c 69 74 65 33 20 2a ocZero(sqlite3 *
43a0: 64 62 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 76 6f db, int n){. vo
43b0: 69 64 20 2a 70 20 3d 20 73 71 6c 69 74 65 33 44 id *p = sqlite3D
43c0: 62 4d 61 6c 6c 6f 63 52 61 77 28 64 62 2c 20 6e bMallocRaw(db, n
43d0: 29 3b 0a 20 20 69 66 28 20 70 20 29 7b 0a 20 20 );. if( p ){.
43e0: 20 20 6d 65 6d 73 65 74 28 70 2c 20 30 2c 20 6e memset(p, 0, n
43f0: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 );. }. return
4400: 70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f p;.}../*.** Allo
4410: 63 61 74 65 20 61 6e 64 20 7a 65 72 6f 20 6d 65 cate and zero me
4420: 6d 6f 72 79 2e 20 20 49 66 20 74 68 65 20 61 6c mory. If the al
4430: 6c 6f 63 61 74 69 6f 6e 20 66 61 69 6c 73 2c 20 location fails,
4440: 6d 61 6b 65 0a 2a 2a 20 74 68 65 20 6d 61 6c 6c make.** the mall
4450: 6f 63 46 61 69 6c 65 64 20 66 6c 61 67 20 69 6e ocFailed flag in
4460: 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 the connection
4470: 70 6f 69 6e 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 pointer..**.** I
4480: 66 20 64 62 21 3d 30 20 61 6e 64 20 64 62 2d 3e f db!=0 and db->
4490: 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 69 73 20 mallocFailed is
44a0: 74 72 75 65 20 28 69 6e 64 69 63 61 74 69 6e 67 true (indicating
44b0: 20 61 20 70 72 69 6f 72 20 6d 61 6c 6c 6f 63 0a a prior malloc.
44c0: 2a 2a 20 66 61 69 6c 75 72 65 20 6f 6e 20 74 68 ** failure on th
44d0: 65 20 73 61 6d 65 20 64 61 74 61 62 61 73 65 20 e same database
44e0: 63 6f 6e 6e 65 63 74 69 6f 6e 29 20 74 68 65 6e connection) then
44f0: 20 61 6c 77 61 79 73 20 72 65 74 75 72 6e 20 30 always return 0
4500: 2e 0a 2a 2a 20 48 65 6e 63 65 20 66 6f 72 20 61 ..** Hence for a
4510: 20 70 61 72 74 69 63 75 6c 61 72 20 64 61 74 61 particular data
4520: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2c base connection,
4530: 20 6f 6e 63 65 20 6d 61 6c 6c 6f 63 20 73 74 61 once malloc sta
4540: 72 74 73 0a 2a 2a 20 66 61 69 6c 69 6e 67 2c 20 rts.** failing,
4550: 69 74 20 66 61 69 6c 73 20 63 6f 6e 73 69 73 74 it fails consist
4560: 65 6e 74 6c 79 20 75 6e 74 69 6c 20 6d 61 6c 6c ently until mall
4570: 6f 63 46 61 69 6c 65 64 20 69 73 20 72 65 73 65 ocFailed is rese
4580: 74 2e 0a 2a 2a 20 54 68 69 73 20 69 73 20 61 6e t..** This is an
4590: 20 69 6d 70 6f 72 74 61 6e 74 20 61 73 73 75 6d important assum
45a0: 70 74 69 6f 6e 2e 20 20 54 68 65 72 65 20 61 72 ption. There ar
45b0: 65 20 6d 61 6e 79 20 70 6c 61 63 65 73 20 69 6e e many places in
45c0: 20 74 68 65 0a 2a 2a 20 63 6f 64 65 20 74 68 61 the.** code tha
45d0: 74 20 64 6f 20 74 68 69 6e 67 73 20 6c 69 6b 65 t do things like
45e0: 20 74 68 69 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 this:.**.**
45f0: 20 20 20 20 20 69 6e 74 20 2a 61 20 3d 20 28 69 int *a = (i
4600: 6e 74 2a 29 73 71 6c 69 74 65 33 44 62 4d 61 6c nt*)sqlite3DbMal
4610: 6c 6f 63 52 61 77 28 64 62 2c 20 31 30 30 29 3b locRaw(db, 100);
4620: 0a 2a 2a 20 20 20 20 20 20 20 20 20 69 6e 74 20 .** int
4630: 2a 62 20 3d 20 28 69 6e 74 2a 29 73 71 6c 69 74 *b = (int*)sqlit
4640: 65 33 44 62 4d 61 6c 6c 6f 63 52 61 77 28 64 62 e3DbMallocRaw(db
4650: 2c 20 32 30 30 29 3b 0a 2a 2a 20 20 20 20 20 20 , 200);.**
4660: 20 20 20 69 66 28 20 62 20 29 20 61 5b 31 30 5d if( b ) a[10]
4670: 20 3d 20 39 3b 0a 2a 2a 0a 2a 2a 20 49 6e 20 6f = 9;.**.** In o
4680: 74 68 65 72 20 77 6f 72 64 73 2c 20 69 66 20 61 ther words, if a
4690: 20 73 75 62 73 65 71 75 65 6e 74 20 6d 61 6c 6c subsequent mall
46a0: 6f 63 20 28 65 78 3a 20 22 62 22 29 20 77 6f 72 oc (ex: "b") wor
46b0: 6b 65 64 2c 20 69 74 20 69 73 20 61 73 73 75 6d ked, it is assum
46c0: 65 64 0a 2a 2a 20 74 68 61 74 20 61 6c 6c 20 70 ed.** that all p
46d0: 72 69 6f 72 20 6d 61 6c 6c 6f 63 73 20 28 65 78 rior mallocs (ex
46e0: 3a 20 22 61 22 29 20 77 6f 72 6b 65 64 20 74 6f : "a") worked to
46f0: 6f 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 o..*/.void *sqli
4700: 74 65 33 44 62 4d 61 6c 6c 6f 63 52 61 77 28 73 te3DbMallocRaw(s
4710: 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 qlite3 *db, int
4720: 6e 29 7b 0a 20 20 76 6f 69 64 20 2a 70 3b 0a 20 n){. void *p;.
4730: 20 61 73 73 65 72 74 28 20 64 62 3d 3d 30 20 7c assert( db==0 |
4740: 7c 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f | sqlite3_mutex_
4750: 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 held(db->mutex)
4760: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 64 62 3d );. assert( db=
4770: 3d 30 20 7c 7c 20 64 62 2d 3e 70 6e 42 79 74 65 =0 || db->pnByte
4780: 73 46 72 65 65 64 3d 3d 30 20 29 3b 0a 23 69 66 sFreed==0 );.#if
4790: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
47a0: 5f 4c 4f 4f 4b 41 53 49 44 45 0a 20 20 69 66 28 _LOOKASIDE. if(
47b0: 20 64 62 20 29 7b 0a 20 20 20 20 4c 6f 6f 6b 61 db ){. Looka
47c0: 73 69 64 65 53 6c 6f 74 20 2a 70 42 75 66 3b 0a sideSlot *pBuf;.
47d0: 20 20 20 20 69 66 28 20 64 62 2d 3e 6d 61 6c 6c if( db->mall
47e0: 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 ocFailed ){.
47f0: 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 return 0;.
4800: 7d 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 6c 6f }. if( db->lo
4810: 6f 6b 61 73 69 64 65 2e 62 45 6e 61 62 6c 65 64 okaside.bEnabled
4820: 20 26 26 20 6e 3c 3d 64 62 2d 3e 6c 6f 6f 6b 61 && n<=db->looka
4830: 73 69 64 65 2e 73 7a 0a 20 20 20 20 20 20 20 20 side.sz.
4840: 20 26 26 20 28 70 42 75 66 20 3d 20 64 62 2d 3e && (pBuf = db->
4850: 6c 6f 6f 6b 61 73 69 64 65 2e 70 46 72 65 65 29 lookaside.pFree)
4860: 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 64 62 2d !=0 ){. db-
4870: 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 46 72 65 65 >lookaside.pFree
4880: 20 3d 20 70 42 75 66 2d 3e 70 4e 65 78 74 3b 0a = pBuf->pNext;.
4890: 20 20 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 db->lookas
48a0: 69 64 65 2e 6e 4f 75 74 2b 2b 3b 0a 20 20 20 20 ide.nOut++;.
48b0: 20 20 69 66 28 20 64 62 2d 3e 6c 6f 6f 6b 61 73 if( db->lookas
48c0: 69 64 65 2e 6e 4f 75 74 3e 64 62 2d 3e 6c 6f 6f ide.nOut>db->loo
48d0: 6b 61 73 69 64 65 2e 6d 78 4f 75 74 20 29 7b 0a kaside.mxOut ){.
48e0: 20 20 20 20 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b db->look
48f0: 61 73 69 64 65 2e 6d 78 4f 75 74 20 3d 20 64 62 aside.mxOut = db
4900: 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 6e 4f 75 74 ->lookaside.nOut
4910: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 ;. }.
4920: 72 65 74 75 72 6e 20 28 76 6f 69 64 2a 29 70 42 return (void*)pB
4930: 75 66 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 uf;. }. }.#e
4940: 6c 73 65 0a 20 20 69 66 28 20 64 62 20 26 26 20 lse. if( db &&
4950: 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 db->mallocFailed
4960: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 ){. return 0
4970: 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 70 ;. }.#endif. p
4980: 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 = sqlite3Malloc
4990: 28 6e 29 3b 0a 20 20 69 66 28 20 21 70 20 26 26 (n);. if( !p &&
49a0: 20 64 62 20 29 7b 0a 20 20 20 20 64 62 2d 3e 6d db ){. db->m
49b0: 61 6c 6c 6f 63 46 61 69 6c 65 64 20 3d 20 31 3b allocFailed = 1;
49c0: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 4d 65 . }. sqlite3Me
49d0: 6d 64 65 62 75 67 53 65 74 54 79 70 65 28 70 2c mdebugSetType(p,
49e0: 20 4d 45 4d 54 59 50 45 5f 44 42 20 7c 0a 20 20 MEMTYPE_DB |.
49f0: 20 20 20 20 20 20 20 28 28 64 62 20 26 26 20 64 ((db && d
4a00: 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 45 6e b->lookaside.bEn
4a10: 61 62 6c 65 64 29 20 3f 20 4d 45 4d 54 59 50 45 abled) ? MEMTYPE
4a20: 5f 4c 4f 4f 4b 41 53 49 44 45 20 3a 20 4d 45 4d _LOOKASIDE : MEM
4a30: 54 59 50 45 5f 48 45 41 50 29 29 3b 0a 20 20 72 TYPE_HEAP));. r
4a40: 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 2f 2a 0a 2a eturn p;.}../*.*
4a50: 2a 20 52 65 73 69 7a 65 20 74 68 65 20 62 6c 6f * Resize the blo
4a60: 63 6b 20 6f 66 20 6d 65 6d 6f 72 79 20 70 6f 69 ck of memory poi
4a70: 6e 74 65 64 20 74 6f 20 62 79 20 70 20 74 6f 20 nted to by p to
4a80: 6e 20 62 79 74 65 73 2e 20 49 66 20 74 68 65 0a n bytes. If the.
4a90: 2a 2a 20 72 65 73 69 7a 65 20 66 61 69 6c 73 2c ** resize fails,
4aa0: 20 73 65 74 20 74 68 65 20 6d 61 6c 6c 6f 63 46 set the mallocF
4ab0: 61 69 6c 65 64 20 66 6c 61 67 20 69 6e 20 74 68 ailed flag in th
4ac0: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6f 62 6a e connection obj
4ad0: 65 63 74 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 ect..*/.void *sq
4ae0: 6c 69 74 65 33 44 62 52 65 61 6c 6c 6f 63 28 73 lite3DbRealloc(s
4af0: 71 6c 69 74 65 33 20 2a 64 62 2c 20 76 6f 69 64 qlite3 *db, void
4b00: 20 2a 70 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 76 *p, int n){. v
4b10: 6f 69 64 20 2a 70 4e 65 77 20 3d 20 30 3b 0a 20 oid *pNew = 0;.
4b20: 20 61 73 73 65 72 74 28 20 64 62 21 3d 30 20 29 assert( db!=0 )
4b30: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
4b40: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 te3_mutex_held(d
4b50: 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 b->mutex) );. i
4b60: 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 f( db->mallocFai
4b70: 6c 65 64 3d 3d 30 20 29 7b 0a 20 20 20 20 69 66 led==0 ){. if
4b80: 28 20 70 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 ( p==0 ){.
4b90: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 44 62 return sqlite3Db
4ba0: 4d 61 6c 6c 6f 63 52 61 77 28 64 62 2c 20 6e 29 MallocRaw(db, n)
4bb0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
4bc0: 69 73 4c 6f 6f 6b 61 73 69 64 65 28 64 62 2c 20 isLookaside(db,
4bd0: 70 29 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 p) ){. if(
4be0: 6e 3c 3d 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 n<=db->lookaside
4bf0: 2e 73 7a 20 29 7b 0a 20 20 20 20 20 20 20 20 72 .sz ){. r
4c00: 65 74 75 72 6e 20 70 3b 0a 20 20 20 20 20 20 7d eturn p;. }
4c10: 0a 20 20 20 20 20 20 70 4e 65 77 20 3d 20 73 71 . pNew = sq
4c20: 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 52 61 77 lite3DbMallocRaw
4c30: 28 64 62 2c 20 6e 29 3b 0a 20 20 20 20 20 20 69 (db, n);. i
4c40: 66 28 20 70 4e 65 77 20 29 7b 0a 20 20 20 20 20 f( pNew ){.
4c50: 20 20 20 6d 65 6d 63 70 79 28 70 4e 65 77 2c 20 memcpy(pNew,
4c60: 70 2c 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 p, db->lookaside
4c70: 2e 73 7a 29 3b 0a 20 20 20 20 20 20 20 20 73 71 .sz);. sq
4c80: 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 lite3DbFree(db,
4c90: 70 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 p);. }.
4ca0: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 61 73 73 }else{. ass
4cb0: 65 72 74 28 20 73 71 6c 69 74 65 33 4d 65 6d 64 ert( sqlite3Memd
4cc0: 65 62 75 67 48 61 73 54 79 70 65 28 70 2c 20 4d ebugHasType(p, M
4cd0: 45 4d 54 59 50 45 5f 44 42 29 20 29 3b 0a 20 20 EMTYPE_DB) );.
4ce0: 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 assert( sqli
4cf0: 74 65 33 4d 65 6d 64 65 62 75 67 48 61 73 54 79 te3MemdebugHasTy
4d00: 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 4c 4f pe(p, MEMTYPE_LO
4d10: 4f 4b 41 53 49 44 45 7c 4d 45 4d 54 59 50 45 5f OKASIDE|MEMTYPE_
4d20: 48 45 41 50 29 20 29 3b 0a 20 20 20 20 20 20 73 HEAP) );. s
4d30: 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 53 65 qlite3MemdebugSe
4d40: 74 54 79 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 tType(p, MEMTYPE
4d50: 5f 48 45 41 50 29 3b 0a 20 20 20 20 20 20 70 4e _HEAP);. pN
4d60: 65 77 20 3d 20 73 71 6c 69 74 65 33 5f 72 65 61 ew = sqlite3_rea
4d70: 6c 6c 6f 63 28 70 2c 20 6e 29 3b 0a 20 20 20 20 lloc(p, n);.
4d80: 20 20 69 66 28 20 21 70 4e 65 77 20 29 7b 0a 20 if( !pNew ){.
4d90: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 4d 65 sqlite3Me
4da0: 6d 64 65 62 75 67 53 65 74 54 79 70 65 28 70 2c mdebugSetType(p,
4db0: 20 4d 45 4d 54 59 50 45 5f 44 42 7c 4d 45 4d 54 MEMTYPE_DB|MEMT
4dc0: 59 50 45 5f 48 45 41 50 29 3b 0a 20 20 20 20 20 YPE_HEAP);.
4dd0: 20 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 db->mallocFai
4de0: 6c 65 64 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d led = 1;. }
4df0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 4d 65 . sqlite3Me
4e00: 6d 64 65 62 75 67 53 65 74 54 79 70 65 28 70 4e mdebugSetType(pN
4e10: 65 77 2c 20 4d 45 4d 54 59 50 45 5f 44 42 20 7c ew, MEMTYPE_DB |
4e20: 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 64 . (d
4e30: 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 45 6e b->lookaside.bEn
4e40: 61 62 6c 65 64 20 3f 20 4d 45 4d 54 59 50 45 5f abled ? MEMTYPE_
4e50: 4c 4f 4f 4b 41 53 49 44 45 20 3a 20 4d 45 4d 54 LOOKASIDE : MEMT
4e60: 59 50 45 5f 48 45 41 50 29 29 3b 0a 20 20 20 20 YPE_HEAP));.
4e70: 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 }. }. return p
4e80: 4e 65 77 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 74 New;.}../*.** At
4e90: 74 65 6d 70 74 20 74 6f 20 72 65 61 6c 6c 6f 63 tempt to realloc
4ea0: 61 74 65 20 70 2e 20 20 49 66 20 74 68 65 20 72 ate p. If the r
4eb0: 65 61 6c 6c 6f 63 61 74 69 6f 6e 20 66 61 69 6c eallocation fail
4ec0: 73 2c 20 74 68 65 6e 20 66 72 65 65 20 70 0a 2a s, then free p.*
4ed0: 2a 20 61 6e 64 20 73 65 74 20 74 68 65 20 6d 61 * and set the ma
4ee0: 6c 6c 6f 63 46 61 69 6c 65 64 20 66 6c 61 67 20 llocFailed flag
4ef0: 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 in the database
4f00: 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 connection..*/.v
4f10: 6f 69 64 20 2a 73 71 6c 69 74 65 33 44 62 52 65 oid *sqlite3DbRe
4f20: 61 6c 6c 6f 63 4f 72 46 72 65 65 28 73 71 6c 69 allocOrFree(sqli
4f30: 74 65 33 20 2a 64 62 2c 20 76 6f 69 64 20 2a 70 te3 *db, void *p
4f40: 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 76 6f 69 64 , int n){. void
4f50: 20 2a 70 4e 65 77 3b 0a 20 20 70 4e 65 77 20 3d *pNew;. pNew =
4f60: 20 73 71 6c 69 74 65 33 44 62 52 65 61 6c 6c 6f sqlite3DbReallo
4f70: 63 28 64 62 2c 20 70 2c 20 6e 29 3b 0a 20 20 69 c(db, p, n);. i
4f80: 66 28 20 21 70 4e 65 77 20 29 7b 0a 20 20 20 20 f( !pNew ){.
4f90: 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 sqlite3DbFree(db
4fa0: 2c 20 70 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 , p);. }. retu
4fb0: 72 6e 20 70 4e 65 77 3b 0a 7d 0a 0a 2f 2a 0a 2a rn pNew;.}../*.*
4fc0: 2a 20 4d 61 6b 65 20 61 20 63 6f 70 79 20 6f 66 * Make a copy of
4fd0: 20 61 20 73 74 72 69 6e 67 20 69 6e 20 6d 65 6d a string in mem
4fe0: 6f 72 79 20 6f 62 74 61 69 6e 65 64 20 66 72 6f ory obtained fro
4ff0: 6d 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 29 m sqliteMalloc()
5000: 2e 20 54 68 65 73 65 20 0a 2a 2a 20 66 75 6e 63 . These .** func
5010: 74 69 6f 6e 73 20 63 61 6c 6c 20 73 71 6c 69 74 tions call sqlit
5020: 65 33 4d 61 6c 6c 6f 63 52 61 77 28 29 20 64 69 e3MallocRaw() di
5030: 72 65 63 74 6c 79 20 69 6e 73 74 65 61 64 20 6f rectly instead o
5040: 66 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 29 f sqliteMalloc()
5050: 2e 20 54 68 69 73 0a 2a 2a 20 69 73 20 62 65 63 . This.** is bec
5060: 61 75 73 65 20 77 68 65 6e 20 6d 65 6d 6f 72 79 ause when memory
5070: 20 64 65 62 75 67 67 69 6e 67 20 69 73 20 74 75 debugging is tu
5080: 72 6e 65 64 20 6f 6e 2c 20 74 68 65 73 65 20 74 rned on, these t
5090: 77 6f 20 66 75 6e 63 74 69 6f 6e 73 20 61 72 65 wo functions are
50a0: 20 0a 2a 2a 20 63 61 6c 6c 65 64 20 76 69 61 20 .** called via
50b0: 6d 61 63 72 6f 73 20 74 68 61 74 20 72 65 63 6f macros that reco
50c0: 72 64 20 74 68 65 20 63 75 72 72 65 6e 74 20 66 rd the current f
50d0: 69 6c 65 20 61 6e 64 20 6c 69 6e 65 20 6e 75 6d ile and line num
50e0: 62 65 72 20 69 6e 20 74 68 65 0a 2a 2a 20 54 68 ber in the.** Th
50f0: 72 65 61 64 44 61 74 61 20 73 74 72 75 63 74 75 readData structu
5100: 72 65 2e 0a 2a 2f 0a 63 68 61 72 20 2a 73 71 6c re..*/.char *sql
5110: 69 74 65 33 44 62 53 74 72 44 75 70 28 73 71 6c ite3DbStrDup(sql
5120: 69 74 65 33 20 2a 64 62 2c 20 63 6f 6e 73 74 20 ite3 *db, const
5130: 63 68 61 72 20 2a 7a 29 7b 0a 20 20 63 68 61 72 char *z){. char
5140: 20 2a 7a 4e 65 77 3b 0a 20 20 73 69 7a 65 5f 74 *zNew;. size_t
5150: 20 6e 3b 0a 20 20 69 66 28 20 7a 3d 3d 30 20 29 n;. if( z==0 )
5160: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a {. return 0;.
5170: 20 20 7d 0a 20 20 6e 20 3d 20 73 71 6c 69 74 65 }. n = sqlite
5180: 33 53 74 72 6c 65 6e 33 30 28 7a 29 20 2b 20 31 3Strlen30(z) + 1
5190: 3b 0a 20 20 61 73 73 65 72 74 28 20 28 6e 26 30 ;. assert( (n&0
51a0: 78 37 66 66 66 66 66 66 66 29 3d 3d 6e 20 29 3b x7fffffff)==n );
51b0: 0a 20 20 7a 4e 65 77 20 3d 20 73 71 6c 69 74 65 . zNew = sqlite
51c0: 33 44 62 4d 61 6c 6c 6f 63 52 61 77 28 64 62 2c 3DbMallocRaw(db,
51d0: 20 28 69 6e 74 29 6e 29 3b 0a 20 20 69 66 28 20 (int)n);. if(
51e0: 7a 4e 65 77 20 29 7b 0a 20 20 20 20 6d 65 6d 63 zNew ){. memc
51f0: 70 79 28 7a 4e 65 77 2c 20 7a 2c 20 6e 29 3b 0a py(zNew, z, n);.
5200: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 7a 4e 65 }. return zNe
5210: 77 3b 0a 7d 0a 63 68 61 72 20 2a 73 71 6c 69 74 w;.}.char *sqlit
5220: 65 33 44 62 53 74 72 4e 44 75 70 28 73 71 6c 69 e3DbStrNDup(sqli
5230: 74 65 33 20 2a 64 62 2c 20 63 6f 6e 73 74 20 63 te3 *db, const c
5240: 68 61 72 20 2a 7a 2c 20 69 6e 74 20 6e 29 7b 0a har *z, int n){.
5250: 20 20 63 68 61 72 20 2a 7a 4e 65 77 3b 0a 20 20 char *zNew;.
5260: 69 66 28 20 7a 3d 3d 30 20 29 7b 0a 20 20 20 20 if( z==0 ){.
5270: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 return 0;. }.
5280: 61 73 73 65 72 74 28 20 28 6e 26 30 78 37 66 66 assert( (n&0x7ff
5290: 66 66 66 66 66 29 3d 3d 6e 20 29 3b 0a 20 20 7a fffff)==n );. z
52a0: 4e 65 77 20 3d 20 73 71 6c 69 74 65 33 44 62 4d New = sqlite3DbM
52b0: 61 6c 6c 6f 63 52 61 77 28 64 62 2c 20 6e 2b 31 allocRaw(db, n+1
52c0: 29 3b 0a 20 20 69 66 28 20 7a 4e 65 77 20 29 7b );. if( zNew ){
52d0: 0a 20 20 20 20 6d 65 6d 63 70 79 28 7a 4e 65 77 . memcpy(zNew
52e0: 2c 20 7a 2c 20 6e 29 3b 0a 20 20 20 20 7a 4e 65 , z, n);. zNe
52f0: 77 5b 6e 5d 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 w[n] = 0;. }.
5300: 72 65 74 75 72 6e 20 7a 4e 65 77 3b 0a 7d 0a 0a return zNew;.}..
5310: 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 73 /*.** Create a s
5320: 74 72 69 6e 67 20 66 72 6f 6d 20 74 68 65 20 7a tring from the z
5330: 46 72 6f 6d 61 74 20 61 72 67 75 6d 65 6e 74 20 Fromat argument
5340: 61 6e 64 20 74 68 65 20 76 61 5f 6c 69 73 74 20 and the va_list
5350: 74 68 61 74 20 66 6f 6c 6c 6f 77 73 2e 0a 2a 2a that follows..**
5360: 20 53 74 6f 72 65 20 74 68 65 20 73 74 72 69 6e Store the strin
5370: 67 20 69 6e 20 6d 65 6d 6f 72 79 20 6f 62 74 61 g in memory obta
5380: 69 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 65 ined from sqlite
5390: 4d 61 6c 6c 6f 63 28 29 20 61 6e 64 20 6d 61 6b Malloc() and mak
53a0: 65 20 2a 70 7a 0a 2a 2a 20 70 6f 69 6e 74 20 74 e *pz.** point t
53b0: 6f 20 74 68 61 74 20 73 74 72 69 6e 67 2e 0a 2a o that string..*
53c0: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 65 /.void sqlite3Se
53d0: 74 53 74 72 69 6e 67 28 63 68 61 72 20 2a 2a 70 tString(char **p
53e0: 7a 2c 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 z, sqlite3 *db,
53f0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 6f 72 const char *zFor
5400: 6d 61 74 2c 20 2e 2e 2e 29 7b 0a 20 20 76 61 5f mat, ...){. va_
5410: 6c 69 73 74 20 61 70 3b 0a 20 20 63 68 61 72 20 list ap;. char
5420: 2a 7a 3b 0a 0a 20 20 76 61 5f 73 74 61 72 74 28 *z;.. va_start(
5430: 61 70 2c 20 7a 46 6f 72 6d 61 74 29 3b 0a 20 20 ap, zFormat);.
5440: 7a 20 3d 20 73 71 6c 69 74 65 33 56 4d 50 72 69 z = sqlite3VMPri
5450: 6e 74 66 28 64 62 2c 20 7a 46 6f 72 6d 61 74 2c ntf(db, zFormat,
5460: 20 61 70 29 3b 0a 20 20 76 61 5f 65 6e 64 28 61 ap);. va_end(a
5470: 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 44 62 46 p);. sqlite3DbF
5480: 72 65 65 28 64 62 2c 20 2a 70 7a 29 3b 0a 20 20 ree(db, *pz);.
5490: 2a 70 7a 20 3d 20 7a 3b 0a 7d 0a 0a 0a 2f 2a 0a *pz = z;.}.../*.
54a0: 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e ** This function
54b0: 20 6d 75 73 74 20 62 65 20 63 61 6c 6c 65 64 20 must be called
54c0: 62 65 66 6f 72 65 20 65 78 69 74 69 6e 67 20 61 before exiting a
54d0: 6e 79 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 20 ny API function
54e0: 28 69 2e 65 2e 20 0a 2a 2a 20 72 65 74 75 72 6e (i.e. .** return
54f0: 69 6e 67 20 63 6f 6e 74 72 6f 6c 20 74 6f 20 74 ing control to t
5500: 68 65 20 75 73 65 72 29 20 74 68 61 74 20 68 61 he user) that ha
5510: 73 20 63 61 6c 6c 65 64 20 73 71 6c 69 74 65 33 s called sqlite3
5520: 5f 6d 61 6c 6c 6f 63 20 6f 72 0a 2a 2a 20 73 71 _malloc or.** sq
5530: 6c 69 74 65 33 5f 72 65 61 6c 6c 6f 63 2e 0a 2a lite3_realloc..*
5540: 2a 0a 2a 2a 20 54 68 65 20 72 65 74 75 72 6e 65 *.** The returne
5550: 64 20 76 61 6c 75 65 20 69 73 20 6e 6f 72 6d 61 d value is norma
5560: 6c 6c 79 20 61 20 63 6f 70 79 20 6f 66 20 74 68 lly a copy of th
5570: 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e e second argumen
5580: 74 20 74 6f 20 74 68 69 73 0a 2a 2a 20 66 75 6e t to this.** fun
5590: 63 74 69 6f 6e 2e 20 48 6f 77 65 76 65 72 2c 20 ction. However,
55a0: 69 66 20 61 20 6d 61 6c 6c 6f 63 28 29 20 66 61 if a malloc() fa
55b0: 69 6c 75 72 65 20 68 61 73 20 6f 63 63 75 72 72 ilure has occurr
55c0: 65 64 20 73 69 6e 63 65 20 74 68 65 20 70 72 65 ed since the pre
55d0: 76 69 6f 75 73 0a 2a 2a 20 69 6e 76 6f 63 61 74 vious.** invocat
55e0: 69 6f 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d ion SQLITE_NOMEM
55f0: 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 6e 73 is returned ins
5600: 74 65 61 64 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 tead. .**.** If
5610: 74 68 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 the first argume
5620: 6e 74 2c 20 64 62 2c 20 69 73 20 6e 6f 74 20 4e nt, db, is not N
5630: 55 4c 4c 20 61 6e 64 20 61 20 6d 61 6c 6c 6f 63 ULL and a malloc
5640: 28 29 20 65 72 72 6f 72 20 68 61 73 20 6f 63 63 () error has occ
5650: 75 72 72 65 64 2c 0a 2a 2a 20 74 68 65 6e 20 74 urred,.** then t
5660: 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 65 72 he connection er
5670: 72 6f 72 2d 63 6f 64 65 20 28 74 68 65 20 76 61 ror-code (the va
5680: 6c 75 65 20 72 65 74 75 72 6e 65 64 20 62 79 20 lue returned by
5690: 73 71 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 28 sqlite3_errcode(
56a0: 29 29 0a 2a 2a 20 69 73 20 73 65 74 20 74 6f 20 )).** is set to
56b0: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 2e 0a 2a 2f SQLITE_NOMEM..*/
56c0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 41 70 69 45 .int sqlite3ApiE
56d0: 78 69 74 28 73 71 6c 69 74 65 33 2a 20 64 62 2c xit(sqlite3* db,
56e0: 20 69 6e 74 20 72 63 29 7b 0a 20 20 2f 2a 20 49 int rc){. /* I
56f0: 66 20 74 68 65 20 64 62 20 68 61 6e 64 6c 65 20 f the db handle
5700: 69 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 is not NULL, the
5710: 6e 20 77 65 20 6d 75 73 74 20 68 6f 6c 64 20 74 n we must hold t
5720: 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 he connection ha
5730: 6e 64 6c 65 0a 20 20 2a 2a 20 6d 75 74 65 78 20 ndle. ** mutex
5740: 68 65 72 65 2e 20 4f 74 68 65 72 77 69 73 65 20 here. Otherwise
5750: 74 68 65 20 72 65 61 64 20 28 61 6e 64 20 70 6f the read (and po
5760: 73 73 69 62 6c 65 20 77 72 69 74 65 29 20 6f 66 ssible write) of
5770: 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 db->mallocFaile
5780: 64 20 0a 20 20 2a 2a 20 69 73 20 75 6e 73 61 66 d . ** is unsaf
5790: 65 2c 20 61 73 20 69 73 20 74 68 65 20 63 61 6c e, as is the cal
57a0: 6c 20 74 6f 20 73 71 6c 69 74 65 33 45 72 72 6f l to sqlite3Erro
57b0: 72 28 29 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 r().. */. asse
57c0: 72 74 28 20 21 64 62 20 7c 7c 20 73 71 6c 69 74 rt( !db || sqlit
57d0: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 e3_mutex_held(db
57e0: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 ->mutex) );. if
57f0: 28 20 64 62 20 26 26 20 28 64 62 2d 3e 6d 61 6c ( db && (db->mal
5800: 6c 6f 63 46 61 69 6c 65 64 20 7c 7c 20 72 63 3d locFailed || rc=
5810: 3d 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4e 4f =SQLITE_IOERR_NO
5820: 4d 45 4d 29 20 29 7b 0a 20 20 20 20 73 71 6c 69 MEM) ){. sqli
5830: 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51 4c te3Error(db, SQL
5840: 49 54 45 5f 4e 4f 4d 45 4d 2c 20 30 29 3b 0a 20 ITE_NOMEM, 0);.
5850: 20 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 db->mallocFai
5860: 6c 65 64 20 3d 20 30 3b 0a 20 20 20 20 72 63 20 led = 0;. rc
5870: 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a = SQLITE_NOMEM;.
5880: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 20 }. return rc
5890: 26 20 28 64 62 20 3f 20 64 62 2d 3e 65 72 72 4d & (db ? db->errM
58a0: 61 73 6b 20 3a 20 30 78 66 66 29 3b 0a 7d 0a ask : 0xff);.}.