/ Hex Artifact Content
Login

Artifact 12c155d0cd5360bfd8f79468fca573eb1e0d27b9:


0000: 2f 2a 0a 2a 2a 20 32 30 30 38 20 4e 6f 76 65 6d  /*.** 2008 Novem
0010: 62 65 72 20 30 35 0a 2a 2a 0a 2a 2a 20 54 68 65  ber 05.**.** The
0020: 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 6d   author disclaim
0030: 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 74  s copyright to t
0040: 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 2e  his source code.
0050: 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a 2a    In place of.**
0060: 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 2c   a legal notice,
0070: 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 73   here is a bless
0080: 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61  ing:.**.**    Ma
0090: 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 6e  y you do good an
00a0: 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 20  d not evil..**  
00b0: 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 66    May you find f
00c0: 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 79  orgiveness for y
00d0: 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 67  ourself and forg
00e0: 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 20  ive others..**  
00f0: 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 20    May you share 
0100: 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 61  freely, never ta
0110: 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 79  king more than y
0120: 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a  ou 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 0a 2a 2a 0a 2a 2a 20 54 68 69 73  *****.**.** This
0180: 20 66 69 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 73   file implements
0190: 20 74 68 65 20 64 65 66 61 75 6c 74 20 70 61 67   the default pag
01a0: 65 20 63 61 63 68 65 20 69 6d 70 6c 65 6d 65 6e  e cache implemen
01b0: 74 61 74 69 6f 6e 20 28 74 68 65 0a 2a 2a 20 73  tation (the.** s
01c0: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 69 6e  qlite3_pcache in
01d0: 74 65 72 66 61 63 65 29 2e 20 49 74 20 61 6c 73  terface). It als
01e0: 6f 20 63 6f 6e 74 61 69 6e 73 20 70 61 72 74 20  o contains part 
01f0: 6f 66 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74  of the implement
0200: 61 74 69 6f 6e 0a 2a 2a 20 6f 66 20 74 68 65 20  ation.** of the 
0210: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41  SQLITE_CONFIG_PA
0220: 47 45 43 41 43 48 45 20 61 6e 64 20 73 71 6c 69  GECACHE and sqli
0230: 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f  te3_release_memo
0240: 72 79 28 29 20 66 65 61 74 75 72 65 73 2e 0a 2a  ry() features..*
0250: 2a 20 49 66 20 74 68 65 20 64 65 66 61 75 6c 74  * If the default
0260: 20 70 61 67 65 20 63 61 63 68 65 20 69 6d 70 6c   page cache impl
0270: 65 6d 65 6e 74 61 74 69 6f 6e 20 69 73 20 6f 76  ementation is ov
0280: 65 72 72 69 64 64 65 6e 2c 20 74 68 65 6e 20 6e  erridden, then n
0290: 65 69 74 68 65 72 20 6f 66 0a 2a 2a 20 74 68 65  either of.** the
02a0: 73 65 20 74 77 6f 20 66 65 61 74 75 72 65 73 20  se two features 
02b0: 61 72 65 20 61 76 61 69 6c 61 62 6c 65 2e 0a 2a  are available..*
02c0: 2f 0a 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 6c  /..#include "sql
02d0: 69 74 65 49 6e 74 2e 68 22 0a 0a 74 79 70 65 64  iteInt.h"..typed
02e0: 65 66 20 73 74 72 75 63 74 20 50 43 61 63 68 65  ef struct PCache
02f0: 31 20 50 43 61 63 68 65 31 3b 0a 74 79 70 65 64  1 PCache1;.typed
0300: 65 66 20 73 74 72 75 63 74 20 50 67 48 64 72 31  ef struct PgHdr1
0310: 20 50 67 48 64 72 31 3b 0a 74 79 70 65 64 65 66   PgHdr1;.typedef
0320: 20 73 74 72 75 63 74 20 50 67 46 72 65 65 73 6c   struct PgFreesl
0330: 6f 74 20 50 67 46 72 65 65 73 6c 6f 74 3b 0a 74  ot PgFreeslot;.t
0340: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 50 47  ypedef struct PG
0350: 72 6f 75 70 20 50 47 72 6f 75 70 3b 0a 0a 2f 2a  roup PGroup;../*
0360: 20 45 61 63 68 20 70 61 67 65 20 63 61 63 68 65   Each page cache
0370: 20 28 6f 72 20 50 43 61 63 68 65 29 20 62 65 6c   (or PCache) bel
0380: 6f 6e 67 73 20 74 6f 20 61 20 50 47 72 6f 75 70  ongs to a PGroup
0390: 2e 20 20 41 20 50 47 72 6f 75 70 20 69 73 20 61  .  A PGroup is a
03a0: 20 73 65 74 20 0a 2a 2a 20 6f 66 20 6f 6e 65 20   set .** of one 
03b0: 6f 72 20 6d 6f 72 65 20 50 43 61 63 68 65 73 20  or more PCaches 
03c0: 74 68 61 74 20 61 72 65 20 61 62 6c 65 20 74 6f  that are able to
03d0: 20 72 65 63 79 63 6c 65 20 65 61 63 68 20 6f 74   recycle each ot
03e0: 68 65 72 27 73 20 75 6e 70 69 6e 6e 65 64 0a 2a  her's unpinned.*
03f0: 2a 20 70 61 67 65 73 20 77 68 65 6e 20 74 68 65  * pages when the
0400: 79 20 61 72 65 20 75 6e 64 65 72 20 6d 65 6d 6f  y are under memo
0410: 72 79 20 70 72 65 73 73 75 72 65 2e 20 20 41 20  ry pressure.  A 
0420: 50 47 72 6f 75 70 20 69 73 20 61 6e 20 69 6e 73  PGroup is an ins
0430: 74 61 6e 63 65 20 6f 66 0a 2a 2a 20 74 68 65 20  tance of.** the 
0440: 66 6f 6c 6c 6f 77 69 6e 67 20 6f 62 6a 65 63 74  following object
0450: 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 70 61 67  ..**.** This pag
0460: 65 20 63 61 63 68 65 20 69 6d 70 6c 65 6d 65 6e  e cache implemen
0470: 74 61 74 69 6f 6e 20 77 6f 72 6b 73 20 69 6e 20  tation works in 
0480: 6f 6e 65 20 6f 66 20 74 77 6f 20 6d 6f 64 65 73  one of two modes
0490: 3a 0a 2a 2a 0a 2a 2a 20 20 20 28 31 29 20 20 45  :.**.**   (1)  E
04a0: 76 65 72 79 20 50 43 61 63 68 65 20 69 73 20 74  very PCache is t
04b0: 68 65 20 73 6f 6c 65 20 6d 65 6d 62 65 72 20 6f  he sole member o
04c0: 66 20 69 74 73 20 6f 77 6e 20 50 47 72 6f 75 70  f its own PGroup
04d0: 2e 20 20 54 68 65 72 65 20 69 73 0a 2a 2a 20 20  .  There is.**  
04e0: 20 20 20 20 20 20 6f 6e 65 20 50 47 72 6f 75 70        one PGroup
04f0: 20 70 65 72 20 50 43 61 63 68 65 2e 0a 2a 2a 0a   per PCache..**.
0500: 2a 2a 20 20 20 28 32 29 20 20 54 68 65 72 65 20  **   (2)  There 
0510: 69 73 20 61 20 73 69 6e 67 6c 65 20 67 6c 6f 62  is a single glob
0520: 61 6c 20 50 47 72 6f 75 70 20 74 68 61 74 20 61  al PGroup that a
0530: 6c 6c 20 50 43 61 63 68 65 73 20 61 72 65 20 61  ll PCaches are a
0540: 20 6d 65 6d 62 65 72 0a 2a 2a 20 20 20 20 20 20   member.**      
0550: 20 20 6f 66 2e 0a 2a 2a 0a 2a 2a 20 4d 6f 64 65    of..**.** Mode
0560: 20 31 20 75 73 65 73 20 6d 6f 72 65 20 6d 65 6d   1 uses more mem
0570: 6f 72 79 20 28 73 69 6e 63 65 20 50 43 61 63 68  ory (since PCach
0580: 65 20 69 6e 73 74 61 6e 63 65 73 20 61 72 65 20  e instances are 
0590: 6e 6f 74 20 61 62 6c 65 20 74 6f 20 72 6f 62 0a  not able to rob.
05a0: 2a 2a 20 75 6e 75 73 65 64 20 70 61 67 65 73 20  ** unused pages 
05b0: 66 72 6f 6d 20 6f 74 68 65 72 20 50 43 61 63 68  from other PCach
05c0: 65 73 29 20 62 75 74 20 69 74 20 61 6c 73 6f 20  es) but it also 
05d0: 6f 70 65 72 61 74 65 73 20 77 69 74 68 6f 75 74  operates without
05e0: 20 61 20 6d 75 74 65 78 2c 0a 2a 2a 20 61 6e 64   a mutex,.** and
05f0: 20 69 73 20 74 68 65 72 65 66 6f 72 65 20 6f 66   is therefore of
0600: 74 65 6e 20 66 61 73 74 65 72 2e 20 20 4d 6f 64  ten faster.  Mod
0610: 65 20 32 20 72 65 71 75 69 72 65 73 20 61 20 6d  e 2 requires a m
0620: 75 74 65 78 20 69 6e 20 6f 72 64 65 72 20 74 6f  utex in order to
0630: 20 62 65 0a 2a 2a 20 74 68 72 65 61 64 73 61 66   be.** threadsaf
0640: 65 2c 20 62 75 74 20 72 65 63 79 63 6c 65 73 20  e, but recycles 
0650: 70 61 67 65 73 20 6d 6f 72 65 20 65 66 66 69 63  pages more effic
0660: 69 65 6e 74 6c 79 2e 0a 2a 2a 0a 2a 2a 20 46 6f  iently..**.** Fo
0670: 72 20 6d 6f 64 65 20 28 31 29 2c 20 50 47 72 6f  r mode (1), PGro
0680: 75 70 2e 6d 75 74 65 78 20 69 73 20 4e 55 4c 4c  up.mutex is NULL
0690: 2e 20 20 46 6f 72 20 6d 6f 64 65 20 28 32 29 20  .  For mode (2) 
06a0: 74 68 65 72 65 20 69 73 20 6f 6e 6c 79 20 61 20  there is only a 
06b0: 73 69 6e 67 6c 65 0a 2a 2a 20 50 47 72 6f 75 70  single.** PGroup
06c0: 20 77 68 69 63 68 20 69 73 20 74 68 65 20 70 63   which is the pc
06d0: 61 63 68 65 31 2e 67 72 70 20 67 6c 6f 62 61 6c  ache1.grp global
06e0: 20 76 61 72 69 61 62 6c 65 20 61 6e 64 20 69 74   variable and it
06f0: 73 20 6d 75 74 65 78 20 69 73 0a 2a 2a 20 53 51  s mutex is.** SQ
0700: 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49  LITE_MUTEX_STATI
0710: 43 5f 4c 52 55 2e 0a 2a 2f 0a 73 74 72 75 63 74  C_LRU..*/.struct
0720: 20 50 47 72 6f 75 70 20 7b 0a 20 20 73 71 6c 69   PGroup {.  sqli
0730: 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78  te3_mutex *mutex
0740: 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 55  ;          /* MU
0750: 54 45 58 5f 53 54 41 54 49 43 5f 4c 52 55 20 6f  TEX_STATIC_LRU o
0760: 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20 75 6e 73 69  r NULL */.  unsi
0770: 67 6e 65 64 20 69 6e 74 20 6e 4d 61 78 50 61 67  gned int nMaxPag
0780: 65 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 53 75  e;         /* Su
0790: 6d 20 6f 66 20 6e 4d 61 78 20 66 6f 72 20 70 75  m of nMax for pu
07a0: 72 67 65 61 62 6c 65 20 63 61 63 68 65 73 20 2a  rgeable caches *
07b0: 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74  /.  unsigned int
07c0: 20 6e 4d 69 6e 50 61 67 65 3b 20 20 20 20 20 20   nMinPage;      
07d0: 20 20 20 2f 2a 20 53 75 6d 20 6f 66 20 6e 4d 69     /* Sum of nMi
07e0: 6e 20 66 6f 72 20 70 75 72 67 65 61 62 6c 65 20  n for purgeable 
07f0: 63 61 63 68 65 73 20 2a 2f 0a 20 20 75 6e 73 69  caches */.  unsi
0800: 67 6e 65 64 20 69 6e 74 20 6d 78 50 69 6e 6e 65  gned int mxPinne
0810: 64 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 6e 4d  d;         /* nM
0820: 61 78 70 61 67 65 20 2b 20 31 30 20 2d 20 6e 4d  axpage + 10 - nM
0830: 69 6e 50 61 67 65 20 2a 2f 0a 20 20 75 6e 73 69  inPage */.  unsi
0840: 67 6e 65 64 20 69 6e 74 20 6e 43 75 72 72 65 6e  gned int nCurren
0850: 74 50 61 67 65 3b 20 20 20 20 20 2f 2a 20 4e 75  tPage;     /* Nu
0860: 6d 62 65 72 20 6f 66 20 70 75 72 67 65 61 62 6c  mber of purgeabl
0870: 65 20 70 61 67 65 73 20 61 6c 6c 6f 63 61 74 65  e pages allocate
0880: 64 20 2a 2f 0a 20 20 50 67 48 64 72 31 20 2a 70  d */.  PgHdr1 *p
0890: 4c 72 75 48 65 61 64 2c 20 2a 70 4c 72 75 54 61  LruHead, *pLruTa
08a0: 69 6c 3b 20 20 20 2f 2a 20 4c 52 55 20 6c 69 73  il;   /* LRU lis
08b0: 74 20 6f 66 20 75 6e 70 69 6e 6e 65 64 20 70 61  t of unpinned pa
08c0: 67 65 73 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 45 61  ges */.};../* Ea
08d0: 63 68 20 70 61 67 65 20 63 61 63 68 65 20 69 73  ch page cache is
08e0: 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20   an instance of 
08f0: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 62  the following ob
0900: 6a 65 63 74 2e 20 20 45 76 65 72 79 0a 2a 2a 20  ject.  Every.** 
0910: 6f 70 65 6e 20 64 61 74 61 62 61 73 65 20 66 69  open database fi
0920: 6c 65 20 28 69 6e 63 6c 75 64 69 6e 67 20 65 61  le (including ea
0930: 63 68 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74  ch in-memory dat
0940: 61 62 61 73 65 20 61 6e 64 20 65 61 63 68 0a 2a  abase and each.*
0950: 2a 20 74 65 6d 70 6f 72 61 72 79 20 6f 72 20 74  * temporary or t
0960: 72 61 6e 73 69 65 6e 74 20 64 61 74 61 62 61 73  ransient databas
0970: 65 29 20 68 61 73 20 61 20 73 69 6e 67 6c 65 20  e) has a single 
0980: 70 61 67 65 20 63 61 63 68 65 20 77 68 69 63 68  page cache which
0990: 0a 2a 2a 20 69 73 20 61 6e 20 69 6e 73 74 61 6e  .** is an instan
09a0: 63 65 20 6f 66 20 74 68 69 73 20 6f 62 6a 65 63  ce of this objec
09b0: 74 2e 0a 2a 2a 0a 2a 2a 20 50 6f 69 6e 74 65 72  t..**.** Pointer
09c0: 73 20 74 6f 20 73 74 72 75 63 74 75 72 65 73 20  s to structures 
09d0: 6f 66 20 74 68 69 73 20 74 79 70 65 20 61 72 65  of this type are
09e0: 20 63 61 73 74 20 61 6e 64 20 72 65 74 75 72 6e   cast and return
09f0: 65 64 20 61 73 20 0a 2a 2a 20 6f 70 61 71 75 65  ed as .** opaque
0a00: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2a   sqlite3_pcache*
0a10: 20 68 61 6e 64 6c 65 73 2e 0a 2a 2f 0a 73 74 72   handles..*/.str
0a20: 75 63 74 20 50 43 61 63 68 65 31 20 7b 0a 20 20  uct PCache1 {.  
0a30: 2f 2a 20 43 61 63 68 65 20 63 6f 6e 66 69 67 75  /* Cache configu
0a40: 72 61 74 69 6f 6e 20 70 61 72 61 6d 65 74 65 72  ration parameter
0a50: 73 2e 20 50 61 67 65 20 73 69 7a 65 20 28 73 7a  s. Page size (sz
0a60: 50 61 67 65 29 20 61 6e 64 20 74 68 65 20 70 75  Page) and the pu
0a70: 72 67 65 61 62 6c 65 0a 20 20 2a 2a 20 66 6c 61  rgeable.  ** fla
0a80: 67 20 28 62 50 75 72 67 65 61 62 6c 65 29 20 61  g (bPurgeable) a
0a90: 72 65 20 73 65 74 20 77 68 65 6e 20 74 68 65 20  re set when the 
0aa0: 63 61 63 68 65 20 69 73 20 63 72 65 61 74 65 64  cache is created
0ab0: 2e 20 6e 4d 61 78 20 6d 61 79 20 62 65 20 0a 20  . nMax may be . 
0ac0: 20 2a 2a 20 6d 6f 64 69 66 69 65 64 20 61 74 20   ** modified at 
0ad0: 61 6e 79 20 74 69 6d 65 20 62 79 20 61 20 63 61  any time by a ca
0ae0: 6c 6c 20 74 6f 20 74 68 65 20 70 63 61 63 68 65  ll to the pcache
0af0: 31 43 61 63 68 65 73 69 7a 65 28 29 20 6d 65 74  1Cachesize() met
0b00: 68 6f 64 2e 0a 20 20 2a 2a 20 54 68 65 20 50 47  hod..  ** The PG
0b10: 72 6f 75 70 20 6d 75 74 65 78 20 6d 75 73 74 20  roup mutex must 
0b20: 62 65 20 68 65 6c 64 20 77 68 65 6e 20 61 63 63  be held when acc
0b30: 65 73 73 69 6e 67 20 6e 4d 61 78 2e 0a 20 20 2a  essing nMax..  *
0b40: 2f 0a 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f  /.  PGroup *pGro
0b50: 75 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  up;             
0b60: 20 20 20 20 20 20 20 20 2f 2a 20 50 47 72 6f 75          /* PGrou
0b70: 70 20 74 68 69 73 20 63 61 63 68 65 20 62 65 6c  p this cache bel
0b80: 6f 6e 67 73 20 74 6f 20 2a 2f 0a 20 20 69 6e 74  ongs to */.  int
0b90: 20 73 7a 50 61 67 65 3b 20 20 20 20 20 20 20 20   szPage;        
0ba0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0bb0: 20 2f 2a 20 53 69 7a 65 20 6f 66 20 61 6c 6c 6f   /* Size of allo
0bc0: 63 61 74 65 64 20 70 61 67 65 73 20 69 6e 20 62  cated pages in b
0bd0: 79 74 65 73 20 2a 2f 0a 20 20 69 6e 74 20 73 7a  ytes */.  int sz
0be0: 45 78 74 72 61 3b 20 20 20 20 20 20 20 20 20 20  Extra;          
0bf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
0c00: 20 53 69 7a 65 20 6f 66 20 65 78 74 72 61 20 73   Size of extra s
0c10: 70 61 63 65 20 69 6e 20 62 79 74 65 73 20 2a 2f  pace in bytes */
0c20: 0a 20 20 69 6e 74 20 62 50 75 72 67 65 61 62 6c  .  int bPurgeabl
0c30: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  e;              
0c40: 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69         /* True i
0c50: 66 20 63 61 63 68 65 20 69 73 20 70 75 72 67 65  f cache is purge
0c60: 61 62 6c 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e  able */.  unsign
0c70: 65 64 20 69 6e 74 20 6e 4d 69 6e 3b 20 20 20 20  ed int nMin;    
0c80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
0c90: 20 4d 69 6e 69 6d 75 6d 20 6e 75 6d 62 65 72 20   Minimum number 
0ca0: 6f 66 20 70 61 67 65 73 20 72 65 73 65 72 76 65  of pages reserve
0cb0: 64 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20  d */.  unsigned 
0cc0: 69 6e 74 20 6e 4d 61 78 3b 20 20 20 20 20 20 20  int nMax;       
0cd0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f             /* Co
0ce0: 6e 66 69 67 75 72 65 64 20 22 63 61 63 68 65 5f  nfigured "cache_
0cf0: 73 69 7a 65 22 20 76 61 6c 75 65 20 2a 2f 0a 20  size" value */. 
0d00: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 39   unsigned int n9
0d10: 30 70 63 74 3b 20 20 20 20 20 20 20 20 20 20 20  0pct;           
0d20: 20 20 20 20 20 2f 2a 20 6e 4d 61 78 2a 39 2f 31       /* nMax*9/1
0d30: 30 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20  0 */.  unsigned 
0d40: 69 6e 74 20 69 4d 61 78 4b 65 79 3b 20 20 20 20  int iMaxKey;    
0d50: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 61             /* La
0d60: 72 67 65 73 74 20 6b 65 79 20 73 65 65 6e 20 73  rgest key seen s
0d70: 69 6e 63 65 20 78 54 72 75 6e 63 61 74 65 28 29  ince xTruncate()
0d80: 20 2a 2f 0a 0a 20 20 2f 2a 20 48 61 73 68 20 74   */..  /* Hash t
0d90: 61 62 6c 65 20 6f 66 20 61 6c 6c 20 70 61 67 65  able of all page
0da0: 73 2e 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  s. The following
0db0: 20 76 61 72 69 61 62 6c 65 73 20 6d 61 79 20 6f   variables may o
0dc0: 6e 6c 79 20 62 65 20 61 63 63 65 73 73 65 64 0a  nly be accessed.
0dd0: 20 20 2a 2a 20 77 68 65 6e 20 74 68 65 20 61 63    ** when the ac
0de0: 63 65 73 73 6f 72 20 69 73 20 68 6f 6c 64 69 6e  cessor is holdin
0df0: 67 20 74 68 65 20 50 47 72 6f 75 70 20 6d 75 74  g the PGroup mut
0e00: 65 78 2e 0a 20 20 2a 2f 0a 20 20 75 6e 73 69 67  ex..  */.  unsig
0e10: 6e 65 64 20 69 6e 74 20 6e 52 65 63 79 63 6c 61  ned int nRecycla
0e20: 62 6c 65 3b 20 20 20 20 20 20 20 20 20 20 20 2f  ble;           /
0e30: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65  * Number of page
0e40: 73 20 69 6e 20 74 68 65 20 4c 52 55 20 6c 69 73  s in the LRU lis
0e50: 74 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20  t */.  unsigned 
0e60: 69 6e 74 20 6e 50 61 67 65 3b 20 20 20 20 20 20  int nPage;      
0e70: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 6f             /* To
0e80: 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 61  tal number of pa
0e90: 67 65 73 20 69 6e 20 61 70 48 61 73 68 20 2a 2f  ges in apHash */
0ea0: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
0eb0: 6e 48 61 73 68 3b 20 20 20 20 20 20 20 20 20 20  nHash;          
0ec0: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72         /* Number
0ed0: 20 6f 66 20 73 6c 6f 74 73 20 69 6e 20 61 70 48   of slots in apH
0ee0: 61 73 68 5b 5d 20 2a 2f 0a 20 20 50 67 48 64 72  ash[] */.  PgHdr
0ef0: 31 20 2a 2a 61 70 48 61 73 68 3b 20 20 20 20 20  1 **apHash;     
0f00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
0f10: 2a 20 48 61 73 68 20 74 61 62 6c 65 20 66 6f 72  * Hash table for
0f20: 20 66 61 73 74 20 6c 6f 6f 6b 75 70 20 62 79 20   fast lookup by 
0f30: 6b 65 79 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a  key */.};../*.**
0f40: 20 45 61 63 68 20 63 61 63 68 65 20 65 6e 74 72   Each cache entr
0f50: 79 20 69 73 20 72 65 70 72 65 73 65 6e 74 65 64  y is represented
0f60: 20 62 79 20 61 6e 20 69 6e 73 74 61 6e 63 65 20   by an instance 
0f70: 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  of the following
0f80: 20 0a 2a 2a 20 73 74 72 75 63 74 75 72 65 2e 20   .** structure. 
0f90: 55 6e 6c 65 73 73 20 53 51 4c 49 54 45 5f 50 43  Unless SQLITE_PC
0fa0: 41 43 48 45 5f 53 45 50 41 52 41 54 45 5f 48 45  ACHE_SEPARATE_HE
0fb0: 41 44 45 52 20 69 73 20 64 65 66 69 6e 65 64 2c  ADER is defined,
0fc0: 20 61 20 62 75 66 66 65 72 20 6f 66 0a 2a 2a 20   a buffer of.** 
0fd0: 50 67 48 64 72 31 2e 70 43 61 63 68 65 2d 3e 73  PgHdr1.pCache->s
0fe0: 7a 50 61 67 65 20 62 79 74 65 73 20 69 73 20 61  zPage bytes is a
0ff0: 6c 6c 6f 63 61 74 65 64 20 64 69 72 65 63 74 6c  llocated directl
1000: 79 20 62 65 66 6f 72 65 20 74 68 69 73 20 73 74  y before this st
1010: 72 75 63 74 75 72 65 20 0a 2a 2a 20 69 6e 20 6d  ructure .** in m
1020: 65 6d 6f 72 79 2e 0a 2a 2f 0a 73 74 72 75 63 74  emory..*/.struct
1030: 20 50 67 48 64 72 31 20 7b 0a 20 20 73 71 6c 69   PgHdr1 {.  sqli
1040: 74 65 33 5f 70 63 61 63 68 65 5f 70 61 67 65 20  te3_pcache_page 
1050: 70 61 67 65 3b 0a 20 20 75 6e 73 69 67 6e 65 64  page;.  unsigned
1060: 20 69 6e 74 20 69 4b 65 79 3b 20 20 20 20 20 20   int iKey;      
1070: 20 20 20 20 20 20 20 2f 2a 20 4b 65 79 20 76 61         /* Key va
1080: 6c 75 65 20 28 70 61 67 65 20 6e 75 6d 62 65 72  lue (page number
1090: 29 20 2a 2f 0a 20 20 75 38 20 69 73 50 69 6e 6e  ) */.  u8 isPinn
10a0: 65 64 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  ed;             
10b0: 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 69 6e        /* Page in
10c0: 20 75 73 65 2c 20 6e 6f 74 20 6f 6e 20 74 68 65   use, not on the
10d0: 20 4c 52 55 20 6c 69 73 74 20 2a 2f 0a 20 20 50   LRU list */.  P
10e0: 67 48 64 72 31 20 2a 70 4e 65 78 74 3b 20 20 20  gHdr1 *pNext;   
10f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
1100: 20 4e 65 78 74 20 69 6e 20 68 61 73 68 20 74 61   Next in hash ta
1110: 62 6c 65 20 63 68 61 69 6e 20 2a 2f 0a 20 20 50  ble chain */.  P
1120: 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 3b 20  Cache1 *pCache; 
1130: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
1140: 20 43 61 63 68 65 20 74 68 61 74 20 63 75 72 72   Cache that curr
1150: 65 6e 74 6c 79 20 6f 77 6e 73 20 74 68 69 73 20  ently owns this 
1160: 70 61 67 65 20 2a 2f 0a 20 20 50 67 48 64 72 31  page */.  PgHdr1
1170: 20 2a 70 4c 72 75 4e 65 78 74 3b 20 20 20 20 20   *pLruNext;     
1180: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 74           /* Next
1190: 20 69 6e 20 4c 52 55 20 6c 69 73 74 20 6f 66 20   in LRU list of 
11a0: 75 6e 70 69 6e 6e 65 64 20 70 61 67 65 73 20 2a  unpinned pages *
11b0: 2f 0a 20 20 50 67 48 64 72 31 20 2a 70 4c 72 75  /.  PgHdr1 *pLru
11c0: 50 72 65 76 3b 20 20 20 20 20 20 20 20 20 20 20  Prev;           
11d0: 20 20 20 2f 2a 20 50 72 65 76 69 6f 75 73 20 69     /* Previous i
11e0: 6e 20 4c 52 55 20 6c 69 73 74 20 6f 66 20 75 6e  n LRU list of un
11f0: 70 69 6e 6e 65 64 20 70 61 67 65 73 20 2a 2f 0a  pinned pages */.
1200: 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 73  };../*.** Free s
1210: 6c 6f 74 73 20 69 6e 20 74 68 65 20 61 6c 6c 6f  lots in the allo
1220: 63 61 74 6f 72 20 75 73 65 64 20 74 6f 20 64 69  cator used to di
1230: 76 69 64 65 20 75 70 20 74 68 65 20 62 75 66 66  vide up the buff
1240: 65 72 20 70 72 6f 76 69 64 65 64 20 75 73 69 6e  er provided usin
1250: 67 0a 2a 2a 20 74 68 65 20 53 51 4c 49 54 45 5f  g.** the SQLITE_
1260: 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45  CONFIG_PAGECACHE
1270: 20 6d 65 63 68 61 6e 69 73 6d 2e 0a 2a 2f 0a 73   mechanism..*/.s
1280: 74 72 75 63 74 20 50 67 46 72 65 65 73 6c 6f 74  truct PgFreeslot
1290: 20 7b 0a 20 20 50 67 46 72 65 65 73 6c 6f 74 20   {.  PgFreeslot 
12a0: 2a 70 4e 65 78 74 3b 20 20 2f 2a 20 4e 65 78 74  *pNext;  /* Next
12b0: 20 66 72 65 65 20 73 6c 6f 74 20 2a 2f 0a 7d 3b   free slot */.};
12c0: 0a 0a 2f 2a 0a 2a 2a 20 47 6c 6f 62 61 6c 20 64  ../*.** Global d
12d0: 61 74 61 20 75 73 65 64 20 62 79 20 74 68 69 73  ata used by this
12e0: 20 63 61 63 68 65 2e 0a 2a 2f 0a 73 74 61 74 69   cache..*/.stati
12f0: 63 20 53 51 4c 49 54 45 5f 57 53 44 20 73 74 72  c SQLITE_WSD str
1300: 75 63 74 20 50 43 61 63 68 65 47 6c 6f 62 61 6c  uct PCacheGlobal
1310: 20 7b 0a 20 20 50 47 72 6f 75 70 20 67 72 70 3b   {.  PGroup grp;
1320: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1330: 20 20 20 20 2f 2a 20 54 68 65 20 67 6c 6f 62 61      /* The globa
1340: 6c 20 50 47 72 6f 75 70 20 66 6f 72 20 6d 6f 64  l PGroup for mod
1350: 65 20 28 32 29 20 2a 2f 0a 0a 20 20 2f 2a 20 56  e (2) */..  /* V
1360: 61 72 69 61 62 6c 65 73 20 72 65 6c 61 74 65 64  ariables related
1370: 20 74 6f 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49   to SQLITE_CONFI
1380: 47 5f 50 41 47 45 43 41 43 48 45 20 73 65 74 74  G_PAGECACHE sett
1390: 69 6e 67 73 2e 20 20 54 68 65 0a 20 20 2a 2a 20  ings.  The.  ** 
13a0: 73 7a 53 6c 6f 74 2c 20 6e 53 6c 6f 74 2c 20 70  szSlot, nSlot, p
13b0: 53 74 61 72 74 2c 20 70 45 6e 64 2c 20 6e 52 65  Start, pEnd, nRe
13c0: 73 65 72 76 65 2c 20 61 6e 64 20 69 73 49 6e 69  serve, and isIni
13d0: 74 20 76 61 6c 75 65 73 20 61 72 65 20 61 6c 6c  t values are all
13e0: 0a 20 20 2a 2a 20 66 69 78 65 64 20 61 74 20 73  .  ** fixed at s
13f0: 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a  qlite3_initializ
1400: 65 28 29 20 74 69 6d 65 20 61 6e 64 20 64 6f 20  e() time and do 
1410: 6e 6f 74 20 72 65 71 75 69 72 65 20 6d 75 74 65  not require mute
1420: 78 20 70 72 6f 74 65 63 74 69 6f 6e 2e 0a 20 20  x protection..  
1430: 2a 2a 20 54 68 65 20 6e 46 72 65 65 53 6c 6f 74  ** The nFreeSlot
1440: 20 61 6e 64 20 70 46 72 65 65 20 76 61 6c 75 65   and pFree value
1450: 73 20 64 6f 20 72 65 71 75 69 72 65 20 6d 75 74  s do require mut
1460: 65 78 20 70 72 6f 74 65 63 74 69 6f 6e 2e 0a 20  ex protection.. 
1470: 20 2a 2f 0a 20 20 69 6e 74 20 69 73 49 6e 69 74   */.  int isInit
1480: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
1490: 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20       /* True if 
14a0: 69 6e 69 74 69 61 6c 69 7a 65 64 20 2a 2f 0a 20  initialized */. 
14b0: 20 69 6e 74 20 73 7a 53 6c 6f 74 3b 20 20 20 20   int szSlot;    
14c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
14d0: 2f 2a 20 53 69 7a 65 20 6f 66 20 65 61 63 68 20  /* Size of each 
14e0: 66 72 65 65 20 73 6c 6f 74 20 2a 2f 0a 20 20 69  free slot */.  i
14f0: 6e 74 20 6e 53 6c 6f 74 3b 20 20 20 20 20 20 20  nt nSlot;       
1500: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
1510: 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70   The number of p
1520: 63 61 63 68 65 20 73 6c 6f 74 73 20 2a 2f 0a 20  cache slots */. 
1530: 20 69 6e 74 20 6e 52 65 73 65 72 76 65 3b 20 20   int nReserve;  
1540: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1550: 2f 2a 20 54 72 79 20 74 6f 20 6b 65 65 70 20 6e  /* Try to keep n
1560: 46 72 65 65 53 6c 6f 74 20 61 62 6f 76 65 20 74  FreeSlot above t
1570: 68 69 73 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70  his */.  void *p
1580: 53 74 61 72 74 2c 20 2a 70 45 6e 64 3b 20 20 20  Start, *pEnd;   
1590: 20 20 20 20 20 20 20 20 2f 2a 20 42 6f 75 6e 64          /* Bound
15a0: 73 20 6f 66 20 70 61 67 65 63 61 63 68 65 20 6d  s of pagecache m
15b0: 61 6c 6c 6f 63 20 72 61 6e 67 65 20 2a 2f 0a 20  alloc range */. 
15c0: 20 2f 2a 20 41 62 6f 76 65 20 72 65 71 75 69 72   /* Above requir
15d0: 65 73 20 6e 6f 20 6d 75 74 65 78 2e 20 20 55 73  es no mutex.  Us
15e0: 65 20 6d 75 74 65 78 20 62 65 6c 6f 77 20 66 6f  e mutex below fo
15f0: 72 20 76 61 72 69 61 62 6c 65 20 74 68 61 74 20  r variable that 
1600: 66 6f 6c 6c 6f 77 2e 20 2a 2f 0a 20 20 73 71 6c  follow. */.  sql
1610: 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65  ite3_mutex *mute
1620: 78 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d  x;          /* M
1630: 75 74 65 78 20 66 6f 72 20 61 63 63 65 73 73 69  utex for accessi
1640: 6e 67 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  ng the following
1650: 3a 20 2a 2f 0a 20 20 50 67 46 72 65 65 73 6c 6f  : */.  PgFreeslo
1660: 74 20 2a 70 46 72 65 65 3b 20 20 20 20 20 20 20  t *pFree;       
1670: 20 20 20 20 20 20 2f 2a 20 46 72 65 65 20 70 61        /* Free pa
1680: 67 65 20 62 6c 6f 63 6b 73 20 2a 2f 0a 20 20 69  ge blocks */.  i
1690: 6e 74 20 6e 46 72 65 65 53 6c 6f 74 3b 20 20 20  nt nFreeSlot;   
16a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
16b0: 20 4e 75 6d 62 65 72 20 6f 66 20 75 6e 75 73 65   Number of unuse
16c0: 64 20 70 63 61 63 68 65 20 73 6c 6f 74 73 20 2a  d pcache slots *
16d0: 2f 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f  /.  /* The follo
16e0: 77 69 6e 67 20 76 61 6c 75 65 20 72 65 71 75 69  wing value requi
16f0: 72 65 73 20 61 20 6d 75 74 65 78 20 74 6f 20 63  res a mutex to c
1700: 68 61 6e 67 65 2e 20 20 57 65 20 73 6b 69 70 20  hange.  We skip 
1710: 74 68 65 20 6d 75 74 65 78 20 6f 6e 0a 20 20 2a  the mutex on.  *
1720: 2a 20 72 65 61 64 69 6e 67 20 62 65 63 61 75 73  * reading becaus
1730: 65 20 28 31 29 20 6d 6f 73 74 20 70 6c 61 74 66  e (1) most platf
1740: 6f 72 6d 73 20 72 65 61 64 20 61 20 33 32 2d 62  orms read a 32-b
1750: 69 74 20 69 6e 74 65 67 65 72 20 61 74 6f 6d 69  it integer atomi
1760: 63 61 6c 6c 79 20 61 6e 64 0a 20 20 2a 2a 20 28  cally and.  ** (
1770: 32 29 20 65 76 65 6e 20 69 66 20 61 6e 20 69 6e  2) even if an in
1780: 63 6f 72 72 65 63 74 20 76 61 6c 75 65 20 69 73  correct value is
1790: 20 72 65 61 64 2c 20 6e 6f 20 67 72 65 61 74 20   read, no great 
17a0: 68 61 72 6d 20 69 73 20 64 6f 6e 65 20 73 69 6e  harm is done sin
17b0: 63 65 20 74 68 69 73 0a 20 20 2a 2a 20 69 73 20  ce this.  ** is 
17c0: 72 65 61 6c 6c 79 20 6a 75 73 74 20 61 6e 20 6f  really just an o
17d0: 70 74 69 6d 69 7a 61 74 69 6f 6e 2e 20 2a 2f 0a  ptimization. */.
17e0: 20 20 69 6e 74 20 62 55 6e 64 65 72 50 72 65 73    int bUnderPres
17f0: 73 75 72 65 3b 20 20 20 20 20 20 20 20 20 20 20  sure;           
1800: 20 2f 2a 20 54 72 75 65 20 69 66 20 6c 6f 77 20   /* True if low 
1810: 6f 6e 20 50 41 47 45 43 41 43 48 45 20 6d 65 6d  on PAGECACHE mem
1820: 6f 72 79 20 2a 2f 0a 7d 20 70 63 61 63 68 65 31  ory */.} pcache1
1830: 5f 67 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 20 63  _g;../*.** All c
1840: 6f 64 65 20 69 6e 20 74 68 69 73 20 66 69 6c 65  ode in this file
1850: 20 73 68 6f 75 6c 64 20 61 63 63 65 73 73 20 74   should access t
1860: 68 65 20 67 6c 6f 62 61 6c 20 73 74 72 75 63 74  he global struct
1870: 75 72 65 20 61 62 6f 76 65 20 76 69 61 20 74 68  ure above via th
1880: 65 0a 2a 2a 20 61 6c 69 61 73 20 22 70 63 61 63  e.** alias "pcac
1890: 68 65 31 22 2e 20 54 68 69 73 20 65 6e 73 75 72  he1". This ensur
18a0: 65 73 20 74 68 61 74 20 74 68 65 20 57 53 44 20  es that the WSD 
18b0: 65 6d 75 6c 61 74 69 6f 6e 20 69 73 20 75 73 65  emulation is use
18c0: 64 20 77 68 65 6e 0a 2a 2a 20 63 6f 6d 70 69 6c  d when.** compil
18d0: 69 6e 67 20 66 6f 72 20 73 79 73 74 65 6d 73 20  ing for systems 
18e0: 74 68 61 74 20 64 6f 20 6e 6f 74 20 73 75 70 70  that do not supp
18f0: 6f 72 74 20 72 65 61 6c 20 57 53 44 2e 0a 2a 2f  ort real WSD..*/
1900: 0a 23 64 65 66 69 6e 65 20 70 63 61 63 68 65 31  .#define pcache1
1910: 20 28 47 4c 4f 42 41 4c 28 73 74 72 75 63 74 20   (GLOBAL(struct 
1920: 50 43 61 63 68 65 47 6c 6f 62 61 6c 2c 20 70 63  PCacheGlobal, pc
1930: 61 63 68 65 31 5f 67 29 29 0a 0a 2f 2a 0a 2a 2a  ache1_g))../*.**
1940: 20 4d 61 63 72 6f 73 20 74 6f 20 65 6e 74 65 72   Macros to enter
1950: 20 61 6e 64 20 6c 65 61 76 65 20 74 68 65 20 50   and leave the P
1960: 43 61 63 68 65 20 4c 52 55 20 6d 75 74 65 78 2e  Cache LRU mutex.
1970: 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 70 63 61 63  .*/.#define pcac
1980: 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 58 29  he1EnterMutex(X)
1990: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65   sqlite3_mutex_e
19a0: 6e 74 65 72 28 28 58 29 2d 3e 6d 75 74 65 78 29  nter((X)->mutex)
19b0: 0a 23 64 65 66 69 6e 65 20 70 63 61 63 68 65 31  .#define pcache1
19c0: 4c 65 61 76 65 4d 75 74 65 78 28 58 29 20 73 71  LeaveMutex(X) sq
19d0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76  lite3_mutex_leav
19e0: 65 28 28 58 29 2d 3e 6d 75 74 65 78 29 0a 0a 2f  e((X)->mutex)../
19f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a00: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a10: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a20: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a30: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a  **************/.
1a40: 2f 2a 2a 2a 2a 2a 2a 2a 2a 20 50 61 67 65 20 41  /******** Page A
1a50: 6c 6c 6f 63 61 74 69 6f 6e 2f 53 51 4c 49 54 45  llocation/SQLITE
1a60: 5f 43 4f 4e 46 49 47 5f 50 43 41 43 48 45 20 52  _CONFIG_PCACHE R
1a70: 65 6c 61 74 65 64 20 46 75 6e 63 74 69 6f 6e 73  elated Functions
1a80: 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f   **************/
1a90: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e  ../*.** This fun
1aa0: 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20  ction is called 
1ab0: 64 75 72 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a  during initializ
1ac0: 61 74 69 6f 6e 20 69 66 20 61 20 73 74 61 74 69  ation if a stati
1ad0: 63 20 62 75 66 66 65 72 20 69 73 20 0a 2a 2a 20  c buffer is .** 
1ae0: 73 75 70 70 6c 69 65 64 20 74 6f 20 75 73 65 20  supplied to use 
1af0: 66 6f 72 20 74 68 65 20 70 61 67 65 2d 63 61 63  for the page-cac
1b00: 68 65 20 62 79 20 70 61 73 73 69 6e 67 20 74 68  he by passing th
1b10: 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f  e SQLITE_CONFIG_
1b20: 50 41 47 45 43 41 43 48 45 0a 2a 2a 20 76 65 72  PAGECACHE.** ver
1b30: 62 20 74 6f 20 73 71 6c 69 74 65 33 5f 63 6f 6e  b to sqlite3_con
1b40: 66 69 67 28 29 2e 20 50 61 72 61 6d 65 74 65 72  fig(). Parameter
1b50: 20 70 42 75 66 20 70 6f 69 6e 74 73 20 74 6f 20   pBuf points to 
1b60: 61 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 6c 61  an allocation la
1b70: 72 67 65 0a 2a 2a 20 65 6e 6f 75 67 68 20 74 6f  rge.** enough to
1b80: 20 63 6f 6e 74 61 69 6e 20 27 6e 27 20 62 75 66   contain 'n' buf
1b90: 66 65 72 73 20 6f 66 20 27 73 7a 27 20 62 79 74  fers of 'sz' byt
1ba0: 65 73 20 65 61 63 68 2e 0a 2a 2a 0a 2a 2a 20 54  es each..**.** T
1bb0: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63  his routine is c
1bc0: 61 6c 6c 65 64 20 66 72 6f 6d 20 73 71 6c 69 74  alled from sqlit
1bd0: 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 20  e3_initialize() 
1be0: 61 6e 64 20 73 6f 20 69 74 20 69 73 20 67 75 61  and so it is gua
1bf0: 72 61 6e 74 65 65 64 0a 2a 2a 20 74 6f 20 62 65  ranteed.** to be
1c00: 20 73 65 72 69 61 6c 69 7a 65 64 20 61 6c 72 65   serialized alre
1c10: 61 64 79 2e 20 20 54 68 65 72 65 20 69 73 20 6e  ady.  There is n
1c20: 6f 20 6e 65 65 64 20 66 6f 72 20 66 75 72 74 68  o need for furth
1c30: 65 72 20 6d 75 74 65 78 69 6e 67 2e 0a 2a 2f 0a  er mutexing..*/.
1c40: 76 6f 69 64 20 73 71 6c 69 74 65 33 50 43 61 63  void sqlite3PCac
1c50: 68 65 42 75 66 66 65 72 53 65 74 75 70 28 76 6f  heBufferSetup(vo
1c60: 69 64 20 2a 70 42 75 66 2c 20 69 6e 74 20 73 7a  id *pBuf, int sz
1c70: 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 69 66 28 20  , int n){.  if( 
1c80: 70 63 61 63 68 65 31 2e 69 73 49 6e 69 74 20 29  pcache1.isInit )
1c90: 7b 0a 20 20 20 20 50 67 46 72 65 65 73 6c 6f 74  {.    PgFreeslot
1ca0: 20 2a 70 3b 0a 20 20 20 20 73 7a 20 3d 20 52 4f   *p;.    sz = RO
1cb0: 55 4e 44 44 4f 57 4e 38 28 73 7a 29 3b 0a 20 20  UNDDOWN8(sz);.  
1cc0: 20 20 70 63 61 63 68 65 31 2e 73 7a 53 6c 6f 74    pcache1.szSlot
1cd0: 20 3d 20 73 7a 3b 0a 20 20 20 20 70 63 61 63 68   = sz;.    pcach
1ce0: 65 31 2e 6e 53 6c 6f 74 20 3d 20 70 63 61 63 68  e1.nSlot = pcach
1cf0: 65 31 2e 6e 46 72 65 65 53 6c 6f 74 20 3d 20 6e  e1.nFreeSlot = n
1d00: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 6e 52  ;.    pcache1.nR
1d10: 65 73 65 72 76 65 20 3d 20 6e 3e 39 30 20 3f 20  eserve = n>90 ? 
1d20: 31 30 20 3a 20 28 6e 2f 31 30 20 2b 20 31 29 3b  10 : (n/10 + 1);
1d30: 0a 20 20 20 20 70 63 61 63 68 65 31 2e 70 53 74  .    pcache1.pSt
1d40: 61 72 74 20 3d 20 70 42 75 66 3b 0a 20 20 20 20  art = pBuf;.    
1d50: 70 63 61 63 68 65 31 2e 70 46 72 65 65 20 3d 20  pcache1.pFree = 
1d60: 30 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 62  0;.    pcache1.b
1d70: 55 6e 64 65 72 50 72 65 73 73 75 72 65 20 3d 20  UnderPressure = 
1d80: 30 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 6e 2d  0;.    while( n-
1d90: 2d 20 29 7b 0a 20 20 20 20 20 20 70 20 3d 20 28  - ){.      p = (
1da0: 50 67 46 72 65 65 73 6c 6f 74 2a 29 70 42 75 66  PgFreeslot*)pBuf
1db0: 3b 0a 20 20 20 20 20 20 70 2d 3e 70 4e 65 78 74  ;.      p->pNext
1dc0: 20 3d 20 70 63 61 63 68 65 31 2e 70 46 72 65 65   = pcache1.pFree
1dd0: 3b 0a 20 20 20 20 20 20 70 63 61 63 68 65 31 2e  ;.      pcache1.
1de0: 70 46 72 65 65 20 3d 20 70 3b 0a 20 20 20 20 20  pFree = p;.     
1df0: 20 70 42 75 66 20 3d 20 28 76 6f 69 64 2a 29 26   pBuf = (void*)&
1e00: 28 28 63 68 61 72 2a 29 70 42 75 66 29 5b 73 7a  ((char*)pBuf)[sz
1e10: 5d 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 63 61  ];.    }.    pca
1e20: 63 68 65 31 2e 70 45 6e 64 20 3d 20 70 42 75 66  che1.pEnd = pBuf
1e30: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d  ;.  }.}../*.** M
1e40: 61 6c 6c 6f 63 20 66 75 6e 63 74 69 6f 6e 20 75  alloc function u
1e50: 73 65 64 20 77 69 74 68 69 6e 20 74 68 69 73 20  sed within this 
1e60: 66 69 6c 65 20 74 6f 20 61 6c 6c 6f 63 61 74 65  file to allocate
1e70: 20 73 70 61 63 65 20 66 72 6f 6d 20 74 68 65 20   space from the 
1e80: 62 75 66 66 65 72 0a 2a 2a 20 63 6f 6e 66 69 67  buffer.** config
1e90: 75 72 65 64 20 75 73 69 6e 67 20 73 71 6c 69 74  ured using sqlit
1ea0: 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54 45  e3_config(SQLITE
1eb0: 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48  _CONFIG_PAGECACH
1ec0: 45 29 20 6f 70 74 69 6f 6e 2e 20 49 66 20 6e 6f  E) option. If no
1ed0: 20 0a 2a 2a 20 73 75 63 68 20 62 75 66 66 65 72   .** such buffer
1ee0: 20 65 78 69 73 74 73 20 6f 72 20 74 68 65 72 65   exists or there
1ef0: 20 69 73 20 6e 6f 20 73 70 61 63 65 20 6c 65 66   is no space lef
1f00: 74 20 69 6e 20 69 74 2c 20 74 68 69 73 20 66 75  t in it, this fu
1f10: 6e 63 74 69 6f 6e 20 66 61 6c 6c 73 20 0a 2a 2a  nction falls .**
1f20: 20 62 61 63 6b 20 74 6f 20 73 71 6c 69 74 65 33   back to sqlite3
1f30: 4d 61 6c 6c 6f 63 28 29 2e 0a 2a 2a 0a 2a 2a 20  Malloc()..**.** 
1f40: 4d 75 6c 74 69 70 6c 65 20 74 68 72 65 61 64 73  Multiple threads
1f50: 20 63 61 6e 20 72 75 6e 20 74 68 69 73 20 72 6f   can run this ro
1f60: 75 74 69 6e 65 20 61 74 20 74 68 65 20 73 61 6d  utine at the sam
1f70: 65 20 74 69 6d 65 2e 20 20 47 6c 6f 62 61 6c 20  e time.  Global 
1f80: 76 61 72 69 61 62 6c 65 73 0a 2a 2a 20 69 6e 20  variables.** in 
1f90: 70 63 61 63 68 65 31 20 6e 65 65 64 20 74 6f 20  pcache1 need to 
1fa0: 62 65 20 70 72 6f 74 65 63 74 65 64 20 76 69 61  be protected via
1fb0: 20 6d 75 74 65 78 2e 0a 2a 2f 0a 73 74 61 74 69   mutex..*/.stati
1fc0: 63 20 76 6f 69 64 20 2a 70 63 61 63 68 65 31 41  c void *pcache1A
1fd0: 6c 6c 6f 63 28 69 6e 74 20 6e 42 79 74 65 29 7b  lloc(int nByte){
1fe0: 0a 20 20 76 6f 69 64 20 2a 70 20 3d 20 30 3b 0a  .  void *p = 0;.
1ff0: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
2000: 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c 64 28  3_mutex_notheld(
2010: 70 63 61 63 68 65 31 2e 67 72 70 2e 6d 75 74 65  pcache1.grp.mute
2020: 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 53  x) );.  sqlite3S
2030: 74 61 74 75 73 53 65 74 28 53 51 4c 49 54 45 5f  tatusSet(SQLITE_
2040: 53 54 41 54 55 53 5f 50 41 47 45 43 41 43 48 45  STATUS_PAGECACHE
2050: 5f 53 49 5a 45 2c 20 6e 42 79 74 65 29 3b 0a 20  _SIZE, nByte);. 
2060: 20 69 66 28 20 6e 42 79 74 65 3c 3d 70 63 61 63   if( nByte<=pcac
2070: 68 65 31 2e 73 7a 53 6c 6f 74 20 29 7b 0a 20 20  he1.szSlot ){.  
2080: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f    sqlite3_mutex_
2090: 65 6e 74 65 72 28 70 63 61 63 68 65 31 2e 6d 75  enter(pcache1.mu
20a0: 74 65 78 29 3b 0a 20 20 20 20 70 20 3d 20 28 50  tex);.    p = (P
20b0: 67 48 64 72 31 20 2a 29 70 63 61 63 68 65 31 2e  gHdr1 *)pcache1.
20c0: 70 46 72 65 65 3b 0a 20 20 20 20 69 66 28 20 70  pFree;.    if( p
20d0: 20 29 7b 0a 20 20 20 20 20 20 70 63 61 63 68 65   ){.      pcache
20e0: 31 2e 70 46 72 65 65 20 3d 20 70 63 61 63 68 65  1.pFree = pcache
20f0: 31 2e 70 46 72 65 65 2d 3e 70 4e 65 78 74 3b 0a  1.pFree->pNext;.
2100: 20 20 20 20 20 20 70 63 61 63 68 65 31 2e 6e 46        pcache1.nF
2110: 72 65 65 53 6c 6f 74 2d 2d 3b 0a 20 20 20 20 20  reeSlot--;.     
2120: 20 70 63 61 63 68 65 31 2e 62 55 6e 64 65 72 50   pcache1.bUnderP
2130: 72 65 73 73 75 72 65 20 3d 20 70 63 61 63 68 65  ressure = pcache
2140: 31 2e 6e 46 72 65 65 53 6c 6f 74 3c 70 63 61 63  1.nFreeSlot<pcac
2150: 68 65 31 2e 6e 52 65 73 65 72 76 65 3b 0a 20 20  he1.nReserve;.  
2160: 20 20 20 20 61 73 73 65 72 74 28 20 70 63 61 63      assert( pcac
2170: 68 65 31 2e 6e 46 72 65 65 53 6c 6f 74 3e 3d 30  he1.nFreeSlot>=0
2180: 20 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   );.      sqlite
2190: 33 53 74 61 74 75 73 41 64 64 28 53 51 4c 49 54  3StatusAdd(SQLIT
21a0: 45 5f 53 54 41 54 55 53 5f 50 41 47 45 43 41 43  E_STATUS_PAGECAC
21b0: 48 45 5f 55 53 45 44 2c 20 31 29 3b 0a 20 20 20  HE_USED, 1);.   
21c0: 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d   }.    sqlite3_m
21d0: 75 74 65 78 5f 6c 65 61 76 65 28 70 63 61 63 68  utex_leave(pcach
21e0: 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 20  e1.mutex);.  }. 
21f0: 20 69 66 28 20 70 3d 3d 30 20 29 7b 0a 20 20 20   if( p==0 ){.   
2200: 20 2f 2a 20 4d 65 6d 6f 72 79 20 69 73 20 6e 6f   /* Memory is no
2210: 74 20 61 76 61 69 6c 61 62 6c 65 20 69 6e 20 74  t available in t
2220: 68 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47  he SQLITE_CONFIG
2230: 5f 50 41 47 45 43 41 43 48 45 20 70 6f 6f 6c 2e  _PAGECACHE pool.
2240: 20 20 47 65 74 0a 20 20 20 20 2a 2a 20 69 74 20    Get.    ** it 
2250: 66 72 6f 6d 20 73 71 6c 69 74 65 33 4d 61 6c 6c  from sqlite3Mall
2260: 6f 63 20 69 6e 73 74 65 61 64 2e 0a 20 20 20 20  oc instead..    
2270: 2a 2f 0a 20 20 20 20 70 20 3d 20 73 71 6c 69 74  */.    p = sqlit
2280: 65 33 4d 61 6c 6c 6f 63 28 6e 42 79 74 65 29 3b  e3Malloc(nByte);
2290: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
22a0: 44 49 53 41 42 4c 45 5f 50 41 47 45 43 41 43 48  DISABLE_PAGECACH
22b0: 45 5f 4f 56 45 52 46 4c 4f 57 5f 53 54 41 54 53  E_OVERFLOW_STATS
22c0: 0a 20 20 20 20 69 66 28 20 70 20 29 7b 0a 20 20  .    if( p ){.  
22d0: 20 20 20 20 69 6e 74 20 73 7a 20 3d 20 73 71 6c      int sz = sql
22e0: 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70  ite3MallocSize(p
22f0: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  );.      sqlite3
2300: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 63 61  _mutex_enter(pca
2310: 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20 20  che1.mutex);.   
2320: 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73     sqlite3Status
2330: 41 64 64 28 53 51 4c 49 54 45 5f 53 54 41 54 55  Add(SQLITE_STATU
2340: 53 5f 50 41 47 45 43 41 43 48 45 5f 4f 56 45 52  S_PAGECACHE_OVER
2350: 46 4c 4f 57 2c 20 73 7a 29 3b 0a 20 20 20 20 20  FLOW, sz);.     
2360: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c   sqlite3_mutex_l
2370: 65 61 76 65 28 70 63 61 63 68 65 31 2e 6d 75 74  eave(pcache1.mut
2380: 65 78 29 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69  ex);.    }.#endi
2390: 66 0a 20 20 20 20 73 71 6c 69 74 65 33 4d 65 6d  f.    sqlite3Mem
23a0: 64 65 62 75 67 53 65 74 54 79 70 65 28 70 2c 20  debugSetType(p, 
23b0: 4d 45 4d 54 59 50 45 5f 50 43 41 43 48 45 29 3b  MEMTYPE_PCACHE);
23c0: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 3b  .  }.  return p;
23d0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 61  .}../*.** Free a
23e0: 6e 20 61 6c 6c 6f 63 61 74 65 64 20 62 75 66 66  n allocated buff
23f0: 65 72 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d  er obtained from
2400: 20 70 63 61 63 68 65 31 41 6c 6c 6f 63 28 29 2e   pcache1Alloc().
2410: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70  .*/.static int p
2420: 63 61 63 68 65 31 46 72 65 65 28 76 6f 69 64 20  cache1Free(void 
2430: 2a 70 29 7b 0a 20 20 69 6e 74 20 6e 46 72 65 65  *p){.  int nFree
2440: 64 20 3d 20 30 3b 0a 20 20 69 66 28 20 70 3d 3d  d = 0;.  if( p==
2450: 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20  0 ) return 0;.  
2460: 69 66 28 20 70 3e 3d 70 63 61 63 68 65 31 2e 70  if( p>=pcache1.p
2470: 53 74 61 72 74 20 26 26 20 70 3c 70 63 61 63 68  Start && p<pcach
2480: 65 31 2e 70 45 6e 64 20 29 7b 0a 20 20 20 20 50  e1.pEnd ){.    P
2490: 67 46 72 65 65 73 6c 6f 74 20 2a 70 53 6c 6f 74  gFreeslot *pSlot
24a0: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75  ;.    sqlite3_mu
24b0: 74 65 78 5f 65 6e 74 65 72 28 70 63 61 63 68 65  tex_enter(pcache
24c0: 31 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 73 71  1.mutex);.    sq
24d0: 6c 69 74 65 33 53 74 61 74 75 73 41 64 64 28 53  lite3StatusAdd(S
24e0: 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 50 41 47  QLITE_STATUS_PAG
24f0: 45 43 41 43 48 45 5f 55 53 45 44 2c 20 2d 31 29  ECACHE_USED, -1)
2500: 3b 0a 20 20 20 20 70 53 6c 6f 74 20 3d 20 28 50  ;.    pSlot = (P
2510: 67 46 72 65 65 73 6c 6f 74 2a 29 70 3b 0a 20 20  gFreeslot*)p;.  
2520: 20 20 70 53 6c 6f 74 2d 3e 70 4e 65 78 74 20 3d    pSlot->pNext =
2530: 20 70 63 61 63 68 65 31 2e 70 46 72 65 65 3b 0a   pcache1.pFree;.
2540: 20 20 20 20 70 63 61 63 68 65 31 2e 70 46 72 65      pcache1.pFre
2550: 65 20 3d 20 70 53 6c 6f 74 3b 0a 20 20 20 20 70  e = pSlot;.    p
2560: 63 61 63 68 65 31 2e 6e 46 72 65 65 53 6c 6f 74  cache1.nFreeSlot
2570: 2b 2b 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e  ++;.    pcache1.
2580: 62 55 6e 64 65 72 50 72 65 73 73 75 72 65 20 3d  bUnderPressure =
2590: 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65 53 6c   pcache1.nFreeSl
25a0: 6f 74 3c 70 63 61 63 68 65 31 2e 6e 52 65 73 65  ot<pcache1.nRese
25b0: 72 76 65 3b 0a 20 20 20 20 61 73 73 65 72 74 28  rve;.    assert(
25c0: 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65 53 6c   pcache1.nFreeSl
25d0: 6f 74 3c 3d 70 63 61 63 68 65 31 2e 6e 53 6c 6f  ot<=pcache1.nSlo
25e0: 74 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  t );.    sqlite3
25f0: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 63 61  _mutex_leave(pca
2600: 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20 7d  che1.mutex);.  }
2610: 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 72 74  else{.    assert
2620: 28 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75  ( sqlite3Memdebu
2630: 67 48 61 73 54 79 70 65 28 70 2c 20 4d 45 4d 54  gHasType(p, MEMT
2640: 59 50 45 5f 50 43 41 43 48 45 29 20 29 3b 0a 20  YPE_PCACHE) );. 
2650: 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62     sqlite3Memdeb
2660: 75 67 53 65 74 54 79 70 65 28 70 2c 20 4d 45 4d  ugSetType(p, MEM
2670: 54 59 50 45 5f 48 45 41 50 29 3b 0a 20 20 20 20  TYPE_HEAP);.    
2680: 6e 46 72 65 65 64 20 3d 20 73 71 6c 69 74 65 33  nFreed = sqlite3
2690: 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 29 3b 0a 23  MallocSize(p);.#
26a0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 49  ifndef SQLITE_DI
26b0: 53 41 42 4c 45 5f 50 41 47 45 43 41 43 48 45 5f  SABLE_PAGECACHE_
26c0: 4f 56 45 52 46 4c 4f 57 5f 53 54 41 54 53 0a 20  OVERFLOW_STATS. 
26d0: 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78     sqlite3_mutex
26e0: 5f 65 6e 74 65 72 28 70 63 61 63 68 65 31 2e 6d  _enter(pcache1.m
26f0: 75 74 65 78 29 3b 0a 20 20 20 20 73 71 6c 69 74  utex);.    sqlit
2700: 65 33 53 74 61 74 75 73 41 64 64 28 53 51 4c 49  e3StatusAdd(SQLI
2710: 54 45 5f 53 54 41 54 55 53 5f 50 41 47 45 43 41  TE_STATUS_PAGECA
2720: 43 48 45 5f 4f 56 45 52 46 4c 4f 57 2c 20 2d 6e  CHE_OVERFLOW, -n
2730: 46 72 65 65 64 29 3b 0a 20 20 20 20 73 71 6c 69  Freed);.    sqli
2740: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
2750: 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a  pcache1.mutex);.
2760: 23 65 6e 64 69 66 0a 20 20 20 20 73 71 6c 69 74  #endif.    sqlit
2770: 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 7d 0a  e3_free(p);.  }.
2780: 20 20 72 65 74 75 72 6e 20 6e 46 72 65 65 64 3b    return nFreed;
2790: 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54  .}..#ifdef SQLIT
27a0: 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f  E_ENABLE_MEMORY_
27b0: 4d 41 4e 41 47 45 4d 45 4e 54 0a 2f 2a 0a 2a 2a  MANAGEMENT./*.**
27c0: 20 52 65 74 75 72 6e 20 74 68 65 20 73 69 7a 65   Return the size
27d0: 20 6f 66 20 61 20 70 63 61 63 68 65 20 61 6c 6c   of a pcache all
27e0: 6f 63 61 74 69 6f 6e 0a 2a 2f 0a 73 74 61 74 69  ocation.*/.stati
27f0: 63 20 69 6e 74 20 70 63 61 63 68 65 31 4d 65 6d  c int pcache1Mem
2800: 53 69 7a 65 28 76 6f 69 64 20 2a 70 29 7b 0a 20  Size(void *p){. 
2810: 20 69 66 28 20 70 3e 3d 70 63 61 63 68 65 31 2e   if( p>=pcache1.
2820: 70 53 74 61 72 74 20 26 26 20 70 3c 70 63 61 63  pStart && p<pcac
2830: 68 65 31 2e 70 45 6e 64 20 29 7b 0a 20 20 20 20  he1.pEnd ){.    
2840: 72 65 74 75 72 6e 20 70 63 61 63 68 65 31 2e 73  return pcache1.s
2850: 7a 53 6c 6f 74 3b 0a 20 20 7d 65 6c 73 65 7b 0a  zSlot;.  }else{.
2860: 20 20 20 20 69 6e 74 20 69 53 69 7a 65 3b 0a 20      int iSize;. 
2870: 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74     assert( sqlit
2880: 65 33 4d 65 6d 64 65 62 75 67 48 61 73 54 79 70  e3MemdebugHasTyp
2890: 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 50 43 41  e(p, MEMTYPE_PCA
28a0: 43 48 45 29 20 29 3b 0a 20 20 20 20 73 71 6c 69  CHE) );.    sqli
28b0: 74 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79  te3MemdebugSetTy
28c0: 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 48 45  pe(p, MEMTYPE_HE
28d0: 41 50 29 3b 0a 20 20 20 20 69 53 69 7a 65 20 3d  AP);.    iSize =
28e0: 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69   sqlite3MallocSi
28f0: 7a 65 28 70 29 3b 0a 20 20 20 20 73 71 6c 69 74  ze(p);.    sqlit
2900: 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70  e3MemdebugSetTyp
2910: 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 50 43 41  e(p, MEMTYPE_PCA
2920: 43 48 45 29 3b 0a 20 20 20 20 72 65 74 75 72 6e  CHE);.    return
2930: 20 69 53 69 7a 65 3b 0a 20 20 7d 0a 7d 0a 23 65   iSize;.  }.}.#e
2940: 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45  ndif /* SQLITE_E
2950: 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e  NABLE_MEMORY_MAN
2960: 41 47 45 4d 45 4e 54 20 2a 2f 0a 0a 2f 2a 0a 2a  AGEMENT */../*.*
2970: 2a 20 41 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77  * Allocate a new
2980: 20 70 61 67 65 20 6f 62 6a 65 63 74 20 69 6e 69   page object ini
2990: 74 69 61 6c 6c 79 20 61 73 73 6f 63 69 61 74 65  tially associate
29a0: 64 20 77 69 74 68 20 63 61 63 68 65 20 70 43 61  d with cache pCa
29b0: 63 68 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50  che..*/.static P
29c0: 67 48 64 72 31 20 2a 70 63 61 63 68 65 31 41 6c  gHdr1 *pcache1Al
29d0: 6c 6f 63 50 61 67 65 28 50 43 61 63 68 65 31 20  locPage(PCache1 
29e0: 2a 70 43 61 63 68 65 29 7b 0a 20 20 50 67 48 64  *pCache){.  PgHd
29f0: 72 31 20 2a 70 20 3d 20 30 3b 0a 20 20 76 6f 69  r1 *p = 0;.  voi
2a00: 64 20 2a 70 50 67 3b 0a 0a 20 20 2f 2a 20 54 68  d *pPg;..  /* Th
2a10: 65 20 67 72 6f 75 70 20 6d 75 74 65 78 20 6d 75  e group mutex mu
2a20: 73 74 20 62 65 20 72 65 6c 65 61 73 65 64 20 62  st be released b
2a30: 65 66 6f 72 65 20 70 63 61 63 68 65 31 41 6c 6c  efore pcache1All
2a40: 6f 63 28 29 20 69 73 20 63 61 6c 6c 65 64 2e 20  oc() is called. 
2a50: 54 68 69 73 0a 20 20 2a 2a 20 69 73 20 62 65 63  This.  ** is bec
2a60: 61 75 73 65 20 69 74 20 6d 61 79 20 63 61 6c 6c  ause it may call
2a70: 20 73 71 6c 69 74 65 33 5f 72 65 6c 65 61 73 65   sqlite3_release
2a80: 5f 6d 65 6d 6f 72 79 28 29 2c 20 77 68 69 63 68  _memory(), which
2a90: 20 61 73 73 75 6d 65 73 20 74 68 61 74 20 0a 20   assumes that . 
2aa0: 20 2a 2a 20 74 68 69 73 20 6d 75 74 65 78 20 69   ** this mutex i
2ab0: 73 20 6e 6f 74 20 68 65 6c 64 2e 20 2a 2f 0a 20  s not held. */. 
2ac0: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
2ad0: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 61 63  _mutex_held(pCac
2ae0: 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65  he->pGroup->mute
2af0: 78 29 20 29 3b 0a 20 20 70 63 61 63 68 65 31 4c  x) );.  pcache1L
2b00: 65 61 76 65 4d 75 74 65 78 28 70 43 61 63 68 65  eaveMutex(pCache
2b10: 2d 3e 70 47 72 6f 75 70 29 3b 0a 23 69 66 64 65  ->pGroup);.#ifde
2b20: 66 20 53 51 4c 49 54 45 5f 50 43 41 43 48 45 5f  f SQLITE_PCACHE_
2b30: 53 45 50 41 52 41 54 45 5f 48 45 41 44 45 52 0a  SEPARATE_HEADER.
2b40: 20 20 70 50 67 20 3d 20 70 63 61 63 68 65 31 41    pPg = pcache1A
2b50: 6c 6c 6f 63 28 70 43 61 63 68 65 2d 3e 73 7a 50  lloc(pCache->szP
2b60: 61 67 65 29 3b 0a 20 20 70 20 3d 20 73 71 6c 69  age);.  p = sqli
2b70: 74 65 33 4d 61 6c 6c 6f 63 28 73 69 7a 65 6f 66  te3Malloc(sizeof
2b80: 28 50 67 48 64 72 31 29 20 2b 20 70 43 61 63 68  (PgHdr1) + pCach
2b90: 65 2d 3e 73 7a 45 78 74 72 61 29 3b 0a 20 20 69  e->szExtra);.  i
2ba0: 66 28 20 21 70 50 67 20 7c 7c 20 21 70 20 29 7b  f( !pPg || !p ){
2bb0: 0a 20 20 20 20 70 63 61 63 68 65 31 46 72 65 65  .    pcache1Free
2bc0: 28 70 50 67 29 3b 0a 20 20 20 20 73 71 6c 69 74  (pPg);.    sqlit
2bd0: 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 20 20  e3_free(p);.    
2be0: 70 50 67 20 3d 20 30 3b 0a 20 20 7d 0a 23 65 6c  pPg = 0;.  }.#el
2bf0: 73 65 0a 20 20 70 50 67 20 3d 20 70 63 61 63 68  se.  pPg = pcach
2c00: 65 31 41 6c 6c 6f 63 28 73 69 7a 65 6f 66 28 50  e1Alloc(sizeof(P
2c10: 67 48 64 72 31 29 20 2b 20 70 43 61 63 68 65 2d  gHdr1) + pCache-
2c20: 3e 73 7a 50 61 67 65 20 2b 20 70 43 61 63 68 65  >szPage + pCache
2c30: 2d 3e 73 7a 45 78 74 72 61 29 3b 0a 20 20 70 20  ->szExtra);.  p 
2c40: 3d 20 28 50 67 48 64 72 31 20 2a 29 26 28 28 75  = (PgHdr1 *)&((u
2c50: 38 20 2a 29 70 50 67 29 5b 70 43 61 63 68 65 2d  8 *)pPg)[pCache-
2c60: 3e 73 7a 50 61 67 65 5d 3b 0a 23 65 6e 64 69 66  >szPage];.#endif
2c70: 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d  .  pcache1EnterM
2c80: 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72  utex(pCache->pGr
2c90: 6f 75 70 29 3b 0a 0a 20 20 69 66 28 20 70 50 67  oup);..  if( pPg
2ca0: 20 29 7b 0a 20 20 20 20 70 2d 3e 70 61 67 65 2e   ){.    p->page.
2cb0: 70 42 75 66 20 3d 20 70 50 67 3b 0a 20 20 20 20  pBuf = pPg;.    
2cc0: 70 2d 3e 70 61 67 65 2e 70 45 78 74 72 61 20 3d  p->page.pExtra =
2cd0: 20 26 70 5b 31 5d 3b 0a 20 20 20 20 69 66 28 20   &p[1];.    if( 
2ce0: 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62  pCache->bPurgeab
2cf0: 6c 65 20 29 7b 0a 20 20 20 20 20 20 70 43 61 63  le ){.      pCac
2d00: 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6e 43 75 72  he->pGroup->nCur
2d10: 72 65 6e 74 50 61 67 65 2b 2b 3b 0a 20 20 20 20  rentPage++;.    
2d20: 7d 0a 20 20 20 20 72 65 74 75 72 6e 20 70 3b 0a  }.    return p;.
2d30: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a    }.  return 0;.
2d40: 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 20  }../*.** Free a 
2d50: 70 61 67 65 20 6f 62 6a 65 63 74 20 61 6c 6c 6f  page object allo
2d60: 63 61 74 65 64 20 62 79 20 70 63 61 63 68 65 31  cated by pcache1
2d70: 41 6c 6c 6f 63 50 61 67 65 28 29 2e 0a 2a 2a 0a  AllocPage()..**.
2d80: 2a 2a 20 54 68 65 20 70 6f 69 6e 74 65 72 20 69  ** The pointer i
2d90: 73 20 61 6c 6c 6f 77 65 64 20 74 6f 20 62 65 20  s allowed to be 
2da0: 4e 55 4c 4c 2c 20 77 68 69 63 68 20 69 73 20 70  NULL, which is p
2db0: 72 75 64 65 6e 74 2e 20 20 42 75 74 20 69 74 20  rudent.  But it 
2dc0: 74 75 72 6e 73 20 6f 75 74 0a 2a 2a 20 74 68 61  turns out.** tha
2dd0: 74 20 74 68 65 20 63 75 72 72 65 6e 74 20 69 6d  t the current im
2de0: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 68 61 70  plementation hap
2df0: 70 65 6e 73 20 74 6f 20 6e 65 76 65 72 20 63 61  pens to never ca
2e00: 6c 6c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 0a  ll this routine.
2e10: 2a 2a 20 77 69 74 68 20 61 20 4e 55 4c 4c 20 70  ** with a NULL p
2e20: 6f 69 6e 74 65 72 2c 20 73 6f 20 77 65 20 6d 61  ointer, so we ma
2e30: 72 6b 20 74 68 65 20 4e 55 4c 4c 20 74 65 73 74  rk the NULL test
2e40: 20 77 69 74 68 20 41 4c 57 41 59 53 28 29 2e 0a   with ALWAYS()..
2e50: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70  */.static void p
2e60: 63 61 63 68 65 31 46 72 65 65 50 61 67 65 28 50  cache1FreePage(P
2e70: 67 48 64 72 31 20 2a 70 29 7b 0a 20 20 69 66 28  gHdr1 *p){.  if(
2e80: 20 41 4c 57 41 59 53 28 70 29 20 29 7b 0a 20 20   ALWAYS(p) ){.  
2e90: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68    PCache1 *pCach
2ea0: 65 20 3d 20 70 2d 3e 70 43 61 63 68 65 3b 0a 20  e = p->pCache;. 
2eb0: 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74     assert( sqlit
2ec0: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d  e3_mutex_held(p-
2ed0: 3e 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d  >pCache->pGroup-
2ee0: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 20 20 70  >mutex) );.    p
2ef0: 63 61 63 68 65 31 46 72 65 65 28 70 2d 3e 70 61  cache1Free(p->pa
2f00: 67 65 2e 70 42 75 66 29 3b 0a 23 69 66 64 65 66  ge.pBuf);.#ifdef
2f10: 20 53 51 4c 49 54 45 5f 50 43 41 43 48 45 5f 53   SQLITE_PCACHE_S
2f20: 45 50 41 52 41 54 45 5f 48 45 41 44 45 52 0a 20  EPARATE_HEADER. 
2f30: 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28     sqlite3_free(
2f40: 70 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 69  p);.#endif.    i
2f50: 66 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67  f( pCache->bPurg
2f60: 65 61 62 6c 65 20 29 7b 0a 20 20 20 20 20 20 70  eable ){.      p
2f70: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6e  Cache->pGroup->n
2f80: 43 75 72 72 65 6e 74 50 61 67 65 2d 2d 3b 0a 20  CurrentPage--;. 
2f90: 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a     }.  }.}../*.*
2fa0: 2a 20 4d 61 6c 6c 6f 63 20 66 75 6e 63 74 69 6f  * Malloc functio
2fb0: 6e 20 75 73 65 64 20 62 79 20 53 51 4c 69 74 65  n used by SQLite
2fc0: 20 74 6f 20 6f 62 74 61 69 6e 20 73 70 61 63 65   to obtain space
2fd0: 20 66 72 6f 6d 20 74 68 65 20 62 75 66 66 65 72   from the buffer
2fe0: 20 63 6f 6e 66 69 67 75 72 65 64 0a 2a 2a 20 75   configured.** u
2ff0: 73 69 6e 67 20 73 71 6c 69 74 65 33 5f 63 6f 6e  sing sqlite3_con
3000: 66 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49  fig(SQLITE_CONFI
3010: 47 5f 50 41 47 45 43 41 43 48 45 29 20 6f 70 74  G_PAGECACHE) opt
3020: 69 6f 6e 2e 20 49 66 20 6e 6f 20 73 75 63 68 20  ion. If no such 
3030: 62 75 66 66 65 72 0a 2a 2a 20 65 78 69 73 74 73  buffer.** exists
3040: 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  , this function 
3050: 66 61 6c 6c 73 20 62 61 63 6b 20 74 6f 20 73 71  falls back to sq
3060: 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 29 2e 0a 2a  lite3Malloc()..*
3070: 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 50  /.void *sqlite3P
3080: 61 67 65 4d 61 6c 6c 6f 63 28 69 6e 74 20 73 7a  ageMalloc(int sz
3090: 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 63 61 63  ){.  return pcac
30a0: 68 65 31 41 6c 6c 6f 63 28 73 7a 29 3b 0a 7d 0a  he1Alloc(sz);.}.
30b0: 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 6e 20 61  ./*.** Free an a
30c0: 6c 6c 6f 63 61 74 65 64 20 62 75 66 66 65 72 20  llocated buffer 
30d0: 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 73 71  obtained from sq
30e0: 6c 69 74 65 33 50 61 67 65 4d 61 6c 6c 6f 63 28  lite3PageMalloc(
30f0: 29 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  )..*/.void sqlit
3100: 65 33 50 61 67 65 46 72 65 65 28 76 6f 69 64 20  e3PageFree(void 
3110: 2a 70 29 7b 0a 20 20 70 63 61 63 68 65 31 46 72  *p){.  pcache1Fr
3120: 65 65 28 70 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a  ee(p);.}.../*.**
3130: 20 52 65 74 75 72 6e 20 74 72 75 65 20 69 66 20   Return true if 
3140: 69 74 20 64 65 73 69 72 61 62 6c 65 20 74 6f 20  it desirable to 
3150: 61 76 6f 69 64 20 61 6c 6c 6f 63 61 74 69 6e 67  avoid allocating
3160: 20 61 20 6e 65 77 20 70 61 67 65 20 63 61 63 68   a new page cach
3170: 65 0a 2a 2a 20 65 6e 74 72 79 2e 0a 2a 2a 0a 2a  e.** entry..**.*
3180: 2a 20 49 66 20 6d 65 6d 6f 72 79 20 77 61 73 20  * If memory was 
3190: 61 6c 6c 6f 63 61 74 65 64 20 73 70 65 63 69 66  allocated specif
31a0: 69 63 61 6c 6c 79 20 74 6f 20 74 68 65 20 70 61  ically to the pa
31b0: 67 65 20 63 61 63 68 65 20 75 73 69 6e 67 0a 2a  ge cache using.*
31c0: 2a 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f  * SQLITE_CONFIG_
31d0: 50 41 47 45 43 41 43 48 45 20 62 75 74 20 74 68  PAGECACHE but th
31e0: 61 74 20 6d 65 6d 6f 72 79 20 68 61 73 20 61 6c  at memory has al
31f0: 6c 20 62 65 65 6e 20 75 73 65 64 2c 20 74 68 65  l been used, the
3200: 6e 0a 2a 2a 20 69 74 20 69 73 20 64 65 73 69 72  n.** it is desir
3210: 61 62 6c 65 20 74 6f 20 61 76 6f 69 64 20 61 6c  able to avoid al
3220: 6c 6f 63 61 74 69 6e 67 20 61 20 6e 65 77 20 70  locating a new p
3230: 61 67 65 20 63 61 63 68 65 20 65 6e 74 72 79 20  age cache entry 
3240: 62 65 63 61 75 73 65 0a 2a 2a 20 70 72 65 73 75  because.** presu
3250: 6d 61 62 6c 79 20 53 51 4c 49 54 45 5f 43 4f 4e  mably SQLITE_CON
3260: 46 49 47 5f 50 41 47 45 43 41 43 48 45 20 77 61  FIG_PAGECACHE wa
3270: 73 20 73 75 70 70 6f 73 65 20 74 6f 20 62 65 20  s suppose to be 
3280: 73 75 66 66 69 63 69 65 6e 74 0a 2a 2a 20 66 6f  sufficient.** fo
3290: 72 20 61 6c 6c 20 70 61 67 65 20 63 61 63 68 65  r all page cache
32a0: 20 6e 65 65 64 73 20 61 6e 64 20 77 65 20 73 68   needs and we sh
32b0: 6f 75 6c 64 20 6e 6f 74 20 6e 65 65 64 20 74 6f  ould not need to
32c0: 20 73 70 69 6c 6c 20 74 68 65 0a 2a 2a 20 61 6c   spill the.** al
32d0: 6c 6f 63 61 74 69 6f 6e 20 6f 6e 74 6f 20 74 68  location onto th
32e0: 65 20 68 65 61 70 2e 0a 2a 2a 0a 2a 2a 20 4f 72  e heap..**.** Or
32f0: 2c 20 74 68 65 20 68 65 61 70 20 69 73 20 75 73  , the heap is us
3300: 65 64 20 66 6f 72 20 61 6c 6c 20 70 61 67 65 20  ed for all page 
3310: 63 61 63 68 65 20 6d 65 6d 6f 72 79 20 62 75 74  cache memory but
3320: 20 74 68 65 20 68 65 61 70 20 69 73 0a 2a 2a 20   the heap is.** 
3330: 75 6e 64 65 72 20 6d 65 6d 6f 72 79 20 70 72 65  under memory pre
3340: 73 73 75 72 65 2c 20 74 68 65 6e 20 61 67 61 69  ssure, then agai
3350: 6e 20 69 74 20 69 73 20 64 65 73 69 72 61 62 6c  n it is desirabl
3360: 65 20 74 6f 20 61 76 6f 69 64 0a 2a 2a 20 61 6c  e to avoid.** al
3370: 6c 6f 63 61 74 69 6e 67 20 61 20 6e 65 77 20 70  locating a new p
3380: 61 67 65 20 63 61 63 68 65 20 65 6e 74 72 79 20  age cache entry 
3390: 69 6e 20 6f 72 64 65 72 20 74 6f 20 61 76 6f 69  in order to avoi
33a0: 64 20 73 74 72 65 73 73 69 6e 67 0a 2a 2a 20 74  d stressing.** t
33b0: 68 65 20 68 65 61 70 20 65 76 65 6e 20 66 75 72  he heap even fur
33c0: 74 68 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  ther..*/.static 
33d0: 69 6e 74 20 70 63 61 63 68 65 31 55 6e 64 65 72  int pcache1Under
33e0: 4d 65 6d 6f 72 79 50 72 65 73 73 75 72 65 28 50  MemoryPressure(P
33f0: 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 29 7b  Cache1 *pCache){
3400: 0a 20 20 69 66 28 20 70 63 61 63 68 65 31 2e 6e  .  if( pcache1.n
3410: 53 6c 6f 74 20 26 26 20 28 70 43 61 63 68 65 2d  Slot && (pCache-
3420: 3e 73 7a 50 61 67 65 2b 70 43 61 63 68 65 2d 3e  >szPage+pCache->
3430: 73 7a 45 78 74 72 61 29 3c 3d 70 63 61 63 68 65  szExtra)<=pcache
3440: 31 2e 73 7a 53 6c 6f 74 20 29 7b 0a 20 20 20 20  1.szSlot ){.    
3450: 72 65 74 75 72 6e 20 70 63 61 63 68 65 31 2e 62  return pcache1.b
3460: 55 6e 64 65 72 50 72 65 73 73 75 72 65 3b 0a 20  UnderPressure;. 
3470: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75   }else{.    retu
3480: 72 6e 20 73 71 6c 69 74 65 33 48 65 61 70 4e 65  rn sqlite3HeapNe
3490: 61 72 6c 79 46 75 6c 6c 28 29 3b 0a 20 20 7d 0a  arlyFull();.  }.
34a0: 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  }../************
34b0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
34c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
34d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
34e0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
34f0: 2a 2a 2f 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 20 47 65  **/./******** Ge
3500: 6e 65 72 61 6c 20 49 6d 70 6c 65 6d 65 6e 74 61  neral Implementa
3510: 74 69 6f 6e 20 46 75 6e 63 74 69 6f 6e 73 20 2a  tion Functions *
3520: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
3530: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
3540: 2a 2a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  ***/../*.** This
3550: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 65   function is use
3560: 64 20 74 6f 20 72 65 73 69 7a 65 20 74 68 65 20  d to resize the 
3570: 68 61 73 68 20 74 61 62 6c 65 20 75 73 65 64 20  hash table used 
3580: 62 79 20 74 68 65 20 63 61 63 68 65 20 70 61 73  by the cache pas
3590: 73 65 64 0a 2a 2a 20 61 73 20 74 68 65 20 66 69  sed.** as the fi
35a0: 72 73 74 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2a  rst argument..**
35b0: 0a 2a 2a 20 54 68 65 20 50 43 61 63 68 65 20 6d  .** The PCache m
35c0: 75 74 65 78 20 6d 75 73 74 20 62 65 20 68 65 6c  utex must be hel
35d0: 64 20 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63  d when this func
35e0: 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2e 0a  tion is called..
35f0: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70  */.static void p
3600: 63 61 63 68 65 31 52 65 73 69 7a 65 48 61 73 68  cache1ResizeHash
3610: 28 50 43 61 63 68 65 31 20 2a 70 29 7b 0a 20 20  (PCache1 *p){.  
3620: 50 67 48 64 72 31 20 2a 2a 61 70 4e 65 77 3b 0a  PgHdr1 **apNew;.
3630: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e    unsigned int n
3640: 4e 65 77 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20  New;.  unsigned 
3650: 69 6e 74 20 69 3b 0a 0a 20 20 61 73 73 65 72 74  int i;..  assert
3660: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
3670: 68 65 6c 64 28 70 2d 3e 70 47 72 6f 75 70 2d 3e  held(p->pGroup->
3680: 6d 75 74 65 78 29 20 29 3b 0a 0a 20 20 6e 4e 65  mutex) );..  nNe
3690: 77 20 3d 20 70 2d 3e 6e 48 61 73 68 2a 32 3b 0a  w = p->nHash*2;.
36a0: 20 20 69 66 28 20 6e 4e 65 77 3c 32 35 36 20 29    if( nNew<256 )
36b0: 7b 0a 20 20 20 20 6e 4e 65 77 20 3d 20 32 35 36  {.    nNew = 256
36c0: 3b 0a 20 20 7d 0a 0a 20 20 70 63 61 63 68 65 31  ;.  }..  pcache1
36d0: 4c 65 61 76 65 4d 75 74 65 78 28 70 2d 3e 70 47  LeaveMutex(p->pG
36e0: 72 6f 75 70 29 3b 0a 20 20 69 66 28 20 70 2d 3e  roup);.  if( p->
36f0: 6e 48 61 73 68 20 29 7b 20 73 71 6c 69 74 65 33  nHash ){ sqlite3
3700: 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f  BeginBenignMallo
3710: 63 28 29 3b 20 7d 0a 20 20 61 70 4e 65 77 20 3d  c(); }.  apNew =
3720: 20 28 50 67 48 64 72 31 20 2a 2a 29 73 71 6c 69   (PgHdr1 **)sqli
3730: 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 69  te3MallocZero(si
3740: 7a 65 6f 66 28 50 67 48 64 72 31 20 2a 29 2a 6e  zeof(PgHdr1 *)*n
3750: 4e 65 77 29 3b 0a 20 20 69 66 28 20 70 2d 3e 6e  New);.  if( p->n
3760: 48 61 73 68 20 29 7b 20 73 71 6c 69 74 65 33 45  Hash ){ sqlite3E
3770: 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29  ndBenignMalloc()
3780: 3b 20 7d 0a 20 20 70 63 61 63 68 65 31 45 6e 74  ; }.  pcache1Ent
3790: 65 72 4d 75 74 65 78 28 70 2d 3e 70 47 72 6f 75  erMutex(p->pGrou
37a0: 70 29 3b 0a 20 20 69 66 28 20 61 70 4e 65 77 20  p);.  if( apNew 
37b0: 29 7b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20  ){.    for(i=0; 
37c0: 69 3c 70 2d 3e 6e 48 61 73 68 3b 20 69 2b 2b 29  i<p->nHash; i++)
37d0: 7b 0a 20 20 20 20 20 20 50 67 48 64 72 31 20 2a  {.      PgHdr1 *
37e0: 70 50 61 67 65 3b 0a 20 20 20 20 20 20 50 67 48  pPage;.      PgH
37f0: 64 72 31 20 2a 70 4e 65 78 74 20 3d 20 70 2d 3e  dr1 *pNext = p->
3800: 61 70 48 61 73 68 5b 69 5d 3b 0a 20 20 20 20 20  apHash[i];.     
3810: 20 77 68 69 6c 65 28 20 28 70 50 61 67 65 20 3d   while( (pPage =
3820: 20 70 4e 65 78 74 29 21 3d 30 20 29 7b 0a 20 20   pNext)!=0 ){.  
3830: 20 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 69        unsigned i
3840: 6e 74 20 68 20 3d 20 70 50 61 67 65 2d 3e 69 4b  nt h = pPage->iK
3850: 65 79 20 25 20 6e 4e 65 77 3b 0a 20 20 20 20 20  ey % nNew;.     
3860: 20 20 20 70 4e 65 78 74 20 3d 20 70 50 61 67 65     pNext = pPage
3870: 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 20  ->pNext;.       
3880: 20 70 50 61 67 65 2d 3e 70 4e 65 78 74 20 3d 20   pPage->pNext = 
3890: 61 70 4e 65 77 5b 68 5d 3b 0a 20 20 20 20 20 20  apNew[h];.      
38a0: 20 20 61 70 4e 65 77 5b 68 5d 20 3d 20 70 50 61    apNew[h] = pPa
38b0: 67 65 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  ge;.      }.    
38c0: 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72  }.    sqlite3_fr
38d0: 65 65 28 70 2d 3e 61 70 48 61 73 68 29 3b 0a 20  ee(p->apHash);. 
38e0: 20 20 20 70 2d 3e 61 70 48 61 73 68 20 3d 20 61     p->apHash = a
38f0: 70 4e 65 77 3b 0a 20 20 20 20 70 2d 3e 6e 48 61  pNew;.    p->nHa
3900: 73 68 20 3d 20 6e 4e 65 77 3b 0a 20 20 7d 0a 7d  sh = nNew;.  }.}
3910: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e  ../*.** This fun
3920: 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 69 6e  ction is used in
3930: 74 65 72 6e 61 6c 6c 79 20 74 6f 20 72 65 6d 6f  ternally to remo
3940: 76 65 20 74 68 65 20 70 61 67 65 20 70 50 61 67  ve the page pPag
3950: 65 20 66 72 6f 6d 20 74 68 65 20 0a 2a 2a 20 50  e from the .** P
3960: 47 72 6f 75 70 20 4c 52 55 20 6c 69 73 74 2c 20  Group LRU list, 
3970: 69 66 20 69 73 20 70 61 72 74 20 6f 66 20 69 74  if is part of it
3980: 2e 20 49 66 20 70 50 61 67 65 20 69 73 20 6e 6f  . If pPage is no
3990: 74 20 70 61 72 74 20 6f 66 20 74 68 65 20 50 47  t part of the PG
39a0: 72 6f 75 70 0a 2a 2a 20 4c 52 55 20 6c 69 73 74  roup.** LRU list
39b0: 2c 20 74 68 65 6e 20 74 68 69 73 20 66 75 6e 63  , then this func
39c0: 74 69 6f 6e 20 69 73 20 61 20 6e 6f 2d 6f 70 2e  tion is a no-op.
39d0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50 47 72 6f 75  .**.** The PGrou
39e0: 70 20 6d 75 74 65 78 20 6d 75 73 74 20 62 65 20  p mutex must be 
39f0: 68 65 6c 64 20 77 68 65 6e 20 74 68 69 73 20 66  held when this f
3a00: 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65  unction is calle
3a10: 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  d..*/.static voi
3a20: 64 20 70 63 61 63 68 65 31 50 69 6e 50 61 67 65  d pcache1PinPage
3a30: 28 50 67 48 64 72 31 20 2a 70 50 61 67 65 29 7b  (PgHdr1 *pPage){
3a40: 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63  .  PCache1 *pCac
3a50: 68 65 3b 0a 20 20 50 47 72 6f 75 70 20 2a 70 47  he;.  PGroup *pG
3a60: 72 6f 75 70 3b 0a 0a 20 20 61 73 73 65 72 74 28  roup;..  assert(
3a70: 20 70 50 61 67 65 21 3d 30 20 29 3b 0a 20 20 61   pPage!=0 );.  a
3a80: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 69 73  ssert( pPage->is
3a90: 50 69 6e 6e 65 64 3d 3d 30 20 29 3b 0a 20 20 70  Pinned==0 );.  p
3aa0: 43 61 63 68 65 20 3d 20 70 50 61 67 65 2d 3e 70  Cache = pPage->p
3ab0: 43 61 63 68 65 3b 0a 20 20 70 47 72 6f 75 70 20  Cache;.  pGroup 
3ac0: 3d 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70  = pCache->pGroup
3ad0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67  ;.  assert( pPag
3ae0: 65 2d 3e 70 4c 72 75 4e 65 78 74 20 7c 7c 20 70  e->pLruNext || p
3af0: 50 61 67 65 3d 3d 70 47 72 6f 75 70 2d 3e 70 4c  Page==pGroup->pL
3b00: 72 75 54 61 69 6c 20 29 3b 0a 20 20 61 73 73 65  ruTail );.  asse
3b10: 72 74 28 20 70 50 61 67 65 2d 3e 70 4c 72 75 50  rt( pPage->pLruP
3b20: 72 65 76 20 7c 7c 20 70 50 61 67 65 3d 3d 70 47  rev || pPage==pG
3b30: 72 6f 75 70 2d 3e 70 4c 72 75 48 65 61 64 20 29  roup->pLruHead )
3b40: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69  ;.  assert( sqli
3b50: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70  te3_mutex_held(p
3b60: 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b  Group->mutex) );
3b70: 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e 70 4c  .  if( pPage->pL
3b80: 72 75 50 72 65 76 20 29 7b 0a 20 20 20 20 70 50  ruPrev ){.    pP
3b90: 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 2d 3e 70  age->pLruPrev->p
3ba0: 4c 72 75 4e 65 78 74 20 3d 20 70 50 61 67 65 2d  LruNext = pPage-
3bb0: 3e 70 4c 72 75 4e 65 78 74 3b 0a 20 20 7d 65 6c  >pLruNext;.  }el
3bc0: 73 65 7b 0a 20 20 20 20 70 47 72 6f 75 70 2d 3e  se{.    pGroup->
3bd0: 70 4c 72 75 48 65 61 64 20 3d 20 70 50 61 67 65  pLruHead = pPage
3be0: 2d 3e 70 4c 72 75 4e 65 78 74 3b 0a 20 20 7d 0a  ->pLruNext;.  }.
3bf0: 20 20 69 66 28 20 70 50 61 67 65 2d 3e 70 4c 72    if( pPage->pLr
3c00: 75 4e 65 78 74 20 29 7b 0a 20 20 20 20 70 50 61  uNext ){.    pPa
3c10: 67 65 2d 3e 70 4c 72 75 4e 65 78 74 2d 3e 70 4c  ge->pLruNext->pL
3c20: 72 75 50 72 65 76 20 3d 20 70 50 61 67 65 2d 3e  ruPrev = pPage->
3c30: 70 4c 72 75 50 72 65 76 3b 0a 20 20 7d 65 6c 73  pLruPrev;.  }els
3c40: 65 7b 0a 20 20 20 20 70 47 72 6f 75 70 2d 3e 70  e{.    pGroup->p
3c50: 4c 72 75 54 61 69 6c 20 3d 20 70 50 61 67 65 2d  LruTail = pPage-
3c60: 3e 70 4c 72 75 50 72 65 76 3b 0a 20 20 7d 0a 20  >pLruPrev;.  }. 
3c70: 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74   pPage->pLruNext
3c80: 20 3d 20 30 3b 0a 20 20 70 50 61 67 65 2d 3e 70   = 0;.  pPage->p
3c90: 4c 72 75 50 72 65 76 20 3d 20 30 3b 0a 20 20 70  LruPrev = 0;.  p
3ca0: 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64 20 3d  Page->isPinned =
3cb0: 20 31 3b 0a 20 20 70 43 61 63 68 65 2d 3e 6e 52   1;.  pCache->nR
3cc0: 65 63 79 63 6c 61 62 6c 65 2d 2d 3b 0a 7d 0a 0a  ecyclable--;.}..
3cd0: 0a 2f 2a 0a 2a 2a 20 52 65 6d 6f 76 65 20 74 68  ./*.** Remove th
3ce0: 65 20 70 61 67 65 20 73 75 70 70 6c 69 65 64 20  e page supplied 
3cf0: 61 73 20 61 6e 20 61 72 67 75 6d 65 6e 74 20 66  as an argument f
3d00: 72 6f 6d 20 74 68 65 20 68 61 73 68 20 74 61 62  rom the hash tab
3d10: 6c 65 20 0a 2a 2a 20 28 50 43 61 63 68 65 31 2e  le .** (PCache1.
3d20: 61 70 48 61 73 68 20 73 74 72 75 63 74 75 72 65  apHash structure
3d30: 29 20 74 68 61 74 20 69 74 20 69 73 20 63 75 72  ) that it is cur
3d40: 72 65 6e 74 6c 79 20 73 74 6f 72 65 64 20 69 6e  rently stored in
3d50: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50 47 72 6f  ..**.** The PGro
3d60: 75 70 20 6d 75 74 65 78 20 6d 75 73 74 20 62 65  up mutex must be
3d70: 20 68 65 6c 64 20 77 68 65 6e 20 74 68 69 73 20   held when this 
3d80: 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c  function is call
3d90: 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  ed..*/.static vo
3da0: 69 64 20 70 63 61 63 68 65 31 52 65 6d 6f 76 65  id pcache1Remove
3db0: 46 72 6f 6d 48 61 73 68 28 50 67 48 64 72 31 20  FromHash(PgHdr1 
3dc0: 2a 70 50 61 67 65 29 7b 0a 20 20 75 6e 73 69 67  *pPage){.  unsig
3dd0: 6e 65 64 20 69 6e 74 20 68 3b 0a 20 20 50 43 61  ned int h;.  PCa
3de0: 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20 70  che1 *pCache = p
3df0: 50 61 67 65 2d 3e 70 43 61 63 68 65 3b 0a 20 20  Page->pCache;.  
3e00: 50 67 48 64 72 31 20 2a 2a 70 70 3b 0a 0a 20 20  PgHdr1 **pp;..  
3e10: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f  assert( sqlite3_
3e20: 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 61 63 68  mutex_held(pCach
3e30: 65 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78  e->pGroup->mutex
3e40: 29 20 29 3b 0a 20 20 68 20 3d 20 70 50 61 67 65  ) );.  h = pPage
3e50: 2d 3e 69 4b 65 79 20 25 20 70 43 61 63 68 65 2d  ->iKey % pCache-
3e60: 3e 6e 48 61 73 68 3b 0a 20 20 66 6f 72 28 70 70  >nHash;.  for(pp
3e70: 3d 26 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68  =&pCache->apHash
3e80: 5b 68 5d 3b 20 28 2a 70 70 29 21 3d 70 50 61 67  [h]; (*pp)!=pPag
3e90: 65 3b 20 70 70 3d 26 28 2a 70 70 29 2d 3e 70 4e  e; pp=&(*pp)->pN
3ea0: 65 78 74 29 3b 0a 20 20 2a 70 70 20 3d 20 28 2a  ext);.  *pp = (*
3eb0: 70 70 29 2d 3e 70 4e 65 78 74 3b 0a 0a 20 20 70  pp)->pNext;..  p
3ec0: 43 61 63 68 65 2d 3e 6e 50 61 67 65 2d 2d 3b 0a  Cache->nPage--;.
3ed0: 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 72  }../*.** If ther
3ee0: 65 20 61 72 65 20 63 75 72 72 65 6e 74 6c 79 20  e are currently 
3ef0: 6d 6f 72 65 20 74 68 61 6e 20 6e 4d 61 78 50 61  more than nMaxPa
3f00: 67 65 20 70 61 67 65 73 20 61 6c 6c 6f 63 61 74  ge pages allocat
3f10: 65 64 2c 20 74 72 79 0a 2a 2a 20 74 6f 20 72 65  ed, try.** to re
3f20: 63 79 63 6c 65 20 70 61 67 65 73 20 74 6f 20 72  cycle pages to r
3f30: 65 64 75 63 65 20 74 68 65 20 6e 75 6d 62 65 72  educe the number
3f40: 20 61 6c 6c 6f 63 61 74 65 64 20 74 6f 20 6e 4d   allocated to nM
3f50: 61 78 50 61 67 65 2e 0a 2a 2f 0a 73 74 61 74 69  axPage..*/.stati
3f60: 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 45 6e  c void pcache1En
3f70: 66 6f 72 63 65 4d 61 78 50 61 67 65 28 50 47 72  forceMaxPage(PGr
3f80: 6f 75 70 20 2a 70 47 72 6f 75 70 29 7b 0a 20 20  oup *pGroup){.  
3f90: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f  assert( sqlite3_
3fa0: 6d 75 74 65 78 5f 68 65 6c 64 28 70 47 72 6f 75  mutex_held(pGrou
3fb0: 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 77  p->mutex) );.  w
3fc0: 68 69 6c 65 28 20 70 47 72 6f 75 70 2d 3e 6e 43  hile( pGroup->nC
3fd0: 75 72 72 65 6e 74 50 61 67 65 3e 70 47 72 6f 75  urrentPage>pGrou
3fe0: 70 2d 3e 6e 4d 61 78 50 61 67 65 20 26 26 20 70  p->nMaxPage && p
3ff0: 47 72 6f 75 70 2d 3e 70 4c 72 75 54 61 69 6c 20  Group->pLruTail 
4000: 29 7b 0a 20 20 20 20 50 67 48 64 72 31 20 2a 70  ){.    PgHdr1 *p
4010: 20 3d 20 70 47 72 6f 75 70 2d 3e 70 4c 72 75 54   = pGroup->pLruT
4020: 61 69 6c 3b 0a 20 20 20 20 61 73 73 65 72 74 28  ail;.    assert(
4030: 20 70 2d 3e 70 43 61 63 68 65 2d 3e 70 47 72 6f   p->pCache->pGro
4040: 75 70 3d 3d 70 47 72 6f 75 70 20 29 3b 0a 20 20  up==pGroup );.  
4050: 20 20 61 73 73 65 72 74 28 20 70 2d 3e 69 73 50    assert( p->isP
4060: 69 6e 6e 65 64 3d 3d 30 20 29 3b 0a 20 20 20 20  inned==0 );.    
4070: 70 63 61 63 68 65 31 50 69 6e 50 61 67 65 28 70  pcache1PinPage(p
4080: 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 52 65  );.    pcache1Re
4090: 6d 6f 76 65 46 72 6f 6d 48 61 73 68 28 70 29 3b  moveFromHash(p);
40a0: 0a 20 20 20 20 70 63 61 63 68 65 31 46 72 65 65  .    pcache1Free
40b0: 50 61 67 65 28 70 29 3b 0a 20 20 7d 0a 7d 0a 0a  Page(p);.  }.}..
40c0: 2f 2a 0a 2a 2a 20 44 69 73 63 61 72 64 20 61 6c  /*.** Discard al
40d0: 6c 20 70 61 67 65 73 20 66 72 6f 6d 20 63 61 63  l pages from cac
40e0: 68 65 20 70 43 61 63 68 65 20 77 69 74 68 20 61  he pCache with a
40f0: 20 70 61 67 65 20 6e 75 6d 62 65 72 20 28 6b 65   page number (ke
4100: 79 20 76 61 6c 75 65 29 20 0a 2a 2a 20 67 72 65  y value) .** gre
4110: 61 74 65 72 20 74 68 61 6e 20 6f 72 20 65 71 75  ater than or equ
4120: 61 6c 20 74 6f 20 69 4c 69 6d 69 74 2e 20 41 6e  al to iLimit. An
4130: 79 20 70 69 6e 6e 65 64 20 70 61 67 65 73 20 74  y pinned pages t
4140: 68 61 74 20 6d 65 65 74 20 74 68 69 73 20 0a 2a  hat meet this .*
4150: 2a 20 63 72 69 74 65 72 69 61 20 61 72 65 20 75  * criteria are u
4160: 6e 70 69 6e 6e 65 64 20 62 65 66 6f 72 65 20 74  npinned before t
4170: 68 65 79 20 61 72 65 20 64 69 73 63 61 72 64 65  hey are discarde
4180: 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50 43 61  d..**.** The PCa
4190: 63 68 65 20 6d 75 74 65 78 20 6d 75 73 74 20 62  che mutex must b
41a0: 65 20 68 65 6c 64 20 77 68 65 6e 20 74 68 69 73  e held when this
41b0: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c   function is cal
41c0: 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  led..*/.static v
41d0: 6f 69 64 20 70 63 61 63 68 65 31 54 72 75 6e 63  oid pcache1Trunc
41e0: 61 74 65 55 6e 73 61 66 65 28 0a 20 20 50 43 61  ateUnsafe(.  PCa
41f0: 63 68 65 31 20 2a 70 43 61 63 68 65 2c 20 20 20  che1 *pCache,   
4200: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65            /* The
4210: 20 63 61 63 68 65 20 74 6f 20 74 72 75 6e 63 61   cache to trunca
4220: 74 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64  te */.  unsigned
4230: 20 69 6e 74 20 69 4c 69 6d 69 74 20 20 20 20 20   int iLimit     
4240: 20 20 20 20 20 2f 2a 20 44 72 6f 70 20 70 61 67       /* Drop pag
4250: 65 73 20 77 69 74 68 20 74 68 69 73 20 70 67 6e  es with this pgn
4260: 6f 20 6f 72 20 6c 61 72 67 65 72 20 2a 2f 0a 29  o or larger */.)
4270: 7b 0a 20 20 54 45 53 54 4f 4e 4c 59 28 20 75 6e  {.  TESTONLY( un
4280: 73 69 67 6e 65 64 20 69 6e 74 20 6e 50 61 67 65  signed int nPage
4290: 20 3d 20 30 3b 20 29 20 20 2f 2a 20 54 6f 20 61   = 0; )  /* To a
42a0: 73 73 65 72 74 20 70 43 61 63 68 65 2d 3e 6e 50  ssert pCache->nP
42b0: 61 67 65 20 69 73 20 63 6f 72 72 65 63 74 20 2a  age is correct *
42c0: 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74  /.  unsigned int
42d0: 20 68 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71   h;.  assert( sq
42e0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64  lite3_mutex_held
42f0: 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d  (pCache->pGroup-
4300: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 66 6f 72  >mutex) );.  for
4310: 28 68 3d 30 3b 20 68 3c 70 43 61 63 68 65 2d 3e  (h=0; h<pCache->
4320: 6e 48 61 73 68 3b 20 68 2b 2b 29 7b 0a 20 20 20  nHash; h++){.   
4330: 20 50 67 48 64 72 31 20 2a 2a 70 70 20 3d 20 26   PgHdr1 **pp = &
4340: 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68  pCache->apHash[h
4350: 5d 3b 20 0a 20 20 20 20 50 67 48 64 72 31 20 2a  ]; .    PgHdr1 *
4360: 70 50 61 67 65 3b 0a 20 20 20 20 77 68 69 6c 65  pPage;.    while
4370: 28 20 28 70 50 61 67 65 20 3d 20 2a 70 70 29 21  ( (pPage = *pp)!
4380: 3d 30 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20  =0 ){.      if( 
4390: 70 50 61 67 65 2d 3e 69 4b 65 79 3e 3d 69 4c 69  pPage->iKey>=iLi
43a0: 6d 69 74 20 29 7b 0a 20 20 20 20 20 20 20 20 70  mit ){.        p
43b0: 43 61 63 68 65 2d 3e 6e 50 61 67 65 2d 2d 3b 0a  Cache->nPage--;.
43c0: 20 20 20 20 20 20 20 20 2a 70 70 20 3d 20 70 50          *pp = pP
43d0: 61 67 65 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20  age->pNext;.    
43e0: 20 20 20 20 69 66 28 20 21 70 50 61 67 65 2d 3e      if( !pPage->
43f0: 69 73 50 69 6e 6e 65 64 20 29 20 70 63 61 63 68  isPinned ) pcach
4400: 65 31 50 69 6e 50 61 67 65 28 70 50 61 67 65 29  e1PinPage(pPage)
4410: 3b 0a 20 20 20 20 20 20 20 20 70 63 61 63 68 65  ;.        pcache
4420: 31 46 72 65 65 50 61 67 65 28 70 50 61 67 65 29  1FreePage(pPage)
4430: 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20  ;.      }else{. 
4440: 20 20 20 20 20 20 20 70 70 20 3d 20 26 70 50 61         pp = &pPa
4450: 67 65 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20  ge->pNext;.     
4460: 20 20 20 54 45 53 54 4f 4e 4c 59 28 20 6e 50 61     TESTONLY( nPa
4470: 67 65 2b 2b 3b 20 29 0a 20 20 20 20 20 20 7d 0a  ge++; ).      }.
4480: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 61 73 73 65      }.  }.  asse
4490: 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 50 61 67  rt( pCache->nPag
44a0: 65 3d 3d 6e 50 61 67 65 20 29 3b 0a 7d 0a 0a 2f  e==nPage );.}../
44b0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
44c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
44d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
44e0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
44f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a  **************/.
4500: 2f 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65  /******** sqlite
4510: 33 5f 70 63 61 63 68 65 20 4d 65 74 68 6f 64 73  3_pcache Methods
4520: 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a   ***************
4530: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4540: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f  ***************/
4550: 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e  ../*.** Implemen
4560: 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71  tation of the sq
4570: 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78 49 6e  lite3_pcache.xIn
4580: 69 74 20 6d 65 74 68 6f 64 2e 0a 2a 2f 0a 73 74  it method..*/.st
4590: 61 74 69 63 20 69 6e 74 20 70 63 61 63 68 65 31  atic int pcache1
45a0: 49 6e 69 74 28 76 6f 69 64 20 2a 4e 6f 74 55 73  Init(void *NotUs
45b0: 65 64 29 7b 0a 20 20 55 4e 55 53 45 44 5f 50 41  ed){.  UNUSED_PA
45c0: 52 41 4d 45 54 45 52 28 4e 6f 74 55 73 65 64 29  RAMETER(NotUsed)
45d0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 63 61 63  ;.  assert( pcac
45e0: 68 65 31 2e 69 73 49 6e 69 74 3d 3d 30 20 29 3b  he1.isInit==0 );
45f0: 0a 20 20 6d 65 6d 73 65 74 28 26 70 63 61 63 68  .  memset(&pcach
4600: 65 31 2c 20 30 2c 20 73 69 7a 65 6f 66 28 70 63  e1, 0, sizeof(pc
4610: 61 63 68 65 31 29 29 3b 0a 20 20 69 66 28 20 73  ache1));.  if( s
4620: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66  qlite3GlobalConf
4630: 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 20 29 7b  ig.bCoreMutex ){
4640: 0a 20 20 20 20 70 63 61 63 68 65 31 2e 67 72 70  .    pcache1.grp
4650: 2e 6d 75 74 65 78 20 3d 20 73 71 6c 69 74 65 33  .mutex = sqlite3
4660: 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 28 53 51 4c  _mutex_alloc(SQL
4670: 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43  ITE_MUTEX_STATIC
4680: 5f 4c 52 55 29 3b 0a 20 20 20 20 70 63 61 63 68  _LRU);.    pcach
4690: 65 31 2e 6d 75 74 65 78 20 3d 20 73 71 6c 69 74  e1.mutex = sqlit
46a0: 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 28 53  e3_mutex_alloc(S
46b0: 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54  QLITE_MUTEX_STAT
46c0: 49 43 5f 50 4d 45 4d 29 3b 0a 20 20 7d 0a 20 20  IC_PMEM);.  }.  
46d0: 70 63 61 63 68 65 31 2e 67 72 70 2e 6d 78 50 69  pcache1.grp.mxPi
46e0: 6e 6e 65 64 20 3d 20 31 30 3b 0a 20 20 70 63 61  nned = 10;.  pca
46f0: 63 68 65 31 2e 69 73 49 6e 69 74 20 3d 20 31 3b  che1.isInit = 1;
4700: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
4710: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d  _OK;.}../*.** Im
4720: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20  plementation of 
4730: 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63  the sqlite3_pcac
4740: 68 65 2e 78 53 68 75 74 64 6f 77 6e 20 6d 65 74  he.xShutdown met
4750: 68 6f 64 2e 0a 2a 2a 20 4e 6f 74 65 20 74 68 61  hod..** Note tha
4760: 74 20 74 68 65 20 73 74 61 74 69 63 20 6d 75 74  t the static mut
4770: 65 78 20 61 6c 6c 6f 63 61 74 65 64 20 69 6e 20  ex allocated in 
4780: 78 49 6e 69 74 20 64 6f 65 73 20 0a 2a 2a 20 6e  xInit does .** n
4790: 6f 74 20 6e 65 65 64 20 74 6f 20 62 65 20 66 72  ot need to be fr
47a0: 65 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  eed..*/.static v
47b0: 6f 69 64 20 70 63 61 63 68 65 31 53 68 75 74 64  oid pcache1Shutd
47c0: 6f 77 6e 28 76 6f 69 64 20 2a 4e 6f 74 55 73 65  own(void *NotUse
47d0: 64 29 7b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52  d){.  UNUSED_PAR
47e0: 41 4d 45 54 45 52 28 4e 6f 74 55 73 65 64 29 3b  AMETER(NotUsed);
47f0: 0a 20 20 61 73 73 65 72 74 28 20 70 63 61 63 68  .  assert( pcach
4800: 65 31 2e 69 73 49 6e 69 74 21 3d 30 20 29 3b 0a  e1.isInit!=0 );.
4810: 20 20 6d 65 6d 73 65 74 28 26 70 63 61 63 68 65    memset(&pcache
4820: 31 2c 20 30 2c 20 73 69 7a 65 6f 66 28 70 63 61  1, 0, sizeof(pca
4830: 63 68 65 31 29 29 3b 0a 7d 0a 0a 2f 2a 20 66 6f  che1));.}../* fo
4840: 72 77 61 72 64 20 64 65 63 6c 61 72 61 74 69 6f  rward declaratio
4850: 6e 20 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  n */.static void
4860: 20 70 63 61 63 68 65 31 44 65 73 74 72 6f 79 28   pcache1Destroy(
4870: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a  sqlite3_pcache *
4880: 70 29 3b 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65  p);../*.** Imple
4890: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65  mentation of the
48a0: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e   sqlite3_pcache.
48b0: 78 43 72 65 61 74 65 20 6d 65 74 68 6f 64 2e 0a  xCreate method..
48c0: 2a 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 61  **.** Allocate a
48d0: 20 6e 65 77 20 63 61 63 68 65 2e 0a 2a 2f 0a 73   new cache..*/.s
48e0: 74 61 74 69 63 20 73 71 6c 69 74 65 33 5f 70 63  tatic sqlite3_pc
48f0: 61 63 68 65 20 2a 70 63 61 63 68 65 31 43 72 65  ache *pcache1Cre
4900: 61 74 65 28 69 6e 74 20 73 7a 50 61 67 65 2c 20  ate(int szPage, 
4910: 69 6e 74 20 73 7a 45 78 74 72 61 2c 20 69 6e 74  int szExtra, int
4920: 20 62 50 75 72 67 65 61 62 6c 65 29 7b 0a 20 20   bPurgeable){.  
4930: 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 3b  PCache1 *pCache;
4940: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6e 65 77        /* The new
4950: 6c 79 20 63 72 65 61 74 65 64 20 70 61 67 65 20  ly created page 
4960: 63 61 63 68 65 20 2a 2f 0a 20 20 50 47 72 6f 75  cache */.  PGrou
4970: 70 20 2a 70 47 72 6f 75 70 3b 20 20 20 20 20 20  p *pGroup;      
4980: 20 2f 2a 20 54 68 65 20 67 72 6f 75 70 20 74 68   /* The group th
4990: 65 20 6e 65 77 20 70 61 67 65 20 63 61 63 68 65  e new page cache
49a0: 20 77 69 6c 6c 20 62 65 6c 6f 6e 67 20 74 6f 20   will belong to 
49b0: 2a 2f 0a 20 20 69 6e 74 20 73 7a 3b 20 20 20 20  */.  int sz;    
49c0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 79             /* By
49d0: 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79 20 72 65  tes of memory re
49e0: 71 75 69 72 65 64 20 74 6f 20 61 6c 6c 6f 63 61  quired to alloca
49f0: 74 65 20 74 68 65 20 6e 65 77 20 63 61 63 68 65  te the new cache
4a00: 20 2a 2f 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54   */..  /*.  ** T
4a10: 68 65 20 73 65 70 61 72 61 74 65 43 61 63 68 65  he separateCache
4a20: 20 76 61 72 69 61 62 6c 65 20 69 73 20 74 72 75   variable is tru
4a30: 65 20 69 66 20 65 61 63 68 20 50 43 61 63 68 65  e if each PCache
4a40: 20 68 61 73 20 69 74 73 20 6f 77 6e 20 70 72 69   has its own pri
4a50: 76 61 74 65 0a 20 20 2a 2a 20 50 47 72 6f 75 70  vate.  ** PGroup
4a60: 2e 20 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64  .  In other word
4a70: 73 2c 20 73 65 70 61 72 61 74 65 43 61 63 68 65  s, separateCache
4a80: 20 69 73 20 74 72 75 65 20 66 6f 72 20 6d 6f 64   is true for mod
4a90: 65 20 28 31 29 20 77 68 65 72 65 20 6e 6f 0a 20  e (1) where no. 
4aa0: 20 2a 2a 20 6d 75 74 65 78 69 6e 67 20 69 73 20   ** mutexing is 
4ab0: 72 65 71 75 69 72 65 64 2e 0a 20 20 2a 2a 0a 20  required..  **. 
4ac0: 20 2a 2a 20 20 20 2a 20 20 41 6c 77 61 79 73 20   **   *  Always 
4ad0: 75 73 65 20 61 20 75 6e 69 66 69 65 64 20 63 61  use a unified ca
4ae0: 63 68 65 20 28 6d 6f 64 65 2d 32 29 20 69 66 20  che (mode-2) if 
4af0: 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41  ENABLE_MEMORY_MA
4b00: 4e 41 47 45 4d 45 4e 54 0a 20 20 2a 2a 0a 20 20  NAGEMENT.  **.  
4b10: 2a 2a 20 20 20 2a 20 20 41 6c 77 61 79 73 20 75  **   *  Always u
4b20: 73 65 20 61 20 75 6e 69 66 69 65 64 20 63 61 63  se a unified cac
4b30: 68 65 20 69 6e 20 73 69 6e 67 6c 65 2d 74 68 72  he in single-thr
4b40: 65 61 64 65 64 20 61 70 70 6c 69 63 61 74 69 6f  eaded applicatio
4b50: 6e 73 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a  ns.  **.  **   *
4b60: 20 20 4f 74 68 65 72 77 69 73 65 20 28 69 66 20    Otherwise (if 
4b70: 6d 75 6c 74 69 2d 74 68 72 65 61 64 65 64 20 61  multi-threaded a
4b80: 6e 64 20 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59  nd ENABLE_MEMORY
4b90: 5f 4d 41 4e 41 47 45 4d 45 4e 54 20 69 73 20 6f  _MANAGEMENT is o
4ba0: 66 66 29 0a 20 20 2a 2a 20 20 20 20 20 20 75 73  ff).  **      us
4bb0: 65 20 73 65 70 61 72 61 74 65 20 63 61 63 68 65  e separate cache
4bc0: 73 20 28 6d 6f 64 65 2d 31 29 0a 20 20 2a 2f 0a  s (mode-1).  */.
4bd0: 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49  #if defined(SQLI
4be0: 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59  TE_ENABLE_MEMORY
4bf0: 5f 4d 41 4e 41 47 45 4d 45 4e 54 29 20 7c 7c 20  _MANAGEMENT) || 
4c00: 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46  SQLITE_THREADSAF
4c10: 45 3d 3d 30 0a 20 20 63 6f 6e 73 74 20 69 6e 74  E==0.  const int
4c20: 20 73 65 70 61 72 61 74 65 43 61 63 68 65 20 3d   separateCache =
4c30: 20 30 3b 0a 23 65 6c 73 65 0a 20 20 69 6e 74 20   0;.#else.  int 
4c40: 73 65 70 61 72 61 74 65 43 61 63 68 65 20 3d 20  separateCache = 
4c50: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
4c60: 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 3e 30  fig.bCoreMutex>0
4c70: 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73 73 65  ;.#endif..  asse
4c80: 72 74 28 20 28 73 7a 50 61 67 65 20 26 20 28 73  rt( (szPage & (s
4c90: 7a 50 61 67 65 2d 31 29 29 3d 3d 30 20 26 26 20  zPage-1))==0 && 
4ca0: 73 7a 50 61 67 65 3e 3d 35 31 32 20 26 26 20 73  szPage>=512 && s
4cb0: 7a 50 61 67 65 3c 3d 36 35 35 33 36 20 29 3b 0a  zPage<=65536 );.
4cc0: 20 20 61 73 73 65 72 74 28 20 73 7a 45 78 74 72    assert( szExtr
4cd0: 61 20 3c 20 33 30 30 20 29 3b 0a 0a 20 20 73 7a  a < 300 );..  sz
4ce0: 20 3d 20 73 69 7a 65 6f 66 28 50 43 61 63 68 65   = sizeof(PCache
4cf0: 31 29 20 2b 20 73 69 7a 65 6f 66 28 50 47 72 6f  1) + sizeof(PGro
4d00: 75 70 29 2a 73 65 70 61 72 61 74 65 43 61 63 68  up)*separateCach
4d10: 65 3b 0a 20 20 70 43 61 63 68 65 20 3d 20 28 50  e;.  pCache = (P
4d20: 43 61 63 68 65 31 20 2a 29 73 71 6c 69 74 65 33  Cache1 *)sqlite3
4d30: 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 7a 29 3b 0a  MallocZero(sz);.
4d40: 20 20 69 66 28 20 70 43 61 63 68 65 20 29 7b 0a    if( pCache ){.
4d50: 20 20 20 20 69 66 28 20 73 65 70 61 72 61 74 65      if( separate
4d60: 43 61 63 68 65 20 29 7b 0a 20 20 20 20 20 20 70  Cache ){.      p
4d70: 47 72 6f 75 70 20 3d 20 28 50 47 72 6f 75 70 2a  Group = (PGroup*
4d80: 29 26 70 43 61 63 68 65 5b 31 5d 3b 0a 20 20 20  )&pCache[1];.   
4d90: 20 20 20 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e     pGroup->mxPin
4da0: 6e 65 64 20 3d 20 31 30 3b 0a 20 20 20 20 7d 65  ned = 10;.    }e
4db0: 6c 73 65 7b 0a 20 20 20 20 20 20 70 47 72 6f 75  lse{.      pGrou
4dc0: 70 20 3d 20 26 70 63 61 63 68 65 31 2e 67 72 70  p = &pcache1.grp
4dd0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 43 61 63  ;.    }.    pCac
4de0: 68 65 2d 3e 70 47 72 6f 75 70 20 3d 20 70 47 72  he->pGroup = pGr
4df0: 6f 75 70 3b 0a 20 20 20 20 70 43 61 63 68 65 2d  oup;.    pCache-
4e00: 3e 73 7a 50 61 67 65 20 3d 20 73 7a 50 61 67 65  >szPage = szPage
4e10: 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 73 7a  ;.    pCache->sz
4e20: 45 78 74 72 61 20 3d 20 73 7a 45 78 74 72 61 3b  Extra = szExtra;
4e30: 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 62 50 75  .    pCache->bPu
4e40: 72 67 65 61 62 6c 65 20 3d 20 28 62 50 75 72 67  rgeable = (bPurg
4e50: 65 61 62 6c 65 20 3f 20 31 20 3a 20 30 29 3b 0a  eable ? 1 : 0);.
4e60: 20 20 20 20 70 63 61 63 68 65 31 45 6e 74 65 72      pcache1Enter
4e70: 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20  Mutex(pGroup);. 
4e80: 20 20 20 70 63 61 63 68 65 31 52 65 73 69 7a 65     pcache1Resize
4e90: 48 61 73 68 28 70 43 61 63 68 65 29 3b 0a 20 20  Hash(pCache);.  
4ea0: 20 20 69 66 28 20 62 50 75 72 67 65 61 62 6c 65    if( bPurgeable
4eb0: 20 29 7b 0a 20 20 20 20 20 20 70 43 61 63 68 65   ){.      pCache
4ec0: 2d 3e 6e 4d 69 6e 20 3d 20 31 30 3b 0a 20 20 20  ->nMin = 10;.   
4ed0: 20 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50     pGroup->nMinP
4ee0: 61 67 65 20 2b 3d 20 70 43 61 63 68 65 2d 3e 6e  age += pCache->n
4ef0: 4d 69 6e 3b 0a 20 20 20 20 20 20 70 47 72 6f 75  Min;.      pGrou
4f00: 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 20 70 47  p->mxPinned = pG
4f10: 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 2b  roup->nMaxPage +
4f20: 20 31 30 20 2d 20 70 47 72 6f 75 70 2d 3e 6e 4d   10 - pGroup->nM
4f30: 69 6e 50 61 67 65 3b 0a 20 20 20 20 7d 0a 20 20  inPage;.    }.  
4f40: 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75    pcache1LeaveMu
4f50: 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20 20 20  tex(pGroup);.   
4f60: 20 69 66 28 20 70 43 61 63 68 65 2d 3e 6e 48 61   if( pCache->nHa
4f70: 73 68 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 70  sh==0 ){.      p
4f80: 63 61 63 68 65 31 44 65 73 74 72 6f 79 28 28 73  cache1Destroy((s
4f90: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2a 29 70  qlite3_pcache*)p
4fa0: 43 61 63 68 65 29 3b 0a 20 20 20 20 20 20 70 43  Cache);.      pC
4fb0: 61 63 68 65 20 3d 20 30 3b 0a 20 20 20 20 7d 0a  ache = 0;.    }.
4fc0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 28 73 71    }.  return (sq
4fd0: 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 29 70  lite3_pcache *)p
4fe0: 43 61 63 68 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  Cache;.}../*.** 
4ff0: 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  Implementation o
5000: 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63  f the sqlite3_pc
5010: 61 63 68 65 2e 78 43 61 63 68 65 73 69 7a 65 20  ache.xCachesize 
5020: 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 43  method. .**.** C
5030: 6f 6e 66 69 67 75 72 65 20 74 68 65 20 63 61 63  onfigure the cac
5040: 68 65 5f 73 69 7a 65 20 6c 69 6d 69 74 20 66 6f  he_size limit fo
5050: 72 20 61 20 63 61 63 68 65 2e 0a 2a 2f 0a 73 74  r a cache..*/.st
5060: 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65  atic void pcache
5070: 31 43 61 63 68 65 73 69 7a 65 28 73 71 6c 69 74  1Cachesize(sqlit
5080: 65 33 5f 70 63 61 63 68 65 20 2a 70 2c 20 69 6e  e3_pcache *p, in
5090: 74 20 6e 4d 61 78 29 7b 0a 20 20 50 43 61 63 68  t nMax){.  PCach
50a0: 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43  e1 *pCache = (PC
50b0: 61 63 68 65 31 20 2a 29 70 3b 0a 20 20 69 66 28  ache1 *)p;.  if(
50c0: 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61   pCache->bPurgea
50d0: 62 6c 65 20 29 7b 0a 20 20 20 20 50 47 72 6f 75  ble ){.    PGrou
50e0: 70 20 2a 70 47 72 6f 75 70 20 3d 20 70 43 61 63  p *pGroup = pCac
50f0: 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20 20 20 20  he->pGroup;.    
5100: 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65  pcache1EnterMute
5110: 78 28 70 47 72 6f 75 70 29 3b 0a 20 20 20 20 70  x(pGroup);.    p
5120: 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20  Group->nMaxPage 
5130: 2b 3d 20 28 6e 4d 61 78 20 2d 20 70 43 61 63 68  += (nMax - pCach
5140: 65 2d 3e 6e 4d 61 78 29 3b 0a 20 20 20 20 70 47  e->nMax);.    pG
5150: 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d  roup->mxPinned =
5160: 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67   pGroup->nMaxPag
5170: 65 20 2b 20 31 30 20 2d 20 70 47 72 6f 75 70 2d  e + 10 - pGroup-
5180: 3e 6e 4d 69 6e 50 61 67 65 3b 0a 20 20 20 20 70  >nMinPage;.    p
5190: 43 61 63 68 65 2d 3e 6e 4d 61 78 20 3d 20 6e 4d  Cache->nMax = nM
51a0: 61 78 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e  ax;.    pCache->
51b0: 6e 39 30 70 63 74 20 3d 20 70 43 61 63 68 65 2d  n90pct = pCache-
51c0: 3e 6e 4d 61 78 2a 39 2f 31 30 3b 0a 20 20 20 20  >nMax*9/10;.    
51d0: 70 63 61 63 68 65 31 45 6e 66 6f 72 63 65 4d 61  pcache1EnforceMa
51e0: 78 50 61 67 65 28 70 47 72 6f 75 70 29 3b 0a 20  xPage(pGroup);. 
51f0: 20 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d     pcache1LeaveM
5200: 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20 20  utex(pGroup);.  
5210: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65  }.}../*.** Imple
5220: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65  mentation of the
5230: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e   sqlite3_pcache.
5240: 78 53 68 72 69 6e 6b 20 6d 65 74 68 6f 64 2e 20  xShrink method. 
5250: 0a 2a 2a 0a 2a 2a 20 46 72 65 65 20 75 70 20 61  .**.** Free up a
5260: 73 20 6d 75 63 68 20 6d 65 6d 6f 72 79 20 61 73  s much memory as
5270: 20 70 6f 73 73 69 62 6c 65 2e 0a 2a 2f 0a 73 74   possible..*/.st
5280: 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65  atic void pcache
5290: 31 53 68 72 69 6e 6b 28 73 71 6c 69 74 65 33 5f  1Shrink(sqlite3_
52a0: 70 63 61 63 68 65 20 2a 70 29 7b 0a 20 20 50 43  pcache *p){.  PC
52b0: 61 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20  ache1 *pCache = 
52c0: 28 50 43 61 63 68 65 31 2a 29 70 3b 0a 20 20 69  (PCache1*)p;.  i
52d0: 66 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67  f( pCache->bPurg
52e0: 65 61 62 6c 65 20 29 7b 0a 20 20 20 20 50 47 72  eable ){.    PGr
52f0: 6f 75 70 20 2a 70 47 72 6f 75 70 20 3d 20 70 43  oup *pGroup = pC
5300: 61 63 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20 20  ache->pGroup;.  
5310: 20 20 69 6e 74 20 73 61 76 65 64 4d 61 78 50 61    int savedMaxPa
5320: 67 65 3b 0a 20 20 20 20 70 63 61 63 68 65 31 45  ge;.    pcache1E
5330: 6e 74 65 72 4d 75 74 65 78 28 70 47 72 6f 75 70  nterMutex(pGroup
5340: 29 3b 0a 20 20 20 20 73 61 76 65 64 4d 61 78 50  );.    savedMaxP
5350: 61 67 65 20 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d  age = pGroup->nM
5360: 61 78 50 61 67 65 3b 0a 20 20 20 20 70 47 72 6f  axPage;.    pGro
5370: 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 3d 20 30  up->nMaxPage = 0
5380: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e 66  ;.    pcache1Enf
5390: 6f 72 63 65 4d 61 78 50 61 67 65 28 70 47 72 6f  orceMaxPage(pGro
53a0: 75 70 29 3b 0a 20 20 20 20 70 47 72 6f 75 70 2d  up);.    pGroup-
53b0: 3e 6e 4d 61 78 50 61 67 65 20 3d 20 73 61 76 65  >nMaxPage = save
53c0: 64 4d 61 78 50 61 67 65 3b 0a 20 20 20 20 70 63  dMaxPage;.    pc
53d0: 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28  ache1LeaveMutex(
53e0: 70 47 72 6f 75 70 29 3b 0a 20 20 7d 0a 7d 0a 0a  pGroup);.  }.}..
53f0: 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61  /*.** Implementa
5400: 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69  tion of the sqli
5410: 74 65 33 5f 70 63 61 63 68 65 2e 78 50 61 67 65  te3_pcache.xPage
5420: 63 6f 75 6e 74 20 6d 65 74 68 6f 64 2e 20 0a 2a  count method. .*
5430: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 63 61  /.static int pca
5440: 63 68 65 31 50 61 67 65 63 6f 75 6e 74 28 73 71  che1Pagecount(sq
5450: 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 29  lite3_pcache *p)
5460: 7b 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 50 43 61  {.  int n;.  PCa
5470: 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28  che1 *pCache = (
5480: 50 43 61 63 68 65 31 2a 29 70 3b 0a 20 20 70 63  PCache1*)p;.  pc
5490: 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28  ache1EnterMutex(
54a0: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b  pCache->pGroup);
54b0: 0a 20 20 6e 20 3d 20 70 43 61 63 68 65 2d 3e 6e  .  n = pCache->n
54c0: 50 61 67 65 3b 0a 20 20 70 63 61 63 68 65 31 4c  Page;.  pcache1L
54d0: 65 61 76 65 4d 75 74 65 78 28 70 43 61 63 68 65  eaveMutex(pCache
54e0: 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20 72 65 74  ->pGroup);.  ret
54f0: 75 72 6e 20 6e 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a  urn n;.}.../*.**
5500: 20 49 6d 70 6c 65 6d 65 6e 74 20 73 74 65 70 73   Implement steps
5510: 20 33 2c 20 34 2c 20 61 6e 64 20 35 20 6f 66 20   3, 4, and 5 of 
5520: 74 68 65 20 70 63 61 63 68 65 31 46 65 74 63 68  the pcache1Fetch
5530: 28 29 20 61 6c 67 6f 72 69 74 68 6d 20 64 65 73  () algorithm des
5540: 63 72 69 62 65 64 0a 2a 2a 20 69 6e 20 74 68 65  cribed.** in the
5550: 20 68 65 61 64 65 72 20 6f 66 20 74 68 65 20 70   header of the p
5560: 63 61 63 68 65 31 46 65 74 63 68 28 29 20 70 72  cache1Fetch() pr
5570: 6f 63 65 64 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 54  ocedure..**.** T
5580: 68 69 73 20 73 74 65 70 73 20 61 72 65 20 62 72  his steps are br
5590: 6f 6b 65 6e 20 6f 75 74 20 69 6e 74 6f 20 61 20  oken out into a 
55a0: 73 65 70 61 72 61 74 65 20 70 72 6f 63 65 64 75  separate procedu
55b0: 72 65 20 62 65 63 61 75 73 65 20 74 68 65 79 20  re because they 
55c0: 61 72 65 0a 2a 2a 20 75 73 75 61 6c 6c 79 20 6e  are.** usually n
55d0: 6f 74 20 6e 65 65 64 65 64 2c 20 61 6e 64 20 62  ot needed, and b
55e0: 79 20 61 76 6f 69 64 69 6e 67 20 74 68 65 20 73  y avoiding the s
55f0: 74 61 63 6b 20 69 6e 69 74 69 61 6c 69 7a 61 74  tack initializat
5600: 69 6f 6e 20 72 65 71 75 69 72 65 64 0a 2a 2a 20  ion required.** 
5610: 66 6f 72 20 74 68 65 73 65 20 73 74 65 70 73 2c  for these steps,
5620: 20 74 68 65 20 6d 61 69 6e 20 70 63 61 63 68 65   the main pcache
5630: 31 46 65 74 63 68 28 29 20 70 72 6f 63 65 64 75  1Fetch() procedu
5640: 72 65 20 63 61 6e 20 72 75 6e 20 66 61 73 74 65  re can run faste
5650: 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 53 51 4c  r..*/.static SQL
5660: 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20 50 67 48  ITE_NOINLINE PgH
5670: 64 72 31 20 2a 70 63 61 63 68 65 31 46 65 74 63  dr1 *pcache1Fetc
5680: 68 53 74 61 67 65 32 28 0a 20 20 50 43 61 63 68  hStage2(.  PCach
5690: 65 31 20 2a 70 43 61 63 68 65 2c 20 0a 20 20 75  e1 *pCache, .  u
56a0: 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4b 65 79  nsigned int iKey
56b0: 2c 20 0a 20 20 69 6e 74 20 63 72 65 61 74 65 46  , .  int createF
56c0: 6c 61 67 0a 29 7b 0a 20 20 75 6e 73 69 67 6e 65  lag.){.  unsigne
56d0: 64 20 69 6e 74 20 6e 50 69 6e 6e 65 64 3b 0a 20  d int nPinned;. 
56e0: 20 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70 20   PGroup *pGroup 
56f0: 3d 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70  = pCache->pGroup
5700: 3b 0a 20 20 50 67 48 64 72 31 20 2a 70 50 61 67  ;.  PgHdr1 *pPag
5710: 65 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20 53 74 65  e = 0;..  /* Ste
5720: 70 20 33 3a 20 41 62 6f 72 74 20 69 66 20 63 72  p 3: Abort if cr
5730: 65 61 74 65 46 6c 61 67 20 69 73 20 31 20 62 75  eateFlag is 1 bu
5740: 74 20 74 68 65 20 63 61 63 68 65 20 69 73 20 6e  t the cache is n
5750: 65 61 72 6c 79 20 66 75 6c 6c 20 2a 2f 0a 20 20  early full */.  
5760: 61 73 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e  assert( pCache->
5770: 6e 50 61 67 65 20 3e 3d 20 70 43 61 63 68 65 2d  nPage >= pCache-
5780: 3e 6e 52 65 63 79 63 6c 61 62 6c 65 20 29 3b 0a  >nRecyclable );.
5790: 20 20 6e 50 69 6e 6e 65 64 20 3d 20 70 43 61 63    nPinned = pCac
57a0: 68 65 2d 3e 6e 50 61 67 65 20 2d 20 70 43 61 63  he->nPage - pCac
57b0: 68 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65 3b  he->nRecyclable;
57c0: 0a 20 20 61 73 73 65 72 74 28 20 70 47 72 6f 75  .  assert( pGrou
57d0: 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 3d 20 70  p->mxPinned == p
57e0: 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20  Group->nMaxPage 
57f0: 2b 20 31 30 20 2d 20 70 47 72 6f 75 70 2d 3e 6e  + 10 - pGroup->n
5800: 4d 69 6e 50 61 67 65 20 29 3b 0a 20 20 61 73 73  MinPage );.  ass
5810: 65 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 39 30  ert( pCache->n90
5820: 70 63 74 20 3d 3d 20 70 43 61 63 68 65 2d 3e 6e  pct == pCache->n
5830: 4d 61 78 2a 39 2f 31 30 20 29 3b 0a 20 20 69 66  Max*9/10 );.  if
5840: 28 20 63 72 65 61 74 65 46 6c 61 67 3d 3d 31 20  ( createFlag==1 
5850: 26 26 20 28 0a 20 20 20 20 20 20 20 20 6e 50 69  && (.        nPi
5860: 6e 6e 65 64 3e 3d 70 47 72 6f 75 70 2d 3e 6d 78  nned>=pGroup->mx
5870: 50 69 6e 6e 65 64 0a 20 20 20 20 20 7c 7c 20 6e  Pinned.     || n
5880: 50 69 6e 6e 65 64 3e 3d 70 43 61 63 68 65 2d 3e  Pinned>=pCache->
5890: 6e 39 30 70 63 74 0a 20 20 20 20 20 7c 7c 20 28  n90pct.     || (
58a0: 70 63 61 63 68 65 31 55 6e 64 65 72 4d 65 6d 6f  pcache1UnderMemo
58b0: 72 79 50 72 65 73 73 75 72 65 28 70 43 61 63 68  ryPressure(pCach
58c0: 65 29 20 26 26 20 70 43 61 63 68 65 2d 3e 6e 52  e) && pCache->nR
58d0: 65 63 79 63 6c 61 62 6c 65 3c 6e 50 69 6e 6e 65  ecyclable<nPinne
58e0: 64 29 0a 20 20 29 29 7b 0a 20 20 20 20 72 65 74  d).  )){.    ret
58f0: 75 72 6e 20 30 3b 0a 20 20 7d 0a 0a 20 20 69 66  urn 0;.  }..  if
5900: 28 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 3e  ( pCache->nPage>
5910: 3d 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 20 29  =pCache->nHash )
5920: 20 70 63 61 63 68 65 31 52 65 73 69 7a 65 48 61   pcache1ResizeHa
5930: 73 68 28 70 43 61 63 68 65 29 3b 0a 20 20 61 73  sh(pCache);.  as
5940: 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 48  sert( pCache->nH
5950: 61 73 68 3e 30 20 26 26 20 70 43 61 63 68 65 2d  ash>0 && pCache-
5960: 3e 61 70 48 61 73 68 20 29 3b 0a 0a 20 20 2f 2a  >apHash );..  /*
5970: 20 53 74 65 70 20 34 2e 20 54 72 79 20 74 6f 20   Step 4. Try to 
5980: 72 65 63 79 63 6c 65 20 61 20 70 61 67 65 2e 20  recycle a page. 
5990: 2a 2f 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d  */.  if( pCache-
59a0: 3e 62 50 75 72 67 65 61 62 6c 65 20 26 26 20 70  >bPurgeable && p
59b0: 47 72 6f 75 70 2d 3e 70 4c 72 75 54 61 69 6c 20  Group->pLruTail 
59c0: 26 26 20 28 0a 20 20 20 20 20 20 20 20 20 28 70  && (.         (p
59d0: 43 61 63 68 65 2d 3e 6e 50 61 67 65 2b 31 3e 3d  Cache->nPage+1>=
59e0: 70 43 61 63 68 65 2d 3e 6e 4d 61 78 29 0a 20 20  pCache->nMax).  
59f0: 20 20 20 20 7c 7c 20 70 47 72 6f 75 70 2d 3e 6e      || pGroup->n
5a00: 43 75 72 72 65 6e 74 50 61 67 65 3e 3d 70 47 72  CurrentPage>=pGr
5a10: 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 0a 20 20  oup->nMaxPage.  
5a20: 20 20 20 20 7c 7c 20 70 63 61 63 68 65 31 55 6e      || pcache1Un
5a30: 64 65 72 4d 65 6d 6f 72 79 50 72 65 73 73 75 72  derMemoryPressur
5a40: 65 28 70 43 61 63 68 65 29 0a 20 20 29 29 7b 0a  e(pCache).  )){.
5a50: 20 20 20 20 50 43 61 63 68 65 31 20 2a 70 4f 74      PCache1 *pOt
5a60: 68 65 72 3b 0a 20 20 20 20 70 50 61 67 65 20 3d  her;.    pPage =
5a70: 20 70 47 72 6f 75 70 2d 3e 70 4c 72 75 54 61 69   pGroup->pLruTai
5a80: 6c 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70  l;.    assert( p
5a90: 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d  Page->isPinned==
5aa0: 30 20 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31  0 );.    pcache1
5ab0: 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73 68 28 70  RemoveFromHash(p
5ac0: 50 61 67 65 29 3b 0a 20 20 20 20 70 63 61 63 68  Page);.    pcach
5ad0: 65 31 50 69 6e 50 61 67 65 28 70 50 61 67 65 29  e1PinPage(pPage)
5ae0: 3b 0a 20 20 20 20 70 4f 74 68 65 72 20 3d 20 70  ;.    pOther = p
5af0: 50 61 67 65 2d 3e 70 43 61 63 68 65 3b 0a 0a 20  Page->pCache;.. 
5b00: 20 20 20 2f 2a 20 57 65 20 77 61 6e 74 20 74 6f     /* We want to
5b10: 20 76 65 72 69 66 79 20 74 68 61 74 20 73 7a 50   verify that szP
5b20: 61 67 65 20 61 6e 64 20 73 7a 45 78 74 72 61 20  age and szExtra 
5b30: 61 72 65 20 74 68 65 20 73 61 6d 65 20 66 6f 72  are the same for
5b40: 20 70 4f 74 68 65 72 0a 20 20 20 20 2a 2a 20 61   pOther.    ** a
5b50: 6e 64 20 70 43 61 63 68 65 2e 20 20 41 73 73 65  nd pCache.  Asse
5b60: 72 74 20 74 68 61 74 20 77 65 20 63 61 6e 20 76  rt that we can v
5b70: 65 72 69 66 79 20 74 68 69 73 20 62 79 20 63 6f  erify this by co
5b80: 6d 70 61 72 69 6e 67 20 73 75 6d 73 2e 20 2a 2f  mparing sums. */
5b90: 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 70 43  .    assert( (pC
5ba0: 61 63 68 65 2d 3e 73 7a 50 61 67 65 20 26 20 28  ache->szPage & (
5bb0: 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 2d 31  pCache->szPage-1
5bc0: 29 29 3d 3d 30 20 26 26 20 70 43 61 63 68 65 2d  ))==0 && pCache-
5bd0: 3e 73 7a 50 61 67 65 3e 3d 35 31 32 20 29 3b 0a  >szPage>=512 );.
5be0: 20 20 20 20 61 73 73 65 72 74 28 20 70 43 61 63      assert( pCac
5bf0: 68 65 2d 3e 73 7a 45 78 74 72 61 3c 35 31 32 20  he->szExtra<512 
5c00: 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 28  );.    assert( (
5c10: 70 4f 74 68 65 72 2d 3e 73 7a 50 61 67 65 20 26  pOther->szPage &
5c20: 20 28 70 4f 74 68 65 72 2d 3e 73 7a 50 61 67 65   (pOther->szPage
5c30: 2d 31 29 29 3d 3d 30 20 26 26 20 70 4f 74 68 65  -1))==0 && pOthe
5c40: 72 2d 3e 73 7a 50 61 67 65 3e 3d 35 31 32 20 29  r->szPage>=512 )
5c50: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 4f  ;.    assert( pO
5c60: 74 68 65 72 2d 3e 73 7a 45 78 74 72 61 3c 35 31  ther->szExtra<51
5c70: 32 20 29 3b 0a 0a 20 20 20 20 69 66 28 20 70 4f  2 );..    if( pO
5c80: 74 68 65 72 2d 3e 73 7a 50 61 67 65 2b 70 4f 74  ther->szPage+pOt
5c90: 68 65 72 2d 3e 73 7a 45 78 74 72 61 20 21 3d 20  her->szExtra != 
5ca0: 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 2b 70  pCache->szPage+p
5cb0: 43 61 63 68 65 2d 3e 73 7a 45 78 74 72 61 20 29  Cache->szExtra )
5cc0: 7b 0a 20 20 20 20 20 20 70 63 61 63 68 65 31 46  {.      pcache1F
5cd0: 72 65 65 50 61 67 65 28 70 50 61 67 65 29 3b 0a  reePage(pPage);.
5ce0: 20 20 20 20 20 20 70 50 61 67 65 20 3d 20 30 3b        pPage = 0;
5cf0: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  .    }else{.    
5d00: 20 20 70 47 72 6f 75 70 2d 3e 6e 43 75 72 72 65    pGroup->nCurre
5d10: 6e 74 50 61 67 65 20 2d 3d 20 28 70 4f 74 68 65  ntPage -= (pOthe
5d20: 72 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 2d 20  r->bPurgeable - 
5d30: 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62  pCache->bPurgeab
5d40: 6c 65 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a  le);.    }.  }..
5d50: 20 20 2f 2a 20 53 74 65 70 20 35 2e 20 49 66 20    /* Step 5. If 
5d60: 61 20 75 73 61 62 6c 65 20 70 61 67 65 20 62 75  a usable page bu
5d70: 66 66 65 72 20 68 61 73 20 73 74 69 6c 6c 20 6e  ffer has still n
5d80: 6f 74 20 62 65 65 6e 20 66 6f 75 6e 64 2c 20 0a  ot been found, .
5d90: 20 20 2a 2a 20 61 74 74 65 6d 70 74 20 74 6f 20    ** attempt to 
5da0: 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 6f  allocate a new o
5db0: 6e 65 2e 20 0a 20 20 2a 2f 0a 20 20 69 66 28 20  ne. .  */.  if( 
5dc0: 21 70 50 61 67 65 20 29 7b 0a 20 20 20 20 69 66  !pPage ){.    if
5dd0: 28 20 63 72 65 61 74 65 46 6c 61 67 3d 3d 31 20  ( createFlag==1 
5de0: 29 20 73 71 6c 69 74 65 33 42 65 67 69 6e 42 65  ) sqlite3BeginBe
5df0: 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20  nignMalloc();.  
5e00: 20 20 70 50 61 67 65 20 3d 20 70 63 61 63 68 65    pPage = pcache
5e10: 31 41 6c 6c 6f 63 50 61 67 65 28 70 43 61 63 68  1AllocPage(pCach
5e20: 65 29 3b 0a 20 20 20 20 69 66 28 20 63 72 65 61  e);.    if( crea
5e30: 74 65 46 6c 61 67 3d 3d 31 20 29 20 73 71 6c 69  teFlag==1 ) sqli
5e40: 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c  te3EndBenignMall
5e50: 6f 63 28 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28  oc();.  }..  if(
5e60: 20 70 50 61 67 65 20 29 7b 0a 20 20 20 20 75 6e   pPage ){.    un
5e70: 73 69 67 6e 65 64 20 69 6e 74 20 68 20 3d 20 69  signed int h = i
5e80: 4b 65 79 20 25 20 70 43 61 63 68 65 2d 3e 6e 48  Key % pCache->nH
5e90: 61 73 68 3b 0a 20 20 20 20 70 43 61 63 68 65 2d  ash;.    pCache-
5ea0: 3e 6e 50 61 67 65 2b 2b 3b 0a 20 20 20 20 70 50  >nPage++;.    pP
5eb0: 61 67 65 2d 3e 69 4b 65 79 20 3d 20 69 4b 65 79  age->iKey = iKey
5ec0: 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 70 4e 65  ;.    pPage->pNe
5ed0: 78 74 20 3d 20 70 43 61 63 68 65 2d 3e 61 70 48  xt = pCache->apH
5ee0: 61 73 68 5b 68 5d 3b 0a 20 20 20 20 70 50 61 67  ash[h];.    pPag
5ef0: 65 2d 3e 70 43 61 63 68 65 20 3d 20 70 43 61 63  e->pCache = pCac
5f00: 68 65 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 70  he;.    pPage->p
5f10: 4c 72 75 50 72 65 76 20 3d 20 30 3b 0a 20 20 20  LruPrev = 0;.   
5f20: 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74   pPage->pLruNext
5f30: 20 3d 20 30 3b 0a 20 20 20 20 70 50 61 67 65 2d   = 0;.    pPage-
5f40: 3e 69 73 50 69 6e 6e 65 64 20 3d 20 31 3b 0a 20  >isPinned = 1;. 
5f50: 20 20 20 2a 28 76 6f 69 64 20 2a 2a 29 70 50 61     *(void **)pPa
5f60: 67 65 2d 3e 70 61 67 65 2e 70 45 78 74 72 61 20  ge->page.pExtra 
5f70: 3d 20 30 3b 0a 20 20 20 20 70 43 61 63 68 65 2d  = 0;.    pCache-
5f80: 3e 61 70 48 61 73 68 5b 68 5d 20 3d 20 70 50 61  >apHash[h] = pPa
5f90: 67 65 3b 0a 20 20 20 20 69 66 28 20 69 4b 65 79  ge;.    if( iKey
5fa0: 3e 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79  >pCache->iMaxKey
5fb0: 20 29 7b 0a 20 20 20 20 20 20 70 43 61 63 68 65   ){.      pCache
5fc0: 2d 3e 69 4d 61 78 4b 65 79 20 3d 20 69 4b 65 79  ->iMaxKey = iKey
5fd0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65  ;.    }.  }.  re
5fe0: 74 75 72 6e 20 70 50 61 67 65 3b 0a 7d 0a 0a 2f  turn pPage;.}../
5ff0: 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74  *.** Implementat
6000: 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74  ion of the sqlit
6010: 65 33 5f 70 63 61 63 68 65 2e 78 46 65 74 63 68  e3_pcache.xFetch
6020: 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20   method. .**.** 
6030: 46 65 74 63 68 20 61 20 70 61 67 65 20 62 79 20  Fetch a page by 
6040: 6b 65 79 20 76 61 6c 75 65 2e 0a 2a 2a 0a 2a 2a  key value..**.**
6050: 20 57 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20   Whether or not 
6060: 61 20 6e 65 77 20 70 61 67 65 20 6d 61 79 20 62  a new page may b
6070: 65 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 20 74  e allocated by t
6080: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 64 65 70  his function dep
6090: 65 6e 64 73 20 6f 6e 0a 2a 2a 20 74 68 65 20 76  ends on.** the v
60a0: 61 6c 75 65 20 6f 66 20 74 68 65 20 63 72 65 61  alue of the crea
60b0: 74 65 46 6c 61 67 20 61 72 67 75 6d 65 6e 74 2e  teFlag argument.
60c0: 20 20 30 20 6d 65 61 6e 73 20 64 6f 20 6e 6f 74    0 means do not
60d0: 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 0a   allocate a new.
60e0: 2a 2a 20 70 61 67 65 2e 20 20 31 20 6d 65 61 6e  ** page.  1 mean
60f0: 73 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77  s allocate a new
6100: 20 70 61 67 65 20 69 66 20 73 70 61 63 65 20 69   page if space i
6110: 73 20 65 61 73 69 6c 79 20 61 76 61 69 6c 61 62  s easily availab
6120: 6c 65 2e 20 20 32 20 0a 2a 2a 20 6d 65 61 6e 73  le.  2 .** means
6130: 20 74 6f 20 74 72 79 20 72 65 61 6c 6c 79 20 68   to try really h
6140: 61 72 64 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20  ard to allocate 
6150: 61 20 6e 65 77 20 70 61 67 65 2e 0a 2a 2a 0a 2a  a new page..**.*
6160: 2a 20 46 6f 72 20 61 20 6e 6f 6e 2d 70 75 72 67  * For a non-purg
6170: 65 61 62 6c 65 20 63 61 63 68 65 20 28 61 20 63  eable cache (a c
6180: 61 63 68 65 20 75 73 65 64 20 61 73 20 74 68 65  ache used as the
6190: 20 73 74 6f 72 61 67 65 20 66 6f 72 20 61 6e 20   storage for an 
61a0: 69 6e 2d 6d 65 6d 6f 72 79 0a 2a 2a 20 64 61 74  in-memory.** dat
61b0: 61 62 61 73 65 29 20 74 68 65 72 65 20 69 73 20  abase) there is 
61c0: 72 65 61 6c 6c 79 20 6e 6f 20 64 69 66 66 65 72  really no differ
61d0: 65 6e 63 65 20 62 65 74 77 65 65 6e 20 63 72 65  ence between cre
61e0: 61 74 65 46 6c 61 67 20 31 20 61 6e 64 20 32 2e  ateFlag 1 and 2.
61f0: 20 20 53 6f 0a 2a 2a 20 74 68 65 20 63 61 6c 6c    So.** the call
6200: 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 28 70 63  ing function (pc
6210: 61 63 68 65 2e 63 29 20 77 69 6c 6c 20 6e 65 76  ache.c) will nev
6220: 65 72 20 68 61 76 65 20 61 20 63 72 65 61 74 65  er have a create
6230: 46 6c 61 67 20 6f 66 20 31 20 6f 6e 0a 2a 2a 20  Flag of 1 on.** 
6240: 61 20 6e 6f 6e 2d 70 75 72 67 65 61 62 6c 65 20  a non-purgeable 
6250: 63 61 63 68 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65  cache..**.** The
6260: 72 65 20 61 72 65 20 74 68 72 65 65 20 64 69 66  re are three dif
6270: 66 65 72 65 6e 74 20 61 70 70 72 6f 61 63 68 65  ferent approache
6280: 73 20 74 6f 20 6f 62 74 61 69 6e 69 6e 67 20 73  s to obtaining s
6290: 70 61 63 65 20 66 6f 72 20 61 20 70 61 67 65 2c  pace for a page,
62a0: 0a 2a 2a 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e  .** depending on
62b0: 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 70 61   the value of pa
62c0: 72 61 6d 65 74 65 72 20 63 72 65 61 74 65 46 6c  rameter createFl
62d0: 61 67 20 28 77 68 69 63 68 20 6d 61 79 20 62 65  ag (which may be
62e0: 20 30 2c 20 31 20 6f 72 20 32 29 2e 0a 2a 2a 0a   0, 1 or 2)..**.
62f0: 2a 2a 20 20 20 31 2e 20 52 65 67 61 72 64 6c 65  **   1. Regardle
6300: 73 73 20 6f 66 20 74 68 65 20 76 61 6c 75 65 20  ss of the value 
6310: 6f 66 20 63 72 65 61 74 65 46 6c 61 67 2c 20 74  of createFlag, t
6320: 68 65 20 63 61 63 68 65 20 69 73 20 73 65 61 72  he cache is sear
6330: 63 68 65 64 20 66 6f 72 20 61 20 0a 2a 2a 20 20  ched for a .**  
6340: 20 20 20 20 63 6f 70 79 20 6f 66 20 74 68 65 20      copy of the 
6350: 72 65 71 75 65 73 74 65 64 20 70 61 67 65 2e 20  requested page. 
6360: 49 66 20 6f 6e 65 20 69 73 20 66 6f 75 6e 64 2c  If one is found,
6370: 20 69 74 20 69 73 20 72 65 74 75 72 6e 65 64 2e   it is returned.
6380: 0a 2a 2a 0a 2a 2a 20 20 20 32 2e 20 49 66 20 63  .**.**   2. If c
6390: 72 65 61 74 65 46 6c 61 67 3d 3d 30 20 61 6e 64  reateFlag==0 and
63a0: 20 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f 74   the page is not
63b0: 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65 20   already in the 
63c0: 63 61 63 68 65 2c 20 4e 55 4c 4c 20 69 73 0a 2a  cache, NULL is.*
63d0: 2a 20 20 20 20 20 20 72 65 74 75 72 6e 65 64 2e  *      returned.
63e0: 0a 2a 2a 0a 2a 2a 20 20 20 33 2e 20 49 66 20 63  .**.**   3. If c
63f0: 72 65 61 74 65 46 6c 61 67 20 69 73 20 31 2c 20  reateFlag is 1, 
6400: 61 6e 64 20 74 68 65 20 70 61 67 65 20 69 73 20  and the page is 
6410: 6e 6f 74 20 61 6c 72 65 61 64 79 20 69 6e 20 74  not already in t
6420: 68 65 20 63 61 63 68 65 2c 20 74 68 65 6e 0a 2a  he cache, then.*
6430: 2a 20 20 20 20 20 20 72 65 74 75 72 6e 20 4e 55  *      return NU
6440: 4c 4c 20 28 64 6f 20 6e 6f 74 20 61 6c 6c 6f 63  LL (do not alloc
6450: 61 74 65 20 61 20 6e 65 77 20 70 61 67 65 29 20  ate a new page) 
6460: 69 66 20 61 6e 79 20 6f 66 20 74 68 65 20 66 6f  if any of the fo
6470: 6c 6c 6f 77 69 6e 67 0a 2a 2a 20 20 20 20 20 20  llowing.**      
6480: 63 6f 6e 64 69 74 69 6f 6e 73 20 61 72 65 20 74  conditions are t
6490: 72 75 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20  rue:.**.**      
64a0: 20 28 61 29 20 74 68 65 20 6e 75 6d 62 65 72 20   (a) the number 
64b0: 6f 66 20 70 61 67 65 73 20 70 69 6e 6e 65 64 20  of pages pinned 
64c0: 62 79 20 74 68 65 20 63 61 63 68 65 20 69 73 20  by the cache is 
64d0: 67 72 65 61 74 65 72 20 74 68 61 6e 0a 2a 2a 20  greater than.** 
64e0: 20 20 20 20 20 20 20 20 20 20 50 43 61 63 68 65            PCache
64f0: 31 2e 6e 4d 61 78 2c 20 6f 72 0a 2a 2a 0a 2a 2a  1.nMax, or.**.**
6500: 20 20 20 20 20 20 20 28 62 29 20 74 68 65 20 6e         (b) the n
6510: 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 70  umber of pages p
6520: 69 6e 6e 65 64 20 62 79 20 74 68 65 20 63 61 63  inned by the cac
6530: 68 65 20 69 73 20 67 72 65 61 74 65 72 20 74 68  he is greater th
6540: 61 6e 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20  an.**           
6550: 74 68 65 20 73 75 6d 20 6f 66 20 6e 4d 61 78 20  the sum of nMax 
6560: 66 6f 72 20 61 6c 6c 20 70 75 72 67 65 61 62 6c  for all purgeabl
6570: 65 20 63 61 63 68 65 73 2c 20 6c 65 73 73 20 74  e caches, less t
6580: 68 65 20 73 75 6d 20 6f 66 20 0a 2a 2a 20 20 20  he sum of .**   
6590: 20 20 20 20 20 20 20 20 6e 4d 69 6e 20 66 6f 72          nMin for
65a0: 20 61 6c 6c 20 6f 74 68 65 72 20 70 75 72 67 65   all other purge
65b0: 61 62 6c 65 20 63 61 63 68 65 73 2c 20 6f 72 0a  able caches, or.
65c0: 2a 2a 0a 2a 2a 20 20 20 34 2e 20 49 66 20 6e 6f  **.**   4. If no
65d0: 6e 65 20 6f 66 20 74 68 65 20 66 69 72 73 74 20  ne of the first 
65e0: 74 68 72 65 65 20 63 6f 6e 64 69 74 69 6f 6e 73  three conditions
65f0: 20 61 70 70 6c 79 20 61 6e 64 20 74 68 65 20 63   apply and the c
6600: 61 63 68 65 20 69 73 20 6d 61 72 6b 65 64 0a 2a  ache is marked.*
6610: 2a 20 20 20 20 20 20 61 73 20 70 75 72 67 65 61  *      as purgea
6620: 62 6c 65 2c 20 61 6e 64 20 69 66 20 6f 6e 65 20  ble, and if one 
6630: 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  of the following
6640: 20 69 73 20 74 72 75 65 3a 0a 2a 2a 0a 2a 2a 20   is true:.**.** 
6650: 20 20 20 20 20 20 28 61 29 20 54 68 65 20 6e 75        (a) The nu
6660: 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 61 6c  mber of pages al
6670: 6c 6f 63 61 74 65 64 20 66 6f 72 20 74 68 65 20  located for the 
6680: 63 61 63 68 65 20 69 73 20 61 6c 72 65 61 64 79  cache is already
6690: 20 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 50   .**           P
66a0: 43 61 63 68 65 31 2e 6e 4d 61 78 2c 20 6f 72 0a  Cache1.nMax, or.
66b0: 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 28 62 29 20  **.**       (b) 
66c0: 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61  The number of pa
66d0: 67 65 73 20 61 6c 6c 6f 63 61 74 65 64 20 66 6f  ges allocated fo
66e0: 72 20 61 6c 6c 20 70 75 72 67 65 61 62 6c 65 20  r all purgeable 
66f0: 63 61 63 68 65 73 20 69 73 0a 2a 2a 20 20 20 20  caches is.**    
6700: 20 20 20 20 20 20 20 61 6c 72 65 61 64 79 20 65         already e
6710: 71 75 61 6c 20 74 6f 20 6f 72 20 67 72 65 61 74  qual to or great
6720: 65 72 20 74 68 61 6e 20 74 68 65 20 73 75 6d 20  er than the sum 
6730: 6f 66 20 6e 4d 61 78 20 66 6f 72 20 61 6c 6c 0a  of nMax for all.
6740: 2a 2a 20 20 20 20 20 20 20 20 20 20 20 70 75 72  **           pur
6750: 67 65 61 62 6c 65 20 63 61 63 68 65 73 2c 0a 2a  geable caches,.*
6760: 2a 0a 2a 2a 20 20 20 20 20 20 20 28 63 29 20 54  *.**       (c) T
6770: 68 65 20 73 79 73 74 65 6d 20 69 73 20 75 6e 64  he system is und
6780: 65 72 20 6d 65 6d 6f 72 79 20 70 72 65 73 73 75  er memory pressu
6790: 72 65 20 61 6e 64 20 77 61 6e 74 73 20 74 6f 20  re and wants to 
67a0: 61 76 6f 69 64 0a 2a 2a 20 20 20 20 20 20 20 20  avoid.**        
67b0: 20 20 20 75 6e 6e 65 63 65 73 73 61 72 79 20 70     unnecessary p
67c0: 61 67 65 73 20 63 61 63 68 65 20 65 6e 74 72 79  ages cache entry
67d0: 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 0a 2a 2a 0a   allocations.**.
67e0: 2a 2a 20 20 20 20 20 20 74 68 65 6e 20 61 74 74  **      then att
67f0: 65 6d 70 74 20 74 6f 20 72 65 63 79 63 6c 65 20  empt to recycle 
6800: 61 20 70 61 67 65 20 66 72 6f 6d 20 74 68 65 20  a page from the 
6810: 4c 52 55 20 6c 69 73 74 2e 20 49 66 20 69 74 20  LRU list. If it 
6820: 69 73 20 74 68 65 20 72 69 67 68 74 0a 2a 2a 20  is the right.** 
6830: 20 20 20 20 20 73 69 7a 65 2c 20 72 65 74 75 72       size, retur
6840: 6e 20 74 68 65 20 72 65 63 79 63 6c 65 64 20 62  n the recycled b
6850: 75 66 66 65 72 2e 20 4f 74 68 65 72 77 69 73 65  uffer. Otherwise
6860: 2c 20 66 72 65 65 20 74 68 65 20 62 75 66 66 65  , free the buffe
6870: 72 20 61 6e 64 0a 2a 2a 20 20 20 20 20 20 70 72  r and.**      pr
6880: 6f 63 65 65 64 20 74 6f 20 73 74 65 70 20 35 2e  oceed to step 5.
6890: 20 0a 2a 2a 0a 2a 2a 20 20 20 35 2e 20 4f 74 68   .**.**   5. Oth
68a0: 65 72 77 69 73 65 2c 20 61 6c 6c 6f 63 61 74 65  erwise, allocate
68b0: 20 61 6e 64 20 72 65 74 75 72 6e 20 61 20 6e 65   and return a ne
68c0: 77 20 70 61 67 65 20 62 75 66 66 65 72 2e 0a 2a  w page buffer..*
68d0: 2f 0a 73 74 61 74 69 63 20 73 71 6c 69 74 65 33  /.static sqlite3
68e0: 5f 70 63 61 63 68 65 5f 70 61 67 65 20 2a 70 63  _pcache_page *pc
68f0: 61 63 68 65 31 46 65 74 63 68 28 0a 20 20 73 71  ache1Fetch(.  sq
6900: 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 2c  lite3_pcache *p,
6910: 20 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74   .  unsigned int
6920: 20 69 4b 65 79 2c 20 0a 20 20 69 6e 74 20 63 72   iKey, .  int cr
6930: 65 61 74 65 46 6c 61 67 0a 29 7b 0a 20 20 50 43  eateFlag.){.  PC
6940: 61 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20  ache1 *pCache = 
6950: 28 50 43 61 63 68 65 31 20 2a 29 70 3b 0a 20 20  (PCache1 *)p;.  
6960: 50 67 48 64 72 31 20 2a 70 50 61 67 65 20 3d 20  PgHdr1 *pPage = 
6970: 30 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 6f 66  0;..  assert( of
6980: 66 73 65 74 6f 66 28 50 67 48 64 72 31 2c 70 61  fsetof(PgHdr1,pa
6990: 67 65 29 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65  ge)==0 );.  asse
69a0: 72 74 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72  rt( pCache->bPur
69b0: 67 65 61 62 6c 65 20 7c 7c 20 63 72 65 61 74 65  geable || create
69c0: 46 6c 61 67 21 3d 31 20 29 3b 0a 20 20 61 73 73  Flag!=1 );.  ass
69d0: 65 72 74 28 20 70 43 61 63 68 65 2d 3e 62 50 75  ert( pCache->bPu
69e0: 72 67 65 61 62 6c 65 20 7c 7c 20 70 43 61 63 68  rgeable || pCach
69f0: 65 2d 3e 6e 4d 69 6e 3d 3d 30 20 29 3b 0a 20 20  e->nMin==0 );.  
6a00: 61 73 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e  assert( pCache->
6a10: 62 50 75 72 67 65 61 62 6c 65 3d 3d 30 20 7c 7c  bPurgeable==0 ||
6a20: 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 3d 3d 31   pCache->nMin==1
6a30: 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  0 );.  assert( p
6a40: 43 61 63 68 65 2d 3e 6e 4d 69 6e 3d 3d 30 20 7c  Cache->nMin==0 |
6a50: 7c 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65  | pCache->bPurge
6a60: 61 62 6c 65 20 29 3b 0a 20 20 61 73 73 65 72 74  able );.  assert
6a70: 28 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 3e  ( pCache->nHash>
6a80: 30 20 29 3b 0a 20 20 70 63 61 63 68 65 31 45 6e  0 );.  pcache1En
6a90: 74 65 72 4d 75 74 65 78 28 70 43 61 63 68 65 2d  terMutex(pCache-
6aa0: 3e 70 47 72 6f 75 70 29 3b 0a 0a 20 20 2f 2a 20  >pGroup);..  /* 
6ab0: 53 74 65 70 20 31 3a 20 53 65 61 72 63 68 20 74  Step 1: Search t
6ac0: 68 65 20 68 61 73 68 20 74 61 62 6c 65 20 66 6f  he hash table fo
6ad0: 72 20 61 6e 20 65 78 69 73 74 69 6e 67 20 65 6e  r an existing en
6ae0: 74 72 79 2e 20 2a 2f 0a 20 20 70 50 61 67 65 20  try. */.  pPage 
6af0: 3d 20 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68  = pCache->apHash
6b00: 5b 69 4b 65 79 20 25 20 70 43 61 63 68 65 2d 3e  [iKey % pCache->
6b10: 6e 48 61 73 68 5d 3b 0a 20 20 77 68 69 6c 65 28  nHash];.  while(
6b20: 20 70 50 61 67 65 20 26 26 20 70 50 61 67 65 2d   pPage && pPage-
6b30: 3e 69 4b 65 79 21 3d 69 4b 65 79 20 29 7b 20 70  >iKey!=iKey ){ p
6b40: 50 61 67 65 20 3d 20 70 50 61 67 65 2d 3e 70 4e  Page = pPage->pN
6b50: 65 78 74 3b 20 7d 0a 0a 20 20 2f 2a 20 53 74 65  ext; }..  /* Ste
6b60: 70 20 32 3a 20 41 62 6f 72 74 20 69 66 20 6e 6f  p 2: Abort if no
6b70: 20 65 78 69 73 74 69 6e 67 20 70 61 67 65 20 69   existing page i
6b80: 73 20 66 6f 75 6e 64 20 61 6e 64 20 63 72 65 61  s found and crea
6b90: 74 65 46 6c 61 67 20 69 73 20 30 20 2a 2f 0a 20  teFlag is 0 */. 
6ba0: 20 69 66 28 20 70 50 61 67 65 20 29 7b 0a 20 20   if( pPage ){.  
6bb0: 20 20 69 66 28 20 21 70 50 61 67 65 2d 3e 69 73    if( !pPage->is
6bc0: 50 69 6e 6e 65 64 20 29 20 70 63 61 63 68 65 31  Pinned ) pcache1
6bd0: 50 69 6e 50 61 67 65 28 70 50 61 67 65 29 3b 0a  PinPage(pPage);.
6be0: 20 20 7d 65 6c 73 65 20 69 66 28 20 63 72 65 61    }else if( crea
6bf0: 74 65 46 6c 61 67 20 29 7b 0a 20 20 20 20 2f 2a  teFlag ){.    /*
6c00: 20 53 74 65 70 73 20 33 2c 20 34 2c 20 61 6e 64   Steps 3, 4, and
6c10: 20 35 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62   5 implemented b
6c20: 79 20 74 68 69 73 20 73 75 62 72 6f 75 74 69 6e  y this subroutin
6c30: 65 20 2a 2f 0a 20 20 20 20 70 50 61 67 65 20 3d  e */.    pPage =
6c40: 20 70 63 61 63 68 65 31 46 65 74 63 68 53 74 61   pcache1FetchSta
6c50: 67 65 32 28 70 43 61 63 68 65 2c 20 69 4b 65 79  ge2(pCache, iKey
6c60: 2c 20 63 72 65 61 74 65 46 6c 61 67 29 3b 0a 20  , createFlag);. 
6c70: 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 50 61   }.  assert( pPa
6c80: 67 65 3d 3d 30 20 7c 7c 20 70 43 61 63 68 65 2d  ge==0 || pCache-
6c90: 3e 69 4d 61 78 4b 65 79 3e 3d 69 4b 65 79 20 29  >iMaxKey>=iKey )
6ca0: 3b 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76 65  ;.  pcache1Leave
6cb0: 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47  Mutex(pCache->pG
6cc0: 72 6f 75 70 29 3b 0a 20 20 72 65 74 75 72 6e 20  roup);.  return 
6cd0: 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f  (sqlite3_pcache_
6ce0: 70 61 67 65 2a 29 70 50 61 67 65 3b 0a 7d 0a 0a  page*)pPage;.}..
6cf0: 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74  ./*.** Implement
6d00: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c  ation of the sql
6d10: 69 74 65 33 5f 70 63 61 63 68 65 2e 78 55 6e 70  ite3_pcache.xUnp
6d20: 69 6e 20 6d 65 74 68 6f 64 2e 0a 2a 2a 0a 2a 2a  in method..**.**
6d30: 20 4d 61 72 6b 20 61 20 70 61 67 65 20 61 73 20   Mark a page as 
6d40: 75 6e 70 69 6e 6e 65 64 20 28 65 6c 69 67 69 62  unpinned (eligib
6d50: 6c 65 20 66 6f 72 20 61 73 79 6e 63 68 72 6f 6e  le for asynchron
6d60: 6f 75 73 20 72 65 63 79 63 6c 69 6e 67 29 2e 0a  ous recycling)..
6d70: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70  */.static void p
6d80: 63 61 63 68 65 31 55 6e 70 69 6e 28 0a 20 20 73  cache1Unpin(.  s
6d90: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70  qlite3_pcache *p
6da0: 2c 20 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 61  , .  sqlite3_pca
6db0: 63 68 65 5f 70 61 67 65 20 2a 70 50 67 2c 20 0a  che_page *pPg, .
6dc0: 20 20 69 6e 74 20 72 65 75 73 65 55 6e 6c 69 6b    int reuseUnlik
6dd0: 65 6c 79 0a 29 7b 0a 20 20 50 43 61 63 68 65 31  ely.){.  PCache1
6de0: 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61 63   *pCache = (PCac
6df0: 68 65 31 20 2a 29 70 3b 0a 20 20 50 67 48 64 72  he1 *)p;.  PgHdr
6e00: 31 20 2a 70 50 61 67 65 20 3d 20 28 50 67 48 64  1 *pPage = (PgHd
6e10: 72 31 20 2a 29 70 50 67 3b 0a 20 20 50 47 72 6f  r1 *)pPg;.  PGro
6e20: 75 70 20 2a 70 47 72 6f 75 70 20 3d 20 70 43 61  up *pGroup = pCa
6e30: 63 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20 0a 20  che->pGroup;. . 
6e40: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e   assert( pPage->
6e50: 70 43 61 63 68 65 3d 3d 70 43 61 63 68 65 20 29  pCache==pCache )
6e60: 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65 72  ;.  pcache1Enter
6e70: 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 0a  Mutex(pGroup);..
6e80: 20 20 2f 2a 20 49 74 20 69 73 20 61 6e 20 65 72    /* It is an er
6e90: 72 6f 72 20 74 6f 20 63 61 6c 6c 20 74 68 69 73  ror to call this
6ea0: 20 66 75 6e 63 74 69 6f 6e 20 69 66 20 74 68 65   function if the
6eb0: 20 70 61 67 65 20 69 73 20 61 6c 72 65 61 64 79   page is already
6ec0: 20 0a 20 20 2a 2a 20 70 61 72 74 20 6f 66 20 74   .  ** part of t
6ed0: 68 65 20 50 47 72 6f 75 70 20 4c 52 55 20 6c 69  he PGroup LRU li
6ee0: 73 74 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72  st..  */.  asser
6ef0: 74 28 20 70 50 61 67 65 2d 3e 70 4c 72 75 50 72  t( pPage->pLruPr
6f00: 65 76 3d 3d 30 20 26 26 20 70 50 61 67 65 2d 3e  ev==0 && pPage->
6f10: 70 4c 72 75 4e 65 78 74 3d 3d 30 20 29 3b 0a 20  pLruNext==0 );. 
6f20: 20 61 73 73 65 72 74 28 20 70 47 72 6f 75 70 2d   assert( pGroup-
6f30: 3e 70 4c 72 75 48 65 61 64 21 3d 70 50 61 67 65  >pLruHead!=pPage
6f40: 20 26 26 20 70 47 72 6f 75 70 2d 3e 70 4c 72 75   && pGroup->pLru
6f50: 54 61 69 6c 21 3d 70 50 61 67 65 20 29 3b 0a 20  Tail!=pPage );. 
6f60: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e   assert( pPage->
6f70: 69 73 50 69 6e 6e 65 64 3d 3d 31 20 29 3b 0a 0a  isPinned==1 );..
6f80: 20 20 69 66 28 20 72 65 75 73 65 55 6e 6c 69 6b    if( reuseUnlik
6f90: 65 6c 79 20 7c 7c 20 70 47 72 6f 75 70 2d 3e 6e  ely || pGroup->n
6fa0: 43 75 72 72 65 6e 74 50 61 67 65 3e 70 47 72 6f  CurrentPage>pGro
6fb0: 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 29 7b 0a  up->nMaxPage ){.
6fc0: 20 20 20 20 70 63 61 63 68 65 31 52 65 6d 6f 76      pcache1Remov
6fd0: 65 46 72 6f 6d 48 61 73 68 28 70 50 61 67 65 29  eFromHash(pPage)
6fe0: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 46 72 65  ;.    pcache1Fre
6ff0: 65 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 20  ePage(pPage);.  
7000: 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 41 64  }else{.    /* Ad
7010: 64 20 74 68 65 20 70 61 67 65 20 74 6f 20 74 68  d the page to th
7020: 65 20 50 47 72 6f 75 70 20 4c 52 55 20 6c 69 73  e PGroup LRU lis
7030: 74 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 47  t. */.    if( pG
7040: 72 6f 75 70 2d 3e 70 4c 72 75 48 65 61 64 20 29  roup->pLruHead )
7050: 7b 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e  {.      pGroup->
7060: 70 4c 72 75 48 65 61 64 2d 3e 70 4c 72 75 50 72  pLruHead->pLruPr
7070: 65 76 20 3d 20 70 50 61 67 65 3b 0a 20 20 20 20  ev = pPage;.    
7080: 20 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78    pPage->pLruNex
7090: 74 20 3d 20 70 47 72 6f 75 70 2d 3e 70 4c 72 75  t = pGroup->pLru
70a0: 48 65 61 64 3b 0a 20 20 20 20 20 20 70 47 72 6f  Head;.      pGro
70b0: 75 70 2d 3e 70 4c 72 75 48 65 61 64 20 3d 20 70  up->pLruHead = p
70c0: 50 61 67 65 3b 0a 20 20 20 20 7d 65 6c 73 65 7b  Page;.    }else{
70d0: 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e 70  .      pGroup->p
70e0: 4c 72 75 54 61 69 6c 20 3d 20 70 50 61 67 65 3b  LruTail = pPage;
70f0: 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e 70  .      pGroup->p
7100: 4c 72 75 48 65 61 64 20 3d 20 70 50 61 67 65 3b  LruHead = pPage;
7110: 0a 20 20 20 20 7d 0a 20 20 20 20 70 43 61 63 68  .    }.    pCach
7120: 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65 2b 2b  e->nRecyclable++
7130: 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 73 50  ;.    pPage->isP
7140: 69 6e 6e 65 64 20 3d 20 30 3b 0a 20 20 7d 0a 0a  inned = 0;.  }..
7150: 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75    pcache1LeaveMu
7160: 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f  tex(pCache->pGro
7170: 75 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d  up);.}../*.** Im
7180: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20  plementation of 
7190: 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63  the sqlite3_pcac
71a0: 68 65 2e 78 52 65 6b 65 79 20 6d 65 74 68 6f 64  he.xRekey method
71b0: 2e 20 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  . .*/.static voi
71c0: 64 20 70 63 61 63 68 65 31 52 65 6b 65 79 28 0a  d pcache1Rekey(.
71d0: 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65    sqlite3_pcache
71e0: 20 2a 70 2c 0a 20 20 73 71 6c 69 74 65 33 5f 70   *p,.  sqlite3_p
71f0: 63 61 63 68 65 5f 70 61 67 65 20 2a 70 50 67 2c  cache_page *pPg,
7200: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
7210: 69 4f 6c 64 2c 0a 20 20 75 6e 73 69 67 6e 65 64  iOld,.  unsigned
7220: 20 69 6e 74 20 69 4e 65 77 0a 29 7b 0a 20 20 50   int iNew.){.  P
7230: 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d  Cache1 *pCache =
7240: 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b 0a 20   (PCache1 *)p;. 
7250: 20 50 67 48 64 72 31 20 2a 70 50 61 67 65 20 3d   PgHdr1 *pPage =
7260: 20 28 50 67 48 64 72 31 20 2a 29 70 50 67 3b 0a   (PgHdr1 *)pPg;.
7270: 20 20 50 67 48 64 72 31 20 2a 2a 70 70 3b 0a 20    PgHdr1 **pp;. 
7280: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 68 3b   unsigned int h;
7290: 20 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67   .  assert( pPag
72a0: 65 2d 3e 69 4b 65 79 3d 3d 69 4f 6c 64 20 29 3b  e->iKey==iOld );
72b0: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65  .  assert( pPage
72c0: 2d 3e 70 43 61 63 68 65 3d 3d 70 43 61 63 68 65  ->pCache==pCache
72d0: 20 29 3b 0a 0a 20 20 70 63 61 63 68 65 31 45 6e   );..  pcache1En
72e0: 74 65 72 4d 75 74 65 78 28 70 43 61 63 68 65 2d  terMutex(pCache-
72f0: 3e 70 47 72 6f 75 70 29 3b 0a 0a 20 20 68 20 3d  >pGroup);..  h =
7300: 20 69 4f 6c 64 25 70 43 61 63 68 65 2d 3e 6e 48   iOld%pCache->nH
7310: 61 73 68 3b 0a 20 20 70 70 20 3d 20 26 70 43 61  ash;.  pp = &pCa
7320: 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 3b 0a  che->apHash[h];.
7330: 20 20 77 68 69 6c 65 28 20 28 2a 70 70 29 21 3d    while( (*pp)!=
7340: 70 50 61 67 65 20 29 7b 0a 20 20 20 20 70 70 20  pPage ){.    pp 
7350: 3d 20 26 28 2a 70 70 29 2d 3e 70 4e 65 78 74 3b  = &(*pp)->pNext;
7360: 0a 20 20 7d 0a 20 20 2a 70 70 20 3d 20 70 50 61  .  }.  *pp = pPa
7370: 67 65 2d 3e 70 4e 65 78 74 3b 0a 0a 20 20 68 20  ge->pNext;..  h 
7380: 3d 20 69 4e 65 77 25 70 43 61 63 68 65 2d 3e 6e  = iNew%pCache->n
7390: 48 61 73 68 3b 0a 20 20 70 50 61 67 65 2d 3e 69  Hash;.  pPage->i
73a0: 4b 65 79 20 3d 20 69 4e 65 77 3b 0a 20 20 70 50  Key = iNew;.  pP
73b0: 61 67 65 2d 3e 70 4e 65 78 74 20 3d 20 70 43 61  age->pNext = pCa
73c0: 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 3b 0a  che->apHash[h];.
73d0: 20 20 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68    pCache->apHash
73e0: 5b 68 5d 20 3d 20 70 50 61 67 65 3b 0a 20 20 69  [h] = pPage;.  i
73f0: 66 28 20 69 4e 65 77 3e 70 43 61 63 68 65 2d 3e  f( iNew>pCache->
7400: 69 4d 61 78 4b 65 79 20 29 7b 0a 20 20 20 20 70  iMaxKey ){.    p
7410: 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 3d  Cache->iMaxKey =
7420: 20 69 4e 65 77 3b 0a 20 20 7d 0a 0a 20 20 70 63   iNew;.  }..  pc
7430: 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28  ache1LeaveMutex(
7440: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b  pCache->pGroup);
7450: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d  .}../*.** Implem
7460: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20  entation of the 
7470: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78  sqlite3_pcache.x
7480: 54 72 75 6e 63 61 74 65 20 6d 65 74 68 6f 64 2e  Truncate method.
7490: 20 0a 2a 2a 0a 2a 2a 20 44 69 73 63 61 72 64 20   .**.** Discard 
74a0: 61 6c 6c 20 75 6e 70 69 6e 6e 65 64 20 70 61 67  all unpinned pag
74b0: 65 73 20 69 6e 20 74 68 65 20 63 61 63 68 65 20  es in the cache 
74c0: 77 69 74 68 20 61 20 70 61 67 65 20 6e 75 6d 62  with a page numb
74d0: 65 72 20 65 71 75 61 6c 20 74 6f 0a 2a 2a 20 6f  er equal to.** o
74e0: 72 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 70  r greater than p
74f0: 61 72 61 6d 65 74 65 72 20 69 4c 69 6d 69 74 2e  arameter iLimit.
7500: 20 41 6e 79 20 70 69 6e 6e 65 64 20 70 61 67 65   Any pinned page
7510: 73 20 77 69 74 68 20 61 20 70 61 67 65 20 6e 75  s with a page nu
7520: 6d 62 65 72 0a 2a 2a 20 65 71 75 61 6c 20 74 6f  mber.** equal to
7530: 20 6f 72 20 67 72 65 61 74 65 72 20 74 68 61 6e   or greater than
7540: 20 69 4c 69 6d 69 74 20 61 72 65 20 69 6d 70 6c   iLimit are impl
7550: 69 63 69 74 6c 79 20 75 6e 70 69 6e 6e 65 64 2e  icitly unpinned.
7560: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
7570: 70 63 61 63 68 65 31 54 72 75 6e 63 61 74 65 28  pcache1Truncate(
7580: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a  sqlite3_pcache *
7590: 70 2c 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  p, unsigned int 
75a0: 69 4c 69 6d 69 74 29 7b 0a 20 20 50 43 61 63 68  iLimit){.  PCach
75b0: 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43  e1 *pCache = (PC
75c0: 61 63 68 65 31 20 2a 29 70 3b 0a 20 20 53 54 41  ache1 *)p;.  STA
75d0: 52 54 5f 44 45 42 55 47 5f 54 49 4d 45 52 3b 0a  RT_DEBUG_TIMER;.
75e0: 20 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75    pcache1EnterMu
75f0: 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f  tex(pCache->pGro
7600: 75 70 29 3b 0a 20 20 69 66 28 20 69 4c 69 6d 69  up);.  if( iLimi
7610: 74 3c 3d 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b  t<=pCache->iMaxK
7620: 65 79 20 29 7b 0a 20 20 20 20 70 63 61 63 68 65  ey ){.    pcache
7630: 31 54 72 75 6e 63 61 74 65 55 6e 73 61 66 65 28  1TruncateUnsafe(
7640: 70 43 61 63 68 65 2c 20 69 4c 69 6d 69 74 29 3b  pCache, iLimit);
7650: 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 69 4d 61  .    pCache->iMa
7660: 78 4b 65 79 20 3d 20 69 4c 69 6d 69 74 2d 31 3b  xKey = iLimit-1;
7670: 0a 20 20 7d 0a 20 20 70 63 61 63 68 65 31 4c 65  .  }.  pcache1Le
7680: 61 76 65 4d 75 74 65 78 28 70 43 61 63 68 65 2d  aveMutex(pCache-
7690: 3e 70 47 72 6f 75 70 29 3b 0a 20 20 45 4e 44 5f  >pGroup);.  END_
76a0: 44 45 42 55 47 5f 54 49 4d 45 52 28 20 44 45 42  DEBUG_TIMER( DEB
76b0: 55 47 5f 54 49 4d 45 52 5f 42 49 47 5f 54 49 4d  UG_TIMER_BIG_TIM
76c0: 45 4f 55 54 20 29 7b 0a 20 20 20 20 73 71 6c 69  EOUT ){.    sqli
76d0: 74 65 33 5f 6c 6f 67 28 53 51 4c 49 54 45 5f 4e  te3_log(SQLITE_N
76e0: 4f 54 49 43 45 2c 20 22 73 6c 6f 77 20 70 63 61  OTICE, "slow pca
76f0: 63 68 65 31 54 72 75 6e 63 61 74 65 28 25 64 29  che1Truncate(%d)
7700: 3a 20 25 6c 6c 75 20 75 53 22 2c 0a 20 20 20 20  : %llu uS",.    
7710: 20 20 28 69 6e 74 29 69 4c 69 6d 69 74 2c 20 69    (int)iLimit, i
7720: 44 65 62 75 67 54 69 6d 65 72 29 3b 0a 20 20 7d  DebugTimer);.  }
7730: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d  .}../*.** Implem
7740: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20  entation of the 
7750: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78  sqlite3_pcache.x
7760: 44 65 73 74 72 6f 79 20 6d 65 74 68 6f 64 2e 20  Destroy method. 
7770: 0a 2a 2a 0a 2a 2a 20 44 65 73 74 72 6f 79 20 61  .**.** Destroy a
7780: 20 63 61 63 68 65 20 61 6c 6c 6f 63 61 74 65 64   cache allocated
7790: 20 75 73 69 6e 67 20 70 63 61 63 68 65 31 43 72   using pcache1Cr
77a0: 65 61 74 65 28 29 2e 0a 2a 2f 0a 73 74 61 74 69  eate()..*/.stati
77b0: 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 44 65  c void pcache1De
77c0: 73 74 72 6f 79 28 73 71 6c 69 74 65 33 5f 70 63  stroy(sqlite3_pc
77d0: 61 63 68 65 20 2a 70 29 7b 0a 20 20 50 43 61 63  ache *p){.  PCac
77e0: 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50  he1 *pCache = (P
77f0: 43 61 63 68 65 31 20 2a 29 70 3b 0a 20 20 50 47  Cache1 *)p;.  PG
7800: 72 6f 75 70 20 2a 70 47 72 6f 75 70 20 3d 20 70  roup *pGroup = p
7810: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20  Cache->pGroup;. 
7820: 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65 2d   assert( pCache-
7830: 3e 62 50 75 72 67 65 61 62 6c 65 20 7c 7c 20 28  >bPurgeable || (
7840: 70 43 61 63 68 65 2d 3e 6e 4d 61 78 3d 3d 30 20  pCache->nMax==0 
7850: 26 26 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 3d  && pCache->nMin=
7860: 3d 30 29 20 29 3b 0a 20 20 70 63 61 63 68 65 31  =0) );.  pcache1
7870: 45 6e 74 65 72 4d 75 74 65 78 28 70 47 72 6f 75  EnterMutex(pGrou
7880: 70 29 3b 0a 20 20 70 63 61 63 68 65 31 54 72 75  p);.  pcache1Tru
7890: 6e 63 61 74 65 55 6e 73 61 66 65 28 70 43 61 63  ncateUnsafe(pCac
78a0: 68 65 2c 20 30 29 3b 0a 20 20 61 73 73 65 72 74  he, 0);.  assert
78b0: 28 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61  ( pGroup->nMaxPa
78c0: 67 65 20 3e 3d 20 70 43 61 63 68 65 2d 3e 6e 4d  ge >= pCache->nM
78d0: 61 78 20 29 3b 0a 20 20 70 47 72 6f 75 70 2d 3e  ax );.  pGroup->
78e0: 6e 4d 61 78 50 61 67 65 20 2d 3d 20 70 43 61 63  nMaxPage -= pCac
78f0: 68 65 2d 3e 6e 4d 61 78 3b 0a 20 20 61 73 73 65  he->nMax;.  asse
7900: 72 74 28 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e  rt( pGroup->nMin
7910: 50 61 67 65 20 3e 3d 20 70 43 61 63 68 65 2d 3e  Page >= pCache->
7920: 6e 4d 69 6e 20 29 3b 0a 20 20 70 47 72 6f 75 70  nMin );.  pGroup
7930: 2d 3e 6e 4d 69 6e 50 61 67 65 20 2d 3d 20 70 43  ->nMinPage -= pC
7940: 61 63 68 65 2d 3e 6e 4d 69 6e 3b 0a 20 20 70 47  ache->nMin;.  pG
7950: 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d  roup->mxPinned =
7960: 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67   pGroup->nMaxPag
7970: 65 20 2b 20 31 30 20 2d 20 70 47 72 6f 75 70 2d  e + 10 - pGroup-
7980: 3e 6e 4d 69 6e 50 61 67 65 3b 0a 20 20 70 63 61  >nMinPage;.  pca
7990: 63 68 65 31 45 6e 66 6f 72 63 65 4d 61 78 50 61  che1EnforceMaxPa
79a0: 67 65 28 70 47 72 6f 75 70 29 3b 0a 20 20 70 63  ge(pGroup);.  pc
79b0: 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28  ache1LeaveMutex(
79c0: 70 47 72 6f 75 70 29 3b 0a 20 20 73 71 6c 69 74  pGroup);.  sqlit
79d0: 65 33 5f 66 72 65 65 28 70 43 61 63 68 65 2d 3e  e3_free(pCache->
79e0: 61 70 48 61 73 68 29 3b 0a 20 20 73 71 6c 69 74  apHash);.  sqlit
79f0: 65 33 5f 66 72 65 65 28 70 43 61 63 68 65 29 3b  e3_free(pCache);
7a00: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66  .}../*.** This f
7a10: 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65  unction is calle
7a20: 64 20 64 75 72 69 6e 67 20 69 6e 69 74 69 61 6c  d during initial
7a30: 69 7a 61 74 69 6f 6e 20 28 73 71 6c 69 74 65 33  ization (sqlite3
7a40: 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 29 20 74  _initialize()) t
7a50: 6f 0a 2a 2a 20 69 6e 73 74 61 6c 6c 20 74 68 65  o.** install the
7a60: 20 64 65 66 61 75 6c 74 20 70 6c 75 67 67 61 62   default pluggab
7a70: 6c 65 20 63 61 63 68 65 20 6d 6f 64 75 6c 65 2c  le cache module,
7a80: 20 61 73 73 75 6d 69 6e 67 20 74 68 65 20 75 73   assuming the us
7a90: 65 72 20 68 61 73 20 6e 6f 74 0a 2a 2a 20 61 6c  er has not.** al
7aa0: 72 65 61 64 79 20 70 72 6f 76 69 64 65 64 20 61  ready provided a
7ab0: 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 2e 0a 2a  n alternative..*
7ac0: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 43  /.void sqlite3PC
7ad0: 61 63 68 65 53 65 74 44 65 66 61 75 6c 74 28 76  acheSetDefault(v
7ae0: 6f 69 64 29 7b 0a 20 20 73 74 61 74 69 63 20 63  oid){.  static c
7af0: 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 70 63 61  onst sqlite3_pca
7b00: 63 68 65 5f 6d 65 74 68 6f 64 73 32 20 64 65 66  che_methods2 def
7b10: 61 75 6c 74 4d 65 74 68 6f 64 73 20 3d 20 7b 0a  aultMethods = {.
7b20: 20 20 20 20 31 2c 20 20 20 20 20 20 20 20 20 20      1,          
7b30: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
7b40: 69 56 65 72 73 69 6f 6e 20 2a 2f 0a 20 20 20 20  iVersion */.    
7b50: 30 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  0,              
7b60: 20 20 20 20 20 20 20 20 20 2f 2a 20 70 41 72 67           /* pArg
7b70: 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 49   */.    pcache1I
7b80: 6e 69 74 2c 20 20 20 20 20 20 20 20 20 20 20 20  nit,            
7b90: 20 2f 2a 20 78 49 6e 69 74 20 2a 2f 0a 20 20 20   /* xInit */.   
7ba0: 20 70 63 61 63 68 65 31 53 68 75 74 64 6f 77 6e   pcache1Shutdown
7bb0: 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 78 53 68  ,         /* xSh
7bc0: 75 74 64 6f 77 6e 20 2a 2f 0a 20 20 20 20 70 63  utdown */.    pc
7bd0: 61 63 68 65 31 43 72 65 61 74 65 2c 20 20 20 20  ache1Create,    
7be0: 20 20 20 20 20 20 20 2f 2a 20 78 43 72 65 61 74         /* xCreat
7bf0: 65 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31  e */.    pcache1
7c00: 43 61 63 68 65 73 69 7a 65 2c 20 20 20 20 20 20  Cachesize,      
7c10: 20 20 2f 2a 20 78 43 61 63 68 65 73 69 7a 65 20    /* xCachesize 
7c20: 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 50 61  */.    pcache1Pa
7c30: 67 65 63 6f 75 6e 74 2c 20 20 20 20 20 20 20 20  gecount,        
7c40: 2f 2a 20 78 50 61 67 65 63 6f 75 6e 74 20 2a 2f  /* xPagecount */
7c50: 0a 20 20 20 20 70 63 61 63 68 65 31 46 65 74 63  .    pcache1Fetc
7c60: 68 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  h,            /*
7c70: 20 78 46 65 74 63 68 20 2a 2f 0a 20 20 20 20 70   xFetch */.    p
7c80: 63 61 63 68 65 31 55 6e 70 69 6e 2c 20 20 20 20  cache1Unpin,    
7c90: 20 20 20 20 20 20 20 20 2f 2a 20 78 55 6e 70 69          /* xUnpi
7ca0: 6e 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31  n */.    pcache1
7cb0: 52 65 6b 65 79 2c 20 20 20 20 20 20 20 20 20 20  Rekey,          
7cc0: 20 20 2f 2a 20 78 52 65 6b 65 79 20 2a 2f 0a 20    /* xRekey */. 
7cd0: 20 20 20 70 63 61 63 68 65 31 54 72 75 6e 63 61     pcache1Trunca
7ce0: 74 65 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 78  te,         /* x
7cf0: 54 72 75 6e 63 61 74 65 20 2a 2f 0a 20 20 20 20  Truncate */.    
7d00: 70 63 61 63 68 65 31 44 65 73 74 72 6f 79 2c 20  pcache1Destroy, 
7d10: 20 20 20 20 20 20 20 20 20 2f 2a 20 78 44 65 73           /* xDes
7d20: 74 72 6f 79 20 2a 2f 0a 20 20 20 20 70 63 61 63  troy */.    pcac
7d30: 68 65 31 53 68 72 69 6e 6b 20 20 20 20 20 20 20  he1Shrink       
7d40: 20 20 20 20 20 2f 2a 20 78 53 68 72 69 6e 6b 20       /* xShrink 
7d50: 2a 2f 0a 20 20 7d 3b 0a 20 20 73 71 6c 69 74 65  */.  };.  sqlite
7d60: 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f  3_config(SQLITE_
7d70: 43 4f 4e 46 49 47 5f 50 43 41 43 48 45 32 2c 20  CONFIG_PCACHE2, 
7d80: 26 64 65 66 61 75 6c 74 4d 65 74 68 6f 64 73 29  &defaultMethods)
7d90: 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49  ;.}..#ifdef SQLI
7da0: 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59  TE_ENABLE_MEMORY
7db0: 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 2f 2a 0a 2a  _MANAGEMENT./*.*
7dc0: 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  * This function 
7dd0: 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 66 72 65  is called to fre
7de0: 65 20 73 75 70 65 72 66 6c 75 6f 75 73 20 64 79  e superfluous dy
7df0: 6e 61 6d 69 63 61 6c 6c 79 20 61 6c 6c 6f 63 61  namically alloca
7e00: 74 65 64 20 6d 65 6d 6f 72 79 0a 2a 2a 20 68 65  ted memory.** he
7e10: 6c 64 20 62 79 20 74 68 65 20 70 61 67 65 72 20  ld by the pager 
7e20: 73 79 73 74 65 6d 2e 20 4d 65 6d 6f 72 79 20 69  system. Memory i
7e30: 6e 20 75 73 65 20 62 79 20 61 6e 79 20 53 51 4c  n use by any SQL
7e40: 69 74 65 20 70 61 67 65 72 20 61 6c 6c 6f 63 61  ite pager alloca
7e50: 74 65 64 0a 2a 2a 20 62 79 20 74 68 65 20 63 75  ted.** by the cu
7e60: 72 72 65 6e 74 20 74 68 72 65 61 64 20 6d 61 79  rrent thread may
7e70: 20 62 65 20 73 71 6c 69 74 65 33 5f 66 72 65 65   be sqlite3_free
7e80: 28 29 65 64 2e 0a 2a 2a 0a 2a 2a 20 6e 52 65 71  ()ed..**.** nReq
7e90: 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f   is the number o
7ea0: 66 20 62 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72  f bytes of memor
7eb0: 79 20 72 65 71 75 69 72 65 64 2e 20 4f 6e 63 65  y required. Once
7ec0: 20 74 68 69 73 20 6d 75 63 68 20 68 61 73 0a 2a   this much has.*
7ed0: 2a 20 62 65 65 6e 20 72 65 6c 65 61 73 65 64 2c  * been released,
7ee0: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 72 65   the function re
7ef0: 74 75 72 6e 73 2e 20 54 68 65 20 72 65 74 75 72  turns. The retur
7f00: 6e 20 76 61 6c 75 65 20 69 73 20 74 68 65 20 74  n value is the t
7f10: 6f 74 61 6c 20 6e 75 6d 62 65 72 20 0a 2a 2a 20  otal number .** 
7f20: 6f 66 20 62 79 74 65 73 20 6f 66 20 6d 65 6d 6f  of bytes of memo
7f30: 72 79 20 72 65 6c 65 61 73 65 64 2e 0a 2a 2f 0a  ry released..*/.
7f40: 69 6e 74 20 73 71 6c 69 74 65 33 50 63 61 63 68  int sqlite3Pcach
7f50: 65 52 65 6c 65 61 73 65 4d 65 6d 6f 72 79 28 69  eReleaseMemory(i
7f60: 6e 74 20 6e 52 65 71 29 7b 0a 20 20 69 6e 74 20  nt nReq){.  int 
7f70: 6e 46 72 65 65 20 3d 20 30 3b 0a 20 20 61 73 73  nFree = 0;.  ass
7f80: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74  ert( sqlite3_mut
7f90: 65 78 5f 6e 6f 74 68 65 6c 64 28 70 63 61 63 68  ex_notheld(pcach
7fa0: 65 31 2e 67 72 70 2e 6d 75 74 65 78 29 20 29 3b  e1.grp.mutex) );
7fb0: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74  .  assert( sqlit
7fc0: 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c 64  e3_mutex_notheld
7fd0: 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29 20  (pcache1.mutex) 
7fe0: 29 3b 0a 20 20 69 66 28 20 70 63 61 63 68 65 31  );.  if( pcache1
7ff0: 2e 70 53 74 61 72 74 3d 3d 30 20 29 7b 0a 20 20  .pStart==0 ){.  
8000: 20 20 50 67 48 64 72 31 20 2a 70 3b 0a 20 20 20    PgHdr1 *p;.   
8010: 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74   pcache1EnterMut
8020: 65 78 28 26 70 63 61 63 68 65 31 2e 67 72 70 29  ex(&pcache1.grp)
8030: 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 28 6e 52  ;.    while( (nR
8040: 65 71 3c 30 20 7c 7c 20 6e 46 72 65 65 3c 6e 52  eq<0 || nFree<nR
8050: 65 71 29 20 26 26 20 28 28 70 3d 70 63 61 63 68  eq) && ((p=pcach
8060: 65 31 2e 67 72 70 2e 70 4c 72 75 54 61 69 6c 29  e1.grp.pLruTail)
8070: 21 3d 30 29 20 29 7b 0a 20 20 20 20 20 20 6e 46  !=0) ){.      nF
8080: 72 65 65 20 2b 3d 20 70 63 61 63 68 65 31 4d 65  ree += pcache1Me
8090: 6d 53 69 7a 65 28 70 2d 3e 70 61 67 65 2e 70 42  mSize(p->page.pB
80a0: 75 66 29 3b 0a 23 69 66 64 65 66 20 53 51 4c 49  uf);.#ifdef SQLI
80b0: 54 45 5f 50 43 41 43 48 45 5f 53 45 50 41 52 41  TE_PCACHE_SEPARA
80c0: 54 45 5f 48 45 41 44 45 52 0a 20 20 20 20 20 20  TE_HEADER.      
80d0: 6e 46 72 65 65 20 2b 3d 20 73 71 6c 69 74 65 33  nFree += sqlite3
80e0: 4d 65 6d 53 69 7a 65 28 70 29 3b 0a 23 65 6e 64  MemSize(p);.#end
80f0: 69 66 0a 20 20 20 20 20 20 61 73 73 65 72 74 28  if.      assert(
8100: 20 70 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d 30 20   p->isPinned==0 
8110: 29 3b 0a 20 20 20 20 20 20 70 63 61 63 68 65 31  );.      pcache1
8120: 50 69 6e 50 61 67 65 28 70 29 3b 0a 20 20 20 20  PinPage(p);.    
8130: 20 20 70 63 61 63 68 65 31 52 65 6d 6f 76 65 46    pcache1RemoveF
8140: 72 6f 6d 48 61 73 68 28 70 29 3b 0a 20 20 20 20  romHash(p);.    
8150: 20 20 70 63 61 63 68 65 31 46 72 65 65 50 61 67    pcache1FreePag
8160: 65 28 70 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20  e(p);.    }.    
8170: 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65  pcache1LeaveMute
8180: 78 28 26 70 63 61 63 68 65 31 2e 67 72 70 29 3b  x(&pcache1.grp);
8190: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 6e 46  .  }.  return nF
81a0: 72 65 65 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a  ree;.}.#endif /*
81b0: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d   SQLITE_ENABLE_M
81c0: 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54  EMORY_MANAGEMENT
81d0: 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c 49   */..#ifdef SQLI
81e0: 54 45 5f 54 45 53 54 0a 2f 2a 0a 2a 2a 20 54 68  TE_TEST./*.** Th
81f0: 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 75  is function is u
8200: 73 65 64 20 62 79 20 74 65 73 74 20 70 72 6f 63  sed by test proc
8210: 65 64 75 72 65 73 20 74 6f 20 69 6e 73 70 65 63  edures to inspec
8220: 74 20 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 73  t the internal s
8230: 74 61 74 65 0a 2a 2a 20 6f 66 20 74 68 65 20 67  tate.** of the g
8240: 6c 6f 62 61 6c 20 63 61 63 68 65 2e 0a 2a 2f 0a  lobal cache..*/.
8250: 76 6f 69 64 20 73 71 6c 69 74 65 33 50 63 61 63  void sqlite3Pcac
8260: 68 65 53 74 61 74 73 28 0a 20 20 69 6e 74 20 2a  heStats(.  int *
8270: 70 6e 43 75 72 72 65 6e 74 2c 20 20 20 20 20 20  pnCurrent,      
8280: 2f 2a 20 4f 55 54 3a 20 54 6f 74 61 6c 20 6e 75  /* OUT: Total nu
8290: 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 63 61  mber of pages ca
82a0: 63 68 65 64 20 2a 2f 0a 20 20 69 6e 74 20 2a 70  ched */.  int *p
82b0: 6e 4d 61 78 2c 20 20 20 20 20 20 20 20 20 20 2f  nMax,          /
82c0: 2a 20 4f 55 54 3a 20 47 6c 6f 62 61 6c 20 6d 61  * OUT: Global ma
82d0: 78 69 6d 75 6d 20 63 61 63 68 65 20 73 69 7a 65  ximum cache size
82e0: 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 4d 69 6e   */.  int *pnMin
82f0: 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55  ,          /* OU
8300: 54 3a 20 53 75 6d 20 6f 66 20 50 43 61 63 68 65  T: Sum of PCache
8310: 31 2e 6e 4d 69 6e 20 66 6f 72 20 70 75 72 67 65  1.nMin for purge
8320: 61 62 6c 65 20 63 61 63 68 65 73 20 2a 2f 0a 20  able caches */. 
8330: 20 69 6e 74 20 2a 70 6e 52 65 63 79 63 6c 61 62   int *pnRecyclab
8340: 6c 65 20 20 20 20 2f 2a 20 4f 55 54 3a 20 54 6f  le    /* OUT: To
8350: 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 61  tal number of pa
8360: 67 65 73 20 61 76 61 69 6c 61 62 6c 65 20 66 6f  ges available fo
8370: 72 20 72 65 63 79 63 6c 69 6e 67 20 2a 2f 0a 29  r recycling */.)
8380: 7b 0a 20 20 50 67 48 64 72 31 20 2a 70 3b 0a 20  {.  PgHdr1 *p;. 
8390: 20 69 6e 74 20 6e 52 65 63 79 63 6c 61 62 6c 65   int nRecyclable
83a0: 20 3d 20 30 3b 0a 20 20 66 6f 72 28 70 3d 70 63   = 0;.  for(p=pc
83b0: 61 63 68 65 31 2e 67 72 70 2e 70 4c 72 75 48 65  ache1.grp.pLruHe
83c0: 61 64 3b 20 70 3b 20 70 3d 70 2d 3e 70 4c 72 75  ad; p; p=p->pLru
83d0: 4e 65 78 74 29 7b 0a 20 20 20 20 61 73 73 65 72  Next){.    asser
83e0: 74 28 20 70 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d  t( p->isPinned==
83f0: 30 20 29 3b 0a 20 20 20 20 6e 52 65 63 79 63 6c  0 );.    nRecycl
8400: 61 62 6c 65 2b 2b 3b 0a 20 20 7d 0a 20 20 2a 70  able++;.  }.  *p
8410: 6e 43 75 72 72 65 6e 74 20 3d 20 70 63 61 63 68  nCurrent = pcach
8420: 65 31 2e 67 72 70 2e 6e 43 75 72 72 65 6e 74 50  e1.grp.nCurrentP
8430: 61 67 65 3b 0a 20 20 2a 70 6e 4d 61 78 20 3d 20  age;.  *pnMax = 
8440: 28 69 6e 74 29 70 63 61 63 68 65 31 2e 67 72 70  (int)pcache1.grp
8450: 2e 6e 4d 61 78 50 61 67 65 3b 0a 20 20 2a 70 6e  .nMaxPage;.  *pn
8460: 4d 69 6e 20 3d 20 28 69 6e 74 29 70 63 61 63 68  Min = (int)pcach
8470: 65 31 2e 67 72 70 2e 6e 4d 69 6e 50 61 67 65 3b  e1.grp.nMinPage;
8480: 0a 20 20 2a 70 6e 52 65 63 79 63 6c 61 62 6c 65  .  *pnRecyclable
8490: 20 3d 20 6e 52 65 63 79 63 6c 61 62 6c 65 3b 0a   = nRecyclable;.
84a0: 7d 0a 23 65 6e 64 69 66 0a                       }.#endif.