/ Hex Artifact Content
Login

Artifact 0324126d981c6db4ba39e0a6b2bf79b690d3107f:


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 69 66 28 20 6e 42 79 74  x) );.  if( nByt
2030: 65 3c 3d 70 63 61 63 68 65 31 2e 73 7a 53 6c 6f  e<=pcache1.szSlo
2040: 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  t ){.    sqlite3
2050: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 63 61  _mutex_enter(pca
2060: 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20 20  che1.mutex);.   
2070: 20 70 20 3d 20 28 50 67 48 64 72 31 20 2a 29 70   p = (PgHdr1 *)p
2080: 63 61 63 68 65 31 2e 70 46 72 65 65 3b 0a 20 20  cache1.pFree;.  
2090: 20 20 69 66 28 20 70 20 29 7b 0a 20 20 20 20 20    if( p ){.     
20a0: 20 70 63 61 63 68 65 31 2e 70 46 72 65 65 20 3d   pcache1.pFree =
20b0: 20 70 63 61 63 68 65 31 2e 70 46 72 65 65 2d 3e   pcache1.pFree->
20c0: 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 70 63 61  pNext;.      pca
20d0: 63 68 65 31 2e 6e 46 72 65 65 53 6c 6f 74 2d 2d  che1.nFreeSlot--
20e0: 3b 0a 20 20 20 20 20 20 70 63 61 63 68 65 31 2e  ;.      pcache1.
20f0: 62 55 6e 64 65 72 50 72 65 73 73 75 72 65 20 3d  bUnderPressure =
2100: 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65 53 6c   pcache1.nFreeSl
2110: 6f 74 3c 70 63 61 63 68 65 31 2e 6e 52 65 73 65  ot<pcache1.nRese
2120: 72 76 65 3b 0a 20 20 20 20 20 20 61 73 73 65 72  rve;.      asser
2130: 74 28 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65  t( pcache1.nFree
2140: 53 6c 6f 74 3e 3d 30 20 29 3b 0a 20 20 20 20 20  Slot>=0 );.     
2150: 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 53 65   sqlite3StatusSe
2160: 74 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f  t(SQLITE_STATUS_
2170: 50 41 47 45 43 41 43 48 45 5f 53 49 5a 45 2c 20  PAGECACHE_SIZE, 
2180: 6e 42 79 74 65 29 3b 0a 20 20 20 20 20 20 73 71  nByte);.      sq
2190: 6c 69 74 65 33 53 74 61 74 75 73 55 70 28 53 51  lite3StatusUp(SQ
21a0: 4c 49 54 45 5f 53 54 41 54 55 53 5f 50 41 47 45  LITE_STATUS_PAGE
21b0: 43 41 43 48 45 5f 55 53 45 44 2c 20 31 29 3b 0a  CACHE_USED, 1);.
21c0: 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65      }.    sqlite
21d0: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 63  3_mutex_leave(pc
21e0: 61 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20  ache1.mutex);.  
21f0: 7d 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 7b 0a  }.  if( p==0 ){.
2200: 20 20 20 20 2f 2a 20 4d 65 6d 6f 72 79 20 69 73      /* Memory is
2210: 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 20 69   not available i
2220: 6e 20 74 68 65 20 53 51 4c 49 54 45 5f 43 4f 4e  n the SQLITE_CON
2230: 46 49 47 5f 50 41 47 45 43 41 43 48 45 20 70 6f  FIG_PAGECACHE po
2240: 6f 6c 2e 20 20 47 65 74 0a 20 20 20 20 2a 2a 20  ol.  Get.    ** 
2250: 69 74 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 4d  it from sqlite3M
2260: 61 6c 6c 6f 63 20 69 6e 73 74 65 61 64 2e 0a 20  alloc instead.. 
2270: 20 20 20 2a 2f 0a 20 20 20 20 70 20 3d 20 73 71     */.    p = sq
2280: 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 6e 42 79 74  lite3Malloc(nByt
2290: 65 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49  e);.#ifndef SQLI
22a0: 54 45 5f 44 49 53 41 42 4c 45 5f 50 41 47 45 43  TE_DISABLE_PAGEC
22b0: 41 43 48 45 5f 4f 56 45 52 46 4c 4f 57 5f 53 54  ACHE_OVERFLOW_ST
22c0: 41 54 53 0a 20 20 20 20 69 66 28 20 70 20 29 7b  ATS.    if( p ){
22d0: 0a 20 20 20 20 20 20 69 6e 74 20 73 7a 20 3d 20  .      int sz = 
22e0: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a  sqlite3MallocSiz
22f0: 65 28 70 29 3b 0a 20 20 20 20 20 20 73 71 6c 69  e(p);.      sqli
2300: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28  te3_mutex_enter(
2310: 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a  pcache1.mutex);.
2320: 20 20 20 20 20 20 73 71 6c 69 74 65 33 53 74 61        sqlite3Sta
2330: 74 75 73 53 65 74 28 53 51 4c 49 54 45 5f 53 54  tusSet(SQLITE_ST
2340: 41 54 55 53 5f 50 41 47 45 43 41 43 48 45 5f 53  ATUS_PAGECACHE_S
2350: 49 5a 45 2c 20 6e 42 79 74 65 29 3b 0a 20 20 20  IZE, nByte);.   
2360: 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73     sqlite3Status
2370: 55 70 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53  Up(SQLITE_STATUS
2380: 5f 50 41 47 45 43 41 43 48 45 5f 4f 56 45 52 46  _PAGECACHE_OVERF
2390: 4c 4f 57 2c 20 73 7a 29 3b 0a 20 20 20 20 20 20  LOW, sz);.      
23a0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65  sqlite3_mutex_le
23b0: 61 76 65 28 70 63 61 63 68 65 31 2e 6d 75 74 65  ave(pcache1.mute
23c0: 78 29 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66  x);.    }.#endif
23d0: 0a 20 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 64  .    sqlite3Memd
23e0: 65 62 75 67 53 65 74 54 79 70 65 28 70 2c 20 4d  ebugSetType(p, M
23f0: 45 4d 54 59 50 45 5f 50 43 41 43 48 45 29 3b 0a  EMTYPE_PCACHE);.
2400: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a    }.  return p;.
2410: 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 6e  }../*.** Free an
2420: 20 61 6c 6c 6f 63 61 74 65 64 20 62 75 66 66 65   allocated buffe
2430: 72 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20  r obtained from 
2440: 70 63 61 63 68 65 31 41 6c 6c 6f 63 28 29 2e 0a  pcache1Alloc()..
2450: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 63  */.static int pc
2460: 61 63 68 65 31 46 72 65 65 28 76 6f 69 64 20 2a  ache1Free(void *
2470: 70 29 7b 0a 20 20 69 6e 74 20 6e 46 72 65 65 64  p){.  int nFreed
2480: 20 3d 20 30 3b 0a 20 20 69 66 28 20 70 3d 3d 30   = 0;.  if( p==0
2490: 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 69   ) return 0;.  i
24a0: 66 28 20 70 3e 3d 70 63 61 63 68 65 31 2e 70 53  f( p>=pcache1.pS
24b0: 74 61 72 74 20 26 26 20 70 3c 70 63 61 63 68 65  tart && p<pcache
24c0: 31 2e 70 45 6e 64 20 29 7b 0a 20 20 20 20 50 67  1.pEnd ){.    Pg
24d0: 46 72 65 65 73 6c 6f 74 20 2a 70 53 6c 6f 74 3b  Freeslot *pSlot;
24e0: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  .    sqlite3_mut
24f0: 65 78 5f 65 6e 74 65 72 28 70 63 61 63 68 65 31  ex_enter(pcache1
2500: 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 73 71 6c  .mutex);.    sql
2510: 69 74 65 33 53 74 61 74 75 73 44 6f 77 6e 28 53  ite3StatusDown(S
2520: 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 50 41 47  QLITE_STATUS_PAG
2530: 45 43 41 43 48 45 5f 55 53 45 44 2c 20 31 29 3b  ECACHE_USED, 1);
2540: 0a 20 20 20 20 70 53 6c 6f 74 20 3d 20 28 50 67  .    pSlot = (Pg
2550: 46 72 65 65 73 6c 6f 74 2a 29 70 3b 0a 20 20 20  Freeslot*)p;.   
2560: 20 70 53 6c 6f 74 2d 3e 70 4e 65 78 74 20 3d 20   pSlot->pNext = 
2570: 70 63 61 63 68 65 31 2e 70 46 72 65 65 3b 0a 20  pcache1.pFree;. 
2580: 20 20 20 70 63 61 63 68 65 31 2e 70 46 72 65 65     pcache1.pFree
2590: 20 3d 20 70 53 6c 6f 74 3b 0a 20 20 20 20 70 63   = pSlot;.    pc
25a0: 61 63 68 65 31 2e 6e 46 72 65 65 53 6c 6f 74 2b  ache1.nFreeSlot+
25b0: 2b 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 62  +;.    pcache1.b
25c0: 55 6e 64 65 72 50 72 65 73 73 75 72 65 20 3d 20  UnderPressure = 
25d0: 70 63 61 63 68 65 31 2e 6e 46 72 65 65 53 6c 6f  pcache1.nFreeSlo
25e0: 74 3c 70 63 61 63 68 65 31 2e 6e 52 65 73 65 72  t<pcache1.nReser
25f0: 76 65 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20  ve;.    assert( 
2600: 70 63 61 63 68 65 31 2e 6e 46 72 65 65 53 6c 6f  pcache1.nFreeSlo
2610: 74 3c 3d 70 63 61 63 68 65 31 2e 6e 53 6c 6f 74  t<=pcache1.nSlot
2620: 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f   );.    sqlite3_
2630: 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 63 61 63  mutex_leave(pcac
2640: 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20 7d 65  he1.mutex);.  }e
2650: 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 72 74 28  lse{.    assert(
2660: 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67   sqlite3Memdebug
2670: 48 61 73 54 79 70 65 28 70 2c 20 4d 45 4d 54 59  HasType(p, MEMTY
2680: 50 45 5f 50 43 41 43 48 45 29 20 29 3b 0a 20 20  PE_PCACHE) );.  
2690: 20 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75    sqlite3Memdebu
26a0: 67 53 65 74 54 79 70 65 28 70 2c 20 4d 45 4d 54  gSetType(p, MEMT
26b0: 59 50 45 5f 48 45 41 50 29 3b 0a 20 20 20 20 6e  YPE_HEAP);.    n
26c0: 46 72 65 65 64 20 3d 20 73 71 6c 69 74 65 33 4d  Freed = sqlite3M
26d0: 61 6c 6c 6f 63 53 69 7a 65 28 70 29 3b 0a 23 69  allocSize(p);.#i
26e0: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 49 53  fndef SQLITE_DIS
26f0: 41 42 4c 45 5f 50 41 47 45 43 41 43 48 45 5f 4f  ABLE_PAGECACHE_O
2700: 56 45 52 46 4c 4f 57 5f 53 54 41 54 53 0a 20 20  VERFLOW_STATS.  
2710: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f    sqlite3_mutex_
2720: 65 6e 74 65 72 28 70 63 61 63 68 65 31 2e 6d 75  enter(pcache1.mu
2730: 74 65 78 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  tex);.    sqlite
2740: 33 53 74 61 74 75 73 44 6f 77 6e 28 53 51 4c 49  3StatusDown(SQLI
2750: 54 45 5f 53 54 41 54 55 53 5f 50 41 47 45 43 41  TE_STATUS_PAGECA
2760: 43 48 45 5f 4f 56 45 52 46 4c 4f 57 2c 20 6e 46  CHE_OVERFLOW, nF
2770: 72 65 65 64 29 3b 0a 20 20 20 20 73 71 6c 69 74  reed);.    sqlit
2780: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70  e3_mutex_leave(p
2790: 63 61 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a 23  cache1.mutex);.#
27a0: 65 6e 64 69 66 0a 20 20 20 20 73 71 6c 69 74 65  endif.    sqlite
27b0: 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 7d 0a 20  3_free(p);.  }. 
27c0: 20 72 65 74 75 72 6e 20 6e 46 72 65 65 64 3b 0a   return nFreed;.
27d0: 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  }..#ifdef SQLITE
27e0: 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d  _ENABLE_MEMORY_M
27f0: 41 4e 41 47 45 4d 45 4e 54 0a 2f 2a 0a 2a 2a 20  ANAGEMENT./*.** 
2800: 52 65 74 75 72 6e 20 74 68 65 20 73 69 7a 65 20  Return the size 
2810: 6f 66 20 61 20 70 63 61 63 68 65 20 61 6c 6c 6f  of a pcache allo
2820: 63 61 74 69 6f 6e 0a 2a 2f 0a 73 74 61 74 69 63  cation.*/.static
2830: 20 69 6e 74 20 70 63 61 63 68 65 31 4d 65 6d 53   int pcache1MemS
2840: 69 7a 65 28 76 6f 69 64 20 2a 70 29 7b 0a 20 20  ize(void *p){.  
2850: 69 66 28 20 70 3e 3d 70 63 61 63 68 65 31 2e 70  if( p>=pcache1.p
2860: 53 74 61 72 74 20 26 26 20 70 3c 70 63 61 63 68  Start && p<pcach
2870: 65 31 2e 70 45 6e 64 20 29 7b 0a 20 20 20 20 72  e1.pEnd ){.    r
2880: 65 74 75 72 6e 20 70 63 61 63 68 65 31 2e 73 7a  eturn pcache1.sz
2890: 53 6c 6f 74 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  Slot;.  }else{. 
28a0: 20 20 20 69 6e 74 20 69 53 69 7a 65 3b 0a 20 20     int iSize;.  
28b0: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
28c0: 33 4d 65 6d 64 65 62 75 67 48 61 73 54 79 70 65  3MemdebugHasType
28d0: 28 70 2c 20 4d 45 4d 54 59 50 45 5f 50 43 41 43  (p, MEMTYPE_PCAC
28e0: 48 45 29 20 29 3b 0a 20 20 20 20 73 71 6c 69 74  HE) );.    sqlit
28f0: 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70  e3MemdebugSetTyp
2900: 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 48 45 41  e(p, MEMTYPE_HEA
2910: 50 29 3b 0a 20 20 20 20 69 53 69 7a 65 20 3d 20  P);.    iSize = 
2920: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a  sqlite3MallocSiz
2930: 65 28 70 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  e(p);.    sqlite
2940: 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65  3MemdebugSetType
2950: 28 70 2c 20 4d 45 4d 54 59 50 45 5f 50 43 41 43  (p, MEMTYPE_PCAC
2960: 48 45 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20  HE);.    return 
2970: 69 53 69 7a 65 3b 0a 20 20 7d 0a 7d 0a 23 65 6e  iSize;.  }.}.#en
2980: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e  dif /* SQLITE_EN
2990: 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41  ABLE_MEMORY_MANA
29a0: 47 45 4d 45 4e 54 20 2a 2f 0a 0a 2f 2a 0a 2a 2a  GEMENT */../*.**
29b0: 20 41 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20   Allocate a new 
29c0: 70 61 67 65 20 6f 62 6a 65 63 74 20 69 6e 69 74  page object init
29d0: 69 61 6c 6c 79 20 61 73 73 6f 63 69 61 74 65 64  ially associated
29e0: 20 77 69 74 68 20 63 61 63 68 65 20 70 43 61 63   with cache pCac
29f0: 68 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67  he..*/.static Pg
2a00: 48 64 72 31 20 2a 70 63 61 63 68 65 31 41 6c 6c  Hdr1 *pcache1All
2a10: 6f 63 50 61 67 65 28 50 43 61 63 68 65 31 20 2a  ocPage(PCache1 *
2a20: 70 43 61 63 68 65 29 7b 0a 20 20 50 67 48 64 72  pCache){.  PgHdr
2a30: 31 20 2a 70 20 3d 20 30 3b 0a 20 20 76 6f 69 64  1 *p = 0;.  void
2a40: 20 2a 70 50 67 3b 0a 0a 20 20 2f 2a 20 54 68 65   *pPg;..  /* The
2a50: 20 67 72 6f 75 70 20 6d 75 74 65 78 20 6d 75 73   group mutex mus
2a60: 74 20 62 65 20 72 65 6c 65 61 73 65 64 20 62 65  t be released be
2a70: 66 6f 72 65 20 70 63 61 63 68 65 31 41 6c 6c 6f  fore pcache1Allo
2a80: 63 28 29 20 69 73 20 63 61 6c 6c 65 64 2e 20 54  c() is called. T
2a90: 68 69 73 0a 20 20 2a 2a 20 69 73 20 62 65 63 61  his.  ** is beca
2aa0: 75 73 65 20 69 74 20 6d 61 79 20 63 61 6c 6c 20  use it may call 
2ab0: 73 71 6c 69 74 65 33 5f 72 65 6c 65 61 73 65 5f  sqlite3_release_
2ac0: 6d 65 6d 6f 72 79 28 29 2c 20 77 68 69 63 68 20  memory(), which 
2ad0: 61 73 73 75 6d 65 73 20 74 68 61 74 20 0a 20 20  assumes that .  
2ae0: 2a 2a 20 74 68 69 73 20 6d 75 74 65 78 20 69 73  ** this mutex is
2af0: 20 6e 6f 74 20 68 65 6c 64 2e 20 2a 2f 0a 20 20   not held. */.  
2b00: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f  assert( sqlite3_
2b10: 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 61 63 68  mutex_held(pCach
2b20: 65 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78  e->pGroup->mutex
2b30: 29 20 29 3b 0a 20 20 70 63 61 63 68 65 31 4c 65  ) );.  pcache1Le
2b40: 61 76 65 4d 75 74 65 78 28 70 43 61 63 68 65 2d  aveMutex(pCache-
2b50: 3e 70 47 72 6f 75 70 29 3b 0a 23 69 66 64 65 66  >pGroup);.#ifdef
2b60: 20 53 51 4c 49 54 45 5f 50 43 41 43 48 45 5f 53   SQLITE_PCACHE_S
2b70: 45 50 41 52 41 54 45 5f 48 45 41 44 45 52 0a 20  EPARATE_HEADER. 
2b80: 20 70 50 67 20 3d 20 70 63 61 63 68 65 31 41 6c   pPg = pcache1Al
2b90: 6c 6f 63 28 70 43 61 63 68 65 2d 3e 73 7a 50 61  loc(pCache->szPa
2ba0: 67 65 29 3b 0a 20 20 70 20 3d 20 73 71 6c 69 74  ge);.  p = sqlit
2bb0: 65 33 4d 61 6c 6c 6f 63 28 73 69 7a 65 6f 66 28  e3Malloc(sizeof(
2bc0: 50 67 48 64 72 31 29 20 2b 20 70 43 61 63 68 65  PgHdr1) + pCache
2bd0: 2d 3e 73 7a 45 78 74 72 61 29 3b 0a 20 20 69 66  ->szExtra);.  if
2be0: 28 20 21 70 50 67 20 7c 7c 20 21 70 20 29 7b 0a  ( !pPg || !p ){.
2bf0: 20 20 20 20 70 63 61 63 68 65 31 46 72 65 65 28      pcache1Free(
2c00: 70 50 67 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  pPg);.    sqlite
2c10: 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 20 20 70  3_free(p);.    p
2c20: 50 67 20 3d 20 30 3b 0a 20 20 7d 0a 23 65 6c 73  Pg = 0;.  }.#els
2c30: 65 0a 20 20 70 50 67 20 3d 20 70 63 61 63 68 65  e.  pPg = pcache
2c40: 31 41 6c 6c 6f 63 28 52 4f 55 4e 44 38 28 73 69  1Alloc(ROUND8(si
2c50: 7a 65 6f 66 28 50 67 48 64 72 31 29 29 20 2b 20  zeof(PgHdr1)) + 
2c60: 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 20 2b  pCache->szPage +
2c70: 20 70 43 61 63 68 65 2d 3e 73 7a 45 78 74 72 61   pCache->szExtra
2c80: 29 3b 0a 20 20 70 20 3d 20 28 50 67 48 64 72 31  );.  p = (PgHdr1
2c90: 20 2a 29 26 28 28 75 38 20 2a 29 70 50 67 29 5b   *)&((u8 *)pPg)[
2ca0: 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 5d 3b  pCache->szPage];
2cb0: 0a 23 65 6e 64 69 66 0a 20 20 70 63 61 63 68 65  .#endif.  pcache
2cc0: 31 45 6e 74 65 72 4d 75 74 65 78 28 70 43 61 63  1EnterMutex(pCac
2cd0: 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 0a 20 20  he->pGroup);..  
2ce0: 69 66 28 20 70 50 67 20 29 7b 0a 20 20 20 20 70  if( pPg ){.    p
2cf0: 2d 3e 70 61 67 65 2e 70 42 75 66 20 3d 20 70 50  ->page.pBuf = pP
2d00: 67 3b 0a 20 20 20 20 70 2d 3e 70 61 67 65 2e 70  g;.    p->page.p
2d10: 45 78 74 72 61 20 3d 20 26 70 5b 31 5d 3b 0a 20  Extra = &p[1];. 
2d20: 20 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e 62     if( pCache->b
2d30: 50 75 72 67 65 61 62 6c 65 20 29 7b 0a 20 20 20  Purgeable ){.   
2d40: 20 20 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75     pCache->pGrou
2d50: 70 2d 3e 6e 43 75 72 72 65 6e 74 50 61 67 65 2b  p->nCurrentPage+
2d60: 2b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 65 74  +;.    }.    ret
2d70: 75 72 6e 20 70 3b 0a 20 20 7d 0a 20 20 72 65 74  urn p;.  }.  ret
2d80: 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  urn 0;.}../*.** 
2d90: 46 72 65 65 20 61 20 70 61 67 65 20 6f 62 6a 65  Free a page obje
2da0: 63 74 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 20  ct allocated by 
2db0: 70 63 61 63 68 65 31 41 6c 6c 6f 63 50 61 67 65  pcache1AllocPage
2dc0: 28 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 6f  ()..**.** The po
2dd0: 69 6e 74 65 72 20 69 73 20 61 6c 6c 6f 77 65 64  inter is allowed
2de0: 20 74 6f 20 62 65 20 4e 55 4c 4c 2c 20 77 68 69   to be NULL, whi
2df0: 63 68 20 69 73 20 70 72 75 64 65 6e 74 2e 20 20  ch is prudent.  
2e00: 42 75 74 20 69 74 20 74 75 72 6e 73 20 6f 75 74  But it turns out
2e10: 0a 2a 2a 20 74 68 61 74 20 74 68 65 20 63 75 72  .** that the cur
2e20: 72 65 6e 74 20 69 6d 70 6c 65 6d 65 6e 74 61 74  rent implementat
2e30: 69 6f 6e 20 68 61 70 70 65 6e 73 20 74 6f 20 6e  ion happens to n
2e40: 65 76 65 72 20 63 61 6c 6c 20 74 68 69 73 20 72  ever call this r
2e50: 6f 75 74 69 6e 65 0a 2a 2a 20 77 69 74 68 20 61  outine.** with a
2e60: 20 4e 55 4c 4c 20 70 6f 69 6e 74 65 72 2c 20 73   NULL pointer, s
2e70: 6f 20 77 65 20 6d 61 72 6b 20 74 68 65 20 4e 55  o we mark the NU
2e80: 4c 4c 20 74 65 73 74 20 77 69 74 68 20 41 4c 57  LL test with ALW
2e90: 41 59 53 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 63  AYS()..*/.static
2ea0: 20 76 6f 69 64 20 70 63 61 63 68 65 31 46 72 65   void pcache1Fre
2eb0: 65 50 61 67 65 28 50 67 48 64 72 31 20 2a 70 29  ePage(PgHdr1 *p)
2ec0: 7b 0a 20 20 69 66 28 20 41 4c 57 41 59 53 28 70  {.  if( ALWAYS(p
2ed0: 29 20 29 7b 0a 20 20 20 20 50 43 61 63 68 65 31  ) ){.    PCache1
2ee0: 20 2a 70 43 61 63 68 65 20 3d 20 70 2d 3e 70 43   *pCache = p->pC
2ef0: 61 63 68 65 3b 0a 20 20 20 20 61 73 73 65 72 74  ache;.    assert
2f00: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
2f10: 68 65 6c 64 28 70 2d 3e 70 43 61 63 68 65 2d 3e  held(p->pCache->
2f20: 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29  pGroup->mutex) )
2f30: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 46 72 65  ;.    pcache1Fre
2f40: 65 28 70 2d 3e 70 61 67 65 2e 70 42 75 66 29 3b  e(p->page.pBuf);
2f50: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 50  .#ifdef SQLITE_P
2f60: 43 41 43 48 45 5f 53 45 50 41 52 41 54 45 5f 48  CACHE_SEPARATE_H
2f70: 45 41 44 45 52 0a 20 20 20 20 73 71 6c 69 74 65  EADER.    sqlite
2f80: 33 5f 66 72 65 65 28 70 29 3b 0a 23 65 6e 64 69  3_free(p);.#endi
2f90: 66 0a 20 20 20 20 69 66 28 20 70 43 61 63 68 65  f.    if( pCache
2fa0: 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 29 7b 0a  ->bPurgeable ){.
2fb0: 20 20 20 20 20 20 70 43 61 63 68 65 2d 3e 70 47        pCache->pG
2fc0: 72 6f 75 70 2d 3e 6e 43 75 72 72 65 6e 74 50 61  roup->nCurrentPa
2fd0: 67 65 2d 2d 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  ge--;.    }.  }.
2fe0: 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6c 6c 6f 63 20  }../*.** Malloc 
2ff0: 66 75 6e 63 74 69 6f 6e 20 75 73 65 64 20 62 79  function used by
3000: 20 53 51 4c 69 74 65 20 74 6f 20 6f 62 74 61 69   SQLite to obtai
3010: 6e 20 73 70 61 63 65 20 66 72 6f 6d 20 74 68 65  n space from the
3020: 20 62 75 66 66 65 72 20 63 6f 6e 66 69 67 75 72   buffer configur
3030: 65 64 0a 2a 2a 20 75 73 69 6e 67 20 73 71 6c 69  ed.** using sqli
3040: 74 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54  te3_config(SQLIT
3050: 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43  E_CONFIG_PAGECAC
3060: 48 45 29 20 6f 70 74 69 6f 6e 2e 20 49 66 20 6e  HE) option. If n
3070: 6f 20 73 75 63 68 20 62 75 66 66 65 72 0a 2a 2a  o such buffer.**
3080: 20 65 78 69 73 74 73 2c 20 74 68 69 73 20 66 75   exists, this fu
3090: 6e 63 74 69 6f 6e 20 66 61 6c 6c 73 20 62 61 63  nction falls bac
30a0: 6b 20 74 6f 20 73 71 6c 69 74 65 33 4d 61 6c 6c  k to sqlite3Mall
30b0: 6f 63 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73  oc()..*/.void *s
30c0: 71 6c 69 74 65 33 50 61 67 65 4d 61 6c 6c 6f 63  qlite3PageMalloc
30d0: 28 69 6e 74 20 73 7a 29 7b 0a 20 20 72 65 74 75  (int sz){.  retu
30e0: 72 6e 20 70 63 61 63 68 65 31 41 6c 6c 6f 63 28  rn pcache1Alloc(
30f0: 73 7a 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72  sz);.}../*.** Fr
3100: 65 65 20 61 6e 20 61 6c 6c 6f 63 61 74 65 64 20  ee an allocated 
3110: 62 75 66 66 65 72 20 6f 62 74 61 69 6e 65 64 20  buffer obtained 
3120: 66 72 6f 6d 20 73 71 6c 69 74 65 33 50 61 67 65  from sqlite3Page
3130: 4d 61 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a 76 6f 69  Malloc()..*/.voi
3140: 64 20 73 71 6c 69 74 65 33 50 61 67 65 46 72 65  d sqlite3PageFre
3150: 65 28 76 6f 69 64 20 2a 70 29 7b 0a 20 20 70 63  e(void *p){.  pc
3160: 61 63 68 65 31 46 72 65 65 28 70 29 3b 0a 7d 0a  ache1Free(p);.}.
3170: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74  ../*.** Return t
3180: 72 75 65 20 69 66 20 69 74 20 64 65 73 69 72 61  rue if it desira
3190: 62 6c 65 20 74 6f 20 61 76 6f 69 64 20 61 6c 6c  ble to avoid all
31a0: 6f 63 61 74 69 6e 67 20 61 20 6e 65 77 20 70 61  ocating a new pa
31b0: 67 65 20 63 61 63 68 65 0a 2a 2a 20 65 6e 74 72  ge cache.** entr
31c0: 79 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6d 65 6d 6f  y..**.** If memo
31d0: 72 79 20 77 61 73 20 61 6c 6c 6f 63 61 74 65 64  ry was allocated
31e0: 20 73 70 65 63 69 66 69 63 61 6c 6c 79 20 74 6f   specifically to
31f0: 20 74 68 65 20 70 61 67 65 20 63 61 63 68 65 20   the page cache 
3200: 75 73 69 6e 67 0a 2a 2a 20 53 51 4c 49 54 45 5f  using.** SQLITE_
3210: 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45  CONFIG_PAGECACHE
3220: 20 62 75 74 20 74 68 61 74 20 6d 65 6d 6f 72 79   but that memory
3230: 20 68 61 73 20 61 6c 6c 20 62 65 65 6e 20 75 73   has all been us
3240: 65 64 2c 20 74 68 65 6e 0a 2a 2a 20 69 74 20 69  ed, then.** it i
3250: 73 20 64 65 73 69 72 61 62 6c 65 20 74 6f 20 61  s desirable to a
3260: 76 6f 69 64 20 61 6c 6c 6f 63 61 74 69 6e 67 20  void allocating 
3270: 61 20 6e 65 77 20 70 61 67 65 20 63 61 63 68 65  a new page cache
3280: 20 65 6e 74 72 79 20 62 65 63 61 75 73 65 0a 2a   entry because.*
3290: 2a 20 70 72 65 73 75 6d 61 62 6c 79 20 53 51 4c  * presumably SQL
32a0: 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43  ITE_CONFIG_PAGEC
32b0: 41 43 48 45 20 77 61 73 20 73 75 70 70 6f 73 65  ACHE was suppose
32c0: 20 74 6f 20 62 65 20 73 75 66 66 69 63 69 65 6e   to be sufficien
32d0: 74 0a 2a 2a 20 66 6f 72 20 61 6c 6c 20 70 61 67  t.** for all pag
32e0: 65 20 63 61 63 68 65 20 6e 65 65 64 73 20 61 6e  e cache needs an
32f0: 64 20 77 65 20 73 68 6f 75 6c 64 20 6e 6f 74 20  d we should not 
3300: 6e 65 65 64 20 74 6f 20 73 70 69 6c 6c 20 74 68  need to spill th
3310: 65 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e 20  e.** allocation 
3320: 6f 6e 74 6f 20 74 68 65 20 68 65 61 70 2e 0a 2a  onto the heap..*
3330: 2a 0a 2a 2a 20 4f 72 2c 20 74 68 65 20 68 65 61  *.** Or, the hea
3340: 70 20 69 73 20 75 73 65 64 20 66 6f 72 20 61 6c  p is used for al
3350: 6c 20 70 61 67 65 20 63 61 63 68 65 20 6d 65 6d  l page cache mem
3360: 6f 72 79 20 62 75 74 20 74 68 65 20 68 65 61 70  ory but the heap
3370: 20 69 73 0a 2a 2a 20 75 6e 64 65 72 20 6d 65 6d   is.** under mem
3380: 6f 72 79 20 70 72 65 73 73 75 72 65 2c 20 74 68  ory pressure, th
3390: 65 6e 20 61 67 61 69 6e 20 69 74 20 69 73 20 64  en again it is d
33a0: 65 73 69 72 61 62 6c 65 20 74 6f 20 61 76 6f 69  esirable to avoi
33b0: 64 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 6e 67 20  d.** allocating 
33c0: 61 20 6e 65 77 20 70 61 67 65 20 63 61 63 68 65  a new page cache
33d0: 20 65 6e 74 72 79 20 69 6e 20 6f 72 64 65 72 20   entry in order 
33e0: 74 6f 20 61 76 6f 69 64 20 73 74 72 65 73 73 69  to avoid stressi
33f0: 6e 67 0a 2a 2a 20 74 68 65 20 68 65 61 70 20 65  ng.** the heap e
3400: 76 65 6e 20 66 75 72 74 68 65 72 2e 0a 2a 2f 0a  ven further..*/.
3410: 73 74 61 74 69 63 20 69 6e 74 20 70 63 61 63 68  static int pcach
3420: 65 31 55 6e 64 65 72 4d 65 6d 6f 72 79 50 72 65  e1UnderMemoryPre
3430: 73 73 75 72 65 28 50 43 61 63 68 65 31 20 2a 70  ssure(PCache1 *p
3440: 43 61 63 68 65 29 7b 0a 20 20 69 66 28 20 70 63  Cache){.  if( pc
3450: 61 63 68 65 31 2e 6e 53 6c 6f 74 20 26 26 20 28  ache1.nSlot && (
3460: 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 2b 70  pCache->szPage+p
3470: 43 61 63 68 65 2d 3e 73 7a 45 78 74 72 61 29 3c  Cache->szExtra)<
3480: 3d 70 63 61 63 68 65 31 2e 73 7a 53 6c 6f 74 20  =pcache1.szSlot 
3490: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 70 63  ){.    return pc
34a0: 61 63 68 65 31 2e 62 55 6e 64 65 72 50 72 65 73  ache1.bUnderPres
34b0: 73 75 72 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  sure;.  }else{. 
34c0: 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65     return sqlite
34d0: 33 48 65 61 70 4e 65 61 72 6c 79 46 75 6c 6c 28  3HeapNearlyFull(
34e0: 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a  );.  }.}../*****
34f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
3500: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
3510: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
3520: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
3530: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 2f 2a 2a 2a 2a  *********/./****
3540: 2a 2a 2a 2a 20 47 65 6e 65 72 61 6c 20 49 6d 70  **** General Imp
3550: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 46 75 6e 63  lementation Func
3560: 74 69 6f 6e 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  tions **********
3570: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
3580: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 0a  **********/../*.
3590: 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e  ** This function
35a0: 20 69 73 20 75 73 65 64 20 74 6f 20 72 65 73 69   is used to resi
35b0: 7a 65 20 74 68 65 20 68 61 73 68 20 74 61 62 6c  ze the hash tabl
35c0: 65 20 75 73 65 64 20 62 79 20 74 68 65 20 63 61  e used by the ca
35d0: 63 68 65 20 70 61 73 73 65 64 0a 2a 2a 20 61 73  che passed.** as
35e0: 20 74 68 65 20 66 69 72 73 74 20 61 72 67 75 6d   the first argum
35f0: 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50  ent..**.** The P
3600: 43 61 63 68 65 20 6d 75 74 65 78 20 6d 75 73 74  Cache mutex must
3610: 20 62 65 20 68 65 6c 64 20 77 68 65 6e 20 74 68   be held when th
3620: 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63  is function is c
3630: 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63  alled..*/.static
3640: 20 76 6f 69 64 20 70 63 61 63 68 65 31 52 65 73   void pcache1Res
3650: 69 7a 65 48 61 73 68 28 50 43 61 63 68 65 31 20  izeHash(PCache1 
3660: 2a 70 29 7b 0a 20 20 50 67 48 64 72 31 20 2a 2a  *p){.  PgHdr1 **
3670: 61 70 4e 65 77 3b 0a 20 20 75 6e 73 69 67 6e 65  apNew;.  unsigne
3680: 64 20 69 6e 74 20 6e 4e 65 77 3b 0a 20 20 75 6e  d int nNew;.  un
3690: 73 69 67 6e 65 64 20 69 6e 74 20 69 3b 0a 0a 20  signed int i;.. 
36a0: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
36b0: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 70  _mutex_held(p->p
36c0: 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b  Group->mutex) );
36d0: 0a 0a 20 20 6e 4e 65 77 20 3d 20 70 2d 3e 6e 48  ..  nNew = p->nH
36e0: 61 73 68 2a 32 3b 0a 20 20 69 66 28 20 6e 4e 65  ash*2;.  if( nNe
36f0: 77 3c 32 35 36 20 29 7b 0a 20 20 20 20 6e 4e 65  w<256 ){.    nNe
3700: 77 20 3d 20 32 35 36 3b 0a 20 20 7d 0a 0a 20 20  w = 256;.  }..  
3710: 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65  pcache1LeaveMute
3720: 78 28 70 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20  x(p->pGroup);.  
3730: 69 66 28 20 70 2d 3e 6e 48 61 73 68 20 29 7b 20  if( p->nHash ){ 
3740: 73 71 6c 69 74 65 33 42 65 67 69 6e 42 65 6e 69  sqlite3BeginBeni
3750: 67 6e 4d 61 6c 6c 6f 63 28 29 3b 20 7d 0a 20 20  gnMalloc(); }.  
3760: 61 70 4e 65 77 20 3d 20 28 50 67 48 64 72 31 20  apNew = (PgHdr1 
3770: 2a 2a 29 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63  **)sqlite3Malloc
3780: 5a 65 72 6f 28 73 69 7a 65 6f 66 28 50 67 48 64  Zero(sizeof(PgHd
3790: 72 31 20 2a 29 2a 6e 4e 65 77 29 3b 0a 20 20 69  r1 *)*nNew);.  i
37a0: 66 28 20 70 2d 3e 6e 48 61 73 68 20 29 7b 20 73  f( p->nHash ){ s
37b0: 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d  qlite3EndBenignM
37c0: 61 6c 6c 6f 63 28 29 3b 20 7d 0a 20 20 70 63 61  alloc(); }.  pca
37d0: 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70  che1EnterMutex(p
37e0: 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20 69 66 28  ->pGroup);.  if(
37f0: 20 61 70 4e 65 77 20 29 7b 0a 20 20 20 20 66 6f   apNew ){.    fo
3800: 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 48 61 73  r(i=0; i<p->nHas
3810: 68 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 50  h; i++){.      P
3820: 67 48 64 72 31 20 2a 70 50 61 67 65 3b 0a 20 20  gHdr1 *pPage;.  
3830: 20 20 20 20 50 67 48 64 72 31 20 2a 70 4e 65 78      PgHdr1 *pNex
3840: 74 20 3d 20 70 2d 3e 61 70 48 61 73 68 5b 69 5d  t = p->apHash[i]
3850: 3b 0a 20 20 20 20 20 20 77 68 69 6c 65 28 20 28  ;.      while( (
3860: 70 50 61 67 65 20 3d 20 70 4e 65 78 74 29 21 3d  pPage = pNext)!=
3870: 30 20 29 7b 0a 20 20 20 20 20 20 20 20 75 6e 73  0 ){.        uns
3880: 69 67 6e 65 64 20 69 6e 74 20 68 20 3d 20 70 50  igned int h = pP
3890: 61 67 65 2d 3e 69 4b 65 79 20 25 20 6e 4e 65 77  age->iKey % nNew
38a0: 3b 0a 20 20 20 20 20 20 20 20 70 4e 65 78 74 20  ;.        pNext 
38b0: 3d 20 70 50 61 67 65 2d 3e 70 4e 65 78 74 3b 0a  = pPage->pNext;.
38c0: 20 20 20 20 20 20 20 20 70 50 61 67 65 2d 3e 70          pPage->p
38d0: 4e 65 78 74 20 3d 20 61 70 4e 65 77 5b 68 5d 3b  Next = apNew[h];
38e0: 0a 20 20 20 20 20 20 20 20 61 70 4e 65 77 5b 68  .        apNew[h
38f0: 5d 20 3d 20 70 50 61 67 65 3b 0a 20 20 20 20 20  ] = pPage;.     
3900: 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c   }.    }.    sql
3910: 69 74 65 33 5f 66 72 65 65 28 70 2d 3e 61 70 48  ite3_free(p->apH
3920: 61 73 68 29 3b 0a 20 20 20 20 70 2d 3e 61 70 48  ash);.    p->apH
3930: 61 73 68 20 3d 20 61 70 4e 65 77 3b 0a 20 20 20  ash = apNew;.   
3940: 20 70 2d 3e 6e 48 61 73 68 20 3d 20 6e 4e 65 77   p->nHash = nNew
3950: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  ;.  }.}../*.** T
3960: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  his function is 
3970: 75 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79 20  used internally 
3980: 74 6f 20 72 65 6d 6f 76 65 20 74 68 65 20 70 61  to remove the pa
3990: 67 65 20 70 50 61 67 65 20 66 72 6f 6d 20 74 68  ge pPage from th
39a0: 65 20 0a 2a 2a 20 50 47 72 6f 75 70 20 4c 52 55  e .** PGroup LRU
39b0: 20 6c 69 73 74 2c 20 69 66 20 69 73 20 70 61 72   list, if is par
39c0: 74 20 6f 66 20 69 74 2e 20 49 66 20 70 50 61 67  t of it. If pPag
39d0: 65 20 69 73 20 6e 6f 74 20 70 61 72 74 20 6f 66  e is not part of
39e0: 20 74 68 65 20 50 47 72 6f 75 70 0a 2a 2a 20 4c   the PGroup.** L
39f0: 52 55 20 6c 69 73 74 2c 20 74 68 65 6e 20 74 68  RU list, then th
3a00: 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61  is function is a
3a10: 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a 2a 2a 20 54 68   no-op..**.** Th
3a20: 65 20 50 47 72 6f 75 70 20 6d 75 74 65 78 20 6d  e PGroup mutex m
3a30: 75 73 74 20 62 65 20 68 65 6c 64 20 77 68 65 6e  ust be held when
3a40: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69   this function i
3a50: 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61  s called..*/.sta
3a60: 74 69 63 20 50 67 48 64 72 31 20 2a 70 63 61 63  tic PgHdr1 *pcac
3a70: 68 65 31 50 69 6e 50 61 67 65 28 50 67 48 64 72  he1PinPage(PgHdr
3a80: 31 20 2a 70 50 61 67 65 29 7b 0a 20 20 50 43 61  1 *pPage){.  PCa
3a90: 63 68 65 31 20 2a 70 43 61 63 68 65 3b 0a 0a 20  che1 *pCache;.. 
3aa0: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 21 3d   assert( pPage!=
3ab0: 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  0 );.  assert( p
3ac0: 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d  Page->isPinned==
3ad0: 30 20 29 3b 0a 20 20 70 43 61 63 68 65 20 3d 20  0 );.  pCache = 
3ae0: 70 50 61 67 65 2d 3e 70 43 61 63 68 65 3b 0a 20  pPage->pCache;. 
3af0: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e   assert( pPage->
3b00: 70 4c 72 75 4e 65 78 74 20 7c 7c 20 70 50 61 67  pLruNext || pPag
3b10: 65 3d 3d 70 43 61 63 68 65 2d 3e 70 47 72 6f 75  e==pCache->pGrou
3b20: 70 2d 3e 70 4c 72 75 54 61 69 6c 20 29 3b 0a 20  p->pLruTail );. 
3b30: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e   assert( pPage->
3b40: 70 4c 72 75 50 72 65 76 20 7c 7c 20 70 50 61 67  pLruPrev || pPag
3b50: 65 3d 3d 70 43 61 63 68 65 2d 3e 70 47 72 6f 75  e==pCache->pGrou
3b60: 70 2d 3e 70 4c 72 75 48 65 61 64 20 29 3b 0a 20  p->pLruHead );. 
3b70: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
3b80: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 61 63  _mutex_held(pCac
3b90: 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65  he->pGroup->mute
3ba0: 78 29 20 29 3b 0a 20 20 69 66 28 20 70 50 61 67  x) );.  if( pPag
3bb0: 65 2d 3e 70 4c 72 75 50 72 65 76 20 29 7b 0a 20  e->pLruPrev ){. 
3bc0: 20 20 20 70 50 61 67 65 2d 3e 70 4c 72 75 50 72     pPage->pLruPr
3bd0: 65 76 2d 3e 70 4c 72 75 4e 65 78 74 20 3d 20 70  ev->pLruNext = p
3be0: 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74 3b 0a  Page->pLruNext;.
3bf0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 43 61    }else{.    pCa
3c00: 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 70 4c 72  che->pGroup->pLr
3c10: 75 48 65 61 64 20 3d 20 70 50 61 67 65 2d 3e 70  uHead = pPage->p
3c20: 4c 72 75 4e 65 78 74 3b 0a 20 20 7d 0a 20 20 69  LruNext;.  }.  i
3c30: 66 28 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65  f( pPage->pLruNe
3c40: 78 74 20 29 7b 0a 20 20 20 20 70 50 61 67 65 2d  xt ){.    pPage-
3c50: 3e 70 4c 72 75 4e 65 78 74 2d 3e 70 4c 72 75 50  >pLruNext->pLruP
3c60: 72 65 76 20 3d 20 70 50 61 67 65 2d 3e 70 4c 72  rev = pPage->pLr
3c70: 75 50 72 65 76 3b 0a 20 20 7d 65 6c 73 65 7b 0a  uPrev;.  }else{.
3c80: 20 20 20 20 70 43 61 63 68 65 2d 3e 70 47 72 6f      pCache->pGro
3c90: 75 70 2d 3e 70 4c 72 75 54 61 69 6c 20 3d 20 70  up->pLruTail = p
3ca0: 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 3b 0a  Page->pLruPrev;.
3cb0: 20 20 7d 0a 20 20 70 50 61 67 65 2d 3e 70 4c 72    }.  pPage->pLr
3cc0: 75 4e 65 78 74 20 3d 20 30 3b 0a 20 20 70 50 61  uNext = 0;.  pPa
3cd0: 67 65 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20 30  ge->pLruPrev = 0
3ce0: 3b 0a 20 20 70 50 61 67 65 2d 3e 69 73 50 69 6e  ;.  pPage->isPin
3cf0: 6e 65 64 20 3d 20 31 3b 0a 20 20 70 43 61 63 68  ned = 1;.  pCach
3d00: 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65 2d 2d  e->nRecyclable--
3d10: 3b 0a 20 20 72 65 74 75 72 6e 20 70 50 61 67 65  ;.  return pPage
3d20: 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 6d 6f  ;.}.../*.** Remo
3d30: 76 65 20 74 68 65 20 70 61 67 65 20 73 75 70 70  ve the page supp
3d40: 6c 69 65 64 20 61 73 20 61 6e 20 61 72 67 75 6d  lied as an argum
3d50: 65 6e 74 20 66 72 6f 6d 20 74 68 65 20 68 61 73  ent from the has
3d60: 68 20 74 61 62 6c 65 20 0a 2a 2a 20 28 50 43 61  h table .** (PCa
3d70: 63 68 65 31 2e 61 70 48 61 73 68 20 73 74 72 75  che1.apHash stru
3d80: 63 74 75 72 65 29 20 74 68 61 74 20 69 74 20 69  cture) that it i
3d90: 73 20 63 75 72 72 65 6e 74 6c 79 20 73 74 6f 72  s currently stor
3da0: 65 64 20 69 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65  ed in..**.** The
3db0: 20 50 47 72 6f 75 70 20 6d 75 74 65 78 20 6d 75   PGroup mutex mu
3dc0: 73 74 20 62 65 20 68 65 6c 64 20 77 68 65 6e 20  st be held when 
3dd0: 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73  this function is
3de0: 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74   called..*/.stat
3df0: 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 52  ic void pcache1R
3e00: 65 6d 6f 76 65 46 72 6f 6d 48 61 73 68 28 50 67  emoveFromHash(Pg
3e10: 48 64 72 31 20 2a 70 50 61 67 65 29 7b 0a 20 20  Hdr1 *pPage){.  
3e20: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 68 3b 0a  unsigned int h;.
3e30: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68    PCache1 *pCach
3e40: 65 20 3d 20 70 50 61 67 65 2d 3e 70 43 61 63 68  e = pPage->pCach
3e50: 65 3b 0a 20 20 50 67 48 64 72 31 20 2a 2a 70 70  e;.  PgHdr1 **pp
3e60: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c  ;..  assert( sql
3e70: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28  ite3_mutex_held(
3e80: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e  pCache->pGroup->
3e90: 6d 75 74 65 78 29 20 29 3b 0a 20 20 68 20 3d 20  mutex) );.  h = 
3ea0: 70 50 61 67 65 2d 3e 69 4b 65 79 20 25 20 70 43  pPage->iKey % pC
3eb0: 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 66  ache->nHash;.  f
3ec0: 6f 72 28 70 70 3d 26 70 43 61 63 68 65 2d 3e 61  or(pp=&pCache->a
3ed0: 70 48 61 73 68 5b 68 5d 3b 20 28 2a 70 70 29 21  pHash[h]; (*pp)!
3ee0: 3d 70 50 61 67 65 3b 20 70 70 3d 26 28 2a 70 70  =pPage; pp=&(*pp
3ef0: 29 2d 3e 70 4e 65 78 74 29 3b 0a 20 20 2a 70 70  )->pNext);.  *pp
3f00: 20 3d 20 28 2a 70 70 29 2d 3e 70 4e 65 78 74 3b   = (*pp)->pNext;
3f10: 0a 0a 20 20 70 43 61 63 68 65 2d 3e 6e 50 61 67  ..  pCache->nPag
3f20: 65 2d 2d 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66  e--;.}../*.** If
3f30: 20 74 68 65 72 65 20 61 72 65 20 63 75 72 72 65   there are curre
3f40: 6e 74 6c 79 20 6d 6f 72 65 20 74 68 61 6e 20 6e  ntly more than n
3f50: 4d 61 78 50 61 67 65 20 70 61 67 65 73 20 61 6c  MaxPage pages al
3f60: 6c 6f 63 61 74 65 64 2c 20 74 72 79 0a 2a 2a 20  located, try.** 
3f70: 74 6f 20 72 65 63 79 63 6c 65 20 70 61 67 65 73  to recycle pages
3f80: 20 74 6f 20 72 65 64 75 63 65 20 74 68 65 20 6e   to reduce the n
3f90: 75 6d 62 65 72 20 61 6c 6c 6f 63 61 74 65 64 20  umber allocated 
3fa0: 74 6f 20 6e 4d 61 78 50 61 67 65 2e 0a 2a 2f 0a  to nMaxPage..*/.
3fb0: 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63  static void pcac
3fc0: 68 65 31 45 6e 66 6f 72 63 65 4d 61 78 50 61 67  he1EnforceMaxPag
3fd0: 65 28 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70  e(PGroup *pGroup
3fe0: 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c  ){.  assert( sql
3ff0: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28  ite3_mutex_held(
4000: 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29  pGroup->mutex) )
4010: 3b 0a 20 20 77 68 69 6c 65 28 20 70 47 72 6f 75  ;.  while( pGrou
4020: 70 2d 3e 6e 43 75 72 72 65 6e 74 50 61 67 65 3e  p->nCurrentPage>
4030: 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65  pGroup->nMaxPage
4040: 20 26 26 20 70 47 72 6f 75 70 2d 3e 70 4c 72 75   && pGroup->pLru
4050: 54 61 69 6c 20 29 7b 0a 20 20 20 20 50 67 48 64  Tail ){.    PgHd
4060: 72 31 20 2a 70 20 3d 20 70 47 72 6f 75 70 2d 3e  r1 *p = pGroup->
4070: 70 4c 72 75 54 61 69 6c 3b 0a 20 20 20 20 61 73  pLruTail;.    as
4080: 73 65 72 74 28 20 70 2d 3e 70 43 61 63 68 65 2d  sert( p->pCache-
4090: 3e 70 47 72 6f 75 70 3d 3d 70 47 72 6f 75 70 20  >pGroup==pGroup 
40a0: 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70  );.    assert( p
40b0: 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d 30 20 29 3b  ->isPinned==0 );
40c0: 0a 20 20 20 20 70 63 61 63 68 65 31 50 69 6e 50  .    pcache1PinP
40d0: 61 67 65 28 70 29 3b 0a 20 20 20 20 70 63 61 63  age(p);.    pcac
40e0: 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73  he1RemoveFromHas
40f0: 68 28 70 29 3b 0a 20 20 20 20 70 63 61 63 68 65  h(p);.    pcache
4100: 31 46 72 65 65 50 61 67 65 28 70 29 3b 0a 20 20  1FreePage(p);.  
4110: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 69 73 63 61  }.}../*.** Disca
4120: 72 64 20 61 6c 6c 20 70 61 67 65 73 20 66 72 6f  rd all pages fro
4130: 6d 20 63 61 63 68 65 20 70 43 61 63 68 65 20 77  m cache pCache w
4140: 69 74 68 20 61 20 70 61 67 65 20 6e 75 6d 62 65  ith a page numbe
4150: 72 20 28 6b 65 79 20 76 61 6c 75 65 29 20 0a 2a  r (key value) .*
4160: 2a 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 6f  * greater than o
4170: 72 20 65 71 75 61 6c 20 74 6f 20 69 4c 69 6d 69  r equal to iLimi
4180: 74 2e 20 41 6e 79 20 70 69 6e 6e 65 64 20 70 61  t. Any pinned pa
4190: 67 65 73 20 74 68 61 74 20 6d 65 65 74 20 74 68  ges that meet th
41a0: 69 73 20 0a 2a 2a 20 63 72 69 74 65 72 69 61 20  is .** criteria 
41b0: 61 72 65 20 75 6e 70 69 6e 6e 65 64 20 62 65 66  are unpinned bef
41c0: 6f 72 65 20 74 68 65 79 20 61 72 65 20 64 69 73  ore they are dis
41d0: 63 61 72 64 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68  carded..**.** Th
41e0: 65 20 50 43 61 63 68 65 20 6d 75 74 65 78 20 6d  e PCache mutex m
41f0: 75 73 74 20 62 65 20 68 65 6c 64 20 77 68 65 6e  ust be held when
4200: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69   this function i
4210: 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61  s called..*/.sta
4220: 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31  tic void pcache1
4230: 54 72 75 6e 63 61 74 65 55 6e 73 61 66 65 28 0a  TruncateUnsafe(.
4240: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68    PCache1 *pCach
4250: 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  e,             /
4260: 2a 20 54 68 65 20 63 61 63 68 65 20 74 6f 20 74  * The cache to t
4270: 72 75 6e 63 61 74 65 20 2a 2f 0a 20 20 75 6e 73  runcate */.  uns
4280: 69 67 6e 65 64 20 69 6e 74 20 69 4c 69 6d 69 74  igned int iLimit
4290: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 72 6f            /* Dro
42a0: 70 20 70 61 67 65 73 20 77 69 74 68 20 74 68 69  p pages with thi
42b0: 73 20 70 67 6e 6f 20 6f 72 20 6c 61 72 67 65 72  s pgno or larger
42c0: 20 2a 2f 0a 29 7b 0a 20 20 54 45 53 54 4f 4e 4c   */.){.  TESTONL
42d0: 59 28 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  Y( unsigned int 
42e0: 6e 50 61 67 65 20 3d 20 30 3b 20 29 20 20 2f 2a  nPage = 0; )  /*
42f0: 20 54 6f 20 61 73 73 65 72 74 20 70 43 61 63 68   To assert pCach
4300: 65 2d 3e 6e 50 61 67 65 20 69 73 20 63 6f 72 72  e->nPage is corr
4310: 65 63 74 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65  ect */.  unsigne
4320: 64 20 69 6e 74 20 68 3b 0a 20 20 61 73 73 65 72  d int h;.  asser
4330: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  t( sqlite3_mutex
4340: 5f 68 65 6c 64 28 70 43 61 63 68 65 2d 3e 70 47  _held(pCache->pG
4350: 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a  roup->mutex) );.
4360: 20 20 66 6f 72 28 68 3d 30 3b 20 68 3c 70 43 61    for(h=0; h<pCa
4370: 63 68 65 2d 3e 6e 48 61 73 68 3b 20 68 2b 2b 29  che->nHash; h++)
4380: 7b 0a 20 20 20 20 50 67 48 64 72 31 20 2a 2a 70  {.    PgHdr1 **p
4390: 70 20 3d 20 26 70 43 61 63 68 65 2d 3e 61 70 48  p = &pCache->apH
43a0: 61 73 68 5b 68 5d 3b 20 0a 20 20 20 20 50 67 48  ash[h]; .    PgH
43b0: 64 72 31 20 2a 70 50 61 67 65 3b 0a 20 20 20 20  dr1 *pPage;.    
43c0: 77 68 69 6c 65 28 20 28 70 50 61 67 65 20 3d 20  while( (pPage = 
43d0: 2a 70 70 29 21 3d 30 20 29 7b 0a 20 20 20 20 20  *pp)!=0 ){.     
43e0: 20 69 66 28 20 70 50 61 67 65 2d 3e 69 4b 65 79   if( pPage->iKey
43f0: 3e 3d 69 4c 69 6d 69 74 20 29 7b 0a 20 20 20 20  >=iLimit ){.    
4400: 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 50 61 67      pCache->nPag
4410: 65 2d 2d 3b 0a 20 20 20 20 20 20 20 20 2a 70 70  e--;.        *pp
4420: 20 3d 20 70 50 61 67 65 2d 3e 70 4e 65 78 74 3b   = pPage->pNext;
4430: 0a 20 20 20 20 20 20 20 20 69 66 28 20 21 70 50  .        if( !pP
4440: 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64 20 29 20  age->isPinned ) 
4450: 70 63 61 63 68 65 31 50 69 6e 50 61 67 65 28 70  pcache1PinPage(p
4460: 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 70  Page);.        p
4470: 63 61 63 68 65 31 46 72 65 65 50 61 67 65 28 70  cache1FreePage(p
4480: 50 61 67 65 29 3b 0a 20 20 20 20 20 20 7d 65 6c  Page);.      }el
4490: 73 65 7b 0a 20 20 20 20 20 20 20 20 70 70 20 3d  se{.        pp =
44a0: 20 26 70 50 61 67 65 2d 3e 70 4e 65 78 74 3b 0a   &pPage->pNext;.
44b0: 20 20 20 20 20 20 20 20 54 45 53 54 4f 4e 4c 59          TESTONLY
44c0: 28 20 6e 50 61 67 65 2b 2b 3b 20 29 0a 20 20 20  ( nPage++; ).   
44d0: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20     }.    }.  }. 
44e0: 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65 2d   assert( pCache-
44f0: 3e 6e 50 61 67 65 3d 3d 6e 50 61 67 65 20 29 3b  >nPage==nPage );
4500: 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  .}../***********
4510: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4520: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4530: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4540: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4550: 2a 2a 2a 2f 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 20 73  ***/./******** s
4560: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 4d 65  qlite3_pcache Me
4570: 74 68 6f 64 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  thods **********
4580: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4590: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
45a0: 2a 2a 2a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70  ****/../*.** Imp
45b0: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74  lementation of t
45c0: 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68  he sqlite3_pcach
45d0: 65 2e 78 49 6e 69 74 20 6d 65 74 68 6f 64 2e 0a  e.xInit method..
45e0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 63  */.static int pc
45f0: 61 63 68 65 31 49 6e 69 74 28 76 6f 69 64 20 2a  ache1Init(void *
4600: 4e 6f 74 55 73 65 64 29 7b 0a 20 20 55 4e 55 53  NotUsed){.  UNUS
4610: 45 44 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f 74  ED_PARAMETER(Not
4620: 55 73 65 64 29 3b 0a 20 20 61 73 73 65 72 74 28  Used);.  assert(
4630: 20 70 63 61 63 68 65 31 2e 69 73 49 6e 69 74 3d   pcache1.isInit=
4640: 3d 30 20 29 3b 0a 20 20 6d 65 6d 73 65 74 28 26  =0 );.  memset(&
4650: 70 63 61 63 68 65 31 2c 20 30 2c 20 73 69 7a 65  pcache1, 0, size
4660: 6f 66 28 70 63 61 63 68 65 31 29 29 3b 0a 20 20  of(pcache1));.  
4670: 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61  if( sqlite3Globa
4680: 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74  lConfig.bCoreMut
4690: 65 78 20 29 7b 0a 20 20 20 20 70 63 61 63 68 65  ex ){.    pcache
46a0: 31 2e 67 72 70 2e 6d 75 74 65 78 20 3d 20 73 71  1.grp.mutex = sq
46b0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f  lite3_mutex_allo
46c0: 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53  c(SQLITE_MUTEX_S
46d0: 54 41 54 49 43 5f 4c 52 55 29 3b 0a 20 20 20 20  TATIC_LRU);.    
46e0: 70 63 61 63 68 65 31 2e 6d 75 74 65 78 20 3d 20  pcache1.mutex = 
46f0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 61 6c  sqlite3_mutex_al
4700: 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58  loc(SQLITE_MUTEX
4710: 5f 53 54 41 54 49 43 5f 50 4d 45 4d 29 3b 0a 20  _STATIC_PMEM);. 
4720: 20 7d 0a 20 20 70 63 61 63 68 65 31 2e 67 72 70   }.  pcache1.grp
4730: 2e 6d 78 50 69 6e 6e 65 64 20 3d 20 31 30 3b 0a  .mxPinned = 10;.
4740: 20 20 70 63 61 63 68 65 31 2e 69 73 49 6e 69 74    pcache1.isInit
4750: 20 3d 20 31 3b 0a 20 20 72 65 74 75 72 6e 20 53   = 1;.  return S
4760: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a  QLITE_OK;.}../*.
4770: 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  ** Implementatio
4780: 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33  n of the sqlite3
4790: 5f 70 63 61 63 68 65 2e 78 53 68 75 74 64 6f 77  _pcache.xShutdow
47a0: 6e 20 6d 65 74 68 6f 64 2e 0a 2a 2a 20 4e 6f 74  n method..** Not
47b0: 65 20 74 68 61 74 20 74 68 65 20 73 74 61 74 69  e that the stati
47c0: 63 20 6d 75 74 65 78 20 61 6c 6c 6f 63 61 74 65  c mutex allocate
47d0: 64 20 69 6e 20 78 49 6e 69 74 20 64 6f 65 73 20  d in xInit does 
47e0: 0a 2a 2a 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20  .** not need to 
47f0: 62 65 20 66 72 65 65 64 2e 0a 2a 2f 0a 73 74 61  be freed..*/.sta
4800: 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31  tic void pcache1
4810: 53 68 75 74 64 6f 77 6e 28 76 6f 69 64 20 2a 4e  Shutdown(void *N
4820: 6f 74 55 73 65 64 29 7b 0a 20 20 55 4e 55 53 45  otUsed){.  UNUSE
4830: 44 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f 74 55  D_PARAMETER(NotU
4840: 73 65 64 29 3b 0a 20 20 61 73 73 65 72 74 28 20  sed);.  assert( 
4850: 70 63 61 63 68 65 31 2e 69 73 49 6e 69 74 21 3d  pcache1.isInit!=
4860: 30 20 29 3b 0a 20 20 6d 65 6d 73 65 74 28 26 70  0 );.  memset(&p
4870: 63 61 63 68 65 31 2c 20 30 2c 20 73 69 7a 65 6f  cache1, 0, sizeo
4880: 66 28 70 63 61 63 68 65 31 29 29 3b 0a 7d 0a 0a  f(pcache1));.}..
4890: 2f 2a 20 66 6f 72 77 61 72 64 20 64 65 63 6c 61  /* forward decla
48a0: 72 61 74 69 6f 6e 20 2a 2f 0a 73 74 61 74 69 63  ration */.static
48b0: 20 76 6f 69 64 20 70 63 61 63 68 65 31 44 65 73   void pcache1Des
48c0: 74 72 6f 79 28 73 71 6c 69 74 65 33 5f 70 63 61  troy(sqlite3_pca
48d0: 63 68 65 20 2a 70 29 3b 0a 0a 2f 2a 0a 2a 2a 20  che *p);../*.** 
48e0: 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  Implementation o
48f0: 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63  f the sqlite3_pc
4900: 61 63 68 65 2e 78 43 72 65 61 74 65 20 6d 65 74  ache.xCreate met
4910: 68 6f 64 2e 0a 2a 2a 0a 2a 2a 20 41 6c 6c 6f 63  hod..**.** Alloc
4920: 61 74 65 20 61 20 6e 65 77 20 63 61 63 68 65 2e  ate a new cache.
4930: 0a 2a 2f 0a 73 74 61 74 69 63 20 73 71 6c 69 74  .*/.static sqlit
4940: 65 33 5f 70 63 61 63 68 65 20 2a 70 63 61 63 68  e3_pcache *pcach
4950: 65 31 43 72 65 61 74 65 28 69 6e 74 20 73 7a 50  e1Create(int szP
4960: 61 67 65 2c 20 69 6e 74 20 73 7a 45 78 74 72 61  age, int szExtra
4970: 2c 20 69 6e 74 20 62 50 75 72 67 65 61 62 6c 65  , int bPurgeable
4980: 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43  ){.  PCache1 *pC
4990: 61 63 68 65 3b 20 20 20 20 20 20 2f 2a 20 54 68  ache;      /* Th
49a0: 65 20 6e 65 77 6c 79 20 63 72 65 61 74 65 64 20  e newly created 
49b0: 70 61 67 65 20 63 61 63 68 65 20 2a 2f 0a 20 20  page cache */.  
49c0: 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70 3b 20  PGroup *pGroup; 
49d0: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 67 72 6f        /* The gro
49e0: 75 70 20 74 68 65 20 6e 65 77 20 70 61 67 65 20  up the new page 
49f0: 63 61 63 68 65 20 77 69 6c 6c 20 62 65 6c 6f 6e  cache will belon
4a00: 67 20 74 6f 20 2a 2f 0a 20 20 69 6e 74 20 73 7a  g to */.  int sz
4a10: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
4a20: 2f 2a 20 42 79 74 65 73 20 6f 66 20 6d 65 6d 6f  /* Bytes of memo
4a30: 72 79 20 72 65 71 75 69 72 65 64 20 74 6f 20 61  ry required to a
4a40: 6c 6c 6f 63 61 74 65 20 74 68 65 20 6e 65 77 20  llocate the new 
4a50: 63 61 63 68 65 20 2a 2f 0a 0a 20 20 2f 2a 0a 20  cache */..  /*. 
4a60: 20 2a 2a 20 54 68 65 20 73 65 70 61 72 61 74 65   ** The separate
4a70: 43 61 63 68 65 20 76 61 72 69 61 62 6c 65 20 69  Cache variable i
4a80: 73 20 74 72 75 65 20 69 66 20 65 61 63 68 20 50  s true if each P
4a90: 43 61 63 68 65 20 68 61 73 20 69 74 73 20 6f 77  Cache has its ow
4aa0: 6e 20 70 72 69 76 61 74 65 0a 20 20 2a 2a 20 50  n private.  ** P
4ab0: 47 72 6f 75 70 2e 20 20 49 6e 20 6f 74 68 65 72  Group.  In other
4ac0: 20 77 6f 72 64 73 2c 20 73 65 70 61 72 61 74 65   words, separate
4ad0: 43 61 63 68 65 20 69 73 20 74 72 75 65 20 66 6f  Cache is true fo
4ae0: 72 20 6d 6f 64 65 20 28 31 29 20 77 68 65 72 65  r mode (1) where
4af0: 20 6e 6f 0a 20 20 2a 2a 20 6d 75 74 65 78 69 6e   no.  ** mutexin
4b00: 67 20 69 73 20 72 65 71 75 69 72 65 64 2e 0a 20  g is required.. 
4b10: 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 20 41 6c   **.  **   *  Al
4b20: 77 61 79 73 20 75 73 65 20 61 20 75 6e 69 66 69  ways use a unifi
4b30: 65 64 20 63 61 63 68 65 20 28 6d 6f 64 65 2d 32  ed cache (mode-2
4b40: 29 20 69 66 20 45 4e 41 42 4c 45 5f 4d 45 4d 4f  ) if ENABLE_MEMO
4b50: 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 20 20  RY_MANAGEMENT.  
4b60: 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 20 41 6c 77  **.  **   *  Alw
4b70: 61 79 73 20 75 73 65 20 61 20 75 6e 69 66 69 65  ays use a unifie
4b80: 64 20 63 61 63 68 65 20 69 6e 20 73 69 6e 67 6c  d cache in singl
4b90: 65 2d 74 68 72 65 61 64 65 64 20 61 70 70 6c 69  e-threaded appli
4ba0: 63 61 74 69 6f 6e 73 0a 20 20 2a 2a 0a 20 20 2a  cations.  **.  *
4bb0: 2a 20 20 20 2a 20 20 4f 74 68 65 72 77 69 73 65  *   *  Otherwise
4bc0: 20 28 69 66 20 6d 75 6c 74 69 2d 74 68 72 65 61   (if multi-threa
4bd0: 64 65 64 20 61 6e 64 20 45 4e 41 42 4c 45 5f 4d  ded and ENABLE_M
4be0: 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54  EMORY_MANAGEMENT
4bf0: 20 69 73 20 6f 66 66 29 0a 20 20 2a 2a 20 20 20   is off).  **   
4c00: 20 20 20 75 73 65 20 73 65 70 61 72 61 74 65 20     use separate 
4c10: 63 61 63 68 65 73 20 28 6d 6f 64 65 2d 31 29 0a  caches (mode-1).
4c20: 20 20 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64    */.#if defined
4c30: 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d  (SQLITE_ENABLE_M
4c40: 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54  EMORY_MANAGEMENT
4c50: 29 20 7c 7c 20 53 51 4c 49 54 45 5f 54 48 52 45  ) || SQLITE_THRE
4c60: 41 44 53 41 46 45 3d 3d 30 0a 20 20 63 6f 6e 73  ADSAFE==0.  cons
4c70: 74 20 69 6e 74 20 73 65 70 61 72 61 74 65 43 61  t int separateCa
4c80: 63 68 65 20 3d 20 30 3b 0a 23 65 6c 73 65 0a 20  che = 0;.#else. 
4c90: 20 69 6e 74 20 73 65 70 61 72 61 74 65 43 61 63   int separateCac
4ca0: 68 65 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62  he = sqlite3Glob
4cb0: 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75  alConfig.bCoreMu
4cc0: 74 65 78 3e 30 3b 0a 23 65 6e 64 69 66 0a 0a 20  tex>0;.#endif.. 
4cd0: 20 61 73 73 65 72 74 28 20 28 73 7a 50 61 67 65   assert( (szPage
4ce0: 20 26 20 28 73 7a 50 61 67 65 2d 31 29 29 3d 3d   & (szPage-1))==
4cf0: 30 20 26 26 20 73 7a 50 61 67 65 3e 3d 35 31 32  0 && szPage>=512
4d00: 20 26 26 20 73 7a 50 61 67 65 3c 3d 36 35 35 33   && szPage<=6553
4d10: 36 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73  6 );.  assert( s
4d20: 7a 45 78 74 72 61 20 3c 20 33 30 30 20 29 3b 0a  zExtra < 300 );.
4d30: 0a 20 20 73 7a 20 3d 20 73 69 7a 65 6f 66 28 50  .  sz = sizeof(P
4d40: 43 61 63 68 65 31 29 20 2b 20 73 69 7a 65 6f 66  Cache1) + sizeof
4d50: 28 50 47 72 6f 75 70 29 2a 73 65 70 61 72 61 74  (PGroup)*separat
4d60: 65 43 61 63 68 65 3b 0a 20 20 70 43 61 63 68 65  eCache;.  pCache
4d70: 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 73 71   = (PCache1 *)sq
4d80: 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28  lite3MallocZero(
4d90: 73 7a 29 3b 0a 20 20 69 66 28 20 70 43 61 63 68  sz);.  if( pCach
4da0: 65 20 29 7b 0a 20 20 20 20 69 66 28 20 73 65 70  e ){.    if( sep
4db0: 61 72 61 74 65 43 61 63 68 65 20 29 7b 0a 20 20  arateCache ){.  
4dc0: 20 20 20 20 70 47 72 6f 75 70 20 3d 20 28 50 47      pGroup = (PG
4dd0: 72 6f 75 70 2a 29 26 70 43 61 63 68 65 5b 31 5d  roup*)&pCache[1]
4de0: 3b 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e  ;.      pGroup->
4df0: 6d 78 50 69 6e 6e 65 64 20 3d 20 31 30 3b 0a 20  mxPinned = 10;. 
4e00: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
4e10: 70 47 72 6f 75 70 20 3d 20 26 70 63 61 63 68 65  pGroup = &pcache
4e20: 31 2e 67 72 70 3b 0a 20 20 20 20 7d 0a 20 20 20  1.grp;.    }.   
4e30: 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 20   pCache->pGroup 
4e40: 3d 20 70 47 72 6f 75 70 3b 0a 20 20 20 20 70 43  = pGroup;.    pC
4e50: 61 63 68 65 2d 3e 73 7a 50 61 67 65 20 3d 20 73  ache->szPage = s
4e60: 7a 50 61 67 65 3b 0a 20 20 20 20 70 43 61 63 68  zPage;.    pCach
4e70: 65 2d 3e 73 7a 45 78 74 72 61 20 3d 20 73 7a 45  e->szExtra = szE
4e80: 78 74 72 61 3b 0a 20 20 20 20 70 43 61 63 68 65  xtra;.    pCache
4e90: 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 3d 20 28  ->bPurgeable = (
4ea0: 62 50 75 72 67 65 61 62 6c 65 20 3f 20 31 20 3a  bPurgeable ? 1 :
4eb0: 20 30 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31   0);.    pcache1
4ec0: 45 6e 74 65 72 4d 75 74 65 78 28 70 47 72 6f 75  EnterMutex(pGrou
4ed0: 70 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 52  p);.    pcache1R
4ee0: 65 73 69 7a 65 48 61 73 68 28 70 43 61 63 68 65  esizeHash(pCache
4ef0: 29 3b 0a 20 20 20 20 69 66 28 20 62 50 75 72 67  );.    if( bPurg
4f00: 65 61 62 6c 65 20 29 7b 0a 20 20 20 20 20 20 70  eable ){.      p
4f10: 43 61 63 68 65 2d 3e 6e 4d 69 6e 20 3d 20 31 30  Cache->nMin = 10
4f20: 3b 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e  ;.      pGroup->
4f30: 6e 4d 69 6e 50 61 67 65 20 2b 3d 20 70 43 61 63  nMinPage += pCac
4f40: 68 65 2d 3e 6e 4d 69 6e 3b 0a 20 20 20 20 20 20  he->nMin;.      
4f50: 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64  pGroup->mxPinned
4f60: 20 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50   = pGroup->nMaxP
4f70: 61 67 65 20 2b 20 31 30 20 2d 20 70 47 72 6f 75  age + 10 - pGrou
4f80: 70 2d 3e 6e 4d 69 6e 50 61 67 65 3b 0a 20 20 20  p->nMinPage;.   
4f90: 20 7d 0a 20 20 20 20 70 63 61 63 68 65 31 4c 65   }.    pcache1Le
4fa0: 61 76 65 4d 75 74 65 78 28 70 47 72 6f 75 70 29  aveMutex(pGroup)
4fb0: 3b 0a 20 20 20 20 69 66 28 20 70 43 61 63 68 65  ;.    if( pCache
4fc0: 2d 3e 6e 48 61 73 68 3d 3d 30 20 29 7b 0a 20 20  ->nHash==0 ){.  
4fd0: 20 20 20 20 70 63 61 63 68 65 31 44 65 73 74 72      pcache1Destr
4fe0: 6f 79 28 28 73 71 6c 69 74 65 33 5f 70 63 61 63  oy((sqlite3_pcac
4ff0: 68 65 2a 29 70 43 61 63 68 65 29 3b 0a 20 20 20  he*)pCache);.   
5000: 20 20 20 70 43 61 63 68 65 20 3d 20 30 3b 0a 20     pCache = 0;. 
5010: 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72     }.  }.  retur
5020: 6e 20 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68  n (sqlite3_pcach
5030: 65 20 2a 29 70 43 61 63 68 65 3b 0a 7d 0a 0a 2f  e *)pCache;.}../
5040: 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74  *.** Implementat
5050: 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74  ion of the sqlit
5060: 65 33 5f 70 63 61 63 68 65 2e 78 43 61 63 68 65  e3_pcache.xCache
5070: 73 69 7a 65 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a  size method. .**
5080: 0a 2a 2a 20 43 6f 6e 66 69 67 75 72 65 20 74 68  .** Configure th
5090: 65 20 63 61 63 68 65 5f 73 69 7a 65 20 6c 69 6d  e cache_size lim
50a0: 69 74 20 66 6f 72 20 61 20 63 61 63 68 65 2e 0a  it for a cache..
50b0: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70  */.static void p
50c0: 63 61 63 68 65 31 43 61 63 68 65 73 69 7a 65 28  cache1Cachesize(
50d0: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a  sqlite3_pcache *
50e0: 70 2c 20 69 6e 74 20 6e 4d 61 78 29 7b 0a 20 20  p, int nMax){.  
50f0: 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 20  PCache1 *pCache 
5100: 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b 0a  = (PCache1 *)p;.
5110: 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e 62 50    if( pCache->bP
5120: 75 72 67 65 61 62 6c 65 20 29 7b 0a 20 20 20 20  urgeable ){.    
5130: 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70 20 3d  PGroup *pGroup =
5140: 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3b   pCache->pGroup;
5150: 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e 74 65  .    pcache1Ente
5160: 72 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a  rMutex(pGroup);.
5170: 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78      pGroup->nMax
5180: 50 61 67 65 20 2b 3d 20 28 6e 4d 61 78 20 2d 20  Page += (nMax - 
5190: 70 43 61 63 68 65 2d 3e 6e 4d 61 78 29 3b 0a 20  pCache->nMax);. 
51a0: 20 20 20 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e     pGroup->mxPin
51b0: 6e 65 64 20 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d  ned = pGroup->nM
51c0: 61 78 50 61 67 65 20 2b 20 31 30 20 2d 20 70 47  axPage + 10 - pG
51d0: 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 3b 0a  roup->nMinPage;.
51e0: 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78      pCache->nMax
51f0: 20 3d 20 6e 4d 61 78 3b 0a 20 20 20 20 70 43 61   = nMax;.    pCa
5200: 63 68 65 2d 3e 6e 39 30 70 63 74 20 3d 20 70 43  che->n90pct = pC
5210: 61 63 68 65 2d 3e 6e 4d 61 78 2a 39 2f 31 30 3b  ache->nMax*9/10;
5220: 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e 66 6f  .    pcache1Enfo
5230: 72 63 65 4d 61 78 50 61 67 65 28 70 47 72 6f 75  rceMaxPage(pGrou
5240: 70 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 4c  p);.    pcache1L
5250: 65 61 76 65 4d 75 74 65 78 28 70 47 72 6f 75 70  eaveMutex(pGroup
5260: 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  );.  }.}../*.** 
5270: 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  Implementation o
5280: 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63  f the sqlite3_pc
5290: 61 63 68 65 2e 78 53 68 72 69 6e 6b 20 6d 65 74  ache.xShrink met
52a0: 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 46 72 65 65  hod. .**.** Free
52b0: 20 75 70 20 61 73 20 6d 75 63 68 20 6d 65 6d 6f   up as much memo
52c0: 72 79 20 61 73 20 70 6f 73 73 69 62 6c 65 2e 0a  ry as possible..
52d0: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70  */.static void p
52e0: 63 61 63 68 65 31 53 68 72 69 6e 6b 28 73 71 6c  cache1Shrink(sql
52f0: 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 29 7b  ite3_pcache *p){
5300: 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63  .  PCache1 *pCac
5310: 68 65 20 3d 20 28 50 43 61 63 68 65 31 2a 29 70  he = (PCache1*)p
5320: 3b 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e  ;.  if( pCache->
5330: 62 50 75 72 67 65 61 62 6c 65 20 29 7b 0a 20 20  bPurgeable ){.  
5340: 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70    PGroup *pGroup
5350: 20 3d 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75   = pCache->pGrou
5360: 70 3b 0a 20 20 20 20 69 6e 74 20 73 61 76 65 64  p;.    int saved
5370: 4d 61 78 50 61 67 65 3b 0a 20 20 20 20 70 63 61  MaxPage;.    pca
5380: 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70  che1EnterMutex(p
5390: 47 72 6f 75 70 29 3b 0a 20 20 20 20 73 61 76 65  Group);.    save
53a0: 64 4d 61 78 50 61 67 65 20 3d 20 70 47 72 6f 75  dMaxPage = pGrou
53b0: 70 2d 3e 6e 4d 61 78 50 61 67 65 3b 0a 20 20 20  p->nMaxPage;.   
53c0: 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67   pGroup->nMaxPag
53d0: 65 20 3d 20 30 3b 0a 20 20 20 20 70 63 61 63 68  e = 0;.    pcach
53e0: 65 31 45 6e 66 6f 72 63 65 4d 61 78 50 61 67 65  e1EnforceMaxPage
53f0: 28 70 47 72 6f 75 70 29 3b 0a 20 20 20 20 70 47  (pGroup);.    pG
5400: 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 3d  roup->nMaxPage =
5410: 20 73 61 76 65 64 4d 61 78 50 61 67 65 3b 0a 20   savedMaxPage;. 
5420: 20 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d     pcache1LeaveM
5430: 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20 20  utex(pGroup);.  
5440: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65  }.}../*.** Imple
5450: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65  mentation of the
5460: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e   sqlite3_pcache.
5470: 78 50 61 67 65 63 6f 75 6e 74 20 6d 65 74 68 6f  xPagecount metho
5480: 64 2e 20 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  d. .*/.static in
5490: 74 20 70 63 61 63 68 65 31 50 61 67 65 63 6f 75  t pcache1Pagecou
54a0: 6e 74 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68  nt(sqlite3_pcach
54b0: 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 6e 3b 0a  e *p){.  int n;.
54c0: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68    PCache1 *pCach
54d0: 65 20 3d 20 28 50 43 61 63 68 65 31 2a 29 70 3b  e = (PCache1*)p;
54e0: 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d  .  pcache1EnterM
54f0: 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72  utex(pCache->pGr
5500: 6f 75 70 29 3b 0a 20 20 6e 20 3d 20 70 43 61 63  oup);.  n = pCac
5510: 68 65 2d 3e 6e 50 61 67 65 3b 0a 20 20 70 63 61  he->nPage;.  pca
5520: 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70  che1LeaveMutex(p
5530: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a  Cache->pGroup);.
5540: 20 20 72 65 74 75 72 6e 20 6e 3b 0a 7d 0a 0a 0a    return n;.}...
5550: 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 20  /*.** Implement 
5560: 73 74 65 70 73 20 33 2c 20 34 2c 20 61 6e 64 20  steps 3, 4, and 
5570: 35 20 6f 66 20 74 68 65 20 70 63 61 63 68 65 31  5 of the pcache1
5580: 46 65 74 63 68 28 29 20 61 6c 67 6f 72 69 74 68  Fetch() algorith
5590: 6d 20 64 65 73 63 72 69 62 65 64 0a 2a 2a 20 69  m described.** i
55a0: 6e 20 74 68 65 20 68 65 61 64 65 72 20 6f 66 20  n the header of 
55b0: 74 68 65 20 70 63 61 63 68 65 31 46 65 74 63 68  the pcache1Fetch
55c0: 28 29 20 70 72 6f 63 65 64 75 72 65 2e 0a 2a 2a  () procedure..**
55d0: 0a 2a 2a 20 54 68 69 73 20 73 74 65 70 73 20 61  .** This steps a
55e0: 72 65 20 62 72 6f 6b 65 6e 20 6f 75 74 20 69 6e  re broken out in
55f0: 74 6f 20 61 20 73 65 70 61 72 61 74 65 20 70 72  to a separate pr
5600: 6f 63 65 64 75 72 65 20 62 65 63 61 75 73 65 20  ocedure because 
5610: 74 68 65 79 20 61 72 65 0a 2a 2a 20 75 73 75 61  they are.** usua
5620: 6c 6c 79 20 6e 6f 74 20 6e 65 65 64 65 64 2c 20  lly not needed, 
5630: 61 6e 64 20 62 79 20 61 76 6f 69 64 69 6e 67 20  and by avoiding 
5640: 74 68 65 20 73 74 61 63 6b 20 69 6e 69 74 69 61  the stack initia
5650: 6c 69 7a 61 74 69 6f 6e 20 72 65 71 75 69 72 65  lization require
5660: 64 0a 2a 2a 20 66 6f 72 20 74 68 65 73 65 20 73  d.** for these s
5670: 74 65 70 73 2c 20 74 68 65 20 6d 61 69 6e 20 70  teps, the main p
5680: 63 61 63 68 65 31 46 65 74 63 68 28 29 20 70 72  cache1Fetch() pr
5690: 6f 63 65 64 75 72 65 20 63 61 6e 20 72 75 6e 20  ocedure can run 
56a0: 66 61 73 74 65 72 2e 0a 2a 2f 0a 73 74 61 74 69  faster..*/.stati
56b0: 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e  c SQLITE_NOINLIN
56c0: 45 20 50 67 48 64 72 31 20 2a 70 63 61 63 68 65  E PgHdr1 *pcache
56d0: 31 46 65 74 63 68 53 74 61 67 65 32 28 0a 20 20  1FetchStage2(.  
56e0: 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 2c  PCache1 *pCache,
56f0: 20 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74   .  unsigned int
5700: 20 69 4b 65 79 2c 20 0a 20 20 69 6e 74 20 63 72   iKey, .  int cr
5710: 65 61 74 65 46 6c 61 67 0a 29 7b 0a 20 20 75 6e  eateFlag.){.  un
5720: 73 69 67 6e 65 64 20 69 6e 74 20 6e 50 69 6e 6e  signed int nPinn
5730: 65 64 3b 0a 20 20 50 47 72 6f 75 70 20 2a 70 47  ed;.  PGroup *pG
5740: 72 6f 75 70 20 3d 20 70 43 61 63 68 65 2d 3e 70  roup = pCache->p
5750: 47 72 6f 75 70 3b 0a 20 20 50 67 48 64 72 31 20  Group;.  PgHdr1 
5760: 2a 70 50 61 67 65 20 3d 20 30 3b 0a 0a 20 20 2f  *pPage = 0;..  /
5770: 2a 20 53 74 65 70 20 33 3a 20 41 62 6f 72 74 20  * Step 3: Abort 
5780: 69 66 20 63 72 65 61 74 65 46 6c 61 67 20 69 73  if createFlag is
5790: 20 31 20 62 75 74 20 74 68 65 20 63 61 63 68 65   1 but the cache
57a0: 20 69 73 20 6e 65 61 72 6c 79 20 66 75 6c 6c 20   is nearly full 
57b0: 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 43 61  */.  assert( pCa
57c0: 63 68 65 2d 3e 6e 50 61 67 65 20 3e 3d 20 70 43  che->nPage >= pC
57d0: 61 63 68 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c  ache->nRecyclabl
57e0: 65 20 29 3b 0a 20 20 6e 50 69 6e 6e 65 64 20 3d  e );.  nPinned =
57f0: 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 20 2d   pCache->nPage -
5800: 20 70 43 61 63 68 65 2d 3e 6e 52 65 63 79 63 6c   pCache->nRecycl
5810: 61 62 6c 65 3b 0a 20 20 61 73 73 65 72 74 28 20  able;.  assert( 
5820: 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64  pGroup->mxPinned
5830: 20 3d 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78   == pGroup->nMax
5840: 50 61 67 65 20 2b 20 31 30 20 2d 20 70 47 72 6f  Page + 10 - pGro
5850: 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 20 29 3b 0a  up->nMinPage );.
5860: 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65    assert( pCache
5870: 2d 3e 6e 39 30 70 63 74 20 3d 3d 20 70 43 61 63  ->n90pct == pCac
5880: 68 65 2d 3e 6e 4d 61 78 2a 39 2f 31 30 20 29 3b  he->nMax*9/10 );
5890: 0a 20 20 69 66 28 20 63 72 65 61 74 65 46 6c 61  .  if( createFla
58a0: 67 3d 3d 31 20 26 26 20 28 0a 20 20 20 20 20 20  g==1 && (.      
58b0: 20 20 6e 50 69 6e 6e 65 64 3e 3d 70 47 72 6f 75    nPinned>=pGrou
58c0: 70 2d 3e 6d 78 50 69 6e 6e 65 64 0a 20 20 20 20  p->mxPinned.    
58d0: 20 7c 7c 20 6e 50 69 6e 6e 65 64 3e 3d 70 43 61   || nPinned>=pCa
58e0: 63 68 65 2d 3e 6e 39 30 70 63 74 0a 20 20 20 20  che->n90pct.    
58f0: 20 7c 7c 20 28 70 63 61 63 68 65 31 55 6e 64 65   || (pcache1Unde
5900: 72 4d 65 6d 6f 72 79 50 72 65 73 73 75 72 65 28  rMemoryPressure(
5910: 70 43 61 63 68 65 29 20 26 26 20 70 43 61 63 68  pCache) && pCach
5920: 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65 3c 6e  e->nRecyclable<n
5930: 50 69 6e 6e 65 64 29 0a 20 20 29 29 7b 0a 20 20  Pinned).  )){.  
5940: 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a    return 0;.  }.
5950: 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e 6e  .  if( pCache->n
5960: 50 61 67 65 3e 3d 70 43 61 63 68 65 2d 3e 6e 48  Page>=pCache->nH
5970: 61 73 68 20 29 20 70 63 61 63 68 65 31 52 65 73  ash ) pcache1Res
5980: 69 7a 65 48 61 73 68 28 70 43 61 63 68 65 29 3b  izeHash(pCache);
5990: 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68  .  assert( pCach
59a0: 65 2d 3e 6e 48 61 73 68 3e 30 20 26 26 20 70 43  e->nHash>0 && pC
59b0: 61 63 68 65 2d 3e 61 70 48 61 73 68 20 29 3b 0a  ache->apHash );.
59c0: 0a 20 20 2f 2a 20 53 74 65 70 20 34 2e 20 54 72  .  /* Step 4. Tr
59d0: 79 20 74 6f 20 72 65 63 79 63 6c 65 20 61 20 70  y to recycle a p
59e0: 61 67 65 2e 20 2a 2f 0a 20 20 69 66 28 20 70 43  age. */.  if( pC
59f0: 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65  ache->bPurgeable
5a00: 20 26 26 20 70 47 72 6f 75 70 2d 3e 70 4c 72 75   && pGroup->pLru
5a10: 54 61 69 6c 20 26 26 20 28 0a 20 20 20 20 20 20  Tail && (.      
5a20: 20 20 20 28 70 43 61 63 68 65 2d 3e 6e 50 61 67     (pCache->nPag
5a30: 65 2b 31 3e 3d 70 43 61 63 68 65 2d 3e 6e 4d 61  e+1>=pCache->nMa
5a40: 78 29 0a 20 20 20 20 20 20 7c 7c 20 70 47 72 6f  x).      || pGro
5a50: 75 70 2d 3e 6e 43 75 72 72 65 6e 74 50 61 67 65  up->nCurrentPage
5a60: 3e 3d 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61  >=pGroup->nMaxPa
5a70: 67 65 0a 20 20 20 20 20 20 7c 7c 20 70 63 61 63  ge.      || pcac
5a80: 68 65 31 55 6e 64 65 72 4d 65 6d 6f 72 79 50 72  he1UnderMemoryPr
5a90: 65 73 73 75 72 65 28 70 43 61 63 68 65 29 0a 20  essure(pCache). 
5aa0: 20 29 29 7b 0a 20 20 20 20 50 43 61 63 68 65 31   )){.    PCache1
5ab0: 20 2a 70 4f 74 68 65 72 3b 0a 20 20 20 20 70 50   *pOther;.    pP
5ac0: 61 67 65 20 3d 20 70 47 72 6f 75 70 2d 3e 70 4c  age = pGroup->pL
5ad0: 72 75 54 61 69 6c 3b 0a 20 20 20 20 61 73 73 65  ruTail;.    asse
5ae0: 72 74 28 20 70 50 61 67 65 2d 3e 69 73 50 69 6e  rt( pPage->isPin
5af0: 6e 65 64 3d 3d 30 20 29 3b 0a 20 20 20 20 70 63  ned==0 );.    pc
5b00: 61 63 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48  ache1RemoveFromH
5b10: 61 73 68 28 70 50 61 67 65 29 3b 0a 20 20 20 20  ash(pPage);.    
5b20: 70 63 61 63 68 65 31 50 69 6e 50 61 67 65 28 70  pcache1PinPage(p
5b30: 50 61 67 65 29 3b 0a 20 20 20 20 70 4f 74 68 65  Page);.    pOthe
5b40: 72 20 3d 20 70 50 61 67 65 2d 3e 70 43 61 63 68  r = pPage->pCach
5b50: 65 3b 0a 0a 20 20 20 20 2f 2a 20 57 65 20 77 61  e;..    /* We wa
5b60: 6e 74 20 74 6f 20 76 65 72 69 66 79 20 74 68 61  nt to verify tha
5b70: 74 20 73 7a 50 61 67 65 20 61 6e 64 20 73 7a 45  t szPage and szE
5b80: 78 74 72 61 20 61 72 65 20 74 68 65 20 73 61 6d  xtra are the sam
5b90: 65 20 66 6f 72 20 70 4f 74 68 65 72 0a 20 20 20  e for pOther.   
5ba0: 20 2a 2a 20 61 6e 64 20 70 43 61 63 68 65 2e 20   ** and pCache. 
5bb0: 20 41 73 73 65 72 74 20 74 68 61 74 20 77 65 20   Assert that we 
5bc0: 63 61 6e 20 76 65 72 69 66 79 20 74 68 69 73 20  can verify this 
5bd0: 62 79 20 63 6f 6d 70 61 72 69 6e 67 20 73 75 6d  by comparing sum
5be0: 73 2e 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74  s. */.    assert
5bf0: 28 20 28 70 43 61 63 68 65 2d 3e 73 7a 50 61 67  ( (pCache->szPag
5c00: 65 20 26 20 28 70 43 61 63 68 65 2d 3e 73 7a 50  e & (pCache->szP
5c10: 61 67 65 2d 31 29 29 3d 3d 30 20 26 26 20 70 43  age-1))==0 && pC
5c20: 61 63 68 65 2d 3e 73 7a 50 61 67 65 3e 3d 35 31  ache->szPage>=51
5c30: 32 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28  2 );.    assert(
5c40: 20 70 43 61 63 68 65 2d 3e 73 7a 45 78 74 72 61   pCache->szExtra
5c50: 3c 35 31 32 20 29 3b 0a 20 20 20 20 61 73 73 65  <512 );.    asse
5c60: 72 74 28 20 28 70 4f 74 68 65 72 2d 3e 73 7a 50  rt( (pOther->szP
5c70: 61 67 65 20 26 20 28 70 4f 74 68 65 72 2d 3e 73  age & (pOther->s
5c80: 7a 50 61 67 65 2d 31 29 29 3d 3d 30 20 26 26 20  zPage-1))==0 && 
5c90: 70 4f 74 68 65 72 2d 3e 73 7a 50 61 67 65 3e 3d  pOther->szPage>=
5ca0: 35 31 32 20 29 3b 0a 20 20 20 20 61 73 73 65 72  512 );.    asser
5cb0: 74 28 20 70 4f 74 68 65 72 2d 3e 73 7a 45 78 74  t( pOther->szExt
5cc0: 72 61 3c 35 31 32 20 29 3b 0a 0a 20 20 20 20 69  ra<512 );..    i
5cd0: 66 28 20 70 4f 74 68 65 72 2d 3e 73 7a 50 61 67  f( pOther->szPag
5ce0: 65 2b 70 4f 74 68 65 72 2d 3e 73 7a 45 78 74 72  e+pOther->szExtr
5cf0: 61 20 21 3d 20 70 43 61 63 68 65 2d 3e 73 7a 50  a != pCache->szP
5d00: 61 67 65 2b 70 43 61 63 68 65 2d 3e 73 7a 45 78  age+pCache->szEx
5d10: 74 72 61 20 29 7b 0a 20 20 20 20 20 20 70 63 61  tra ){.      pca
5d20: 63 68 65 31 46 72 65 65 50 61 67 65 28 70 50 61  che1FreePage(pPa
5d30: 67 65 29 3b 0a 20 20 20 20 20 20 70 50 61 67 65  ge);.      pPage
5d40: 20 3d 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65 7b   = 0;.    }else{
5d50: 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e  .      pGroup->n
5d60: 43 75 72 72 65 6e 74 50 61 67 65 20 2d 3d 20 28  CurrentPage -= (
5d70: 70 4f 74 68 65 72 2d 3e 62 50 75 72 67 65 61 62  pOther->bPurgeab
5d80: 6c 65 20 2d 20 70 43 61 63 68 65 2d 3e 62 50 75  le - pCache->bPu
5d90: 72 67 65 61 62 6c 65 29 3b 0a 20 20 20 20 7d 0a  rgeable);.    }.
5da0: 20 20 7d 0a 0a 20 20 2f 2a 20 53 74 65 70 20 35    }..  /* Step 5
5db0: 2e 20 49 66 20 61 20 75 73 61 62 6c 65 20 70 61  . If a usable pa
5dc0: 67 65 20 62 75 66 66 65 72 20 68 61 73 20 73 74  ge buffer has st
5dd0: 69 6c 6c 20 6e 6f 74 20 62 65 65 6e 20 66 6f 75  ill not been fou
5de0: 6e 64 2c 20 0a 20 20 2a 2a 20 61 74 74 65 6d 70  nd, .  ** attemp
5df0: 74 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 61 20  t to allocate a 
5e00: 6e 65 77 20 6f 6e 65 2e 20 0a 20 20 2a 2f 0a 20  new one. .  */. 
5e10: 20 69 66 28 20 21 70 50 61 67 65 20 29 7b 0a 20   if( !pPage ){. 
5e20: 20 20 20 69 66 28 20 63 72 65 61 74 65 46 6c 61     if( createFla
5e30: 67 3d 3d 31 20 29 20 73 71 6c 69 74 65 33 42 65  g==1 ) sqlite3Be
5e40: 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28  ginBenignMalloc(
5e50: 29 3b 0a 20 20 20 20 70 50 61 67 65 20 3d 20 70  );.    pPage = p
5e60: 63 61 63 68 65 31 41 6c 6c 6f 63 50 61 67 65 28  cache1AllocPage(
5e70: 70 43 61 63 68 65 29 3b 0a 20 20 20 20 69 66 28  pCache);.    if(
5e80: 20 63 72 65 61 74 65 46 6c 61 67 3d 3d 31 20 29   createFlag==1 )
5e90: 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 67   sqlite3EndBenig
5ea0: 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 7d 0a 0a  nMalloc();.  }..
5eb0: 20 20 69 66 28 20 70 50 61 67 65 20 29 7b 0a 20    if( pPage ){. 
5ec0: 20 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20     unsigned int 
5ed0: 68 20 3d 20 69 4b 65 79 20 25 20 70 43 61 63 68  h = iKey % pCach
5ee0: 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 20 20 70 43  e->nHash;.    pC
5ef0: 61 63 68 65 2d 3e 6e 50 61 67 65 2b 2b 3b 0a 20  ache->nPage++;. 
5f00: 20 20 20 70 50 61 67 65 2d 3e 69 4b 65 79 20 3d     pPage->iKey =
5f10: 20 69 4b 65 79 3b 0a 20 20 20 20 70 50 61 67 65   iKey;.    pPage
5f20: 2d 3e 70 4e 65 78 74 20 3d 20 70 43 61 63 68 65  ->pNext = pCache
5f30: 2d 3e 61 70 48 61 73 68 5b 68 5d 3b 0a 20 20 20  ->apHash[h];.   
5f40: 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65 20 3d   pPage->pCache =
5f50: 20 70 43 61 63 68 65 3b 0a 20 20 20 20 70 50 61   pCache;.    pPa
5f60: 67 65 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20 30  ge->pLruPrev = 0
5f70: 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 70 4c 72  ;.    pPage->pLr
5f80: 75 4e 65 78 74 20 3d 20 30 3b 0a 20 20 20 20 70  uNext = 0;.    p
5f90: 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64 20 3d  Page->isPinned =
5fa0: 20 31 3b 0a 20 20 20 20 2a 28 76 6f 69 64 20 2a   1;.    *(void *
5fb0: 2a 29 70 50 61 67 65 2d 3e 70 61 67 65 2e 70 45  *)pPage->page.pE
5fc0: 78 74 72 61 20 3d 20 30 3b 0a 20 20 20 20 70 43  xtra = 0;.    pC
5fd0: 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 20  ache->apHash[h] 
5fe0: 3d 20 70 50 61 67 65 3b 0a 20 20 20 20 69 66 28  = pPage;.    if(
5ff0: 20 69 4b 65 79 3e 70 43 61 63 68 65 2d 3e 69 4d   iKey>pCache->iM
6000: 61 78 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 70  axKey ){.      p
6010: 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 3d  Cache->iMaxKey =
6020: 20 69 4b 65 79 3b 0a 20 20 20 20 7d 0a 20 20 7d   iKey;.    }.  }
6030: 0a 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 3b  .  return pPage;
6040: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d  .}../*.** Implem
6050: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20  entation of the 
6060: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78  sqlite3_pcache.x
6070: 46 65 74 63 68 20 6d 65 74 68 6f 64 2e 20 0a 2a  Fetch method. .*
6080: 2a 0a 2a 2a 20 46 65 74 63 68 20 61 20 70 61 67  *.** Fetch a pag
6090: 65 20 62 79 20 6b 65 79 20 76 61 6c 75 65 2e 0a  e by key value..
60a0: 2a 2a 0a 2a 2a 20 57 68 65 74 68 65 72 20 6f 72  **.** Whether or
60b0: 20 6e 6f 74 20 61 20 6e 65 77 20 70 61 67 65 20   not a new page 
60c0: 6d 61 79 20 62 65 20 61 6c 6c 6f 63 61 74 65 64  may be allocated
60d0: 20 62 79 20 74 68 69 73 20 66 75 6e 63 74 69 6f   by this functio
60e0: 6e 20 64 65 70 65 6e 64 73 20 6f 6e 0a 2a 2a 20  n depends on.** 
60f0: 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65  the value of the
6100: 20 63 72 65 61 74 65 46 6c 61 67 20 61 72 67 75   createFlag argu
6110: 6d 65 6e 74 2e 20 20 30 20 6d 65 61 6e 73 20 64  ment.  0 means d
6120: 6f 20 6e 6f 74 20 61 6c 6c 6f 63 61 74 65 20 61  o not allocate a
6130: 20 6e 65 77 0a 2a 2a 20 70 61 67 65 2e 20 20 31   new.** page.  1
6140: 20 6d 65 61 6e 73 20 61 6c 6c 6f 63 61 74 65 20   means allocate 
6150: 61 20 6e 65 77 20 70 61 67 65 20 69 66 20 73 70  a new page if sp
6160: 61 63 65 20 69 73 20 65 61 73 69 6c 79 20 61 76  ace is easily av
6170: 61 69 6c 61 62 6c 65 2e 20 20 32 20 0a 2a 2a 20  ailable.  2 .** 
6180: 6d 65 61 6e 73 20 74 6f 20 74 72 79 20 72 65 61  means to try rea
6190: 6c 6c 79 20 68 61 72 64 20 74 6f 20 61 6c 6c 6f  lly hard to allo
61a0: 63 61 74 65 20 61 20 6e 65 77 20 70 61 67 65 2e  cate a new page.
61b0: 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 61 20 6e 6f 6e  .**.** For a non
61c0: 2d 70 75 72 67 65 61 62 6c 65 20 63 61 63 68 65  -purgeable cache
61d0: 20 28 61 20 63 61 63 68 65 20 75 73 65 64 20 61   (a cache used a
61e0: 73 20 74 68 65 20 73 74 6f 72 61 67 65 20 66 6f  s the storage fo
61f0: 72 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 0a 2a  r an in-memory.*
6200: 2a 20 64 61 74 61 62 61 73 65 29 20 74 68 65 72  * database) ther
6210: 65 20 69 73 20 72 65 61 6c 6c 79 20 6e 6f 20 64  e is really no d
6220: 69 66 66 65 72 65 6e 63 65 20 62 65 74 77 65 65  ifference betwee
6230: 6e 20 63 72 65 61 74 65 46 6c 61 67 20 31 20 61  n createFlag 1 a
6240: 6e 64 20 32 2e 20 20 53 6f 0a 2a 2a 20 74 68 65  nd 2.  So.** the
6250: 20 63 61 6c 6c 69 6e 67 20 66 75 6e 63 74 69 6f   calling functio
6260: 6e 20 28 70 63 61 63 68 65 2e 63 29 20 77 69 6c  n (pcache.c) wil
6270: 6c 20 6e 65 76 65 72 20 68 61 76 65 20 61 20 63  l never have a c
6280: 72 65 61 74 65 46 6c 61 67 20 6f 66 20 31 20 6f  reateFlag of 1 o
6290: 6e 0a 2a 2a 20 61 20 6e 6f 6e 2d 70 75 72 67 65  n.** a non-purge
62a0: 61 62 6c 65 20 63 61 63 68 65 2e 0a 2a 2a 0a 2a  able cache..**.*
62b0: 2a 20 54 68 65 72 65 20 61 72 65 20 74 68 72 65  * There are thre
62c0: 65 20 64 69 66 66 65 72 65 6e 74 20 61 70 70 72  e different appr
62d0: 6f 61 63 68 65 73 20 74 6f 20 6f 62 74 61 69 6e  oaches to obtain
62e0: 69 6e 67 20 73 70 61 63 65 20 66 6f 72 20 61 20  ing space for a 
62f0: 70 61 67 65 2c 0a 2a 2a 20 64 65 70 65 6e 64 69  page,.** dependi
6300: 6e 67 20 6f 6e 20 74 68 65 20 76 61 6c 75 65 20  ng on the value 
6310: 6f 66 20 70 61 72 61 6d 65 74 65 72 20 63 72 65  of parameter cre
6320: 61 74 65 46 6c 61 67 20 28 77 68 69 63 68 20 6d  ateFlag (which m
6330: 61 79 20 62 65 20 30 2c 20 31 20 6f 72 20 32 29  ay be 0, 1 or 2)
6340: 2e 0a 2a 2a 0a 2a 2a 20 20 20 31 2e 20 52 65 67  ..**.**   1. Reg
6350: 61 72 64 6c 65 73 73 20 6f 66 20 74 68 65 20 76  ardless of the v
6360: 61 6c 75 65 20 6f 66 20 63 72 65 61 74 65 46 6c  alue of createFl
6370: 61 67 2c 20 74 68 65 20 63 61 63 68 65 20 69 73  ag, the cache is
6380: 20 73 65 61 72 63 68 65 64 20 66 6f 72 20 61 20   searched for a 
6390: 0a 2a 2a 20 20 20 20 20 20 63 6f 70 79 20 6f 66  .**      copy of
63a0: 20 74 68 65 20 72 65 71 75 65 73 74 65 64 20 70   the requested p
63b0: 61 67 65 2e 20 49 66 20 6f 6e 65 20 69 73 20 66  age. If one is f
63c0: 6f 75 6e 64 2c 20 69 74 20 69 73 20 72 65 74 75  ound, it is retu
63d0: 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 20 20 32 2e  rned..**.**   2.
63e0: 20 49 66 20 63 72 65 61 74 65 46 6c 61 67 3d 3d   If createFlag==
63f0: 30 20 61 6e 64 20 74 68 65 20 70 61 67 65 20 69  0 and the page i
6400: 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 69 6e  s not already in
6410: 20 74 68 65 20 63 61 63 68 65 2c 20 4e 55 4c 4c   the cache, NULL
6420: 20 69 73 0a 2a 2a 20 20 20 20 20 20 72 65 74 75   is.**      retu
6430: 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 20 20 33 2e  rned..**.**   3.
6440: 20 49 66 20 63 72 65 61 74 65 46 6c 61 67 20 69   If createFlag i
6450: 73 20 31 2c 20 61 6e 64 20 74 68 65 20 70 61 67  s 1, and the pag
6460: 65 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79  e is not already
6470: 20 69 6e 20 74 68 65 20 63 61 63 68 65 2c 20 74   in the cache, t
6480: 68 65 6e 0a 2a 2a 20 20 20 20 20 20 72 65 74 75  hen.**      retu
6490: 72 6e 20 4e 55 4c 4c 20 28 64 6f 20 6e 6f 74 20  rn NULL (do not 
64a0: 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 70  allocate a new p
64b0: 61 67 65 29 20 69 66 20 61 6e 79 20 6f 66 20 74  age) if any of t
64c0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 2a 2a 20  he following.** 
64d0: 20 20 20 20 20 63 6f 6e 64 69 74 69 6f 6e 73 20       conditions 
64e0: 61 72 65 20 74 72 75 65 3a 0a 2a 2a 0a 2a 2a 20  are true:.**.** 
64f0: 20 20 20 20 20 20 28 61 29 20 74 68 65 20 6e 75        (a) the nu
6500: 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 70 69  mber of pages pi
6510: 6e 6e 65 64 20 62 79 20 74 68 65 20 63 61 63 68  nned by the cach
6520: 65 20 69 73 20 67 72 65 61 74 65 72 20 74 68 61  e is greater tha
6530: 6e 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 50  n.**           P
6540: 43 61 63 68 65 31 2e 6e 4d 61 78 2c 20 6f 72 0a  Cache1.nMax, or.
6550: 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 28 62 29 20  **.**       (b) 
6560: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61  the number of pa
6570: 67 65 73 20 70 69 6e 6e 65 64 20 62 79 20 74 68  ges pinned by th
6580: 65 20 63 61 63 68 65 20 69 73 20 67 72 65 61 74  e cache is great
6590: 65 72 20 74 68 61 6e 0a 2a 2a 20 20 20 20 20 20  er than.**      
65a0: 20 20 20 20 20 74 68 65 20 73 75 6d 20 6f 66 20       the sum of 
65b0: 6e 4d 61 78 20 66 6f 72 20 61 6c 6c 20 70 75 72  nMax for all pur
65c0: 67 65 61 62 6c 65 20 63 61 63 68 65 73 2c 20 6c  geable caches, l
65d0: 65 73 73 20 74 68 65 20 73 75 6d 20 6f 66 20 0a  ess the sum of .
65e0: 2a 2a 20 20 20 20 20 20 20 20 20 20 20 6e 4d 69  **           nMi
65f0: 6e 20 66 6f 72 20 61 6c 6c 20 6f 74 68 65 72 20  n for all other 
6600: 70 75 72 67 65 61 62 6c 65 20 63 61 63 68 65 73  purgeable caches
6610: 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 20 20 34 2e 20  , or.**.**   4. 
6620: 49 66 20 6e 6f 6e 65 20 6f 66 20 74 68 65 20 66  If none of the f
6630: 69 72 73 74 20 74 68 72 65 65 20 63 6f 6e 64 69  irst three condi
6640: 74 69 6f 6e 73 20 61 70 70 6c 79 20 61 6e 64 20  tions apply and 
6650: 74 68 65 20 63 61 63 68 65 20 69 73 20 6d 61 72  the cache is mar
6660: 6b 65 64 0a 2a 2a 20 20 20 20 20 20 61 73 20 70  ked.**      as p
6670: 75 72 67 65 61 62 6c 65 2c 20 61 6e 64 20 69 66  urgeable, and if
6680: 20 6f 6e 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c   one of the foll
6690: 6f 77 69 6e 67 20 69 73 20 74 72 75 65 3a 0a 2a  owing is true:.*
66a0: 2a 0a 2a 2a 20 20 20 20 20 20 20 28 61 29 20 54  *.**       (a) T
66b0: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67  he number of pag
66c0: 65 73 20 61 6c 6c 6f 63 61 74 65 64 20 66 6f 72  es allocated for
66d0: 20 74 68 65 20 63 61 63 68 65 20 69 73 20 61 6c   the cache is al
66e0: 72 65 61 64 79 20 0a 2a 2a 20 20 20 20 20 20 20  ready .**       
66f0: 20 20 20 20 50 43 61 63 68 65 31 2e 6e 4d 61 78      PCache1.nMax
6700: 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20  , or.**.**      
6710: 20 28 62 29 20 54 68 65 20 6e 75 6d 62 65 72 20   (b) The number 
6720: 6f 66 20 70 61 67 65 73 20 61 6c 6c 6f 63 61 74  of pages allocat
6730: 65 64 20 66 6f 72 20 61 6c 6c 20 70 75 72 67 65  ed for all purge
6740: 61 62 6c 65 20 63 61 63 68 65 73 20 69 73 0a 2a  able caches is.*
6750: 2a 20 20 20 20 20 20 20 20 20 20 20 61 6c 72 65  *           alre
6760: 61 64 79 20 65 71 75 61 6c 20 74 6f 20 6f 72 20  ady equal to or 
6770: 67 72 65 61 74 65 72 20 74 68 61 6e 20 74 68 65  greater than the
6780: 20 73 75 6d 20 6f 66 20 6e 4d 61 78 20 66 6f 72   sum of nMax for
6790: 20 61 6c 6c 0a 2a 2a 20 20 20 20 20 20 20 20 20   all.**         
67a0: 20 20 70 75 72 67 65 61 62 6c 65 20 63 61 63 68    purgeable cach
67b0: 65 73 2c 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20  es,.**.**       
67c0: 28 63 29 20 54 68 65 20 73 79 73 74 65 6d 20 69  (c) The system i
67d0: 73 20 75 6e 64 65 72 20 6d 65 6d 6f 72 79 20 70  s under memory p
67e0: 72 65 73 73 75 72 65 20 61 6e 64 20 77 61 6e 74  ressure and want
67f0: 73 20 74 6f 20 61 76 6f 69 64 0a 2a 2a 20 20 20  s to avoid.**   
6800: 20 20 20 20 20 20 20 20 75 6e 6e 65 63 65 73 73          unnecess
6810: 61 72 79 20 70 61 67 65 73 20 63 61 63 68 65 20  ary pages cache 
6820: 65 6e 74 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e  entry allocation
6830: 73 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 74 68 65  s.**.**      the
6840: 6e 20 61 74 74 65 6d 70 74 20 74 6f 20 72 65 63  n attempt to rec
6850: 79 63 6c 65 20 61 20 70 61 67 65 20 66 72 6f 6d  ycle a page from
6860: 20 74 68 65 20 4c 52 55 20 6c 69 73 74 2e 20 49   the LRU list. I
6870: 66 20 69 74 20 69 73 20 74 68 65 20 72 69 67 68  f it is the righ
6880: 74 0a 2a 2a 20 20 20 20 20 20 73 69 7a 65 2c 20  t.**      size, 
6890: 72 65 74 75 72 6e 20 74 68 65 20 72 65 63 79 63  return the recyc
68a0: 6c 65 64 20 62 75 66 66 65 72 2e 20 4f 74 68 65  led buffer. Othe
68b0: 72 77 69 73 65 2c 20 66 72 65 65 20 74 68 65 20  rwise, free the 
68c0: 62 75 66 66 65 72 20 61 6e 64 0a 2a 2a 20 20 20  buffer and.**   
68d0: 20 20 20 70 72 6f 63 65 65 64 20 74 6f 20 73 74     proceed to st
68e0: 65 70 20 35 2e 20 0a 2a 2a 0a 2a 2a 20 20 20 35  ep 5. .**.**   5
68f0: 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 61 6c 6c  . Otherwise, all
6900: 6f 63 61 74 65 20 61 6e 64 20 72 65 74 75 72 6e  ocate and return
6910: 20 61 20 6e 65 77 20 70 61 67 65 20 62 75 66 66   a new page buff
6920: 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 72 65 20  er..**.** There 
6930: 61 72 65 20 74 77 6f 20 76 65 72 73 69 6f 6e 73  are two versions
6940: 20 6f 66 20 74 68 69 73 20 72 6f 75 74 69 6e 65   of this routine
6950: 2e 20 20 70 63 61 63 68 65 31 46 65 74 63 68 57  .  pcache1FetchW
6960: 69 74 68 4d 75 74 65 78 28 29 20 69 73 0a 2a 2a  ithMutex() is.**
6970: 20 74 68 65 20 67 65 6e 65 72 61 6c 20 63 61 73   the general cas
6980: 65 2e 20 20 70 63 61 63 68 65 31 46 65 74 63 68  e.  pcache1Fetch
6990: 4e 6f 4d 75 74 65 78 28 29 20 69 73 20 61 20 66  NoMutex() is a f
69a0: 61 73 74 65 72 20 69 6d 70 6c 65 6d 65 6e 74 61  aster implementa
69b0: 74 69 6f 6e 20 66 6f 72 0a 2a 2a 20 74 68 65 20  tion for.** the 
69c0: 63 6f 6d 6d 6f 6e 20 63 61 73 65 20 77 68 65 72  common case wher
69d0: 65 20 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 20  e pGroup->mutex 
69e0: 69 73 20 4e 55 4c 4c 2e 20 20 54 68 65 20 70 63  is NULL.  The pc
69f0: 61 63 68 65 31 46 65 74 63 68 28 29 20 77 72 61  ache1Fetch() wra
6a00: 70 70 65 72 0a 2a 2a 20 69 6e 76 6f 6b 65 73 20  pper.** invokes 
6a10: 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 20  the appropriate 
6a20: 72 6f 75 74 69 6e 65 2e 0a 2a 2f 0a 73 74 61 74  routine..*/.stat
6a30: 69 63 20 50 67 48 64 72 31 20 2a 70 63 61 63 68  ic PgHdr1 *pcach
6a40: 65 31 46 65 74 63 68 4e 6f 4d 75 74 65 78 28 0a  e1FetchNoMutex(.
6a50: 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65    sqlite3_pcache
6a60: 20 2a 70 2c 20 0a 20 20 75 6e 73 69 67 6e 65 64   *p, .  unsigned
6a70: 20 69 6e 74 20 69 4b 65 79 2c 20 0a 20 20 69 6e   int iKey, .  in
6a80: 74 20 63 72 65 61 74 65 46 6c 61 67 0a 29 7b 0a  t createFlag.){.
6a90: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68    PCache1 *pCach
6aa0: 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70  e = (PCache1 *)p
6ab0: 3b 0a 20 20 50 67 48 64 72 31 20 2a 70 50 61 67  ;.  PgHdr1 *pPag
6ac0: 65 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20 53 74 65  e = 0;..  /* Ste
6ad0: 70 20 31 3a 20 53 65 61 72 63 68 20 74 68 65 20  p 1: Search the 
6ae0: 68 61 73 68 20 74 61 62 6c 65 20 66 6f 72 20 61  hash table for a
6af0: 6e 20 65 78 69 73 74 69 6e 67 20 65 6e 74 72 79  n existing entry
6b00: 2e 20 2a 2f 0a 20 20 70 50 61 67 65 20 3d 20 70  . */.  pPage = p
6b10: 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 69 4b  Cache->apHash[iK
6b20: 65 79 20 25 20 70 43 61 63 68 65 2d 3e 6e 48 61  ey % pCache->nHa
6b30: 73 68 5d 3b 0a 20 20 77 68 69 6c 65 28 20 70 50  sh];.  while( pP
6b40: 61 67 65 20 26 26 20 70 50 61 67 65 2d 3e 69 4b  age && pPage->iK
6b50: 65 79 21 3d 69 4b 65 79 20 29 7b 20 70 50 61 67  ey!=iKey ){ pPag
6b60: 65 20 3d 20 70 50 61 67 65 2d 3e 70 4e 65 78 74  e = pPage->pNext
6b70: 3b 20 7d 0a 0a 20 20 2f 2a 20 53 74 65 70 20 32  ; }..  /* Step 2
6b80: 3a 20 41 62 6f 72 74 20 69 66 20 6e 6f 20 65 78  : Abort if no ex
6b90: 69 73 74 69 6e 67 20 70 61 67 65 20 69 73 20 66  isting page is f
6ba0: 6f 75 6e 64 20 61 6e 64 20 63 72 65 61 74 65 46  ound and createF
6bb0: 6c 61 67 20 69 73 20 30 20 2a 2f 0a 20 20 69 66  lag is 0 */.  if
6bc0: 28 20 70 50 61 67 65 20 29 7b 0a 20 20 20 20 69  ( pPage ){.    i
6bd0: 66 28 20 21 70 50 61 67 65 2d 3e 69 73 50 69 6e  f( !pPage->isPin
6be0: 6e 65 64 20 29 7b 0a 20 20 20 20 20 20 72 65 74  ned ){.      ret
6bf0: 75 72 6e 20 70 63 61 63 68 65 31 50 69 6e 50 61  urn pcache1PinPa
6c00: 67 65 28 70 50 61 67 65 29 3b 0a 20 20 20 20 7d  ge(pPage);.    }
6c10: 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 65 74 75  else{.      retu
6c20: 72 6e 20 70 50 61 67 65 3b 0a 20 20 20 20 7d 0a  rn pPage;.    }.
6c30: 20 20 7d 65 6c 73 65 20 69 66 28 20 63 72 65 61    }else if( crea
6c40: 74 65 46 6c 61 67 20 29 7b 0a 20 20 20 20 2f 2a  teFlag ){.    /*
6c50: 20 53 74 65 70 73 20 33 2c 20 34 2c 20 61 6e 64   Steps 3, 4, and
6c60: 20 35 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62   5 implemented b
6c70: 79 20 74 68 69 73 20 73 75 62 72 6f 75 74 69 6e  y this subroutin
6c80: 65 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e 20  e */.    return 
6c90: 70 63 61 63 68 65 31 46 65 74 63 68 53 74 61 67  pcache1FetchStag
6ca0: 65 32 28 70 43 61 63 68 65 2c 20 69 4b 65 79 2c  e2(pCache, iKey,
6cb0: 20 63 72 65 61 74 65 46 6c 61 67 29 3b 0a 20 20   createFlag);.  
6cc0: 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72  }else{.    retur
6cd0: 6e 20 30 3b 0a 20 20 7d 0a 7d 0a 73 74 61 74 69  n 0;.  }.}.stati
6ce0: 63 20 50 67 48 64 72 31 20 2a 70 63 61 63 68 65  c PgHdr1 *pcache
6cf0: 31 46 65 74 63 68 57 69 74 68 4d 75 74 65 78 28  1FetchWithMutex(
6d00: 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68  .  sqlite3_pcach
6d10: 65 20 2a 70 2c 20 0a 20 20 75 6e 73 69 67 6e 65  e *p, .  unsigne
6d20: 64 20 69 6e 74 20 69 4b 65 79 2c 20 0a 20 20 69  d int iKey, .  i
6d30: 6e 74 20 63 72 65 61 74 65 46 6c 61 67 0a 29 7b  nt createFlag.){
6d40: 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63  .  PCache1 *pCac
6d50: 68 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29  he = (PCache1 *)
6d60: 70 3b 0a 20 20 50 67 48 64 72 31 20 2a 70 50 61  p;.  PgHdr1 *pPa
6d70: 67 65 3b 0a 0a 20 20 70 63 61 63 68 65 31 45 6e  ge;..  pcache1En
6d80: 74 65 72 4d 75 74 65 78 28 70 43 61 63 68 65 2d  terMutex(pCache-
6d90: 3e 70 47 72 6f 75 70 29 3b 0a 20 20 70 50 61 67  >pGroup);.  pPag
6da0: 65 20 3d 20 70 63 61 63 68 65 31 46 65 74 63 68  e = pcache1Fetch
6db0: 4e 6f 4d 75 74 65 78 28 70 2c 20 69 4b 65 79 2c  NoMutex(p, iKey,
6dc0: 20 63 72 65 61 74 65 46 6c 61 67 29 3b 0a 20 20   createFlag);.  
6dd0: 61 73 73 65 72 74 28 20 70 50 61 67 65 3d 3d 30  assert( pPage==0
6de0: 20 7c 7c 20 70 43 61 63 68 65 2d 3e 69 4d 61 78   || pCache->iMax
6df0: 4b 65 79 3e 3d 69 4b 65 79 20 29 3b 0a 20 20 70  Key>=iKey );.  p
6e00: 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78  cache1LeaveMutex
6e10: 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29  (pCache->pGroup)
6e20: 3b 0a 20 20 72 65 74 75 72 6e 20 70 50 61 67 65  ;.  return pPage
6e30: 3b 0a 7d 0a 73 74 61 74 69 63 20 73 71 6c 69 74  ;.}.static sqlit
6e40: 65 33 5f 70 63 61 63 68 65 5f 70 61 67 65 20 2a  e3_pcache_page *
6e50: 70 63 61 63 68 65 31 46 65 74 63 68 28 0a 20 20  pcache1Fetch(.  
6e60: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a  sqlite3_pcache *
6e70: 70 2c 20 0a 20 20 75 6e 73 69 67 6e 65 64 20 69  p, .  unsigned i
6e80: 6e 74 20 69 4b 65 79 2c 20 0a 20 20 69 6e 74 20  nt iKey, .  int 
6e90: 63 72 65 61 74 65 46 6c 61 67 0a 29 7b 0a 20 20  createFlag.){.  
6ea0: 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 20  PCache1 *pCache 
6eb0: 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b 0a  = (PCache1 *)p;.
6ec0: 0a 20 20 61 73 73 65 72 74 28 20 6f 66 66 73 65  .  assert( offse
6ed0: 74 6f 66 28 50 67 48 64 72 31 2c 70 61 67 65 29  tof(PgHdr1,page)
6ee0: 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28  ==0 );.  assert(
6ef0: 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61   pCache->bPurgea
6f00: 62 6c 65 20 7c 7c 20 63 72 65 61 74 65 46 6c 61  ble || createFla
6f10: 67 21 3d 31 20 29 3b 0a 20 20 61 73 73 65 72 74  g!=1 );.  assert
6f20: 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65  ( pCache->bPurge
6f30: 61 62 6c 65 20 7c 7c 20 70 43 61 63 68 65 2d 3e  able || pCache->
6f40: 6e 4d 69 6e 3d 3d 30 20 29 3b 0a 20 20 61 73 73  nMin==0 );.  ass
6f50: 65 72 74 28 20 70 43 61 63 68 65 2d 3e 62 50 75  ert( pCache->bPu
6f60: 72 67 65 61 62 6c 65 3d 3d 30 20 7c 7c 20 70 43  rgeable==0 || pC
6f70: 61 63 68 65 2d 3e 6e 4d 69 6e 3d 3d 31 30 20 29  ache->nMin==10 )
6f80: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63  ;.  assert( pCac
6f90: 68 65 2d 3e 6e 4d 69 6e 3d 3d 30 20 7c 7c 20 70  he->nMin==0 || p
6fa0: 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c  Cache->bPurgeabl
6fb0: 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  e );.  assert( p
6fc0: 43 61 63 68 65 2d 3e 6e 48 61 73 68 3e 30 20 29  Cache->nHash>0 )
6fd0: 3b 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e  ;.  if( pCache->
6fe0: 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 20 29 7b  pGroup->mutex ){
6ff0: 0a 20 20 20 20 72 65 74 75 72 6e 20 28 73 71 6c  .    return (sql
7000: 69 74 65 33 5f 70 63 61 63 68 65 5f 70 61 67 65  ite3_pcache_page
7010: 2a 29 70 63 61 63 68 65 31 46 65 74 63 68 57 69  *)pcache1FetchWi
7020: 74 68 4d 75 74 65 78 28 70 2c 20 69 4b 65 79 2c  thMutex(p, iKey,
7030: 20 63 72 65 61 74 65 46 6c 61 67 29 3b 0a 20 20   createFlag);.  
7040: 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72  }else{.    retur
7050: 6e 20 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68  n (sqlite3_pcach
7060: 65 5f 70 61 67 65 2a 29 70 63 61 63 68 65 31 46  e_page*)pcache1F
7070: 65 74 63 68 4e 6f 4d 75 74 65 78 28 70 2c 20 69  etchNoMutex(p, i
7080: 4b 65 79 2c 20 63 72 65 61 74 65 46 6c 61 67 29  Key, createFlag)
7090: 3b 0a 20 20 7d 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20  ;.  }.}.../*.** 
70a0: 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  Implementation o
70b0: 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63  f the sqlite3_pc
70c0: 61 63 68 65 2e 78 55 6e 70 69 6e 20 6d 65 74 68  ache.xUnpin meth
70d0: 6f 64 2e 0a 2a 2a 0a 2a 2a 20 4d 61 72 6b 20 61  od..**.** Mark a
70e0: 20 70 61 67 65 20 61 73 20 75 6e 70 69 6e 6e 65   page as unpinne
70f0: 64 20 28 65 6c 69 67 69 62 6c 65 20 66 6f 72 20  d (eligible for 
7100: 61 73 79 6e 63 68 72 6f 6e 6f 75 73 20 72 65 63  asynchronous rec
7110: 79 63 6c 69 6e 67 29 2e 0a 2a 2f 0a 73 74 61 74  ycling)..*/.stat
7120: 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 55  ic void pcache1U
7130: 6e 70 69 6e 28 0a 20 20 73 71 6c 69 74 65 33 5f  npin(.  sqlite3_
7140: 70 63 61 63 68 65 20 2a 70 2c 20 0a 20 20 73 71  pcache *p, .  sq
7150: 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 70 61 67  lite3_pcache_pag
7160: 65 20 2a 70 50 67 2c 20 0a 20 20 69 6e 74 20 72  e *pPg, .  int r
7170: 65 75 73 65 55 6e 6c 69 6b 65 6c 79 0a 29 7b 0a  euseUnlikely.){.
7180: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68    PCache1 *pCach
7190: 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70  e = (PCache1 *)p
71a0: 3b 0a 20 20 50 67 48 64 72 31 20 2a 70 50 61 67  ;.  PgHdr1 *pPag
71b0: 65 20 3d 20 28 50 67 48 64 72 31 20 2a 29 70 50  e = (PgHdr1 *)pP
71c0: 67 3b 0a 20 20 50 47 72 6f 75 70 20 2a 70 47 72  g;.  PGroup *pGr
71d0: 6f 75 70 20 3d 20 70 43 61 63 68 65 2d 3e 70 47  oup = pCache->pG
71e0: 72 6f 75 70 3b 0a 20 0a 20 20 61 73 73 65 72 74  roup;. .  assert
71f0: 28 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65 3d  ( pPage->pCache=
7200: 3d 70 43 61 63 68 65 20 29 3b 0a 20 20 70 63 61  =pCache );.  pca
7210: 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70  che1EnterMutex(p
7220: 47 72 6f 75 70 29 3b 0a 0a 20 20 2f 2a 20 49 74  Group);..  /* It
7230: 20 69 73 20 61 6e 20 65 72 72 6f 72 20 74 6f 20   is an error to 
7240: 63 61 6c 6c 20 74 68 69 73 20 66 75 6e 63 74 69  call this functi
7250: 6f 6e 20 69 66 20 74 68 65 20 70 61 67 65 20 69  on if the page i
7260: 73 20 61 6c 72 65 61 64 79 20 0a 20 20 2a 2a 20  s already .  ** 
7270: 70 61 72 74 20 6f 66 20 74 68 65 20 50 47 72 6f  part of the PGro
7280: 75 70 20 4c 52 55 20 6c 69 73 74 2e 0a 20 20 2a  up LRU list..  *
7290: 2f 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67  /.  assert( pPag
72a0: 65 2d 3e 70 4c 72 75 50 72 65 76 3d 3d 30 20 26  e->pLruPrev==0 &
72b0: 26 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78  & pPage->pLruNex
72c0: 74 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74  t==0 );.  assert
72d0: 28 20 70 47 72 6f 75 70 2d 3e 70 4c 72 75 48 65  ( pGroup->pLruHe
72e0: 61 64 21 3d 70 50 61 67 65 20 26 26 20 70 47 72  ad!=pPage && pGr
72f0: 6f 75 70 2d 3e 70 4c 72 75 54 61 69 6c 21 3d 70  oup->pLruTail!=p
7300: 50 61 67 65 20 29 3b 0a 20 20 61 73 73 65 72 74  Page );.  assert
7310: 28 20 70 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65  ( pPage->isPinne
7320: 64 3d 3d 31 20 29 3b 0a 0a 20 20 69 66 28 20 72  d==1 );..  if( r
7330: 65 75 73 65 55 6e 6c 69 6b 65 6c 79 20 7c 7c 20  euseUnlikely || 
7340: 70 47 72 6f 75 70 2d 3e 6e 43 75 72 72 65 6e 74  pGroup->nCurrent
7350: 50 61 67 65 3e 70 47 72 6f 75 70 2d 3e 6e 4d 61  Page>pGroup->nMa
7360: 78 50 61 67 65 20 29 7b 0a 20 20 20 20 70 63 61  xPage ){.    pca
7370: 63 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61  che1RemoveFromHa
7380: 73 68 28 70 50 61 67 65 29 3b 0a 20 20 20 20 70  sh(pPage);.    p
7390: 63 61 63 68 65 31 46 72 65 65 50 61 67 65 28 70  cache1FreePage(p
73a0: 50 61 67 65 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a  Page);.  }else{.
73b0: 20 20 20 20 2f 2a 20 41 64 64 20 74 68 65 20 70      /* Add the p
73c0: 61 67 65 20 74 6f 20 74 68 65 20 50 47 72 6f 75  age to the PGrou
73d0: 70 20 4c 52 55 20 6c 69 73 74 2e 20 2a 2f 0a 20  p LRU list. */. 
73e0: 20 20 20 69 66 28 20 70 47 72 6f 75 70 2d 3e 70     if( pGroup->p
73f0: 4c 72 75 48 65 61 64 20 29 7b 0a 20 20 20 20 20  LruHead ){.     
7400: 20 70 47 72 6f 75 70 2d 3e 70 4c 72 75 48 65 61   pGroup->pLruHea
7410: 64 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20 70 50  d->pLruPrev = pP
7420: 61 67 65 3b 0a 20 20 20 20 20 20 70 50 61 67 65  age;.      pPage
7430: 2d 3e 70 4c 72 75 4e 65 78 74 20 3d 20 70 47 72  ->pLruNext = pGr
7440: 6f 75 70 2d 3e 70 4c 72 75 48 65 61 64 3b 0a 20  oup->pLruHead;. 
7450: 20 20 20 20 20 70 47 72 6f 75 70 2d 3e 70 4c 72       pGroup->pLr
7460: 75 48 65 61 64 20 3d 20 70 50 61 67 65 3b 0a 20  uHead = pPage;. 
7470: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
7480: 70 47 72 6f 75 70 2d 3e 70 4c 72 75 54 61 69 6c  pGroup->pLruTail
7490: 20 3d 20 70 50 61 67 65 3b 0a 20 20 20 20 20 20   = pPage;.      
74a0: 70 47 72 6f 75 70 2d 3e 70 4c 72 75 48 65 61 64  pGroup->pLruHead
74b0: 20 3d 20 70 50 61 67 65 3b 0a 20 20 20 20 7d 0a   = pPage;.    }.
74c0: 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 52 65 63      pCache->nRec
74d0: 79 63 6c 61 62 6c 65 2b 2b 3b 0a 20 20 20 20 70  yclable++;.    p
74e0: 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64 20 3d  Page->isPinned =
74f0: 20 30 3b 0a 20 20 7d 0a 0a 20 20 70 63 61 63 68   0;.  }..  pcach
7500: 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70 43 61  e1LeaveMutex(pCa
7510: 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 7d 0a  che->pGroup);.}.
7520: 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74  ./*.** Implement
7530: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c  ation of the sql
7540: 69 74 65 33 5f 70 63 61 63 68 65 2e 78 52 65 6b  ite3_pcache.xRek
7550: 65 79 20 6d 65 74 68 6f 64 2e 20 0a 2a 2f 0a 73  ey method. .*/.s
7560: 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68  tatic void pcach
7570: 65 31 52 65 6b 65 79 28 0a 20 20 73 71 6c 69 74  e1Rekey(.  sqlit
7580: 65 33 5f 70 63 61 63 68 65 20 2a 70 2c 0a 20 20  e3_pcache *p,.  
7590: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 70  sqlite3_pcache_p
75a0: 61 67 65 20 2a 70 50 67 2c 0a 20 20 75 6e 73 69  age *pPg,.  unsi
75b0: 67 6e 65 64 20 69 6e 74 20 69 4f 6c 64 2c 0a 20  gned int iOld,. 
75c0: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4e   unsigned int iN
75d0: 65 77 0a 29 7b 0a 20 20 50 43 61 63 68 65 31 20  ew.){.  PCache1 
75e0: 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61 63 68  *pCache = (PCach
75f0: 65 31 20 2a 29 70 3b 0a 20 20 50 67 48 64 72 31  e1 *)p;.  PgHdr1
7600: 20 2a 70 50 61 67 65 20 3d 20 28 50 67 48 64 72   *pPage = (PgHdr
7610: 31 20 2a 29 70 50 67 3b 0a 20 20 50 67 48 64 72  1 *)pPg;.  PgHdr
7620: 31 20 2a 2a 70 70 3b 0a 20 20 75 6e 73 69 67 6e  1 **pp;.  unsign
7630: 65 64 20 69 6e 74 20 68 3b 20 0a 20 20 61 73 73  ed int h; .  ass
7640: 65 72 74 28 20 70 50 61 67 65 2d 3e 69 4b 65 79  ert( pPage->iKey
7650: 3d 3d 69 4f 6c 64 20 29 3b 0a 20 20 61 73 73 65  ==iOld );.  asse
7660: 72 74 28 20 70 50 61 67 65 2d 3e 70 43 61 63 68  rt( pPage->pCach
7670: 65 3d 3d 70 43 61 63 68 65 20 29 3b 0a 0a 20 20  e==pCache );..  
7680: 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65  pcache1EnterMute
7690: 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70  x(pCache->pGroup
76a0: 29 3b 0a 0a 20 20 68 20 3d 20 69 4f 6c 64 25 70  );..  h = iOld%p
76b0: 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20  Cache->nHash;.  
76c0: 70 70 20 3d 20 26 70 43 61 63 68 65 2d 3e 61 70  pp = &pCache->ap
76d0: 48 61 73 68 5b 68 5d 3b 0a 20 20 77 68 69 6c 65  Hash[h];.  while
76e0: 28 20 28 2a 70 70 29 21 3d 70 50 61 67 65 20 29  ( (*pp)!=pPage )
76f0: 7b 0a 20 20 20 20 70 70 20 3d 20 26 28 2a 70 70  {.    pp = &(*pp
7700: 29 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d 0a 20 20  )->pNext;.  }.  
7710: 2a 70 70 20 3d 20 70 50 61 67 65 2d 3e 70 4e 65  *pp = pPage->pNe
7720: 78 74 3b 0a 0a 20 20 68 20 3d 20 69 4e 65 77 25  xt;..  h = iNew%
7730: 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20  pCache->nHash;. 
7740: 20 70 50 61 67 65 2d 3e 69 4b 65 79 20 3d 20 69   pPage->iKey = i
7750: 4e 65 77 3b 0a 20 20 70 50 61 67 65 2d 3e 70 4e  New;.  pPage->pN
7760: 65 78 74 20 3d 20 70 43 61 63 68 65 2d 3e 61 70  ext = pCache->ap
7770: 48 61 73 68 5b 68 5d 3b 0a 20 20 70 43 61 63 68  Hash[h];.  pCach
7780: 65 2d 3e 61 70 48 61 73 68 5b 68 5d 20 3d 20 70  e->apHash[h] = p
7790: 50 61 67 65 3b 0a 20 20 69 66 28 20 69 4e 65 77  Page;.  if( iNew
77a0: 3e 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79  >pCache->iMaxKey
77b0: 20 29 7b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e   ){.    pCache->
77c0: 69 4d 61 78 4b 65 79 20 3d 20 69 4e 65 77 3b 0a  iMaxKey = iNew;.
77d0: 20 20 7d 0a 0a 20 20 70 63 61 63 68 65 31 4c 65    }..  pcache1Le
77e0: 61 76 65 4d 75 74 65 78 28 70 43 61 63 68 65 2d  aveMutex(pCache-
77f0: 3e 70 47 72 6f 75 70 29 3b 0a 7d 0a 0a 2f 2a 0a  >pGroup);.}../*.
7800: 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  ** Implementatio
7810: 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33  n of the sqlite3
7820: 5f 70 63 61 63 68 65 2e 78 54 72 75 6e 63 61 74  _pcache.xTruncat
7830: 65 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a  e method. .**.**
7840: 20 44 69 73 63 61 72 64 20 61 6c 6c 20 75 6e 70   Discard all unp
7850: 69 6e 6e 65 64 20 70 61 67 65 73 20 69 6e 20 74  inned pages in t
7860: 68 65 20 63 61 63 68 65 20 77 69 74 68 20 61 20  he cache with a 
7870: 70 61 67 65 20 6e 75 6d 62 65 72 20 65 71 75 61  page number equa
7880: 6c 20 74 6f 0a 2a 2a 20 6f 72 20 67 72 65 61 74  l to.** or great
7890: 65 72 20 74 68 61 6e 20 70 61 72 61 6d 65 74 65  er than paramete
78a0: 72 20 69 4c 69 6d 69 74 2e 20 41 6e 79 20 70 69  r iLimit. Any pi
78b0: 6e 6e 65 64 20 70 61 67 65 73 20 77 69 74 68 20  nned pages with 
78c0: 61 20 70 61 67 65 20 6e 75 6d 62 65 72 0a 2a 2a  a page number.**
78d0: 20 65 71 75 61 6c 20 74 6f 20 6f 72 20 67 72 65   equal to or gre
78e0: 61 74 65 72 20 74 68 61 6e 20 69 4c 69 6d 69 74  ater than iLimit
78f0: 20 61 72 65 20 69 6d 70 6c 69 63 69 74 6c 79 20   are implicitly 
7900: 75 6e 70 69 6e 6e 65 64 2e 0a 2a 2f 0a 73 74 61  unpinned..*/.sta
7910: 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31  tic void pcache1
7920: 54 72 75 6e 63 61 74 65 28 73 71 6c 69 74 65 33  Truncate(sqlite3
7930: 5f 70 63 61 63 68 65 20 2a 70 2c 20 75 6e 73 69  _pcache *p, unsi
7940: 67 6e 65 64 20 69 6e 74 20 69 4c 69 6d 69 74 29  gned int iLimit)
7950: 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61  {.  PCache1 *pCa
7960: 63 68 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a  che = (PCache1 *
7970: 29 70 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 74  )p;.  pcache1Ent
7980: 65 72 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e  erMutex(pCache->
7990: 70 47 72 6f 75 70 29 3b 0a 20 20 69 66 28 20 69  pGroup);.  if( i
79a0: 4c 69 6d 69 74 3c 3d 70 43 61 63 68 65 2d 3e 69  Limit<=pCache->i
79b0: 4d 61 78 4b 65 79 20 29 7b 0a 20 20 20 20 70 63  MaxKey ){.    pc
79c0: 61 63 68 65 31 54 72 75 6e 63 61 74 65 55 6e 73  ache1TruncateUns
79d0: 61 66 65 28 70 43 61 63 68 65 2c 20 69 4c 69 6d  afe(pCache, iLim
79e0: 69 74 29 3b 0a 20 20 20 20 70 43 61 63 68 65 2d  it);.    pCache-
79f0: 3e 69 4d 61 78 4b 65 79 20 3d 20 69 4c 69 6d 69  >iMaxKey = iLimi
7a00: 74 2d 31 3b 0a 20 20 7d 0a 20 20 70 63 61 63 68  t-1;.  }.  pcach
7a10: 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70 43 61  e1LeaveMutex(pCa
7a20: 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 7d 0a  che->pGroup);.}.
7a30: 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74  ./*.** Implement
7a40: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c  ation of the sql
7a50: 69 74 65 33 5f 70 63 61 63 68 65 2e 78 44 65 73  ite3_pcache.xDes
7a60: 74 72 6f 79 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a  troy method. .**
7a70: 0a 2a 2a 20 44 65 73 74 72 6f 79 20 61 20 63 61  .** Destroy a ca
7a80: 63 68 65 20 61 6c 6c 6f 63 61 74 65 64 20 75 73  che allocated us
7a90: 69 6e 67 20 70 63 61 63 68 65 31 43 72 65 61 74  ing pcache1Creat
7aa0: 65 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  e()..*/.static v
7ab0: 6f 69 64 20 70 63 61 63 68 65 31 44 65 73 74 72  oid pcache1Destr
7ac0: 6f 79 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68  oy(sqlite3_pcach
7ad0: 65 20 2a 70 29 7b 0a 20 20 50 43 61 63 68 65 31  e *p){.  PCache1
7ae0: 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61 63   *pCache = (PCac
7af0: 68 65 31 20 2a 29 70 3b 0a 20 20 50 47 72 6f 75  he1 *)p;.  PGrou
7b00: 70 20 2a 70 47 72 6f 75 70 20 3d 20 70 43 61 63  p *pGroup = pCac
7b10: 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20 20 61 73  he->pGroup;.  as
7b20: 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 62 50  sert( pCache->bP
7b30: 75 72 67 65 61 62 6c 65 20 7c 7c 20 28 70 43 61  urgeable || (pCa
7b40: 63 68 65 2d 3e 6e 4d 61 78 3d 3d 30 20 26 26 20  che->nMax==0 && 
7b50: 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 3d 3d 30 29  pCache->nMin==0)
7b60: 20 29 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 74   );.  pcache1Ent
7b70: 65 72 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b  erMutex(pGroup);
7b80: 0a 20 20 70 63 61 63 68 65 31 54 72 75 6e 63 61  .  pcache1Trunca
7b90: 74 65 55 6e 73 61 66 65 28 70 43 61 63 68 65 2c  teUnsafe(pCache,
7ba0: 20 30 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70   0);.  assert( p
7bb0: 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20  Group->nMaxPage 
7bc0: 3e 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 20  >= pCache->nMax 
7bd0: 29 3b 0a 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 61  );.  pGroup->nMa
7be0: 78 50 61 67 65 20 2d 3d 20 70 43 61 63 68 65 2d  xPage -= pCache-
7bf0: 3e 6e 4d 61 78 3b 0a 20 20 61 73 73 65 72 74 28  >nMax;.  assert(
7c00: 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67   pGroup->nMinPag
7c10: 65 20 3e 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 69  e >= pCache->nMi
7c20: 6e 20 29 3b 0a 20 20 70 47 72 6f 75 70 2d 3e 6e  n );.  pGroup->n
7c30: 4d 69 6e 50 61 67 65 20 2d 3d 20 70 43 61 63 68  MinPage -= pCach
7c40: 65 2d 3e 6e 4d 69 6e 3b 0a 20 20 70 47 72 6f 75  e->nMin;.  pGrou
7c50: 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 20 70 47  p->mxPinned = pG
7c60: 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 2b  roup->nMaxPage +
7c70: 20 31 30 20 2d 20 70 47 72 6f 75 70 2d 3e 6e 4d   10 - pGroup->nM
7c80: 69 6e 50 61 67 65 3b 0a 20 20 70 63 61 63 68 65  inPage;.  pcache
7c90: 31 45 6e 66 6f 72 63 65 4d 61 78 50 61 67 65 28  1EnforceMaxPage(
7ca0: 70 47 72 6f 75 70 29 3b 0a 20 20 70 63 61 63 68  pGroup);.  pcach
7cb0: 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70 47 72  e1LeaveMutex(pGr
7cc0: 6f 75 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f  oup);.  sqlite3_
7cd0: 66 72 65 65 28 70 43 61 63 68 65 2d 3e 61 70 48  free(pCache->apH
7ce0: 61 73 68 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f  ash);.  sqlite3_
7cf0: 66 72 65 65 28 70 43 61 63 68 65 29 3b 0a 7d 0a  free(pCache);.}.
7d00: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63  ./*.** This func
7d10: 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 64  tion is called d
7d20: 75 72 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a 61  uring initializa
7d30: 74 69 6f 6e 20 28 73 71 6c 69 74 65 33 5f 69 6e  tion (sqlite3_in
7d40: 69 74 69 61 6c 69 7a 65 28 29 29 20 74 6f 0a 2a  itialize()) to.*
7d50: 2a 20 69 6e 73 74 61 6c 6c 20 74 68 65 20 64 65  * install the de
7d60: 66 61 75 6c 74 20 70 6c 75 67 67 61 62 6c 65 20  fault pluggable 
7d70: 63 61 63 68 65 20 6d 6f 64 75 6c 65 2c 20 61 73  cache module, as
7d80: 73 75 6d 69 6e 67 20 74 68 65 20 75 73 65 72 20  suming the user 
7d90: 68 61 73 20 6e 6f 74 0a 2a 2a 20 61 6c 72 65 61  has not.** alrea
7da0: 64 79 20 70 72 6f 76 69 64 65 64 20 61 6e 20 61  dy provided an a
7db0: 6c 74 65 72 6e 61 74 69 76 65 2e 0a 2a 2f 0a 76  lternative..*/.v
7dc0: 6f 69 64 20 73 71 6c 69 74 65 33 50 43 61 63 68  oid sqlite3PCach
7dd0: 65 53 65 74 44 65 66 61 75 6c 74 28 76 6f 69 64  eSetDefault(void
7de0: 29 7b 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73  ){.  static cons
7df0: 74 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  t sqlite3_pcache
7e00: 5f 6d 65 74 68 6f 64 73 32 20 64 65 66 61 75 6c  _methods2 defaul
7e10: 74 4d 65 74 68 6f 64 73 20 3d 20 7b 0a 20 20 20  tMethods = {.   
7e20: 20 31 2c 20 20 20 20 20 20 20 20 20 20 20 20 20   1,             
7e30: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 69 56 65            /* iVe
7e40: 72 73 69 6f 6e 20 2a 2f 0a 20 20 20 20 30 2c 20  rsion */.    0, 
7e50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7e60: 20 20 20 20 20 20 2f 2a 20 70 41 72 67 20 2a 2f        /* pArg */
7e70: 0a 20 20 20 20 70 63 61 63 68 65 31 49 6e 69 74  .    pcache1Init
7e80: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ,             /*
7e90: 20 78 49 6e 69 74 20 2a 2f 0a 20 20 20 20 70 63   xInit */.    pc
7ea0: 61 63 68 65 31 53 68 75 74 64 6f 77 6e 2c 20 20  ache1Shutdown,  
7eb0: 20 20 20 20 20 20 20 2f 2a 20 78 53 68 75 74 64         /* xShutd
7ec0: 6f 77 6e 20 2a 2f 0a 20 20 20 20 70 63 61 63 68  own */.    pcach
7ed0: 65 31 43 72 65 61 74 65 2c 20 20 20 20 20 20 20  e1Create,       
7ee0: 20 20 20 20 2f 2a 20 78 43 72 65 61 74 65 20 2a      /* xCreate *
7ef0: 2f 0a 20 20 20 20 70 63 61 63 68 65 31 43 61 63  /.    pcache1Cac
7f00: 68 65 73 69 7a 65 2c 20 20 20 20 20 20 20 20 2f  hesize,        /
7f10: 2a 20 78 43 61 63 68 65 73 69 7a 65 20 2a 2f 0a  * xCachesize */.
7f20: 20 20 20 20 70 63 61 63 68 65 31 50 61 67 65 63      pcache1Pagec
7f30: 6f 75 6e 74 2c 20 20 20 20 20 20 20 20 2f 2a 20  ount,        /* 
7f40: 78 50 61 67 65 63 6f 75 6e 74 20 2a 2f 0a 20 20  xPagecount */.  
7f50: 20 20 70 63 61 63 68 65 31 46 65 74 63 68 2c 20    pcache1Fetch, 
7f60: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 46             /* xF
7f70: 65 74 63 68 20 2a 2f 0a 20 20 20 20 70 63 61 63  etch */.    pcac
7f80: 68 65 31 55 6e 70 69 6e 2c 20 20 20 20 20 20 20  he1Unpin,       
7f90: 20 20 20 20 20 2f 2a 20 78 55 6e 70 69 6e 20 2a       /* xUnpin *
7fa0: 2f 0a 20 20 20 20 70 63 61 63 68 65 31 52 65 6b  /.    pcache1Rek
7fb0: 65 79 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f  ey,            /
7fc0: 2a 20 78 52 65 6b 65 79 20 2a 2f 0a 20 20 20 20  * xRekey */.    
7fd0: 70 63 61 63 68 65 31 54 72 75 6e 63 61 74 65 2c  pcache1Truncate,
7fe0: 20 20 20 20 20 20 20 20 20 2f 2a 20 78 54 72 75           /* xTru
7ff0: 6e 63 61 74 65 20 2a 2f 0a 20 20 20 20 70 63 61  ncate */.    pca
8000: 63 68 65 31 44 65 73 74 72 6f 79 2c 20 20 20 20  che1Destroy,    
8010: 20 20 20 20 20 20 2f 2a 20 78 44 65 73 74 72 6f        /* xDestro
8020: 79 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31  y */.    pcache1
8030: 53 68 72 69 6e 6b 20 20 20 20 20 20 20 20 20 20  Shrink          
8040: 20 20 2f 2a 20 78 53 68 72 69 6e 6b 20 2a 2f 0a    /* xShrink */.
8050: 20 20 7d 3b 0a 20 20 73 71 6c 69 74 65 33 5f 63    };.  sqlite3_c
8060: 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e  onfig(SQLITE_CON
8070: 46 49 47 5f 50 43 41 43 48 45 32 2c 20 26 64 65  FIG_PCACHE2, &de
8080: 66 61 75 6c 74 4d 65 74 68 6f 64 73 29 3b 0a 7d  faultMethods);.}
8090: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74  ../*.** Return t
80a0: 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 68  he size of the h
80b0: 65 61 64 65 72 20 6f 6e 20 65 61 63 68 20 70 61  eader on each pa
80c0: 67 65 20 6f 66 20 74 68 69 73 20 50 43 41 43 48  ge of this PCACH
80d0: 45 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  E implementation
80e0: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
80f0: 48 65 61 64 65 72 53 69 7a 65 50 63 61 63 68 65  HeaderSizePcache
8100: 31 28 76 6f 69 64 29 7b 20 72 65 74 75 72 6e 20  1(void){ return 
8110: 52 4f 55 4e 44 38 28 73 69 7a 65 6f 66 28 50 67  ROUND8(sizeof(Pg
8120: 48 64 72 31 29 29 3b 20 7d 0a 0a 2f 2a 0a 2a 2a  Hdr1)); }../*.**
8130: 20 52 65 74 75 72 6e 20 74 68 65 20 67 6c 6f 62   Return the glob
8140: 61 6c 20 6d 75 74 65 78 20 75 73 65 64 20 62 79  al mutex used by
8150: 20 74 68 69 73 20 50 43 41 43 48 45 20 69 6d 70   this PCACHE imp
8160: 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 20 20 54 68  lementation.  Th
8170: 65 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 73 74 61  e.** sqlite3_sta
8180: 74 75 73 28 29 20 72 6f 75 74 69 6e 65 20 6e 65  tus() routine ne
8190: 65 64 73 20 61 63 63 65 73 73 20 74 6f 20 74 68  eds access to th
81a0: 69 73 20 6d 75 74 65 78 2e 0a 2a 2f 0a 73 71 6c  is mutex..*/.sql
81b0: 69 74 65 33 5f 6d 75 74 65 78 20 2a 73 71 6c 69  ite3_mutex *sqli
81c0: 74 65 33 50 63 61 63 68 65 31 4d 75 74 65 78 28  te3Pcache1Mutex(
81d0: 76 6f 69 64 29 7b 0a 20 20 72 65 74 75 72 6e 20  void){.  return 
81e0: 70 63 61 63 68 65 31 2e 6d 75 74 65 78 3b 0a 7d  pcache1.mutex;.}
81f0: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ..#ifdef SQLITE_
8200: 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41  ENABLE_MEMORY_MA
8210: 4e 41 47 45 4d 45 4e 54 0a 2f 2a 0a 2a 2a 20 54  NAGEMENT./*.** T
8220: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  his function is 
8230: 63 61 6c 6c 65 64 20 74 6f 20 66 72 65 65 20 73  called to free s
8240: 75 70 65 72 66 6c 75 6f 75 73 20 64 79 6e 61 6d  uperfluous dynam
8250: 69 63 61 6c 6c 79 20 61 6c 6c 6f 63 61 74 65 64  ically allocated
8260: 20 6d 65 6d 6f 72 79 0a 2a 2a 20 68 65 6c 64 20   memory.** held 
8270: 62 79 20 74 68 65 20 70 61 67 65 72 20 73 79 73  by the pager sys
8280: 74 65 6d 2e 20 4d 65 6d 6f 72 79 20 69 6e 20 75  tem. Memory in u
8290: 73 65 20 62 79 20 61 6e 79 20 53 51 4c 69 74 65  se by any SQLite
82a0: 20 70 61 67 65 72 20 61 6c 6c 6f 63 61 74 65 64   pager allocated
82b0: 0a 2a 2a 20 62 79 20 74 68 65 20 63 75 72 72 65  .** by the curre
82c0: 6e 74 20 74 68 72 65 61 64 20 6d 61 79 20 62 65  nt thread may be
82d0: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 29 65   sqlite3_free()e
82e0: 64 2e 0a 2a 2a 0a 2a 2a 20 6e 52 65 71 20 69 73  d..**.** nReq is
82f0: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62   the number of b
8300: 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79 20 72  ytes of memory r
8310: 65 71 75 69 72 65 64 2e 20 4f 6e 63 65 20 74 68  equired. Once th
8320: 69 73 20 6d 75 63 68 20 68 61 73 0a 2a 2a 20 62  is much has.** b
8330: 65 65 6e 20 72 65 6c 65 61 73 65 64 2c 20 74 68  een released, th
8340: 65 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72  e function retur
8350: 6e 73 2e 20 54 68 65 20 72 65 74 75 72 6e 20 76  ns. The return v
8360: 61 6c 75 65 20 69 73 20 74 68 65 20 74 6f 74 61  alue is the tota
8370: 6c 20 6e 75 6d 62 65 72 20 0a 2a 2a 20 6f 66 20  l number .** of 
8380: 62 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79 20  bytes of memory 
8390: 72 65 6c 65 61 73 65 64 2e 0a 2a 2f 0a 69 6e 74  released..*/.int
83a0: 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 52 65   sqlite3PcacheRe
83b0: 6c 65 61 73 65 4d 65 6d 6f 72 79 28 69 6e 74 20  leaseMemory(int 
83c0: 6e 52 65 71 29 7b 0a 20 20 69 6e 74 20 6e 46 72  nReq){.  int nFr
83d0: 65 65 20 3d 20 30 3b 0a 20 20 61 73 73 65 72 74  ee = 0;.  assert
83e0: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
83f0: 6e 6f 74 68 65 6c 64 28 70 63 61 63 68 65 31 2e  notheld(pcache1.
8400: 67 72 70 2e 6d 75 74 65 78 29 20 29 3b 0a 20 20  grp.mutex) );.  
8410: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f  assert( sqlite3_
8420: 6d 75 74 65 78 5f 6e 6f 74 68 65 6c 64 28 70 63  mutex_notheld(pc
8430: 61 63 68 65 31 2e 6d 75 74 65 78 29 20 29 3b 0a  ache1.mutex) );.
8440: 20 20 69 66 28 20 70 63 61 63 68 65 31 2e 70 53    if( pcache1.pS
8450: 74 61 72 74 3d 3d 30 20 29 7b 0a 20 20 20 20 50  tart==0 ){.    P
8460: 67 48 64 72 31 20 2a 70 3b 0a 20 20 20 20 70 63  gHdr1 *p;.    pc
8470: 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28  ache1EnterMutex(
8480: 26 70 63 61 63 68 65 31 2e 67 72 70 29 3b 0a 20  &pcache1.grp);. 
8490: 20 20 20 77 68 69 6c 65 28 20 28 6e 52 65 71 3c     while( (nReq<
84a0: 30 20 7c 7c 20 6e 46 72 65 65 3c 6e 52 65 71 29  0 || nFree<nReq)
84b0: 20 26 26 20 28 28 70 3d 70 63 61 63 68 65 31 2e   && ((p=pcache1.
84c0: 67 72 70 2e 70 4c 72 75 54 61 69 6c 29 21 3d 30  grp.pLruTail)!=0
84d0: 29 20 29 7b 0a 20 20 20 20 20 20 6e 46 72 65 65  ) ){.      nFree
84e0: 20 2b 3d 20 70 63 61 63 68 65 31 4d 65 6d 53 69   += pcache1MemSi
84f0: 7a 65 28 70 2d 3e 70 61 67 65 2e 70 42 75 66 29  ze(p->page.pBuf)
8500: 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ;.#ifdef SQLITE_
8510: 50 43 41 43 48 45 5f 53 45 50 41 52 41 54 45 5f  PCACHE_SEPARATE_
8520: 48 45 41 44 45 52 0a 20 20 20 20 20 20 6e 46 72  HEADER.      nFr
8530: 65 65 20 2b 3d 20 73 71 6c 69 74 65 33 4d 65 6d  ee += sqlite3Mem
8540: 53 69 7a 65 28 70 29 3b 0a 23 65 6e 64 69 66 0a  Size(p);.#endif.
8550: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 2d        assert( p-
8560: 3e 69 73 50 69 6e 6e 65 64 3d 3d 30 20 29 3b 0a  >isPinned==0 );.
8570: 20 20 20 20 20 20 70 63 61 63 68 65 31 50 69 6e        pcache1Pin
8580: 50 61 67 65 28 70 29 3b 0a 20 20 20 20 20 20 70  Page(p);.      p
8590: 63 61 63 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d  cache1RemoveFrom
85a0: 48 61 73 68 28 70 29 3b 0a 20 20 20 20 20 20 70  Hash(p);.      p
85b0: 63 61 63 68 65 31 46 72 65 65 50 61 67 65 28 70  cache1FreePage(p
85c0: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 63 61  );.    }.    pca
85d0: 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 26  che1LeaveMutex(&
85e0: 70 63 61 63 68 65 31 2e 67 72 70 29 3b 0a 20 20  pcache1.grp);.  
85f0: 7d 0a 20 20 72 65 74 75 72 6e 20 6e 46 72 65 65  }.  return nFree
8600: 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51  ;.}.#endif /* SQ
8610: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f  LITE_ENABLE_MEMO
8620: 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 20 2a 2f  RY_MANAGEMENT */
8630: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ..#ifdef SQLITE_
8640: 54 45 53 54 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  TEST./*.** This 
8650: 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 64  function is used
8660: 20 62 79 20 74 65 73 74 20 70 72 6f 63 65 64 75   by test procedu
8670: 72 65 73 20 74 6f 20 69 6e 73 70 65 63 74 20 74  res to inspect t
8680: 68 65 20 69 6e 74 65 72 6e 61 6c 20 73 74 61 74  he internal stat
8690: 65 0a 2a 2a 20 6f 66 20 74 68 65 20 67 6c 6f 62  e.** of the glob
86a0: 61 6c 20 63 61 63 68 65 2e 0a 2a 2f 0a 76 6f 69  al cache..*/.voi
86b0: 64 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 53  d sqlite3PcacheS
86c0: 74 61 74 73 28 0a 20 20 69 6e 74 20 2a 70 6e 43  tats(.  int *pnC
86d0: 75 72 72 65 6e 74 2c 20 20 20 20 20 20 2f 2a 20  urrent,      /* 
86e0: 4f 55 54 3a 20 54 6f 74 61 6c 20 6e 75 6d 62 65  OUT: Total numbe
86f0: 72 20 6f 66 20 70 61 67 65 73 20 63 61 63 68 65  r of pages cache
8700: 64 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 4d 61  d */.  int *pnMa
8710: 78 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f  x,          /* O
8720: 55 54 3a 20 47 6c 6f 62 61 6c 20 6d 61 78 69 6d  UT: Global maxim
8730: 75 6d 20 63 61 63 68 65 20 73 69 7a 65 20 2a 2f  um cache size */
8740: 0a 20 20 69 6e 74 20 2a 70 6e 4d 69 6e 2c 20 20  .  int *pnMin,  
8750: 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20          /* OUT: 
8760: 53 75 6d 20 6f 66 20 50 43 61 63 68 65 31 2e 6e  Sum of PCache1.n
8770: 4d 69 6e 20 66 6f 72 20 70 75 72 67 65 61 62 6c  Min for purgeabl
8780: 65 20 63 61 63 68 65 73 20 2a 2f 0a 20 20 69 6e  e caches */.  in
8790: 74 20 2a 70 6e 52 65 63 79 63 6c 61 62 6c 65 20  t *pnRecyclable 
87a0: 20 20 20 2f 2a 20 4f 55 54 3a 20 54 6f 74 61 6c     /* OUT: Total
87b0: 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73   number of pages
87c0: 20 61 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 72   available for r
87d0: 65 63 79 63 6c 69 6e 67 20 2a 2f 0a 29 7b 0a 20  ecycling */.){. 
87e0: 20 50 67 48 64 72 31 20 2a 70 3b 0a 20 20 69 6e   PgHdr1 *p;.  in
87f0: 74 20 6e 52 65 63 79 63 6c 61 62 6c 65 20 3d 20  t nRecyclable = 
8800: 30 3b 0a 20 20 66 6f 72 28 70 3d 70 63 61 63 68  0;.  for(p=pcach
8810: 65 31 2e 67 72 70 2e 70 4c 72 75 48 65 61 64 3b  e1.grp.pLruHead;
8820: 20 70 3b 20 70 3d 70 2d 3e 70 4c 72 75 4e 65 78   p; p=p->pLruNex
8830: 74 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20  t){.    assert( 
8840: 70 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d 30 20 29  p->isPinned==0 )
8850: 3b 0a 20 20 20 20 6e 52 65 63 79 63 6c 61 62 6c  ;.    nRecyclabl
8860: 65 2b 2b 3b 0a 20 20 7d 0a 20 20 2a 70 6e 43 75  e++;.  }.  *pnCu
8870: 72 72 65 6e 74 20 3d 20 70 63 61 63 68 65 31 2e  rrent = pcache1.
8880: 67 72 70 2e 6e 43 75 72 72 65 6e 74 50 61 67 65  grp.nCurrentPage
8890: 3b 0a 20 20 2a 70 6e 4d 61 78 20 3d 20 28 69 6e  ;.  *pnMax = (in
88a0: 74 29 70 63 61 63 68 65 31 2e 67 72 70 2e 6e 4d  t)pcache1.grp.nM
88b0: 61 78 50 61 67 65 3b 0a 20 20 2a 70 6e 4d 69 6e  axPage;.  *pnMin
88c0: 20 3d 20 28 69 6e 74 29 70 63 61 63 68 65 31 2e   = (int)pcache1.
88d0: 67 72 70 2e 6e 4d 69 6e 50 61 67 65 3b 0a 20 20  grp.nMinPage;.  
88e0: 2a 70 6e 52 65 63 79 63 6c 61 62 6c 65 20 3d 20  *pnRecyclable = 
88f0: 6e 52 65 63 79 63 6c 61 62 6c 65 3b 0a 7d 0a 23  nRecyclable;.}.#
8900: 65 6e 64 69 66 0a                                endif.