/ Hex Artifact Content
Login

Artifact 1e77432b40b7d3288327d9cdf399dcdfd2b6d3bf:


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 52 4f 55 4e 44 38 28 73  e1Alloc(ROUND8(s
2c10: 69 7a 65 6f 66 28 50 67 48 64 72 31 29 29 20 2b  izeof(PgHdr1)) +
2c20: 20 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 20   pCache->szPage 
2c30: 2b 20 70 43 61 63 68 65 2d 3e 73 7a 45 78 74 72  + pCache->szExtr
2c40: 61 29 3b 0a 20 20 70 20 3d 20 28 50 67 48 64 72  a);.  p = (PgHdr
2c50: 31 20 2a 29 26 28 28 75 38 20 2a 29 70 50 67 29  1 *)&((u8 *)pPg)
2c60: 5b 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 5d  [pCache->szPage]
2c70: 3b 0a 23 65 6e 64 69 66 0a 20 20 70 63 61 63 68  ;.#endif.  pcach
2c80: 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70 43 61  e1EnterMutex(pCa
2c90: 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 0a 20  che->pGroup);.. 
2ca0: 20 69 66 28 20 70 50 67 20 29 7b 0a 20 20 20 20   if( pPg ){.    
2cb0: 70 2d 3e 70 61 67 65 2e 70 42 75 66 20 3d 20 70  p->page.pBuf = p
2cc0: 50 67 3b 0a 20 20 20 20 70 2d 3e 70 61 67 65 2e  Pg;.    p->page.
2cd0: 70 45 78 74 72 61 20 3d 20 26 70 5b 31 5d 3b 0a  pExtra = &p[1];.
2ce0: 20 20 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e      if( pCache->
2cf0: 62 50 75 72 67 65 61 62 6c 65 20 29 7b 0a 20 20  bPurgeable ){.  
2d00: 20 20 20 20 70 43 61 63 68 65 2d 3e 70 47 72 6f      pCache->pGro
2d10: 75 70 2d 3e 6e 43 75 72 72 65 6e 74 50 61 67 65  up->nCurrentPage
2d20: 2b 2b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 65  ++;.    }.    re
2d30: 74 75 72 6e 20 70 3b 0a 20 20 7d 0a 20 20 72 65  turn p;.  }.  re
2d40: 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  turn 0;.}../*.**
2d50: 20 46 72 65 65 20 61 20 70 61 67 65 20 6f 62 6a   Free a page obj
2d60: 65 63 74 20 61 6c 6c 6f 63 61 74 65 64 20 62 79  ect allocated by
2d70: 20 70 63 61 63 68 65 31 41 6c 6c 6f 63 50 61 67   pcache1AllocPag
2d80: 65 28 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70  e()..**.** The p
2d90: 6f 69 6e 74 65 72 20 69 73 20 61 6c 6c 6f 77 65  ointer is allowe
2da0: 64 20 74 6f 20 62 65 20 4e 55 4c 4c 2c 20 77 68  d to be NULL, wh
2db0: 69 63 68 20 69 73 20 70 72 75 64 65 6e 74 2e 20  ich is prudent. 
2dc0: 20 42 75 74 20 69 74 20 74 75 72 6e 73 20 6f 75   But it turns ou
2dd0: 74 0a 2a 2a 20 74 68 61 74 20 74 68 65 20 63 75  t.** that the cu
2de0: 72 72 65 6e 74 20 69 6d 70 6c 65 6d 65 6e 74 61  rrent implementa
2df0: 74 69 6f 6e 20 68 61 70 70 65 6e 73 20 74 6f 20  tion happens to 
2e00: 6e 65 76 65 72 20 63 61 6c 6c 20 74 68 69 73 20  never call this 
2e10: 72 6f 75 74 69 6e 65 0a 2a 2a 20 77 69 74 68 20  routine.** with 
2e20: 61 20 4e 55 4c 4c 20 70 6f 69 6e 74 65 72 2c 20  a NULL pointer, 
2e30: 73 6f 20 77 65 20 6d 61 72 6b 20 74 68 65 20 4e  so we mark the N
2e40: 55 4c 4c 20 74 65 73 74 20 77 69 74 68 20 41 4c  ULL test with AL
2e50: 57 41 59 53 28 29 2e 0a 2a 2f 0a 73 74 61 74 69  WAYS()..*/.stati
2e60: 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 46 72  c void pcache1Fr
2e70: 65 65 50 61 67 65 28 50 67 48 64 72 31 20 2a 70  eePage(PgHdr1 *p
2e80: 29 7b 0a 20 20 69 66 28 20 41 4c 57 41 59 53 28  ){.  if( ALWAYS(
2e90: 70 29 20 29 7b 0a 20 20 20 20 50 43 61 63 68 65  p) ){.    PCache
2ea0: 31 20 2a 70 43 61 63 68 65 20 3d 20 70 2d 3e 70  1 *pCache = p->p
2eb0: 43 61 63 68 65 3b 0a 20 20 20 20 61 73 73 65 72  Cache;.    asser
2ec0: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  t( sqlite3_mutex
2ed0: 5f 68 65 6c 64 28 70 2d 3e 70 43 61 63 68 65 2d  _held(p->pCache-
2ee0: 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20  >pGroup->mutex) 
2ef0: 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 46 72  );.    pcache1Fr
2f00: 65 65 28 70 2d 3e 70 61 67 65 2e 70 42 75 66 29  ee(p->page.pBuf)
2f10: 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ;.#ifdef SQLITE_
2f20: 50 43 41 43 48 45 5f 53 45 50 41 52 41 54 45 5f  PCACHE_SEPARATE_
2f30: 48 45 41 44 45 52 0a 20 20 20 20 73 71 6c 69 74  HEADER.    sqlit
2f40: 65 33 5f 66 72 65 65 28 70 29 3b 0a 23 65 6e 64  e3_free(p);.#end
2f50: 69 66 0a 20 20 20 20 69 66 28 20 70 43 61 63 68  if.    if( pCach
2f60: 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 29 7b  e->bPurgeable ){
2f70: 0a 20 20 20 20 20 20 70 43 61 63 68 65 2d 3e 70  .      pCache->p
2f80: 47 72 6f 75 70 2d 3e 6e 43 75 72 72 65 6e 74 50  Group->nCurrentP
2f90: 61 67 65 2d 2d 3b 0a 20 20 20 20 7d 0a 20 20 7d  age--;.    }.  }
2fa0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6c 6c 6f 63  .}../*.** Malloc
2fb0: 20 66 75 6e 63 74 69 6f 6e 20 75 73 65 64 20 62   function used b
2fc0: 79 20 53 51 4c 69 74 65 20 74 6f 20 6f 62 74 61  y SQLite to obta
2fd0: 69 6e 20 73 70 61 63 65 20 66 72 6f 6d 20 74 68  in space from th
2fe0: 65 20 62 75 66 66 65 72 20 63 6f 6e 66 69 67 75  e buffer configu
2ff0: 72 65 64 0a 2a 2a 20 75 73 69 6e 67 20 73 71 6c  red.** using sql
3000: 69 74 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49  ite3_config(SQLI
3010: 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41  TE_CONFIG_PAGECA
3020: 43 48 45 29 20 6f 70 74 69 6f 6e 2e 20 49 66 20  CHE) option. If 
3030: 6e 6f 20 73 75 63 68 20 62 75 66 66 65 72 0a 2a  no such buffer.*
3040: 2a 20 65 78 69 73 74 73 2c 20 74 68 69 73 20 66  * exists, this f
3050: 75 6e 63 74 69 6f 6e 20 66 61 6c 6c 73 20 62 61  unction falls ba
3060: 63 6b 20 74 6f 20 73 71 6c 69 74 65 33 4d 61 6c  ck to sqlite3Mal
3070: 6c 6f 63 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 2a  loc()..*/.void *
3080: 73 71 6c 69 74 65 33 50 61 67 65 4d 61 6c 6c 6f  sqlite3PageMallo
3090: 63 28 69 6e 74 20 73 7a 29 7b 0a 20 20 72 65 74  c(int sz){.  ret
30a0: 75 72 6e 20 70 63 61 63 68 65 31 41 6c 6c 6f 63  urn pcache1Alloc
30b0: 28 73 7a 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46  (sz);.}../*.** F
30c0: 72 65 65 20 61 6e 20 61 6c 6c 6f 63 61 74 65 64  ree an allocated
30d0: 20 62 75 66 66 65 72 20 6f 62 74 61 69 6e 65 64   buffer obtained
30e0: 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 50 61 67   from sqlite3Pag
30f0: 65 4d 61 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a 76 6f  eMalloc()..*/.vo
3100: 69 64 20 73 71 6c 69 74 65 33 50 61 67 65 46 72  id sqlite3PageFr
3110: 65 65 28 76 6f 69 64 20 2a 70 29 7b 0a 20 20 70  ee(void *p){.  p
3120: 63 61 63 68 65 31 46 72 65 65 28 70 29 3b 0a 7d  cache1Free(p);.}
3130: 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  .../*.** Return 
3140: 74 72 75 65 20 69 66 20 69 74 20 64 65 73 69 72  true if it desir
3150: 61 62 6c 65 20 74 6f 20 61 76 6f 69 64 20 61 6c  able to avoid al
3160: 6c 6f 63 61 74 69 6e 67 20 61 20 6e 65 77 20 70  locating a new p
3170: 61 67 65 20 63 61 63 68 65 0a 2a 2a 20 65 6e 74  age cache.** ent
3180: 72 79 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6d 65 6d  ry..**.** If mem
3190: 6f 72 79 20 77 61 73 20 61 6c 6c 6f 63 61 74 65  ory was allocate
31a0: 64 20 73 70 65 63 69 66 69 63 61 6c 6c 79 20 74  d specifically t
31b0: 6f 20 74 68 65 20 70 61 67 65 20 63 61 63 68 65  o the page cache
31c0: 20 75 73 69 6e 67 0a 2a 2a 20 53 51 4c 49 54 45   using.** SQLITE
31d0: 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48  _CONFIG_PAGECACH
31e0: 45 20 62 75 74 20 74 68 61 74 20 6d 65 6d 6f 72  E but that memor
31f0: 79 20 68 61 73 20 61 6c 6c 20 62 65 65 6e 20 75  y has all been u
3200: 73 65 64 2c 20 74 68 65 6e 0a 2a 2a 20 69 74 20  sed, then.** it 
3210: 69 73 20 64 65 73 69 72 61 62 6c 65 20 74 6f 20  is desirable to 
3220: 61 76 6f 69 64 20 61 6c 6c 6f 63 61 74 69 6e 67  avoid allocating
3230: 20 61 20 6e 65 77 20 70 61 67 65 20 63 61 63 68   a new page cach
3240: 65 20 65 6e 74 72 79 20 62 65 63 61 75 73 65 0a  e entry because.
3250: 2a 2a 20 70 72 65 73 75 6d 61 62 6c 79 20 53 51  ** presumably SQ
3260: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45  LITE_CONFIG_PAGE
3270: 43 41 43 48 45 20 77 61 73 20 73 75 70 70 6f 73  CACHE was suppos
3280: 65 20 74 6f 20 62 65 20 73 75 66 66 69 63 69 65  e to be sufficie
3290: 6e 74 0a 2a 2a 20 66 6f 72 20 61 6c 6c 20 70 61  nt.** for all pa
32a0: 67 65 20 63 61 63 68 65 20 6e 65 65 64 73 20 61  ge cache needs a
32b0: 6e 64 20 77 65 20 73 68 6f 75 6c 64 20 6e 6f 74  nd we should not
32c0: 20 6e 65 65 64 20 74 6f 20 73 70 69 6c 6c 20 74   need to spill t
32d0: 68 65 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e  he.** allocation
32e0: 20 6f 6e 74 6f 20 74 68 65 20 68 65 61 70 2e 0a   onto the heap..
32f0: 2a 2a 0a 2a 2a 20 4f 72 2c 20 74 68 65 20 68 65  **.** Or, the he
3300: 61 70 20 69 73 20 75 73 65 64 20 66 6f 72 20 61  ap is used for a
3310: 6c 6c 20 70 61 67 65 20 63 61 63 68 65 20 6d 65  ll page cache me
3320: 6d 6f 72 79 20 62 75 74 20 74 68 65 20 68 65 61  mory but the hea
3330: 70 20 69 73 0a 2a 2a 20 75 6e 64 65 72 20 6d 65  p is.** under me
3340: 6d 6f 72 79 20 70 72 65 73 73 75 72 65 2c 20 74  mory pressure, t
3350: 68 65 6e 20 61 67 61 69 6e 20 69 74 20 69 73 20  hen again it is 
3360: 64 65 73 69 72 61 62 6c 65 20 74 6f 20 61 76 6f  desirable to avo
3370: 69 64 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 6e 67  id.** allocating
3380: 20 61 20 6e 65 77 20 70 61 67 65 20 63 61 63 68   a new page cach
3390: 65 20 65 6e 74 72 79 20 69 6e 20 6f 72 64 65 72  e entry in order
33a0: 20 74 6f 20 61 76 6f 69 64 20 73 74 72 65 73 73   to avoid stress
33b0: 69 6e 67 0a 2a 2a 20 74 68 65 20 68 65 61 70 20  ing.** the heap 
33c0: 65 76 65 6e 20 66 75 72 74 68 65 72 2e 0a 2a 2f  even further..*/
33d0: 0a 73 74 61 74 69 63 20 69 6e 74 20 70 63 61 63  .static int pcac
33e0: 68 65 31 55 6e 64 65 72 4d 65 6d 6f 72 79 50 72  he1UnderMemoryPr
33f0: 65 73 73 75 72 65 28 50 43 61 63 68 65 31 20 2a  essure(PCache1 *
3400: 70 43 61 63 68 65 29 7b 0a 20 20 69 66 28 20 70  pCache){.  if( p
3410: 63 61 63 68 65 31 2e 6e 53 6c 6f 74 20 26 26 20  cache1.nSlot && 
3420: 28 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 2b  (pCache->szPage+
3430: 70 43 61 63 68 65 2d 3e 73 7a 45 78 74 72 61 29  pCache->szExtra)
3440: 3c 3d 70 63 61 63 68 65 31 2e 73 7a 53 6c 6f 74  <=pcache1.szSlot
3450: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 70   ){.    return p
3460: 63 61 63 68 65 31 2e 62 55 6e 64 65 72 50 72 65  cache1.bUnderPre
3470: 73 73 75 72 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a  ssure;.  }else{.
3480: 20 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74      return sqlit
3490: 65 33 48 65 61 70 4e 65 61 72 6c 79 46 75 6c 6c  e3HeapNearlyFull
34a0: 28 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 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 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 2f 2a 2a 2a  **********/./***
3500: 2a 2a 2a 2a 2a 20 47 65 6e 65 72 61 6c 20 49 6d  ***** General Im
3510: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 46 75 6e  plementation Fun
3520: 63 74 69 6f 6e 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a  ctions *********
3530: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
3540: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a  ***********/../*
3550: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f  .** This functio
3560: 6e 20 69 73 20 75 73 65 64 20 74 6f 20 72 65 73  n is used to res
3570: 69 7a 65 20 74 68 65 20 68 61 73 68 20 74 61 62  ize the hash tab
3580: 6c 65 20 75 73 65 64 20 62 79 20 74 68 65 20 63  le used by the c
3590: 61 63 68 65 20 70 61 73 73 65 64 0a 2a 2a 20 61  ache passed.** a
35a0: 73 20 74 68 65 20 66 69 72 73 74 20 61 72 67 75  s the first argu
35b0: 6d 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20  ment..**.** The 
35c0: 50 43 61 63 68 65 20 6d 75 74 65 78 20 6d 75 73  PCache mutex mus
35d0: 74 20 62 65 20 68 65 6c 64 20 77 68 65 6e 20 74  t be held when t
35e0: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  his function is 
35f0: 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69  called..*/.stati
3600: 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 52 65  c void pcache1Re
3610: 73 69 7a 65 48 61 73 68 28 50 43 61 63 68 65 31  sizeHash(PCache1
3620: 20 2a 70 29 7b 0a 20 20 50 67 48 64 72 31 20 2a   *p){.  PgHdr1 *
3630: 2a 61 70 4e 65 77 3b 0a 20 20 75 6e 73 69 67 6e  *apNew;.  unsign
3640: 65 64 20 69 6e 74 20 6e 4e 65 77 3b 0a 20 20 75  ed int nNew;.  u
3650: 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 3b 0a 0a  nsigned int i;..
3660: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
3670: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e  3_mutex_held(p->
3680: 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29  pGroup->mutex) )
3690: 3b 0a 0a 20 20 6e 4e 65 77 20 3d 20 70 2d 3e 6e  ;..  nNew = p->n
36a0: 48 61 73 68 2a 32 3b 0a 20 20 69 66 28 20 6e 4e  Hash*2;.  if( nN
36b0: 65 77 3c 32 35 36 20 29 7b 0a 20 20 20 20 6e 4e  ew<256 ){.    nN
36c0: 65 77 20 3d 20 32 35 36 3b 0a 20 20 7d 0a 0a 20  ew = 256;.  }.. 
36d0: 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74   pcache1LeaveMut
36e0: 65 78 28 70 2d 3e 70 47 72 6f 75 70 29 3b 0a 20  ex(p->pGroup);. 
36f0: 20 69 66 28 20 70 2d 3e 6e 48 61 73 68 20 29 7b   if( p->nHash ){
3700: 20 73 71 6c 69 74 65 33 42 65 67 69 6e 42 65 6e   sqlite3BeginBen
3710: 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 20 7d 0a 20  ignMalloc(); }. 
3720: 20 61 70 4e 65 77 20 3d 20 28 50 67 48 64 72 31   apNew = (PgHdr1
3730: 20 2a 2a 29 73 71 6c 69 74 65 33 4d 61 6c 6c 6f   **)sqlite3Mallo
3740: 63 5a 65 72 6f 28 73 69 7a 65 6f 66 28 50 67 48  cZero(sizeof(PgH
3750: 64 72 31 20 2a 29 2a 6e 4e 65 77 29 3b 0a 20 20  dr1 *)*nNew);.  
3760: 69 66 28 20 70 2d 3e 6e 48 61 73 68 20 29 7b 20  if( p->nHash ){ 
3770: 73 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 6e  sqlite3EndBenign
3780: 4d 61 6c 6c 6f 63 28 29 3b 20 7d 0a 20 20 70 63  Malloc(); }.  pc
3790: 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28  ache1EnterMutex(
37a0: 70 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20 69 66  p->pGroup);.  if
37b0: 28 20 61 70 4e 65 77 20 29 7b 0a 20 20 20 20 66  ( apNew ){.    f
37c0: 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 48 61  or(i=0; i<p->nHa
37d0: 73 68 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20  sh; i++){.      
37e0: 50 67 48 64 72 31 20 2a 70 50 61 67 65 3b 0a 20  PgHdr1 *pPage;. 
37f0: 20 20 20 20 20 50 67 48 64 72 31 20 2a 70 4e 65       PgHdr1 *pNe
3800: 78 74 20 3d 20 70 2d 3e 61 70 48 61 73 68 5b 69  xt = p->apHash[i
3810: 5d 3b 0a 20 20 20 20 20 20 77 68 69 6c 65 28 20  ];.      while( 
3820: 28 70 50 61 67 65 20 3d 20 70 4e 65 78 74 29 21  (pPage = pNext)!
3830: 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 75 6e  =0 ){.        un
3840: 73 69 67 6e 65 64 20 69 6e 74 20 68 20 3d 20 70  signed int h = p
3850: 50 61 67 65 2d 3e 69 4b 65 79 20 25 20 6e 4e 65  Page->iKey % nNe
3860: 77 3b 0a 20 20 20 20 20 20 20 20 70 4e 65 78 74  w;.        pNext
3870: 20 3d 20 70 50 61 67 65 2d 3e 70 4e 65 78 74 3b   = pPage->pNext;
3880: 0a 20 20 20 20 20 20 20 20 70 50 61 67 65 2d 3e  .        pPage->
3890: 70 4e 65 78 74 20 3d 20 61 70 4e 65 77 5b 68 5d  pNext = apNew[h]
38a0: 3b 0a 20 20 20 20 20 20 20 20 61 70 4e 65 77 5b  ;.        apNew[
38b0: 68 5d 20 3d 20 70 50 61 67 65 3b 0a 20 20 20 20  h] = pPage;.    
38c0: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73 71    }.    }.    sq
38d0: 6c 69 74 65 33 5f 66 72 65 65 28 70 2d 3e 61 70  lite3_free(p->ap
38e0: 48 61 73 68 29 3b 0a 20 20 20 20 70 2d 3e 61 70  Hash);.    p->ap
38f0: 48 61 73 68 20 3d 20 61 70 4e 65 77 3b 0a 20 20  Hash = apNew;.  
3900: 20 20 70 2d 3e 6e 48 61 73 68 20 3d 20 6e 4e 65    p->nHash = nNe
3910: 77 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  w;.  }.}../*.** 
3920: 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73  This function is
3930: 20 75 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79   used internally
3940: 20 74 6f 20 72 65 6d 6f 76 65 20 74 68 65 20 70   to remove the p
3950: 61 67 65 20 70 50 61 67 65 20 66 72 6f 6d 20 74  age pPage from t
3960: 68 65 20 0a 2a 2a 20 50 47 72 6f 75 70 20 4c 52  he .** PGroup LR
3970: 55 20 6c 69 73 74 2c 20 69 66 20 69 73 20 70 61  U list, if is pa
3980: 72 74 20 6f 66 20 69 74 2e 20 49 66 20 70 50 61  rt of it. If pPa
3990: 67 65 20 69 73 20 6e 6f 74 20 70 61 72 74 20 6f  ge is not part o
39a0: 66 20 74 68 65 20 50 47 72 6f 75 70 0a 2a 2a 20  f the PGroup.** 
39b0: 4c 52 55 20 6c 69 73 74 2c 20 74 68 65 6e 20 74  LRU list, then t
39c0: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  his function is 
39d0: 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a 2a 2a 20 54  a no-op..**.** T
39e0: 68 65 20 50 47 72 6f 75 70 20 6d 75 74 65 78 20  he PGroup mutex 
39f0: 6d 75 73 74 20 62 65 20 68 65 6c 64 20 77 68 65  must be held whe
3a00: 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  n this function 
3a10: 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74  is called..*/.st
3a20: 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65  atic void pcache
3a30: 31 50 69 6e 50 61 67 65 28 50 67 48 64 72 31 20  1PinPage(PgHdr1 
3a40: 2a 70 50 61 67 65 29 7b 0a 20 20 50 43 61 63 68  *pPage){.  PCach
3a50: 65 31 20 2a 70 43 61 63 68 65 3b 0a 20 20 50 47  e1 *pCache;.  PG
3a60: 72 6f 75 70 20 2a 70 47 72 6f 75 70 3b 0a 0a 20  roup *pGroup;.. 
3a70: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 21 3d   assert( pPage!=
3a80: 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  0 );.  assert( p
3a90: 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d  Page->isPinned==
3aa0: 30 20 29 3b 0a 20 20 70 43 61 63 68 65 20 3d 20  0 );.  pCache = 
3ab0: 70 50 61 67 65 2d 3e 70 43 61 63 68 65 3b 0a 20  pPage->pCache;. 
3ac0: 20 70 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65   pGroup = pCache
3ad0: 2d 3e 70 47 72 6f 75 70 3b 0a 20 20 61 73 73 65  ->pGroup;.  asse
3ae0: 72 74 28 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e  rt( pPage->pLruN
3af0: 65 78 74 20 7c 7c 20 70 50 61 67 65 3d 3d 70 47  ext || pPage==pG
3b00: 72 6f 75 70 2d 3e 70 4c 72 75 54 61 69 6c 20 29  roup->pLruTail )
3b10: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67  ;.  assert( pPag
3b20: 65 2d 3e 70 4c 72 75 50 72 65 76 20 7c 7c 20 70  e->pLruPrev || p
3b30: 50 61 67 65 3d 3d 70 47 72 6f 75 70 2d 3e 70 4c  Page==pGroup->pL
3b40: 72 75 48 65 61 64 20 29 3b 0a 20 20 61 73 73 65  ruHead );.  asse
3b50: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  rt( sqlite3_mute
3b60: 78 5f 68 65 6c 64 28 70 47 72 6f 75 70 2d 3e 6d  x_held(pGroup->m
3b70: 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 70  utex) );.  if( p
3b80: 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 20 29  Page->pLruPrev )
3b90: 7b 0a 20 20 20 20 70 50 61 67 65 2d 3e 70 4c 72  {.    pPage->pLr
3ba0: 75 50 72 65 76 2d 3e 70 4c 72 75 4e 65 78 74 20  uPrev->pLruNext 
3bb0: 3d 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78  = pPage->pLruNex
3bc0: 74 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  t;.  }else{.    
3bd0: 70 47 72 6f 75 70 2d 3e 70 4c 72 75 48 65 61 64  pGroup->pLruHead
3be0: 20 3d 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65   = pPage->pLruNe
3bf0: 78 74 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 50  xt;.  }.  if( pP
3c00: 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74 20 29 7b  age->pLruNext ){
3c10: 0a 20 20 20 20 70 50 61 67 65 2d 3e 70 4c 72 75  .    pPage->pLru
3c20: 4e 65 78 74 2d 3e 70 4c 72 75 50 72 65 76 20 3d  Next->pLruPrev =
3c30: 20 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76   pPage->pLruPrev
3c40: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70  ;.  }else{.    p
3c50: 47 72 6f 75 70 2d 3e 70 4c 72 75 54 61 69 6c 20  Group->pLruTail 
3c60: 3d 20 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 65  = pPage->pLruPre
3c70: 76 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 2d 3e  v;.  }.  pPage->
3c80: 70 4c 72 75 4e 65 78 74 20 3d 20 30 3b 0a 20 20  pLruNext = 0;.  
3c90: 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 20  pPage->pLruPrev 
3ca0: 3d 20 30 3b 0a 20 20 70 50 61 67 65 2d 3e 69 73  = 0;.  pPage->is
3cb0: 50 69 6e 6e 65 64 20 3d 20 31 3b 0a 20 20 70 43  Pinned = 1;.  pC
3cc0: 61 63 68 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c  ache->nRecyclabl
3cd0: 65 2d 2d 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52  e--;.}.../*.** R
3ce0: 65 6d 6f 76 65 20 74 68 65 20 70 61 67 65 20 73  emove the page s
3cf0: 75 70 70 6c 69 65 64 20 61 73 20 61 6e 20 61 72  upplied as an ar
3d00: 67 75 6d 65 6e 74 20 66 72 6f 6d 20 74 68 65 20  gument from the 
3d10: 68 61 73 68 20 74 61 62 6c 65 20 0a 2a 2a 20 28  hash table .** (
3d20: 50 43 61 63 68 65 31 2e 61 70 48 61 73 68 20 73  PCache1.apHash s
3d30: 74 72 75 63 74 75 72 65 29 20 74 68 61 74 20 69  tructure) that i
3d40: 74 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 73  t is currently s
3d50: 74 6f 72 65 64 20 69 6e 2e 0a 2a 2a 0a 2a 2a 20  tored in..**.** 
3d60: 54 68 65 20 50 47 72 6f 75 70 20 6d 75 74 65 78  The PGroup mutex
3d70: 20 6d 75 73 74 20 62 65 20 68 65 6c 64 20 77 68   must be held wh
3d80: 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e  en this function
3d90: 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73   is called..*/.s
3da0: 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68  tatic void pcach
3db0: 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73 68  e1RemoveFromHash
3dc0: 28 50 67 48 64 72 31 20 2a 70 50 61 67 65 29 7b  (PgHdr1 *pPage){
3dd0: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
3de0: 68 3b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43  h;.  PCache1 *pC
3df0: 61 63 68 65 20 3d 20 70 50 61 67 65 2d 3e 70 43  ache = pPage->pC
3e00: 61 63 68 65 3b 0a 20 20 50 67 48 64 72 31 20 2a  ache;.  PgHdr1 *
3e10: 2a 70 70 3b 0a 0a 20 20 61 73 73 65 72 74 28 20  *pp;..  assert( 
3e20: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65  sqlite3_mutex_he
3e30: 6c 64 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75  ld(pCache->pGrou
3e40: 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 68  p->mutex) );.  h
3e50: 20 3d 20 70 50 61 67 65 2d 3e 69 4b 65 79 20 25   = pPage->iKey %
3e60: 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a   pCache->nHash;.
3e70: 20 20 66 6f 72 28 70 70 3d 26 70 43 61 63 68 65    for(pp=&pCache
3e80: 2d 3e 61 70 48 61 73 68 5b 68 5d 3b 20 28 2a 70  ->apHash[h]; (*p
3e90: 70 29 21 3d 70 50 61 67 65 3b 20 70 70 3d 26 28  p)!=pPage; pp=&(
3ea0: 2a 70 70 29 2d 3e 70 4e 65 78 74 29 3b 0a 20 20  *pp)->pNext);.  
3eb0: 2a 70 70 20 3d 20 28 2a 70 70 29 2d 3e 70 4e 65  *pp = (*pp)->pNe
3ec0: 78 74 3b 0a 0a 20 20 70 43 61 63 68 65 2d 3e 6e  xt;..  pCache->n
3ed0: 50 61 67 65 2d 2d 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  Page--;.}../*.**
3ee0: 20 49 66 20 74 68 65 72 65 20 61 72 65 20 63 75   If there are cu
3ef0: 72 72 65 6e 74 6c 79 20 6d 6f 72 65 20 74 68 61  rrently more tha
3f00: 6e 20 6e 4d 61 78 50 61 67 65 20 70 61 67 65 73  n nMaxPage pages
3f10: 20 61 6c 6c 6f 63 61 74 65 64 2c 20 74 72 79 0a   allocated, try.
3f20: 2a 2a 20 74 6f 20 72 65 63 79 63 6c 65 20 70 61  ** to recycle pa
3f30: 67 65 73 20 74 6f 20 72 65 64 75 63 65 20 74 68  ges to reduce th
3f40: 65 20 6e 75 6d 62 65 72 20 61 6c 6c 6f 63 61 74  e number allocat
3f50: 65 64 20 74 6f 20 6e 4d 61 78 50 61 67 65 2e 0a  ed to nMaxPage..
3f60: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70  */.static void p
3f70: 63 61 63 68 65 31 45 6e 66 6f 72 63 65 4d 61 78  cache1EnforceMax
3f80: 50 61 67 65 28 50 47 72 6f 75 70 20 2a 70 47 72  Page(PGroup *pGr
3f90: 6f 75 70 29 7b 0a 20 20 61 73 73 65 72 74 28 20  oup){.  assert( 
3fa0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65  sqlite3_mutex_he
3fb0: 6c 64 28 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78  ld(pGroup->mutex
3fc0: 29 20 29 3b 0a 20 20 77 68 69 6c 65 28 20 70 47  ) );.  while( pG
3fd0: 72 6f 75 70 2d 3e 6e 43 75 72 72 65 6e 74 50 61  roup->nCurrentPa
3fe0: 67 65 3e 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50  ge>pGroup->nMaxP
3ff0: 61 67 65 20 26 26 20 70 47 72 6f 75 70 2d 3e 70  age && pGroup->p
4000: 4c 72 75 54 61 69 6c 20 29 7b 0a 20 20 20 20 50  LruTail ){.    P
4010: 67 48 64 72 31 20 2a 70 20 3d 20 70 47 72 6f 75  gHdr1 *p = pGrou
4020: 70 2d 3e 70 4c 72 75 54 61 69 6c 3b 0a 20 20 20  p->pLruTail;.   
4030: 20 61 73 73 65 72 74 28 20 70 2d 3e 70 43 61 63   assert( p->pCac
4040: 68 65 2d 3e 70 47 72 6f 75 70 3d 3d 70 47 72 6f  he->pGroup==pGro
4050: 75 70 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74  up );.    assert
4060: 28 20 70 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d 30  ( p->isPinned==0
4070: 20 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 50   );.    pcache1P
4080: 69 6e 50 61 67 65 28 70 29 3b 0a 20 20 20 20 70  inPage(p);.    p
4090: 63 61 63 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d  cache1RemoveFrom
40a0: 48 61 73 68 28 70 29 3b 0a 20 20 20 20 70 63 61  Hash(p);.    pca
40b0: 63 68 65 31 46 72 65 65 50 61 67 65 28 70 29 3b  che1FreePage(p);
40c0: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 69  .  }.}../*.** Di
40d0: 73 63 61 72 64 20 61 6c 6c 20 70 61 67 65 73 20  scard all pages 
40e0: 66 72 6f 6d 20 63 61 63 68 65 20 70 43 61 63 68  from cache pCach
40f0: 65 20 77 69 74 68 20 61 20 70 61 67 65 20 6e 75  e with a page nu
4100: 6d 62 65 72 20 28 6b 65 79 20 76 61 6c 75 65 29  mber (key value)
4110: 20 0a 2a 2a 20 67 72 65 61 74 65 72 20 74 68 61   .** greater tha
4120: 6e 20 6f 72 20 65 71 75 61 6c 20 74 6f 20 69 4c  n or equal to iL
4130: 69 6d 69 74 2e 20 41 6e 79 20 70 69 6e 6e 65 64  imit. Any pinned
4140: 20 70 61 67 65 73 20 74 68 61 74 20 6d 65 65 74   pages that meet
4150: 20 74 68 69 73 20 0a 2a 2a 20 63 72 69 74 65 72   this .** criter
4160: 69 61 20 61 72 65 20 75 6e 70 69 6e 6e 65 64 20  ia are unpinned 
4170: 62 65 66 6f 72 65 20 74 68 65 79 20 61 72 65 20  before they are 
4180: 64 69 73 63 61 72 64 65 64 2e 0a 2a 2a 0a 2a 2a  discarded..**.**
4190: 20 54 68 65 20 50 43 61 63 68 65 20 6d 75 74 65   The PCache mute
41a0: 78 20 6d 75 73 74 20 62 65 20 68 65 6c 64 20 77  x must be held w
41b0: 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f  hen this functio
41c0: 6e 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a  n is called..*/.
41d0: 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63  static void pcac
41e0: 68 65 31 54 72 75 6e 63 61 74 65 55 6e 73 61 66  he1TruncateUnsaf
41f0: 65 28 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43  e(.  PCache1 *pC
4200: 61 63 68 65 2c 20 20 20 20 20 20 20 20 20 20 20  ache,           
4210: 20 20 2f 2a 20 54 68 65 20 63 61 63 68 65 20 74    /* The cache t
4220: 6f 20 74 72 75 6e 63 61 74 65 20 2a 2f 0a 20 20  o truncate */.  
4230: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4c 69  unsigned int iLi
4240: 6d 69 74 20 20 20 20 20 20 20 20 20 20 2f 2a 20  mit          /* 
4250: 44 72 6f 70 20 70 61 67 65 73 20 77 69 74 68 20  Drop pages with 
4260: 74 68 69 73 20 70 67 6e 6f 20 6f 72 20 6c 61 72  this pgno or lar
4270: 67 65 72 20 2a 2f 0a 29 7b 0a 20 20 54 45 53 54  ger */.){.  TEST
4280: 4f 4e 4c 59 28 20 75 6e 73 69 67 6e 65 64 20 69  ONLY( unsigned i
4290: 6e 74 20 6e 50 61 67 65 20 3d 20 30 3b 20 29 20  nt nPage = 0; ) 
42a0: 20 2f 2a 20 54 6f 20 61 73 73 65 72 74 20 70 43   /* To assert pC
42b0: 61 63 68 65 2d 3e 6e 50 61 67 65 20 69 73 20 63  ache->nPage is c
42c0: 6f 72 72 65 63 74 20 2a 2f 0a 20 20 75 6e 73 69  orrect */.  unsi
42d0: 67 6e 65 64 20 69 6e 74 20 68 3b 0a 20 20 61 73  gned int h;.  as
42e0: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75  sert( sqlite3_mu
42f0: 74 65 78 5f 68 65 6c 64 28 70 43 61 63 68 65 2d  tex_held(pCache-
4300: 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20  >pGroup->mutex) 
4310: 29 3b 0a 20 20 66 6f 72 28 68 3d 30 3b 20 68 3c  );.  for(h=0; h<
4320: 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b 20 68  pCache->nHash; h
4330: 2b 2b 29 7b 0a 20 20 20 20 50 67 48 64 72 31 20  ++){.    PgHdr1 
4340: 2a 2a 70 70 20 3d 20 26 70 43 61 63 68 65 2d 3e  **pp = &pCache->
4350: 61 70 48 61 73 68 5b 68 5d 3b 20 0a 20 20 20 20  apHash[h]; .    
4360: 50 67 48 64 72 31 20 2a 70 50 61 67 65 3b 0a 20  PgHdr1 *pPage;. 
4370: 20 20 20 77 68 69 6c 65 28 20 28 70 50 61 67 65     while( (pPage
4380: 20 3d 20 2a 70 70 29 21 3d 30 20 29 7b 0a 20 20   = *pp)!=0 ){.  
4390: 20 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e 69      if( pPage->i
43a0: 4b 65 79 3e 3d 69 4c 69 6d 69 74 20 29 7b 0a 20  Key>=iLimit ){. 
43b0: 20 20 20 20 20 20 20 70 43 61 63 68 65 2d 3e 6e         pCache->n
43c0: 50 61 67 65 2d 2d 3b 0a 20 20 20 20 20 20 20 20  Page--;.        
43d0: 2a 70 70 20 3d 20 70 50 61 67 65 2d 3e 70 4e 65  *pp = pPage->pNe
43e0: 78 74 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20  xt;.        if( 
43f0: 21 70 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64  !pPage->isPinned
4400: 20 29 20 70 63 61 63 68 65 31 50 69 6e 50 61 67   ) pcache1PinPag
4410: 65 28 70 50 61 67 65 29 3b 0a 20 20 20 20 20 20  e(pPage);.      
4420: 20 20 70 63 61 63 68 65 31 46 72 65 65 50 61 67    pcache1FreePag
4430: 65 28 70 50 61 67 65 29 3b 0a 20 20 20 20 20 20  e(pPage);.      
4440: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70  }else{.        p
4450: 70 20 3d 20 26 70 50 61 67 65 2d 3e 70 4e 65 78  p = &pPage->pNex
4460: 74 3b 0a 20 20 20 20 20 20 20 20 54 45 53 54 4f  t;.        TESTO
4470: 4e 4c 59 28 20 6e 50 61 67 65 2b 2b 3b 20 29 0a  NLY( nPage++; ).
4480: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20        }.    }.  
4490: 7d 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63  }.  assert( pCac
44a0: 68 65 2d 3e 6e 50 61 67 65 3d 3d 6e 50 61 67 65  he->nPage==nPage
44b0: 20 29 3b 0a 7d 0a 0a 2f 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 2a 2a  ****************
4500: 2a 2a 2a 2a 2a 2a 2f 0a 2f 2a 2a 2a 2a 2a 2a 2a  ******/./*******
4510: 2a 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  * sqlite3_pcache
4520: 20 4d 65 74 68 6f 64 73 20 2a 2a 2a 2a 2a 2a 2a   Methods *******
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 2a  ****************
4550: 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20  *******/../*.** 
4560: 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  Implementation o
4570: 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63  f the sqlite3_pc
4580: 61 63 68 65 2e 78 49 6e 69 74 20 6d 65 74 68 6f  ache.xInit metho
4590: 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  d..*/.static int
45a0: 20 70 63 61 63 68 65 31 49 6e 69 74 28 76 6f 69   pcache1Init(voi
45b0: 64 20 2a 4e 6f 74 55 73 65 64 29 7b 0a 20 20 55  d *NotUsed){.  U
45c0: 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28  NUSED_PARAMETER(
45d0: 4e 6f 74 55 73 65 64 29 3b 0a 20 20 61 73 73 65  NotUsed);.  asse
45e0: 72 74 28 20 70 63 61 63 68 65 31 2e 69 73 49 6e  rt( pcache1.isIn
45f0: 69 74 3d 3d 30 20 29 3b 0a 20 20 6d 65 6d 73 65  it==0 );.  memse
4600: 74 28 26 70 63 61 63 68 65 31 2c 20 30 2c 20 73  t(&pcache1, 0, s
4610: 69 7a 65 6f 66 28 70 63 61 63 68 65 31 29 29 3b  izeof(pcache1));
4620: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c  .  if( sqlite3Gl
4630: 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65  obalConfig.bCore
4640: 4d 75 74 65 78 20 29 7b 0a 20 20 20 20 70 63 61  Mutex ){.    pca
4650: 63 68 65 31 2e 67 72 70 2e 6d 75 74 65 78 20 3d  che1.grp.mutex =
4660: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 61   sqlite3_mutex_a
4670: 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45  lloc(SQLITE_MUTE
4680: 58 5f 53 54 41 54 49 43 5f 4c 52 55 29 3b 0a 20  X_STATIC_LRU);. 
4690: 20 20 20 70 63 61 63 68 65 31 2e 6d 75 74 65 78     pcache1.mutex
46a0: 20 3d 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78   = sqlite3_mutex
46b0: 5f 61 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55  _alloc(SQLITE_MU
46c0: 54 45 58 5f 53 54 41 54 49 43 5f 50 4d 45 4d 29  TEX_STATIC_PMEM)
46d0: 3b 0a 20 20 7d 0a 20 20 70 63 61 63 68 65 31 2e  ;.  }.  pcache1.
46e0: 67 72 70 2e 6d 78 50 69 6e 6e 65 64 20 3d 20 31  grp.mxPinned = 1
46f0: 30 3b 0a 20 20 70 63 61 63 68 65 31 2e 69 73 49  0;.  pcache1.isI
4700: 6e 69 74 20 3d 20 31 3b 0a 20 20 72 65 74 75 72  nit = 1;.  retur
4710: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a  n SQLITE_OK;.}..
4720: 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61  /*.** Implementa
4730: 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69  tion of the sqli
4740: 74 65 33 5f 70 63 61 63 68 65 2e 78 53 68 75 74  te3_pcache.xShut
4750: 64 6f 77 6e 20 6d 65 74 68 6f 64 2e 0a 2a 2a 20  down method..** 
4760: 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 73 74  Note that the st
4770: 61 74 69 63 20 6d 75 74 65 78 20 61 6c 6c 6f 63  atic mutex alloc
4780: 61 74 65 64 20 69 6e 20 78 49 6e 69 74 20 64 6f  ated in xInit do
4790: 65 73 20 0a 2a 2a 20 6e 6f 74 20 6e 65 65 64 20  es .** not need 
47a0: 74 6f 20 62 65 20 66 72 65 65 64 2e 0a 2a 2f 0a  to be freed..*/.
47b0: 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63  static void pcac
47c0: 68 65 31 53 68 75 74 64 6f 77 6e 28 76 6f 69 64  he1Shutdown(void
47d0: 20 2a 4e 6f 74 55 73 65 64 29 7b 0a 20 20 55 4e   *NotUsed){.  UN
47e0: 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 4e  USED_PARAMETER(N
47f0: 6f 74 55 73 65 64 29 3b 0a 20 20 61 73 73 65 72  otUsed);.  asser
4800: 74 28 20 70 63 61 63 68 65 31 2e 69 73 49 6e 69  t( pcache1.isIni
4810: 74 21 3d 30 20 29 3b 0a 20 20 6d 65 6d 73 65 74  t!=0 );.  memset
4820: 28 26 70 63 61 63 68 65 31 2c 20 30 2c 20 73 69  (&pcache1, 0, si
4830: 7a 65 6f 66 28 70 63 61 63 68 65 31 29 29 3b 0a  zeof(pcache1));.
4840: 7d 0a 0a 2f 2a 20 66 6f 72 77 61 72 64 20 64 65  }../* forward de
4850: 63 6c 61 72 61 74 69 6f 6e 20 2a 2f 0a 73 74 61  claration */.sta
4860: 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31  tic void pcache1
4870: 44 65 73 74 72 6f 79 28 73 71 6c 69 74 65 33 5f  Destroy(sqlite3_
4880: 70 63 61 63 68 65 20 2a 70 29 3b 0a 0a 2f 2a 0a  pcache *p);../*.
4890: 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  ** Implementatio
48a0: 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33  n of the sqlite3
48b0: 5f 70 63 61 63 68 65 2e 78 43 72 65 61 74 65 20  _pcache.xCreate 
48c0: 6d 65 74 68 6f 64 2e 0a 2a 2a 0a 2a 2a 20 41 6c  method..**.** Al
48d0: 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 63 61 63  locate a new cac
48e0: 68 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 73 71  he..*/.static sq
48f0: 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 63  lite3_pcache *pc
4900: 61 63 68 65 31 43 72 65 61 74 65 28 69 6e 74 20  ache1Create(int 
4910: 73 7a 50 61 67 65 2c 20 69 6e 74 20 73 7a 45 78  szPage, int szEx
4920: 74 72 61 2c 20 69 6e 74 20 62 50 75 72 67 65 61  tra, int bPurgea
4930: 62 6c 65 29 7b 0a 20 20 50 43 61 63 68 65 31 20  ble){.  PCache1 
4940: 2a 70 43 61 63 68 65 3b 20 20 20 20 20 20 2f 2a  *pCache;      /*
4950: 20 54 68 65 20 6e 65 77 6c 79 20 63 72 65 61 74   The newly creat
4960: 65 64 20 70 61 67 65 20 63 61 63 68 65 20 2a 2f  ed page cache */
4970: 0a 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f 75  .  PGroup *pGrou
4980: 70 3b 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20  p;       /* The 
4990: 67 72 6f 75 70 20 74 68 65 20 6e 65 77 20 70 61  group the new pa
49a0: 67 65 20 63 61 63 68 65 20 77 69 6c 6c 20 62 65  ge cache will be
49b0: 6c 6f 6e 67 20 74 6f 20 2a 2f 0a 20 20 69 6e 74  long to */.  int
49c0: 20 73 7a 3b 20 20 20 20 20 20 20 20 20 20 20 20   sz;            
49d0: 20 20 20 2f 2a 20 42 79 74 65 73 20 6f 66 20 6d     /* Bytes of m
49e0: 65 6d 6f 72 79 20 72 65 71 75 69 72 65 64 20 74  emory required t
49f0: 6f 20 61 6c 6c 6f 63 61 74 65 20 74 68 65 20 6e  o allocate the n
4a00: 65 77 20 63 61 63 68 65 20 2a 2f 0a 0a 20 20 2f  ew cache */..  /
4a10: 2a 0a 20 20 2a 2a 20 54 68 65 20 73 65 70 61 72  *.  ** The separ
4a20: 61 74 65 43 61 63 68 65 20 76 61 72 69 61 62 6c  ateCache variabl
4a30: 65 20 69 73 20 74 72 75 65 20 69 66 20 65 61 63  e is true if eac
4a40: 68 20 50 43 61 63 68 65 20 68 61 73 20 69 74 73  h PCache has its
4a50: 20 6f 77 6e 20 70 72 69 76 61 74 65 0a 20 20 2a   own private.  *
4a60: 2a 20 50 47 72 6f 75 70 2e 20 20 49 6e 20 6f 74  * PGroup.  In ot
4a70: 68 65 72 20 77 6f 72 64 73 2c 20 73 65 70 61 72  her words, separ
4a80: 61 74 65 43 61 63 68 65 20 69 73 20 74 72 75 65  ateCache is true
4a90: 20 66 6f 72 20 6d 6f 64 65 20 28 31 29 20 77 68   for mode (1) wh
4aa0: 65 72 65 20 6e 6f 0a 20 20 2a 2a 20 6d 75 74 65  ere no.  ** mute
4ab0: 78 69 6e 67 20 69 73 20 72 65 71 75 69 72 65 64  xing is required
4ac0: 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20  ..  **.  **   * 
4ad0: 20 41 6c 77 61 79 73 20 75 73 65 20 61 20 75 6e   Always use a un
4ae0: 69 66 69 65 64 20 63 61 63 68 65 20 28 6d 6f 64  ified cache (mod
4af0: 65 2d 32 29 20 69 66 20 45 4e 41 42 4c 45 5f 4d  e-2) if ENABLE_M
4b00: 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54  EMORY_MANAGEMENT
4b10: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 20  .  **.  **   *  
4b20: 41 6c 77 61 79 73 20 75 73 65 20 61 20 75 6e 69  Always use a uni
4b30: 66 69 65 64 20 63 61 63 68 65 20 69 6e 20 73 69  fied cache in si
4b40: 6e 67 6c 65 2d 74 68 72 65 61 64 65 64 20 61 70  ngle-threaded ap
4b50: 70 6c 69 63 61 74 69 6f 6e 73 0a 20 20 2a 2a 0a  plications.  **.
4b60: 20 20 2a 2a 20 20 20 2a 20 20 4f 74 68 65 72 77    **   *  Otherw
4b70: 69 73 65 20 28 69 66 20 6d 75 6c 74 69 2d 74 68  ise (if multi-th
4b80: 72 65 61 64 65 64 20 61 6e 64 20 45 4e 41 42 4c  readed and ENABL
4b90: 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d  E_MEMORY_MANAGEM
4ba0: 45 4e 54 20 69 73 20 6f 66 66 29 0a 20 20 2a 2a  ENT is off).  **
4bb0: 20 20 20 20 20 20 75 73 65 20 73 65 70 61 72 61        use separa
4bc0: 74 65 20 63 61 63 68 65 73 20 28 6d 6f 64 65 2d  te caches (mode-
4bd0: 31 29 0a 20 20 2a 2f 0a 23 69 66 20 64 65 66 69  1).  */.#if defi
4be0: 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c  ned(SQLITE_ENABL
4bf0: 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d  E_MEMORY_MANAGEM
4c00: 45 4e 54 29 20 7c 7c 20 53 51 4c 49 54 45 5f 54  ENT) || SQLITE_T
4c10: 48 52 45 41 44 53 41 46 45 3d 3d 30 0a 20 20 63  HREADSAFE==0.  c
4c20: 6f 6e 73 74 20 69 6e 74 20 73 65 70 61 72 61 74  onst int separat
4c30: 65 43 61 63 68 65 20 3d 20 30 3b 0a 23 65 6c 73  eCache = 0;.#els
4c40: 65 0a 20 20 69 6e 74 20 73 65 70 61 72 61 74 65  e.  int separate
4c50: 43 61 63 68 65 20 3d 20 73 71 6c 69 74 65 33 47  Cache = sqlite3G
4c60: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72  lobalConfig.bCor
4c70: 65 4d 75 74 65 78 3e 30 3b 0a 23 65 6e 64 69 66  eMutex>0;.#endif
4c80: 0a 0a 20 20 61 73 73 65 72 74 28 20 28 73 7a 50  ..  assert( (szP
4c90: 61 67 65 20 26 20 28 73 7a 50 61 67 65 2d 31 29  age & (szPage-1)
4ca0: 29 3d 3d 30 20 26 26 20 73 7a 50 61 67 65 3e 3d  )==0 && szPage>=
4cb0: 35 31 32 20 26 26 20 73 7a 50 61 67 65 3c 3d 36  512 && szPage<=6
4cc0: 35 35 33 36 20 29 3b 0a 20 20 61 73 73 65 72 74  5536 );.  assert
4cd0: 28 20 73 7a 45 78 74 72 61 20 3c 20 33 30 30 20  ( szExtra < 300 
4ce0: 29 3b 0a 0a 20 20 73 7a 20 3d 20 73 69 7a 65 6f  );..  sz = sizeo
4cf0: 66 28 50 43 61 63 68 65 31 29 20 2b 20 73 69 7a  f(PCache1) + siz
4d00: 65 6f 66 28 50 47 72 6f 75 70 29 2a 73 65 70 61  eof(PGroup)*sepa
4d10: 72 61 74 65 43 61 63 68 65 3b 0a 20 20 70 43 61  rateCache;.  pCa
4d20: 63 68 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a  che = (PCache1 *
4d30: 29 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a 65  )sqlite3MallocZe
4d40: 72 6f 28 73 7a 29 3b 0a 20 20 69 66 28 20 70 43  ro(sz);.  if( pC
4d50: 61 63 68 65 20 29 7b 0a 20 20 20 20 69 66 28 20  ache ){.    if( 
4d60: 73 65 70 61 72 61 74 65 43 61 63 68 65 20 29 7b  separateCache ){
4d70: 0a 20 20 20 20 20 20 70 47 72 6f 75 70 20 3d 20  .      pGroup = 
4d80: 28 50 47 72 6f 75 70 2a 29 26 70 43 61 63 68 65  (PGroup*)&pCache
4d90: 5b 31 5d 3b 0a 20 20 20 20 20 20 70 47 72 6f 75  [1];.      pGrou
4da0: 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 20 31 30  p->mxPinned = 10
4db0: 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ;.    }else{.   
4dc0: 20 20 20 70 47 72 6f 75 70 20 3d 20 26 70 63 61     pGroup = &pca
4dd0: 63 68 65 31 2e 67 72 70 3b 0a 20 20 20 20 7d 0a  che1.grp;.    }.
4de0: 20 20 20 20 70 43 61 63 68 65 2d 3e 70 47 72 6f      pCache->pGro
4df0: 75 70 20 3d 20 70 47 72 6f 75 70 3b 0a 20 20 20  up = pGroup;.   
4e00: 20 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 20   pCache->szPage 
4e10: 3d 20 73 7a 50 61 67 65 3b 0a 20 20 20 20 70 43  = szPage;.    pC
4e20: 61 63 68 65 2d 3e 73 7a 45 78 74 72 61 20 3d 20  ache->szExtra = 
4e30: 73 7a 45 78 74 72 61 3b 0a 20 20 20 20 70 43 61  szExtra;.    pCa
4e40: 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20  che->bPurgeable 
4e50: 3d 20 28 62 50 75 72 67 65 61 62 6c 65 20 3f 20  = (bPurgeable ? 
4e60: 31 20 3a 20 30 29 3b 0a 20 20 20 20 70 63 61 63  1 : 0);.    pcac
4e70: 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70 47  he1EnterMutex(pG
4e80: 72 6f 75 70 29 3b 0a 20 20 20 20 70 63 61 63 68  roup);.    pcach
4e90: 65 31 52 65 73 69 7a 65 48 61 73 68 28 70 43 61  e1ResizeHash(pCa
4ea0: 63 68 65 29 3b 0a 20 20 20 20 69 66 28 20 62 50  che);.    if( bP
4eb0: 75 72 67 65 61 62 6c 65 20 29 7b 0a 20 20 20 20  urgeable ){.    
4ec0: 20 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 20 3d    pCache->nMin =
4ed0: 20 31 30 3b 0a 20 20 20 20 20 20 70 47 72 6f 75   10;.      pGrou
4ee0: 70 2d 3e 6e 4d 69 6e 50 61 67 65 20 2b 3d 20 70  p->nMinPage += p
4ef0: 43 61 63 68 65 2d 3e 6e 4d 69 6e 3b 0a 20 20 20  Cache->nMin;.   
4f00: 20 20 20 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e     pGroup->mxPin
4f10: 6e 65 64 20 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d  ned = pGroup->nM
4f20: 61 78 50 61 67 65 20 2b 20 31 30 20 2d 20 70 47  axPage + 10 - pG
4f30: 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 3b 0a  roup->nMinPage;.
4f40: 20 20 20 20 7d 0a 20 20 20 20 70 63 61 63 68 65      }.    pcache
4f50: 31 4c 65 61 76 65 4d 75 74 65 78 28 70 47 72 6f  1LeaveMutex(pGro
4f60: 75 70 29 3b 0a 20 20 20 20 69 66 28 20 70 43 61  up);.    if( pCa
4f70: 63 68 65 2d 3e 6e 48 61 73 68 3d 3d 30 20 29 7b  che->nHash==0 ){
4f80: 0a 20 20 20 20 20 20 70 63 61 63 68 65 31 44 65  .      pcache1De
4f90: 73 74 72 6f 79 28 28 73 71 6c 69 74 65 33 5f 70  stroy((sqlite3_p
4fa0: 63 61 63 68 65 2a 29 70 43 61 63 68 65 29 3b 0a  cache*)pCache);.
4fb0: 20 20 20 20 20 20 70 43 61 63 68 65 20 3d 20 30        pCache = 0
4fc0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65  ;.    }.  }.  re
4fd0: 74 75 72 6e 20 28 73 71 6c 69 74 65 33 5f 70 63  turn (sqlite3_pc
4fe0: 61 63 68 65 20 2a 29 70 43 61 63 68 65 3b 0a 7d  ache *)pCache;.}
4ff0: 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e  ../*.** Implemen
5000: 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71  tation of the sq
5010: 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78 43 61  lite3_pcache.xCa
5020: 63 68 65 73 69 7a 65 20 6d 65 74 68 6f 64 2e 20  chesize method. 
5030: 0a 2a 2a 0a 2a 2a 20 43 6f 6e 66 69 67 75 72 65  .**.** Configure
5040: 20 74 68 65 20 63 61 63 68 65 5f 73 69 7a 65 20   the cache_size 
5050: 6c 69 6d 69 74 20 66 6f 72 20 61 20 63 61 63 68  limit for a cach
5060: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  e..*/.static voi
5070: 64 20 70 63 61 63 68 65 31 43 61 63 68 65 73 69  d pcache1Cachesi
5080: 7a 65 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68  ze(sqlite3_pcach
5090: 65 20 2a 70 2c 20 69 6e 74 20 6e 4d 61 78 29 7b  e *p, int nMax){
50a0: 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63  .  PCache1 *pCac
50b0: 68 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29  he = (PCache1 *)
50c0: 70 3b 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d  p;.  if( pCache-
50d0: 3e 62 50 75 72 67 65 61 62 6c 65 20 29 7b 0a 20  >bPurgeable ){. 
50e0: 20 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f 75     PGroup *pGrou
50f0: 70 20 3d 20 70 43 61 63 68 65 2d 3e 70 47 72 6f  p = pCache->pGro
5100: 75 70 3b 0a 20 20 20 20 70 63 61 63 68 65 31 45  up;.    pcache1E
5110: 6e 74 65 72 4d 75 74 65 78 28 70 47 72 6f 75 70  nterMutex(pGroup
5120: 29 3b 0a 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e  );.    pGroup->n
5130: 4d 61 78 50 61 67 65 20 2b 3d 20 28 6e 4d 61 78  MaxPage += (nMax
5140: 20 2d 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 29   - pCache->nMax)
5150: 3b 0a 20 20 20 20 70 47 72 6f 75 70 2d 3e 6d 78  ;.    pGroup->mx
5160: 50 69 6e 6e 65 64 20 3d 20 70 47 72 6f 75 70 2d  Pinned = pGroup-
5170: 3e 6e 4d 61 78 50 61 67 65 20 2b 20 31 30 20 2d  >nMaxPage + 10 -
5180: 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67   pGroup->nMinPag
5190: 65 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 6e  e;.    pCache->n
51a0: 4d 61 78 20 3d 20 6e 4d 61 78 3b 0a 20 20 20 20  Max = nMax;.    
51b0: 70 43 61 63 68 65 2d 3e 6e 39 30 70 63 74 20 3d  pCache->n90pct =
51c0: 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 2a 39 2f   pCache->nMax*9/
51d0: 31 30 3b 0a 20 20 20 20 70 63 61 63 68 65 31 45  10;.    pcache1E
51e0: 6e 66 6f 72 63 65 4d 61 78 50 61 67 65 28 70 47  nforceMaxPage(pG
51f0: 72 6f 75 70 29 3b 0a 20 20 20 20 70 63 61 63 68  roup);.    pcach
5200: 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70 47 72  e1LeaveMutex(pGr
5210: 6f 75 70 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a  oup);.  }.}../*.
5220: 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  ** Implementatio
5230: 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33  n of the sqlite3
5240: 5f 70 63 61 63 68 65 2e 78 53 68 72 69 6e 6b 20  _pcache.xShrink 
5250: 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 46  method. .**.** F
5260: 72 65 65 20 75 70 20 61 73 20 6d 75 63 68 20 6d  ree up as much m
5270: 65 6d 6f 72 79 20 61 73 20 70 6f 73 73 69 62 6c  emory as possibl
5280: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  e..*/.static voi
5290: 64 20 70 63 61 63 68 65 31 53 68 72 69 6e 6b 28  d pcache1Shrink(
52a0: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a  sqlite3_pcache *
52b0: 70 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70  p){.  PCache1 *p
52c0: 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 65 31  Cache = (PCache1
52d0: 2a 29 70 3b 0a 20 20 69 66 28 20 70 43 61 63 68  *)p;.  if( pCach
52e0: 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 29 7b  e->bPurgeable ){
52f0: 0a 20 20 20 20 50 47 72 6f 75 70 20 2a 70 47 72  .    PGroup *pGr
5300: 6f 75 70 20 3d 20 70 43 61 63 68 65 2d 3e 70 47  oup = pCache->pG
5310: 72 6f 75 70 3b 0a 20 20 20 20 69 6e 74 20 73 61  roup;.    int sa
5320: 76 65 64 4d 61 78 50 61 67 65 3b 0a 20 20 20 20  vedMaxPage;.    
5330: 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65  pcache1EnterMute
5340: 78 28 70 47 72 6f 75 70 29 3b 0a 20 20 20 20 73  x(pGroup);.    s
5350: 61 76 65 64 4d 61 78 50 61 67 65 20 3d 20 70 47  avedMaxPage = pG
5360: 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 3b 0a  roup->nMaxPage;.
5370: 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78      pGroup->nMax
5380: 50 61 67 65 20 3d 20 30 3b 0a 20 20 20 20 70 63  Page = 0;.    pc
5390: 61 63 68 65 31 45 6e 66 6f 72 63 65 4d 61 78 50  ache1EnforceMaxP
53a0: 61 67 65 28 70 47 72 6f 75 70 29 3b 0a 20 20 20  age(pGroup);.   
53b0: 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67   pGroup->nMaxPag
53c0: 65 20 3d 20 73 61 76 65 64 4d 61 78 50 61 67 65  e = savedMaxPage
53d0: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 4c 65 61  ;.    pcache1Lea
53e0: 76 65 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b  veMutex(pGroup);
53f0: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d  .  }.}../*.** Im
5400: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20  plementation of 
5410: 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63  the sqlite3_pcac
5420: 68 65 2e 78 50 61 67 65 63 6f 75 6e 74 20 6d 65  he.xPagecount me
5430: 74 68 6f 64 2e 20 0a 2a 2f 0a 73 74 61 74 69 63  thod. .*/.static
5440: 20 69 6e 74 20 70 63 61 63 68 65 31 50 61 67 65   int pcache1Page
5450: 63 6f 75 6e 74 28 73 71 6c 69 74 65 33 5f 70 63  count(sqlite3_pc
5460: 61 63 68 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20  ache *p){.  int 
5470: 6e 3b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43  n;.  PCache1 *pC
5480: 61 63 68 65 20 3d 20 28 50 43 61 63 68 65 31 2a  ache = (PCache1*
5490: 29 70 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 74  )p;.  pcache1Ent
54a0: 65 72 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e  erMutex(pCache->
54b0: 70 47 72 6f 75 70 29 3b 0a 20 20 6e 20 3d 20 70  pGroup);.  n = p
54c0: 43 61 63 68 65 2d 3e 6e 50 61 67 65 3b 0a 20 20  Cache->nPage;.  
54d0: 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65  pcache1LeaveMute
54e0: 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70  x(pCache->pGroup
54f0: 29 3b 0a 20 20 72 65 74 75 72 6e 20 6e 3b 0a 7d  );.  return n;.}
5500: 0a 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65  .../*.** Impleme
5510: 6e 74 20 73 74 65 70 73 20 33 2c 20 34 2c 20 61  nt steps 3, 4, a
5520: 6e 64 20 35 20 6f 66 20 74 68 65 20 70 63 61 63  nd 5 of the pcac
5530: 68 65 31 46 65 74 63 68 28 29 20 61 6c 67 6f 72  he1Fetch() algor
5540: 69 74 68 6d 20 64 65 73 63 72 69 62 65 64 0a 2a  ithm described.*
5550: 2a 20 69 6e 20 74 68 65 20 68 65 61 64 65 72 20  * in the header 
5560: 6f 66 20 74 68 65 20 70 63 61 63 68 65 31 46 65  of the pcache1Fe
5570: 74 63 68 28 29 20 70 72 6f 63 65 64 75 72 65 2e  tch() procedure.
5580: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 73 74 65 70  .**.** This step
5590: 73 20 61 72 65 20 62 72 6f 6b 65 6e 20 6f 75 74  s are broken out
55a0: 20 69 6e 74 6f 20 61 20 73 65 70 61 72 61 74 65   into a separate
55b0: 20 70 72 6f 63 65 64 75 72 65 20 62 65 63 61 75   procedure becau
55c0: 73 65 20 74 68 65 79 20 61 72 65 0a 2a 2a 20 75  se they are.** u
55d0: 73 75 61 6c 6c 79 20 6e 6f 74 20 6e 65 65 64 65  sually not neede
55e0: 64 2c 20 61 6e 64 20 62 79 20 61 76 6f 69 64 69  d, and by avoidi
55f0: 6e 67 20 74 68 65 20 73 74 61 63 6b 20 69 6e 69  ng the stack ini
5600: 74 69 61 6c 69 7a 61 74 69 6f 6e 20 72 65 71 75  tialization requ
5610: 69 72 65 64 0a 2a 2a 20 66 6f 72 20 74 68 65 73  ired.** for thes
5620: 65 20 73 74 65 70 73 2c 20 74 68 65 20 6d 61 69  e steps, the mai
5630: 6e 20 70 63 61 63 68 65 31 46 65 74 63 68 28 29  n pcache1Fetch()
5640: 20 70 72 6f 63 65 64 75 72 65 20 63 61 6e 20 72   procedure can r
5650: 75 6e 20 66 61 73 74 65 72 2e 0a 2a 2f 0a 73 74  un faster..*/.st
5660: 61 74 69 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e  atic SQLITE_NOIN
5670: 4c 49 4e 45 20 50 67 48 64 72 31 20 2a 70 63 61  LINE PgHdr1 *pca
5680: 63 68 65 31 46 65 74 63 68 53 74 61 67 65 32 28  che1FetchStage2(
5690: 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63  .  PCache1 *pCac
56a0: 68 65 2c 20 0a 20 20 75 6e 73 69 67 6e 65 64 20  he, .  unsigned 
56b0: 69 6e 74 20 69 4b 65 79 2c 20 0a 20 20 69 6e 74  int iKey, .  int
56c0: 20 63 72 65 61 74 65 46 6c 61 67 0a 29 7b 0a 20   createFlag.){. 
56d0: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 50   unsigned int nP
56e0: 69 6e 6e 65 64 3b 0a 20 20 50 47 72 6f 75 70 20  inned;.  PGroup 
56f0: 2a 70 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65  *pGroup = pCache
5700: 2d 3e 70 47 72 6f 75 70 3b 0a 20 20 50 67 48 64  ->pGroup;.  PgHd
5710: 72 31 20 2a 70 50 61 67 65 20 3d 20 30 3b 0a 0a  r1 *pPage = 0;..
5720: 20 20 2f 2a 20 53 74 65 70 20 33 3a 20 41 62 6f    /* Step 3: Abo
5730: 72 74 20 69 66 20 63 72 65 61 74 65 46 6c 61 67  rt if createFlag
5740: 20 69 73 20 31 20 62 75 74 20 74 68 65 20 63 61   is 1 but the ca
5750: 63 68 65 20 69 73 20 6e 65 61 72 6c 79 20 66 75  che is nearly fu
5760: 6c 6c 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20  ll */.  assert( 
5770: 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 20 3e 3d  pCache->nPage >=
5780: 20 70 43 61 63 68 65 2d 3e 6e 52 65 63 79 63 6c   pCache->nRecycl
5790: 61 62 6c 65 20 29 3b 0a 20 20 6e 50 69 6e 6e 65  able );.  nPinne
57a0: 64 20 3d 20 70 43 61 63 68 65 2d 3e 6e 50 61 67  d = pCache->nPag
57b0: 65 20 2d 20 70 43 61 63 68 65 2d 3e 6e 52 65 63  e - pCache->nRec
57c0: 79 63 6c 61 62 6c 65 3b 0a 20 20 61 73 73 65 72  yclable;.  asser
57d0: 74 28 20 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e  t( pGroup->mxPin
57e0: 6e 65 64 20 3d 3d 20 70 47 72 6f 75 70 2d 3e 6e  ned == pGroup->n
57f0: 4d 61 78 50 61 67 65 20 2b 20 31 30 20 2d 20 70  MaxPage + 10 - p
5800: 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 20  Group->nMinPage 
5810: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61  );.  assert( pCa
5820: 63 68 65 2d 3e 6e 39 30 70 63 74 20 3d 3d 20 70  che->n90pct == p
5830: 43 61 63 68 65 2d 3e 6e 4d 61 78 2a 39 2f 31 30  Cache->nMax*9/10
5840: 20 29 3b 0a 20 20 69 66 28 20 63 72 65 61 74 65   );.  if( create
5850: 46 6c 61 67 3d 3d 31 20 26 26 20 28 0a 20 20 20  Flag==1 && (.   
5860: 20 20 20 20 20 6e 50 69 6e 6e 65 64 3e 3d 70 47       nPinned>=pG
5870: 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 0a 20  roup->mxPinned. 
5880: 20 20 20 20 7c 7c 20 6e 50 69 6e 6e 65 64 3e 3d      || nPinned>=
5890: 70 43 61 63 68 65 2d 3e 6e 39 30 70 63 74 0a 20  pCache->n90pct. 
58a0: 20 20 20 20 7c 7c 20 28 70 63 61 63 68 65 31 55      || (pcache1U
58b0: 6e 64 65 72 4d 65 6d 6f 72 79 50 72 65 73 73 75  nderMemoryPressu
58c0: 72 65 28 70 43 61 63 68 65 29 20 26 26 20 70 43  re(pCache) && pC
58d0: 61 63 68 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c  ache->nRecyclabl
58e0: 65 3c 6e 50 69 6e 6e 65 64 29 0a 20 20 29 29 7b  e<nPinned).  )){
58f0: 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20  .    return 0;. 
5900: 20 7d 0a 0a 20 20 69 66 28 20 70 43 61 63 68 65   }..  if( pCache
5910: 2d 3e 6e 50 61 67 65 3e 3d 70 43 61 63 68 65 2d  ->nPage>=pCache-
5920: 3e 6e 48 61 73 68 20 29 20 70 63 61 63 68 65 31  >nHash ) pcache1
5930: 52 65 73 69 7a 65 48 61 73 68 28 70 43 61 63 68  ResizeHash(pCach
5940: 65 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43  e);.  assert( pC
5950: 61 63 68 65 2d 3e 6e 48 61 73 68 3e 30 20 26 26  ache->nHash>0 &&
5960: 20 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 20   pCache->apHash 
5970: 29 3b 0a 0a 20 20 2f 2a 20 53 74 65 70 20 34 2e  );..  /* Step 4.
5980: 20 54 72 79 20 74 6f 20 72 65 63 79 63 6c 65 20   Try to recycle 
5990: 61 20 70 61 67 65 2e 20 2a 2f 0a 20 20 69 66 28  a page. */.  if(
59a0: 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61   pCache->bPurgea
59b0: 62 6c 65 20 26 26 20 70 47 72 6f 75 70 2d 3e 70  ble && pGroup->p
59c0: 4c 72 75 54 61 69 6c 20 26 26 20 28 0a 20 20 20  LruTail && (.   
59d0: 20 20 20 20 20 20 28 70 43 61 63 68 65 2d 3e 6e        (pCache->n
59e0: 50 61 67 65 2b 31 3e 3d 70 43 61 63 68 65 2d 3e  Page+1>=pCache->
59f0: 6e 4d 61 78 29 0a 20 20 20 20 20 20 7c 7c 20 70  nMax).      || p
5a00: 47 72 6f 75 70 2d 3e 6e 43 75 72 72 65 6e 74 50  Group->nCurrentP
5a10: 61 67 65 3e 3d 70 47 72 6f 75 70 2d 3e 6e 4d 61  age>=pGroup->nMa
5a20: 78 50 61 67 65 0a 20 20 20 20 20 20 7c 7c 20 70  xPage.      || p
5a30: 63 61 63 68 65 31 55 6e 64 65 72 4d 65 6d 6f 72  cache1UnderMemor
5a40: 79 50 72 65 73 73 75 72 65 28 70 43 61 63 68 65  yPressure(pCache
5a50: 29 0a 20 20 29 29 7b 0a 20 20 20 20 50 43 61 63  ).  )){.    PCac
5a60: 68 65 31 20 2a 70 4f 74 68 65 72 3b 0a 20 20 20  he1 *pOther;.   
5a70: 20 70 50 61 67 65 20 3d 20 70 47 72 6f 75 70 2d   pPage = pGroup-
5a80: 3e 70 4c 72 75 54 61 69 6c 3b 0a 20 20 20 20 61  >pLruTail;.    a
5a90: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 69 73  ssert( pPage->is
5aa0: 50 69 6e 6e 65 64 3d 3d 30 20 29 3b 0a 20 20 20  Pinned==0 );.   
5ab0: 20 70 63 61 63 68 65 31 52 65 6d 6f 76 65 46 72   pcache1RemoveFr
5ac0: 6f 6d 48 61 73 68 28 70 50 61 67 65 29 3b 0a 20  omHash(pPage);. 
5ad0: 20 20 20 70 63 61 63 68 65 31 50 69 6e 50 61 67     pcache1PinPag
5ae0: 65 28 70 50 61 67 65 29 3b 0a 20 20 20 20 70 4f  e(pPage);.    pO
5af0: 74 68 65 72 20 3d 20 70 50 61 67 65 2d 3e 70 43  ther = pPage->pC
5b00: 61 63 68 65 3b 0a 0a 20 20 20 20 2f 2a 20 57 65  ache;..    /* We
5b10: 20 77 61 6e 74 20 74 6f 20 76 65 72 69 66 79 20   want to verify 
5b20: 74 68 61 74 20 73 7a 50 61 67 65 20 61 6e 64 20  that szPage and 
5b30: 73 7a 45 78 74 72 61 20 61 72 65 20 74 68 65 20  szExtra are the 
5b40: 73 61 6d 65 20 66 6f 72 20 70 4f 74 68 65 72 0a  same for pOther.
5b50: 20 20 20 20 2a 2a 20 61 6e 64 20 70 43 61 63 68      ** and pCach
5b60: 65 2e 20 20 41 73 73 65 72 74 20 74 68 61 74 20  e.  Assert that 
5b70: 77 65 20 63 61 6e 20 76 65 72 69 66 79 20 74 68  we can verify th
5b80: 69 73 20 62 79 20 63 6f 6d 70 61 72 69 6e 67 20  is by comparing 
5b90: 73 75 6d 73 2e 20 2a 2f 0a 20 20 20 20 61 73 73  sums. */.    ass
5ba0: 65 72 74 28 20 28 70 43 61 63 68 65 2d 3e 73 7a  ert( (pCache->sz
5bb0: 50 61 67 65 20 26 20 28 70 43 61 63 68 65 2d 3e  Page & (pCache->
5bc0: 73 7a 50 61 67 65 2d 31 29 29 3d 3d 30 20 26 26  szPage-1))==0 &&
5bd0: 20 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 3e   pCache->szPage>
5be0: 3d 35 31 32 20 29 3b 0a 20 20 20 20 61 73 73 65  =512 );.    asse
5bf0: 72 74 28 20 70 43 61 63 68 65 2d 3e 73 7a 45 78  rt( pCache->szEx
5c00: 74 72 61 3c 35 31 32 20 29 3b 0a 20 20 20 20 61  tra<512 );.    a
5c10: 73 73 65 72 74 28 20 28 70 4f 74 68 65 72 2d 3e  ssert( (pOther->
5c20: 73 7a 50 61 67 65 20 26 20 28 70 4f 74 68 65 72  szPage & (pOther
5c30: 2d 3e 73 7a 50 61 67 65 2d 31 29 29 3d 3d 30 20  ->szPage-1))==0 
5c40: 26 26 20 70 4f 74 68 65 72 2d 3e 73 7a 50 61 67  && pOther->szPag
5c50: 65 3e 3d 35 31 32 20 29 3b 0a 20 20 20 20 61 73  e>=512 );.    as
5c60: 73 65 72 74 28 20 70 4f 74 68 65 72 2d 3e 73 7a  sert( pOther->sz
5c70: 45 78 74 72 61 3c 35 31 32 20 29 3b 0a 0a 20 20  Extra<512 );..  
5c80: 20 20 69 66 28 20 70 4f 74 68 65 72 2d 3e 73 7a    if( pOther->sz
5c90: 50 61 67 65 2b 70 4f 74 68 65 72 2d 3e 73 7a 45  Page+pOther->szE
5ca0: 78 74 72 61 20 21 3d 20 70 43 61 63 68 65 2d 3e  xtra != pCache->
5cb0: 73 7a 50 61 67 65 2b 70 43 61 63 68 65 2d 3e 73  szPage+pCache->s
5cc0: 7a 45 78 74 72 61 20 29 7b 0a 20 20 20 20 20 20  zExtra ){.      
5cd0: 70 63 61 63 68 65 31 46 72 65 65 50 61 67 65 28  pcache1FreePage(
5ce0: 70 50 61 67 65 29 3b 0a 20 20 20 20 20 20 70 50  pPage);.      pP
5cf0: 61 67 65 20 3d 20 30 3b 0a 20 20 20 20 7d 65 6c  age = 0;.    }el
5d00: 73 65 7b 0a 20 20 20 20 20 20 70 47 72 6f 75 70  se{.      pGroup
5d10: 2d 3e 6e 43 75 72 72 65 6e 74 50 61 67 65 20 2d  ->nCurrentPage -
5d20: 3d 20 28 70 4f 74 68 65 72 2d 3e 62 50 75 72 67  = (pOther->bPurg
5d30: 65 61 62 6c 65 20 2d 20 70 43 61 63 68 65 2d 3e  eable - pCache->
5d40: 62 50 75 72 67 65 61 62 6c 65 29 3b 0a 20 20 20  bPurgeable);.   
5d50: 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 53 74 65   }.  }..  /* Ste
5d60: 70 20 35 2e 20 49 66 20 61 20 75 73 61 62 6c 65  p 5. If a usable
5d70: 20 70 61 67 65 20 62 75 66 66 65 72 20 68 61 73   page buffer has
5d80: 20 73 74 69 6c 6c 20 6e 6f 74 20 62 65 65 6e 20   still not been 
5d90: 66 6f 75 6e 64 2c 20 0a 20 20 2a 2a 20 61 74 74  found, .  ** att
5da0: 65 6d 70 74 20 74 6f 20 61 6c 6c 6f 63 61 74 65  empt to allocate
5db0: 20 61 20 6e 65 77 20 6f 6e 65 2e 20 0a 20 20 2a   a new one. .  *
5dc0: 2f 0a 20 20 69 66 28 20 21 70 50 61 67 65 20 29  /.  if( !pPage )
5dd0: 7b 0a 20 20 20 20 69 66 28 20 63 72 65 61 74 65  {.    if( create
5de0: 46 6c 61 67 3d 3d 31 20 29 20 73 71 6c 69 74 65  Flag==1 ) sqlite
5df0: 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c  3BeginBenignMall
5e00: 6f 63 28 29 3b 0a 20 20 20 20 70 50 61 67 65 20  oc();.    pPage 
5e10: 3d 20 70 63 61 63 68 65 31 41 6c 6c 6f 63 50 61  = pcache1AllocPa
5e20: 67 65 28 70 43 61 63 68 65 29 3b 0a 20 20 20 20  ge(pCache);.    
5e30: 69 66 28 20 63 72 65 61 74 65 46 6c 61 67 3d 3d  if( createFlag==
5e40: 31 20 29 20 73 71 6c 69 74 65 33 45 6e 64 42 65  1 ) sqlite3EndBe
5e50: 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20  nignMalloc();.  
5e60: 7d 0a 0a 20 20 69 66 28 20 70 50 61 67 65 20 29  }..  if( pPage )
5e70: 7b 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20 69  {.    unsigned i
5e80: 6e 74 20 68 20 3d 20 69 4b 65 79 20 25 20 70 43  nt h = iKey % pC
5e90: 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 20  ache->nHash;.   
5ea0: 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 2b 2b   pCache->nPage++
5eb0: 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 4b 65  ;.    pPage->iKe
5ec0: 79 20 3d 20 69 4b 65 79 3b 0a 20 20 20 20 70 50  y = iKey;.    pP
5ed0: 61 67 65 2d 3e 70 4e 65 78 74 20 3d 20 70 43 61  age->pNext = pCa
5ee0: 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 3b 0a  che->apHash[h];.
5ef0: 20 20 20 20 70 50 61 67 65 2d 3e 70 43 61 63 68      pPage->pCach
5f00: 65 20 3d 20 70 43 61 63 68 65 3b 0a 20 20 20 20  e = pCache;.    
5f10: 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 20  pPage->pLruPrev 
5f20: 3d 20 30 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e  = 0;.    pPage->
5f30: 70 4c 72 75 4e 65 78 74 20 3d 20 30 3b 0a 20 20  pLruNext = 0;.  
5f40: 20 20 70 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65    pPage->isPinne
5f50: 64 20 3d 20 31 3b 0a 20 20 20 20 2a 28 76 6f 69  d = 1;.    *(voi
5f60: 64 20 2a 2a 29 70 50 61 67 65 2d 3e 70 61 67 65  d **)pPage->page
5f70: 2e 70 45 78 74 72 61 20 3d 20 30 3b 0a 20 20 20  .pExtra = 0;.   
5f80: 20 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b   pCache->apHash[
5f90: 68 5d 20 3d 20 70 50 61 67 65 3b 0a 20 20 20 20  h] = pPage;.    
5fa0: 69 66 28 20 69 4b 65 79 3e 70 43 61 63 68 65 2d  if( iKey>pCache-
5fb0: 3e 69 4d 61 78 4b 65 79 20 29 7b 0a 20 20 20 20  >iMaxKey ){.    
5fc0: 20 20 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65    pCache->iMaxKe
5fd0: 79 20 3d 20 69 4b 65 79 3b 0a 20 20 20 20 7d 0a  y = iKey;.    }.
5fe0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 50 61    }.  return pPa
5ff0: 67 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70  ge;.}../*.** Imp
6000: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74  lementation of t
6010: 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68  he sqlite3_pcach
6020: 65 2e 78 46 65 74 63 68 20 6d 65 74 68 6f 64 2e  e.xFetch method.
6030: 20 0a 2a 2a 0a 2a 2a 20 46 65 74 63 68 20 61 20   .**.** Fetch a 
6040: 70 61 67 65 20 62 79 20 6b 65 79 20 76 61 6c 75  page by key valu
6050: 65 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 74 68 65 72  e..**.** Whether
6060: 20 6f 72 20 6e 6f 74 20 61 20 6e 65 77 20 70 61   or not a new pa
6070: 67 65 20 6d 61 79 20 62 65 20 61 6c 6c 6f 63 61  ge may be alloca
6080: 74 65 64 20 62 79 20 74 68 69 73 20 66 75 6e 63  ted by this func
6090: 74 69 6f 6e 20 64 65 70 65 6e 64 73 20 6f 6e 0a  tion depends on.
60a0: 2a 2a 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20  ** the value of 
60b0: 74 68 65 20 63 72 65 61 74 65 46 6c 61 67 20 61  the createFlag a
60c0: 72 67 75 6d 65 6e 74 2e 20 20 30 20 6d 65 61 6e  rgument.  0 mean
60d0: 73 20 64 6f 20 6e 6f 74 20 61 6c 6c 6f 63 61 74  s do not allocat
60e0: 65 20 61 20 6e 65 77 0a 2a 2a 20 70 61 67 65 2e  e a new.** page.
60f0: 20 20 31 20 6d 65 61 6e 73 20 61 6c 6c 6f 63 61    1 means alloca
6100: 74 65 20 61 20 6e 65 77 20 70 61 67 65 20 69 66  te a new page if
6110: 20 73 70 61 63 65 20 69 73 20 65 61 73 69 6c 79   space is easily
6120: 20 61 76 61 69 6c 61 62 6c 65 2e 20 20 32 20 0a   available.  2 .
6130: 2a 2a 20 6d 65 61 6e 73 20 74 6f 20 74 72 79 20  ** means to try 
6140: 72 65 61 6c 6c 79 20 68 61 72 64 20 74 6f 20 61  really hard to a
6150: 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 70 61  llocate a new pa
6160: 67 65 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 61 20  ge..**.** For a 
6170: 6e 6f 6e 2d 70 75 72 67 65 61 62 6c 65 20 63 61  non-purgeable ca
6180: 63 68 65 20 28 61 20 63 61 63 68 65 20 75 73 65  che (a cache use
6190: 64 20 61 73 20 74 68 65 20 73 74 6f 72 61 67 65  d as the storage
61a0: 20 66 6f 72 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72   for an in-memor
61b0: 79 0a 2a 2a 20 64 61 74 61 62 61 73 65 29 20 74  y.** database) t
61c0: 68 65 72 65 20 69 73 20 72 65 61 6c 6c 79 20 6e  here is really n
61d0: 6f 20 64 69 66 66 65 72 65 6e 63 65 20 62 65 74  o difference bet
61e0: 77 65 65 6e 20 63 72 65 61 74 65 46 6c 61 67 20  ween createFlag 
61f0: 31 20 61 6e 64 20 32 2e 20 20 53 6f 0a 2a 2a 20  1 and 2.  So.** 
6200: 74 68 65 20 63 61 6c 6c 69 6e 67 20 66 75 6e 63  the calling func
6210: 74 69 6f 6e 20 28 70 63 61 63 68 65 2e 63 29 20  tion (pcache.c) 
6220: 77 69 6c 6c 20 6e 65 76 65 72 20 68 61 76 65 20  will never have 
6230: 61 20 63 72 65 61 74 65 46 6c 61 67 20 6f 66 20  a createFlag of 
6240: 31 20 6f 6e 0a 2a 2a 20 61 20 6e 6f 6e 2d 70 75  1 on.** a non-pu
6250: 72 67 65 61 62 6c 65 20 63 61 63 68 65 2e 0a 2a  rgeable cache..*
6260: 2a 0a 2a 2a 20 54 68 65 72 65 20 61 72 65 20 74  *.** There are t
6270: 68 72 65 65 20 64 69 66 66 65 72 65 6e 74 20 61  hree different a
6280: 70 70 72 6f 61 63 68 65 73 20 74 6f 20 6f 62 74  pproaches to obt
6290: 61 69 6e 69 6e 67 20 73 70 61 63 65 20 66 6f 72  aining space for
62a0: 20 61 20 70 61 67 65 2c 0a 2a 2a 20 64 65 70 65   a page,.** depe
62b0: 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 76 61 6c  nding on the val
62c0: 75 65 20 6f 66 20 70 61 72 61 6d 65 74 65 72 20  ue of parameter 
62d0: 63 72 65 61 74 65 46 6c 61 67 20 28 77 68 69 63  createFlag (whic
62e0: 68 20 6d 61 79 20 62 65 20 30 2c 20 31 20 6f 72  h may be 0, 1 or
62f0: 20 32 29 2e 0a 2a 2a 0a 2a 2a 20 20 20 31 2e 20   2)..**.**   1. 
6300: 52 65 67 61 72 64 6c 65 73 73 20 6f 66 20 74 68  Regardless of th
6310: 65 20 76 61 6c 75 65 20 6f 66 20 63 72 65 61 74  e value of creat
6320: 65 46 6c 61 67 2c 20 74 68 65 20 63 61 63 68 65  eFlag, the cache
6330: 20 69 73 20 73 65 61 72 63 68 65 64 20 66 6f 72   is searched for
6340: 20 61 20 0a 2a 2a 20 20 20 20 20 20 63 6f 70 79   a .**      copy
6350: 20 6f 66 20 74 68 65 20 72 65 71 75 65 73 74 65   of the requeste
6360: 64 20 70 61 67 65 2e 20 49 66 20 6f 6e 65 20 69  d page. If one i
6370: 73 20 66 6f 75 6e 64 2c 20 69 74 20 69 73 20 72  s found, it is r
6380: 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 20  eturned..**.**  
6390: 20 32 2e 20 49 66 20 63 72 65 61 74 65 46 6c 61   2. If createFla
63a0: 67 3d 3d 30 20 61 6e 64 20 74 68 65 20 70 61 67  g==0 and the pag
63b0: 65 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79  e is not already
63c0: 20 69 6e 20 74 68 65 20 63 61 63 68 65 2c 20 4e   in the cache, N
63d0: 55 4c 4c 20 69 73 0a 2a 2a 20 20 20 20 20 20 72  ULL is.**      r
63e0: 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 20  eturned..**.**  
63f0: 20 33 2e 20 49 66 20 63 72 65 61 74 65 46 6c 61   3. If createFla
6400: 67 20 69 73 20 31 2c 20 61 6e 64 20 74 68 65 20  g is 1, and the 
6410: 70 61 67 65 20 69 73 20 6e 6f 74 20 61 6c 72 65  page is not alre
6420: 61 64 79 20 69 6e 20 74 68 65 20 63 61 63 68 65  ady in the cache
6430: 2c 20 74 68 65 6e 0a 2a 2a 20 20 20 20 20 20 72  , then.**      r
6440: 65 74 75 72 6e 20 4e 55 4c 4c 20 28 64 6f 20 6e  eturn NULL (do n
6450: 6f 74 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65  ot allocate a ne
6460: 77 20 70 61 67 65 29 20 69 66 20 61 6e 79 20 6f  w page) if any o
6470: 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a  f the following.
6480: 2a 2a 20 20 20 20 20 20 63 6f 6e 64 69 74 69 6f  **      conditio
6490: 6e 73 20 61 72 65 20 74 72 75 65 3a 0a 2a 2a 0a  ns are true:.**.
64a0: 2a 2a 20 20 20 20 20 20 20 28 61 29 20 74 68 65  **       (a) the
64b0: 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73   number of pages
64c0: 20 70 69 6e 6e 65 64 20 62 79 20 74 68 65 20 63   pinned by the c
64d0: 61 63 68 65 20 69 73 20 67 72 65 61 74 65 72 20  ache is greater 
64e0: 74 68 61 6e 0a 2a 2a 20 20 20 20 20 20 20 20 20  than.**         
64f0: 20 20 50 43 61 63 68 65 31 2e 6e 4d 61 78 2c 20    PCache1.nMax, 
6500: 6f 72 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 28  or.**.**       (
6510: 62 29 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  b) the number of
6520: 20 70 61 67 65 73 20 70 69 6e 6e 65 64 20 62 79   pages pinned by
6530: 20 74 68 65 20 63 61 63 68 65 20 69 73 20 67 72   the cache is gr
6540: 65 61 74 65 72 20 74 68 61 6e 0a 2a 2a 20 20 20  eater than.**   
6550: 20 20 20 20 20 20 20 20 74 68 65 20 73 75 6d 20          the sum 
6560: 6f 66 20 6e 4d 61 78 20 66 6f 72 20 61 6c 6c 20  of nMax for all 
6570: 70 75 72 67 65 61 62 6c 65 20 63 61 63 68 65 73  purgeable caches
6580: 2c 20 6c 65 73 73 20 74 68 65 20 73 75 6d 20 6f  , less the sum o
6590: 66 20 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20  f .**           
65a0: 6e 4d 69 6e 20 66 6f 72 20 61 6c 6c 20 6f 74 68  nMin for all oth
65b0: 65 72 20 70 75 72 67 65 61 62 6c 65 20 63 61 63  er purgeable cac
65c0: 68 65 73 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 20 20  hes, or.**.**   
65d0: 34 2e 20 49 66 20 6e 6f 6e 65 20 6f 66 20 74 68  4. If none of th
65e0: 65 20 66 69 72 73 74 20 74 68 72 65 65 20 63 6f  e first three co
65f0: 6e 64 69 74 69 6f 6e 73 20 61 70 70 6c 79 20 61  nditions apply a
6600: 6e 64 20 74 68 65 20 63 61 63 68 65 20 69 73 20  nd the cache is 
6610: 6d 61 72 6b 65 64 0a 2a 2a 20 20 20 20 20 20 61  marked.**      a
6620: 73 20 70 75 72 67 65 61 62 6c 65 2c 20 61 6e 64  s purgeable, and
6630: 20 69 66 20 6f 6e 65 20 6f 66 20 74 68 65 20 66   if one of the f
6640: 6f 6c 6c 6f 77 69 6e 67 20 69 73 20 74 72 75 65  ollowing is true
6650: 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 28 61  :.**.**       (a
6660: 29 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  ) The number of 
6670: 70 61 67 65 73 20 61 6c 6c 6f 63 61 74 65 64 20  pages allocated 
6680: 66 6f 72 20 74 68 65 20 63 61 63 68 65 20 69 73  for the cache is
6690: 20 61 6c 72 65 61 64 79 20 0a 2a 2a 20 20 20 20   already .**    
66a0: 20 20 20 20 20 20 20 50 43 61 63 68 65 31 2e 6e         PCache1.n
66b0: 4d 61 78 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 20 20  Max, or.**.**   
66c0: 20 20 20 20 28 62 29 20 54 68 65 20 6e 75 6d 62      (b) The numb
66d0: 65 72 20 6f 66 20 70 61 67 65 73 20 61 6c 6c 6f  er of pages allo
66e0: 63 61 74 65 64 20 66 6f 72 20 61 6c 6c 20 70 75  cated for all pu
66f0: 72 67 65 61 62 6c 65 20 63 61 63 68 65 73 20 69  rgeable caches i
6700: 73 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 61  s.**           a
6710: 6c 72 65 61 64 79 20 65 71 75 61 6c 20 74 6f 20  lready equal to 
6720: 6f 72 20 67 72 65 61 74 65 72 20 74 68 61 6e 20  or greater than 
6730: 74 68 65 20 73 75 6d 20 6f 66 20 6e 4d 61 78 20  the sum of nMax 
6740: 66 6f 72 20 61 6c 6c 0a 2a 2a 20 20 20 20 20 20  for all.**      
6750: 20 20 20 20 20 70 75 72 67 65 61 62 6c 65 20 63       purgeable c
6760: 61 63 68 65 73 2c 0a 2a 2a 0a 2a 2a 20 20 20 20  aches,.**.**    
6770: 20 20 20 28 63 29 20 54 68 65 20 73 79 73 74 65     (c) The syste
6780: 6d 20 69 73 20 75 6e 64 65 72 20 6d 65 6d 6f 72  m is under memor
6790: 79 20 70 72 65 73 73 75 72 65 20 61 6e 64 20 77  y pressure and w
67a0: 61 6e 74 73 20 74 6f 20 61 76 6f 69 64 0a 2a 2a  ants to avoid.**
67b0: 20 20 20 20 20 20 20 20 20 20 20 75 6e 6e 65 63             unnec
67c0: 65 73 73 61 72 79 20 70 61 67 65 73 20 63 61 63  essary pages cac
67d0: 68 65 20 65 6e 74 72 79 20 61 6c 6c 6f 63 61 74  he entry allocat
67e0: 69 6f 6e 73 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20  ions.**.**      
67f0: 74 68 65 6e 20 61 74 74 65 6d 70 74 20 74 6f 20  then attempt to 
6800: 72 65 63 79 63 6c 65 20 61 20 70 61 67 65 20 66  recycle a page f
6810: 72 6f 6d 20 74 68 65 20 4c 52 55 20 6c 69 73 74  rom the LRU list
6820: 2e 20 49 66 20 69 74 20 69 73 20 74 68 65 20 72  . If it is the r
6830: 69 67 68 74 0a 2a 2a 20 20 20 20 20 20 73 69 7a  ight.**      siz
6840: 65 2c 20 72 65 74 75 72 6e 20 74 68 65 20 72 65  e, return the re
6850: 63 79 63 6c 65 64 20 62 75 66 66 65 72 2e 20 4f  cycled buffer. O
6860: 74 68 65 72 77 69 73 65 2c 20 66 72 65 65 20 74  therwise, free t
6870: 68 65 20 62 75 66 66 65 72 20 61 6e 64 0a 2a 2a  he buffer and.**
6880: 20 20 20 20 20 20 70 72 6f 63 65 65 64 20 74 6f        proceed to
6890: 20 73 74 65 70 20 35 2e 20 0a 2a 2a 0a 2a 2a 20   step 5. .**.** 
68a0: 20 20 35 2e 20 4f 74 68 65 72 77 69 73 65 2c 20    5. Otherwise, 
68b0: 61 6c 6c 6f 63 61 74 65 20 61 6e 64 20 72 65 74  allocate and ret
68c0: 75 72 6e 20 61 20 6e 65 77 20 70 61 67 65 20 62  urn a new page b
68d0: 75 66 66 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63  uffer..*/.static
68e0: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f   sqlite3_pcache_
68f0: 70 61 67 65 20 2a 70 63 61 63 68 65 31 46 65 74  page *pcache1Fet
6900: 63 68 28 0a 20 20 73 71 6c 69 74 65 33 5f 70 63  ch(.  sqlite3_pc
6910: 61 63 68 65 20 2a 70 2c 20 0a 20 20 75 6e 73 69  ache *p, .  unsi
6920: 67 6e 65 64 20 69 6e 74 20 69 4b 65 79 2c 20 0a  gned int iKey, .
6930: 20 20 69 6e 74 20 63 72 65 61 74 65 46 6c 61 67    int createFlag
6940: 0a 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70  .){.  PCache1 *p
6950: 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 65 31  Cache = (PCache1
6960: 20 2a 29 70 3b 0a 20 20 50 67 48 64 72 31 20 2a   *)p;.  PgHdr1 *
6970: 70 50 61 67 65 20 3d 20 30 3b 0a 0a 20 20 61 73  pPage = 0;..  as
6980: 73 65 72 74 28 20 6f 66 66 73 65 74 6f 66 28 50  sert( offsetof(P
6990: 67 48 64 72 31 2c 70 61 67 65 29 3d 3d 30 20 29  gHdr1,page)==0 )
69a0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63  ;.  assert( pCac
69b0: 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 7c  he->bPurgeable |
69c0: 7c 20 63 72 65 61 74 65 46 6c 61 67 21 3d 31 20  | createFlag!=1 
69d0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61  );.  assert( pCa
69e0: 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20  che->bPurgeable 
69f0: 7c 7c 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 3d  || pCache->nMin=
6a00: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  =0 );.  assert( 
6a10: 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62  pCache->bPurgeab
6a20: 6c 65 3d 3d 30 20 7c 7c 20 70 43 61 63 68 65 2d  le==0 || pCache-
6a30: 3e 6e 4d 69 6e 3d 3d 31 30 20 29 3b 0a 20 20 61  >nMin==10 );.  a
6a40: 73 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 6e  ssert( pCache->n
6a50: 4d 69 6e 3d 3d 30 20 7c 7c 20 70 43 61 63 68 65  Min==0 || pCache
6a60: 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 29 3b 0a  ->bPurgeable );.
6a70: 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65    assert( pCache
6a80: 2d 3e 6e 48 61 73 68 3e 30 20 29 3b 0a 20 20 70  ->nHash>0 );.  p
6a90: 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78  cache1EnterMutex
6aa0: 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29  (pCache->pGroup)
6ab0: 3b 0a 0a 20 20 2f 2a 20 53 74 65 70 20 31 3a 20  ;..  /* Step 1: 
6ac0: 53 65 61 72 63 68 20 74 68 65 20 68 61 73 68 20  Search the hash 
6ad0: 74 61 62 6c 65 20 66 6f 72 20 61 6e 20 65 78 69  table for an exi
6ae0: 73 74 69 6e 67 20 65 6e 74 72 79 2e 20 2a 2f 0a  sting entry. */.
6af0: 20 20 70 50 61 67 65 20 3d 20 70 43 61 63 68 65    pPage = pCache
6b00: 2d 3e 61 70 48 61 73 68 5b 69 4b 65 79 20 25 20  ->apHash[iKey % 
6b10: 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 5d 3b 0a  pCache->nHash];.
6b20: 20 20 77 68 69 6c 65 28 20 70 50 61 67 65 20 26    while( pPage &
6b30: 26 20 70 50 61 67 65 2d 3e 69 4b 65 79 21 3d 69  & pPage->iKey!=i
6b40: 4b 65 79 20 29 7b 20 70 50 61 67 65 20 3d 20 70  Key ){ pPage = p
6b50: 50 61 67 65 2d 3e 70 4e 65 78 74 3b 20 7d 0a 0a  Page->pNext; }..
6b60: 20 20 2f 2a 20 53 74 65 70 20 32 3a 20 41 62 6f    /* Step 2: Abo
6b70: 72 74 20 69 66 20 6e 6f 20 65 78 69 73 74 69 6e  rt if no existin
6b80: 67 20 70 61 67 65 20 69 73 20 66 6f 75 6e 64 20  g page is found 
6b90: 61 6e 64 20 63 72 65 61 74 65 46 6c 61 67 20 69  and createFlag i
6ba0: 73 20 30 20 2a 2f 0a 20 20 69 66 28 20 70 50 61  s 0 */.  if( pPa
6bb0: 67 65 20 29 7b 0a 20 20 20 20 69 66 28 20 21 70  ge ){.    if( !p
6bc0: 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64 20 29  Page->isPinned )
6bd0: 20 70 63 61 63 68 65 31 50 69 6e 50 61 67 65 28   pcache1PinPage(
6be0: 70 50 61 67 65 29 3b 0a 20 20 7d 65 6c 73 65 20  pPage);.  }else 
6bf0: 69 66 28 20 63 72 65 61 74 65 46 6c 61 67 20 29  if( createFlag )
6c00: 7b 0a 20 20 20 20 2f 2a 20 53 74 65 70 73 20 33  {.    /* Steps 3
6c10: 2c 20 34 2c 20 61 6e 64 20 35 20 69 6d 70 6c 65  , 4, and 5 imple
6c20: 6d 65 6e 74 65 64 20 62 79 20 74 68 69 73 20 73  mented by this s
6c30: 75 62 72 6f 75 74 69 6e 65 20 2a 2f 0a 20 20 20  ubroutine */.   
6c40: 20 70 50 61 67 65 20 3d 20 70 63 61 63 68 65 31   pPage = pcache1
6c50: 46 65 74 63 68 53 74 61 67 65 32 28 70 43 61 63  FetchStage2(pCac
6c60: 68 65 2c 20 69 4b 65 79 2c 20 63 72 65 61 74 65  he, iKey, create
6c70: 46 6c 61 67 29 3b 0a 20 20 7d 0a 20 20 61 73 73  Flag);.  }.  ass
6c80: 65 72 74 28 20 70 50 61 67 65 3d 3d 30 20 7c 7c  ert( pPage==0 ||
6c90: 20 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79   pCache->iMaxKey
6ca0: 3e 3d 69 4b 65 79 20 29 3b 0a 20 20 70 63 61 63  >=iKey );.  pcac
6cb0: 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70 43  he1LeaveMutex(pC
6cc0: 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 20  ache->pGroup);. 
6cd0: 20 72 65 74 75 72 6e 20 28 73 71 6c 69 74 65 33   return (sqlite3
6ce0: 5f 70 63 61 63 68 65 5f 70 61 67 65 2a 29 70 50  _pcache_page*)pP
6cf0: 61 67 65 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 49  age;.}.../*.** I
6d00: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66  mplementation of
6d10: 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61   the sqlite3_pca
6d20: 63 68 65 2e 78 55 6e 70 69 6e 20 6d 65 74 68 6f  che.xUnpin metho
6d30: 64 2e 0a 2a 2a 0a 2a 2a 20 4d 61 72 6b 20 61 20  d..**.** Mark a 
6d40: 70 61 67 65 20 61 73 20 75 6e 70 69 6e 6e 65 64  page as unpinned
6d50: 20 28 65 6c 69 67 69 62 6c 65 20 66 6f 72 20 61   (eligible for a
6d60: 73 79 6e 63 68 72 6f 6e 6f 75 73 20 72 65 63 79  synchronous recy
6d70: 63 6c 69 6e 67 29 2e 0a 2a 2f 0a 73 74 61 74 69  cling)..*/.stati
6d80: 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 55 6e  c void pcache1Un
6d90: 70 69 6e 28 0a 20 20 73 71 6c 69 74 65 33 5f 70  pin(.  sqlite3_p
6da0: 63 61 63 68 65 20 2a 70 2c 20 0a 20 20 73 71 6c  cache *p, .  sql
6db0: 69 74 65 33 5f 70 63 61 63 68 65 5f 70 61 67 65  ite3_pcache_page
6dc0: 20 2a 70 50 67 2c 20 0a 20 20 69 6e 74 20 72 65   *pPg, .  int re
6dd0: 75 73 65 55 6e 6c 69 6b 65 6c 79 0a 29 7b 0a 20  useUnlikely.){. 
6de0: 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65   PCache1 *pCache
6df0: 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b   = (PCache1 *)p;
6e00: 0a 20 20 50 67 48 64 72 31 20 2a 70 50 61 67 65  .  PgHdr1 *pPage
6e10: 20 3d 20 28 50 67 48 64 72 31 20 2a 29 70 50 67   = (PgHdr1 *)pPg
6e20: 3b 0a 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f  ;.  PGroup *pGro
6e30: 75 70 20 3d 20 70 43 61 63 68 65 2d 3e 70 47 72  up = pCache->pGr
6e40: 6f 75 70 3b 0a 20 0a 20 20 61 73 73 65 72 74 28  oup;. .  assert(
6e50: 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65 3d 3d   pPage->pCache==
6e60: 70 43 61 63 68 65 20 29 3b 0a 20 20 70 63 61 63  pCache );.  pcac
6e70: 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70 47  he1EnterMutex(pG
6e80: 72 6f 75 70 29 3b 0a 0a 20 20 2f 2a 20 49 74 20  roup);..  /* It 
6e90: 69 73 20 61 6e 20 65 72 72 6f 72 20 74 6f 20 63  is an error to c
6ea0: 61 6c 6c 20 74 68 69 73 20 66 75 6e 63 74 69 6f  all this functio
6eb0: 6e 20 69 66 20 74 68 65 20 70 61 67 65 20 69 73  n if the page is
6ec0: 20 61 6c 72 65 61 64 79 20 0a 20 20 2a 2a 20 70   already .  ** p
6ed0: 61 72 74 20 6f 66 20 74 68 65 20 50 47 72 6f 75  art of the PGrou
6ee0: 70 20 4c 52 55 20 6c 69 73 74 2e 0a 20 20 2a 2f  p LRU list..  */
6ef0: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65  .  assert( pPage
6f00: 2d 3e 70 4c 72 75 50 72 65 76 3d 3d 30 20 26 26  ->pLruPrev==0 &&
6f10: 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74   pPage->pLruNext
6f20: 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28  ==0 );.  assert(
6f30: 20 70 47 72 6f 75 70 2d 3e 70 4c 72 75 48 65 61   pGroup->pLruHea
6f40: 64 21 3d 70 50 61 67 65 20 26 26 20 70 47 72 6f  d!=pPage && pGro
6f50: 75 70 2d 3e 70 4c 72 75 54 61 69 6c 21 3d 70 50  up->pLruTail!=pP
6f60: 61 67 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28  age );.  assert(
6f70: 20 70 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64   pPage->isPinned
6f80: 3d 3d 31 20 29 3b 0a 0a 20 20 69 66 28 20 72 65  ==1 );..  if( re
6f90: 75 73 65 55 6e 6c 69 6b 65 6c 79 20 7c 7c 20 70  useUnlikely || p
6fa0: 47 72 6f 75 70 2d 3e 6e 43 75 72 72 65 6e 74 50  Group->nCurrentP
6fb0: 61 67 65 3e 70 47 72 6f 75 70 2d 3e 6e 4d 61 78  age>pGroup->nMax
6fc0: 50 61 67 65 20 29 7b 0a 20 20 20 20 70 63 61 63  Page ){.    pcac
6fd0: 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73  he1RemoveFromHas
6fe0: 68 28 70 50 61 67 65 29 3b 0a 20 20 20 20 70 63  h(pPage);.    pc
6ff0: 61 63 68 65 31 46 72 65 65 50 61 67 65 28 70 50  ache1FreePage(pP
7000: 61 67 65 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  age);.  }else{. 
7010: 20 20 20 2f 2a 20 41 64 64 20 74 68 65 20 70 61     /* Add the pa
7020: 67 65 20 74 6f 20 74 68 65 20 50 47 72 6f 75 70  ge to the PGroup
7030: 20 4c 52 55 20 6c 69 73 74 2e 20 2a 2f 0a 20 20   LRU list. */.  
7040: 20 20 69 66 28 20 70 47 72 6f 75 70 2d 3e 70 4c    if( pGroup->pL
7050: 72 75 48 65 61 64 20 29 7b 0a 20 20 20 20 20 20  ruHead ){.      
7060: 70 47 72 6f 75 70 2d 3e 70 4c 72 75 48 65 61 64  pGroup->pLruHead
7070: 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20 70 50 61  ->pLruPrev = pPa
7080: 67 65 3b 0a 20 20 20 20 20 20 70 50 61 67 65 2d  ge;.      pPage-
7090: 3e 70 4c 72 75 4e 65 78 74 20 3d 20 70 47 72 6f  >pLruNext = pGro
70a0: 75 70 2d 3e 70 4c 72 75 48 65 61 64 3b 0a 20 20  up->pLruHead;.  
70b0: 20 20 20 20 70 47 72 6f 75 70 2d 3e 70 4c 72 75      pGroup->pLru
70c0: 48 65 61 64 20 3d 20 70 50 61 67 65 3b 0a 20 20  Head = pPage;.  
70d0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70    }else{.      p
70e0: 47 72 6f 75 70 2d 3e 70 4c 72 75 54 61 69 6c 20  Group->pLruTail 
70f0: 3d 20 70 50 61 67 65 3b 0a 20 20 20 20 20 20 70  = pPage;.      p
7100: 47 72 6f 75 70 2d 3e 70 4c 72 75 48 65 61 64 20  Group->pLruHead 
7110: 3d 20 70 50 61 67 65 3b 0a 20 20 20 20 7d 0a 20  = pPage;.    }. 
7120: 20 20 20 70 43 61 63 68 65 2d 3e 6e 52 65 63 79     pCache->nRecy
7130: 63 6c 61 62 6c 65 2b 2b 3b 0a 20 20 20 20 70 50  clable++;.    pP
7140: 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64 20 3d 20  age->isPinned = 
7150: 30 3b 0a 20 20 7d 0a 0a 20 20 70 63 61 63 68 65  0;.  }..  pcache
7160: 31 4c 65 61 76 65 4d 75 74 65 78 28 70 43 61 63  1LeaveMutex(pCac
7170: 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 7d 0a 0a  he->pGroup);.}..
7180: 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61  /*.** Implementa
7190: 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69  tion of the sqli
71a0: 74 65 33 5f 70 63 61 63 68 65 2e 78 52 65 6b 65  te3_pcache.xReke
71b0: 79 20 6d 65 74 68 6f 64 2e 20 0a 2a 2f 0a 73 74  y method. .*/.st
71c0: 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65  atic void pcache
71d0: 31 52 65 6b 65 79 28 0a 20 20 73 71 6c 69 74 65  1Rekey(.  sqlite
71e0: 33 5f 70 63 61 63 68 65 20 2a 70 2c 0a 20 20 73  3_pcache *p,.  s
71f0: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 70 61  qlite3_pcache_pa
7200: 67 65 20 2a 70 50 67 2c 0a 20 20 75 6e 73 69 67  ge *pPg,.  unsig
7210: 6e 65 64 20 69 6e 74 20 69 4f 6c 64 2c 0a 20 20  ned int iOld,.  
7220: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4e 65  unsigned int iNe
7230: 77 0a 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a  w.){.  PCache1 *
7240: 70 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 65  pCache = (PCache
7250: 31 20 2a 29 70 3b 0a 20 20 50 67 48 64 72 31 20  1 *)p;.  PgHdr1 
7260: 2a 70 50 61 67 65 20 3d 20 28 50 67 48 64 72 31  *pPage = (PgHdr1
7270: 20 2a 29 70 50 67 3b 0a 20 20 50 67 48 64 72 31   *)pPg;.  PgHdr1
7280: 20 2a 2a 70 70 3b 0a 20 20 75 6e 73 69 67 6e 65   **pp;.  unsigne
7290: 64 20 69 6e 74 20 68 3b 20 0a 20 20 61 73 73 65  d int h; .  asse
72a0: 72 74 28 20 70 50 61 67 65 2d 3e 69 4b 65 79 3d  rt( pPage->iKey=
72b0: 3d 69 4f 6c 64 20 29 3b 0a 20 20 61 73 73 65 72  =iOld );.  asser
72c0: 74 28 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65  t( pPage->pCache
72d0: 3d 3d 70 43 61 63 68 65 20 29 3b 0a 0a 20 20 70  ==pCache );..  p
72e0: 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78  cache1EnterMutex
72f0: 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29  (pCache->pGroup)
7300: 3b 0a 0a 20 20 68 20 3d 20 69 4f 6c 64 25 70 43  ;..  h = iOld%pC
7310: 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 70  ache->nHash;.  p
7320: 70 20 3d 20 26 70 43 61 63 68 65 2d 3e 61 70 48  p = &pCache->apH
7330: 61 73 68 5b 68 5d 3b 0a 20 20 77 68 69 6c 65 28  ash[h];.  while(
7340: 20 28 2a 70 70 29 21 3d 70 50 61 67 65 20 29 7b   (*pp)!=pPage ){
7350: 0a 20 20 20 20 70 70 20 3d 20 26 28 2a 70 70 29  .    pp = &(*pp)
7360: 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d 0a 20 20 2a  ->pNext;.  }.  *
7370: 70 70 20 3d 20 70 50 61 67 65 2d 3e 70 4e 65 78  pp = pPage->pNex
7380: 74 3b 0a 0a 20 20 68 20 3d 20 69 4e 65 77 25 70  t;..  h = iNew%p
7390: 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20  Cache->nHash;.  
73a0: 70 50 61 67 65 2d 3e 69 4b 65 79 20 3d 20 69 4e  pPage->iKey = iN
73b0: 65 77 3b 0a 20 20 70 50 61 67 65 2d 3e 70 4e 65  ew;.  pPage->pNe
73c0: 78 74 20 3d 20 70 43 61 63 68 65 2d 3e 61 70 48  xt = pCache->apH
73d0: 61 73 68 5b 68 5d 3b 0a 20 20 70 43 61 63 68 65  ash[h];.  pCache
73e0: 2d 3e 61 70 48 61 73 68 5b 68 5d 20 3d 20 70 50  ->apHash[h] = pP
73f0: 61 67 65 3b 0a 20 20 69 66 28 20 69 4e 65 77 3e  age;.  if( iNew>
7400: 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20  pCache->iMaxKey 
7410: 29 7b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 69  ){.    pCache->i
7420: 4d 61 78 4b 65 79 20 3d 20 69 4e 65 77 3b 0a 20  MaxKey = iNew;. 
7430: 20 7d 0a 0a 20 20 70 63 61 63 68 65 31 4c 65 61   }..  pcache1Lea
7440: 76 65 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e  veMutex(pCache->
7450: 70 47 72 6f 75 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  pGroup);.}../*.*
7460: 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  * Implementation
7470: 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f   of the sqlite3_
7480: 70 63 61 63 68 65 2e 78 54 72 75 6e 63 61 74 65  pcache.xTruncate
7490: 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20   method. .**.** 
74a0: 44 69 73 63 61 72 64 20 61 6c 6c 20 75 6e 70 69  Discard all unpi
74b0: 6e 6e 65 64 20 70 61 67 65 73 20 69 6e 20 74 68  nned pages in th
74c0: 65 20 63 61 63 68 65 20 77 69 74 68 20 61 20 70  e cache with a p
74d0: 61 67 65 20 6e 75 6d 62 65 72 20 65 71 75 61 6c  age number equal
74e0: 20 74 6f 0a 2a 2a 20 6f 72 20 67 72 65 61 74 65   to.** or greate
74f0: 72 20 74 68 61 6e 20 70 61 72 61 6d 65 74 65 72  r than parameter
7500: 20 69 4c 69 6d 69 74 2e 20 41 6e 79 20 70 69 6e   iLimit. Any pin
7510: 6e 65 64 20 70 61 67 65 73 20 77 69 74 68 20 61  ned pages with a
7520: 20 70 61 67 65 20 6e 75 6d 62 65 72 0a 2a 2a 20   page number.** 
7530: 65 71 75 61 6c 20 74 6f 20 6f 72 20 67 72 65 61  equal to or grea
7540: 74 65 72 20 74 68 61 6e 20 69 4c 69 6d 69 74 20  ter than iLimit 
7550: 61 72 65 20 69 6d 70 6c 69 63 69 74 6c 79 20 75  are implicitly u
7560: 6e 70 69 6e 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74  npinned..*/.stat
7570: 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 54  ic void pcache1T
7580: 72 75 6e 63 61 74 65 28 73 71 6c 69 74 65 33 5f  runcate(sqlite3_
7590: 70 63 61 63 68 65 20 2a 70 2c 20 75 6e 73 69 67  pcache *p, unsig
75a0: 6e 65 64 20 69 6e 74 20 69 4c 69 6d 69 74 29 7b  ned int iLimit){
75b0: 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63  .  PCache1 *pCac
75c0: 68 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29  he = (PCache1 *)
75d0: 70 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65  p;.  pcache1Ente
75e0: 72 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70  rMutex(pCache->p
75f0: 47 72 6f 75 70 29 3b 0a 20 20 69 66 28 20 69 4c  Group);.  if( iL
7600: 69 6d 69 74 3c 3d 70 43 61 63 68 65 2d 3e 69 4d  imit<=pCache->iM
7610: 61 78 4b 65 79 20 29 7b 0a 20 20 20 20 70 63 61  axKey ){.    pca
7620: 63 68 65 31 54 72 75 6e 63 61 74 65 55 6e 73 61  che1TruncateUnsa
7630: 66 65 28 70 43 61 63 68 65 2c 20 69 4c 69 6d 69  fe(pCache, iLimi
7640: 74 29 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e  t);.    pCache->
7650: 69 4d 61 78 4b 65 79 20 3d 20 69 4c 69 6d 69 74  iMaxKey = iLimit
7660: 2d 31 3b 0a 20 20 7d 0a 20 20 70 63 61 63 68 65  -1;.  }.  pcache
7670: 31 4c 65 61 76 65 4d 75 74 65 78 28 70 43 61 63  1LeaveMutex(pCac
7680: 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 7d 0a 0a  he->pGroup);.}..
7690: 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61  /*.** Implementa
76a0: 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69  tion of the sqli
76b0: 74 65 33 5f 70 63 61 63 68 65 2e 78 44 65 73 74  te3_pcache.xDest
76c0: 72 6f 79 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a  roy method. .**.
76d0: 2a 2a 20 44 65 73 74 72 6f 79 20 61 20 63 61 63  ** Destroy a cac
76e0: 68 65 20 61 6c 6c 6f 63 61 74 65 64 20 75 73 69  he allocated usi
76f0: 6e 67 20 70 63 61 63 68 65 31 43 72 65 61 74 65  ng pcache1Create
7700: 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  ()..*/.static vo
7710: 69 64 20 70 63 61 63 68 65 31 44 65 73 74 72 6f  id pcache1Destro
7720: 79 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  y(sqlite3_pcache
7730: 20 2a 70 29 7b 0a 20 20 50 43 61 63 68 65 31 20   *p){.  PCache1 
7740: 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61 63 68  *pCache = (PCach
7750: 65 31 20 2a 29 70 3b 0a 20 20 50 47 72 6f 75 70  e1 *)p;.  PGroup
7760: 20 2a 70 47 72 6f 75 70 20 3d 20 70 43 61 63 68   *pGroup = pCach
7770: 65 2d 3e 70 47 72 6f 75 70 3b 0a 20 20 61 73 73  e->pGroup;.  ass
7780: 65 72 74 28 20 70 43 61 63 68 65 2d 3e 62 50 75  ert( pCache->bPu
7790: 72 67 65 61 62 6c 65 20 7c 7c 20 28 70 43 61 63  rgeable || (pCac
77a0: 68 65 2d 3e 6e 4d 61 78 3d 3d 30 20 26 26 20 70  he->nMax==0 && p
77b0: 43 61 63 68 65 2d 3e 6e 4d 69 6e 3d 3d 30 29 20  Cache->nMin==0) 
77c0: 29 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65  );.  pcache1Ente
77d0: 72 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a  rMutex(pGroup);.
77e0: 20 20 70 63 61 63 68 65 31 54 72 75 6e 63 61 74    pcache1Truncat
77f0: 65 55 6e 73 61 66 65 28 70 43 61 63 68 65 2c 20  eUnsafe(pCache, 
7800: 30 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 47  0);.  assert( pG
7810: 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 3e  roup->nMaxPage >
7820: 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 20 29  = pCache->nMax )
7830: 3b 0a 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78  ;.  pGroup->nMax
7840: 50 61 67 65 20 2d 3d 20 70 43 61 63 68 65 2d 3e  Page -= pCache->
7850: 6e 4d 61 78 3b 0a 20 20 61 73 73 65 72 74 28 20  nMax;.  assert( 
7860: 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65  pGroup->nMinPage
7870: 20 3e 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e   >= pCache->nMin
7880: 20 29 3b 0a 20 20 70 47 72 6f 75 70 2d 3e 6e 4d   );.  pGroup->nM
7890: 69 6e 50 61 67 65 20 2d 3d 20 70 43 61 63 68 65  inPage -= pCache
78a0: 2d 3e 6e 4d 69 6e 3b 0a 20 20 70 47 72 6f 75 70  ->nMin;.  pGroup
78b0: 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 20 70 47 72  ->mxPinned = pGr
78c0: 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 2b 20  oup->nMaxPage + 
78d0: 31 30 20 2d 20 70 47 72 6f 75 70 2d 3e 6e 4d 69  10 - pGroup->nMi
78e0: 6e 50 61 67 65 3b 0a 20 20 70 63 61 63 68 65 31  nPage;.  pcache1
78f0: 45 6e 66 6f 72 63 65 4d 61 78 50 61 67 65 28 70  EnforceMaxPage(p
7900: 47 72 6f 75 70 29 3b 0a 20 20 70 63 61 63 68 65  Group);.  pcache
7910: 31 4c 65 61 76 65 4d 75 74 65 78 28 70 47 72 6f  1LeaveMutex(pGro
7920: 75 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66  up);.  sqlite3_f
7930: 72 65 65 28 70 43 61 63 68 65 2d 3e 61 70 48 61  ree(pCache->apHa
7940: 73 68 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66  sh);.  sqlite3_f
7950: 72 65 65 28 70 43 61 63 68 65 29 3b 0a 7d 0a 0a  ree(pCache);.}..
7960: 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74  /*.** This funct
7970: 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 64 75  ion is called du
7980: 72 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a 61 74  ring initializat
7990: 69 6f 6e 20 28 73 71 6c 69 74 65 33 5f 69 6e 69  ion (sqlite3_ini
79a0: 74 69 61 6c 69 7a 65 28 29 29 20 74 6f 0a 2a 2a  tialize()) to.**
79b0: 20 69 6e 73 74 61 6c 6c 20 74 68 65 20 64 65 66   install the def
79c0: 61 75 6c 74 20 70 6c 75 67 67 61 62 6c 65 20 63  ault pluggable c
79d0: 61 63 68 65 20 6d 6f 64 75 6c 65 2c 20 61 73 73  ache module, ass
79e0: 75 6d 69 6e 67 20 74 68 65 20 75 73 65 72 20 68  uming the user h
79f0: 61 73 20 6e 6f 74 0a 2a 2a 20 61 6c 72 65 61 64  as not.** alread
7a00: 79 20 70 72 6f 76 69 64 65 64 20 61 6e 20 61 6c  y provided an al
7a10: 74 65 72 6e 61 74 69 76 65 2e 0a 2a 2f 0a 76 6f  ternative..*/.vo
7a20: 69 64 20 73 71 6c 69 74 65 33 50 43 61 63 68 65  id sqlite3PCache
7a30: 53 65 74 44 65 66 61 75 6c 74 28 76 6f 69 64 29  SetDefault(void)
7a40: 7b 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74  {.  static const
7a50: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f   sqlite3_pcache_
7a60: 6d 65 74 68 6f 64 73 32 20 64 65 66 61 75 6c 74  methods2 default
7a70: 4d 65 74 68 6f 64 73 20 3d 20 7b 0a 20 20 20 20  Methods = {.    
7a80: 31 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  1,              
7a90: 20 20 20 20 20 20 20 20 20 2f 2a 20 69 56 65 72           /* iVer
7aa0: 73 69 6f 6e 20 2a 2f 0a 20 20 20 20 30 2c 20 20  sion */.    0,  
7ab0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7ac0: 20 20 20 20 20 2f 2a 20 70 41 72 67 20 2a 2f 0a       /* pArg */.
7ad0: 20 20 20 20 70 63 61 63 68 65 31 49 6e 69 74 2c      pcache1Init,
7ae0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
7af0: 78 49 6e 69 74 20 2a 2f 0a 20 20 20 20 70 63 61  xInit */.    pca
7b00: 63 68 65 31 53 68 75 74 64 6f 77 6e 2c 20 20 20  che1Shutdown,   
7b10: 20 20 20 20 20 20 2f 2a 20 78 53 68 75 74 64 6f        /* xShutdo
7b20: 77 6e 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65  wn */.    pcache
7b30: 31 43 72 65 61 74 65 2c 20 20 20 20 20 20 20 20  1Create,        
7b40: 20 20 20 2f 2a 20 78 43 72 65 61 74 65 20 2a 2f     /* xCreate */
7b50: 0a 20 20 20 20 70 63 61 63 68 65 31 43 61 63 68  .    pcache1Cach
7b60: 65 73 69 7a 65 2c 20 20 20 20 20 20 20 20 2f 2a  esize,        /*
7b70: 20 78 43 61 63 68 65 73 69 7a 65 20 2a 2f 0a 20   xCachesize */. 
7b80: 20 20 20 70 63 61 63 68 65 31 50 61 67 65 63 6f     pcache1Pageco
7b90: 75 6e 74 2c 20 20 20 20 20 20 20 20 2f 2a 20 78  unt,        /* x
7ba0: 50 61 67 65 63 6f 75 6e 74 20 2a 2f 0a 20 20 20  Pagecount */.   
7bb0: 20 70 63 61 63 68 65 31 46 65 74 63 68 2c 20 20   pcache1Fetch,  
7bc0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 46 65            /* xFe
7bd0: 74 63 68 20 2a 2f 0a 20 20 20 20 70 63 61 63 68  tch */.    pcach
7be0: 65 31 55 6e 70 69 6e 2c 20 20 20 20 20 20 20 20  e1Unpin,        
7bf0: 20 20 20 20 2f 2a 20 78 55 6e 70 69 6e 20 2a 2f      /* xUnpin */
7c00: 0a 20 20 20 20 70 63 61 63 68 65 31 52 65 6b 65  .    pcache1Reke
7c10: 79 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  y,            /*
7c20: 20 78 52 65 6b 65 79 20 2a 2f 0a 20 20 20 20 70   xRekey */.    p
7c30: 63 61 63 68 65 31 54 72 75 6e 63 61 74 65 2c 20  cache1Truncate, 
7c40: 20 20 20 20 20 20 20 20 2f 2a 20 78 54 72 75 6e          /* xTrun
7c50: 63 61 74 65 20 2a 2f 0a 20 20 20 20 70 63 61 63  cate */.    pcac
7c60: 68 65 31 44 65 73 74 72 6f 79 2c 20 20 20 20 20  he1Destroy,     
7c70: 20 20 20 20 20 2f 2a 20 78 44 65 73 74 72 6f 79       /* xDestroy
7c80: 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 53   */.    pcache1S
7c90: 68 72 69 6e 6b 20 20 20 20 20 20 20 20 20 20 20  hrink           
7ca0: 20 2f 2a 20 78 53 68 72 69 6e 6b 20 2a 2f 0a 20   /* xShrink */. 
7cb0: 20 7d 3b 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f   };.  sqlite3_co
7cc0: 6e 66 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46  nfig(SQLITE_CONF
7cd0: 49 47 5f 50 43 41 43 48 45 32 2c 20 26 64 65 66  IG_PCACHE2, &def
7ce0: 61 75 6c 74 4d 65 74 68 6f 64 73 29 3b 0a 7d 0a  aultMethods);.}.
7cf0: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68  ./*.** Return th
7d00: 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 68 65  e size of the he
7d10: 61 64 65 72 20 6f 6e 20 65 61 63 68 20 70 61 67  ader on each pag
7d20: 65 20 6f 66 20 74 68 69 73 20 50 43 41 43 48 45  e of this PCACHE
7d30: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e   implementation.
7d40: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 48  .*/.int sqlite3H
7d50: 65 61 64 65 72 53 69 7a 65 50 63 61 63 68 65 31  eaderSizePcache1
7d60: 28 76 6f 69 64 29 7b 20 72 65 74 75 72 6e 20 52  (void){ return R
7d70: 4f 55 4e 44 38 28 73 69 7a 65 6f 66 28 50 67 48  OUND8(sizeof(PgH
7d80: 64 72 31 29 29 3b 20 7d 0a 0a 23 69 66 64 65 66  dr1)); }..#ifdef
7d90: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d   SQLITE_ENABLE_M
7da0: 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54  EMORY_MANAGEMENT
7db0: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63  ./*.** This func
7dc0: 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 74  tion is called t
7dd0: 6f 20 66 72 65 65 20 73 75 70 65 72 66 6c 75 6f  o free superfluo
7de0: 75 73 20 64 79 6e 61 6d 69 63 61 6c 6c 79 20 61  us dynamically a
7df0: 6c 6c 6f 63 61 74 65 64 20 6d 65 6d 6f 72 79 0a  llocated memory.
7e00: 2a 2a 20 68 65 6c 64 20 62 79 20 74 68 65 20 70  ** held by the p
7e10: 61 67 65 72 20 73 79 73 74 65 6d 2e 20 4d 65 6d  ager system. Mem
7e20: 6f 72 79 20 69 6e 20 75 73 65 20 62 79 20 61 6e  ory in use by an
7e30: 79 20 53 51 4c 69 74 65 20 70 61 67 65 72 20 61  y SQLite pager a
7e40: 6c 6c 6f 63 61 74 65 64 0a 2a 2a 20 62 79 20 74  llocated.** by t
7e50: 68 65 20 63 75 72 72 65 6e 74 20 74 68 72 65 61  he current threa
7e60: 64 20 6d 61 79 20 62 65 20 73 71 6c 69 74 65 33  d may be sqlite3
7e70: 5f 66 72 65 65 28 29 65 64 2e 0a 2a 2a 0a 2a 2a  _free()ed..**.**
7e80: 20 6e 52 65 71 20 69 73 20 74 68 65 20 6e 75 6d   nReq is the num
7e90: 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f 66 20  ber of bytes of 
7ea0: 6d 65 6d 6f 72 79 20 72 65 71 75 69 72 65 64 2e  memory required.
7eb0: 20 4f 6e 63 65 20 74 68 69 73 20 6d 75 63 68 20   Once this much 
7ec0: 68 61 73 0a 2a 2a 20 62 65 65 6e 20 72 65 6c 65  has.** been rele
7ed0: 61 73 65 64 2c 20 74 68 65 20 66 75 6e 63 74 69  ased, the functi
7ee0: 6f 6e 20 72 65 74 75 72 6e 73 2e 20 54 68 65 20  on returns. The 
7ef0: 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 73 20  return value is 
7f00: 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72  the total number
7f10: 20 0a 2a 2a 20 6f 66 20 62 79 74 65 73 20 6f 66   .** of bytes of
7f20: 20 6d 65 6d 6f 72 79 20 72 65 6c 65 61 73 65 64   memory released
7f30: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
7f40: 50 63 61 63 68 65 52 65 6c 65 61 73 65 4d 65 6d  PcacheReleaseMem
7f50: 6f 72 79 28 69 6e 74 20 6e 52 65 71 29 7b 0a 20  ory(int nReq){. 
7f60: 20 69 6e 74 20 6e 46 72 65 65 20 3d 20 30 3b 0a   int nFree = 0;.
7f70: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
7f80: 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c 64 28  3_mutex_notheld(
7f90: 70 63 61 63 68 65 31 2e 67 72 70 2e 6d 75 74 65  pcache1.grp.mute
7fa0: 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  x) );.  assert( 
7fb0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6e 6f  sqlite3_mutex_no
7fc0: 74 68 65 6c 64 28 70 63 61 63 68 65 31 2e 6d 75  theld(pcache1.mu
7fd0: 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 70 63  tex) );.  if( pc
7fe0: 61 63 68 65 31 2e 70 53 74 61 72 74 3d 3d 30 20  ache1.pStart==0 
7ff0: 29 7b 0a 20 20 20 20 50 67 48 64 72 31 20 2a 70  ){.    PgHdr1 *p
8000: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e 74  ;.    pcache1Ent
8010: 65 72 4d 75 74 65 78 28 26 70 63 61 63 68 65 31  erMutex(&pcache1
8020: 2e 67 72 70 29 3b 0a 20 20 20 20 77 68 69 6c 65  .grp);.    while
8030: 28 20 28 6e 52 65 71 3c 30 20 7c 7c 20 6e 46 72  ( (nReq<0 || nFr
8040: 65 65 3c 6e 52 65 71 29 20 26 26 20 28 28 70 3d  ee<nReq) && ((p=
8050: 70 63 61 63 68 65 31 2e 67 72 70 2e 70 4c 72 75  pcache1.grp.pLru
8060: 54 61 69 6c 29 21 3d 30 29 20 29 7b 0a 20 20 20  Tail)!=0) ){.   
8070: 20 20 20 6e 46 72 65 65 20 2b 3d 20 70 63 61 63     nFree += pcac
8080: 68 65 31 4d 65 6d 53 69 7a 65 28 70 2d 3e 70 61  he1MemSize(p->pa
8090: 67 65 2e 70 42 75 66 29 3b 0a 23 69 66 64 65 66  ge.pBuf);.#ifdef
80a0: 20 53 51 4c 49 54 45 5f 50 43 41 43 48 45 5f 53   SQLITE_PCACHE_S
80b0: 45 50 41 52 41 54 45 5f 48 45 41 44 45 52 0a 20  EPARATE_HEADER. 
80c0: 20 20 20 20 20 6e 46 72 65 65 20 2b 3d 20 73 71       nFree += sq
80d0: 6c 69 74 65 33 4d 65 6d 53 69 7a 65 28 70 29 3b  lite3MemSize(p);
80e0: 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 61 73  .#endif.      as
80f0: 73 65 72 74 28 20 70 2d 3e 69 73 50 69 6e 6e 65  sert( p->isPinne
8100: 64 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 70 63  d==0 );.      pc
8110: 61 63 68 65 31 50 69 6e 50 61 67 65 28 70 29 3b  ache1PinPage(p);
8120: 0a 20 20 20 20 20 20 70 63 61 63 68 65 31 52 65  .      pcache1Re
8130: 6d 6f 76 65 46 72 6f 6d 48 61 73 68 28 70 29 3b  moveFromHash(p);
8140: 0a 20 20 20 20 20 20 70 63 61 63 68 65 31 46 72  .      pcache1Fr
8150: 65 65 50 61 67 65 28 70 29 3b 0a 20 20 20 20 7d  eePage(p);.    }
8160: 0a 20 20 20 20 70 63 61 63 68 65 31 4c 65 61 76  .    pcache1Leav
8170: 65 4d 75 74 65 78 28 26 70 63 61 63 68 65 31 2e  eMutex(&pcache1.
8180: 67 72 70 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75  grp);.  }.  retu
8190: 72 6e 20 6e 46 72 65 65 3b 0a 7d 0a 23 65 6e 64  rn nFree;.}.#end
81a0: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41  if /* SQLITE_ENA
81b0: 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47  BLE_MEMORY_MANAG
81c0: 45 4d 45 4e 54 20 2a 2f 0a 0a 23 69 66 64 65 66  EMENT */..#ifdef
81d0: 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 2f 2a 0a   SQLITE_TEST./*.
81e0: 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e  ** This function
81f0: 20 69 73 20 75 73 65 64 20 62 79 20 74 65 73 74   is used by test
8200: 20 70 72 6f 63 65 64 75 72 65 73 20 74 6f 20 69   procedures to i
8210: 6e 73 70 65 63 74 20 74 68 65 20 69 6e 74 65 72  nspect the inter
8220: 6e 61 6c 20 73 74 61 74 65 0a 2a 2a 20 6f 66 20  nal state.** of 
8230: 74 68 65 20 67 6c 6f 62 61 6c 20 63 61 63 68 65  the global cache
8240: 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65  ..*/.void sqlite
8250: 33 50 63 61 63 68 65 53 74 61 74 73 28 0a 20 20  3PcacheStats(.  
8260: 69 6e 74 20 2a 70 6e 43 75 72 72 65 6e 74 2c 20  int *pnCurrent, 
8270: 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 54 6f 74       /* OUT: Tot
8280: 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67  al number of pag
8290: 65 73 20 63 61 63 68 65 64 20 2a 2f 0a 20 20 69  es cached */.  i
82a0: 6e 74 20 2a 70 6e 4d 61 78 2c 20 20 20 20 20 20  nt *pnMax,      
82b0: 20 20 20 20 2f 2a 20 4f 55 54 3a 20 47 6c 6f 62      /* OUT: Glob
82c0: 61 6c 20 6d 61 78 69 6d 75 6d 20 63 61 63 68 65  al maximum cache
82d0: 20 73 69 7a 65 20 2a 2f 0a 20 20 69 6e 74 20 2a   size */.  int *
82e0: 70 6e 4d 69 6e 2c 20 20 20 20 20 20 20 20 20 20  pnMin,          
82f0: 2f 2a 20 4f 55 54 3a 20 53 75 6d 20 6f 66 20 50  /* OUT: Sum of P
8300: 43 61 63 68 65 31 2e 6e 4d 69 6e 20 66 6f 72 20  Cache1.nMin for 
8310: 70 75 72 67 65 61 62 6c 65 20 63 61 63 68 65 73  purgeable caches
8320: 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 52 65 63   */.  int *pnRec
8330: 79 63 6c 61 62 6c 65 20 20 20 20 2f 2a 20 4f 55  yclable    /* OU
8340: 54 3a 20 54 6f 74 61 6c 20 6e 75 6d 62 65 72 20  T: Total number 
8350: 6f 66 20 70 61 67 65 73 20 61 76 61 69 6c 61 62  of pages availab
8360: 6c 65 20 66 6f 72 20 72 65 63 79 63 6c 69 6e 67  le for recycling
8370: 20 2a 2f 0a 29 7b 0a 20 20 50 67 48 64 72 31 20   */.){.  PgHdr1 
8380: 2a 70 3b 0a 20 20 69 6e 74 20 6e 52 65 63 79 63  *p;.  int nRecyc
8390: 6c 61 62 6c 65 20 3d 20 30 3b 0a 20 20 66 6f 72  lable = 0;.  for
83a0: 28 70 3d 70 63 61 63 68 65 31 2e 67 72 70 2e 70  (p=pcache1.grp.p
83b0: 4c 72 75 48 65 61 64 3b 20 70 3b 20 70 3d 70 2d  LruHead; p; p=p-
83c0: 3e 70 4c 72 75 4e 65 78 74 29 7b 0a 20 20 20 20  >pLruNext){.    
83d0: 61 73 73 65 72 74 28 20 70 2d 3e 69 73 50 69 6e  assert( p->isPin
83e0: 6e 65 64 3d 3d 30 20 29 3b 0a 20 20 20 20 6e 52  ned==0 );.    nR
83f0: 65 63 79 63 6c 61 62 6c 65 2b 2b 3b 0a 20 20 7d  ecyclable++;.  }
8400: 0a 20 20 2a 70 6e 43 75 72 72 65 6e 74 20 3d 20  .  *pnCurrent = 
8410: 70 63 61 63 68 65 31 2e 67 72 70 2e 6e 43 75 72  pcache1.grp.nCur
8420: 72 65 6e 74 50 61 67 65 3b 0a 20 20 2a 70 6e 4d  rentPage;.  *pnM
8430: 61 78 20 3d 20 28 69 6e 74 29 70 63 61 63 68 65  ax = (int)pcache
8440: 31 2e 67 72 70 2e 6e 4d 61 78 50 61 67 65 3b 0a  1.grp.nMaxPage;.
8450: 20 20 2a 70 6e 4d 69 6e 20 3d 20 28 69 6e 74 29    *pnMin = (int)
8460: 70 63 61 63 68 65 31 2e 67 72 70 2e 6e 4d 69 6e  pcache1.grp.nMin
8470: 50 61 67 65 3b 0a 20 20 2a 70 6e 52 65 63 79 63  Page;.  *pnRecyc
8480: 6c 61 62 6c 65 20 3d 20 6e 52 65 63 79 63 6c 61  lable = nRecycla
8490: 62 6c 65 3b 0a 7d 0a 23 65 6e 64 69 66 0a        ble;.}.#endif.