/ Hex Artifact Content
Login
SQLite training in Houston TX on 2019-11-05 (details)
Part of the 2019 Tcl Conference

Artifact be64b2f3908a7f97c56c963676eb12f0d6254c95b28cdc1d73a186eff213219d:


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: 2a 0a 2a 2a 20 41 20 50 61 67 65 20 63 61 63 68  *.** A Page cach
02d0: 65 20 6c 69 6e 65 20 6c 6f 6f 6b 73 20 6c 69 6b  e line looks lik
02e0: 65 20 74 68 69 73 3a 0a 2a 2a 0a 2a 2a 20 20 2d  e this:.**.**  -
02f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0300: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0310: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0320: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 20  ------------.** 
0330: 20 7c 20 20 64 61 74 61 62 61 73 65 20 70 61 67   |  database pag
0340: 65 20 63 6f 6e 74 65 6e 74 20 20 20 7c 20 20 50  e content   |  P
0350: 67 48 64 72 31 20 20 7c 20 20 4d 65 6d 50 61 67  gHdr1  |  MemPag
0360: 65 20 20 7c 20 20 50 67 48 64 72 20 20 7c 0a 2a  e  |  PgHdr  |.*
0370: 2a 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  *  -------------
0380: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0390: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
03a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
03b0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 64 61 74 61 62  .**.** The datab
03c0: 61 73 65 20 70 61 67 65 20 63 6f 6e 74 65 6e 74  ase page content
03d0: 20 69 73 20 75 70 20 66 72 6f 6e 74 20 28 73 6f   is up front (so
03e0: 20 74 68 61 74 20 62 75 66 66 65 72 20 6f 76 65   that buffer ove
03f0: 72 72 65 61 64 73 20 74 65 6e 64 20 74 6f 0a 2a  rreads tend to.*
0400: 2a 20 66 6c 6f 77 20 68 61 72 6d 6c 65 73 73 6c  * flow harmlessl
0410: 79 20 69 6e 74 6f 20 74 68 65 20 50 67 48 64 72  y into the PgHdr
0420: 31 2c 20 4d 65 6d 50 61 67 65 2c 20 61 6e 64 20  1, MemPage, and 
0430: 50 67 48 64 72 20 65 78 74 65 6e 73 69 6f 6e 73  PgHdr extensions
0440: 29 2e 20 20 20 4d 65 6d 50 61 67 65 0a 2a 2a 20  ).   MemPage.** 
0450: 69 73 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e  is the extension
0460: 20 61 64 64 65 64 20 62 79 20 74 68 65 20 62 74   added by the bt
0470: 72 65 65 2e 63 20 6d 6f 64 75 6c 65 20 63 6f 6e  ree.c module con
0480: 74 61 69 6e 69 6e 67 20 69 6e 66 6f 72 6d 61 74  taining informat
0490: 69 6f 6e 20 73 75 63 68 0a 2a 2a 20 61 73 20 74  ion such.** as t
04a0: 68 65 20 64 61 74 61 62 61 73 65 20 70 61 67 65  he database page
04b0: 20 6e 75 6d 62 65 72 20 61 6e 64 20 68 6f 77 20   number and how 
04c0: 74 68 61 74 20 64 61 74 61 62 61 73 65 20 70 61  that database pa
04d0: 67 65 20 69 73 20 75 73 65 64 2e 20 20 50 67 48  ge is used.  PgH
04e0: 64 72 0a 2a 2a 20 69 73 20 61 64 64 65 64 20 62  dr.** is added b
04f0: 79 20 74 68 65 20 70 63 61 63 68 65 2e 63 20 6c  y the pcache.c l
0500: 61 79 65 72 20 61 6e 64 20 63 6f 6e 74 61 69 6e  ayer and contain
0510: 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 75 73  s information us
0520: 65 64 20 74 6f 20 6b 65 65 70 20 74 72 61 63 6b  ed to keep track
0530: 0a 2a 2a 20 6f 66 20 77 68 69 63 68 20 70 61 67  .** of which pag
0540: 65 73 20 61 72 65 20 22 64 69 72 74 79 22 2e 20  es are "dirty". 
0550: 20 50 67 48 64 72 31 20 69 73 20 61 6e 20 65 78   PgHdr1 is an ex
0560: 74 65 6e 73 69 6f 6e 20 61 64 64 65 64 20 62 79  tension added by
0570: 20 74 68 69 73 0a 2a 2a 20 6d 6f 64 75 6c 65 20   this.** module 
0580: 28 70 63 61 63 68 65 31 2e 63 29 2e 20 20 54 68  (pcache1.c).  Th
0590: 65 20 50 67 48 64 72 31 20 68 65 61 64 65 72 20  e PgHdr1 header 
05a0: 69 73 20 61 20 73 75 62 63 6c 61 73 73 20 6f 66  is a subclass of
05b0: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f   sqlite3_pcache_
05c0: 70 61 67 65 2e 0a 2a 2a 20 50 67 48 64 72 31 20  page..** PgHdr1 
05d0: 63 6f 6e 74 61 69 6e 73 20 69 6e 66 6f 72 6d 61  contains informa
05e0: 74 69 6f 6e 20 6e 65 65 64 65 64 20 74 6f 20 6c  tion needed to l
05f0: 6f 6f 6b 20 75 70 20 61 20 70 61 67 65 20 62 79  ook up a page by
0600: 20 69 74 73 20 70 61 67 65 20 6e 75 6d 62 65 72   its page number
0610: 2e 0a 2a 2a 20 54 68 65 20 73 75 70 65 72 63 6c  ..** The supercl
0620: 61 73 73 20 73 71 6c 69 74 65 33 5f 70 63 61 63  ass sqlite3_pcac
0630: 68 65 5f 70 61 67 65 2e 70 42 75 66 20 70 6f 69  he_page.pBuf poi
0640: 6e 74 73 20 74 6f 20 74 68 65 20 73 74 61 72 74  nts to the start
0650: 20 6f 66 20 74 68 65 0a 2a 2a 20 64 61 74 61 62   of the.** datab
0660: 61 73 65 20 70 61 67 65 20 63 6f 6e 74 65 6e 74  ase page content
0670: 20 61 6e 64 20 73 71 6c 69 74 65 33 5f 70 63 61   and sqlite3_pca
0680: 63 68 65 5f 70 61 67 65 2e 70 45 78 74 72 61 20  che_page.pExtra 
0690: 70 6f 69 6e 74 73 20 74 6f 20 50 67 48 64 72 2e  points to PgHdr.
06a0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 69 7a 65 20  .**.** The size 
06b0: 6f 66 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e  of the extension
06c0: 20 28 4d 65 6d 50 61 67 65 2b 50 67 48 64 72 2b   (MemPage+PgHdr+
06d0: 50 67 48 64 72 31 29 20 63 61 6e 20 62 65 20 64  PgHdr1) can be d
06e0: 65 74 65 72 6d 69 6e 65 64 20 61 74 0a 2a 2a 20  etermined at.** 
06f0: 72 75 6e 74 69 6d 65 20 75 73 69 6e 67 20 73 71  runtime using sq
0700: 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c  lite3_config(SQL
0710: 49 54 45 5f 43 4f 4e 46 49 47 5f 50 43 41 43 48  ITE_CONFIG_PCACH
0720: 45 5f 48 44 52 53 5a 2c 20 26 73 69 7a 65 29 2e  E_HDRSZ, &size).
0730: 20 20 54 68 65 0a 2a 2a 20 73 69 7a 65 73 20 6f    The.** sizes o
0740: 66 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e 73  f the extensions
0750: 20 73 75 6d 20 74 6f 20 32 37 32 20 62 79 74 65   sum to 272 byte
0760: 73 20 6f 6e 20 78 36 34 20 66 6f 72 20 33 2e 38  s on x64 for 3.8
0770: 2e 31 30 2c 20 62 75 74 20 74 68 69 73 0a 2a 2a  .10, but this.**
0780: 20 73 69 7a 65 20 63 61 6e 20 76 61 72 79 20 61   size can vary a
0790: 63 63 6f 72 64 69 6e 67 20 74 6f 20 61 72 63 68  ccording to arch
07a0: 69 74 65 63 74 75 72 65 2c 20 63 6f 6d 70 69 6c  itecture, compil
07b0: 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73 2c 20  e-time options, 
07c0: 61 6e 64 0a 2a 2a 20 53 51 4c 69 74 65 20 6c 69  and.** SQLite li
07d0: 62 72 61 72 79 20 76 65 72 73 69 6f 6e 20 6e 75  brary version nu
07e0: 6d 62 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 53  mber..**.** If S
07f0: 51 4c 49 54 45 5f 50 43 41 43 48 45 5f 53 45 50  QLITE_PCACHE_SEP
0800: 41 52 41 54 45 5f 48 45 41 44 45 52 20 69 73 20  ARATE_HEADER is 
0810: 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 74 68  defined, then th
0820: 65 20 65 78 74 65 6e 73 69 6f 6e 20 69 73 20 6f  e extension is o
0830: 62 74 61 69 6e 65 64 0a 2a 2a 20 75 73 69 6e 67  btained.** using
0840: 20 61 20 73 65 70 61 72 61 74 65 20 6d 65 6d 6f   a separate memo
0850: 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 66 72  ry allocation fr
0860: 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 20  om the database 
0870: 70 61 67 65 20 63 6f 6e 74 65 6e 74 2e 20 20 54  page content.  T
0880: 68 69 73 0a 2a 2a 20 73 65 65 6b 73 20 74 6f 20  his.** seeks to 
0890: 6f 76 65 72 63 6f 6d 65 20 74 68 65 20 22 63 6c  overcome the "cl
08a0: 6f 77 6e 73 68 6f 65 22 20 70 72 6f 62 6c 65 6d  ownshoe" problem
08b0: 20 28 61 6c 73 6f 20 63 61 6c 6c 65 64 20 22 69   (also called "i
08c0: 6e 74 65 72 6e 61 6c 0a 2a 2a 20 66 72 61 67 6d  nternal.** fragm
08d0: 65 6e 74 61 74 69 6f 6e 22 20 69 6e 20 61 63 61  entation" in aca
08e0: 64 65 6d 69 63 20 6c 69 74 65 72 61 74 75 72 65  demic literature
08f0: 29 20 6f 66 20 61 6c 6c 6f 63 61 74 69 6e 67 20  ) of allocating 
0900: 61 20 66 65 77 20 62 79 74 65 73 20 6d 6f 72 65  a few bytes more
0910: 0a 2a 2a 20 74 68 61 6e 20 61 20 70 6f 77 65 72  .** than a power
0920: 20 6f 66 20 74 77 6f 20 77 69 74 68 20 74 68 65   of two with the
0930: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f   memory allocato
0940: 72 20 72 6f 75 6e 64 69 6e 67 20 75 70 20 74 6f  r rounding up to
0950: 20 74 68 65 20 6e 65 78 74 0a 2a 2a 20 70 6f 77   the next.** pow
0960: 65 72 20 6f 66 20 74 77 6f 2c 20 61 6e 64 20 6c  er of two, and l
0970: 65 61 76 69 6e 67 20 74 68 65 20 72 6f 75 6e 64  eaving the round
0980: 65 64 2d 75 70 20 73 70 61 63 65 20 75 6e 75 73  ed-up space unus
0990: 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 6d  ed..**.** This m
09a0: 6f 64 75 6c 65 20 74 72 61 63 6b 73 20 70 6f 69  odule tracks poi
09b0: 6e 74 65 72 73 20 74 6f 20 50 67 48 64 72 31 20  nters to PgHdr1 
09c0: 6f 62 6a 65 63 74 73 2e 20 20 4f 6e 6c 79 20 70  objects.  Only p
09d0: 63 61 63 68 65 2e 63 20 63 6f 6d 6d 75 6e 69 63  cache.c communic
09e0: 61 74 65 73 0a 2a 2a 20 77 69 74 68 20 74 68 69  ates.** with thi
09f0: 73 20 6d 6f 64 75 6c 65 2e 20 20 49 6e 66 6f 72  s module.  Infor
0a00: 6d 61 74 69 6f 6e 20 69 73 20 70 61 73 73 65 64  mation is passed
0a10: 20 62 61 63 6b 20 61 6e 64 20 66 6f 72 74 68 20   back and forth 
0a20: 61 73 20 50 67 48 64 72 31 20 70 6f 69 6e 74 65  as PgHdr1 pointe
0a30: 72 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 63  rs..**.** The pc
0a40: 61 63 68 65 2e 63 20 61 6e 64 20 70 61 67 65 72  ache.c and pager
0a50: 2e 63 20 6d 6f 64 75 6c 65 73 20 64 65 61 6c 20  .c modules deal 
0a60: 70 6f 69 6e 74 65 72 73 20 74 6f 20 50 67 48 64  pointers to PgHd
0a70: 72 20 6f 62 6a 65 63 74 73 2e 0a 2a 2a 20 54 68  r objects..** Th
0a80: 65 20 62 74 72 65 65 2e 63 20 6d 6f 64 75 6c 65  e btree.c module
0a90: 20 64 65 61 6c 73 20 77 69 74 68 20 70 6f 69 6e   deals with poin
0aa0: 74 65 72 73 20 74 6f 20 4d 65 6d 50 61 67 65 20  ters to MemPage 
0ab0: 6f 62 6a 65 63 74 73 2e 0a 2a 2a 0a 2a 2a 20 53  objects..**.** S
0ac0: 4f 55 52 43 45 20 4f 46 20 50 41 47 45 20 43 41  OURCE OF PAGE CA
0ad0: 43 48 45 20 4d 45 4d 4f 52 59 3a 0a 2a 2a 0a 2a  CHE MEMORY:.**.*
0ae0: 2a 20 4d 65 6d 6f 72 79 20 66 6f 72 20 61 20 70  * Memory for a p
0af0: 61 67 65 20 6d 69 67 68 74 20 63 6f 6d 65 20 66  age might come f
0b00: 72 6f 6d 20 61 6e 79 20 6f 66 20 74 68 72 65 65  rom any of three
0b10: 20 73 6f 75 72 63 65 73 3a 0a 2a 2a 0a 2a 2a 20   sources:.**.** 
0b20: 20 20 20 28 31 29 20 20 54 68 65 20 67 65 6e 65     (1)  The gene
0b30: 72 61 6c 2d 70 75 72 70 6f 73 65 20 6d 65 6d 6f  ral-purpose memo
0b40: 72 79 20 61 6c 6c 6f 63 61 74 6f 72 20 2d 20 73  ry allocator - s
0b50: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 29 0a 2a  qlite3Malloc().*
0b60: 2a 20 20 20 20 28 32 29 20 20 47 6c 6f 62 61 6c  *    (2)  Global
0b70: 20 70 61 67 65 2d 63 61 63 68 65 20 6d 65 6d 6f   page-cache memo
0b80: 72 79 20 70 72 6f 76 69 64 65 64 20 75 73 69 6e  ry provided usin
0b90: 67 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67  g sqlite3_config
0ba0: 28 29 20 77 69 74 68 0a 2a 2a 20 20 20 20 20 20  () with.**      
0bb0: 20 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47     SQLITE_CONFIG
0bc0: 5f 50 41 47 45 43 41 43 48 45 2e 0a 2a 2a 20 20  _PAGECACHE..**  
0bd0: 20 20 28 33 29 20 20 50 43 61 63 68 65 2d 6c 6f    (3)  PCache-lo
0be0: 63 61 6c 20 62 75 6c 6b 20 61 6c 6c 6f 63 61 74  cal bulk allocat
0bf0: 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 74  ion..**.** The t
0c00: 68 69 72 64 20 63 61 73 65 20 69 73 20 61 20 63  hird case is a c
0c10: 68 75 6e 6b 20 6f 66 20 68 65 61 70 20 6d 65 6d  hunk of heap mem
0c20: 6f 72 79 20 28 64 65 66 61 75 6c 74 69 6e 67 20  ory (defaulting 
0c30: 74 6f 20 31 30 30 20 70 61 67 65 73 20 77 6f 72  to 100 pages wor
0c40: 74 68 29 0a 2a 2a 20 74 68 61 74 20 69 73 20 61  th).** that is a
0c50: 6c 6c 6f 63 61 74 65 64 20 77 68 65 6e 20 74 68  llocated when th
0c60: 65 20 70 61 67 65 20 63 61 63 68 65 20 69 73 20  e page cache is 
0c70: 63 72 65 61 74 65 64 2e 20 20 54 68 65 20 73 69  created.  The si
0c80: 7a 65 20 6f 66 20 74 68 65 20 6c 6f 63 61 6c 0a  ze of the local.
0c90: 2a 2a 20 62 75 6c 6b 20 61 6c 6c 6f 63 61 74 69  ** bulk allocati
0ca0: 6f 6e 20 63 61 6e 20 62 65 20 61 64 6a 75 73 74  on can be adjust
0cb0: 65 64 20 75 73 69 6e 67 20 0a 2a 2a 0a 2a 2a 20  ed using .**.** 
0cc0: 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66      sqlite3_conf
0cd0: 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47  ig(SQLITE_CONFIG
0ce0: 5f 50 41 47 45 43 41 43 48 45 2c 20 28 76 6f 69  _PAGECACHE, (voi
0cf0: 64 2a 29 30 2c 20 30 2c 20 4e 29 2e 0a 2a 2a 0a  d*)0, 0, N)..**.
0d00: 2a 2a 20 49 66 20 4e 20 69 73 20 70 6f 73 69 74  ** If N is posit
0d10: 69 76 65 2c 20 74 68 65 6e 20 4e 20 70 61 67 65  ive, then N page
0d20: 73 20 77 6f 72 74 68 20 6f 66 20 6d 65 6d 6f 72  s worth of memor
0d30: 79 20 61 72 65 20 61 6c 6c 6f 63 61 74 65 64 20  y are allocated 
0d40: 75 73 69 6e 67 20 61 20 73 69 6e 67 6c 65 0a 2a  using a single.*
0d50: 2a 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28  * sqlite3Malloc(
0d60: 29 20 63 61 6c 6c 20 61 6e 64 20 74 68 61 74 20  ) call and that 
0d70: 6d 65 6d 6f 72 79 20 69 73 20 75 73 65 64 20 66  memory is used f
0d80: 6f 72 20 74 68 65 20 66 69 72 73 74 20 4e 20 70  or the first N p
0d90: 61 67 65 73 20 61 6c 6c 6f 63 61 74 65 64 2e 0a  ages allocated..
0da0: 2a 2a 20 4f 72 20 69 66 20 4e 20 69 73 20 6e 65  ** Or if N is ne
0db0: 67 61 74 69 76 65 2c 20 74 68 65 6e 20 2d 31 30  gative, then -10
0dc0: 32 34 2a 4e 20 62 79 74 65 73 20 6f 66 20 6d 65  24*N bytes of me
0dd0: 6d 6f 72 79 20 61 72 65 20 61 6c 6c 6f 63 61 74  mory are allocat
0de0: 65 64 20 61 6e 64 20 75 73 65 64 0a 2a 2a 20 66  ed and used.** f
0df0: 6f 72 20 61 73 20 6d 61 6e 79 20 70 61 67 65 73  or as many pages
0e00: 20 61 73 20 63 61 6e 20 62 65 20 61 63 63 6f 6d   as can be accom
0e10: 6f 64 61 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 4f 6e  odated..**.** On
0e20: 6c 79 20 6f 6e 65 20 6f 66 20 28 32 29 20 6f 72  ly one of (2) or
0e30: 20 28 33 29 20 63 61 6e 20 62 65 20 75 73 65 64   (3) can be used
0e40: 2e 20 20 4f 6e 63 65 20 74 68 65 20 6d 65 6d 6f  .  Once the memo
0e50: 72 79 20 61 76 61 69 6c 61 62 6c 65 20 74 6f 20  ry available to 
0e60: 28 32 29 20 6f 72 0a 2a 2a 20 28 33 29 20 69 73  (2) or.** (3) is
0e70: 20 65 78 68 61 75 73 74 65 64 2c 20 73 75 62 73   exhausted, subs
0e80: 65 71 75 65 6e 74 20 61 6c 6c 6f 63 61 74 69 6f  equent allocatio
0e90: 6e 73 20 66 61 69 6c 20 6f 76 65 72 20 74 6f 20  ns fail over to 
0ea0: 74 68 65 20 67 65 6e 65 72 61 6c 2d 70 75 72 70  the general-purp
0eb0: 6f 73 65 0a 2a 2a 20 6d 65 6d 6f 72 79 20 61 6c  ose.** memory al
0ec0: 6c 6f 63 61 74 6f 72 20 28 31 29 2e 0a 2a 2a 0a  locator (1)..**.
0ed0: 2a 2a 20 45 61 72 6c 69 65 72 20 76 65 72 73 69  ** Earlier versi
0ee0: 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 75 73  ons of SQLite us
0ef0: 65 64 20 6f 6e 6c 79 20 6d 65 74 68 6f 64 73 20  ed only methods 
0f00: 28 31 29 20 61 6e 64 20 28 32 29 2e 20 20 42 75  (1) and (2).  Bu
0f10: 74 20 65 78 70 65 72 69 6d 65 6e 74 73 0a 2a 2a  t experiments.**
0f20: 20 73 68 6f 77 20 74 68 61 74 20 6d 65 74 68 6f   show that metho
0f30: 64 20 28 33 29 20 77 69 74 68 20 4e 3d 3d 31 30  d (3) with N==10
0f40: 30 20 70 72 6f 76 69 64 65 73 20 61 62 6f 75 74  0 provides about
0f50: 20 61 20 35 25 20 70 65 72 66 6f 72 6d 61 6e 63   a 5% performanc
0f60: 65 20 62 6f 6f 73 74 20 66 6f 72 0a 2a 2a 20 63  e boost for.** c
0f70: 6f 6d 6d 6f 6e 20 77 6f 72 6b 6c 6f 61 64 73 2e  ommon workloads.
0f80: 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71  .*/.#include "sq
0f90: 6c 69 74 65 49 6e 74 2e 68 22 0a 0a 74 79 70 65  liteInt.h"..type
0fa0: 64 65 66 20 73 74 72 75 63 74 20 50 43 61 63 68  def struct PCach
0fb0: 65 31 20 50 43 61 63 68 65 31 3b 0a 74 79 70 65  e1 PCache1;.type
0fc0: 64 65 66 20 73 74 72 75 63 74 20 50 67 48 64 72  def struct PgHdr
0fd0: 31 20 50 67 48 64 72 31 3b 0a 74 79 70 65 64 65  1 PgHdr1;.typede
0fe0: 66 20 73 74 72 75 63 74 20 50 67 46 72 65 65 73  f struct PgFrees
0ff0: 6c 6f 74 20 50 67 46 72 65 65 73 6c 6f 74 3b 0a  lot PgFreeslot;.
1000: 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 50  typedef struct P
1010: 47 72 6f 75 70 20 50 47 72 6f 75 70 3b 0a 0a 2f  Group PGroup;../
1020: 2a 0a 2a 2a 20 45 61 63 68 20 63 61 63 68 65 20  *.** Each cache 
1030: 65 6e 74 72 79 20 69 73 20 72 65 70 72 65 73 65  entry is represe
1040: 6e 74 65 64 20 62 79 20 61 6e 20 69 6e 73 74 61  nted by an insta
1050: 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f  nce of the follo
1060: 77 69 6e 67 20 0a 2a 2a 20 73 74 72 75 63 74 75  wing .** structu
1070: 72 65 2e 20 55 6e 6c 65 73 73 20 53 51 4c 49 54  re. Unless SQLIT
1080: 45 5f 50 43 41 43 48 45 5f 53 45 50 41 52 41 54  E_PCACHE_SEPARAT
1090: 45 5f 48 45 41 44 45 52 20 69 73 20 64 65 66 69  E_HEADER is defi
10a0: 6e 65 64 2c 20 61 20 62 75 66 66 65 72 20 6f 66  ned, a buffer of
10b0: 0a 2a 2a 20 50 67 48 64 72 31 2e 70 43 61 63 68  .** PgHdr1.pCach
10c0: 65 2d 3e 73 7a 50 61 67 65 20 62 79 74 65 73 20  e->szPage bytes 
10d0: 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 64 69 72  is allocated dir
10e0: 65 63 74 6c 79 20 62 65 66 6f 72 65 20 74 68 69  ectly before thi
10f0: 73 20 73 74 72 75 63 74 75 72 65 20 0a 2a 2a 20  s structure .** 
1100: 69 6e 20 6d 65 6d 6f 72 79 2e 0a 2a 2a 0a 2a 2a  in memory..**.**
1110: 20 4e 6f 74 65 3a 20 56 61 72 69 61 62 6c 65 73   Note: Variables
1120: 20 69 73 42 75 6c 6b 4c 6f 63 61 6c 20 61 6e 64   isBulkLocal and
1130: 20 69 73 41 6e 63 68 6f 72 20 77 65 72 65 20 6f   isAnchor were o
1140: 6e 63 65 20 74 79 70 65 20 22 75 38 22 2e 20 54  nce type "u8". T
1150: 68 61 74 20 77 6f 72 6b 73 2c 0a 2a 2a 20 62 75  hat works,.** bu
1160: 74 20 63 61 75 73 65 73 20 61 20 32 2d 62 79 74  t causes a 2-byt
1170: 65 20 67 61 70 20 69 6e 20 74 68 65 20 73 74 72  e gap in the str
1180: 75 63 74 75 72 65 20 66 6f 72 20 6d 6f 73 74 20  ucture for most 
1190: 61 72 63 68 69 74 65 63 74 75 72 65 73 20 28 73  architectures (s
11a0: 69 6e 63 65 20 0a 2a 2a 20 70 6f 69 6e 74 65 72  ince .** pointer
11b0: 73 20 6d 75 73 74 20 62 65 20 65 69 74 68 65 72  s must be either
11c0: 20 34 20 6f 72 20 38 2d 62 79 74 65 20 61 6c 69   4 or 8-byte ali
11d0: 67 6e 65 64 29 2e 20 41 73 20 74 68 69 73 20 73  gned). As this s
11e0: 74 72 75 63 74 75 72 65 20 69 73 20 6c 6f 63 61  tructure is loca
11f0: 74 65 64 0a 2a 2a 20 69 6e 20 6d 65 6d 6f 72 79  ted.** in memory
1200: 20 64 69 72 65 63 74 6c 79 20 61 66 74 65 72 20   directly after 
1210: 74 68 65 20 61 73 73 6f 63 69 61 74 65 64 20 70  the associated p
1220: 61 67 65 20 64 61 74 61 2c 20 69 66 20 74 68 65  age data, if the
1230: 20 64 61 74 61 62 61 73 65 20 69 73 0a 2a 2a 20   database is.** 
1240: 63 6f 72 72 75 70 74 2c 20 63 6f 64 65 20 61 74  corrupt, code at
1250: 20 74 68 65 20 62 2d 74 72 65 65 20 6c 61 79 65   the b-tree laye
1260: 72 20 6d 61 79 20 6f 76 65 72 72 65 61 64 20 74  r may overread t
1270: 68 65 20 70 61 67 65 20 62 75 66 66 65 72 20 61  he page buffer a
1280: 6e 64 20 0a 2a 2a 20 72 65 61 64 20 70 61 72 74  nd .** read part
1290: 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 74 75   of this structu
12a0: 72 65 20 62 65 66 6f 72 65 20 74 68 65 20 63 6f  re before the co
12b0: 72 72 75 70 74 69 6f 6e 20 69 73 20 64 65 74 65  rruption is dete
12c0: 63 74 65 64 2e 20 54 68 69 73 0a 2a 2a 20 63 61  cted. This.** ca
12d0: 6e 20 63 61 75 73 65 20 61 20 76 61 6c 67 72 69  n cause a valgri
12e0: 6e 64 20 65 72 72 6f 72 20 69 66 20 74 68 65 20  nd error if the 
12f0: 75 6e 69 74 69 61 6c 69 7a 65 64 20 67 61 70 20  unitialized gap 
1300: 69 73 20 61 63 63 65 73 73 65 64 2e 20 55 73 69  is accessed. Usi
1310: 6e 67 20 75 31 36 0a 2a 2a 20 65 6e 73 75 72 65  ng u16.** ensure
1320: 73 20 74 68 65 72 65 20 69 73 20 6e 6f 20 73 75  s there is no su
1330: 63 68 20 67 61 70 2c 20 61 6e 64 20 74 68 65 72  ch gap, and ther
1340: 65 66 6f 72 65 20 6e 6f 20 62 79 74 65 73 20 6f  efore no bytes o
1350: 66 20 75 6e 69 74 69 61 6c 69 7a 65 64 20 6d 65  f unitialized me
1360: 6d 6f 72 79 0a 2a 2a 20 69 6e 20 74 68 65 20 73  mory.** in the s
1370: 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 73 74 72  tructure..*/.str
1380: 75 63 74 20 50 67 48 64 72 31 20 7b 0a 20 20 73  uct PgHdr1 {.  s
1390: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 70 61  qlite3_pcache_pa
13a0: 67 65 20 70 61 67 65 3b 20 20 20 20 20 20 2f 2a  ge page;      /*
13b0: 20 42 61 73 65 20 63 6c 61 73 73 2e 20 4d 75 73   Base class. Mus
13c0: 74 20 62 65 20 66 69 72 73 74 2e 20 70 42 75 66  t be first. pBuf
13d0: 20 26 20 70 45 78 74 72 61 20 2a 2f 0a 20 20 75   & pExtra */.  u
13e0: 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4b 65 79  nsigned int iKey
13f0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ;             /*
1400: 20 4b 65 79 20 76 61 6c 75 65 20 28 70 61 67 65   Key value (page
1410: 20 6e 75 6d 62 65 72 29 20 2a 2f 0a 20 20 75 31   number) */.  u1
1420: 36 20 69 73 42 75 6c 6b 4c 6f 63 61 6c 3b 20 20  6 isBulkLocal;  
1430: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1440: 54 68 69 73 20 70 61 67 65 20 66 72 6f 6d 20 62  This page from b
1450: 75 6c 6b 20 6c 6f 63 61 6c 20 73 74 6f 72 61 67  ulk local storag
1460: 65 20 2a 2f 0a 20 20 75 31 36 20 69 73 41 6e 63  e */.  u16 isAnc
1470: 68 6f 72 3b 20 20 20 20 20 20 20 20 20 20 20 20  hor;            
1480: 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 69 73        /* This is
1490: 20 74 68 65 20 50 47 72 6f 75 70 2e 6c 72 75 20   the PGroup.lru 
14a0: 65 6c 65 6d 65 6e 74 20 2a 2f 0a 20 20 50 67 48  element */.  PgH
14b0: 64 72 31 20 2a 70 4e 65 78 74 3b 20 20 20 20 20  dr1 *pNext;     
14c0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e              /* N
14d0: 65 78 74 20 69 6e 20 68 61 73 68 20 74 61 62 6c  ext in hash tabl
14e0: 65 20 63 68 61 69 6e 20 2a 2f 0a 20 20 50 43 61  e chain */.  PCa
14f0: 63 68 65 31 20 2a 70 43 61 63 68 65 3b 20 20 20  che1 *pCache;   
1500: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43              /* C
1510: 61 63 68 65 20 74 68 61 74 20 63 75 72 72 65 6e  ache that curren
1520: 74 6c 79 20 6f 77 6e 73 20 74 68 69 73 20 70 61  tly owns this pa
1530: 67 65 20 2a 2f 0a 20 20 50 67 48 64 72 31 20 2a  ge */.  PgHdr1 *
1540: 70 4c 72 75 4e 65 78 74 3b 20 20 20 20 20 20 20  pLruNext;       
1550: 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 69         /* Next i
1560: 6e 20 4c 52 55 20 6c 69 73 74 20 6f 66 20 75 6e  n LRU list of un
1570: 70 69 6e 6e 65 64 20 70 61 67 65 73 20 2a 2f 0a  pinned pages */.
1580: 20 20 50 67 48 64 72 31 20 2a 70 4c 72 75 50 72    PgHdr1 *pLruPr
1590: 65 76 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  ev;             
15a0: 20 2f 2a 20 50 72 65 76 69 6f 75 73 20 69 6e 20   /* Previous in 
15b0: 4c 52 55 20 6c 69 73 74 20 6f 66 20 75 6e 70 69  LRU list of unpi
15c0: 6e 6e 65 64 20 70 61 67 65 73 20 2a 2f 0a 20 20  nned pages */.  
15d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
15e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
15f0: 2a 20 4e 42 3a 20 70 4c 72 75 50 72 65 76 20 69  * NB: pLruPrev i
1600: 73 20 6f 6e 6c 79 20 76 61 6c 69 64 20 69 66 20  s only valid if 
1610: 70 4c 72 75 4e 65 78 74 21 3d 30 20 2a 2f 0a 7d  pLruNext!=0 */.}
1620: 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 70 61 67 65 20  ;../*.** A page 
1630: 69 73 20 70 69 6e 6e 65 64 20 69 66 20 69 74 20  is pinned if it 
1640: 69 73 20 6e 6f 74 20 6f 6e 20 74 68 65 20 4c 52  is not on the LR
1650: 55 20 6c 69 73 74 2e 20 20 54 6f 20 62 65 20 22  U list.  To be "
1660: 70 69 6e 6e 65 64 22 20 6d 65 61 6e 73 0a 2a 2a  pinned" means.**
1670: 20 74 68 61 74 20 74 68 65 20 70 61 67 65 20 69   that the page i
1680: 73 20 69 6e 20 61 63 74 69 76 65 20 75 73 65 20  s in active use 
1690: 61 6e 64 20 6d 75 73 74 20 6e 6f 74 20 62 65 20  and must not be 
16a0: 64 65 61 6c 6c 6f 63 61 74 65 64 2e 0a 2a 2f 0a  deallocated..*/.
16b0: 23 64 65 66 69 6e 65 20 50 41 47 45 5f 49 53 5f  #define PAGE_IS_
16c0: 50 49 4e 4e 45 44 28 70 29 20 20 20 20 28 28 70  PINNED(p)    ((p
16d0: 29 2d 3e 70 4c 72 75 4e 65 78 74 3d 3d 30 29 0a  )->pLruNext==0).
16e0: 23 64 65 66 69 6e 65 20 50 41 47 45 5f 49 53 5f  #define PAGE_IS_
16f0: 55 4e 50 49 4e 4e 45 44 28 70 29 20 20 28 28 70  UNPINNED(p)  ((p
1700: 29 2d 3e 70 4c 72 75 4e 65 78 74 21 3d 30 29 0a  )->pLruNext!=0).
1710: 0a 2f 2a 20 45 61 63 68 20 70 61 67 65 20 63 61  ./* Each page ca
1720: 63 68 65 20 28 6f 72 20 50 43 61 63 68 65 29 20  che (or PCache) 
1730: 62 65 6c 6f 6e 67 73 20 74 6f 20 61 20 50 47 72  belongs to a PGr
1740: 6f 75 70 2e 20 20 41 20 50 47 72 6f 75 70 20 69  oup.  A PGroup i
1750: 73 20 61 20 73 65 74 20 0a 2a 2a 20 6f 66 20 6f  s a set .** of o
1760: 6e 65 20 6f 72 20 6d 6f 72 65 20 50 43 61 63 68  ne or more PCach
1770: 65 73 20 74 68 61 74 20 61 72 65 20 61 62 6c 65  es that are able
1780: 20 74 6f 20 72 65 63 79 63 6c 65 20 65 61 63 68   to recycle each
1790: 20 6f 74 68 65 72 27 73 20 75 6e 70 69 6e 6e 65   other's unpinne
17a0: 64 0a 2a 2a 20 70 61 67 65 73 20 77 68 65 6e 20  d.** pages when 
17b0: 74 68 65 79 20 61 72 65 20 75 6e 64 65 72 20 6d  they are under m
17c0: 65 6d 6f 72 79 20 70 72 65 73 73 75 72 65 2e 20  emory pressure. 
17d0: 20 41 20 50 47 72 6f 75 70 20 69 73 20 61 6e 20   A PGroup is an 
17e0: 69 6e 73 74 61 6e 63 65 20 6f 66 0a 2a 2a 20 74  instance of.** t
17f0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 62 6a  he following obj
1800: 65 63 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20  ect..**.** This 
1810: 70 61 67 65 20 63 61 63 68 65 20 69 6d 70 6c 65  page cache imple
1820: 6d 65 6e 74 61 74 69 6f 6e 20 77 6f 72 6b 73 20  mentation works 
1830: 69 6e 20 6f 6e 65 20 6f 66 20 74 77 6f 20 6d 6f  in one of two mo
1840: 64 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 28 31 29  des:.**.**   (1)
1850: 20 20 45 76 65 72 79 20 50 43 61 63 68 65 20 69    Every PCache i
1860: 73 20 74 68 65 20 73 6f 6c 65 20 6d 65 6d 62 65  s the sole membe
1870: 72 20 6f 66 20 69 74 73 20 6f 77 6e 20 50 47 72  r of its own PGr
1880: 6f 75 70 2e 20 20 54 68 65 72 65 20 69 73 0a 2a  oup.  There is.*
1890: 2a 20 20 20 20 20 20 20 20 6f 6e 65 20 50 47 72  *        one PGr
18a0: 6f 75 70 20 70 65 72 20 50 43 61 63 68 65 2e 0a  oup per PCache..
18b0: 2a 2a 0a 2a 2a 20 20 20 28 32 29 20 20 54 68 65  **.**   (2)  The
18c0: 72 65 20 69 73 20 61 20 73 69 6e 67 6c 65 20 67  re is a single g
18d0: 6c 6f 62 61 6c 20 50 47 72 6f 75 70 20 74 68 61  lobal PGroup tha
18e0: 74 20 61 6c 6c 20 50 43 61 63 68 65 73 20 61 72  t all PCaches ar
18f0: 65 20 61 20 6d 65 6d 62 65 72 0a 2a 2a 20 20 20  e a member.**   
1900: 20 20 20 20 20 6f 66 2e 0a 2a 2a 0a 2a 2a 20 4d       of..**.** M
1910: 6f 64 65 20 31 20 75 73 65 73 20 6d 6f 72 65 20  ode 1 uses more 
1920: 6d 65 6d 6f 72 79 20 28 73 69 6e 63 65 20 50 43  memory (since PC
1930: 61 63 68 65 20 69 6e 73 74 61 6e 63 65 73 20 61  ache instances a
1940: 72 65 20 6e 6f 74 20 61 62 6c 65 20 74 6f 20 72  re not able to r
1950: 6f 62 0a 2a 2a 20 75 6e 75 73 65 64 20 70 61 67  ob.** unused pag
1960: 65 73 20 66 72 6f 6d 20 6f 74 68 65 72 20 50 43  es from other PC
1970: 61 63 68 65 73 29 20 62 75 74 20 69 74 20 61 6c  aches) but it al
1980: 73 6f 20 6f 70 65 72 61 74 65 73 20 77 69 74 68  so operates with
1990: 6f 75 74 20 61 20 6d 75 74 65 78 2c 0a 2a 2a 20  out a mutex,.** 
19a0: 61 6e 64 20 69 73 20 74 68 65 72 65 66 6f 72 65  and is therefore
19b0: 20 6f 66 74 65 6e 20 66 61 73 74 65 72 2e 20 20   often faster.  
19c0: 4d 6f 64 65 20 32 20 72 65 71 75 69 72 65 73 20  Mode 2 requires 
19d0: 61 20 6d 75 74 65 78 20 69 6e 20 6f 72 64 65 72  a mutex in order
19e0: 20 74 6f 20 62 65 0a 2a 2a 20 74 68 72 65 61 64   to be.** thread
19f0: 73 61 66 65 2c 20 62 75 74 20 72 65 63 79 63 6c  safe, but recycl
1a00: 65 73 20 70 61 67 65 73 20 6d 6f 72 65 20 65 66  es pages more ef
1a10: 66 69 63 69 65 6e 74 6c 79 2e 0a 2a 2a 0a 2a 2a  ficiently..**.**
1a20: 20 46 6f 72 20 6d 6f 64 65 20 28 31 29 2c 20 50   For mode (1), P
1a30: 47 72 6f 75 70 2e 6d 75 74 65 78 20 69 73 20 4e  Group.mutex is N
1a40: 55 4c 4c 2e 20 20 46 6f 72 20 6d 6f 64 65 20 28  ULL.  For mode (
1a50: 32 29 20 74 68 65 72 65 20 69 73 20 6f 6e 6c 79  2) there is only
1a60: 20 61 20 73 69 6e 67 6c 65 0a 2a 2a 20 50 47 72   a single.** PGr
1a70: 6f 75 70 20 77 68 69 63 68 20 69 73 20 74 68 65  oup which is the
1a80: 20 70 63 61 63 68 65 31 2e 67 72 70 20 67 6c 6f   pcache1.grp glo
1a90: 62 61 6c 20 76 61 72 69 61 62 6c 65 20 61 6e 64  bal variable and
1aa0: 20 69 74 73 20 6d 75 74 65 78 20 69 73 0a 2a 2a   its mutex is.**
1ab0: 20 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54   SQLITE_MUTEX_ST
1ac0: 41 54 49 43 5f 4c 52 55 2e 0a 2a 2f 0a 73 74 72  ATIC_LRU..*/.str
1ad0: 75 63 74 20 50 47 72 6f 75 70 20 7b 0a 20 20 73  uct PGroup {.  s
1ae0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75  qlite3_mutex *mu
1af0: 74 65 78 3b 20 20 20 20 20 20 20 20 20 20 2f 2a  tex;          /*
1b00: 20 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c 52   MUTEX_STATIC_LR
1b10: 55 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20 75  U or NULL */.  u
1b20: 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 4d 61 78  nsigned int nMax
1b30: 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 2f 2a  Page;         /*
1b40: 20 53 75 6d 20 6f 66 20 6e 4d 61 78 20 66 6f 72   Sum of nMax for
1b50: 20 70 75 72 67 65 61 62 6c 65 20 63 61 63 68 65   purgeable cache
1b60: 73 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20  s */.  unsigned 
1b70: 69 6e 74 20 6e 4d 69 6e 50 61 67 65 3b 20 20 20  int nMinPage;   
1b80: 20 20 20 20 20 20 2f 2a 20 53 75 6d 20 6f 66 20        /* Sum of 
1b90: 6e 4d 69 6e 20 66 6f 72 20 70 75 72 67 65 61 62  nMin for purgeab
1ba0: 6c 65 20 63 61 63 68 65 73 20 2a 2f 0a 20 20 75  le caches */.  u
1bb0: 6e 73 69 67 6e 65 64 20 69 6e 74 20 6d 78 50 69  nsigned int mxPi
1bc0: 6e 6e 65 64 3b 20 20 20 20 20 20 20 20 20 2f 2a  nned;         /*
1bd0: 20 6e 4d 61 78 70 61 67 65 20 2b 20 31 30 20 2d   nMaxpage + 10 -
1be0: 20 6e 4d 69 6e 50 61 67 65 20 2a 2f 0a 20 20 75   nMinPage */.  u
1bf0: 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 50 75 72  nsigned int nPur
1c00: 67 65 61 62 6c 65 3b 20 20 20 20 20 20 20 2f 2a  geable;       /*
1c10: 20 4e 75 6d 62 65 72 20 6f 66 20 70 75 72 67 65   Number of purge
1c20: 61 62 6c 65 20 70 61 67 65 73 20 61 6c 6c 6f 63  able pages alloc
1c30: 61 74 65 64 20 2a 2f 0a 20 20 50 67 48 64 72 31  ated */.  PgHdr1
1c40: 20 6c 72 75 3b 20 20 20 20 20 20 20 20 20 20 20   lru;           
1c50: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20           /* The 
1c60: 62 65 67 69 6e 6e 69 6e 67 20 61 6e 64 20 65 6e  beginning and en
1c70: 64 20 6f 66 20 74 68 65 20 4c 52 55 20 6c 69 73  d of the LRU lis
1c80: 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 45 61 63 68  t */.};../* Each
1c90: 20 70 61 67 65 20 63 61 63 68 65 20 69 73 20 61   page cache is a
1ca0: 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68  n instance of th
1cb0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 62 6a 65  e following obje
1cc0: 63 74 2e 20 20 45 76 65 72 79 0a 2a 2a 20 6f 70  ct.  Every.** op
1cd0: 65 6e 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  en database file
1ce0: 20 28 69 6e 63 6c 75 64 69 6e 67 20 65 61 63 68   (including each
1cf0: 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62   in-memory datab
1d00: 61 73 65 20 61 6e 64 20 65 61 63 68 0a 2a 2a 20  ase and each.** 
1d10: 74 65 6d 70 6f 72 61 72 79 20 6f 72 20 74 72 61  temporary or tra
1d20: 6e 73 69 65 6e 74 20 64 61 74 61 62 61 73 65 29  nsient database)
1d30: 20 68 61 73 20 61 20 73 69 6e 67 6c 65 20 70 61   has a single pa
1d40: 67 65 20 63 61 63 68 65 20 77 68 69 63 68 0a 2a  ge cache which.*
1d50: 2a 20 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 65  * is an instance
1d60: 20 6f 66 20 74 68 69 73 20 6f 62 6a 65 63 74 2e   of this object.
1d70: 0a 2a 2a 0a 2a 2a 20 50 6f 69 6e 74 65 72 73 20  .**.** Pointers 
1d80: 74 6f 20 73 74 72 75 63 74 75 72 65 73 20 6f 66  to structures of
1d90: 20 74 68 69 73 20 74 79 70 65 20 61 72 65 20 63   this type are c
1da0: 61 73 74 20 61 6e 64 20 72 65 74 75 72 6e 65 64  ast and returned
1db0: 20 61 73 20 0a 2a 2a 20 6f 70 61 71 75 65 20 73   as .** opaque s
1dc0: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2a 20 68  qlite3_pcache* h
1dd0: 61 6e 64 6c 65 73 2e 0a 2a 2f 0a 73 74 72 75 63  andles..*/.struc
1de0: 74 20 50 43 61 63 68 65 31 20 7b 0a 20 20 2f 2a  t PCache1 {.  /*
1df0: 20 43 61 63 68 65 20 63 6f 6e 66 69 67 75 72 61   Cache configura
1e00: 74 69 6f 6e 20 70 61 72 61 6d 65 74 65 72 73 2e  tion parameters.
1e10: 20 50 61 67 65 20 73 69 7a 65 20 28 73 7a 50 61   Page size (szPa
1e20: 67 65 29 20 61 6e 64 20 74 68 65 20 70 75 72 67  ge) and the purg
1e30: 65 61 62 6c 65 0a 20 20 2a 2a 20 66 6c 61 67 20  eable.  ** flag 
1e40: 28 62 50 75 72 67 65 61 62 6c 65 29 20 61 6e 64  (bPurgeable) and
1e50: 20 74 68 65 20 70 6e 50 75 72 67 65 61 62 6c 65   the pnPurgeable
1e60: 20 70 6f 69 6e 74 65 72 20 61 72 65 20 61 6c 6c   pointer are all
1e70: 20 73 65 74 20 77 68 65 6e 20 74 68 65 0a 20 20   set when the.  
1e80: 2a 2a 20 63 61 63 68 65 20 69 73 20 63 72 65 61  ** cache is crea
1e90: 74 65 64 20 61 6e 64 20 61 72 65 20 6e 65 76 65  ted and are neve
1ea0: 72 20 63 68 61 6e 67 65 64 20 74 68 65 72 65 61  r changed therea
1eb0: 66 74 65 72 2e 20 6e 4d 61 78 20 6d 61 79 20 62  fter. nMax may b
1ec0: 65 20 0a 20 20 2a 2a 20 6d 6f 64 69 66 69 65 64  e .  ** modified
1ed0: 20 61 74 20 61 6e 79 20 74 69 6d 65 20 62 79 20   at any time by 
1ee0: 61 20 63 61 6c 6c 20 74 6f 20 74 68 65 20 70 63  a call to the pc
1ef0: 61 63 68 65 31 43 61 63 68 65 73 69 7a 65 28 29  ache1Cachesize()
1f00: 20 6d 65 74 68 6f 64 2e 0a 20 20 2a 2a 20 54 68   method..  ** Th
1f10: 65 20 50 47 72 6f 75 70 20 6d 75 74 65 78 20 6d  e PGroup mutex m
1f20: 75 73 74 20 62 65 20 68 65 6c 64 20 77 68 65 6e  ust be held when
1f30: 20 61 63 63 65 73 73 69 6e 67 20 6e 4d 61 78 2e   accessing nMax.
1f40: 0a 20 20 2a 2f 0a 20 20 50 47 72 6f 75 70 20 2a  .  */.  PGroup *
1f50: 70 47 72 6f 75 70 3b 20 20 20 20 20 20 20 20 20  pGroup;         
1f60: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50              /* P
1f70: 47 72 6f 75 70 20 74 68 69 73 20 63 61 63 68 65  Group this cache
1f80: 20 62 65 6c 6f 6e 67 73 20 74 6f 20 2a 2f 0a 20   belongs to */. 
1f90: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 2a 70   unsigned int *p
1fa0: 6e 50 75 72 67 65 61 62 6c 65 3b 20 20 20 20 20  nPurgeable;     
1fb0: 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20       /* Pointer 
1fc0: 74 6f 20 70 47 72 6f 75 70 2d 3e 6e 50 75 72 67  to pGroup->nPurg
1fd0: 65 61 62 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 73  eable */.  int s
1fe0: 7a 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 20  zPage;          
1ff0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
2000: 2a 20 53 69 7a 65 20 6f 66 20 64 61 74 61 62 61  * Size of databa
2010: 73 65 20 63 6f 6e 74 65 6e 74 20 73 65 63 74 69  se content secti
2020: 6f 6e 20 2a 2f 0a 20 20 69 6e 74 20 73 7a 45 78  on */.  int szEx
2030: 74 72 61 3b 20 20 20 20 20 20 20 20 20 20 20 20  tra;            
2040: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 73              /* s
2050: 69 7a 65 6f 66 28 4d 65 6d 50 61 67 65 29 2b 73  izeof(MemPage)+s
2060: 69 7a 65 6f 66 28 50 67 48 64 72 29 20 2a 2f 0a  izeof(PgHdr) */.
2070: 20 20 69 6e 74 20 73 7a 41 6c 6c 6f 63 3b 20 20    int szAlloc;  
2080: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2090: 20 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 73        /* Total s
20a0: 69 7a 65 20 6f 66 20 6f 6e 65 20 70 63 61 63 68  ize of one pcach
20b0: 65 20 6c 69 6e 65 20 2a 2f 0a 20 20 69 6e 74 20  e line */.  int 
20c0: 62 50 75 72 67 65 61 62 6c 65 3b 20 20 20 20 20  bPurgeable;     
20d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
20e0: 2f 2a 20 54 72 75 65 20 69 66 20 63 61 63 68 65  /* True if cache
20f0: 20 69 73 20 70 75 72 67 65 61 62 6c 65 20 2a 2f   is purgeable */
2100: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
2110: 6e 4d 69 6e 3b 20 20 20 20 20 20 20 20 20 20 20  nMin;           
2120: 20 20 20 20 20 20 20 2f 2a 20 4d 69 6e 69 6d 75         /* Minimu
2130: 6d 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65  m number of page
2140: 73 20 72 65 73 65 72 76 65 64 20 2a 2f 0a 20 20  s reserved */.  
2150: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 4d 61  unsigned int nMa
2160: 78 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  x;              
2170: 20 20 20 20 2f 2a 20 43 6f 6e 66 69 67 75 72 65      /* Configure
2180: 64 20 22 63 61 63 68 65 5f 73 69 7a 65 22 20 76  d "cache_size" v
2190: 61 6c 75 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e  alue */.  unsign
21a0: 65 64 20 69 6e 74 20 6e 39 30 70 63 74 3b 20 20  ed int n90pct;  
21b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
21c0: 20 6e 4d 61 78 2a 39 2f 31 30 20 2a 2f 0a 20 20   nMax*9/10 */.  
21d0: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4d 61  unsigned int iMa
21e0: 78 4b 65 79 3b 20 20 20 20 20 20 20 20 20 20 20  xKey;           
21f0: 20 20 20 20 2f 2a 20 4c 61 72 67 65 73 74 20 6b      /* Largest k
2200: 65 79 20 73 65 65 6e 20 73 69 6e 63 65 20 78 54  ey seen since xT
2210: 72 75 6e 63 61 74 65 28 29 20 2a 2f 0a 20 20 75  runcate() */.  u
2220: 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 50 75 72  nsigned int nPur
2230: 67 65 61 62 6c 65 44 75 6d 6d 79 3b 20 20 20 20  geableDummy;    
2240: 20 20 20 2f 2a 20 70 6e 50 75 72 67 65 61 62 6c     /* pnPurgeabl
2250: 65 20 70 6f 69 6e 74 73 20 68 65 72 65 20 77 68  e points here wh
2260: 65 6e 20 6e 6f 74 20 75 73 65 64 2a 2f 0a 0a 20  en not used*/.. 
2270: 20 2f 2a 20 48 61 73 68 20 74 61 62 6c 65 20 6f   /* Hash table o
2280: 66 20 61 6c 6c 20 70 61 67 65 73 2e 20 54 68 65  f all pages. The
2290: 20 66 6f 6c 6c 6f 77 69 6e 67 20 76 61 72 69 61   following varia
22a0: 62 6c 65 73 20 6d 61 79 20 6f 6e 6c 79 20 62 65  bles may only be
22b0: 20 61 63 63 65 73 73 65 64 0a 20 20 2a 2a 20 77   accessed.  ** w
22c0: 68 65 6e 20 74 68 65 20 61 63 63 65 73 73 6f 72  hen the accessor
22d0: 20 69 73 20 68 6f 6c 64 69 6e 67 20 74 68 65 20   is holding the 
22e0: 50 47 72 6f 75 70 20 6d 75 74 65 78 2e 0a 20 20  PGroup mutex..  
22f0: 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e  */.  unsigned in
2300: 74 20 6e 52 65 63 79 63 6c 61 62 6c 65 3b 20 20  t nRecyclable;  
2310: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62           /* Numb
2320: 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74  er of pages in t
2330: 68 65 20 4c 52 55 20 6c 69 73 74 20 2a 2f 0a 20  he LRU list */. 
2340: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 50   unsigned int nP
2350: 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 20  age;            
2360: 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 6e 75       /* Total nu
2370: 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e  mber of pages in
2380: 20 61 70 48 61 73 68 20 2a 2f 0a 20 20 75 6e 73   apHash */.  uns
2390: 69 67 6e 65 64 20 69 6e 74 20 6e 48 61 73 68 3b  igned int nHash;
23a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
23b0: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 73 6c   /* Number of sl
23c0: 6f 74 73 20 69 6e 20 61 70 48 61 73 68 5b 5d 20  ots in apHash[] 
23d0: 2a 2f 0a 20 20 50 67 48 64 72 31 20 2a 2a 61 70  */.  PgHdr1 **ap
23e0: 48 61 73 68 3b 20 20 20 20 20 20 20 20 20 20 20  Hash;           
23f0: 20 20 20 20 20 20 20 20 20 2f 2a 20 48 61 73 68           /* Hash
2400: 20 74 61 62 6c 65 20 66 6f 72 20 66 61 73 74 20   table for fast 
2410: 6c 6f 6f 6b 75 70 20 62 79 20 6b 65 79 20 2a 2f  lookup by key */
2420: 0a 20 20 50 67 48 64 72 31 20 2a 70 46 72 65 65  .  PgHdr1 *pFree
2430: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
2440: 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f         /* List o
2450: 66 20 75 6e 75 73 65 64 20 70 63 61 63 68 65 2d  f unused pcache-
2460: 6c 6f 63 61 6c 20 70 61 67 65 73 20 2a 2f 0a 20  local pages */. 
2470: 20 76 6f 69 64 20 2a 70 42 75 6c 6b 3b 20 20 20   void *pBulk;   
2480: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2490: 20 20 20 20 20 2f 2a 20 42 75 6c 6b 20 6d 65 6d       /* Bulk mem
24a0: 6f 72 79 20 75 73 65 64 20 62 79 20 70 63 61 63  ory used by pcac
24b0: 68 65 2d 6c 6f 63 61 6c 20 2a 2f 0a 7d 3b 0a 0a  he-local */.};..
24c0: 2f 2a 0a 2a 2a 20 46 72 65 65 20 73 6c 6f 74 73  /*.** Free slots
24d0: 20 69 6e 20 74 68 65 20 61 6c 6c 6f 63 61 74 6f   in the allocato
24e0: 72 20 75 73 65 64 20 74 6f 20 64 69 76 69 64 65  r used to divide
24f0: 20 75 70 20 74 68 65 20 67 6c 6f 62 61 6c 20 70   up the global p
2500: 61 67 65 20 63 61 63 68 65 0a 2a 2a 20 62 75 66  age cache.** buf
2510: 66 65 72 20 70 72 6f 76 69 64 65 64 20 75 73 69  fer provided usi
2520: 6e 67 20 74 68 65 20 53 51 4c 49 54 45 5f 43 4f  ng the SQLITE_CO
2530: 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45 20 6d  NFIG_PAGECACHE m
2540: 65 63 68 61 6e 69 73 6d 2e 0a 2a 2f 0a 73 74 72  echanism..*/.str
2550: 75 63 74 20 50 67 46 72 65 65 73 6c 6f 74 20 7b  uct PgFreeslot {
2560: 0a 20 20 50 67 46 72 65 65 73 6c 6f 74 20 2a 70  .  PgFreeslot *p
2570: 4e 65 78 74 3b 20 20 2f 2a 20 4e 65 78 74 20 66  Next;  /* Next f
2580: 72 65 65 20 73 6c 6f 74 20 2a 2f 0a 7d 3b 0a 0a  ree slot */.};..
2590: 2f 2a 0a 2a 2a 20 47 6c 6f 62 61 6c 20 64 61 74  /*.** Global dat
25a0: 61 20 75 73 65 64 20 62 79 20 74 68 69 73 20 63  a used by this c
25b0: 61 63 68 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  ache..*/.static 
25c0: 53 51 4c 49 54 45 5f 57 53 44 20 73 74 72 75 63  SQLITE_WSD struc
25d0: 74 20 50 43 61 63 68 65 47 6c 6f 62 61 6c 20 7b  t PCacheGlobal {
25e0: 0a 20 20 50 47 72 6f 75 70 20 67 72 70 3b 20 20  .  PGroup grp;  
25f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2600: 20 20 2f 2a 20 54 68 65 20 67 6c 6f 62 61 6c 20    /* The global 
2610: 50 47 72 6f 75 70 20 66 6f 72 20 6d 6f 64 65 20  PGroup for mode 
2620: 28 32 29 20 2a 2f 0a 0a 20 20 2f 2a 20 56 61 72  (2) */..  /* Var
2630: 69 61 62 6c 65 73 20 72 65 6c 61 74 65 64 20 74  iables related t
2640: 6f 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f  o SQLITE_CONFIG_
2650: 50 41 47 45 43 41 43 48 45 20 73 65 74 74 69 6e  PAGECACHE settin
2660: 67 73 2e 20 20 54 68 65 0a 20 20 2a 2a 20 73 7a  gs.  The.  ** sz
2670: 53 6c 6f 74 2c 20 6e 53 6c 6f 74 2c 20 70 53 74  Slot, nSlot, pSt
2680: 61 72 74 2c 20 70 45 6e 64 2c 20 6e 52 65 73 65  art, pEnd, nRese
2690: 72 76 65 2c 20 61 6e 64 20 69 73 49 6e 69 74 20  rve, and isInit 
26a0: 76 61 6c 75 65 73 20 61 72 65 20 61 6c 6c 0a 20  values are all. 
26b0: 20 2a 2a 20 66 69 78 65 64 20 61 74 20 73 71 6c   ** fixed at sql
26c0: 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28  ite3_initialize(
26d0: 29 20 74 69 6d 65 20 61 6e 64 20 64 6f 20 6e 6f  ) time and do no
26e0: 74 20 72 65 71 75 69 72 65 20 6d 75 74 65 78 20  t require mutex 
26f0: 70 72 6f 74 65 63 74 69 6f 6e 2e 0a 20 20 2a 2a  protection..  **
2700: 20 54 68 65 20 6e 46 72 65 65 53 6c 6f 74 20 61   The nFreeSlot a
2710: 6e 64 20 70 46 72 65 65 20 76 61 6c 75 65 73 20  nd pFree values 
2720: 64 6f 20 72 65 71 75 69 72 65 20 6d 75 74 65 78  do require mutex
2730: 20 70 72 6f 74 65 63 74 69 6f 6e 2e 0a 20 20 2a   protection..  *
2740: 2f 0a 20 20 69 6e 74 20 69 73 49 6e 69 74 3b 20  /.  int isInit; 
2750: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2760: 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 69 6e     /* True if in
2770: 69 74 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 20 69  itialized */.  i
2780: 6e 74 20 73 65 70 61 72 61 74 65 43 61 63 68 65  nt separateCache
2790: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ;             /*
27a0: 20 55 73 65 20 61 20 6e 65 77 20 50 47 72 6f 75   Use a new PGrou
27b0: 70 20 66 6f 72 20 65 61 63 68 20 50 43 61 63 68  p for each PCach
27c0: 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 49 6e 69 74  e */.  int nInit
27d0: 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 20  Page;           
27e0: 20 20 20 20 20 20 2f 2a 20 49 6e 69 74 69 61 6c        /* Initial
27f0: 20 62 75 6c 6b 20 61 6c 6c 6f 63 61 74 69 6f 6e   bulk allocation
2800: 20 73 69 7a 65 20 2a 2f 20 20 20 0a 20 20 69 6e   size */   .  in
2810: 74 20 73 7a 53 6c 6f 74 3b 20 20 20 20 20 20 20  t szSlot;       
2820: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
2830: 53 69 7a 65 20 6f 66 20 65 61 63 68 20 66 72 65  Size of each fre
2840: 65 20 73 6c 6f 74 20 2a 2f 0a 20 20 69 6e 74 20  e slot */.  int 
2850: 6e 53 6c 6f 74 3b 20 20 20 20 20 20 20 20 20 20  nSlot;          
2860: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68             /* Th
2870: 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 63 61 63  e number of pcac
2880: 68 65 20 73 6c 6f 74 73 20 2a 2f 0a 20 20 69 6e  he slots */.  in
2890: 74 20 6e 52 65 73 65 72 76 65 3b 20 20 20 20 20  t nReserve;     
28a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
28b0: 54 72 79 20 74 6f 20 6b 65 65 70 20 6e 46 72 65  Try to keep nFre
28c0: 65 53 6c 6f 74 20 61 62 6f 76 65 20 74 68 69 73  eSlot above this
28d0: 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 53 74 61   */.  void *pSta
28e0: 72 74 2c 20 2a 70 45 6e 64 3b 20 20 20 20 20 20  rt, *pEnd;      
28f0: 20 20 20 20 20 2f 2a 20 42 6f 75 6e 64 73 20 6f       /* Bounds o
2900: 66 20 67 6c 6f 62 61 6c 20 70 61 67 65 20 63 61  f global page ca
2910: 63 68 65 20 6d 65 6d 6f 72 79 20 2a 2f 0a 20 20  che memory */.  
2920: 2f 2a 20 41 62 6f 76 65 20 72 65 71 75 69 72 65  /* Above require
2930: 73 20 6e 6f 20 6d 75 74 65 78 2e 20 20 55 73 65  s no mutex.  Use
2940: 20 6d 75 74 65 78 20 62 65 6c 6f 77 20 66 6f 72   mutex below for
2950: 20 76 61 72 69 61 62 6c 65 20 74 68 61 74 20 66   variable that f
2960: 6f 6c 6c 6f 77 2e 20 2a 2f 0a 20 20 73 71 6c 69  ollow. */.  sqli
2970: 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78  te3_mutex *mutex
2980: 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 75  ;          /* Mu
2990: 74 65 78 20 66 6f 72 20 61 63 63 65 73 73 69 6e  tex for accessin
29a0: 67 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a  g the following:
29b0: 20 2a 2f 0a 20 20 50 67 46 72 65 65 73 6c 6f 74   */.  PgFreeslot
29c0: 20 2a 70 46 72 65 65 3b 20 20 20 20 20 20 20 20   *pFree;        
29d0: 20 20 20 20 20 2f 2a 20 46 72 65 65 20 70 61 67       /* Free pag
29e0: 65 20 62 6c 6f 63 6b 73 20 2a 2f 0a 20 20 69 6e  e blocks */.  in
29f0: 74 20 6e 46 72 65 65 53 6c 6f 74 3b 20 20 20 20  t nFreeSlot;    
2a00: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
2a10: 4e 75 6d 62 65 72 20 6f 66 20 75 6e 75 73 65 64  Number of unused
2a20: 20 70 63 61 63 68 65 20 73 6c 6f 74 73 20 2a 2f   pcache slots */
2a30: 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77  .  /* The follow
2a40: 69 6e 67 20 76 61 6c 75 65 20 72 65 71 75 69 72  ing value requir
2a50: 65 73 20 61 20 6d 75 74 65 78 20 74 6f 20 63 68  es a mutex to ch
2a60: 61 6e 67 65 2e 20 20 57 65 20 73 6b 69 70 20 74  ange.  We skip t
2a70: 68 65 20 6d 75 74 65 78 20 6f 6e 0a 20 20 2a 2a  he mutex on.  **
2a80: 20 72 65 61 64 69 6e 67 20 62 65 63 61 75 73 65   reading because
2a90: 20 28 31 29 20 6d 6f 73 74 20 70 6c 61 74 66 6f   (1) most platfo
2aa0: 72 6d 73 20 72 65 61 64 20 61 20 33 32 2d 62 69  rms read a 32-bi
2ab0: 74 20 69 6e 74 65 67 65 72 20 61 74 6f 6d 69 63  t integer atomic
2ac0: 61 6c 6c 79 20 61 6e 64 0a 20 20 2a 2a 20 28 32  ally and.  ** (2
2ad0: 29 20 65 76 65 6e 20 69 66 20 61 6e 20 69 6e 63  ) even if an inc
2ae0: 6f 72 72 65 63 74 20 76 61 6c 75 65 20 69 73 20  orrect value is 
2af0: 72 65 61 64 2c 20 6e 6f 20 67 72 65 61 74 20 68  read, no great h
2b00: 61 72 6d 20 69 73 20 64 6f 6e 65 20 73 69 6e 63  arm is done sinc
2b10: 65 20 74 68 69 73 0a 20 20 2a 2a 20 69 73 20 72  e this.  ** is r
2b20: 65 61 6c 6c 79 20 6a 75 73 74 20 61 6e 20 6f 70  eally just an op
2b30: 74 69 6d 69 7a 61 74 69 6f 6e 2e 20 2a 2f 0a 20  timization. */. 
2b40: 20 69 6e 74 20 62 55 6e 64 65 72 50 72 65 73 73   int bUnderPress
2b50: 75 72 65 3b 20 20 20 20 20 20 20 20 20 20 20 20  ure;            
2b60: 2f 2a 20 54 72 75 65 20 69 66 20 6c 6f 77 20 6f  /* True if low o
2b70: 6e 20 50 41 47 45 43 41 43 48 45 20 6d 65 6d 6f  n PAGECACHE memo
2b80: 72 79 20 2a 2f 0a 7d 20 70 63 61 63 68 65 31 5f  ry */.} pcache1_
2b90: 67 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 20 63 6f  g;../*.** All co
2ba0: 64 65 20 69 6e 20 74 68 69 73 20 66 69 6c 65 20  de in this file 
2bb0: 73 68 6f 75 6c 64 20 61 63 63 65 73 73 20 74 68  should access th
2bc0: 65 20 67 6c 6f 62 61 6c 20 73 74 72 75 63 74 75  e global structu
2bd0: 72 65 20 61 62 6f 76 65 20 76 69 61 20 74 68 65  re above via the
2be0: 0a 2a 2a 20 61 6c 69 61 73 20 22 70 63 61 63 68  .** alias "pcach
2bf0: 65 31 22 2e 20 54 68 69 73 20 65 6e 73 75 72 65  e1". This ensure
2c00: 73 20 74 68 61 74 20 74 68 65 20 57 53 44 20 65  s that the WSD e
2c10: 6d 75 6c 61 74 69 6f 6e 20 69 73 20 75 73 65 64  mulation is used
2c20: 20 77 68 65 6e 0a 2a 2a 20 63 6f 6d 70 69 6c 69   when.** compili
2c30: 6e 67 20 66 6f 72 20 73 79 73 74 65 6d 73 20 74  ng for systems t
2c40: 68 61 74 20 64 6f 20 6e 6f 74 20 73 75 70 70 6f  hat do not suppo
2c50: 72 74 20 72 65 61 6c 20 57 53 44 2e 0a 2a 2f 0a  rt real WSD..*/.
2c60: 23 64 65 66 69 6e 65 20 70 63 61 63 68 65 31 20  #define pcache1 
2c70: 28 47 4c 4f 42 41 4c 28 73 74 72 75 63 74 20 50  (GLOBAL(struct P
2c80: 43 61 63 68 65 47 6c 6f 62 61 6c 2c 20 70 63 61  CacheGlobal, pca
2c90: 63 68 65 31 5f 67 29 29 0a 0a 2f 2a 0a 2a 2a 20  che1_g))../*.** 
2ca0: 4d 61 63 72 6f 73 20 74 6f 20 65 6e 74 65 72 20  Macros to enter 
2cb0: 61 6e 64 20 6c 65 61 76 65 20 74 68 65 20 50 43  and leave the PC
2cc0: 61 63 68 65 20 4c 52 55 20 6d 75 74 65 78 2e 0a  ache LRU mutex..
2cd0: 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28  */.#if !defined(
2ce0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45  SQLITE_ENABLE_ME
2cf0: 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 29  MORY_MANAGEMENT)
2d00: 20 7c 7c 20 53 51 4c 49 54 45 5f 54 48 52 45 41   || SQLITE_THREA
2d10: 44 53 41 46 45 3d 3d 30 0a 23 20 64 65 66 69 6e  DSAFE==0.# defin
2d20: 65 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75  e pcache1EnterMu
2d30: 74 65 78 28 58 29 20 20 61 73 73 65 72 74 28 28  tex(X)  assert((
2d40: 58 29 2d 3e 6d 75 74 65 78 3d 3d 30 29 0a 23 20  X)->mutex==0).# 
2d50: 64 65 66 69 6e 65 20 70 63 61 63 68 65 31 4c 65  define pcache1Le
2d60: 61 76 65 4d 75 74 65 78 28 58 29 20 20 61 73 73  aveMutex(X)  ass
2d70: 65 72 74 28 28 58 29 2d 3e 6d 75 74 65 78 3d 3d  ert((X)->mutex==
2d80: 30 29 0a 23 20 64 65 66 69 6e 65 20 50 43 41 43  0).# define PCAC
2d90: 48 45 31 5f 4d 49 47 48 54 5f 55 53 45 5f 47 52  HE1_MIGHT_USE_GR
2da0: 4f 55 50 5f 4d 55 54 45 58 20 30 0a 23 65 6c 73  OUP_MUTEX 0.#els
2db0: 65 0a 23 20 64 65 66 69 6e 65 20 70 63 61 63 68  e.# define pcach
2dc0: 65 31 45 6e 74 65 72 4d 75 74 65 78 28 58 29 20  e1EnterMutex(X) 
2dd0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e  sqlite3_mutex_en
2de0: 74 65 72 28 28 58 29 2d 3e 6d 75 74 65 78 29 0a  ter((X)->mutex).
2df0: 23 20 64 65 66 69 6e 65 20 70 63 61 63 68 65 31  # define pcache1
2e00: 4c 65 61 76 65 4d 75 74 65 78 28 58 29 20 73 71  LeaveMutex(X) sq
2e10: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76  lite3_mutex_leav
2e20: 65 28 28 58 29 2d 3e 6d 75 74 65 78 29 0a 23 20  e((X)->mutex).# 
2e30: 64 65 66 69 6e 65 20 50 43 41 43 48 45 31 5f 4d  define PCACHE1_M
2e40: 49 47 48 54 5f 55 53 45 5f 47 52 4f 55 50 5f 4d  IGHT_USE_GROUP_M
2e50: 55 54 45 58 20 31 0a 23 65 6e 64 69 66 0a 0a 2f  UTEX 1.#endif../
2e60: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2e70: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2e80: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2e90: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2ea0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a  **************/.
2eb0: 2f 2a 2a 2a 2a 2a 2a 2a 2a 20 50 61 67 65 20 41  /******** Page A
2ec0: 6c 6c 6f 63 61 74 69 6f 6e 2f 53 51 4c 49 54 45  llocation/SQLITE
2ed0: 5f 43 4f 4e 46 49 47 5f 50 43 41 43 48 45 20 52  _CONFIG_PCACHE R
2ee0: 65 6c 61 74 65 64 20 46 75 6e 63 74 69 6f 6e 73  elated Functions
2ef0: 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f   **************/
2f00: 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75  .../*.** This fu
2f10: 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64  nction is called
2f20: 20 64 75 72 69 6e 67 20 69 6e 69 74 69 61 6c 69   during initiali
2f30: 7a 61 74 69 6f 6e 20 69 66 20 61 20 73 74 61 74  zation if a stat
2f40: 69 63 20 62 75 66 66 65 72 20 69 73 20 0a 2a 2a  ic buffer is .**
2f50: 20 73 75 70 70 6c 69 65 64 20 74 6f 20 75 73 65   supplied to use
2f60: 20 66 6f 72 20 74 68 65 20 70 61 67 65 2d 63 61   for the page-ca
2f70: 63 68 65 20 62 79 20 70 61 73 73 69 6e 67 20 74  che by passing t
2f80: 68 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47  he SQLITE_CONFIG
2f90: 5f 50 41 47 45 43 41 43 48 45 0a 2a 2a 20 76 65  _PAGECACHE.** ve
2fa0: 72 62 20 74 6f 20 73 71 6c 69 74 65 33 5f 63 6f  rb to sqlite3_co
2fb0: 6e 66 69 67 28 29 2e 20 50 61 72 61 6d 65 74 65  nfig(). Paramete
2fc0: 72 20 70 42 75 66 20 70 6f 69 6e 74 73 20 74 6f  r pBuf points to
2fd0: 20 61 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 6c   an allocation l
2fe0: 61 72 67 65 0a 2a 2a 20 65 6e 6f 75 67 68 20 74  arge.** enough t
2ff0: 6f 20 63 6f 6e 74 61 69 6e 20 27 6e 27 20 62 75  o contain 'n' bu
3000: 66 66 65 72 73 20 6f 66 20 27 73 7a 27 20 62 79  ffers of 'sz' by
3010: 74 65 73 20 65 61 63 68 2e 0a 2a 2a 0a 2a 2a 20  tes each..**.** 
3020: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20  This routine is 
3030: 63 61 6c 6c 65 64 20 66 72 6f 6d 20 73 71 6c 69  called from sqli
3040: 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29  te3_initialize()
3050: 20 61 6e 64 20 73 6f 20 69 74 20 69 73 20 67 75   and so it is gu
3060: 61 72 61 6e 74 65 65 64 0a 2a 2a 20 74 6f 20 62  aranteed.** to b
3070: 65 20 73 65 72 69 61 6c 69 7a 65 64 20 61 6c 72  e serialized alr
3080: 65 61 64 79 2e 20 20 54 68 65 72 65 20 69 73 20  eady.  There is 
3090: 6e 6f 20 6e 65 65 64 20 66 6f 72 20 66 75 72 74  no need for furt
30a0: 68 65 72 20 6d 75 74 65 78 69 6e 67 2e 0a 2a 2f  her mutexing..*/
30b0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 43 61  .void sqlite3PCa
30c0: 63 68 65 42 75 66 66 65 72 53 65 74 75 70 28 76  cheBufferSetup(v
30d0: 6f 69 64 20 2a 70 42 75 66 2c 20 69 6e 74 20 73  oid *pBuf, int s
30e0: 7a 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 69 66 28  z, int n){.  if(
30f0: 20 70 63 61 63 68 65 31 2e 69 73 49 6e 69 74 20   pcache1.isInit 
3100: 29 7b 0a 20 20 20 20 50 67 46 72 65 65 73 6c 6f  ){.    PgFreeslo
3110: 74 20 2a 70 3b 0a 20 20 20 20 69 66 28 20 70 42  t *p;.    if( pB
3120: 75 66 3d 3d 30 20 29 20 73 7a 20 3d 20 6e 20 3d  uf==0 ) sz = n =
3130: 20 30 3b 0a 20 20 20 20 69 66 28 20 6e 3d 3d 30   0;.    if( n==0
3140: 20 29 20 73 7a 20 3d 20 30 3b 0a 20 20 20 20 73   ) sz = 0;.    s
3150: 7a 20 3d 20 52 4f 55 4e 44 44 4f 57 4e 38 28 73  z = ROUNDDOWN8(s
3160: 7a 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e  z);.    pcache1.
3170: 73 7a 53 6c 6f 74 20 3d 20 73 7a 3b 0a 20 20 20  szSlot = sz;.   
3180: 20 70 63 61 63 68 65 31 2e 6e 53 6c 6f 74 20 3d   pcache1.nSlot =
3190: 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65 53 6c   pcache1.nFreeSl
31a0: 6f 74 20 3d 20 6e 3b 0a 20 20 20 20 70 63 61 63  ot = n;.    pcac
31b0: 68 65 31 2e 6e 52 65 73 65 72 76 65 20 3d 20 6e  he1.nReserve = n
31c0: 3e 39 30 20 3f 20 31 30 20 3a 20 28 6e 2f 31 30  >90 ? 10 : (n/10
31d0: 20 2b 20 31 29 3b 0a 20 20 20 20 70 63 61 63 68   + 1);.    pcach
31e0: 65 31 2e 70 53 74 61 72 74 20 3d 20 70 42 75 66  e1.pStart = pBuf
31f0: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 70 46  ;.    pcache1.pF
3200: 72 65 65 20 3d 20 30 3b 0a 20 20 20 20 70 63 61  ree = 0;.    pca
3210: 63 68 65 31 2e 62 55 6e 64 65 72 50 72 65 73 73  che1.bUnderPress
3220: 75 72 65 20 3d 20 30 3b 0a 20 20 20 20 77 68 69  ure = 0;.    whi
3230: 6c 65 28 20 6e 2d 2d 20 29 7b 0a 20 20 20 20 20  le( n-- ){.     
3240: 20 70 20 3d 20 28 50 67 46 72 65 65 73 6c 6f 74   p = (PgFreeslot
3250: 2a 29 70 42 75 66 3b 0a 20 20 20 20 20 20 70 2d  *)pBuf;.      p-
3260: 3e 70 4e 65 78 74 20 3d 20 70 63 61 63 68 65 31  >pNext = pcache1
3270: 2e 70 46 72 65 65 3b 0a 20 20 20 20 20 20 70 63  .pFree;.      pc
3280: 61 63 68 65 31 2e 70 46 72 65 65 20 3d 20 70 3b  ache1.pFree = p;
3290: 0a 20 20 20 20 20 20 70 42 75 66 20 3d 20 28 76  .      pBuf = (v
32a0: 6f 69 64 2a 29 26 28 28 63 68 61 72 2a 29 70 42  oid*)&((char*)pB
32b0: 75 66 29 5b 73 7a 5d 3b 0a 20 20 20 20 7d 0a 20  uf)[sz];.    }. 
32c0: 20 20 20 70 63 61 63 68 65 31 2e 70 45 6e 64 20     pcache1.pEnd 
32d0: 3d 20 70 42 75 66 3b 0a 20 20 7d 0a 7d 0a 0a 2f  = pBuf;.  }.}../
32e0: 2a 0a 2a 2a 20 54 72 79 20 74 6f 20 69 6e 69 74  *.** Try to init
32f0: 69 61 6c 69 7a 65 20 74 68 65 20 70 43 61 63 68  ialize the pCach
3300: 65 2d 3e 70 46 72 65 65 20 61 6e 64 20 70 43 61  e->pFree and pCa
3310: 63 68 65 2d 3e 70 42 75 6c 6b 20 66 69 65 6c 64  che->pBulk field
3320: 73 2e 20 20 52 65 74 75 72 6e 0a 2a 2a 20 74 72  s.  Return.** tr
3330: 75 65 20 69 66 20 70 43 61 63 68 65 2d 3e 70 46  ue if pCache->pF
3340: 72 65 65 20 65 6e 64 73 20 75 70 20 63 6f 6e 74  ree ends up cont
3350: 61 69 6e 69 6e 67 20 6f 6e 65 20 6f 72 20 6d 6f  aining one or mo
3360: 72 65 20 66 72 65 65 20 70 61 67 65 73 2e 0a 2a  re free pages..*
3370: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 63 61  /.static int pca
3380: 63 68 65 31 49 6e 69 74 42 75 6c 6b 28 50 43 61  che1InitBulk(PCa
3390: 63 68 65 31 20 2a 70 43 61 63 68 65 29 7b 0a 20  che1 *pCache){. 
33a0: 20 69 36 34 20 73 7a 42 75 6c 6b 3b 0a 20 20 63   i64 szBulk;.  c
33b0: 68 61 72 20 2a 7a 42 75 6c 6b 3b 0a 20 20 69 66  har *zBulk;.  if
33c0: 28 20 70 63 61 63 68 65 31 2e 6e 49 6e 69 74 50  ( pcache1.nInitP
33d0: 61 67 65 3d 3d 30 20 29 20 72 65 74 75 72 6e 20  age==0 ) return 
33e0: 30 3b 0a 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 62  0;.  /* Do not b
33f0: 6f 74 68 65 72 20 77 69 74 68 20 61 20 62 75 6c  other with a bul
3400: 6b 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69 66 20  k allocation if 
3410: 74 68 65 20 63 61 63 68 65 20 73 69 7a 65 20 76  the cache size v
3420: 65 72 79 20 73 6d 61 6c 6c 20 2a 2f 0a 20 20 69  ery small */.  i
3430: 66 28 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 3c  f( pCache->nMax<
3440: 33 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20  3 ) return 0;.  
3450: 73 71 6c 69 74 65 33 42 65 67 69 6e 42 65 6e 69  sqlite3BeginBeni
3460: 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 69 66  gnMalloc();.  if
3470: 28 20 70 63 61 63 68 65 31 2e 6e 49 6e 69 74 50  ( pcache1.nInitP
3480: 61 67 65 3e 30 20 29 7b 0a 20 20 20 20 73 7a 42  age>0 ){.    szB
3490: 75 6c 6b 20 3d 20 70 43 61 63 68 65 2d 3e 73 7a  ulk = pCache->sz
34a0: 41 6c 6c 6f 63 20 2a 20 28 69 36 34 29 70 63 61  Alloc * (i64)pca
34b0: 63 68 65 31 2e 6e 49 6e 69 74 50 61 67 65 3b 0a  che1.nInitPage;.
34c0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 7a 42    }else{.    szB
34d0: 75 6c 6b 20 3d 20 2d 31 30 32 34 20 2a 20 28 69  ulk = -1024 * (i
34e0: 36 34 29 70 63 61 63 68 65 31 2e 6e 49 6e 69 74  64)pcache1.nInit
34f0: 50 61 67 65 3b 0a 20 20 7d 0a 20 20 69 66 28 20  Page;.  }.  if( 
3500: 73 7a 42 75 6c 6b 20 3e 20 70 43 61 63 68 65 2d  szBulk > pCache-
3510: 3e 73 7a 41 6c 6c 6f 63 2a 28 69 36 34 29 70 43  >szAlloc*(i64)pC
3520: 61 63 68 65 2d 3e 6e 4d 61 78 20 29 7b 0a 20 20  ache->nMax ){.  
3530: 20 20 73 7a 42 75 6c 6b 20 3d 20 70 43 61 63 68    szBulk = pCach
3540: 65 2d 3e 73 7a 41 6c 6c 6f 63 2a 28 69 36 34 29  e->szAlloc*(i64)
3550: 70 43 61 63 68 65 2d 3e 6e 4d 61 78 3b 0a 20 20  pCache->nMax;.  
3560: 7d 0a 20 20 7a 42 75 6c 6b 20 3d 20 70 43 61 63  }.  zBulk = pCac
3570: 68 65 2d 3e 70 42 75 6c 6b 20 3d 20 73 71 6c 69  he->pBulk = sqli
3580: 74 65 33 4d 61 6c 6c 6f 63 28 20 73 7a 42 75 6c  te3Malloc( szBul
3590: 6b 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 45 6e  k );.  sqlite3En
35a0: 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b  dBenignMalloc();
35b0: 0a 20 20 69 66 28 20 7a 42 75 6c 6b 20 29 7b 0a  .  if( zBulk ){.
35c0: 20 20 20 20 69 6e 74 20 6e 42 75 6c 6b 20 3d 20      int nBulk = 
35d0: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a  sqlite3MallocSiz
35e0: 65 28 7a 42 75 6c 6b 29 2f 70 43 61 63 68 65 2d  e(zBulk)/pCache-
35f0: 3e 73 7a 41 6c 6c 6f 63 3b 0a 20 20 20 20 64 6f  >szAlloc;.    do
3600: 7b 0a 20 20 20 20 20 20 50 67 48 64 72 31 20 2a  {.      PgHdr1 *
3610: 70 58 20 3d 20 28 50 67 48 64 72 31 2a 29 26 7a  pX = (PgHdr1*)&z
3620: 42 75 6c 6b 5b 70 43 61 63 68 65 2d 3e 73 7a 50  Bulk[pCache->szP
3630: 61 67 65 5d 3b 0a 20 20 20 20 20 20 70 58 2d 3e  age];.      pX->
3640: 70 61 67 65 2e 70 42 75 66 20 3d 20 7a 42 75 6c  page.pBuf = zBul
3650: 6b 3b 0a 20 20 20 20 20 20 70 58 2d 3e 70 61 67  k;.      pX->pag
3660: 65 2e 70 45 78 74 72 61 20 3d 20 26 70 58 5b 31  e.pExtra = &pX[1
3670: 5d 3b 0a 20 20 20 20 20 20 70 58 2d 3e 69 73 42  ];.      pX->isB
3680: 75 6c 6b 4c 6f 63 61 6c 20 3d 20 31 3b 0a 20 20  ulkLocal = 1;.  
3690: 20 20 20 20 70 58 2d 3e 69 73 41 6e 63 68 6f 72      pX->isAnchor
36a0: 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 58 2d 3e   = 0;.      pX->
36b0: 70 4e 65 78 74 20 3d 20 70 43 61 63 68 65 2d 3e  pNext = pCache->
36c0: 70 46 72 65 65 3b 0a 20 20 20 20 20 20 70 58 2d  pFree;.      pX-
36d0: 3e 70 4c 72 75 50 72 65 76 20 3d 20 30 3b 20 20  >pLruPrev = 0;  
36e0: 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 69 74           /* Init
36f0: 69 61 6c 69 7a 69 6e 67 20 74 68 69 73 20 73 61  ializing this sa
3700: 76 65 73 20 61 20 76 61 6c 67 72 69 6e 64 20 65  ves a valgrind e
3710: 72 72 6f 72 20 2a 2f 0a 20 20 20 20 20 20 70 43  rror */.      pC
3720: 61 63 68 65 2d 3e 70 46 72 65 65 20 3d 20 70 58  ache->pFree = pX
3730: 3b 0a 20 20 20 20 20 20 7a 42 75 6c 6b 20 2b 3d  ;.      zBulk +=
3740: 20 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63   pCache->szAlloc
3750: 3b 0a 20 20 20 20 7d 77 68 69 6c 65 28 20 2d 2d  ;.    }while( --
3760: 6e 42 75 6c 6b 20 29 3b 0a 20 20 7d 0a 20 20 72  nBulk );.  }.  r
3770: 65 74 75 72 6e 20 70 43 61 63 68 65 2d 3e 70 46  eturn pCache->pF
3780: 72 65 65 21 3d 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ree!=0;.}../*.**
3790: 20 4d 61 6c 6c 6f 63 20 66 75 6e 63 74 69 6f 6e   Malloc function
37a0: 20 75 73 65 64 20 77 69 74 68 69 6e 20 74 68 69   used within thi
37b0: 73 20 66 69 6c 65 20 74 6f 20 61 6c 6c 6f 63 61  s file to alloca
37c0: 74 65 20 73 70 61 63 65 20 66 72 6f 6d 20 74 68  te space from th
37d0: 65 20 62 75 66 66 65 72 0a 2a 2a 20 63 6f 6e 66  e buffer.** conf
37e0: 69 67 75 72 65 64 20 75 73 69 6e 67 20 73 71 6c  igured using sql
37f0: 69 74 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49  ite3_config(SQLI
3800: 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41  TE_CONFIG_PAGECA
3810: 43 48 45 29 20 6f 70 74 69 6f 6e 2e 20 49 66 20  CHE) option. If 
3820: 6e 6f 20 0a 2a 2a 20 73 75 63 68 20 62 75 66 66  no .** such buff
3830: 65 72 20 65 78 69 73 74 73 20 6f 72 20 74 68 65  er exists or the
3840: 72 65 20 69 73 20 6e 6f 20 73 70 61 63 65 20 6c  re is no space l
3850: 65 66 74 20 69 6e 20 69 74 2c 20 74 68 69 73 20  eft in it, this 
3860: 66 75 6e 63 74 69 6f 6e 20 66 61 6c 6c 73 20 0a  function falls .
3870: 2a 2a 20 62 61 63 6b 20 74 6f 20 73 71 6c 69 74  ** back to sqlit
3880: 65 33 4d 61 6c 6c 6f 63 28 29 2e 0a 2a 2a 0a 2a  e3Malloc()..**.*
3890: 2a 20 4d 75 6c 74 69 70 6c 65 20 74 68 72 65 61  * Multiple threa
38a0: 64 73 20 63 61 6e 20 72 75 6e 20 74 68 69 73 20  ds can run this 
38b0: 72 6f 75 74 69 6e 65 20 61 74 20 74 68 65 20 73  routine at the s
38c0: 61 6d 65 20 74 69 6d 65 2e 20 20 47 6c 6f 62 61  ame time.  Globa
38d0: 6c 20 76 61 72 69 61 62 6c 65 73 0a 2a 2a 20 69  l variables.** i
38e0: 6e 20 70 63 61 63 68 65 31 20 6e 65 65 64 20 74  n pcache1 need t
38f0: 6f 20 62 65 20 70 72 6f 74 65 63 74 65 64 20 76  o be protected v
3900: 69 61 20 6d 75 74 65 78 2e 0a 2a 2f 0a 73 74 61  ia mutex..*/.sta
3910: 74 69 63 20 76 6f 69 64 20 2a 70 63 61 63 68 65  tic void *pcache
3920: 31 41 6c 6c 6f 63 28 69 6e 74 20 6e 42 79 74 65  1Alloc(int nByte
3930: 29 7b 0a 20 20 76 6f 69 64 20 2a 70 20 3d 20 30  ){.  void *p = 0
3940: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69  ;.  assert( sqli
3950: 74 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c  te3_mutex_nothel
3960: 64 28 70 63 61 63 68 65 31 2e 67 72 70 2e 6d 75  d(pcache1.grp.mu
3970: 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 6e 42  tex) );.  if( nB
3980: 79 74 65 3c 3d 70 63 61 63 68 65 31 2e 73 7a 53  yte<=pcache1.szS
3990: 6c 6f 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  lot ){.    sqlit
39a0: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70  e3_mutex_enter(p
39b0: 63 61 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20  cache1.mutex);. 
39c0: 20 20 20 70 20 3d 20 28 50 67 48 64 72 31 20 2a     p = (PgHdr1 *
39d0: 29 70 63 61 63 68 65 31 2e 70 46 72 65 65 3b 0a  )pcache1.pFree;.
39e0: 20 20 20 20 69 66 28 20 70 20 29 7b 0a 20 20 20      if( p ){.   
39f0: 20 20 20 70 63 61 63 68 65 31 2e 70 46 72 65 65     pcache1.pFree
3a00: 20 3d 20 70 63 61 63 68 65 31 2e 70 46 72 65 65   = pcache1.pFree
3a10: 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 70  ->pNext;.      p
3a20: 63 61 63 68 65 31 2e 6e 46 72 65 65 53 6c 6f 74  cache1.nFreeSlot
3a30: 2d 2d 3b 0a 20 20 20 20 20 20 70 63 61 63 68 65  --;.      pcache
3a40: 31 2e 62 55 6e 64 65 72 50 72 65 73 73 75 72 65  1.bUnderPressure
3a50: 20 3d 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65   = pcache1.nFree
3a60: 53 6c 6f 74 3c 70 63 61 63 68 65 31 2e 6e 52 65  Slot<pcache1.nRe
3a70: 73 65 72 76 65 3b 0a 20 20 20 20 20 20 61 73 73  serve;.      ass
3a80: 65 72 74 28 20 70 63 61 63 68 65 31 2e 6e 46 72  ert( pcache1.nFr
3a90: 65 65 53 6c 6f 74 3e 3d 30 20 29 3b 0a 20 20 20  eeSlot>=0 );.   
3aa0: 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73     sqlite3Status
3ab0: 48 69 67 68 77 61 74 65 72 28 53 51 4c 49 54 45  Highwater(SQLITE
3ac0: 5f 53 54 41 54 55 53 5f 50 41 47 45 43 41 43 48  _STATUS_PAGECACH
3ad0: 45 5f 53 49 5a 45 2c 20 6e 42 79 74 65 29 3b 0a  E_SIZE, nByte);.
3ae0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 53 74 61        sqlite3Sta
3af0: 74 75 73 55 70 28 53 51 4c 49 54 45 5f 53 54 41  tusUp(SQLITE_STA
3b00: 54 55 53 5f 50 41 47 45 43 41 43 48 45 5f 55 53  TUS_PAGECACHE_US
3b10: 45 44 2c 20 31 29 3b 0a 20 20 20 20 7d 0a 20 20  ED, 1);.    }.  
3b20: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f    sqlite3_mutex_
3b30: 6c 65 61 76 65 28 70 63 61 63 68 65 31 2e 6d 75  leave(pcache1.mu
3b40: 74 65 78 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20  tex);.  }.  if( 
3b50: 70 3d 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 20 4d  p==0 ){.    /* M
3b60: 65 6d 6f 72 79 20 69 73 20 6e 6f 74 20 61 76 61  emory is not ava
3b70: 69 6c 61 62 6c 65 20 69 6e 20 74 68 65 20 53 51  ilable in the SQ
3b80: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45  LITE_CONFIG_PAGE
3b90: 43 41 43 48 45 20 70 6f 6f 6c 2e 20 20 47 65 74  CACHE pool.  Get
3ba0: 0a 20 20 20 20 2a 2a 20 69 74 20 66 72 6f 6d 20  .    ** it from 
3bb0: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 20 69 6e  sqlite3Malloc in
3bc0: 73 74 65 61 64 2e 0a 20 20 20 20 2a 2f 0a 20 20  stead..    */.  
3bd0: 20 20 70 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c    p = sqlite3Mal
3be0: 6c 6f 63 28 6e 42 79 74 65 29 3b 0a 23 69 66 6e  loc(nByte);.#ifn
3bf0: 64 65 66 20 53 51 4c 49 54 45 5f 44 49 53 41 42  def SQLITE_DISAB
3c00: 4c 45 5f 50 41 47 45 43 41 43 48 45 5f 4f 56 45  LE_PAGECACHE_OVE
3c10: 52 46 4c 4f 57 5f 53 54 41 54 53 0a 20 20 20 20  RFLOW_STATS.    
3c20: 69 66 28 20 70 20 29 7b 0a 20 20 20 20 20 20 69  if( p ){.      i
3c30: 6e 74 20 73 7a 20 3d 20 73 71 6c 69 74 65 33 4d  nt sz = sqlite3M
3c40: 61 6c 6c 6f 63 53 69 7a 65 28 70 29 3b 0a 20 20  allocSize(p);.  
3c50: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65      sqlite3_mute
3c60: 78 5f 65 6e 74 65 72 28 70 63 61 63 68 65 31 2e  x_enter(pcache1.
3c70: 6d 75 74 65 78 29 3b 0a 20 20 20 20 20 20 73 71  mutex);.      sq
3c80: 6c 69 74 65 33 53 74 61 74 75 73 48 69 67 68 77  lite3StatusHighw
3c90: 61 74 65 72 28 53 51 4c 49 54 45 5f 53 54 41 54  ater(SQLITE_STAT
3ca0: 55 53 5f 50 41 47 45 43 41 43 48 45 5f 53 49 5a  US_PAGECACHE_SIZ
3cb0: 45 2c 20 6e 42 79 74 65 29 3b 0a 20 20 20 20 20  E, nByte);.     
3cc0: 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 55 70   sqlite3StatusUp
3cd0: 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 50  (SQLITE_STATUS_P
3ce0: 41 47 45 43 41 43 48 45 5f 4f 56 45 52 46 4c 4f  AGECACHE_OVERFLO
3cf0: 57 2c 20 73 7a 29 3b 0a 20 20 20 20 20 20 73 71  W, sz);.      sq
3d00: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76  lite3_mutex_leav
3d10: 65 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29  e(pcache1.mutex)
3d20: 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20  ;.    }.#endif. 
3d30: 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62     sqlite3Memdeb
3d40: 75 67 53 65 74 54 79 70 65 28 70 2c 20 4d 45 4d  ugSetType(p, MEM
3d50: 54 59 50 45 5f 50 43 41 43 48 45 29 3b 0a 20 20  TYPE_PCACHE);.  
3d60: 7d 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a  }.  return p;.}.
3d70: 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 6e 20 61  ./*.** Free an a
3d80: 6c 6c 6f 63 61 74 65 64 20 62 75 66 66 65 72 20  llocated buffer 
3d90: 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 70 63  obtained from pc
3da0: 61 63 68 65 31 41 6c 6c 6f 63 28 29 2e 0a 2a 2f  ache1Alloc()..*/
3db0: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61  .static void pca
3dc0: 63 68 65 31 46 72 65 65 28 76 6f 69 64 20 2a 70  che1Free(void *p
3dd0: 29 7b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20  ){.  if( p==0 ) 
3de0: 72 65 74 75 72 6e 3b 0a 20 20 69 66 28 20 53 51  return;.  if( SQ
3df0: 4c 49 54 45 5f 57 49 54 48 49 4e 28 70 2c 20 70  LITE_WITHIN(p, p
3e00: 63 61 63 68 65 31 2e 70 53 74 61 72 74 2c 20 70  cache1.pStart, p
3e10: 63 61 63 68 65 31 2e 70 45 6e 64 29 20 29 7b 0a  cache1.pEnd) ){.
3e20: 20 20 20 20 50 67 46 72 65 65 73 6c 6f 74 20 2a      PgFreeslot *
3e30: 70 53 6c 6f 74 3b 0a 20 20 20 20 73 71 6c 69 74  pSlot;.    sqlit
3e40: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70  e3_mutex_enter(p
3e50: 63 61 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20  cache1.mutex);. 
3e60: 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73     sqlite3Status
3e70: 44 6f 77 6e 28 53 51 4c 49 54 45 5f 53 54 41 54  Down(SQLITE_STAT
3e80: 55 53 5f 50 41 47 45 43 41 43 48 45 5f 55 53 45  US_PAGECACHE_USE
3e90: 44 2c 20 31 29 3b 0a 20 20 20 20 70 53 6c 6f 74  D, 1);.    pSlot
3ea0: 20 3d 20 28 50 67 46 72 65 65 73 6c 6f 74 2a 29   = (PgFreeslot*)
3eb0: 70 3b 0a 20 20 20 20 70 53 6c 6f 74 2d 3e 70 4e  p;.    pSlot->pN
3ec0: 65 78 74 20 3d 20 70 63 61 63 68 65 31 2e 70 46  ext = pcache1.pF
3ed0: 72 65 65 3b 0a 20 20 20 20 70 63 61 63 68 65 31  ree;.    pcache1
3ee0: 2e 70 46 72 65 65 20 3d 20 70 53 6c 6f 74 3b 0a  .pFree = pSlot;.
3ef0: 20 20 20 20 70 63 61 63 68 65 31 2e 6e 46 72 65      pcache1.nFre
3f00: 65 53 6c 6f 74 2b 2b 3b 0a 20 20 20 20 70 63 61  eSlot++;.    pca
3f10: 63 68 65 31 2e 62 55 6e 64 65 72 50 72 65 73 73  che1.bUnderPress
3f20: 75 72 65 20 3d 20 70 63 61 63 68 65 31 2e 6e 46  ure = pcache1.nF
3f30: 72 65 65 53 6c 6f 74 3c 70 63 61 63 68 65 31 2e  reeSlot<pcache1.
3f40: 6e 52 65 73 65 72 76 65 3b 0a 20 20 20 20 61 73  nReserve;.    as
3f50: 73 65 72 74 28 20 70 63 61 63 68 65 31 2e 6e 46  sert( pcache1.nF
3f60: 72 65 65 53 6c 6f 74 3c 3d 70 63 61 63 68 65 31  reeSlot<=pcache1
3f70: 2e 6e 53 6c 6f 74 20 29 3b 0a 20 20 20 20 73 71  .nSlot );.    sq
3f80: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76  lite3_mutex_leav
3f90: 65 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29  e(pcache1.mutex)
3fa0: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61  ;.  }else{.    a
3fb0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d 65  ssert( sqlite3Me
3fc0: 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 70 2c  mdebugHasType(p,
3fd0: 20 4d 45 4d 54 59 50 45 5f 50 43 41 43 48 45 29   MEMTYPE_PCACHE)
3fe0: 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 4d   );.    sqlite3M
3ff0: 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 28 70  emdebugSetType(p
4000: 2c 20 4d 45 4d 54 59 50 45 5f 48 45 41 50 29 3b  , MEMTYPE_HEAP);
4010: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
4020: 44 49 53 41 42 4c 45 5f 50 41 47 45 43 41 43 48  DISABLE_PAGECACH
4030: 45 5f 4f 56 45 52 46 4c 4f 57 5f 53 54 41 54 53  E_OVERFLOW_STATS
4040: 0a 20 20 20 20 7b 0a 20 20 20 20 20 20 69 6e 74  .    {.      int
4050: 20 6e 46 72 65 65 64 20 3d 20 30 3b 0a 20 20 20   nFreed = 0;.   
4060: 20 20 20 6e 46 72 65 65 64 20 3d 20 73 71 6c 69     nFreed = sqli
4070: 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 29  te3MallocSize(p)
4080: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f  ;.      sqlite3_
4090: 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 63 61 63  mutex_enter(pcac
40a0: 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20  he1.mutex);.    
40b0: 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 44    sqlite3StatusD
40c0: 6f 77 6e 28 53 51 4c 49 54 45 5f 53 54 41 54 55  own(SQLITE_STATU
40d0: 53 5f 50 41 47 45 43 41 43 48 45 5f 4f 56 45 52  S_PAGECACHE_OVER
40e0: 46 4c 4f 57 2c 20 6e 46 72 65 65 64 29 3b 0a 20  FLOW, nFreed);. 
40f0: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74       sqlite3_mut
4100: 65 78 5f 6c 65 61 76 65 28 70 63 61 63 68 65 31  ex_leave(pcache1
4110: 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 7d 0a 23  .mutex);.    }.#
4120: 65 6e 64 69 66 0a 20 20 20 20 73 71 6c 69 74 65  endif.    sqlite
4130: 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 7d 0a 7d  3_free(p);.  }.}
4140: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ..#ifdef SQLITE_
4150: 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41  ENABLE_MEMORY_MA
4160: 4e 41 47 45 4d 45 4e 54 0a 2f 2a 0a 2a 2a 20 52  NAGEMENT./*.** R
4170: 65 74 75 72 6e 20 74 68 65 20 73 69 7a 65 20 6f  eturn the size o
4180: 66 20 61 20 70 63 61 63 68 65 20 61 6c 6c 6f 63  f a pcache alloc
4190: 61 74 69 6f 6e 0a 2a 2f 0a 73 74 61 74 69 63 20  ation.*/.static 
41a0: 69 6e 74 20 70 63 61 63 68 65 31 4d 65 6d 53 69  int pcache1MemSi
41b0: 7a 65 28 76 6f 69 64 20 2a 70 29 7b 0a 20 20 69  ze(void *p){.  i
41c0: 66 28 20 70 3e 3d 70 63 61 63 68 65 31 2e 70 53  f( p>=pcache1.pS
41d0: 74 61 72 74 20 26 26 20 70 3c 70 63 61 63 68 65  tart && p<pcache
41e0: 31 2e 70 45 6e 64 20 29 7b 0a 20 20 20 20 72 65  1.pEnd ){.    re
41f0: 74 75 72 6e 20 70 63 61 63 68 65 31 2e 73 7a 53  turn pcache1.szS
4200: 6c 6f 74 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  lot;.  }else{.  
4210: 20 20 69 6e 74 20 69 53 69 7a 65 3b 0a 20 20 20    int iSize;.   
4220: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
4230: 4d 65 6d 64 65 62 75 67 48 61 73 54 79 70 65 28  MemdebugHasType(
4240: 70 2c 20 4d 45 4d 54 59 50 45 5f 50 43 41 43 48  p, MEMTYPE_PCACH
4250: 45 29 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  E) );.    sqlite
4260: 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65  3MemdebugSetType
4270: 28 70 2c 20 4d 45 4d 54 59 50 45 5f 48 45 41 50  (p, MEMTYPE_HEAP
4280: 29 3b 0a 20 20 20 20 69 53 69 7a 65 20 3d 20 73  );.    iSize = s
4290: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65  qlite3MallocSize
42a0: 28 70 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  (p);.    sqlite3
42b0: 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 28  MemdebugSetType(
42c0: 70 2c 20 4d 45 4d 54 59 50 45 5f 50 43 41 43 48  p, MEMTYPE_PCACH
42d0: 45 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 69  E);.    return i
42e0: 53 69 7a 65 3b 0a 20 20 7d 0a 7d 0a 23 65 6e 64  Size;.  }.}.#end
42f0: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41  if /* SQLITE_ENA
4300: 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47  BLE_MEMORY_MANAG
4310: 45 4d 45 4e 54 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20  EMENT */../*.** 
4320: 41 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 70  Allocate a new p
4330: 61 67 65 20 6f 62 6a 65 63 74 20 69 6e 69 74 69  age object initi
4340: 61 6c 6c 79 20 61 73 73 6f 63 69 61 74 65 64 20  ally associated 
4350: 77 69 74 68 20 63 61 63 68 65 20 70 43 61 63 68  with cache pCach
4360: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67 48  e..*/.static PgH
4370: 64 72 31 20 2a 70 63 61 63 68 65 31 41 6c 6c 6f  dr1 *pcache1Allo
4380: 63 50 61 67 65 28 50 43 61 63 68 65 31 20 2a 70  cPage(PCache1 *p
4390: 43 61 63 68 65 2c 20 69 6e 74 20 62 65 6e 69 67  Cache, int benig
43a0: 6e 4d 61 6c 6c 6f 63 29 7b 0a 20 20 50 67 48 64  nMalloc){.  PgHd
43b0: 72 31 20 2a 70 20 3d 20 30 3b 0a 20 20 76 6f 69  r1 *p = 0;.  voi
43c0: 64 20 2a 70 50 67 3b 0a 0a 20 20 61 73 73 65 72  d *pPg;..  asser
43d0: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  t( sqlite3_mutex
43e0: 5f 68 65 6c 64 28 70 43 61 63 68 65 2d 3e 70 47  _held(pCache->pG
43f0: 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a  roup->mutex) );.
4400: 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e 70 46    if( pCache->pF
4410: 72 65 65 20 7c 7c 20 28 70 43 61 63 68 65 2d 3e  ree || (pCache->
4420: 6e 50 61 67 65 3d 3d 30 20 26 26 20 70 63 61 63  nPage==0 && pcac
4430: 68 65 31 49 6e 69 74 42 75 6c 6b 28 70 43 61 63  he1InitBulk(pCac
4440: 68 65 29 29 20 29 7b 0a 20 20 20 20 70 20 3d 20  he)) ){.    p = 
4450: 70 43 61 63 68 65 2d 3e 70 46 72 65 65 3b 0a 20  pCache->pFree;. 
4460: 20 20 20 70 43 61 63 68 65 2d 3e 70 46 72 65 65     pCache->pFree
4470: 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 20   = p->pNext;.   
4480: 20 70 2d 3e 70 4e 65 78 74 20 3d 20 30 3b 0a 20   p->pNext = 0;. 
4490: 20 7d 65 6c 73 65 7b 0a 23 69 66 64 65 66 20 53   }else{.#ifdef S
44a0: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d  QLITE_ENABLE_MEM
44b0: 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 20  ORY_MANAGEMENT. 
44c0: 20 20 20 2f 2a 20 54 68 65 20 67 72 6f 75 70 20     /* The group 
44d0: 6d 75 74 65 78 20 6d 75 73 74 20 62 65 20 72 65  mutex must be re
44e0: 6c 65 61 73 65 64 20 62 65 66 6f 72 65 20 70 63  leased before pc
44f0: 61 63 68 65 31 41 6c 6c 6f 63 28 29 20 69 73 20  ache1Alloc() is 
4500: 63 61 6c 6c 65 64 2e 20 54 68 69 73 0a 20 20 20  called. This.   
4510: 20 2a 2a 20 69 73 20 62 65 63 61 75 73 65 20 69   ** is because i
4520: 74 20 6d 69 67 68 74 20 63 61 6c 6c 20 73 71 6c  t might call sql
4530: 69 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d  ite3_release_mem
4540: 6f 72 79 28 29 2c 20 77 68 69 63 68 20 61 73 73  ory(), which ass
4550: 75 6d 65 73 20 74 68 61 74 20 0a 20 20 20 20 2a  umes that .    *
4560: 2a 20 74 68 69 73 20 6d 75 74 65 78 20 69 73 20  * this mutex is 
4570: 6e 6f 74 20 68 65 6c 64 2e 20 2a 2f 0a 20 20 20  not held. */.   
4580: 20 61 73 73 65 72 74 28 20 70 63 61 63 68 65 31   assert( pcache1
4590: 2e 73 65 70 61 72 61 74 65 43 61 63 68 65 3d 3d  .separateCache==
45a0: 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28  0 );.    assert(
45b0: 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3d   pCache->pGroup=
45c0: 3d 26 70 63 61 63 68 65 31 2e 67 72 70 20 29 3b  =&pcache1.grp );
45d0: 0a 20 20 20 20 70 63 61 63 68 65 31 4c 65 61 76  .    pcache1Leav
45e0: 65 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70  eMutex(pCache->p
45f0: 47 72 6f 75 70 29 3b 0a 23 65 6e 64 69 66 0a 20  Group);.#endif. 
4600: 20 20 20 69 66 28 20 62 65 6e 69 67 6e 4d 61 6c     if( benignMal
4610: 6c 6f 63 20 29 7b 20 73 71 6c 69 74 65 33 42 65  loc ){ sqlite3Be
4620: 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28  ginBenignMalloc(
4630: 29 3b 20 7d 0a 23 69 66 64 65 66 20 53 51 4c 49  ); }.#ifdef SQLI
4640: 54 45 5f 50 43 41 43 48 45 5f 53 45 50 41 52 41  TE_PCACHE_SEPARA
4650: 54 45 5f 48 45 41 44 45 52 0a 20 20 20 20 70 50  TE_HEADER.    pP
4660: 67 20 3d 20 70 63 61 63 68 65 31 41 6c 6c 6f 63  g = pcache1Alloc
4670: 28 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 29  (pCache->szPage)
4680: 3b 0a 20 20 20 20 70 20 3d 20 73 71 6c 69 74 65  ;.    p = sqlite
4690: 33 4d 61 6c 6c 6f 63 28 73 69 7a 65 6f 66 28 50  3Malloc(sizeof(P
46a0: 67 48 64 72 31 29 20 2b 20 70 43 61 63 68 65 2d  gHdr1) + pCache-
46b0: 3e 73 7a 45 78 74 72 61 29 3b 0a 20 20 20 20 69  >szExtra);.    i
46c0: 66 28 20 21 70 50 67 20 7c 7c 20 21 70 20 29 7b  f( !pPg || !p ){
46d0: 0a 20 20 20 20 20 20 70 63 61 63 68 65 31 46 72  .      pcache1Fr
46e0: 65 65 28 70 50 67 29 3b 0a 20 20 20 20 20 20 73  ee(pPg);.      s
46f0: 71 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a  qlite3_free(p);.
4700: 20 20 20 20 20 20 70 50 67 20 3d 20 30 3b 0a 20        pPg = 0;. 
4710: 20 20 20 7d 0a 23 65 6c 73 65 0a 20 20 20 20 70     }.#else.    p
4720: 50 67 20 3d 20 70 63 61 63 68 65 31 41 6c 6c 6f  Pg = pcache1Allo
4730: 63 28 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f  c(pCache->szAllo
4740: 63 29 3b 0a 20 20 20 20 70 20 3d 20 28 50 67 48  c);.    p = (PgH
4750: 64 72 31 20 2a 29 26 28 28 75 38 20 2a 29 70 50  dr1 *)&((u8 *)pP
4760: 67 29 5b 70 43 61 63 68 65 2d 3e 73 7a 50 61 67  g)[pCache->szPag
4770: 65 5d 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 69  e];.#endif.    i
4780: 66 28 20 62 65 6e 69 67 6e 4d 61 6c 6c 6f 63 20  f( benignMalloc 
4790: 29 7b 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e  ){ sqlite3EndBen
47a0: 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 20 7d 0a 23  ignMalloc(); }.#
47b0: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41  ifdef SQLITE_ENA
47c0: 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47  BLE_MEMORY_MANAG
47d0: 45 4d 45 4e 54 0a 20 20 20 20 70 63 61 63 68 65  EMENT.    pcache
47e0: 31 45 6e 74 65 72 4d 75 74 65 78 28 70 43 61 63  1EnterMutex(pCac
47f0: 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 23 65 6e  he->pGroup);.#en
4800: 64 69 66 0a 20 20 20 20 69 66 28 20 70 50 67 3d  dif.    if( pPg=
4810: 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20  =0 ) return 0;. 
4820: 20 20 20 70 2d 3e 70 61 67 65 2e 70 42 75 66 20     p->page.pBuf 
4830: 3d 20 70 50 67 3b 0a 20 20 20 20 70 2d 3e 70 61  = pPg;.    p->pa
4840: 67 65 2e 70 45 78 74 72 61 20 3d 20 26 70 5b 31  ge.pExtra = &p[1
4850: 5d 3b 0a 20 20 20 20 70 2d 3e 69 73 42 75 6c 6b  ];.    p->isBulk
4860: 4c 6f 63 61 6c 20 3d 20 30 3b 0a 20 20 20 20 70  Local = 0;.    p
4870: 2d 3e 69 73 41 6e 63 68 6f 72 20 3d 20 30 3b 0a  ->isAnchor = 0;.
4880: 20 20 7d 0a 20 20 28 2a 70 43 61 63 68 65 2d 3e    }.  (*pCache->
4890: 70 6e 50 75 72 67 65 61 62 6c 65 29 2b 2b 3b 0a  pnPurgeable)++;.
48a0: 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 2f    return p;.}../
48b0: 2a 0a 2a 2a 20 46 72 65 65 20 61 20 70 61 67 65  *.** Free a page
48c0: 20 6f 62 6a 65 63 74 20 61 6c 6c 6f 63 61 74 65   object allocate
48d0: 64 20 62 79 20 70 63 61 63 68 65 31 41 6c 6c 6f  d by pcache1Allo
48e0: 63 50 61 67 65 28 29 2e 0a 2a 2f 0a 73 74 61 74  cPage()..*/.stat
48f0: 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 46  ic void pcache1F
4900: 72 65 65 50 61 67 65 28 50 67 48 64 72 31 20 2a  reePage(PgHdr1 *
4910: 70 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70  p){.  PCache1 *p
4920: 43 61 63 68 65 3b 0a 20 20 61 73 73 65 72 74 28  Cache;.  assert(
4930: 20 70 21 3d 30 20 29 3b 0a 20 20 70 43 61 63 68   p!=0 );.  pCach
4940: 65 20 3d 20 70 2d 3e 70 43 61 63 68 65 3b 0a 20  e = p->pCache;. 
4950: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
4960: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 70  _mutex_held(p->p
4970: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6d  Cache->pGroup->m
4980: 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 70  utex) );.  if( p
4990: 2d 3e 69 73 42 75 6c 6b 4c 6f 63 61 6c 20 29 7b  ->isBulkLocal ){
49a0: 0a 20 20 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20  .    p->pNext = 
49b0: 70 43 61 63 68 65 2d 3e 70 46 72 65 65 3b 0a 20  pCache->pFree;. 
49c0: 20 20 20 70 43 61 63 68 65 2d 3e 70 46 72 65 65     pCache->pFree
49d0: 20 3d 20 70 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20   = p;.  }else{. 
49e0: 20 20 20 70 63 61 63 68 65 31 46 72 65 65 28 70     pcache1Free(p
49f0: 2d 3e 70 61 67 65 2e 70 42 75 66 29 3b 0a 23 69  ->page.pBuf);.#i
4a00: 66 64 65 66 20 53 51 4c 49 54 45 5f 50 43 41 43  fdef SQLITE_PCAC
4a10: 48 45 5f 53 45 50 41 52 41 54 45 5f 48 45 41 44  HE_SEPARATE_HEAD
4a20: 45 52 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66  ER.    sqlite3_f
4a30: 72 65 65 28 70 29 3b 0a 23 65 6e 64 69 66 0a 20  ree(p);.#endif. 
4a40: 20 7d 0a 20 20 28 2a 70 43 61 63 68 65 2d 3e 70   }.  (*pCache->p
4a50: 6e 50 75 72 67 65 61 62 6c 65 29 2d 2d 3b 0a 7d  nPurgeable)--;.}
4a60: 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6c 6c 6f 63 20 66  ../*.** Malloc f
4a70: 75 6e 63 74 69 6f 6e 20 75 73 65 64 20 62 79 20  unction used by 
4a80: 53 51 4c 69 74 65 20 74 6f 20 6f 62 74 61 69 6e  SQLite to obtain
4a90: 20 73 70 61 63 65 20 66 72 6f 6d 20 74 68 65 20   space from the 
4aa0: 62 75 66 66 65 72 20 63 6f 6e 66 69 67 75 72 65  buffer configure
4ab0: 64 0a 2a 2a 20 75 73 69 6e 67 20 73 71 6c 69 74  d.** using sqlit
4ac0: 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54 45  e3_config(SQLITE
4ad0: 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48  _CONFIG_PAGECACH
4ae0: 45 29 20 6f 70 74 69 6f 6e 2e 20 49 66 20 6e 6f  E) option. If no
4af0: 20 73 75 63 68 20 62 75 66 66 65 72 0a 2a 2a 20   such buffer.** 
4b00: 65 78 69 73 74 73 2c 20 74 68 69 73 20 66 75 6e  exists, this fun
4b10: 63 74 69 6f 6e 20 66 61 6c 6c 73 20 62 61 63 6b  ction falls back
4b20: 20 74 6f 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f   to sqlite3Mallo
4b30: 63 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71  c()..*/.void *sq
4b40: 6c 69 74 65 33 50 61 67 65 4d 61 6c 6c 6f 63 28  lite3PageMalloc(
4b50: 69 6e 74 20 73 7a 29 7b 0a 20 20 61 73 73 65 72  int sz){.  asser
4b60: 74 28 20 73 7a 3c 3d 36 35 35 33 36 2b 38 20 29  t( sz<=65536+8 )
4b70: 3b 20 2f 2a 20 54 68 65 73 65 20 61 6c 6c 6f 63  ; /* These alloc
4b80: 61 74 69 6f 6e 73 20 61 72 65 20 6e 65 76 65 72  ations are never
4b90: 20 76 65 72 79 20 6c 61 72 67 65 20 2a 2f 0a 20   very large */. 
4ba0: 20 72 65 74 75 72 6e 20 70 63 61 63 68 65 31 41   return pcache1A
4bb0: 6c 6c 6f 63 28 73 7a 29 3b 0a 7d 0a 0a 2f 2a 0a  lloc(sz);.}../*.
4bc0: 2a 2a 20 46 72 65 65 20 61 6e 20 61 6c 6c 6f 63  ** Free an alloc
4bd0: 61 74 65 64 20 62 75 66 66 65 72 20 6f 62 74 61  ated buffer obta
4be0: 69 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 65  ined from sqlite
4bf0: 33 50 61 67 65 4d 61 6c 6c 6f 63 28 29 2e 0a 2a  3PageMalloc()..*
4c00: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61  /.void sqlite3Pa
4c10: 67 65 46 72 65 65 28 76 6f 69 64 20 2a 70 29 7b  geFree(void *p){
4c20: 0a 20 20 70 63 61 63 68 65 31 46 72 65 65 28 70  .  pcache1Free(p
4c30: 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 74  );.}.../*.** Ret
4c40: 75 72 6e 20 74 72 75 65 20 69 66 20 69 74 20 64  urn true if it d
4c50: 65 73 69 72 61 62 6c 65 20 74 6f 20 61 76 6f 69  esirable to avoi
4c60: 64 20 61 6c 6c 6f 63 61 74 69 6e 67 20 61 20 6e  d allocating a n
4c70: 65 77 20 70 61 67 65 20 63 61 63 68 65 0a 2a 2a  ew page cache.**
4c80: 20 65 6e 74 72 79 2e 0a 2a 2a 0a 2a 2a 20 49 66   entry..**.** If
4c90: 20 6d 65 6d 6f 72 79 20 77 61 73 20 61 6c 6c 6f   memory was allo
4ca0: 63 61 74 65 64 20 73 70 65 63 69 66 69 63 61 6c  cated specifical
4cb0: 6c 79 20 74 6f 20 74 68 65 20 70 61 67 65 20 63  ly to the page c
4cc0: 61 63 68 65 20 75 73 69 6e 67 0a 2a 2a 20 53 51  ache using.** SQ
4cd0: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45  LITE_CONFIG_PAGE
4ce0: 43 41 43 48 45 20 62 75 74 20 74 68 61 74 20 6d  CACHE but that m
4cf0: 65 6d 6f 72 79 20 68 61 73 20 61 6c 6c 20 62 65  emory has all be
4d00: 65 6e 20 75 73 65 64 2c 20 74 68 65 6e 0a 2a 2a  en used, then.**
4d10: 20 69 74 20 69 73 20 64 65 73 69 72 61 62 6c 65   it is desirable
4d20: 20 74 6f 20 61 76 6f 69 64 20 61 6c 6c 6f 63 61   to avoid alloca
4d30: 74 69 6e 67 20 61 20 6e 65 77 20 70 61 67 65 20  ting a new page 
4d40: 63 61 63 68 65 20 65 6e 74 72 79 20 62 65 63 61  cache entry beca
4d50: 75 73 65 0a 2a 2a 20 70 72 65 73 75 6d 61 62 6c  use.** presumabl
4d60: 79 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f  y SQLITE_CONFIG_
4d70: 50 41 47 45 43 41 43 48 45 20 77 61 73 20 73 75  PAGECACHE was su
4d80: 70 70 6f 73 65 20 74 6f 20 62 65 20 73 75 66 66  ppose to be suff
4d90: 69 63 69 65 6e 74 0a 2a 2a 20 66 6f 72 20 61 6c  icient.** for al
4da0: 6c 20 70 61 67 65 20 63 61 63 68 65 20 6e 65 65  l page cache nee
4db0: 64 73 20 61 6e 64 20 77 65 20 73 68 6f 75 6c 64  ds and we should
4dc0: 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 73 70 69   not need to spi
4dd0: 6c 6c 20 74 68 65 0a 2a 2a 20 61 6c 6c 6f 63 61  ll the.** alloca
4de0: 74 69 6f 6e 20 6f 6e 74 6f 20 74 68 65 20 68 65  tion onto the he
4df0: 61 70 2e 0a 2a 2a 0a 2a 2a 20 4f 72 2c 20 74 68  ap..**.** Or, th
4e00: 65 20 68 65 61 70 20 69 73 20 75 73 65 64 20 66  e heap is used f
4e10: 6f 72 20 61 6c 6c 20 70 61 67 65 20 63 61 63 68  or all page cach
4e20: 65 20 6d 65 6d 6f 72 79 20 62 75 74 20 74 68 65  e memory but the
4e30: 20 68 65 61 70 20 69 73 0a 2a 2a 20 75 6e 64 65   heap is.** unde
4e40: 72 20 6d 65 6d 6f 72 79 20 70 72 65 73 73 75 72  r memory pressur
4e50: 65 2c 20 74 68 65 6e 20 61 67 61 69 6e 20 69 74  e, then again it
4e60: 20 69 73 20 64 65 73 69 72 61 62 6c 65 20 74 6f   is desirable to
4e70: 20 61 76 6f 69 64 0a 2a 2a 20 61 6c 6c 6f 63 61   avoid.** alloca
4e80: 74 69 6e 67 20 61 20 6e 65 77 20 70 61 67 65 20  ting a new page 
4e90: 63 61 63 68 65 20 65 6e 74 72 79 20 69 6e 20 6f  cache entry in o
4ea0: 72 64 65 72 20 74 6f 20 61 76 6f 69 64 20 73 74  rder to avoid st
4eb0: 72 65 73 73 69 6e 67 0a 2a 2a 20 74 68 65 20 68  ressing.** the h
4ec0: 65 61 70 20 65 76 65 6e 20 66 75 72 74 68 65 72  eap even further
4ed0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
4ee0: 70 63 61 63 68 65 31 55 6e 64 65 72 4d 65 6d 6f  pcache1UnderMemo
4ef0: 72 79 50 72 65 73 73 75 72 65 28 50 43 61 63 68  ryPressure(PCach
4f00: 65 31 20 2a 70 43 61 63 68 65 29 7b 0a 20 20 69  e1 *pCache){.  i
4f10: 66 28 20 70 63 61 63 68 65 31 2e 6e 53 6c 6f 74  f( pcache1.nSlot
4f20: 20 26 26 20 28 70 43 61 63 68 65 2d 3e 73 7a 50   && (pCache->szP
4f30: 61 67 65 2b 70 43 61 63 68 65 2d 3e 73 7a 45 78  age+pCache->szEx
4f40: 74 72 61 29 3c 3d 70 63 61 63 68 65 31 2e 73 7a  tra)<=pcache1.sz
4f50: 53 6c 6f 74 20 29 7b 0a 20 20 20 20 72 65 74 75  Slot ){.    retu
4f60: 72 6e 20 70 63 61 63 68 65 31 2e 62 55 6e 64 65  rn pcache1.bUnde
4f70: 72 50 72 65 73 73 75 72 65 3b 0a 20 20 7d 65 6c  rPressure;.  }el
4f80: 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 73  se{.    return s
4f90: 71 6c 69 74 65 33 48 65 61 70 4e 65 61 72 6c 79  qlite3HeapNearly
4fa0: 46 75 6c 6c 28 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f  Full();.  }.}../
4fb0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4fc0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4fd0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4fe0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4ff0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a  **************/.
5000: 2f 2a 2a 2a 2a 2a 2a 2a 2a 20 47 65 6e 65 72 61  /******** Genera
5010: 6c 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  l Implementation
5020: 20 46 75 6e 63 74 69 6f 6e 73 20 2a 2a 2a 2a 2a   Functions *****
5030: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5040: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f  ***************/
5050: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e  ../*.** This fun
5060: 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f  ction is used to
5070: 20 72 65 73 69 7a 65 20 74 68 65 20 68 61 73 68   resize the hash
5080: 20 74 61 62 6c 65 20 75 73 65 64 20 62 79 20 74   table used by t
5090: 68 65 20 63 61 63 68 65 20 70 61 73 73 65 64 0a  he cache passed.
50a0: 2a 2a 20 61 73 20 74 68 65 20 66 69 72 73 74 20  ** as the first 
50b0: 61 72 67 75 6d 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20  argument..**.** 
50c0: 54 68 65 20 50 43 61 63 68 65 20 6d 75 74 65 78  The PCache mutex
50d0: 20 6d 75 73 74 20 62 65 20 68 65 6c 64 20 77 68   must be held wh
50e0: 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e  en this function
50f0: 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73   is called..*/.s
5100: 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68  tatic void pcach
5110: 65 31 52 65 73 69 7a 65 48 61 73 68 28 50 43 61  e1ResizeHash(PCa
5120: 63 68 65 31 20 2a 70 29 7b 0a 20 20 50 67 48 64  che1 *p){.  PgHd
5130: 72 31 20 2a 2a 61 70 4e 65 77 3b 0a 20 20 75 6e  r1 **apNew;.  un
5140: 73 69 67 6e 65 64 20 69 6e 74 20 6e 4e 65 77 3b  signed int nNew;
5150: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
5160: 69 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71  i;..  assert( sq
5170: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64  lite3_mutex_held
5180: 28 70 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65  (p->pGroup->mute
5190: 78 29 20 29 3b 0a 0a 20 20 6e 4e 65 77 20 3d 20  x) );..  nNew = 
51a0: 70 2d 3e 6e 48 61 73 68 2a 32 3b 0a 20 20 69 66  p->nHash*2;.  if
51b0: 28 20 6e 4e 65 77 3c 32 35 36 20 29 7b 0a 20 20  ( nNew<256 ){.  
51c0: 20 20 6e 4e 65 77 20 3d 20 32 35 36 3b 0a 20 20    nNew = 256;.  
51d0: 7d 0a 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76  }..  pcache1Leav
51e0: 65 4d 75 74 65 78 28 70 2d 3e 70 47 72 6f 75 70  eMutex(p->pGroup
51f0: 29 3b 0a 20 20 69 66 28 20 70 2d 3e 6e 48 61 73  );.  if( p->nHas
5200: 68 20 29 7b 20 73 71 6c 69 74 65 33 42 65 67 69  h ){ sqlite3Begi
5210: 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b  nBenignMalloc();
5220: 20 7d 0a 20 20 61 70 4e 65 77 20 3d 20 28 50 67   }.  apNew = (Pg
5230: 48 64 72 31 20 2a 2a 29 73 71 6c 69 74 65 33 4d  Hdr1 **)sqlite3M
5240: 61 6c 6c 6f 63 5a 65 72 6f 28 73 69 7a 65 6f 66  allocZero(sizeof
5250: 28 50 67 48 64 72 31 20 2a 29 2a 6e 4e 65 77 29  (PgHdr1 *)*nNew)
5260: 3b 0a 20 20 69 66 28 20 70 2d 3e 6e 48 61 73 68  ;.  if( p->nHash
5270: 20 29 7b 20 73 71 6c 69 74 65 33 45 6e 64 42 65   ){ sqlite3EndBe
5280: 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 20 7d 0a  nignMalloc(); }.
5290: 20 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75    pcache1EnterMu
52a0: 74 65 78 28 70 2d 3e 70 47 72 6f 75 70 29 3b 0a  tex(p->pGroup);.
52b0: 20 20 69 66 28 20 61 70 4e 65 77 20 29 7b 0a 20    if( apNew ){. 
52c0: 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d     for(i=0; i<p-
52d0: 3e 6e 48 61 73 68 3b 20 69 2b 2b 29 7b 0a 20 20  >nHash; i++){.  
52e0: 20 20 20 20 50 67 48 64 72 31 20 2a 70 50 61 67      PgHdr1 *pPag
52f0: 65 3b 0a 20 20 20 20 20 20 50 67 48 64 72 31 20  e;.      PgHdr1 
5300: 2a 70 4e 65 78 74 20 3d 20 70 2d 3e 61 70 48 61  *pNext = p->apHa
5310: 73 68 5b 69 5d 3b 0a 20 20 20 20 20 20 77 68 69  sh[i];.      whi
5320: 6c 65 28 20 28 70 50 61 67 65 20 3d 20 70 4e 65  le( (pPage = pNe
5330: 78 74 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20  xt)!=0 ){.      
5340: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 68    unsigned int h
5350: 20 3d 20 70 50 61 67 65 2d 3e 69 4b 65 79 20 25   = pPage->iKey %
5360: 20 6e 4e 65 77 3b 0a 20 20 20 20 20 20 20 20 70   nNew;.        p
5370: 4e 65 78 74 20 3d 20 70 50 61 67 65 2d 3e 70 4e  Next = pPage->pN
5380: 65 78 74 3b 0a 20 20 20 20 20 20 20 20 70 50 61  ext;.        pPa
5390: 67 65 2d 3e 70 4e 65 78 74 20 3d 20 61 70 4e 65  ge->pNext = apNe
53a0: 77 5b 68 5d 3b 0a 20 20 20 20 20 20 20 20 61 70  w[h];.        ap
53b0: 4e 65 77 5b 68 5d 20 3d 20 70 50 61 67 65 3b 0a  New[h] = pPage;.
53c0: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20        }.    }.  
53d0: 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70    sqlite3_free(p
53e0: 2d 3e 61 70 48 61 73 68 29 3b 0a 20 20 20 20 70  ->apHash);.    p
53f0: 2d 3e 61 70 48 61 73 68 20 3d 20 61 70 4e 65 77  ->apHash = apNew
5400: 3b 0a 20 20 20 20 70 2d 3e 6e 48 61 73 68 20 3d  ;.    p->nHash =
5410: 20 6e 4e 65 77 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a   nNew;.  }.}../*
5420: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f  .** This functio
5430: 6e 20 69 73 20 75 73 65 64 20 69 6e 74 65 72 6e  n is used intern
5440: 61 6c 6c 79 20 74 6f 20 72 65 6d 6f 76 65 20 74  ally to remove t
5450: 68 65 20 70 61 67 65 20 70 50 61 67 65 20 66 72  he page pPage fr
5460: 6f 6d 20 74 68 65 20 0a 2a 2a 20 50 47 72 6f 75  om the .** PGrou
5470: 70 20 4c 52 55 20 6c 69 73 74 2c 20 69 66 20 69  p LRU list, if i
5480: 73 20 70 61 72 74 20 6f 66 20 69 74 2e 20 49 66  s part of it. If
5490: 20 70 50 61 67 65 20 69 73 20 6e 6f 74 20 70 61   pPage is not pa
54a0: 72 74 20 6f 66 20 74 68 65 20 50 47 72 6f 75 70  rt of the PGroup
54b0: 0a 2a 2a 20 4c 52 55 20 6c 69 73 74 2c 20 74 68  .** LRU list, th
54c0: 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e  en this function
54d0: 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a   is a no-op..**.
54e0: 2a 2a 20 54 68 65 20 50 47 72 6f 75 70 20 6d 75  ** The PGroup mu
54f0: 74 65 78 20 6d 75 73 74 20 62 65 20 68 65 6c 64  tex must be held
5500: 20 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74   when this funct
5510: 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a  ion is called..*
5520: 2f 0a 73 74 61 74 69 63 20 50 67 48 64 72 31 20  /.static PgHdr1 
5530: 2a 70 63 61 63 68 65 31 50 69 6e 50 61 67 65 28  *pcache1PinPage(
5540: 50 67 48 64 72 31 20 2a 70 50 61 67 65 29 7b 0a  PgHdr1 *pPage){.
5550: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 21    assert( pPage!
5560: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  =0 );.  assert( 
5570: 50 41 47 45 5f 49 53 5f 55 4e 50 49 4e 4e 45 44  PAGE_IS_UNPINNED
5580: 28 70 50 61 67 65 29 20 29 3b 0a 20 20 61 73 73  (pPage) );.  ass
5590: 65 72 74 28 20 70 50 61 67 65 2d 3e 70 4c 72 75  ert( pPage->pLru
55a0: 4e 65 78 74 20 29 3b 0a 20 20 61 73 73 65 72 74  Next );.  assert
55b0: 28 20 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 65  ( pPage->pLruPre
55c0: 76 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73  v );.  assert( s
55d0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c  qlite3_mutex_hel
55e0: 64 28 70 50 61 67 65 2d 3e 70 43 61 63 68 65 2d  d(pPage->pCache-
55f0: 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20  >pGroup->mutex) 
5600: 29 3b 0a 20 20 70 50 61 67 65 2d 3e 70 4c 72 75  );.  pPage->pLru
5610: 50 72 65 76 2d 3e 70 4c 72 75 4e 65 78 74 20 3d  Prev->pLruNext =
5620: 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74   pPage->pLruNext
5630: 3b 0a 20 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e  ;.  pPage->pLruN
5640: 65 78 74 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20  ext->pLruPrev = 
5650: 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 3b  pPage->pLruPrev;
5660: 0a 20 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65  .  pPage->pLruNe
5670: 78 74 20 3d 20 30 3b 0a 20 20 2f 2a 20 70 50 61  xt = 0;.  /* pPa
5680: 67 65 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20 30  ge->pLruPrev = 0
5690: 3b 0a 20 20 2a 2a 20 4e 6f 20 6e 65 65 64 20 74  ;.  ** No need t
56a0: 6f 20 63 6c 65 61 72 20 70 4c 72 75 50 72 65 76  o clear pLruPrev
56b0: 20 61 73 20 69 74 20 69 73 20 6e 65 76 65 72 20   as it is never 
56c0: 61 63 63 65 73 73 65 64 20 69 66 20 70 4c 72 75  accessed if pLru
56d0: 4e 65 78 74 20 69 73 20 30 20 2a 2f 0a 20 20 61  Next is 0 */.  a
56e0: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 69 73  ssert( pPage->is
56f0: 41 6e 63 68 6f 72 3d 3d 30 20 29 3b 0a 20 20 61  Anchor==0 );.  a
5700: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 43  ssert( pPage->pC
5710: 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6c 72  ache->pGroup->lr
5720: 75 2e 69 73 41 6e 63 68 6f 72 3d 3d 31 20 29 3b  u.isAnchor==1 );
5730: 0a 20 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65  .  pPage->pCache
5740: 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65 2d 2d 3b  ->nRecyclable--;
5750: 0a 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 3b  .  return pPage;
5760: 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 6d 6f 76  .}.../*.** Remov
5770: 65 20 74 68 65 20 70 61 67 65 20 73 75 70 70 6c  e the page suppl
5780: 69 65 64 20 61 73 20 61 6e 20 61 72 67 75 6d 65  ied as an argume
5790: 6e 74 20 66 72 6f 6d 20 74 68 65 20 68 61 73 68  nt from the hash
57a0: 20 74 61 62 6c 65 20 0a 2a 2a 20 28 50 43 61 63   table .** (PCac
57b0: 68 65 31 2e 61 70 48 61 73 68 20 73 74 72 75 63  he1.apHash struc
57c0: 74 75 72 65 29 20 74 68 61 74 20 69 74 20 69 73  ture) that it is
57d0: 20 63 75 72 72 65 6e 74 6c 79 20 73 74 6f 72 65   currently store
57e0: 64 20 69 6e 2e 0a 2a 2a 20 41 6c 73 6f 20 66 72  d in..** Also fr
57f0: 65 65 20 74 68 65 20 70 61 67 65 20 69 66 20 66  ee the page if f
5800: 72 65 65 50 61 67 65 20 69 73 20 74 72 75 65 2e  reePage is true.
5810: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50 47 72 6f 75  .**.** The PGrou
5820: 70 20 6d 75 74 65 78 20 6d 75 73 74 20 62 65 20  p mutex must be 
5830: 68 65 6c 64 20 77 68 65 6e 20 74 68 69 73 20 66  held when this f
5840: 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65  unction is calle
5850: 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  d..*/.static voi
5860: 64 20 70 63 61 63 68 65 31 52 65 6d 6f 76 65 46  d pcache1RemoveF
5870: 72 6f 6d 48 61 73 68 28 50 67 48 64 72 31 20 2a  romHash(PgHdr1 *
5880: 70 50 61 67 65 2c 20 69 6e 74 20 66 72 65 65 46  pPage, int freeF
5890: 6c 61 67 29 7b 0a 20 20 75 6e 73 69 67 6e 65 64  lag){.  unsigned
58a0: 20 69 6e 74 20 68 3b 0a 20 20 50 43 61 63 68 65   int h;.  PCache
58b0: 31 20 2a 70 43 61 63 68 65 20 3d 20 70 50 61 67  1 *pCache = pPag
58c0: 65 2d 3e 70 43 61 63 68 65 3b 0a 20 20 50 67 48  e->pCache;.  PgH
58d0: 64 72 31 20 2a 2a 70 70 3b 0a 0a 20 20 61 73 73  dr1 **pp;..  ass
58e0: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74  ert( sqlite3_mut
58f0: 65 78 5f 68 65 6c 64 28 70 43 61 63 68 65 2d 3e  ex_held(pCache->
5900: 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29  pGroup->mutex) )
5910: 3b 0a 20 20 68 20 3d 20 70 50 61 67 65 2d 3e 69  ;.  h = pPage->i
5920: 4b 65 79 20 25 20 70 43 61 63 68 65 2d 3e 6e 48  Key % pCache->nH
5930: 61 73 68 3b 0a 20 20 66 6f 72 28 70 70 3d 26 70  ash;.  for(pp=&p
5940: 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d  Cache->apHash[h]
5950: 3b 20 28 2a 70 70 29 21 3d 70 50 61 67 65 3b 20  ; (*pp)!=pPage; 
5960: 70 70 3d 26 28 2a 70 70 29 2d 3e 70 4e 65 78 74  pp=&(*pp)->pNext
5970: 29 3b 0a 20 20 2a 70 70 20 3d 20 28 2a 70 70 29  );.  *pp = (*pp)
5980: 2d 3e 70 4e 65 78 74 3b 0a 0a 20 20 70 43 61 63  ->pNext;..  pCac
5990: 68 65 2d 3e 6e 50 61 67 65 2d 2d 3b 0a 20 20 69  he->nPage--;.  i
59a0: 66 28 20 66 72 65 65 46 6c 61 67 20 29 20 70 63  f( freeFlag ) pc
59b0: 61 63 68 65 31 46 72 65 65 50 61 67 65 28 70 50  ache1FreePage(pP
59c0: 61 67 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49  age);.}../*.** I
59d0: 66 20 74 68 65 72 65 20 61 72 65 20 63 75 72 72  f there are curr
59e0: 65 6e 74 6c 79 20 6d 6f 72 65 20 74 68 61 6e 20  ently more than 
59f0: 6e 4d 61 78 50 61 67 65 20 70 61 67 65 73 20 61  nMaxPage pages a
5a00: 6c 6c 6f 63 61 74 65 64 2c 20 74 72 79 0a 2a 2a  llocated, try.**
5a10: 20 74 6f 20 72 65 63 79 63 6c 65 20 70 61 67 65   to recycle page
5a20: 73 20 74 6f 20 72 65 64 75 63 65 20 74 68 65 20  s to reduce the 
5a30: 6e 75 6d 62 65 72 20 61 6c 6c 6f 63 61 74 65 64  number allocated
5a40: 20 74 6f 20 6e 4d 61 78 50 61 67 65 2e 0a 2a 2f   to nMaxPage..*/
5a50: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61  .static void pca
5a60: 63 68 65 31 45 6e 66 6f 72 63 65 4d 61 78 50 61  che1EnforceMaxPa
5a70: 67 65 28 50 43 61 63 68 65 31 20 2a 70 43 61 63  ge(PCache1 *pCac
5a80: 68 65 29 7b 0a 20 20 50 47 72 6f 75 70 20 2a 70  he){.  PGroup *p
5a90: 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65 2d 3e  Group = pCache->
5aa0: 70 47 72 6f 75 70 3b 0a 20 20 50 67 48 64 72 31  pGroup;.  PgHdr1
5ab0: 20 2a 70 3b 0a 20 20 61 73 73 65 72 74 28 20 73   *p;.  assert( s
5ac0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c  qlite3_mutex_hel
5ad0: 64 28 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29  d(pGroup->mutex)
5ae0: 20 29 3b 0a 20 20 77 68 69 6c 65 28 20 70 47 72   );.  while( pGr
5af0: 6f 75 70 2d 3e 6e 50 75 72 67 65 61 62 6c 65 3e  oup->nPurgeable>
5b00: 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65  pGroup->nMaxPage
5b10: 0a 20 20 20 20 20 20 26 26 20 28 70 3d 70 47 72  .      && (p=pGr
5b20: 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72 75 50 72 65  oup->lru.pLruPre
5b30: 76 29 2d 3e 69 73 41 6e 63 68 6f 72 3d 3d 30 0a  v)->isAnchor==0.
5b40: 20 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28    ){.    assert(
5b50: 20 70 2d 3e 70 43 61 63 68 65 2d 3e 70 47 72 6f   p->pCache->pGro
5b60: 75 70 3d 3d 70 47 72 6f 75 70 20 29 3b 0a 20 20  up==pGroup );.  
5b70: 20 20 61 73 73 65 72 74 28 20 50 41 47 45 5f 49    assert( PAGE_I
5b80: 53 5f 55 4e 50 49 4e 4e 45 44 28 70 29 20 29 3b  S_UNPINNED(p) );
5b90: 0a 20 20 20 20 70 63 61 63 68 65 31 50 69 6e 50  .    pcache1PinP
5ba0: 61 67 65 28 70 29 3b 0a 20 20 20 20 70 63 61 63  age(p);.    pcac
5bb0: 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73  he1RemoveFromHas
5bc0: 68 28 70 2c 20 31 29 3b 0a 20 20 7d 0a 20 20 69  h(p, 1);.  }.  i
5bd0: 66 28 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65  f( pCache->nPage
5be0: 3d 3d 30 20 26 26 20 70 43 61 63 68 65 2d 3e 70  ==0 && pCache->p
5bf0: 42 75 6c 6b 20 29 7b 0a 20 20 20 20 73 71 6c 69  Bulk ){.    sqli
5c00: 74 65 33 5f 66 72 65 65 28 70 43 61 63 68 65 2d  te3_free(pCache-
5c10: 3e 70 42 75 6c 6b 29 3b 0a 20 20 20 20 70 43 61  >pBulk);.    pCa
5c20: 63 68 65 2d 3e 70 42 75 6c 6b 20 3d 20 70 43 61  che->pBulk = pCa
5c30: 63 68 65 2d 3e 70 46 72 65 65 20 3d 20 30 3b 0a  che->pFree = 0;.
5c40: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 69 73    }.}../*.** Dis
5c50: 63 61 72 64 20 61 6c 6c 20 70 61 67 65 73 20 66  card all pages f
5c60: 72 6f 6d 20 63 61 63 68 65 20 70 43 61 63 68 65  rom cache pCache
5c70: 20 77 69 74 68 20 61 20 70 61 67 65 20 6e 75 6d   with a page num
5c80: 62 65 72 20 28 6b 65 79 20 76 61 6c 75 65 29 20  ber (key value) 
5c90: 0a 2a 2a 20 67 72 65 61 74 65 72 20 74 68 61 6e  .** greater than
5ca0: 20 6f 72 20 65 71 75 61 6c 20 74 6f 20 69 4c 69   or equal to iLi
5cb0: 6d 69 74 2e 20 41 6e 79 20 70 69 6e 6e 65 64 20  mit. Any pinned 
5cc0: 70 61 67 65 73 20 74 68 61 74 20 6d 65 65 74 20  pages that meet 
5cd0: 74 68 69 73 20 0a 2a 2a 20 63 72 69 74 65 72 69  this .** criteri
5ce0: 61 20 61 72 65 20 75 6e 70 69 6e 6e 65 64 20 62  a are unpinned b
5cf0: 65 66 6f 72 65 20 74 68 65 79 20 61 72 65 20 64  efore they are d
5d00: 69 73 63 61 72 64 65 64 2e 0a 2a 2a 0a 2a 2a 20  iscarded..**.** 
5d10: 54 68 65 20 50 43 61 63 68 65 20 6d 75 74 65 78  The PCache mutex
5d20: 20 6d 75 73 74 20 62 65 20 68 65 6c 64 20 77 68   must be held wh
5d30: 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e  en this function
5d40: 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73   is called..*/.s
5d50: 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68  tatic void pcach
5d60: 65 31 54 72 75 6e 63 61 74 65 55 6e 73 61 66 65  e1TruncateUnsafe
5d70: 28 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61  (.  PCache1 *pCa
5d80: 63 68 65 2c 20 20 20 20 20 20 20 20 20 20 20 20  che,            
5d90: 20 2f 2a 20 54 68 65 20 63 61 63 68 65 20 74 6f   /* The cache to
5da0: 20 74 72 75 6e 63 61 74 65 20 2a 2f 0a 20 20 75   truncate */.  u
5db0: 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4c 69 6d  nsigned int iLim
5dc0: 69 74 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44  it          /* D
5dd0: 72 6f 70 20 70 61 67 65 73 20 77 69 74 68 20 74  rop pages with t
5de0: 68 69 73 20 70 67 6e 6f 20 6f 72 20 6c 61 72 67  his pgno or larg
5df0: 65 72 20 2a 2f 0a 29 7b 0a 20 20 54 45 53 54 4f  er */.){.  TESTO
5e00: 4e 4c 59 28 20 69 6e 74 20 6e 50 61 67 65 20 3d  NLY( int nPage =
5e10: 20 30 3b 20 29 20 20 2f 2a 20 54 6f 20 61 73 73   0; )  /* To ass
5e20: 65 72 74 20 70 43 61 63 68 65 2d 3e 6e 50 61 67  ert pCache->nPag
5e30: 65 20 69 73 20 63 6f 72 72 65 63 74 20 2a 2f 0a  e is correct */.
5e40: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 68    unsigned int h
5e50: 2c 20 69 53 74 6f 70 3b 0a 20 20 61 73 73 65 72  , iStop;.  asser
5e60: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  t( sqlite3_mutex
5e70: 5f 68 65 6c 64 28 70 43 61 63 68 65 2d 3e 70 47  _held(pCache->pG
5e80: 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a  roup->mutex) );.
5e90: 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65    assert( pCache
5ea0: 2d 3e 69 4d 61 78 4b 65 79 20 3e 3d 20 69 4c 69  ->iMaxKey >= iLi
5eb0: 6d 69 74 20 29 3b 0a 20 20 61 73 73 65 72 74 28  mit );.  assert(
5ec0: 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 20 3e   pCache->nHash >
5ed0: 20 30 20 29 3b 0a 20 20 69 66 28 20 70 43 61 63   0 );.  if( pCac
5ee0: 68 65 2d 3e 69 4d 61 78 4b 65 79 20 2d 20 69 4c  he->iMaxKey - iL
5ef0: 69 6d 69 74 20 3c 20 70 43 61 63 68 65 2d 3e 6e  imit < pCache->n
5f00: 48 61 73 68 20 29 7b 0a 20 20 20 20 2f 2a 20 49  Hash ){.    /* I
5f10: 66 20 77 65 20 61 72 65 20 6a 75 73 74 20 73 68  f we are just sh
5f20: 61 76 69 6e 67 20 74 68 65 20 6c 61 73 74 20 66  aving the last f
5f30: 65 77 20 70 61 67 65 73 20 6f 66 66 20 74 68 65  ew pages off the
5f40: 20 65 6e 64 20 6f 66 20 74 68 65 0a 20 20 20 20   end of the.    
5f50: 2a 2a 20 63 61 63 68 65 2c 20 74 68 65 6e 20 74  ** cache, then t
5f60: 68 65 72 65 20 69 73 20 6e 6f 20 70 6f 69 6e 74  here is no point
5f70: 20 69 6e 20 73 63 61 6e 6e 69 6e 67 20 74 68 65   in scanning the
5f80: 20 65 6e 74 69 72 65 20 68 61 73 68 20 74 61 62   entire hash tab
5f90: 6c 65 2e 0a 20 20 20 20 2a 2a 20 4f 6e 6c 79 20  le..    ** Only 
5fa0: 73 63 61 6e 20 74 68 6f 73 65 20 68 61 73 68 20  scan those hash 
5fb0: 73 6c 6f 74 73 20 74 68 61 74 20 6d 69 67 68 74  slots that might
5fc0: 20 63 6f 6e 74 61 69 6e 20 70 61 67 65 73 20 74   contain pages t
5fd0: 68 61 74 20 6e 65 65 64 20 74 6f 0a 20 20 20 20  hat need to.    
5fe0: 2a 2a 20 62 65 20 72 65 6d 6f 76 65 64 2e 20 2a  ** be removed. *
5ff0: 2f 0a 20 20 20 20 68 20 3d 20 69 4c 69 6d 69 74  /.    h = iLimit
6000: 20 25 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68   % pCache->nHash
6010: 3b 0a 20 20 20 20 69 53 74 6f 70 20 3d 20 70 43  ;.    iStop = pC
6020: 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 25 20  ache->iMaxKey % 
6030: 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20  pCache->nHash;. 
6040: 20 20 20 54 45 53 54 4f 4e 4c 59 28 20 6e 50 61     TESTONLY( nPa
6050: 67 65 20 3d 20 2d 31 30 3b 20 29 20 20 2f 2a 20  ge = -10; )  /* 
6060: 44 69 73 61 62 6c 65 20 74 68 65 20 70 43 61 63  Disable the pCac
6070: 68 65 2d 3e 6e 50 61 67 65 20 76 61 6c 69 64 69  he->nPage validi
6080: 74 79 20 63 68 65 63 6b 20 2a 2f 0a 20 20 7d 65  ty check */.  }e
6090: 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 54 68 69 73  lse{.    /* This
60a0: 20 69 73 20 74 68 65 20 67 65 6e 65 72 61 6c 20   is the general 
60b0: 63 61 73 65 20 77 68 65 72 65 20 6d 61 6e 79 20  case where many 
60c0: 70 61 67 65 73 20 61 72 65 20 62 65 69 6e 67 20  pages are being 
60d0: 72 65 6d 6f 76 65 64 2e 0a 20 20 20 20 2a 2a 20  removed..    ** 
60e0: 49 74 20 69 73 20 6e 65 63 65 73 73 61 72 79 20  It is necessary 
60f0: 74 6f 20 73 63 61 6e 20 74 68 65 20 65 6e 74 69  to scan the enti
6100: 72 65 20 68 61 73 68 20 74 61 62 6c 65 20 2a 2f  re hash table */
6110: 0a 20 20 20 20 68 20 3d 20 70 43 61 63 68 65 2d  .    h = pCache-
6120: 3e 6e 48 61 73 68 2f 32 3b 0a 20 20 20 20 69 53  >nHash/2;.    iS
6130: 74 6f 70 20 3d 20 68 20 2d 20 31 3b 0a 20 20 7d  top = h - 1;.  }
6140: 0a 20 20 66 6f 72 28 3b 3b 29 7b 0a 20 20 20 20  .  for(;;){.    
6150: 50 67 48 64 72 31 20 2a 2a 70 70 3b 0a 20 20 20  PgHdr1 **pp;.   
6160: 20 50 67 48 64 72 31 20 2a 70 50 61 67 65 3b 0a   PgHdr1 *pPage;.
6170: 20 20 20 20 61 73 73 65 72 74 28 20 68 3c 70 43      assert( h<pC
6180: 61 63 68 65 2d 3e 6e 48 61 73 68 20 29 3b 0a 20  ache->nHash );. 
6190: 20 20 20 70 70 20 3d 20 26 70 43 61 63 68 65 2d     pp = &pCache-
61a0: 3e 61 70 48 61 73 68 5b 68 5d 3b 20 0a 20 20 20  >apHash[h]; .   
61b0: 20 77 68 69 6c 65 28 20 28 70 50 61 67 65 20 3d   while( (pPage =
61c0: 20 2a 70 70 29 21 3d 30 20 29 7b 0a 20 20 20 20   *pp)!=0 ){.    
61d0: 20 20 69 66 28 20 70 50 61 67 65 2d 3e 69 4b 65    if( pPage->iKe
61e0: 79 3e 3d 69 4c 69 6d 69 74 20 29 7b 0a 20 20 20  y>=iLimit ){.   
61f0: 20 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 50 61       pCache->nPa
6200: 67 65 2d 2d 3b 0a 20 20 20 20 20 20 20 20 2a 70  ge--;.        *p
6210: 70 20 3d 20 70 50 61 67 65 2d 3e 70 4e 65 78 74  p = pPage->pNext
6220: 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 50 41  ;.        if( PA
6230: 47 45 5f 49 53 5f 55 4e 50 49 4e 4e 45 44 28 70  GE_IS_UNPINNED(p
6240: 50 61 67 65 29 20 29 20 70 63 61 63 68 65 31 50  Page) ) pcache1P
6250: 69 6e 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20  inPage(pPage);. 
6260: 20 20 20 20 20 20 20 70 63 61 63 68 65 31 46 72         pcache1Fr
6270: 65 65 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20  eePage(pPage);. 
6280: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20       }else{.    
6290: 20 20 20 20 70 70 20 3d 20 26 70 50 61 67 65 2d      pp = &pPage-
62a0: 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 20 20  >pNext;.        
62b0: 54 45 53 54 4f 4e 4c 59 28 20 69 66 28 20 6e 50  TESTONLY( if( nP
62c0: 61 67 65 3e 3d 30 20 29 20 6e 50 61 67 65 2b 2b  age>=0 ) nPage++
62d0: 3b 20 29 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  ; ).      }.    
62e0: 7d 0a 20 20 20 20 69 66 28 20 68 3d 3d 69 53 74  }.    if( h==iSt
62f0: 6f 70 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20  op ) break;.    
6300: 68 20 3d 20 28 68 2b 31 29 20 25 20 70 43 61 63  h = (h+1) % pCac
6310: 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 7d 0a 20  he->nHash;.  }. 
6320: 20 61 73 73 65 72 74 28 20 6e 50 61 67 65 3c 30   assert( nPage<0
6330: 20 7c 7c 20 70 43 61 63 68 65 2d 3e 6e 50 61 67   || pCache->nPag
6340: 65 3d 3d 28 75 6e 73 69 67 6e 65 64 29 6e 50 61  e==(unsigned)nPa
6350: 67 65 20 29 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a  ge );.}../******
6360: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
6370: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
6380: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
6390: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
63a0: 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 2f 2a 2a 2a 2a 2a  ********/./*****
63b0: 2a 2a 2a 20 73 71 6c 69 74 65 33 5f 70 63 61 63  *** sqlite3_pcac
63c0: 68 65 20 4d 65 74 68 6f 64 73 20 2a 2a 2a 2a 2a  he Methods *****
63d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
63e0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
63f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 0a 2a  *********/../*.*
6400: 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  * Implementation
6410: 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f   of the sqlite3_
6420: 70 63 61 63 68 65 2e 78 49 6e 69 74 20 6d 65 74  pcache.xInit met
6430: 68 6f 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  hod..*/.static i
6440: 6e 74 20 70 63 61 63 68 65 31 49 6e 69 74 28 76  nt pcache1Init(v
6450: 6f 69 64 20 2a 4e 6f 74 55 73 65 64 29 7b 0a 20  oid *NotUsed){. 
6460: 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45   UNUSED_PARAMETE
6470: 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 61 73  R(NotUsed);.  as
6480: 73 65 72 74 28 20 70 63 61 63 68 65 31 2e 69 73  sert( pcache1.is
6490: 49 6e 69 74 3d 3d 30 20 29 3b 0a 20 20 6d 65 6d  Init==0 );.  mem
64a0: 73 65 74 28 26 70 63 61 63 68 65 31 2c 20 30 2c  set(&pcache1, 0,
64b0: 20 73 69 7a 65 6f 66 28 70 63 61 63 68 65 31 29   sizeof(pcache1)
64c0: 29 3b 0a 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54  );...  /*.  ** T
64d0: 68 65 20 70 63 61 63 68 65 31 2e 73 65 70 61 72  he pcache1.separ
64e0: 61 74 65 43 61 63 68 65 20 76 61 72 69 61 62 6c  ateCache variabl
64f0: 65 20 69 73 20 74 72 75 65 20 69 66 20 65 61 63  e is true if eac
6500: 68 20 50 43 61 63 68 65 20 68 61 73 20 69 74 73  h PCache has its
6510: 20 6f 77 6e 0a 20 20 2a 2a 20 70 72 69 76 61 74   own.  ** privat
6520: 65 20 50 47 72 6f 75 70 20 28 6d 6f 64 65 2d 31  e PGroup (mode-1
6530: 29 2e 20 20 70 63 61 63 68 65 31 2e 73 65 70 61  ).  pcache1.sepa
6540: 72 61 74 65 43 61 63 68 65 20 69 73 20 66 61 6c  rateCache is fal
6550: 73 65 20 69 66 20 74 68 65 20 73 69 6e 67 6c 65  se if the single
6560: 0a 20 20 2a 2a 20 50 47 72 6f 75 70 20 69 6e 20  .  ** PGroup in 
6570: 70 63 61 63 68 65 31 2e 67 72 70 20 69 73 20 75  pcache1.grp is u
6580: 73 65 64 20 66 6f 72 20 61 6c 6c 20 70 61 67 65  sed for all page
6590: 20 63 61 63 68 65 73 20 28 6d 6f 64 65 2d 32 29   caches (mode-2)
65a0: 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20  ..  **.  **   * 
65b0: 20 41 6c 77 61 79 73 20 75 73 65 20 61 20 75 6e   Always use a un
65c0: 69 66 69 65 64 20 63 61 63 68 65 20 28 6d 6f 64  ified cache (mod
65d0: 65 2d 32 29 20 69 66 20 45 4e 41 42 4c 45 5f 4d  e-2) if ENABLE_M
65e0: 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54  EMORY_MANAGEMENT
65f0: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 20  .  **.  **   *  
6600: 55 73 65 20 61 20 75 6e 69 66 69 65 64 20 63 61  Use a unified ca
6610: 63 68 65 20 69 6e 20 73 69 6e 67 6c 65 2d 74 68  che in single-th
6620: 72 65 61 64 65 64 20 61 70 70 6c 69 63 61 74 69  readed applicati
6630: 6f 6e 73 20 74 68 61 74 20 68 61 76 65 0a 20 20  ons that have.  
6640: 2a 2a 20 20 20 20 20 20 63 6f 6e 66 69 67 75 72  **      configur
6650: 65 64 20 61 20 73 74 61 72 74 2d 74 69 6d 65 20  ed a start-time 
6660: 62 75 66 66 65 72 20 66 6f 72 20 75 73 65 20 61  buffer for use a
6670: 73 20 70 61 67 65 2d 63 61 63 68 65 20 6d 65 6d  s page-cache mem
6680: 6f 72 79 20 75 73 69 6e 67 0a 20 20 2a 2a 20 20  ory using.  **  
6690: 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66      sqlite3_conf
66a0: 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47  ig(SQLITE_CONFIG
66b0: 5f 50 41 47 45 43 41 43 48 45 2c 20 70 42 75 66  _PAGECACHE, pBuf
66c0: 2c 20 73 7a 2c 20 4e 29 20 77 69 74 68 20 6e 6f  , sz, N) with no
66d0: 6e 2d 4e 55 4c 4c 20 0a 20 20 2a 2a 20 20 20 20  n-NULL .  **    
66e0: 20 20 70 42 75 66 20 61 72 67 75 6d 65 6e 74 2e    pBuf argument.
66f0: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 20  .  **.  **   *  
6700: 4f 74 68 65 72 77 69 73 65 20 75 73 65 20 73 65  Otherwise use se
6710: 70 61 72 61 74 65 20 63 61 63 68 65 73 20 28 6d  parate caches (m
6720: 6f 64 65 2d 31 29 0a 20 20 2a 2f 0a 23 69 66 20  ode-1).  */.#if 
6730: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45  defined(SQLITE_E
6740: 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e  NABLE_MEMORY_MAN
6750: 41 47 45 4d 45 4e 54 29 0a 20 20 70 63 61 63 68  AGEMENT).  pcach
6760: 65 31 2e 73 65 70 61 72 61 74 65 43 61 63 68 65  e1.separateCache
6770: 20 3d 20 30 3b 0a 23 65 6c 69 66 20 53 51 4c 49   = 0;.#elif SQLI
6780: 54 45 5f 54 48 52 45 41 44 53 41 46 45 0a 20 20  TE_THREADSAFE.  
6790: 70 63 61 63 68 65 31 2e 73 65 70 61 72 61 74 65  pcache1.separate
67a0: 43 61 63 68 65 20 3d 20 73 71 6c 69 74 65 33 47  Cache = sqlite3G
67b0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67  lobalConfig.pPag
67c0: 65 3d 3d 30 0a 20 20 20 20 20 20 20 20 20 20 20  e==0.           
67d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c                 |
67e0: 7c 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43  | sqlite3GlobalC
67f0: 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78  onfig.bCoreMutex
6800: 3e 30 3b 0a 23 65 6c 73 65 0a 20 20 70 63 61 63  >0;.#else.  pcac
6810: 68 65 31 2e 73 65 70 61 72 61 74 65 43 61 63 68  he1.separateCach
6820: 65 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61  e = sqlite3Globa
6830: 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65 3d 3d 30  lConfig.pPage==0
6840: 3b 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 53 51  ;.#endif..#if SQ
6850: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 0a  LITE_THREADSAFE.
6860: 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f    if( sqlite3Glo
6870: 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d  balConfig.bCoreM
6880: 75 74 65 78 20 29 7b 0a 20 20 20 20 70 63 61 63  utex ){.    pcac
6890: 68 65 31 2e 67 72 70 2e 6d 75 74 65 78 20 3d 20  he1.grp.mutex = 
68a0: 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f  sqlite3MutexAllo
68b0: 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53  c(SQLITE_MUTEX_S
68c0: 54 41 54 49 43 5f 4c 52 55 29 3b 0a 20 20 20 20  TATIC_LRU);.    
68d0: 70 63 61 63 68 65 31 2e 6d 75 74 65 78 20 3d 20  pcache1.mutex = 
68e0: 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f  sqlite3MutexAllo
68f0: 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53  c(SQLITE_MUTEX_S
6900: 54 41 54 49 43 5f 50 4d 45 4d 29 3b 0a 20 20 7d  TATIC_PMEM);.  }
6910: 0a 23 65 6e 64 69 66 0a 20 20 69 66 28 20 70 63  .#endif.  if( pc
6920: 61 63 68 65 31 2e 73 65 70 61 72 61 74 65 43 61  ache1.separateCa
6930: 63 68 65 0a 20 20 20 26 26 20 73 71 6c 69 74 65  che.   && sqlite
6940: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 50  3GlobalConfig.nP
6950: 61 67 65 21 3d 30 0a 20 20 20 26 26 20 73 71 6c  age!=0.   && sql
6960: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67  ite3GlobalConfig
6970: 2e 70 50 61 67 65 3d 3d 30 0a 20 20 29 7b 0a 20  .pPage==0.  ){. 
6980: 20 20 20 70 63 61 63 68 65 31 2e 6e 49 6e 69 74     pcache1.nInit
6990: 50 61 67 65 20 3d 20 73 71 6c 69 74 65 33 47 6c  Page = sqlite3Gl
69a0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 50 61 67 65  obalConfig.nPage
69b0: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70  ;.  }else{.    p
69c0: 63 61 63 68 65 31 2e 6e 49 6e 69 74 50 61 67 65  cache1.nInitPage
69d0: 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 70 63 61 63   = 0;.  }.  pcac
69e0: 68 65 31 2e 67 72 70 2e 6d 78 50 69 6e 6e 65 64  he1.grp.mxPinned
69f0: 20 3d 20 31 30 3b 0a 20 20 70 63 61 63 68 65 31   = 10;.  pcache1
6a00: 2e 69 73 49 6e 69 74 20 3d 20 31 3b 0a 20 20 72  .isInit = 1;.  r
6a10: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
6a20: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d  .}../*.** Implem
6a30: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20  entation of the 
6a40: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78  sqlite3_pcache.x
6a50: 53 68 75 74 64 6f 77 6e 20 6d 65 74 68 6f 64 2e  Shutdown method.
6a60: 0a 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 74 68  .** Note that th
6a70: 65 20 73 74 61 74 69 63 20 6d 75 74 65 78 20 61  e static mutex a
6a80: 6c 6c 6f 63 61 74 65 64 20 69 6e 20 78 49 6e 69  llocated in xIni
6a90: 74 20 64 6f 65 73 20 0a 2a 2a 20 6e 6f 74 20 6e  t does .** not n
6aa0: 65 65 64 20 74 6f 20 62 65 20 66 72 65 65 64 2e  eed to be freed.
6ab0: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
6ac0: 70 63 61 63 68 65 31 53 68 75 74 64 6f 77 6e 28  pcache1Shutdown(
6ad0: 76 6f 69 64 20 2a 4e 6f 74 55 73 65 64 29 7b 0a  void *NotUsed){.
6ae0: 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54    UNUSED_PARAMET
6af0: 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 61  ER(NotUsed);.  a
6b00: 73 73 65 72 74 28 20 70 63 61 63 68 65 31 2e 69  ssert( pcache1.i
6b10: 73 49 6e 69 74 21 3d 30 20 29 3b 0a 20 20 6d 65  sInit!=0 );.  me
6b20: 6d 73 65 74 28 26 70 63 61 63 68 65 31 2c 20 30  mset(&pcache1, 0
6b30: 2c 20 73 69 7a 65 6f 66 28 70 63 61 63 68 65 31  , sizeof(pcache1
6b40: 29 29 3b 0a 7d 0a 0a 2f 2a 20 66 6f 72 77 61 72  ));.}../* forwar
6b50: 64 20 64 65 63 6c 61 72 61 74 69 6f 6e 20 2a 2f  d declaration */
6b60: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61  .static void pca
6b70: 63 68 65 31 44 65 73 74 72 6f 79 28 73 71 6c 69  che1Destroy(sqli
6b80: 74 65 33 5f 70 63 61 63 68 65 20 2a 70 29 3b 0a  te3_pcache *p);.
6b90: 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74  ./*.** Implement
6ba0: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c  ation of the sql
6bb0: 69 74 65 33 5f 70 63 61 63 68 65 2e 78 43 72 65  ite3_pcache.xCre
6bc0: 61 74 65 20 6d 65 74 68 6f 64 2e 0a 2a 2a 0a 2a  ate method..**.*
6bd0: 2a 20 41 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77  * Allocate a new
6be0: 20 63 61 63 68 65 2e 0a 2a 2f 0a 73 74 61 74 69   cache..*/.stati
6bf0: 63 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  c sqlite3_pcache
6c00: 20 2a 70 63 61 63 68 65 31 43 72 65 61 74 65 28   *pcache1Create(
6c10: 69 6e 74 20 73 7a 50 61 67 65 2c 20 69 6e 74 20  int szPage, int 
6c20: 73 7a 45 78 74 72 61 2c 20 69 6e 74 20 62 50 75  szExtra, int bPu
6c30: 72 67 65 61 62 6c 65 29 7b 0a 20 20 50 43 61 63  rgeable){.  PCac
6c40: 68 65 31 20 2a 70 43 61 63 68 65 3b 20 20 20 20  he1 *pCache;    
6c50: 20 20 2f 2a 20 54 68 65 20 6e 65 77 6c 79 20 63    /* The newly c
6c60: 72 65 61 74 65 64 20 70 61 67 65 20 63 61 63 68  reated page cach
6c70: 65 20 2a 2f 0a 20 20 50 47 72 6f 75 70 20 2a 70  e */.  PGroup *p
6c80: 47 72 6f 75 70 3b 20 20 20 20 20 20 20 2f 2a 20  Group;       /* 
6c90: 54 68 65 20 67 72 6f 75 70 20 74 68 65 20 6e 65  The group the ne
6ca0: 77 20 70 61 67 65 20 63 61 63 68 65 20 77 69 6c  w page cache wil
6cb0: 6c 20 62 65 6c 6f 6e 67 20 74 6f 20 2a 2f 0a 20  l belong to */. 
6cc0: 20 69 6e 74 20 73 7a 3b 20 20 20 20 20 20 20 20   int sz;        
6cd0: 20 20 20 20 20 20 20 2f 2a 20 42 79 74 65 73 20         /* Bytes 
6ce0: 6f 66 20 6d 65 6d 6f 72 79 20 72 65 71 75 69 72  of memory requir
6cf0: 65 64 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 74  ed to allocate t
6d00: 68 65 20 6e 65 77 20 63 61 63 68 65 20 2a 2f 0a  he new cache */.
6d10: 0a 20 20 61 73 73 65 72 74 28 20 28 73 7a 50 61  .  assert( (szPa
6d20: 67 65 20 26 20 28 73 7a 50 61 67 65 2d 31 29 29  ge & (szPage-1))
6d30: 3d 3d 30 20 26 26 20 73 7a 50 61 67 65 3e 3d 35  ==0 && szPage>=5
6d40: 31 32 20 26 26 20 73 7a 50 61 67 65 3c 3d 36 35  12 && szPage<=65
6d50: 35 33 36 20 29 3b 0a 20 20 61 73 73 65 72 74 28  536 );.  assert(
6d60: 20 73 7a 45 78 74 72 61 20 3c 20 33 30 30 20 29   szExtra < 300 )
6d70: 3b 0a 0a 20 20 73 7a 20 3d 20 73 69 7a 65 6f 66  ;..  sz = sizeof
6d80: 28 50 43 61 63 68 65 31 29 20 2b 20 73 69 7a 65  (PCache1) + size
6d90: 6f 66 28 50 47 72 6f 75 70 29 2a 70 63 61 63 68  of(PGroup)*pcach
6da0: 65 31 2e 73 65 70 61 72 61 74 65 43 61 63 68 65  e1.separateCache
6db0: 3b 0a 20 20 70 43 61 63 68 65 20 3d 20 28 50 43  ;.  pCache = (PC
6dc0: 61 63 68 65 31 20 2a 29 73 71 6c 69 74 65 33 4d  ache1 *)sqlite3M
6dd0: 61 6c 6c 6f 63 5a 65 72 6f 28 73 7a 29 3b 0a 20  allocZero(sz);. 
6de0: 20 69 66 28 20 70 43 61 63 68 65 20 29 7b 0a 20   if( pCache ){. 
6df0: 20 20 20 69 66 28 20 70 63 61 63 68 65 31 2e 73     if( pcache1.s
6e00: 65 70 61 72 61 74 65 43 61 63 68 65 20 29 7b 0a  eparateCache ){.
6e10: 20 20 20 20 20 20 70 47 72 6f 75 70 20 3d 20 28        pGroup = (
6e20: 50 47 72 6f 75 70 2a 29 26 70 43 61 63 68 65 5b  PGroup*)&pCache[
6e30: 31 5d 3b 0a 20 20 20 20 20 20 70 47 72 6f 75 70  1];.      pGroup
6e40: 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 20 31 30 3b  ->mxPinned = 10;
6e50: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  .    }else{.    
6e60: 20 20 70 47 72 6f 75 70 20 3d 20 26 70 63 61 63    pGroup = &pcac
6e70: 68 65 31 2e 67 72 70 3b 0a 20 20 20 20 7d 0a 20  he1.grp;.    }. 
6e80: 20 20 20 69 66 28 20 70 47 72 6f 75 70 2d 3e 6c     if( pGroup->l
6e90: 72 75 2e 69 73 41 6e 63 68 6f 72 3d 3d 30 20 29  ru.isAnchor==0 )
6ea0: 7b 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e  {.      pGroup->
6eb0: 6c 72 75 2e 69 73 41 6e 63 68 6f 72 20 3d 20 31  lru.isAnchor = 1
6ec0: 3b 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e  ;.      pGroup->
6ed0: 6c 72 75 2e 70 4c 72 75 50 72 65 76 20 3d 20 70  lru.pLruPrev = p
6ee0: 47 72 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72 75 4e  Group->lru.pLruN
6ef0: 65 78 74 20 3d 20 26 70 47 72 6f 75 70 2d 3e 6c  ext = &pGroup->l
6f00: 72 75 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 43  ru;.    }.    pC
6f10: 61 63 68 65 2d 3e 70 47 72 6f 75 70 20 3d 20 70  ache->pGroup = p
6f20: 47 72 6f 75 70 3b 0a 20 20 20 20 70 43 61 63 68  Group;.    pCach
6f30: 65 2d 3e 73 7a 50 61 67 65 20 3d 20 73 7a 50 61  e->szPage = szPa
6f40: 67 65 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e  ge;.    pCache->
6f50: 73 7a 45 78 74 72 61 20 3d 20 73 7a 45 78 74 72  szExtra = szExtr
6f60: 61 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 73  a;.    pCache->s
6f70: 7a 41 6c 6c 6f 63 20 3d 20 73 7a 50 61 67 65 20  zAlloc = szPage 
6f80: 2b 20 73 7a 45 78 74 72 61 20 2b 20 52 4f 55 4e  + szExtra + ROUN
6f90: 44 38 28 73 69 7a 65 6f 66 28 50 67 48 64 72 31  D8(sizeof(PgHdr1
6fa0: 29 29 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e  ));.    pCache->
6fb0: 62 50 75 72 67 65 61 62 6c 65 20 3d 20 28 62 50  bPurgeable = (bP
6fc0: 75 72 67 65 61 62 6c 65 20 3f 20 31 20 3a 20 30  urgeable ? 1 : 0
6fd0: 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e  );.    pcache1En
6fe0: 74 65 72 4d 75 74 65 78 28 70 47 72 6f 75 70 29  terMutex(pGroup)
6ff0: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 52 65 73  ;.    pcache1Res
7000: 69 7a 65 48 61 73 68 28 70 43 61 63 68 65 29 3b  izeHash(pCache);
7010: 0a 20 20 20 20 69 66 28 20 62 50 75 72 67 65 61  .    if( bPurgea
7020: 62 6c 65 20 29 7b 0a 20 20 20 20 20 20 70 43 61  ble ){.      pCa
7030: 63 68 65 2d 3e 6e 4d 69 6e 20 3d 20 31 30 3b 0a  che->nMin = 10;.
7040: 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e 4d        pGroup->nM
7050: 69 6e 50 61 67 65 20 2b 3d 20 70 43 61 63 68 65  inPage += pCache
7060: 2d 3e 6e 4d 69 6e 3b 0a 20 20 20 20 20 20 70 47  ->nMin;.      pG
7070: 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d  roup->mxPinned =
7080: 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67   pGroup->nMaxPag
7090: 65 20 2b 20 31 30 20 2d 20 70 47 72 6f 75 70 2d  e + 10 - pGroup-
70a0: 3e 6e 4d 69 6e 50 61 67 65 3b 0a 20 20 20 20 20  >nMinPage;.     
70b0: 20 70 43 61 63 68 65 2d 3e 70 6e 50 75 72 67 65   pCache->pnPurge
70c0: 61 62 6c 65 20 3d 20 26 70 47 72 6f 75 70 2d 3e  able = &pGroup->
70d0: 6e 50 75 72 67 65 61 62 6c 65 3b 0a 20 20 20 20  nPurgeable;.    
70e0: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 43 61  }else{.      pCa
70f0: 63 68 65 2d 3e 70 6e 50 75 72 67 65 61 62 6c 65  che->pnPurgeable
7100: 20 3d 20 26 70 43 61 63 68 65 2d 3e 6e 50 75 72   = &pCache->nPur
7110: 67 65 61 62 6c 65 44 75 6d 6d 79 3b 0a 20 20 20  geableDummy;.   
7120: 20 7d 0a 20 20 20 20 70 63 61 63 68 65 31 4c 65   }.    pcache1Le
7130: 61 76 65 4d 75 74 65 78 28 70 47 72 6f 75 70 29  aveMutex(pGroup)
7140: 3b 0a 20 20 20 20 69 66 28 20 70 43 61 63 68 65  ;.    if( pCache
7150: 2d 3e 6e 48 61 73 68 3d 3d 30 20 29 7b 0a 20 20  ->nHash==0 ){.  
7160: 20 20 20 20 70 63 61 63 68 65 31 44 65 73 74 72      pcache1Destr
7170: 6f 79 28 28 73 71 6c 69 74 65 33 5f 70 63 61 63  oy((sqlite3_pcac
7180: 68 65 2a 29 70 43 61 63 68 65 29 3b 0a 20 20 20  he*)pCache);.   
7190: 20 20 20 70 43 61 63 68 65 20 3d 20 30 3b 0a 20     pCache = 0;. 
71a0: 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72     }.  }.  retur
71b0: 6e 20 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68  n (sqlite3_pcach
71c0: 65 20 2a 29 70 43 61 63 68 65 3b 0a 7d 0a 0a 2f  e *)pCache;.}../
71d0: 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74  *.** Implementat
71e0: 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74  ion of the sqlit
71f0: 65 33 5f 70 63 61 63 68 65 2e 78 43 61 63 68 65  e3_pcache.xCache
7200: 73 69 7a 65 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a  size method. .**
7210: 0a 2a 2a 20 43 6f 6e 66 69 67 75 72 65 20 74 68  .** Configure th
7220: 65 20 63 61 63 68 65 5f 73 69 7a 65 20 6c 69 6d  e cache_size lim
7230: 69 74 20 66 6f 72 20 61 20 63 61 63 68 65 2e 0a  it for a cache..
7240: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70  */.static void p
7250: 63 61 63 68 65 31 43 61 63 68 65 73 69 7a 65 28  cache1Cachesize(
7260: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a  sqlite3_pcache *
7270: 70 2c 20 69 6e 74 20 6e 4d 61 78 29 7b 0a 20 20  p, int nMax){.  
7280: 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 20  PCache1 *pCache 
7290: 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b 0a  = (PCache1 *)p;.
72a0: 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e 62 50    if( pCache->bP
72b0: 75 72 67 65 61 62 6c 65 20 29 7b 0a 20 20 20 20  urgeable ){.    
72c0: 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70 20 3d  PGroup *pGroup =
72d0: 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3b   pCache->pGroup;
72e0: 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e 74 65  .    pcache1Ente
72f0: 72 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a  rMutex(pGroup);.
7300: 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78      pGroup->nMax
7310: 50 61 67 65 20 2b 3d 20 28 6e 4d 61 78 20 2d 20  Page += (nMax - 
7320: 70 43 61 63 68 65 2d 3e 6e 4d 61 78 29 3b 0a 20  pCache->nMax);. 
7330: 20 20 20 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e     pGroup->mxPin
7340: 6e 65 64 20 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d  ned = pGroup->nM
7350: 61 78 50 61 67 65 20 2b 20 31 30 20 2d 20 70 47  axPage + 10 - pG
7360: 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 3b 0a  roup->nMinPage;.
7370: 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78      pCache->nMax
7380: 20 3d 20 6e 4d 61 78 3b 0a 20 20 20 20 70 43 61   = nMax;.    pCa
7390: 63 68 65 2d 3e 6e 39 30 70 63 74 20 3d 20 70 43  che->n90pct = pC
73a0: 61 63 68 65 2d 3e 6e 4d 61 78 2a 39 2f 31 30 3b  ache->nMax*9/10;
73b0: 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e 66 6f  .    pcache1Enfo
73c0: 72 63 65 4d 61 78 50 61 67 65 28 70 43 61 63 68  rceMaxPage(pCach
73d0: 65 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 4c  e);.    pcache1L
73e0: 65 61 76 65 4d 75 74 65 78 28 70 47 72 6f 75 70  eaveMutex(pGroup
73f0: 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  );.  }.}../*.** 
7400: 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  Implementation o
7410: 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63  f the sqlite3_pc
7420: 61 63 68 65 2e 78 53 68 72 69 6e 6b 20 6d 65 74  ache.xShrink met
7430: 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 46 72 65 65  hod. .**.** Free
7440: 20 75 70 20 61 73 20 6d 75 63 68 20 6d 65 6d 6f   up as much memo
7450: 72 79 20 61 73 20 70 6f 73 73 69 62 6c 65 2e 0a  ry as possible..
7460: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70  */.static void p
7470: 63 61 63 68 65 31 53 68 72 69 6e 6b 28 73 71 6c  cache1Shrink(sql
7480: 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 29 7b  ite3_pcache *p){
7490: 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63  .  PCache1 *pCac
74a0: 68 65 20 3d 20 28 50 43 61 63 68 65 31 2a 29 70  he = (PCache1*)p
74b0: 3b 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e  ;.  if( pCache->
74c0: 62 50 75 72 67 65 61 62 6c 65 20 29 7b 0a 20 20  bPurgeable ){.  
74d0: 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70    PGroup *pGroup
74e0: 20 3d 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75   = pCache->pGrou
74f0: 70 3b 0a 20 20 20 20 69 6e 74 20 73 61 76 65 64  p;.    int saved
7500: 4d 61 78 50 61 67 65 3b 0a 20 20 20 20 70 63 61  MaxPage;.    pca
7510: 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70  che1EnterMutex(p
7520: 47 72 6f 75 70 29 3b 0a 20 20 20 20 73 61 76 65  Group);.    save
7530: 64 4d 61 78 50 61 67 65 20 3d 20 70 47 72 6f 75  dMaxPage = pGrou
7540: 70 2d 3e 6e 4d 61 78 50 61 67 65 3b 0a 20 20 20  p->nMaxPage;.   
7550: 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67   pGroup->nMaxPag
7560: 65 20 3d 20 30 3b 0a 20 20 20 20 70 63 61 63 68  e = 0;.    pcach
7570: 65 31 45 6e 66 6f 72 63 65 4d 61 78 50 61 67 65  e1EnforceMaxPage
7580: 28 70 43 61 63 68 65 29 3b 0a 20 20 20 20 70 47  (pCache);.    pG
7590: 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 3d  roup->nMaxPage =
75a0: 20 73 61 76 65 64 4d 61 78 50 61 67 65 3b 0a 20   savedMaxPage;. 
75b0: 20 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d     pcache1LeaveM
75c0: 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20 20  utex(pGroup);.  
75d0: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65  }.}../*.** Imple
75e0: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65  mentation of the
75f0: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e   sqlite3_pcache.
7600: 78 50 61 67 65 63 6f 75 6e 74 20 6d 65 74 68 6f  xPagecount metho
7610: 64 2e 20 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  d. .*/.static in
7620: 74 20 70 63 61 63 68 65 31 50 61 67 65 63 6f 75  t pcache1Pagecou
7630: 6e 74 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68  nt(sqlite3_pcach
7640: 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 6e 3b 0a  e *p){.  int n;.
7650: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68    PCache1 *pCach
7660: 65 20 3d 20 28 50 43 61 63 68 65 31 2a 29 70 3b  e = (PCache1*)p;
7670: 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d  .  pcache1EnterM
7680: 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72  utex(pCache->pGr
7690: 6f 75 70 29 3b 0a 20 20 6e 20 3d 20 70 43 61 63  oup);.  n = pCac
76a0: 68 65 2d 3e 6e 50 61 67 65 3b 0a 20 20 70 63 61  he->nPage;.  pca
76b0: 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70  che1LeaveMutex(p
76c0: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a  Cache->pGroup);.
76d0: 20 20 72 65 74 75 72 6e 20 6e 3b 0a 7d 0a 0a 0a    return n;.}...
76e0: 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 20  /*.** Implement 
76f0: 73 74 65 70 73 20 33 2c 20 34 2c 20 61 6e 64 20  steps 3, 4, and 
7700: 35 20 6f 66 20 74 68 65 20 70 63 61 63 68 65 31  5 of the pcache1
7710: 46 65 74 63 68 28 29 20 61 6c 67 6f 72 69 74 68  Fetch() algorith
7720: 6d 20 64 65 73 63 72 69 62 65 64 0a 2a 2a 20 69  m described.** i
7730: 6e 20 74 68 65 20 68 65 61 64 65 72 20 6f 66 20  n the header of 
7740: 74 68 65 20 70 63 61 63 68 65 31 46 65 74 63 68  the pcache1Fetch
7750: 28 29 20 70 72 6f 63 65 64 75 72 65 2e 0a 2a 2a  () procedure..**
7760: 0a 2a 2a 20 54 68 69 73 20 73 74 65 70 73 20 61  .** This steps a
7770: 72 65 20 62 72 6f 6b 65 6e 20 6f 75 74 20 69 6e  re broken out in
7780: 74 6f 20 61 20 73 65 70 61 72 61 74 65 20 70 72  to a separate pr
7790: 6f 63 65 64 75 72 65 20 62 65 63 61 75 73 65 20  ocedure because 
77a0: 74 68 65 79 20 61 72 65 0a 2a 2a 20 75 73 75 61  they are.** usua
77b0: 6c 6c 79 20 6e 6f 74 20 6e 65 65 64 65 64 2c 20  lly not needed, 
77c0: 61 6e 64 20 62 79 20 61 76 6f 69 64 69 6e 67 20  and by avoiding 
77d0: 74 68 65 20 73 74 61 63 6b 20 69 6e 69 74 69 61  the stack initia
77e0: 6c 69 7a 61 74 69 6f 6e 20 72 65 71 75 69 72 65  lization require
77f0: 64 0a 2a 2a 20 66 6f 72 20 74 68 65 73 65 20 73  d.** for these s
7800: 74 65 70 73 2c 20 74 68 65 20 6d 61 69 6e 20 70  teps, the main p
7810: 63 61 63 68 65 31 46 65 74 63 68 28 29 20 70 72  cache1Fetch() pr
7820: 6f 63 65 64 75 72 65 20 63 61 6e 20 72 75 6e 20  ocedure can run 
7830: 66 61 73 74 65 72 2e 0a 2a 2f 0a 73 74 61 74 69  faster..*/.stati
7840: 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e  c SQLITE_NOINLIN
7850: 45 20 50 67 48 64 72 31 20 2a 70 63 61 63 68 65  E PgHdr1 *pcache
7860: 31 46 65 74 63 68 53 74 61 67 65 32 28 0a 20 20  1FetchStage2(.  
7870: 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 2c  PCache1 *pCache,
7880: 20 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74   .  unsigned int
7890: 20 69 4b 65 79 2c 20 0a 20 20 69 6e 74 20 63 72   iKey, .  int cr
78a0: 65 61 74 65 46 6c 61 67 0a 29 7b 0a 20 20 75 6e  eateFlag.){.  un
78b0: 73 69 67 6e 65 64 20 69 6e 74 20 6e 50 69 6e 6e  signed int nPinn
78c0: 65 64 3b 0a 20 20 50 47 72 6f 75 70 20 2a 70 47  ed;.  PGroup *pG
78d0: 72 6f 75 70 20 3d 20 70 43 61 63 68 65 2d 3e 70  roup = pCache->p
78e0: 47 72 6f 75 70 3b 0a 20 20 50 67 48 64 72 31 20  Group;.  PgHdr1 
78f0: 2a 70 50 61 67 65 20 3d 20 30 3b 0a 0a 20 20 2f  *pPage = 0;..  /
7900: 2a 20 53 74 65 70 20 33 3a 20 41 62 6f 72 74 20  * Step 3: Abort 
7910: 69 66 20 63 72 65 61 74 65 46 6c 61 67 20 69 73  if createFlag is
7920: 20 31 20 62 75 74 20 74 68 65 20 63 61 63 68 65   1 but the cache
7930: 20 69 73 20 6e 65 61 72 6c 79 20 66 75 6c 6c 20   is nearly full 
7940: 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 43 61  */.  assert( pCa
7950: 63 68 65 2d 3e 6e 50 61 67 65 20 3e 3d 20 70 43  che->nPage >= pC
7960: 61 63 68 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c  ache->nRecyclabl
7970: 65 20 29 3b 0a 20 20 6e 50 69 6e 6e 65 64 20 3d  e );.  nPinned =
7980: 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 20 2d   pCache->nPage -
7990: 20 70 43 61 63 68 65 2d 3e 6e 52 65 63 79 63 6c   pCache->nRecycl
79a0: 61 62 6c 65 3b 0a 20 20 61 73 73 65 72 74 28 20  able;.  assert( 
79b0: 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64  pGroup->mxPinned
79c0: 20 3d 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78   == pGroup->nMax
79d0: 50 61 67 65 20 2b 20 31 30 20 2d 20 70 47 72 6f  Page + 10 - pGro
79e0: 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 20 29 3b 0a  up->nMinPage );.
79f0: 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65    assert( pCache
7a00: 2d 3e 6e 39 30 70 63 74 20 3d 3d 20 70 43 61 63  ->n90pct == pCac
7a10: 68 65 2d 3e 6e 4d 61 78 2a 39 2f 31 30 20 29 3b  he->nMax*9/10 );
7a20: 0a 20 20 69 66 28 20 63 72 65 61 74 65 46 6c 61  .  if( createFla
7a30: 67 3d 3d 31 20 26 26 20 28 0a 20 20 20 20 20 20  g==1 && (.      
7a40: 20 20 6e 50 69 6e 6e 65 64 3e 3d 70 47 72 6f 75    nPinned>=pGrou
7a50: 70 2d 3e 6d 78 50 69 6e 6e 65 64 0a 20 20 20 20  p->mxPinned.    
7a60: 20 7c 7c 20 6e 50 69 6e 6e 65 64 3e 3d 70 43 61   || nPinned>=pCa
7a70: 63 68 65 2d 3e 6e 39 30 70 63 74 0a 20 20 20 20  che->n90pct.    
7a80: 20 7c 7c 20 28 70 63 61 63 68 65 31 55 6e 64 65   || (pcache1Unde
7a90: 72 4d 65 6d 6f 72 79 50 72 65 73 73 75 72 65 28  rMemoryPressure(
7aa0: 70 43 61 63 68 65 29 20 26 26 20 70 43 61 63 68  pCache) && pCach
7ab0: 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65 3c 6e  e->nRecyclable<n
7ac0: 50 69 6e 6e 65 64 29 0a 20 20 29 29 7b 0a 20 20  Pinned).  )){.  
7ad0: 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a    return 0;.  }.
7ae0: 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e 6e  .  if( pCache->n
7af0: 50 61 67 65 3e 3d 70 43 61 63 68 65 2d 3e 6e 48  Page>=pCache->nH
7b00: 61 73 68 20 29 20 70 63 61 63 68 65 31 52 65 73  ash ) pcache1Res
7b10: 69 7a 65 48 61 73 68 28 70 43 61 63 68 65 29 3b  izeHash(pCache);
7b20: 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68  .  assert( pCach
7b30: 65 2d 3e 6e 48 61 73 68 3e 30 20 26 26 20 70 43  e->nHash>0 && pC
7b40: 61 63 68 65 2d 3e 61 70 48 61 73 68 20 29 3b 0a  ache->apHash );.
7b50: 0a 20 20 2f 2a 20 53 74 65 70 20 34 2e 20 54 72  .  /* Step 4. Tr
7b60: 79 20 74 6f 20 72 65 63 79 63 6c 65 20 61 20 70  y to recycle a p
7b70: 61 67 65 2e 20 2a 2f 0a 20 20 69 66 28 20 70 43  age. */.  if( pC
7b80: 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65  ache->bPurgeable
7b90: 0a 20 20 20 26 26 20 21 70 47 72 6f 75 70 2d 3e  .   && !pGroup->
7ba0: 6c 72 75 2e 70 4c 72 75 50 72 65 76 2d 3e 69 73  lru.pLruPrev->is
7bb0: 41 6e 63 68 6f 72 0a 20 20 20 26 26 20 28 28 70  Anchor.   && ((p
7bc0: 43 61 63 68 65 2d 3e 6e 50 61 67 65 2b 31 3e 3d  Cache->nPage+1>=
7bd0: 70 43 61 63 68 65 2d 3e 6e 4d 61 78 29 20 7c 7c  pCache->nMax) ||
7be0: 20 70 63 61 63 68 65 31 55 6e 64 65 72 4d 65 6d   pcache1UnderMem
7bf0: 6f 72 79 50 72 65 73 73 75 72 65 28 70 43 61 63  oryPressure(pCac
7c00: 68 65 29 29 0a 20 20 29 7b 0a 20 20 20 20 50 43  he)).  ){.    PC
7c10: 61 63 68 65 31 20 2a 70 4f 74 68 65 72 3b 0a 20  ache1 *pOther;. 
7c20: 20 20 20 70 50 61 67 65 20 3d 20 70 47 72 6f 75     pPage = pGrou
7c30: 70 2d 3e 6c 72 75 2e 70 4c 72 75 50 72 65 76 3b  p->lru.pLruPrev;
7c40: 0a 20 20 20 20 61 73 73 65 72 74 28 20 50 41 47  .    assert( PAG
7c50: 45 5f 49 53 5f 55 4e 50 49 4e 4e 45 44 28 70 50  E_IS_UNPINNED(pP
7c60: 61 67 65 29 20 29 3b 0a 20 20 20 20 70 63 61 63  age) );.    pcac
7c70: 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73  he1RemoveFromHas
7c80: 68 28 70 50 61 67 65 2c 20 30 29 3b 0a 20 20 20  h(pPage, 0);.   
7c90: 20 70 63 61 63 68 65 31 50 69 6e 50 61 67 65 28   pcache1PinPage(
7ca0: 70 50 61 67 65 29 3b 0a 20 20 20 20 70 4f 74 68  pPage);.    pOth
7cb0: 65 72 20 3d 20 70 50 61 67 65 2d 3e 70 43 61 63  er = pPage->pCac
7cc0: 68 65 3b 0a 20 20 20 20 69 66 28 20 70 4f 74 68  he;.    if( pOth
7cd0: 65 72 2d 3e 73 7a 41 6c 6c 6f 63 20 21 3d 20 70  er->szAlloc != p
7ce0: 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63 20 29  Cache->szAlloc )
7cf0: 7b 0a 20 20 20 20 20 20 70 63 61 63 68 65 31 46  {.      pcache1F
7d00: 72 65 65 50 61 67 65 28 70 50 61 67 65 29 3b 0a  reePage(pPage);.
7d10: 20 20 20 20 20 20 70 50 61 67 65 20 3d 20 30 3b        pPage = 0;
7d20: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  .    }else{.    
7d30: 20 20 70 47 72 6f 75 70 2d 3e 6e 50 75 72 67 65    pGroup->nPurge
7d40: 61 62 6c 65 20 2d 3d 20 28 70 4f 74 68 65 72 2d  able -= (pOther-
7d50: 3e 62 50 75 72 67 65 61 62 6c 65 20 2d 20 70 43  >bPurgeable - pC
7d60: 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65  ache->bPurgeable
7d70: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20  );.    }.  }..  
7d80: 2f 2a 20 53 74 65 70 20 35 2e 20 49 66 20 61 20  /* Step 5. If a 
7d90: 75 73 61 62 6c 65 20 70 61 67 65 20 62 75 66 66  usable page buff
7da0: 65 72 20 68 61 73 20 73 74 69 6c 6c 20 6e 6f 74  er has still not
7db0: 20 62 65 65 6e 20 66 6f 75 6e 64 2c 20 0a 20 20   been found, .  
7dc0: 2a 2a 20 61 74 74 65 6d 70 74 20 74 6f 20 61 6c  ** attempt to al
7dd0: 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 6f 6e 65  locate a new one
7de0: 2e 20 0a 20 20 2a 2f 0a 20 20 69 66 28 20 21 70  . .  */.  if( !p
7df0: 50 61 67 65 20 29 7b 0a 20 20 20 20 70 50 61 67  Page ){.    pPag
7e00: 65 20 3d 20 70 63 61 63 68 65 31 41 6c 6c 6f 63  e = pcache1Alloc
7e10: 50 61 67 65 28 70 43 61 63 68 65 2c 20 63 72 65  Page(pCache, cre
7e20: 61 74 65 46 6c 61 67 3d 3d 31 29 3b 0a 20 20 7d  ateFlag==1);.  }
7e30: 0a 0a 20 20 69 66 28 20 70 50 61 67 65 20 29 7b  ..  if( pPage ){
7e40: 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20 69 6e  .    unsigned in
7e50: 74 20 68 20 3d 20 69 4b 65 79 20 25 20 70 43 61  t h = iKey % pCa
7e60: 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 20 20  che->nHash;.    
7e70: 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 2b 2b 3b  pCache->nPage++;
7e80: 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 4b 65 79  .    pPage->iKey
7e90: 20 3d 20 69 4b 65 79 3b 0a 20 20 20 20 70 50 61   = iKey;.    pPa
7ea0: 67 65 2d 3e 70 4e 65 78 74 20 3d 20 70 43 61 63  ge->pNext = pCac
7eb0: 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 3b 0a 20  he->apHash[h];. 
7ec0: 20 20 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65     pPage->pCache
7ed0: 20 3d 20 70 43 61 63 68 65 3b 0a 20 20 20 20 70   = pCache;.    p
7ee0: 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74 20 3d  Page->pLruNext =
7ef0: 20 30 3b 0a 20 20 20 20 2f 2a 20 70 50 61 67 65   0;.    /* pPage
7f00: 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20 30 3b 0a  ->pLruPrev = 0;.
7f10: 20 20 20 20 2a 2a 20 4e 6f 20 6e 65 65 64 20 74      ** No need t
7f20: 6f 20 63 6c 65 61 72 20 70 4c 72 75 50 72 65 76  o clear pLruPrev
7f30: 20 73 69 6e 63 65 20 69 74 20 69 73 20 6e 6f 74   since it is not
7f40: 20 61 63 63 65 73 73 65 64 20 77 68 65 6e 20 70   accessed when p
7f50: 4c 72 75 4e 65 78 74 3d 3d 30 20 2a 2f 0a 20 20  LruNext==0 */.  
7f60: 20 20 2a 28 76 6f 69 64 20 2a 2a 29 70 50 61 67    *(void **)pPag
7f70: 65 2d 3e 70 61 67 65 2e 70 45 78 74 72 61 20 3d  e->page.pExtra =
7f80: 20 30 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e   0;.    pCache->
7f90: 61 70 48 61 73 68 5b 68 5d 20 3d 20 70 50 61 67  apHash[h] = pPag
7fa0: 65 3b 0a 20 20 20 20 69 66 28 20 69 4b 65 79 3e  e;.    if( iKey>
7fb0: 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20  pCache->iMaxKey 
7fc0: 29 7b 0a 20 20 20 20 20 20 70 43 61 63 68 65 2d  ){.      pCache-
7fd0: 3e 69 4d 61 78 4b 65 79 20 3d 20 69 4b 65 79 3b  >iMaxKey = iKey;
7fe0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74  .    }.  }.  ret
7ff0: 75 72 6e 20 70 50 61 67 65 3b 0a 7d 0a 0a 2f 2a  urn pPage;.}../*
8000: 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69  .** Implementati
8010: 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65  on of the sqlite
8020: 33 5f 70 63 61 63 68 65 2e 78 46 65 74 63 68 20  3_pcache.xFetch 
8030: 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 46  method. .**.** F
8040: 65 74 63 68 20 61 20 70 61 67 65 20 62 79 20 6b  etch a page by k
8050: 65 79 20 76 61 6c 75 65 2e 0a 2a 2a 0a 2a 2a 20  ey value..**.** 
8060: 57 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 61  Whether or not a
8070: 20 6e 65 77 20 70 61 67 65 20 6d 61 79 20 62 65   new page may be
8080: 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 20 74 68   allocated by th
8090: 69 73 20 66 75 6e 63 74 69 6f 6e 20 64 65 70 65  is function depe
80a0: 6e 64 73 20 6f 6e 0a 2a 2a 20 74 68 65 20 76 61  nds on.** the va
80b0: 6c 75 65 20 6f 66 20 74 68 65 20 63 72 65 61 74  lue of the creat
80c0: 65 46 6c 61 67 20 61 72 67 75 6d 65 6e 74 2e 20  eFlag argument. 
80d0: 20 30 20 6d 65 61 6e 73 20 64 6f 20 6e 6f 74 20   0 means do not 
80e0: 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 0a 2a  allocate a new.*
80f0: 2a 20 70 61 67 65 2e 20 20 31 20 6d 65 61 6e 73  * page.  1 means
8100: 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20   allocate a new 
8110: 70 61 67 65 20 69 66 20 73 70 61 63 65 20 69 73  page if space is
8120: 20 65 61 73 69 6c 79 20 61 76 61 69 6c 61 62 6c   easily availabl
8130: 65 2e 20 20 32 20 0a 2a 2a 20 6d 65 61 6e 73 20  e.  2 .** means 
8140: 74 6f 20 74 72 79 20 72 65 61 6c 6c 79 20 68 61  to try really ha
8150: 72 64 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 61  rd to allocate a
8160: 20 6e 65 77 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a   new page..**.**
8170: 20 46 6f 72 20 61 20 6e 6f 6e 2d 70 75 72 67 65   For a non-purge
8180: 61 62 6c 65 20 63 61 63 68 65 20 28 61 20 63 61  able cache (a ca
8190: 63 68 65 20 75 73 65 64 20 61 73 20 74 68 65 20  che used as the 
81a0: 73 74 6f 72 61 67 65 20 66 6f 72 20 61 6e 20 69  storage for an i
81b0: 6e 2d 6d 65 6d 6f 72 79 0a 2a 2a 20 64 61 74 61  n-memory.** data
81c0: 62 61 73 65 29 20 74 68 65 72 65 20 69 73 20 72  base) there is r
81d0: 65 61 6c 6c 79 20 6e 6f 20 64 69 66 66 65 72 65  eally no differe
81e0: 6e 63 65 20 62 65 74 77 65 65 6e 20 63 72 65 61  nce between crea
81f0: 74 65 46 6c 61 67 20 31 20 61 6e 64 20 32 2e 20  teFlag 1 and 2. 
8200: 20 53 6f 0a 2a 2a 20 74 68 65 20 63 61 6c 6c 69   So.** the calli
8210: 6e 67 20 66 75 6e 63 74 69 6f 6e 20 28 70 63 61  ng function (pca
8220: 63 68 65 2e 63 29 20 77 69 6c 6c 20 6e 65 76 65  che.c) will neve
8230: 72 20 68 61 76 65 20 61 20 63 72 65 61 74 65 46  r have a createF
8240: 6c 61 67 20 6f 66 20 31 20 6f 6e 0a 2a 2a 20 61  lag of 1 on.** a
8250: 20 6e 6f 6e 2d 70 75 72 67 65 61 62 6c 65 20 63   non-purgeable c
8260: 61 63 68 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 72  ache..**.** Ther
8270: 65 20 61 72 65 20 74 68 72 65 65 20 64 69 66 66  e are three diff
8280: 65 72 65 6e 74 20 61 70 70 72 6f 61 63 68 65 73  erent approaches
8290: 20 74 6f 20 6f 62 74 61 69 6e 69 6e 67 20 73 70   to obtaining sp
82a0: 61 63 65 20 66 6f 72 20 61 20 70 61 67 65 2c 0a  ace for a page,.
82b0: 2a 2a 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20  ** depending on 
82c0: 74 68 65 20 76 61 6c 75 65 20 6f 66 20 70 61 72  the value of par
82d0: 61 6d 65 74 65 72 20 63 72 65 61 74 65 46 6c 61  ameter createFla
82e0: 67 20 28 77 68 69 63 68 20 6d 61 79 20 62 65 20  g (which may be 
82f0: 30 2c 20 31 20 6f 72 20 32 29 2e 0a 2a 2a 0a 2a  0, 1 or 2)..**.*
8300: 2a 20 20 20 31 2e 20 52 65 67 61 72 64 6c 65 73  *   1. Regardles
8310: 73 20 6f 66 20 74 68 65 20 76 61 6c 75 65 20 6f  s of the value o
8320: 66 20 63 72 65 61 74 65 46 6c 61 67 2c 20 74 68  f createFlag, th
8330: 65 20 63 61 63 68 65 20 69 73 20 73 65 61 72 63  e cache is searc
8340: 68 65 64 20 66 6f 72 20 61 20 0a 2a 2a 20 20 20  hed for a .**   
8350: 20 20 20 63 6f 70 79 20 6f 66 20 74 68 65 20 72     copy of the r
8360: 65 71 75 65 73 74 65 64 20 70 61 67 65 2e 20 49  equested page. I
8370: 66 20 6f 6e 65 20 69 73 20 66 6f 75 6e 64 2c 20  f one is found, 
8380: 69 74 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a  it is returned..
8390: 2a 2a 0a 2a 2a 20 20 20 32 2e 20 49 66 20 63 72  **.**   2. If cr
83a0: 65 61 74 65 46 6c 61 67 3d 3d 30 20 61 6e 64 20  eateFlag==0 and 
83b0: 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f 74 20  the page is not 
83c0: 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65 20 63  already in the c
83d0: 61 63 68 65 2c 20 4e 55 4c 4c 20 69 73 0a 2a 2a  ache, NULL is.**
83e0: 20 20 20 20 20 20 72 65 74 75 72 6e 65 64 2e 0a        returned..
83f0: 2a 2a 0a 2a 2a 20 20 20 33 2e 20 49 66 20 63 72  **.**   3. If cr
8400: 65 61 74 65 46 6c 61 67 20 69 73 20 31 2c 20 61  eateFlag is 1, a
8410: 6e 64 20 74 68 65 20 70 61 67 65 20 69 73 20 6e  nd the page is n
8420: 6f 74 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68  ot already in th
8430: 65 20 63 61 63 68 65 2c 20 74 68 65 6e 0a 2a 2a  e cache, then.**
8440: 20 20 20 20 20 20 72 65 74 75 72 6e 20 4e 55 4c        return NUL
8450: 4c 20 28 64 6f 20 6e 6f 74 20 61 6c 6c 6f 63 61  L (do not alloca
8460: 74 65 20 61 20 6e 65 77 20 70 61 67 65 29 20 69  te a new page) i
8470: 66 20 61 6e 79 20 6f 66 20 74 68 65 20 66 6f 6c  f any of the fol
8480: 6c 6f 77 69 6e 67 0a 2a 2a 20 20 20 20 20 20 63  lowing.**      c
8490: 6f 6e 64 69 74 69 6f 6e 73 20 61 72 65 20 74 72  onditions are tr
84a0: 75 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20  ue:.**.**       
84b0: 28 61 29 20 74 68 65 20 6e 75 6d 62 65 72 20 6f  (a) the number o
84c0: 66 20 70 61 67 65 73 20 70 69 6e 6e 65 64 20 62  f pages pinned b
84d0: 79 20 74 68 65 20 63 61 63 68 65 20 69 73 20 67  y the cache is g
84e0: 72 65 61 74 65 72 20 74 68 61 6e 0a 2a 2a 20 20  reater than.**  
84f0: 20 20 20 20 20 20 20 20 20 50 43 61 63 68 65 31           PCache1
8500: 2e 6e 4d 61 78 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20  .nMax, or.**.** 
8510: 20 20 20 20 20 20 28 62 29 20 74 68 65 20 6e 75        (b) the nu
8520: 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 70 69  mber of pages pi
8530: 6e 6e 65 64 20 62 79 20 74 68 65 20 63 61 63 68  nned by the cach
8540: 65 20 69 73 20 67 72 65 61 74 65 72 20 74 68 61  e is greater tha
8550: 6e 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 74  n.**           t
8560: 68 65 20 73 75 6d 20 6f 66 20 6e 4d 61 78 20 66  he sum of nMax f
8570: 6f 72 20 61 6c 6c 20 70 75 72 67 65 61 62 6c 65  or all purgeable
8580: 20 63 61 63 68 65 73 2c 20 6c 65 73 73 20 74 68   caches, less th
8590: 65 20 73 75 6d 20 6f 66 20 0a 2a 2a 20 20 20 20  e sum of .**    
85a0: 20 20 20 20 20 20 20 6e 4d 69 6e 20 66 6f 72 20         nMin for 
85b0: 61 6c 6c 20 6f 74 68 65 72 20 70 75 72 67 65 61  all other purgea
85c0: 62 6c 65 20 63 61 63 68 65 73 2c 20 6f 72 0a 2a  ble caches, or.*
85d0: 2a 0a 2a 2a 20 20 20 34 2e 20 49 66 20 6e 6f 6e  *.**   4. If non
85e0: 65 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 74  e of the first t
85f0: 68 72 65 65 20 63 6f 6e 64 69 74 69 6f 6e 73 20  hree conditions 
8600: 61 70 70 6c 79 20 61 6e 64 20 74 68 65 20 63 61  apply and the ca
8610: 63 68 65 20 69 73 20 6d 61 72 6b 65 64 0a 2a 2a  che is marked.**
8620: 20 20 20 20 20 20 61 73 20 70 75 72 67 65 61 62        as purgeab
8630: 6c 65 2c 20 61 6e 64 20 69 66 20 6f 6e 65 20 6f  le, and if one o
8640: 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  f the following 
8650: 69 73 20 74 72 75 65 3a 0a 2a 2a 0a 2a 2a 20 20  is true:.**.**  
8660: 20 20 20 20 20 28 61 29 20 54 68 65 20 6e 75 6d       (a) The num
8670: 62 65 72 20 6f 66 20 70 61 67 65 73 20 61 6c 6c  ber of pages all
8680: 6f 63 61 74 65 64 20 66 6f 72 20 74 68 65 20 63  ocated for the c
8690: 61 63 68 65 20 69 73 20 61 6c 72 65 61 64 79 20  ache is already 
86a0: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 50 43  .**           PC
86b0: 61 63 68 65 31 2e 6e 4d 61 78 2c 20 6f 72 0a 2a  ache1.nMax, or.*
86c0: 2a 0a 2a 2a 20 20 20 20 20 20 20 28 62 29 20 54  *.**       (b) T
86d0: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67  he number of pag
86e0: 65 73 20 61 6c 6c 6f 63 61 74 65 64 20 66 6f 72  es allocated for
86f0: 20 61 6c 6c 20 70 75 72 67 65 61 62 6c 65 20 63   all purgeable c
8700: 61 63 68 65 73 20 69 73 0a 2a 2a 20 20 20 20 20  aches is.**     
8710: 20 20 20 20 20 20 61 6c 72 65 61 64 79 20 65 71        already eq
8720: 75 61 6c 20 74 6f 20 6f 72 20 67 72 65 61 74 65  ual to or greate
8730: 72 20 74 68 61 6e 20 74 68 65 20 73 75 6d 20 6f  r than the sum o
8740: 66 20 6e 4d 61 78 20 66 6f 72 20 61 6c 6c 0a 2a  f nMax for all.*
8750: 2a 20 20 20 20 20 20 20 20 20 20 20 70 75 72 67  *           purg
8760: 65 61 62 6c 65 20 63 61 63 68 65 73 2c 0a 2a 2a  eable caches,.**
8770: 0a 2a 2a 20 20 20 20 20 20 20 28 63 29 20 54 68  .**       (c) Th
8780: 65 20 73 79 73 74 65 6d 20 69 73 20 75 6e 64 65  e system is unde
8790: 72 20 6d 65 6d 6f 72 79 20 70 72 65 73 73 75 72  r memory pressur
87a0: 65 20 61 6e 64 20 77 61 6e 74 73 20 74 6f 20 61  e and wants to a
87b0: 76 6f 69 64 0a 2a 2a 20 20 20 20 20 20 20 20 20  void.**         
87c0: 20 20 75 6e 6e 65 63 65 73 73 61 72 79 20 70 61    unnecessary pa
87d0: 67 65 73 20 63 61 63 68 65 20 65 6e 74 72 79 20  ges cache entry 
87e0: 61 6c 6c 6f 63 61 74 69 6f 6e 73 0a 2a 2a 0a 2a  allocations.**.*
87f0: 2a 20 20 20 20 20 20 74 68 65 6e 20 61 74 74 65  *      then atte
8800: 6d 70 74 20 74 6f 20 72 65 63 79 63 6c 65 20 61  mpt to recycle a
8810: 20 70 61 67 65 20 66 72 6f 6d 20 74 68 65 20 4c   page from the L
8820: 52 55 20 6c 69 73 74 2e 20 49 66 20 69 74 20 69  RU list. If it i
8830: 73 20 74 68 65 20 72 69 67 68 74 0a 2a 2a 20 20  s the right.**  
8840: 20 20 20 20 73 69 7a 65 2c 20 72 65 74 75 72 6e      size, return
8850: 20 74 68 65 20 72 65 63 79 63 6c 65 64 20 62 75   the recycled bu
8860: 66 66 65 72 2e 20 4f 74 68 65 72 77 69 73 65 2c  ffer. Otherwise,
8870: 20 66 72 65 65 20 74 68 65 20 62 75 66 66 65 72   free the buffer
8880: 20 61 6e 64 0a 2a 2a 20 20 20 20 20 20 70 72 6f   and.**      pro
8890: 63 65 65 64 20 74 6f 20 73 74 65 70 20 35 2e 20  ceed to step 5. 
88a0: 0a 2a 2a 0a 2a 2a 20 20 20 35 2e 20 4f 74 68 65  .**.**   5. Othe
88b0: 72 77 69 73 65 2c 20 61 6c 6c 6f 63 61 74 65 20  rwise, allocate 
88c0: 61 6e 64 20 72 65 74 75 72 6e 20 61 20 6e 65 77  and return a new
88d0: 20 70 61 67 65 20 62 75 66 66 65 72 2e 0a 2a 2a   page buffer..**
88e0: 0a 2a 2a 20 54 68 65 72 65 20 61 72 65 20 74 77  .** There are tw
88f0: 6f 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 74 68  o versions of th
8900: 69 73 20 72 6f 75 74 69 6e 65 2e 20 20 70 63 61  is routine.  pca
8910: 63 68 65 31 46 65 74 63 68 57 69 74 68 4d 75 74  che1FetchWithMut
8920: 65 78 28 29 20 69 73 0a 2a 2a 20 74 68 65 20 67  ex() is.** the g
8930: 65 6e 65 72 61 6c 20 63 61 73 65 2e 20 20 70 63  eneral case.  pc
8940: 61 63 68 65 31 46 65 74 63 68 4e 6f 4d 75 74 65  ache1FetchNoMute
8950: 78 28 29 20 69 73 20 61 20 66 61 73 74 65 72 20  x() is a faster 
8960: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 66  implementation f
8970: 6f 72 0a 2a 2a 20 74 68 65 20 63 6f 6d 6d 6f 6e  or.** the common
8980: 20 63 61 73 65 20 77 68 65 72 65 20 70 47 72 6f   case where pGro
8990: 75 70 2d 3e 6d 75 74 65 78 20 69 73 20 4e 55 4c  up->mutex is NUL
89a0: 4c 2e 20 20 54 68 65 20 70 63 61 63 68 65 31 46  L.  The pcache1F
89b0: 65 74 63 68 28 29 20 77 72 61 70 70 65 72 0a 2a  etch() wrapper.*
89c0: 2a 20 69 6e 76 6f 6b 65 73 20 74 68 65 20 61 70  * invokes the ap
89d0: 70 72 6f 70 72 69 61 74 65 20 72 6f 75 74 69 6e  propriate routin
89e0: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67 48  e..*/.static PgH
89f0: 64 72 31 20 2a 70 63 61 63 68 65 31 46 65 74 63  dr1 *pcache1Fetc
8a00: 68 4e 6f 4d 75 74 65 78 28 0a 20 20 73 71 6c 69  hNoMutex(.  sqli
8a10: 74 65 33 5f 70 63 61 63 68 65 20 2a 70 2c 20 0a  te3_pcache *p, .
8a20: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69    unsigned int i
8a30: 4b 65 79 2c 20 0a 20 20 69 6e 74 20 63 72 65 61  Key, .  int crea
8a40: 74 65 46 6c 61 67 0a 29 7b 0a 20 20 50 43 61 63  teFlag.){.  PCac
8a50: 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50  he1 *pCache = (P
8a60: 43 61 63 68 65 31 20 2a 29 70 3b 0a 20 20 50 67  Cache1 *)p;.  Pg
8a70: 48 64 72 31 20 2a 70 50 61 67 65 20 3d 20 30 3b  Hdr1 *pPage = 0;
8a80: 0a 0a 20 20 2f 2a 20 53 74 65 70 20 31 3a 20 53  ..  /* Step 1: S
8a90: 65 61 72 63 68 20 74 68 65 20 68 61 73 68 20 74  earch the hash t
8aa0: 61 62 6c 65 20 66 6f 72 20 61 6e 20 65 78 69 73  able for an exis
8ab0: 74 69 6e 67 20 65 6e 74 72 79 2e 20 2a 2f 0a 20  ting entry. */. 
8ac0: 20 70 50 61 67 65 20 3d 20 70 43 61 63 68 65 2d   pPage = pCache-
8ad0: 3e 61 70 48 61 73 68 5b 69 4b 65 79 20 25 20 70  >apHash[iKey % p
8ae0: 43 61 63 68 65 2d 3e 6e 48 61 73 68 5d 3b 0a 20  Cache->nHash];. 
8af0: 20 77 68 69 6c 65 28 20 70 50 61 67 65 20 26 26   while( pPage &&
8b00: 20 70 50 61 67 65 2d 3e 69 4b 65 79 21 3d 69 4b   pPage->iKey!=iK
8b10: 65 79 20 29 7b 20 70 50 61 67 65 20 3d 20 70 50  ey ){ pPage = pP
8b20: 61 67 65 2d 3e 70 4e 65 78 74 3b 20 7d 0a 0a 20  age->pNext; }.. 
8b30: 20 2f 2a 20 53 74 65 70 20 32 3a 20 49 66 20 74   /* Step 2: If t
8b40: 68 65 20 70 61 67 65 20 77 61 73 20 66 6f 75 6e  he page was foun
8b50: 64 20 69 6e 20 74 68 65 20 68 61 73 68 20 74 61  d in the hash ta
8b60: 62 6c 65 2c 20 74 68 65 6e 20 72 65 74 75 72 6e  ble, then return
8b70: 20 69 74 2e 0a 20 20 2a 2a 20 49 66 20 74 68 65   it..  ** If the
8b80: 20 70 61 67 65 20 77 61 73 20 6e 6f 74 20 69 6e   page was not in
8b90: 20 74 68 65 20 68 61 73 68 20 74 61 62 6c 65 20   the hash table 
8ba0: 61 6e 64 20 63 72 65 61 74 65 46 6c 61 67 20 69  and createFlag i
8bb0: 73 20 30 2c 20 61 62 6f 72 74 2e 0a 20 20 2a 2a  s 0, abort..  **
8bc0: 20 4f 74 68 65 72 77 69 73 65 20 28 70 61 67 65   Otherwise (page
8bd0: 20 6e 6f 74 20 69 6e 20 68 61 73 68 20 61 6e 64   not in hash and
8be0: 20 63 72 65 61 74 65 46 6c 61 67 21 3d 30 29 20   createFlag!=0) 
8bf0: 63 6f 6e 74 69 6e 75 65 20 77 69 74 68 0a 20 20  continue with.  
8c00: 2a 2a 20 73 75 62 73 65 71 75 65 6e 74 20 73 74  ** subsequent st
8c10: 65 70 73 20 74 6f 20 74 72 79 20 74 6f 20 63 72  eps to try to cr
8c20: 65 61 74 65 20 74 68 65 20 70 61 67 65 2e 20 2a  eate the page. *
8c30: 2f 0a 20 20 69 66 28 20 70 50 61 67 65 20 29 7b  /.  if( pPage ){
8c40: 0a 20 20 20 20 69 66 28 20 50 41 47 45 5f 49 53  .    if( PAGE_IS
8c50: 5f 55 4e 50 49 4e 4e 45 44 28 70 50 61 67 65 29  _UNPINNED(pPage)
8c60: 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e   ){.      return
8c70: 20 70 63 61 63 68 65 31 50 69 6e 50 61 67 65 28   pcache1PinPage(
8c80: 70 50 61 67 65 29 3b 0a 20 20 20 20 7d 65 6c 73  pPage);.    }els
8c90: 65 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  e{.      return 
8ca0: 70 50 61 67 65 3b 0a 20 20 20 20 7d 0a 20 20 7d  pPage;.    }.  }
8cb0: 65 6c 73 65 20 69 66 28 20 63 72 65 61 74 65 46  else if( createF
8cc0: 6c 61 67 20 29 7b 0a 20 20 20 20 2f 2a 20 53 74  lag ){.    /* St
8cd0: 65 70 73 20 33 2c 20 34 2c 20 61 6e 64 20 35 20  eps 3, 4, and 5 
8ce0: 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62 79 20 74  implemented by t
8cf0: 68 69 73 20 73 75 62 72 6f 75 74 69 6e 65 20 2a  his subroutine *
8d00: 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 70 63 61  /.    return pca
8d10: 63 68 65 31 46 65 74 63 68 53 74 61 67 65 32 28  che1FetchStage2(
8d20: 70 43 61 63 68 65 2c 20 69 4b 65 79 2c 20 63 72  pCache, iKey, cr
8d30: 65 61 74 65 46 6c 61 67 29 3b 0a 20 20 7d 65 6c  eateFlag);.  }el
8d40: 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30  se{.    return 0
8d50: 3b 0a 20 20 7d 0a 7d 0a 23 69 66 20 50 43 41 43  ;.  }.}.#if PCAC
8d60: 48 45 31 5f 4d 49 47 48 54 5f 55 53 45 5f 47 52  HE1_MIGHT_USE_GR
8d70: 4f 55 50 5f 4d 55 54 45 58 0a 73 74 61 74 69 63  OUP_MUTEX.static
8d80: 20 50 67 48 64 72 31 20 2a 70 63 61 63 68 65 31   PgHdr1 *pcache1
8d90: 46 65 74 63 68 57 69 74 68 4d 75 74 65 78 28 0a  FetchWithMutex(.
8da0: 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65    sqlite3_pcache
8db0: 20 2a 70 2c 20 0a 20 20 75 6e 73 69 67 6e 65 64   *p, .  unsigned
8dc0: 20 69 6e 74 20 69 4b 65 79 2c 20 0a 20 20 69 6e   int iKey, .  in
8dd0: 74 20 63 72 65 61 74 65 46 6c 61 67 0a 29 7b 0a  t createFlag.){.
8de0: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68    PCache1 *pCach
8df0: 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70  e = (PCache1 *)p
8e00: 3b 0a 20 20 50 67 48 64 72 31 20 2a 70 50 61 67  ;.  PgHdr1 *pPag
8e10: 65 3b 0a 0a 20 20 70 63 61 63 68 65 31 45 6e 74  e;..  pcache1Ent
8e20: 65 72 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e  erMutex(pCache->
8e30: 70 47 72 6f 75 70 29 3b 0a 20 20 70 50 61 67 65  pGroup);.  pPage
8e40: 20 3d 20 70 63 61 63 68 65 31 46 65 74 63 68 4e   = pcache1FetchN
8e50: 6f 4d 75 74 65 78 28 70 2c 20 69 4b 65 79 2c 20  oMutex(p, iKey, 
8e60: 63 72 65 61 74 65 46 6c 61 67 29 3b 0a 20 20 61  createFlag);.  a
8e70: 73 73 65 72 74 28 20 70 50 61 67 65 3d 3d 30 20  ssert( pPage==0 
8e80: 7c 7c 20 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b  || pCache->iMaxK
8e90: 65 79 3e 3d 69 4b 65 79 20 29 3b 0a 20 20 70 63  ey>=iKey );.  pc
8ea0: 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28  ache1LeaveMutex(
8eb0: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b  pCache->pGroup);
8ec0: 0a 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 3b  .  return pPage;
8ed0: 0a 7d 0a 23 65 6e 64 69 66 0a 73 74 61 74 69 63  .}.#endif.static
8ee0: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f   sqlite3_pcache_
8ef0: 70 61 67 65 20 2a 70 63 61 63 68 65 31 46 65 74  page *pcache1Fet
8f00: 63 68 28 0a 20 20 73 71 6c 69 74 65 33 5f 70 63  ch(.  sqlite3_pc
8f10: 61 63 68 65 20 2a 70 2c 20 0a 20 20 75 6e 73 69  ache *p, .  unsi
8f20: 67 6e 65 64 20 69 6e 74 20 69 4b 65 79 2c 20 0a  gned int iKey, .
8f30: 20 20 69 6e 74 20 63 72 65 61 74 65 46 6c 61 67    int createFlag
8f40: 0a 29 7b 0a 23 69 66 20 50 43 41 43 48 45 31 5f  .){.#if PCACHE1_
8f50: 4d 49 47 48 54 5f 55 53 45 5f 47 52 4f 55 50 5f  MIGHT_USE_GROUP_
8f60: 4d 55 54 45 58 20 7c 7c 20 64 65 66 69 6e 65 64  MUTEX || defined
8f70: 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29 0a 20  (SQLITE_DEBUG). 
8f80: 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65   PCache1 *pCache
8f90: 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b   = (PCache1 *)p;
8fa0: 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73 73 65 72  .#endif..  asser
8fb0: 74 28 20 6f 66 66 73 65 74 6f 66 28 50 67 48 64  t( offsetof(PgHd
8fc0: 72 31 2c 70 61 67 65 29 3d 3d 30 20 29 3b 0a 20  r1,page)==0 );. 
8fd0: 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65 2d   assert( pCache-
8fe0: 3e 62 50 75 72 67 65 61 62 6c 65 20 7c 7c 20 63  >bPurgeable || c
8ff0: 72 65 61 74 65 46 6c 61 67 21 3d 31 20 29 3b 0a  reateFlag!=1 );.
9000: 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65    assert( pCache
9010: 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 7c 7c 20  ->bPurgeable || 
9020: 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 3d 3d 30 20  pCache->nMin==0 
9030: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61  );.  assert( pCa
9040: 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 3d  che->bPurgeable=
9050: 3d 30 20 7c 7c 20 70 43 61 63 68 65 2d 3e 6e 4d  =0 || pCache->nM
9060: 69 6e 3d 3d 31 30 20 29 3b 0a 20 20 61 73 73 65  in==10 );.  asse
9070: 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e  rt( pCache->nMin
9080: 3d 3d 30 20 7c 7c 20 70 43 61 63 68 65 2d 3e 62  ==0 || pCache->b
9090: 50 75 72 67 65 61 62 6c 65 20 29 3b 0a 20 20 61  Purgeable );.  a
90a0: 73 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 6e  ssert( pCache->n
90b0: 48 61 73 68 3e 30 20 29 3b 0a 23 69 66 20 50 43  Hash>0 );.#if PC
90c0: 41 43 48 45 31 5f 4d 49 47 48 54 5f 55 53 45 5f  ACHE1_MIGHT_USE_
90d0: 47 52 4f 55 50 5f 4d 55 54 45 58 0a 20 20 69 66  GROUP_MUTEX.  if
90e0: 28 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70  ( pCache->pGroup
90f0: 2d 3e 6d 75 74 65 78 20 29 7b 0a 20 20 20 20 72  ->mutex ){.    r
9100: 65 74 75 72 6e 20 28 73 71 6c 69 74 65 33 5f 70  eturn (sqlite3_p
9110: 63 61 63 68 65 5f 70 61 67 65 2a 29 70 63 61 63  cache_page*)pcac
9120: 68 65 31 46 65 74 63 68 57 69 74 68 4d 75 74 65  he1FetchWithMute
9130: 78 28 70 2c 20 69 4b 65 79 2c 20 63 72 65 61 74  x(p, iKey, creat
9140: 65 46 6c 61 67 29 3b 0a 20 20 7d 65 6c 73 65 0a  eFlag);.  }else.
9150: 23 65 6e 64 69 66 0a 20 20 7b 0a 20 20 20 20 72  #endif.  {.    r
9160: 65 74 75 72 6e 20 28 73 71 6c 69 74 65 33 5f 70  eturn (sqlite3_p
9170: 63 61 63 68 65 5f 70 61 67 65 2a 29 70 63 61 63  cache_page*)pcac
9180: 68 65 31 46 65 74 63 68 4e 6f 4d 75 74 65 78 28  he1FetchNoMutex(
9190: 70 2c 20 69 4b 65 79 2c 20 63 72 65 61 74 65 46  p, iKey, createF
91a0: 6c 61 67 29 3b 0a 20 20 7d 0a 7d 0a 0a 0a 2f 2a  lag);.  }.}.../*
91b0: 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69  .** Implementati
91c0: 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65  on of the sqlite
91d0: 33 5f 70 63 61 63 68 65 2e 78 55 6e 70 69 6e 20  3_pcache.xUnpin 
91e0: 6d 65 74 68 6f 64 2e 0a 2a 2a 0a 2a 2a 20 4d 61  method..**.** Ma
91f0: 72 6b 20 61 20 70 61 67 65 20 61 73 20 75 6e 70  rk a page as unp
9200: 69 6e 6e 65 64 20 28 65 6c 69 67 69 62 6c 65 20  inned (eligible 
9210: 66 6f 72 20 61 73 79 6e 63 68 72 6f 6e 6f 75 73  for asynchronous
9220: 20 72 65 63 79 63 6c 69 6e 67 29 2e 0a 2a 2f 0a   recycling)..*/.
9230: 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63  static void pcac
9240: 68 65 31 55 6e 70 69 6e 28 0a 20 20 73 71 6c 69  he1Unpin(.  sqli
9250: 74 65 33 5f 70 63 61 63 68 65 20 2a 70 2c 20 0a  te3_pcache *p, .
9260: 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65    sqlite3_pcache
9270: 5f 70 61 67 65 20 2a 70 50 67 2c 20 0a 20 20 69  _page *pPg, .  i
9280: 6e 74 20 72 65 75 73 65 55 6e 6c 69 6b 65 6c 79  nt reuseUnlikely
9290: 0a 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70  .){.  PCache1 *p
92a0: 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 65 31  Cache = (PCache1
92b0: 20 2a 29 70 3b 0a 20 20 50 67 48 64 72 31 20 2a   *)p;.  PgHdr1 *
92c0: 70 50 61 67 65 20 3d 20 28 50 67 48 64 72 31 20  pPage = (PgHdr1 
92d0: 2a 29 70 50 67 3b 0a 20 20 50 47 72 6f 75 70 20  *)pPg;.  PGroup 
92e0: 2a 70 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65  *pGroup = pCache
92f0: 2d 3e 70 47 72 6f 75 70 3b 0a 20 0a 20 20 61 73  ->pGroup;. .  as
9300: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 43 61  sert( pPage->pCa
9310: 63 68 65 3d 3d 70 43 61 63 68 65 20 29 3b 0a 20  che==pCache );. 
9320: 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74   pcache1EnterMut
9330: 65 78 28 70 47 72 6f 75 70 29 3b 0a 0a 20 20 2f  ex(pGroup);..  /
9340: 2a 20 49 74 20 69 73 20 61 6e 20 65 72 72 6f 72  * It is an error
9350: 20 74 6f 20 63 61 6c 6c 20 74 68 69 73 20 66 75   to call this fu
9360: 6e 63 74 69 6f 6e 20 69 66 20 74 68 65 20 70 61  nction if the pa
9370: 67 65 20 69 73 20 61 6c 72 65 61 64 79 20 0a 20  ge is already . 
9380: 20 2a 2a 20 70 61 72 74 20 6f 66 20 74 68 65 20   ** part of the 
9390: 50 47 72 6f 75 70 20 4c 52 55 20 6c 69 73 74 2e  PGroup LRU list.
93a0: 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20  .  */.  assert( 
93b0: 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74 3d  pPage->pLruNext=
93c0: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  =0 );.  assert( 
93d0: 50 41 47 45 5f 49 53 5f 50 49 4e 4e 45 44 28 70  PAGE_IS_PINNED(p
93e0: 50 61 67 65 29 20 29 3b 0a 0a 20 20 69 66 28 20  Page) );..  if( 
93f0: 72 65 75 73 65 55 6e 6c 69 6b 65 6c 79 20 7c 7c  reuseUnlikely ||
9400: 20 70 47 72 6f 75 70 2d 3e 6e 50 75 72 67 65 61   pGroup->nPurgea
9410: 62 6c 65 3e 70 47 72 6f 75 70 2d 3e 6e 4d 61 78  ble>pGroup->nMax
9420: 50 61 67 65 20 29 7b 0a 20 20 20 20 70 63 61 63  Page ){.    pcac
9430: 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73  he1RemoveFromHas
9440: 68 28 70 50 61 67 65 2c 20 31 29 3b 0a 20 20 7d  h(pPage, 1);.  }
9450: 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 41 64 64  else{.    /* Add
9460: 20 74 68 65 20 70 61 67 65 20 74 6f 20 74 68 65   the page to the
9470: 20 50 47 72 6f 75 70 20 4c 52 55 20 6c 69 73 74   PGroup LRU list
9480: 2e 20 2a 2f 0a 20 20 20 20 50 67 48 64 72 31 20  . */.    PgHdr1 
9490: 2a 2a 70 70 46 69 72 73 74 20 3d 20 26 70 47 72  **ppFirst = &pGr
94a0: 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72 75 4e 65 78  oup->lru.pLruNex
94b0: 74 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 70 4c  t;.    pPage->pL
94c0: 72 75 50 72 65 76 20 3d 20 26 70 47 72 6f 75 70  ruPrev = &pGroup
94d0: 2d 3e 6c 72 75 3b 0a 20 20 20 20 28 70 50 61 67  ->lru;.    (pPag
94e0: 65 2d 3e 70 4c 72 75 4e 65 78 74 20 3d 20 2a 70  e->pLruNext = *p
94f0: 70 46 69 72 73 74 29 2d 3e 70 4c 72 75 50 72 65  pFirst)->pLruPre
9500: 76 20 3d 20 70 50 61 67 65 3b 0a 20 20 20 20 2a  v = pPage;.    *
9510: 70 70 46 69 72 73 74 20 3d 20 70 50 61 67 65 3b  ppFirst = pPage;
9520: 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 52 65  .    pCache->nRe
9530: 63 79 63 6c 61 62 6c 65 2b 2b 3b 0a 20 20 7d 0a  cyclable++;.  }.
9540: 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d  .  pcache1LeaveM
9550: 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72  utex(pCache->pGr
9560: 6f 75 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49  oup);.}../*.** I
9570: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66  mplementation of
9580: 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61   the sqlite3_pca
9590: 63 68 65 2e 78 52 65 6b 65 79 20 6d 65 74 68 6f  che.xRekey metho
95a0: 64 2e 20 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  d. .*/.static vo
95b0: 69 64 20 70 63 61 63 68 65 31 52 65 6b 65 79 28  id pcache1Rekey(
95c0: 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68  .  sqlite3_pcach
95d0: 65 20 2a 70 2c 0a 20 20 73 71 6c 69 74 65 33 5f  e *p,.  sqlite3_
95e0: 70 63 61 63 68 65 5f 70 61 67 65 20 2a 70 50 67  pcache_page *pPg
95f0: 2c 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74  ,.  unsigned int
9600: 20 69 4f 6c 64 2c 0a 20 20 75 6e 73 69 67 6e 65   iOld,.  unsigne
9610: 64 20 69 6e 74 20 69 4e 65 77 0a 29 7b 0a 20 20  d int iNew.){.  
9620: 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 20  PCache1 *pCache 
9630: 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b 0a  = (PCache1 *)p;.
9640: 20 20 50 67 48 64 72 31 20 2a 70 50 61 67 65 20    PgHdr1 *pPage 
9650: 3d 20 28 50 67 48 64 72 31 20 2a 29 70 50 67 3b  = (PgHdr1 *)pPg;
9660: 0a 20 20 50 67 48 64 72 31 20 2a 2a 70 70 3b 0a  .  PgHdr1 **pp;.
9670: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 68    unsigned int h
9680: 3b 20 0a 20 20 61 73 73 65 72 74 28 20 70 50 61  ; .  assert( pPa
9690: 67 65 2d 3e 69 4b 65 79 3d 3d 69 4f 6c 64 20 29  ge->iKey==iOld )
96a0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67  ;.  assert( pPag
96b0: 65 2d 3e 70 43 61 63 68 65 3d 3d 70 43 61 63 68  e->pCache==pCach
96c0: 65 20 29 3b 0a 0a 20 20 70 63 61 63 68 65 31 45  e );..  pcache1E
96d0: 6e 74 65 72 4d 75 74 65 78 28 70 43 61 63 68 65  nterMutex(pCache
96e0: 2d 3e 70 47 72 6f 75 70 29 3b 0a 0a 20 20 68 20  ->pGroup);..  h 
96f0: 3d 20 69 4f 6c 64 25 70 43 61 63 68 65 2d 3e 6e  = iOld%pCache->n
9700: 48 61 73 68 3b 0a 20 20 70 70 20 3d 20 26 70 43  Hash;.  pp = &pC
9710: 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 3b  ache->apHash[h];
9720: 0a 20 20 77 68 69 6c 65 28 20 28 2a 70 70 29 21  .  while( (*pp)!
9730: 3d 70 50 61 67 65 20 29 7b 0a 20 20 20 20 70 70  =pPage ){.    pp
9740: 20 3d 20 26 28 2a 70 70 29 2d 3e 70 4e 65 78 74   = &(*pp)->pNext
9750: 3b 0a 20 20 7d 0a 20 20 2a 70 70 20 3d 20 70 50  ;.  }.  *pp = pP
9760: 61 67 65 2d 3e 70 4e 65 78 74 3b 0a 0a 20 20 68  age->pNext;..  h
9770: 20 3d 20 69 4e 65 77 25 70 43 61 63 68 65 2d 3e   = iNew%pCache->
9780: 6e 48 61 73 68 3b 0a 20 20 70 50 61 67 65 2d 3e  nHash;.  pPage->
9790: 69 4b 65 79 20 3d 20 69 4e 65 77 3b 0a 20 20 70  iKey = iNew;.  p
97a0: 50 61 67 65 2d 3e 70 4e 65 78 74 20 3d 20 70 43  Page->pNext = pC
97b0: 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 3b  ache->apHash[h];
97c0: 0a 20 20 70 43 61 63 68 65 2d 3e 61 70 48 61 73  .  pCache->apHas
97d0: 68 5b 68 5d 20 3d 20 70 50 61 67 65 3b 0a 20 20  h[h] = pPage;.  
97e0: 69 66 28 20 69 4e 65 77 3e 70 43 61 63 68 65 2d  if( iNew>pCache-
97f0: 3e 69 4d 61 78 4b 65 79 20 29 7b 0a 20 20 20 20  >iMaxKey ){.    
9800: 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20  pCache->iMaxKey 
9810: 3d 20 69 4e 65 77 3b 0a 20 20 7d 0a 0a 20 20 70  = iNew;.  }..  p
9820: 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78  cache1LeaveMutex
9830: 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29  (pCache->pGroup)
9840: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65  ;.}../*.** Imple
9850: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65  mentation of the
9860: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e   sqlite3_pcache.
9870: 78 54 72 75 6e 63 61 74 65 20 6d 65 74 68 6f 64  xTruncate method
9880: 2e 20 0a 2a 2a 0a 2a 2a 20 44 69 73 63 61 72 64  . .**.** Discard
9890: 20 61 6c 6c 20 75 6e 70 69 6e 6e 65 64 20 70 61   all unpinned pa
98a0: 67 65 73 20 69 6e 20 74 68 65 20 63 61 63 68 65  ges in the cache
98b0: 20 77 69 74 68 20 61 20 70 61 67 65 20 6e 75 6d   with a page num
98c0: 62 65 72 20 65 71 75 61 6c 20 74 6f 0a 2a 2a 20  ber equal to.** 
98d0: 6f 72 20 67 72 65 61 74 65 72 20 74 68 61 6e 20  or greater than 
98e0: 70 61 72 61 6d 65 74 65 72 20 69 4c 69 6d 69 74  parameter iLimit
98f0: 2e 20 41 6e 79 20 70 69 6e 6e 65 64 20 70 61 67  . Any pinned pag
9900: 65 73 20 77 69 74 68 20 61 20 70 61 67 65 20 6e  es with a page n
9910: 75 6d 62 65 72 0a 2a 2a 20 65 71 75 61 6c 20 74  umber.** equal t
9920: 6f 20 6f 72 20 67 72 65 61 74 65 72 20 74 68 61  o or greater tha
9930: 6e 20 69 4c 69 6d 69 74 20 61 72 65 20 69 6d 70  n iLimit are imp
9940: 6c 69 63 69 74 6c 79 20 75 6e 70 69 6e 6e 65 64  licitly unpinned
9950: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
9960: 20 70 63 61 63 68 65 31 54 72 75 6e 63 61 74 65   pcache1Truncate
9970: 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20  (sqlite3_pcache 
9980: 2a 70 2c 20 75 6e 73 69 67 6e 65 64 20 69 6e 74  *p, unsigned int
9990: 20 69 4c 69 6d 69 74 29 7b 0a 20 20 50 43 61 63   iLimit){.  PCac
99a0: 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50  he1 *pCache = (P
99b0: 43 61 63 68 65 31 20 2a 29 70 3b 0a 20 20 70 63  Cache1 *)p;.  pc
99c0: 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28  ache1EnterMutex(
99d0: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b  pCache->pGroup);
99e0: 0a 20 20 69 66 28 20 69 4c 69 6d 69 74 3c 3d 70  .  if( iLimit<=p
99f0: 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 29  Cache->iMaxKey )
9a00: 7b 0a 20 20 20 20 70 63 61 63 68 65 31 54 72 75  {.    pcache1Tru
9a10: 6e 63 61 74 65 55 6e 73 61 66 65 28 70 43 61 63  ncateUnsafe(pCac
9a20: 68 65 2c 20 69 4c 69 6d 69 74 29 3b 0a 20 20 20  he, iLimit);.   
9a30: 20 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79   pCache->iMaxKey
9a40: 20 3d 20 69 4c 69 6d 69 74 2d 31 3b 0a 20 20 7d   = iLimit-1;.  }
9a50: 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d  .  pcache1LeaveM
9a60: 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72  utex(pCache->pGr
9a70: 6f 75 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49  oup);.}../*.** I
9a80: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66  mplementation of
9a90: 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61   the sqlite3_pca
9aa0: 63 68 65 2e 78 44 65 73 74 72 6f 79 20 6d 65 74  che.xDestroy met
9ab0: 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 44 65 73 74  hod. .**.** Dest
9ac0: 72 6f 79 20 61 20 63 61 63 68 65 20 61 6c 6c 6f  roy a cache allo
9ad0: 63 61 74 65 64 20 75 73 69 6e 67 20 70 63 61 63  cated using pcac
9ae0: 68 65 31 43 72 65 61 74 65 28 29 2e 0a 2a 2f 0a  he1Create()..*/.
9af0: 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63  static void pcac
9b00: 68 65 31 44 65 73 74 72 6f 79 28 73 71 6c 69 74  he1Destroy(sqlit
9b10: 65 33 5f 70 63 61 63 68 65 20 2a 70 29 7b 0a 20  e3_pcache *p){. 
9b20: 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65   PCache1 *pCache
9b30: 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b   = (PCache1 *)p;
9b40: 0a 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f 75  .  PGroup *pGrou
9b50: 70 20 3d 20 70 43 61 63 68 65 2d 3e 70 47 72 6f  p = pCache->pGro
9b60: 75 70 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43  up;.  assert( pC
9b70: 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65  ache->bPurgeable
9b80: 20 7c 7c 20 28 70 43 61 63 68 65 2d 3e 6e 4d 61   || (pCache->nMa
9b90: 78 3d 3d 30 20 26 26 20 70 43 61 63 68 65 2d 3e  x==0 && pCache->
9ba0: 6e 4d 69 6e 3d 3d 30 29 20 29 3b 0a 20 20 70 63  nMin==0) );.  pc
9bb0: 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28  ache1EnterMutex(
9bc0: 70 47 72 6f 75 70 29 3b 0a 20 20 69 66 28 20 70  pGroup);.  if( p
9bd0: 43 61 63 68 65 2d 3e 6e 50 61 67 65 20 29 20 70  Cache->nPage ) p
9be0: 63 61 63 68 65 31 54 72 75 6e 63 61 74 65 55 6e  cache1TruncateUn
9bf0: 73 61 66 65 28 70 43 61 63 68 65 2c 20 30 29 3b  safe(pCache, 0);
9c00: 0a 20 20 61 73 73 65 72 74 28 20 70 47 72 6f 75  .  assert( pGrou
9c10: 70 2d 3e 6e 4d 61 78 50 61 67 65 20 3e 3d 20 70  p->nMaxPage >= p
9c20: 43 61 63 68 65 2d 3e 6e 4d 61 78 20 29 3b 0a 20  Cache->nMax );. 
9c30: 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67   pGroup->nMaxPag
9c40: 65 20 2d 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 61  e -= pCache->nMa
9c50: 78 3b 0a 20 20 61 73 73 65 72 74 28 20 70 47 72  x;.  assert( pGr
9c60: 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 20 3e 3d  oup->nMinPage >=
9c70: 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 20 29 3b   pCache->nMin );
9c80: 0a 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50  .  pGroup->nMinP
9c90: 61 67 65 20 2d 3d 20 70 43 61 63 68 65 2d 3e 6e  age -= pCache->n
9ca0: 4d 69 6e 3b 0a 20 20 70 47 72 6f 75 70 2d 3e 6d  Min;.  pGroup->m
9cb0: 78 50 69 6e 6e 65 64 20 3d 20 70 47 72 6f 75 70  xPinned = pGroup
9cc0: 2d 3e 6e 4d 61 78 50 61 67 65 20 2b 20 31 30 20  ->nMaxPage + 10 
9cd0: 2d 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61  - pGroup->nMinPa
9ce0: 67 65 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 66  ge;.  pcache1Enf
9cf0: 6f 72 63 65 4d 61 78 50 61 67 65 28 70 43 61 63  orceMaxPage(pCac
9d00: 68 65 29 3b 0a 20 20 70 63 61 63 68 65 31 4c 65  he);.  pcache1Le
9d10: 61 76 65 4d 75 74 65 78 28 70 47 72 6f 75 70 29  aveMutex(pGroup)
9d20: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65  ;.  sqlite3_free
9d30: 28 70 43 61 63 68 65 2d 3e 70 42 75 6c 6b 29 3b  (pCache->pBulk);
9d40: 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28  .  sqlite3_free(
9d50: 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 29 3b  pCache->apHash);
9d60: 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28  .  sqlite3_free(
9d70: 70 43 61 63 68 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  pCache);.}../*.*
9d80: 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  * This function 
9d90: 69 73 20 63 61 6c 6c 65 64 20 64 75 72 69 6e 67  is called during
9da0: 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20   initialization 
9db0: 28 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c  (sqlite3_initial
9dc0: 69 7a 65 28 29 29 20 74 6f 0a 2a 2a 20 69 6e 73  ize()) to.** ins
9dd0: 74 61 6c 6c 20 74 68 65 20 64 65 66 61 75 6c 74  tall the default
9de0: 20 70 6c 75 67 67 61 62 6c 65 20 63 61 63 68 65   pluggable cache
9df0: 20 6d 6f 64 75 6c 65 2c 20 61 73 73 75 6d 69 6e   module, assumin
9e00: 67 20 74 68 65 20 75 73 65 72 20 68 61 73 20 6e  g the user has n
9e10: 6f 74 0a 2a 2a 20 61 6c 72 65 61 64 79 20 70 72  ot.** already pr
9e20: 6f 76 69 64 65 64 20 61 6e 20 61 6c 74 65 72 6e  ovided an altern
9e30: 61 74 69 76 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73  ative..*/.void s
9e40: 71 6c 69 74 65 33 50 43 61 63 68 65 53 65 74 44  qlite3PCacheSetD
9e50: 65 66 61 75 6c 74 28 76 6f 69 64 29 7b 0a 20 20  efault(void){.  
9e60: 73 74 61 74 69 63 20 63 6f 6e 73 74 20 73 71 6c  static const sql
9e70: 69 74 65 33 5f 70 63 61 63 68 65 5f 6d 65 74 68  ite3_pcache_meth
9e80: 6f 64 73 32 20 64 65 66 61 75 6c 74 4d 65 74 68  ods2 defaultMeth
9e90: 6f 64 73 20 3d 20 7b 0a 20 20 20 20 31 2c 20 20  ods = {.    1,  
9ea0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
9eb0: 20 20 20 20 20 2f 2a 20 69 56 65 72 73 69 6f 6e       /* iVersion
9ec0: 20 2a 2f 0a 20 20 20 20 30 2c 20 20 20 20 20 20   */.    0,      
9ed0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
9ee0: 20 2f 2a 20 70 41 72 67 20 2a 2f 0a 20 20 20 20   /* pArg */.    
9ef0: 70 63 61 63 68 65 31 49 6e 69 74 2c 20 20 20 20  pcache1Init,    
9f00: 20 20 20 20 20 20 20 20 20 2f 2a 20 78 49 6e 69           /* xIni
9f10: 74 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31  t */.    pcache1
9f20: 53 68 75 74 64 6f 77 6e 2c 20 20 20 20 20 20 20  Shutdown,       
9f30: 20 20 2f 2a 20 78 53 68 75 74 64 6f 77 6e 20 2a    /* xShutdown *
9f40: 2f 0a 20 20 20 20 70 63 61 63 68 65 31 43 72 65  /.    pcache1Cre
9f50: 61 74 65 2c 20 20 20 20 20 20 20 20 20 20 20 2f  ate,           /
9f60: 2a 20 78 43 72 65 61 74 65 20 2a 2f 0a 20 20 20  * xCreate */.   
9f70: 20 70 63 61 63 68 65 31 43 61 63 68 65 73 69 7a   pcache1Cachesiz
9f80: 65 2c 20 20 20 20 20 20 20 20 2f 2a 20 78 43 61  e,        /* xCa
9f90: 63 68 65 73 69 7a 65 20 2a 2f 0a 20 20 20 20 70  chesize */.    p
9fa0: 63 61 63 68 65 31 50 61 67 65 63 6f 75 6e 74 2c  cache1Pagecount,
9fb0: 20 20 20 20 20 20 20 20 2f 2a 20 78 50 61 67 65          /* xPage
9fc0: 63 6f 75 6e 74 20 2a 2f 0a 20 20 20 20 70 63 61  count */.    pca
9fd0: 63 68 65 31 46 65 74 63 68 2c 20 20 20 20 20 20  che1Fetch,      
9fe0: 20 20 20 20 20 20 2f 2a 20 78 46 65 74 63 68 20        /* xFetch 
9ff0: 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 55 6e  */.    pcache1Un
a000: 70 69 6e 2c 20 20 20 20 20 20 20 20 20 20 20 20  pin,            
a010: 2f 2a 20 78 55 6e 70 69 6e 20 2a 2f 0a 20 20 20  /* xUnpin */.   
a020: 20 70 63 61 63 68 65 31 52 65 6b 65 79 2c 20 20   pcache1Rekey,  
a030: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 52 65            /* xRe
a040: 6b 65 79 20 2a 2f 0a 20 20 20 20 70 63 61 63 68  key */.    pcach
a050: 65 31 54 72 75 6e 63 61 74 65 2c 20 20 20 20 20  e1Truncate,     
a060: 20 20 20 20 2f 2a 20 78 54 72 75 6e 63 61 74 65      /* xTruncate
a070: 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 44   */.    pcache1D
a080: 65 73 74 72 6f 79 2c 20 20 20 20 20 20 20 20 20  estroy,         
a090: 20 2f 2a 20 78 44 65 73 74 72 6f 79 20 2a 2f 0a   /* xDestroy */.
a0a0: 20 20 20 20 70 63 61 63 68 65 31 53 68 72 69 6e      pcache1Shrin
a0b0: 6b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20  k            /* 
a0c0: 78 53 68 72 69 6e 6b 20 2a 2f 0a 20 20 7d 3b 0a  xShrink */.  };.
a0d0: 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67    sqlite3_config
a0e0: 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50  (SQLITE_CONFIG_P
a0f0: 43 41 43 48 45 32 2c 20 26 64 65 66 61 75 6c 74  CACHE2, &default
a100: 4d 65 74 68 6f 64 73 29 3b 0a 7d 0a 0a 2f 2a 0a  Methods);.}../*.
a110: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 73 69  ** Return the si
a120: 7a 65 20 6f 66 20 74 68 65 20 68 65 61 64 65 72  ze of the header
a130: 20 6f 6e 20 65 61 63 68 20 70 61 67 65 20 6f 66   on each page of
a140: 20 74 68 69 73 20 50 43 41 43 48 45 20 69 6d 70   this PCACHE imp
a150: 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 0a 2a 2f 0a  lementation..*/.
a160: 69 6e 74 20 73 71 6c 69 74 65 33 48 65 61 64 65  int sqlite3Heade
a170: 72 53 69 7a 65 50 63 61 63 68 65 31 28 76 6f 69  rSizePcache1(voi
a180: 64 29 7b 20 72 65 74 75 72 6e 20 52 4f 55 4e 44  d){ return ROUND
a190: 38 28 73 69 7a 65 6f 66 28 50 67 48 64 72 31 29  8(sizeof(PgHdr1)
a1a0: 29 3b 20 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  ); }../*.** Retu
a1b0: 72 6e 20 74 68 65 20 67 6c 6f 62 61 6c 20 6d 75  rn the global mu
a1c0: 74 65 78 20 75 73 65 64 20 62 79 20 74 68 69 73  tex used by this
a1d0: 20 50 43 41 43 48 45 20 69 6d 70 6c 65 6d 65 6e   PCACHE implemen
a1e0: 74 61 74 69 6f 6e 2e 20 20 54 68 65 0a 2a 2a 20  tation.  The.** 
a1f0: 73 71 6c 69 74 65 33 5f 73 74 61 74 75 73 28 29  sqlite3_status()
a200: 20 72 6f 75 74 69 6e 65 20 6e 65 65 64 73 20 61   routine needs a
a210: 63 63 65 73 73 20 74 6f 20 74 68 69 73 20 6d 75  ccess to this mu
a220: 74 65 78 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f  tex..*/.sqlite3_
a230: 6d 75 74 65 78 20 2a 73 71 6c 69 74 65 33 50 63  mutex *sqlite3Pc
a240: 61 63 68 65 31 4d 75 74 65 78 28 76 6f 69 64 29  ache1Mutex(void)
a250: 7b 0a 20 20 72 65 74 75 72 6e 20 70 63 61 63 68  {.  return pcach
a260: 65 31 2e 6d 75 74 65 78 3b 0a 7d 0a 0a 23 69 66  e1.mutex;.}..#if
a270: 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c  def SQLITE_ENABL
a280: 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d  E_MEMORY_MANAGEM
a290: 45 4e 54 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66  ENT./*.** This f
a2a0: 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65  unction is calle
a2b0: 64 20 74 6f 20 66 72 65 65 20 73 75 70 65 72 66  d to free superf
a2c0: 6c 75 6f 75 73 20 64 79 6e 61 6d 69 63 61 6c 6c  luous dynamicall
a2d0: 79 20 61 6c 6c 6f 63 61 74 65 64 20 6d 65 6d 6f  y allocated memo
a2e0: 72 79 0a 2a 2a 20 68 65 6c 64 20 62 79 20 74 68  ry.** held by th
a2f0: 65 20 70 61 67 65 72 20 73 79 73 74 65 6d 2e 20  e pager system. 
a300: 4d 65 6d 6f 72 79 20 69 6e 20 75 73 65 20 62 79  Memory in use by
a310: 20 61 6e 79 20 53 51 4c 69 74 65 20 70 61 67 65   any SQLite page
a320: 72 20 61 6c 6c 6f 63 61 74 65 64 0a 2a 2a 20 62  r allocated.** b
a330: 79 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 68  y the current th
a340: 72 65 61 64 20 6d 61 79 20 62 65 20 73 71 6c 69  read may be sqli
a350: 74 65 33 5f 66 72 65 65 28 29 65 64 2e 0a 2a 2a  te3_free()ed..**
a360: 0a 2a 2a 20 6e 52 65 71 20 69 73 20 74 68 65 20  .** nReq is the 
a370: 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20  number of bytes 
a380: 6f 66 20 6d 65 6d 6f 72 79 20 72 65 71 75 69 72  of memory requir
a390: 65 64 2e 20 4f 6e 63 65 20 74 68 69 73 20 6d 75  ed. Once this mu
a3a0: 63 68 20 68 61 73 0a 2a 2a 20 62 65 65 6e 20 72  ch has.** been r
a3b0: 65 6c 65 61 73 65 64 2c 20 74 68 65 20 66 75 6e  eleased, the fun
a3c0: 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 2e 20 54  ction returns. T
a3d0: 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20  he return value 
a3e0: 69 73 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d  is the total num
a3f0: 62 65 72 20 0a 2a 2a 20 6f 66 20 62 79 74 65 73  ber .** of bytes
a400: 20 6f 66 20 6d 65 6d 6f 72 79 20 72 65 6c 65 61   of memory relea
a410: 73 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  sed..*/.int sqli
a420: 74 65 33 50 63 61 63 68 65 52 65 6c 65 61 73 65  te3PcacheRelease
a430: 4d 65 6d 6f 72 79 28 69 6e 74 20 6e 52 65 71 29  Memory(int nReq)
a440: 7b 0a 20 20 69 6e 74 20 6e 46 72 65 65 20 3d 20  {.  int nFree = 
a450: 30 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c  0;.  assert( sql
a460: 69 74 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65  ite3_mutex_nothe
a470: 6c 64 28 70 63 61 63 68 65 31 2e 67 72 70 2e 6d  ld(pcache1.grp.m
a480: 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72  utex) );.  asser
a490: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  t( sqlite3_mutex
a4a0: 5f 6e 6f 74 68 65 6c 64 28 70 63 61 63 68 65 31  _notheld(pcache1
a4b0: 2e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28  .mutex) );.  if(
a4c0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f   sqlite3GlobalCo
a4d0: 6e 66 69 67 2e 70 50 61 67 65 3d 3d 30 20 29 7b  nfig.pPage==0 ){
a4e0: 0a 20 20 20 20 50 67 48 64 72 31 20 2a 70 3b 0a  .    PgHdr1 *p;.
a4f0: 20 20 20 20 70 63 61 63 68 65 31 45 6e 74 65 72      pcache1Enter
a500: 4d 75 74 65 78 28 26 70 63 61 63 68 65 31 2e 67  Mutex(&pcache1.g
a510: 72 70 29 3b 0a 20 20 20 20 77 68 69 6c 65 28 20  rp);.    while( 
a520: 28 6e 52 65 71 3c 30 20 7c 7c 20 6e 46 72 65 65  (nReq<0 || nFree
a530: 3c 6e 52 65 71 29 0a 20 20 20 20 20 20 20 26 26  <nReq).       &&
a540: 20 20 28 70 3d 70 63 61 63 68 65 31 2e 67 72 70    (p=pcache1.grp
a550: 2e 6c 72 75 2e 70 4c 72 75 50 72 65 76 29 21 3d  .lru.pLruPrev)!=
a560: 30 0a 20 20 20 20 20 20 20 26 26 20 20 70 2d 3e  0.       &&  p->
a570: 69 73 41 6e 63 68 6f 72 3d 3d 30 0a 20 20 20 20  isAnchor==0.    
a580: 29 7b 0a 20 20 20 20 20 20 6e 46 72 65 65 20 2b  ){.      nFree +
a590: 3d 20 70 63 61 63 68 65 31 4d 65 6d 53 69 7a 65  = pcache1MemSize
a5a0: 28 70 2d 3e 70 61 67 65 2e 70 42 75 66 29 3b 0a  (p->page.pBuf);.
a5b0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 50 43  #ifdef SQLITE_PC
a5c0: 41 43 48 45 5f 53 45 50 41 52 41 54 45 5f 48 45  ACHE_SEPARATE_HE
a5d0: 41 44 45 52 0a 20 20 20 20 20 20 6e 46 72 65 65  ADER.      nFree
a5e0: 20 2b 3d 20 73 71 6c 69 74 65 33 4d 65 6d 53 69   += sqlite3MemSi
a5f0: 7a 65 28 70 29 3b 0a 23 65 6e 64 69 66 0a 20 20  ze(p);.#endif.  
a600: 20 20 20 20 61 73 73 65 72 74 28 20 50 41 47 45      assert( PAGE
a610: 5f 49 53 5f 55 4e 50 49 4e 4e 45 44 28 70 29 20  _IS_UNPINNED(p) 
a620: 29 3b 0a 20 20 20 20 20 20 70 63 61 63 68 65 31  );.      pcache1
a630: 50 69 6e 50 61 67 65 28 70 29 3b 0a 20 20 20 20  PinPage(p);.    
a640: 20 20 70 63 61 63 68 65 31 52 65 6d 6f 76 65 46    pcache1RemoveF
a650: 72 6f 6d 48 61 73 68 28 70 2c 20 31 29 3b 0a 20  romHash(p, 1);. 
a660: 20 20 20 7d 0a 20 20 20 20 70 63 61 63 68 65 31     }.    pcache1
a670: 4c 65 61 76 65 4d 75 74 65 78 28 26 70 63 61 63  LeaveMutex(&pcac
a680: 68 65 31 2e 67 72 70 29 3b 0a 20 20 7d 0a 20 20  he1.grp);.  }.  
a690: 72 65 74 75 72 6e 20 6e 46 72 65 65 3b 0a 7d 0a  return nFree;.}.
a6a0: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45  #endif /* SQLITE
a6b0: 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d  _ENABLE_MEMORY_M
a6c0: 41 4e 41 47 45 4d 45 4e 54 20 2a 2f 0a 0a 23 69  ANAGEMENT */..#i
a6d0: 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45 53 54  fdef SQLITE_TEST
a6e0: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63  ./*.** This func
a6f0: 74 69 6f 6e 20 69 73 20 75 73 65 64 20 62 79 20  tion is used by 
a700: 74 65 73 74 20 70 72 6f 63 65 64 75 72 65 73 20  test procedures 
a710: 74 6f 20 69 6e 73 70 65 63 74 20 74 68 65 20 69  to inspect the i
a720: 6e 74 65 72 6e 61 6c 20 73 74 61 74 65 0a 2a 2a  nternal state.**
a730: 20 6f 66 20 74 68 65 20 67 6c 6f 62 61 6c 20 63   of the global c
a740: 61 63 68 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  ache..*/.void sq
a750: 6c 69 74 65 33 50 63 61 63 68 65 53 74 61 74 73  lite3PcacheStats
a760: 28 0a 20 20 69 6e 74 20 2a 70 6e 43 75 72 72 65  (.  int *pnCurre
a770: 6e 74 2c 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a  nt,      /* OUT:
a780: 20 54 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66   Total number of
a790: 20 70 61 67 65 73 20 63 61 63 68 65 64 20 2a 2f   pages cached */
a7a0: 0a 20 20 69 6e 74 20 2a 70 6e 4d 61 78 2c 20 20  .  int *pnMax,  
a7b0: 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20          /* OUT: 
a7c0: 47 6c 6f 62 61 6c 20 6d 61 78 69 6d 75 6d 20 63  Global maximum c
a7d0: 61 63 68 65 20 73 69 7a 65 20 2a 2f 0a 20 20 69  ache size */.  i
a7e0: 6e 74 20 2a 70 6e 4d 69 6e 2c 20 20 20 20 20 20  nt *pnMin,      
a7f0: 20 20 20 20 2f 2a 20 4f 55 54 3a 20 53 75 6d 20      /* OUT: Sum 
a800: 6f 66 20 50 43 61 63 68 65 31 2e 6e 4d 69 6e 20  of PCache1.nMin 
a810: 66 6f 72 20 70 75 72 67 65 61 62 6c 65 20 63 61  for purgeable ca
a820: 63 68 65 73 20 2a 2f 0a 20 20 69 6e 74 20 2a 70  ches */.  int *p
a830: 6e 52 65 63 79 63 6c 61 62 6c 65 20 20 20 20 2f  nRecyclable    /
a840: 2a 20 4f 55 54 3a 20 54 6f 74 61 6c 20 6e 75 6d  * OUT: Total num
a850: 62 65 72 20 6f 66 20 70 61 67 65 73 20 61 76 61  ber of pages ava
a860: 69 6c 61 62 6c 65 20 66 6f 72 20 72 65 63 79 63  ilable for recyc
a870: 6c 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 50 67 48  ling */.){.  PgH
a880: 64 72 31 20 2a 70 3b 0a 20 20 69 6e 74 20 6e 52  dr1 *p;.  int nR
a890: 65 63 79 63 6c 61 62 6c 65 20 3d 20 30 3b 0a 20  ecyclable = 0;. 
a8a0: 20 66 6f 72 28 70 3d 70 63 61 63 68 65 31 2e 67   for(p=pcache1.g
a8b0: 72 70 2e 6c 72 75 2e 70 4c 72 75 4e 65 78 74 3b  rp.lru.pLruNext;
a8c0: 20 70 20 26 26 20 21 70 2d 3e 69 73 41 6e 63 68   p && !p->isAnch
a8d0: 6f 72 3b 20 70 3d 70 2d 3e 70 4c 72 75 4e 65 78  or; p=p->pLruNex
a8e0: 74 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20  t){.    assert( 
a8f0: 50 41 47 45 5f 49 53 5f 55 4e 50 49 4e 4e 45 44  PAGE_IS_UNPINNED
a900: 28 70 29 20 29 3b 0a 20 20 20 20 6e 52 65 63 79  (p) );.    nRecy
a910: 63 6c 61 62 6c 65 2b 2b 3b 0a 20 20 7d 0a 20 20  clable++;.  }.  
a920: 2a 70 6e 43 75 72 72 65 6e 74 20 3d 20 70 63 61  *pnCurrent = pca
a930: 63 68 65 31 2e 67 72 70 2e 6e 50 75 72 67 65 61  che1.grp.nPurgea
a940: 62 6c 65 3b 0a 20 20 2a 70 6e 4d 61 78 20 3d 20  ble;.  *pnMax = 
a950: 28 69 6e 74 29 70 63 61 63 68 65 31 2e 67 72 70  (int)pcache1.grp
a960: 2e 6e 4d 61 78 50 61 67 65 3b 0a 20 20 2a 70 6e  .nMaxPage;.  *pn
a970: 4d 69 6e 20 3d 20 28 69 6e 74 29 70 63 61 63 68  Min = (int)pcach
a980: 65 31 2e 67 72 70 2e 6e 4d 69 6e 50 61 67 65 3b  e1.grp.nMinPage;
a990: 0a 20 20 2a 70 6e 52 65 63 79 63 6c 61 62 6c 65  .  *pnRecyclable
a9a0: 20 3d 20 6e 52 65 63 79 63 6c 61 62 6c 65 3b 0a   = nRecyclable;.
a9b0: 7d 0a 23 65 6e 64 69 66 0a                       }.#endif.