/ Hex Artifact Content
Login

Artifact fffd5250a323579384a3b3904302b9fe87e186ba24602af3013f749a0234ae98:


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 2f 0a 73 74  in memory..*/.st
1110: 72 75 63 74 20 50 67 48 64 72 31 20 7b 0a 20 20  ruct PgHdr1 {.  
1120: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 70  sqlite3_pcache_p
1130: 61 67 65 20 70 61 67 65 3b 20 20 20 20 20 20 2f  age page;      /
1140: 2a 20 42 61 73 65 20 63 6c 61 73 73 2e 20 4d 75  * Base class. Mu
1150: 73 74 20 62 65 20 66 69 72 73 74 2e 20 70 42 75  st be first. pBu
1160: 66 20 26 20 70 45 78 74 72 61 20 2a 2f 0a 20 20  f & pExtra */.  
1170: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4b 65  unsigned int iKe
1180: 79 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  y;             /
1190: 2a 20 4b 65 79 20 76 61 6c 75 65 20 28 70 61 67  * Key value (pag
11a0: 65 20 6e 75 6d 62 65 72 29 20 2a 2f 0a 20 20 75  e number) */.  u
11b0: 38 20 69 73 42 75 6c 6b 4c 6f 63 61 6c 3b 20 20  8 isBulkLocal;  
11c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
11d0: 20 54 68 69 73 20 70 61 67 65 20 66 72 6f 6d 20   This page from 
11e0: 62 75 6c 6b 20 6c 6f 63 61 6c 20 73 74 6f 72 61  bulk local stora
11f0: 67 65 20 2a 2f 0a 20 20 75 38 20 69 73 41 6e 63  ge */.  u8 isAnc
1200: 68 6f 72 3b 20 20 20 20 20 20 20 20 20 20 20 20  hor;            
1210: 20 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 69         /* This i
1220: 73 20 74 68 65 20 50 47 72 6f 75 70 2e 6c 72 75  s the PGroup.lru
1230: 20 65 6c 65 6d 65 6e 74 20 2a 2f 0a 20 20 50 67   element */.  Pg
1240: 48 64 72 31 20 2a 70 4e 65 78 74 3b 20 20 20 20  Hdr1 *pNext;    
1250: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1260: 4e 65 78 74 20 69 6e 20 68 61 73 68 20 74 61 62  Next in hash tab
1270: 6c 65 20 63 68 61 69 6e 20 2a 2f 0a 20 20 50 43  le chain */.  PC
1280: 61 63 68 65 31 20 2a 70 43 61 63 68 65 3b 20 20  ache1 *pCache;  
1290: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
12a0: 43 61 63 68 65 20 74 68 61 74 20 63 75 72 72 65  Cache that curre
12b0: 6e 74 6c 79 20 6f 77 6e 73 20 74 68 69 73 20 70  ntly owns this p
12c0: 61 67 65 20 2a 2f 0a 20 20 50 67 48 64 72 31 20  age */.  PgHdr1 
12d0: 2a 70 4c 72 75 4e 65 78 74 3b 20 20 20 20 20 20  *pLruNext;      
12e0: 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20          /* Next 
12f0: 69 6e 20 4c 52 55 20 6c 69 73 74 20 6f 66 20 75  in LRU list of u
1300: 6e 70 69 6e 6e 65 64 20 70 61 67 65 73 20 2a 2f  npinned pages */
1310: 0a 20 20 50 67 48 64 72 31 20 2a 70 4c 72 75 50  .  PgHdr1 *pLruP
1320: 72 65 76 3b 20 20 20 20 20 20 20 20 20 20 20 20  rev;            
1330: 20 20 2f 2a 20 50 72 65 76 69 6f 75 73 20 69 6e    /* Previous in
1340: 20 4c 52 55 20 6c 69 73 74 20 6f 66 20 75 6e 70   LRU list of unp
1350: 69 6e 6e 65 64 20 70 61 67 65 73 20 2a 2f 0a 20  inned pages */. 
1360: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1370: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1380: 2f 2a 20 4e 42 3a 20 70 4c 72 75 50 72 65 76 20  /* NB: pLruPrev 
1390: 69 73 20 6f 6e 6c 79 20 76 61 6c 69 64 20 69 66  is only valid if
13a0: 20 70 4c 72 75 4e 65 78 74 21 3d 30 20 2a 2f 0a   pLruNext!=0 */.
13b0: 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 70 61 67 65  };../*.** A page
13c0: 20 69 73 20 70 69 6e 6e 65 64 20 69 66 20 69 74   is pinned if it
13d0: 20 69 73 20 6e 6f 74 20 6f 6e 20 74 68 65 20 4c   is not on the L
13e0: 52 55 20 6c 69 73 74 2e 20 20 54 6f 20 62 65 20  RU list.  To be 
13f0: 22 70 69 6e 6e 65 64 22 20 6d 65 61 6e 73 0a 2a  "pinned" means.*
1400: 2a 20 74 68 61 74 20 74 68 65 20 70 61 67 65 20  * that the page 
1410: 69 73 20 69 6e 20 61 63 74 69 76 65 20 75 73 65  is in active use
1420: 20 61 6e 64 20 6d 75 73 74 20 6e 6f 74 20 62 65   and must not be
1430: 20 64 65 61 6c 6c 6f 63 61 74 65 64 2e 0a 2a 2f   deallocated..*/
1440: 0a 23 64 65 66 69 6e 65 20 50 41 47 45 5f 49 53  .#define PAGE_IS
1450: 5f 50 49 4e 4e 45 44 28 70 29 20 20 20 20 28 28  _PINNED(p)    ((
1460: 70 29 2d 3e 70 4c 72 75 4e 65 78 74 3d 3d 30 29  p)->pLruNext==0)
1470: 0a 23 64 65 66 69 6e 65 20 50 41 47 45 5f 49 53  .#define PAGE_IS
1480: 5f 55 4e 50 49 4e 4e 45 44 28 70 29 20 20 28 28  _UNPINNED(p)  ((
1490: 70 29 2d 3e 70 4c 72 75 4e 65 78 74 21 3d 30 29  p)->pLruNext!=0)
14a0: 0a 0a 2f 2a 20 45 61 63 68 20 70 61 67 65 20 63  ../* Each page c
14b0: 61 63 68 65 20 28 6f 72 20 50 43 61 63 68 65 29  ache (or PCache)
14c0: 20 62 65 6c 6f 6e 67 73 20 74 6f 20 61 20 50 47   belongs to a PG
14d0: 72 6f 75 70 2e 20 20 41 20 50 47 72 6f 75 70 20  roup.  A PGroup 
14e0: 69 73 20 61 20 73 65 74 20 0a 2a 2a 20 6f 66 20  is a set .** of 
14f0: 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 50 43 61 63  one or more PCac
1500: 68 65 73 20 74 68 61 74 20 61 72 65 20 61 62 6c  hes that are abl
1510: 65 20 74 6f 20 72 65 63 79 63 6c 65 20 65 61 63  e to recycle eac
1520: 68 20 6f 74 68 65 72 27 73 20 75 6e 70 69 6e 6e  h other's unpinn
1530: 65 64 0a 2a 2a 20 70 61 67 65 73 20 77 68 65 6e  ed.** pages when
1540: 20 74 68 65 79 20 61 72 65 20 75 6e 64 65 72 20   they are under 
1550: 6d 65 6d 6f 72 79 20 70 72 65 73 73 75 72 65 2e  memory pressure.
1560: 20 20 41 20 50 47 72 6f 75 70 20 69 73 20 61 6e    A PGroup is an
1570: 20 69 6e 73 74 61 6e 63 65 20 6f 66 0a 2a 2a 20   instance of.** 
1580: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 62  the following ob
1590: 6a 65 63 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73  ject..**.** This
15a0: 20 70 61 67 65 20 63 61 63 68 65 20 69 6d 70 6c   page cache impl
15b0: 65 6d 65 6e 74 61 74 69 6f 6e 20 77 6f 72 6b 73  ementation works
15c0: 20 69 6e 20 6f 6e 65 20 6f 66 20 74 77 6f 20 6d   in one of two m
15d0: 6f 64 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 28 31  odes:.**.**   (1
15e0: 29 20 20 45 76 65 72 79 20 50 43 61 63 68 65 20  )  Every PCache 
15f0: 69 73 20 74 68 65 20 73 6f 6c 65 20 6d 65 6d 62  is the sole memb
1600: 65 72 20 6f 66 20 69 74 73 20 6f 77 6e 20 50 47  er of its own PG
1610: 72 6f 75 70 2e 20 20 54 68 65 72 65 20 69 73 0a  roup.  There is.
1620: 2a 2a 20 20 20 20 20 20 20 20 6f 6e 65 20 50 47  **        one PG
1630: 72 6f 75 70 20 70 65 72 20 50 43 61 63 68 65 2e  roup per PCache.
1640: 0a 2a 2a 0a 2a 2a 20 20 20 28 32 29 20 20 54 68  .**.**   (2)  Th
1650: 65 72 65 20 69 73 20 61 20 73 69 6e 67 6c 65 20  ere is a single 
1660: 67 6c 6f 62 61 6c 20 50 47 72 6f 75 70 20 74 68  global PGroup th
1670: 61 74 20 61 6c 6c 20 50 43 61 63 68 65 73 20 61  at all PCaches a
1680: 72 65 20 61 20 6d 65 6d 62 65 72 0a 2a 2a 20 20  re a member.**  
1690: 20 20 20 20 20 20 6f 66 2e 0a 2a 2a 0a 2a 2a 20        of..**.** 
16a0: 4d 6f 64 65 20 31 20 75 73 65 73 20 6d 6f 72 65  Mode 1 uses more
16b0: 20 6d 65 6d 6f 72 79 20 28 73 69 6e 63 65 20 50   memory (since P
16c0: 43 61 63 68 65 20 69 6e 73 74 61 6e 63 65 73 20  Cache instances 
16d0: 61 72 65 20 6e 6f 74 20 61 62 6c 65 20 74 6f 20  are not able to 
16e0: 72 6f 62 0a 2a 2a 20 75 6e 75 73 65 64 20 70 61  rob.** unused pa
16f0: 67 65 73 20 66 72 6f 6d 20 6f 74 68 65 72 20 50  ges from other P
1700: 43 61 63 68 65 73 29 20 62 75 74 20 69 74 20 61  Caches) but it a
1710: 6c 73 6f 20 6f 70 65 72 61 74 65 73 20 77 69 74  lso operates wit
1720: 68 6f 75 74 20 61 20 6d 75 74 65 78 2c 0a 2a 2a  hout a mutex,.**
1730: 20 61 6e 64 20 69 73 20 74 68 65 72 65 66 6f 72   and is therefor
1740: 65 20 6f 66 74 65 6e 20 66 61 73 74 65 72 2e 20  e often faster. 
1750: 20 4d 6f 64 65 20 32 20 72 65 71 75 69 72 65 73   Mode 2 requires
1760: 20 61 20 6d 75 74 65 78 20 69 6e 20 6f 72 64 65   a mutex in orde
1770: 72 20 74 6f 20 62 65 0a 2a 2a 20 74 68 72 65 61  r to be.** threa
1780: 64 73 61 66 65 2c 20 62 75 74 20 72 65 63 79 63  dsafe, but recyc
1790: 6c 65 73 20 70 61 67 65 73 20 6d 6f 72 65 20 65  les pages more e
17a0: 66 66 69 63 69 65 6e 74 6c 79 2e 0a 2a 2a 0a 2a  fficiently..**.*
17b0: 2a 20 46 6f 72 20 6d 6f 64 65 20 28 31 29 2c 20  * For mode (1), 
17c0: 50 47 72 6f 75 70 2e 6d 75 74 65 78 20 69 73 20  PGroup.mutex is 
17d0: 4e 55 4c 4c 2e 20 20 46 6f 72 20 6d 6f 64 65 20  NULL.  For mode 
17e0: 28 32 29 20 74 68 65 72 65 20 69 73 20 6f 6e 6c  (2) there is onl
17f0: 79 20 61 20 73 69 6e 67 6c 65 0a 2a 2a 20 50 47  y a single.** PG
1800: 72 6f 75 70 20 77 68 69 63 68 20 69 73 20 74 68  roup which is th
1810: 65 20 70 63 61 63 68 65 31 2e 67 72 70 20 67 6c  e pcache1.grp gl
1820: 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 20 61 6e  obal variable an
1830: 64 20 69 74 73 20 6d 75 74 65 78 20 69 73 0a 2a  d its mutex is.*
1840: 2a 20 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53  * SQLITE_MUTEX_S
1850: 54 41 54 49 43 5f 4c 52 55 2e 0a 2a 2f 0a 73 74  TATIC_LRU..*/.st
1860: 72 75 63 74 20 50 47 72 6f 75 70 20 7b 0a 20 20  ruct PGroup {.  
1870: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d  sqlite3_mutex *m
1880: 75 74 65 78 3b 20 20 20 20 20 20 20 20 20 20 2f  utex;          /
1890: 2a 20 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c  * MUTEX_STATIC_L
18a0: 52 55 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20  RU or NULL */.  
18b0: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 4d 61  unsigned int nMa
18c0: 78 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 2f  xPage;         /
18d0: 2a 20 53 75 6d 20 6f 66 20 6e 4d 61 78 20 66 6f  * Sum of nMax fo
18e0: 72 20 70 75 72 67 65 61 62 6c 65 20 63 61 63 68  r purgeable cach
18f0: 65 73 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64  es */.  unsigned
1900: 20 69 6e 74 20 6e 4d 69 6e 50 61 67 65 3b 20 20   int nMinPage;  
1910: 20 20 20 20 20 20 20 2f 2a 20 53 75 6d 20 6f 66         /* Sum of
1920: 20 6e 4d 69 6e 20 66 6f 72 20 70 75 72 67 65 61   nMin for purgea
1930: 62 6c 65 20 63 61 63 68 65 73 20 2a 2f 0a 20 20  ble caches */.  
1940: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6d 78 50  unsigned int mxP
1950: 69 6e 6e 65 64 3b 20 20 20 20 20 20 20 20 20 2f  inned;         /
1960: 2a 20 6e 4d 61 78 70 61 67 65 20 2b 20 31 30 20  * nMaxpage + 10 
1970: 2d 20 6e 4d 69 6e 50 61 67 65 20 2a 2f 0a 20 20  - nMinPage */.  
1980: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 50 75  unsigned int nPu
1990: 72 67 65 61 62 6c 65 3b 20 20 20 20 20 20 20 2f  rgeable;       /
19a0: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 75 72 67  * Number of purg
19b0: 65 61 62 6c 65 20 70 61 67 65 73 20 61 6c 6c 6f  eable pages allo
19c0: 63 61 74 65 64 20 2a 2f 0a 20 20 50 67 48 64 72  cated */.  PgHdr
19d0: 31 20 6c 72 75 3b 20 20 20 20 20 20 20 20 20 20  1 lru;          
19e0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65            /* The
19f0: 20 62 65 67 69 6e 6e 69 6e 67 20 61 6e 64 20 65   beginning and e
1a00: 6e 64 20 6f 66 20 74 68 65 20 4c 52 55 20 6c 69  nd of the LRU li
1a10: 73 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 45 61 63  st */.};../* Eac
1a20: 68 20 70 61 67 65 20 63 61 63 68 65 20 69 73 20  h page cache is 
1a30: 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74  an instance of t
1a40: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 62 6a  he following obj
1a50: 65 63 74 2e 20 20 45 76 65 72 79 0a 2a 2a 20 6f  ect.  Every.** o
1a60: 70 65 6e 20 64 61 74 61 62 61 73 65 20 66 69 6c  pen database fil
1a70: 65 20 28 69 6e 63 6c 75 64 69 6e 67 20 65 61 63  e (including eac
1a80: 68 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61  h in-memory data
1a90: 62 61 73 65 20 61 6e 64 20 65 61 63 68 0a 2a 2a  base and each.**
1aa0: 20 74 65 6d 70 6f 72 61 72 79 20 6f 72 20 74 72   temporary or tr
1ab0: 61 6e 73 69 65 6e 74 20 64 61 74 61 62 61 73 65  ansient database
1ac0: 29 20 68 61 73 20 61 20 73 69 6e 67 6c 65 20 70  ) has a single p
1ad0: 61 67 65 20 63 61 63 68 65 20 77 68 69 63 68 0a  age cache which.
1ae0: 2a 2a 20 69 73 20 61 6e 20 69 6e 73 74 61 6e 63  ** is an instanc
1af0: 65 20 6f 66 20 74 68 69 73 20 6f 62 6a 65 63 74  e of this object
1b00: 2e 0a 2a 2a 0a 2a 2a 20 50 6f 69 6e 74 65 72 73  ..**.** Pointers
1b10: 20 74 6f 20 73 74 72 75 63 74 75 72 65 73 20 6f   to structures o
1b20: 66 20 74 68 69 73 20 74 79 70 65 20 61 72 65 20  f this type are 
1b30: 63 61 73 74 20 61 6e 64 20 72 65 74 75 72 6e 65  cast and returne
1b40: 64 20 61 73 20 0a 2a 2a 20 6f 70 61 71 75 65 20  d as .** opaque 
1b50: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2a 20  sqlite3_pcache* 
1b60: 68 61 6e 64 6c 65 73 2e 0a 2a 2f 0a 73 74 72 75  handles..*/.stru
1b70: 63 74 20 50 43 61 63 68 65 31 20 7b 0a 20 20 2f  ct PCache1 {.  /
1b80: 2a 20 43 61 63 68 65 20 63 6f 6e 66 69 67 75 72  * Cache configur
1b90: 61 74 69 6f 6e 20 70 61 72 61 6d 65 74 65 72 73  ation parameters
1ba0: 2e 20 50 61 67 65 20 73 69 7a 65 20 28 73 7a 50  . Page size (szP
1bb0: 61 67 65 29 20 61 6e 64 20 74 68 65 20 70 75 72  age) and the pur
1bc0: 67 65 61 62 6c 65 0a 20 20 2a 2a 20 66 6c 61 67  geable.  ** flag
1bd0: 20 28 62 50 75 72 67 65 61 62 6c 65 29 20 61 6e   (bPurgeable) an
1be0: 64 20 74 68 65 20 70 6e 50 75 72 67 65 61 62 6c  d the pnPurgeabl
1bf0: 65 20 70 6f 69 6e 74 65 72 20 61 72 65 20 61 6c  e pointer are al
1c00: 6c 20 73 65 74 20 77 68 65 6e 20 74 68 65 0a 20  l set when the. 
1c10: 20 2a 2a 20 63 61 63 68 65 20 69 73 20 63 72 65   ** cache is cre
1c20: 61 74 65 64 20 61 6e 64 20 61 72 65 20 6e 65 76  ated and are nev
1c30: 65 72 20 63 68 61 6e 67 65 64 20 74 68 65 72 65  er changed there
1c40: 61 66 74 65 72 2e 20 6e 4d 61 78 20 6d 61 79 20  after. nMax may 
1c50: 62 65 20 0a 20 20 2a 2a 20 6d 6f 64 69 66 69 65  be .  ** modifie
1c60: 64 20 61 74 20 61 6e 79 20 74 69 6d 65 20 62 79  d at any time by
1c70: 20 61 20 63 61 6c 6c 20 74 6f 20 74 68 65 20 70   a call to the p
1c80: 63 61 63 68 65 31 43 61 63 68 65 73 69 7a 65 28  cache1Cachesize(
1c90: 29 20 6d 65 74 68 6f 64 2e 0a 20 20 2a 2a 20 54  ) method..  ** T
1ca0: 68 65 20 50 47 72 6f 75 70 20 6d 75 74 65 78 20  he PGroup mutex 
1cb0: 6d 75 73 74 20 62 65 20 68 65 6c 64 20 77 68 65  must be held whe
1cc0: 6e 20 61 63 63 65 73 73 69 6e 67 20 6e 4d 61 78  n accessing nMax
1cd0: 2e 0a 20 20 2a 2f 0a 20 20 50 47 72 6f 75 70 20  ..  */.  PGroup 
1ce0: 2a 70 47 72 6f 75 70 3b 20 20 20 20 20 20 20 20  *pGroup;        
1cf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1d00: 50 47 72 6f 75 70 20 74 68 69 73 20 63 61 63 68  PGroup this cach
1d10: 65 20 62 65 6c 6f 6e 67 73 20 74 6f 20 2a 2f 0a  e belongs to */.
1d20: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 2a    unsigned int *
1d30: 70 6e 50 75 72 67 65 61 62 6c 65 3b 20 20 20 20  pnPurgeable;    
1d40: 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72        /* Pointer
1d50: 20 74 6f 20 70 47 72 6f 75 70 2d 3e 6e 50 75 72   to pGroup->nPur
1d60: 67 65 61 62 6c 65 20 2a 2f 0a 20 20 69 6e 74 20  geable */.  int 
1d70: 73 7a 50 61 67 65 3b 20 20 20 20 20 20 20 20 20  szPage;         
1d80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1d90: 2f 2a 20 53 69 7a 65 20 6f 66 20 64 61 74 61 62  /* Size of datab
1da0: 61 73 65 20 63 6f 6e 74 65 6e 74 20 73 65 63 74  ase content sect
1db0: 69 6f 6e 20 2a 2f 0a 20 20 69 6e 74 20 73 7a 45  ion */.  int szE
1dc0: 78 74 72 61 3b 20 20 20 20 20 20 20 20 20 20 20  xtra;           
1dd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1de0: 73 69 7a 65 6f 66 28 4d 65 6d 50 61 67 65 29 2b  sizeof(MemPage)+
1df0: 73 69 7a 65 6f 66 28 50 67 48 64 72 29 20 2a 2f  sizeof(PgHdr) */
1e00: 0a 20 20 69 6e 74 20 73 7a 41 6c 6c 6f 63 3b 20  .  int szAlloc; 
1e10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1e20: 20 20 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20         /* Total 
1e30: 73 69 7a 65 20 6f 66 20 6f 6e 65 20 70 63 61 63  size of one pcac
1e40: 68 65 20 6c 69 6e 65 20 2a 2f 0a 20 20 69 6e 74  he line */.  int
1e50: 20 62 50 75 72 67 65 61 62 6c 65 3b 20 20 20 20   bPurgeable;    
1e60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1e70: 20 2f 2a 20 54 72 75 65 20 69 66 20 63 61 63 68   /* True if cach
1e80: 65 20 69 73 20 70 75 72 67 65 61 62 6c 65 20 2a  e is purgeable *
1e90: 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74  /.  unsigned int
1ea0: 20 6e 4d 69 6e 3b 20 20 20 20 20 20 20 20 20 20   nMin;          
1eb0: 20 20 20 20 20 20 20 20 2f 2a 20 4d 69 6e 69 6d          /* Minim
1ec0: 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67  um number of pag
1ed0: 65 73 20 72 65 73 65 72 76 65 64 20 2a 2f 0a 20  es reserved */. 
1ee0: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 4d   unsigned int nM
1ef0: 61 78 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  ax;             
1f00: 20 20 20 20 20 2f 2a 20 43 6f 6e 66 69 67 75 72       /* Configur
1f10: 65 64 20 22 63 61 63 68 65 5f 73 69 7a 65 22 20  ed "cache_size" 
1f20: 76 61 6c 75 65 20 2a 2f 0a 20 20 75 6e 73 69 67  value */.  unsig
1f30: 6e 65 64 20 69 6e 74 20 6e 39 30 70 63 74 3b 20  ned int n90pct; 
1f40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1f50: 2a 20 6e 4d 61 78 2a 39 2f 31 30 20 2a 2f 0a 20  * nMax*9/10 */. 
1f60: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4d   unsigned int iM
1f70: 61 78 4b 65 79 3b 20 20 20 20 20 20 20 20 20 20  axKey;          
1f80: 20 20 20 20 20 2f 2a 20 4c 61 72 67 65 73 74 20       /* Largest 
1f90: 6b 65 79 20 73 65 65 6e 20 73 69 6e 63 65 20 78  key seen since x
1fa0: 54 72 75 6e 63 61 74 65 28 29 20 2a 2f 0a 20 20  Truncate() */.  
1fb0: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 50 75  unsigned int nPu
1fc0: 72 67 65 61 62 6c 65 44 75 6d 6d 79 3b 20 20 20  rgeableDummy;   
1fd0: 20 20 20 20 2f 2a 20 70 6e 50 75 72 67 65 61 62      /* pnPurgeab
1fe0: 6c 65 20 70 6f 69 6e 74 73 20 68 65 72 65 20 77  le points here w
1ff0: 68 65 6e 20 6e 6f 74 20 75 73 65 64 2a 2f 0a 0a  hen not used*/..
2000: 20 20 2f 2a 20 48 61 73 68 20 74 61 62 6c 65 20    /* Hash table 
2010: 6f 66 20 61 6c 6c 20 70 61 67 65 73 2e 20 54 68  of all pages. Th
2020: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 76 61 72 69  e following vari
2030: 61 62 6c 65 73 20 6d 61 79 20 6f 6e 6c 79 20 62  ables may only b
2040: 65 20 61 63 63 65 73 73 65 64 0a 20 20 2a 2a 20  e accessed.  ** 
2050: 77 68 65 6e 20 74 68 65 20 61 63 63 65 73 73 6f  when the accesso
2060: 72 20 69 73 20 68 6f 6c 64 69 6e 67 20 74 68 65  r is holding the
2070: 20 50 47 72 6f 75 70 20 6d 75 74 65 78 2e 0a 20   PGroup mutex.. 
2080: 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69   */.  unsigned i
2090: 6e 74 20 6e 52 65 63 79 63 6c 61 62 6c 65 3b 20  nt nRecyclable; 
20a0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d            /* Num
20b0: 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20  ber of pages in 
20c0: 74 68 65 20 4c 52 55 20 6c 69 73 74 20 2a 2f 0a  the LRU list */.
20d0: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e    unsigned int n
20e0: 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 20  Page;           
20f0: 20 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 6e        /* Total n
2100: 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 69  umber of pages i
2110: 6e 20 61 70 48 61 73 68 20 2a 2f 0a 20 20 75 6e  n apHash */.  un
2120: 73 69 67 6e 65 64 20 69 6e 74 20 6e 48 61 73 68  signed int nHash
2130: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
2140: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 73    /* Number of s
2150: 6c 6f 74 73 20 69 6e 20 61 70 48 61 73 68 5b 5d  lots in apHash[]
2160: 20 2a 2f 0a 20 20 50 67 48 64 72 31 20 2a 2a 61   */.  PgHdr1 **a
2170: 70 48 61 73 68 3b 20 20 20 20 20 20 20 20 20 20  pHash;          
2180: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 48 61 73            /* Has
2190: 68 20 74 61 62 6c 65 20 66 6f 72 20 66 61 73 74  h table for fast
21a0: 20 6c 6f 6f 6b 75 70 20 62 79 20 6b 65 79 20 2a   lookup by key *
21b0: 2f 0a 20 20 50 67 48 64 72 31 20 2a 70 46 72 65  /.  PgHdr1 *pFre
21c0: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  e;              
21d0: 20 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20          /* List 
21e0: 6f 66 20 75 6e 75 73 65 64 20 70 63 61 63 68 65  of unused pcache
21f0: 2d 6c 6f 63 61 6c 20 70 61 67 65 73 20 2a 2f 0a  -local pages */.
2200: 20 20 76 6f 69 64 20 2a 70 42 75 6c 6b 3b 20 20    void *pBulk;  
2210: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2220: 20 20 20 20 20 20 2f 2a 20 42 75 6c 6b 20 6d 65        /* Bulk me
2230: 6d 6f 72 79 20 75 73 65 64 20 62 79 20 70 63 61  mory used by pca
2240: 63 68 65 2d 6c 6f 63 61 6c 20 2a 2f 0a 7d 3b 0a  che-local */.};.
2250: 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 73 6c 6f 74  ./*.** Free slot
2260: 73 20 69 6e 20 74 68 65 20 61 6c 6c 6f 63 61 74  s in the allocat
2270: 6f 72 20 75 73 65 64 20 74 6f 20 64 69 76 69 64  or used to divid
2280: 65 20 75 70 20 74 68 65 20 67 6c 6f 62 61 6c 20  e up the global 
2290: 70 61 67 65 20 63 61 63 68 65 0a 2a 2a 20 62 75  page cache.** bu
22a0: 66 66 65 72 20 70 72 6f 76 69 64 65 64 20 75 73  ffer provided us
22b0: 69 6e 67 20 74 68 65 20 53 51 4c 49 54 45 5f 43  ing the SQLITE_C
22c0: 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45 20  ONFIG_PAGECACHE 
22d0: 6d 65 63 68 61 6e 69 73 6d 2e 0a 2a 2f 0a 73 74  mechanism..*/.st
22e0: 72 75 63 74 20 50 67 46 72 65 65 73 6c 6f 74 20  ruct PgFreeslot 
22f0: 7b 0a 20 20 50 67 46 72 65 65 73 6c 6f 74 20 2a  {.  PgFreeslot *
2300: 70 4e 65 78 74 3b 20 20 2f 2a 20 4e 65 78 74 20  pNext;  /* Next 
2310: 66 72 65 65 20 73 6c 6f 74 20 2a 2f 0a 7d 3b 0a  free slot */.};.
2320: 0a 2f 2a 0a 2a 2a 20 47 6c 6f 62 61 6c 20 64 61  ./*.** Global da
2330: 74 61 20 75 73 65 64 20 62 79 20 74 68 69 73 20  ta used by this 
2340: 63 61 63 68 65 2e 0a 2a 2f 0a 73 74 61 74 69 63  cache..*/.static
2350: 20 53 51 4c 49 54 45 5f 57 53 44 20 73 74 72 75   SQLITE_WSD stru
2360: 63 74 20 50 43 61 63 68 65 47 6c 6f 62 61 6c 20  ct PCacheGlobal 
2370: 7b 0a 20 20 50 47 72 6f 75 70 20 67 72 70 3b 20  {.  PGroup grp; 
2380: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2390: 20 20 20 2f 2a 20 54 68 65 20 67 6c 6f 62 61 6c     /* The global
23a0: 20 50 47 72 6f 75 70 20 66 6f 72 20 6d 6f 64 65   PGroup for mode
23b0: 20 28 32 29 20 2a 2f 0a 0a 20 20 2f 2a 20 56 61   (2) */..  /* Va
23c0: 72 69 61 62 6c 65 73 20 72 65 6c 61 74 65 64 20  riables related 
23d0: 74 6f 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47  to SQLITE_CONFIG
23e0: 5f 50 41 47 45 43 41 43 48 45 20 73 65 74 74 69  _PAGECACHE setti
23f0: 6e 67 73 2e 20 20 54 68 65 0a 20 20 2a 2a 20 73  ngs.  The.  ** s
2400: 7a 53 6c 6f 74 2c 20 6e 53 6c 6f 74 2c 20 70 53  zSlot, nSlot, pS
2410: 74 61 72 74 2c 20 70 45 6e 64 2c 20 6e 52 65 73  tart, pEnd, nRes
2420: 65 72 76 65 2c 20 61 6e 64 20 69 73 49 6e 69 74  erve, and isInit
2430: 20 76 61 6c 75 65 73 20 61 72 65 20 61 6c 6c 0a   values are all.
2440: 20 20 2a 2a 20 66 69 78 65 64 20 61 74 20 73 71    ** fixed at sq
2450: 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65  lite3_initialize
2460: 28 29 20 74 69 6d 65 20 61 6e 64 20 64 6f 20 6e  () time and do n
2470: 6f 74 20 72 65 71 75 69 72 65 20 6d 75 74 65 78  ot require mutex
2480: 20 70 72 6f 74 65 63 74 69 6f 6e 2e 0a 20 20 2a   protection..  *
2490: 2a 20 54 68 65 20 6e 46 72 65 65 53 6c 6f 74 20  * The nFreeSlot 
24a0: 61 6e 64 20 70 46 72 65 65 20 76 61 6c 75 65 73  and pFree values
24b0: 20 64 6f 20 72 65 71 75 69 72 65 20 6d 75 74 65   do require mute
24c0: 78 20 70 72 6f 74 65 63 74 69 6f 6e 2e 0a 20 20  x protection..  
24d0: 2a 2f 0a 20 20 69 6e 74 20 69 73 49 6e 69 74 3b  */.  int isInit;
24e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
24f0: 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 69      /* True if i
2500: 6e 69 74 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 20  nitialized */.  
2510: 69 6e 74 20 73 65 70 61 72 61 74 65 43 61 63 68  int separateCach
2520: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  e;             /
2530: 2a 20 55 73 65 20 61 20 6e 65 77 20 50 47 72 6f  * Use a new PGro
2540: 75 70 20 66 6f 72 20 65 61 63 68 20 50 43 61 63  up for each PCac
2550: 68 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 49 6e 69  he */.  int nIni
2560: 74 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 20  tPage;          
2570: 20 20 20 20 20 20 20 2f 2a 20 49 6e 69 74 69 61         /* Initia
2580: 6c 20 62 75 6c 6b 20 61 6c 6c 6f 63 61 74 69 6f  l bulk allocatio
2590: 6e 20 73 69 7a 65 20 2a 2f 20 20 20 0a 20 20 69  n size */   .  i
25a0: 6e 74 20 73 7a 53 6c 6f 74 3b 20 20 20 20 20 20  nt szSlot;      
25b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
25c0: 20 53 69 7a 65 20 6f 66 20 65 61 63 68 20 66 72   Size of each fr
25d0: 65 65 20 73 6c 6f 74 20 2a 2f 0a 20 20 69 6e 74  ee slot */.  int
25e0: 20 6e 53 6c 6f 74 3b 20 20 20 20 20 20 20 20 20   nSlot;         
25f0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
2600: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 63 61  he number of pca
2610: 63 68 65 20 73 6c 6f 74 73 20 2a 2f 0a 20 20 69  che slots */.  i
2620: 6e 74 20 6e 52 65 73 65 72 76 65 3b 20 20 20 20  nt nReserve;    
2630: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
2640: 20 54 72 79 20 74 6f 20 6b 65 65 70 20 6e 46 72   Try to keep nFr
2650: 65 65 53 6c 6f 74 20 61 62 6f 76 65 20 74 68 69  eeSlot above thi
2660: 73 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 53 74  s */.  void *pSt
2670: 61 72 74 2c 20 2a 70 45 6e 64 3b 20 20 20 20 20  art, *pEnd;     
2680: 20 20 20 20 20 20 2f 2a 20 42 6f 75 6e 64 73 20        /* Bounds 
2690: 6f 66 20 67 6c 6f 62 61 6c 20 70 61 67 65 20 63  of global page c
26a0: 61 63 68 65 20 6d 65 6d 6f 72 79 20 2a 2f 0a 20  ache memory */. 
26b0: 20 2f 2a 20 41 62 6f 76 65 20 72 65 71 75 69 72   /* Above requir
26c0: 65 73 20 6e 6f 20 6d 75 74 65 78 2e 20 20 55 73  es no mutex.  Us
26d0: 65 20 6d 75 74 65 78 20 62 65 6c 6f 77 20 66 6f  e mutex below fo
26e0: 72 20 76 61 72 69 61 62 6c 65 20 74 68 61 74 20  r variable that 
26f0: 66 6f 6c 6c 6f 77 2e 20 2a 2f 0a 20 20 73 71 6c  follow. */.  sql
2700: 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65  ite3_mutex *mute
2710: 78 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d  x;          /* M
2720: 75 74 65 78 20 66 6f 72 20 61 63 63 65 73 73 69  utex for accessi
2730: 6e 67 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  ng the following
2740: 3a 20 2a 2f 0a 20 20 50 67 46 72 65 65 73 6c 6f  : */.  PgFreeslo
2750: 74 20 2a 70 46 72 65 65 3b 20 20 20 20 20 20 20  t *pFree;       
2760: 20 20 20 20 20 20 2f 2a 20 46 72 65 65 20 70 61        /* Free pa
2770: 67 65 20 62 6c 6f 63 6b 73 20 2a 2f 0a 20 20 69  ge blocks */.  i
2780: 6e 74 20 6e 46 72 65 65 53 6c 6f 74 3b 20 20 20  nt nFreeSlot;   
2790: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
27a0: 20 4e 75 6d 62 65 72 20 6f 66 20 75 6e 75 73 65   Number of unuse
27b0: 64 20 70 63 61 63 68 65 20 73 6c 6f 74 73 20 2a  d pcache slots *
27c0: 2f 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f  /.  /* The follo
27d0: 77 69 6e 67 20 76 61 6c 75 65 20 72 65 71 75 69  wing value requi
27e0: 72 65 73 20 61 20 6d 75 74 65 78 20 74 6f 20 63  res a mutex to c
27f0: 68 61 6e 67 65 2e 20 20 57 65 20 73 6b 69 70 20  hange.  We skip 
2800: 74 68 65 20 6d 75 74 65 78 20 6f 6e 0a 20 20 2a  the mutex on.  *
2810: 2a 20 72 65 61 64 69 6e 67 20 62 65 63 61 75 73  * reading becaus
2820: 65 20 28 31 29 20 6d 6f 73 74 20 70 6c 61 74 66  e (1) most platf
2830: 6f 72 6d 73 20 72 65 61 64 20 61 20 33 32 2d 62  orms read a 32-b
2840: 69 74 20 69 6e 74 65 67 65 72 20 61 74 6f 6d 69  it integer atomi
2850: 63 61 6c 6c 79 20 61 6e 64 0a 20 20 2a 2a 20 28  cally and.  ** (
2860: 32 29 20 65 76 65 6e 20 69 66 20 61 6e 20 69 6e  2) even if an in
2870: 63 6f 72 72 65 63 74 20 76 61 6c 75 65 20 69 73  correct value is
2880: 20 72 65 61 64 2c 20 6e 6f 20 67 72 65 61 74 20   read, no great 
2890: 68 61 72 6d 20 69 73 20 64 6f 6e 65 20 73 69 6e  harm is done sin
28a0: 63 65 20 74 68 69 73 0a 20 20 2a 2a 20 69 73 20  ce this.  ** is 
28b0: 72 65 61 6c 6c 79 20 6a 75 73 74 20 61 6e 20 6f  really just an o
28c0: 70 74 69 6d 69 7a 61 74 69 6f 6e 2e 20 2a 2f 0a  ptimization. */.
28d0: 20 20 69 6e 74 20 62 55 6e 64 65 72 50 72 65 73    int bUnderPres
28e0: 73 75 72 65 3b 20 20 20 20 20 20 20 20 20 20 20  sure;           
28f0: 20 2f 2a 20 54 72 75 65 20 69 66 20 6c 6f 77 20   /* True if low 
2900: 6f 6e 20 50 41 47 45 43 41 43 48 45 20 6d 65 6d  on PAGECACHE mem
2910: 6f 72 79 20 2a 2f 0a 7d 20 70 63 61 63 68 65 31  ory */.} pcache1
2920: 5f 67 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 20 63  _g;../*.** All c
2930: 6f 64 65 20 69 6e 20 74 68 69 73 20 66 69 6c 65  ode in this file
2940: 20 73 68 6f 75 6c 64 20 61 63 63 65 73 73 20 74   should access t
2950: 68 65 20 67 6c 6f 62 61 6c 20 73 74 72 75 63 74  he global struct
2960: 75 72 65 20 61 62 6f 76 65 20 76 69 61 20 74 68  ure above via th
2970: 65 0a 2a 2a 20 61 6c 69 61 73 20 22 70 63 61 63  e.** alias "pcac
2980: 68 65 31 22 2e 20 54 68 69 73 20 65 6e 73 75 72  he1". This ensur
2990: 65 73 20 74 68 61 74 20 74 68 65 20 57 53 44 20  es that the WSD 
29a0: 65 6d 75 6c 61 74 69 6f 6e 20 69 73 20 75 73 65  emulation is use
29b0: 64 20 77 68 65 6e 0a 2a 2a 20 63 6f 6d 70 69 6c  d when.** compil
29c0: 69 6e 67 20 66 6f 72 20 73 79 73 74 65 6d 73 20  ing for systems 
29d0: 74 68 61 74 20 64 6f 20 6e 6f 74 20 73 75 70 70  that do not supp
29e0: 6f 72 74 20 72 65 61 6c 20 57 53 44 2e 0a 2a 2f  ort real WSD..*/
29f0: 0a 23 64 65 66 69 6e 65 20 70 63 61 63 68 65 31  .#define pcache1
2a00: 20 28 47 4c 4f 42 41 4c 28 73 74 72 75 63 74 20   (GLOBAL(struct 
2a10: 50 43 61 63 68 65 47 6c 6f 62 61 6c 2c 20 70 63  PCacheGlobal, pc
2a20: 61 63 68 65 31 5f 67 29 29 0a 0a 2f 2a 0a 2a 2a  ache1_g))../*.**
2a30: 20 4d 61 63 72 6f 73 20 74 6f 20 65 6e 74 65 72   Macros to enter
2a40: 20 61 6e 64 20 6c 65 61 76 65 20 74 68 65 20 50   and leave the P
2a50: 43 61 63 68 65 20 4c 52 55 20 6d 75 74 65 78 2e  Cache LRU mutex.
2a60: 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 64  .*/.#if !defined
2a70: 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d  (SQLITE_ENABLE_M
2a80: 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54  EMORY_MANAGEMENT
2a90: 29 20 7c 7c 20 53 51 4c 49 54 45 5f 54 48 52 45  ) || SQLITE_THRE
2aa0: 41 44 53 41 46 45 3d 3d 30 0a 23 20 64 65 66 69  ADSAFE==0.# defi
2ab0: 6e 65 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d  ne pcache1EnterM
2ac0: 75 74 65 78 28 58 29 20 20 61 73 73 65 72 74 28  utex(X)  assert(
2ad0: 28 58 29 2d 3e 6d 75 74 65 78 3d 3d 30 29 0a 23  (X)->mutex==0).#
2ae0: 20 64 65 66 69 6e 65 20 70 63 61 63 68 65 31 4c   define pcache1L
2af0: 65 61 76 65 4d 75 74 65 78 28 58 29 20 20 61 73  eaveMutex(X)  as
2b00: 73 65 72 74 28 28 58 29 2d 3e 6d 75 74 65 78 3d  sert((X)->mutex=
2b10: 3d 30 29 0a 23 20 64 65 66 69 6e 65 20 50 43 41  =0).# define PCA
2b20: 43 48 45 31 5f 4d 49 47 48 54 5f 55 53 45 5f 47  CHE1_MIGHT_USE_G
2b30: 52 4f 55 50 5f 4d 55 54 45 58 20 30 0a 23 65 6c  ROUP_MUTEX 0.#el
2b40: 73 65 0a 23 20 64 65 66 69 6e 65 20 70 63 61 63  se.# define pcac
2b50: 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 58 29  he1EnterMutex(X)
2b60: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65   sqlite3_mutex_e
2b70: 6e 74 65 72 28 28 58 29 2d 3e 6d 75 74 65 78 29  nter((X)->mutex)
2b80: 0a 23 20 64 65 66 69 6e 65 20 70 63 61 63 68 65  .# define pcache
2b90: 31 4c 65 61 76 65 4d 75 74 65 78 28 58 29 20 73  1LeaveMutex(X) s
2ba0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
2bb0: 76 65 28 28 58 29 2d 3e 6d 75 74 65 78 29 0a 23  ve((X)->mutex).#
2bc0: 20 64 65 66 69 6e 65 20 50 43 41 43 48 45 31 5f   define PCACHE1_
2bd0: 4d 49 47 48 54 5f 55 53 45 5f 47 52 4f 55 50 5f  MIGHT_USE_GROUP_
2be0: 4d 55 54 45 58 20 31 0a 23 65 6e 64 69 66 0a 0a  MUTEX 1.#endif..
2bf0: 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  /***************
2c00: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2c10: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2c20: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2c30: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f  ***************/
2c40: 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 20 50 61 67 65 20  ./******** Page 
2c50: 41 6c 6c 6f 63 61 74 69 6f 6e 2f 53 51 4c 49 54  Allocation/SQLIT
2c60: 45 5f 43 4f 4e 46 49 47 5f 50 43 41 43 48 45 20  E_CONFIG_PCACHE 
2c70: 52 65 6c 61 74 65 64 20 46 75 6e 63 74 69 6f 6e  Related Function
2c80: 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  s **************
2c90: 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66  /.../*.** This f
2ca0: 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65  unction is calle
2cb0: 64 20 64 75 72 69 6e 67 20 69 6e 69 74 69 61 6c  d during initial
2cc0: 69 7a 61 74 69 6f 6e 20 69 66 20 61 20 73 74 61  ization if a sta
2cd0: 74 69 63 20 62 75 66 66 65 72 20 69 73 20 0a 2a  tic buffer is .*
2ce0: 2a 20 73 75 70 70 6c 69 65 64 20 74 6f 20 75 73  * supplied to us
2cf0: 65 20 66 6f 72 20 74 68 65 20 70 61 67 65 2d 63  e for the page-c
2d00: 61 63 68 65 20 62 79 20 70 61 73 73 69 6e 67 20  ache by passing 
2d10: 74 68 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49  the SQLITE_CONFI
2d20: 47 5f 50 41 47 45 43 41 43 48 45 0a 2a 2a 20 76  G_PAGECACHE.** v
2d30: 65 72 62 20 74 6f 20 73 71 6c 69 74 65 33 5f 63  erb to sqlite3_c
2d40: 6f 6e 66 69 67 28 29 2e 20 50 61 72 61 6d 65 74  onfig(). Paramet
2d50: 65 72 20 70 42 75 66 20 70 6f 69 6e 74 73 20 74  er pBuf points t
2d60: 6f 20 61 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e 20  o an allocation 
2d70: 6c 61 72 67 65 0a 2a 2a 20 65 6e 6f 75 67 68 20  large.** enough 
2d80: 74 6f 20 63 6f 6e 74 61 69 6e 20 27 6e 27 20 62  to contain 'n' b
2d90: 75 66 66 65 72 73 20 6f 66 20 27 73 7a 27 20 62  uffers of 'sz' b
2da0: 79 74 65 73 20 65 61 63 68 2e 0a 2a 2a 0a 2a 2a  ytes each..**.**
2db0: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73   This routine is
2dc0: 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 73 71 6c   called from sql
2dd0: 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28  ite3_initialize(
2de0: 29 20 61 6e 64 20 73 6f 20 69 74 20 69 73 20 67  ) and so it is g
2df0: 75 61 72 61 6e 74 65 65 64 0a 2a 2a 20 74 6f 20  uaranteed.** to 
2e00: 62 65 20 73 65 72 69 61 6c 69 7a 65 64 20 61 6c  be serialized al
2e10: 72 65 61 64 79 2e 20 20 54 68 65 72 65 20 69 73  ready.  There is
2e20: 20 6e 6f 20 6e 65 65 64 20 66 6f 72 20 66 75 72   no need for fur
2e30: 74 68 65 72 20 6d 75 74 65 78 69 6e 67 2e 0a 2a  ther mutexing..*
2e40: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 43  /.void sqlite3PC
2e50: 61 63 68 65 42 75 66 66 65 72 53 65 74 75 70 28  acheBufferSetup(
2e60: 76 6f 69 64 20 2a 70 42 75 66 2c 20 69 6e 74 20  void *pBuf, int 
2e70: 73 7a 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 69 66  sz, int n){.  if
2e80: 28 20 70 63 61 63 68 65 31 2e 69 73 49 6e 69 74  ( pcache1.isInit
2e90: 20 29 7b 0a 20 20 20 20 50 67 46 72 65 65 73 6c   ){.    PgFreesl
2ea0: 6f 74 20 2a 70 3b 0a 20 20 20 20 69 66 28 20 70  ot *p;.    if( p
2eb0: 42 75 66 3d 3d 30 20 29 20 73 7a 20 3d 20 6e 20  Buf==0 ) sz = n 
2ec0: 3d 20 30 3b 0a 20 20 20 20 69 66 28 20 6e 3d 3d  = 0;.    if( n==
2ed0: 30 20 29 20 73 7a 20 3d 20 30 3b 0a 20 20 20 20  0 ) sz = 0;.    
2ee0: 73 7a 20 3d 20 52 4f 55 4e 44 44 4f 57 4e 38 28  sz = ROUNDDOWN8(
2ef0: 73 7a 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31  sz);.    pcache1
2f00: 2e 73 7a 53 6c 6f 74 20 3d 20 73 7a 3b 0a 20 20  .szSlot = sz;.  
2f10: 20 20 70 63 61 63 68 65 31 2e 6e 53 6c 6f 74 20    pcache1.nSlot 
2f20: 3d 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65 53  = pcache1.nFreeS
2f30: 6c 6f 74 20 3d 20 6e 3b 0a 20 20 20 20 70 63 61  lot = n;.    pca
2f40: 63 68 65 31 2e 6e 52 65 73 65 72 76 65 20 3d 20  che1.nReserve = 
2f50: 6e 3e 39 30 20 3f 20 31 30 20 3a 20 28 6e 2f 31  n>90 ? 10 : (n/1
2f60: 30 20 2b 20 31 29 3b 0a 20 20 20 20 70 63 61 63  0 + 1);.    pcac
2f70: 68 65 31 2e 70 53 74 61 72 74 20 3d 20 70 42 75  he1.pStart = pBu
2f80: 66 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 70  f;.    pcache1.p
2f90: 46 72 65 65 20 3d 20 30 3b 0a 20 20 20 20 70 63  Free = 0;.    pc
2fa0: 61 63 68 65 31 2e 62 55 6e 64 65 72 50 72 65 73  ache1.bUnderPres
2fb0: 73 75 72 65 20 3d 20 30 3b 0a 20 20 20 20 77 68  sure = 0;.    wh
2fc0: 69 6c 65 28 20 6e 2d 2d 20 29 7b 0a 20 20 20 20  ile( n-- ){.    
2fd0: 20 20 70 20 3d 20 28 50 67 46 72 65 65 73 6c 6f    p = (PgFreeslo
2fe0: 74 2a 29 70 42 75 66 3b 0a 20 20 20 20 20 20 70  t*)pBuf;.      p
2ff0: 2d 3e 70 4e 65 78 74 20 3d 20 70 63 61 63 68 65  ->pNext = pcache
3000: 31 2e 70 46 72 65 65 3b 0a 20 20 20 20 20 20 70  1.pFree;.      p
3010: 63 61 63 68 65 31 2e 70 46 72 65 65 20 3d 20 70  cache1.pFree = p
3020: 3b 0a 20 20 20 20 20 20 70 42 75 66 20 3d 20 28  ;.      pBuf = (
3030: 76 6f 69 64 2a 29 26 28 28 63 68 61 72 2a 29 70  void*)&((char*)p
3040: 42 75 66 29 5b 73 7a 5d 3b 0a 20 20 20 20 7d 0a  Buf)[sz];.    }.
3050: 20 20 20 20 70 63 61 63 68 65 31 2e 70 45 6e 64      pcache1.pEnd
3060: 20 3d 20 70 42 75 66 3b 0a 20 20 7d 0a 7d 0a 0a   = pBuf;.  }.}..
3070: 2f 2a 0a 2a 2a 20 54 72 79 20 74 6f 20 69 6e 69  /*.** Try to ini
3080: 74 69 61 6c 69 7a 65 20 74 68 65 20 70 43 61 63  tialize the pCac
3090: 68 65 2d 3e 70 46 72 65 65 20 61 6e 64 20 70 43  he->pFree and pC
30a0: 61 63 68 65 2d 3e 70 42 75 6c 6b 20 66 69 65 6c  ache->pBulk fiel
30b0: 64 73 2e 20 20 52 65 74 75 72 6e 0a 2a 2a 20 74  ds.  Return.** t
30c0: 72 75 65 20 69 66 20 70 43 61 63 68 65 2d 3e 70  rue if pCache->p
30d0: 46 72 65 65 20 65 6e 64 73 20 75 70 20 63 6f 6e  Free ends up con
30e0: 74 61 69 6e 69 6e 67 20 6f 6e 65 20 6f 72 20 6d  taining one or m
30f0: 6f 72 65 20 66 72 65 65 20 70 61 67 65 73 2e 0a  ore free pages..
3100: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 63  */.static int pc
3110: 61 63 68 65 31 49 6e 69 74 42 75 6c 6b 28 50 43  ache1InitBulk(PC
3120: 61 63 68 65 31 20 2a 70 43 61 63 68 65 29 7b 0a  ache1 *pCache){.
3130: 20 20 69 36 34 20 73 7a 42 75 6c 6b 3b 0a 20 20    i64 szBulk;.  
3140: 63 68 61 72 20 2a 7a 42 75 6c 6b 3b 0a 20 20 69  char *zBulk;.  i
3150: 66 28 20 70 63 61 63 68 65 31 2e 6e 49 6e 69 74  f( pcache1.nInit
3160: 50 61 67 65 3d 3d 30 20 29 20 72 65 74 75 72 6e  Page==0 ) return
3170: 20 30 3b 0a 20 20 2f 2a 20 44 6f 20 6e 6f 74 20   0;.  /* Do not 
3180: 62 6f 74 68 65 72 20 77 69 74 68 20 61 20 62 75  bother with a bu
3190: 6c 6b 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69 66  lk allocation if
31a0: 20 74 68 65 20 63 61 63 68 65 20 73 69 7a 65 20   the cache size 
31b0: 76 65 72 79 20 73 6d 61 6c 6c 20 2a 2f 0a 20 20  very small */.  
31c0: 69 66 28 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78  if( pCache->nMax
31d0: 3c 33 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20  <3 ) return 0;. 
31e0: 20 73 71 6c 69 74 65 33 42 65 67 69 6e 42 65 6e   sqlite3BeginBen
31f0: 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 69  ignMalloc();.  i
3200: 66 28 20 70 63 61 63 68 65 31 2e 6e 49 6e 69 74  f( pcache1.nInit
3210: 50 61 67 65 3e 30 20 29 7b 0a 20 20 20 20 73 7a  Page>0 ){.    sz
3220: 42 75 6c 6b 20 3d 20 70 43 61 63 68 65 2d 3e 73  Bulk = pCache->s
3230: 7a 41 6c 6c 6f 63 20 2a 20 28 69 36 34 29 70 63  zAlloc * (i64)pc
3240: 61 63 68 65 31 2e 6e 49 6e 69 74 50 61 67 65 3b  ache1.nInitPage;
3250: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 7a  .  }else{.    sz
3260: 42 75 6c 6b 20 3d 20 2d 31 30 32 34 20 2a 20 28  Bulk = -1024 * (
3270: 69 36 34 29 70 63 61 63 68 65 31 2e 6e 49 6e 69  i64)pcache1.nIni
3280: 74 50 61 67 65 3b 0a 20 20 7d 0a 20 20 69 66 28  tPage;.  }.  if(
3290: 20 73 7a 42 75 6c 6b 20 3e 20 70 43 61 63 68 65   szBulk > pCache
32a0: 2d 3e 73 7a 41 6c 6c 6f 63 2a 28 69 36 34 29 70  ->szAlloc*(i64)p
32b0: 43 61 63 68 65 2d 3e 6e 4d 61 78 20 29 7b 0a 20  Cache->nMax ){. 
32c0: 20 20 20 73 7a 42 75 6c 6b 20 3d 20 70 43 61 63     szBulk = pCac
32d0: 68 65 2d 3e 73 7a 41 6c 6c 6f 63 2a 28 69 36 34  he->szAlloc*(i64
32e0: 29 70 43 61 63 68 65 2d 3e 6e 4d 61 78 3b 0a 20  )pCache->nMax;. 
32f0: 20 7d 0a 20 20 7a 42 75 6c 6b 20 3d 20 70 43 61   }.  zBulk = pCa
3300: 63 68 65 2d 3e 70 42 75 6c 6b 20 3d 20 73 71 6c  che->pBulk = sql
3310: 69 74 65 33 4d 61 6c 6c 6f 63 28 20 73 7a 42 75  ite3Malloc( szBu
3320: 6c 6b 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 45  lk );.  sqlite3E
3330: 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29  ndBenignMalloc()
3340: 3b 0a 20 20 69 66 28 20 7a 42 75 6c 6b 20 29 7b  ;.  if( zBulk ){
3350: 0a 20 20 20 20 69 6e 74 20 6e 42 75 6c 6b 20 3d  .    int nBulk =
3360: 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69   sqlite3MallocSi
3370: 7a 65 28 7a 42 75 6c 6b 29 2f 70 43 61 63 68 65  ze(zBulk)/pCache
3380: 2d 3e 73 7a 41 6c 6c 6f 63 3b 0a 20 20 20 20 64  ->szAlloc;.    d
3390: 6f 7b 0a 20 20 20 20 20 20 50 67 48 64 72 31 20  o{.      PgHdr1 
33a0: 2a 70 58 20 3d 20 28 50 67 48 64 72 31 2a 29 26  *pX = (PgHdr1*)&
33b0: 7a 42 75 6c 6b 5b 70 43 61 63 68 65 2d 3e 73 7a  zBulk[pCache->sz
33c0: 50 61 67 65 5d 3b 0a 20 20 20 20 20 20 70 58 2d  Page];.      pX-
33d0: 3e 70 61 67 65 2e 70 42 75 66 20 3d 20 7a 42 75  >page.pBuf = zBu
33e0: 6c 6b 3b 0a 20 20 20 20 20 20 70 58 2d 3e 70 61  lk;.      pX->pa
33f0: 67 65 2e 70 45 78 74 72 61 20 3d 20 26 70 58 5b  ge.pExtra = &pX[
3400: 31 5d 3b 0a 20 20 20 20 20 20 70 58 2d 3e 69 73  1];.      pX->is
3410: 42 75 6c 6b 4c 6f 63 61 6c 20 3d 20 31 3b 0a 20  BulkLocal = 1;. 
3420: 20 20 20 20 20 70 58 2d 3e 69 73 41 6e 63 68 6f       pX->isAncho
3430: 72 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 58 2d  r = 0;.      pX-
3440: 3e 70 4e 65 78 74 20 3d 20 70 43 61 63 68 65 2d  >pNext = pCache-
3450: 3e 70 46 72 65 65 3b 0a 20 20 20 20 20 20 70 43  >pFree;.      pC
3460: 61 63 68 65 2d 3e 70 46 72 65 65 20 3d 20 70 58  ache->pFree = pX
3470: 3b 0a 20 20 20 20 20 20 7a 42 75 6c 6b 20 2b 3d  ;.      zBulk +=
3480: 20 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63   pCache->szAlloc
3490: 3b 0a 20 20 20 20 7d 77 68 69 6c 65 28 20 2d 2d  ;.    }while( --
34a0: 6e 42 75 6c 6b 20 29 3b 0a 20 20 7d 0a 20 20 72  nBulk );.  }.  r
34b0: 65 74 75 72 6e 20 70 43 61 63 68 65 2d 3e 70 46  eturn pCache->pF
34c0: 72 65 65 21 3d 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ree!=0;.}../*.**
34d0: 20 4d 61 6c 6c 6f 63 20 66 75 6e 63 74 69 6f 6e   Malloc function
34e0: 20 75 73 65 64 20 77 69 74 68 69 6e 20 74 68 69   used within thi
34f0: 73 20 66 69 6c 65 20 74 6f 20 61 6c 6c 6f 63 61  s file to alloca
3500: 74 65 20 73 70 61 63 65 20 66 72 6f 6d 20 74 68  te space from th
3510: 65 20 62 75 66 66 65 72 0a 2a 2a 20 63 6f 6e 66  e buffer.** conf
3520: 69 67 75 72 65 64 20 75 73 69 6e 67 20 73 71 6c  igured using sql
3530: 69 74 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49  ite3_config(SQLI
3540: 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41  TE_CONFIG_PAGECA
3550: 43 48 45 29 20 6f 70 74 69 6f 6e 2e 20 49 66 20  CHE) option. If 
3560: 6e 6f 20 0a 2a 2a 20 73 75 63 68 20 62 75 66 66  no .** such buff
3570: 65 72 20 65 78 69 73 74 73 20 6f 72 20 74 68 65  er exists or the
3580: 72 65 20 69 73 20 6e 6f 20 73 70 61 63 65 20 6c  re is no space l
3590: 65 66 74 20 69 6e 20 69 74 2c 20 74 68 69 73 20  eft in it, this 
35a0: 66 75 6e 63 74 69 6f 6e 20 66 61 6c 6c 73 20 0a  function falls .
35b0: 2a 2a 20 62 61 63 6b 20 74 6f 20 73 71 6c 69 74  ** back to sqlit
35c0: 65 33 4d 61 6c 6c 6f 63 28 29 2e 0a 2a 2a 0a 2a  e3Malloc()..**.*
35d0: 2a 20 4d 75 6c 74 69 70 6c 65 20 74 68 72 65 61  * Multiple threa
35e0: 64 73 20 63 61 6e 20 72 75 6e 20 74 68 69 73 20  ds can run this 
35f0: 72 6f 75 74 69 6e 65 20 61 74 20 74 68 65 20 73  routine at the s
3600: 61 6d 65 20 74 69 6d 65 2e 20 20 47 6c 6f 62 61  ame time.  Globa
3610: 6c 20 76 61 72 69 61 62 6c 65 73 0a 2a 2a 20 69  l variables.** i
3620: 6e 20 70 63 61 63 68 65 31 20 6e 65 65 64 20 74  n pcache1 need t
3630: 6f 20 62 65 20 70 72 6f 74 65 63 74 65 64 20 76  o be protected v
3640: 69 61 20 6d 75 74 65 78 2e 0a 2a 2f 0a 73 74 61  ia mutex..*/.sta
3650: 74 69 63 20 76 6f 69 64 20 2a 70 63 61 63 68 65  tic void *pcache
3660: 31 41 6c 6c 6f 63 28 69 6e 74 20 6e 42 79 74 65  1Alloc(int nByte
3670: 29 7b 0a 20 20 76 6f 69 64 20 2a 70 20 3d 20 30  ){.  void *p = 0
3680: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69  ;.  assert( sqli
3690: 74 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c  te3_mutex_nothel
36a0: 64 28 70 63 61 63 68 65 31 2e 67 72 70 2e 6d 75  d(pcache1.grp.mu
36b0: 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 6e 42  tex) );.  if( nB
36c0: 79 74 65 3c 3d 70 63 61 63 68 65 31 2e 73 7a 53  yte<=pcache1.szS
36d0: 6c 6f 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  lot ){.    sqlit
36e0: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70  e3_mutex_enter(p
36f0: 63 61 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20  cache1.mutex);. 
3700: 20 20 20 70 20 3d 20 28 50 67 48 64 72 31 20 2a     p = (PgHdr1 *
3710: 29 70 63 61 63 68 65 31 2e 70 46 72 65 65 3b 0a  )pcache1.pFree;.
3720: 20 20 20 20 69 66 28 20 70 20 29 7b 0a 20 20 20      if( p ){.   
3730: 20 20 20 70 63 61 63 68 65 31 2e 70 46 72 65 65     pcache1.pFree
3740: 20 3d 20 70 63 61 63 68 65 31 2e 70 46 72 65 65   = pcache1.pFree
3750: 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 70  ->pNext;.      p
3760: 63 61 63 68 65 31 2e 6e 46 72 65 65 53 6c 6f 74  cache1.nFreeSlot
3770: 2d 2d 3b 0a 20 20 20 20 20 20 70 63 61 63 68 65  --;.      pcache
3780: 31 2e 62 55 6e 64 65 72 50 72 65 73 73 75 72 65  1.bUnderPressure
3790: 20 3d 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65   = pcache1.nFree
37a0: 53 6c 6f 74 3c 70 63 61 63 68 65 31 2e 6e 52 65  Slot<pcache1.nRe
37b0: 73 65 72 76 65 3b 0a 20 20 20 20 20 20 61 73 73  serve;.      ass
37c0: 65 72 74 28 20 70 63 61 63 68 65 31 2e 6e 46 72  ert( pcache1.nFr
37d0: 65 65 53 6c 6f 74 3e 3d 30 20 29 3b 0a 20 20 20  eeSlot>=0 );.   
37e0: 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73     sqlite3Status
37f0: 48 69 67 68 77 61 74 65 72 28 53 51 4c 49 54 45  Highwater(SQLITE
3800: 5f 53 54 41 54 55 53 5f 50 41 47 45 43 41 43 48  _STATUS_PAGECACH
3810: 45 5f 53 49 5a 45 2c 20 6e 42 79 74 65 29 3b 0a  E_SIZE, nByte);.
3820: 20 20 20 20 20 20 73 71 6c 69 74 65 33 53 74 61        sqlite3Sta
3830: 74 75 73 55 70 28 53 51 4c 49 54 45 5f 53 54 41  tusUp(SQLITE_STA
3840: 54 55 53 5f 50 41 47 45 43 41 43 48 45 5f 55 53  TUS_PAGECACHE_US
3850: 45 44 2c 20 31 29 3b 0a 20 20 20 20 7d 0a 20 20  ED, 1);.    }.  
3860: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f    sqlite3_mutex_
3870: 6c 65 61 76 65 28 70 63 61 63 68 65 31 2e 6d 75  leave(pcache1.mu
3880: 74 65 78 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20  tex);.  }.  if( 
3890: 70 3d 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 20 4d  p==0 ){.    /* M
38a0: 65 6d 6f 72 79 20 69 73 20 6e 6f 74 20 61 76 61  emory is not ava
38b0: 69 6c 61 62 6c 65 20 69 6e 20 74 68 65 20 53 51  ilable in the SQ
38c0: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45  LITE_CONFIG_PAGE
38d0: 43 41 43 48 45 20 70 6f 6f 6c 2e 20 20 47 65 74  CACHE pool.  Get
38e0: 0a 20 20 20 20 2a 2a 20 69 74 20 66 72 6f 6d 20  .    ** it from 
38f0: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 20 69 6e  sqlite3Malloc in
3900: 73 74 65 61 64 2e 0a 20 20 20 20 2a 2f 0a 20 20  stead..    */.  
3910: 20 20 70 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c    p = sqlite3Mal
3920: 6c 6f 63 28 6e 42 79 74 65 29 3b 0a 23 69 66 6e  loc(nByte);.#ifn
3930: 64 65 66 20 53 51 4c 49 54 45 5f 44 49 53 41 42  def SQLITE_DISAB
3940: 4c 45 5f 50 41 47 45 43 41 43 48 45 5f 4f 56 45  LE_PAGECACHE_OVE
3950: 52 46 4c 4f 57 5f 53 54 41 54 53 0a 20 20 20 20  RFLOW_STATS.    
3960: 69 66 28 20 70 20 29 7b 0a 20 20 20 20 20 20 69  if( p ){.      i
3970: 6e 74 20 73 7a 20 3d 20 73 71 6c 69 74 65 33 4d  nt sz = sqlite3M
3980: 61 6c 6c 6f 63 53 69 7a 65 28 70 29 3b 0a 20 20  allocSize(p);.  
3990: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65      sqlite3_mute
39a0: 78 5f 65 6e 74 65 72 28 70 63 61 63 68 65 31 2e  x_enter(pcache1.
39b0: 6d 75 74 65 78 29 3b 0a 20 20 20 20 20 20 73 71  mutex);.      sq
39c0: 6c 69 74 65 33 53 74 61 74 75 73 48 69 67 68 77  lite3StatusHighw
39d0: 61 74 65 72 28 53 51 4c 49 54 45 5f 53 54 41 54  ater(SQLITE_STAT
39e0: 55 53 5f 50 41 47 45 43 41 43 48 45 5f 53 49 5a  US_PAGECACHE_SIZ
39f0: 45 2c 20 6e 42 79 74 65 29 3b 0a 20 20 20 20 20  E, nByte);.     
3a00: 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 55 70   sqlite3StatusUp
3a10: 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 50  (SQLITE_STATUS_P
3a20: 41 47 45 43 41 43 48 45 5f 4f 56 45 52 46 4c 4f  AGECACHE_OVERFLO
3a30: 57 2c 20 73 7a 29 3b 0a 20 20 20 20 20 20 73 71  W, sz);.      sq
3a40: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76  lite3_mutex_leav
3a50: 65 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29  e(pcache1.mutex)
3a60: 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20  ;.    }.#endif. 
3a70: 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62     sqlite3Memdeb
3a80: 75 67 53 65 74 54 79 70 65 28 70 2c 20 4d 45 4d  ugSetType(p, MEM
3a90: 54 59 50 45 5f 50 43 41 43 48 45 29 3b 0a 20 20  TYPE_PCACHE);.  
3aa0: 7d 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a  }.  return p;.}.
3ab0: 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 6e 20 61  ./*.** Free an a
3ac0: 6c 6c 6f 63 61 74 65 64 20 62 75 66 66 65 72 20  llocated buffer 
3ad0: 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 70 63  obtained from pc
3ae0: 61 63 68 65 31 41 6c 6c 6f 63 28 29 2e 0a 2a 2f  ache1Alloc()..*/
3af0: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61  .static void pca
3b00: 63 68 65 31 46 72 65 65 28 76 6f 69 64 20 2a 70  che1Free(void *p
3b10: 29 7b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20  ){.  if( p==0 ) 
3b20: 72 65 74 75 72 6e 3b 0a 20 20 69 66 28 20 53 51  return;.  if( SQ
3b30: 4c 49 54 45 5f 57 49 54 48 49 4e 28 70 2c 20 70  LITE_WITHIN(p, p
3b40: 63 61 63 68 65 31 2e 70 53 74 61 72 74 2c 20 70  cache1.pStart, p
3b50: 63 61 63 68 65 31 2e 70 45 6e 64 29 20 29 7b 0a  cache1.pEnd) ){.
3b60: 20 20 20 20 50 67 46 72 65 65 73 6c 6f 74 20 2a      PgFreeslot *
3b70: 70 53 6c 6f 74 3b 0a 20 20 20 20 73 71 6c 69 74  pSlot;.    sqlit
3b80: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70  e3_mutex_enter(p
3b90: 63 61 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20  cache1.mutex);. 
3ba0: 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73     sqlite3Status
3bb0: 44 6f 77 6e 28 53 51 4c 49 54 45 5f 53 54 41 54  Down(SQLITE_STAT
3bc0: 55 53 5f 50 41 47 45 43 41 43 48 45 5f 55 53 45  US_PAGECACHE_USE
3bd0: 44 2c 20 31 29 3b 0a 20 20 20 20 70 53 6c 6f 74  D, 1);.    pSlot
3be0: 20 3d 20 28 50 67 46 72 65 65 73 6c 6f 74 2a 29   = (PgFreeslot*)
3bf0: 70 3b 0a 20 20 20 20 70 53 6c 6f 74 2d 3e 70 4e  p;.    pSlot->pN
3c00: 65 78 74 20 3d 20 70 63 61 63 68 65 31 2e 70 46  ext = pcache1.pF
3c10: 72 65 65 3b 0a 20 20 20 20 70 63 61 63 68 65 31  ree;.    pcache1
3c20: 2e 70 46 72 65 65 20 3d 20 70 53 6c 6f 74 3b 0a  .pFree = pSlot;.
3c30: 20 20 20 20 70 63 61 63 68 65 31 2e 6e 46 72 65      pcache1.nFre
3c40: 65 53 6c 6f 74 2b 2b 3b 0a 20 20 20 20 70 63 61  eSlot++;.    pca
3c50: 63 68 65 31 2e 62 55 6e 64 65 72 50 72 65 73 73  che1.bUnderPress
3c60: 75 72 65 20 3d 20 70 63 61 63 68 65 31 2e 6e 46  ure = pcache1.nF
3c70: 72 65 65 53 6c 6f 74 3c 70 63 61 63 68 65 31 2e  reeSlot<pcache1.
3c80: 6e 52 65 73 65 72 76 65 3b 0a 20 20 20 20 61 73  nReserve;.    as
3c90: 73 65 72 74 28 20 70 63 61 63 68 65 31 2e 6e 46  sert( pcache1.nF
3ca0: 72 65 65 53 6c 6f 74 3c 3d 70 63 61 63 68 65 31  reeSlot<=pcache1
3cb0: 2e 6e 53 6c 6f 74 20 29 3b 0a 20 20 20 20 73 71  .nSlot );.    sq
3cc0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76  lite3_mutex_leav
3cd0: 65 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29  e(pcache1.mutex)
3ce0: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61  ;.  }else{.    a
3cf0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d 65  ssert( sqlite3Me
3d00: 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 70 2c  mdebugHasType(p,
3d10: 20 4d 45 4d 54 59 50 45 5f 50 43 41 43 48 45 29   MEMTYPE_PCACHE)
3d20: 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 4d   );.    sqlite3M
3d30: 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 28 70  emdebugSetType(p
3d40: 2c 20 4d 45 4d 54 59 50 45 5f 48 45 41 50 29 3b  , MEMTYPE_HEAP);
3d50: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
3d60: 44 49 53 41 42 4c 45 5f 50 41 47 45 43 41 43 48  DISABLE_PAGECACH
3d70: 45 5f 4f 56 45 52 46 4c 4f 57 5f 53 54 41 54 53  E_OVERFLOW_STATS
3d80: 0a 20 20 20 20 7b 0a 20 20 20 20 20 20 69 6e 74  .    {.      int
3d90: 20 6e 46 72 65 65 64 20 3d 20 30 3b 0a 20 20 20   nFreed = 0;.   
3da0: 20 20 20 6e 46 72 65 65 64 20 3d 20 73 71 6c 69     nFreed = sqli
3db0: 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 29  te3MallocSize(p)
3dc0: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f  ;.      sqlite3_
3dd0: 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 63 61 63  mutex_enter(pcac
3de0: 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20  he1.mutex);.    
3df0: 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 44    sqlite3StatusD
3e00: 6f 77 6e 28 53 51 4c 49 54 45 5f 53 54 41 54 55  own(SQLITE_STATU
3e10: 53 5f 50 41 47 45 43 41 43 48 45 5f 4f 56 45 52  S_PAGECACHE_OVER
3e20: 46 4c 4f 57 2c 20 6e 46 72 65 65 64 29 3b 0a 20  FLOW, nFreed);. 
3e30: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74       sqlite3_mut
3e40: 65 78 5f 6c 65 61 76 65 28 70 63 61 63 68 65 31  ex_leave(pcache1
3e50: 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 7d 0a 23  .mutex);.    }.#
3e60: 65 6e 64 69 66 0a 20 20 20 20 73 71 6c 69 74 65  endif.    sqlite
3e70: 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 7d 0a 7d  3_free(p);.  }.}
3e80: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ..#ifdef SQLITE_
3e90: 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41  ENABLE_MEMORY_MA
3ea0: 4e 41 47 45 4d 45 4e 54 0a 2f 2a 0a 2a 2a 20 52  NAGEMENT./*.** R
3eb0: 65 74 75 72 6e 20 74 68 65 20 73 69 7a 65 20 6f  eturn the size o
3ec0: 66 20 61 20 70 63 61 63 68 65 20 61 6c 6c 6f 63  f a pcache alloc
3ed0: 61 74 69 6f 6e 0a 2a 2f 0a 73 74 61 74 69 63 20  ation.*/.static 
3ee0: 69 6e 74 20 70 63 61 63 68 65 31 4d 65 6d 53 69  int pcache1MemSi
3ef0: 7a 65 28 76 6f 69 64 20 2a 70 29 7b 0a 20 20 69  ze(void *p){.  i
3f00: 66 28 20 70 3e 3d 70 63 61 63 68 65 31 2e 70 53  f( p>=pcache1.pS
3f10: 74 61 72 74 20 26 26 20 70 3c 70 63 61 63 68 65  tart && p<pcache
3f20: 31 2e 70 45 6e 64 20 29 7b 0a 20 20 20 20 72 65  1.pEnd ){.    re
3f30: 74 75 72 6e 20 70 63 61 63 68 65 31 2e 73 7a 53  turn pcache1.szS
3f40: 6c 6f 74 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  lot;.  }else{.  
3f50: 20 20 69 6e 74 20 69 53 69 7a 65 3b 0a 20 20 20    int iSize;.   
3f60: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
3f70: 4d 65 6d 64 65 62 75 67 48 61 73 54 79 70 65 28  MemdebugHasType(
3f80: 70 2c 20 4d 45 4d 54 59 50 45 5f 50 43 41 43 48  p, MEMTYPE_PCACH
3f90: 45 29 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  E) );.    sqlite
3fa0: 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65  3MemdebugSetType
3fb0: 28 70 2c 20 4d 45 4d 54 59 50 45 5f 48 45 41 50  (p, MEMTYPE_HEAP
3fc0: 29 3b 0a 20 20 20 20 69 53 69 7a 65 20 3d 20 73  );.    iSize = s
3fd0: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65  qlite3MallocSize
3fe0: 28 70 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  (p);.    sqlite3
3ff0: 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 28  MemdebugSetType(
4000: 70 2c 20 4d 45 4d 54 59 50 45 5f 50 43 41 43 48  p, MEMTYPE_PCACH
4010: 45 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 69  E);.    return i
4020: 53 69 7a 65 3b 0a 20 20 7d 0a 7d 0a 23 65 6e 64  Size;.  }.}.#end
4030: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41  if /* SQLITE_ENA
4040: 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47  BLE_MEMORY_MANAG
4050: 45 4d 45 4e 54 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20  EMENT */../*.** 
4060: 41 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 70  Allocate a new p
4070: 61 67 65 20 6f 62 6a 65 63 74 20 69 6e 69 74 69  age object initi
4080: 61 6c 6c 79 20 61 73 73 6f 63 69 61 74 65 64 20  ally associated 
4090: 77 69 74 68 20 63 61 63 68 65 20 70 43 61 63 68  with cache pCach
40a0: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67 48  e..*/.static PgH
40b0: 64 72 31 20 2a 70 63 61 63 68 65 31 41 6c 6c 6f  dr1 *pcache1Allo
40c0: 63 50 61 67 65 28 50 43 61 63 68 65 31 20 2a 70  cPage(PCache1 *p
40d0: 43 61 63 68 65 2c 20 69 6e 74 20 62 65 6e 69 67  Cache, int benig
40e0: 6e 4d 61 6c 6c 6f 63 29 7b 0a 20 20 50 67 48 64  nMalloc){.  PgHd
40f0: 72 31 20 2a 70 20 3d 20 30 3b 0a 20 20 76 6f 69  r1 *p = 0;.  voi
4100: 64 20 2a 70 50 67 3b 0a 0a 20 20 61 73 73 65 72  d *pPg;..  asser
4110: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  t( sqlite3_mutex
4120: 5f 68 65 6c 64 28 70 43 61 63 68 65 2d 3e 70 47  _held(pCache->pG
4130: 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a  roup->mutex) );.
4140: 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e 70 46    if( pCache->pF
4150: 72 65 65 20 7c 7c 20 28 70 43 61 63 68 65 2d 3e  ree || (pCache->
4160: 6e 50 61 67 65 3d 3d 30 20 26 26 20 70 63 61 63  nPage==0 && pcac
4170: 68 65 31 49 6e 69 74 42 75 6c 6b 28 70 43 61 63  he1InitBulk(pCac
4180: 68 65 29 29 20 29 7b 0a 20 20 20 20 70 20 3d 20  he)) ){.    p = 
4190: 70 43 61 63 68 65 2d 3e 70 46 72 65 65 3b 0a 20  pCache->pFree;. 
41a0: 20 20 20 70 43 61 63 68 65 2d 3e 70 46 72 65 65     pCache->pFree
41b0: 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 20   = p->pNext;.   
41c0: 20 70 2d 3e 70 4e 65 78 74 20 3d 20 30 3b 0a 20   p->pNext = 0;. 
41d0: 20 7d 65 6c 73 65 7b 0a 23 69 66 64 65 66 20 53   }else{.#ifdef S
41e0: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d  QLITE_ENABLE_MEM
41f0: 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 20  ORY_MANAGEMENT. 
4200: 20 20 20 2f 2a 20 54 68 65 20 67 72 6f 75 70 20     /* The group 
4210: 6d 75 74 65 78 20 6d 75 73 74 20 62 65 20 72 65  mutex must be re
4220: 6c 65 61 73 65 64 20 62 65 66 6f 72 65 20 70 63  leased before pc
4230: 61 63 68 65 31 41 6c 6c 6f 63 28 29 20 69 73 20  ache1Alloc() is 
4240: 63 61 6c 6c 65 64 2e 20 54 68 69 73 0a 20 20 20  called. This.   
4250: 20 2a 2a 20 69 73 20 62 65 63 61 75 73 65 20 69   ** is because i
4260: 74 20 6d 69 67 68 74 20 63 61 6c 6c 20 73 71 6c  t might call sql
4270: 69 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d  ite3_release_mem
4280: 6f 72 79 28 29 2c 20 77 68 69 63 68 20 61 73 73  ory(), which ass
4290: 75 6d 65 73 20 74 68 61 74 20 0a 20 20 20 20 2a  umes that .    *
42a0: 2a 20 74 68 69 73 20 6d 75 74 65 78 20 69 73 20  * this mutex is 
42b0: 6e 6f 74 20 68 65 6c 64 2e 20 2a 2f 0a 20 20 20  not held. */.   
42c0: 20 61 73 73 65 72 74 28 20 70 63 61 63 68 65 31   assert( pcache1
42d0: 2e 73 65 70 61 72 61 74 65 43 61 63 68 65 3d 3d  .separateCache==
42e0: 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28  0 );.    assert(
42f0: 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3d   pCache->pGroup=
4300: 3d 26 70 63 61 63 68 65 31 2e 67 72 70 20 29 3b  =&pcache1.grp );
4310: 0a 20 20 20 20 70 63 61 63 68 65 31 4c 65 61 76  .    pcache1Leav
4320: 65 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70  eMutex(pCache->p
4330: 47 72 6f 75 70 29 3b 0a 23 65 6e 64 69 66 0a 20  Group);.#endif. 
4340: 20 20 20 69 66 28 20 62 65 6e 69 67 6e 4d 61 6c     if( benignMal
4350: 6c 6f 63 20 29 7b 20 73 71 6c 69 74 65 33 42 65  loc ){ sqlite3Be
4360: 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28  ginBenignMalloc(
4370: 29 3b 20 7d 0a 23 69 66 64 65 66 20 53 51 4c 49  ); }.#ifdef SQLI
4380: 54 45 5f 50 43 41 43 48 45 5f 53 45 50 41 52 41  TE_PCACHE_SEPARA
4390: 54 45 5f 48 45 41 44 45 52 0a 20 20 20 20 70 50  TE_HEADER.    pP
43a0: 67 20 3d 20 70 63 61 63 68 65 31 41 6c 6c 6f 63  g = pcache1Alloc
43b0: 28 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 29  (pCache->szPage)
43c0: 3b 0a 20 20 20 20 70 20 3d 20 73 71 6c 69 74 65  ;.    p = sqlite
43d0: 33 4d 61 6c 6c 6f 63 28 73 69 7a 65 6f 66 28 50  3Malloc(sizeof(P
43e0: 67 48 64 72 31 29 20 2b 20 70 43 61 63 68 65 2d  gHdr1) + pCache-
43f0: 3e 73 7a 45 78 74 72 61 29 3b 0a 20 20 20 20 69  >szExtra);.    i
4400: 66 28 20 21 70 50 67 20 7c 7c 20 21 70 20 29 7b  f( !pPg || !p ){
4410: 0a 20 20 20 20 20 20 70 63 61 63 68 65 31 46 72  .      pcache1Fr
4420: 65 65 28 70 50 67 29 3b 0a 20 20 20 20 20 20 73  ee(pPg);.      s
4430: 71 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a  qlite3_free(p);.
4440: 20 20 20 20 20 20 70 50 67 20 3d 20 30 3b 0a 20        pPg = 0;. 
4450: 20 20 20 7d 0a 23 65 6c 73 65 0a 20 20 20 20 70     }.#else.    p
4460: 50 67 20 3d 20 70 63 61 63 68 65 31 41 6c 6c 6f  Pg = pcache1Allo
4470: 63 28 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f  c(pCache->szAllo
4480: 63 29 3b 0a 20 20 20 20 70 20 3d 20 28 50 67 48  c);.    p = (PgH
4490: 64 72 31 20 2a 29 26 28 28 75 38 20 2a 29 70 50  dr1 *)&((u8 *)pP
44a0: 67 29 5b 70 43 61 63 68 65 2d 3e 73 7a 50 61 67  g)[pCache->szPag
44b0: 65 5d 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 69  e];.#endif.    i
44c0: 66 28 20 62 65 6e 69 67 6e 4d 61 6c 6c 6f 63 20  f( benignMalloc 
44d0: 29 7b 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e  ){ sqlite3EndBen
44e0: 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 20 7d 0a 23  ignMalloc(); }.#
44f0: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41  ifdef SQLITE_ENA
4500: 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47  BLE_MEMORY_MANAG
4510: 45 4d 45 4e 54 0a 20 20 20 20 70 63 61 63 68 65  EMENT.    pcache
4520: 31 45 6e 74 65 72 4d 75 74 65 78 28 70 43 61 63  1EnterMutex(pCac
4530: 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 23 65 6e  he->pGroup);.#en
4540: 64 69 66 0a 20 20 20 20 69 66 28 20 70 50 67 3d  dif.    if( pPg=
4550: 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20  =0 ) return 0;. 
4560: 20 20 20 70 2d 3e 70 61 67 65 2e 70 42 75 66 20     p->page.pBuf 
4570: 3d 20 70 50 67 3b 0a 20 20 20 20 70 2d 3e 70 61  = pPg;.    p->pa
4580: 67 65 2e 70 45 78 74 72 61 20 3d 20 26 70 5b 31  ge.pExtra = &p[1
4590: 5d 3b 0a 20 20 20 20 70 2d 3e 69 73 42 75 6c 6b  ];.    p->isBulk
45a0: 4c 6f 63 61 6c 20 3d 20 30 3b 0a 20 20 20 20 70  Local = 0;.    p
45b0: 2d 3e 69 73 41 6e 63 68 6f 72 20 3d 20 30 3b 0a  ->isAnchor = 0;.
45c0: 20 20 7d 0a 20 20 28 2a 70 43 61 63 68 65 2d 3e    }.  (*pCache->
45d0: 70 6e 50 75 72 67 65 61 62 6c 65 29 2b 2b 3b 0a  pnPurgeable)++;.
45e0: 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 2f    return p;.}../
45f0: 2a 0a 2a 2a 20 46 72 65 65 20 61 20 70 61 67 65  *.** Free a page
4600: 20 6f 62 6a 65 63 74 20 61 6c 6c 6f 63 61 74 65   object allocate
4610: 64 20 62 79 20 70 63 61 63 68 65 31 41 6c 6c 6f  d by pcache1Allo
4620: 63 50 61 67 65 28 29 2e 0a 2a 2f 0a 73 74 61 74  cPage()..*/.stat
4630: 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 46  ic void pcache1F
4640: 72 65 65 50 61 67 65 28 50 67 48 64 72 31 20 2a  reePage(PgHdr1 *
4650: 70 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70  p){.  PCache1 *p
4660: 43 61 63 68 65 3b 0a 20 20 61 73 73 65 72 74 28  Cache;.  assert(
4670: 20 70 21 3d 30 20 29 3b 0a 20 20 70 43 61 63 68   p!=0 );.  pCach
4680: 65 20 3d 20 70 2d 3e 70 43 61 63 68 65 3b 0a 20  e = p->pCache;. 
4690: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
46a0: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 70  _mutex_held(p->p
46b0: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6d  Cache->pGroup->m
46c0: 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 70  utex) );.  if( p
46d0: 2d 3e 69 73 42 75 6c 6b 4c 6f 63 61 6c 20 29 7b  ->isBulkLocal ){
46e0: 0a 20 20 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20  .    p->pNext = 
46f0: 70 43 61 63 68 65 2d 3e 70 46 72 65 65 3b 0a 20  pCache->pFree;. 
4700: 20 20 20 70 43 61 63 68 65 2d 3e 70 46 72 65 65     pCache->pFree
4710: 20 3d 20 70 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20   = p;.  }else{. 
4720: 20 20 20 70 63 61 63 68 65 31 46 72 65 65 28 70     pcache1Free(p
4730: 2d 3e 70 61 67 65 2e 70 42 75 66 29 3b 0a 23 69  ->page.pBuf);.#i
4740: 66 64 65 66 20 53 51 4c 49 54 45 5f 50 43 41 43  fdef SQLITE_PCAC
4750: 48 45 5f 53 45 50 41 52 41 54 45 5f 48 45 41 44  HE_SEPARATE_HEAD
4760: 45 52 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66  ER.    sqlite3_f
4770: 72 65 65 28 70 29 3b 0a 23 65 6e 64 69 66 0a 20  ree(p);.#endif. 
4780: 20 7d 0a 20 20 28 2a 70 43 61 63 68 65 2d 3e 70   }.  (*pCache->p
4790: 6e 50 75 72 67 65 61 62 6c 65 29 2d 2d 3b 0a 7d  nPurgeable)--;.}
47a0: 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6c 6c 6f 63 20 66  ../*.** Malloc f
47b0: 75 6e 63 74 69 6f 6e 20 75 73 65 64 20 62 79 20  unction used by 
47c0: 53 51 4c 69 74 65 20 74 6f 20 6f 62 74 61 69 6e  SQLite to obtain
47d0: 20 73 70 61 63 65 20 66 72 6f 6d 20 74 68 65 20   space from the 
47e0: 62 75 66 66 65 72 20 63 6f 6e 66 69 67 75 72 65  buffer configure
47f0: 64 0a 2a 2a 20 75 73 69 6e 67 20 73 71 6c 69 74  d.** using sqlit
4800: 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54 45  e3_config(SQLITE
4810: 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48  _CONFIG_PAGECACH
4820: 45 29 20 6f 70 74 69 6f 6e 2e 20 49 66 20 6e 6f  E) option. If no
4830: 20 73 75 63 68 20 62 75 66 66 65 72 0a 2a 2a 20   such buffer.** 
4840: 65 78 69 73 74 73 2c 20 74 68 69 73 20 66 75 6e  exists, this fun
4850: 63 74 69 6f 6e 20 66 61 6c 6c 73 20 62 61 63 6b  ction falls back
4860: 20 74 6f 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f   to sqlite3Mallo
4870: 63 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71  c()..*/.void *sq
4880: 6c 69 74 65 33 50 61 67 65 4d 61 6c 6c 6f 63 28  lite3PageMalloc(
4890: 69 6e 74 20 73 7a 29 7b 0a 20 20 2f 2a 20 44 75  int sz){.  /* Du
48a0: 72 69 6e 67 20 72 65 62 61 6c 61 6e 63 65 20 6f  ring rebalance o
48b0: 70 65 72 61 74 69 6f 6e 73 20 6f 6e 20 61 20 63  perations on a c
48c0: 6f 72 72 75 70 74 20 64 61 74 61 62 61 73 65 20  orrupt database 
48d0: 66 69 6c 65 2c 20 69 74 20 69 73 20 73 6f 6d 65  file, it is some
48e0: 74 69 6d 65 73 0a 20 20 2a 2a 20 28 72 61 72 65  times.  ** (rare
48f0: 6c 79 29 20 70 6f 73 73 69 62 6c 65 20 74 6f 20  ly) possible to 
4900: 6f 76 65 72 72 65 61 64 20 74 68 65 20 74 65 6d  overread the tem
4910: 70 6f 72 61 72 79 20 70 61 67 65 20 62 75 66 66  porary page buff
4920: 65 72 20 62 79 20 61 20 66 65 77 20 62 79 74 65  er by a few byte
4930: 73 2e 0a 20 20 2a 2a 20 45 6e 6c 61 72 67 65 20  s..  ** Enlarge 
4940: 74 68 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 73  the allocation s
4950: 6c 69 67 68 74 6c 79 20 73 6f 20 74 68 61 74 20  lightly so that 
4960: 74 68 69 73 20 64 6f 65 73 20 6e 6f 74 20 63 61  this does not ca
4970: 75 73 65 20 70 72 6f 62 6c 65 6d 73 2e 20 2a 2f  use problems. */
4980: 0a 20 20 72 65 74 75 72 6e 20 70 63 61 63 68 65  .  return pcache
4990: 31 41 6c 6c 6f 63 28 73 7a 29 3b 0a 7d 0a 0a 2f  1Alloc(sz);.}../
49a0: 2a 0a 2a 2a 20 46 72 65 65 20 61 6e 20 61 6c 6c  *.** Free an all
49b0: 6f 63 61 74 65 64 20 62 75 66 66 65 72 20 6f 62  ocated buffer ob
49c0: 74 61 69 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69  tained from sqli
49d0: 74 65 33 50 61 67 65 4d 61 6c 6c 6f 63 28 29 2e  te3PageMalloc().
49e0: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
49f0: 50 61 67 65 46 72 65 65 28 76 6f 69 64 20 2a 70  PageFree(void *p
4a00: 29 7b 0a 20 20 70 63 61 63 68 65 31 46 72 65 65  ){.  pcache1Free
4a10: 28 70 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52  (p);.}.../*.** R
4a20: 65 74 75 72 6e 20 74 72 75 65 20 69 66 20 69 74  eturn true if it
4a30: 20 64 65 73 69 72 61 62 6c 65 20 74 6f 20 61 76   desirable to av
4a40: 6f 69 64 20 61 6c 6c 6f 63 61 74 69 6e 67 20 61  oid allocating a
4a50: 20 6e 65 77 20 70 61 67 65 20 63 61 63 68 65 0a   new page cache.
4a60: 2a 2a 20 65 6e 74 72 79 2e 0a 2a 2a 0a 2a 2a 20  ** entry..**.** 
4a70: 49 66 20 6d 65 6d 6f 72 79 20 77 61 73 20 61 6c  If memory was al
4a80: 6c 6f 63 61 74 65 64 20 73 70 65 63 69 66 69 63  located specific
4a90: 61 6c 6c 79 20 74 6f 20 74 68 65 20 70 61 67 65  ally to the page
4aa0: 20 63 61 63 68 65 20 75 73 69 6e 67 0a 2a 2a 20   cache using.** 
4ab0: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41  SQLITE_CONFIG_PA
4ac0: 47 45 43 41 43 48 45 20 62 75 74 20 74 68 61 74  GECACHE but that
4ad0: 20 6d 65 6d 6f 72 79 20 68 61 73 20 61 6c 6c 20   memory has all 
4ae0: 62 65 65 6e 20 75 73 65 64 2c 20 74 68 65 6e 0a  been used, then.
4af0: 2a 2a 20 69 74 20 69 73 20 64 65 73 69 72 61 62  ** it is desirab
4b00: 6c 65 20 74 6f 20 61 76 6f 69 64 20 61 6c 6c 6f  le to avoid allo
4b10: 63 61 74 69 6e 67 20 61 20 6e 65 77 20 70 61 67  cating a new pag
4b20: 65 20 63 61 63 68 65 20 65 6e 74 72 79 20 62 65  e cache entry be
4b30: 63 61 75 73 65 0a 2a 2a 20 70 72 65 73 75 6d 61  cause.** presuma
4b40: 62 6c 79 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49  bly SQLITE_CONFI
4b50: 47 5f 50 41 47 45 43 41 43 48 45 20 77 61 73 20  G_PAGECACHE was 
4b60: 73 75 70 70 6f 73 65 20 74 6f 20 62 65 20 73 75  suppose to be su
4b70: 66 66 69 63 69 65 6e 74 0a 2a 2a 20 66 6f 72 20  fficient.** for 
4b80: 61 6c 6c 20 70 61 67 65 20 63 61 63 68 65 20 6e  all page cache n
4b90: 65 65 64 73 20 61 6e 64 20 77 65 20 73 68 6f 75  eeds and we shou
4ba0: 6c 64 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 73  ld not need to s
4bb0: 70 69 6c 6c 20 74 68 65 0a 2a 2a 20 61 6c 6c 6f  pill the.** allo
4bc0: 63 61 74 69 6f 6e 20 6f 6e 74 6f 20 74 68 65 20  cation onto the 
4bd0: 68 65 61 70 2e 0a 2a 2a 0a 2a 2a 20 4f 72 2c 20  heap..**.** Or, 
4be0: 74 68 65 20 68 65 61 70 20 69 73 20 75 73 65 64  the heap is used
4bf0: 20 66 6f 72 20 61 6c 6c 20 70 61 67 65 20 63 61   for all page ca
4c00: 63 68 65 20 6d 65 6d 6f 72 79 20 62 75 74 20 74  che memory but t
4c10: 68 65 20 68 65 61 70 20 69 73 0a 2a 2a 20 75 6e  he heap is.** un
4c20: 64 65 72 20 6d 65 6d 6f 72 79 20 70 72 65 73 73  der memory press
4c30: 75 72 65 2c 20 74 68 65 6e 20 61 67 61 69 6e 20  ure, then again 
4c40: 69 74 20 69 73 20 64 65 73 69 72 61 62 6c 65 20  it is desirable 
4c50: 74 6f 20 61 76 6f 69 64 0a 2a 2a 20 61 6c 6c 6f  to avoid.** allo
4c60: 63 61 74 69 6e 67 20 61 20 6e 65 77 20 70 61 67  cating a new pag
4c70: 65 20 63 61 63 68 65 20 65 6e 74 72 79 20 69 6e  e cache entry in
4c80: 20 6f 72 64 65 72 20 74 6f 20 61 76 6f 69 64 20   order to avoid 
4c90: 73 74 72 65 73 73 69 6e 67 0a 2a 2a 20 74 68 65  stressing.** the
4ca0: 20 68 65 61 70 20 65 76 65 6e 20 66 75 72 74 68   heap even furth
4cb0: 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  er..*/.static in
4cc0: 74 20 70 63 61 63 68 65 31 55 6e 64 65 72 4d 65  t pcache1UnderMe
4cd0: 6d 6f 72 79 50 72 65 73 73 75 72 65 28 50 43 61  moryPressure(PCa
4ce0: 63 68 65 31 20 2a 70 43 61 63 68 65 29 7b 0a 20  che1 *pCache){. 
4cf0: 20 69 66 28 20 70 63 61 63 68 65 31 2e 6e 53 6c   if( pcache1.nSl
4d00: 6f 74 20 26 26 20 28 70 43 61 63 68 65 2d 3e 73  ot && (pCache->s
4d10: 7a 50 61 67 65 2b 70 43 61 63 68 65 2d 3e 73 7a  zPage+pCache->sz
4d20: 45 78 74 72 61 29 3c 3d 70 63 61 63 68 65 31 2e  Extra)<=pcache1.
4d30: 73 7a 53 6c 6f 74 20 29 7b 0a 20 20 20 20 72 65  szSlot ){.    re
4d40: 74 75 72 6e 20 70 63 61 63 68 65 31 2e 62 55 6e  turn pcache1.bUn
4d50: 64 65 72 50 72 65 73 73 75 72 65 3b 0a 20 20 7d  derPressure;.  }
4d60: 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e  else{.    return
4d70: 20 73 71 6c 69 74 65 33 48 65 61 70 4e 65 61 72   sqlite3HeapNear
4d80: 6c 79 46 75 6c 6c 28 29 3b 0a 20 20 7d 0a 7d 0a  lyFull();.  }.}.
4d90: 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ./**************
4da0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4db0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4dc0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4dd0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4de0: 2f 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 20 47 65 6e 65  /./******** Gene
4df0: 72 61 6c 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69  ral Implementati
4e00: 6f 6e 20 46 75 6e 63 74 69 6f 6e 73 20 2a 2a 2a  on Functions ***
4e10: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4e20: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4e30: 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66  */../*.** This f
4e40: 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20  unction is used 
4e50: 74 6f 20 72 65 73 69 7a 65 20 74 68 65 20 68 61  to resize the ha
4e60: 73 68 20 74 61 62 6c 65 20 75 73 65 64 20 62 79  sh table used by
4e70: 20 74 68 65 20 63 61 63 68 65 20 70 61 73 73 65   the cache passe
4e80: 64 0a 2a 2a 20 61 73 20 74 68 65 20 66 69 72 73  d.** as the firs
4e90: 74 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2a 0a 2a  t argument..**.*
4ea0: 2a 20 54 68 65 20 50 43 61 63 68 65 20 6d 75 74  * The PCache mut
4eb0: 65 78 20 6d 75 73 74 20 62 65 20 68 65 6c 64 20  ex must be held 
4ec0: 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69  when this functi
4ed0: 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f  on is called..*/
4ee0: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61  .static void pca
4ef0: 63 68 65 31 52 65 73 69 7a 65 48 61 73 68 28 50  che1ResizeHash(P
4f00: 43 61 63 68 65 31 20 2a 70 29 7b 0a 20 20 50 67  Cache1 *p){.  Pg
4f10: 48 64 72 31 20 2a 2a 61 70 4e 65 77 3b 0a 20 20  Hdr1 **apNew;.  
4f20: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 4e 65  unsigned int nNe
4f30: 77 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e  w;.  unsigned in
4f40: 74 20 69 3b 0a 0a 20 20 61 73 73 65 72 74 28 20  t i;..  assert( 
4f50: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65  sqlite3_mutex_he
4f60: 6c 64 28 70 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75  ld(p->pGroup->mu
4f70: 74 65 78 29 20 29 3b 0a 0a 20 20 6e 4e 65 77 20  tex) );..  nNew 
4f80: 3d 20 70 2d 3e 6e 48 61 73 68 2a 32 3b 0a 20 20  = p->nHash*2;.  
4f90: 69 66 28 20 6e 4e 65 77 3c 32 35 36 20 29 7b 0a  if( nNew<256 ){.
4fa0: 20 20 20 20 6e 4e 65 77 20 3d 20 32 35 36 3b 0a      nNew = 256;.
4fb0: 20 20 7d 0a 0a 20 20 70 63 61 63 68 65 31 4c 65    }..  pcache1Le
4fc0: 61 76 65 4d 75 74 65 78 28 70 2d 3e 70 47 72 6f  aveMutex(p->pGro
4fd0: 75 70 29 3b 0a 20 20 69 66 28 20 70 2d 3e 6e 48  up);.  if( p->nH
4fe0: 61 73 68 20 29 7b 20 73 71 6c 69 74 65 33 42 65  ash ){ sqlite3Be
4ff0: 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28  ginBenignMalloc(
5000: 29 3b 20 7d 0a 20 20 61 70 4e 65 77 20 3d 20 28  ); }.  apNew = (
5010: 50 67 48 64 72 31 20 2a 2a 29 73 71 6c 69 74 65  PgHdr1 **)sqlite
5020: 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 69 7a 65  3MallocZero(size
5030: 6f 66 28 50 67 48 64 72 31 20 2a 29 2a 6e 4e 65  of(PgHdr1 *)*nNe
5040: 77 29 3b 0a 20 20 69 66 28 20 70 2d 3e 6e 48 61  w);.  if( p->nHa
5050: 73 68 20 29 7b 20 73 71 6c 69 74 65 33 45 6e 64  sh ){ sqlite3End
5060: 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 20  BenignMalloc(); 
5070: 7d 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65 72  }.  pcache1Enter
5080: 4d 75 74 65 78 28 70 2d 3e 70 47 72 6f 75 70 29  Mutex(p->pGroup)
5090: 3b 0a 20 20 69 66 28 20 61 70 4e 65 77 20 29 7b  ;.  if( apNew ){
50a0: 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c  .    for(i=0; i<
50b0: 70 2d 3e 6e 48 61 73 68 3b 20 69 2b 2b 29 7b 0a  p->nHash; i++){.
50c0: 20 20 20 20 20 20 50 67 48 64 72 31 20 2a 70 50        PgHdr1 *pP
50d0: 61 67 65 3b 0a 20 20 20 20 20 20 50 67 48 64 72  age;.      PgHdr
50e0: 31 20 2a 70 4e 65 78 74 20 3d 20 70 2d 3e 61 70  1 *pNext = p->ap
50f0: 48 61 73 68 5b 69 5d 3b 0a 20 20 20 20 20 20 77  Hash[i];.      w
5100: 68 69 6c 65 28 20 28 70 50 61 67 65 20 3d 20 70  hile( (pPage = p
5110: 4e 65 78 74 29 21 3d 30 20 29 7b 0a 20 20 20 20  Next)!=0 ){.    
5120: 20 20 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74      unsigned int
5130: 20 68 20 3d 20 70 50 61 67 65 2d 3e 69 4b 65 79   h = pPage->iKey
5140: 20 25 20 6e 4e 65 77 3b 0a 20 20 20 20 20 20 20   % nNew;.       
5150: 20 70 4e 65 78 74 20 3d 20 70 50 61 67 65 2d 3e   pNext = pPage->
5160: 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 20 20 70  pNext;.        p
5170: 50 61 67 65 2d 3e 70 4e 65 78 74 20 3d 20 61 70  Page->pNext = ap
5180: 4e 65 77 5b 68 5d 3b 0a 20 20 20 20 20 20 20 20  New[h];.        
5190: 61 70 4e 65 77 5b 68 5d 20 3d 20 70 50 61 67 65  apNew[h] = pPage
51a0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
51b0: 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65      sqlite3_free
51c0: 28 70 2d 3e 61 70 48 61 73 68 29 3b 0a 20 20 20  (p->apHash);.   
51d0: 20 70 2d 3e 61 70 48 61 73 68 20 3d 20 61 70 4e   p->apHash = apN
51e0: 65 77 3b 0a 20 20 20 20 70 2d 3e 6e 48 61 73 68  ew;.    p->nHash
51f0: 20 3d 20 6e 4e 65 77 3b 0a 20 20 7d 0a 7d 0a 0a   = nNew;.  }.}..
5200: 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74  /*.** This funct
5210: 69 6f 6e 20 69 73 20 75 73 65 64 20 69 6e 74 65  ion is used inte
5220: 72 6e 61 6c 6c 79 20 74 6f 20 72 65 6d 6f 76 65  rnally to remove
5230: 20 74 68 65 20 70 61 67 65 20 70 50 61 67 65 20   the page pPage 
5240: 66 72 6f 6d 20 74 68 65 20 0a 2a 2a 20 50 47 72  from the .** PGr
5250: 6f 75 70 20 4c 52 55 20 6c 69 73 74 2c 20 69 66  oup LRU list, if
5260: 20 69 73 20 70 61 72 74 20 6f 66 20 69 74 2e 20   is part of it. 
5270: 49 66 20 70 50 61 67 65 20 69 73 20 6e 6f 74 20  If pPage is not 
5280: 70 61 72 74 20 6f 66 20 74 68 65 20 50 47 72 6f  part of the PGro
5290: 75 70 0a 2a 2a 20 4c 52 55 20 6c 69 73 74 2c 20  up.** LRU list, 
52a0: 74 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69  then this functi
52b0: 6f 6e 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a  on is a no-op..*
52c0: 2a 0a 2a 2a 20 54 68 65 20 50 47 72 6f 75 70 20  *.** The PGroup 
52d0: 6d 75 74 65 78 20 6d 75 73 74 20 62 65 20 68 65  mutex must be he
52e0: 6c 64 20 77 68 65 6e 20 74 68 69 73 20 66 75 6e  ld when this fun
52f0: 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2e  ction is called.
5300: 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67 48 64 72  .*/.static PgHdr
5310: 31 20 2a 70 63 61 63 68 65 31 50 69 6e 50 61 67  1 *pcache1PinPag
5320: 65 28 50 67 48 64 72 31 20 2a 70 50 61 67 65 29  e(PgHdr1 *pPage)
5330: 7b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67  {.  assert( pPag
5340: 65 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74  e!=0 );.  assert
5350: 28 20 50 41 47 45 5f 49 53 5f 55 4e 50 49 4e 4e  ( PAGE_IS_UNPINN
5360: 45 44 28 70 50 61 67 65 29 20 29 3b 0a 20 20 61  ED(pPage) );.  a
5370: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 4c  ssert( pPage->pL
5380: 72 75 4e 65 78 74 20 29 3b 0a 20 20 61 73 73 65  ruNext );.  asse
5390: 72 74 28 20 70 50 61 67 65 2d 3e 70 4c 72 75 50  rt( pPage->pLruP
53a0: 72 65 76 20 29 3b 0a 20 20 61 73 73 65 72 74 28  rev );.  assert(
53b0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68   sqlite3_mutex_h
53c0: 65 6c 64 28 70 50 61 67 65 2d 3e 70 43 61 63 68  eld(pPage->pCach
53d0: 65 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78  e->pGroup->mutex
53e0: 29 20 29 3b 0a 20 20 70 50 61 67 65 2d 3e 70 4c  ) );.  pPage->pL
53f0: 72 75 50 72 65 76 2d 3e 70 4c 72 75 4e 65 78 74  ruPrev->pLruNext
5400: 20 3d 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65   = pPage->pLruNe
5410: 78 74 3b 0a 20 20 70 50 61 67 65 2d 3e 70 4c 72  xt;.  pPage->pLr
5420: 75 4e 65 78 74 2d 3e 70 4c 72 75 50 72 65 76 20  uNext->pLruPrev 
5430: 3d 20 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 65  = pPage->pLruPre
5440: 76 3b 0a 20 20 70 50 61 67 65 2d 3e 70 4c 72 75  v;.  pPage->pLru
5450: 4e 65 78 74 20 3d 20 30 3b 0a 20 20 2f 2a 20 70  Next = 0;.  /* p
5460: 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 20 3d  Page->pLruPrev =
5470: 20 30 3b 0a 20 20 2a 2a 20 4e 6f 20 6e 65 65 64   0;.  ** No need
5480: 20 74 6f 20 63 6c 65 61 72 20 70 4c 72 75 50 72   to clear pLruPr
5490: 65 76 20 61 73 20 69 74 20 69 73 20 6e 65 76 65  ev as it is neve
54a0: 72 20 61 63 63 65 73 73 65 64 20 69 66 20 70 4c  r accessed if pL
54b0: 72 75 4e 65 78 74 20 69 73 20 30 20 2a 2f 0a 20  ruNext is 0 */. 
54c0: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e   assert( pPage->
54d0: 69 73 41 6e 63 68 6f 72 3d 3d 30 20 29 3b 0a 20  isAnchor==0 );. 
54e0: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e   assert( pPage->
54f0: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e  pCache->pGroup->
5500: 6c 72 75 2e 69 73 41 6e 63 68 6f 72 3d 3d 31 20  lru.isAnchor==1 
5510: 29 3b 0a 20 20 70 50 61 67 65 2d 3e 70 43 61 63  );.  pPage->pCac
5520: 68 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65 2d  he->nRecyclable-
5530: 2d 3b 0a 20 20 72 65 74 75 72 6e 20 70 50 61 67  -;.  return pPag
5540: 65 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 6d  e;.}.../*.** Rem
5550: 6f 76 65 20 74 68 65 20 70 61 67 65 20 73 75 70  ove the page sup
5560: 70 6c 69 65 64 20 61 73 20 61 6e 20 61 72 67 75  plied as an argu
5570: 6d 65 6e 74 20 66 72 6f 6d 20 74 68 65 20 68 61  ment from the ha
5580: 73 68 20 74 61 62 6c 65 20 0a 2a 2a 20 28 50 43  sh table .** (PC
5590: 61 63 68 65 31 2e 61 70 48 61 73 68 20 73 74 72  ache1.apHash str
55a0: 75 63 74 75 72 65 29 20 74 68 61 74 20 69 74 20  ucture) that it 
55b0: 69 73 20 63 75 72 72 65 6e 74 6c 79 20 73 74 6f  is currently sto
55c0: 72 65 64 20 69 6e 2e 0a 2a 2a 20 41 6c 73 6f 20  red in..** Also 
55d0: 66 72 65 65 20 74 68 65 20 70 61 67 65 20 69 66  free the page if
55e0: 20 66 72 65 65 50 61 67 65 20 69 73 20 74 72 75   freePage is tru
55f0: 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50 47 72  e..**.** The PGr
5600: 6f 75 70 20 6d 75 74 65 78 20 6d 75 73 74 20 62  oup mutex must b
5610: 65 20 68 65 6c 64 20 77 68 65 6e 20 74 68 69 73  e held when this
5620: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c   function is cal
5630: 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  led..*/.static v
5640: 6f 69 64 20 70 63 61 63 68 65 31 52 65 6d 6f 76  oid pcache1Remov
5650: 65 46 72 6f 6d 48 61 73 68 28 50 67 48 64 72 31  eFromHash(PgHdr1
5660: 20 2a 70 50 61 67 65 2c 20 69 6e 74 20 66 72 65   *pPage, int fre
5670: 65 46 6c 61 67 29 7b 0a 20 20 75 6e 73 69 67 6e  eFlag){.  unsign
5680: 65 64 20 69 6e 74 20 68 3b 0a 20 20 50 43 61 63  ed int h;.  PCac
5690: 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20 70 50  he1 *pCache = pP
56a0: 61 67 65 2d 3e 70 43 61 63 68 65 3b 0a 20 20 50  age->pCache;.  P
56b0: 67 48 64 72 31 20 2a 2a 70 70 3b 0a 0a 20 20 61  gHdr1 **pp;..  a
56c0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d  ssert( sqlite3_m
56d0: 75 74 65 78 5f 68 65 6c 64 28 70 43 61 63 68 65  utex_held(pCache
56e0: 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29  ->pGroup->mutex)
56f0: 20 29 3b 0a 20 20 68 20 3d 20 70 50 61 67 65 2d   );.  h = pPage-
5700: 3e 69 4b 65 79 20 25 20 70 43 61 63 68 65 2d 3e  >iKey % pCache->
5710: 6e 48 61 73 68 3b 0a 20 20 66 6f 72 28 70 70 3d  nHash;.  for(pp=
5720: 26 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b  &pCache->apHash[
5730: 68 5d 3b 20 28 2a 70 70 29 21 3d 70 50 61 67 65  h]; (*pp)!=pPage
5740: 3b 20 70 70 3d 26 28 2a 70 70 29 2d 3e 70 4e 65  ; pp=&(*pp)->pNe
5750: 78 74 29 3b 0a 20 20 2a 70 70 20 3d 20 28 2a 70  xt);.  *pp = (*p
5760: 70 29 2d 3e 70 4e 65 78 74 3b 0a 0a 20 20 70 43  p)->pNext;..  pC
5770: 61 63 68 65 2d 3e 6e 50 61 67 65 2d 2d 3b 0a 20  ache->nPage--;. 
5780: 20 69 66 28 20 66 72 65 65 46 6c 61 67 20 29 20   if( freeFlag ) 
5790: 70 63 61 63 68 65 31 46 72 65 65 50 61 67 65 28  pcache1FreePage(
57a0: 70 50 61 67 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  pPage);.}../*.**
57b0: 20 49 66 20 74 68 65 72 65 20 61 72 65 20 63 75   If there are cu
57c0: 72 72 65 6e 74 6c 79 20 6d 6f 72 65 20 74 68 61  rrently more tha
57d0: 6e 20 6e 4d 61 78 50 61 67 65 20 70 61 67 65 73  n nMaxPage pages
57e0: 20 61 6c 6c 6f 63 61 74 65 64 2c 20 74 72 79 0a   allocated, try.
57f0: 2a 2a 20 74 6f 20 72 65 63 79 63 6c 65 20 70 61  ** to recycle pa
5800: 67 65 73 20 74 6f 20 72 65 64 75 63 65 20 74 68  ges to reduce th
5810: 65 20 6e 75 6d 62 65 72 20 61 6c 6c 6f 63 61 74  e number allocat
5820: 65 64 20 74 6f 20 6e 4d 61 78 50 61 67 65 2e 0a  ed to nMaxPage..
5830: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70  */.static void p
5840: 63 61 63 68 65 31 45 6e 66 6f 72 63 65 4d 61 78  cache1EnforceMax
5850: 50 61 67 65 28 50 43 61 63 68 65 31 20 2a 70 43  Page(PCache1 *pC
5860: 61 63 68 65 29 7b 0a 20 20 50 47 72 6f 75 70 20  ache){.  PGroup 
5870: 2a 70 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65  *pGroup = pCache
5880: 2d 3e 70 47 72 6f 75 70 3b 0a 20 20 50 67 48 64  ->pGroup;.  PgHd
5890: 72 31 20 2a 70 3b 0a 20 20 61 73 73 65 72 74 28  r1 *p;.  assert(
58a0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68   sqlite3_mutex_h
58b0: 65 6c 64 28 70 47 72 6f 75 70 2d 3e 6d 75 74 65  eld(pGroup->mute
58c0: 78 29 20 29 3b 0a 20 20 77 68 69 6c 65 28 20 70  x) );.  while( p
58d0: 47 72 6f 75 70 2d 3e 6e 50 75 72 67 65 61 62 6c  Group->nPurgeabl
58e0: 65 3e 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61  e>pGroup->nMaxPa
58f0: 67 65 0a 20 20 20 20 20 20 26 26 20 28 70 3d 70  ge.      && (p=p
5900: 47 72 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72 75 50  Group->lru.pLruP
5910: 72 65 76 29 2d 3e 69 73 41 6e 63 68 6f 72 3d 3d  rev)->isAnchor==
5920: 30 0a 20 20 29 7b 0a 20 20 20 20 61 73 73 65 72  0.  ){.    asser
5930: 74 28 20 70 2d 3e 70 43 61 63 68 65 2d 3e 70 47  t( p->pCache->pG
5940: 72 6f 75 70 3d 3d 70 47 72 6f 75 70 20 29 3b 0a  roup==pGroup );.
5950: 20 20 20 20 61 73 73 65 72 74 28 20 50 41 47 45      assert( PAGE
5960: 5f 49 53 5f 55 4e 50 49 4e 4e 45 44 28 70 29 20  _IS_UNPINNED(p) 
5970: 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 50 69  );.    pcache1Pi
5980: 6e 50 61 67 65 28 70 29 3b 0a 20 20 20 20 70 63  nPage(p);.    pc
5990: 61 63 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48  ache1RemoveFromH
59a0: 61 73 68 28 70 2c 20 31 29 3b 0a 20 20 7d 0a 20  ash(p, 1);.  }. 
59b0: 20 69 66 28 20 70 43 61 63 68 65 2d 3e 6e 50 61   if( pCache->nPa
59c0: 67 65 3d 3d 30 20 26 26 20 70 43 61 63 68 65 2d  ge==0 && pCache-
59d0: 3e 70 42 75 6c 6b 20 29 7b 0a 20 20 20 20 73 71  >pBulk ){.    sq
59e0: 6c 69 74 65 33 5f 66 72 65 65 28 70 43 61 63 68  lite3_free(pCach
59f0: 65 2d 3e 70 42 75 6c 6b 29 3b 0a 20 20 20 20 70  e->pBulk);.    p
5a00: 43 61 63 68 65 2d 3e 70 42 75 6c 6b 20 3d 20 70  Cache->pBulk = p
5a10: 43 61 63 68 65 2d 3e 70 46 72 65 65 20 3d 20 30  Cache->pFree = 0
5a20: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44  ;.  }.}../*.** D
5a30: 69 73 63 61 72 64 20 61 6c 6c 20 70 61 67 65 73  iscard all pages
5a40: 20 66 72 6f 6d 20 63 61 63 68 65 20 70 43 61 63   from cache pCac
5a50: 68 65 20 77 69 74 68 20 61 20 70 61 67 65 20 6e  he with a page n
5a60: 75 6d 62 65 72 20 28 6b 65 79 20 76 61 6c 75 65  umber (key value
5a70: 29 20 0a 2a 2a 20 67 72 65 61 74 65 72 20 74 68  ) .** greater th
5a80: 61 6e 20 6f 72 20 65 71 75 61 6c 20 74 6f 20 69  an or equal to i
5a90: 4c 69 6d 69 74 2e 20 41 6e 79 20 70 69 6e 6e 65  Limit. Any pinne
5aa0: 64 20 70 61 67 65 73 20 74 68 61 74 20 6d 65 65  d pages that mee
5ab0: 74 20 74 68 69 73 20 0a 2a 2a 20 63 72 69 74 65  t this .** crite
5ac0: 72 69 61 20 61 72 65 20 75 6e 70 69 6e 6e 65 64  ria are unpinned
5ad0: 20 62 65 66 6f 72 65 20 74 68 65 79 20 61 72 65   before they are
5ae0: 20 64 69 73 63 61 72 64 65 64 2e 0a 2a 2a 0a 2a   discarded..**.*
5af0: 2a 20 54 68 65 20 50 43 61 63 68 65 20 6d 75 74  * The PCache mut
5b00: 65 78 20 6d 75 73 74 20 62 65 20 68 65 6c 64 20  ex must be held 
5b10: 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69  when this functi
5b20: 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f  on is called..*/
5b30: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61  .static void pca
5b40: 63 68 65 31 54 72 75 6e 63 61 74 65 55 6e 73 61  che1TruncateUnsa
5b50: 66 65 28 0a 20 20 50 43 61 63 68 65 31 20 2a 70  fe(.  PCache1 *p
5b60: 43 61 63 68 65 2c 20 20 20 20 20 20 20 20 20 20  Cache,          
5b70: 20 20 20 2f 2a 20 54 68 65 20 63 61 63 68 65 20     /* The cache 
5b80: 74 6f 20 74 72 75 6e 63 61 74 65 20 2a 2f 0a 20  to truncate */. 
5b90: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4c   unsigned int iL
5ba0: 69 6d 69 74 20 20 20 20 20 20 20 20 20 20 2f 2a  imit          /*
5bb0: 20 44 72 6f 70 20 70 61 67 65 73 20 77 69 74 68   Drop pages with
5bc0: 20 74 68 69 73 20 70 67 6e 6f 20 6f 72 20 6c 61   this pgno or la
5bd0: 72 67 65 72 20 2a 2f 0a 29 7b 0a 20 20 54 45 53  rger */.){.  TES
5be0: 54 4f 4e 4c 59 28 20 69 6e 74 20 6e 50 61 67 65  TONLY( int nPage
5bf0: 20 3d 20 30 3b 20 29 20 20 2f 2a 20 54 6f 20 61   = 0; )  /* To a
5c00: 73 73 65 72 74 20 70 43 61 63 68 65 2d 3e 6e 50  ssert pCache->nP
5c10: 61 67 65 20 69 73 20 63 6f 72 72 65 63 74 20 2a  age is correct *
5c20: 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74  /.  unsigned int
5c30: 20 68 2c 20 69 53 74 6f 70 3b 0a 20 20 61 73 73   h, iStop;.  ass
5c40: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74  ert( sqlite3_mut
5c50: 65 78 5f 68 65 6c 64 28 70 43 61 63 68 65 2d 3e  ex_held(pCache->
5c60: 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29  pGroup->mutex) )
5c70: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63  ;.  assert( pCac
5c80: 68 65 2d 3e 69 4d 61 78 4b 65 79 20 3e 3d 20 69  he->iMaxKey >= i
5c90: 4c 69 6d 69 74 20 29 3b 0a 20 20 61 73 73 65 72  Limit );.  asser
5ca0: 74 28 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68  t( pCache->nHash
5cb0: 20 3e 20 30 20 29 3b 0a 20 20 69 66 28 20 70 43   > 0 );.  if( pC
5cc0: 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 2d 20  ache->iMaxKey - 
5cd0: 69 4c 69 6d 69 74 20 3c 20 70 43 61 63 68 65 2d  iLimit < pCache-
5ce0: 3e 6e 48 61 73 68 20 29 7b 0a 20 20 20 20 2f 2a  >nHash ){.    /*
5cf0: 20 49 66 20 77 65 20 61 72 65 20 6a 75 73 74 20   If we are just 
5d00: 73 68 61 76 69 6e 67 20 74 68 65 20 6c 61 73 74  shaving the last
5d10: 20 66 65 77 20 70 61 67 65 73 20 6f 66 66 20 74   few pages off t
5d20: 68 65 20 65 6e 64 20 6f 66 20 74 68 65 0a 20 20  he end of the.  
5d30: 20 20 2a 2a 20 63 61 63 68 65 2c 20 74 68 65 6e    ** cache, then
5d40: 20 74 68 65 72 65 20 69 73 20 6e 6f 20 70 6f 69   there is no poi
5d50: 6e 74 20 69 6e 20 73 63 61 6e 6e 69 6e 67 20 74  nt in scanning t
5d60: 68 65 20 65 6e 74 69 72 65 20 68 61 73 68 20 74  he entire hash t
5d70: 61 62 6c 65 2e 0a 20 20 20 20 2a 2a 20 4f 6e 6c  able..    ** Onl
5d80: 79 20 73 63 61 6e 20 74 68 6f 73 65 20 68 61 73  y scan those has
5d90: 68 20 73 6c 6f 74 73 20 74 68 61 74 20 6d 69 67  h slots that mig
5da0: 68 74 20 63 6f 6e 74 61 69 6e 20 70 61 67 65 73  ht contain pages
5db0: 20 74 68 61 74 20 6e 65 65 64 20 74 6f 0a 20 20   that need to.  
5dc0: 20 20 2a 2a 20 62 65 20 72 65 6d 6f 76 65 64 2e    ** be removed.
5dd0: 20 2a 2f 0a 20 20 20 20 68 20 3d 20 69 4c 69 6d   */.    h = iLim
5de0: 69 74 20 25 20 70 43 61 63 68 65 2d 3e 6e 48 61  it % pCache->nHa
5df0: 73 68 3b 0a 20 20 20 20 69 53 74 6f 70 20 3d 20  sh;.    iStop = 
5e00: 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20  pCache->iMaxKey 
5e10: 25 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b  % pCache->nHash;
5e20: 0a 20 20 20 20 54 45 53 54 4f 4e 4c 59 28 20 6e  .    TESTONLY( n
5e30: 50 61 67 65 20 3d 20 2d 31 30 3b 20 29 20 20 2f  Page = -10; )  /
5e40: 2a 20 44 69 73 61 62 6c 65 20 74 68 65 20 70 43  * Disable the pC
5e50: 61 63 68 65 2d 3e 6e 50 61 67 65 20 76 61 6c 69  ache->nPage vali
5e60: 64 69 74 79 20 63 68 65 63 6b 20 2a 2f 0a 20 20  dity check */.  
5e70: 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 54 68  }else{.    /* Th
5e80: 69 73 20 69 73 20 74 68 65 20 67 65 6e 65 72 61  is is the genera
5e90: 6c 20 63 61 73 65 20 77 68 65 72 65 20 6d 61 6e  l case where man
5ea0: 79 20 70 61 67 65 73 20 61 72 65 20 62 65 69 6e  y pages are bein
5eb0: 67 20 72 65 6d 6f 76 65 64 2e 0a 20 20 20 20 2a  g removed..    *
5ec0: 2a 20 49 74 20 69 73 20 6e 65 63 65 73 73 61 72  * It is necessar
5ed0: 79 20 74 6f 20 73 63 61 6e 20 74 68 65 20 65 6e  y to scan the en
5ee0: 74 69 72 65 20 68 61 73 68 20 74 61 62 6c 65 20  tire hash table 
5ef0: 2a 2f 0a 20 20 20 20 68 20 3d 20 70 43 61 63 68  */.    h = pCach
5f00: 65 2d 3e 6e 48 61 73 68 2f 32 3b 0a 20 20 20 20  e->nHash/2;.    
5f10: 69 53 74 6f 70 20 3d 20 68 20 2d 20 31 3b 0a 20  iStop = h - 1;. 
5f20: 20 7d 0a 20 20 66 6f 72 28 3b 3b 29 7b 0a 20 20   }.  for(;;){.  
5f30: 20 20 50 67 48 64 72 31 20 2a 2a 70 70 3b 0a 20    PgHdr1 **pp;. 
5f40: 20 20 20 50 67 48 64 72 31 20 2a 70 50 61 67 65     PgHdr1 *pPage
5f50: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 68 3c  ;.    assert( h<
5f60: 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 20 29 3b  pCache->nHash );
5f70: 0a 20 20 20 20 70 70 20 3d 20 26 70 43 61 63 68  .    pp = &pCach
5f80: 65 2d 3e 61 70 48 61 73 68 5b 68 5d 3b 20 0a 20  e->apHash[h]; . 
5f90: 20 20 20 77 68 69 6c 65 28 20 28 70 50 61 67 65     while( (pPage
5fa0: 20 3d 20 2a 70 70 29 21 3d 30 20 29 7b 0a 20 20   = *pp)!=0 ){.  
5fb0: 20 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e 69      if( pPage->i
5fc0: 4b 65 79 3e 3d 69 4c 69 6d 69 74 20 29 7b 0a 20  Key>=iLimit ){. 
5fd0: 20 20 20 20 20 20 20 70 43 61 63 68 65 2d 3e 6e         pCache->n
5fe0: 50 61 67 65 2d 2d 3b 0a 20 20 20 20 20 20 20 20  Page--;.        
5ff0: 2a 70 70 20 3d 20 70 50 61 67 65 2d 3e 70 4e 65  *pp = pPage->pNe
6000: 78 74 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20  xt;.        if( 
6010: 50 41 47 45 5f 49 53 5f 55 4e 50 49 4e 4e 45 44  PAGE_IS_UNPINNED
6020: 28 70 50 61 67 65 29 20 29 20 70 63 61 63 68 65  (pPage) ) pcache
6030: 31 50 69 6e 50 61 67 65 28 70 50 61 67 65 29 3b  1PinPage(pPage);
6040: 0a 20 20 20 20 20 20 20 20 70 63 61 63 68 65 31  .        pcache1
6050: 46 72 65 65 50 61 67 65 28 70 50 61 67 65 29 3b  FreePage(pPage);
6060: 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  .      }else{.  
6070: 20 20 20 20 20 20 70 70 20 3d 20 26 70 50 61 67        pp = &pPag
6080: 65 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20  e->pNext;.      
6090: 20 20 54 45 53 54 4f 4e 4c 59 28 20 69 66 28 20    TESTONLY( if( 
60a0: 6e 50 61 67 65 3e 3d 30 20 29 20 6e 50 61 67 65  nPage>=0 ) nPage
60b0: 2b 2b 3b 20 29 0a 20 20 20 20 20 20 7d 0a 20 20  ++; ).      }.  
60c0: 20 20 7d 0a 20 20 20 20 69 66 28 20 68 3d 3d 69    }.    if( h==i
60d0: 53 74 6f 70 20 29 20 62 72 65 61 6b 3b 0a 20 20  Stop ) break;.  
60e0: 20 20 68 20 3d 20 28 68 2b 31 29 20 25 20 70 43    h = (h+1) % pC
60f0: 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 7d  ache->nHash;.  }
6100: 0a 20 20 61 73 73 65 72 74 28 20 6e 50 61 67 65  .  assert( nPage
6110: 3c 30 20 7c 7c 20 70 43 61 63 68 65 2d 3e 6e 50  <0 || pCache->nP
6120: 61 67 65 3d 3d 28 75 6e 73 69 67 6e 65 64 29 6e  age==(unsigned)n
6130: 50 61 67 65 20 29 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a  Page );.}../****
6140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
6150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
6160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
6170: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
6180: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 2f 2a 2a 2a  **********/./***
6190: 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65 33 5f 70 63  ***** sqlite3_pc
61a0: 61 63 68 65 20 4d 65 74 68 6f 64 73 20 2a 2a 2a  ache Methods ***
61b0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
61c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
61d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a  ***********/../*
61e0: 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69  .** Implementati
61f0: 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65  on of the sqlite
6200: 33 5f 70 63 61 63 68 65 2e 78 49 6e 69 74 20 6d  3_pcache.xInit m
6210: 65 74 68 6f 64 2e 0a 2a 2f 0a 73 74 61 74 69 63  ethod..*/.static
6220: 20 69 6e 74 20 70 63 61 63 68 65 31 49 6e 69 74   int pcache1Init
6230: 28 76 6f 69 64 20 2a 4e 6f 74 55 73 65 64 29 7b  (void *NotUsed){
6240: 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45  .  UNUSED_PARAME
6250: 54 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20  TER(NotUsed);.  
6260: 61 73 73 65 72 74 28 20 70 63 61 63 68 65 31 2e  assert( pcache1.
6270: 69 73 49 6e 69 74 3d 3d 30 20 29 3b 0a 20 20 6d  isInit==0 );.  m
6280: 65 6d 73 65 74 28 26 70 63 61 63 68 65 31 2c 20  emset(&pcache1, 
6290: 30 2c 20 73 69 7a 65 6f 66 28 70 63 61 63 68 65  0, sizeof(pcache
62a0: 31 29 29 3b 0a 0a 0a 20 20 2f 2a 0a 20 20 2a 2a  1));...  /*.  **
62b0: 20 54 68 65 20 70 63 61 63 68 65 31 2e 73 65 70   The pcache1.sep
62c0: 61 72 61 74 65 43 61 63 68 65 20 76 61 72 69 61  arateCache varia
62d0: 62 6c 65 20 69 73 20 74 72 75 65 20 69 66 20 65  ble is true if e
62e0: 61 63 68 20 50 43 61 63 68 65 20 68 61 73 20 69  ach PCache has i
62f0: 74 73 20 6f 77 6e 0a 20 20 2a 2a 20 70 72 69 76  ts own.  ** priv
6300: 61 74 65 20 50 47 72 6f 75 70 20 28 6d 6f 64 65  ate PGroup (mode
6310: 2d 31 29 2e 20 20 70 63 61 63 68 65 31 2e 73 65  -1).  pcache1.se
6320: 70 61 72 61 74 65 43 61 63 68 65 20 69 73 20 66  parateCache is f
6330: 61 6c 73 65 20 69 66 20 74 68 65 20 73 69 6e 67  alse if the sing
6340: 6c 65 0a 20 20 2a 2a 20 50 47 72 6f 75 70 20 69  le.  ** PGroup i
6350: 6e 20 70 63 61 63 68 65 31 2e 67 72 70 20 69 73  n pcache1.grp is
6360: 20 75 73 65 64 20 66 6f 72 20 61 6c 6c 20 70 61   used for all pa
6370: 67 65 20 63 61 63 68 65 73 20 28 6d 6f 64 65 2d  ge caches (mode-
6380: 32 29 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20  2)..  **.  **   
6390: 2a 20 20 41 6c 77 61 79 73 20 75 73 65 20 61 20  *  Always use a 
63a0: 75 6e 69 66 69 65 64 20 63 61 63 68 65 20 28 6d  unified cache (m
63b0: 6f 64 65 2d 32 29 20 69 66 20 45 4e 41 42 4c 45  ode-2) if ENABLE
63c0: 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45  _MEMORY_MANAGEME
63d0: 4e 54 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a  NT.  **.  **   *
63e0: 20 20 55 73 65 20 61 20 75 6e 69 66 69 65 64 20    Use a unified 
63f0: 63 61 63 68 65 20 69 6e 20 73 69 6e 67 6c 65 2d  cache in single-
6400: 74 68 72 65 61 64 65 64 20 61 70 70 6c 69 63 61  threaded applica
6410: 74 69 6f 6e 73 20 74 68 61 74 20 68 61 76 65 0a  tions that have.
6420: 20 20 2a 2a 20 20 20 20 20 20 63 6f 6e 66 69 67    **      config
6430: 75 72 65 64 20 61 20 73 74 61 72 74 2d 74 69 6d  ured a start-tim
6440: 65 20 62 75 66 66 65 72 20 66 6f 72 20 75 73 65  e buffer for use
6450: 20 61 73 20 70 61 67 65 2d 63 61 63 68 65 20 6d   as page-cache m
6460: 65 6d 6f 72 79 20 75 73 69 6e 67 0a 20 20 2a 2a  emory using.  **
6470: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f        sqlite3_co
6480: 6e 66 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46  nfig(SQLITE_CONF
6490: 49 47 5f 50 41 47 45 43 41 43 48 45 2c 20 70 42  IG_PAGECACHE, pB
64a0: 75 66 2c 20 73 7a 2c 20 4e 29 20 77 69 74 68 20  uf, sz, N) with 
64b0: 6e 6f 6e 2d 4e 55 4c 4c 20 0a 20 20 2a 2a 20 20  non-NULL .  **  
64c0: 20 20 20 20 70 42 75 66 20 61 72 67 75 6d 65 6e      pBuf argumen
64d0: 74 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a  t..  **.  **   *
64e0: 20 20 4f 74 68 65 72 77 69 73 65 20 75 73 65 20    Otherwise use 
64f0: 73 65 70 61 72 61 74 65 20 63 61 63 68 65 73 20  separate caches 
6500: 28 6d 6f 64 65 2d 31 29 0a 20 20 2a 2f 0a 23 69  (mode-1).  */.#i
6510: 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45  f defined(SQLITE
6520: 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d  _ENABLE_MEMORY_M
6530: 41 4e 41 47 45 4d 45 4e 54 29 0a 20 20 70 63 61  ANAGEMENT).  pca
6540: 63 68 65 31 2e 73 65 70 61 72 61 74 65 43 61 63  che1.separateCac
6550: 68 65 20 3d 20 30 3b 0a 23 65 6c 69 66 20 53 51  he = 0;.#elif SQ
6560: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 0a  LITE_THREADSAFE.
6570: 20 20 70 63 61 63 68 65 31 2e 73 65 70 61 72 61    pcache1.separa
6580: 74 65 43 61 63 68 65 20 3d 20 73 71 6c 69 74 65  teCache = sqlite
6590: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 50  3GlobalConfig.pP
65a0: 61 67 65 3d 3d 30 0a 20 20 20 20 20 20 20 20 20  age==0.         
65b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
65c0: 20 7c 7c 20 73 71 6c 69 74 65 33 47 6c 6f 62 61   || sqlite3Globa
65d0: 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74  lConfig.bCoreMut
65e0: 65 78 3e 30 3b 0a 23 65 6c 73 65 0a 20 20 70 63  ex>0;.#else.  pc
65f0: 61 63 68 65 31 2e 73 65 70 61 72 61 74 65 43 61  ache1.separateCa
6600: 63 68 65 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f  che = sqlite3Glo
6610: 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65 3d  balConfig.pPage=
6620: 3d 30 3b 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20  =0;.#endif..#if 
6630: 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46  SQLITE_THREADSAF
6640: 45 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 47  E.  if( sqlite3G
6650: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72  lobalConfig.bCor
6660: 65 4d 75 74 65 78 20 29 7b 0a 20 20 20 20 70 63  eMutex ){.    pc
6670: 61 63 68 65 31 2e 67 72 70 2e 6d 75 74 65 78 20  ache1.grp.mutex 
6680: 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c  = sqlite3MutexAl
6690: 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58  loc(SQLITE_MUTEX
66a0: 5f 53 54 41 54 49 43 5f 4c 52 55 29 3b 0a 20 20  _STATIC_LRU);.  
66b0: 20 20 70 63 61 63 68 65 31 2e 6d 75 74 65 78 20    pcache1.mutex 
66c0: 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c  = sqlite3MutexAl
66d0: 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58  loc(SQLITE_MUTEX
66e0: 5f 53 54 41 54 49 43 5f 50 4d 45 4d 29 3b 0a 20  _STATIC_PMEM);. 
66f0: 20 7d 0a 23 65 6e 64 69 66 0a 20 20 69 66 28 20   }.#endif.  if( 
6700: 70 63 61 63 68 65 31 2e 73 65 70 61 72 61 74 65  pcache1.separate
6710: 43 61 63 68 65 0a 20 20 20 26 26 20 73 71 6c 69  Cache.   && sqli
6720: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e  te3GlobalConfig.
6730: 6e 50 61 67 65 21 3d 30 0a 20 20 20 26 26 20 73  nPage!=0.   && s
6740: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66  qlite3GlobalConf
6750: 69 67 2e 70 50 61 67 65 3d 3d 30 0a 20 20 29 7b  ig.pPage==0.  ){
6760: 0a 20 20 20 20 70 63 61 63 68 65 31 2e 6e 49 6e  .    pcache1.nIn
6770: 69 74 50 61 67 65 20 3d 20 73 71 6c 69 74 65 33  itPage = sqlite3
6780: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 50 61  GlobalConfig.nPa
6790: 67 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ge;.  }else{.   
67a0: 20 70 63 61 63 68 65 31 2e 6e 49 6e 69 74 50 61   pcache1.nInitPa
67b0: 67 65 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 70 63  ge = 0;.  }.  pc
67c0: 61 63 68 65 31 2e 67 72 70 2e 6d 78 50 69 6e 6e  ache1.grp.mxPinn
67d0: 65 64 20 3d 20 31 30 3b 0a 20 20 70 63 61 63 68  ed = 10;.  pcach
67e0: 65 31 2e 69 73 49 6e 69 74 20 3d 20 31 3b 0a 20  e1.isInit = 1;. 
67f0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
6800: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c  K;.}../*.** Impl
6810: 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68  ementation of th
6820: 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  e sqlite3_pcache
6830: 2e 78 53 68 75 74 64 6f 77 6e 20 6d 65 74 68 6f  .xShutdown metho
6840: 64 2e 0a 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20  d..** Note that 
6850: 74 68 65 20 73 74 61 74 69 63 20 6d 75 74 65 78  the static mutex
6860: 20 61 6c 6c 6f 63 61 74 65 64 20 69 6e 20 78 49   allocated in xI
6870: 6e 69 74 20 64 6f 65 73 20 0a 2a 2a 20 6e 6f 74  nit does .** not
6880: 20 6e 65 65 64 20 74 6f 20 62 65 20 66 72 65 65   need to be free
6890: 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  d..*/.static voi
68a0: 64 20 70 63 61 63 68 65 31 53 68 75 74 64 6f 77  d pcache1Shutdow
68b0: 6e 28 76 6f 69 64 20 2a 4e 6f 74 55 73 65 64 29  n(void *NotUsed)
68c0: 7b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d  {.  UNUSED_PARAM
68d0: 45 54 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20  ETER(NotUsed);. 
68e0: 20 61 73 73 65 72 74 28 20 70 63 61 63 68 65 31   assert( pcache1
68f0: 2e 69 73 49 6e 69 74 21 3d 30 20 29 3b 0a 20 20  .isInit!=0 );.  
6900: 6d 65 6d 73 65 74 28 26 70 63 61 63 68 65 31 2c  memset(&pcache1,
6910: 20 30 2c 20 73 69 7a 65 6f 66 28 70 63 61 63 68   0, sizeof(pcach
6920: 65 31 29 29 3b 0a 7d 0a 0a 2f 2a 20 66 6f 72 77  e1));.}../* forw
6930: 61 72 64 20 64 65 63 6c 61 72 61 74 69 6f 6e 20  ard declaration 
6940: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70  */.static void p
6950: 63 61 63 68 65 31 44 65 73 74 72 6f 79 28 73 71  cache1Destroy(sq
6960: 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 29  lite3_pcache *p)
6970: 3b 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65  ;../*.** Impleme
6980: 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73  ntation of the s
6990: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78 43  qlite3_pcache.xC
69a0: 72 65 61 74 65 20 6d 65 74 68 6f 64 2e 0a 2a 2a  reate method..**
69b0: 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 61 20 6e  .** Allocate a n
69c0: 65 77 20 63 61 63 68 65 2e 0a 2a 2f 0a 73 74 61  ew cache..*/.sta
69d0: 74 69 63 20 73 71 6c 69 74 65 33 5f 70 63 61 63  tic sqlite3_pcac
69e0: 68 65 20 2a 70 63 61 63 68 65 31 43 72 65 61 74  he *pcache1Creat
69f0: 65 28 69 6e 74 20 73 7a 50 61 67 65 2c 20 69 6e  e(int szPage, in
6a00: 74 20 73 7a 45 78 74 72 61 2c 20 69 6e 74 20 62  t szExtra, int b
6a10: 50 75 72 67 65 61 62 6c 65 29 7b 0a 20 20 50 43  Purgeable){.  PC
6a20: 61 63 68 65 31 20 2a 70 43 61 63 68 65 3b 20 20  ache1 *pCache;  
6a30: 20 20 20 20 2f 2a 20 54 68 65 20 6e 65 77 6c 79      /* The newly
6a40: 20 63 72 65 61 74 65 64 20 70 61 67 65 20 63 61   created page ca
6a50: 63 68 65 20 2a 2f 0a 20 20 50 47 72 6f 75 70 20  che */.  PGroup 
6a60: 2a 70 47 72 6f 75 70 3b 20 20 20 20 20 20 20 2f  *pGroup;       /
6a70: 2a 20 54 68 65 20 67 72 6f 75 70 20 74 68 65 20  * The group the 
6a80: 6e 65 77 20 70 61 67 65 20 63 61 63 68 65 20 77  new page cache w
6a90: 69 6c 6c 20 62 65 6c 6f 6e 67 20 74 6f 20 2a 2f  ill belong to */
6aa0: 0a 20 20 69 6e 74 20 73 7a 3b 20 20 20 20 20 20  .  int sz;      
6ab0: 20 20 20 20 20 20 20 20 20 2f 2a 20 42 79 74 65           /* Byte
6ac0: 73 20 6f 66 20 6d 65 6d 6f 72 79 20 72 65 71 75  s of memory requ
6ad0: 69 72 65 64 20 74 6f 20 61 6c 6c 6f 63 61 74 65  ired to allocate
6ae0: 20 74 68 65 20 6e 65 77 20 63 61 63 68 65 20 2a   the new cache *
6af0: 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 28 73 7a  /..  assert( (sz
6b00: 50 61 67 65 20 26 20 28 73 7a 50 61 67 65 2d 31  Page & (szPage-1
6b10: 29 29 3d 3d 30 20 26 26 20 73 7a 50 61 67 65 3e  ))==0 && szPage>
6b20: 3d 35 31 32 20 26 26 20 73 7a 50 61 67 65 3c 3d  =512 && szPage<=
6b30: 36 35 35 33 36 20 29 3b 0a 20 20 61 73 73 65 72  65536 );.  asser
6b40: 74 28 20 73 7a 45 78 74 72 61 20 3c 20 33 30 30  t( szExtra < 300
6b50: 20 29 3b 0a 0a 20 20 73 7a 20 3d 20 73 69 7a 65   );..  sz = size
6b60: 6f 66 28 50 43 61 63 68 65 31 29 20 2b 20 73 69  of(PCache1) + si
6b70: 7a 65 6f 66 28 50 47 72 6f 75 70 29 2a 70 63 61  zeof(PGroup)*pca
6b80: 63 68 65 31 2e 73 65 70 61 72 61 74 65 43 61 63  che1.separateCac
6b90: 68 65 3b 0a 20 20 70 43 61 63 68 65 20 3d 20 28  he;.  pCache = (
6ba0: 50 43 61 63 68 65 31 20 2a 29 73 71 6c 69 74 65  PCache1 *)sqlite
6bb0: 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 7a 29 3b  3MallocZero(sz);
6bc0: 0a 20 20 69 66 28 20 70 43 61 63 68 65 20 29 7b  .  if( pCache ){
6bd0: 0a 20 20 20 20 69 66 28 20 70 63 61 63 68 65 31  .    if( pcache1
6be0: 2e 73 65 70 61 72 61 74 65 43 61 63 68 65 20 29  .separateCache )
6bf0: 7b 0a 20 20 20 20 20 20 70 47 72 6f 75 70 20 3d  {.      pGroup =
6c00: 20 28 50 47 72 6f 75 70 2a 29 26 70 43 61 63 68   (PGroup*)&pCach
6c10: 65 5b 31 5d 3b 0a 20 20 20 20 20 20 70 47 72 6f  e[1];.      pGro
6c20: 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 20 31  up->mxPinned = 1
6c30: 30 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  0;.    }else{.  
6c40: 20 20 20 20 70 47 72 6f 75 70 20 3d 20 26 70 63      pGroup = &pc
6c50: 61 63 68 65 31 2e 67 72 70 3b 0a 20 20 20 20 7d  ache1.grp;.    }
6c60: 0a 20 20 20 20 69 66 28 20 70 47 72 6f 75 70 2d  .    if( pGroup-
6c70: 3e 6c 72 75 2e 69 73 41 6e 63 68 6f 72 3d 3d 30  >lru.isAnchor==0
6c80: 20 29 7b 0a 20 20 20 20 20 20 70 47 72 6f 75 70   ){.      pGroup
6c90: 2d 3e 6c 72 75 2e 69 73 41 6e 63 68 6f 72 20 3d  ->lru.isAnchor =
6ca0: 20 31 3b 0a 20 20 20 20 20 20 70 47 72 6f 75 70   1;.      pGroup
6cb0: 2d 3e 6c 72 75 2e 70 4c 72 75 50 72 65 76 20 3d  ->lru.pLruPrev =
6cc0: 20 70 47 72 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72   pGroup->lru.pLr
6cd0: 75 4e 65 78 74 20 3d 20 26 70 47 72 6f 75 70 2d  uNext = &pGroup-
6ce0: 3e 6c 72 75 3b 0a 20 20 20 20 7d 0a 20 20 20 20  >lru;.    }.    
6cf0: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 20 3d  pCache->pGroup =
6d00: 20 70 47 72 6f 75 70 3b 0a 20 20 20 20 70 43 61   pGroup;.    pCa
6d10: 63 68 65 2d 3e 73 7a 50 61 67 65 20 3d 20 73 7a  che->szPage = sz
6d20: 50 61 67 65 3b 0a 20 20 20 20 70 43 61 63 68 65  Page;.    pCache
6d30: 2d 3e 73 7a 45 78 74 72 61 20 3d 20 73 7a 45 78  ->szExtra = szEx
6d40: 74 72 61 3b 0a 20 20 20 20 70 43 61 63 68 65 2d  tra;.    pCache-
6d50: 3e 73 7a 41 6c 6c 6f 63 20 3d 20 73 7a 50 61 67  >szAlloc = szPag
6d60: 65 20 2b 20 73 7a 45 78 74 72 61 20 2b 20 52 4f  e + szExtra + RO
6d70: 55 4e 44 38 28 73 69 7a 65 6f 66 28 50 67 48 64  UND8(sizeof(PgHd
6d80: 72 31 29 29 3b 0a 20 20 20 20 70 43 61 63 68 65  r1));.    pCache
6d90: 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 3d 20 28  ->bPurgeable = (
6da0: 62 50 75 72 67 65 61 62 6c 65 20 3f 20 31 20 3a  bPurgeable ? 1 :
6db0: 20 30 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31   0);.    pcache1
6dc0: 45 6e 74 65 72 4d 75 74 65 78 28 70 47 72 6f 75  EnterMutex(pGrou
6dd0: 70 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 52  p);.    pcache1R
6de0: 65 73 69 7a 65 48 61 73 68 28 70 43 61 63 68 65  esizeHash(pCache
6df0: 29 3b 0a 20 20 20 20 69 66 28 20 62 50 75 72 67  );.    if( bPurg
6e00: 65 61 62 6c 65 20 29 7b 0a 20 20 20 20 20 20 70  eable ){.      p
6e10: 43 61 63 68 65 2d 3e 6e 4d 69 6e 20 3d 20 31 30  Cache->nMin = 10
6e20: 3b 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e  ;.      pGroup->
6e30: 6e 4d 69 6e 50 61 67 65 20 2b 3d 20 70 43 61 63  nMinPage += pCac
6e40: 68 65 2d 3e 6e 4d 69 6e 3b 0a 20 20 20 20 20 20  he->nMin;.      
6e50: 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64  pGroup->mxPinned
6e60: 20 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50   = pGroup->nMaxP
6e70: 61 67 65 20 2b 20 31 30 20 2d 20 70 47 72 6f 75  age + 10 - pGrou
6e80: 70 2d 3e 6e 4d 69 6e 50 61 67 65 3b 0a 20 20 20  p->nMinPage;.   
6e90: 20 20 20 70 43 61 63 68 65 2d 3e 70 6e 50 75 72     pCache->pnPur
6ea0: 67 65 61 62 6c 65 20 3d 20 26 70 47 72 6f 75 70  geable = &pGroup
6eb0: 2d 3e 6e 50 75 72 67 65 61 62 6c 65 3b 0a 20 20  ->nPurgeable;.  
6ec0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70    }else{.      p
6ed0: 43 61 63 68 65 2d 3e 70 6e 50 75 72 67 65 61 62  Cache->pnPurgeab
6ee0: 6c 65 20 3d 20 26 70 43 61 63 68 65 2d 3e 6e 50  le = &pCache->nP
6ef0: 75 72 67 65 61 62 6c 65 44 75 6d 6d 79 3b 0a 20  urgeableDummy;. 
6f00: 20 20 20 7d 0a 20 20 20 20 70 63 61 63 68 65 31     }.    pcache1
6f10: 4c 65 61 76 65 4d 75 74 65 78 28 70 47 72 6f 75  LeaveMutex(pGrou
6f20: 70 29 3b 0a 20 20 20 20 69 66 28 20 70 43 61 63  p);.    if( pCac
6f30: 68 65 2d 3e 6e 48 61 73 68 3d 3d 30 20 29 7b 0a  he->nHash==0 ){.
6f40: 20 20 20 20 20 20 70 63 61 63 68 65 31 44 65 73        pcache1Des
6f50: 74 72 6f 79 28 28 73 71 6c 69 74 65 33 5f 70 63  troy((sqlite3_pc
6f60: 61 63 68 65 2a 29 70 43 61 63 68 65 29 3b 0a 20  ache*)pCache);. 
6f70: 20 20 20 20 20 70 43 61 63 68 65 20 3d 20 30 3b       pCache = 0;
6f80: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74  .    }.  }.  ret
6f90: 75 72 6e 20 28 73 71 6c 69 74 65 33 5f 70 63 61  urn (sqlite3_pca
6fa0: 63 68 65 20 2a 29 70 43 61 63 68 65 3b 0a 7d 0a  che *)pCache;.}.
6fb0: 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74  ./*.** Implement
6fc0: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c  ation of the sql
6fd0: 69 74 65 33 5f 70 63 61 63 68 65 2e 78 43 61 63  ite3_pcache.xCac
6fe0: 68 65 73 69 7a 65 20 6d 65 74 68 6f 64 2e 20 0a  hesize method. .
6ff0: 2a 2a 0a 2a 2a 20 43 6f 6e 66 69 67 75 72 65 20  **.** Configure 
7000: 74 68 65 20 63 61 63 68 65 5f 73 69 7a 65 20 6c  the cache_size l
7010: 69 6d 69 74 20 66 6f 72 20 61 20 63 61 63 68 65  imit for a cache
7020: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
7030: 20 70 63 61 63 68 65 31 43 61 63 68 65 73 69 7a   pcache1Cachesiz
7040: 65 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  e(sqlite3_pcache
7050: 20 2a 70 2c 20 69 6e 74 20 6e 4d 61 78 29 7b 0a   *p, int nMax){.
7060: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68    PCache1 *pCach
7070: 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70  e = (PCache1 *)p
7080: 3b 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e  ;.  if( pCache->
7090: 62 50 75 72 67 65 61 62 6c 65 20 29 7b 0a 20 20  bPurgeable ){.  
70a0: 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70    PGroup *pGroup
70b0: 20 3d 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75   = pCache->pGrou
70c0: 70 3b 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e  p;.    pcache1En
70d0: 74 65 72 4d 75 74 65 78 28 70 47 72 6f 75 70 29  terMutex(pGroup)
70e0: 3b 0a 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e 4d  ;.    pGroup->nM
70f0: 61 78 50 61 67 65 20 2b 3d 20 28 6e 4d 61 78 20  axPage += (nMax 
7100: 2d 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 29 3b  - pCache->nMax);
7110: 0a 20 20 20 20 70 47 72 6f 75 70 2d 3e 6d 78 50  .    pGroup->mxP
7120: 69 6e 6e 65 64 20 3d 20 70 47 72 6f 75 70 2d 3e  inned = pGroup->
7130: 6e 4d 61 78 50 61 67 65 20 2b 20 31 30 20 2d 20  nMaxPage + 10 - 
7140: 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65  pGroup->nMinPage
7150: 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 4d  ;.    pCache->nM
7160: 61 78 20 3d 20 6e 4d 61 78 3b 0a 20 20 20 20 70  ax = nMax;.    p
7170: 43 61 63 68 65 2d 3e 6e 39 30 70 63 74 20 3d 20  Cache->n90pct = 
7180: 70 43 61 63 68 65 2d 3e 6e 4d 61 78 2a 39 2f 31  pCache->nMax*9/1
7190: 30 3b 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e  0;.    pcache1En
71a0: 66 6f 72 63 65 4d 61 78 50 61 67 65 28 70 43 61  forceMaxPage(pCa
71b0: 63 68 65 29 3b 0a 20 20 20 20 70 63 61 63 68 65  che);.    pcache
71c0: 31 4c 65 61 76 65 4d 75 74 65 78 28 70 47 72 6f  1LeaveMutex(pGro
71d0: 75 70 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a  up);.  }.}../*.*
71e0: 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  * Implementation
71f0: 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f   of the sqlite3_
7200: 70 63 61 63 68 65 2e 78 53 68 72 69 6e 6b 20 6d  pcache.xShrink m
7210: 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 46 72  ethod. .**.** Fr
7220: 65 65 20 75 70 20 61 73 20 6d 75 63 68 20 6d 65  ee up as much me
7230: 6d 6f 72 79 20 61 73 20 70 6f 73 73 69 62 6c 65  mory as possible
7240: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
7250: 20 70 63 61 63 68 65 31 53 68 72 69 6e 6b 28 73   pcache1Shrink(s
7260: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70  qlite3_pcache *p
7270: 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43  ){.  PCache1 *pC
7280: 61 63 68 65 20 3d 20 28 50 43 61 63 68 65 31 2a  ache = (PCache1*
7290: 29 70 3b 0a 20 20 69 66 28 20 70 43 61 63 68 65  )p;.  if( pCache
72a0: 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 29 7b 0a  ->bPurgeable ){.
72b0: 20 20 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f      PGroup *pGro
72c0: 75 70 20 3d 20 70 43 61 63 68 65 2d 3e 70 47 72  up = pCache->pGr
72d0: 6f 75 70 3b 0a 20 20 20 20 69 6e 74 20 73 61 76  oup;.    int sav
72e0: 65 64 4d 61 78 50 61 67 65 3b 0a 20 20 20 20 70  edMaxPage;.    p
72f0: 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78  cache1EnterMutex
7300: 28 70 47 72 6f 75 70 29 3b 0a 20 20 20 20 73 61  (pGroup);.    sa
7310: 76 65 64 4d 61 78 50 61 67 65 20 3d 20 70 47 72  vedMaxPage = pGr
7320: 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 3b 0a 20  oup->nMaxPage;. 
7330: 20 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50     pGroup->nMaxP
7340: 61 67 65 20 3d 20 30 3b 0a 20 20 20 20 70 63 61  age = 0;.    pca
7350: 63 68 65 31 45 6e 66 6f 72 63 65 4d 61 78 50 61  che1EnforceMaxPa
7360: 67 65 28 70 43 61 63 68 65 29 3b 0a 20 20 20 20  ge(pCache);.    
7370: 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65  pGroup->nMaxPage
7380: 20 3d 20 73 61 76 65 64 4d 61 78 50 61 67 65 3b   = savedMaxPage;
7390: 0a 20 20 20 20 70 63 61 63 68 65 31 4c 65 61 76  .    pcache1Leav
73a0: 65 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a  eMutex(pGroup);.
73b0: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70    }.}../*.** Imp
73c0: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74  lementation of t
73d0: 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68  he sqlite3_pcach
73e0: 65 2e 78 50 61 67 65 63 6f 75 6e 74 20 6d 65 74  e.xPagecount met
73f0: 68 6f 64 2e 20 0a 2a 2f 0a 73 74 61 74 69 63 20  hod. .*/.static 
7400: 69 6e 74 20 70 63 61 63 68 65 31 50 61 67 65 63  int pcache1Pagec
7410: 6f 75 6e 74 28 73 71 6c 69 74 65 33 5f 70 63 61  ount(sqlite3_pca
7420: 63 68 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 6e  che *p){.  int n
7430: 3b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61  ;.  PCache1 *pCa
7440: 63 68 65 20 3d 20 28 50 43 61 63 68 65 31 2a 29  che = (PCache1*)
7450: 70 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65  p;.  pcache1Ente
7460: 72 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70  rMutex(pCache->p
7470: 47 72 6f 75 70 29 3b 0a 20 20 6e 20 3d 20 70 43  Group);.  n = pC
7480: 61 63 68 65 2d 3e 6e 50 61 67 65 3b 0a 20 20 70  ache->nPage;.  p
7490: 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78  cache1LeaveMutex
74a0: 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29  (pCache->pGroup)
74b0: 3b 0a 20 20 72 65 74 75 72 6e 20 6e 3b 0a 7d 0a  ;.  return n;.}.
74c0: 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e  ../*.** Implemen
74d0: 74 20 73 74 65 70 73 20 33 2c 20 34 2c 20 61 6e  t steps 3, 4, an
74e0: 64 20 35 20 6f 66 20 74 68 65 20 70 63 61 63 68  d 5 of the pcach
74f0: 65 31 46 65 74 63 68 28 29 20 61 6c 67 6f 72 69  e1Fetch() algori
7500: 74 68 6d 20 64 65 73 63 72 69 62 65 64 0a 2a 2a  thm described.**
7510: 20 69 6e 20 74 68 65 20 68 65 61 64 65 72 20 6f   in the header o
7520: 66 20 74 68 65 20 70 63 61 63 68 65 31 46 65 74  f the pcache1Fet
7530: 63 68 28 29 20 70 72 6f 63 65 64 75 72 65 2e 0a  ch() procedure..
7540: 2a 2a 0a 2a 2a 20 54 68 69 73 20 73 74 65 70 73  **.** This steps
7550: 20 61 72 65 20 62 72 6f 6b 65 6e 20 6f 75 74 20   are broken out 
7560: 69 6e 74 6f 20 61 20 73 65 70 61 72 61 74 65 20  into a separate 
7570: 70 72 6f 63 65 64 75 72 65 20 62 65 63 61 75 73  procedure becaus
7580: 65 20 74 68 65 79 20 61 72 65 0a 2a 2a 20 75 73  e they are.** us
7590: 75 61 6c 6c 79 20 6e 6f 74 20 6e 65 65 64 65 64  ually not needed
75a0: 2c 20 61 6e 64 20 62 79 20 61 76 6f 69 64 69 6e  , and by avoidin
75b0: 67 20 74 68 65 20 73 74 61 63 6b 20 69 6e 69 74  g the stack init
75c0: 69 61 6c 69 7a 61 74 69 6f 6e 20 72 65 71 75 69  ialization requi
75d0: 72 65 64 0a 2a 2a 20 66 6f 72 20 74 68 65 73 65  red.** for these
75e0: 20 73 74 65 70 73 2c 20 74 68 65 20 6d 61 69 6e   steps, the main
75f0: 20 70 63 61 63 68 65 31 46 65 74 63 68 28 29 20   pcache1Fetch() 
7600: 70 72 6f 63 65 64 75 72 65 20 63 61 6e 20 72 75  procedure can ru
7610: 6e 20 66 61 73 74 65 72 2e 0a 2a 2f 0a 73 74 61  n faster..*/.sta
7620: 74 69 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c  tic SQLITE_NOINL
7630: 49 4e 45 20 50 67 48 64 72 31 20 2a 70 63 61 63  INE PgHdr1 *pcac
7640: 68 65 31 46 65 74 63 68 53 74 61 67 65 32 28 0a  he1FetchStage2(.
7650: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68    PCache1 *pCach
7660: 65 2c 20 0a 20 20 75 6e 73 69 67 6e 65 64 20 69  e, .  unsigned i
7670: 6e 74 20 69 4b 65 79 2c 20 0a 20 20 69 6e 74 20  nt iKey, .  int 
7680: 63 72 65 61 74 65 46 6c 61 67 0a 29 7b 0a 20 20  createFlag.){.  
7690: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 50 69  unsigned int nPi
76a0: 6e 6e 65 64 3b 0a 20 20 50 47 72 6f 75 70 20 2a  nned;.  PGroup *
76b0: 70 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65 2d  pGroup = pCache-
76c0: 3e 70 47 72 6f 75 70 3b 0a 20 20 50 67 48 64 72  >pGroup;.  PgHdr
76d0: 31 20 2a 70 50 61 67 65 20 3d 20 30 3b 0a 0a 20  1 *pPage = 0;.. 
76e0: 20 2f 2a 20 53 74 65 70 20 33 3a 20 41 62 6f 72   /* Step 3: Abor
76f0: 74 20 69 66 20 63 72 65 61 74 65 46 6c 61 67 20  t if createFlag 
7700: 69 73 20 31 20 62 75 74 20 74 68 65 20 63 61 63  is 1 but the cac
7710: 68 65 20 69 73 20 6e 65 61 72 6c 79 20 66 75 6c  he is nearly ful
7720: 6c 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70  l */.  assert( p
7730: 43 61 63 68 65 2d 3e 6e 50 61 67 65 20 3e 3d 20  Cache->nPage >= 
7740: 70 43 61 63 68 65 2d 3e 6e 52 65 63 79 63 6c 61  pCache->nRecycla
7750: 62 6c 65 20 29 3b 0a 20 20 6e 50 69 6e 6e 65 64  ble );.  nPinned
7760: 20 3d 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65   = pCache->nPage
7770: 20 2d 20 70 43 61 63 68 65 2d 3e 6e 52 65 63 79   - pCache->nRecy
7780: 63 6c 61 62 6c 65 3b 0a 20 20 61 73 73 65 72 74  clable;.  assert
7790: 28 20 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e  ( pGroup->mxPinn
77a0: 65 64 20 3d 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d  ed == pGroup->nM
77b0: 61 78 50 61 67 65 20 2b 20 31 30 20 2d 20 70 47  axPage + 10 - pG
77c0: 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 20 29  roup->nMinPage )
77d0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63  ;.  assert( pCac
77e0: 68 65 2d 3e 6e 39 30 70 63 74 20 3d 3d 20 70 43  he->n90pct == pC
77f0: 61 63 68 65 2d 3e 6e 4d 61 78 2a 39 2f 31 30 20  ache->nMax*9/10 
7800: 29 3b 0a 20 20 69 66 28 20 63 72 65 61 74 65 46  );.  if( createF
7810: 6c 61 67 3d 3d 31 20 26 26 20 28 0a 20 20 20 20  lag==1 && (.    
7820: 20 20 20 20 6e 50 69 6e 6e 65 64 3e 3d 70 47 72      nPinned>=pGr
7830: 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 0a 20 20  oup->mxPinned.  
7840: 20 20 20 7c 7c 20 6e 50 69 6e 6e 65 64 3e 3d 70     || nPinned>=p
7850: 43 61 63 68 65 2d 3e 6e 39 30 70 63 74 0a 20 20  Cache->n90pct.  
7860: 20 20 20 7c 7c 20 28 70 63 61 63 68 65 31 55 6e     || (pcache1Un
7870: 64 65 72 4d 65 6d 6f 72 79 50 72 65 73 73 75 72  derMemoryPressur
7880: 65 28 70 43 61 63 68 65 29 20 26 26 20 70 43 61  e(pCache) && pCa
7890: 63 68 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65  che->nRecyclable
78a0: 3c 6e 50 69 6e 6e 65 64 29 0a 20 20 29 29 7b 0a  <nPinned).  )){.
78b0: 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20      return 0;.  
78c0: 7d 0a 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d  }..  if( pCache-
78d0: 3e 6e 50 61 67 65 3e 3d 70 43 61 63 68 65 2d 3e  >nPage>=pCache->
78e0: 6e 48 61 73 68 20 29 20 70 63 61 63 68 65 31 52  nHash ) pcache1R
78f0: 65 73 69 7a 65 48 61 73 68 28 70 43 61 63 68 65  esizeHash(pCache
7900: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61  );.  assert( pCa
7910: 63 68 65 2d 3e 6e 48 61 73 68 3e 30 20 26 26 20  che->nHash>0 && 
7920: 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 20 29  pCache->apHash )
7930: 3b 0a 0a 20 20 2f 2a 20 53 74 65 70 20 34 2e 20  ;..  /* Step 4. 
7940: 54 72 79 20 74 6f 20 72 65 63 79 63 6c 65 20 61  Try to recycle a
7950: 20 70 61 67 65 2e 20 2a 2f 0a 20 20 69 66 28 20   page. */.  if( 
7960: 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62  pCache->bPurgeab
7970: 6c 65 0a 20 20 20 26 26 20 21 70 47 72 6f 75 70  le.   && !pGroup
7980: 2d 3e 6c 72 75 2e 70 4c 72 75 50 72 65 76 2d 3e  ->lru.pLruPrev->
7990: 69 73 41 6e 63 68 6f 72 0a 20 20 20 26 26 20 28  isAnchor.   && (
79a0: 28 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 2b 31  (pCache->nPage+1
79b0: 3e 3d 70 43 61 63 68 65 2d 3e 6e 4d 61 78 29 20  >=pCache->nMax) 
79c0: 7c 7c 20 70 63 61 63 68 65 31 55 6e 64 65 72 4d  || pcache1UnderM
79d0: 65 6d 6f 72 79 50 72 65 73 73 75 72 65 28 70 43  emoryPressure(pC
79e0: 61 63 68 65 29 29 0a 20 20 29 7b 0a 20 20 20 20  ache)).  ){.    
79f0: 50 43 61 63 68 65 31 20 2a 70 4f 74 68 65 72 3b  PCache1 *pOther;
7a00: 0a 20 20 20 20 70 50 61 67 65 20 3d 20 70 47 72  .    pPage = pGr
7a10: 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72 75 50 72 65  oup->lru.pLruPre
7a20: 76 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 50  v;.    assert( P
7a30: 41 47 45 5f 49 53 5f 55 4e 50 49 4e 4e 45 44 28  AGE_IS_UNPINNED(
7a40: 70 50 61 67 65 29 20 29 3b 0a 20 20 20 20 70 63  pPage) );.    pc
7a50: 61 63 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48  ache1RemoveFromH
7a60: 61 73 68 28 70 50 61 67 65 2c 20 30 29 3b 0a 20  ash(pPage, 0);. 
7a70: 20 20 20 70 63 61 63 68 65 31 50 69 6e 50 61 67     pcache1PinPag
7a80: 65 28 70 50 61 67 65 29 3b 0a 20 20 20 20 70 4f  e(pPage);.    pO
7a90: 74 68 65 72 20 3d 20 70 50 61 67 65 2d 3e 70 43  ther = pPage->pC
7aa0: 61 63 68 65 3b 0a 20 20 20 20 69 66 28 20 70 4f  ache;.    if( pO
7ab0: 74 68 65 72 2d 3e 73 7a 41 6c 6c 6f 63 20 21 3d  ther->szAlloc !=
7ac0: 20 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63   pCache->szAlloc
7ad0: 20 29 7b 0a 20 20 20 20 20 20 70 63 61 63 68 65   ){.      pcache
7ae0: 31 46 72 65 65 50 61 67 65 28 70 50 61 67 65 29  1FreePage(pPage)
7af0: 3b 0a 20 20 20 20 20 20 70 50 61 67 65 20 3d 20  ;.      pPage = 
7b00: 30 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  0;.    }else{.  
7b10: 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e 50 75 72      pGroup->nPur
7b20: 67 65 61 62 6c 65 20 2d 3d 20 28 70 4f 74 68 65  geable -= (pOthe
7b30: 72 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 2d 20  r->bPurgeable - 
7b40: 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62  pCache->bPurgeab
7b50: 6c 65 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a  le);.    }.  }..
7b60: 20 20 2f 2a 20 53 74 65 70 20 35 2e 20 49 66 20    /* Step 5. If 
7b70: 61 20 75 73 61 62 6c 65 20 70 61 67 65 20 62 75  a usable page bu
7b80: 66 66 65 72 20 68 61 73 20 73 74 69 6c 6c 20 6e  ffer has still n
7b90: 6f 74 20 62 65 65 6e 20 66 6f 75 6e 64 2c 20 0a  ot been found, .
7ba0: 20 20 2a 2a 20 61 74 74 65 6d 70 74 20 74 6f 20    ** attempt to 
7bb0: 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 6f  allocate a new o
7bc0: 6e 65 2e 20 0a 20 20 2a 2f 0a 20 20 69 66 28 20  ne. .  */.  if( 
7bd0: 21 70 50 61 67 65 20 29 7b 0a 20 20 20 20 70 50  !pPage ){.    pP
7be0: 61 67 65 20 3d 20 70 63 61 63 68 65 31 41 6c 6c  age = pcache1All
7bf0: 6f 63 50 61 67 65 28 70 43 61 63 68 65 2c 20 63  ocPage(pCache, c
7c00: 72 65 61 74 65 46 6c 61 67 3d 3d 31 29 3b 0a 20  reateFlag==1);. 
7c10: 20 7d 0a 0a 20 20 69 66 28 20 70 50 61 67 65 20   }..  if( pPage 
7c20: 29 7b 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20  ){.    unsigned 
7c30: 69 6e 74 20 68 20 3d 20 69 4b 65 79 20 25 20 70  int h = iKey % p
7c40: 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20  Cache->nHash;.  
7c50: 20 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 2b    pCache->nPage+
7c60: 2b 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 4b  +;.    pPage->iK
7c70: 65 79 20 3d 20 69 4b 65 79 3b 0a 20 20 20 20 70  ey = iKey;.    p
7c80: 50 61 67 65 2d 3e 70 4e 65 78 74 20 3d 20 70 43  Page->pNext = pC
7c90: 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 3b  ache->apHash[h];
7ca0: 0a 20 20 20 20 70 50 61 67 65 2d 3e 70 43 61 63  .    pPage->pCac
7cb0: 68 65 20 3d 20 70 43 61 63 68 65 3b 0a 20 20 20  he = pCache;.   
7cc0: 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74   pPage->pLruNext
7cd0: 20 3d 20 30 3b 0a 20 20 20 20 2f 2a 20 70 50 61   = 0;.    /* pPa
7ce0: 67 65 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20 30  ge->pLruPrev = 0
7cf0: 3b 0a 20 20 20 20 2a 2a 20 4e 6f 20 6e 65 65 64  ;.    ** No need
7d00: 20 74 6f 20 63 6c 65 61 72 20 70 4c 72 75 50 72   to clear pLruPr
7d10: 65 76 20 73 69 6e 63 65 20 69 74 20 69 73 20 6e  ev since it is n
7d20: 6f 74 20 61 63 63 65 73 73 65 64 20 77 68 65 6e  ot accessed when
7d30: 20 70 4c 72 75 4e 65 78 74 3d 3d 30 20 2a 2f 0a   pLruNext==0 */.
7d40: 20 20 20 20 2a 28 76 6f 69 64 20 2a 2a 29 70 50      *(void **)pP
7d50: 61 67 65 2d 3e 70 61 67 65 2e 70 45 78 74 72 61  age->page.pExtra
7d60: 20 3d 20 30 3b 0a 20 20 20 20 70 43 61 63 68 65   = 0;.    pCache
7d70: 2d 3e 61 70 48 61 73 68 5b 68 5d 20 3d 20 70 50  ->apHash[h] = pP
7d80: 61 67 65 3b 0a 20 20 20 20 69 66 28 20 69 4b 65  age;.    if( iKe
7d90: 79 3e 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65  y>pCache->iMaxKe
7da0: 79 20 29 7b 0a 20 20 20 20 20 20 70 43 61 63 68  y ){.      pCach
7db0: 65 2d 3e 69 4d 61 78 4b 65 79 20 3d 20 69 4b 65  e->iMaxKey = iKe
7dc0: 79 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72  y;.    }.  }.  r
7dd0: 65 74 75 72 6e 20 70 50 61 67 65 3b 0a 7d 0a 0a  eturn pPage;.}..
7de0: 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61  /*.** Implementa
7df0: 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69  tion of the sqli
7e00: 74 65 33 5f 70 63 61 63 68 65 2e 78 46 65 74 63  te3_pcache.xFetc
7e10: 68 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a  h method. .**.**
7e20: 20 46 65 74 63 68 20 61 20 70 61 67 65 20 62 79   Fetch a page by
7e30: 20 6b 65 79 20 76 61 6c 75 65 2e 0a 2a 2a 0a 2a   key value..**.*
7e40: 2a 20 57 68 65 74 68 65 72 20 6f 72 20 6e 6f 74  * Whether or not
7e50: 20 61 20 6e 65 77 20 70 61 67 65 20 6d 61 79 20   a new page may 
7e60: 62 65 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 20  be allocated by 
7e70: 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 64 65  this function de
7e80: 70 65 6e 64 73 20 6f 6e 0a 2a 2a 20 74 68 65 20  pends on.** the 
7e90: 76 61 6c 75 65 20 6f 66 20 74 68 65 20 63 72 65  value of the cre
7ea0: 61 74 65 46 6c 61 67 20 61 72 67 75 6d 65 6e 74  ateFlag argument
7eb0: 2e 20 20 30 20 6d 65 61 6e 73 20 64 6f 20 6e 6f  .  0 means do no
7ec0: 74 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77  t allocate a new
7ed0: 0a 2a 2a 20 70 61 67 65 2e 20 20 31 20 6d 65 61  .** page.  1 mea
7ee0: 6e 73 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65  ns allocate a ne
7ef0: 77 20 70 61 67 65 20 69 66 20 73 70 61 63 65 20  w page if space 
7f00: 69 73 20 65 61 73 69 6c 79 20 61 76 61 69 6c 61  is easily availa
7f10: 62 6c 65 2e 20 20 32 20 0a 2a 2a 20 6d 65 61 6e  ble.  2 .** mean
7f20: 73 20 74 6f 20 74 72 79 20 72 65 61 6c 6c 79 20  s to try really 
7f30: 68 61 72 64 20 74 6f 20 61 6c 6c 6f 63 61 74 65  hard to allocate
7f40: 20 61 20 6e 65 77 20 70 61 67 65 2e 0a 2a 2a 0a   a new page..**.
7f50: 2a 2a 20 46 6f 72 20 61 20 6e 6f 6e 2d 70 75 72  ** For a non-pur
7f60: 67 65 61 62 6c 65 20 63 61 63 68 65 20 28 61 20  geable cache (a 
7f70: 63 61 63 68 65 20 75 73 65 64 20 61 73 20 74 68  cache used as th
7f80: 65 20 73 74 6f 72 61 67 65 20 66 6f 72 20 61 6e  e storage for an
7f90: 20 69 6e 2d 6d 65 6d 6f 72 79 0a 2a 2a 20 64 61   in-memory.** da
7fa0: 74 61 62 61 73 65 29 20 74 68 65 72 65 20 69 73  tabase) there is
7fb0: 20 72 65 61 6c 6c 79 20 6e 6f 20 64 69 66 66 65   really no diffe
7fc0: 72 65 6e 63 65 20 62 65 74 77 65 65 6e 20 63 72  rence between cr
7fd0: 65 61 74 65 46 6c 61 67 20 31 20 61 6e 64 20 32  eateFlag 1 and 2
7fe0: 2e 20 20 53 6f 0a 2a 2a 20 74 68 65 20 63 61 6c  .  So.** the cal
7ff0: 6c 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 28 70  ling function (p
8000: 63 61 63 68 65 2e 63 29 20 77 69 6c 6c 20 6e 65  cache.c) will ne
8010: 76 65 72 20 68 61 76 65 20 61 20 63 72 65 61 74  ver have a creat
8020: 65 46 6c 61 67 20 6f 66 20 31 20 6f 6e 0a 2a 2a  eFlag of 1 on.**
8030: 20 61 20 6e 6f 6e 2d 70 75 72 67 65 61 62 6c 65   a non-purgeable
8040: 20 63 61 63 68 65 2e 0a 2a 2a 0a 2a 2a 20 54 68   cache..**.** Th
8050: 65 72 65 20 61 72 65 20 74 68 72 65 65 20 64 69  ere are three di
8060: 66 66 65 72 65 6e 74 20 61 70 70 72 6f 61 63 68  fferent approach
8070: 65 73 20 74 6f 20 6f 62 74 61 69 6e 69 6e 67 20  es to obtaining 
8080: 73 70 61 63 65 20 66 6f 72 20 61 20 70 61 67 65  space for a page
8090: 2c 0a 2a 2a 20 64 65 70 65 6e 64 69 6e 67 20 6f  ,.** depending o
80a0: 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 70  n the value of p
80b0: 61 72 61 6d 65 74 65 72 20 63 72 65 61 74 65 46  arameter createF
80c0: 6c 61 67 20 28 77 68 69 63 68 20 6d 61 79 20 62  lag (which may b
80d0: 65 20 30 2c 20 31 20 6f 72 20 32 29 2e 0a 2a 2a  e 0, 1 or 2)..**
80e0: 0a 2a 2a 20 20 20 31 2e 20 52 65 67 61 72 64 6c  .**   1. Regardl
80f0: 65 73 73 20 6f 66 20 74 68 65 20 76 61 6c 75 65  ess of the value
8100: 20 6f 66 20 63 72 65 61 74 65 46 6c 61 67 2c 20   of createFlag, 
8110: 74 68 65 20 63 61 63 68 65 20 69 73 20 73 65 61  the cache is sea
8120: 72 63 68 65 64 20 66 6f 72 20 61 20 0a 2a 2a 20  rched for a .** 
8130: 20 20 20 20 20 63 6f 70 79 20 6f 66 20 74 68 65       copy of the
8140: 20 72 65 71 75 65 73 74 65 64 20 70 61 67 65 2e   requested page.
8150: 20 49 66 20 6f 6e 65 20 69 73 20 66 6f 75 6e 64   If one is found
8160: 2c 20 69 74 20 69 73 20 72 65 74 75 72 6e 65 64  , it is returned
8170: 2e 0a 2a 2a 0a 2a 2a 20 20 20 32 2e 20 49 66 20  ..**.**   2. If 
8180: 63 72 65 61 74 65 46 6c 61 67 3d 3d 30 20 61 6e  createFlag==0 an
8190: 64 20 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f  d the page is no
81a0: 74 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65  t already in the
81b0: 20 63 61 63 68 65 2c 20 4e 55 4c 4c 20 69 73 0a   cache, NULL is.
81c0: 2a 2a 20 20 20 20 20 20 72 65 74 75 72 6e 65 64  **      returned
81d0: 2e 0a 2a 2a 0a 2a 2a 20 20 20 33 2e 20 49 66 20  ..**.**   3. If 
81e0: 63 72 65 61 74 65 46 6c 61 67 20 69 73 20 31 2c  createFlag is 1,
81f0: 20 61 6e 64 20 74 68 65 20 70 61 67 65 20 69 73   and the page is
8200: 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 69 6e 20   not already in 
8210: 74 68 65 20 63 61 63 68 65 2c 20 74 68 65 6e 0a  the cache, then.
8220: 2a 2a 20 20 20 20 20 20 72 65 74 75 72 6e 20 4e  **      return N
8230: 55 4c 4c 20 28 64 6f 20 6e 6f 74 20 61 6c 6c 6f  ULL (do not allo
8240: 63 61 74 65 20 61 20 6e 65 77 20 70 61 67 65 29  cate a new page)
8250: 20 69 66 20 61 6e 79 20 6f 66 20 74 68 65 20 66   if any of the f
8260: 6f 6c 6c 6f 77 69 6e 67 0a 2a 2a 20 20 20 20 20  ollowing.**     
8270: 20 63 6f 6e 64 69 74 69 6f 6e 73 20 61 72 65 20   conditions are 
8280: 74 72 75 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20  true:.**.**     
8290: 20 20 28 61 29 20 74 68 65 20 6e 75 6d 62 65 72    (a) the number
82a0: 20 6f 66 20 70 61 67 65 73 20 70 69 6e 6e 65 64   of pages pinned
82b0: 20 62 79 20 74 68 65 20 63 61 63 68 65 20 69 73   by the cache is
82c0: 20 67 72 65 61 74 65 72 20 74 68 61 6e 0a 2a 2a   greater than.**
82d0: 20 20 20 20 20 20 20 20 20 20 20 50 43 61 63 68             PCach
82e0: 65 31 2e 6e 4d 61 78 2c 20 6f 72 0a 2a 2a 0a 2a  e1.nMax, or.**.*
82f0: 2a 20 20 20 20 20 20 20 28 62 29 20 74 68 65 20  *       (b) the 
8300: 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20  number of pages 
8310: 70 69 6e 6e 65 64 20 62 79 20 74 68 65 20 63 61  pinned by the ca
8320: 63 68 65 20 69 73 20 67 72 65 61 74 65 72 20 74  che is greater t
8330: 68 61 6e 0a 2a 2a 20 20 20 20 20 20 20 20 20 20  han.**          
8340: 20 74 68 65 20 73 75 6d 20 6f 66 20 6e 4d 61 78   the sum of nMax
8350: 20 66 6f 72 20 61 6c 6c 20 70 75 72 67 65 61 62   for all purgeab
8360: 6c 65 20 63 61 63 68 65 73 2c 20 6c 65 73 73 20  le caches, less 
8370: 74 68 65 20 73 75 6d 20 6f 66 20 0a 2a 2a 20 20  the sum of .**  
8380: 20 20 20 20 20 20 20 20 20 6e 4d 69 6e 20 66 6f           nMin fo
8390: 72 20 61 6c 6c 20 6f 74 68 65 72 20 70 75 72 67  r all other purg
83a0: 65 61 62 6c 65 20 63 61 63 68 65 73 2c 20 6f 72  eable caches, or
83b0: 0a 2a 2a 0a 2a 2a 20 20 20 34 2e 20 49 66 20 6e  .**.**   4. If n
83c0: 6f 6e 65 20 6f 66 20 74 68 65 20 66 69 72 73 74  one of the first
83d0: 20 74 68 72 65 65 20 63 6f 6e 64 69 74 69 6f 6e   three condition
83e0: 73 20 61 70 70 6c 79 20 61 6e 64 20 74 68 65 20  s apply and the 
83f0: 63 61 63 68 65 20 69 73 20 6d 61 72 6b 65 64 0a  cache is marked.
8400: 2a 2a 20 20 20 20 20 20 61 73 20 70 75 72 67 65  **      as purge
8410: 61 62 6c 65 2c 20 61 6e 64 20 69 66 20 6f 6e 65  able, and if one
8420: 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e   of the followin
8430: 67 20 69 73 20 74 72 75 65 3a 0a 2a 2a 0a 2a 2a  g is true:.**.**
8440: 20 20 20 20 20 20 20 28 61 29 20 54 68 65 20 6e         (a) The n
8450: 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 61  umber of pages a
8460: 6c 6c 6f 63 61 74 65 64 20 66 6f 72 20 74 68 65  llocated for the
8470: 20 63 61 63 68 65 20 69 73 20 61 6c 72 65 61 64   cache is alread
8480: 79 20 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20  y .**           
8490: 50 43 61 63 68 65 31 2e 6e 4d 61 78 2c 20 6f 72  PCache1.nMax, or
84a0: 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 28 62 29  .**.**       (b)
84b0: 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70   The number of p
84c0: 61 67 65 73 20 61 6c 6c 6f 63 61 74 65 64 20 66  ages allocated f
84d0: 6f 72 20 61 6c 6c 20 70 75 72 67 65 61 62 6c 65  or all purgeable
84e0: 20 63 61 63 68 65 73 20 69 73 0a 2a 2a 20 20 20   caches is.**   
84f0: 20 20 20 20 20 20 20 20 61 6c 72 65 61 64 79 20          already 
8500: 65 71 75 61 6c 20 74 6f 20 6f 72 20 67 72 65 61  equal to or grea
8510: 74 65 72 20 74 68 61 6e 20 74 68 65 20 73 75 6d  ter than the sum
8520: 20 6f 66 20 6e 4d 61 78 20 66 6f 72 20 61 6c 6c   of nMax for all
8530: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 70 75  .**           pu
8540: 72 67 65 61 62 6c 65 20 63 61 63 68 65 73 2c 0a  rgeable caches,.
8550: 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 28 63 29 20  **.**       (c) 
8560: 54 68 65 20 73 79 73 74 65 6d 20 69 73 20 75 6e  The system is un
8570: 64 65 72 20 6d 65 6d 6f 72 79 20 70 72 65 73 73  der memory press
8580: 75 72 65 20 61 6e 64 20 77 61 6e 74 73 20 74 6f  ure and wants to
8590: 20 61 76 6f 69 64 0a 2a 2a 20 20 20 20 20 20 20   avoid.**       
85a0: 20 20 20 20 75 6e 6e 65 63 65 73 73 61 72 79 20      unnecessary 
85b0: 70 61 67 65 73 20 63 61 63 68 65 20 65 6e 74 72  pages cache entr
85c0: 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 0a 2a 2a  y allocations.**
85d0: 0a 2a 2a 20 20 20 20 20 20 74 68 65 6e 20 61 74  .**      then at
85e0: 74 65 6d 70 74 20 74 6f 20 72 65 63 79 63 6c 65  tempt to recycle
85f0: 20 61 20 70 61 67 65 20 66 72 6f 6d 20 74 68 65   a page from the
8600: 20 4c 52 55 20 6c 69 73 74 2e 20 49 66 20 69 74   LRU list. If it
8610: 20 69 73 20 74 68 65 20 72 69 67 68 74 0a 2a 2a   is the right.**
8620: 20 20 20 20 20 20 73 69 7a 65 2c 20 72 65 74 75        size, retu
8630: 72 6e 20 74 68 65 20 72 65 63 79 63 6c 65 64 20  rn the recycled 
8640: 62 75 66 66 65 72 2e 20 4f 74 68 65 72 77 69 73  buffer. Otherwis
8650: 65 2c 20 66 72 65 65 20 74 68 65 20 62 75 66 66  e, free the buff
8660: 65 72 20 61 6e 64 0a 2a 2a 20 20 20 20 20 20 70  er and.**      p
8670: 72 6f 63 65 65 64 20 74 6f 20 73 74 65 70 20 35  roceed to step 5
8680: 2e 20 0a 2a 2a 0a 2a 2a 20 20 20 35 2e 20 4f 74  . .**.**   5. Ot
8690: 68 65 72 77 69 73 65 2c 20 61 6c 6c 6f 63 61 74  herwise, allocat
86a0: 65 20 61 6e 64 20 72 65 74 75 72 6e 20 61 20 6e  e and return a n
86b0: 65 77 20 70 61 67 65 20 62 75 66 66 65 72 2e 0a  ew page buffer..
86c0: 2a 2a 0a 2a 2a 20 54 68 65 72 65 20 61 72 65 20  **.** There are 
86d0: 74 77 6f 20 76 65 72 73 69 6f 6e 73 20 6f 66 20  two versions of 
86e0: 74 68 69 73 20 72 6f 75 74 69 6e 65 2e 20 20 70  this routine.  p
86f0: 63 61 63 68 65 31 46 65 74 63 68 57 69 74 68 4d  cache1FetchWithM
8700: 75 74 65 78 28 29 20 69 73 0a 2a 2a 20 74 68 65  utex() is.** the
8710: 20 67 65 6e 65 72 61 6c 20 63 61 73 65 2e 20 20   general case.  
8720: 70 63 61 63 68 65 31 46 65 74 63 68 4e 6f 4d 75  pcache1FetchNoMu
8730: 74 65 78 28 29 20 69 73 20 61 20 66 61 73 74 65  tex() is a faste
8740: 72 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  r implementation
8750: 20 66 6f 72 0a 2a 2a 20 74 68 65 20 63 6f 6d 6d   for.** the comm
8760: 6f 6e 20 63 61 73 65 20 77 68 65 72 65 20 70 47  on case where pG
8770: 72 6f 75 70 2d 3e 6d 75 74 65 78 20 69 73 20 4e  roup->mutex is N
8780: 55 4c 4c 2e 20 20 54 68 65 20 70 63 61 63 68 65  ULL.  The pcache
8790: 31 46 65 74 63 68 28 29 20 77 72 61 70 70 65 72  1Fetch() wrapper
87a0: 0a 2a 2a 20 69 6e 76 6f 6b 65 73 20 74 68 65 20  .** invokes the 
87b0: 61 70 70 72 6f 70 72 69 61 74 65 20 72 6f 75 74  appropriate rout
87c0: 69 6e 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50  ine..*/.static P
87d0: 67 48 64 72 31 20 2a 70 63 61 63 68 65 31 46 65  gHdr1 *pcache1Fe
87e0: 74 63 68 4e 6f 4d 75 74 65 78 28 0a 20 20 73 71  tchNoMutex(.  sq
87f0: 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 2c  lite3_pcache *p,
8800: 20 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74   .  unsigned int
8810: 20 69 4b 65 79 2c 20 0a 20 20 69 6e 74 20 63 72   iKey, .  int cr
8820: 65 61 74 65 46 6c 61 67 0a 29 7b 0a 20 20 50 43  eateFlag.){.  PC
8830: 61 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20  ache1 *pCache = 
8840: 28 50 43 61 63 68 65 31 20 2a 29 70 3b 0a 20 20  (PCache1 *)p;.  
8850: 50 67 48 64 72 31 20 2a 70 50 61 67 65 20 3d 20  PgHdr1 *pPage = 
8860: 30 3b 0a 0a 20 20 2f 2a 20 53 74 65 70 20 31 3a  0;..  /* Step 1:
8870: 20 53 65 61 72 63 68 20 74 68 65 20 68 61 73 68   Search the hash
8880: 20 74 61 62 6c 65 20 66 6f 72 20 61 6e 20 65 78   table for an ex
8890: 69 73 74 69 6e 67 20 65 6e 74 72 79 2e 20 2a 2f  isting entry. */
88a0: 0a 20 20 70 50 61 67 65 20 3d 20 70 43 61 63 68  .  pPage = pCach
88b0: 65 2d 3e 61 70 48 61 73 68 5b 69 4b 65 79 20 25  e->apHash[iKey %
88c0: 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 5d 3b   pCache->nHash];
88d0: 0a 20 20 77 68 69 6c 65 28 20 70 50 61 67 65 20  .  while( pPage 
88e0: 26 26 20 70 50 61 67 65 2d 3e 69 4b 65 79 21 3d  && pPage->iKey!=
88f0: 69 4b 65 79 20 29 7b 20 70 50 61 67 65 20 3d 20  iKey ){ pPage = 
8900: 70 50 61 67 65 2d 3e 70 4e 65 78 74 3b 20 7d 0a  pPage->pNext; }.
8910: 0a 20 20 2f 2a 20 53 74 65 70 20 32 3a 20 49 66  .  /* Step 2: If
8920: 20 74 68 65 20 70 61 67 65 20 77 61 73 20 66 6f   the page was fo
8930: 75 6e 64 20 69 6e 20 74 68 65 20 68 61 73 68 20  und in the hash 
8940: 74 61 62 6c 65 2c 20 74 68 65 6e 20 72 65 74 75  table, then retu
8950: 72 6e 20 69 74 2e 0a 20 20 2a 2a 20 49 66 20 74  rn it..  ** If t
8960: 68 65 20 70 61 67 65 20 77 61 73 20 6e 6f 74 20  he page was not 
8970: 69 6e 20 74 68 65 20 68 61 73 68 20 74 61 62 6c  in the hash tabl
8980: 65 20 61 6e 64 20 63 72 65 61 74 65 46 6c 61 67  e and createFlag
8990: 20 69 73 20 30 2c 20 61 62 6f 72 74 2e 0a 20 20   is 0, abort..  
89a0: 2a 2a 20 4f 74 68 65 72 77 69 73 65 20 28 70 61  ** Otherwise (pa
89b0: 67 65 20 6e 6f 74 20 69 6e 20 68 61 73 68 20 61  ge not in hash a
89c0: 6e 64 20 63 72 65 61 74 65 46 6c 61 67 21 3d 30  nd createFlag!=0
89d0: 29 20 63 6f 6e 74 69 6e 75 65 20 77 69 74 68 0a  ) continue with.
89e0: 20 20 2a 2a 20 73 75 62 73 65 71 75 65 6e 74 20    ** subsequent 
89f0: 73 74 65 70 73 20 74 6f 20 74 72 79 20 74 6f 20  steps to try to 
8a00: 63 72 65 61 74 65 20 74 68 65 20 70 61 67 65 2e  create the page.
8a10: 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 65 20   */.  if( pPage 
8a20: 29 7b 0a 20 20 20 20 69 66 28 20 50 41 47 45 5f  ){.    if( PAGE_
8a30: 49 53 5f 55 4e 50 49 4e 4e 45 44 28 70 50 61 67  IS_UNPINNED(pPag
8a40: 65 29 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75  e) ){.      retu
8a50: 72 6e 20 70 63 61 63 68 65 31 50 69 6e 50 61 67  rn pcache1PinPag
8a60: 65 28 70 50 61 67 65 29 3b 0a 20 20 20 20 7d 65  e(pPage);.    }e
8a70: 6c 73 65 7b 0a 20 20 20 20 20 20 72 65 74 75 72  lse{.      retur
8a80: 6e 20 70 50 61 67 65 3b 0a 20 20 20 20 7d 0a 20  n pPage;.    }. 
8a90: 20 7d 65 6c 73 65 20 69 66 28 20 63 72 65 61 74   }else if( creat
8aa0: 65 46 6c 61 67 20 29 7b 0a 20 20 20 20 2f 2a 20  eFlag ){.    /* 
8ab0: 53 74 65 70 73 20 33 2c 20 34 2c 20 61 6e 64 20  Steps 3, 4, and 
8ac0: 35 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62 79  5 implemented by
8ad0: 20 74 68 69 73 20 73 75 62 72 6f 75 74 69 6e 65   this subroutine
8ae0: 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 70   */.    return p
8af0: 63 61 63 68 65 31 46 65 74 63 68 53 74 61 67 65  cache1FetchStage
8b00: 32 28 70 43 61 63 68 65 2c 20 69 4b 65 79 2c 20  2(pCache, iKey, 
8b10: 63 72 65 61 74 65 46 6c 61 67 29 3b 0a 20 20 7d  createFlag);.  }
8b20: 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e  else{.    return
8b30: 20 30 3b 0a 20 20 7d 0a 7d 0a 23 69 66 20 50 43   0;.  }.}.#if PC
8b40: 41 43 48 45 31 5f 4d 49 47 48 54 5f 55 53 45 5f  ACHE1_MIGHT_USE_
8b50: 47 52 4f 55 50 5f 4d 55 54 45 58 0a 73 74 61 74  GROUP_MUTEX.stat
8b60: 69 63 20 50 67 48 64 72 31 20 2a 70 63 61 63 68  ic PgHdr1 *pcach
8b70: 65 31 46 65 74 63 68 57 69 74 68 4d 75 74 65 78  e1FetchWithMutex
8b80: 28 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63  (.  sqlite3_pcac
8b90: 68 65 20 2a 70 2c 20 0a 20 20 75 6e 73 69 67 6e  he *p, .  unsign
8ba0: 65 64 20 69 6e 74 20 69 4b 65 79 2c 20 0a 20 20  ed int iKey, .  
8bb0: 69 6e 74 20 63 72 65 61 74 65 46 6c 61 67 0a 29  int createFlag.)
8bc0: 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61  {.  PCache1 *pCa
8bd0: 63 68 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a  che = (PCache1 *
8be0: 29 70 3b 0a 20 20 50 67 48 64 72 31 20 2a 70 50  )p;.  PgHdr1 *pP
8bf0: 61 67 65 3b 0a 0a 20 20 70 63 61 63 68 65 31 45  age;..  pcache1E
8c00: 6e 74 65 72 4d 75 74 65 78 28 70 43 61 63 68 65  nterMutex(pCache
8c10: 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20 70 50 61  ->pGroup);.  pPa
8c20: 67 65 20 3d 20 70 63 61 63 68 65 31 46 65 74 63  ge = pcache1Fetc
8c30: 68 4e 6f 4d 75 74 65 78 28 70 2c 20 69 4b 65 79  hNoMutex(p, iKey
8c40: 2c 20 63 72 65 61 74 65 46 6c 61 67 29 3b 0a 20  , createFlag);. 
8c50: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 3d 3d   assert( pPage==
8c60: 30 20 7c 7c 20 70 43 61 63 68 65 2d 3e 69 4d 61  0 || pCache->iMa
8c70: 78 4b 65 79 3e 3d 69 4b 65 79 20 29 3b 0a 20 20  xKey>=iKey );.  
8c80: 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65  pcache1LeaveMute
8c90: 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70  x(pCache->pGroup
8ca0: 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 50 61 67  );.  return pPag
8cb0: 65 3b 0a 7d 0a 23 65 6e 64 69 66 0a 73 74 61 74  e;.}.#endif.stat
8cc0: 69 63 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68  ic sqlite3_pcach
8cd0: 65 5f 70 61 67 65 20 2a 70 63 61 63 68 65 31 46  e_page *pcache1F
8ce0: 65 74 63 68 28 0a 20 20 73 71 6c 69 74 65 33 5f  etch(.  sqlite3_
8cf0: 70 63 61 63 68 65 20 2a 70 2c 20 0a 20 20 75 6e  pcache *p, .  un
8d00: 73 69 67 6e 65 64 20 69 6e 74 20 69 4b 65 79 2c  signed int iKey,
8d10: 20 0a 20 20 69 6e 74 20 63 72 65 61 74 65 46 6c   .  int createFl
8d20: 61 67 0a 29 7b 0a 23 69 66 20 50 43 41 43 48 45  ag.){.#if PCACHE
8d30: 31 5f 4d 49 47 48 54 5f 55 53 45 5f 47 52 4f 55  1_MIGHT_USE_GROU
8d40: 50 5f 4d 55 54 45 58 20 7c 7c 20 64 65 66 69 6e  P_MUTEX || defin
8d50: 65 64 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29  ed(SQLITE_DEBUG)
8d60: 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63  .  PCache1 *pCac
8d70: 68 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29  he = (PCache1 *)
8d80: 70 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73 73  p;.#endif..  ass
8d90: 65 72 74 28 20 6f 66 66 73 65 74 6f 66 28 50 67  ert( offsetof(Pg
8da0: 48 64 72 31 2c 70 61 67 65 29 3d 3d 30 20 29 3b  Hdr1,page)==0 );
8db0: 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68  .  assert( pCach
8dc0: 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 7c 7c  e->bPurgeable ||
8dd0: 20 63 72 65 61 74 65 46 6c 61 67 21 3d 31 20 29   createFlag!=1 )
8de0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63  ;.  assert( pCac
8df0: 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 7c  he->bPurgeable |
8e00: 7c 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 3d 3d  | pCache->nMin==
8e10: 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  0 );.  assert( p
8e20: 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c  Cache->bPurgeabl
8e30: 65 3d 3d 30 20 7c 7c 20 70 43 61 63 68 65 2d 3e  e==0 || pCache->
8e40: 6e 4d 69 6e 3d 3d 31 30 20 29 3b 0a 20 20 61 73  nMin==10 );.  as
8e50: 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 4d  sert( pCache->nM
8e60: 69 6e 3d 3d 30 20 7c 7c 20 70 43 61 63 68 65 2d  in==0 || pCache-
8e70: 3e 62 50 75 72 67 65 61 62 6c 65 20 29 3b 0a 20  >bPurgeable );. 
8e80: 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65 2d   assert( pCache-
8e90: 3e 6e 48 61 73 68 3e 30 20 29 3b 0a 23 69 66 20  >nHash>0 );.#if 
8ea0: 50 43 41 43 48 45 31 5f 4d 49 47 48 54 5f 55 53  PCACHE1_MIGHT_US
8eb0: 45 5f 47 52 4f 55 50 5f 4d 55 54 45 58 0a 20 20  E_GROUP_MUTEX.  
8ec0: 69 66 28 20 70 43 61 63 68 65 2d 3e 70 47 72 6f  if( pCache->pGro
8ed0: 75 70 2d 3e 6d 75 74 65 78 20 29 7b 0a 20 20 20  up->mutex ){.   
8ee0: 20 72 65 74 75 72 6e 20 28 73 71 6c 69 74 65 33   return (sqlite3
8ef0: 5f 70 63 61 63 68 65 5f 70 61 67 65 2a 29 70 63  _pcache_page*)pc
8f00: 61 63 68 65 31 46 65 74 63 68 57 69 74 68 4d 75  ache1FetchWithMu
8f10: 74 65 78 28 70 2c 20 69 4b 65 79 2c 20 63 72 65  tex(p, iKey, cre
8f20: 61 74 65 46 6c 61 67 29 3b 0a 20 20 7d 65 6c 73  ateFlag);.  }els
8f30: 65 0a 23 65 6e 64 69 66 0a 20 20 7b 0a 20 20 20  e.#endif.  {.   
8f40: 20 72 65 74 75 72 6e 20 28 73 71 6c 69 74 65 33   return (sqlite3
8f50: 5f 70 63 61 63 68 65 5f 70 61 67 65 2a 29 70 63  _pcache_page*)pc
8f60: 61 63 68 65 31 46 65 74 63 68 4e 6f 4d 75 74 65  ache1FetchNoMute
8f70: 78 28 70 2c 20 69 4b 65 79 2c 20 63 72 65 61 74  x(p, iKey, creat
8f80: 65 46 6c 61 67 29 3b 0a 20 20 7d 0a 7d 0a 0a 0a  eFlag);.  }.}...
8f90: 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61  /*.** Implementa
8fa0: 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69  tion of the sqli
8fb0: 74 65 33 5f 70 63 61 63 68 65 2e 78 55 6e 70 69  te3_pcache.xUnpi
8fc0: 6e 20 6d 65 74 68 6f 64 2e 0a 2a 2a 0a 2a 2a 20  n method..**.** 
8fd0: 4d 61 72 6b 20 61 20 70 61 67 65 20 61 73 20 75  Mark a page as u
8fe0: 6e 70 69 6e 6e 65 64 20 28 65 6c 69 67 69 62 6c  npinned (eligibl
8ff0: 65 20 66 6f 72 20 61 73 79 6e 63 68 72 6f 6e 6f  e for asynchrono
9000: 75 73 20 72 65 63 79 63 6c 69 6e 67 29 2e 0a 2a  us recycling)..*
9010: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63  /.static void pc
9020: 61 63 68 65 31 55 6e 70 69 6e 28 0a 20 20 73 71  ache1Unpin(.  sq
9030: 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 2c  lite3_pcache *p,
9040: 20 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63   .  sqlite3_pcac
9050: 68 65 5f 70 61 67 65 20 2a 70 50 67 2c 20 0a 20  he_page *pPg, . 
9060: 20 69 6e 74 20 72 65 75 73 65 55 6e 6c 69 6b 65   int reuseUnlike
9070: 6c 79 0a 29 7b 0a 20 20 50 43 61 63 68 65 31 20  ly.){.  PCache1 
9080: 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61 63 68  *pCache = (PCach
9090: 65 31 20 2a 29 70 3b 0a 20 20 50 67 48 64 72 31  e1 *)p;.  PgHdr1
90a0: 20 2a 70 50 61 67 65 20 3d 20 28 50 67 48 64 72   *pPage = (PgHdr
90b0: 31 20 2a 29 70 50 67 3b 0a 20 20 50 47 72 6f 75  1 *)pPg;.  PGrou
90c0: 70 20 2a 70 47 72 6f 75 70 20 3d 20 70 43 61 63  p *pGroup = pCac
90d0: 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20 0a 20 20  he->pGroup;. .  
90e0: 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70  assert( pPage->p
90f0: 43 61 63 68 65 3d 3d 70 43 61 63 68 65 20 29 3b  Cache==pCache );
9100: 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d  .  pcache1EnterM
9110: 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 0a 20  utex(pGroup);.. 
9120: 20 2f 2a 20 49 74 20 69 73 20 61 6e 20 65 72 72   /* It is an err
9130: 6f 72 20 74 6f 20 63 61 6c 6c 20 74 68 69 73 20  or to call this 
9140: 66 75 6e 63 74 69 6f 6e 20 69 66 20 74 68 65 20  function if the 
9150: 70 61 67 65 20 69 73 20 61 6c 72 65 61 64 79 20  page is already 
9160: 0a 20 20 2a 2a 20 70 61 72 74 20 6f 66 20 74 68  .  ** part of th
9170: 65 20 50 47 72 6f 75 70 20 4c 52 55 20 6c 69 73  e PGroup LRU lis
9180: 74 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74  t..  */.  assert
9190: 28 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78  ( pPage->pLruNex
91a0: 74 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74  t==0 );.  assert
91b0: 28 20 50 41 47 45 5f 49 53 5f 50 49 4e 4e 45 44  ( PAGE_IS_PINNED
91c0: 28 70 50 61 67 65 29 20 29 3b 0a 0a 20 20 69 66  (pPage) );..  if
91d0: 28 20 72 65 75 73 65 55 6e 6c 69 6b 65 6c 79 20  ( reuseUnlikely 
91e0: 7c 7c 20 70 47 72 6f 75 70 2d 3e 6e 50 75 72 67  || pGroup->nPurg
91f0: 65 61 62 6c 65 3e 70 47 72 6f 75 70 2d 3e 6e 4d  eable>pGroup->nM
9200: 61 78 50 61 67 65 20 29 7b 0a 20 20 20 20 70 63  axPage ){.    pc
9210: 61 63 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48  ache1RemoveFromH
9220: 61 73 68 28 70 50 61 67 65 2c 20 31 29 3b 0a 20  ash(pPage, 1);. 
9230: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 41   }else{.    /* A
9240: 64 64 20 74 68 65 20 70 61 67 65 20 74 6f 20 74  dd the page to t
9250: 68 65 20 50 47 72 6f 75 70 20 4c 52 55 20 6c 69  he PGroup LRU li
9260: 73 74 2e 20 2a 2f 0a 20 20 20 20 50 67 48 64 72  st. */.    PgHdr
9270: 31 20 2a 2a 70 70 46 69 72 73 74 20 3d 20 26 70  1 **ppFirst = &p
9280: 47 72 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72 75 4e  Group->lru.pLruN
9290: 65 78 74 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e  ext;.    pPage->
92a0: 70 4c 72 75 50 72 65 76 20 3d 20 26 70 47 72 6f  pLruPrev = &pGro
92b0: 75 70 2d 3e 6c 72 75 3b 0a 20 20 20 20 28 70 50  up->lru;.    (pP
92c0: 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74 20 3d 20  age->pLruNext = 
92d0: 2a 70 70 46 69 72 73 74 29 2d 3e 70 4c 72 75 50  *ppFirst)->pLruP
92e0: 72 65 76 20 3d 20 70 50 61 67 65 3b 0a 20 20 20  rev = pPage;.   
92f0: 20 2a 70 70 46 69 72 73 74 20 3d 20 70 50 61 67   *ppFirst = pPag
9300: 65 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 6e  e;.    pCache->n
9310: 52 65 63 79 63 6c 61 62 6c 65 2b 2b 3b 0a 20 20  Recyclable++;.  
9320: 7d 0a 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76  }..  pcache1Leav
9330: 65 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70  eMutex(pCache->p
9340: 47 72 6f 75 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  Group);.}../*.**
9350: 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20   Implementation 
9360: 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70  of the sqlite3_p
9370: 63 61 63 68 65 2e 78 52 65 6b 65 79 20 6d 65 74  cache.xRekey met
9380: 68 6f 64 2e 20 0a 2a 2f 0a 73 74 61 74 69 63 20  hod. .*/.static 
9390: 76 6f 69 64 20 70 63 61 63 68 65 31 52 65 6b 65  void pcache1Reke
93a0: 79 28 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 61  y(.  sqlite3_pca
93b0: 63 68 65 20 2a 70 2c 0a 20 20 73 71 6c 69 74 65  che *p,.  sqlite
93c0: 33 5f 70 63 61 63 68 65 5f 70 61 67 65 20 2a 70  3_pcache_page *p
93d0: 50 67 2c 0a 20 20 75 6e 73 69 67 6e 65 64 20 69  Pg,.  unsigned i
93e0: 6e 74 20 69 4f 6c 64 2c 0a 20 20 75 6e 73 69 67  nt iOld,.  unsig
93f0: 6e 65 64 20 69 6e 74 20 69 4e 65 77 0a 29 7b 0a  ned int iNew.){.
9400: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68    PCache1 *pCach
9410: 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70  e = (PCache1 *)p
9420: 3b 0a 20 20 50 67 48 64 72 31 20 2a 70 50 61 67  ;.  PgHdr1 *pPag
9430: 65 20 3d 20 28 50 67 48 64 72 31 20 2a 29 70 50  e = (PgHdr1 *)pP
9440: 67 3b 0a 20 20 50 67 48 64 72 31 20 2a 2a 70 70  g;.  PgHdr1 **pp
9450: 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74  ;.  unsigned int
9460: 20 68 3b 20 0a 20 20 61 73 73 65 72 74 28 20 70   h; .  assert( p
9470: 50 61 67 65 2d 3e 69 4b 65 79 3d 3d 69 4f 6c 64  Page->iKey==iOld
9480: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50   );.  assert( pP
9490: 61 67 65 2d 3e 70 43 61 63 68 65 3d 3d 70 43 61  age->pCache==pCa
94a0: 63 68 65 20 29 3b 0a 0a 20 20 70 63 61 63 68 65  che );..  pcache
94b0: 31 45 6e 74 65 72 4d 75 74 65 78 28 70 43 61 63  1EnterMutex(pCac
94c0: 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 0a 20 20  he->pGroup);..  
94d0: 68 20 3d 20 69 4f 6c 64 25 70 43 61 63 68 65 2d  h = iOld%pCache-
94e0: 3e 6e 48 61 73 68 3b 0a 20 20 70 70 20 3d 20 26  >nHash;.  pp = &
94f0: 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68  pCache->apHash[h
9500: 5d 3b 0a 20 20 77 68 69 6c 65 28 20 28 2a 70 70  ];.  while( (*pp
9510: 29 21 3d 70 50 61 67 65 20 29 7b 0a 20 20 20 20  )!=pPage ){.    
9520: 70 70 20 3d 20 26 28 2a 70 70 29 2d 3e 70 4e 65  pp = &(*pp)->pNe
9530: 78 74 3b 0a 20 20 7d 0a 20 20 2a 70 70 20 3d 20  xt;.  }.  *pp = 
9540: 70 50 61 67 65 2d 3e 70 4e 65 78 74 3b 0a 0a 20  pPage->pNext;.. 
9550: 20 68 20 3d 20 69 4e 65 77 25 70 43 61 63 68 65   h = iNew%pCache
9560: 2d 3e 6e 48 61 73 68 3b 0a 20 20 70 50 61 67 65  ->nHash;.  pPage
9570: 2d 3e 69 4b 65 79 20 3d 20 69 4e 65 77 3b 0a 20  ->iKey = iNew;. 
9580: 20 70 50 61 67 65 2d 3e 70 4e 65 78 74 20 3d 20   pPage->pNext = 
9590: 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68  pCache->apHash[h
95a0: 5d 3b 0a 20 20 70 43 61 63 68 65 2d 3e 61 70 48  ];.  pCache->apH
95b0: 61 73 68 5b 68 5d 20 3d 20 70 50 61 67 65 3b 0a  ash[h] = pPage;.
95c0: 20 20 69 66 28 20 69 4e 65 77 3e 70 43 61 63 68    if( iNew>pCach
95d0: 65 2d 3e 69 4d 61 78 4b 65 79 20 29 7b 0a 20 20  e->iMaxKey ){.  
95e0: 20 20 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65    pCache->iMaxKe
95f0: 79 20 3d 20 69 4e 65 77 3b 0a 20 20 7d 0a 0a 20  y = iNew;.  }.. 
9600: 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74   pcache1LeaveMut
9610: 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75  ex(pCache->pGrou
9620: 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70  p);.}../*.** Imp
9630: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74  lementation of t
9640: 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68  he sqlite3_pcach
9650: 65 2e 78 54 72 75 6e 63 61 74 65 20 6d 65 74 68  e.xTruncate meth
9660: 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 44 69 73 63 61  od. .**.** Disca
9670: 72 64 20 61 6c 6c 20 75 6e 70 69 6e 6e 65 64 20  rd all unpinned 
9680: 70 61 67 65 73 20 69 6e 20 74 68 65 20 63 61 63  pages in the cac
9690: 68 65 20 77 69 74 68 20 61 20 70 61 67 65 20 6e  he with a page n
96a0: 75 6d 62 65 72 20 65 71 75 61 6c 20 74 6f 0a 2a  umber equal to.*
96b0: 2a 20 6f 72 20 67 72 65 61 74 65 72 20 74 68 61  * or greater tha
96c0: 6e 20 70 61 72 61 6d 65 74 65 72 20 69 4c 69 6d  n parameter iLim
96d0: 69 74 2e 20 41 6e 79 20 70 69 6e 6e 65 64 20 70  it. Any pinned p
96e0: 61 67 65 73 20 77 69 74 68 20 61 20 70 61 67 65  ages with a page
96f0: 20 6e 75 6d 62 65 72 0a 2a 2a 20 65 71 75 61 6c   number.** equal
9700: 20 74 6f 20 6f 72 20 67 72 65 61 74 65 72 20 74   to or greater t
9710: 68 61 6e 20 69 4c 69 6d 69 74 20 61 72 65 20 69  han iLimit are i
9720: 6d 70 6c 69 63 69 74 6c 79 20 75 6e 70 69 6e 6e  mplicitly unpinn
9730: 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  ed..*/.static vo
9740: 69 64 20 70 63 61 63 68 65 31 54 72 75 6e 63 61  id pcache1Trunca
9750: 74 65 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68  te(sqlite3_pcach
9760: 65 20 2a 70 2c 20 75 6e 73 69 67 6e 65 64 20 69  e *p, unsigned i
9770: 6e 74 20 69 4c 69 6d 69 74 29 7b 0a 20 20 50 43  nt iLimit){.  PC
9780: 61 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20  ache1 *pCache = 
9790: 28 50 43 61 63 68 65 31 20 2a 29 70 3b 0a 20 20  (PCache1 *)p;.  
97a0: 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65  pcache1EnterMute
97b0: 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70  x(pCache->pGroup
97c0: 29 3b 0a 20 20 69 66 28 20 69 4c 69 6d 69 74 3c  );.  if( iLimit<
97d0: 3d 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79  =pCache->iMaxKey
97e0: 20 29 7b 0a 20 20 20 20 70 63 61 63 68 65 31 54   ){.    pcache1T
97f0: 72 75 6e 63 61 74 65 55 6e 73 61 66 65 28 70 43  runcateUnsafe(pC
9800: 61 63 68 65 2c 20 69 4c 69 6d 69 74 29 3b 0a 20  ache, iLimit);. 
9810: 20 20 20 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b     pCache->iMaxK
9820: 65 79 20 3d 20 69 4c 69 6d 69 74 2d 31 3b 0a 20  ey = iLimit-1;. 
9830: 20 7d 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76   }.  pcache1Leav
9840: 65 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70  eMutex(pCache->p
9850: 47 72 6f 75 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  Group);.}../*.**
9860: 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20   Implementation 
9870: 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70  of the sqlite3_p
9880: 63 61 63 68 65 2e 78 44 65 73 74 72 6f 79 20 6d  cache.xDestroy m
9890: 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 44 65  ethod. .**.** De
98a0: 73 74 72 6f 79 20 61 20 63 61 63 68 65 20 61 6c  stroy a cache al
98b0: 6c 6f 63 61 74 65 64 20 75 73 69 6e 67 20 70 63  located using pc
98c0: 61 63 68 65 31 43 72 65 61 74 65 28 29 2e 0a 2a  ache1Create()..*
98d0: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63  /.static void pc
98e0: 61 63 68 65 31 44 65 73 74 72 6f 79 28 73 71 6c  ache1Destroy(sql
98f0: 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 29 7b  ite3_pcache *p){
9900: 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63  .  PCache1 *pCac
9910: 68 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29  he = (PCache1 *)
9920: 70 3b 0a 20 20 50 47 72 6f 75 70 20 2a 70 47 72  p;.  PGroup *pGr
9930: 6f 75 70 20 3d 20 70 43 61 63 68 65 2d 3e 70 47  oup = pCache->pG
9940: 72 6f 75 70 3b 0a 20 20 61 73 73 65 72 74 28 20  roup;.  assert( 
9950: 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62  pCache->bPurgeab
9960: 6c 65 20 7c 7c 20 28 70 43 61 63 68 65 2d 3e 6e  le || (pCache->n
9970: 4d 61 78 3d 3d 30 20 26 26 20 70 43 61 63 68 65  Max==0 && pCache
9980: 2d 3e 6e 4d 69 6e 3d 3d 30 29 20 29 3b 0a 20 20  ->nMin==0) );.  
9990: 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65  pcache1EnterMute
99a0: 78 28 70 47 72 6f 75 70 29 3b 0a 20 20 69 66 28  x(pGroup);.  if(
99b0: 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 20 29   pCache->nPage )
99c0: 20 70 63 61 63 68 65 31 54 72 75 6e 63 61 74 65   pcache1Truncate
99d0: 55 6e 73 61 66 65 28 70 43 61 63 68 65 2c 20 30  Unsafe(pCache, 0
99e0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 47 72  );.  assert( pGr
99f0: 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 3e 3d  oup->nMaxPage >=
9a00: 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 20 29 3b   pCache->nMax );
9a10: 0a 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50  .  pGroup->nMaxP
9a20: 61 67 65 20 2d 3d 20 70 43 61 63 68 65 2d 3e 6e  age -= pCache->n
9a30: 4d 61 78 3b 0a 20 20 61 73 73 65 72 74 28 20 70  Max;.  assert( p
9a40: 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 20  Group->nMinPage 
9a50: 3e 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 20  >= pCache->nMin 
9a60: 29 3b 0a 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 69  );.  pGroup->nMi
9a70: 6e 50 61 67 65 20 2d 3d 20 70 43 61 63 68 65 2d  nPage -= pCache-
9a80: 3e 6e 4d 69 6e 3b 0a 20 20 70 47 72 6f 75 70 2d  >nMin;.  pGroup-
9a90: 3e 6d 78 50 69 6e 6e 65 64 20 3d 20 70 47 72 6f  >mxPinned = pGro
9aa0: 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 2b 20 31  up->nMaxPage + 1
9ab0: 30 20 2d 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e  0 - pGroup->nMin
9ac0: 50 61 67 65 3b 0a 20 20 70 63 61 63 68 65 31 45  Page;.  pcache1E
9ad0: 6e 66 6f 72 63 65 4d 61 78 50 61 67 65 28 70 43  nforceMaxPage(pC
9ae0: 61 63 68 65 29 3b 0a 20 20 70 63 61 63 68 65 31  ache);.  pcache1
9af0: 4c 65 61 76 65 4d 75 74 65 78 28 70 47 72 6f 75  LeaveMutex(pGrou
9b00: 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66 72  p);.  sqlite3_fr
9b10: 65 65 28 70 43 61 63 68 65 2d 3e 70 42 75 6c 6b  ee(pCache->pBulk
9b20: 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65  );.  sqlite3_fre
9b30: 65 28 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68  e(pCache->apHash
9b40: 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65  );.  sqlite3_fre
9b50: 65 28 70 43 61 63 68 65 29 3b 0a 7d 0a 0a 2f 2a  e(pCache);.}../*
9b60: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f  .** This functio
9b70: 6e 20 69 73 20 63 61 6c 6c 65 64 20 64 75 72 69  n is called duri
9b80: 6e 67 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f  ng initializatio
9b90: 6e 20 28 73 71 6c 69 74 65 33 5f 69 6e 69 74 69  n (sqlite3_initi
9ba0: 61 6c 69 7a 65 28 29 29 20 74 6f 0a 2a 2a 20 69  alize()) to.** i
9bb0: 6e 73 74 61 6c 6c 20 74 68 65 20 64 65 66 61 75  nstall the defau
9bc0: 6c 74 20 70 6c 75 67 67 61 62 6c 65 20 63 61 63  lt pluggable cac
9bd0: 68 65 20 6d 6f 64 75 6c 65 2c 20 61 73 73 75 6d  he module, assum
9be0: 69 6e 67 20 74 68 65 20 75 73 65 72 20 68 61 73  ing the user has
9bf0: 20 6e 6f 74 0a 2a 2a 20 61 6c 72 65 61 64 79 20   not.** already 
9c00: 70 72 6f 76 69 64 65 64 20 61 6e 20 61 6c 74 65  provided an alte
9c10: 72 6e 61 74 69 76 65 2e 0a 2a 2f 0a 76 6f 69 64  rnative..*/.void
9c20: 20 73 71 6c 69 74 65 33 50 43 61 63 68 65 53 65   sqlite3PCacheSe
9c30: 74 44 65 66 61 75 6c 74 28 76 6f 69 64 29 7b 0a  tDefault(void){.
9c40: 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 73    static const s
9c50: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 6d 65  qlite3_pcache_me
9c60: 74 68 6f 64 73 32 20 64 65 66 61 75 6c 74 4d 65  thods2 defaultMe
9c70: 74 68 6f 64 73 20 3d 20 7b 0a 20 20 20 20 31 2c  thods = {.    1,
9c80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
9c90: 20 20 20 20 20 20 20 2f 2a 20 69 56 65 72 73 69         /* iVersi
9ca0: 6f 6e 20 2a 2f 0a 20 20 20 20 30 2c 20 20 20 20  on */.    0,    
9cb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
9cc0: 20 20 20 2f 2a 20 70 41 72 67 20 2a 2f 0a 20 20     /* pArg */.  
9cd0: 20 20 70 63 61 63 68 65 31 49 6e 69 74 2c 20 20    pcache1Init,  
9ce0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 49             /* xI
9cf0: 6e 69 74 20 2a 2f 0a 20 20 20 20 70 63 61 63 68  nit */.    pcach
9d00: 65 31 53 68 75 74 64 6f 77 6e 2c 20 20 20 20 20  e1Shutdown,     
9d10: 20 20 20 20 2f 2a 20 78 53 68 75 74 64 6f 77 6e      /* xShutdown
9d20: 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 43   */.    pcache1C
9d30: 72 65 61 74 65 2c 20 20 20 20 20 20 20 20 20 20  reate,          
9d40: 20 2f 2a 20 78 43 72 65 61 74 65 20 2a 2f 0a 20   /* xCreate */. 
9d50: 20 20 20 70 63 61 63 68 65 31 43 61 63 68 65 73     pcache1Caches
9d60: 69 7a 65 2c 20 20 20 20 20 20 20 20 2f 2a 20 78  ize,        /* x
9d70: 43 61 63 68 65 73 69 7a 65 20 2a 2f 0a 20 20 20  Cachesize */.   
9d80: 20 70 63 61 63 68 65 31 50 61 67 65 63 6f 75 6e   pcache1Pagecoun
9d90: 74 2c 20 20 20 20 20 20 20 20 2f 2a 20 78 50 61  t,        /* xPa
9da0: 67 65 63 6f 75 6e 74 20 2a 2f 0a 20 20 20 20 70  gecount */.    p
9db0: 63 61 63 68 65 31 46 65 74 63 68 2c 20 20 20 20  cache1Fetch,    
9dc0: 20 20 20 20 20 20 20 20 2f 2a 20 78 46 65 74 63          /* xFetc
9dd0: 68 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31  h */.    pcache1
9de0: 55 6e 70 69 6e 2c 20 20 20 20 20 20 20 20 20 20  Unpin,          
9df0: 20 20 2f 2a 20 78 55 6e 70 69 6e 20 2a 2f 0a 20    /* xUnpin */. 
9e00: 20 20 20 70 63 61 63 68 65 31 52 65 6b 65 79 2c     pcache1Rekey,
9e10: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78              /* x
9e20: 52 65 6b 65 79 20 2a 2f 0a 20 20 20 20 70 63 61  Rekey */.    pca
9e30: 63 68 65 31 54 72 75 6e 63 61 74 65 2c 20 20 20  che1Truncate,   
9e40: 20 20 20 20 20 20 2f 2a 20 78 54 72 75 6e 63 61        /* xTrunca
9e50: 74 65 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65  te */.    pcache
9e60: 31 44 65 73 74 72 6f 79 2c 20 20 20 20 20 20 20  1Destroy,       
9e70: 20 20 20 2f 2a 20 78 44 65 73 74 72 6f 79 20 2a     /* xDestroy *
9e80: 2f 0a 20 20 20 20 70 63 61 63 68 65 31 53 68 72  /.    pcache1Shr
9e90: 69 6e 6b 20 20 20 20 20 20 20 20 20 20 20 20 2f  ink            /
9ea0: 2a 20 78 53 68 72 69 6e 6b 20 2a 2f 0a 20 20 7d  * xShrink */.  }
9eb0: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66  ;.  sqlite3_conf
9ec0: 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47  ig(SQLITE_CONFIG
9ed0: 5f 50 43 41 43 48 45 32 2c 20 26 64 65 66 61 75  _PCACHE2, &defau
9ee0: 6c 74 4d 65 74 68 6f 64 73 29 3b 0a 7d 0a 0a 2f  ltMethods);.}../
9ef0: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
9f00: 73 69 7a 65 20 6f 66 20 74 68 65 20 68 65 61 64  size of the head
9f10: 65 72 20 6f 6e 20 65 61 63 68 20 70 61 67 65 20  er on each page 
9f20: 6f 66 20 74 68 69 73 20 50 43 41 43 48 45 20 69  of this PCACHE i
9f30: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 0a 2a  mplementation..*
9f40: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 48 65 61  /.int sqlite3Hea
9f50: 64 65 72 53 69 7a 65 50 63 61 63 68 65 31 28 76  derSizePcache1(v
9f60: 6f 69 64 29 7b 20 72 65 74 75 72 6e 20 52 4f 55  oid){ return ROU
9f70: 4e 44 38 28 73 69 7a 65 6f 66 28 50 67 48 64 72  ND8(sizeof(PgHdr
9f80: 31 29 29 3b 20 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  1)); }../*.** Re
9f90: 74 75 72 6e 20 74 68 65 20 67 6c 6f 62 61 6c 20  turn the global 
9fa0: 6d 75 74 65 78 20 75 73 65 64 20 62 79 20 74 68  mutex used by th
9fb0: 69 73 20 50 43 41 43 48 45 20 69 6d 70 6c 65 6d  is PCACHE implem
9fc0: 65 6e 74 61 74 69 6f 6e 2e 20 20 54 68 65 0a 2a  entation.  The.*
9fd0: 2a 20 73 71 6c 69 74 65 33 5f 73 74 61 74 75 73  * sqlite3_status
9fe0: 28 29 20 72 6f 75 74 69 6e 65 20 6e 65 65 64 73  () routine needs
9ff0: 20 61 63 63 65 73 73 20 74 6f 20 74 68 69 73 20   access to this 
a000: 6d 75 74 65 78 2e 0a 2a 2f 0a 73 71 6c 69 74 65  mutex..*/.sqlite
a010: 33 5f 6d 75 74 65 78 20 2a 73 71 6c 69 74 65 33  3_mutex *sqlite3
a020: 50 63 61 63 68 65 31 4d 75 74 65 78 28 76 6f 69  Pcache1Mutex(voi
a030: 64 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 63 61  d){.  return pca
a040: 63 68 65 31 2e 6d 75 74 65 78 3b 0a 7d 0a 0a 23  che1.mutex;.}..#
a050: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41  ifdef SQLITE_ENA
a060: 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47  BLE_MEMORY_MANAG
a070: 45 4d 45 4e 54 0a 2f 2a 0a 2a 2a 20 54 68 69 73  EMENT./*.** This
a080: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c   function is cal
a090: 6c 65 64 20 74 6f 20 66 72 65 65 20 73 75 70 65  led to free supe
a0a0: 72 66 6c 75 6f 75 73 20 64 79 6e 61 6d 69 63 61  rfluous dynamica
a0b0: 6c 6c 79 20 61 6c 6c 6f 63 61 74 65 64 20 6d 65  lly allocated me
a0c0: 6d 6f 72 79 0a 2a 2a 20 68 65 6c 64 20 62 79 20  mory.** held by 
a0d0: 74 68 65 20 70 61 67 65 72 20 73 79 73 74 65 6d  the pager system
a0e0: 2e 20 4d 65 6d 6f 72 79 20 69 6e 20 75 73 65 20  . Memory in use 
a0f0: 62 79 20 61 6e 79 20 53 51 4c 69 74 65 20 70 61  by any SQLite pa
a100: 67 65 72 20 61 6c 6c 6f 63 61 74 65 64 0a 2a 2a  ger allocated.**
a110: 20 62 79 20 74 68 65 20 63 75 72 72 65 6e 74 20   by the current 
a120: 74 68 72 65 61 64 20 6d 61 79 20 62 65 20 73 71  thread may be sq
a130: 6c 69 74 65 33 5f 66 72 65 65 28 29 65 64 2e 0a  lite3_free()ed..
a140: 2a 2a 0a 2a 2a 20 6e 52 65 71 20 69 73 20 74 68  **.** nReq is th
a150: 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65  e number of byte
a160: 73 20 6f 66 20 6d 65 6d 6f 72 79 20 72 65 71 75  s of memory requ
a170: 69 72 65 64 2e 20 4f 6e 63 65 20 74 68 69 73 20  ired. Once this 
a180: 6d 75 63 68 20 68 61 73 0a 2a 2a 20 62 65 65 6e  much has.** been
a190: 20 72 65 6c 65 61 73 65 64 2c 20 74 68 65 20 66   released, the f
a1a0: 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 2e  unction returns.
a1b0: 20 54 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75   The return valu
a1c0: 65 20 69 73 20 74 68 65 20 74 6f 74 61 6c 20 6e  e is the total n
a1d0: 75 6d 62 65 72 20 0a 2a 2a 20 6f 66 20 62 79 74  umber .** of byt
a1e0: 65 73 20 6f 66 20 6d 65 6d 6f 72 79 20 72 65 6c  es of memory rel
a1f0: 65 61 73 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71  eased..*/.int sq
a200: 6c 69 74 65 33 50 63 61 63 68 65 52 65 6c 65 61  lite3PcacheRelea
a210: 73 65 4d 65 6d 6f 72 79 28 69 6e 74 20 6e 52 65  seMemory(int nRe
a220: 71 29 7b 0a 20 20 69 6e 74 20 6e 46 72 65 65 20  q){.  int nFree 
a230: 3d 20 30 3b 0a 20 20 61 73 73 65 72 74 28 20 73  = 0;.  assert( s
a240: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6e 6f 74  qlite3_mutex_not
a250: 68 65 6c 64 28 70 63 61 63 68 65 31 2e 67 72 70  held(pcache1.grp
a260: 2e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73  .mutex) );.  ass
a270: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74  ert( sqlite3_mut
a280: 65 78 5f 6e 6f 74 68 65 6c 64 28 70 63 61 63 68  ex_notheld(pcach
a290: 65 31 2e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69  e1.mutex) );.  i
a2a0: 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c  f( sqlite3Global
a2b0: 43 6f 6e 66 69 67 2e 70 50 61 67 65 3d 3d 30 20  Config.pPage==0 
a2c0: 29 7b 0a 20 20 20 20 50 67 48 64 72 31 20 2a 70  ){.    PgHdr1 *p
a2d0: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e 74  ;.    pcache1Ent
a2e0: 65 72 4d 75 74 65 78 28 26 70 63 61 63 68 65 31  erMutex(&pcache1
a2f0: 2e 67 72 70 29 3b 0a 20 20 20 20 77 68 69 6c 65  .grp);.    while
a300: 28 20 28 6e 52 65 71 3c 30 20 7c 7c 20 6e 46 72  ( (nReq<0 || nFr
a310: 65 65 3c 6e 52 65 71 29 0a 20 20 20 20 20 20 20  ee<nReq).       
a320: 26 26 20 20 28 70 3d 70 63 61 63 68 65 31 2e 67  &&  (p=pcache1.g
a330: 72 70 2e 6c 72 75 2e 70 4c 72 75 50 72 65 76 29  rp.lru.pLruPrev)
a340: 21 3d 30 0a 20 20 20 20 20 20 20 26 26 20 20 70  !=0.       &&  p
a350: 2d 3e 69 73 41 6e 63 68 6f 72 3d 3d 30 0a 20 20  ->isAnchor==0.  
a360: 20 20 29 7b 0a 20 20 20 20 20 20 6e 46 72 65 65    ){.      nFree
a370: 20 2b 3d 20 70 63 61 63 68 65 31 4d 65 6d 53 69   += pcache1MemSi
a380: 7a 65 28 70 2d 3e 70 61 67 65 2e 70 42 75 66 29  ze(p->page.pBuf)
a390: 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ;.#ifdef SQLITE_
a3a0: 50 43 41 43 48 45 5f 53 45 50 41 52 41 54 45 5f  PCACHE_SEPARATE_
a3b0: 48 45 41 44 45 52 0a 20 20 20 20 20 20 6e 46 72  HEADER.      nFr
a3c0: 65 65 20 2b 3d 20 73 71 6c 69 74 65 33 4d 65 6d  ee += sqlite3Mem
a3d0: 53 69 7a 65 28 70 29 3b 0a 23 65 6e 64 69 66 0a  Size(p);.#endif.
a3e0: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 50 41        assert( PA
a3f0: 47 45 5f 49 53 5f 55 4e 50 49 4e 4e 45 44 28 70  GE_IS_UNPINNED(p
a400: 29 20 29 3b 0a 20 20 20 20 20 20 70 63 61 63 68  ) );.      pcach
a410: 65 31 50 69 6e 50 61 67 65 28 70 29 3b 0a 20 20  e1PinPage(p);.  
a420: 20 20 20 20 70 63 61 63 68 65 31 52 65 6d 6f 76      pcache1Remov
a430: 65 46 72 6f 6d 48 61 73 68 28 70 2c 20 31 29 3b  eFromHash(p, 1);
a440: 0a 20 20 20 20 7d 0a 20 20 20 20 70 63 61 63 68  .    }.    pcach
a450: 65 31 4c 65 61 76 65 4d 75 74 65 78 28 26 70 63  e1LeaveMutex(&pc
a460: 61 63 68 65 31 2e 67 72 70 29 3b 0a 20 20 7d 0a  ache1.grp);.  }.
a470: 20 20 72 65 74 75 72 6e 20 6e 46 72 65 65 3b 0a    return nFree;.
a480: 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49  }.#endif /* SQLI
a490: 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59  TE_ENABLE_MEMORY
a4a0: 5f 4d 41 4e 41 47 45 4d 45 4e 54 20 2a 2f 0a 0a  _MANAGEMENT */..
a4b0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45  #ifdef SQLITE_TE
a4c0: 53 54 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75  ST./*.** This fu
a4d0: 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 62  nction is used b
a4e0: 79 20 74 65 73 74 20 70 72 6f 63 65 64 75 72 65  y test procedure
a4f0: 73 20 74 6f 20 69 6e 73 70 65 63 74 20 74 68 65  s to inspect the
a500: 20 69 6e 74 65 72 6e 61 6c 20 73 74 61 74 65 0a   internal state.
a510: 2a 2a 20 6f 66 20 74 68 65 20 67 6c 6f 62 61 6c  ** of the global
a520: 20 63 61 63 68 65 2e 0a 2a 2f 0a 76 6f 69 64 20   cache..*/.void 
a530: 73 71 6c 69 74 65 33 50 63 61 63 68 65 53 74 61  sqlite3PcacheSta
a540: 74 73 28 0a 20 20 69 6e 74 20 2a 70 6e 43 75 72  ts(.  int *pnCur
a550: 72 65 6e 74 2c 20 20 20 20 20 20 2f 2a 20 4f 55  rent,      /* OU
a560: 54 3a 20 54 6f 74 61 6c 20 6e 75 6d 62 65 72 20  T: Total number 
a570: 6f 66 20 70 61 67 65 73 20 63 61 63 68 65 64 20  of pages cached 
a580: 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 4d 61 78 2c  */.  int *pnMax,
a590: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54            /* OUT
a5a0: 3a 20 47 6c 6f 62 61 6c 20 6d 61 78 69 6d 75 6d  : Global maximum
a5b0: 20 63 61 63 68 65 20 73 69 7a 65 20 2a 2f 0a 20   cache size */. 
a5c0: 20 69 6e 74 20 2a 70 6e 4d 69 6e 2c 20 20 20 20   int *pnMin,    
a5d0: 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 53 75        /* OUT: Su
a5e0: 6d 20 6f 66 20 50 43 61 63 68 65 31 2e 6e 4d 69  m of PCache1.nMi
a5f0: 6e 20 66 6f 72 20 70 75 72 67 65 61 62 6c 65 20  n for purgeable 
a600: 63 61 63 68 65 73 20 2a 2f 0a 20 20 69 6e 74 20  caches */.  int 
a610: 2a 70 6e 52 65 63 79 63 6c 61 62 6c 65 20 20 20  *pnRecyclable   
a620: 20 2f 2a 20 4f 55 54 3a 20 54 6f 74 61 6c 20 6e   /* OUT: Total n
a630: 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 61  umber of pages a
a640: 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 72 65 63  vailable for rec
a650: 79 63 6c 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 50  ycling */.){.  P
a660: 67 48 64 72 31 20 2a 70 3b 0a 20 20 69 6e 74 20  gHdr1 *p;.  int 
a670: 6e 52 65 63 79 63 6c 61 62 6c 65 20 3d 20 30 3b  nRecyclable = 0;
a680: 0a 20 20 66 6f 72 28 70 3d 70 63 61 63 68 65 31  .  for(p=pcache1
a690: 2e 67 72 70 2e 6c 72 75 2e 70 4c 72 75 4e 65 78  .grp.lru.pLruNex
a6a0: 74 3b 20 70 20 26 26 20 21 70 2d 3e 69 73 41 6e  t; p && !p->isAn
a6b0: 63 68 6f 72 3b 20 70 3d 70 2d 3e 70 4c 72 75 4e  chor; p=p->pLruN
a6c0: 65 78 74 29 7b 0a 20 20 20 20 61 73 73 65 72 74  ext){.    assert
a6d0: 28 20 50 41 47 45 5f 49 53 5f 55 4e 50 49 4e 4e  ( PAGE_IS_UNPINN
a6e0: 45 44 28 70 29 20 29 3b 0a 20 20 20 20 6e 52 65  ED(p) );.    nRe
a6f0: 63 79 63 6c 61 62 6c 65 2b 2b 3b 0a 20 20 7d 0a  cyclable++;.  }.
a700: 20 20 2a 70 6e 43 75 72 72 65 6e 74 20 3d 20 70    *pnCurrent = p
a710: 63 61 63 68 65 31 2e 67 72 70 2e 6e 50 75 72 67  cache1.grp.nPurg
a720: 65 61 62 6c 65 3b 0a 20 20 2a 70 6e 4d 61 78 20  eable;.  *pnMax 
a730: 3d 20 28 69 6e 74 29 70 63 61 63 68 65 31 2e 67  = (int)pcache1.g
a740: 72 70 2e 6e 4d 61 78 50 61 67 65 3b 0a 20 20 2a  rp.nMaxPage;.  *
a750: 70 6e 4d 69 6e 20 3d 20 28 69 6e 74 29 70 63 61  pnMin = (int)pca
a760: 63 68 65 31 2e 67 72 70 2e 6e 4d 69 6e 50 61 67  che1.grp.nMinPag
a770: 65 3b 0a 20 20 2a 70 6e 52 65 63 79 63 6c 61 62  e;.  *pnRecyclab
a780: 6c 65 20 3d 20 6e 52 65 63 79 63 6c 61 62 6c 65  le = nRecyclable
a790: 3b 0a 7d 0a 23 65 6e 64 69 66 0a                 ;.}.#endif.