/ Hex Artifact Content
Login

Artifact 0f2c218d9fa84814403033319036d8e9ecb06dfd:


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 76 6f 69 64 20 70 63 61 63 68 65 31  tic void pcache1
3a70: 50 69 6e 50 61 67 65 28 50 67 48 64 72 31 20 2a  PinPage(PgHdr1 *
3a80: 70 50 61 67 65 29 7b 0a 20 20 50 43 61 63 68 65  pPage){.  PCache
3a90: 31 20 2a 70 43 61 63 68 65 3b 0a 0a 20 20 61 73  1 *pCache;..  as
3aa0: 73 65 72 74 28 20 70 50 61 67 65 21 3d 30 20 29  sert( pPage!=0 )
3ab0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67  ;.  assert( pPag
3ac0: 65 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d 30 20 29  e->isPinned==0 )
3ad0: 3b 0a 20 20 70 43 61 63 68 65 20 3d 20 70 50 61  ;.  pCache = pPa
3ae0: 67 65 2d 3e 70 43 61 63 68 65 3b 0a 20 20 61 73  ge->pCache;.  as
3af0: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 4c 72  sert( pPage->pLr
3b00: 75 4e 65 78 74 20 7c 7c 20 70 50 61 67 65 3d 3d  uNext || pPage==
3b10: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e  pCache->pGroup->
3b20: 70 4c 72 75 54 61 69 6c 20 29 3b 0a 20 20 61 73  pLruTail );.  as
3b30: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 4c 72  sert( pPage->pLr
3b40: 75 50 72 65 76 20 7c 7c 20 70 50 61 67 65 3d 3d  uPrev || pPage==
3b50: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e  pCache->pGroup->
3b60: 70 4c 72 75 48 65 61 64 20 29 3b 0a 20 20 61 73  pLruHead );.  as
3b70: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75  sert( sqlite3_mu
3b80: 74 65 78 5f 68 65 6c 64 28 70 43 61 63 68 65 2d  tex_held(pCache-
3b90: 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20  >pGroup->mutex) 
3ba0: 29 3b 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e  );.  if( pPage->
3bb0: 70 4c 72 75 50 72 65 76 20 29 7b 0a 20 20 20 20  pLruPrev ){.    
3bc0: 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 2d  pPage->pLruPrev-
3bd0: 3e 70 4c 72 75 4e 65 78 74 20 3d 20 70 50 61 67  >pLruNext = pPag
3be0: 65 2d 3e 70 4c 72 75 4e 65 78 74 3b 0a 20 20 7d  e->pLruNext;.  }
3bf0: 65 6c 73 65 7b 0a 20 20 20 20 70 43 61 63 68 65  else{.    pCache
3c00: 2d 3e 70 47 72 6f 75 70 2d 3e 70 4c 72 75 48 65  ->pGroup->pLruHe
3c10: 61 64 20 3d 20 70 50 61 67 65 2d 3e 70 4c 72 75  ad = pPage->pLru
3c20: 4e 65 78 74 3b 0a 20 20 7d 0a 20 20 69 66 28 20  Next;.  }.  if( 
3c30: 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74 20  pPage->pLruNext 
3c40: 29 7b 0a 20 20 20 20 70 50 61 67 65 2d 3e 70 4c  ){.    pPage->pL
3c50: 72 75 4e 65 78 74 2d 3e 70 4c 72 75 50 72 65 76  ruNext->pLruPrev
3c60: 20 3d 20 70 50 61 67 65 2d 3e 70 4c 72 75 50 72   = pPage->pLruPr
3c70: 65 76 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ev;.  }else{.   
3c80: 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d   pCache->pGroup-
3c90: 3e 70 4c 72 75 54 61 69 6c 20 3d 20 70 50 61 67  >pLruTail = pPag
3ca0: 65 2d 3e 70 4c 72 75 50 72 65 76 3b 0a 20 20 7d  e->pLruPrev;.  }
3cb0: 0a 20 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65  .  pPage->pLruNe
3cc0: 78 74 20 3d 20 30 3b 0a 20 20 70 50 61 67 65 2d  xt = 0;.  pPage-
3cd0: 3e 70 4c 72 75 50 72 65 76 20 3d 20 30 3b 0a 20  >pLruPrev = 0;. 
3ce0: 20 70 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64   pPage->isPinned
3cf0: 20 3d 20 31 3b 0a 20 20 70 43 61 63 68 65 2d 3e   = 1;.  pCache->
3d00: 6e 52 65 63 79 63 6c 61 62 6c 65 2d 2d 3b 0a 7d  nRecyclable--;.}
3d10: 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 6d 6f 76 65 20  .../*.** Remove 
3d20: 74 68 65 20 70 61 67 65 20 73 75 70 70 6c 69 65  the page supplie
3d30: 64 20 61 73 20 61 6e 20 61 72 67 75 6d 65 6e 74  d as an argument
3d40: 20 66 72 6f 6d 20 74 68 65 20 68 61 73 68 20 74   from the hash t
3d50: 61 62 6c 65 20 0a 2a 2a 20 28 50 43 61 63 68 65  able .** (PCache
3d60: 31 2e 61 70 48 61 73 68 20 73 74 72 75 63 74 75  1.apHash structu
3d70: 72 65 29 20 74 68 61 74 20 69 74 20 69 73 20 63  re) that it is c
3d80: 75 72 72 65 6e 74 6c 79 20 73 74 6f 72 65 64 20  urrently stored 
3d90: 69 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50 47  in..**.** The PG
3da0: 72 6f 75 70 20 6d 75 74 65 78 20 6d 75 73 74 20  roup mutex must 
3db0: 62 65 20 68 65 6c 64 20 77 68 65 6e 20 74 68 69  be held when thi
3dc0: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61  s function is ca
3dd0: 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  lled..*/.static 
3de0: 76 6f 69 64 20 70 63 61 63 68 65 31 52 65 6d 6f  void pcache1Remo
3df0: 76 65 46 72 6f 6d 48 61 73 68 28 50 67 48 64 72  veFromHash(PgHdr
3e00: 31 20 2a 70 50 61 67 65 29 7b 0a 20 20 75 6e 73  1 *pPage){.  uns
3e10: 69 67 6e 65 64 20 69 6e 74 20 68 3b 0a 20 20 50  igned int h;.  P
3e20: 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d  Cache1 *pCache =
3e30: 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65 3b 0a   pPage->pCache;.
3e40: 20 20 50 67 48 64 72 31 20 2a 2a 70 70 3b 0a 0a    PgHdr1 **pp;..
3e50: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
3e60: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 61  3_mutex_held(pCa
3e70: 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74  che->pGroup->mut
3e80: 65 78 29 20 29 3b 0a 20 20 68 20 3d 20 70 50 61  ex) );.  h = pPa
3e90: 67 65 2d 3e 69 4b 65 79 20 25 20 70 43 61 63 68  ge->iKey % pCach
3ea0: 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 66 6f 72 28  e->nHash;.  for(
3eb0: 70 70 3d 26 70 43 61 63 68 65 2d 3e 61 70 48 61  pp=&pCache->apHa
3ec0: 73 68 5b 68 5d 3b 20 28 2a 70 70 29 21 3d 70 50  sh[h]; (*pp)!=pP
3ed0: 61 67 65 3b 20 70 70 3d 26 28 2a 70 70 29 2d 3e  age; pp=&(*pp)->
3ee0: 70 4e 65 78 74 29 3b 0a 20 20 2a 70 70 20 3d 20  pNext);.  *pp = 
3ef0: 28 2a 70 70 29 2d 3e 70 4e 65 78 74 3b 0a 0a 20  (*pp)->pNext;.. 
3f00: 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 2d 2d   pCache->nPage--
3f10: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68  ;.}../*.** If th
3f20: 65 72 65 20 61 72 65 20 63 75 72 72 65 6e 74 6c  ere are currentl
3f30: 79 20 6d 6f 72 65 20 74 68 61 6e 20 6e 4d 61 78  y more than nMax
3f40: 50 61 67 65 20 70 61 67 65 73 20 61 6c 6c 6f 63  Page pages alloc
3f50: 61 74 65 64 2c 20 74 72 79 0a 2a 2a 20 74 6f 20  ated, try.** to 
3f60: 72 65 63 79 63 6c 65 20 70 61 67 65 73 20 74 6f  recycle pages to
3f70: 20 72 65 64 75 63 65 20 74 68 65 20 6e 75 6d 62   reduce the numb
3f80: 65 72 20 61 6c 6c 6f 63 61 74 65 64 20 74 6f 20  er allocated to 
3f90: 6e 4d 61 78 50 61 67 65 2e 0a 2a 2f 0a 73 74 61  nMaxPage..*/.sta
3fa0: 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31  tic void pcache1
3fb0: 45 6e 66 6f 72 63 65 4d 61 78 50 61 67 65 28 50  EnforceMaxPage(P
3fc0: 47 72 6f 75 70 20 2a 70 47 72 6f 75 70 29 7b 0a  Group *pGroup){.
3fd0: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
3fe0: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 47 72  3_mutex_held(pGr
3ff0: 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20  oup->mutex) );. 
4000: 20 77 68 69 6c 65 28 20 70 47 72 6f 75 70 2d 3e   while( pGroup->
4010: 6e 43 75 72 72 65 6e 74 50 61 67 65 3e 70 47 72  nCurrentPage>pGr
4020: 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 26 26  oup->nMaxPage &&
4030: 20 70 47 72 6f 75 70 2d 3e 70 4c 72 75 54 61 69   pGroup->pLruTai
4040: 6c 20 29 7b 0a 20 20 20 20 50 67 48 64 72 31 20  l ){.    PgHdr1 
4050: 2a 70 20 3d 20 70 47 72 6f 75 70 2d 3e 70 4c 72  *p = pGroup->pLr
4060: 75 54 61 69 6c 3b 0a 20 20 20 20 61 73 73 65 72  uTail;.    asser
4070: 74 28 20 70 2d 3e 70 43 61 63 68 65 2d 3e 70 47  t( p->pCache->pG
4080: 72 6f 75 70 3d 3d 70 47 72 6f 75 70 20 29 3b 0a  roup==pGroup );.
4090: 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 69      assert( p->i
40a0: 73 50 69 6e 6e 65 64 3d 3d 30 20 29 3b 0a 20 20  sPinned==0 );.  
40b0: 20 20 70 63 61 63 68 65 31 50 69 6e 50 61 67 65    pcache1PinPage
40c0: 28 70 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31  (p);.    pcache1
40d0: 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73 68 28 70  RemoveFromHash(p
40e0: 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 46 72  );.    pcache1Fr
40f0: 65 65 50 61 67 65 28 70 29 3b 0a 20 20 7d 0a 7d  eePage(p);.  }.}
4100: 0a 0a 2f 2a 0a 2a 2a 20 44 69 73 63 61 72 64 20  ../*.** Discard 
4110: 61 6c 6c 20 70 61 67 65 73 20 66 72 6f 6d 20 63  all pages from c
4120: 61 63 68 65 20 70 43 61 63 68 65 20 77 69 74 68  ache pCache with
4130: 20 61 20 70 61 67 65 20 6e 75 6d 62 65 72 20 28   a page number (
4140: 6b 65 79 20 76 61 6c 75 65 29 20 0a 2a 2a 20 67  key value) .** g
4150: 72 65 61 74 65 72 20 74 68 61 6e 20 6f 72 20 65  reater than or e
4160: 71 75 61 6c 20 74 6f 20 69 4c 69 6d 69 74 2e 20  qual to iLimit. 
4170: 41 6e 79 20 70 69 6e 6e 65 64 20 70 61 67 65 73  Any pinned pages
4180: 20 74 68 61 74 20 6d 65 65 74 20 74 68 69 73 20   that meet this 
4190: 0a 2a 2a 20 63 72 69 74 65 72 69 61 20 61 72 65  .** criteria are
41a0: 20 75 6e 70 69 6e 6e 65 64 20 62 65 66 6f 72 65   unpinned before
41b0: 20 74 68 65 79 20 61 72 65 20 64 69 73 63 61 72   they are discar
41c0: 64 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50  ded..**.** The P
41d0: 43 61 63 68 65 20 6d 75 74 65 78 20 6d 75 73 74  Cache mutex must
41e0: 20 62 65 20 68 65 6c 64 20 77 68 65 6e 20 74 68   be held when th
41f0: 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63  is function is c
4200: 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63  alled..*/.static
4210: 20 76 6f 69 64 20 70 63 61 63 68 65 31 54 72 75   void pcache1Tru
4220: 6e 63 61 74 65 55 6e 73 61 66 65 28 0a 20 20 50  ncateUnsafe(.  P
4230: 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 2c 20  Cache1 *pCache, 
4240: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
4250: 68 65 20 63 61 63 68 65 20 74 6f 20 74 72 75 6e  he cache to trun
4260: 63 61 74 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e  cate */.  unsign
4270: 65 64 20 69 6e 74 20 69 4c 69 6d 69 74 20 20 20  ed int iLimit   
4280: 20 20 20 20 20 20 20 2f 2a 20 44 72 6f 70 20 70         /* Drop p
4290: 61 67 65 73 20 77 69 74 68 20 74 68 69 73 20 70  ages with this p
42a0: 67 6e 6f 20 6f 72 20 6c 61 72 67 65 72 20 2a 2f  gno or larger */
42b0: 0a 29 7b 0a 20 20 54 45 53 54 4f 4e 4c 59 28 20  .){.  TESTONLY( 
42c0: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 50 61  unsigned int nPa
42d0: 67 65 20 3d 20 30 3b 20 29 20 20 2f 2a 20 54 6f  ge = 0; )  /* To
42e0: 20 61 73 73 65 72 74 20 70 43 61 63 68 65 2d 3e   assert pCache->
42f0: 6e 50 61 67 65 20 69 73 20 63 6f 72 72 65 63 74  nPage is correct
4300: 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69   */.  unsigned i
4310: 6e 74 20 68 3b 0a 20 20 61 73 73 65 72 74 28 20  nt h;.  assert( 
4320: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65  sqlite3_mutex_he
4330: 6c 64 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75  ld(pCache->pGrou
4340: 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 66  p->mutex) );.  f
4350: 6f 72 28 68 3d 30 3b 20 68 3c 70 43 61 63 68 65  or(h=0; h<pCache
4360: 2d 3e 6e 48 61 73 68 3b 20 68 2b 2b 29 7b 0a 20  ->nHash; h++){. 
4370: 20 20 20 50 67 48 64 72 31 20 2a 2a 70 70 20 3d     PgHdr1 **pp =
4380: 20 26 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68   &pCache->apHash
4390: 5b 68 5d 3b 20 0a 20 20 20 20 50 67 48 64 72 31  [h]; .    PgHdr1
43a0: 20 2a 70 50 61 67 65 3b 0a 20 20 20 20 77 68 69   *pPage;.    whi
43b0: 6c 65 28 20 28 70 50 61 67 65 20 3d 20 2a 70 70  le( (pPage = *pp
43c0: 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 69 66  )!=0 ){.      if
43d0: 28 20 70 50 61 67 65 2d 3e 69 4b 65 79 3e 3d 69  ( pPage->iKey>=i
43e0: 4c 69 6d 69 74 20 29 7b 0a 20 20 20 20 20 20 20  Limit ){.       
43f0: 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 2d 2d   pCache->nPage--
4400: 3b 0a 20 20 20 20 20 20 20 20 2a 70 70 20 3d 20  ;.        *pp = 
4410: 70 50 61 67 65 2d 3e 70 4e 65 78 74 3b 0a 20 20  pPage->pNext;.  
4420: 20 20 20 20 20 20 69 66 28 20 21 70 50 61 67 65        if( !pPage
4430: 2d 3e 69 73 50 69 6e 6e 65 64 20 29 20 70 63 61  ->isPinned ) pca
4440: 63 68 65 31 50 69 6e 50 61 67 65 28 70 50 61 67  che1PinPage(pPag
4450: 65 29 3b 0a 20 20 20 20 20 20 20 20 70 63 61 63  e);.        pcac
4460: 68 65 31 46 72 65 65 50 61 67 65 28 70 50 61 67  he1FreePage(pPag
4470: 65 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b  e);.      }else{
4480: 0a 20 20 20 20 20 20 20 20 70 70 20 3d 20 26 70  .        pp = &p
4490: 50 61 67 65 2d 3e 70 4e 65 78 74 3b 0a 20 20 20  Page->pNext;.   
44a0: 20 20 20 20 20 54 45 53 54 4f 4e 4c 59 28 20 6e       TESTONLY( n
44b0: 50 61 67 65 2b 2b 3b 20 29 0a 20 20 20 20 20 20  Page++; ).      
44c0: 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 61 73  }.    }.  }.  as
44d0: 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 50  sert( pCache->nP
44e0: 61 67 65 3d 3d 6e 50 61 67 65 20 29 3b 0a 7d 0a  age==nPage );.}.
44f0: 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ./**************
4500: 2a 2a 2a 2a 2a 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: 2f 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c 69  /./******** sqli
4550: 74 65 33 5f 70 63 61 63 68 65 20 4d 65 74 68 6f  te3_pcache Metho
4560: 64 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ds *************
4570: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4580: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4590: 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d  */../*.** Implem
45a0: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20  entation of the 
45b0: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78  sqlite3_pcache.x
45c0: 49 6e 69 74 20 6d 65 74 68 6f 64 2e 0a 2a 2f 0a  Init method..*/.
45d0: 73 74 61 74 69 63 20 69 6e 74 20 70 63 61 63 68  static int pcach
45e0: 65 31 49 6e 69 74 28 76 6f 69 64 20 2a 4e 6f 74  e1Init(void *Not
45f0: 55 73 65 64 29 7b 0a 20 20 55 4e 55 53 45 44 5f  Used){.  UNUSED_
4600: 50 41 52 41 4d 45 54 45 52 28 4e 6f 74 55 73 65  PARAMETER(NotUse
4610: 64 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 63  d);.  assert( pc
4620: 61 63 68 65 31 2e 69 73 49 6e 69 74 3d 3d 30 20  ache1.isInit==0 
4630: 29 3b 0a 20 20 6d 65 6d 73 65 74 28 26 70 63 61  );.  memset(&pca
4640: 63 68 65 31 2c 20 30 2c 20 73 69 7a 65 6f 66 28  che1, 0, sizeof(
4650: 70 63 61 63 68 65 31 29 29 3b 0a 20 20 69 66 28  pcache1));.  if(
4660: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f   sqlite3GlobalCo
4670: 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 20  nfig.bCoreMutex 
4680: 29 7b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 67  ){.    pcache1.g
4690: 72 70 2e 6d 75 74 65 78 20 3d 20 73 71 6c 69 74  rp.mutex = sqlit
46a0: 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 28 53  e3_mutex_alloc(S
46b0: 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54  QLITE_MUTEX_STAT
46c0: 49 43 5f 4c 52 55 29 3b 0a 20 20 20 20 70 63 61  IC_LRU);.    pca
46d0: 63 68 65 31 2e 6d 75 74 65 78 20 3d 20 73 71 6c  che1.mutex = sql
46e0: 69 74 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63  ite3_mutex_alloc
46f0: 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54  (SQLITE_MUTEX_ST
4700: 41 54 49 43 5f 50 4d 45 4d 29 3b 0a 20 20 7d 0a  ATIC_PMEM);.  }.
4710: 20 20 70 63 61 63 68 65 31 2e 67 72 70 2e 6d 78    pcache1.grp.mx
4720: 50 69 6e 6e 65 64 20 3d 20 31 30 3b 0a 20 20 70  Pinned = 10;.  p
4730: 63 61 63 68 65 31 2e 69 73 49 6e 69 74 20 3d 20  cache1.isInit = 
4740: 31 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49  1;.  return SQLI
4750: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  TE_OK;.}../*.** 
4760: 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  Implementation o
4770: 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63  f the sqlite3_pc
4780: 61 63 68 65 2e 78 53 68 75 74 64 6f 77 6e 20 6d  ache.xShutdown m
4790: 65 74 68 6f 64 2e 0a 2a 2a 20 4e 6f 74 65 20 74  ethod..** Note t
47a0: 68 61 74 20 74 68 65 20 73 74 61 74 69 63 20 6d  hat the static m
47b0: 75 74 65 78 20 61 6c 6c 6f 63 61 74 65 64 20 69  utex allocated i
47c0: 6e 20 78 49 6e 69 74 20 64 6f 65 73 20 0a 2a 2a  n xInit does .**
47d0: 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 62 65 20   not need to be 
47e0: 66 72 65 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63  freed..*/.static
47f0: 20 76 6f 69 64 20 70 63 61 63 68 65 31 53 68 75   void pcache1Shu
4800: 74 64 6f 77 6e 28 76 6f 69 64 20 2a 4e 6f 74 55  tdown(void *NotU
4810: 73 65 64 29 7b 0a 20 20 55 4e 55 53 45 44 5f 50  sed){.  UNUSED_P
4820: 41 52 41 4d 45 54 45 52 28 4e 6f 74 55 73 65 64  ARAMETER(NotUsed
4830: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 63 61  );.  assert( pca
4840: 63 68 65 31 2e 69 73 49 6e 69 74 21 3d 30 20 29  che1.isInit!=0 )
4850: 3b 0a 20 20 6d 65 6d 73 65 74 28 26 70 63 61 63  ;.  memset(&pcac
4860: 68 65 31 2c 20 30 2c 20 73 69 7a 65 6f 66 28 70  he1, 0, sizeof(p
4870: 63 61 63 68 65 31 29 29 3b 0a 7d 0a 0a 2f 2a 20  cache1));.}../* 
4880: 66 6f 72 77 61 72 64 20 64 65 63 6c 61 72 61 74  forward declarat
4890: 69 6f 6e 20 2a 2f 0a 73 74 61 74 69 63 20 76 6f  ion */.static vo
48a0: 69 64 20 70 63 61 63 68 65 31 44 65 73 74 72 6f  id pcache1Destro
48b0: 79 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  y(sqlite3_pcache
48c0: 20 2a 70 29 3b 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70   *p);../*.** Imp
48d0: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74  lementation of t
48e0: 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68  he sqlite3_pcach
48f0: 65 2e 78 43 72 65 61 74 65 20 6d 65 74 68 6f 64  e.xCreate method
4900: 2e 0a 2a 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65  ..**.** Allocate
4910: 20 61 20 6e 65 77 20 63 61 63 68 65 2e 0a 2a 2f   a new cache..*/
4920: 0a 73 74 61 74 69 63 20 73 71 6c 69 74 65 33 5f  .static sqlite3_
4930: 70 63 61 63 68 65 20 2a 70 63 61 63 68 65 31 43  pcache *pcache1C
4940: 72 65 61 74 65 28 69 6e 74 20 73 7a 50 61 67 65  reate(int szPage
4950: 2c 20 69 6e 74 20 73 7a 45 78 74 72 61 2c 20 69  , int szExtra, i
4960: 6e 74 20 62 50 75 72 67 65 61 62 6c 65 29 7b 0a  nt bPurgeable){.
4970: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68    PCache1 *pCach
4980: 65 3b 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6e  e;      /* The n
4990: 65 77 6c 79 20 63 72 65 61 74 65 64 20 70 61 67  ewly created pag
49a0: 65 20 63 61 63 68 65 20 2a 2f 0a 20 20 50 47 72  e cache */.  PGr
49b0: 6f 75 70 20 2a 70 47 72 6f 75 70 3b 20 20 20 20  oup *pGroup;    
49c0: 20 20 20 2f 2a 20 54 68 65 20 67 72 6f 75 70 20     /* The group 
49d0: 74 68 65 20 6e 65 77 20 70 61 67 65 20 63 61 63  the new page cac
49e0: 68 65 20 77 69 6c 6c 20 62 65 6c 6f 6e 67 20 74  he will belong t
49f0: 6f 20 2a 2f 0a 20 20 69 6e 74 20 73 7a 3b 20 20  o */.  int sz;  
4a00: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
4a10: 42 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79 20  Bytes of memory 
4a20: 72 65 71 75 69 72 65 64 20 74 6f 20 61 6c 6c 6f  required to allo
4a30: 63 61 74 65 20 74 68 65 20 6e 65 77 20 63 61 63  cate the new cac
4a40: 68 65 20 2a 2f 0a 0a 20 20 2f 2a 0a 20 20 2a 2a  he */..  /*.  **
4a50: 20 54 68 65 20 73 65 70 61 72 61 74 65 43 61 63   The separateCac
4a60: 68 65 20 76 61 72 69 61 62 6c 65 20 69 73 20 74  he variable is t
4a70: 72 75 65 20 69 66 20 65 61 63 68 20 50 43 61 63  rue if each PCac
4a80: 68 65 20 68 61 73 20 69 74 73 20 6f 77 6e 20 70  he has its own p
4a90: 72 69 76 61 74 65 0a 20 20 2a 2a 20 50 47 72 6f  rivate.  ** PGro
4aa0: 75 70 2e 20 20 49 6e 20 6f 74 68 65 72 20 77 6f  up.  In other wo
4ab0: 72 64 73 2c 20 73 65 70 61 72 61 74 65 43 61 63  rds, separateCac
4ac0: 68 65 20 69 73 20 74 72 75 65 20 66 6f 72 20 6d  he is true for m
4ad0: 6f 64 65 20 28 31 29 20 77 68 65 72 65 20 6e 6f  ode (1) where no
4ae0: 0a 20 20 2a 2a 20 6d 75 74 65 78 69 6e 67 20 69  .  ** mutexing i
4af0: 73 20 72 65 71 75 69 72 65 64 2e 0a 20 20 2a 2a  s required..  **
4b00: 0a 20 20 2a 2a 20 20 20 2a 20 20 41 6c 77 61 79  .  **   *  Alway
4b10: 73 20 75 73 65 20 61 20 75 6e 69 66 69 65 64 20  s use a unified 
4b20: 63 61 63 68 65 20 28 6d 6f 64 65 2d 32 29 20 69  cache (mode-2) i
4b30: 66 20 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f  f ENABLE_MEMORY_
4b40: 4d 41 4e 41 47 45 4d 45 4e 54 0a 20 20 2a 2a 0a  MANAGEMENT.  **.
4b50: 20 20 2a 2a 20 20 20 2a 20 20 41 6c 77 61 79 73    **   *  Always
4b60: 20 75 73 65 20 61 20 75 6e 69 66 69 65 64 20 63   use a unified c
4b70: 61 63 68 65 20 69 6e 20 73 69 6e 67 6c 65 2d 74  ache in single-t
4b80: 68 72 65 61 64 65 64 20 61 70 70 6c 69 63 61 74  hreaded applicat
4b90: 69 6f 6e 73 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20  ions.  **.  **  
4ba0: 20 2a 20 20 4f 74 68 65 72 77 69 73 65 20 28 69   *  Otherwise (i
4bb0: 66 20 6d 75 6c 74 69 2d 74 68 72 65 61 64 65 64  f multi-threaded
4bc0: 20 61 6e 64 20 45 4e 41 42 4c 45 5f 4d 45 4d 4f   and ENABLE_MEMO
4bd0: 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 20 69 73  RY_MANAGEMENT is
4be0: 20 6f 66 66 29 0a 20 20 2a 2a 20 20 20 20 20 20   off).  **      
4bf0: 75 73 65 20 73 65 70 61 72 61 74 65 20 63 61 63  use separate cac
4c00: 68 65 73 20 28 6d 6f 64 65 2d 31 29 0a 20 20 2a  hes (mode-1).  *
4c10: 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51  /.#if defined(SQ
4c20: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f  LITE_ENABLE_MEMO
4c30: 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 29 20 7c  RY_MANAGEMENT) |
4c40: 7c 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53  | SQLITE_THREADS
4c50: 41 46 45 3d 3d 30 0a 20 20 63 6f 6e 73 74 20 69  AFE==0.  const i
4c60: 6e 74 20 73 65 70 61 72 61 74 65 43 61 63 68 65  nt separateCache
4c70: 20 3d 20 30 3b 0a 23 65 6c 73 65 0a 20 20 69 6e   = 0;.#else.  in
4c80: 74 20 73 65 70 61 72 61 74 65 43 61 63 68 65 20  t separateCache 
4c90: 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43  = sqlite3GlobalC
4ca0: 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78  onfig.bCoreMutex
4cb0: 3e 30 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73  >0;.#endif..  as
4cc0: 73 65 72 74 28 20 28 73 7a 50 61 67 65 20 26 20  sert( (szPage & 
4cd0: 28 73 7a 50 61 67 65 2d 31 29 29 3d 3d 30 20 26  (szPage-1))==0 &
4ce0: 26 20 73 7a 50 61 67 65 3e 3d 35 31 32 20 26 26  & szPage>=512 &&
4cf0: 20 73 7a 50 61 67 65 3c 3d 36 35 35 33 36 20 29   szPage<=65536 )
4d00: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 7a 45 78  ;.  assert( szEx
4d10: 74 72 61 20 3c 20 33 30 30 20 29 3b 0a 0a 20 20  tra < 300 );..  
4d20: 73 7a 20 3d 20 73 69 7a 65 6f 66 28 50 43 61 63  sz = sizeof(PCac
4d30: 68 65 31 29 20 2b 20 73 69 7a 65 6f 66 28 50 47  he1) + sizeof(PG
4d40: 72 6f 75 70 29 2a 73 65 70 61 72 61 74 65 43 61  roup)*separateCa
4d50: 63 68 65 3b 0a 20 20 70 43 61 63 68 65 20 3d 20  che;.  pCache = 
4d60: 28 50 43 61 63 68 65 31 20 2a 29 73 71 6c 69 74  (PCache1 *)sqlit
4d70: 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 7a 29  e3MallocZero(sz)
4d80: 3b 0a 20 20 69 66 28 20 70 43 61 63 68 65 20 29  ;.  if( pCache )
4d90: 7b 0a 20 20 20 20 69 66 28 20 73 65 70 61 72 61  {.    if( separa
4da0: 74 65 43 61 63 68 65 20 29 7b 0a 20 20 20 20 20  teCache ){.     
4db0: 20 70 47 72 6f 75 70 20 3d 20 28 50 47 72 6f 75   pGroup = (PGrou
4dc0: 70 2a 29 26 70 43 61 63 68 65 5b 31 5d 3b 0a 20  p*)&pCache[1];. 
4dd0: 20 20 20 20 20 70 47 72 6f 75 70 2d 3e 6d 78 50       pGroup->mxP
4de0: 69 6e 6e 65 64 20 3d 20 31 30 3b 0a 20 20 20 20  inned = 10;.    
4df0: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 47 72  }else{.      pGr
4e00: 6f 75 70 20 3d 20 26 70 63 61 63 68 65 31 2e 67  oup = &pcache1.g
4e10: 72 70 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 43  rp;.    }.    pC
4e20: 61 63 68 65 2d 3e 70 47 72 6f 75 70 20 3d 20 70  ache->pGroup = p
4e30: 47 72 6f 75 70 3b 0a 20 20 20 20 70 43 61 63 68  Group;.    pCach
4e40: 65 2d 3e 73 7a 50 61 67 65 20 3d 20 73 7a 50 61  e->szPage = szPa
4e50: 67 65 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e  ge;.    pCache->
4e60: 73 7a 45 78 74 72 61 20 3d 20 73 7a 45 78 74 72  szExtra = szExtr
4e70: 61 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 62  a;.    pCache->b
4e80: 50 75 72 67 65 61 62 6c 65 20 3d 20 28 62 50 75  Purgeable = (bPu
4e90: 72 67 65 61 62 6c 65 20 3f 20 31 20 3a 20 30 29  rgeable ? 1 : 0)
4ea0: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e 74  ;.    pcache1Ent
4eb0: 65 72 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b  erMutex(pGroup);
4ec0: 0a 20 20 20 20 70 63 61 63 68 65 31 52 65 73 69  .    pcache1Resi
4ed0: 7a 65 48 61 73 68 28 70 43 61 63 68 65 29 3b 0a  zeHash(pCache);.
4ee0: 20 20 20 20 69 66 28 20 62 50 75 72 67 65 61 62      if( bPurgeab
4ef0: 6c 65 20 29 7b 0a 20 20 20 20 20 20 70 43 61 63  le ){.      pCac
4f00: 68 65 2d 3e 6e 4d 69 6e 20 3d 20 31 30 3b 0a 20  he->nMin = 10;. 
4f10: 20 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 69       pGroup->nMi
4f20: 6e 50 61 67 65 20 2b 3d 20 70 43 61 63 68 65 2d  nPage += pCache-
4f30: 3e 6e 4d 69 6e 3b 0a 20 20 20 20 20 20 70 47 72  >nMin;.      pGr
4f40: 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 20  oup->mxPinned = 
4f50: 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65  pGroup->nMaxPage
4f60: 20 2b 20 31 30 20 2d 20 70 47 72 6f 75 70 2d 3e   + 10 - pGroup->
4f70: 6e 4d 69 6e 50 61 67 65 3b 0a 20 20 20 20 7d 0a  nMinPage;.    }.
4f80: 20 20 20 20 70 63 61 63 68 65 31 4c 65 61 76 65      pcache1Leave
4f90: 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20  Mutex(pGroup);. 
4fa0: 20 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e 6e     if( pCache->n
4fb0: 48 61 73 68 3d 3d 30 20 29 7b 0a 20 20 20 20 20  Hash==0 ){.     
4fc0: 20 70 63 61 63 68 65 31 44 65 73 74 72 6f 79 28   pcache1Destroy(
4fd0: 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2a  (sqlite3_pcache*
4fe0: 29 70 43 61 63 68 65 29 3b 0a 20 20 20 20 20 20  )pCache);.      
4ff0: 70 43 61 63 68 65 20 3d 20 30 3b 0a 20 20 20 20  pCache = 0;.    
5000: 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 28  }.  }.  return (
5010: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a  sqlite3_pcache *
5020: 29 70 43 61 63 68 65 3b 0a 7d 0a 0a 2f 2a 0a 2a  )pCache;.}../*.*
5030: 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  * Implementation
5040: 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f   of the sqlite3_
5050: 70 63 61 63 68 65 2e 78 43 61 63 68 65 73 69 7a  pcache.xCachesiz
5060: 65 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a  e method. .**.**
5070: 20 43 6f 6e 66 69 67 75 72 65 20 74 68 65 20 63   Configure the c
5080: 61 63 68 65 5f 73 69 7a 65 20 6c 69 6d 69 74 20  ache_size limit 
5090: 66 6f 72 20 61 20 63 61 63 68 65 2e 0a 2a 2f 0a  for a cache..*/.
50a0: 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63  static void pcac
50b0: 68 65 31 43 61 63 68 65 73 69 7a 65 28 73 71 6c  he1Cachesize(sql
50c0: 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 2c 20  ite3_pcache *p, 
50d0: 69 6e 74 20 6e 4d 61 78 29 7b 0a 20 20 50 43 61  int nMax){.  PCa
50e0: 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28  che1 *pCache = (
50f0: 50 43 61 63 68 65 31 20 2a 29 70 3b 0a 20 20 69  PCache1 *)p;.  i
5100: 66 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67  f( pCache->bPurg
5110: 65 61 62 6c 65 20 29 7b 0a 20 20 20 20 50 47 72  eable ){.    PGr
5120: 6f 75 70 20 2a 70 47 72 6f 75 70 20 3d 20 70 43  oup *pGroup = pC
5130: 61 63 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20 20  ache->pGroup;.  
5140: 20 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75    pcache1EnterMu
5150: 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20 20 20  tex(pGroup);.   
5160: 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67   pGroup->nMaxPag
5170: 65 20 2b 3d 20 28 6e 4d 61 78 20 2d 20 70 43 61  e += (nMax - pCa
5180: 63 68 65 2d 3e 6e 4d 61 78 29 3b 0a 20 20 20 20  che->nMax);.    
5190: 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64  pGroup->mxPinned
51a0: 20 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50   = pGroup->nMaxP
51b0: 61 67 65 20 2b 20 31 30 20 2d 20 70 47 72 6f 75  age + 10 - pGrou
51c0: 70 2d 3e 6e 4d 69 6e 50 61 67 65 3b 0a 20 20 20  p->nMinPage;.   
51d0: 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 20 3d 20   pCache->nMax = 
51e0: 6e 4d 61 78 3b 0a 20 20 20 20 70 43 61 63 68 65  nMax;.    pCache
51f0: 2d 3e 6e 39 30 70 63 74 20 3d 20 70 43 61 63 68  ->n90pct = pCach
5200: 65 2d 3e 6e 4d 61 78 2a 39 2f 31 30 3b 0a 20 20  e->nMax*9/10;.  
5210: 20 20 70 63 61 63 68 65 31 45 6e 66 6f 72 63 65    pcache1Enforce
5220: 4d 61 78 50 61 67 65 28 70 47 72 6f 75 70 29 3b  MaxPage(pGroup);
5230: 0a 20 20 20 20 70 63 61 63 68 65 31 4c 65 61 76  .    pcache1Leav
5240: 65 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a  eMutex(pGroup);.
5250: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70    }.}../*.** Imp
5260: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74  lementation of t
5270: 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68  he sqlite3_pcach
5280: 65 2e 78 53 68 72 69 6e 6b 20 6d 65 74 68 6f 64  e.xShrink method
5290: 2e 20 0a 2a 2a 0a 2a 2a 20 46 72 65 65 20 75 70  . .**.** Free up
52a0: 20 61 73 20 6d 75 63 68 20 6d 65 6d 6f 72 79 20   as much memory 
52b0: 61 73 20 70 6f 73 73 69 62 6c 65 2e 0a 2a 2f 0a  as possible..*/.
52c0: 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63  static void pcac
52d0: 68 65 31 53 68 72 69 6e 6b 28 73 71 6c 69 74 65  he1Shrink(sqlite
52e0: 33 5f 70 63 61 63 68 65 20 2a 70 29 7b 0a 20 20  3_pcache *p){.  
52f0: 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 20  PCache1 *pCache 
5300: 3d 20 28 50 43 61 63 68 65 31 2a 29 70 3b 0a 20  = (PCache1*)p;. 
5310: 20 69 66 28 20 70 43 61 63 68 65 2d 3e 62 50 75   if( pCache->bPu
5320: 72 67 65 61 62 6c 65 20 29 7b 0a 20 20 20 20 50  rgeable ){.    P
5330: 47 72 6f 75 70 20 2a 70 47 72 6f 75 70 20 3d 20  Group *pGroup = 
5340: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3b 0a  pCache->pGroup;.
5350: 20 20 20 20 69 6e 74 20 73 61 76 65 64 4d 61 78      int savedMax
5360: 50 61 67 65 3b 0a 20 20 20 20 70 63 61 63 68 65  Page;.    pcache
5370: 31 45 6e 74 65 72 4d 75 74 65 78 28 70 47 72 6f  1EnterMutex(pGro
5380: 75 70 29 3b 0a 20 20 20 20 73 61 76 65 64 4d 61  up);.    savedMa
5390: 78 50 61 67 65 20 3d 20 70 47 72 6f 75 70 2d 3e  xPage = pGroup->
53a0: 6e 4d 61 78 50 61 67 65 3b 0a 20 20 20 20 70 47  nMaxPage;.    pG
53b0: 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 3d  roup->nMaxPage =
53c0: 20 30 3b 0a 20 20 20 20 70 63 61 63 68 65 31 45   0;.    pcache1E
53d0: 6e 66 6f 72 63 65 4d 61 78 50 61 67 65 28 70 47  nforceMaxPage(pG
53e0: 72 6f 75 70 29 3b 0a 20 20 20 20 70 47 72 6f 75  roup);.    pGrou
53f0: 70 2d 3e 6e 4d 61 78 50 61 67 65 20 3d 20 73 61  p->nMaxPage = sa
5400: 76 65 64 4d 61 78 50 61 67 65 3b 0a 20 20 20 20  vedMaxPage;.    
5410: 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65  pcache1LeaveMute
5420: 78 28 70 47 72 6f 75 70 29 3b 0a 20 20 7d 0a 7d  x(pGroup);.  }.}
5430: 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e  ../*.** Implemen
5440: 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71  tation of the sq
5450: 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78 50 61  lite3_pcache.xPa
5460: 67 65 63 6f 75 6e 74 20 6d 65 74 68 6f 64 2e 20  gecount method. 
5470: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70  .*/.static int p
5480: 63 61 63 68 65 31 50 61 67 65 63 6f 75 6e 74 28  cache1Pagecount(
5490: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a  sqlite3_pcache *
54a0: 70 29 7b 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 50  p){.  int n;.  P
54b0: 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d  Cache1 *pCache =
54c0: 20 28 50 43 61 63 68 65 31 2a 29 70 3b 0a 20 20   (PCache1*)p;.  
54d0: 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65  pcache1EnterMute
54e0: 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70  x(pCache->pGroup
54f0: 29 3b 0a 20 20 6e 20 3d 20 70 43 61 63 68 65 2d  );.  n = pCache-
5500: 3e 6e 50 61 67 65 3b 0a 20 20 70 63 61 63 68 65  >nPage;.  pcache
5510: 31 4c 65 61 76 65 4d 75 74 65 78 28 70 43 61 63  1LeaveMutex(pCac
5520: 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20 72  he->pGroup);.  r
5530: 65 74 75 72 6e 20 6e 3b 0a 7d 0a 0a 0a 2f 2a 0a  eturn n;.}.../*.
5540: 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 20 73 74 65  ** Implement ste
5550: 70 73 20 33 2c 20 34 2c 20 61 6e 64 20 35 20 6f  ps 3, 4, and 5 o
5560: 66 20 74 68 65 20 70 63 61 63 68 65 31 46 65 74  f the pcache1Fet
5570: 63 68 28 29 20 61 6c 67 6f 72 69 74 68 6d 20 64  ch() algorithm d
5580: 65 73 63 72 69 62 65 64 0a 2a 2a 20 69 6e 20 74  escribed.** in t
5590: 68 65 20 68 65 61 64 65 72 20 6f 66 20 74 68 65  he header of the
55a0: 20 70 63 61 63 68 65 31 46 65 74 63 68 28 29 20   pcache1Fetch() 
55b0: 70 72 6f 63 65 64 75 72 65 2e 0a 2a 2a 0a 2a 2a  procedure..**.**
55c0: 20 54 68 69 73 20 73 74 65 70 73 20 61 72 65 20   This steps are 
55d0: 62 72 6f 6b 65 6e 20 6f 75 74 20 69 6e 74 6f 20  broken out into 
55e0: 61 20 73 65 70 61 72 61 74 65 20 70 72 6f 63 65  a separate proce
55f0: 64 75 72 65 20 62 65 63 61 75 73 65 20 74 68 65  dure because the
5600: 79 20 61 72 65 0a 2a 2a 20 75 73 75 61 6c 6c 79  y are.** usually
5610: 20 6e 6f 74 20 6e 65 65 64 65 64 2c 20 61 6e 64   not needed, and
5620: 20 62 79 20 61 76 6f 69 64 69 6e 67 20 74 68 65   by avoiding the
5630: 20 73 74 61 63 6b 20 69 6e 69 74 69 61 6c 69 7a   stack initializ
5640: 61 74 69 6f 6e 20 72 65 71 75 69 72 65 64 0a 2a  ation required.*
5650: 2a 20 66 6f 72 20 74 68 65 73 65 20 73 74 65 70  * for these step
5660: 73 2c 20 74 68 65 20 6d 61 69 6e 20 70 63 61 63  s, the main pcac
5670: 68 65 31 46 65 74 63 68 28 29 20 70 72 6f 63 65  he1Fetch() proce
5680: 64 75 72 65 20 63 61 6e 20 72 75 6e 20 66 61 73  dure can run fas
5690: 74 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 53  ter..*/.static S
56a0: 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20 50  QLITE_NOINLINE P
56b0: 67 48 64 72 31 20 2a 70 63 61 63 68 65 31 46 65  gHdr1 *pcache1Fe
56c0: 74 63 68 53 74 61 67 65 32 28 0a 20 20 50 43 61  tchStage2(.  PCa
56d0: 63 68 65 31 20 2a 70 43 61 63 68 65 2c 20 0a 20  che1 *pCache, . 
56e0: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4b   unsigned int iK
56f0: 65 79 2c 20 0a 20 20 69 6e 74 20 63 72 65 61 74  ey, .  int creat
5700: 65 46 6c 61 67 0a 29 7b 0a 20 20 75 6e 73 69 67  eFlag.){.  unsig
5710: 6e 65 64 20 69 6e 74 20 6e 50 69 6e 6e 65 64 3b  ned int nPinned;
5720: 0a 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f 75  .  PGroup *pGrou
5730: 70 20 3d 20 70 43 61 63 68 65 2d 3e 70 47 72 6f  p = pCache->pGro
5740: 75 70 3b 0a 20 20 50 67 48 64 72 31 20 2a 70 50  up;.  PgHdr1 *pP
5750: 61 67 65 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20 53  age = 0;..  /* S
5760: 74 65 70 20 33 3a 20 41 62 6f 72 74 20 69 66 20  tep 3: Abort if 
5770: 63 72 65 61 74 65 46 6c 61 67 20 69 73 20 31 20  createFlag is 1 
5780: 62 75 74 20 74 68 65 20 63 61 63 68 65 20 69 73  but the cache is
5790: 20 6e 65 61 72 6c 79 20 66 75 6c 6c 20 2a 2f 0a   nearly full */.
57a0: 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65    assert( pCache
57b0: 2d 3e 6e 50 61 67 65 20 3e 3d 20 70 43 61 63 68  ->nPage >= pCach
57c0: 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65 20 29  e->nRecyclable )
57d0: 3b 0a 20 20 6e 50 69 6e 6e 65 64 20 3d 20 70 43  ;.  nPinned = pC
57e0: 61 63 68 65 2d 3e 6e 50 61 67 65 20 2d 20 70 43  ache->nPage - pC
57f0: 61 63 68 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c  ache->nRecyclabl
5800: 65 3b 0a 20 20 61 73 73 65 72 74 28 20 70 47 72  e;.  assert( pGr
5810: 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 3d  oup->mxPinned ==
5820: 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67   pGroup->nMaxPag
5830: 65 20 2b 20 31 30 20 2d 20 70 47 72 6f 75 70 2d  e + 10 - pGroup-
5840: 3e 6e 4d 69 6e 50 61 67 65 20 29 3b 0a 20 20 61  >nMinPage );.  a
5850: 73 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 6e  ssert( pCache->n
5860: 39 30 70 63 74 20 3d 3d 20 70 43 61 63 68 65 2d  90pct == pCache-
5870: 3e 6e 4d 61 78 2a 39 2f 31 30 20 29 3b 0a 20 20  >nMax*9/10 );.  
5880: 69 66 28 20 63 72 65 61 74 65 46 6c 61 67 3d 3d  if( createFlag==
5890: 31 20 26 26 20 28 0a 20 20 20 20 20 20 20 20 6e  1 && (.        n
58a0: 50 69 6e 6e 65 64 3e 3d 70 47 72 6f 75 70 2d 3e  Pinned>=pGroup->
58b0: 6d 78 50 69 6e 6e 65 64 0a 20 20 20 20 20 7c 7c  mxPinned.     ||
58c0: 20 6e 50 69 6e 6e 65 64 3e 3d 70 43 61 63 68 65   nPinned>=pCache
58d0: 2d 3e 6e 39 30 70 63 74 0a 20 20 20 20 20 7c 7c  ->n90pct.     ||
58e0: 20 28 70 63 61 63 68 65 31 55 6e 64 65 72 4d 65   (pcache1UnderMe
58f0: 6d 6f 72 79 50 72 65 73 73 75 72 65 28 70 43 61  moryPressure(pCa
5900: 63 68 65 29 20 26 26 20 70 43 61 63 68 65 2d 3e  che) && pCache->
5910: 6e 52 65 63 79 63 6c 61 62 6c 65 3c 6e 50 69 6e  nRecyclable<nPin
5920: 6e 65 64 29 0a 20 20 29 29 7b 0a 20 20 20 20 72  ned).  )){.    r
5930: 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 0a 20 20  eturn 0;.  }..  
5940: 69 66 28 20 70 43 61 63 68 65 2d 3e 6e 50 61 67  if( pCache->nPag
5950: 65 3e 3d 70 43 61 63 68 65 2d 3e 6e 48 61 73 68  e>=pCache->nHash
5960: 20 29 20 70 63 61 63 68 65 31 52 65 73 69 7a 65   ) pcache1Resize
5970: 48 61 73 68 28 70 43 61 63 68 65 29 3b 0a 20 20  Hash(pCache);.  
5980: 61 73 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e  assert( pCache->
5990: 6e 48 61 73 68 3e 30 20 26 26 20 70 43 61 63 68  nHash>0 && pCach
59a0: 65 2d 3e 61 70 48 61 73 68 20 29 3b 0a 0a 20 20  e->apHash );..  
59b0: 2f 2a 20 53 74 65 70 20 34 2e 20 54 72 79 20 74  /* Step 4. Try t
59c0: 6f 20 72 65 63 79 63 6c 65 20 61 20 70 61 67 65  o recycle a page
59d0: 2e 20 2a 2f 0a 20 20 69 66 28 20 70 43 61 63 68  . */.  if( pCach
59e0: 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 26 26  e->bPurgeable &&
59f0: 20 70 47 72 6f 75 70 2d 3e 70 4c 72 75 54 61 69   pGroup->pLruTai
5a00: 6c 20 26 26 20 28 0a 20 20 20 20 20 20 20 20 20  l && (.         
5a10: 28 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 2b 31  (pCache->nPage+1
5a20: 3e 3d 70 43 61 63 68 65 2d 3e 6e 4d 61 78 29 0a  >=pCache->nMax).
5a30: 20 20 20 20 20 20 7c 7c 20 70 47 72 6f 75 70 2d        || pGroup-
5a40: 3e 6e 43 75 72 72 65 6e 74 50 61 67 65 3e 3d 70  >nCurrentPage>=p
5a50: 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 0a  Group->nMaxPage.
5a60: 20 20 20 20 20 20 7c 7c 20 70 63 61 63 68 65 31        || pcache1
5a70: 55 6e 64 65 72 4d 65 6d 6f 72 79 50 72 65 73 73  UnderMemoryPress
5a80: 75 72 65 28 70 43 61 63 68 65 29 0a 20 20 29 29  ure(pCache).  ))
5a90: 7b 0a 20 20 20 20 50 43 61 63 68 65 31 20 2a 70  {.    PCache1 *p
5aa0: 4f 74 68 65 72 3b 0a 20 20 20 20 70 50 61 67 65  Other;.    pPage
5ab0: 20 3d 20 70 47 72 6f 75 70 2d 3e 70 4c 72 75 54   = pGroup->pLruT
5ac0: 61 69 6c 3b 0a 20 20 20 20 61 73 73 65 72 74 28  ail;.    assert(
5ad0: 20 70 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64   pPage->isPinned
5ae0: 3d 3d 30 20 29 3b 0a 20 20 20 20 70 63 61 63 68  ==0 );.    pcach
5af0: 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73 68  e1RemoveFromHash
5b00: 28 70 50 61 67 65 29 3b 0a 20 20 20 20 70 63 61  (pPage);.    pca
5b10: 63 68 65 31 50 69 6e 50 61 67 65 28 70 50 61 67  che1PinPage(pPag
5b20: 65 29 3b 0a 20 20 20 20 70 4f 74 68 65 72 20 3d  e);.    pOther =
5b30: 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65 3b 0a   pPage->pCache;.
5b40: 0a 20 20 20 20 2f 2a 20 57 65 20 77 61 6e 74 20  .    /* We want 
5b50: 74 6f 20 76 65 72 69 66 79 20 74 68 61 74 20 73  to verify that s
5b60: 7a 50 61 67 65 20 61 6e 64 20 73 7a 45 78 74 72  zPage and szExtr
5b70: 61 20 61 72 65 20 74 68 65 20 73 61 6d 65 20 66  a are the same f
5b80: 6f 72 20 70 4f 74 68 65 72 0a 20 20 20 20 2a 2a  or pOther.    **
5b90: 20 61 6e 64 20 70 43 61 63 68 65 2e 20 20 41 73   and pCache.  As
5ba0: 73 65 72 74 20 74 68 61 74 20 77 65 20 63 61 6e  sert that we can
5bb0: 20 76 65 72 69 66 79 20 74 68 69 73 20 62 79 20   verify this by 
5bc0: 63 6f 6d 70 61 72 69 6e 67 20 73 75 6d 73 2e 20  comparing sums. 
5bd0: 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 28  */.    assert( (
5be0: 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 20 26  pCache->szPage &
5bf0: 20 28 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65   (pCache->szPage
5c00: 2d 31 29 29 3d 3d 30 20 26 26 20 70 43 61 63 68  -1))==0 && pCach
5c10: 65 2d 3e 73 7a 50 61 67 65 3e 3d 35 31 32 20 29  e->szPage>=512 )
5c20: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 43  ;.    assert( pC
5c30: 61 63 68 65 2d 3e 73 7a 45 78 74 72 61 3c 35 31  ache->szExtra<51
5c40: 32 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28  2 );.    assert(
5c50: 20 28 70 4f 74 68 65 72 2d 3e 73 7a 50 61 67 65   (pOther->szPage
5c60: 20 26 20 28 70 4f 74 68 65 72 2d 3e 73 7a 50 61   & (pOther->szPa
5c70: 67 65 2d 31 29 29 3d 3d 30 20 26 26 20 70 4f 74  ge-1))==0 && pOt
5c80: 68 65 72 2d 3e 73 7a 50 61 67 65 3e 3d 35 31 32  her->szPage>=512
5c90: 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20   );.    assert( 
5ca0: 70 4f 74 68 65 72 2d 3e 73 7a 45 78 74 72 61 3c  pOther->szExtra<
5cb0: 35 31 32 20 29 3b 0a 0a 20 20 20 20 69 66 28 20  512 );..    if( 
5cc0: 70 4f 74 68 65 72 2d 3e 73 7a 50 61 67 65 2b 70  pOther->szPage+p
5cd0: 4f 74 68 65 72 2d 3e 73 7a 45 78 74 72 61 20 21  Other->szExtra !
5ce0: 3d 20 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65  = pCache->szPage
5cf0: 2b 70 43 61 63 68 65 2d 3e 73 7a 45 78 74 72 61  +pCache->szExtra
5d00: 20 29 7b 0a 20 20 20 20 20 20 70 63 61 63 68 65   ){.      pcache
5d10: 31 46 72 65 65 50 61 67 65 28 70 50 61 67 65 29  1FreePage(pPage)
5d20: 3b 0a 20 20 20 20 20 20 70 50 61 67 65 20 3d 20  ;.      pPage = 
5d30: 30 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  0;.    }else{.  
5d40: 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e 43 75 72      pGroup->nCur
5d50: 72 65 6e 74 50 61 67 65 20 2d 3d 20 28 70 4f 74  rentPage -= (pOt
5d60: 68 65 72 2d 3e 62 50 75 72 67 65 61 62 6c 65 20  her->bPurgeable 
5d70: 2d 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65  - pCache->bPurge
5d80: 61 62 6c 65 29 3b 0a 20 20 20 20 7d 0a 20 20 7d  able);.    }.  }
5d90: 0a 0a 20 20 2f 2a 20 53 74 65 70 20 35 2e 20 49  ..  /* Step 5. I
5da0: 66 20 61 20 75 73 61 62 6c 65 20 70 61 67 65 20  f a usable page 
5db0: 62 75 66 66 65 72 20 68 61 73 20 73 74 69 6c 6c  buffer has still
5dc0: 20 6e 6f 74 20 62 65 65 6e 20 66 6f 75 6e 64 2c   not been found,
5dd0: 20 0a 20 20 2a 2a 20 61 74 74 65 6d 70 74 20 74   .  ** attempt t
5de0: 6f 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77  o allocate a new
5df0: 20 6f 6e 65 2e 20 0a 20 20 2a 2f 0a 20 20 69 66   one. .  */.  if
5e00: 28 20 21 70 50 61 67 65 20 29 7b 0a 20 20 20 20  ( !pPage ){.    
5e10: 69 66 28 20 63 72 65 61 74 65 46 6c 61 67 3d 3d  if( createFlag==
5e20: 31 20 29 20 73 71 6c 69 74 65 33 42 65 67 69 6e  1 ) sqlite3Begin
5e30: 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a  BenignMalloc();.
5e40: 20 20 20 20 70 50 61 67 65 20 3d 20 70 63 61 63      pPage = pcac
5e50: 68 65 31 41 6c 6c 6f 63 50 61 67 65 28 70 43 61  he1AllocPage(pCa
5e60: 63 68 65 29 3b 0a 20 20 20 20 69 66 28 20 63 72  che);.    if( cr
5e70: 65 61 74 65 46 6c 61 67 3d 3d 31 20 29 20 73 71  eateFlag==1 ) sq
5e80: 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d 61  lite3EndBenignMa
5e90: 6c 6c 6f 63 28 29 3b 0a 20 20 7d 0a 0a 20 20 69  lloc();.  }..  i
5ea0: 66 28 20 70 50 61 67 65 20 29 7b 0a 20 20 20 20  f( pPage ){.    
5eb0: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 68 20 3d  unsigned int h =
5ec0: 20 69 4b 65 79 20 25 20 70 43 61 63 68 65 2d 3e   iKey % pCache->
5ed0: 6e 48 61 73 68 3b 0a 20 20 20 20 70 43 61 63 68  nHash;.    pCach
5ee0: 65 2d 3e 6e 50 61 67 65 2b 2b 3b 0a 20 20 20 20  e->nPage++;.    
5ef0: 70 50 61 67 65 2d 3e 69 4b 65 79 20 3d 20 69 4b  pPage->iKey = iK
5f00: 65 79 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 70  ey;.    pPage->p
5f10: 4e 65 78 74 20 3d 20 70 43 61 63 68 65 2d 3e 61  Next = pCache->a
5f20: 70 48 61 73 68 5b 68 5d 3b 0a 20 20 20 20 70 50  pHash[h];.    pP
5f30: 61 67 65 2d 3e 70 43 61 63 68 65 20 3d 20 70 43  age->pCache = pC
5f40: 61 63 68 65 3b 0a 20 20 20 20 70 50 61 67 65 2d  ache;.    pPage-
5f50: 3e 70 4c 72 75 50 72 65 76 20 3d 20 30 3b 0a 20  >pLruPrev = 0;. 
5f60: 20 20 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65     pPage->pLruNe
5f70: 78 74 20 3d 20 30 3b 0a 20 20 20 20 70 50 61 67  xt = 0;.    pPag
5f80: 65 2d 3e 69 73 50 69 6e 6e 65 64 20 3d 20 31 3b  e->isPinned = 1;
5f90: 0a 20 20 20 20 2a 28 76 6f 69 64 20 2a 2a 29 70  .    *(void **)p
5fa0: 50 61 67 65 2d 3e 70 61 67 65 2e 70 45 78 74 72  Page->page.pExtr
5fb0: 61 20 3d 20 30 3b 0a 20 20 20 20 70 43 61 63 68  a = 0;.    pCach
5fc0: 65 2d 3e 61 70 48 61 73 68 5b 68 5d 20 3d 20 70  e->apHash[h] = p
5fd0: 50 61 67 65 3b 0a 20 20 20 20 69 66 28 20 69 4b  Page;.    if( iK
5fe0: 65 79 3e 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b  ey>pCache->iMaxK
5ff0: 65 79 20 29 7b 0a 20 20 20 20 20 20 70 43 61 63  ey ){.      pCac
6000: 68 65 2d 3e 69 4d 61 78 4b 65 79 20 3d 20 69 4b  he->iMaxKey = iK
6010: 65 79 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20  ey;.    }.  }.  
6020: 72 65 74 75 72 6e 20 70 50 61 67 65 3b 0a 7d 0a  return pPage;.}.
6030: 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74  ./*.** Implement
6040: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c  ation of the sql
6050: 69 74 65 33 5f 70 63 61 63 68 65 2e 78 46 65 74  ite3_pcache.xFet
6060: 63 68 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a  ch method. .**.*
6070: 2a 20 46 65 74 63 68 20 61 20 70 61 67 65 20 62  * Fetch a page b
6080: 79 20 6b 65 79 20 76 61 6c 75 65 2e 0a 2a 2a 0a  y key value..**.
6090: 2a 2a 20 57 68 65 74 68 65 72 20 6f 72 20 6e 6f  ** Whether or no
60a0: 74 20 61 20 6e 65 77 20 70 61 67 65 20 6d 61 79  t a new page may
60b0: 20 62 65 20 61 6c 6c 6f 63 61 74 65 64 20 62 79   be allocated by
60c0: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 64   this function d
60d0: 65 70 65 6e 64 73 20 6f 6e 0a 2a 2a 20 74 68 65  epends on.** the
60e0: 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 63 72   value of the cr
60f0: 65 61 74 65 46 6c 61 67 20 61 72 67 75 6d 65 6e  eateFlag argumen
6100: 74 2e 20 20 30 20 6d 65 61 6e 73 20 64 6f 20 6e  t.  0 means do n
6110: 6f 74 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65  ot allocate a ne
6120: 77 0a 2a 2a 20 70 61 67 65 2e 20 20 31 20 6d 65  w.** page.  1 me
6130: 61 6e 73 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e  ans allocate a n
6140: 65 77 20 70 61 67 65 20 69 66 20 73 70 61 63 65  ew page if space
6150: 20 69 73 20 65 61 73 69 6c 79 20 61 76 61 69 6c   is easily avail
6160: 61 62 6c 65 2e 20 20 32 20 0a 2a 2a 20 6d 65 61  able.  2 .** mea
6170: 6e 73 20 74 6f 20 74 72 79 20 72 65 61 6c 6c 79  ns to try really
6180: 20 68 61 72 64 20 74 6f 20 61 6c 6c 6f 63 61 74   hard to allocat
6190: 65 20 61 20 6e 65 77 20 70 61 67 65 2e 0a 2a 2a  e a new page..**
61a0: 0a 2a 2a 20 46 6f 72 20 61 20 6e 6f 6e 2d 70 75  .** For a non-pu
61b0: 72 67 65 61 62 6c 65 20 63 61 63 68 65 20 28 61  rgeable cache (a
61c0: 20 63 61 63 68 65 20 75 73 65 64 20 61 73 20 74   cache used as t
61d0: 68 65 20 73 74 6f 72 61 67 65 20 66 6f 72 20 61  he storage for a
61e0: 6e 20 69 6e 2d 6d 65 6d 6f 72 79 0a 2a 2a 20 64  n in-memory.** d
61f0: 61 74 61 62 61 73 65 29 20 74 68 65 72 65 20 69  atabase) there i
6200: 73 20 72 65 61 6c 6c 79 20 6e 6f 20 64 69 66 66  s really no diff
6210: 65 72 65 6e 63 65 20 62 65 74 77 65 65 6e 20 63  erence between c
6220: 72 65 61 74 65 46 6c 61 67 20 31 20 61 6e 64 20  reateFlag 1 and 
6230: 32 2e 20 20 53 6f 0a 2a 2a 20 74 68 65 20 63 61  2.  So.** the ca
6240: 6c 6c 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 28  lling function (
6250: 70 63 61 63 68 65 2e 63 29 20 77 69 6c 6c 20 6e  pcache.c) will n
6260: 65 76 65 72 20 68 61 76 65 20 61 20 63 72 65 61  ever have a crea
6270: 74 65 46 6c 61 67 20 6f 66 20 31 20 6f 6e 0a 2a  teFlag of 1 on.*
6280: 2a 20 61 20 6e 6f 6e 2d 70 75 72 67 65 61 62 6c  * a non-purgeabl
6290: 65 20 63 61 63 68 65 2e 0a 2a 2a 0a 2a 2a 20 54  e cache..**.** T
62a0: 68 65 72 65 20 61 72 65 20 74 68 72 65 65 20 64  here are three d
62b0: 69 66 66 65 72 65 6e 74 20 61 70 70 72 6f 61 63  ifferent approac
62c0: 68 65 73 20 74 6f 20 6f 62 74 61 69 6e 69 6e 67  hes to obtaining
62d0: 20 73 70 61 63 65 20 66 6f 72 20 61 20 70 61 67   space for a pag
62e0: 65 2c 0a 2a 2a 20 64 65 70 65 6e 64 69 6e 67 20  e,.** depending 
62f0: 6f 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20  on the value of 
6300: 70 61 72 61 6d 65 74 65 72 20 63 72 65 61 74 65  parameter create
6310: 46 6c 61 67 20 28 77 68 69 63 68 20 6d 61 79 20  Flag (which may 
6320: 62 65 20 30 2c 20 31 20 6f 72 20 32 29 2e 0a 2a  be 0, 1 or 2)..*
6330: 2a 0a 2a 2a 20 20 20 31 2e 20 52 65 67 61 72 64  *.**   1. Regard
6340: 6c 65 73 73 20 6f 66 20 74 68 65 20 76 61 6c 75  less of the valu
6350: 65 20 6f 66 20 63 72 65 61 74 65 46 6c 61 67 2c  e of createFlag,
6360: 20 74 68 65 20 63 61 63 68 65 20 69 73 20 73 65   the cache is se
6370: 61 72 63 68 65 64 20 66 6f 72 20 61 20 0a 2a 2a  arched for a .**
6380: 20 20 20 20 20 20 63 6f 70 79 20 6f 66 20 74 68        copy of th
6390: 65 20 72 65 71 75 65 73 74 65 64 20 70 61 67 65  e requested page
63a0: 2e 20 49 66 20 6f 6e 65 20 69 73 20 66 6f 75 6e  . If one is foun
63b0: 64 2c 20 69 74 20 69 73 20 72 65 74 75 72 6e 65  d, it is returne
63c0: 64 2e 0a 2a 2a 0a 2a 2a 20 20 20 32 2e 20 49 66  d..**.**   2. If
63d0: 20 63 72 65 61 74 65 46 6c 61 67 3d 3d 30 20 61   createFlag==0 a
63e0: 6e 64 20 74 68 65 20 70 61 67 65 20 69 73 20 6e  nd the page is n
63f0: 6f 74 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68  ot already in th
6400: 65 20 63 61 63 68 65 2c 20 4e 55 4c 4c 20 69 73  e cache, NULL is
6410: 0a 2a 2a 20 20 20 20 20 20 72 65 74 75 72 6e 65  .**      returne
6420: 64 2e 0a 2a 2a 0a 2a 2a 20 20 20 33 2e 20 49 66  d..**.**   3. If
6430: 20 63 72 65 61 74 65 46 6c 61 67 20 69 73 20 31   createFlag is 1
6440: 2c 20 61 6e 64 20 74 68 65 20 70 61 67 65 20 69  , and the page i
6450: 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 69 6e  s not already in
6460: 20 74 68 65 20 63 61 63 68 65 2c 20 74 68 65 6e   the cache, then
6470: 0a 2a 2a 20 20 20 20 20 20 72 65 74 75 72 6e 20  .**      return 
6480: 4e 55 4c 4c 20 28 64 6f 20 6e 6f 74 20 61 6c 6c  NULL (do not all
6490: 6f 63 61 74 65 20 61 20 6e 65 77 20 70 61 67 65  ocate a new page
64a0: 29 20 69 66 20 61 6e 79 20 6f 66 20 74 68 65 20  ) if any of the 
64b0: 66 6f 6c 6c 6f 77 69 6e 67 0a 2a 2a 20 20 20 20  following.**    
64c0: 20 20 63 6f 6e 64 69 74 69 6f 6e 73 20 61 72 65    conditions are
64d0: 20 74 72 75 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20   true:.**.**    
64e0: 20 20 20 28 61 29 20 74 68 65 20 6e 75 6d 62 65     (a) the numbe
64f0: 72 20 6f 66 20 70 61 67 65 73 20 70 69 6e 6e 65  r of pages pinne
6500: 64 20 62 79 20 74 68 65 20 63 61 63 68 65 20 69  d by the cache i
6510: 73 20 67 72 65 61 74 65 72 20 74 68 61 6e 0a 2a  s greater than.*
6520: 2a 20 20 20 20 20 20 20 20 20 20 20 50 43 61 63  *           PCac
6530: 68 65 31 2e 6e 4d 61 78 2c 20 6f 72 0a 2a 2a 0a  he1.nMax, or.**.
6540: 2a 2a 20 20 20 20 20 20 20 28 62 29 20 74 68 65  **       (b) the
6550: 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73   number of pages
6560: 20 70 69 6e 6e 65 64 20 62 79 20 74 68 65 20 63   pinned by the c
6570: 61 63 68 65 20 69 73 20 67 72 65 61 74 65 72 20  ache is greater 
6580: 74 68 61 6e 0a 2a 2a 20 20 20 20 20 20 20 20 20  than.**         
6590: 20 20 74 68 65 20 73 75 6d 20 6f 66 20 6e 4d 61    the sum of nMa
65a0: 78 20 66 6f 72 20 61 6c 6c 20 70 75 72 67 65 61  x for all purgea
65b0: 62 6c 65 20 63 61 63 68 65 73 2c 20 6c 65 73 73  ble caches, less
65c0: 20 74 68 65 20 73 75 6d 20 6f 66 20 0a 2a 2a 20   the sum of .** 
65d0: 20 20 20 20 20 20 20 20 20 20 6e 4d 69 6e 20 66            nMin f
65e0: 6f 72 20 61 6c 6c 20 6f 74 68 65 72 20 70 75 72  or all other pur
65f0: 67 65 61 62 6c 65 20 63 61 63 68 65 73 2c 20 6f  geable caches, o
6600: 72 0a 2a 2a 0a 2a 2a 20 20 20 34 2e 20 49 66 20  r.**.**   4. If 
6610: 6e 6f 6e 65 20 6f 66 20 74 68 65 20 66 69 72 73  none of the firs
6620: 74 20 74 68 72 65 65 20 63 6f 6e 64 69 74 69 6f  t three conditio
6630: 6e 73 20 61 70 70 6c 79 20 61 6e 64 20 74 68 65  ns apply and the
6640: 20 63 61 63 68 65 20 69 73 20 6d 61 72 6b 65 64   cache is marked
6650: 0a 2a 2a 20 20 20 20 20 20 61 73 20 70 75 72 67  .**      as purg
6660: 65 61 62 6c 65 2c 20 61 6e 64 20 69 66 20 6f 6e  eable, and if on
6670: 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69  e of the followi
6680: 6e 67 20 69 73 20 74 72 75 65 3a 0a 2a 2a 0a 2a  ng is true:.**.*
6690: 2a 20 20 20 20 20 20 20 28 61 29 20 54 68 65 20  *       (a) The 
66a0: 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20  number of pages 
66b0: 61 6c 6c 6f 63 61 74 65 64 20 66 6f 72 20 74 68  allocated for th
66c0: 65 20 63 61 63 68 65 20 69 73 20 61 6c 72 65 61  e cache is alrea
66d0: 64 79 20 0a 2a 2a 20 20 20 20 20 20 20 20 20 20  dy .**          
66e0: 20 50 43 61 63 68 65 31 2e 6e 4d 61 78 2c 20 6f   PCache1.nMax, o
66f0: 72 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 28 62  r.**.**       (b
6700: 29 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  ) The number of 
6710: 70 61 67 65 73 20 61 6c 6c 6f 63 61 74 65 64 20  pages allocated 
6720: 66 6f 72 20 61 6c 6c 20 70 75 72 67 65 61 62 6c  for all purgeabl
6730: 65 20 63 61 63 68 65 73 20 69 73 0a 2a 2a 20 20  e caches is.**  
6740: 20 20 20 20 20 20 20 20 20 61 6c 72 65 61 64 79           already
6750: 20 65 71 75 61 6c 20 74 6f 20 6f 72 20 67 72 65   equal to or gre
6760: 61 74 65 72 20 74 68 61 6e 20 74 68 65 20 73 75  ater than the su
6770: 6d 20 6f 66 20 6e 4d 61 78 20 66 6f 72 20 61 6c  m of nMax for al
6780: 6c 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 70  l.**           p
6790: 75 72 67 65 61 62 6c 65 20 63 61 63 68 65 73 2c  urgeable caches,
67a0: 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 28 63 29  .**.**       (c)
67b0: 20 54 68 65 20 73 79 73 74 65 6d 20 69 73 20 75   The system is u
67c0: 6e 64 65 72 20 6d 65 6d 6f 72 79 20 70 72 65 73  nder memory pres
67d0: 73 75 72 65 20 61 6e 64 20 77 61 6e 74 73 20 74  sure and wants t
67e0: 6f 20 61 76 6f 69 64 0a 2a 2a 20 20 20 20 20 20  o avoid.**      
67f0: 20 20 20 20 20 75 6e 6e 65 63 65 73 73 61 72 79       unnecessary
6800: 20 70 61 67 65 73 20 63 61 63 68 65 20 65 6e 74   pages cache ent
6810: 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 0a 2a  ry allocations.*
6820: 2a 0a 2a 2a 20 20 20 20 20 20 74 68 65 6e 20 61  *.**      then a
6830: 74 74 65 6d 70 74 20 74 6f 20 72 65 63 79 63 6c  ttempt to recycl
6840: 65 20 61 20 70 61 67 65 20 66 72 6f 6d 20 74 68  e a page from th
6850: 65 20 4c 52 55 20 6c 69 73 74 2e 20 49 66 20 69  e LRU list. If i
6860: 74 20 69 73 20 74 68 65 20 72 69 67 68 74 0a 2a  t is the right.*
6870: 2a 20 20 20 20 20 20 73 69 7a 65 2c 20 72 65 74  *      size, ret
6880: 75 72 6e 20 74 68 65 20 72 65 63 79 63 6c 65 64  urn the recycled
6890: 20 62 75 66 66 65 72 2e 20 4f 74 68 65 72 77 69   buffer. Otherwi
68a0: 73 65 2c 20 66 72 65 65 20 74 68 65 20 62 75 66  se, free the buf
68b0: 66 65 72 20 61 6e 64 0a 2a 2a 20 20 20 20 20 20  fer and.**      
68c0: 70 72 6f 63 65 65 64 20 74 6f 20 73 74 65 70 20  proceed to step 
68d0: 35 2e 20 0a 2a 2a 0a 2a 2a 20 20 20 35 2e 20 4f  5. .**.**   5. O
68e0: 74 68 65 72 77 69 73 65 2c 20 61 6c 6c 6f 63 61  therwise, alloca
68f0: 74 65 20 61 6e 64 20 72 65 74 75 72 6e 20 61 20  te and return a 
6900: 6e 65 77 20 70 61 67 65 20 62 75 66 66 65 72 2e  new page buffer.
6910: 0a 2a 2f 0a 73 74 61 74 69 63 20 73 71 6c 69 74  .*/.static sqlit
6920: 65 33 5f 70 63 61 63 68 65 5f 70 61 67 65 20 2a  e3_pcache_page *
6930: 70 63 61 63 68 65 31 46 65 74 63 68 28 0a 20 20  pcache1Fetch(.  
6940: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a  sqlite3_pcache *
6950: 70 2c 20 0a 20 20 75 6e 73 69 67 6e 65 64 20 69  p, .  unsigned i
6960: 6e 74 20 69 4b 65 79 2c 20 0a 20 20 69 6e 74 20  nt iKey, .  int 
6970: 63 72 65 61 74 65 46 6c 61 67 0a 29 7b 0a 20 20  createFlag.){.  
6980: 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 20  PCache1 *pCache 
6990: 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b 0a  = (PCache1 *)p;.
69a0: 20 20 50 67 48 64 72 31 20 2a 70 50 61 67 65 20    PgHdr1 *pPage 
69b0: 3d 20 30 3b 0a 0a 20 20 61 73 73 65 72 74 28 20  = 0;..  assert( 
69c0: 6f 66 66 73 65 74 6f 66 28 50 67 48 64 72 31 2c  offsetof(PgHdr1,
69d0: 70 61 67 65 29 3d 3d 30 20 29 3b 0a 20 20 61 73  page)==0 );.  as
69e0: 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 62 50  sert( pCache->bP
69f0: 75 72 67 65 61 62 6c 65 20 7c 7c 20 63 72 65 61  urgeable || crea
6a00: 74 65 46 6c 61 67 21 3d 31 20 29 3b 0a 20 20 61  teFlag!=1 );.  a
6a10: 73 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 62  ssert( pCache->b
6a20: 50 75 72 67 65 61 62 6c 65 20 7c 7c 20 70 43 61  Purgeable || pCa
6a30: 63 68 65 2d 3e 6e 4d 69 6e 3d 3d 30 20 29 3b 0a  che->nMin==0 );.
6a40: 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65    assert( pCache
6a50: 2d 3e 62 50 75 72 67 65 61 62 6c 65 3d 3d 30 20  ->bPurgeable==0 
6a60: 7c 7c 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 3d  || pCache->nMin=
6a70: 3d 31 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28  =10 );.  assert(
6a80: 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 3d 3d 30   pCache->nMin==0
6a90: 20 7c 7c 20 70 43 61 63 68 65 2d 3e 62 50 75 72   || pCache->bPur
6aa0: 67 65 61 62 6c 65 20 29 3b 0a 20 20 61 73 73 65  geable );.  asse
6ab0: 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 48 61 73  rt( pCache->nHas
6ac0: 68 3e 30 20 29 3b 0a 20 20 70 63 61 63 68 65 31  h>0 );.  pcache1
6ad0: 45 6e 74 65 72 4d 75 74 65 78 28 70 43 61 63 68  EnterMutex(pCach
6ae0: 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 0a 20 20 2f  e->pGroup);..  /
6af0: 2a 20 53 74 65 70 20 31 3a 20 53 65 61 72 63 68  * Step 1: Search
6b00: 20 74 68 65 20 68 61 73 68 20 74 61 62 6c 65 20   the hash table 
6b10: 66 6f 72 20 61 6e 20 65 78 69 73 74 69 6e 67 20  for an existing 
6b20: 65 6e 74 72 79 2e 20 2a 2f 0a 20 20 70 50 61 67  entry. */.  pPag
6b30: 65 20 3d 20 70 43 61 63 68 65 2d 3e 61 70 48 61  e = pCache->apHa
6b40: 73 68 5b 69 4b 65 79 20 25 20 70 43 61 63 68 65  sh[iKey % pCache
6b50: 2d 3e 6e 48 61 73 68 5d 3b 0a 20 20 77 68 69 6c  ->nHash];.  whil
6b60: 65 28 20 70 50 61 67 65 20 26 26 20 70 50 61 67  e( pPage && pPag
6b70: 65 2d 3e 69 4b 65 79 21 3d 69 4b 65 79 20 29 7b  e->iKey!=iKey ){
6b80: 20 70 50 61 67 65 20 3d 20 70 50 61 67 65 2d 3e   pPage = pPage->
6b90: 70 4e 65 78 74 3b 20 7d 0a 0a 20 20 2f 2a 20 53  pNext; }..  /* S
6ba0: 74 65 70 20 32 3a 20 41 62 6f 72 74 20 69 66 20  tep 2: Abort if 
6bb0: 6e 6f 20 65 78 69 73 74 69 6e 67 20 70 61 67 65  no existing page
6bc0: 20 69 73 20 66 6f 75 6e 64 20 61 6e 64 20 63 72   is found and cr
6bd0: 65 61 74 65 46 6c 61 67 20 69 73 20 30 20 2a 2f  eateFlag is 0 */
6be0: 0a 20 20 69 66 28 20 70 50 61 67 65 20 29 7b 0a  .  if( pPage ){.
6bf0: 20 20 20 20 69 66 28 20 21 70 50 61 67 65 2d 3e      if( !pPage->
6c00: 69 73 50 69 6e 6e 65 64 20 29 20 70 63 61 63 68  isPinned ) pcach
6c10: 65 31 50 69 6e 50 61 67 65 28 70 50 61 67 65 29  e1PinPage(pPage)
6c20: 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 63 72  ;.  }else if( cr
6c30: 65 61 74 65 46 6c 61 67 20 29 7b 0a 20 20 20 20  eateFlag ){.    
6c40: 2f 2a 20 53 74 65 70 73 20 33 2c 20 34 2c 20 61  /* Steps 3, 4, a
6c50: 6e 64 20 35 20 69 6d 70 6c 65 6d 65 6e 74 65 64  nd 5 implemented
6c60: 20 62 79 20 74 68 69 73 20 73 75 62 72 6f 75 74   by this subrout
6c70: 69 6e 65 20 2a 2f 0a 20 20 20 20 70 50 61 67 65  ine */.    pPage
6c80: 20 3d 20 70 63 61 63 68 65 31 46 65 74 63 68 53   = pcache1FetchS
6c90: 74 61 67 65 32 28 70 43 61 63 68 65 2c 20 69 4b  tage2(pCache, iK
6ca0: 65 79 2c 20 63 72 65 61 74 65 46 6c 61 67 29 3b  ey, createFlag);
6cb0: 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70  .  }.  assert( p
6cc0: 50 61 67 65 3d 3d 30 20 7c 7c 20 70 43 61 63 68  Page==0 || pCach
6cd0: 65 2d 3e 69 4d 61 78 4b 65 79 3e 3d 69 4b 65 79  e->iMaxKey>=iKey
6ce0: 20 29 3b 0a 20 20 70 63 61 63 68 65 31 4c 65 61   );.  pcache1Lea
6cf0: 76 65 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e  veMutex(pCache->
6d00: 70 47 72 6f 75 70 29 3b 0a 20 20 72 65 74 75 72  pGroup);.  retur
6d10: 6e 20 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68  n (sqlite3_pcach
6d20: 65 5f 70 61 67 65 2a 29 70 50 61 67 65 3b 0a 7d  e_page*)pPage;.}
6d30: 0a 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65  .../*.** Impleme
6d40: 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73  ntation of the s
6d50: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78 55  qlite3_pcache.xU
6d60: 6e 70 69 6e 20 6d 65 74 68 6f 64 2e 0a 2a 2a 0a  npin method..**.
6d70: 2a 2a 20 4d 61 72 6b 20 61 20 70 61 67 65 20 61  ** Mark a page a
6d80: 73 20 75 6e 70 69 6e 6e 65 64 20 28 65 6c 69 67  s unpinned (elig
6d90: 69 62 6c 65 20 66 6f 72 20 61 73 79 6e 63 68 72  ible for asynchr
6da0: 6f 6e 6f 75 73 20 72 65 63 79 63 6c 69 6e 67 29  onous recycling)
6db0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
6dc0: 20 70 63 61 63 68 65 31 55 6e 70 69 6e 28 0a 20   pcache1Unpin(. 
6dd0: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20   sqlite3_pcache 
6de0: 2a 70 2c 20 0a 20 20 73 71 6c 69 74 65 33 5f 70  *p, .  sqlite3_p
6df0: 63 61 63 68 65 5f 70 61 67 65 20 2a 70 50 67 2c  cache_page *pPg,
6e00: 20 0a 20 20 69 6e 74 20 72 65 75 73 65 55 6e 6c   .  int reuseUnl
6e10: 69 6b 65 6c 79 0a 29 7b 0a 20 20 50 43 61 63 68  ikely.){.  PCach
6e20: 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43  e1 *pCache = (PC
6e30: 61 63 68 65 31 20 2a 29 70 3b 0a 20 20 50 67 48  ache1 *)p;.  PgH
6e40: 64 72 31 20 2a 70 50 61 67 65 20 3d 20 28 50 67  dr1 *pPage = (Pg
6e50: 48 64 72 31 20 2a 29 70 50 67 3b 0a 20 20 50 47  Hdr1 *)pPg;.  PG
6e60: 72 6f 75 70 20 2a 70 47 72 6f 75 70 20 3d 20 70  roup *pGroup = p
6e70: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20  Cache->pGroup;. 
6e80: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65  .  assert( pPage
6e90: 2d 3e 70 43 61 63 68 65 3d 3d 70 43 61 63 68 65  ->pCache==pCache
6ea0: 20 29 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 74   );.  pcache1Ent
6eb0: 65 72 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b  erMutex(pGroup);
6ec0: 0a 0a 20 20 2f 2a 20 49 74 20 69 73 20 61 6e 20  ..  /* It is an 
6ed0: 65 72 72 6f 72 20 74 6f 20 63 61 6c 6c 20 74 68  error to call th
6ee0: 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 66 20 74  is function if t
6ef0: 68 65 20 70 61 67 65 20 69 73 20 61 6c 72 65 61  he page is alrea
6f00: 64 79 20 0a 20 20 2a 2a 20 70 61 72 74 20 6f 66  dy .  ** part of
6f10: 20 74 68 65 20 50 47 72 6f 75 70 20 4c 52 55 20   the PGroup LRU 
6f20: 6c 69 73 74 2e 0a 20 20 2a 2f 0a 20 20 61 73 73  list..  */.  ass
6f30: 65 72 74 28 20 70 50 61 67 65 2d 3e 70 4c 72 75  ert( pPage->pLru
6f40: 50 72 65 76 3d 3d 30 20 26 26 20 70 50 61 67 65  Prev==0 && pPage
6f50: 2d 3e 70 4c 72 75 4e 65 78 74 3d 3d 30 20 29 3b  ->pLruNext==0 );
6f60: 0a 20 20 61 73 73 65 72 74 28 20 70 47 72 6f 75  .  assert( pGrou
6f70: 70 2d 3e 70 4c 72 75 48 65 61 64 21 3d 70 50 61  p->pLruHead!=pPa
6f80: 67 65 20 26 26 20 70 47 72 6f 75 70 2d 3e 70 4c  ge && pGroup->pL
6f90: 72 75 54 61 69 6c 21 3d 70 50 61 67 65 20 29 3b  ruTail!=pPage );
6fa0: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65  .  assert( pPage
6fb0: 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d 31 20 29 3b  ->isPinned==1 );
6fc0: 0a 0a 20 20 69 66 28 20 72 65 75 73 65 55 6e 6c  ..  if( reuseUnl
6fd0: 69 6b 65 6c 79 20 7c 7c 20 70 47 72 6f 75 70 2d  ikely || pGroup-
6fe0: 3e 6e 43 75 72 72 65 6e 74 50 61 67 65 3e 70 47  >nCurrentPage>pG
6ff0: 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 29  roup->nMaxPage )
7000: 7b 0a 20 20 20 20 70 63 61 63 68 65 31 52 65 6d  {.    pcache1Rem
7010: 6f 76 65 46 72 6f 6d 48 61 73 68 28 70 50 61 67  oveFromHash(pPag
7020: 65 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 46  e);.    pcache1F
7030: 72 65 65 50 61 67 65 28 70 50 61 67 65 29 3b 0a  reePage(pPage);.
7040: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20    }else{.    /* 
7050: 41 64 64 20 74 68 65 20 70 61 67 65 20 74 6f 20  Add the page to 
7060: 74 68 65 20 50 47 72 6f 75 70 20 4c 52 55 20 6c  the PGroup LRU l
7070: 69 73 74 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20  ist. */.    if( 
7080: 70 47 72 6f 75 70 2d 3e 70 4c 72 75 48 65 61 64  pGroup->pLruHead
7090: 20 29 7b 0a 20 20 20 20 20 20 70 47 72 6f 75 70   ){.      pGroup
70a0: 2d 3e 70 4c 72 75 48 65 61 64 2d 3e 70 4c 72 75  ->pLruHead->pLru
70b0: 50 72 65 76 20 3d 20 70 50 61 67 65 3b 0a 20 20  Prev = pPage;.  
70c0: 20 20 20 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e      pPage->pLruN
70d0: 65 78 74 20 3d 20 70 47 72 6f 75 70 2d 3e 70 4c  ext = pGroup->pL
70e0: 72 75 48 65 61 64 3b 0a 20 20 20 20 20 20 70 47  ruHead;.      pG
70f0: 72 6f 75 70 2d 3e 70 4c 72 75 48 65 61 64 20 3d  roup->pLruHead =
7100: 20 70 50 61 67 65 3b 0a 20 20 20 20 7d 65 6c 73   pPage;.    }els
7110: 65 7b 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d  e{.      pGroup-
7120: 3e 70 4c 72 75 54 61 69 6c 20 3d 20 70 50 61 67  >pLruTail = pPag
7130: 65 3b 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d  e;.      pGroup-
7140: 3e 70 4c 72 75 48 65 61 64 20 3d 20 70 50 61 67  >pLruHead = pPag
7150: 65 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 43 61  e;.    }.    pCa
7160: 63 68 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65  che->nRecyclable
7170: 2b 2b 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69  ++;.    pPage->i
7180: 73 50 69 6e 6e 65 64 20 3d 20 30 3b 0a 20 20 7d  sPinned = 0;.  }
7190: 0a 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76 65  ..  pcache1Leave
71a0: 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47  Mutex(pCache->pG
71b0: 72 6f 75 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  roup);.}../*.** 
71c0: 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  Implementation o
71d0: 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63  f the sqlite3_pc
71e0: 61 63 68 65 2e 78 52 65 6b 65 79 20 6d 65 74 68  ache.xRekey meth
71f0: 6f 64 2e 20 0a 2a 2f 0a 73 74 61 74 69 63 20 76  od. .*/.static v
7200: 6f 69 64 20 70 63 61 63 68 65 31 52 65 6b 65 79  oid pcache1Rekey
7210: 28 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63  (.  sqlite3_pcac
7220: 68 65 20 2a 70 2c 0a 20 20 73 71 6c 69 74 65 33  he *p,.  sqlite3
7230: 5f 70 63 61 63 68 65 5f 70 61 67 65 20 2a 70 50  _pcache_page *pP
7240: 67 2c 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e  g,.  unsigned in
7250: 74 20 69 4f 6c 64 2c 0a 20 20 75 6e 73 69 67 6e  t iOld,.  unsign
7260: 65 64 20 69 6e 74 20 69 4e 65 77 0a 29 7b 0a 20  ed int iNew.){. 
7270: 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65   PCache1 *pCache
7280: 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b   = (PCache1 *)p;
7290: 0a 20 20 50 67 48 64 72 31 20 2a 70 50 61 67 65  .  PgHdr1 *pPage
72a0: 20 3d 20 28 50 67 48 64 72 31 20 2a 29 70 50 67   = (PgHdr1 *)pPg
72b0: 3b 0a 20 20 50 67 48 64 72 31 20 2a 2a 70 70 3b  ;.  PgHdr1 **pp;
72c0: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
72d0: 68 3b 20 0a 20 20 61 73 73 65 72 74 28 20 70 50  h; .  assert( pP
72e0: 61 67 65 2d 3e 69 4b 65 79 3d 3d 69 4f 6c 64 20  age->iKey==iOld 
72f0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61  );.  assert( pPa
7300: 67 65 2d 3e 70 43 61 63 68 65 3d 3d 70 43 61 63  ge->pCache==pCac
7310: 68 65 20 29 3b 0a 0a 20 20 70 63 61 63 68 65 31  he );..  pcache1
7320: 45 6e 74 65 72 4d 75 74 65 78 28 70 43 61 63 68  EnterMutex(pCach
7330: 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 0a 20 20 68  e->pGroup);..  h
7340: 20 3d 20 69 4f 6c 64 25 70 43 61 63 68 65 2d 3e   = iOld%pCache->
7350: 6e 48 61 73 68 3b 0a 20 20 70 70 20 3d 20 26 70  nHash;.  pp = &p
7360: 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d  Cache->apHash[h]
7370: 3b 0a 20 20 77 68 69 6c 65 28 20 28 2a 70 70 29  ;.  while( (*pp)
7380: 21 3d 70 50 61 67 65 20 29 7b 0a 20 20 20 20 70  !=pPage ){.    p
7390: 70 20 3d 20 26 28 2a 70 70 29 2d 3e 70 4e 65 78  p = &(*pp)->pNex
73a0: 74 3b 0a 20 20 7d 0a 20 20 2a 70 70 20 3d 20 70  t;.  }.  *pp = p
73b0: 50 61 67 65 2d 3e 70 4e 65 78 74 3b 0a 0a 20 20  Page->pNext;..  
73c0: 68 20 3d 20 69 4e 65 77 25 70 43 61 63 68 65 2d  h = iNew%pCache-
73d0: 3e 6e 48 61 73 68 3b 0a 20 20 70 50 61 67 65 2d  >nHash;.  pPage-
73e0: 3e 69 4b 65 79 20 3d 20 69 4e 65 77 3b 0a 20 20  >iKey = iNew;.  
73f0: 70 50 61 67 65 2d 3e 70 4e 65 78 74 20 3d 20 70  pPage->pNext = p
7400: 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d  Cache->apHash[h]
7410: 3b 0a 20 20 70 43 61 63 68 65 2d 3e 61 70 48 61  ;.  pCache->apHa
7420: 73 68 5b 68 5d 20 3d 20 70 50 61 67 65 3b 0a 20  sh[h] = pPage;. 
7430: 20 69 66 28 20 69 4e 65 77 3e 70 43 61 63 68 65   if( iNew>pCache
7440: 2d 3e 69 4d 61 78 4b 65 79 20 29 7b 0a 20 20 20  ->iMaxKey ){.   
7450: 20 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79   pCache->iMaxKey
7460: 20 3d 20 69 4e 65 77 3b 0a 20 20 7d 0a 0a 20 20   = iNew;.  }..  
7470: 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65  pcache1LeaveMute
7480: 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70  x(pCache->pGroup
7490: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c  );.}../*.** Impl
74a0: 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68  ementation of th
74b0: 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  e sqlite3_pcache
74c0: 2e 78 54 72 75 6e 63 61 74 65 20 6d 65 74 68 6f  .xTruncate metho
74d0: 64 2e 20 0a 2a 2a 0a 2a 2a 20 44 69 73 63 61 72  d. .**.** Discar
74e0: 64 20 61 6c 6c 20 75 6e 70 69 6e 6e 65 64 20 70  d all unpinned p
74f0: 61 67 65 73 20 69 6e 20 74 68 65 20 63 61 63 68  ages in the cach
7500: 65 20 77 69 74 68 20 61 20 70 61 67 65 20 6e 75  e with a page nu
7510: 6d 62 65 72 20 65 71 75 61 6c 20 74 6f 0a 2a 2a  mber equal to.**
7520: 20 6f 72 20 67 72 65 61 74 65 72 20 74 68 61 6e   or greater than
7530: 20 70 61 72 61 6d 65 74 65 72 20 69 4c 69 6d 69   parameter iLimi
7540: 74 2e 20 41 6e 79 20 70 69 6e 6e 65 64 20 70 61  t. Any pinned pa
7550: 67 65 73 20 77 69 74 68 20 61 20 70 61 67 65 20  ges with a page 
7560: 6e 75 6d 62 65 72 0a 2a 2a 20 65 71 75 61 6c 20  number.** equal 
7570: 74 6f 20 6f 72 20 67 72 65 61 74 65 72 20 74 68  to or greater th
7580: 61 6e 20 69 4c 69 6d 69 74 20 61 72 65 20 69 6d  an iLimit are im
7590: 70 6c 69 63 69 74 6c 79 20 75 6e 70 69 6e 6e 65  plicitly unpinne
75a0: 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  d..*/.static voi
75b0: 64 20 70 63 61 63 68 65 31 54 72 75 6e 63 61 74  d pcache1Truncat
75c0: 65 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  e(sqlite3_pcache
75d0: 20 2a 70 2c 20 75 6e 73 69 67 6e 65 64 20 69 6e   *p, unsigned in
75e0: 74 20 69 4c 69 6d 69 74 29 7b 0a 20 20 50 43 61  t iLimit){.  PCa
75f0: 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28  che1 *pCache = (
7600: 50 43 61 63 68 65 31 20 2a 29 70 3b 0a 20 20 70  PCache1 *)p;.  p
7610: 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78  cache1EnterMutex
7620: 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29  (pCache->pGroup)
7630: 3b 0a 20 20 69 66 28 20 69 4c 69 6d 69 74 3c 3d  ;.  if( iLimit<=
7640: 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20  pCache->iMaxKey 
7650: 29 7b 0a 20 20 20 20 70 63 61 63 68 65 31 54 72  ){.    pcache1Tr
7660: 75 6e 63 61 74 65 55 6e 73 61 66 65 28 70 43 61  uncateUnsafe(pCa
7670: 63 68 65 2c 20 69 4c 69 6d 69 74 29 3b 0a 20 20  che, iLimit);.  
7680: 20 20 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65    pCache->iMaxKe
7690: 79 20 3d 20 69 4c 69 6d 69 74 2d 31 3b 0a 20 20  y = iLimit-1;.  
76a0: 7d 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76 65  }.  pcache1Leave
76b0: 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47  Mutex(pCache->pG
76c0: 72 6f 75 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  roup);.}../*.** 
76d0: 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  Implementation o
76e0: 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63  f the sqlite3_pc
76f0: 61 63 68 65 2e 78 44 65 73 74 72 6f 79 20 6d 65  ache.xDestroy me
7700: 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 44 65 73  thod. .**.** Des
7710: 74 72 6f 79 20 61 20 63 61 63 68 65 20 61 6c 6c  troy a cache all
7720: 6f 63 61 74 65 64 20 75 73 69 6e 67 20 70 63 61  ocated using pca
7730: 63 68 65 31 43 72 65 61 74 65 28 29 2e 0a 2a 2f  che1Create()..*/
7740: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61  .static void pca
7750: 63 68 65 31 44 65 73 74 72 6f 79 28 73 71 6c 69  che1Destroy(sqli
7760: 74 65 33 5f 70 63 61 63 68 65 20 2a 70 29 7b 0a  te3_pcache *p){.
7770: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68    PCache1 *pCach
7780: 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70  e = (PCache1 *)p
7790: 3b 0a 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f  ;.  PGroup *pGro
77a0: 75 70 20 3d 20 70 43 61 63 68 65 2d 3e 70 47 72  up = pCache->pGr
77b0: 6f 75 70 3b 0a 20 20 61 73 73 65 72 74 28 20 70  oup;.  assert( p
77c0: 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c  Cache->bPurgeabl
77d0: 65 20 7c 7c 20 28 70 43 61 63 68 65 2d 3e 6e 4d  e || (pCache->nM
77e0: 61 78 3d 3d 30 20 26 26 20 70 43 61 63 68 65 2d  ax==0 && pCache-
77f0: 3e 6e 4d 69 6e 3d 3d 30 29 20 29 3b 0a 20 20 70  >nMin==0) );.  p
7800: 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78  cache1EnterMutex
7810: 28 70 47 72 6f 75 70 29 3b 0a 20 20 70 63 61 63  (pGroup);.  pcac
7820: 68 65 31 54 72 75 6e 63 61 74 65 55 6e 73 61 66  he1TruncateUnsaf
7830: 65 28 70 43 61 63 68 65 2c 20 30 29 3b 0a 20 20  e(pCache, 0);.  
7840: 61 73 73 65 72 74 28 20 70 47 72 6f 75 70 2d 3e  assert( pGroup->
7850: 6e 4d 61 78 50 61 67 65 20 3e 3d 20 70 43 61 63  nMaxPage >= pCac
7860: 68 65 2d 3e 6e 4d 61 78 20 29 3b 0a 20 20 70 47  he->nMax );.  pG
7870: 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 2d  roup->nMaxPage -
7880: 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 3b 0a  = pCache->nMax;.
7890: 20 20 61 73 73 65 72 74 28 20 70 47 72 6f 75 70    assert( pGroup
78a0: 2d 3e 6e 4d 69 6e 50 61 67 65 20 3e 3d 20 70 43  ->nMinPage >= pC
78b0: 61 63 68 65 2d 3e 6e 4d 69 6e 20 29 3b 0a 20 20  ache->nMin );.  
78c0: 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65  pGroup->nMinPage
78d0: 20 2d 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e   -= pCache->nMin
78e0: 3b 0a 20 20 70 47 72 6f 75 70 2d 3e 6d 78 50 69  ;.  pGroup->mxPi
78f0: 6e 6e 65 64 20 3d 20 70 47 72 6f 75 70 2d 3e 6e  nned = pGroup->n
7900: 4d 61 78 50 61 67 65 20 2b 20 31 30 20 2d 20 70  MaxPage + 10 - p
7910: 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 3b  Group->nMinPage;
7920: 0a 20 20 70 63 61 63 68 65 31 45 6e 66 6f 72 63  .  pcache1Enforc
7930: 65 4d 61 78 50 61 67 65 28 70 47 72 6f 75 70 29  eMaxPage(pGroup)
7940: 3b 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76 65  ;.  pcache1Leave
7950: 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20  Mutex(pGroup);. 
7960: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 43   sqlite3_free(pC
7970: 61 63 68 65 2d 3e 61 70 48 61 73 68 29 3b 0a 20  ache->apHash);. 
7980: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 43   sqlite3_free(pC
7990: 61 63 68 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  ache);.}../*.** 
79a0: 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73  This function is
79b0: 20 63 61 6c 6c 65 64 20 64 75 72 69 6e 67 20 69   called during i
79c0: 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 28 73  nitialization (s
79d0: 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a  qlite3_initializ
79e0: 65 28 29 29 20 74 6f 0a 2a 2a 20 69 6e 73 74 61  e()) to.** insta
79f0: 6c 6c 20 74 68 65 20 64 65 66 61 75 6c 74 20 70  ll the default p
7a00: 6c 75 67 67 61 62 6c 65 20 63 61 63 68 65 20 6d  luggable cache m
7a10: 6f 64 75 6c 65 2c 20 61 73 73 75 6d 69 6e 67 20  odule, assuming 
7a20: 74 68 65 20 75 73 65 72 20 68 61 73 20 6e 6f 74  the user has not
7a30: 0a 2a 2a 20 61 6c 72 65 61 64 79 20 70 72 6f 76  .** already prov
7a40: 69 64 65 64 20 61 6e 20 61 6c 74 65 72 6e 61 74  ided an alternat
7a50: 69 76 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  ive..*/.void sql
7a60: 69 74 65 33 50 43 61 63 68 65 53 65 74 44 65 66  ite3PCacheSetDef
7a70: 61 75 6c 74 28 76 6f 69 64 29 7b 0a 20 20 73 74  ault(void){.  st
7a80: 61 74 69 63 20 63 6f 6e 73 74 20 73 71 6c 69 74  atic const sqlit
7a90: 65 33 5f 70 63 61 63 68 65 5f 6d 65 74 68 6f 64  e3_pcache_method
7aa0: 73 32 20 64 65 66 61 75 6c 74 4d 65 74 68 6f 64  s2 defaultMethod
7ab0: 73 20 3d 20 7b 0a 20 20 20 20 31 2c 20 20 20 20  s = {.    1,    
7ac0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7ad0: 20 20 20 2f 2a 20 69 56 65 72 73 69 6f 6e 20 2a     /* iVersion *
7ae0: 2f 0a 20 20 20 20 30 2c 20 20 20 20 20 20 20 20  /.    0,        
7af0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
7b00: 2a 20 70 41 72 67 20 2a 2f 0a 20 20 20 20 70 63  * pArg */.    pc
7b10: 61 63 68 65 31 49 6e 69 74 2c 20 20 20 20 20 20  ache1Init,      
7b20: 20 20 20 20 20 20 20 2f 2a 20 78 49 6e 69 74 20         /* xInit 
7b30: 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 53 68  */.    pcache1Sh
7b40: 75 74 64 6f 77 6e 2c 20 20 20 20 20 20 20 20 20  utdown,         
7b50: 2f 2a 20 78 53 68 75 74 64 6f 77 6e 20 2a 2f 0a  /* xShutdown */.
7b60: 20 20 20 20 70 63 61 63 68 65 31 43 72 65 61 74      pcache1Creat
7b70: 65 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20  e,           /* 
7b80: 78 43 72 65 61 74 65 20 2a 2f 0a 20 20 20 20 70  xCreate */.    p
7b90: 63 61 63 68 65 31 43 61 63 68 65 73 69 7a 65 2c  cache1Cachesize,
7ba0: 20 20 20 20 20 20 20 20 2f 2a 20 78 43 61 63 68          /* xCach
7bb0: 65 73 69 7a 65 20 2a 2f 0a 20 20 20 20 70 63 61  esize */.    pca
7bc0: 63 68 65 31 50 61 67 65 63 6f 75 6e 74 2c 20 20  che1Pagecount,  
7bd0: 20 20 20 20 20 20 2f 2a 20 78 50 61 67 65 63 6f        /* xPageco
7be0: 75 6e 74 20 2a 2f 0a 20 20 20 20 70 63 61 63 68  unt */.    pcach
7bf0: 65 31 46 65 74 63 68 2c 20 20 20 20 20 20 20 20  e1Fetch,        
7c00: 20 20 20 20 2f 2a 20 78 46 65 74 63 68 20 2a 2f      /* xFetch */
7c10: 0a 20 20 20 20 70 63 61 63 68 65 31 55 6e 70 69  .    pcache1Unpi
7c20: 6e 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  n,            /*
7c30: 20 78 55 6e 70 69 6e 20 2a 2f 0a 20 20 20 20 70   xUnpin */.    p
7c40: 63 61 63 68 65 31 52 65 6b 65 79 2c 20 20 20 20  cache1Rekey,    
7c50: 20 20 20 20 20 20 20 20 2f 2a 20 78 52 65 6b 65          /* xReke
7c60: 79 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31  y */.    pcache1
7c70: 54 72 75 6e 63 61 74 65 2c 20 20 20 20 20 20 20  Truncate,       
7c80: 20 20 2f 2a 20 78 54 72 75 6e 63 61 74 65 20 2a    /* xTruncate *
7c90: 2f 0a 20 20 20 20 70 63 61 63 68 65 31 44 65 73  /.    pcache1Des
7ca0: 74 72 6f 79 2c 20 20 20 20 20 20 20 20 20 20 2f  troy,          /
7cb0: 2a 20 78 44 65 73 74 72 6f 79 20 2a 2f 0a 20 20  * xDestroy */.  
7cc0: 20 20 70 63 61 63 68 65 31 53 68 72 69 6e 6b 20    pcache1Shrink 
7cd0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 53             /* xS
7ce0: 68 72 69 6e 6b 20 2a 2f 0a 20 20 7d 3b 0a 20 20  hrink */.  };.  
7cf0: 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 53  sqlite3_config(S
7d00: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 43 41  QLITE_CONFIG_PCA
7d10: 43 48 45 32 2c 20 26 64 65 66 61 75 6c 74 4d 65  CHE2, &defaultMe
7d20: 74 68 6f 64 73 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  thods);.}../*.**
7d30: 20 52 65 74 75 72 6e 20 74 68 65 20 73 69 7a 65   Return the size
7d40: 20 6f 66 20 74 68 65 20 68 65 61 64 65 72 20 6f   of the header o
7d50: 6e 20 65 61 63 68 20 70 61 67 65 20 6f 66 20 74  n each page of t
7d60: 68 69 73 20 50 43 41 43 48 45 20 69 6d 70 6c 65  his PCACHE imple
7d70: 6d 65 6e 74 61 74 69 6f 6e 2e 0a 2a 2f 0a 69 6e  mentation..*/.in
7d80: 74 20 73 71 6c 69 74 65 33 48 65 61 64 65 72 53  t sqlite3HeaderS
7d90: 69 7a 65 50 63 61 63 68 65 31 28 76 6f 69 64 29  izePcache1(void)
7da0: 7b 20 72 65 74 75 72 6e 20 52 4f 55 4e 44 38 28  { return ROUND8(
7db0: 73 69 7a 65 6f 66 28 50 67 48 64 72 31 29 29 3b  sizeof(PgHdr1));
7dc0: 20 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e   }../*.** Return
7dd0: 20 74 68 65 20 67 6c 6f 62 61 6c 20 6d 75 74 65   the global mute
7de0: 78 20 75 73 65 64 20 62 79 20 74 68 69 73 20 50  x used by this P
7df0: 43 41 43 48 45 20 69 6d 70 6c 65 6d 65 6e 74 61  CACHE implementa
7e00: 74 69 6f 6e 2e 20 20 54 68 65 0a 2a 2a 20 73 71  tion.  The.** sq
7e10: 6c 69 74 65 33 5f 73 74 61 74 75 73 28 29 20 72  lite3_status() r
7e20: 6f 75 74 69 6e 65 20 6e 65 65 64 73 20 61 63 63  outine needs acc
7e30: 65 73 73 20 74 6f 20 74 68 69 73 20 6d 75 74 65  ess to this mute
7e40: 78 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f 6d 75  x..*/.sqlite3_mu
7e50: 74 65 78 20 2a 73 71 6c 69 74 65 33 50 63 61 63  tex *sqlite3Pcac
7e60: 68 65 31 4d 75 74 65 78 28 76 6f 69 64 29 7b 0a  he1Mutex(void){.
7e70: 20 20 72 65 74 75 72 6e 20 70 63 61 63 68 65 31    return pcache1
7e80: 2e 6d 75 74 65 78 3b 0a 7d 0a 0a 23 69 66 64 65  .mutex;.}..#ifde
7e90: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  f SQLITE_ENABLE_
7ea0: 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e  MEMORY_MANAGEMEN
7eb0: 54 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e  T./*.** This fun
7ec0: 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20  ction is called 
7ed0: 74 6f 20 66 72 65 65 20 73 75 70 65 72 66 6c 75  to free superflu
7ee0: 6f 75 73 20 64 79 6e 61 6d 69 63 61 6c 6c 79 20  ous dynamically 
7ef0: 61 6c 6c 6f 63 61 74 65 64 20 6d 65 6d 6f 72 79  allocated memory
7f00: 0a 2a 2a 20 68 65 6c 64 20 62 79 20 74 68 65 20  .** held by the 
7f10: 70 61 67 65 72 20 73 79 73 74 65 6d 2e 20 4d 65  pager system. Me
7f20: 6d 6f 72 79 20 69 6e 20 75 73 65 20 62 79 20 61  mory in use by a
7f30: 6e 79 20 53 51 4c 69 74 65 20 70 61 67 65 72 20  ny SQLite pager 
7f40: 61 6c 6c 6f 63 61 74 65 64 0a 2a 2a 20 62 79 20  allocated.** by 
7f50: 74 68 65 20 63 75 72 72 65 6e 74 20 74 68 72 65  the current thre
7f60: 61 64 20 6d 61 79 20 62 65 20 73 71 6c 69 74 65  ad may be sqlite
7f70: 33 5f 66 72 65 65 28 29 65 64 2e 0a 2a 2a 0a 2a  3_free()ed..**.*
7f80: 2a 20 6e 52 65 71 20 69 73 20 74 68 65 20 6e 75  * nReq is the nu
7f90: 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f 66  mber of bytes of
7fa0: 20 6d 65 6d 6f 72 79 20 72 65 71 75 69 72 65 64   memory required
7fb0: 2e 20 4f 6e 63 65 20 74 68 69 73 20 6d 75 63 68  . Once this much
7fc0: 20 68 61 73 0a 2a 2a 20 62 65 65 6e 20 72 65 6c   has.** been rel
7fd0: 65 61 73 65 64 2c 20 74 68 65 20 66 75 6e 63 74  eased, the funct
7fe0: 69 6f 6e 20 72 65 74 75 72 6e 73 2e 20 54 68 65  ion returns. The
7ff0: 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 73   return value is
8000: 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65   the total numbe
8010: 72 20 0a 2a 2a 20 6f 66 20 62 79 74 65 73 20 6f  r .** of bytes o
8020: 66 20 6d 65 6d 6f 72 79 20 72 65 6c 65 61 73 65  f memory release
8030: 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  d..*/.int sqlite
8040: 33 50 63 61 63 68 65 52 65 6c 65 61 73 65 4d 65  3PcacheReleaseMe
8050: 6d 6f 72 79 28 69 6e 74 20 6e 52 65 71 29 7b 0a  mory(int nReq){.
8060: 20 20 69 6e 74 20 6e 46 72 65 65 20 3d 20 30 3b    int nFree = 0;
8070: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74  .  assert( sqlit
8080: 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c 64  e3_mutex_notheld
8090: 28 70 63 61 63 68 65 31 2e 67 72 70 2e 6d 75 74  (pcache1.grp.mut
80a0: 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28  ex) );.  assert(
80b0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6e   sqlite3_mutex_n
80c0: 6f 74 68 65 6c 64 28 70 63 61 63 68 65 31 2e 6d  otheld(pcache1.m
80d0: 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 70  utex) );.  if( p
80e0: 63 61 63 68 65 31 2e 70 53 74 61 72 74 3d 3d 30  cache1.pStart==0
80f0: 20 29 7b 0a 20 20 20 20 50 67 48 64 72 31 20 2a   ){.    PgHdr1 *
8100: 70 3b 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e  p;.    pcache1En
8110: 74 65 72 4d 75 74 65 78 28 26 70 63 61 63 68 65  terMutex(&pcache
8120: 31 2e 67 72 70 29 3b 0a 20 20 20 20 77 68 69 6c  1.grp);.    whil
8130: 65 28 20 28 6e 52 65 71 3c 30 20 7c 7c 20 6e 46  e( (nReq<0 || nF
8140: 72 65 65 3c 6e 52 65 71 29 20 26 26 20 28 28 70  ree<nReq) && ((p
8150: 3d 70 63 61 63 68 65 31 2e 67 72 70 2e 70 4c 72  =pcache1.grp.pLr
8160: 75 54 61 69 6c 29 21 3d 30 29 20 29 7b 0a 20 20  uTail)!=0) ){.  
8170: 20 20 20 20 6e 46 72 65 65 20 2b 3d 20 70 63 61      nFree += pca
8180: 63 68 65 31 4d 65 6d 53 69 7a 65 28 70 2d 3e 70  che1MemSize(p->p
8190: 61 67 65 2e 70 42 75 66 29 3b 0a 23 69 66 64 65  age.pBuf);.#ifde
81a0: 66 20 53 51 4c 49 54 45 5f 50 43 41 43 48 45 5f  f SQLITE_PCACHE_
81b0: 53 45 50 41 52 41 54 45 5f 48 45 41 44 45 52 0a  SEPARATE_HEADER.
81c0: 20 20 20 20 20 20 6e 46 72 65 65 20 2b 3d 20 73        nFree += s
81d0: 71 6c 69 74 65 33 4d 65 6d 53 69 7a 65 28 70 29  qlite3MemSize(p)
81e0: 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 61  ;.#endif.      a
81f0: 73 73 65 72 74 28 20 70 2d 3e 69 73 50 69 6e 6e  ssert( p->isPinn
8200: 65 64 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 70  ed==0 );.      p
8210: 63 61 63 68 65 31 50 69 6e 50 61 67 65 28 70 29  cache1PinPage(p)
8220: 3b 0a 20 20 20 20 20 20 70 63 61 63 68 65 31 52  ;.      pcache1R
8230: 65 6d 6f 76 65 46 72 6f 6d 48 61 73 68 28 70 29  emoveFromHash(p)
8240: 3b 0a 20 20 20 20 20 20 70 63 61 63 68 65 31 46  ;.      pcache1F
8250: 72 65 65 50 61 67 65 28 70 29 3b 0a 20 20 20 20  reePage(p);.    
8260: 7d 0a 20 20 20 20 70 63 61 63 68 65 31 4c 65 61  }.    pcache1Lea
8270: 76 65 4d 75 74 65 78 28 26 70 63 61 63 68 65 31  veMutex(&pcache1
8280: 2e 67 72 70 29 3b 0a 20 20 7d 0a 20 20 72 65 74  .grp);.  }.  ret
8290: 75 72 6e 20 6e 46 72 65 65 3b 0a 7d 0a 23 65 6e  urn nFree;.}.#en
82a0: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e  dif /* SQLITE_EN
82b0: 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41  ABLE_MEMORY_MANA
82c0: 47 45 4d 45 4e 54 20 2a 2f 0a 0a 23 69 66 64 65  GEMENT */..#ifde
82d0: 66 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 2f 2a  f SQLITE_TEST./*
82e0: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f  .** This functio
82f0: 6e 20 69 73 20 75 73 65 64 20 62 79 20 74 65 73  n is used by tes
8300: 74 20 70 72 6f 63 65 64 75 72 65 73 20 74 6f 20  t procedures to 
8310: 69 6e 73 70 65 63 74 20 74 68 65 20 69 6e 74 65  inspect the inte
8320: 72 6e 61 6c 20 73 74 61 74 65 0a 2a 2a 20 6f 66  rnal state.** of
8330: 20 74 68 65 20 67 6c 6f 62 61 6c 20 63 61 63 68   the global cach
8340: 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  e..*/.void sqlit
8350: 65 33 50 63 61 63 68 65 53 74 61 74 73 28 0a 20  e3PcacheStats(. 
8360: 20 69 6e 74 20 2a 70 6e 43 75 72 72 65 6e 74 2c   int *pnCurrent,
8370: 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 54 6f        /* OUT: To
8380: 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 61  tal number of pa
8390: 67 65 73 20 63 61 63 68 65 64 20 2a 2f 0a 20 20  ges cached */.  
83a0: 69 6e 74 20 2a 70 6e 4d 61 78 2c 20 20 20 20 20  int *pnMax,     
83b0: 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 47 6c 6f       /* OUT: Glo
83c0: 62 61 6c 20 6d 61 78 69 6d 75 6d 20 63 61 63 68  bal maximum cach
83d0: 65 20 73 69 7a 65 20 2a 2f 0a 20 20 69 6e 74 20  e size */.  int 
83e0: 2a 70 6e 4d 69 6e 2c 20 20 20 20 20 20 20 20 20  *pnMin,         
83f0: 20 2f 2a 20 4f 55 54 3a 20 53 75 6d 20 6f 66 20   /* OUT: Sum of 
8400: 50 43 61 63 68 65 31 2e 6e 4d 69 6e 20 66 6f 72  PCache1.nMin for
8410: 20 70 75 72 67 65 61 62 6c 65 20 63 61 63 68 65   purgeable cache
8420: 73 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 52 65  s */.  int *pnRe
8430: 63 79 63 6c 61 62 6c 65 20 20 20 20 2f 2a 20 4f  cyclable    /* O
8440: 55 54 3a 20 54 6f 74 61 6c 20 6e 75 6d 62 65 72  UT: Total number
8450: 20 6f 66 20 70 61 67 65 73 20 61 76 61 69 6c 61   of pages availa
8460: 62 6c 65 20 66 6f 72 20 72 65 63 79 63 6c 69 6e  ble for recyclin
8470: 67 20 2a 2f 0a 29 7b 0a 20 20 50 67 48 64 72 31  g */.){.  PgHdr1
8480: 20 2a 70 3b 0a 20 20 69 6e 74 20 6e 52 65 63 79   *p;.  int nRecy
8490: 63 6c 61 62 6c 65 20 3d 20 30 3b 0a 20 20 66 6f  clable = 0;.  fo
84a0: 72 28 70 3d 70 63 61 63 68 65 31 2e 67 72 70 2e  r(p=pcache1.grp.
84b0: 70 4c 72 75 48 65 61 64 3b 20 70 3b 20 70 3d 70  pLruHead; p; p=p
84c0: 2d 3e 70 4c 72 75 4e 65 78 74 29 7b 0a 20 20 20  ->pLruNext){.   
84d0: 20 61 73 73 65 72 74 28 20 70 2d 3e 69 73 50 69   assert( p->isPi
84e0: 6e 6e 65 64 3d 3d 30 20 29 3b 0a 20 20 20 20 6e  nned==0 );.    n
84f0: 52 65 63 79 63 6c 61 62 6c 65 2b 2b 3b 0a 20 20  Recyclable++;.  
8500: 7d 0a 20 20 2a 70 6e 43 75 72 72 65 6e 74 20 3d  }.  *pnCurrent =
8510: 20 70 63 61 63 68 65 31 2e 67 72 70 2e 6e 43 75   pcache1.grp.nCu
8520: 72 72 65 6e 74 50 61 67 65 3b 0a 20 20 2a 70 6e  rrentPage;.  *pn
8530: 4d 61 78 20 3d 20 28 69 6e 74 29 70 63 61 63 68  Max = (int)pcach
8540: 65 31 2e 67 72 70 2e 6e 4d 61 78 50 61 67 65 3b  e1.grp.nMaxPage;
8550: 0a 20 20 2a 70 6e 4d 69 6e 20 3d 20 28 69 6e 74  .  *pnMin = (int
8560: 29 70 63 61 63 68 65 31 2e 67 72 70 2e 6e 4d 69  )pcache1.grp.nMi
8570: 6e 50 61 67 65 3b 0a 20 20 2a 70 6e 52 65 63 79  nPage;.  *pnRecy
8580: 63 6c 61 62 6c 65 20 3d 20 6e 52 65 63 79 63 6c  clable = nRecycl
8590: 61 62 6c 65 3b 0a 7d 0a 23 65 6e 64 69 66 0a     able;.}.#endif.