/ Hex Artifact Content
Login

Artifact 69d137620a305f814398bd29a0c998038c0695e9:


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 20 20 50 47 72  1 *pCache;.  PGr
3aa0: 6f 75 70 20 2a 70 47 72 6f 75 70 3b 0a 0a 20 20  oup *pGroup;..  
3ab0: 61 73 73 65 72 74 28 20 70 50 61 67 65 21 3d 30  assert( pPage!=0
3ac0: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50   );.  assert( pP
3ad0: 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d 30  age->isPinned==0
3ae0: 20 29 3b 0a 20 20 70 43 61 63 68 65 20 3d 20 70   );.  pCache = p
3af0: 50 61 67 65 2d 3e 70 43 61 63 68 65 3b 0a 20 20  Page->pCache;.  
3b00: 70 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65 2d  pGroup = pCache-
3b10: 3e 70 47 72 6f 75 70 3b 0a 20 20 61 73 73 65 72  >pGroup;.  asser
3b20: 74 28 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65  t( pPage->pLruNe
3b30: 78 74 20 7c 7c 20 70 50 61 67 65 3d 3d 70 47 72  xt || pPage==pGr
3b40: 6f 75 70 2d 3e 70 4c 72 75 54 61 69 6c 20 29 3b  oup->pLruTail );
3b50: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65  .  assert( pPage
3b60: 2d 3e 70 4c 72 75 50 72 65 76 20 7c 7c 20 70 50  ->pLruPrev || pP
3b70: 61 67 65 3d 3d 70 47 72 6f 75 70 2d 3e 70 4c 72  age==pGroup->pLr
3b80: 75 48 65 61 64 20 29 3b 0a 20 20 61 73 73 65 72  uHead );.  asser
3b90: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  t( sqlite3_mutex
3ba0: 5f 68 65 6c 64 28 70 47 72 6f 75 70 2d 3e 6d 75  _held(pGroup->mu
3bb0: 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 70 50  tex) );.  if( pP
3bc0: 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 20 29 7b  age->pLruPrev ){
3bd0: 0a 20 20 20 20 70 50 61 67 65 2d 3e 70 4c 72 75  .    pPage->pLru
3be0: 50 72 65 76 2d 3e 70 4c 72 75 4e 65 78 74 20 3d  Prev->pLruNext =
3bf0: 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74   pPage->pLruNext
3c00: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70  ;.  }else{.    p
3c10: 47 72 6f 75 70 2d 3e 70 4c 72 75 48 65 61 64 20  Group->pLruHead 
3c20: 3d 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78  = pPage->pLruNex
3c30: 74 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 61  t;.  }.  if( pPa
3c40: 67 65 2d 3e 70 4c 72 75 4e 65 78 74 20 29 7b 0a  ge->pLruNext ){.
3c50: 20 20 20 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e      pPage->pLruN
3c60: 65 78 74 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20  ext->pLruPrev = 
3c70: 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 3b  pPage->pLruPrev;
3c80: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 47  .  }else{.    pG
3c90: 72 6f 75 70 2d 3e 70 4c 72 75 54 61 69 6c 20 3d  roup->pLruTail =
3ca0: 20 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76   pPage->pLruPrev
3cb0: 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 2d 3e 70  ;.  }.  pPage->p
3cc0: 4c 72 75 4e 65 78 74 20 3d 20 30 3b 0a 20 20 70  LruNext = 0;.  p
3cd0: 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 20 3d  Page->pLruPrev =
3ce0: 20 30 3b 0a 20 20 70 50 61 67 65 2d 3e 69 73 50   0;.  pPage->isP
3cf0: 69 6e 6e 65 64 20 3d 20 31 3b 0a 20 20 70 43 61  inned = 1;.  pCa
3d00: 63 68 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65  che->nRecyclable
3d10: 2d 2d 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65  --;.}.../*.** Re
3d20: 6d 6f 76 65 20 74 68 65 20 70 61 67 65 20 73 75  move the page su
3d30: 70 70 6c 69 65 64 20 61 73 20 61 6e 20 61 72 67  pplied as an arg
3d40: 75 6d 65 6e 74 20 66 72 6f 6d 20 74 68 65 20 68  ument from the h
3d50: 61 73 68 20 74 61 62 6c 65 20 0a 2a 2a 20 28 50  ash table .** (P
3d60: 43 61 63 68 65 31 2e 61 70 48 61 73 68 20 73 74  Cache1.apHash st
3d70: 72 75 63 74 75 72 65 29 20 74 68 61 74 20 69 74  ructure) that it
3d80: 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 73 74   is currently st
3d90: 6f 72 65 64 20 69 6e 2e 0a 2a 2a 0a 2a 2a 20 54  ored in..**.** T
3da0: 68 65 20 50 47 72 6f 75 70 20 6d 75 74 65 78 20  he PGroup mutex 
3db0: 6d 75 73 74 20 62 65 20 68 65 6c 64 20 77 68 65  must be held whe
3dc0: 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  n this function 
3dd0: 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74  is called..*/.st
3de0: 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65  atic void pcache
3df0: 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73 68 28  1RemoveFromHash(
3e00: 50 67 48 64 72 31 20 2a 70 50 61 67 65 29 7b 0a  PgHdr1 *pPage){.
3e10: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 68    unsigned int h
3e20: 3b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61  ;.  PCache1 *pCa
3e30: 63 68 65 20 3d 20 70 50 61 67 65 2d 3e 70 43 61  che = pPage->pCa
3e40: 63 68 65 3b 0a 20 20 50 67 48 64 72 31 20 2a 2a  che;.  PgHdr1 **
3e50: 70 70 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73  pp;..  assert( s
3e60: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c  qlite3_mutex_hel
3e70: 64 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70  d(pCache->pGroup
3e80: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 68 20  ->mutex) );.  h 
3e90: 3d 20 70 50 61 67 65 2d 3e 69 4b 65 79 20 25 20  = pPage->iKey % 
3ea0: 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20  pCache->nHash;. 
3eb0: 20 66 6f 72 28 70 70 3d 26 70 43 61 63 68 65 2d   for(pp=&pCache-
3ec0: 3e 61 70 48 61 73 68 5b 68 5d 3b 20 28 2a 70 70  >apHash[h]; (*pp
3ed0: 29 21 3d 70 50 61 67 65 3b 20 70 70 3d 26 28 2a  )!=pPage; pp=&(*
3ee0: 70 70 29 2d 3e 70 4e 65 78 74 29 3b 0a 20 20 2a  pp)->pNext);.  *
3ef0: 70 70 20 3d 20 28 2a 70 70 29 2d 3e 70 4e 65 78  pp = (*pp)->pNex
3f00: 74 3b 0a 0a 20 20 70 43 61 63 68 65 2d 3e 6e 50  t;..  pCache->nP
3f10: 61 67 65 2d 2d 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  age--;.}../*.** 
3f20: 49 66 20 74 68 65 72 65 20 61 72 65 20 63 75 72  If there are cur
3f30: 72 65 6e 74 6c 79 20 6d 6f 72 65 20 74 68 61 6e  rently more than
3f40: 20 6e 4d 61 78 50 61 67 65 20 70 61 67 65 73 20   nMaxPage pages 
3f50: 61 6c 6c 6f 63 61 74 65 64 2c 20 74 72 79 0a 2a  allocated, try.*
3f60: 2a 20 74 6f 20 72 65 63 79 63 6c 65 20 70 61 67  * to recycle pag
3f70: 65 73 20 74 6f 20 72 65 64 75 63 65 20 74 68 65  es to reduce the
3f80: 20 6e 75 6d 62 65 72 20 61 6c 6c 6f 63 61 74 65   number allocate
3f90: 64 20 74 6f 20 6e 4d 61 78 50 61 67 65 2e 0a 2a  d to nMaxPage..*
3fa0: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63  /.static void pc
3fb0: 61 63 68 65 31 45 6e 66 6f 72 63 65 4d 61 78 50  ache1EnforceMaxP
3fc0: 61 67 65 28 50 47 72 6f 75 70 20 2a 70 47 72 6f  age(PGroup *pGro
3fd0: 75 70 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73  up){.  assert( s
3fe0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c  qlite3_mutex_hel
3ff0: 64 28 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29  d(pGroup->mutex)
4000: 20 29 3b 0a 20 20 77 68 69 6c 65 28 20 70 47 72   );.  while( pGr
4010: 6f 75 70 2d 3e 6e 43 75 72 72 65 6e 74 50 61 67  oup->nCurrentPag
4020: 65 3e 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61  e>pGroup->nMaxPa
4030: 67 65 20 26 26 20 70 47 72 6f 75 70 2d 3e 70 4c  ge && pGroup->pL
4040: 72 75 54 61 69 6c 20 29 7b 0a 20 20 20 20 50 67  ruTail ){.    Pg
4050: 48 64 72 31 20 2a 70 20 3d 20 70 47 72 6f 75 70  Hdr1 *p = pGroup
4060: 2d 3e 70 4c 72 75 54 61 69 6c 3b 0a 20 20 20 20  ->pLruTail;.    
4070: 61 73 73 65 72 74 28 20 70 2d 3e 70 43 61 63 68  assert( p->pCach
4080: 65 2d 3e 70 47 72 6f 75 70 3d 3d 70 47 72 6f 75  e->pGroup==pGrou
4090: 70 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28  p );.    assert(
40a0: 20 70 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d 30 20   p->isPinned==0 
40b0: 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 50 69  );.    pcache1Pi
40c0: 6e 50 61 67 65 28 70 29 3b 0a 20 20 20 20 70 63  nPage(p);.    pc
40d0: 61 63 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48  ache1RemoveFromH
40e0: 61 73 68 28 70 29 3b 0a 20 20 20 20 70 63 61 63  ash(p);.    pcac
40f0: 68 65 31 46 72 65 65 50 61 67 65 28 70 29 3b 0a  he1FreePage(p);.
4100: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 69 73    }.}../*.** Dis
4110: 63 61 72 64 20 61 6c 6c 20 70 61 67 65 73 20 66  card all pages f
4120: 72 6f 6d 20 63 61 63 68 65 20 70 43 61 63 68 65  rom cache pCache
4130: 20 77 69 74 68 20 61 20 70 61 67 65 20 6e 75 6d   with a page num
4140: 62 65 72 20 28 6b 65 79 20 76 61 6c 75 65 29 20  ber (key value) 
4150: 0a 2a 2a 20 67 72 65 61 74 65 72 20 74 68 61 6e  .** greater than
4160: 20 6f 72 20 65 71 75 61 6c 20 74 6f 20 69 4c 69   or equal to iLi
4170: 6d 69 74 2e 20 41 6e 79 20 70 69 6e 6e 65 64 20  mit. Any pinned 
4180: 70 61 67 65 73 20 74 68 61 74 20 6d 65 65 74 20  pages that meet 
4190: 74 68 69 73 20 0a 2a 2a 20 63 72 69 74 65 72 69  this .** criteri
41a0: 61 20 61 72 65 20 75 6e 70 69 6e 6e 65 64 20 62  a are unpinned b
41b0: 65 66 6f 72 65 20 74 68 65 79 20 61 72 65 20 64  efore they are d
41c0: 69 73 63 61 72 64 65 64 2e 0a 2a 2a 0a 2a 2a 20  iscarded..**.** 
41d0: 54 68 65 20 50 43 61 63 68 65 20 6d 75 74 65 78  The PCache mutex
41e0: 20 6d 75 73 74 20 62 65 20 68 65 6c 64 20 77 68   must be held wh
41f0: 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e  en this function
4200: 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73   is called..*/.s
4210: 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68  tatic void pcach
4220: 65 31 54 72 75 6e 63 61 74 65 55 6e 73 61 66 65  e1TruncateUnsafe
4230: 28 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61  (.  PCache1 *pCa
4240: 63 68 65 2c 20 20 20 20 20 20 20 20 20 20 20 20  che,            
4250: 20 2f 2a 20 54 68 65 20 63 61 63 68 65 20 74 6f   /* The cache to
4260: 20 74 72 75 6e 63 61 74 65 20 2a 2f 0a 20 20 75   truncate */.  u
4270: 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4c 69 6d  nsigned int iLim
4280: 69 74 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44  it          /* D
4290: 72 6f 70 20 70 61 67 65 73 20 77 69 74 68 20 74  rop pages with t
42a0: 68 69 73 20 70 67 6e 6f 20 6f 72 20 6c 61 72 67  his pgno or larg
42b0: 65 72 20 2a 2f 0a 29 7b 0a 20 20 54 45 53 54 4f  er */.){.  TESTO
42c0: 4e 4c 59 28 20 75 6e 73 69 67 6e 65 64 20 69 6e  NLY( unsigned in
42d0: 74 20 6e 50 61 67 65 20 3d 20 30 3b 20 29 20 20  t nPage = 0; )  
42e0: 2f 2a 20 54 6f 20 61 73 73 65 72 74 20 70 43 61  /* To assert pCa
42f0: 63 68 65 2d 3e 6e 50 61 67 65 20 69 73 20 63 6f  che->nPage is co
4300: 72 72 65 63 74 20 2a 2f 0a 20 20 75 6e 73 69 67  rrect */.  unsig
4310: 6e 65 64 20 69 6e 74 20 68 3b 0a 20 20 61 73 73  ned int h;.  ass
4320: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74  ert( sqlite3_mut
4330: 65 78 5f 68 65 6c 64 28 70 43 61 63 68 65 2d 3e  ex_held(pCache->
4340: 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29  pGroup->mutex) )
4350: 3b 0a 20 20 66 6f 72 28 68 3d 30 3b 20 68 3c 70  ;.  for(h=0; h<p
4360: 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b 20 68 2b  Cache->nHash; h+
4370: 2b 29 7b 0a 20 20 20 20 50 67 48 64 72 31 20 2a  +){.    PgHdr1 *
4380: 2a 70 70 20 3d 20 26 70 43 61 63 68 65 2d 3e 61  *pp = &pCache->a
4390: 70 48 61 73 68 5b 68 5d 3b 20 0a 20 20 20 20 50  pHash[h]; .    P
43a0: 67 48 64 72 31 20 2a 70 50 61 67 65 3b 0a 20 20  gHdr1 *pPage;.  
43b0: 20 20 77 68 69 6c 65 28 20 28 70 50 61 67 65 20    while( (pPage 
43c0: 3d 20 2a 70 70 29 21 3d 30 20 29 7b 0a 20 20 20  = *pp)!=0 ){.   
43d0: 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e 69 4b     if( pPage->iK
43e0: 65 79 3e 3d 69 4c 69 6d 69 74 20 29 7b 0a 20 20  ey>=iLimit ){.  
43f0: 20 20 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 50        pCache->nP
4400: 61 67 65 2d 2d 3b 0a 20 20 20 20 20 20 20 20 2a  age--;.        *
4410: 70 70 20 3d 20 70 50 61 67 65 2d 3e 70 4e 65 78  pp = pPage->pNex
4420: 74 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 21  t;.        if( !
4430: 70 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64 20  pPage->isPinned 
4440: 29 20 70 63 61 63 68 65 31 50 69 6e 50 61 67 65  ) pcache1PinPage
4450: 28 70 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20  (pPage);.       
4460: 20 70 63 61 63 68 65 31 46 72 65 65 50 61 67 65   pcache1FreePage
4470: 28 70 50 61 67 65 29 3b 0a 20 20 20 20 20 20 7d  (pPage);.      }
4480: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70 70  else{.        pp
4490: 20 3d 20 26 70 50 61 67 65 2d 3e 70 4e 65 78 74   = &pPage->pNext
44a0: 3b 0a 20 20 20 20 20 20 20 20 54 45 53 54 4f 4e  ;.        TESTON
44b0: 4c 59 28 20 6e 50 61 67 65 2b 2b 3b 20 29 0a 20  LY( nPage++; ). 
44c0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d       }.    }.  }
44d0: 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68  .  assert( pCach
44e0: 65 2d 3e 6e 50 61 67 65 3d 3d 6e 50 61 67 65 20  e->nPage==nPage 
44f0: 29 3b 0a 7d 0a 0a 2f 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: 2a 2a 2a 2a 2a 2f 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a  *****/./********
4550: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20   sqlite3_pcache 
4560: 4d 65 74 68 6f 64 73 20 2a 2a 2a 2a 2a 2a 2a 2a  Methods ********
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 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 49  ******/../*.** I
45a0: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66  mplementation of
45b0: 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61   the sqlite3_pca
45c0: 63 68 65 2e 78 49 6e 69 74 20 6d 65 74 68 6f 64  che.xInit method
45d0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
45e0: 70 63 61 63 68 65 31 49 6e 69 74 28 76 6f 69 64  pcache1Init(void
45f0: 20 2a 4e 6f 74 55 73 65 64 29 7b 0a 20 20 55 4e   *NotUsed){.  UN
4600: 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 4e  USED_PARAMETER(N
4610: 6f 74 55 73 65 64 29 3b 0a 20 20 61 73 73 65 72  otUsed);.  asser
4620: 74 28 20 70 63 61 63 68 65 31 2e 69 73 49 6e 69  t( pcache1.isIni
4630: 74 3d 3d 30 20 29 3b 0a 20 20 6d 65 6d 73 65 74  t==0 );.  memset
4640: 28 26 70 63 61 63 68 65 31 2c 20 30 2c 20 73 69  (&pcache1, 0, si
4650: 7a 65 6f 66 28 70 63 61 63 68 65 31 29 29 3b 0a  zeof(pcache1));.
4660: 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f    if( sqlite3Glo
4670: 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d  balConfig.bCoreM
4680: 75 74 65 78 20 29 7b 0a 20 20 20 20 70 63 61 63  utex ){.    pcac
4690: 68 65 31 2e 67 72 70 2e 6d 75 74 65 78 20 3d 20  he1.grp.mutex = 
46a0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 61 6c  sqlite3_mutex_al
46b0: 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58  loc(SQLITE_MUTEX
46c0: 5f 53 54 41 54 49 43 5f 4c 52 55 29 3b 0a 20 20  _STATIC_LRU);.  
46d0: 20 20 70 63 61 63 68 65 31 2e 6d 75 74 65 78 20    pcache1.mutex 
46e0: 3d 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  = sqlite3_mutex_
46f0: 61 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54  alloc(SQLITE_MUT
4700: 45 58 5f 53 54 41 54 49 43 5f 50 4d 45 4d 29 3b  EX_STATIC_PMEM);
4710: 0a 20 20 7d 0a 20 20 70 63 61 63 68 65 31 2e 67  .  }.  pcache1.g
4720: 72 70 2e 6d 78 50 69 6e 6e 65 64 20 3d 20 31 30  rp.mxPinned = 10
4730: 3b 0a 20 20 70 63 61 63 68 65 31 2e 69 73 49 6e  ;.  pcache1.isIn
4740: 69 74 20 3d 20 31 3b 0a 20 20 72 65 74 75 72 6e  it = 1;.  return
4750: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f   SQLITE_OK;.}../
4760: 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74  *.** Implementat
4770: 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74  ion of the sqlit
4780: 65 33 5f 70 63 61 63 68 65 2e 78 53 68 75 74 64  e3_pcache.xShutd
4790: 6f 77 6e 20 6d 65 74 68 6f 64 2e 0a 2a 2a 20 4e  own method..** N
47a0: 6f 74 65 20 74 68 61 74 20 74 68 65 20 73 74 61  ote that the sta
47b0: 74 69 63 20 6d 75 74 65 78 20 61 6c 6c 6f 63 61  tic mutex alloca
47c0: 74 65 64 20 69 6e 20 78 49 6e 69 74 20 64 6f 65  ted in xInit doe
47d0: 73 20 0a 2a 2a 20 6e 6f 74 20 6e 65 65 64 20 74  s .** not need t
47e0: 6f 20 62 65 20 66 72 65 65 64 2e 0a 2a 2f 0a 73  o be freed..*/.s
47f0: 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68  tatic void pcach
4800: 65 31 53 68 75 74 64 6f 77 6e 28 76 6f 69 64 20  e1Shutdown(void 
4810: 2a 4e 6f 74 55 73 65 64 29 7b 0a 20 20 55 4e 55  *NotUsed){.  UNU
4820: 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f  SED_PARAMETER(No
4830: 74 55 73 65 64 29 3b 0a 20 20 61 73 73 65 72 74  tUsed);.  assert
4840: 28 20 70 63 61 63 68 65 31 2e 69 73 49 6e 69 74  ( pcache1.isInit
4850: 21 3d 30 20 29 3b 0a 20 20 6d 65 6d 73 65 74 28  !=0 );.  memset(
4860: 26 70 63 61 63 68 65 31 2c 20 30 2c 20 73 69 7a  &pcache1, 0, siz
4870: 65 6f 66 28 70 63 61 63 68 65 31 29 29 3b 0a 7d  eof(pcache1));.}
4880: 0a 0a 2f 2a 20 66 6f 72 77 61 72 64 20 64 65 63  ../* forward dec
4890: 6c 61 72 61 74 69 6f 6e 20 2a 2f 0a 73 74 61 74  laration */.stat
48a0: 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 44  ic void pcache1D
48b0: 65 73 74 72 6f 79 28 73 71 6c 69 74 65 33 5f 70  estroy(sqlite3_p
48c0: 63 61 63 68 65 20 2a 70 29 3b 0a 0a 2f 2a 0a 2a  cache *p);../*.*
48d0: 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  * Implementation
48e0: 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f   of the sqlite3_
48f0: 70 63 61 63 68 65 2e 78 43 72 65 61 74 65 20 6d  pcache.xCreate m
4900: 65 74 68 6f 64 2e 0a 2a 2a 0a 2a 2a 20 41 6c 6c  ethod..**.** All
4910: 6f 63 61 74 65 20 61 20 6e 65 77 20 63 61 63 68  ocate a new cach
4920: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 73 71 6c  e..*/.static sql
4930: 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 63 61  ite3_pcache *pca
4940: 63 68 65 31 43 72 65 61 74 65 28 69 6e 74 20 73  che1Create(int s
4950: 7a 50 61 67 65 2c 20 69 6e 74 20 73 7a 45 78 74  zPage, int szExt
4960: 72 61 2c 20 69 6e 74 20 62 50 75 72 67 65 61 62  ra, int bPurgeab
4970: 6c 65 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a  le){.  PCache1 *
4980: 70 43 61 63 68 65 3b 20 20 20 20 20 20 2f 2a 20  pCache;      /* 
4990: 54 68 65 20 6e 65 77 6c 79 20 63 72 65 61 74 65  The newly create
49a0: 64 20 70 61 67 65 20 63 61 63 68 65 20 2a 2f 0a  d page cache */.
49b0: 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70    PGroup *pGroup
49c0: 3b 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 67  ;       /* The g
49d0: 72 6f 75 70 20 74 68 65 20 6e 65 77 20 70 61 67  roup the new pag
49e0: 65 20 63 61 63 68 65 20 77 69 6c 6c 20 62 65 6c  e cache will bel
49f0: 6f 6e 67 20 74 6f 20 2a 2f 0a 20 20 69 6e 74 20  ong to */.  int 
4a00: 73 7a 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  sz;             
4a10: 20 20 2f 2a 20 42 79 74 65 73 20 6f 66 20 6d 65    /* Bytes of me
4a20: 6d 6f 72 79 20 72 65 71 75 69 72 65 64 20 74 6f  mory required to
4a30: 20 61 6c 6c 6f 63 61 74 65 20 74 68 65 20 6e 65   allocate the ne
4a40: 77 20 63 61 63 68 65 20 2a 2f 0a 0a 20 20 2f 2a  w cache */..  /*
4a50: 0a 20 20 2a 2a 20 54 68 65 20 73 65 70 61 72 61  .  ** The separa
4a60: 74 65 43 61 63 68 65 20 76 61 72 69 61 62 6c 65  teCache variable
4a70: 20 69 73 20 74 72 75 65 20 69 66 20 65 61 63 68   is true if each
4a80: 20 50 43 61 63 68 65 20 68 61 73 20 69 74 73 20   PCache has its 
4a90: 6f 77 6e 20 70 72 69 76 61 74 65 0a 20 20 2a 2a  own private.  **
4aa0: 20 50 47 72 6f 75 70 2e 20 20 49 6e 20 6f 74 68   PGroup.  In oth
4ab0: 65 72 20 77 6f 72 64 73 2c 20 73 65 70 61 72 61  er words, separa
4ac0: 74 65 43 61 63 68 65 20 69 73 20 74 72 75 65 20  teCache is true 
4ad0: 66 6f 72 20 6d 6f 64 65 20 28 31 29 20 77 68 65  for mode (1) whe
4ae0: 72 65 20 6e 6f 0a 20 20 2a 2a 20 6d 75 74 65 78  re no.  ** mutex
4af0: 69 6e 67 20 69 73 20 72 65 71 75 69 72 65 64 2e  ing is required.
4b00: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 20  .  **.  **   *  
4b10: 41 6c 77 61 79 73 20 75 73 65 20 61 20 75 6e 69  Always use a uni
4b20: 66 69 65 64 20 63 61 63 68 65 20 28 6d 6f 64 65  fied cache (mode
4b30: 2d 32 29 20 69 66 20 45 4e 41 42 4c 45 5f 4d 45  -2) if ENABLE_ME
4b40: 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a  MORY_MANAGEMENT.
4b50: 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 20 41    **.  **   *  A
4b60: 6c 77 61 79 73 20 75 73 65 20 61 20 75 6e 69 66  lways use a unif
4b70: 69 65 64 20 63 61 63 68 65 20 69 6e 20 73 69 6e  ied cache in sin
4b80: 67 6c 65 2d 74 68 72 65 61 64 65 64 20 61 70 70  gle-threaded app
4b90: 6c 69 63 61 74 69 6f 6e 73 0a 20 20 2a 2a 0a 20  lications.  **. 
4ba0: 20 2a 2a 20 20 20 2a 20 20 4f 74 68 65 72 77 69   **   *  Otherwi
4bb0: 73 65 20 28 69 66 20 6d 75 6c 74 69 2d 74 68 72  se (if multi-thr
4bc0: 65 61 64 65 64 20 61 6e 64 20 45 4e 41 42 4c 45  eaded and ENABLE
4bd0: 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45  _MEMORY_MANAGEME
4be0: 4e 54 20 69 73 20 6f 66 66 29 0a 20 20 2a 2a 20  NT is off).  ** 
4bf0: 20 20 20 20 20 75 73 65 20 73 65 70 61 72 61 74       use separat
4c00: 65 20 63 61 63 68 65 73 20 28 6d 6f 64 65 2d 31  e caches (mode-1
4c10: 29 0a 20 20 2a 2f 0a 23 69 66 20 64 65 66 69 6e  ).  */.#if defin
4c20: 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  ed(SQLITE_ENABLE
4c30: 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45  _MEMORY_MANAGEME
4c40: 4e 54 29 20 7c 7c 20 53 51 4c 49 54 45 5f 54 48  NT) || SQLITE_TH
4c50: 52 45 41 44 53 41 46 45 3d 3d 30 0a 20 20 63 6f  READSAFE==0.  co
4c60: 6e 73 74 20 69 6e 74 20 73 65 70 61 72 61 74 65  nst int separate
4c70: 43 61 63 68 65 20 3d 20 30 3b 0a 23 65 6c 73 65  Cache = 0;.#else
4c80: 0a 20 20 69 6e 74 20 73 65 70 61 72 61 74 65 43  .  int separateC
4c90: 61 63 68 65 20 3d 20 73 71 6c 69 74 65 33 47 6c  ache = sqlite3Gl
4ca0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65  obalConfig.bCore
4cb0: 4d 75 74 65 78 3e 30 3b 0a 23 65 6e 64 69 66 0a  Mutex>0;.#endif.
4cc0: 0a 20 20 61 73 73 65 72 74 28 20 28 73 7a 50 61  .  assert( (szPa
4cd0: 67 65 20 26 20 28 73 7a 50 61 67 65 2d 31 29 29  ge & (szPage-1))
4ce0: 3d 3d 30 20 26 26 20 73 7a 50 61 67 65 3e 3d 35  ==0 && szPage>=5
4cf0: 31 32 20 26 26 20 73 7a 50 61 67 65 3c 3d 36 35  12 && szPage<=65
4d00: 35 33 36 20 29 3b 0a 20 20 61 73 73 65 72 74 28  536 );.  assert(
4d10: 20 73 7a 45 78 74 72 61 20 3c 20 33 30 30 20 29   szExtra < 300 )
4d20: 3b 0a 0a 20 20 73 7a 20 3d 20 73 69 7a 65 6f 66  ;..  sz = sizeof
4d30: 28 50 43 61 63 68 65 31 29 20 2b 20 73 69 7a 65  (PCache1) + size
4d40: 6f 66 28 50 47 72 6f 75 70 29 2a 73 65 70 61 72  of(PGroup)*separ
4d50: 61 74 65 43 61 63 68 65 3b 0a 20 20 70 43 61 63  ateCache;.  pCac
4d60: 68 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29  he = (PCache1 *)
4d70: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72  sqlite3MallocZer
4d80: 6f 28 73 7a 29 3b 0a 20 20 69 66 28 20 70 43 61  o(sz);.  if( pCa
4d90: 63 68 65 20 29 7b 0a 20 20 20 20 69 66 28 20 73  che ){.    if( s
4da0: 65 70 61 72 61 74 65 43 61 63 68 65 20 29 7b 0a  eparateCache ){.
4db0: 20 20 20 20 20 20 70 47 72 6f 75 70 20 3d 20 28        pGroup = (
4dc0: 50 47 72 6f 75 70 2a 29 26 70 43 61 63 68 65 5b  PGroup*)&pCache[
4dd0: 31 5d 3b 0a 20 20 20 20 20 20 70 47 72 6f 75 70  1];.      pGroup
4de0: 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 20 31 30 3b  ->mxPinned = 10;
4df0: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  .    }else{.    
4e00: 20 20 70 47 72 6f 75 70 20 3d 20 26 70 63 61 63    pGroup = &pcac
4e10: 68 65 31 2e 67 72 70 3b 0a 20 20 20 20 7d 0a 20  he1.grp;.    }. 
4e20: 20 20 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75     pCache->pGrou
4e30: 70 20 3d 20 70 47 72 6f 75 70 3b 0a 20 20 20 20  p = pGroup;.    
4e40: 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 20 3d  pCache->szPage =
4e50: 20 73 7a 50 61 67 65 3b 0a 20 20 20 20 70 43 61   szPage;.    pCa
4e60: 63 68 65 2d 3e 73 7a 45 78 74 72 61 20 3d 20 73  che->szExtra = s
4e70: 7a 45 78 74 72 61 3b 0a 20 20 20 20 70 43 61 63  zExtra;.    pCac
4e80: 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 3d  he->bPurgeable =
4e90: 20 28 62 50 75 72 67 65 61 62 6c 65 20 3f 20 31   (bPurgeable ? 1
4ea0: 20 3a 20 30 29 3b 0a 20 20 20 20 70 63 61 63 68   : 0);.    pcach
4eb0: 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70 47 72  e1EnterMutex(pGr
4ec0: 6f 75 70 29 3b 0a 20 20 20 20 70 63 61 63 68 65  oup);.    pcache
4ed0: 31 52 65 73 69 7a 65 48 61 73 68 28 70 43 61 63  1ResizeHash(pCac
4ee0: 68 65 29 3b 0a 20 20 20 20 69 66 28 20 62 50 75  he);.    if( bPu
4ef0: 72 67 65 61 62 6c 65 20 29 7b 0a 20 20 20 20 20  rgeable ){.     
4f00: 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 20 3d 20   pCache->nMin = 
4f10: 31 30 3b 0a 20 20 20 20 20 20 70 47 72 6f 75 70  10;.      pGroup
4f20: 2d 3e 6e 4d 69 6e 50 61 67 65 20 2b 3d 20 70 43  ->nMinPage += pC
4f30: 61 63 68 65 2d 3e 6e 4d 69 6e 3b 0a 20 20 20 20  ache->nMin;.    
4f40: 20 20 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e    pGroup->mxPinn
4f50: 65 64 20 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d 61  ed = pGroup->nMa
4f60: 78 50 61 67 65 20 2b 20 31 30 20 2d 20 70 47 72  xPage + 10 - pGr
4f70: 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 3b 0a 20  oup->nMinPage;. 
4f80: 20 20 20 7d 0a 20 20 20 20 70 63 61 63 68 65 31     }.    pcache1
4f90: 4c 65 61 76 65 4d 75 74 65 78 28 70 47 72 6f 75  LeaveMutex(pGrou
4fa0: 70 29 3b 0a 20 20 20 20 69 66 28 20 70 43 61 63  p);.    if( pCac
4fb0: 68 65 2d 3e 6e 48 61 73 68 3d 3d 30 20 29 7b 0a  he->nHash==0 ){.
4fc0: 20 20 20 20 20 20 70 63 61 63 68 65 31 44 65 73        pcache1Des
4fd0: 74 72 6f 79 28 28 73 71 6c 69 74 65 33 5f 70 63  troy((sqlite3_pc
4fe0: 61 63 68 65 2a 29 70 43 61 63 68 65 29 3b 0a 20  ache*)pCache);. 
4ff0: 20 20 20 20 20 70 43 61 63 68 65 20 3d 20 30 3b       pCache = 0;
5000: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74  .    }.  }.  ret
5010: 75 72 6e 20 28 73 71 6c 69 74 65 33 5f 70 63 61  urn (sqlite3_pca
5020: 63 68 65 20 2a 29 70 43 61 63 68 65 3b 0a 7d 0a  che *)pCache;.}.
5030: 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74  ./*.** Implement
5040: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c  ation of the sql
5050: 69 74 65 33 5f 70 63 61 63 68 65 2e 78 43 61 63  ite3_pcache.xCac
5060: 68 65 73 69 7a 65 20 6d 65 74 68 6f 64 2e 20 0a  hesize method. .
5070: 2a 2a 0a 2a 2a 20 43 6f 6e 66 69 67 75 72 65 20  **.** Configure 
5080: 74 68 65 20 63 61 63 68 65 5f 73 69 7a 65 20 6c  the cache_size l
5090: 69 6d 69 74 20 66 6f 72 20 61 20 63 61 63 68 65  imit for a cache
50a0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
50b0: 20 70 63 61 63 68 65 31 43 61 63 68 65 73 69 7a   pcache1Cachesiz
50c0: 65 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  e(sqlite3_pcache
50d0: 20 2a 70 2c 20 69 6e 74 20 6e 4d 61 78 29 7b 0a   *p, int nMax){.
50e0: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68    PCache1 *pCach
50f0: 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70  e = (PCache1 *)p
5100: 3b 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e  ;.  if( pCache->
5110: 62 50 75 72 67 65 61 62 6c 65 20 29 7b 0a 20 20  bPurgeable ){.  
5120: 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70    PGroup *pGroup
5130: 20 3d 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75   = pCache->pGrou
5140: 70 3b 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e  p;.    pcache1En
5150: 74 65 72 4d 75 74 65 78 28 70 47 72 6f 75 70 29  terMutex(pGroup)
5160: 3b 0a 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e 4d  ;.    pGroup->nM
5170: 61 78 50 61 67 65 20 2b 3d 20 28 6e 4d 61 78 20  axPage += (nMax 
5180: 2d 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 29 3b  - pCache->nMax);
5190: 0a 20 20 20 20 70 47 72 6f 75 70 2d 3e 6d 78 50  .    pGroup->mxP
51a0: 69 6e 6e 65 64 20 3d 20 70 47 72 6f 75 70 2d 3e  inned = pGroup->
51b0: 6e 4d 61 78 50 61 67 65 20 2b 20 31 30 20 2d 20  nMaxPage + 10 - 
51c0: 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65  pGroup->nMinPage
51d0: 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 4d  ;.    pCache->nM
51e0: 61 78 20 3d 20 6e 4d 61 78 3b 0a 20 20 20 20 70  ax = nMax;.    p
51f0: 43 61 63 68 65 2d 3e 6e 39 30 70 63 74 20 3d 20  Cache->n90pct = 
5200: 70 43 61 63 68 65 2d 3e 6e 4d 61 78 2a 39 2f 31  pCache->nMax*9/1
5210: 30 3b 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e  0;.    pcache1En
5220: 66 6f 72 63 65 4d 61 78 50 61 67 65 28 70 47 72  forceMaxPage(pGr
5230: 6f 75 70 29 3b 0a 20 20 20 20 70 63 61 63 68 65  oup);.    pcache
5240: 31 4c 65 61 76 65 4d 75 74 65 78 28 70 47 72 6f  1LeaveMutex(pGro
5250: 75 70 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a  up);.  }.}../*.*
5260: 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  * Implementation
5270: 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f   of the sqlite3_
5280: 70 63 61 63 68 65 2e 78 53 68 72 69 6e 6b 20 6d  pcache.xShrink m
5290: 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 46 72  ethod. .**.** Fr
52a0: 65 65 20 75 70 20 61 73 20 6d 75 63 68 20 6d 65  ee up as much me
52b0: 6d 6f 72 79 20 61 73 20 70 6f 73 73 69 62 6c 65  mory as possible
52c0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
52d0: 20 70 63 61 63 68 65 31 53 68 72 69 6e 6b 28 73   pcache1Shrink(s
52e0: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70  qlite3_pcache *p
52f0: 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43  ){.  PCache1 *pC
5300: 61 63 68 65 20 3d 20 28 50 43 61 63 68 65 31 2a  ache = (PCache1*
5310: 29 70 3b 0a 20 20 69 66 28 20 70 43 61 63 68 65  )p;.  if( pCache
5320: 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 29 7b 0a  ->bPurgeable ){.
5330: 20 20 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f      PGroup *pGro
5340: 75 70 20 3d 20 70 43 61 63 68 65 2d 3e 70 47 72  up = pCache->pGr
5350: 6f 75 70 3b 0a 20 20 20 20 69 6e 74 20 73 61 76  oup;.    int sav
5360: 65 64 4d 61 78 50 61 67 65 3b 0a 20 20 20 20 70  edMaxPage;.    p
5370: 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78  cache1EnterMutex
5380: 28 70 47 72 6f 75 70 29 3b 0a 20 20 20 20 73 61  (pGroup);.    sa
5390: 76 65 64 4d 61 78 50 61 67 65 20 3d 20 70 47 72  vedMaxPage = pGr
53a0: 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 3b 0a 20  oup->nMaxPage;. 
53b0: 20 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50     pGroup->nMaxP
53c0: 61 67 65 20 3d 20 30 3b 0a 20 20 20 20 70 63 61  age = 0;.    pca
53d0: 63 68 65 31 45 6e 66 6f 72 63 65 4d 61 78 50 61  che1EnforceMaxPa
53e0: 67 65 28 70 47 72 6f 75 70 29 3b 0a 20 20 20 20  ge(pGroup);.    
53f0: 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65  pGroup->nMaxPage
5400: 20 3d 20 73 61 76 65 64 4d 61 78 50 61 67 65 3b   = savedMaxPage;
5410: 0a 20 20 20 20 70 63 61 63 68 65 31 4c 65 61 76  .    pcache1Leav
5420: 65 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a  eMutex(pGroup);.
5430: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70    }.}../*.** Imp
5440: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74  lementation of t
5450: 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68  he sqlite3_pcach
5460: 65 2e 78 50 61 67 65 63 6f 75 6e 74 20 6d 65 74  e.xPagecount met
5470: 68 6f 64 2e 20 0a 2a 2f 0a 73 74 61 74 69 63 20  hod. .*/.static 
5480: 69 6e 74 20 70 63 61 63 68 65 31 50 61 67 65 63  int pcache1Pagec
5490: 6f 75 6e 74 28 73 71 6c 69 74 65 33 5f 70 63 61  ount(sqlite3_pca
54a0: 63 68 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 6e  che *p){.  int n
54b0: 3b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61  ;.  PCache1 *pCa
54c0: 63 68 65 20 3d 20 28 50 43 61 63 68 65 31 2a 29  che = (PCache1*)
54d0: 70 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65  p;.  pcache1Ente
54e0: 72 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70  rMutex(pCache->p
54f0: 47 72 6f 75 70 29 3b 0a 20 20 6e 20 3d 20 70 43  Group);.  n = pC
5500: 61 63 68 65 2d 3e 6e 50 61 67 65 3b 0a 20 20 70  ache->nPage;.  p
5510: 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78  cache1LeaveMutex
5520: 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29  (pCache->pGroup)
5530: 3b 0a 20 20 72 65 74 75 72 6e 20 6e 3b 0a 7d 0a  ;.  return n;.}.
5540: 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e  ../*.** Implemen
5550: 74 20 73 74 65 70 73 20 33 2c 20 34 2c 20 61 6e  t steps 3, 4, an
5560: 64 20 35 20 6f 66 20 74 68 65 20 70 63 61 63 68  d 5 of the pcach
5570: 65 31 46 65 74 63 68 28 29 20 61 6c 67 6f 72 69  e1Fetch() algori
5580: 74 68 6d 20 64 65 73 63 72 69 62 65 64 0a 2a 2a  thm described.**
5590: 20 69 6e 20 74 68 65 20 68 65 61 64 65 72 20 6f   in the header o
55a0: 66 20 74 68 65 20 70 63 61 63 68 65 31 46 65 74  f the pcache1Fet
55b0: 63 68 28 29 20 70 72 6f 63 65 64 75 72 65 2e 0a  ch() procedure..
55c0: 2a 2a 0a 2a 2a 20 54 68 69 73 20 73 74 65 70 73  **.** This steps
55d0: 20 61 72 65 20 62 72 6f 6b 65 6e 20 6f 75 74 20   are broken out 
55e0: 69 6e 74 6f 20 61 20 73 65 70 61 72 61 74 65 20  into a separate 
55f0: 70 72 6f 63 65 64 75 72 65 20 62 65 63 61 75 73  procedure becaus
5600: 65 20 74 68 65 79 20 61 72 65 0a 2a 2a 20 75 73  e they are.** us
5610: 75 61 6c 6c 79 20 6e 6f 74 20 6e 65 65 64 65 64  ually not needed
5620: 2c 20 61 6e 64 20 62 79 20 61 76 6f 69 64 69 6e  , and by avoidin
5630: 67 20 74 68 65 20 73 74 61 63 6b 20 69 6e 69 74  g the stack init
5640: 69 61 6c 69 7a 61 74 69 6f 6e 20 72 65 71 75 69  ialization requi
5650: 72 65 64 0a 2a 2a 20 66 6f 72 20 74 68 65 73 65  red.** for these
5660: 20 73 74 65 70 73 2c 20 74 68 65 20 6d 61 69 6e   steps, the main
5670: 20 70 63 61 63 68 65 31 46 65 74 63 68 28 29 20   pcache1Fetch() 
5680: 70 72 6f 63 65 64 75 72 65 20 63 61 6e 20 72 75  procedure can ru
5690: 6e 20 66 61 73 74 65 72 2e 0a 2a 2f 0a 73 74 61  n faster..*/.sta
56a0: 74 69 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c  tic SQLITE_NOINL
56b0: 49 4e 45 20 50 67 48 64 72 31 20 2a 70 63 61 63  INE PgHdr1 *pcac
56c0: 68 65 31 46 65 74 63 68 53 74 61 67 65 32 28 0a  he1FetchStage2(.
56d0: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68    PCache1 *pCach
56e0: 65 2c 20 0a 20 20 75 6e 73 69 67 6e 65 64 20 69  e, .  unsigned i
56f0: 6e 74 20 69 4b 65 79 2c 20 0a 20 20 69 6e 74 20  nt iKey, .  int 
5700: 63 72 65 61 74 65 46 6c 61 67 0a 29 7b 0a 20 20  createFlag.){.  
5710: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 50 69  unsigned int nPi
5720: 6e 6e 65 64 3b 0a 20 20 50 47 72 6f 75 70 20 2a  nned;.  PGroup *
5730: 70 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65 2d  pGroup = pCache-
5740: 3e 70 47 72 6f 75 70 3b 0a 20 20 50 67 48 64 72  >pGroup;.  PgHdr
5750: 31 20 2a 70 50 61 67 65 20 3d 20 30 3b 0a 0a 20  1 *pPage = 0;.. 
5760: 20 2f 2a 20 53 74 65 70 20 33 3a 20 41 62 6f 72   /* Step 3: Abor
5770: 74 20 69 66 20 63 72 65 61 74 65 46 6c 61 67 20  t if createFlag 
5780: 69 73 20 31 20 62 75 74 20 74 68 65 20 63 61 63  is 1 but the cac
5790: 68 65 20 69 73 20 6e 65 61 72 6c 79 20 66 75 6c  he is nearly ful
57a0: 6c 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70  l */.  assert( p
57b0: 43 61 63 68 65 2d 3e 6e 50 61 67 65 20 3e 3d 20  Cache->nPage >= 
57c0: 70 43 61 63 68 65 2d 3e 6e 52 65 63 79 63 6c 61  pCache->nRecycla
57d0: 62 6c 65 20 29 3b 0a 20 20 6e 50 69 6e 6e 65 64  ble );.  nPinned
57e0: 20 3d 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65   = pCache->nPage
57f0: 20 2d 20 70 43 61 63 68 65 2d 3e 6e 52 65 63 79   - pCache->nRecy
5800: 63 6c 61 62 6c 65 3b 0a 20 20 61 73 73 65 72 74  clable;.  assert
5810: 28 20 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e  ( pGroup->mxPinn
5820: 65 64 20 3d 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d  ed == pGroup->nM
5830: 61 78 50 61 67 65 20 2b 20 31 30 20 2d 20 70 47  axPage + 10 - pG
5840: 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 20 29  roup->nMinPage )
5850: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63  ;.  assert( pCac
5860: 68 65 2d 3e 6e 39 30 70 63 74 20 3d 3d 20 70 43  he->n90pct == pC
5870: 61 63 68 65 2d 3e 6e 4d 61 78 2a 39 2f 31 30 20  ache->nMax*9/10 
5880: 29 3b 0a 20 20 69 66 28 20 63 72 65 61 74 65 46  );.  if( createF
5890: 6c 61 67 3d 3d 31 20 26 26 20 28 0a 20 20 20 20  lag==1 && (.    
58a0: 20 20 20 20 6e 50 69 6e 6e 65 64 3e 3d 70 47 72      nPinned>=pGr
58b0: 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 0a 20 20  oup->mxPinned.  
58c0: 20 20 20 7c 7c 20 6e 50 69 6e 6e 65 64 3e 3d 70     || nPinned>=p
58d0: 43 61 63 68 65 2d 3e 6e 39 30 70 63 74 0a 20 20  Cache->n90pct.  
58e0: 20 20 20 7c 7c 20 28 70 63 61 63 68 65 31 55 6e     || (pcache1Un
58f0: 64 65 72 4d 65 6d 6f 72 79 50 72 65 73 73 75 72  derMemoryPressur
5900: 65 28 70 43 61 63 68 65 29 20 26 26 20 70 43 61  e(pCache) && pCa
5910: 63 68 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65  che->nRecyclable
5920: 3c 6e 50 69 6e 6e 65 64 29 0a 20 20 29 29 7b 0a  <nPinned).  )){.
5930: 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20      return 0;.  
5940: 7d 0a 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d  }..  if( pCache-
5950: 3e 6e 50 61 67 65 3e 3d 70 43 61 63 68 65 2d 3e  >nPage>=pCache->
5960: 6e 48 61 73 68 20 29 20 70 63 61 63 68 65 31 52  nHash ) pcache1R
5970: 65 73 69 7a 65 48 61 73 68 28 70 43 61 63 68 65  esizeHash(pCache
5980: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61  );.  assert( pCa
5990: 63 68 65 2d 3e 6e 48 61 73 68 3e 30 20 26 26 20  che->nHash>0 && 
59a0: 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 20 29  pCache->apHash )
59b0: 3b 0a 0a 20 20 2f 2a 20 53 74 65 70 20 34 2e 20  ;..  /* Step 4. 
59c0: 54 72 79 20 74 6f 20 72 65 63 79 63 6c 65 20 61  Try to recycle a
59d0: 20 70 61 67 65 2e 20 2a 2f 0a 20 20 69 66 28 20   page. */.  if( 
59e0: 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62  pCache->bPurgeab
59f0: 6c 65 20 26 26 20 70 47 72 6f 75 70 2d 3e 70 4c  le && pGroup->pL
5a00: 72 75 54 61 69 6c 20 26 26 20 28 0a 20 20 20 20  ruTail && (.    
5a10: 20 20 20 20 20 28 70 43 61 63 68 65 2d 3e 6e 50       (pCache->nP
5a20: 61 67 65 2b 31 3e 3d 70 43 61 63 68 65 2d 3e 6e  age+1>=pCache->n
5a30: 4d 61 78 29 0a 20 20 20 20 20 20 7c 7c 20 70 47  Max).      || pG
5a40: 72 6f 75 70 2d 3e 6e 43 75 72 72 65 6e 74 50 61  roup->nCurrentPa
5a50: 67 65 3e 3d 70 47 72 6f 75 70 2d 3e 6e 4d 61 78  ge>=pGroup->nMax
5a60: 50 61 67 65 0a 20 20 20 20 20 20 7c 7c 20 70 63  Page.      || pc
5a70: 61 63 68 65 31 55 6e 64 65 72 4d 65 6d 6f 72 79  ache1UnderMemory
5a80: 50 72 65 73 73 75 72 65 28 70 43 61 63 68 65 29  Pressure(pCache)
5a90: 0a 20 20 29 29 7b 0a 20 20 20 20 50 43 61 63 68  .  )){.    PCach
5aa0: 65 31 20 2a 70 4f 74 68 65 72 3b 0a 20 20 20 20  e1 *pOther;.    
5ab0: 70 50 61 67 65 20 3d 20 70 47 72 6f 75 70 2d 3e  pPage = pGroup->
5ac0: 70 4c 72 75 54 61 69 6c 3b 0a 20 20 20 20 61 73  pLruTail;.    as
5ad0: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 69 73 50  sert( pPage->isP
5ae0: 69 6e 6e 65 64 3d 3d 30 20 29 3b 0a 20 20 20 20  inned==0 );.    
5af0: 70 63 61 63 68 65 31 52 65 6d 6f 76 65 46 72 6f  pcache1RemoveFro
5b00: 6d 48 61 73 68 28 70 50 61 67 65 29 3b 0a 20 20  mHash(pPage);.  
5b10: 20 20 70 63 61 63 68 65 31 50 69 6e 50 61 67 65    pcache1PinPage
5b20: 28 70 50 61 67 65 29 3b 0a 20 20 20 20 70 4f 74  (pPage);.    pOt
5b30: 68 65 72 20 3d 20 70 50 61 67 65 2d 3e 70 43 61  her = pPage->pCa
5b40: 63 68 65 3b 0a 0a 20 20 20 20 2f 2a 20 57 65 20  che;..    /* We 
5b50: 77 61 6e 74 20 74 6f 20 76 65 72 69 66 79 20 74  want to verify t
5b60: 68 61 74 20 73 7a 50 61 67 65 20 61 6e 64 20 73  hat szPage and s
5b70: 7a 45 78 74 72 61 20 61 72 65 20 74 68 65 20 73  zExtra are the s
5b80: 61 6d 65 20 66 6f 72 20 70 4f 74 68 65 72 0a 20  ame for pOther. 
5b90: 20 20 20 2a 2a 20 61 6e 64 20 70 43 61 63 68 65     ** and pCache
5ba0: 2e 20 20 41 73 73 65 72 74 20 74 68 61 74 20 77  .  Assert that w
5bb0: 65 20 63 61 6e 20 76 65 72 69 66 79 20 74 68 69  e can verify thi
5bc0: 73 20 62 79 20 63 6f 6d 70 61 72 69 6e 67 20 73  s by comparing s
5bd0: 75 6d 73 2e 20 2a 2f 0a 20 20 20 20 61 73 73 65  ums. */.    asse
5be0: 72 74 28 20 28 70 43 61 63 68 65 2d 3e 73 7a 50  rt( (pCache->szP
5bf0: 61 67 65 20 26 20 28 70 43 61 63 68 65 2d 3e 73  age & (pCache->s
5c00: 7a 50 61 67 65 2d 31 29 29 3d 3d 30 20 26 26 20  zPage-1))==0 && 
5c10: 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 3e 3d  pCache->szPage>=
5c20: 35 31 32 20 29 3b 0a 20 20 20 20 61 73 73 65 72  512 );.    asser
5c30: 74 28 20 70 43 61 63 68 65 2d 3e 73 7a 45 78 74  t( pCache->szExt
5c40: 72 61 3c 35 31 32 20 29 3b 0a 20 20 20 20 61 73  ra<512 );.    as
5c50: 73 65 72 74 28 20 28 70 4f 74 68 65 72 2d 3e 73  sert( (pOther->s
5c60: 7a 50 61 67 65 20 26 20 28 70 4f 74 68 65 72 2d  zPage & (pOther-
5c70: 3e 73 7a 50 61 67 65 2d 31 29 29 3d 3d 30 20 26  >szPage-1))==0 &
5c80: 26 20 70 4f 74 68 65 72 2d 3e 73 7a 50 61 67 65  & pOther->szPage
5c90: 3e 3d 35 31 32 20 29 3b 0a 20 20 20 20 61 73 73  >=512 );.    ass
5ca0: 65 72 74 28 20 70 4f 74 68 65 72 2d 3e 73 7a 45  ert( pOther->szE
5cb0: 78 74 72 61 3c 35 31 32 20 29 3b 0a 0a 20 20 20  xtra<512 );..   
5cc0: 20 69 66 28 20 70 4f 74 68 65 72 2d 3e 73 7a 50   if( pOther->szP
5cd0: 61 67 65 2b 70 4f 74 68 65 72 2d 3e 73 7a 45 78  age+pOther->szEx
5ce0: 74 72 61 20 21 3d 20 70 43 61 63 68 65 2d 3e 73  tra != pCache->s
5cf0: 7a 50 61 67 65 2b 70 43 61 63 68 65 2d 3e 73 7a  zPage+pCache->sz
5d00: 45 78 74 72 61 20 29 7b 0a 20 20 20 20 20 20 70  Extra ){.      p
5d10: 63 61 63 68 65 31 46 72 65 65 50 61 67 65 28 70  cache1FreePage(p
5d20: 50 61 67 65 29 3b 0a 20 20 20 20 20 20 70 50 61  Page);.      pPa
5d30: 67 65 20 3d 20 30 3b 0a 20 20 20 20 7d 65 6c 73  ge = 0;.    }els
5d40: 65 7b 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d  e{.      pGroup-
5d50: 3e 6e 43 75 72 72 65 6e 74 50 61 67 65 20 2d 3d  >nCurrentPage -=
5d60: 20 28 70 4f 74 68 65 72 2d 3e 62 50 75 72 67 65   (pOther->bPurge
5d70: 61 62 6c 65 20 2d 20 70 43 61 63 68 65 2d 3e 62  able - pCache->b
5d80: 50 75 72 67 65 61 62 6c 65 29 3b 0a 20 20 20 20  Purgeable);.    
5d90: 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 53 74 65 70  }.  }..  /* Step
5da0: 20 35 2e 20 49 66 20 61 20 75 73 61 62 6c 65 20   5. If a usable 
5db0: 70 61 67 65 20 62 75 66 66 65 72 20 68 61 73 20  page buffer has 
5dc0: 73 74 69 6c 6c 20 6e 6f 74 20 62 65 65 6e 20 66  still not been f
5dd0: 6f 75 6e 64 2c 20 0a 20 20 2a 2a 20 61 74 74 65  ound, .  ** atte
5de0: 6d 70 74 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20  mpt to allocate 
5df0: 61 20 6e 65 77 20 6f 6e 65 2e 20 0a 20 20 2a 2f  a new one. .  */
5e00: 0a 20 20 69 66 28 20 21 70 50 61 67 65 20 29 7b  .  if( !pPage ){
5e10: 0a 20 20 20 20 69 66 28 20 63 72 65 61 74 65 46  .    if( createF
5e20: 6c 61 67 3d 3d 31 20 29 20 73 71 6c 69 74 65 33  lag==1 ) sqlite3
5e30: 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f  BeginBenignMallo
5e40: 63 28 29 3b 0a 20 20 20 20 70 50 61 67 65 20 3d  c();.    pPage =
5e50: 20 70 63 61 63 68 65 31 41 6c 6c 6f 63 50 61 67   pcache1AllocPag
5e60: 65 28 70 43 61 63 68 65 29 3b 0a 20 20 20 20 69  e(pCache);.    i
5e70: 66 28 20 63 72 65 61 74 65 46 6c 61 67 3d 3d 31  f( createFlag==1
5e80: 20 29 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e   ) sqlite3EndBen
5e90: 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 7d  ignMalloc();.  }
5ea0: 0a 0a 20 20 69 66 28 20 70 50 61 67 65 20 29 7b  ..  if( pPage ){
5eb0: 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20 69 6e  .    unsigned in
5ec0: 74 20 68 20 3d 20 69 4b 65 79 20 25 20 70 43 61  t h = iKey % pCa
5ed0: 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 20 20  che->nHash;.    
5ee0: 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 2b 2b 3b  pCache->nPage++;
5ef0: 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 4b 65 79  .    pPage->iKey
5f00: 20 3d 20 69 4b 65 79 3b 0a 20 20 20 20 70 50 61   = iKey;.    pPa
5f10: 67 65 2d 3e 70 4e 65 78 74 20 3d 20 70 43 61 63  ge->pNext = pCac
5f20: 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 3b 0a 20  he->apHash[h];. 
5f30: 20 20 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65     pPage->pCache
5f40: 20 3d 20 70 43 61 63 68 65 3b 0a 20 20 20 20 70   = pCache;.    p
5f50: 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 20 3d  Page->pLruPrev =
5f60: 20 30 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 70   0;.    pPage->p
5f70: 4c 72 75 4e 65 78 74 20 3d 20 30 3b 0a 20 20 20  LruNext = 0;.   
5f80: 20 70 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64   pPage->isPinned
5f90: 20 3d 20 31 3b 0a 20 20 20 20 2a 28 76 6f 69 64   = 1;.    *(void
5fa0: 20 2a 2a 29 70 50 61 67 65 2d 3e 70 61 67 65 2e   **)pPage->page.
5fb0: 70 45 78 74 72 61 20 3d 20 30 3b 0a 20 20 20 20  pExtra = 0;.    
5fc0: 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68  pCache->apHash[h
5fd0: 5d 20 3d 20 70 50 61 67 65 3b 0a 20 20 20 20 69  ] = pPage;.    i
5fe0: 66 28 20 69 4b 65 79 3e 70 43 61 63 68 65 2d 3e  f( iKey>pCache->
5ff0: 69 4d 61 78 4b 65 79 20 29 7b 0a 20 20 20 20 20  iMaxKey ){.     
6000: 20 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79   pCache->iMaxKey
6010: 20 3d 20 69 4b 65 79 3b 0a 20 20 20 20 7d 0a 20   = iKey;.    }. 
6020: 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 50 61 67   }.  return pPag
6030: 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c  e;.}../*.** Impl
6040: 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68  ementation of th
6050: 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  e sqlite3_pcache
6060: 2e 78 46 65 74 63 68 20 6d 65 74 68 6f 64 2e 20  .xFetch method. 
6070: 0a 2a 2a 0a 2a 2a 20 46 65 74 63 68 20 61 20 70  .**.** Fetch a p
6080: 61 67 65 20 62 79 20 6b 65 79 20 76 61 6c 75 65  age by key value
6090: 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 74 68 65 72 20  ..**.** Whether 
60a0: 6f 72 20 6e 6f 74 20 61 20 6e 65 77 20 70 61 67  or not a new pag
60b0: 65 20 6d 61 79 20 62 65 20 61 6c 6c 6f 63 61 74  e may be allocat
60c0: 65 64 20 62 79 20 74 68 69 73 20 66 75 6e 63 74  ed by this funct
60d0: 69 6f 6e 20 64 65 70 65 6e 64 73 20 6f 6e 0a 2a  ion depends on.*
60e0: 2a 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74  * the value of t
60f0: 68 65 20 63 72 65 61 74 65 46 6c 61 67 20 61 72  he createFlag ar
6100: 67 75 6d 65 6e 74 2e 20 20 30 20 6d 65 61 6e 73  gument.  0 means
6110: 20 64 6f 20 6e 6f 74 20 61 6c 6c 6f 63 61 74 65   do not allocate
6120: 20 61 20 6e 65 77 0a 2a 2a 20 70 61 67 65 2e 20   a new.** page. 
6130: 20 31 20 6d 65 61 6e 73 20 61 6c 6c 6f 63 61 74   1 means allocat
6140: 65 20 61 20 6e 65 77 20 70 61 67 65 20 69 66 20  e a new page if 
6150: 73 70 61 63 65 20 69 73 20 65 61 73 69 6c 79 20  space is easily 
6160: 61 76 61 69 6c 61 62 6c 65 2e 20 20 32 20 0a 2a  available.  2 .*
6170: 2a 20 6d 65 61 6e 73 20 74 6f 20 74 72 79 20 72  * means to try r
6180: 65 61 6c 6c 79 20 68 61 72 64 20 74 6f 20 61 6c  eally hard to al
6190: 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 70 61 67  locate a new pag
61a0: 65 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 61 20 6e  e..**.** For a n
61b0: 6f 6e 2d 70 75 72 67 65 61 62 6c 65 20 63 61 63  on-purgeable cac
61c0: 68 65 20 28 61 20 63 61 63 68 65 20 75 73 65 64  he (a cache used
61d0: 20 61 73 20 74 68 65 20 73 74 6f 72 61 67 65 20   as the storage 
61e0: 66 6f 72 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79  for an in-memory
61f0: 0a 2a 2a 20 64 61 74 61 62 61 73 65 29 20 74 68  .** database) th
6200: 65 72 65 20 69 73 20 72 65 61 6c 6c 79 20 6e 6f  ere is really no
6210: 20 64 69 66 66 65 72 65 6e 63 65 20 62 65 74 77   difference betw
6220: 65 65 6e 20 63 72 65 61 74 65 46 6c 61 67 20 31  een createFlag 1
6230: 20 61 6e 64 20 32 2e 20 20 53 6f 0a 2a 2a 20 74   and 2.  So.** t
6240: 68 65 20 63 61 6c 6c 69 6e 67 20 66 75 6e 63 74  he calling funct
6250: 69 6f 6e 20 28 70 63 61 63 68 65 2e 63 29 20 77  ion (pcache.c) w
6260: 69 6c 6c 20 6e 65 76 65 72 20 68 61 76 65 20 61  ill never have a
6270: 20 63 72 65 61 74 65 46 6c 61 67 20 6f 66 20 31   createFlag of 1
6280: 20 6f 6e 0a 2a 2a 20 61 20 6e 6f 6e 2d 70 75 72   on.** a non-pur
6290: 67 65 61 62 6c 65 20 63 61 63 68 65 2e 0a 2a 2a  geable cache..**
62a0: 0a 2a 2a 20 54 68 65 72 65 20 61 72 65 20 74 68  .** There are th
62b0: 72 65 65 20 64 69 66 66 65 72 65 6e 74 20 61 70  ree different ap
62c0: 70 72 6f 61 63 68 65 73 20 74 6f 20 6f 62 74 61  proaches to obta
62d0: 69 6e 69 6e 67 20 73 70 61 63 65 20 66 6f 72 20  ining space for 
62e0: 61 20 70 61 67 65 2c 0a 2a 2a 20 64 65 70 65 6e  a page,.** depen
62f0: 64 69 6e 67 20 6f 6e 20 74 68 65 20 76 61 6c 75  ding on the valu
6300: 65 20 6f 66 20 70 61 72 61 6d 65 74 65 72 20 63  e of parameter c
6310: 72 65 61 74 65 46 6c 61 67 20 28 77 68 69 63 68  reateFlag (which
6320: 20 6d 61 79 20 62 65 20 30 2c 20 31 20 6f 72 20   may be 0, 1 or 
6330: 32 29 2e 0a 2a 2a 0a 2a 2a 20 20 20 31 2e 20 52  2)..**.**   1. R
6340: 65 67 61 72 64 6c 65 73 73 20 6f 66 20 74 68 65  egardless of the
6350: 20 76 61 6c 75 65 20 6f 66 20 63 72 65 61 74 65   value of create
6360: 46 6c 61 67 2c 20 74 68 65 20 63 61 63 68 65 20  Flag, the cache 
6370: 69 73 20 73 65 61 72 63 68 65 64 20 66 6f 72 20  is searched for 
6380: 61 20 0a 2a 2a 20 20 20 20 20 20 63 6f 70 79 20  a .**      copy 
6390: 6f 66 20 74 68 65 20 72 65 71 75 65 73 74 65 64  of the requested
63a0: 20 70 61 67 65 2e 20 49 66 20 6f 6e 65 20 69 73   page. If one is
63b0: 20 66 6f 75 6e 64 2c 20 69 74 20 69 73 20 72 65   found, it is re
63c0: 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 20 20  turned..**.**   
63d0: 32 2e 20 49 66 20 63 72 65 61 74 65 46 6c 61 67  2. If createFlag
63e0: 3d 3d 30 20 61 6e 64 20 74 68 65 20 70 61 67 65  ==0 and the page
63f0: 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20   is not already 
6400: 69 6e 20 74 68 65 20 63 61 63 68 65 2c 20 4e 55  in the cache, NU
6410: 4c 4c 20 69 73 0a 2a 2a 20 20 20 20 20 20 72 65  LL is.**      re
6420: 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 20 20  turned..**.**   
6430: 33 2e 20 49 66 20 63 72 65 61 74 65 46 6c 61 67  3. If createFlag
6440: 20 69 73 20 31 2c 20 61 6e 64 20 74 68 65 20 70   is 1, and the p
6450: 61 67 65 20 69 73 20 6e 6f 74 20 61 6c 72 65 61  age is not alrea
6460: 64 79 20 69 6e 20 74 68 65 20 63 61 63 68 65 2c  dy in the cache,
6470: 20 74 68 65 6e 0a 2a 2a 20 20 20 20 20 20 72 65   then.**      re
6480: 74 75 72 6e 20 4e 55 4c 4c 20 28 64 6f 20 6e 6f  turn NULL (do no
6490: 74 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77  t allocate a new
64a0: 20 70 61 67 65 29 20 69 66 20 61 6e 79 20 6f 66   page) if any of
64b0: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 2a   the following.*
64c0: 2a 20 20 20 20 20 20 63 6f 6e 64 69 74 69 6f 6e  *      condition
64d0: 73 20 61 72 65 20 74 72 75 65 3a 0a 2a 2a 0a 2a  s are true:.**.*
64e0: 2a 20 20 20 20 20 20 20 28 61 29 20 74 68 65 20  *       (a) the 
64f0: 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20  number of pages 
6500: 70 69 6e 6e 65 64 20 62 79 20 74 68 65 20 63 61  pinned by the ca
6510: 63 68 65 20 69 73 20 67 72 65 61 74 65 72 20 74  che is greater t
6520: 68 61 6e 0a 2a 2a 20 20 20 20 20 20 20 20 20 20  han.**          
6530: 20 50 43 61 63 68 65 31 2e 6e 4d 61 78 2c 20 6f   PCache1.nMax, o
6540: 72 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 28 62  r.**.**       (b
6550: 29 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  ) the number of 
6560: 70 61 67 65 73 20 70 69 6e 6e 65 64 20 62 79 20  pages pinned by 
6570: 74 68 65 20 63 61 63 68 65 20 69 73 20 67 72 65  the cache is gre
6580: 61 74 65 72 20 74 68 61 6e 0a 2a 2a 20 20 20 20  ater than.**    
6590: 20 20 20 20 20 20 20 74 68 65 20 73 75 6d 20 6f         the sum o
65a0: 66 20 6e 4d 61 78 20 66 6f 72 20 61 6c 6c 20 70  f nMax for all p
65b0: 75 72 67 65 61 62 6c 65 20 63 61 63 68 65 73 2c  urgeable caches,
65c0: 20 6c 65 73 73 20 74 68 65 20 73 75 6d 20 6f 66   less the sum of
65d0: 20 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 6e   .**           n
65e0: 4d 69 6e 20 66 6f 72 20 61 6c 6c 20 6f 74 68 65  Min for all othe
65f0: 72 20 70 75 72 67 65 61 62 6c 65 20 63 61 63 68  r purgeable cach
6600: 65 73 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 20 20 34  es, or.**.**   4
6610: 2e 20 49 66 20 6e 6f 6e 65 20 6f 66 20 74 68 65  . If none of the
6620: 20 66 69 72 73 74 20 74 68 72 65 65 20 63 6f 6e   first three con
6630: 64 69 74 69 6f 6e 73 20 61 70 70 6c 79 20 61 6e  ditions apply an
6640: 64 20 74 68 65 20 63 61 63 68 65 20 69 73 20 6d  d the cache is m
6650: 61 72 6b 65 64 0a 2a 2a 20 20 20 20 20 20 61 73  arked.**      as
6660: 20 70 75 72 67 65 61 62 6c 65 2c 20 61 6e 64 20   purgeable, and 
6670: 69 66 20 6f 6e 65 20 6f 66 20 74 68 65 20 66 6f  if one of the fo
6680: 6c 6c 6f 77 69 6e 67 20 69 73 20 74 72 75 65 3a  llowing is true:
6690: 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 28 61 29  .**.**       (a)
66a0: 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70   The number of p
66b0: 61 67 65 73 20 61 6c 6c 6f 63 61 74 65 64 20 66  ages allocated f
66c0: 6f 72 20 74 68 65 20 63 61 63 68 65 20 69 73 20  or the cache is 
66d0: 61 6c 72 65 61 64 79 20 0a 2a 2a 20 20 20 20 20  already .**     
66e0: 20 20 20 20 20 20 50 43 61 63 68 65 31 2e 6e 4d        PCache1.nM
66f0: 61 78 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 20 20 20  ax, or.**.**    
6700: 20 20 20 28 62 29 20 54 68 65 20 6e 75 6d 62 65     (b) The numbe
6710: 72 20 6f 66 20 70 61 67 65 73 20 61 6c 6c 6f 63  r of pages alloc
6720: 61 74 65 64 20 66 6f 72 20 61 6c 6c 20 70 75 72  ated for all pur
6730: 67 65 61 62 6c 65 20 63 61 63 68 65 73 20 69 73  geable caches is
6740: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 61 6c  .**           al
6750: 72 65 61 64 79 20 65 71 75 61 6c 20 74 6f 20 6f  ready equal to o
6760: 72 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 74  r greater than t
6770: 68 65 20 73 75 6d 20 6f 66 20 6e 4d 61 78 20 66  he sum of nMax f
6780: 6f 72 20 61 6c 6c 0a 2a 2a 20 20 20 20 20 20 20  or all.**       
6790: 20 20 20 20 70 75 72 67 65 61 62 6c 65 20 63 61      purgeable ca
67a0: 63 68 65 73 2c 0a 2a 2a 0a 2a 2a 20 20 20 20 20  ches,.**.**     
67b0: 20 20 28 63 29 20 54 68 65 20 73 79 73 74 65 6d    (c) The system
67c0: 20 69 73 20 75 6e 64 65 72 20 6d 65 6d 6f 72 79   is under memory
67d0: 20 70 72 65 73 73 75 72 65 20 61 6e 64 20 77 61   pressure and wa
67e0: 6e 74 73 20 74 6f 20 61 76 6f 69 64 0a 2a 2a 20  nts to avoid.** 
67f0: 20 20 20 20 20 20 20 20 20 20 75 6e 6e 65 63 65            unnece
6800: 73 73 61 72 79 20 70 61 67 65 73 20 63 61 63 68  ssary pages cach
6810: 65 20 65 6e 74 72 79 20 61 6c 6c 6f 63 61 74 69  e entry allocati
6820: 6f 6e 73 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 74  ons.**.**      t
6830: 68 65 6e 20 61 74 74 65 6d 70 74 20 74 6f 20 72  hen attempt to r
6840: 65 63 79 63 6c 65 20 61 20 70 61 67 65 20 66 72  ecycle a page fr
6850: 6f 6d 20 74 68 65 20 4c 52 55 20 6c 69 73 74 2e  om the LRU list.
6860: 20 49 66 20 69 74 20 69 73 20 74 68 65 20 72 69   If it is the ri
6870: 67 68 74 0a 2a 2a 20 20 20 20 20 20 73 69 7a 65  ght.**      size
6880: 2c 20 72 65 74 75 72 6e 20 74 68 65 20 72 65 63  , return the rec
6890: 79 63 6c 65 64 20 62 75 66 66 65 72 2e 20 4f 74  ycled buffer. Ot
68a0: 68 65 72 77 69 73 65 2c 20 66 72 65 65 20 74 68  herwise, free th
68b0: 65 20 62 75 66 66 65 72 20 61 6e 64 0a 2a 2a 20  e buffer and.** 
68c0: 20 20 20 20 20 70 72 6f 63 65 65 64 20 74 6f 20       proceed to 
68d0: 73 74 65 70 20 35 2e 20 0a 2a 2a 0a 2a 2a 20 20  step 5. .**.**  
68e0: 20 35 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 61   5. Otherwise, a
68f0: 6c 6c 6f 63 61 74 65 20 61 6e 64 20 72 65 74 75  llocate and retu
6900: 72 6e 20 61 20 6e 65 77 20 70 61 67 65 20 62 75  rn a new page bu
6910: 66 66 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  ffer..*/.static 
6920: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 70  sqlite3_pcache_p
6930: 61 67 65 20 2a 70 63 61 63 68 65 31 46 65 74 63  age *pcache1Fetc
6940: 68 28 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 61  h(.  sqlite3_pca
6950: 63 68 65 20 2a 70 2c 20 0a 20 20 75 6e 73 69 67  che *p, .  unsig
6960: 6e 65 64 20 69 6e 74 20 69 4b 65 79 2c 20 0a 20  ned int iKey, . 
6970: 20 69 6e 74 20 63 72 65 61 74 65 46 6c 61 67 0a   int createFlag.
6980: 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43  ){.  PCache1 *pC
6990: 61 63 68 65 20 3d 20 28 50 43 61 63 68 65 31 20  ache = (PCache1 
69a0: 2a 29 70 3b 0a 20 20 50 67 48 64 72 31 20 2a 70  *)p;.  PgHdr1 *p
69b0: 50 61 67 65 20 3d 20 30 3b 0a 0a 20 20 61 73 73  Page = 0;..  ass
69c0: 65 72 74 28 20 6f 66 66 73 65 74 6f 66 28 50 67  ert( offsetof(Pg
69d0: 48 64 72 31 2c 70 61 67 65 29 3d 3d 30 20 29 3b  Hdr1,page)==0 );
69e0: 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68  .  assert( pCach
69f0: 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 7c 7c  e->bPurgeable ||
6a00: 20 63 72 65 61 74 65 46 6c 61 67 21 3d 31 20 29   createFlag!=1 )
6a10: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63  ;.  assert( pCac
6a20: 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 7c  he->bPurgeable |
6a30: 7c 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 3d 3d  | pCache->nMin==
6a40: 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  0 );.  assert( p
6a50: 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c  Cache->bPurgeabl
6a60: 65 3d 3d 30 20 7c 7c 20 70 43 61 63 68 65 2d 3e  e==0 || pCache->
6a70: 6e 4d 69 6e 3d 3d 31 30 20 29 3b 0a 20 20 61 73  nMin==10 );.  as
6a80: 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 4d  sert( pCache->nM
6a90: 69 6e 3d 3d 30 20 7c 7c 20 70 43 61 63 68 65 2d  in==0 || pCache-
6aa0: 3e 62 50 75 72 67 65 61 62 6c 65 20 29 3b 0a 20  >bPurgeable );. 
6ab0: 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65 2d   assert( pCache-
6ac0: 3e 6e 48 61 73 68 3e 30 20 29 3b 0a 20 20 70 63  >nHash>0 );.  pc
6ad0: 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28  ache1EnterMutex(
6ae0: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b  pCache->pGroup);
6af0: 0a 0a 20 20 2f 2a 20 53 74 65 70 20 31 3a 20 53  ..  /* Step 1: S
6b00: 65 61 72 63 68 20 74 68 65 20 68 61 73 68 20 74  earch the hash t
6b10: 61 62 6c 65 20 66 6f 72 20 61 6e 20 65 78 69 73  able for an exis
6b20: 74 69 6e 67 20 65 6e 74 72 79 2e 20 2a 2f 0a 20  ting entry. */. 
6b30: 20 70 50 61 67 65 20 3d 20 70 43 61 63 68 65 2d   pPage = pCache-
6b40: 3e 61 70 48 61 73 68 5b 69 4b 65 79 20 25 20 70  >apHash[iKey % p
6b50: 43 61 63 68 65 2d 3e 6e 48 61 73 68 5d 3b 0a 20  Cache->nHash];. 
6b60: 20 77 68 69 6c 65 28 20 70 50 61 67 65 20 26 26   while( pPage &&
6b70: 20 70 50 61 67 65 2d 3e 69 4b 65 79 21 3d 69 4b   pPage->iKey!=iK
6b80: 65 79 20 29 7b 20 70 50 61 67 65 20 3d 20 70 50  ey ){ pPage = pP
6b90: 61 67 65 2d 3e 70 4e 65 78 74 3b 20 7d 0a 0a 20  age->pNext; }.. 
6ba0: 20 2f 2a 20 53 74 65 70 20 32 3a 20 41 62 6f 72   /* Step 2: Abor
6bb0: 74 20 69 66 20 6e 6f 20 65 78 69 73 74 69 6e 67  t if no existing
6bc0: 20 70 61 67 65 20 69 73 20 66 6f 75 6e 64 20 61   page is found a
6bd0: 6e 64 20 63 72 65 61 74 65 46 6c 61 67 20 69 73  nd createFlag is
6be0: 20 30 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67   0 */.  if( pPag
6bf0: 65 20 29 7b 0a 20 20 20 20 69 66 28 20 21 70 50  e ){.    if( !pP
6c00: 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64 20 29 20  age->isPinned ) 
6c10: 70 63 61 63 68 65 31 50 69 6e 50 61 67 65 28 70  pcache1PinPage(p
6c20: 50 61 67 65 29 3b 0a 20 20 7d 65 6c 73 65 20 69  Page);.  }else i
6c30: 66 28 20 63 72 65 61 74 65 46 6c 61 67 20 29 7b  f( createFlag ){
6c40: 0a 20 20 20 20 2f 2a 20 53 74 65 70 73 20 33 2c  .    /* Steps 3,
6c50: 20 34 2c 20 61 6e 64 20 35 20 69 6d 70 6c 65 6d   4, and 5 implem
6c60: 65 6e 74 65 64 20 62 79 20 74 68 69 73 20 73 75  ented by this su
6c70: 62 72 6f 75 74 69 6e 65 20 2a 2f 0a 20 20 20 20  broutine */.    
6c80: 70 50 61 67 65 20 3d 20 70 63 61 63 68 65 31 46  pPage = pcache1F
6c90: 65 74 63 68 53 74 61 67 65 32 28 70 43 61 63 68  etchStage2(pCach
6ca0: 65 2c 20 69 4b 65 79 2c 20 63 72 65 61 74 65 46  e, iKey, createF
6cb0: 6c 61 67 29 3b 0a 20 20 7d 0a 20 20 61 73 73 65  lag);.  }.  asse
6cc0: 72 74 28 20 70 50 61 67 65 3d 3d 30 20 7c 7c 20  rt( pPage==0 || 
6cd0: 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 3e  pCache->iMaxKey>
6ce0: 3d 69 4b 65 79 20 29 3b 0a 20 20 70 63 61 63 68  =iKey );.  pcach
6cf0: 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70 43 61  e1LeaveMutex(pCa
6d00: 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20  che->pGroup);.  
6d10: 72 65 74 75 72 6e 20 28 73 71 6c 69 74 65 33 5f  return (sqlite3_
6d20: 70 63 61 63 68 65 5f 70 61 67 65 2a 29 70 50 61  pcache_page*)pPa
6d30: 67 65 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 49 6d  ge;.}.../*.** Im
6d40: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20  plementation of 
6d50: 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63  the sqlite3_pcac
6d60: 68 65 2e 78 55 6e 70 69 6e 20 6d 65 74 68 6f 64  he.xUnpin method
6d70: 2e 0a 2a 2a 0a 2a 2a 20 4d 61 72 6b 20 61 20 70  ..**.** Mark a p
6d80: 61 67 65 20 61 73 20 75 6e 70 69 6e 6e 65 64 20  age as unpinned 
6d90: 28 65 6c 69 67 69 62 6c 65 20 66 6f 72 20 61 73  (eligible for as
6da0: 79 6e 63 68 72 6f 6e 6f 75 73 20 72 65 63 79 63  ynchronous recyc
6db0: 6c 69 6e 67 29 2e 0a 2a 2f 0a 73 74 61 74 69 63  ling)..*/.static
6dc0: 20 76 6f 69 64 20 70 63 61 63 68 65 31 55 6e 70   void pcache1Unp
6dd0: 69 6e 28 0a 20 20 73 71 6c 69 74 65 33 5f 70 63  in(.  sqlite3_pc
6de0: 61 63 68 65 20 2a 70 2c 20 0a 20 20 73 71 6c 69  ache *p, .  sqli
6df0: 74 65 33 5f 70 63 61 63 68 65 5f 70 61 67 65 20  te3_pcache_page 
6e00: 2a 70 50 67 2c 20 0a 20 20 69 6e 74 20 72 65 75  *pPg, .  int reu
6e10: 73 65 55 6e 6c 69 6b 65 6c 79 0a 29 7b 0a 20 20  seUnlikely.){.  
6e20: 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 20  PCache1 *pCache 
6e30: 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b 0a  = (PCache1 *)p;.
6e40: 20 20 50 67 48 64 72 31 20 2a 70 50 61 67 65 20    PgHdr1 *pPage 
6e50: 3d 20 28 50 67 48 64 72 31 20 2a 29 70 50 67 3b  = (PgHdr1 *)pPg;
6e60: 0a 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f 75  .  PGroup *pGrou
6e70: 70 20 3d 20 70 43 61 63 68 65 2d 3e 70 47 72 6f  p = pCache->pGro
6e80: 75 70 3b 0a 20 0a 20 20 61 73 73 65 72 74 28 20  up;. .  assert( 
6e90: 70 50 61 67 65 2d 3e 70 43 61 63 68 65 3d 3d 70  pPage->pCache==p
6ea0: 43 61 63 68 65 20 29 3b 0a 20 20 70 63 61 63 68  Cache );.  pcach
6eb0: 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70 47 72  e1EnterMutex(pGr
6ec0: 6f 75 70 29 3b 0a 0a 20 20 2f 2a 20 49 74 20 69  oup);..  /* It i
6ed0: 73 20 61 6e 20 65 72 72 6f 72 20 74 6f 20 63 61  s an error to ca
6ee0: 6c 6c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e  ll this function
6ef0: 20 69 66 20 74 68 65 20 70 61 67 65 20 69 73 20   if the page is 
6f00: 61 6c 72 65 61 64 79 20 0a 20 20 2a 2a 20 70 61  already .  ** pa
6f10: 72 74 20 6f 66 20 74 68 65 20 50 47 72 6f 75 70  rt of the PGroup
6f20: 20 4c 52 55 20 6c 69 73 74 2e 0a 20 20 2a 2f 0a   LRU list..  */.
6f30: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d    assert( pPage-
6f40: 3e 70 4c 72 75 50 72 65 76 3d 3d 30 20 26 26 20  >pLruPrev==0 && 
6f50: 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74 3d  pPage->pLruNext=
6f60: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  =0 );.  assert( 
6f70: 70 47 72 6f 75 70 2d 3e 70 4c 72 75 48 65 61 64  pGroup->pLruHead
6f80: 21 3d 70 50 61 67 65 20 26 26 20 70 47 72 6f 75  !=pPage && pGrou
6f90: 70 2d 3e 70 4c 72 75 54 61 69 6c 21 3d 70 50 61  p->pLruTail!=pPa
6fa0: 67 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  ge );.  assert( 
6fb0: 70 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64 3d  pPage->isPinned=
6fc0: 3d 31 20 29 3b 0a 0a 20 20 69 66 28 20 72 65 75  =1 );..  if( reu
6fd0: 73 65 55 6e 6c 69 6b 65 6c 79 20 7c 7c 20 70 47  seUnlikely || pG
6fe0: 72 6f 75 70 2d 3e 6e 43 75 72 72 65 6e 74 50 61  roup->nCurrentPa
6ff0: 67 65 3e 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50  ge>pGroup->nMaxP
7000: 61 67 65 20 29 7b 0a 20 20 20 20 70 63 61 63 68  age ){.    pcach
7010: 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73 68  e1RemoveFromHash
7020: 28 70 50 61 67 65 29 3b 0a 20 20 20 20 70 63 61  (pPage);.    pca
7030: 63 68 65 31 46 72 65 65 50 61 67 65 28 70 50 61  che1FreePage(pPa
7040: 67 65 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  ge);.  }else{.  
7050: 20 20 2f 2a 20 41 64 64 20 74 68 65 20 70 61 67    /* Add the pag
7060: 65 20 74 6f 20 74 68 65 20 50 47 72 6f 75 70 20  e to the PGroup 
7070: 4c 52 55 20 6c 69 73 74 2e 20 2a 2f 0a 20 20 20  LRU list. */.   
7080: 20 69 66 28 20 70 47 72 6f 75 70 2d 3e 70 4c 72   if( pGroup->pLr
7090: 75 48 65 61 64 20 29 7b 0a 20 20 20 20 20 20 70  uHead ){.      p
70a0: 47 72 6f 75 70 2d 3e 70 4c 72 75 48 65 61 64 2d  Group->pLruHead-
70b0: 3e 70 4c 72 75 50 72 65 76 20 3d 20 70 50 61 67  >pLruPrev = pPag
70c0: 65 3b 0a 20 20 20 20 20 20 70 50 61 67 65 2d 3e  e;.      pPage->
70d0: 70 4c 72 75 4e 65 78 74 20 3d 20 70 47 72 6f 75  pLruNext = pGrou
70e0: 70 2d 3e 70 4c 72 75 48 65 61 64 3b 0a 20 20 20  p->pLruHead;.   
70f0: 20 20 20 70 47 72 6f 75 70 2d 3e 70 4c 72 75 48     pGroup->pLruH
7100: 65 61 64 20 3d 20 70 50 61 67 65 3b 0a 20 20 20  ead = pPage;.   
7110: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 47   }else{.      pG
7120: 72 6f 75 70 2d 3e 70 4c 72 75 54 61 69 6c 20 3d  roup->pLruTail =
7130: 20 70 50 61 67 65 3b 0a 20 20 20 20 20 20 70 47   pPage;.      pG
7140: 72 6f 75 70 2d 3e 70 4c 72 75 48 65 61 64 20 3d  roup->pLruHead =
7150: 20 70 50 61 67 65 3b 0a 20 20 20 20 7d 0a 20 20   pPage;.    }.  
7160: 20 20 70 43 61 63 68 65 2d 3e 6e 52 65 63 79 63    pCache->nRecyc
7170: 6c 61 62 6c 65 2b 2b 3b 0a 20 20 20 20 70 50 61  lable++;.    pPa
7180: 67 65 2d 3e 69 73 50 69 6e 6e 65 64 20 3d 20 30  ge->isPinned = 0
7190: 3b 0a 20 20 7d 0a 0a 20 20 70 63 61 63 68 65 31  ;.  }..  pcache1
71a0: 4c 65 61 76 65 4d 75 74 65 78 28 70 43 61 63 68  LeaveMutex(pCach
71b0: 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 7d 0a 0a 2f  e->pGroup);.}../
71c0: 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74  *.** Implementat
71d0: 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74  ion of the sqlit
71e0: 65 33 5f 70 63 61 63 68 65 2e 78 52 65 6b 65 79  e3_pcache.xRekey
71f0: 20 6d 65 74 68 6f 64 2e 20 0a 2a 2f 0a 73 74 61   method. .*/.sta
7200: 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31  tic void pcache1
7210: 52 65 6b 65 79 28 0a 20 20 73 71 6c 69 74 65 33  Rekey(.  sqlite3
7220: 5f 70 63 61 63 68 65 20 2a 70 2c 0a 20 20 73 71  _pcache *p,.  sq
7230: 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 70 61 67  lite3_pcache_pag
7240: 65 20 2a 70 50 67 2c 0a 20 20 75 6e 73 69 67 6e  e *pPg,.  unsign
7250: 65 64 20 69 6e 74 20 69 4f 6c 64 2c 0a 20 20 75  ed int iOld,.  u
7260: 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4e 65 77  nsigned int iNew
7270: 0a 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70  .){.  PCache1 *p
7280: 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 65 31  Cache = (PCache1
7290: 20 2a 29 70 3b 0a 20 20 50 67 48 64 72 31 20 2a   *)p;.  PgHdr1 *
72a0: 70 50 61 67 65 20 3d 20 28 50 67 48 64 72 31 20  pPage = (PgHdr1 
72b0: 2a 29 70 50 67 3b 0a 20 20 50 67 48 64 72 31 20  *)pPg;.  PgHdr1 
72c0: 2a 2a 70 70 3b 0a 20 20 75 6e 73 69 67 6e 65 64  **pp;.  unsigned
72d0: 20 69 6e 74 20 68 3b 20 0a 20 20 61 73 73 65 72   int h; .  asser
72e0: 74 28 20 70 50 61 67 65 2d 3e 69 4b 65 79 3d 3d  t( pPage->iKey==
72f0: 69 4f 6c 64 20 29 3b 0a 20 20 61 73 73 65 72 74  iOld );.  assert
7300: 28 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65 3d  ( pPage->pCache=
7310: 3d 70 43 61 63 68 65 20 29 3b 0a 0a 20 20 70 63  =pCache );..  pc
7320: 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28  ache1EnterMutex(
7330: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b  pCache->pGroup);
7340: 0a 0a 20 20 68 20 3d 20 69 4f 6c 64 25 70 43 61  ..  h = iOld%pCa
7350: 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 70 70  che->nHash;.  pp
7360: 20 3d 20 26 70 43 61 63 68 65 2d 3e 61 70 48 61   = &pCache->apHa
7370: 73 68 5b 68 5d 3b 0a 20 20 77 68 69 6c 65 28 20  sh[h];.  while( 
7380: 28 2a 70 70 29 21 3d 70 50 61 67 65 20 29 7b 0a  (*pp)!=pPage ){.
7390: 20 20 20 20 70 70 20 3d 20 26 28 2a 70 70 29 2d      pp = &(*pp)-
73a0: 3e 70 4e 65 78 74 3b 0a 20 20 7d 0a 20 20 2a 70  >pNext;.  }.  *p
73b0: 70 20 3d 20 70 50 61 67 65 2d 3e 70 4e 65 78 74  p = pPage->pNext
73c0: 3b 0a 0a 20 20 68 20 3d 20 69 4e 65 77 25 70 43  ;..  h = iNew%pC
73d0: 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 70  ache->nHash;.  p
73e0: 50 61 67 65 2d 3e 69 4b 65 79 20 3d 20 69 4e 65  Page->iKey = iNe
73f0: 77 3b 0a 20 20 70 50 61 67 65 2d 3e 70 4e 65 78  w;.  pPage->pNex
7400: 74 20 3d 20 70 43 61 63 68 65 2d 3e 61 70 48 61  t = pCache->apHa
7410: 73 68 5b 68 5d 3b 0a 20 20 70 43 61 63 68 65 2d  sh[h];.  pCache-
7420: 3e 61 70 48 61 73 68 5b 68 5d 20 3d 20 70 50 61  >apHash[h] = pPa
7430: 67 65 3b 0a 20 20 69 66 28 20 69 4e 65 77 3e 70  ge;.  if( iNew>p
7440: 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 29  Cache->iMaxKey )
7450: 7b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 69 4d  {.    pCache->iM
7460: 61 78 4b 65 79 20 3d 20 69 4e 65 77 3b 0a 20 20  axKey = iNew;.  
7470: 7d 0a 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76  }..  pcache1Leav
7480: 65 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70  eMutex(pCache->p
7490: 47 72 6f 75 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  Group);.}../*.**
74a0: 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20   Implementation 
74b0: 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70  of the sqlite3_p
74c0: 63 61 63 68 65 2e 78 54 72 75 6e 63 61 74 65 20  cache.xTruncate 
74d0: 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 44  method. .**.** D
74e0: 69 73 63 61 72 64 20 61 6c 6c 20 75 6e 70 69 6e  iscard all unpin
74f0: 6e 65 64 20 70 61 67 65 73 20 69 6e 20 74 68 65  ned pages in the
7500: 20 63 61 63 68 65 20 77 69 74 68 20 61 20 70 61   cache with a pa
7510: 67 65 20 6e 75 6d 62 65 72 20 65 71 75 61 6c 20  ge number equal 
7520: 74 6f 0a 2a 2a 20 6f 72 20 67 72 65 61 74 65 72  to.** or greater
7530: 20 74 68 61 6e 20 70 61 72 61 6d 65 74 65 72 20   than parameter 
7540: 69 4c 69 6d 69 74 2e 20 41 6e 79 20 70 69 6e 6e  iLimit. Any pinn
7550: 65 64 20 70 61 67 65 73 20 77 69 74 68 20 61 20  ed pages with a 
7560: 70 61 67 65 20 6e 75 6d 62 65 72 0a 2a 2a 20 65  page number.** e
7570: 71 75 61 6c 20 74 6f 20 6f 72 20 67 72 65 61 74  qual to or great
7580: 65 72 20 74 68 61 6e 20 69 4c 69 6d 69 74 20 61  er than iLimit a
7590: 72 65 20 69 6d 70 6c 69 63 69 74 6c 79 20 75 6e  re implicitly un
75a0: 70 69 6e 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69  pinned..*/.stati
75b0: 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 54 72  c void pcache1Tr
75c0: 75 6e 63 61 74 65 28 73 71 6c 69 74 65 33 5f 70  uncate(sqlite3_p
75d0: 63 61 63 68 65 20 2a 70 2c 20 75 6e 73 69 67 6e  cache *p, unsign
75e0: 65 64 20 69 6e 74 20 69 4c 69 6d 69 74 29 7b 0a  ed int iLimit){.
75f0: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68    PCache1 *pCach
7600: 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70  e = (PCache1 *)p
7610: 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65 72  ;.  pcache1Enter
7620: 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47  Mutex(pCache->pG
7630: 72 6f 75 70 29 3b 0a 20 20 69 66 28 20 69 4c 69  roup);.  if( iLi
7640: 6d 69 74 3c 3d 70 43 61 63 68 65 2d 3e 69 4d 61  mit<=pCache->iMa
7650: 78 4b 65 79 20 29 7b 0a 20 20 20 20 70 63 61 63  xKey ){.    pcac
7660: 68 65 31 54 72 75 6e 63 61 74 65 55 6e 73 61 66  he1TruncateUnsaf
7670: 65 28 70 43 61 63 68 65 2c 20 69 4c 69 6d 69 74  e(pCache, iLimit
7680: 29 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 69  );.    pCache->i
7690: 4d 61 78 4b 65 79 20 3d 20 69 4c 69 6d 69 74 2d  MaxKey = iLimit-
76a0: 31 3b 0a 20 20 7d 0a 20 20 70 63 61 63 68 65 31  1;.  }.  pcache1
76b0: 4c 65 61 76 65 4d 75 74 65 78 28 70 43 61 63 68  LeaveMutex(pCach
76c0: 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 7d 0a 0a 2f  e->pGroup);.}../
76d0: 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74  *.** Implementat
76e0: 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74  ion of the sqlit
76f0: 65 33 5f 70 63 61 63 68 65 2e 78 44 65 73 74 72  e3_pcache.xDestr
7700: 6f 79 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a  oy method. .**.*
7710: 2a 20 44 65 73 74 72 6f 79 20 61 20 63 61 63 68  * Destroy a cach
7720: 65 20 61 6c 6c 6f 63 61 74 65 64 20 75 73 69 6e  e allocated usin
7730: 67 20 70 63 61 63 68 65 31 43 72 65 61 74 65 28  g pcache1Create(
7740: 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  )..*/.static voi
7750: 64 20 70 63 61 63 68 65 31 44 65 73 74 72 6f 79  d pcache1Destroy
7760: 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20  (sqlite3_pcache 
7770: 2a 70 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a  *p){.  PCache1 *
7780: 70 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 65  pCache = (PCache
7790: 31 20 2a 29 70 3b 0a 20 20 50 47 72 6f 75 70 20  1 *)p;.  PGroup 
77a0: 2a 70 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65  *pGroup = pCache
77b0: 2d 3e 70 47 72 6f 75 70 3b 0a 20 20 61 73 73 65  ->pGroup;.  asse
77c0: 72 74 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72  rt( pCache->bPur
77d0: 67 65 61 62 6c 65 20 7c 7c 20 28 70 43 61 63 68  geable || (pCach
77e0: 65 2d 3e 6e 4d 61 78 3d 3d 30 20 26 26 20 70 43  e->nMax==0 && pC
77f0: 61 63 68 65 2d 3e 6e 4d 69 6e 3d 3d 30 29 20 29  ache->nMin==0) )
7800: 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65 72  ;.  pcache1Enter
7810: 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20  Mutex(pGroup);. 
7820: 20 70 63 61 63 68 65 31 54 72 75 6e 63 61 74 65   pcache1Truncate
7830: 55 6e 73 61 66 65 28 70 43 61 63 68 65 2c 20 30  Unsafe(pCache, 0
7840: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 47 72  );.  assert( pGr
7850: 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 3e 3d  oup->nMaxPage >=
7860: 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 20 29 3b   pCache->nMax );
7870: 0a 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50  .  pGroup->nMaxP
7880: 61 67 65 20 2d 3d 20 70 43 61 63 68 65 2d 3e 6e  age -= pCache->n
7890: 4d 61 78 3b 0a 20 20 61 73 73 65 72 74 28 20 70  Max;.  assert( p
78a0: 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 20  Group->nMinPage 
78b0: 3e 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 20  >= pCache->nMin 
78c0: 29 3b 0a 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 69  );.  pGroup->nMi
78d0: 6e 50 61 67 65 20 2d 3d 20 70 43 61 63 68 65 2d  nPage -= pCache-
78e0: 3e 6e 4d 69 6e 3b 0a 20 20 70 47 72 6f 75 70 2d  >nMin;.  pGroup-
78f0: 3e 6d 78 50 69 6e 6e 65 64 20 3d 20 70 47 72 6f  >mxPinned = pGro
7900: 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 2b 20 31  up->nMaxPage + 1
7910: 30 20 2d 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e  0 - pGroup->nMin
7920: 50 61 67 65 3b 0a 20 20 70 63 61 63 68 65 31 45  Page;.  pcache1E
7930: 6e 66 6f 72 63 65 4d 61 78 50 61 67 65 28 70 47  nforceMaxPage(pG
7940: 72 6f 75 70 29 3b 0a 20 20 70 63 61 63 68 65 31  roup);.  pcache1
7950: 4c 65 61 76 65 4d 75 74 65 78 28 70 47 72 6f 75  LeaveMutex(pGrou
7960: 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66 72  p);.  sqlite3_fr
7970: 65 65 28 70 43 61 63 68 65 2d 3e 61 70 48 61 73  ee(pCache->apHas
7980: 68 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66 72  h);.  sqlite3_fr
7990: 65 65 28 70 43 61 63 68 65 29 3b 0a 7d 0a 0a 2f  ee(pCache);.}../
79a0: 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69  *.** This functi
79b0: 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 64 75 72  on is called dur
79c0: 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a 61 74 69  ing initializati
79d0: 6f 6e 20 28 73 71 6c 69 74 65 33 5f 69 6e 69 74  on (sqlite3_init
79e0: 69 61 6c 69 7a 65 28 29 29 20 74 6f 0a 2a 2a 20  ialize()) to.** 
79f0: 69 6e 73 74 61 6c 6c 20 74 68 65 20 64 65 66 61  install the defa
7a00: 75 6c 74 20 70 6c 75 67 67 61 62 6c 65 20 63 61  ult pluggable ca
7a10: 63 68 65 20 6d 6f 64 75 6c 65 2c 20 61 73 73 75  che module, assu
7a20: 6d 69 6e 67 20 74 68 65 20 75 73 65 72 20 68 61  ming the user ha
7a30: 73 20 6e 6f 74 0a 2a 2a 20 61 6c 72 65 61 64 79  s not.** already
7a40: 20 70 72 6f 76 69 64 65 64 20 61 6e 20 61 6c 74   provided an alt
7a50: 65 72 6e 61 74 69 76 65 2e 0a 2a 2f 0a 76 6f 69  ernative..*/.voi
7a60: 64 20 73 71 6c 69 74 65 33 50 43 61 63 68 65 53  d sqlite3PCacheS
7a70: 65 74 44 65 66 61 75 6c 74 28 76 6f 69 64 29 7b  etDefault(void){
7a80: 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20  .  static const 
7a90: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 6d  sqlite3_pcache_m
7aa0: 65 74 68 6f 64 73 32 20 64 65 66 61 75 6c 74 4d  ethods2 defaultM
7ab0: 65 74 68 6f 64 73 20 3d 20 7b 0a 20 20 20 20 31  ethods = {.    1
7ac0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
7ad0: 20 20 20 20 20 20 20 20 2f 2a 20 69 56 65 72 73          /* iVers
7ae0: 69 6f 6e 20 2a 2f 0a 20 20 20 20 30 2c 20 20 20  ion */.    0,   
7af0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7b00: 20 20 20 20 2f 2a 20 70 41 72 67 20 2a 2f 0a 20      /* pArg */. 
7b10: 20 20 20 70 63 61 63 68 65 31 49 6e 69 74 2c 20     pcache1Init, 
7b20: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78              /* x
7b30: 49 6e 69 74 20 2a 2f 0a 20 20 20 20 70 63 61 63  Init */.    pcac
7b40: 68 65 31 53 68 75 74 64 6f 77 6e 2c 20 20 20 20  he1Shutdown,    
7b50: 20 20 20 20 20 2f 2a 20 78 53 68 75 74 64 6f 77       /* xShutdow
7b60: 6e 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31  n */.    pcache1
7b70: 43 72 65 61 74 65 2c 20 20 20 20 20 20 20 20 20  Create,         
7b80: 20 20 2f 2a 20 78 43 72 65 61 74 65 20 2a 2f 0a    /* xCreate */.
7b90: 20 20 20 20 70 63 61 63 68 65 31 43 61 63 68 65      pcache1Cache
7ba0: 73 69 7a 65 2c 20 20 20 20 20 20 20 20 2f 2a 20  size,        /* 
7bb0: 78 43 61 63 68 65 73 69 7a 65 20 2a 2f 0a 20 20  xCachesize */.  
7bc0: 20 20 70 63 61 63 68 65 31 50 61 67 65 63 6f 75    pcache1Pagecou
7bd0: 6e 74 2c 20 20 20 20 20 20 20 20 2f 2a 20 78 50  nt,        /* xP
7be0: 61 67 65 63 6f 75 6e 74 20 2a 2f 0a 20 20 20 20  agecount */.    
7bf0: 70 63 61 63 68 65 31 46 65 74 63 68 2c 20 20 20  pcache1Fetch,   
7c00: 20 20 20 20 20 20 20 20 20 2f 2a 20 78 46 65 74           /* xFet
7c10: 63 68 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65  ch */.    pcache
7c20: 31 55 6e 70 69 6e 2c 20 20 20 20 20 20 20 20 20  1Unpin,         
7c30: 20 20 20 2f 2a 20 78 55 6e 70 69 6e 20 2a 2f 0a     /* xUnpin */.
7c40: 20 20 20 20 70 63 61 63 68 65 31 52 65 6b 65 79      pcache1Rekey
7c50: 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ,            /* 
7c60: 78 52 65 6b 65 79 20 2a 2f 0a 20 20 20 20 70 63  xRekey */.    pc
7c70: 61 63 68 65 31 54 72 75 6e 63 61 74 65 2c 20 20  ache1Truncate,  
7c80: 20 20 20 20 20 20 20 2f 2a 20 78 54 72 75 6e 63         /* xTrunc
7c90: 61 74 65 20 2a 2f 0a 20 20 20 20 70 63 61 63 68  ate */.    pcach
7ca0: 65 31 44 65 73 74 72 6f 79 2c 20 20 20 20 20 20  e1Destroy,      
7cb0: 20 20 20 20 2f 2a 20 78 44 65 73 74 72 6f 79 20      /* xDestroy 
7cc0: 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 53 68  */.    pcache1Sh
7cd0: 72 69 6e 6b 20 20 20 20 20 20 20 20 20 20 20 20  rink            
7ce0: 2f 2a 20 78 53 68 72 69 6e 6b 20 2a 2f 0a 20 20  /* xShrink */.  
7cf0: 7d 3b 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e  };.  sqlite3_con
7d00: 66 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49  fig(SQLITE_CONFI
7d10: 47 5f 50 43 41 43 48 45 32 2c 20 26 64 65 66 61  G_PCACHE2, &defa
7d20: 75 6c 74 4d 65 74 68 6f 64 73 29 3b 0a 7d 0a 0a  ultMethods);.}..
7d30: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65  /*.** Return the
7d40: 20 73 69 7a 65 20 6f 66 20 74 68 65 20 68 65 61   size of the hea
7d50: 64 65 72 20 6f 6e 20 65 61 63 68 20 70 61 67 65  der on each page
7d60: 20 6f 66 20 74 68 69 73 20 50 43 41 43 48 45 20   of this PCACHE 
7d70: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 0a  implementation..
7d80: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 48 65  */.int sqlite3He
7d90: 61 64 65 72 53 69 7a 65 50 63 61 63 68 65 31 28  aderSizePcache1(
7da0: 76 6f 69 64 29 7b 20 72 65 74 75 72 6e 20 52 4f  void){ return RO
7db0: 55 4e 44 38 28 73 69 7a 65 6f 66 28 50 67 48 64  UND8(sizeof(PgHd
7dc0: 72 31 29 29 3b 20 7d 0a 0a 2f 2a 0a 2a 2a 20 52  r1)); }../*.** R
7dd0: 65 74 75 72 6e 20 74 68 65 20 67 6c 6f 62 61 6c  eturn the global
7de0: 20 6d 75 74 65 78 20 75 73 65 64 20 62 79 20 74   mutex used by t
7df0: 68 69 73 20 50 43 41 43 48 45 20 69 6d 70 6c 65  his PCACHE imple
7e00: 6d 65 6e 74 61 74 69 6f 6e 2e 20 20 54 68 65 0a  mentation.  The.
7e10: 2a 2a 20 73 71 6c 69 74 65 33 5f 73 74 61 74 75  ** sqlite3_statu
7e20: 73 28 29 20 72 6f 75 74 69 6e 65 20 6e 65 65 64  s() routine need
7e30: 73 20 61 63 63 65 73 73 20 74 6f 20 74 68 69 73  s access to this
7e40: 20 6d 75 74 65 78 2e 0a 2a 2f 0a 73 71 6c 69 74   mutex..*/.sqlit
7e50: 65 33 5f 6d 75 74 65 78 20 2a 73 71 6c 69 74 65  e3_mutex *sqlite
7e60: 33 50 63 61 63 68 65 31 4d 75 74 65 78 28 76 6f  3Pcache1Mutex(vo
7e70: 69 64 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 63  id){.  return pc
7e80: 61 63 68 65 31 2e 6d 75 74 65 78 3b 0a 7d 0a 0a  ache1.mutex;.}..
7e90: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e  #ifdef SQLITE_EN
7ea0: 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41  ABLE_MEMORY_MANA
7eb0: 47 45 4d 45 4e 54 0a 2f 2a 0a 2a 2a 20 54 68 69  GEMENT./*.** Thi
7ec0: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61  s function is ca
7ed0: 6c 6c 65 64 20 74 6f 20 66 72 65 65 20 73 75 70  lled to free sup
7ee0: 65 72 66 6c 75 6f 75 73 20 64 79 6e 61 6d 69 63  erfluous dynamic
7ef0: 61 6c 6c 79 20 61 6c 6c 6f 63 61 74 65 64 20 6d  ally allocated m
7f00: 65 6d 6f 72 79 0a 2a 2a 20 68 65 6c 64 20 62 79  emory.** held by
7f10: 20 74 68 65 20 70 61 67 65 72 20 73 79 73 74 65   the pager syste
7f20: 6d 2e 20 4d 65 6d 6f 72 79 20 69 6e 20 75 73 65  m. Memory in use
7f30: 20 62 79 20 61 6e 79 20 53 51 4c 69 74 65 20 70   by any SQLite p
7f40: 61 67 65 72 20 61 6c 6c 6f 63 61 74 65 64 0a 2a  ager allocated.*
7f50: 2a 20 62 79 20 74 68 65 20 63 75 72 72 65 6e 74  * by the current
7f60: 20 74 68 72 65 61 64 20 6d 61 79 20 62 65 20 73   thread may be s
7f70: 71 6c 69 74 65 33 5f 66 72 65 65 28 29 65 64 2e  qlite3_free()ed.
7f80: 0a 2a 2a 0a 2a 2a 20 6e 52 65 71 20 69 73 20 74  .**.** nReq is t
7f90: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74  he number of byt
7fa0: 65 73 20 6f 66 20 6d 65 6d 6f 72 79 20 72 65 71  es of memory req
7fb0: 75 69 72 65 64 2e 20 4f 6e 63 65 20 74 68 69 73  uired. Once this
7fc0: 20 6d 75 63 68 20 68 61 73 0a 2a 2a 20 62 65 65   much has.** bee
7fd0: 6e 20 72 65 6c 65 61 73 65 64 2c 20 74 68 65 20  n released, the 
7fe0: 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73  function returns
7ff0: 2e 20 54 68 65 20 72 65 74 75 72 6e 20 76 61 6c  . The return val
8000: 75 65 20 69 73 20 74 68 65 20 74 6f 74 61 6c 20  ue is the total 
8010: 6e 75 6d 62 65 72 20 0a 2a 2a 20 6f 66 20 62 79  number .** of by
8020: 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79 20 72 65  tes of memory re
8030: 6c 65 61 73 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73  leased..*/.int s
8040: 71 6c 69 74 65 33 50 63 61 63 68 65 52 65 6c 65  qlite3PcacheRele
8050: 61 73 65 4d 65 6d 6f 72 79 28 69 6e 74 20 6e 52  aseMemory(int nR
8060: 65 71 29 7b 0a 20 20 69 6e 74 20 6e 46 72 65 65  eq){.  int nFree
8070: 20 3d 20 30 3b 0a 20 20 61 73 73 65 72 74 28 20   = 0;.  assert( 
8080: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6e 6f  sqlite3_mutex_no
8090: 74 68 65 6c 64 28 70 63 61 63 68 65 31 2e 67 72  theld(pcache1.gr
80a0: 70 2e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73  p.mutex) );.  as
80b0: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75  sert( sqlite3_mu
80c0: 74 65 78 5f 6e 6f 74 68 65 6c 64 28 70 63 61 63  tex_notheld(pcac
80d0: 68 65 31 2e 6d 75 74 65 78 29 20 29 3b 0a 20 20  he1.mutex) );.  
80e0: 69 66 28 20 70 63 61 63 68 65 31 2e 70 53 74 61  if( pcache1.pSta
80f0: 72 74 3d 3d 30 20 29 7b 0a 20 20 20 20 50 67 48  rt==0 ){.    PgH
8100: 64 72 31 20 2a 70 3b 0a 20 20 20 20 70 63 61 63  dr1 *p;.    pcac
8110: 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 26 70  he1EnterMutex(&p
8120: 63 61 63 68 65 31 2e 67 72 70 29 3b 0a 20 20 20  cache1.grp);.   
8130: 20 77 68 69 6c 65 28 20 28 6e 52 65 71 3c 30 20   while( (nReq<0 
8140: 7c 7c 20 6e 46 72 65 65 3c 6e 52 65 71 29 20 26  || nFree<nReq) &
8150: 26 20 28 28 70 3d 70 63 61 63 68 65 31 2e 67 72  & ((p=pcache1.gr
8160: 70 2e 70 4c 72 75 54 61 69 6c 29 21 3d 30 29 20  p.pLruTail)!=0) 
8170: 29 7b 0a 20 20 20 20 20 20 6e 46 72 65 65 20 2b  ){.      nFree +
8180: 3d 20 70 63 61 63 68 65 31 4d 65 6d 53 69 7a 65  = pcache1MemSize
8190: 28 70 2d 3e 70 61 67 65 2e 70 42 75 66 29 3b 0a  (p->page.pBuf);.
81a0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 50 43  #ifdef SQLITE_PC
81b0: 41 43 48 45 5f 53 45 50 41 52 41 54 45 5f 48 45  ACHE_SEPARATE_HE
81c0: 41 44 45 52 0a 20 20 20 20 20 20 6e 46 72 65 65  ADER.      nFree
81d0: 20 2b 3d 20 73 71 6c 69 74 65 33 4d 65 6d 53 69   += sqlite3MemSi
81e0: 7a 65 28 70 29 3b 0a 23 65 6e 64 69 66 0a 20 20  ze(p);.#endif.  
81f0: 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 69      assert( p->i
8200: 73 50 69 6e 6e 65 64 3d 3d 30 20 29 3b 0a 20 20  sPinned==0 );.  
8210: 20 20 20 20 70 63 61 63 68 65 31 50 69 6e 50 61      pcache1PinPa
8220: 67 65 28 70 29 3b 0a 20 20 20 20 20 20 70 63 61  ge(p);.      pca
8230: 63 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61  che1RemoveFromHa
8240: 73 68 28 70 29 3b 0a 20 20 20 20 20 20 70 63 61  sh(p);.      pca
8250: 63 68 65 31 46 72 65 65 50 61 67 65 28 70 29 3b  che1FreePage(p);
8260: 0a 20 20 20 20 7d 0a 20 20 20 20 70 63 61 63 68  .    }.    pcach
8270: 65 31 4c 65 61 76 65 4d 75 74 65 78 28 26 70 63  e1LeaveMutex(&pc
8280: 61 63 68 65 31 2e 67 72 70 29 3b 0a 20 20 7d 0a  ache1.grp);.  }.
8290: 20 20 72 65 74 75 72 6e 20 6e 46 72 65 65 3b 0a    return nFree;.
82a0: 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49  }.#endif /* SQLI
82b0: 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59  TE_ENABLE_MEMORY
82c0: 5f 4d 41 4e 41 47 45 4d 45 4e 54 20 2a 2f 0a 0a  _MANAGEMENT */..
82d0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45  #ifdef SQLITE_TE
82e0: 53 54 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75  ST./*.** This fu
82f0: 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 62  nction is used b
8300: 79 20 74 65 73 74 20 70 72 6f 63 65 64 75 72 65  y test procedure
8310: 73 20 74 6f 20 69 6e 73 70 65 63 74 20 74 68 65  s to inspect the
8320: 20 69 6e 74 65 72 6e 61 6c 20 73 74 61 74 65 0a   internal state.
8330: 2a 2a 20 6f 66 20 74 68 65 20 67 6c 6f 62 61 6c  ** of the global
8340: 20 63 61 63 68 65 2e 0a 2a 2f 0a 76 6f 69 64 20   cache..*/.void 
8350: 73 71 6c 69 74 65 33 50 63 61 63 68 65 53 74 61  sqlite3PcacheSta
8360: 74 73 28 0a 20 20 69 6e 74 20 2a 70 6e 43 75 72  ts(.  int *pnCur
8370: 72 65 6e 74 2c 20 20 20 20 20 20 2f 2a 20 4f 55  rent,      /* OU
8380: 54 3a 20 54 6f 74 61 6c 20 6e 75 6d 62 65 72 20  T: Total number 
8390: 6f 66 20 70 61 67 65 73 20 63 61 63 68 65 64 20  of pages cached 
83a0: 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 4d 61 78 2c  */.  int *pnMax,
83b0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54            /* OUT
83c0: 3a 20 47 6c 6f 62 61 6c 20 6d 61 78 69 6d 75 6d  : Global maximum
83d0: 20 63 61 63 68 65 20 73 69 7a 65 20 2a 2f 0a 20   cache size */. 
83e0: 20 69 6e 74 20 2a 70 6e 4d 69 6e 2c 20 20 20 20   int *pnMin,    
83f0: 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 53 75        /* OUT: Su
8400: 6d 20 6f 66 20 50 43 61 63 68 65 31 2e 6e 4d 69  m of PCache1.nMi
8410: 6e 20 66 6f 72 20 70 75 72 67 65 61 62 6c 65 20  n for purgeable 
8420: 63 61 63 68 65 73 20 2a 2f 0a 20 20 69 6e 74 20  caches */.  int 
8430: 2a 70 6e 52 65 63 79 63 6c 61 62 6c 65 20 20 20  *pnRecyclable   
8440: 20 2f 2a 20 4f 55 54 3a 20 54 6f 74 61 6c 20 6e   /* OUT: Total n
8450: 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 61  umber of pages a
8460: 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 72 65 63  vailable for rec
8470: 79 63 6c 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 50  ycling */.){.  P
8480: 67 48 64 72 31 20 2a 70 3b 0a 20 20 69 6e 74 20  gHdr1 *p;.  int 
8490: 6e 52 65 63 79 63 6c 61 62 6c 65 20 3d 20 30 3b  nRecyclable = 0;
84a0: 0a 20 20 66 6f 72 28 70 3d 70 63 61 63 68 65 31  .  for(p=pcache1
84b0: 2e 67 72 70 2e 70 4c 72 75 48 65 61 64 3b 20 70  .grp.pLruHead; p
84c0: 3b 20 70 3d 70 2d 3e 70 4c 72 75 4e 65 78 74 29  ; p=p->pLruNext)
84d0: 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 2d  {.    assert( p-
84e0: 3e 69 73 50 69 6e 6e 65 64 3d 3d 30 20 29 3b 0a  >isPinned==0 );.
84f0: 20 20 20 20 6e 52 65 63 79 63 6c 61 62 6c 65 2b      nRecyclable+
8500: 2b 3b 0a 20 20 7d 0a 20 20 2a 70 6e 43 75 72 72  +;.  }.  *pnCurr
8510: 65 6e 74 20 3d 20 70 63 61 63 68 65 31 2e 67 72  ent = pcache1.gr
8520: 70 2e 6e 43 75 72 72 65 6e 74 50 61 67 65 3b 0a  p.nCurrentPage;.
8530: 20 20 2a 70 6e 4d 61 78 20 3d 20 28 69 6e 74 29    *pnMax = (int)
8540: 70 63 61 63 68 65 31 2e 67 72 70 2e 6e 4d 61 78  pcache1.grp.nMax
8550: 50 61 67 65 3b 0a 20 20 2a 70 6e 4d 69 6e 20 3d  Page;.  *pnMin =
8560: 20 28 69 6e 74 29 70 63 61 63 68 65 31 2e 67 72   (int)pcache1.gr
8570: 70 2e 6e 4d 69 6e 50 61 67 65 3b 0a 20 20 2a 70  p.nMinPage;.  *p
8580: 6e 52 65 63 79 63 6c 61 62 6c 65 20 3d 20 6e 52  nRecyclable = nR
8590: 65 63 79 63 6c 61 62 6c 65 3b 0a 7d 0a 23 65 6e  ecyclable;.}.#en
85a0: 64 69 66 0a                                      dif.