/ Hex Artifact Content
Login

Artifact 1195a21fe28e223e024f900b2011e80df53793f0356a24caace4188b098540dc:


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 50 69 6e 6e 65 64 3b 20 20 20 20 20  8 isPinned;     
11c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
11d0: 20 50 61 67 65 20 69 6e 20 75 73 65 2c 20 6e 6f   Page in use, no
11e0: 74 20 6f 6e 20 74 68 65 20 4c 52 55 20 6c 69 73  t on the LRU lis
11f0: 74 20 2a 2f 0a 20 20 75 38 20 69 73 42 75 6c 6b  t */.  u8 isBulk
1200: 4c 6f 63 61 6c 3b 20 20 20 20 20 20 20 20 20 20  Local;          
1210: 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 70 61        /* This pa
1220: 67 65 20 66 72 6f 6d 20 62 75 6c 6b 20 6c 6f 63  ge from bulk loc
1230: 61 6c 20 73 74 6f 72 61 67 65 20 2a 2f 0a 20 20  al storage */.  
1240: 75 38 20 69 73 41 6e 63 68 6f 72 3b 20 20 20 20  u8 isAnchor;    
1250: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1260: 2a 20 54 68 69 73 20 69 73 20 74 68 65 20 50 47  * This is the PG
1270: 72 6f 75 70 2e 6c 72 75 20 65 6c 65 6d 65 6e 74  roup.lru element
1280: 20 2a 2f 0a 20 20 50 67 48 64 72 31 20 2a 70 4e   */.  PgHdr1 *pN
1290: 65 78 74 3b 20 20 20 20 20 20 20 20 20 20 20 20  ext;            
12a0: 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 69 6e 20       /* Next in 
12b0: 68 61 73 68 20 74 61 62 6c 65 20 63 68 61 69 6e  hash table chain
12c0: 20 2a 2f 0a 20 20 50 43 61 63 68 65 31 20 2a 70   */.  PCache1 *p
12d0: 43 61 63 68 65 3b 20 20 20 20 20 20 20 20 20 20  Cache;          
12e0: 20 20 20 20 20 2f 2a 20 43 61 63 68 65 20 74 68       /* Cache th
12f0: 61 74 20 63 75 72 72 65 6e 74 6c 79 20 6f 77 6e  at currently own
1300: 73 20 74 68 69 73 20 70 61 67 65 20 2a 2f 0a 20  s this page */. 
1310: 20 50 67 48 64 72 31 20 2a 70 4c 72 75 4e 65 78   PgHdr1 *pLruNex
1320: 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  t;              
1330: 2f 2a 20 4e 65 78 74 20 69 6e 20 4c 52 55 20 6c  /* Next in LRU l
1340: 69 73 74 20 6f 66 20 75 6e 70 69 6e 6e 65 64 20  ist of unpinned 
1350: 70 61 67 65 73 20 2a 2f 0a 20 20 50 67 48 64 72  pages */.  PgHdr
1360: 31 20 2a 70 4c 72 75 50 72 65 76 3b 20 20 20 20  1 *pLruPrev;    
1370: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 72 65            /* Pre
1380: 76 69 6f 75 73 20 69 6e 20 4c 52 55 20 6c 69 73  vious in LRU lis
1390: 74 20 6f 66 20 75 6e 70 69 6e 6e 65 64 20 70 61  t of unpinned pa
13a0: 67 65 73 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 45 61  ges */.};../* Ea
13b0: 63 68 20 70 61 67 65 20 63 61 63 68 65 20 28 6f  ch page cache (o
13c0: 72 20 50 43 61 63 68 65 29 20 62 65 6c 6f 6e 67  r PCache) belong
13d0: 73 20 74 6f 20 61 20 50 47 72 6f 75 70 2e 20 20  s to a PGroup.  
13e0: 41 20 50 47 72 6f 75 70 20 69 73 20 61 20 73 65  A PGroup is a se
13f0: 74 20 0a 2a 2a 20 6f 66 20 6f 6e 65 20 6f 72 20  t .** of one or 
1400: 6d 6f 72 65 20 50 43 61 63 68 65 73 20 74 68 61  more PCaches tha
1410: 74 20 61 72 65 20 61 62 6c 65 20 74 6f 20 72 65  t are able to re
1420: 63 79 63 6c 65 20 65 61 63 68 20 6f 74 68 65 72  cycle each other
1430: 27 73 20 75 6e 70 69 6e 6e 65 64 0a 2a 2a 20 70  's unpinned.** p
1440: 61 67 65 73 20 77 68 65 6e 20 74 68 65 79 20 61  ages when they a
1450: 72 65 20 75 6e 64 65 72 20 6d 65 6d 6f 72 79 20  re under memory 
1460: 70 72 65 73 73 75 72 65 2e 20 20 41 20 50 47 72  pressure.  A PGr
1470: 6f 75 70 20 69 73 20 61 6e 20 69 6e 73 74 61 6e  oup is an instan
1480: 63 65 20 6f 66 0a 2a 2a 20 74 68 65 20 66 6f 6c  ce of.** the fol
1490: 6c 6f 77 69 6e 67 20 6f 62 6a 65 63 74 2e 0a 2a  lowing object..*
14a0: 2a 0a 2a 2a 20 54 68 69 73 20 70 61 67 65 20 63  *.** This page c
14b0: 61 63 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74  ache implementat
14c0: 69 6f 6e 20 77 6f 72 6b 73 20 69 6e 20 6f 6e 65  ion works in one
14d0: 20 6f 66 20 74 77 6f 20 6d 6f 64 65 73 3a 0a 2a   of two modes:.*
14e0: 2a 0a 2a 2a 20 20 20 28 31 29 20 20 45 76 65 72  *.**   (1)  Ever
14f0: 79 20 50 43 61 63 68 65 20 69 73 20 74 68 65 20  y PCache is the 
1500: 73 6f 6c 65 20 6d 65 6d 62 65 72 20 6f 66 20 69  sole member of i
1510: 74 73 20 6f 77 6e 20 50 47 72 6f 75 70 2e 20 20  ts own PGroup.  
1520: 54 68 65 72 65 20 69 73 0a 2a 2a 20 20 20 20 20  There is.**     
1530: 20 20 20 6f 6e 65 20 50 47 72 6f 75 70 20 70 65     one PGroup pe
1540: 72 20 50 43 61 63 68 65 2e 0a 2a 2a 0a 2a 2a 20  r PCache..**.** 
1550: 20 20 28 32 29 20 20 54 68 65 72 65 20 69 73 20    (2)  There is 
1560: 61 20 73 69 6e 67 6c 65 20 67 6c 6f 62 61 6c 20  a single global 
1570: 50 47 72 6f 75 70 20 74 68 61 74 20 61 6c 6c 20  PGroup that all 
1580: 50 43 61 63 68 65 73 20 61 72 65 20 61 20 6d 65  PCaches are a me
1590: 6d 62 65 72 0a 2a 2a 20 20 20 20 20 20 20 20 6f  mber.**        o
15a0: 66 2e 0a 2a 2a 0a 2a 2a 20 4d 6f 64 65 20 31 20  f..**.** Mode 1 
15b0: 75 73 65 73 20 6d 6f 72 65 20 6d 65 6d 6f 72 79  uses more memory
15c0: 20 28 73 69 6e 63 65 20 50 43 61 63 68 65 20 69   (since PCache i
15d0: 6e 73 74 61 6e 63 65 73 20 61 72 65 20 6e 6f 74  nstances are not
15e0: 20 61 62 6c 65 20 74 6f 20 72 6f 62 0a 2a 2a 20   able to rob.** 
15f0: 75 6e 75 73 65 64 20 70 61 67 65 73 20 66 72 6f  unused pages fro
1600: 6d 20 6f 74 68 65 72 20 50 43 61 63 68 65 73 29  m other PCaches)
1610: 20 62 75 74 20 69 74 20 61 6c 73 6f 20 6f 70 65   but it also ope
1620: 72 61 74 65 73 20 77 69 74 68 6f 75 74 20 61 20  rates without a 
1630: 6d 75 74 65 78 2c 0a 2a 2a 20 61 6e 64 20 69 73  mutex,.** and is
1640: 20 74 68 65 72 65 66 6f 72 65 20 6f 66 74 65 6e   therefore often
1650: 20 66 61 73 74 65 72 2e 20 20 4d 6f 64 65 20 32   faster.  Mode 2
1660: 20 72 65 71 75 69 72 65 73 20 61 20 6d 75 74 65   requires a mute
1670: 78 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 62 65  x in order to be
1680: 0a 2a 2a 20 74 68 72 65 61 64 73 61 66 65 2c 20  .** threadsafe, 
1690: 62 75 74 20 72 65 63 79 63 6c 65 73 20 70 61 67  but recycles pag
16a0: 65 73 20 6d 6f 72 65 20 65 66 66 69 63 69 65 6e  es more efficien
16b0: 74 6c 79 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 6d  tly..**.** For m
16c0: 6f 64 65 20 28 31 29 2c 20 50 47 72 6f 75 70 2e  ode (1), PGroup.
16d0: 6d 75 74 65 78 20 69 73 20 4e 55 4c 4c 2e 20 20  mutex is NULL.  
16e0: 46 6f 72 20 6d 6f 64 65 20 28 32 29 20 74 68 65  For mode (2) the
16f0: 72 65 20 69 73 20 6f 6e 6c 79 20 61 20 73 69 6e  re is only a sin
1700: 67 6c 65 0a 2a 2a 20 50 47 72 6f 75 70 20 77 68  gle.** PGroup wh
1710: 69 63 68 20 69 73 20 74 68 65 20 70 63 61 63 68  ich is the pcach
1720: 65 31 2e 67 72 70 20 67 6c 6f 62 61 6c 20 76 61  e1.grp global va
1730: 72 69 61 62 6c 65 20 61 6e 64 20 69 74 73 20 6d  riable and its m
1740: 75 74 65 78 20 69 73 0a 2a 2a 20 53 51 4c 49 54  utex is.** SQLIT
1750: 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c  E_MUTEX_STATIC_L
1760: 52 55 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 50 47  RU..*/.struct PG
1770: 72 6f 75 70 20 7b 0a 20 20 73 71 6c 69 74 65 33  roup {.  sqlite3
1780: 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 3b 20 20  _mutex *mutex;  
1790: 20 20 20 20 20 20 20 20 2f 2a 20 4d 55 54 45 58          /* MUTEX
17a0: 5f 53 54 41 54 49 43 5f 4c 52 55 20 6f 72 20 4e  _STATIC_LRU or N
17b0: 55 4c 4c 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65  ULL */.  unsigne
17c0: 64 20 69 6e 74 20 6e 4d 61 78 50 61 67 65 3b 20  d int nMaxPage; 
17d0: 20 20 20 20 20 20 20 20 2f 2a 20 53 75 6d 20 6f          /* Sum o
17e0: 66 20 6e 4d 61 78 20 66 6f 72 20 70 75 72 67 65  f nMax for purge
17f0: 61 62 6c 65 20 63 61 63 68 65 73 20 2a 2f 0a 20  able caches */. 
1800: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 4d   unsigned int nM
1810: 69 6e 50 61 67 65 3b 20 20 20 20 20 20 20 20 20  inPage;         
1820: 2f 2a 20 53 75 6d 20 6f 66 20 6e 4d 69 6e 20 66  /* Sum of nMin f
1830: 6f 72 20 70 75 72 67 65 61 62 6c 65 20 63 61 63  or purgeable cac
1840: 68 65 73 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65  hes */.  unsigne
1850: 64 20 69 6e 74 20 6d 78 50 69 6e 6e 65 64 3b 20  d int mxPinned; 
1860: 20 20 20 20 20 20 20 20 2f 2a 20 6e 4d 61 78 70          /* nMaxp
1870: 61 67 65 20 2b 20 31 30 20 2d 20 6e 4d 69 6e 50  age + 10 - nMinP
1880: 61 67 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65  age */.  unsigne
1890: 64 20 69 6e 74 20 6e 43 75 72 72 65 6e 74 50 61  d int nCurrentPa
18a0: 67 65 3b 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65  ge;     /* Numbe
18b0: 72 20 6f 66 20 70 75 72 67 65 61 62 6c 65 20 70  r of purgeable p
18c0: 61 67 65 73 20 61 6c 6c 6f 63 61 74 65 64 20 2a  ages allocated *
18d0: 2f 0a 20 20 50 67 48 64 72 31 20 6c 72 75 3b 20  /.  PgHdr1 lru; 
18e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
18f0: 20 20 20 2f 2a 20 54 68 65 20 62 65 67 69 6e 6e     /* The beginn
1900: 69 6e 67 20 61 6e 64 20 65 6e 64 20 6f 66 20 74  ing and end of t
1910: 68 65 20 4c 52 55 20 6c 69 73 74 20 2a 2f 0a 7d  he LRU list */.}
1920: 3b 0a 0a 2f 2a 20 45 61 63 68 20 70 61 67 65 20  ;../* Each page 
1930: 63 61 63 68 65 20 69 73 20 61 6e 20 69 6e 73 74  cache is an inst
1940: 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c  ance of the foll
1950: 6f 77 69 6e 67 20 6f 62 6a 65 63 74 2e 20 20 45  owing object.  E
1960: 76 65 72 79 0a 2a 2a 20 6f 70 65 6e 20 64 61 74  very.** open dat
1970: 61 62 61 73 65 20 66 69 6c 65 20 28 69 6e 63 6c  abase file (incl
1980: 75 64 69 6e 67 20 65 61 63 68 20 69 6e 2d 6d 65  uding each in-me
1990: 6d 6f 72 79 20 64 61 74 61 62 61 73 65 20 61 6e  mory database an
19a0: 64 20 65 61 63 68 0a 2a 2a 20 74 65 6d 70 6f 72  d each.** tempor
19b0: 61 72 79 20 6f 72 20 74 72 61 6e 73 69 65 6e 74  ary or transient
19c0: 20 64 61 74 61 62 61 73 65 29 20 68 61 73 20 61   database) has a
19d0: 20 73 69 6e 67 6c 65 20 70 61 67 65 20 63 61 63   single page cac
19e0: 68 65 20 77 68 69 63 68 0a 2a 2a 20 69 73 20 61  he which.** is a
19f0: 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68  n instance of th
1a00: 69 73 20 6f 62 6a 65 63 74 2e 0a 2a 2a 0a 2a 2a  is object..**.**
1a10: 20 50 6f 69 6e 74 65 72 73 20 74 6f 20 73 74 72   Pointers to str
1a20: 75 63 74 75 72 65 73 20 6f 66 20 74 68 69 73 20  uctures of this 
1a30: 74 79 70 65 20 61 72 65 20 63 61 73 74 20 61 6e  type are cast an
1a40: 64 20 72 65 74 75 72 6e 65 64 20 61 73 20 0a 2a  d returned as .*
1a50: 2a 20 6f 70 61 71 75 65 20 73 71 6c 69 74 65 33  * opaque sqlite3
1a60: 5f 70 63 61 63 68 65 2a 20 68 61 6e 64 6c 65 73  _pcache* handles
1a70: 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 50 43 61 63  ..*/.struct PCac
1a80: 68 65 31 20 7b 0a 20 20 2f 2a 20 43 61 63 68 65  he1 {.  /* Cache
1a90: 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 70   configuration p
1aa0: 61 72 61 6d 65 74 65 72 73 2e 20 50 61 67 65 20  arameters. Page 
1ab0: 73 69 7a 65 20 28 73 7a 50 61 67 65 29 20 61 6e  size (szPage) an
1ac0: 64 20 74 68 65 20 70 75 72 67 65 61 62 6c 65 0a  d the purgeable.
1ad0: 20 20 2a 2a 20 66 6c 61 67 20 28 62 50 75 72 67    ** flag (bPurg
1ae0: 65 61 62 6c 65 29 20 61 72 65 20 73 65 74 20 77  eable) are set w
1af0: 68 65 6e 20 74 68 65 20 63 61 63 68 65 20 69 73  hen the cache is
1b00: 20 63 72 65 61 74 65 64 2e 20 6e 4d 61 78 20 6d   created. nMax m
1b10: 61 79 20 62 65 20 0a 20 20 2a 2a 20 6d 6f 64 69  ay be .  ** modi
1b20: 66 69 65 64 20 61 74 20 61 6e 79 20 74 69 6d 65  fied at any time
1b30: 20 62 79 20 61 20 63 61 6c 6c 20 74 6f 20 74 68   by a call to th
1b40: 65 20 70 63 61 63 68 65 31 43 61 63 68 65 73 69  e pcache1Cachesi
1b50: 7a 65 28 29 20 6d 65 74 68 6f 64 2e 0a 20 20 2a  ze() method..  *
1b60: 2a 20 54 68 65 20 50 47 72 6f 75 70 20 6d 75 74  * The PGroup mut
1b70: 65 78 20 6d 75 73 74 20 62 65 20 68 65 6c 64 20  ex must be held 
1b80: 77 68 65 6e 20 61 63 63 65 73 73 69 6e 67 20 6e  when accessing n
1b90: 4d 61 78 2e 0a 20 20 2a 2f 0a 20 20 50 47 72 6f  Max..  */.  PGro
1ba0: 75 70 20 2a 70 47 72 6f 75 70 3b 20 20 20 20 20  up *pGroup;     
1bb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1bc0: 2f 2a 20 50 47 72 6f 75 70 20 74 68 69 73 20 63  /* PGroup this c
1bd0: 61 63 68 65 20 62 65 6c 6f 6e 67 73 20 74 6f 20  ache belongs to 
1be0: 2a 2f 0a 20 20 69 6e 74 20 73 7a 50 61 67 65 3b  */.  int szPage;
1bf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1c00: 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65           /* Size
1c10: 20 6f 66 20 64 61 74 61 62 61 73 65 20 63 6f 6e   of database con
1c20: 74 65 6e 74 20 73 65 63 74 69 6f 6e 20 2a 2f 0a  tent section */.
1c30: 20 20 69 6e 74 20 73 7a 45 78 74 72 61 3b 20 20    int szExtra;  
1c40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1c50: 20 20 20 20 20 20 2f 2a 20 73 69 7a 65 6f 66 28        /* sizeof(
1c60: 4d 65 6d 50 61 67 65 29 2b 73 69 7a 65 6f 66 28  MemPage)+sizeof(
1c70: 50 67 48 64 72 29 20 2a 2f 0a 20 20 69 6e 74 20  PgHdr) */.  int 
1c80: 73 7a 41 6c 6c 6f 63 3b 20 20 20 20 20 20 20 20  szAlloc;        
1c90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1ca0: 2f 2a 20 54 6f 74 61 6c 20 73 69 7a 65 20 6f 66  /* Total size of
1cb0: 20 6f 6e 65 20 70 63 61 63 68 65 20 6c 69 6e 65   one pcache line
1cc0: 20 2a 2f 0a 20 20 69 6e 74 20 62 50 75 72 67 65   */.  int bPurge
1cd0: 61 62 6c 65 3b 20 20 20 20 20 20 20 20 20 20 20  able;           
1ce0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75            /* Tru
1cf0: 65 20 69 66 20 63 61 63 68 65 20 69 73 20 70 75  e if cache is pu
1d00: 72 67 65 61 62 6c 65 20 2a 2f 0a 20 20 75 6e 73  rgeable */.  uns
1d10: 69 67 6e 65 64 20 69 6e 74 20 6e 4d 69 6e 3b 20  igned int nMin; 
1d20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1d30: 20 2f 2a 20 4d 69 6e 69 6d 75 6d 20 6e 75 6d 62   /* Minimum numb
1d40: 65 72 20 6f 66 20 70 61 67 65 73 20 72 65 73 65  er of pages rese
1d50: 72 76 65 64 20 2a 2f 0a 20 20 75 6e 73 69 67 6e  rved */.  unsign
1d60: 65 64 20 69 6e 74 20 6e 4d 61 78 3b 20 20 20 20  ed int nMax;    
1d70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
1d80: 20 43 6f 6e 66 69 67 75 72 65 64 20 22 63 61 63   Configured "cac
1d90: 68 65 5f 73 69 7a 65 22 20 76 61 6c 75 65 20 2a  he_size" value *
1da0: 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74  /.  unsigned int
1db0: 20 6e 39 30 70 63 74 3b 20 20 20 20 20 20 20 20   n90pct;        
1dc0: 20 20 20 20 20 20 20 20 2f 2a 20 6e 4d 61 78 2a          /* nMax*
1dd0: 39 2f 31 30 20 2a 2f 0a 20 20 75 6e 73 69 67 6e  9/10 */.  unsign
1de0: 65 64 20 69 6e 74 20 69 4d 61 78 4b 65 79 3b 20  ed int iMaxKey; 
1df0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
1e00: 20 4c 61 72 67 65 73 74 20 6b 65 79 20 73 65 65   Largest key see
1e10: 6e 20 73 69 6e 63 65 20 78 54 72 75 6e 63 61 74  n since xTruncat
1e20: 65 28 29 20 2a 2f 0a 0a 20 20 2f 2a 20 48 61 73  e() */..  /* Has
1e30: 68 20 74 61 62 6c 65 20 6f 66 20 61 6c 6c 20 70  h table of all p
1e40: 61 67 65 73 2e 20 54 68 65 20 66 6f 6c 6c 6f 77  ages. The follow
1e50: 69 6e 67 20 76 61 72 69 61 62 6c 65 73 20 6d 61  ing variables ma
1e60: 79 20 6f 6e 6c 79 20 62 65 20 61 63 63 65 73 73  y only be access
1e70: 65 64 0a 20 20 2a 2a 20 77 68 65 6e 20 74 68 65  ed.  ** when the
1e80: 20 61 63 63 65 73 73 6f 72 20 69 73 20 68 6f 6c   accessor is hol
1e90: 64 69 6e 67 20 74 68 65 20 50 47 72 6f 75 70 20  ding the PGroup 
1ea0: 6d 75 74 65 78 2e 0a 20 20 2a 2f 0a 20 20 75 6e  mutex..  */.  un
1eb0: 73 69 67 6e 65 64 20 69 6e 74 20 6e 52 65 63 79  signed int nRecy
1ec0: 63 6c 61 62 6c 65 3b 20 20 20 20 20 20 20 20 20  clable;         
1ed0: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70    /* Number of p
1ee0: 61 67 65 73 20 69 6e 20 74 68 65 20 4c 52 55 20  ages in the LRU 
1ef0: 6c 69 73 74 20 2a 2f 0a 20 20 75 6e 73 69 67 6e  list */.  unsign
1f00: 65 64 20 69 6e 74 20 6e 50 61 67 65 3b 20 20 20  ed int nPage;   
1f10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
1f20: 20 54 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66   Total number of
1f30: 20 70 61 67 65 73 20 69 6e 20 61 70 48 61 73 68   pages in apHash
1f40: 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69   */.  unsigned i
1f50: 6e 74 20 6e 48 61 73 68 3b 20 20 20 20 20 20 20  nt nHash;       
1f60: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d            /* Num
1f70: 62 65 72 20 6f 66 20 73 6c 6f 74 73 20 69 6e 20  ber of slots in 
1f80: 61 70 48 61 73 68 5b 5d 20 2a 2f 0a 20 20 50 67  apHash[] */.  Pg
1f90: 48 64 72 31 20 2a 2a 61 70 48 61 73 68 3b 20 20  Hdr1 **apHash;  
1fa0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1fb0: 20 20 2f 2a 20 48 61 73 68 20 74 61 62 6c 65 20    /* Hash table 
1fc0: 66 6f 72 20 66 61 73 74 20 6c 6f 6f 6b 75 70 20  for fast lookup 
1fd0: 62 79 20 6b 65 79 20 2a 2f 0a 20 20 50 67 48 64  by key */.  PgHd
1fe0: 72 31 20 2a 70 46 72 65 65 3b 20 20 20 20 20 20  r1 *pFree;      
1ff0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2000: 2f 2a 20 4c 69 73 74 20 6f 66 20 75 6e 75 73 65  /* List of unuse
2010: 64 20 70 63 61 63 68 65 2d 6c 6f 63 61 6c 20 70  d pcache-local p
2020: 61 67 65 73 20 2a 2f 0a 20 20 76 6f 69 64 20 2a  ages */.  void *
2030: 70 42 75 6c 6b 3b 20 20 20 20 20 20 20 20 20 20  pBulk;          
2040: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
2050: 20 42 75 6c 6b 20 6d 65 6d 6f 72 79 20 75 73 65   Bulk memory use
2060: 64 20 62 79 20 70 63 61 63 68 65 2d 6c 6f 63 61  d by pcache-loca
2070: 6c 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 46  l */.};../*.** F
2080: 72 65 65 20 73 6c 6f 74 73 20 69 6e 20 74 68 65  ree slots in the
2090: 20 61 6c 6c 6f 63 61 74 6f 72 20 75 73 65 64 20   allocator used 
20a0: 74 6f 20 64 69 76 69 64 65 20 75 70 20 74 68 65  to divide up the
20b0: 20 67 6c 6f 62 61 6c 20 70 61 67 65 20 63 61 63   global page cac
20c0: 68 65 0a 2a 2a 20 62 75 66 66 65 72 20 70 72 6f  he.** buffer pro
20d0: 76 69 64 65 64 20 75 73 69 6e 67 20 74 68 65 20  vided using the 
20e0: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41  SQLITE_CONFIG_PA
20f0: 47 45 43 41 43 48 45 20 6d 65 63 68 61 6e 69 73  GECACHE mechanis
2100: 6d 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 50 67 46  m..*/.struct PgF
2110: 72 65 65 73 6c 6f 74 20 7b 0a 20 20 50 67 46 72  reeslot {.  PgFr
2120: 65 65 73 6c 6f 74 20 2a 70 4e 65 78 74 3b 20 20  eeslot *pNext;  
2130: 2f 2a 20 4e 65 78 74 20 66 72 65 65 20 73 6c 6f  /* Next free slo
2140: 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 47  t */.};../*.** G
2150: 6c 6f 62 61 6c 20 64 61 74 61 20 75 73 65 64 20  lobal data used 
2160: 62 79 20 74 68 69 73 20 63 61 63 68 65 2e 0a 2a  by this cache..*
2170: 2f 0a 73 74 61 74 69 63 20 53 51 4c 49 54 45 5f  /.static SQLITE_
2180: 57 53 44 20 73 74 72 75 63 74 20 50 43 61 63 68  WSD struct PCach
2190: 65 47 6c 6f 62 61 6c 20 7b 0a 20 20 50 47 72 6f  eGlobal {.  PGro
21a0: 75 70 20 67 72 70 3b 20 20 20 20 20 20 20 20 20  up grp;         
21b0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68             /* Th
21c0: 65 20 67 6c 6f 62 61 6c 20 50 47 72 6f 75 70 20  e global PGroup 
21d0: 66 6f 72 20 6d 6f 64 65 20 28 32 29 20 2a 2f 0a  for mode (2) */.
21e0: 0a 20 20 2f 2a 20 56 61 72 69 61 62 6c 65 73 20  .  /* Variables 
21f0: 72 65 6c 61 74 65 64 20 74 6f 20 53 51 4c 49 54  related to SQLIT
2200: 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43  E_CONFIG_PAGECAC
2210: 48 45 20 73 65 74 74 69 6e 67 73 2e 20 20 54 68  HE settings.  Th
2220: 65 0a 20 20 2a 2a 20 73 7a 53 6c 6f 74 2c 20 6e  e.  ** szSlot, n
2230: 53 6c 6f 74 2c 20 70 53 74 61 72 74 2c 20 70 45  Slot, pStart, pE
2240: 6e 64 2c 20 6e 52 65 73 65 72 76 65 2c 20 61 6e  nd, nReserve, an
2250: 64 20 69 73 49 6e 69 74 20 76 61 6c 75 65 73 20  d isInit values 
2260: 61 72 65 20 61 6c 6c 0a 20 20 2a 2a 20 66 69 78  are all.  ** fix
2270: 65 64 20 61 74 20 73 71 6c 69 74 65 33 5f 69 6e  ed at sqlite3_in
2280: 69 74 69 61 6c 69 7a 65 28 29 20 74 69 6d 65 20  itialize() time 
2290: 61 6e 64 20 64 6f 20 6e 6f 74 20 72 65 71 75 69  and do not requi
22a0: 72 65 20 6d 75 74 65 78 20 70 72 6f 74 65 63 74  re mutex protect
22b0: 69 6f 6e 2e 0a 20 20 2a 2a 20 54 68 65 20 6e 46  ion..  ** The nF
22c0: 72 65 65 53 6c 6f 74 20 61 6e 64 20 70 46 72 65  reeSlot and pFre
22d0: 65 20 76 61 6c 75 65 73 20 64 6f 20 72 65 71 75  e values do requ
22e0: 69 72 65 20 6d 75 74 65 78 20 70 72 6f 74 65 63  ire mutex protec
22f0: 74 69 6f 6e 2e 0a 20 20 2a 2f 0a 20 20 69 6e 74  tion..  */.  int
2300: 20 69 73 49 6e 69 74 3b 20 20 20 20 20 20 20 20   isInit;        
2310: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
2320: 72 75 65 20 69 66 20 69 6e 69 74 69 61 6c 69 7a  rue if initializ
2330: 65 64 20 2a 2f 0a 20 20 69 6e 74 20 73 65 70 61  ed */.  int sepa
2340: 72 61 74 65 43 61 63 68 65 3b 20 20 20 20 20 20  rateCache;      
2350: 20 20 20 20 20 20 20 2f 2a 20 55 73 65 20 61 20         /* Use a 
2360: 6e 65 77 20 50 47 72 6f 75 70 20 66 6f 72 20 65  new PGroup for e
2370: 61 63 68 20 50 43 61 63 68 65 20 2a 2f 0a 20 20  ach PCache */.  
2380: 69 6e 74 20 6e 49 6e 69 74 50 61 67 65 3b 20 20  int nInitPage;  
2390: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
23a0: 2a 20 49 6e 69 74 69 61 6c 20 62 75 6c 6b 20 61  * Initial bulk a
23b0: 6c 6c 6f 63 61 74 69 6f 6e 20 73 69 7a 65 20 2a  llocation size *
23c0: 2f 20 20 20 0a 20 20 69 6e 74 20 73 7a 53 6c 6f  /   .  int szSlo
23d0: 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  t;              
23e0: 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66        /* Size of
23f0: 20 65 61 63 68 20 66 72 65 65 20 73 6c 6f 74 20   each free slot 
2400: 2a 2f 0a 20 20 69 6e 74 20 6e 53 6c 6f 74 3b 20  */.  int nSlot; 
2410: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2420: 20 20 20 20 2f 2a 20 54 68 65 20 6e 75 6d 62 65      /* The numbe
2430: 72 20 6f 66 20 70 63 61 63 68 65 20 73 6c 6f 74  r of pcache slot
2440: 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 73 65  s */.  int nRese
2450: 72 76 65 3b 20 20 20 20 20 20 20 20 20 20 20 20  rve;            
2460: 20 20 20 20 20 20 2f 2a 20 54 72 79 20 74 6f 20        /* Try to 
2470: 6b 65 65 70 20 6e 46 72 65 65 53 6c 6f 74 20 61  keep nFreeSlot a
2480: 62 6f 76 65 20 74 68 69 73 20 2a 2f 0a 20 20 76  bove this */.  v
2490: 6f 69 64 20 2a 70 53 74 61 72 74 2c 20 2a 70 45  oid *pStart, *pE
24a0: 6e 64 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a  nd;           /*
24b0: 20 42 6f 75 6e 64 73 20 6f 66 20 67 6c 6f 62 61   Bounds of globa
24c0: 6c 20 70 61 67 65 20 63 61 63 68 65 20 6d 65 6d  l page cache mem
24d0: 6f 72 79 20 2a 2f 0a 20 20 2f 2a 20 41 62 6f 76  ory */.  /* Abov
24e0: 65 20 72 65 71 75 69 72 65 73 20 6e 6f 20 6d 75  e requires no mu
24f0: 74 65 78 2e 20 20 55 73 65 20 6d 75 74 65 78 20  tex.  Use mutex 
2500: 62 65 6c 6f 77 20 66 6f 72 20 76 61 72 69 61 62  below for variab
2510: 6c 65 20 74 68 61 74 20 66 6f 6c 6c 6f 77 2e 20  le that follow. 
2520: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  */.  sqlite3_mut
2530: 65 78 20 2a 6d 75 74 65 78 3b 20 20 20 20 20 20  ex *mutex;      
2540: 20 20 20 20 2f 2a 20 4d 75 74 65 78 20 66 6f 72      /* Mutex for
2550: 20 61 63 63 65 73 73 69 6e 67 20 74 68 65 20 66   accessing the f
2560: 6f 6c 6c 6f 77 69 6e 67 3a 20 2a 2f 0a 20 20 50  ollowing: */.  P
2570: 67 46 72 65 65 73 6c 6f 74 20 2a 70 46 72 65 65  gFreeslot *pFree
2580: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ;             /*
2590: 20 46 72 65 65 20 70 61 67 65 20 62 6c 6f 63 6b   Free page block
25a0: 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 46 72 65 65  s */.  int nFree
25b0: 53 6c 6f 74 3b 20 20 20 20 20 20 20 20 20 20 20  Slot;           
25c0: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20        /* Number 
25d0: 6f 66 20 75 6e 75 73 65 64 20 70 63 61 63 68 65  of unused pcache
25e0: 20 73 6c 6f 74 73 20 2a 2f 0a 20 20 2f 2a 20 54   slots */.  /* T
25f0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 76 61 6c  he following val
2600: 75 65 20 72 65 71 75 69 72 65 73 20 61 20 6d 75  ue requires a mu
2610: 74 65 78 20 74 6f 20 63 68 61 6e 67 65 2e 20 20  tex to change.  
2620: 57 65 20 73 6b 69 70 20 74 68 65 20 6d 75 74 65  We skip the mute
2630: 78 20 6f 6e 0a 20 20 2a 2a 20 72 65 61 64 69 6e  x on.  ** readin
2640: 67 20 62 65 63 61 75 73 65 20 28 31 29 20 6d 6f  g because (1) mo
2650: 73 74 20 70 6c 61 74 66 6f 72 6d 73 20 72 65 61  st platforms rea
2660: 64 20 61 20 33 32 2d 62 69 74 20 69 6e 74 65 67  d a 32-bit integ
2670: 65 72 20 61 74 6f 6d 69 63 61 6c 6c 79 20 61 6e  er atomically an
2680: 64 0a 20 20 2a 2a 20 28 32 29 20 65 76 65 6e 20  d.  ** (2) even 
2690: 69 66 20 61 6e 20 69 6e 63 6f 72 72 65 63 74 20  if an incorrect 
26a0: 76 61 6c 75 65 20 69 73 20 72 65 61 64 2c 20 6e  value is read, n
26b0: 6f 20 67 72 65 61 74 20 68 61 72 6d 20 69 73 20  o great harm is 
26c0: 64 6f 6e 65 20 73 69 6e 63 65 20 74 68 69 73 0a  done since this.
26d0: 20 20 2a 2a 20 69 73 20 72 65 61 6c 6c 79 20 6a    ** is really j
26e0: 75 73 74 20 61 6e 20 6f 70 74 69 6d 69 7a 61 74  ust an optimizat
26f0: 69 6f 6e 2e 20 2a 2f 0a 20 20 69 6e 74 20 62 55  ion. */.  int bU
2700: 6e 64 65 72 50 72 65 73 73 75 72 65 3b 20 20 20  nderPressure;   
2710: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65           /* True
2720: 20 69 66 20 6c 6f 77 20 6f 6e 20 50 41 47 45 43   if low on PAGEC
2730: 41 43 48 45 20 6d 65 6d 6f 72 79 20 2a 2f 0a 7d  ACHE memory */.}
2740: 20 70 63 61 63 68 65 31 5f 67 3b 0a 0a 2f 2a 0a   pcache1_g;../*.
2750: 2a 2a 20 41 6c 6c 20 63 6f 64 65 20 69 6e 20 74  ** All code in t
2760: 68 69 73 20 66 69 6c 65 20 73 68 6f 75 6c 64 20  his file should 
2770: 61 63 63 65 73 73 20 74 68 65 20 67 6c 6f 62 61  access the globa
2780: 6c 20 73 74 72 75 63 74 75 72 65 20 61 62 6f 76  l structure abov
2790: 65 20 76 69 61 20 74 68 65 0a 2a 2a 20 61 6c 69  e via the.** ali
27a0: 61 73 20 22 70 63 61 63 68 65 31 22 2e 20 54 68  as "pcache1". Th
27b0: 69 73 20 65 6e 73 75 72 65 73 20 74 68 61 74 20  is ensures that 
27c0: 74 68 65 20 57 53 44 20 65 6d 75 6c 61 74 69 6f  the WSD emulatio
27d0: 6e 20 69 73 20 75 73 65 64 20 77 68 65 6e 0a 2a  n is used when.*
27e0: 2a 20 63 6f 6d 70 69 6c 69 6e 67 20 66 6f 72 20  * compiling for 
27f0: 73 79 73 74 65 6d 73 20 74 68 61 74 20 64 6f 20  systems that do 
2800: 6e 6f 74 20 73 75 70 70 6f 72 74 20 72 65 61 6c  not support real
2810: 20 57 53 44 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65   WSD..*/.#define
2820: 20 70 63 61 63 68 65 31 20 28 47 4c 4f 42 41 4c   pcache1 (GLOBAL
2830: 28 73 74 72 75 63 74 20 50 43 61 63 68 65 47 6c  (struct PCacheGl
2840: 6f 62 61 6c 2c 20 70 63 61 63 68 65 31 5f 67 29  obal, pcache1_g)
2850: 29 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72 6f 73 20  )../*.** Macros 
2860: 74 6f 20 65 6e 74 65 72 20 61 6e 64 20 6c 65 61  to enter and lea
2870: 76 65 20 74 68 65 20 50 43 61 63 68 65 20 4c 52  ve the PCache LR
2880: 55 20 6d 75 74 65 78 2e 0a 2a 2f 0a 23 69 66 20  U mutex..*/.#if 
2890: 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f  !defined(SQLITE_
28a0: 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41  ENABLE_MEMORY_MA
28b0: 4e 41 47 45 4d 45 4e 54 29 20 7c 7c 20 53 51 4c  NAGEMENT) || SQL
28c0: 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d 3d  ITE_THREADSAFE==
28d0: 30 0a 23 20 64 65 66 69 6e 65 20 70 63 61 63 68  0.# define pcach
28e0: 65 31 45 6e 74 65 72 4d 75 74 65 78 28 58 29 20  e1EnterMutex(X) 
28f0: 20 61 73 73 65 72 74 28 28 58 29 2d 3e 6d 75 74   assert((X)->mut
2900: 65 78 3d 3d 30 29 0a 23 20 64 65 66 69 6e 65 20  ex==0).# define 
2910: 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65  pcache1LeaveMute
2920: 78 28 58 29 20 20 61 73 73 65 72 74 28 28 58 29  x(X)  assert((X)
2930: 2d 3e 6d 75 74 65 78 3d 3d 30 29 0a 23 20 64 65  ->mutex==0).# de
2940: 66 69 6e 65 20 50 43 41 43 48 45 31 5f 4d 49 47  fine PCACHE1_MIG
2950: 48 54 5f 55 53 45 5f 47 52 4f 55 50 5f 4d 55 54  HT_USE_GROUP_MUT
2960: 45 58 20 30 0a 23 65 6c 73 65 0a 23 20 64 65 66  EX 0.#else.# def
2970: 69 6e 65 20 70 63 61 63 68 65 31 45 6e 74 65 72  ine pcache1Enter
2980: 4d 75 74 65 78 28 58 29 20 73 71 6c 69 74 65 33  Mutex(X) sqlite3
2990: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 28 58 29  _mutex_enter((X)
29a0: 2d 3e 6d 75 74 65 78 29 0a 23 20 64 65 66 69 6e  ->mutex).# defin
29b0: 65 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75  e pcache1LeaveMu
29c0: 74 65 78 28 58 29 20 73 71 6c 69 74 65 33 5f 6d  tex(X) sqlite3_m
29d0: 75 74 65 78 5f 6c 65 61 76 65 28 28 58 29 2d 3e  utex_leave((X)->
29e0: 6d 75 74 65 78 29 0a 23 20 64 65 66 69 6e 65 20  mutex).# define 
29f0: 50 43 41 43 48 45 31 5f 4d 49 47 48 54 5f 55 53  PCACHE1_MIGHT_US
2a00: 45 5f 47 52 4f 55 50 5f 4d 55 54 45 58 20 31 0a  E_GROUP_MUTEX 1.
2a10: 23 65 6e 64 69 66 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a  #endif../*******
2a20: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2a30: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2a40: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2a50: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2a60: 2a 2a 2a 2a 2a 2a 2a 2f 0a 2f 2a 2a 2a 2a 2a 2a  *******/./******
2a70: 2a 2a 20 50 61 67 65 20 41 6c 6c 6f 63 61 74 69  ** Page Allocati
2a80: 6f 6e 2f 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47  on/SQLITE_CONFIG
2a90: 5f 50 43 41 43 48 45 20 52 65 6c 61 74 65 64 20  _PCACHE Related 
2aa0: 46 75 6e 63 74 69 6f 6e 73 20 2a 2a 2a 2a 2a 2a  Functions ******
2ab0: 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 0a 2f 2a 0a 2a  ********/.../*.*
2ac0: 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  * This function 
2ad0: 69 73 20 63 61 6c 6c 65 64 20 64 75 72 69 6e 67  is called during
2ae0: 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20   initialization 
2af0: 69 66 20 61 20 73 74 61 74 69 63 20 62 75 66 66  if a static buff
2b00: 65 72 20 69 73 20 0a 2a 2a 20 73 75 70 70 6c 69  er is .** suppli
2b10: 65 64 20 74 6f 20 75 73 65 20 66 6f 72 20 74 68  ed to use for th
2b20: 65 20 70 61 67 65 2d 63 61 63 68 65 20 62 79 20  e page-cache by 
2b30: 70 61 73 73 69 6e 67 20 74 68 65 20 53 51 4c 49  passing the SQLI
2b40: 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41  TE_CONFIG_PAGECA
2b50: 43 48 45 0a 2a 2a 20 76 65 72 62 20 74 6f 20 73  CHE.** verb to s
2b60: 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 29 2e  qlite3_config().
2b70: 20 50 61 72 61 6d 65 74 65 72 20 70 42 75 66 20   Parameter pBuf 
2b80: 70 6f 69 6e 74 73 20 74 6f 20 61 6e 20 61 6c 6c  points to an all
2b90: 6f 63 61 74 69 6f 6e 20 6c 61 72 67 65 0a 2a 2a  ocation large.**
2ba0: 20 65 6e 6f 75 67 68 20 74 6f 20 63 6f 6e 74 61   enough to conta
2bb0: 69 6e 20 27 6e 27 20 62 75 66 66 65 72 73 20 6f  in 'n' buffers o
2bc0: 66 20 27 73 7a 27 20 62 79 74 65 73 20 65 61 63  f 'sz' bytes eac
2bd0: 68 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f  h..**.** This ro
2be0: 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 20  utine is called 
2bf0: 66 72 6f 6d 20 73 71 6c 69 74 65 33 5f 69 6e 69  from sqlite3_ini
2c00: 74 69 61 6c 69 7a 65 28 29 20 61 6e 64 20 73 6f  tialize() and so
2c10: 20 69 74 20 69 73 20 67 75 61 72 61 6e 74 65 65   it is guarantee
2c20: 64 0a 2a 2a 20 74 6f 20 62 65 20 73 65 72 69 61  d.** to be seria
2c30: 6c 69 7a 65 64 20 61 6c 72 65 61 64 79 2e 20 20  lized already.  
2c40: 54 68 65 72 65 20 69 73 20 6e 6f 20 6e 65 65 64  There is no need
2c50: 20 66 6f 72 20 66 75 72 74 68 65 72 20 6d 75 74   for further mut
2c60: 65 78 69 6e 67 2e 0a 2a 2f 0a 76 6f 69 64 20 73  exing..*/.void s
2c70: 71 6c 69 74 65 33 50 43 61 63 68 65 42 75 66 66  qlite3PCacheBuff
2c80: 65 72 53 65 74 75 70 28 76 6f 69 64 20 2a 70 42  erSetup(void *pB
2c90: 75 66 2c 20 69 6e 74 20 73 7a 2c 20 69 6e 74 20  uf, int sz, int 
2ca0: 6e 29 7b 0a 20 20 69 66 28 20 70 63 61 63 68 65  n){.  if( pcache
2cb0: 31 2e 69 73 49 6e 69 74 20 29 7b 0a 20 20 20 20  1.isInit ){.    
2cc0: 50 67 46 72 65 65 73 6c 6f 74 20 2a 70 3b 0a 20  PgFreeslot *p;. 
2cd0: 20 20 20 69 66 28 20 70 42 75 66 3d 3d 30 20 29     if( pBuf==0 )
2ce0: 20 73 7a 20 3d 20 6e 20 3d 20 30 3b 0a 20 20 20   sz = n = 0;.   
2cf0: 20 73 7a 20 3d 20 52 4f 55 4e 44 44 4f 57 4e 38   sz = ROUNDDOWN8
2d00: 28 73 7a 29 3b 0a 20 20 20 20 70 63 61 63 68 65  (sz);.    pcache
2d10: 31 2e 73 7a 53 6c 6f 74 20 3d 20 73 7a 3b 0a 20  1.szSlot = sz;. 
2d20: 20 20 20 70 63 61 63 68 65 31 2e 6e 53 6c 6f 74     pcache1.nSlot
2d30: 20 3d 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65   = pcache1.nFree
2d40: 53 6c 6f 74 20 3d 20 6e 3b 0a 20 20 20 20 70 63  Slot = n;.    pc
2d50: 61 63 68 65 31 2e 6e 52 65 73 65 72 76 65 20 3d  ache1.nReserve =
2d60: 20 6e 3e 39 30 20 3f 20 31 30 20 3a 20 28 6e 2f   n>90 ? 10 : (n/
2d70: 31 30 20 2b 20 31 29 3b 0a 20 20 20 20 70 63 61  10 + 1);.    pca
2d80: 63 68 65 31 2e 70 53 74 61 72 74 20 3d 20 70 42  che1.pStart = pB
2d90: 75 66 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e  uf;.    pcache1.
2da0: 70 46 72 65 65 20 3d 20 30 3b 0a 20 20 20 20 70  pFree = 0;.    p
2db0: 63 61 63 68 65 31 2e 62 55 6e 64 65 72 50 72 65  cache1.bUnderPre
2dc0: 73 73 75 72 65 20 3d 20 30 3b 0a 20 20 20 20 77  ssure = 0;.    w
2dd0: 68 69 6c 65 28 20 6e 2d 2d 20 29 7b 0a 20 20 20  hile( n-- ){.   
2de0: 20 20 20 70 20 3d 20 28 50 67 46 72 65 65 73 6c     p = (PgFreesl
2df0: 6f 74 2a 29 70 42 75 66 3b 0a 20 20 20 20 20 20  ot*)pBuf;.      
2e00: 70 2d 3e 70 4e 65 78 74 20 3d 20 70 63 61 63 68  p->pNext = pcach
2e10: 65 31 2e 70 46 72 65 65 3b 0a 20 20 20 20 20 20  e1.pFree;.      
2e20: 70 63 61 63 68 65 31 2e 70 46 72 65 65 20 3d 20  pcache1.pFree = 
2e30: 70 3b 0a 20 20 20 20 20 20 70 42 75 66 20 3d 20  p;.      pBuf = 
2e40: 28 76 6f 69 64 2a 29 26 28 28 63 68 61 72 2a 29  (void*)&((char*)
2e50: 70 42 75 66 29 5b 73 7a 5d 3b 0a 20 20 20 20 7d  pBuf)[sz];.    }
2e60: 0a 20 20 20 20 70 63 61 63 68 65 31 2e 70 45 6e  .    pcache1.pEn
2e70: 64 20 3d 20 70 42 75 66 3b 0a 20 20 7d 0a 7d 0a  d = pBuf;.  }.}.
2e80: 0a 2f 2a 0a 2a 2a 20 54 72 79 20 74 6f 20 69 6e  ./*.** Try to in
2e90: 69 74 69 61 6c 69 7a 65 20 74 68 65 20 70 43 61  itialize the pCa
2ea0: 63 68 65 2d 3e 70 46 72 65 65 20 61 6e 64 20 70  che->pFree and p
2eb0: 43 61 63 68 65 2d 3e 70 42 75 6c 6b 20 66 69 65  Cache->pBulk fie
2ec0: 6c 64 73 2e 20 20 52 65 74 75 72 6e 0a 2a 2a 20  lds.  Return.** 
2ed0: 74 72 75 65 20 69 66 20 70 43 61 63 68 65 2d 3e  true if pCache->
2ee0: 70 46 72 65 65 20 65 6e 64 73 20 75 70 20 63 6f  pFree ends up co
2ef0: 6e 74 61 69 6e 69 6e 67 20 6f 6e 65 20 6f 72 20  ntaining one or 
2f00: 6d 6f 72 65 20 66 72 65 65 20 70 61 67 65 73 2e  more free pages.
2f10: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70  .*/.static int p
2f20: 63 61 63 68 65 31 49 6e 69 74 42 75 6c 6b 28 50  cache1InitBulk(P
2f30: 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 29 7b  Cache1 *pCache){
2f40: 0a 20 20 69 36 34 20 73 7a 42 75 6c 6b 3b 0a 20  .  i64 szBulk;. 
2f50: 20 63 68 61 72 20 2a 7a 42 75 6c 6b 3b 0a 20 20   char *zBulk;.  
2f60: 69 66 28 20 70 63 61 63 68 65 31 2e 6e 49 6e 69  if( pcache1.nIni
2f70: 74 50 61 67 65 3d 3d 30 20 29 20 72 65 74 75 72  tPage==0 ) retur
2f80: 6e 20 30 3b 0a 20 20 2f 2a 20 44 6f 20 6e 6f 74  n 0;.  /* Do not
2f90: 20 62 6f 74 68 65 72 20 77 69 74 68 20 61 20 62   bother with a b
2fa0: 75 6c 6b 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69  ulk allocation i
2fb0: 66 20 74 68 65 20 63 61 63 68 65 20 73 69 7a 65  f the cache size
2fc0: 20 76 65 72 79 20 73 6d 61 6c 6c 20 2a 2f 0a 20   very small */. 
2fd0: 20 69 66 28 20 70 43 61 63 68 65 2d 3e 6e 4d 61   if( pCache->nMa
2fe0: 78 3c 33 20 29 20 72 65 74 75 72 6e 20 30 3b 0a  x<3 ) return 0;.
2ff0: 20 20 73 71 6c 69 74 65 33 42 65 67 69 6e 42 65    sqlite3BeginBe
3000: 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20  nignMalloc();.  
3010: 69 66 28 20 70 63 61 63 68 65 31 2e 6e 49 6e 69  if( pcache1.nIni
3020: 74 50 61 67 65 3e 30 20 29 7b 0a 20 20 20 20 73  tPage>0 ){.    s
3030: 7a 42 75 6c 6b 20 3d 20 70 43 61 63 68 65 2d 3e  zBulk = pCache->
3040: 73 7a 41 6c 6c 6f 63 20 2a 20 28 69 36 34 29 70  szAlloc * (i64)p
3050: 63 61 63 68 65 31 2e 6e 49 6e 69 74 50 61 67 65  cache1.nInitPage
3060: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73  ;.  }else{.    s
3070: 7a 42 75 6c 6b 20 3d 20 2d 31 30 32 34 20 2a 20  zBulk = -1024 * 
3080: 28 69 36 34 29 70 63 61 63 68 65 31 2e 6e 49 6e  (i64)pcache1.nIn
3090: 69 74 50 61 67 65 3b 0a 20 20 7d 0a 20 20 69 66  itPage;.  }.  if
30a0: 28 20 73 7a 42 75 6c 6b 20 3e 20 70 43 61 63 68  ( szBulk > pCach
30b0: 65 2d 3e 73 7a 41 6c 6c 6f 63 2a 28 69 36 34 29  e->szAlloc*(i64)
30c0: 70 43 61 63 68 65 2d 3e 6e 4d 61 78 20 29 7b 0a  pCache->nMax ){.
30d0: 20 20 20 20 73 7a 42 75 6c 6b 20 3d 20 70 43 61      szBulk = pCa
30e0: 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63 2a 28 69 36  che->szAlloc*(i6
30f0: 34 29 70 43 61 63 68 65 2d 3e 6e 4d 61 78 3b 0a  4)pCache->nMax;.
3100: 20 20 7d 0a 20 20 7a 42 75 6c 6b 20 3d 20 70 43    }.  zBulk = pC
3110: 61 63 68 65 2d 3e 70 42 75 6c 6b 20 3d 20 73 71  ache->pBulk = sq
3120: 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 20 73 7a 42  lite3Malloc( szB
3130: 75 6c 6b 20 29 3b 0a 20 20 73 71 6c 69 74 65 33  ulk );.  sqlite3
3140: 45 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28  EndBenignMalloc(
3150: 29 3b 0a 20 20 69 66 28 20 7a 42 75 6c 6b 20 29  );.  if( zBulk )
3160: 7b 0a 20 20 20 20 69 6e 74 20 6e 42 75 6c 6b 20  {.    int nBulk 
3170: 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53  = sqlite3MallocS
3180: 69 7a 65 28 7a 42 75 6c 6b 29 2f 70 43 61 63 68  ize(zBulk)/pCach
3190: 65 2d 3e 73 7a 41 6c 6c 6f 63 3b 0a 20 20 20 20  e->szAlloc;.    
31a0: 64 6f 7b 0a 20 20 20 20 20 20 50 67 48 64 72 31  do{.      PgHdr1
31b0: 20 2a 70 58 20 3d 20 28 50 67 48 64 72 31 2a 29   *pX = (PgHdr1*)
31c0: 26 7a 42 75 6c 6b 5b 70 43 61 63 68 65 2d 3e 73  &zBulk[pCache->s
31d0: 7a 50 61 67 65 5d 3b 0a 20 20 20 20 20 20 70 58  zPage];.      pX
31e0: 2d 3e 70 61 67 65 2e 70 42 75 66 20 3d 20 7a 42  ->page.pBuf = zB
31f0: 75 6c 6b 3b 0a 20 20 20 20 20 20 70 58 2d 3e 70  ulk;.      pX->p
3200: 61 67 65 2e 70 45 78 74 72 61 20 3d 20 26 70 58  age.pExtra = &pX
3210: 5b 31 5d 3b 0a 20 20 20 20 20 20 70 58 2d 3e 69  [1];.      pX->i
3220: 73 42 75 6c 6b 4c 6f 63 61 6c 20 3d 20 31 3b 0a  sBulkLocal = 1;.
3230: 20 20 20 20 20 20 70 58 2d 3e 69 73 41 6e 63 68        pX->isAnch
3240: 6f 72 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 58  or = 0;.      pX
3250: 2d 3e 70 4e 65 78 74 20 3d 20 70 43 61 63 68 65  ->pNext = pCache
3260: 2d 3e 70 46 72 65 65 3b 0a 20 20 20 20 20 20 70  ->pFree;.      p
3270: 43 61 63 68 65 2d 3e 70 46 72 65 65 20 3d 20 70  Cache->pFree = p
3280: 58 3b 0a 20 20 20 20 20 20 7a 42 75 6c 6b 20 2b  X;.      zBulk +
3290: 3d 20 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f  = pCache->szAllo
32a0: 63 3b 0a 20 20 20 20 7d 77 68 69 6c 65 28 20 2d  c;.    }while( -
32b0: 2d 6e 42 75 6c 6b 20 29 3b 0a 20 20 7d 0a 20 20  -nBulk );.  }.  
32c0: 72 65 74 75 72 6e 20 70 43 61 63 68 65 2d 3e 70  return pCache->p
32d0: 46 72 65 65 21 3d 30 3b 0a 7d 0a 0a 2f 2a 0a 2a  Free!=0;.}../*.*
32e0: 2a 20 4d 61 6c 6c 6f 63 20 66 75 6e 63 74 69 6f  * Malloc functio
32f0: 6e 20 75 73 65 64 20 77 69 74 68 69 6e 20 74 68  n used within th
3300: 69 73 20 66 69 6c 65 20 74 6f 20 61 6c 6c 6f 63  is file to alloc
3310: 61 74 65 20 73 70 61 63 65 20 66 72 6f 6d 20 74  ate space from t
3320: 68 65 20 62 75 66 66 65 72 0a 2a 2a 20 63 6f 6e  he buffer.** con
3330: 66 69 67 75 72 65 64 20 75 73 69 6e 67 20 73 71  figured using sq
3340: 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c  lite3_config(SQL
3350: 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43  ITE_CONFIG_PAGEC
3360: 41 43 48 45 29 20 6f 70 74 69 6f 6e 2e 20 49 66  ACHE) option. If
3370: 20 6e 6f 20 0a 2a 2a 20 73 75 63 68 20 62 75 66   no .** such buf
3380: 66 65 72 20 65 78 69 73 74 73 20 6f 72 20 74 68  fer exists or th
3390: 65 72 65 20 69 73 20 6e 6f 20 73 70 61 63 65 20  ere is no space 
33a0: 6c 65 66 74 20 69 6e 20 69 74 2c 20 74 68 69 73  left in it, this
33b0: 20 66 75 6e 63 74 69 6f 6e 20 66 61 6c 6c 73 20   function falls 
33c0: 0a 2a 2a 20 62 61 63 6b 20 74 6f 20 73 71 6c 69  .** back to sqli
33d0: 74 65 33 4d 61 6c 6c 6f 63 28 29 2e 0a 2a 2a 0a  te3Malloc()..**.
33e0: 2a 2a 20 4d 75 6c 74 69 70 6c 65 20 74 68 72 65  ** Multiple thre
33f0: 61 64 73 20 63 61 6e 20 72 75 6e 20 74 68 69 73  ads can run this
3400: 20 72 6f 75 74 69 6e 65 20 61 74 20 74 68 65 20   routine at the 
3410: 73 61 6d 65 20 74 69 6d 65 2e 20 20 47 6c 6f 62  same time.  Glob
3420: 61 6c 20 76 61 72 69 61 62 6c 65 73 0a 2a 2a 20  al variables.** 
3430: 69 6e 20 70 63 61 63 68 65 31 20 6e 65 65 64 20  in pcache1 need 
3440: 74 6f 20 62 65 20 70 72 6f 74 65 63 74 65 64 20  to be protected 
3450: 76 69 61 20 6d 75 74 65 78 2e 0a 2a 2f 0a 73 74  via mutex..*/.st
3460: 61 74 69 63 20 76 6f 69 64 20 2a 70 63 61 63 68  atic void *pcach
3470: 65 31 41 6c 6c 6f 63 28 69 6e 74 20 6e 42 79 74  e1Alloc(int nByt
3480: 65 29 7b 0a 20 20 76 6f 69 64 20 2a 70 20 3d 20  e){.  void *p = 
3490: 30 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c  0;.  assert( sql
34a0: 69 74 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65  ite3_mutex_nothe
34b0: 6c 64 28 70 63 61 63 68 65 31 2e 67 72 70 2e 6d  ld(pcache1.grp.m
34c0: 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 6e  utex) );.  if( n
34d0: 42 79 74 65 3c 3d 70 63 61 63 68 65 31 2e 73 7a  Byte<=pcache1.sz
34e0: 53 6c 6f 74 20 29 7b 0a 20 20 20 20 73 71 6c 69  Slot ){.    sqli
34f0: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28  te3_mutex_enter(
3500: 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a  pcache1.mutex);.
3510: 20 20 20 20 70 20 3d 20 28 50 67 48 64 72 31 20      p = (PgHdr1 
3520: 2a 29 70 63 61 63 68 65 31 2e 70 46 72 65 65 3b  *)pcache1.pFree;
3530: 0a 20 20 20 20 69 66 28 20 70 20 29 7b 0a 20 20  .    if( p ){.  
3540: 20 20 20 20 70 63 61 63 68 65 31 2e 70 46 72 65      pcache1.pFre
3550: 65 20 3d 20 70 63 61 63 68 65 31 2e 70 46 72 65  e = pcache1.pFre
3560: 65 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20  e->pNext;.      
3570: 70 63 61 63 68 65 31 2e 6e 46 72 65 65 53 6c 6f  pcache1.nFreeSlo
3580: 74 2d 2d 3b 0a 20 20 20 20 20 20 70 63 61 63 68  t--;.      pcach
3590: 65 31 2e 62 55 6e 64 65 72 50 72 65 73 73 75 72  e1.bUnderPressur
35a0: 65 20 3d 20 70 63 61 63 68 65 31 2e 6e 46 72 65  e = pcache1.nFre
35b0: 65 53 6c 6f 74 3c 70 63 61 63 68 65 31 2e 6e 52  eSlot<pcache1.nR
35c0: 65 73 65 72 76 65 3b 0a 20 20 20 20 20 20 61 73  eserve;.      as
35d0: 73 65 72 74 28 20 70 63 61 63 68 65 31 2e 6e 46  sert( pcache1.nF
35e0: 72 65 65 53 6c 6f 74 3e 3d 30 20 29 3b 0a 20 20  reeSlot>=0 );.  
35f0: 20 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75      sqlite3Statu
3600: 73 48 69 67 68 77 61 74 65 72 28 53 51 4c 49 54  sHighwater(SQLIT
3610: 45 5f 53 54 41 54 55 53 5f 50 41 47 45 43 41 43  E_STATUS_PAGECAC
3620: 48 45 5f 53 49 5a 45 2c 20 6e 42 79 74 65 29 3b  HE_SIZE, nByte);
3630: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 53 74  .      sqlite3St
3640: 61 74 75 73 55 70 28 53 51 4c 49 54 45 5f 53 54  atusUp(SQLITE_ST
3650: 41 54 55 53 5f 50 41 47 45 43 41 43 48 45 5f 55  ATUS_PAGECACHE_U
3660: 53 45 44 2c 20 31 29 3b 0a 20 20 20 20 7d 0a 20  SED, 1);.    }. 
3670: 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78     sqlite3_mutex
3680: 5f 6c 65 61 76 65 28 70 63 61 63 68 65 31 2e 6d  _leave(pcache1.m
3690: 75 74 65 78 29 3b 0a 20 20 7d 0a 20 20 69 66 28  utex);.  }.  if(
36a0: 20 70 3d 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 20   p==0 ){.    /* 
36b0: 4d 65 6d 6f 72 79 20 69 73 20 6e 6f 74 20 61 76  Memory is not av
36c0: 61 69 6c 61 62 6c 65 20 69 6e 20 74 68 65 20 53  ailable in the S
36d0: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47  QLITE_CONFIG_PAG
36e0: 45 43 41 43 48 45 20 70 6f 6f 6c 2e 20 20 47 65  ECACHE pool.  Ge
36f0: 74 0a 20 20 20 20 2a 2a 20 69 74 20 66 72 6f 6d  t.    ** it from
3700: 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 20 69   sqlite3Malloc i
3710: 6e 73 74 65 61 64 2e 0a 20 20 20 20 2a 2f 0a 20  nstead..    */. 
3720: 20 20 20 70 20 3d 20 73 71 6c 69 74 65 33 4d 61     p = sqlite3Ma
3730: 6c 6c 6f 63 28 6e 42 79 74 65 29 3b 0a 23 69 66  lloc(nByte);.#if
3740: 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 49 53 41  ndef SQLITE_DISA
3750: 42 4c 45 5f 50 41 47 45 43 41 43 48 45 5f 4f 56  BLE_PAGECACHE_OV
3760: 45 52 46 4c 4f 57 5f 53 54 41 54 53 0a 20 20 20  ERFLOW_STATS.   
3770: 20 69 66 28 20 70 20 29 7b 0a 20 20 20 20 20 20   if( p ){.      
3780: 69 6e 74 20 73 7a 20 3d 20 73 71 6c 69 74 65 33  int sz = sqlite3
3790: 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 29 3b 0a 20  MallocSize(p);. 
37a0: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74       sqlite3_mut
37b0: 65 78 5f 65 6e 74 65 72 28 70 63 61 63 68 65 31  ex_enter(pcache1
37c0: 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 20 20 73  .mutex);.      s
37d0: 71 6c 69 74 65 33 53 74 61 74 75 73 48 69 67 68  qlite3StatusHigh
37e0: 77 61 74 65 72 28 53 51 4c 49 54 45 5f 53 54 41  water(SQLITE_STA
37f0: 54 55 53 5f 50 41 47 45 43 41 43 48 45 5f 53 49  TUS_PAGECACHE_SI
3800: 5a 45 2c 20 6e 42 79 74 65 29 3b 0a 20 20 20 20  ZE, nByte);.    
3810: 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 55    sqlite3StatusU
3820: 70 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f  p(SQLITE_STATUS_
3830: 50 41 47 45 43 41 43 48 45 5f 4f 56 45 52 46 4c  PAGECACHE_OVERFL
3840: 4f 57 2c 20 73 7a 29 3b 0a 20 20 20 20 20 20 73  OW, sz);.      s
3850: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
3860: 76 65 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78  ve(pcache1.mutex
3870: 29 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a  );.    }.#endif.
3880: 20 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 64 65      sqlite3Memde
3890: 62 75 67 53 65 74 54 79 70 65 28 70 2c 20 4d 45  bugSetType(p, ME
38a0: 4d 54 59 50 45 5f 50 43 41 43 48 45 29 3b 0a 20  MTYPE_PCACHE);. 
38b0: 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d   }.  return p;.}
38c0: 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 6e 20  ../*.** Free an 
38d0: 61 6c 6c 6f 63 61 74 65 64 20 62 75 66 66 65 72  allocated buffer
38e0: 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 70   obtained from p
38f0: 63 61 63 68 65 31 41 6c 6c 6f 63 28 29 2e 0a 2a  cache1Alloc()..*
3900: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63  /.static void pc
3910: 61 63 68 65 31 46 72 65 65 28 76 6f 69 64 20 2a  ache1Free(void *
3920: 70 29 7b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29  p){.  if( p==0 )
3930: 20 72 65 74 75 72 6e 3b 0a 20 20 69 66 28 20 53   return;.  if( S
3940: 51 4c 49 54 45 5f 57 49 54 48 49 4e 28 70 2c 20  QLITE_WITHIN(p, 
3950: 70 63 61 63 68 65 31 2e 70 53 74 61 72 74 2c 20  pcache1.pStart, 
3960: 70 63 61 63 68 65 31 2e 70 45 6e 64 29 20 29 7b  pcache1.pEnd) ){
3970: 0a 20 20 20 20 50 67 46 72 65 65 73 6c 6f 74 20  .    PgFreeslot 
3980: 2a 70 53 6c 6f 74 3b 0a 20 20 20 20 73 71 6c 69  *pSlot;.    sqli
3990: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28  te3_mutex_enter(
39a0: 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a  pcache1.mutex);.
39b0: 20 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75      sqlite3Statu
39c0: 73 44 6f 77 6e 28 53 51 4c 49 54 45 5f 53 54 41  sDown(SQLITE_STA
39d0: 54 55 53 5f 50 41 47 45 43 41 43 48 45 5f 55 53  TUS_PAGECACHE_US
39e0: 45 44 2c 20 31 29 3b 0a 20 20 20 20 70 53 6c 6f  ED, 1);.    pSlo
39f0: 74 20 3d 20 28 50 67 46 72 65 65 73 6c 6f 74 2a  t = (PgFreeslot*
3a00: 29 70 3b 0a 20 20 20 20 70 53 6c 6f 74 2d 3e 70  )p;.    pSlot->p
3a10: 4e 65 78 74 20 3d 20 70 63 61 63 68 65 31 2e 70  Next = pcache1.p
3a20: 46 72 65 65 3b 0a 20 20 20 20 70 63 61 63 68 65  Free;.    pcache
3a30: 31 2e 70 46 72 65 65 20 3d 20 70 53 6c 6f 74 3b  1.pFree = pSlot;
3a40: 0a 20 20 20 20 70 63 61 63 68 65 31 2e 6e 46 72  .    pcache1.nFr
3a50: 65 65 53 6c 6f 74 2b 2b 3b 0a 20 20 20 20 70 63  eeSlot++;.    pc
3a60: 61 63 68 65 31 2e 62 55 6e 64 65 72 50 72 65 73  ache1.bUnderPres
3a70: 73 75 72 65 20 3d 20 70 63 61 63 68 65 31 2e 6e  sure = pcache1.n
3a80: 46 72 65 65 53 6c 6f 74 3c 70 63 61 63 68 65 31  FreeSlot<pcache1
3a90: 2e 6e 52 65 73 65 72 76 65 3b 0a 20 20 20 20 61  .nReserve;.    a
3aa0: 73 73 65 72 74 28 20 70 63 61 63 68 65 31 2e 6e  ssert( pcache1.n
3ab0: 46 72 65 65 53 6c 6f 74 3c 3d 70 63 61 63 68 65  FreeSlot<=pcache
3ac0: 31 2e 6e 53 6c 6f 74 20 29 3b 0a 20 20 20 20 73  1.nSlot );.    s
3ad0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
3ae0: 76 65 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78  ve(pcache1.mutex
3af0: 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  );.  }else{.    
3b00: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d  assert( sqlite3M
3b10: 65 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 70  emdebugHasType(p
3b20: 2c 20 4d 45 4d 54 59 50 45 5f 50 43 41 43 48 45  , MEMTYPE_PCACHE
3b30: 29 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  ) );.    sqlite3
3b40: 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 28  MemdebugSetType(
3b50: 70 2c 20 4d 45 4d 54 59 50 45 5f 48 45 41 50 29  p, MEMTYPE_HEAP)
3b60: 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45  ;.#ifndef SQLITE
3b70: 5f 44 49 53 41 42 4c 45 5f 50 41 47 45 43 41 43  _DISABLE_PAGECAC
3b80: 48 45 5f 4f 56 45 52 46 4c 4f 57 5f 53 54 41 54  HE_OVERFLOW_STAT
3b90: 53 0a 20 20 20 20 7b 0a 20 20 20 20 20 20 69 6e  S.    {.      in
3ba0: 74 20 6e 46 72 65 65 64 20 3d 20 30 3b 0a 20 20  t nFreed = 0;.  
3bb0: 20 20 20 20 6e 46 72 65 65 64 20 3d 20 73 71 6c      nFreed = sql
3bc0: 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70  ite3MallocSize(p
3bd0: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  );.      sqlite3
3be0: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 63 61  _mutex_enter(pca
3bf0: 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20 20  che1.mutex);.   
3c00: 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73     sqlite3Status
3c10: 44 6f 77 6e 28 53 51 4c 49 54 45 5f 53 54 41 54  Down(SQLITE_STAT
3c20: 55 53 5f 50 41 47 45 43 41 43 48 45 5f 4f 56 45  US_PAGECACHE_OVE
3c30: 52 46 4c 4f 57 2c 20 6e 46 72 65 65 64 29 3b 0a  RFLOW, nFreed);.
3c40: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75        sqlite3_mu
3c50: 74 65 78 5f 6c 65 61 76 65 28 70 63 61 63 68 65  tex_leave(pcache
3c60: 31 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 7d 0a  1.mutex);.    }.
3c70: 23 65 6e 64 69 66 0a 20 20 20 20 73 71 6c 69 74  #endif.    sqlit
3c80: 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 7d 0a  e3_free(p);.  }.
3c90: 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  }..#ifdef SQLITE
3ca0: 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d  _ENABLE_MEMORY_M
3cb0: 41 4e 41 47 45 4d 45 4e 54 0a 2f 2a 0a 2a 2a 20  ANAGEMENT./*.** 
3cc0: 52 65 74 75 72 6e 20 74 68 65 20 73 69 7a 65 20  Return the size 
3cd0: 6f 66 20 61 20 70 63 61 63 68 65 20 61 6c 6c 6f  of a pcache allo
3ce0: 63 61 74 69 6f 6e 0a 2a 2f 0a 73 74 61 74 69 63  cation.*/.static
3cf0: 20 69 6e 74 20 70 63 61 63 68 65 31 4d 65 6d 53   int pcache1MemS
3d00: 69 7a 65 28 76 6f 69 64 20 2a 70 29 7b 0a 20 20  ize(void *p){.  
3d10: 69 66 28 20 70 3e 3d 70 63 61 63 68 65 31 2e 70  if( p>=pcache1.p
3d20: 53 74 61 72 74 20 26 26 20 70 3c 70 63 61 63 68  Start && p<pcach
3d30: 65 31 2e 70 45 6e 64 20 29 7b 0a 20 20 20 20 72  e1.pEnd ){.    r
3d40: 65 74 75 72 6e 20 70 63 61 63 68 65 31 2e 73 7a  eturn pcache1.sz
3d50: 53 6c 6f 74 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  Slot;.  }else{. 
3d60: 20 20 20 69 6e 74 20 69 53 69 7a 65 3b 0a 20 20     int iSize;.  
3d70: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
3d80: 33 4d 65 6d 64 65 62 75 67 48 61 73 54 79 70 65  3MemdebugHasType
3d90: 28 70 2c 20 4d 45 4d 54 59 50 45 5f 50 43 41 43  (p, MEMTYPE_PCAC
3da0: 48 45 29 20 29 3b 0a 20 20 20 20 73 71 6c 69 74  HE) );.    sqlit
3db0: 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70  e3MemdebugSetTyp
3dc0: 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 48 45 41  e(p, MEMTYPE_HEA
3dd0: 50 29 3b 0a 20 20 20 20 69 53 69 7a 65 20 3d 20  P);.    iSize = 
3de0: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a  sqlite3MallocSiz
3df0: 65 28 70 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  e(p);.    sqlite
3e00: 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65  3MemdebugSetType
3e10: 28 70 2c 20 4d 45 4d 54 59 50 45 5f 50 43 41 43  (p, MEMTYPE_PCAC
3e20: 48 45 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20  HE);.    return 
3e30: 69 53 69 7a 65 3b 0a 20 20 7d 0a 7d 0a 23 65 6e  iSize;.  }.}.#en
3e40: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e  dif /* SQLITE_EN
3e50: 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41  ABLE_MEMORY_MANA
3e60: 47 45 4d 45 4e 54 20 2a 2f 0a 0a 2f 2a 0a 2a 2a  GEMENT */../*.**
3e70: 20 41 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20   Allocate a new 
3e80: 70 61 67 65 20 6f 62 6a 65 63 74 20 69 6e 69 74  page object init
3e90: 69 61 6c 6c 79 20 61 73 73 6f 63 69 61 74 65 64  ially associated
3ea0: 20 77 69 74 68 20 63 61 63 68 65 20 70 43 61 63   with cache pCac
3eb0: 68 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67  he..*/.static Pg
3ec0: 48 64 72 31 20 2a 70 63 61 63 68 65 31 41 6c 6c  Hdr1 *pcache1All
3ed0: 6f 63 50 61 67 65 28 50 43 61 63 68 65 31 20 2a  ocPage(PCache1 *
3ee0: 70 43 61 63 68 65 2c 20 69 6e 74 20 62 65 6e 69  pCache, int beni
3ef0: 67 6e 4d 61 6c 6c 6f 63 29 7b 0a 20 20 50 67 48  gnMalloc){.  PgH
3f00: 64 72 31 20 2a 70 20 3d 20 30 3b 0a 20 20 76 6f  dr1 *p = 0;.  vo
3f10: 69 64 20 2a 70 50 67 3b 0a 0a 20 20 61 73 73 65  id *pPg;..  asse
3f20: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  rt( sqlite3_mute
3f30: 78 5f 68 65 6c 64 28 70 43 61 63 68 65 2d 3e 70  x_held(pCache->p
3f40: 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b  Group->mutex) );
3f50: 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e 70  .  if( pCache->p
3f60: 46 72 65 65 20 7c 7c 20 28 70 43 61 63 68 65 2d  Free || (pCache-
3f70: 3e 6e 50 61 67 65 3d 3d 30 20 26 26 20 70 63 61  >nPage==0 && pca
3f80: 63 68 65 31 49 6e 69 74 42 75 6c 6b 28 70 43 61  che1InitBulk(pCa
3f90: 63 68 65 29 29 20 29 7b 0a 20 20 20 20 70 20 3d  che)) ){.    p =
3fa0: 20 70 43 61 63 68 65 2d 3e 70 46 72 65 65 3b 0a   pCache->pFree;.
3fb0: 20 20 20 20 70 43 61 63 68 65 2d 3e 70 46 72 65      pCache->pFre
3fc0: 65 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20  e = p->pNext;.  
3fd0: 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20 30 3b 0a    p->pNext = 0;.
3fe0: 20 20 7d 65 6c 73 65 7b 0a 23 69 66 64 65 66 20    }else{.#ifdef 
3ff0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45  SQLITE_ENABLE_ME
4000: 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a  MORY_MANAGEMENT.
4010: 20 20 20 20 2f 2a 20 54 68 65 20 67 72 6f 75 70      /* The group
4020: 20 6d 75 74 65 78 20 6d 75 73 74 20 62 65 20 72   mutex must be r
4030: 65 6c 65 61 73 65 64 20 62 65 66 6f 72 65 20 70  eleased before p
4040: 63 61 63 68 65 31 41 6c 6c 6f 63 28 29 20 69 73  cache1Alloc() is
4050: 20 63 61 6c 6c 65 64 2e 20 54 68 69 73 0a 20 20   called. This.  
4060: 20 20 2a 2a 20 69 73 20 62 65 63 61 75 73 65 20    ** is because 
4070: 69 74 20 6d 69 67 68 74 20 63 61 6c 6c 20 73 71  it might call sq
4080: 6c 69 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65  lite3_release_me
4090: 6d 6f 72 79 28 29 2c 20 77 68 69 63 68 20 61 73  mory(), which as
40a0: 73 75 6d 65 73 20 74 68 61 74 20 0a 20 20 20 20  sumes that .    
40b0: 2a 2a 20 74 68 69 73 20 6d 75 74 65 78 20 69 73  ** this mutex is
40c0: 20 6e 6f 74 20 68 65 6c 64 2e 20 2a 2f 0a 20 20   not held. */.  
40d0: 20 20 61 73 73 65 72 74 28 20 70 63 61 63 68 65    assert( pcache
40e0: 31 2e 73 65 70 61 72 61 74 65 43 61 63 68 65 3d  1.separateCache=
40f0: 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74  =0 );.    assert
4100: 28 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70  ( pCache->pGroup
4110: 3d 3d 26 70 63 61 63 68 65 31 2e 67 72 70 20 29  ==&pcache1.grp )
4120: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 4c 65 61  ;.    pcache1Lea
4130: 76 65 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e  veMutex(pCache->
4140: 70 47 72 6f 75 70 29 3b 0a 23 65 6e 64 69 66 0a  pGroup);.#endif.
4150: 20 20 20 20 69 66 28 20 62 65 6e 69 67 6e 4d 61      if( benignMa
4160: 6c 6c 6f 63 20 29 7b 20 73 71 6c 69 74 65 33 42  lloc ){ sqlite3B
4170: 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63  eginBenignMalloc
4180: 28 29 3b 20 7d 0a 23 69 66 64 65 66 20 53 51 4c  (); }.#ifdef SQL
4190: 49 54 45 5f 50 43 41 43 48 45 5f 53 45 50 41 52  ITE_PCACHE_SEPAR
41a0: 41 54 45 5f 48 45 41 44 45 52 0a 20 20 20 20 70  ATE_HEADER.    p
41b0: 50 67 20 3d 20 70 63 61 63 68 65 31 41 6c 6c 6f  Pg = pcache1Allo
41c0: 63 28 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65  c(pCache->szPage
41d0: 29 3b 0a 20 20 20 20 70 20 3d 20 73 71 6c 69 74  );.    p = sqlit
41e0: 65 33 4d 61 6c 6c 6f 63 28 73 69 7a 65 6f 66 28  e3Malloc(sizeof(
41f0: 50 67 48 64 72 31 29 20 2b 20 70 43 61 63 68 65  PgHdr1) + pCache
4200: 2d 3e 73 7a 45 78 74 72 61 29 3b 0a 20 20 20 20  ->szExtra);.    
4210: 69 66 28 20 21 70 50 67 20 7c 7c 20 21 70 20 29  if( !pPg || !p )
4220: 7b 0a 20 20 20 20 20 20 70 63 61 63 68 65 31 46  {.      pcache1F
4230: 72 65 65 28 70 50 67 29 3b 0a 20 20 20 20 20 20  ree(pPg);.      
4240: 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b  sqlite3_free(p);
4250: 0a 20 20 20 20 20 20 70 50 67 20 3d 20 30 3b 0a  .      pPg = 0;.
4260: 20 20 20 20 7d 0a 23 65 6c 73 65 0a 20 20 20 20      }.#else.    
4270: 70 50 67 20 3d 20 70 63 61 63 68 65 31 41 6c 6c  pPg = pcache1All
4280: 6f 63 28 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c  oc(pCache->szAll
4290: 6f 63 29 3b 0a 20 20 20 20 70 20 3d 20 28 50 67  oc);.    p = (Pg
42a0: 48 64 72 31 20 2a 29 26 28 28 75 38 20 2a 29 70  Hdr1 *)&((u8 *)p
42b0: 50 67 29 5b 70 43 61 63 68 65 2d 3e 73 7a 50 61  Pg)[pCache->szPa
42c0: 67 65 5d 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20  ge];.#endif.    
42d0: 69 66 28 20 62 65 6e 69 67 6e 4d 61 6c 6c 6f 63  if( benignMalloc
42e0: 20 29 7b 20 73 71 6c 69 74 65 33 45 6e 64 42 65   ){ sqlite3EndBe
42f0: 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 20 7d 0a  nignMalloc(); }.
4300: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e  #ifdef SQLITE_EN
4310: 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41  ABLE_MEMORY_MANA
4320: 47 45 4d 45 4e 54 0a 20 20 20 20 70 63 61 63 68  GEMENT.    pcach
4330: 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70 43 61  e1EnterMutex(pCa
4340: 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 23 65  che->pGroup);.#e
4350: 6e 64 69 66 0a 20 20 20 20 69 66 28 20 70 50 67  ndif.    if( pPg
4360: 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a  ==0 ) return 0;.
4370: 20 20 20 20 70 2d 3e 70 61 67 65 2e 70 42 75 66      p->page.pBuf
4380: 20 3d 20 70 50 67 3b 0a 20 20 20 20 70 2d 3e 70   = pPg;.    p->p
4390: 61 67 65 2e 70 45 78 74 72 61 20 3d 20 26 70 5b  age.pExtra = &p[
43a0: 31 5d 3b 0a 20 20 20 20 70 2d 3e 69 73 42 75 6c  1];.    p->isBul
43b0: 6b 4c 6f 63 61 6c 20 3d 20 30 3b 0a 20 20 20 20  kLocal = 0;.    
43c0: 70 2d 3e 69 73 41 6e 63 68 6f 72 20 3d 20 30 3b  p->isAnchor = 0;
43d0: 0a 20 20 7d 0a 20 20 69 66 28 20 70 43 61 63 68  .  }.  if( pCach
43e0: 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 29 7b  e->bPurgeable ){
43f0: 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 70 47 72  .    pCache->pGr
4400: 6f 75 70 2d 3e 6e 43 75 72 72 65 6e 74 50 61 67  oup->nCurrentPag
4410: 65 2b 2b 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72  e++;.  }.  retur
4420: 6e 20 70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72  n p;.}../*.** Fr
4430: 65 65 20 61 20 70 61 67 65 20 6f 62 6a 65 63 74  ee a page object
4440: 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 20 70 63   allocated by pc
4450: 61 63 68 65 31 41 6c 6c 6f 63 50 61 67 65 28 29  ache1AllocPage()
4460: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
4470: 20 70 63 61 63 68 65 31 46 72 65 65 50 61 67 65   pcache1FreePage
4480: 28 50 67 48 64 72 31 20 2a 70 29 7b 0a 20 20 50  (PgHdr1 *p){.  P
4490: 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 3b 0a  Cache1 *pCache;.
44a0: 20 20 61 73 73 65 72 74 28 20 70 21 3d 30 20 29    assert( p!=0 )
44b0: 3b 0a 20 20 70 43 61 63 68 65 20 3d 20 70 2d 3e  ;.  pCache = p->
44c0: 70 43 61 63 68 65 3b 0a 20 20 61 73 73 65 72 74  pCache;.  assert
44d0: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
44e0: 68 65 6c 64 28 70 2d 3e 70 43 61 63 68 65 2d 3e  held(p->pCache->
44f0: 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29  pGroup->mutex) )
4500: 3b 0a 20 20 69 66 28 20 70 2d 3e 69 73 42 75 6c  ;.  if( p->isBul
4510: 6b 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 70 2d  kLocal ){.    p-
4520: 3e 70 4e 65 78 74 20 3d 20 70 43 61 63 68 65 2d  >pNext = pCache-
4530: 3e 70 46 72 65 65 3b 0a 20 20 20 20 70 43 61 63  >pFree;.    pCac
4540: 68 65 2d 3e 70 46 72 65 65 20 3d 20 70 3b 0a 20  he->pFree = p;. 
4550: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 63 61 63   }else{.    pcac
4560: 68 65 31 46 72 65 65 28 70 2d 3e 70 61 67 65 2e  he1Free(p->page.
4570: 70 42 75 66 29 3b 0a 23 69 66 64 65 66 20 53 51  pBuf);.#ifdef SQ
4580: 4c 49 54 45 5f 50 43 41 43 48 45 5f 53 45 50 41  LITE_PCACHE_SEPA
4590: 52 41 54 45 5f 48 45 41 44 45 52 0a 20 20 20 20  RATE_HEADER.    
45a0: 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b  sqlite3_free(p);
45b0: 0a 23 65 6e 64 69 66 0a 20 20 7d 0a 20 20 69 66  .#endif.  }.  if
45c0: 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65  ( pCache->bPurge
45d0: 61 62 6c 65 20 29 7b 0a 20 20 20 20 70 43 61 63  able ){.    pCac
45e0: 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6e 43 75 72  he->pGroup->nCur
45f0: 72 65 6e 74 50 61 67 65 2d 2d 3b 0a 20 20 7d 0a  rentPage--;.  }.
4600: 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6c 6c 6f 63 20  }../*.** Malloc 
4610: 66 75 6e 63 74 69 6f 6e 20 75 73 65 64 20 62 79  function used by
4620: 20 53 51 4c 69 74 65 20 74 6f 20 6f 62 74 61 69   SQLite to obtai
4630: 6e 20 73 70 61 63 65 20 66 72 6f 6d 20 74 68 65  n space from the
4640: 20 62 75 66 66 65 72 20 63 6f 6e 66 69 67 75 72   buffer configur
4650: 65 64 0a 2a 2a 20 75 73 69 6e 67 20 73 71 6c 69  ed.** using sqli
4660: 74 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54  te3_config(SQLIT
4670: 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43  E_CONFIG_PAGECAC
4680: 48 45 29 20 6f 70 74 69 6f 6e 2e 20 49 66 20 6e  HE) option. If n
4690: 6f 20 73 75 63 68 20 62 75 66 66 65 72 0a 2a 2a  o such buffer.**
46a0: 20 65 78 69 73 74 73 2c 20 74 68 69 73 20 66 75   exists, this fu
46b0: 6e 63 74 69 6f 6e 20 66 61 6c 6c 73 20 62 61 63  nction falls bac
46c0: 6b 20 74 6f 20 73 71 6c 69 74 65 33 4d 61 6c 6c  k to sqlite3Mall
46d0: 6f 63 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73  oc()..*/.void *s
46e0: 71 6c 69 74 65 33 50 61 67 65 4d 61 6c 6c 6f 63  qlite3PageMalloc
46f0: 28 69 6e 74 20 73 7a 29 7b 0a 20 20 72 65 74 75  (int sz){.  retu
4700: 72 6e 20 70 63 61 63 68 65 31 41 6c 6c 6f 63 28  rn pcache1Alloc(
4710: 73 7a 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72  sz);.}../*.** Fr
4720: 65 65 20 61 6e 20 61 6c 6c 6f 63 61 74 65 64 20  ee an allocated 
4730: 62 75 66 66 65 72 20 6f 62 74 61 69 6e 65 64 20  buffer obtained 
4740: 66 72 6f 6d 20 73 71 6c 69 74 65 33 50 61 67 65  from sqlite3Page
4750: 4d 61 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a 76 6f 69  Malloc()..*/.voi
4760: 64 20 73 71 6c 69 74 65 33 50 61 67 65 46 72 65  d sqlite3PageFre
4770: 65 28 76 6f 69 64 20 2a 70 29 7b 0a 20 20 70 63  e(void *p){.  pc
4780: 61 63 68 65 31 46 72 65 65 28 70 29 3b 0a 7d 0a  ache1Free(p);.}.
4790: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74  ../*.** Return t
47a0: 72 75 65 20 69 66 20 69 74 20 64 65 73 69 72 61  rue if it desira
47b0: 62 6c 65 20 74 6f 20 61 76 6f 69 64 20 61 6c 6c  ble to avoid all
47c0: 6f 63 61 74 69 6e 67 20 61 20 6e 65 77 20 70 61  ocating a new pa
47d0: 67 65 20 63 61 63 68 65 0a 2a 2a 20 65 6e 74 72  ge cache.** entr
47e0: 79 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6d 65 6d 6f  y..**.** If memo
47f0: 72 79 20 77 61 73 20 61 6c 6c 6f 63 61 74 65 64  ry was allocated
4800: 20 73 70 65 63 69 66 69 63 61 6c 6c 79 20 74 6f   specifically to
4810: 20 74 68 65 20 70 61 67 65 20 63 61 63 68 65 20   the page cache 
4820: 75 73 69 6e 67 0a 2a 2a 20 53 51 4c 49 54 45 5f  using.** SQLITE_
4830: 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45  CONFIG_PAGECACHE
4840: 20 62 75 74 20 74 68 61 74 20 6d 65 6d 6f 72 79   but that memory
4850: 20 68 61 73 20 61 6c 6c 20 62 65 65 6e 20 75 73   has all been us
4860: 65 64 2c 20 74 68 65 6e 0a 2a 2a 20 69 74 20 69  ed, then.** it i
4870: 73 20 64 65 73 69 72 61 62 6c 65 20 74 6f 20 61  s desirable to a
4880: 76 6f 69 64 20 61 6c 6c 6f 63 61 74 69 6e 67 20  void allocating 
4890: 61 20 6e 65 77 20 70 61 67 65 20 63 61 63 68 65  a new page cache
48a0: 20 65 6e 74 72 79 20 62 65 63 61 75 73 65 0a 2a   entry because.*
48b0: 2a 20 70 72 65 73 75 6d 61 62 6c 79 20 53 51 4c  * presumably SQL
48c0: 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43  ITE_CONFIG_PAGEC
48d0: 41 43 48 45 20 77 61 73 20 73 75 70 70 6f 73 65  ACHE was suppose
48e0: 20 74 6f 20 62 65 20 73 75 66 66 69 63 69 65 6e   to be sufficien
48f0: 74 0a 2a 2a 20 66 6f 72 20 61 6c 6c 20 70 61 67  t.** for all pag
4900: 65 20 63 61 63 68 65 20 6e 65 65 64 73 20 61 6e  e cache needs an
4910: 64 20 77 65 20 73 68 6f 75 6c 64 20 6e 6f 74 20  d we should not 
4920: 6e 65 65 64 20 74 6f 20 73 70 69 6c 6c 20 74 68  need to spill th
4930: 65 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e 20  e.** allocation 
4940: 6f 6e 74 6f 20 74 68 65 20 68 65 61 70 2e 0a 2a  onto the heap..*
4950: 2a 0a 2a 2a 20 4f 72 2c 20 74 68 65 20 68 65 61  *.** Or, the hea
4960: 70 20 69 73 20 75 73 65 64 20 66 6f 72 20 61 6c  p is used for al
4970: 6c 20 70 61 67 65 20 63 61 63 68 65 20 6d 65 6d  l page cache mem
4980: 6f 72 79 20 62 75 74 20 74 68 65 20 68 65 61 70  ory but the heap
4990: 20 69 73 0a 2a 2a 20 75 6e 64 65 72 20 6d 65 6d   is.** under mem
49a0: 6f 72 79 20 70 72 65 73 73 75 72 65 2c 20 74 68  ory pressure, th
49b0: 65 6e 20 61 67 61 69 6e 20 69 74 20 69 73 20 64  en again it is d
49c0: 65 73 69 72 61 62 6c 65 20 74 6f 20 61 76 6f 69  esirable to avoi
49d0: 64 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 6e 67 20  d.** allocating 
49e0: 61 20 6e 65 77 20 70 61 67 65 20 63 61 63 68 65  a new page cache
49f0: 20 65 6e 74 72 79 20 69 6e 20 6f 72 64 65 72 20   entry in order 
4a00: 74 6f 20 61 76 6f 69 64 20 73 74 72 65 73 73 69  to avoid stressi
4a10: 6e 67 0a 2a 2a 20 74 68 65 20 68 65 61 70 20 65  ng.** the heap e
4a20: 76 65 6e 20 66 75 72 74 68 65 72 2e 0a 2a 2f 0a  ven further..*/.
4a30: 73 74 61 74 69 63 20 69 6e 74 20 70 63 61 63 68  static int pcach
4a40: 65 31 55 6e 64 65 72 4d 65 6d 6f 72 79 50 72 65  e1UnderMemoryPre
4a50: 73 73 75 72 65 28 50 43 61 63 68 65 31 20 2a 70  ssure(PCache1 *p
4a60: 43 61 63 68 65 29 7b 0a 20 20 69 66 28 20 70 63  Cache){.  if( pc
4a70: 61 63 68 65 31 2e 6e 53 6c 6f 74 20 26 26 20 28  ache1.nSlot && (
4a80: 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 2b 70  pCache->szPage+p
4a90: 43 61 63 68 65 2d 3e 73 7a 45 78 74 72 61 29 3c  Cache->szExtra)<
4aa0: 3d 70 63 61 63 68 65 31 2e 73 7a 53 6c 6f 74 20  =pcache1.szSlot 
4ab0: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 70 63  ){.    return pc
4ac0: 61 63 68 65 31 2e 62 55 6e 64 65 72 50 72 65 73  ache1.bUnderPres
4ad0: 73 75 72 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  sure;.  }else{. 
4ae0: 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65     return sqlite
4af0: 33 48 65 61 70 4e 65 61 72 6c 79 46 75 6c 6c 28  3HeapNearlyFull(
4b00: 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a  );.  }.}../*****
4b10: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4b20: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4b30: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4b40: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4b50: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 2f 2a 2a 2a 2a  *********/./****
4b60: 2a 2a 2a 2a 20 47 65 6e 65 72 61 6c 20 49 6d 70  **** General Imp
4b70: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 46 75 6e 63  lementation Func
4b80: 74 69 6f 6e 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  tions **********
4b90: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4ba0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 0a  **********/../*.
4bb0: 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e  ** This function
4bc0: 20 69 73 20 75 73 65 64 20 74 6f 20 72 65 73 69   is used to resi
4bd0: 7a 65 20 74 68 65 20 68 61 73 68 20 74 61 62 6c  ze the hash tabl
4be0: 65 20 75 73 65 64 20 62 79 20 74 68 65 20 63 61  e used by the ca
4bf0: 63 68 65 20 70 61 73 73 65 64 0a 2a 2a 20 61 73  che passed.** as
4c00: 20 74 68 65 20 66 69 72 73 74 20 61 72 67 75 6d   the first argum
4c10: 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50  ent..**.** The P
4c20: 43 61 63 68 65 20 6d 75 74 65 78 20 6d 75 73 74  Cache mutex must
4c30: 20 62 65 20 68 65 6c 64 20 77 68 65 6e 20 74 68   be held when th
4c40: 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63  is function is c
4c50: 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63  alled..*/.static
4c60: 20 76 6f 69 64 20 70 63 61 63 68 65 31 52 65 73   void pcache1Res
4c70: 69 7a 65 48 61 73 68 28 50 43 61 63 68 65 31 20  izeHash(PCache1 
4c80: 2a 70 29 7b 0a 20 20 50 67 48 64 72 31 20 2a 2a  *p){.  PgHdr1 **
4c90: 61 70 4e 65 77 3b 0a 20 20 75 6e 73 69 67 6e 65  apNew;.  unsigne
4ca0: 64 20 69 6e 74 20 6e 4e 65 77 3b 0a 20 20 75 6e  d int nNew;.  un
4cb0: 73 69 67 6e 65 64 20 69 6e 74 20 69 3b 0a 0a 20  signed int i;.. 
4cc0: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
4cd0: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 70  _mutex_held(p->p
4ce0: 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b  Group->mutex) );
4cf0: 0a 0a 20 20 6e 4e 65 77 20 3d 20 70 2d 3e 6e 48  ..  nNew = p->nH
4d00: 61 73 68 2a 32 3b 0a 20 20 69 66 28 20 6e 4e 65  ash*2;.  if( nNe
4d10: 77 3c 32 35 36 20 29 7b 0a 20 20 20 20 6e 4e 65  w<256 ){.    nNe
4d20: 77 20 3d 20 32 35 36 3b 0a 20 20 7d 0a 0a 20 20  w = 256;.  }..  
4d30: 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65  pcache1LeaveMute
4d40: 78 28 70 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20  x(p->pGroup);.  
4d50: 69 66 28 20 70 2d 3e 6e 48 61 73 68 20 29 7b 20  if( p->nHash ){ 
4d60: 73 71 6c 69 74 65 33 42 65 67 69 6e 42 65 6e 69  sqlite3BeginBeni
4d70: 67 6e 4d 61 6c 6c 6f 63 28 29 3b 20 7d 0a 20 20  gnMalloc(); }.  
4d80: 61 70 4e 65 77 20 3d 20 28 50 67 48 64 72 31 20  apNew = (PgHdr1 
4d90: 2a 2a 29 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63  **)sqlite3Malloc
4da0: 5a 65 72 6f 28 73 69 7a 65 6f 66 28 50 67 48 64  Zero(sizeof(PgHd
4db0: 72 31 20 2a 29 2a 6e 4e 65 77 29 3b 0a 20 20 69  r1 *)*nNew);.  i
4dc0: 66 28 20 70 2d 3e 6e 48 61 73 68 20 29 7b 20 73  f( p->nHash ){ s
4dd0: 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d  qlite3EndBenignM
4de0: 61 6c 6c 6f 63 28 29 3b 20 7d 0a 20 20 70 63 61  alloc(); }.  pca
4df0: 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70  che1EnterMutex(p
4e00: 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20 69 66 28  ->pGroup);.  if(
4e10: 20 61 70 4e 65 77 20 29 7b 0a 20 20 20 20 66 6f   apNew ){.    fo
4e20: 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 48 61 73  r(i=0; i<p->nHas
4e30: 68 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 50  h; i++){.      P
4e40: 67 48 64 72 31 20 2a 70 50 61 67 65 3b 0a 20 20  gHdr1 *pPage;.  
4e50: 20 20 20 20 50 67 48 64 72 31 20 2a 70 4e 65 78      PgHdr1 *pNex
4e60: 74 20 3d 20 70 2d 3e 61 70 48 61 73 68 5b 69 5d  t = p->apHash[i]
4e70: 3b 0a 20 20 20 20 20 20 77 68 69 6c 65 28 20 28  ;.      while( (
4e80: 70 50 61 67 65 20 3d 20 70 4e 65 78 74 29 21 3d  pPage = pNext)!=
4e90: 30 20 29 7b 0a 20 20 20 20 20 20 20 20 75 6e 73  0 ){.        uns
4ea0: 69 67 6e 65 64 20 69 6e 74 20 68 20 3d 20 70 50  igned int h = pP
4eb0: 61 67 65 2d 3e 69 4b 65 79 20 25 20 6e 4e 65 77  age->iKey % nNew
4ec0: 3b 0a 20 20 20 20 20 20 20 20 70 4e 65 78 74 20  ;.        pNext 
4ed0: 3d 20 70 50 61 67 65 2d 3e 70 4e 65 78 74 3b 0a  = pPage->pNext;.
4ee0: 20 20 20 20 20 20 20 20 70 50 61 67 65 2d 3e 70          pPage->p
4ef0: 4e 65 78 74 20 3d 20 61 70 4e 65 77 5b 68 5d 3b  Next = apNew[h];
4f00: 0a 20 20 20 20 20 20 20 20 61 70 4e 65 77 5b 68  .        apNew[h
4f10: 5d 20 3d 20 70 50 61 67 65 3b 0a 20 20 20 20 20  ] = pPage;.     
4f20: 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c   }.    }.    sql
4f30: 69 74 65 33 5f 66 72 65 65 28 70 2d 3e 61 70 48  ite3_free(p->apH
4f40: 61 73 68 29 3b 0a 20 20 20 20 70 2d 3e 61 70 48  ash);.    p->apH
4f50: 61 73 68 20 3d 20 61 70 4e 65 77 3b 0a 20 20 20  ash = apNew;.   
4f60: 20 70 2d 3e 6e 48 61 73 68 20 3d 20 6e 4e 65 77   p->nHash = nNew
4f70: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  ;.  }.}../*.** T
4f80: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  his function is 
4f90: 75 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79 20  used internally 
4fa0: 74 6f 20 72 65 6d 6f 76 65 20 74 68 65 20 70 61  to remove the pa
4fb0: 67 65 20 70 50 61 67 65 20 66 72 6f 6d 20 74 68  ge pPage from th
4fc0: 65 20 0a 2a 2a 20 50 47 72 6f 75 70 20 4c 52 55  e .** PGroup LRU
4fd0: 20 6c 69 73 74 2c 20 69 66 20 69 73 20 70 61 72   list, if is par
4fe0: 74 20 6f 66 20 69 74 2e 20 49 66 20 70 50 61 67  t of it. If pPag
4ff0: 65 20 69 73 20 6e 6f 74 20 70 61 72 74 20 6f 66  e is not part of
5000: 20 74 68 65 20 50 47 72 6f 75 70 0a 2a 2a 20 4c   the PGroup.** L
5010: 52 55 20 6c 69 73 74 2c 20 74 68 65 6e 20 74 68  RU list, then th
5020: 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61  is function is a
5030: 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a 2a 2a 20 54 68   no-op..**.** Th
5040: 65 20 50 47 72 6f 75 70 20 6d 75 74 65 78 20 6d  e PGroup mutex m
5050: 75 73 74 20 62 65 20 68 65 6c 64 20 77 68 65 6e  ust be held when
5060: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69   this function i
5070: 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61  s called..*/.sta
5080: 74 69 63 20 50 67 48 64 72 31 20 2a 70 63 61 63  tic PgHdr1 *pcac
5090: 68 65 31 50 69 6e 50 61 67 65 28 50 67 48 64 72  he1PinPage(PgHdr
50a0: 31 20 2a 70 50 61 67 65 29 7b 0a 20 20 50 43 61  1 *pPage){.  PCa
50b0: 63 68 65 31 20 2a 70 43 61 63 68 65 3b 0a 0a 20  che1 *pCache;.. 
50c0: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 21 3d   assert( pPage!=
50d0: 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  0 );.  assert( p
50e0: 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d  Page->isPinned==
50f0: 30 20 29 3b 0a 20 20 70 43 61 63 68 65 20 3d 20  0 );.  pCache = 
5100: 70 50 61 67 65 2d 3e 70 43 61 63 68 65 3b 0a 20  pPage->pCache;. 
5110: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e   assert( pPage->
5120: 70 4c 72 75 4e 65 78 74 20 29 3b 0a 20 20 61 73  pLruNext );.  as
5130: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 4c 72  sert( pPage->pLr
5140: 75 50 72 65 76 20 29 3b 0a 20 20 61 73 73 65 72  uPrev );.  asser
5150: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  t( sqlite3_mutex
5160: 5f 68 65 6c 64 28 70 43 61 63 68 65 2d 3e 70 47  _held(pCache->pG
5170: 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a  roup->mutex) );.
5180: 20 20 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 65    pPage->pLruPre
5190: 76 2d 3e 70 4c 72 75 4e 65 78 74 20 3d 20 70 50  v->pLruNext = pP
51a0: 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74 3b 0a 20  age->pLruNext;. 
51b0: 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74   pPage->pLruNext
51c0: 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20 70 50 61  ->pLruPrev = pPa
51d0: 67 65 2d 3e 70 4c 72 75 50 72 65 76 3b 0a 20 20  ge->pLruPrev;.  
51e0: 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74 20  pPage->pLruNext 
51f0: 3d 20 30 3b 0a 20 20 70 50 61 67 65 2d 3e 70 4c  = 0;.  pPage->pL
5200: 72 75 50 72 65 76 20 3d 20 30 3b 0a 20 20 70 50  ruPrev = 0;.  pP
5210: 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64 20 3d 20  age->isPinned = 
5220: 31 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61  1;.  assert( pPa
5230: 67 65 2d 3e 69 73 41 6e 63 68 6f 72 3d 3d 30 20  ge->isAnchor==0 
5240: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61  );.  assert( pCa
5250: 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6c 72 75  che->pGroup->lru
5260: 2e 69 73 41 6e 63 68 6f 72 3d 3d 31 20 29 3b 0a  .isAnchor==1 );.
5270: 20 20 70 43 61 63 68 65 2d 3e 6e 52 65 63 79 63    pCache->nRecyc
5280: 6c 61 62 6c 65 2d 2d 3b 0a 20 20 72 65 74 75 72  lable--;.  retur
5290: 6e 20 70 50 61 67 65 3b 0a 7d 0a 0a 0a 2f 2a 0a  n pPage;.}.../*.
52a0: 2a 2a 20 52 65 6d 6f 76 65 20 74 68 65 20 70 61  ** Remove the pa
52b0: 67 65 20 73 75 70 70 6c 69 65 64 20 61 73 20 61  ge supplied as a
52c0: 6e 20 61 72 67 75 6d 65 6e 74 20 66 72 6f 6d 20  n argument from 
52d0: 74 68 65 20 68 61 73 68 20 74 61 62 6c 65 20 0a  the hash table .
52e0: 2a 2a 20 28 50 43 61 63 68 65 31 2e 61 70 48 61  ** (PCache1.apHa
52f0: 73 68 20 73 74 72 75 63 74 75 72 65 29 20 74 68  sh structure) th
5300: 61 74 20 69 74 20 69 73 20 63 75 72 72 65 6e 74  at it is current
5310: 6c 79 20 73 74 6f 72 65 64 20 69 6e 2e 0a 2a 2a  ly stored in..**
5320: 20 41 6c 73 6f 20 66 72 65 65 20 74 68 65 20 70   Also free the p
5330: 61 67 65 20 69 66 20 66 72 65 65 50 61 67 65 20  age if freePage 
5340: 69 73 20 74 72 75 65 2e 0a 2a 2a 0a 2a 2a 20 54  is true..**.** T
5350: 68 65 20 50 47 72 6f 75 70 20 6d 75 74 65 78 20  he PGroup mutex 
5360: 6d 75 73 74 20 62 65 20 68 65 6c 64 20 77 68 65  must be held whe
5370: 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  n this function 
5380: 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74  is called..*/.st
5390: 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65  atic void pcache
53a0: 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73 68 28  1RemoveFromHash(
53b0: 50 67 48 64 72 31 20 2a 70 50 61 67 65 2c 20 69  PgHdr1 *pPage, i
53c0: 6e 74 20 66 72 65 65 46 6c 61 67 29 7b 0a 20 20  nt freeFlag){.  
53d0: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 68 3b 0a  unsigned int h;.
53e0: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68    PCache1 *pCach
53f0: 65 20 3d 20 70 50 61 67 65 2d 3e 70 43 61 63 68  e = pPage->pCach
5400: 65 3b 0a 20 20 50 67 48 64 72 31 20 2a 2a 70 70  e;.  PgHdr1 **pp
5410: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c  ;..  assert( sql
5420: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28  ite3_mutex_held(
5430: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e  pCache->pGroup->
5440: 6d 75 74 65 78 29 20 29 3b 0a 20 20 68 20 3d 20  mutex) );.  h = 
5450: 70 50 61 67 65 2d 3e 69 4b 65 79 20 25 20 70 43  pPage->iKey % pC
5460: 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 66  ache->nHash;.  f
5470: 6f 72 28 70 70 3d 26 70 43 61 63 68 65 2d 3e 61  or(pp=&pCache->a
5480: 70 48 61 73 68 5b 68 5d 3b 20 28 2a 70 70 29 21  pHash[h]; (*pp)!
5490: 3d 70 50 61 67 65 3b 20 70 70 3d 26 28 2a 70 70  =pPage; pp=&(*pp
54a0: 29 2d 3e 70 4e 65 78 74 29 3b 0a 20 20 2a 70 70  )->pNext);.  *pp
54b0: 20 3d 20 28 2a 70 70 29 2d 3e 70 4e 65 78 74 3b   = (*pp)->pNext;
54c0: 0a 0a 20 20 70 43 61 63 68 65 2d 3e 6e 50 61 67  ..  pCache->nPag
54d0: 65 2d 2d 3b 0a 20 20 69 66 28 20 66 72 65 65 46  e--;.  if( freeF
54e0: 6c 61 67 20 29 20 70 63 61 63 68 65 31 46 72 65  lag ) pcache1Fre
54f0: 65 50 61 67 65 28 70 50 61 67 65 29 3b 0a 7d 0a  ePage(pPage);.}.
5500: 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 72 65 20  ./*.** If there 
5510: 61 72 65 20 63 75 72 72 65 6e 74 6c 79 20 6d 6f  are currently mo
5520: 72 65 20 74 68 61 6e 20 6e 4d 61 78 50 61 67 65  re than nMaxPage
5530: 20 70 61 67 65 73 20 61 6c 6c 6f 63 61 74 65 64   pages allocated
5540: 2c 20 74 72 79 0a 2a 2a 20 74 6f 20 72 65 63 79  , try.** to recy
5550: 63 6c 65 20 70 61 67 65 73 20 74 6f 20 72 65 64  cle pages to red
5560: 75 63 65 20 74 68 65 20 6e 75 6d 62 65 72 20 61  uce the number a
5570: 6c 6c 6f 63 61 74 65 64 20 74 6f 20 6e 4d 61 78  llocated to nMax
5580: 50 61 67 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  Page..*/.static 
5590: 76 6f 69 64 20 70 63 61 63 68 65 31 45 6e 66 6f  void pcache1Enfo
55a0: 72 63 65 4d 61 78 50 61 67 65 28 50 43 61 63 68  rceMaxPage(PCach
55b0: 65 31 20 2a 70 43 61 63 68 65 29 7b 0a 20 20 50  e1 *pCache){.  P
55c0: 47 72 6f 75 70 20 2a 70 47 72 6f 75 70 20 3d 20  Group *pGroup = 
55d0: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3b 0a  pCache->pGroup;.
55e0: 20 20 50 67 48 64 72 31 20 2a 70 3b 0a 20 20 61    PgHdr1 *p;.  a
55f0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d  ssert( sqlite3_m
5600: 75 74 65 78 5f 68 65 6c 64 28 70 47 72 6f 75 70  utex_held(pGroup
5610: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 77 68  ->mutex) );.  wh
5620: 69 6c 65 28 20 70 47 72 6f 75 70 2d 3e 6e 43 75  ile( pGroup->nCu
5630: 72 72 65 6e 74 50 61 67 65 3e 70 47 72 6f 75 70  rrentPage>pGroup
5640: 2d 3e 6e 4d 61 78 50 61 67 65 0a 20 20 20 20 20  ->nMaxPage.     
5650: 20 26 26 20 28 70 3d 70 47 72 6f 75 70 2d 3e 6c   && (p=pGroup->l
5660: 72 75 2e 70 4c 72 75 50 72 65 76 29 2d 3e 69 73  ru.pLruPrev)->is
5670: 41 6e 63 68 6f 72 3d 3d 30 0a 20 20 29 7b 0a 20  Anchor==0.  ){. 
5680: 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 70 43     assert( p->pC
5690: 61 63 68 65 2d 3e 70 47 72 6f 75 70 3d 3d 70 47  ache->pGroup==pG
56a0: 72 6f 75 70 20 29 3b 0a 20 20 20 20 61 73 73 65  roup );.    asse
56b0: 72 74 28 20 70 2d 3e 69 73 50 69 6e 6e 65 64 3d  rt( p->isPinned=
56c0: 3d 30 20 29 3b 0a 20 20 20 20 70 63 61 63 68 65  =0 );.    pcache
56d0: 31 50 69 6e 50 61 67 65 28 70 29 3b 0a 20 20 20  1PinPage(p);.   
56e0: 20 70 63 61 63 68 65 31 52 65 6d 6f 76 65 46 72   pcache1RemoveFr
56f0: 6f 6d 48 61 73 68 28 70 2c 20 31 29 3b 0a 20 20  omHash(p, 1);.  
5700: 7d 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e  }.  if( pCache->
5710: 6e 50 61 67 65 3d 3d 30 20 26 26 20 70 43 61 63  nPage==0 && pCac
5720: 68 65 2d 3e 70 42 75 6c 6b 20 29 7b 0a 20 20 20  he->pBulk ){.   
5730: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 43   sqlite3_free(pC
5740: 61 63 68 65 2d 3e 70 42 75 6c 6b 29 3b 0a 20 20  ache->pBulk);.  
5750: 20 20 70 43 61 63 68 65 2d 3e 70 42 75 6c 6b 20    pCache->pBulk 
5760: 3d 20 70 43 61 63 68 65 2d 3e 70 46 72 65 65 20  = pCache->pFree 
5770: 3d 20 30 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a  = 0;.  }.}../*.*
5780: 2a 20 44 69 73 63 61 72 64 20 61 6c 6c 20 70 61  * Discard all pa
5790: 67 65 73 20 66 72 6f 6d 20 63 61 63 68 65 20 70  ges from cache p
57a0: 43 61 63 68 65 20 77 69 74 68 20 61 20 70 61 67  Cache with a pag
57b0: 65 20 6e 75 6d 62 65 72 20 28 6b 65 79 20 76 61  e number (key va
57c0: 6c 75 65 29 20 0a 2a 2a 20 67 72 65 61 74 65 72  lue) .** greater
57d0: 20 74 68 61 6e 20 6f 72 20 65 71 75 61 6c 20 74   than or equal t
57e0: 6f 20 69 4c 69 6d 69 74 2e 20 41 6e 79 20 70 69  o iLimit. Any pi
57f0: 6e 6e 65 64 20 70 61 67 65 73 20 74 68 61 74 20  nned pages that 
5800: 6d 65 65 74 20 74 68 69 73 20 0a 2a 2a 20 63 72  meet this .** cr
5810: 69 74 65 72 69 61 20 61 72 65 20 75 6e 70 69 6e  iteria are unpin
5820: 6e 65 64 20 62 65 66 6f 72 65 20 74 68 65 79 20  ned before they 
5830: 61 72 65 20 64 69 73 63 61 72 64 65 64 2e 0a 2a  are discarded..*
5840: 2a 0a 2a 2a 20 54 68 65 20 50 43 61 63 68 65 20  *.** The PCache 
5850: 6d 75 74 65 78 20 6d 75 73 74 20 62 65 20 68 65  mutex must be he
5860: 6c 64 20 77 68 65 6e 20 74 68 69 73 20 66 75 6e  ld when this fun
5870: 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2e  ction is called.
5880: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
5890: 70 63 61 63 68 65 31 54 72 75 6e 63 61 74 65 55  pcache1TruncateU
58a0: 6e 73 61 66 65 28 0a 20 20 50 43 61 63 68 65 31  nsafe(.  PCache1
58b0: 20 2a 70 43 61 63 68 65 2c 20 20 20 20 20 20 20   *pCache,       
58c0: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 63 61 63        /* The cac
58d0: 68 65 20 74 6f 20 74 72 75 6e 63 61 74 65 20 2a  he to truncate *
58e0: 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74  /.  unsigned int
58f0: 20 69 4c 69 6d 69 74 20 20 20 20 20 20 20 20 20   iLimit         
5900: 20 2f 2a 20 44 72 6f 70 20 70 61 67 65 73 20 77   /* Drop pages w
5910: 69 74 68 20 74 68 69 73 20 70 67 6e 6f 20 6f 72  ith this pgno or
5920: 20 6c 61 72 67 65 72 20 2a 2f 0a 29 7b 0a 20 20   larger */.){.  
5930: 54 45 53 54 4f 4e 4c 59 28 20 69 6e 74 20 6e 50  TESTONLY( int nP
5940: 61 67 65 20 3d 20 30 3b 20 29 20 20 2f 2a 20 54  age = 0; )  /* T
5950: 6f 20 61 73 73 65 72 74 20 70 43 61 63 68 65 2d  o assert pCache-
5960: 3e 6e 50 61 67 65 20 69 73 20 63 6f 72 72 65 63  >nPage is correc
5970: 74 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20  t */.  unsigned 
5980: 69 6e 74 20 68 2c 20 69 53 74 6f 70 3b 0a 20 20  int h, iStop;.  
5990: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f  assert( sqlite3_
59a0: 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 61 63 68  mutex_held(pCach
59b0: 65 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78  e->pGroup->mutex
59c0: 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  ) );.  assert( p
59d0: 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 3e  Cache->iMaxKey >
59e0: 3d 20 69 4c 69 6d 69 74 20 29 3b 0a 20 20 61 73  = iLimit );.  as
59f0: 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 48  sert( pCache->nH
5a00: 61 73 68 20 3e 20 30 20 29 3b 0a 20 20 69 66 28  ash > 0 );.  if(
5a10: 20 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79   pCache->iMaxKey
5a20: 20 2d 20 69 4c 69 6d 69 74 20 3c 20 70 43 61 63   - iLimit < pCac
5a30: 68 65 2d 3e 6e 48 61 73 68 20 29 7b 0a 20 20 20  he->nHash ){.   
5a40: 20 2f 2a 20 49 66 20 77 65 20 61 72 65 20 6a 75   /* If we are ju
5a50: 73 74 20 73 68 61 76 69 6e 67 20 74 68 65 20 6c  st shaving the l
5a60: 61 73 74 20 66 65 77 20 70 61 67 65 73 20 6f 66  ast few pages of
5a70: 66 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65  f the end of the
5a80: 0a 20 20 20 20 2a 2a 20 63 61 63 68 65 2c 20 74  .    ** cache, t
5a90: 68 65 6e 20 74 68 65 72 65 20 69 73 20 6e 6f 20  hen there is no 
5aa0: 70 6f 69 6e 74 20 69 6e 20 73 63 61 6e 6e 69 6e  point in scannin
5ab0: 67 20 74 68 65 20 65 6e 74 69 72 65 20 68 61 73  g the entire has
5ac0: 68 20 74 61 62 6c 65 2e 0a 20 20 20 20 2a 2a 20  h table..    ** 
5ad0: 4f 6e 6c 79 20 73 63 61 6e 20 74 68 6f 73 65 20  Only scan those 
5ae0: 68 61 73 68 20 73 6c 6f 74 73 20 74 68 61 74 20  hash slots that 
5af0: 6d 69 67 68 74 20 63 6f 6e 74 61 69 6e 20 70 61  might contain pa
5b00: 67 65 73 20 74 68 61 74 20 6e 65 65 64 20 74 6f  ges that need to
5b10: 0a 20 20 20 20 2a 2a 20 62 65 20 72 65 6d 6f 76  .    ** be remov
5b20: 65 64 2e 20 2a 2f 0a 20 20 20 20 68 20 3d 20 69  ed. */.    h = i
5b30: 4c 69 6d 69 74 20 25 20 70 43 61 63 68 65 2d 3e  Limit % pCache->
5b40: 6e 48 61 73 68 3b 0a 20 20 20 20 69 53 74 6f 70  nHash;.    iStop
5b50: 20 3d 20 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b   = pCache->iMaxK
5b60: 65 79 20 25 20 70 43 61 63 68 65 2d 3e 6e 48 61  ey % pCache->nHa
5b70: 73 68 3b 0a 20 20 20 20 54 45 53 54 4f 4e 4c 59  sh;.    TESTONLY
5b80: 28 20 6e 50 61 67 65 20 3d 20 2d 31 30 3b 20 29  ( nPage = -10; )
5b90: 20 20 2f 2a 20 44 69 73 61 62 6c 65 20 74 68 65    /* Disable the
5ba0: 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 20 76   pCache->nPage v
5bb0: 61 6c 69 64 69 74 79 20 63 68 65 63 6b 20 2a 2f  alidity check */
5bc0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a  .  }else{.    /*
5bd0: 20 54 68 69 73 20 69 73 20 74 68 65 20 67 65 6e   This is the gen
5be0: 65 72 61 6c 20 63 61 73 65 20 77 68 65 72 65 20  eral case where 
5bf0: 6d 61 6e 79 20 70 61 67 65 73 20 61 72 65 20 62  many pages are b
5c00: 65 69 6e 67 20 72 65 6d 6f 76 65 64 2e 0a 20 20  eing removed..  
5c10: 20 20 2a 2a 20 49 74 20 69 73 20 6e 65 63 65 73    ** It is neces
5c20: 73 61 72 79 20 74 6f 20 73 63 61 6e 20 74 68 65  sary to scan the
5c30: 20 65 6e 74 69 72 65 20 68 61 73 68 20 74 61 62   entire hash tab
5c40: 6c 65 20 2a 2f 0a 20 20 20 20 68 20 3d 20 70 43  le */.    h = pC
5c50: 61 63 68 65 2d 3e 6e 48 61 73 68 2f 32 3b 0a 20  ache->nHash/2;. 
5c60: 20 20 20 69 53 74 6f 70 20 3d 20 68 20 2d 20 31     iStop = h - 1
5c70: 3b 0a 20 20 7d 0a 20 20 66 6f 72 28 3b 3b 29 7b  ;.  }.  for(;;){
5c80: 0a 20 20 20 20 50 67 48 64 72 31 20 2a 2a 70 70  .    PgHdr1 **pp
5c90: 3b 0a 20 20 20 20 50 67 48 64 72 31 20 2a 70 50  ;.    PgHdr1 *pP
5ca0: 61 67 65 3b 0a 20 20 20 20 61 73 73 65 72 74 28  age;.    assert(
5cb0: 20 68 3c 70 43 61 63 68 65 2d 3e 6e 48 61 73 68   h<pCache->nHash
5cc0: 20 29 3b 0a 20 20 20 20 70 70 20 3d 20 26 70 43   );.    pp = &pC
5cd0: 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 3b  ache->apHash[h];
5ce0: 20 0a 20 20 20 20 77 68 69 6c 65 28 20 28 70 50   .    while( (pP
5cf0: 61 67 65 20 3d 20 2a 70 70 29 21 3d 30 20 29 7b  age = *pp)!=0 ){
5d00: 0a 20 20 20 20 20 20 69 66 28 20 70 50 61 67 65  .      if( pPage
5d10: 2d 3e 69 4b 65 79 3e 3d 69 4c 69 6d 69 74 20 29  ->iKey>=iLimit )
5d20: 7b 0a 20 20 20 20 20 20 20 20 70 43 61 63 68 65  {.        pCache
5d30: 2d 3e 6e 50 61 67 65 2d 2d 3b 0a 20 20 20 20 20  ->nPage--;.     
5d40: 20 20 20 2a 70 70 20 3d 20 70 50 61 67 65 2d 3e     *pp = pPage->
5d50: 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 20 20 69  pNext;.        i
5d60: 66 28 20 21 70 50 61 67 65 2d 3e 69 73 50 69 6e  f( !pPage->isPin
5d70: 6e 65 64 20 29 20 70 63 61 63 68 65 31 50 69 6e  ned ) pcache1Pin
5d80: 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 20 20  Page(pPage);.   
5d90: 20 20 20 20 20 70 63 61 63 68 65 31 46 72 65 65       pcache1Free
5da0: 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 20 20  Page(pPage);.   
5db0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
5dc0: 20 20 70 70 20 3d 20 26 70 50 61 67 65 2d 3e 70    pp = &pPage->p
5dd0: 4e 65 78 74 3b 0a 20 20 20 20 20 20 20 20 54 45  Next;.        TE
5de0: 53 54 4f 4e 4c 59 28 20 69 66 28 20 6e 50 61 67  STONLY( if( nPag
5df0: 65 3e 3d 30 20 29 20 6e 50 61 67 65 2b 2b 3b 20  e>=0 ) nPage++; 
5e00: 29 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ).      }.    }.
5e10: 20 20 20 20 69 66 28 20 68 3d 3d 69 53 74 6f 70      if( h==iStop
5e20: 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 68 20   ) break;.    h 
5e30: 3d 20 28 68 2b 31 29 20 25 20 70 43 61 63 68 65  = (h+1) % pCache
5e40: 2d 3e 6e 48 61 73 68 3b 0a 20 20 7d 0a 20 20 61  ->nHash;.  }.  a
5e50: 73 73 65 72 74 28 20 6e 50 61 67 65 3c 30 20 7c  ssert( nPage<0 |
5e60: 7c 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 3d  | pCache->nPage=
5e70: 3d 28 75 6e 73 69 67 6e 65 64 29 6e 50 61 67 65  =(unsigned)nPage
5e80: 20 29 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a   );.}../********
5e90: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5ea0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5eb0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5ec0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5ed0: 2a 2a 2a 2a 2a 2a 2f 0a 2f 2a 2a 2a 2a 2a 2a 2a  ******/./*******
5ee0: 2a 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  * sqlite3_pcache
5ef0: 20 4d 65 74 68 6f 64 73 20 2a 2a 2a 2a 2a 2a 2a   Methods *******
5f00: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5f10: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5f20: 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20  *******/../*.** 
5f30: 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  Implementation o
5f40: 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63  f the sqlite3_pc
5f50: 61 63 68 65 2e 78 49 6e 69 74 20 6d 65 74 68 6f  ache.xInit metho
5f60: 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  d..*/.static int
5f70: 20 70 63 61 63 68 65 31 49 6e 69 74 28 76 6f 69   pcache1Init(voi
5f80: 64 20 2a 4e 6f 74 55 73 65 64 29 7b 0a 20 20 55  d *NotUsed){.  U
5f90: 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28  NUSED_PARAMETER(
5fa0: 4e 6f 74 55 73 65 64 29 3b 0a 20 20 61 73 73 65  NotUsed);.  asse
5fb0: 72 74 28 20 70 63 61 63 68 65 31 2e 69 73 49 6e  rt( pcache1.isIn
5fc0: 69 74 3d 3d 30 20 29 3b 0a 20 20 6d 65 6d 73 65  it==0 );.  memse
5fd0: 74 28 26 70 63 61 63 68 65 31 2c 20 30 2c 20 73  t(&pcache1, 0, s
5fe0: 69 7a 65 6f 66 28 70 63 61 63 68 65 31 29 29 3b  izeof(pcache1));
5ff0: 0a 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54 68 65  ...  /*.  ** The
6000: 20 70 63 61 63 68 65 31 2e 73 65 70 61 72 61 74   pcache1.separat
6010: 65 43 61 63 68 65 20 76 61 72 69 61 62 6c 65 20  eCache variable 
6020: 69 73 20 74 72 75 65 20 69 66 20 65 61 63 68 20  is true if each 
6030: 50 43 61 63 68 65 20 68 61 73 20 69 74 73 20 6f  PCache has its o
6040: 77 6e 0a 20 20 2a 2a 20 70 72 69 76 61 74 65 20  wn.  ** private 
6050: 50 47 72 6f 75 70 20 28 6d 6f 64 65 2d 31 29 2e  PGroup (mode-1).
6060: 20 20 70 63 61 63 68 65 31 2e 73 65 70 61 72 61    pcache1.separa
6070: 74 65 43 61 63 68 65 20 69 73 20 66 61 6c 73 65  teCache is false
6080: 20 69 66 20 74 68 65 20 73 69 6e 67 6c 65 0a 20   if the single. 
6090: 20 2a 2a 20 50 47 72 6f 75 70 20 69 6e 20 70 63   ** PGroup in pc
60a0: 61 63 68 65 31 2e 67 72 70 20 69 73 20 75 73 65  ache1.grp is use
60b0: 64 20 66 6f 72 20 61 6c 6c 20 70 61 67 65 20 63  d for all page c
60c0: 61 63 68 65 73 20 28 6d 6f 64 65 2d 32 29 2e 0a  aches (mode-2)..
60d0: 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 20 41    **.  **   *  A
60e0: 6c 77 61 79 73 20 75 73 65 20 61 20 75 6e 69 66  lways use a unif
60f0: 69 65 64 20 63 61 63 68 65 20 28 6d 6f 64 65 2d  ied cache (mode-
6100: 32 29 20 69 66 20 45 4e 41 42 4c 45 5f 4d 45 4d  2) if ENABLE_MEM
6110: 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 20  ORY_MANAGEMENT. 
6120: 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 20 55 73   **.  **   *  Us
6130: 65 20 61 20 75 6e 69 66 69 65 64 20 63 61 63 68  e a unified cach
6140: 65 20 69 6e 20 73 69 6e 67 6c 65 2d 74 68 72 65  e in single-thre
6150: 61 64 65 64 20 61 70 70 6c 69 63 61 74 69 6f 6e  aded application
6160: 73 20 74 68 61 74 20 68 61 76 65 0a 20 20 2a 2a  s that have.  **
6170: 20 20 20 20 20 20 63 6f 6e 66 69 67 75 72 65 64        configured
6180: 20 61 20 73 74 61 72 74 2d 74 69 6d 65 20 62 75   a start-time bu
6190: 66 66 65 72 20 66 6f 72 20 75 73 65 20 61 73 20  ffer for use as 
61a0: 70 61 67 65 2d 63 61 63 68 65 20 6d 65 6d 6f 72  page-cache memor
61b0: 79 20 75 73 69 6e 67 0a 20 20 2a 2a 20 20 20 20  y using.  **    
61c0: 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67    sqlite3_config
61d0: 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50  (SQLITE_CONFIG_P
61e0: 41 47 45 43 41 43 48 45 2c 20 70 42 75 66 2c 20  AGECACHE, pBuf, 
61f0: 73 7a 2c 20 4e 29 20 77 69 74 68 20 6e 6f 6e 2d  sz, N) with non-
6200: 4e 55 4c 4c 20 0a 20 20 2a 2a 20 20 20 20 20 20  NULL .  **      
6210: 70 42 75 66 20 61 72 67 75 6d 65 6e 74 2e 0a 20  pBuf argument.. 
6220: 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 20 4f 74   **.  **   *  Ot
6230: 68 65 72 77 69 73 65 20 75 73 65 20 73 65 70 61  herwise use sepa
6240: 72 61 74 65 20 63 61 63 68 65 73 20 28 6d 6f 64  rate caches (mod
6250: 65 2d 31 29 0a 20 20 2a 2f 0a 23 69 66 20 64 65  e-1).  */.#if de
6260: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41  fined(SQLITE_ENA
6270: 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47  BLE_MEMORY_MANAG
6280: 45 4d 45 4e 54 29 0a 20 20 70 63 61 63 68 65 31  EMENT).  pcache1
6290: 2e 73 65 70 61 72 61 74 65 43 61 63 68 65 20 3d  .separateCache =
62a0: 20 30 3b 0a 23 65 6c 69 66 20 53 51 4c 49 54 45   0;.#elif SQLITE
62b0: 5f 54 48 52 45 41 44 53 41 46 45 0a 20 20 70 63  _THREADSAFE.  pc
62c0: 61 63 68 65 31 2e 73 65 70 61 72 61 74 65 43 61  ache1.separateCa
62d0: 63 68 65 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f  che = sqlite3Glo
62e0: 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65 3d  balConfig.pPage=
62f0: 3d 30 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  =0.             
6300: 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20               || 
6310: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
6320: 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 3e 30  fig.bCoreMutex>0
6330: 3b 0a 23 65 6c 73 65 0a 20 20 70 63 61 63 68 65  ;.#else.  pcache
6340: 31 2e 73 65 70 61 72 61 74 65 43 61 63 68 65 20  1.separateCache 
6350: 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43  = sqlite3GlobalC
6360: 6f 6e 66 69 67 2e 70 50 61 67 65 3d 3d 30 3b 0a  onfig.pPage==0;.
6370: 23 65 6e 64 69 66 0a 0a 23 69 66 20 53 51 4c 49  #endif..#if SQLI
6380: 54 45 5f 54 48 52 45 41 44 53 41 46 45 0a 20 20  TE_THREADSAFE.  
6390: 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61  if( sqlite3Globa
63a0: 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74  lConfig.bCoreMut
63b0: 65 78 20 29 7b 0a 20 20 20 20 70 63 61 63 68 65  ex ){.    pcache
63c0: 31 2e 67 72 70 2e 6d 75 74 65 78 20 3d 20 73 71  1.grp.mutex = sq
63d0: 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28  lite3MutexAlloc(
63e0: 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41  SQLITE_MUTEX_STA
63f0: 54 49 43 5f 4c 52 55 29 3b 0a 20 20 20 20 70 63  TIC_LRU);.    pc
6400: 61 63 68 65 31 2e 6d 75 74 65 78 20 3d 20 73 71  ache1.mutex = sq
6410: 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28  lite3MutexAlloc(
6420: 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41  SQLITE_MUTEX_STA
6430: 54 49 43 5f 50 4d 45 4d 29 3b 0a 20 20 7d 0a 23  TIC_PMEM);.  }.#
6440: 65 6e 64 69 66 0a 20 20 69 66 28 20 70 63 61 63  endif.  if( pcac
6450: 68 65 31 2e 73 65 70 61 72 61 74 65 43 61 63 68  he1.separateCach
6460: 65 0a 20 20 20 26 26 20 73 71 6c 69 74 65 33 47  e.   && sqlite3G
6470: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 50 61 67  lobalConfig.nPag
6480: 65 21 3d 30 0a 20 20 20 26 26 20 73 71 6c 69 74  e!=0.   && sqlit
6490: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70  e3GlobalConfig.p
64a0: 50 61 67 65 3d 3d 30 0a 20 20 29 7b 0a 20 20 20  Page==0.  ){.   
64b0: 20 70 63 61 63 68 65 31 2e 6e 49 6e 69 74 50 61   pcache1.nInitPa
64c0: 67 65 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62  ge = sqlite3Glob
64d0: 61 6c 43 6f 6e 66 69 67 2e 6e 50 61 67 65 3b 0a  alConfig.nPage;.
64e0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 63 61    }else{.    pca
64f0: 63 68 65 31 2e 6e 49 6e 69 74 50 61 67 65 20 3d  che1.nInitPage =
6500: 20 30 3b 0a 20 20 7d 0a 20 20 70 63 61 63 68 65   0;.  }.  pcache
6510: 31 2e 67 72 70 2e 6d 78 50 69 6e 6e 65 64 20 3d  1.grp.mxPinned =
6520: 20 31 30 3b 0a 20 20 70 63 61 63 68 65 31 2e 69   10;.  pcache1.i
6530: 73 49 6e 69 74 20 3d 20 31 3b 0a 20 20 72 65 74  sInit = 1;.  ret
6540: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d  urn SQLITE_OK;.}
6550: 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e  ../*.** Implemen
6560: 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71  tation of the sq
6570: 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78 53 68  lite3_pcache.xSh
6580: 75 74 64 6f 77 6e 20 6d 65 74 68 6f 64 2e 0a 2a  utdown method..*
6590: 2a 20 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20  * Note that the 
65a0: 73 74 61 74 69 63 20 6d 75 74 65 78 20 61 6c 6c  static mutex all
65b0: 6f 63 61 74 65 64 20 69 6e 20 78 49 6e 69 74 20  ocated in xInit 
65c0: 64 6f 65 73 20 0a 2a 2a 20 6e 6f 74 20 6e 65 65  does .** not nee
65d0: 64 20 74 6f 20 62 65 20 66 72 65 65 64 2e 0a 2a  d to be freed..*
65e0: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63  /.static void pc
65f0: 61 63 68 65 31 53 68 75 74 64 6f 77 6e 28 76 6f  ache1Shutdown(vo
6600: 69 64 20 2a 4e 6f 74 55 73 65 64 29 7b 0a 20 20  id *NotUsed){.  
6610: 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52  UNUSED_PARAMETER
6620: 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 61 73 73  (NotUsed);.  ass
6630: 65 72 74 28 20 70 63 61 63 68 65 31 2e 69 73 49  ert( pcache1.isI
6640: 6e 69 74 21 3d 30 20 29 3b 0a 20 20 6d 65 6d 73  nit!=0 );.  mems
6650: 65 74 28 26 70 63 61 63 68 65 31 2c 20 30 2c 20  et(&pcache1, 0, 
6660: 73 69 7a 65 6f 66 28 70 63 61 63 68 65 31 29 29  sizeof(pcache1))
6670: 3b 0a 7d 0a 0a 2f 2a 20 66 6f 72 77 61 72 64 20  ;.}../* forward 
6680: 64 65 63 6c 61 72 61 74 69 6f 6e 20 2a 2f 0a 73  declaration */.s
6690: 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68  tatic void pcach
66a0: 65 31 44 65 73 74 72 6f 79 28 73 71 6c 69 74 65  e1Destroy(sqlite
66b0: 33 5f 70 63 61 63 68 65 20 2a 70 29 3b 0a 0a 2f  3_pcache *p);../
66c0: 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74  *.** Implementat
66d0: 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74  ion of the sqlit
66e0: 65 33 5f 70 63 61 63 68 65 2e 78 43 72 65 61 74  e3_pcache.xCreat
66f0: 65 20 6d 65 74 68 6f 64 2e 0a 2a 2a 0a 2a 2a 20  e method..**.** 
6700: 41 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 63  Allocate a new c
6710: 61 63 68 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  ache..*/.static 
6720: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a  sqlite3_pcache *
6730: 70 63 61 63 68 65 31 43 72 65 61 74 65 28 69 6e  pcache1Create(in
6740: 74 20 73 7a 50 61 67 65 2c 20 69 6e 74 20 73 7a  t szPage, int sz
6750: 45 78 74 72 61 2c 20 69 6e 74 20 62 50 75 72 67  Extra, int bPurg
6760: 65 61 62 6c 65 29 7b 0a 20 20 50 43 61 63 68 65  eable){.  PCache
6770: 31 20 2a 70 43 61 63 68 65 3b 20 20 20 20 20 20  1 *pCache;      
6780: 2f 2a 20 54 68 65 20 6e 65 77 6c 79 20 63 72 65  /* The newly cre
6790: 61 74 65 64 20 70 61 67 65 20 63 61 63 68 65 20  ated page cache 
67a0: 2a 2f 0a 20 20 50 47 72 6f 75 70 20 2a 70 47 72  */.  PGroup *pGr
67b0: 6f 75 70 3b 20 20 20 20 20 20 20 2f 2a 20 54 68  oup;       /* Th
67c0: 65 20 67 72 6f 75 70 20 74 68 65 20 6e 65 77 20  e group the new 
67d0: 70 61 67 65 20 63 61 63 68 65 20 77 69 6c 6c 20  page cache will 
67e0: 62 65 6c 6f 6e 67 20 74 6f 20 2a 2f 0a 20 20 69  belong to */.  i
67f0: 6e 74 20 73 7a 3b 20 20 20 20 20 20 20 20 20 20  nt sz;          
6800: 20 20 20 20 20 2f 2a 20 42 79 74 65 73 20 6f 66       /* Bytes of
6810: 20 6d 65 6d 6f 72 79 20 72 65 71 75 69 72 65 64   memory required
6820: 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 74 68 65   to allocate the
6830: 20 6e 65 77 20 63 61 63 68 65 20 2a 2f 0a 0a 20   new cache */.. 
6840: 20 61 73 73 65 72 74 28 20 28 73 7a 50 61 67 65   assert( (szPage
6850: 20 26 20 28 73 7a 50 61 67 65 2d 31 29 29 3d 3d   & (szPage-1))==
6860: 30 20 26 26 20 73 7a 50 61 67 65 3e 3d 35 31 32  0 && szPage>=512
6870: 20 26 26 20 73 7a 50 61 67 65 3c 3d 36 35 35 33   && szPage<=6553
6880: 36 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73  6 );.  assert( s
6890: 7a 45 78 74 72 61 20 3c 20 33 30 30 20 29 3b 0a  zExtra < 300 );.
68a0: 0a 20 20 73 7a 20 3d 20 73 69 7a 65 6f 66 28 50  .  sz = sizeof(P
68b0: 43 61 63 68 65 31 29 20 2b 20 73 69 7a 65 6f 66  Cache1) + sizeof
68c0: 28 50 47 72 6f 75 70 29 2a 70 63 61 63 68 65 31  (PGroup)*pcache1
68d0: 2e 73 65 70 61 72 61 74 65 43 61 63 68 65 3b 0a  .separateCache;.
68e0: 20 20 70 43 61 63 68 65 20 3d 20 28 50 43 61 63    pCache = (PCac
68f0: 68 65 31 20 2a 29 73 71 6c 69 74 65 33 4d 61 6c  he1 *)sqlite3Mal
6900: 6c 6f 63 5a 65 72 6f 28 73 7a 29 3b 0a 20 20 69  locZero(sz);.  i
6910: 66 28 20 70 43 61 63 68 65 20 29 7b 0a 20 20 20  f( pCache ){.   
6920: 20 69 66 28 20 70 63 61 63 68 65 31 2e 73 65 70   if( pcache1.sep
6930: 61 72 61 74 65 43 61 63 68 65 20 29 7b 0a 20 20  arateCache ){.  
6940: 20 20 20 20 70 47 72 6f 75 70 20 3d 20 28 50 47      pGroup = (PG
6950: 72 6f 75 70 2a 29 26 70 43 61 63 68 65 5b 31 5d  roup*)&pCache[1]
6960: 3b 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e  ;.      pGroup->
6970: 6d 78 50 69 6e 6e 65 64 20 3d 20 31 30 3b 0a 20  mxPinned = 10;. 
6980: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
6990: 70 47 72 6f 75 70 20 3d 20 26 70 63 61 63 68 65  pGroup = &pcache
69a0: 31 2e 67 72 70 3b 0a 20 20 20 20 7d 0a 20 20 20  1.grp;.    }.   
69b0: 20 69 66 28 20 70 47 72 6f 75 70 2d 3e 6c 72 75   if( pGroup->lru
69c0: 2e 69 73 41 6e 63 68 6f 72 3d 3d 30 20 29 7b 0a  .isAnchor==0 ){.
69d0: 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e 6c 72        pGroup->lr
69e0: 75 2e 69 73 41 6e 63 68 6f 72 20 3d 20 31 3b 0a  u.isAnchor = 1;.
69f0: 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e 6c 72        pGroup->lr
6a00: 75 2e 70 4c 72 75 50 72 65 76 20 3d 20 70 47 72  u.pLruPrev = pGr
6a10: 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72 75 4e 65 78  oup->lru.pLruNex
6a20: 74 20 3d 20 26 70 47 72 6f 75 70 2d 3e 6c 72 75  t = &pGroup->lru
6a30: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 43 61 63  ;.    }.    pCac
6a40: 68 65 2d 3e 70 47 72 6f 75 70 20 3d 20 70 47 72  he->pGroup = pGr
6a50: 6f 75 70 3b 0a 20 20 20 20 70 43 61 63 68 65 2d  oup;.    pCache-
6a60: 3e 73 7a 50 61 67 65 20 3d 20 73 7a 50 61 67 65  >szPage = szPage
6a70: 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 73 7a  ;.    pCache->sz
6a80: 45 78 74 72 61 20 3d 20 73 7a 45 78 74 72 61 3b  Extra = szExtra;
6a90: 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 73 7a 41  .    pCache->szA
6aa0: 6c 6c 6f 63 20 3d 20 73 7a 50 61 67 65 20 2b 20  lloc = szPage + 
6ab0: 73 7a 45 78 74 72 61 20 2b 20 52 4f 55 4e 44 38  szExtra + ROUND8
6ac0: 28 73 69 7a 65 6f 66 28 50 67 48 64 72 31 29 29  (sizeof(PgHdr1))
6ad0: 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 62 50  ;.    pCache->bP
6ae0: 75 72 67 65 61 62 6c 65 20 3d 20 28 62 50 75 72  urgeable = (bPur
6af0: 67 65 61 62 6c 65 20 3f 20 31 20 3a 20 30 29 3b  geable ? 1 : 0);
6b00: 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e 74 65  .    pcache1Ente
6b10: 72 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a  rMutex(pGroup);.
6b20: 20 20 20 20 70 63 61 63 68 65 31 52 65 73 69 7a      pcache1Resiz
6b30: 65 48 61 73 68 28 70 43 61 63 68 65 29 3b 0a 20  eHash(pCache);. 
6b40: 20 20 20 69 66 28 20 62 50 75 72 67 65 61 62 6c     if( bPurgeabl
6b50: 65 20 29 7b 0a 20 20 20 20 20 20 70 43 61 63 68  e ){.      pCach
6b60: 65 2d 3e 6e 4d 69 6e 20 3d 20 31 30 3b 0a 20 20  e->nMin = 10;.  
6b70: 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e      pGroup->nMin
6b80: 50 61 67 65 20 2b 3d 20 70 43 61 63 68 65 2d 3e  Page += pCache->
6b90: 6e 4d 69 6e 3b 0a 20 20 20 20 20 20 70 47 72 6f  nMin;.      pGro
6ba0: 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 20 70  up->mxPinned = p
6bb0: 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20  Group->nMaxPage 
6bc0: 2b 20 31 30 20 2d 20 70 47 72 6f 75 70 2d 3e 6e  + 10 - pGroup->n
6bd0: 4d 69 6e 50 61 67 65 3b 0a 20 20 20 20 7d 0a 20  MinPage;.    }. 
6be0: 20 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d     pcache1LeaveM
6bf0: 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20 20  utex(pGroup);.  
6c00: 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e 6e 48    if( pCache->nH
6c10: 61 73 68 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20  ash==0 ){.      
6c20: 70 63 61 63 68 65 31 44 65 73 74 72 6f 79 28 28  pcache1Destroy((
6c30: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2a 29  sqlite3_pcache*)
6c40: 70 43 61 63 68 65 29 3b 0a 20 20 20 20 20 20 70  pCache);.      p
6c50: 43 61 63 68 65 20 3d 20 30 3b 0a 20 20 20 20 7d  Cache = 0;.    }
6c60: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 28 73  .  }.  return (s
6c70: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 29  qlite3_pcache *)
6c80: 70 43 61 63 68 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  pCache;.}../*.**
6c90: 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20   Implementation 
6ca0: 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70  of the sqlite3_p
6cb0: 63 61 63 68 65 2e 78 43 61 63 68 65 73 69 7a 65  cache.xCachesize
6cc0: 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20   method. .**.** 
6cd0: 43 6f 6e 66 69 67 75 72 65 20 74 68 65 20 63 61  Configure the ca
6ce0: 63 68 65 5f 73 69 7a 65 20 6c 69 6d 69 74 20 66  che_size limit f
6cf0: 6f 72 20 61 20 63 61 63 68 65 2e 0a 2a 2f 0a 73  or a cache..*/.s
6d00: 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68  tatic void pcach
6d10: 65 31 43 61 63 68 65 73 69 7a 65 28 73 71 6c 69  e1Cachesize(sqli
6d20: 74 65 33 5f 70 63 61 63 68 65 20 2a 70 2c 20 69  te3_pcache *p, i
6d30: 6e 74 20 6e 4d 61 78 29 7b 0a 20 20 50 43 61 63  nt nMax){.  PCac
6d40: 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50  he1 *pCache = (P
6d50: 43 61 63 68 65 31 20 2a 29 70 3b 0a 20 20 69 66  Cache1 *)p;.  if
6d60: 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65  ( pCache->bPurge
6d70: 61 62 6c 65 20 29 7b 0a 20 20 20 20 50 47 72 6f  able ){.    PGro
6d80: 75 70 20 2a 70 47 72 6f 75 70 20 3d 20 70 43 61  up *pGroup = pCa
6d90: 63 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20 20 20  che->pGroup;.   
6da0: 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74   pcache1EnterMut
6db0: 65 78 28 70 47 72 6f 75 70 29 3b 0a 20 20 20 20  ex(pGroup);.    
6dc0: 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65  pGroup->nMaxPage
6dd0: 20 2b 3d 20 28 6e 4d 61 78 20 2d 20 70 43 61 63   += (nMax - pCac
6de0: 68 65 2d 3e 6e 4d 61 78 29 3b 0a 20 20 20 20 70  he->nMax);.    p
6df0: 47 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 20  Group->mxPinned 
6e00: 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61  = pGroup->nMaxPa
6e10: 67 65 20 2b 20 31 30 20 2d 20 70 47 72 6f 75 70  ge + 10 - pGroup
6e20: 2d 3e 6e 4d 69 6e 50 61 67 65 3b 0a 20 20 20 20  ->nMinPage;.    
6e30: 70 43 61 63 68 65 2d 3e 6e 4d 61 78 20 3d 20 6e  pCache->nMax = n
6e40: 4d 61 78 3b 0a 20 20 20 20 70 43 61 63 68 65 2d  Max;.    pCache-
6e50: 3e 6e 39 30 70 63 74 20 3d 20 70 43 61 63 68 65  >n90pct = pCache
6e60: 2d 3e 6e 4d 61 78 2a 39 2f 31 30 3b 0a 20 20 20  ->nMax*9/10;.   
6e70: 20 70 63 61 63 68 65 31 45 6e 66 6f 72 63 65 4d   pcache1EnforceM
6e80: 61 78 50 61 67 65 28 70 43 61 63 68 65 29 3b 0a  axPage(pCache);.
6e90: 20 20 20 20 70 63 61 63 68 65 31 4c 65 61 76 65      pcache1Leave
6ea0: 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20  Mutex(pGroup);. 
6eb0: 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c   }.}../*.** Impl
6ec0: 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68  ementation of th
6ed0: 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  e sqlite3_pcache
6ee0: 2e 78 53 68 72 69 6e 6b 20 6d 65 74 68 6f 64 2e  .xShrink method.
6ef0: 20 0a 2a 2a 0a 2a 2a 20 46 72 65 65 20 75 70 20   .**.** Free up 
6f00: 61 73 20 6d 75 63 68 20 6d 65 6d 6f 72 79 20 61  as much memory a
6f10: 73 20 70 6f 73 73 69 62 6c 65 2e 0a 2a 2f 0a 73  s possible..*/.s
6f20: 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68  tatic void pcach
6f30: 65 31 53 68 72 69 6e 6b 28 73 71 6c 69 74 65 33  e1Shrink(sqlite3
6f40: 5f 70 63 61 63 68 65 20 2a 70 29 7b 0a 20 20 50  _pcache *p){.  P
6f50: 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d  Cache1 *pCache =
6f60: 20 28 50 43 61 63 68 65 31 2a 29 70 3b 0a 20 20   (PCache1*)p;.  
6f70: 69 66 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72  if( pCache->bPur
6f80: 67 65 61 62 6c 65 20 29 7b 0a 20 20 20 20 50 47  geable ){.    PG
6f90: 72 6f 75 70 20 2a 70 47 72 6f 75 70 20 3d 20 70  roup *pGroup = p
6fa0: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20  Cache->pGroup;. 
6fb0: 20 20 20 69 6e 74 20 73 61 76 65 64 4d 61 78 50     int savedMaxP
6fc0: 61 67 65 3b 0a 20 20 20 20 70 63 61 63 68 65 31  age;.    pcache1
6fd0: 45 6e 74 65 72 4d 75 74 65 78 28 70 47 72 6f 75  EnterMutex(pGrou
6fe0: 70 29 3b 0a 20 20 20 20 73 61 76 65 64 4d 61 78  p);.    savedMax
6ff0: 50 61 67 65 20 3d 20 70 47 72 6f 75 70 2d 3e 6e  Page = pGroup->n
7000: 4d 61 78 50 61 67 65 3b 0a 20 20 20 20 70 47 72  MaxPage;.    pGr
7010: 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 3d 20  oup->nMaxPage = 
7020: 30 3b 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e  0;.    pcache1En
7030: 66 6f 72 63 65 4d 61 78 50 61 67 65 28 70 43 61  forceMaxPage(pCa
7040: 63 68 65 29 3b 0a 20 20 20 20 70 47 72 6f 75 70  che);.    pGroup
7050: 2d 3e 6e 4d 61 78 50 61 67 65 20 3d 20 73 61 76  ->nMaxPage = sav
7060: 65 64 4d 61 78 50 61 67 65 3b 0a 20 20 20 20 70  edMaxPage;.    p
7070: 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78  cache1LeaveMutex
7080: 28 70 47 72 6f 75 70 29 3b 0a 20 20 7d 0a 7d 0a  (pGroup);.  }.}.
7090: 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74  ./*.** Implement
70a0: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c  ation of the sql
70b0: 69 74 65 33 5f 70 63 61 63 68 65 2e 78 50 61 67  ite3_pcache.xPag
70c0: 65 63 6f 75 6e 74 20 6d 65 74 68 6f 64 2e 20 0a  ecount method. .
70d0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 63  */.static int pc
70e0: 61 63 68 65 31 50 61 67 65 63 6f 75 6e 74 28 73  ache1Pagecount(s
70f0: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70  qlite3_pcache *p
7100: 29 7b 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 50 43  ){.  int n;.  PC
7110: 61 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20  ache1 *pCache = 
7120: 28 50 43 61 63 68 65 31 2a 29 70 3b 0a 20 20 70  (PCache1*)p;.  p
7130: 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78  cache1EnterMutex
7140: 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29  (pCache->pGroup)
7150: 3b 0a 20 20 6e 20 3d 20 70 43 61 63 68 65 2d 3e  ;.  n = pCache->
7160: 6e 50 61 67 65 3b 0a 20 20 70 63 61 63 68 65 31  nPage;.  pcache1
7170: 4c 65 61 76 65 4d 75 74 65 78 28 70 43 61 63 68  LeaveMutex(pCach
7180: 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20 72 65  e->pGroup);.  re
7190: 74 75 72 6e 20 6e 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a  turn n;.}.../*.*
71a0: 2a 20 49 6d 70 6c 65 6d 65 6e 74 20 73 74 65 70  * Implement step
71b0: 73 20 33 2c 20 34 2c 20 61 6e 64 20 35 20 6f 66  s 3, 4, and 5 of
71c0: 20 74 68 65 20 70 63 61 63 68 65 31 46 65 74 63   the pcache1Fetc
71d0: 68 28 29 20 61 6c 67 6f 72 69 74 68 6d 20 64 65  h() algorithm de
71e0: 73 63 72 69 62 65 64 0a 2a 2a 20 69 6e 20 74 68  scribed.** in th
71f0: 65 20 68 65 61 64 65 72 20 6f 66 20 74 68 65 20  e header of the 
7200: 70 63 61 63 68 65 31 46 65 74 63 68 28 29 20 70  pcache1Fetch() p
7210: 72 6f 63 65 64 75 72 65 2e 0a 2a 2a 0a 2a 2a 20  rocedure..**.** 
7220: 54 68 69 73 20 73 74 65 70 73 20 61 72 65 20 62  This steps are b
7230: 72 6f 6b 65 6e 20 6f 75 74 20 69 6e 74 6f 20 61  roken out into a
7240: 20 73 65 70 61 72 61 74 65 20 70 72 6f 63 65 64   separate proced
7250: 75 72 65 20 62 65 63 61 75 73 65 20 74 68 65 79  ure because they
7260: 20 61 72 65 0a 2a 2a 20 75 73 75 61 6c 6c 79 20   are.** usually 
7270: 6e 6f 74 20 6e 65 65 64 65 64 2c 20 61 6e 64 20  not needed, and 
7280: 62 79 20 61 76 6f 69 64 69 6e 67 20 74 68 65 20  by avoiding the 
7290: 73 74 61 63 6b 20 69 6e 69 74 69 61 6c 69 7a 61  stack initializa
72a0: 74 69 6f 6e 20 72 65 71 75 69 72 65 64 0a 2a 2a  tion required.**
72b0: 20 66 6f 72 20 74 68 65 73 65 20 73 74 65 70 73   for these steps
72c0: 2c 20 74 68 65 20 6d 61 69 6e 20 70 63 61 63 68  , the main pcach
72d0: 65 31 46 65 74 63 68 28 29 20 70 72 6f 63 65 64  e1Fetch() proced
72e0: 75 72 65 20 63 61 6e 20 72 75 6e 20 66 61 73 74  ure can run fast
72f0: 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 53 51  er..*/.static SQ
7300: 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20 50 67  LITE_NOINLINE Pg
7310: 48 64 72 31 20 2a 70 63 61 63 68 65 31 46 65 74  Hdr1 *pcache1Fet
7320: 63 68 53 74 61 67 65 32 28 0a 20 20 50 43 61 63  chStage2(.  PCac
7330: 68 65 31 20 2a 70 43 61 63 68 65 2c 20 0a 20 20  he1 *pCache, .  
7340: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4b 65  unsigned int iKe
7350: 79 2c 20 0a 20 20 69 6e 74 20 63 72 65 61 74 65  y, .  int create
7360: 46 6c 61 67 0a 29 7b 0a 20 20 75 6e 73 69 67 6e  Flag.){.  unsign
7370: 65 64 20 69 6e 74 20 6e 50 69 6e 6e 65 64 3b 0a  ed int nPinned;.
7380: 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70    PGroup *pGroup
7390: 20 3d 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75   = pCache->pGrou
73a0: 70 3b 0a 20 20 50 67 48 64 72 31 20 2a 70 50 61  p;.  PgHdr1 *pPa
73b0: 67 65 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20 53 74  ge = 0;..  /* St
73c0: 65 70 20 33 3a 20 41 62 6f 72 74 20 69 66 20 63  ep 3: Abort if c
73d0: 72 65 61 74 65 46 6c 61 67 20 69 73 20 31 20 62  reateFlag is 1 b
73e0: 75 74 20 74 68 65 20 63 61 63 68 65 20 69 73 20  ut the cache is 
73f0: 6e 65 61 72 6c 79 20 66 75 6c 6c 20 2a 2f 0a 20  nearly full */. 
7400: 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65 2d   assert( pCache-
7410: 3e 6e 50 61 67 65 20 3e 3d 20 70 43 61 63 68 65  >nPage >= pCache
7420: 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65 20 29 3b  ->nRecyclable );
7430: 0a 20 20 6e 50 69 6e 6e 65 64 20 3d 20 70 43 61  .  nPinned = pCa
7440: 63 68 65 2d 3e 6e 50 61 67 65 20 2d 20 70 43 61  che->nPage - pCa
7450: 63 68 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65  che->nRecyclable
7460: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 47 72 6f  ;.  assert( pGro
7470: 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 3d 20  up->mxPinned == 
7480: 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65  pGroup->nMaxPage
7490: 20 2b 20 31 30 20 2d 20 70 47 72 6f 75 70 2d 3e   + 10 - pGroup->
74a0: 6e 4d 69 6e 50 61 67 65 20 29 3b 0a 20 20 61 73  nMinPage );.  as
74b0: 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 39  sert( pCache->n9
74c0: 30 70 63 74 20 3d 3d 20 70 43 61 63 68 65 2d 3e  0pct == pCache->
74d0: 6e 4d 61 78 2a 39 2f 31 30 20 29 3b 0a 20 20 69  nMax*9/10 );.  i
74e0: 66 28 20 63 72 65 61 74 65 46 6c 61 67 3d 3d 31  f( createFlag==1
74f0: 20 26 26 20 28 0a 20 20 20 20 20 20 20 20 6e 50   && (.        nP
7500: 69 6e 6e 65 64 3e 3d 70 47 72 6f 75 70 2d 3e 6d  inned>=pGroup->m
7510: 78 50 69 6e 6e 65 64 0a 20 20 20 20 20 7c 7c 20  xPinned.     || 
7520: 6e 50 69 6e 6e 65 64 3e 3d 70 43 61 63 68 65 2d  nPinned>=pCache-
7530: 3e 6e 39 30 70 63 74 0a 20 20 20 20 20 7c 7c 20  >n90pct.     || 
7540: 28 70 63 61 63 68 65 31 55 6e 64 65 72 4d 65 6d  (pcache1UnderMem
7550: 6f 72 79 50 72 65 73 73 75 72 65 28 70 43 61 63  oryPressure(pCac
7560: 68 65 29 20 26 26 20 70 43 61 63 68 65 2d 3e 6e  he) && pCache->n
7570: 52 65 63 79 63 6c 61 62 6c 65 3c 6e 50 69 6e 6e  Recyclable<nPinn
7580: 65 64 29 0a 20 20 29 29 7b 0a 20 20 20 20 72 65  ed).  )){.    re
7590: 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 0a 20 20 69  turn 0;.  }..  i
75a0: 66 28 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65  f( pCache->nPage
75b0: 3e 3d 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 20  >=pCache->nHash 
75c0: 29 20 70 63 61 63 68 65 31 52 65 73 69 7a 65 48  ) pcache1ResizeH
75d0: 61 73 68 28 70 43 61 63 68 65 29 3b 0a 20 20 61  ash(pCache);.  a
75e0: 73 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 6e  ssert( pCache->n
75f0: 48 61 73 68 3e 30 20 26 26 20 70 43 61 63 68 65  Hash>0 && pCache
7600: 2d 3e 61 70 48 61 73 68 20 29 3b 0a 0a 20 20 2f  ->apHash );..  /
7610: 2a 20 53 74 65 70 20 34 2e 20 54 72 79 20 74 6f  * Step 4. Try to
7620: 20 72 65 63 79 63 6c 65 20 61 20 70 61 67 65 2e   recycle a page.
7630: 20 2a 2f 0a 20 20 69 66 28 20 70 43 61 63 68 65   */.  if( pCache
7640: 2d 3e 62 50 75 72 67 65 61 62 6c 65 0a 20 20 20  ->bPurgeable.   
7650: 26 26 20 21 70 47 72 6f 75 70 2d 3e 6c 72 75 2e  && !pGroup->lru.
7660: 70 4c 72 75 50 72 65 76 2d 3e 69 73 41 6e 63 68  pLruPrev->isAnch
7670: 6f 72 0a 20 20 20 26 26 20 28 28 70 43 61 63 68  or.   && ((pCach
7680: 65 2d 3e 6e 50 61 67 65 2b 31 3e 3d 70 43 61 63  e->nPage+1>=pCac
7690: 68 65 2d 3e 6e 4d 61 78 29 20 7c 7c 20 70 63 61  he->nMax) || pca
76a0: 63 68 65 31 55 6e 64 65 72 4d 65 6d 6f 72 79 50  che1UnderMemoryP
76b0: 72 65 73 73 75 72 65 28 70 43 61 63 68 65 29 29  ressure(pCache))
76c0: 0a 20 20 29 7b 0a 20 20 20 20 50 43 61 63 68 65  .  ){.    PCache
76d0: 31 20 2a 70 4f 74 68 65 72 3b 0a 20 20 20 20 70  1 *pOther;.    p
76e0: 50 61 67 65 20 3d 20 70 47 72 6f 75 70 2d 3e 6c  Page = pGroup->l
76f0: 72 75 2e 70 4c 72 75 50 72 65 76 3b 0a 20 20 20  ru.pLruPrev;.   
7700: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e   assert( pPage->
7710: 69 73 50 69 6e 6e 65 64 3d 3d 30 20 29 3b 0a 20  isPinned==0 );. 
7720: 20 20 20 70 63 61 63 68 65 31 52 65 6d 6f 76 65     pcache1Remove
7730: 46 72 6f 6d 48 61 73 68 28 70 50 61 67 65 2c 20  FromHash(pPage, 
7740: 30 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 50  0);.    pcache1P
7750: 69 6e 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20  inPage(pPage);. 
7760: 20 20 20 70 4f 74 68 65 72 20 3d 20 70 50 61 67     pOther = pPag
7770: 65 2d 3e 70 43 61 63 68 65 3b 0a 20 20 20 20 69  e->pCache;.    i
7780: 66 28 20 70 4f 74 68 65 72 2d 3e 73 7a 41 6c 6c  f( pOther->szAll
7790: 6f 63 20 21 3d 20 70 43 61 63 68 65 2d 3e 73 7a  oc != pCache->sz
77a0: 41 6c 6c 6f 63 20 29 7b 0a 20 20 20 20 20 20 70  Alloc ){.      p
77b0: 63 61 63 68 65 31 46 72 65 65 50 61 67 65 28 70  cache1FreePage(p
77c0: 50 61 67 65 29 3b 0a 20 20 20 20 20 20 70 50 61  Page);.      pPa
77d0: 67 65 20 3d 20 30 3b 0a 20 20 20 20 7d 65 6c 73  ge = 0;.    }els
77e0: 65 7b 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d  e{.      pGroup-
77f0: 3e 6e 43 75 72 72 65 6e 74 50 61 67 65 20 2d 3d  >nCurrentPage -=
7800: 20 28 70 4f 74 68 65 72 2d 3e 62 50 75 72 67 65   (pOther->bPurge
7810: 61 62 6c 65 20 2d 20 70 43 61 63 68 65 2d 3e 62  able - pCache->b
7820: 50 75 72 67 65 61 62 6c 65 29 3b 0a 20 20 20 20  Purgeable);.    
7830: 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 53 74 65 70  }.  }..  /* Step
7840: 20 35 2e 20 49 66 20 61 20 75 73 61 62 6c 65 20   5. If a usable 
7850: 70 61 67 65 20 62 75 66 66 65 72 20 68 61 73 20  page buffer has 
7860: 73 74 69 6c 6c 20 6e 6f 74 20 62 65 65 6e 20 66  still not been f
7870: 6f 75 6e 64 2c 20 0a 20 20 2a 2a 20 61 74 74 65  ound, .  ** atte
7880: 6d 70 74 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20  mpt to allocate 
7890: 61 20 6e 65 77 20 6f 6e 65 2e 20 0a 20 20 2a 2f  a new one. .  */
78a0: 0a 20 20 69 66 28 20 21 70 50 61 67 65 20 29 7b  .  if( !pPage ){
78b0: 0a 20 20 20 20 70 50 61 67 65 20 3d 20 70 63 61  .    pPage = pca
78c0: 63 68 65 31 41 6c 6c 6f 63 50 61 67 65 28 70 43  che1AllocPage(pC
78d0: 61 63 68 65 2c 20 63 72 65 61 74 65 46 6c 61 67  ache, createFlag
78e0: 3d 3d 31 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28  ==1);.  }..  if(
78f0: 20 70 50 61 67 65 20 29 7b 0a 20 20 20 20 75 6e   pPage ){.    un
7900: 73 69 67 6e 65 64 20 69 6e 74 20 68 20 3d 20 69  signed int h = i
7910: 4b 65 79 20 25 20 70 43 61 63 68 65 2d 3e 6e 48  Key % pCache->nH
7920: 61 73 68 3b 0a 20 20 20 20 70 43 61 63 68 65 2d  ash;.    pCache-
7930: 3e 6e 50 61 67 65 2b 2b 3b 0a 20 20 20 20 70 50  >nPage++;.    pP
7940: 61 67 65 2d 3e 69 4b 65 79 20 3d 20 69 4b 65 79  age->iKey = iKey
7950: 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 70 4e 65  ;.    pPage->pNe
7960: 78 74 20 3d 20 70 43 61 63 68 65 2d 3e 61 70 48  xt = pCache->apH
7970: 61 73 68 5b 68 5d 3b 0a 20 20 20 20 70 50 61 67  ash[h];.    pPag
7980: 65 2d 3e 70 43 61 63 68 65 20 3d 20 70 43 61 63  e->pCache = pCac
7990: 68 65 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 70  he;.    pPage->p
79a0: 4c 72 75 50 72 65 76 20 3d 20 30 3b 0a 20 20 20  LruPrev = 0;.   
79b0: 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74   pPage->pLruNext
79c0: 20 3d 20 30 3b 0a 20 20 20 20 70 50 61 67 65 2d   = 0;.    pPage-
79d0: 3e 69 73 50 69 6e 6e 65 64 20 3d 20 31 3b 0a 20  >isPinned = 1;. 
79e0: 20 20 20 2a 28 76 6f 69 64 20 2a 2a 29 70 50 61     *(void **)pPa
79f0: 67 65 2d 3e 70 61 67 65 2e 70 45 78 74 72 61 20  ge->page.pExtra 
7a00: 3d 20 30 3b 0a 20 20 20 20 70 43 61 63 68 65 2d  = 0;.    pCache-
7a10: 3e 61 70 48 61 73 68 5b 68 5d 20 3d 20 70 50 61  >apHash[h] = pPa
7a20: 67 65 3b 0a 20 20 20 20 69 66 28 20 69 4b 65 79  ge;.    if( iKey
7a30: 3e 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79  >pCache->iMaxKey
7a40: 20 29 7b 0a 20 20 20 20 20 20 70 43 61 63 68 65   ){.      pCache
7a50: 2d 3e 69 4d 61 78 4b 65 79 20 3d 20 69 4b 65 79  ->iMaxKey = iKey
7a60: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65  ;.    }.  }.  re
7a70: 74 75 72 6e 20 70 50 61 67 65 3b 0a 7d 0a 0a 2f  turn pPage;.}../
7a80: 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74  *.** Implementat
7a90: 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74  ion of the sqlit
7aa0: 65 33 5f 70 63 61 63 68 65 2e 78 46 65 74 63 68  e3_pcache.xFetch
7ab0: 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20   method. .**.** 
7ac0: 46 65 74 63 68 20 61 20 70 61 67 65 20 62 79 20  Fetch a page by 
7ad0: 6b 65 79 20 76 61 6c 75 65 2e 0a 2a 2a 0a 2a 2a  key value..**.**
7ae0: 20 57 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20   Whether or not 
7af0: 61 20 6e 65 77 20 70 61 67 65 20 6d 61 79 20 62  a new page may b
7b00: 65 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 20 74  e allocated by t
7b10: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 64 65 70  his function dep
7b20: 65 6e 64 73 20 6f 6e 0a 2a 2a 20 74 68 65 20 76  ends on.** the v
7b30: 61 6c 75 65 20 6f 66 20 74 68 65 20 63 72 65 61  alue of the crea
7b40: 74 65 46 6c 61 67 20 61 72 67 75 6d 65 6e 74 2e  teFlag argument.
7b50: 20 20 30 20 6d 65 61 6e 73 20 64 6f 20 6e 6f 74    0 means do not
7b60: 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 0a   allocate a new.
7b70: 2a 2a 20 70 61 67 65 2e 20 20 31 20 6d 65 61 6e  ** page.  1 mean
7b80: 73 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77  s allocate a new
7b90: 20 70 61 67 65 20 69 66 20 73 70 61 63 65 20 69   page if space i
7ba0: 73 20 65 61 73 69 6c 79 20 61 76 61 69 6c 61 62  s easily availab
7bb0: 6c 65 2e 20 20 32 20 0a 2a 2a 20 6d 65 61 6e 73  le.  2 .** means
7bc0: 20 74 6f 20 74 72 79 20 72 65 61 6c 6c 79 20 68   to try really h
7bd0: 61 72 64 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20  ard to allocate 
7be0: 61 20 6e 65 77 20 70 61 67 65 2e 0a 2a 2a 0a 2a  a new page..**.*
7bf0: 2a 20 46 6f 72 20 61 20 6e 6f 6e 2d 70 75 72 67  * For a non-purg
7c00: 65 61 62 6c 65 20 63 61 63 68 65 20 28 61 20 63  eable cache (a c
7c10: 61 63 68 65 20 75 73 65 64 20 61 73 20 74 68 65  ache used as the
7c20: 20 73 74 6f 72 61 67 65 20 66 6f 72 20 61 6e 20   storage for an 
7c30: 69 6e 2d 6d 65 6d 6f 72 79 0a 2a 2a 20 64 61 74  in-memory.** dat
7c40: 61 62 61 73 65 29 20 74 68 65 72 65 20 69 73 20  abase) there is 
7c50: 72 65 61 6c 6c 79 20 6e 6f 20 64 69 66 66 65 72  really no differ
7c60: 65 6e 63 65 20 62 65 74 77 65 65 6e 20 63 72 65  ence between cre
7c70: 61 74 65 46 6c 61 67 20 31 20 61 6e 64 20 32 2e  ateFlag 1 and 2.
7c80: 20 20 53 6f 0a 2a 2a 20 74 68 65 20 63 61 6c 6c    So.** the call
7c90: 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 28 70 63  ing function (pc
7ca0: 61 63 68 65 2e 63 29 20 77 69 6c 6c 20 6e 65 76  ache.c) will nev
7cb0: 65 72 20 68 61 76 65 20 61 20 63 72 65 61 74 65  er have a create
7cc0: 46 6c 61 67 20 6f 66 20 31 20 6f 6e 0a 2a 2a 20  Flag of 1 on.** 
7cd0: 61 20 6e 6f 6e 2d 70 75 72 67 65 61 62 6c 65 20  a non-purgeable 
7ce0: 63 61 63 68 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65  cache..**.** The
7cf0: 72 65 20 61 72 65 20 74 68 72 65 65 20 64 69 66  re are three dif
7d00: 66 65 72 65 6e 74 20 61 70 70 72 6f 61 63 68 65  ferent approache
7d10: 73 20 74 6f 20 6f 62 74 61 69 6e 69 6e 67 20 73  s to obtaining s
7d20: 70 61 63 65 20 66 6f 72 20 61 20 70 61 67 65 2c  pace for a page,
7d30: 0a 2a 2a 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e  .** depending on
7d40: 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 70 61   the value of pa
7d50: 72 61 6d 65 74 65 72 20 63 72 65 61 74 65 46 6c  rameter createFl
7d60: 61 67 20 28 77 68 69 63 68 20 6d 61 79 20 62 65  ag (which may be
7d70: 20 30 2c 20 31 20 6f 72 20 32 29 2e 0a 2a 2a 0a   0, 1 or 2)..**.
7d80: 2a 2a 20 20 20 31 2e 20 52 65 67 61 72 64 6c 65  **   1. Regardle
7d90: 73 73 20 6f 66 20 74 68 65 20 76 61 6c 75 65 20  ss of the value 
7da0: 6f 66 20 63 72 65 61 74 65 46 6c 61 67 2c 20 74  of createFlag, t
7db0: 68 65 20 63 61 63 68 65 20 69 73 20 73 65 61 72  he cache is sear
7dc0: 63 68 65 64 20 66 6f 72 20 61 20 0a 2a 2a 20 20  ched for a .**  
7dd0: 20 20 20 20 63 6f 70 79 20 6f 66 20 74 68 65 20      copy of the 
7de0: 72 65 71 75 65 73 74 65 64 20 70 61 67 65 2e 20  requested page. 
7df0: 49 66 20 6f 6e 65 20 69 73 20 66 6f 75 6e 64 2c  If one is found,
7e00: 20 69 74 20 69 73 20 72 65 74 75 72 6e 65 64 2e   it is returned.
7e10: 0a 2a 2a 0a 2a 2a 20 20 20 32 2e 20 49 66 20 63  .**.**   2. If c
7e20: 72 65 61 74 65 46 6c 61 67 3d 3d 30 20 61 6e 64  reateFlag==0 and
7e30: 20 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f 74   the page is not
7e40: 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65 20   already in the 
7e50: 63 61 63 68 65 2c 20 4e 55 4c 4c 20 69 73 0a 2a  cache, NULL is.*
7e60: 2a 20 20 20 20 20 20 72 65 74 75 72 6e 65 64 2e  *      returned.
7e70: 0a 2a 2a 0a 2a 2a 20 20 20 33 2e 20 49 66 20 63  .**.**   3. If c
7e80: 72 65 61 74 65 46 6c 61 67 20 69 73 20 31 2c 20  reateFlag is 1, 
7e90: 61 6e 64 20 74 68 65 20 70 61 67 65 20 69 73 20  and the page is 
7ea0: 6e 6f 74 20 61 6c 72 65 61 64 79 20 69 6e 20 74  not already in t
7eb0: 68 65 20 63 61 63 68 65 2c 20 74 68 65 6e 0a 2a  he cache, then.*
7ec0: 2a 20 20 20 20 20 20 72 65 74 75 72 6e 20 4e 55  *      return NU
7ed0: 4c 4c 20 28 64 6f 20 6e 6f 74 20 61 6c 6c 6f 63  LL (do not alloc
7ee0: 61 74 65 20 61 20 6e 65 77 20 70 61 67 65 29 20  ate a new page) 
7ef0: 69 66 20 61 6e 79 20 6f 66 20 74 68 65 20 66 6f  if any of the fo
7f00: 6c 6c 6f 77 69 6e 67 0a 2a 2a 20 20 20 20 20 20  llowing.**      
7f10: 63 6f 6e 64 69 74 69 6f 6e 73 20 61 72 65 20 74  conditions are t
7f20: 72 75 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20  rue:.**.**      
7f30: 20 28 61 29 20 74 68 65 20 6e 75 6d 62 65 72 20   (a) the number 
7f40: 6f 66 20 70 61 67 65 73 20 70 69 6e 6e 65 64 20  of pages pinned 
7f50: 62 79 20 74 68 65 20 63 61 63 68 65 20 69 73 20  by the cache is 
7f60: 67 72 65 61 74 65 72 20 74 68 61 6e 0a 2a 2a 20  greater than.** 
7f70: 20 20 20 20 20 20 20 20 20 20 50 43 61 63 68 65            PCache
7f80: 31 2e 6e 4d 61 78 2c 20 6f 72 0a 2a 2a 0a 2a 2a  1.nMax, or.**.**
7f90: 20 20 20 20 20 20 20 28 62 29 20 74 68 65 20 6e         (b) the n
7fa0: 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 70  umber of pages p
7fb0: 69 6e 6e 65 64 20 62 79 20 74 68 65 20 63 61 63  inned by the cac
7fc0: 68 65 20 69 73 20 67 72 65 61 74 65 72 20 74 68  he is greater th
7fd0: 61 6e 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20  an.**           
7fe0: 74 68 65 20 73 75 6d 20 6f 66 20 6e 4d 61 78 20  the sum of nMax 
7ff0: 66 6f 72 20 61 6c 6c 20 70 75 72 67 65 61 62 6c  for all purgeabl
8000: 65 20 63 61 63 68 65 73 2c 20 6c 65 73 73 20 74  e caches, less t
8010: 68 65 20 73 75 6d 20 6f 66 20 0a 2a 2a 20 20 20  he sum of .**   
8020: 20 20 20 20 20 20 20 20 6e 4d 69 6e 20 66 6f 72          nMin for
8030: 20 61 6c 6c 20 6f 74 68 65 72 20 70 75 72 67 65   all other purge
8040: 61 62 6c 65 20 63 61 63 68 65 73 2c 20 6f 72 0a  able caches, or.
8050: 2a 2a 0a 2a 2a 20 20 20 34 2e 20 49 66 20 6e 6f  **.**   4. If no
8060: 6e 65 20 6f 66 20 74 68 65 20 66 69 72 73 74 20  ne of the first 
8070: 74 68 72 65 65 20 63 6f 6e 64 69 74 69 6f 6e 73  three conditions
8080: 20 61 70 70 6c 79 20 61 6e 64 20 74 68 65 20 63   apply and the c
8090: 61 63 68 65 20 69 73 20 6d 61 72 6b 65 64 0a 2a  ache is marked.*
80a0: 2a 20 20 20 20 20 20 61 73 20 70 75 72 67 65 61  *      as purgea
80b0: 62 6c 65 2c 20 61 6e 64 20 69 66 20 6f 6e 65 20  ble, and if one 
80c0: 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  of the following
80d0: 20 69 73 20 74 72 75 65 3a 0a 2a 2a 0a 2a 2a 20   is true:.**.** 
80e0: 20 20 20 20 20 20 28 61 29 20 54 68 65 20 6e 75        (a) The nu
80f0: 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 61 6c  mber of pages al
8100: 6c 6f 63 61 74 65 64 20 66 6f 72 20 74 68 65 20  located for the 
8110: 63 61 63 68 65 20 69 73 20 61 6c 72 65 61 64 79  cache is already
8120: 20 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 50   .**           P
8130: 43 61 63 68 65 31 2e 6e 4d 61 78 2c 20 6f 72 0a  Cache1.nMax, or.
8140: 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 28 62 29 20  **.**       (b) 
8150: 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61  The number of pa
8160: 67 65 73 20 61 6c 6c 6f 63 61 74 65 64 20 66 6f  ges allocated fo
8170: 72 20 61 6c 6c 20 70 75 72 67 65 61 62 6c 65 20  r all purgeable 
8180: 63 61 63 68 65 73 20 69 73 0a 2a 2a 20 20 20 20  caches is.**    
8190: 20 20 20 20 20 20 20 61 6c 72 65 61 64 79 20 65         already e
81a0: 71 75 61 6c 20 74 6f 20 6f 72 20 67 72 65 61 74  qual to or great
81b0: 65 72 20 74 68 61 6e 20 74 68 65 20 73 75 6d 20  er than the sum 
81c0: 6f 66 20 6e 4d 61 78 20 66 6f 72 20 61 6c 6c 0a  of nMax for all.
81d0: 2a 2a 20 20 20 20 20 20 20 20 20 20 20 70 75 72  **           pur
81e0: 67 65 61 62 6c 65 20 63 61 63 68 65 73 2c 0a 2a  geable caches,.*
81f0: 2a 0a 2a 2a 20 20 20 20 20 20 20 28 63 29 20 54  *.**       (c) T
8200: 68 65 20 73 79 73 74 65 6d 20 69 73 20 75 6e 64  he system is und
8210: 65 72 20 6d 65 6d 6f 72 79 20 70 72 65 73 73 75  er memory pressu
8220: 72 65 20 61 6e 64 20 77 61 6e 74 73 20 74 6f 20  re and wants to 
8230: 61 76 6f 69 64 0a 2a 2a 20 20 20 20 20 20 20 20  avoid.**        
8240: 20 20 20 75 6e 6e 65 63 65 73 73 61 72 79 20 70     unnecessary p
8250: 61 67 65 73 20 63 61 63 68 65 20 65 6e 74 72 79  ages cache entry
8260: 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 0a 2a 2a 0a   allocations.**.
8270: 2a 2a 20 20 20 20 20 20 74 68 65 6e 20 61 74 74  **      then att
8280: 65 6d 70 74 20 74 6f 20 72 65 63 79 63 6c 65 20  empt to recycle 
8290: 61 20 70 61 67 65 20 66 72 6f 6d 20 74 68 65 20  a page from the 
82a0: 4c 52 55 20 6c 69 73 74 2e 20 49 66 20 69 74 20  LRU list. If it 
82b0: 69 73 20 74 68 65 20 72 69 67 68 74 0a 2a 2a 20  is the right.** 
82c0: 20 20 20 20 20 73 69 7a 65 2c 20 72 65 74 75 72       size, retur
82d0: 6e 20 74 68 65 20 72 65 63 79 63 6c 65 64 20 62  n the recycled b
82e0: 75 66 66 65 72 2e 20 4f 74 68 65 72 77 69 73 65  uffer. Otherwise
82f0: 2c 20 66 72 65 65 20 74 68 65 20 62 75 66 66 65  , free the buffe
8300: 72 20 61 6e 64 0a 2a 2a 20 20 20 20 20 20 70 72  r and.**      pr
8310: 6f 63 65 65 64 20 74 6f 20 73 74 65 70 20 35 2e  oceed to step 5.
8320: 20 0a 2a 2a 0a 2a 2a 20 20 20 35 2e 20 4f 74 68   .**.**   5. Oth
8330: 65 72 77 69 73 65 2c 20 61 6c 6c 6f 63 61 74 65  erwise, allocate
8340: 20 61 6e 64 20 72 65 74 75 72 6e 20 61 20 6e 65   and return a ne
8350: 77 20 70 61 67 65 20 62 75 66 66 65 72 2e 0a 2a  w page buffer..*
8360: 2a 0a 2a 2a 20 54 68 65 72 65 20 61 72 65 20 74  *.** There are t
8370: 77 6f 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 74  wo versions of t
8380: 68 69 73 20 72 6f 75 74 69 6e 65 2e 20 20 70 63  his routine.  pc
8390: 61 63 68 65 31 46 65 74 63 68 57 69 74 68 4d 75  ache1FetchWithMu
83a0: 74 65 78 28 29 20 69 73 0a 2a 2a 20 74 68 65 20  tex() is.** the 
83b0: 67 65 6e 65 72 61 6c 20 63 61 73 65 2e 20 20 70  general case.  p
83c0: 63 61 63 68 65 31 46 65 74 63 68 4e 6f 4d 75 74  cache1FetchNoMut
83d0: 65 78 28 29 20 69 73 20 61 20 66 61 73 74 65 72  ex() is a faster
83e0: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20   implementation 
83f0: 66 6f 72 0a 2a 2a 20 74 68 65 20 63 6f 6d 6d 6f  for.** the commo
8400: 6e 20 63 61 73 65 20 77 68 65 72 65 20 70 47 72  n case where pGr
8410: 6f 75 70 2d 3e 6d 75 74 65 78 20 69 73 20 4e 55  oup->mutex is NU
8420: 4c 4c 2e 20 20 54 68 65 20 70 63 61 63 68 65 31  LL.  The pcache1
8430: 46 65 74 63 68 28 29 20 77 72 61 70 70 65 72 0a  Fetch() wrapper.
8440: 2a 2a 20 69 6e 76 6f 6b 65 73 20 74 68 65 20 61  ** invokes the a
8450: 70 70 72 6f 70 72 69 61 74 65 20 72 6f 75 74 69  ppropriate routi
8460: 6e 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67  ne..*/.static Pg
8470: 48 64 72 31 20 2a 70 63 61 63 68 65 31 46 65 74  Hdr1 *pcache1Fet
8480: 63 68 4e 6f 4d 75 74 65 78 28 0a 20 20 73 71 6c  chNoMutex(.  sql
8490: 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 2c 20  ite3_pcache *p, 
84a0: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
84b0: 69 4b 65 79 2c 20 0a 20 20 69 6e 74 20 63 72 65  iKey, .  int cre
84c0: 61 74 65 46 6c 61 67 0a 29 7b 0a 20 20 50 43 61  ateFlag.){.  PCa
84d0: 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28  che1 *pCache = (
84e0: 50 43 61 63 68 65 31 20 2a 29 70 3b 0a 20 20 50  PCache1 *)p;.  P
84f0: 67 48 64 72 31 20 2a 70 50 61 67 65 20 3d 20 30  gHdr1 *pPage = 0
8500: 3b 0a 0a 20 20 2f 2a 20 53 74 65 70 20 31 3a 20  ;..  /* Step 1: 
8510: 53 65 61 72 63 68 20 74 68 65 20 68 61 73 68 20  Search the hash 
8520: 74 61 62 6c 65 20 66 6f 72 20 61 6e 20 65 78 69  table for an exi
8530: 73 74 69 6e 67 20 65 6e 74 72 79 2e 20 2a 2f 0a  sting entry. */.
8540: 20 20 70 50 61 67 65 20 3d 20 70 43 61 63 68 65    pPage = pCache
8550: 2d 3e 61 70 48 61 73 68 5b 69 4b 65 79 20 25 20  ->apHash[iKey % 
8560: 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 5d 3b 0a  pCache->nHash];.
8570: 20 20 77 68 69 6c 65 28 20 70 50 61 67 65 20 26    while( pPage &
8580: 26 20 70 50 61 67 65 2d 3e 69 4b 65 79 21 3d 69  & pPage->iKey!=i
8590: 4b 65 79 20 29 7b 20 70 50 61 67 65 20 3d 20 70  Key ){ pPage = p
85a0: 50 61 67 65 2d 3e 70 4e 65 78 74 3b 20 7d 0a 0a  Page->pNext; }..
85b0: 20 20 2f 2a 20 53 74 65 70 20 32 3a 20 49 66 20    /* Step 2: If 
85c0: 74 68 65 20 70 61 67 65 20 77 61 73 20 66 6f 75  the page was fou
85d0: 6e 64 20 69 6e 20 74 68 65 20 68 61 73 68 20 74  nd in the hash t
85e0: 61 62 6c 65 2c 20 74 68 65 6e 20 72 65 74 75 72  able, then retur
85f0: 6e 20 69 74 2e 0a 20 20 2a 2a 20 49 66 20 74 68  n it..  ** If th
8600: 65 20 70 61 67 65 20 77 61 73 20 6e 6f 74 20 69  e page was not i
8610: 6e 20 74 68 65 20 68 61 73 68 20 74 61 62 6c 65  n the hash table
8620: 20 61 6e 64 20 63 72 65 61 74 65 46 6c 61 67 20   and createFlag 
8630: 69 73 20 30 2c 20 61 62 6f 72 74 2e 0a 20 20 2a  is 0, abort..  *
8640: 2a 20 4f 74 68 65 72 77 69 73 65 20 28 70 61 67  * Otherwise (pag
8650: 65 20 6e 6f 74 20 69 6e 20 68 61 73 68 20 61 6e  e not in hash an
8660: 64 20 63 72 65 61 74 65 46 6c 61 67 21 3d 30 29  d createFlag!=0)
8670: 20 63 6f 6e 74 69 6e 75 65 20 77 69 74 68 0a 20   continue with. 
8680: 20 2a 2a 20 73 75 62 73 65 71 75 65 6e 74 20 73   ** subsequent s
8690: 74 65 70 73 20 74 6f 20 74 72 79 20 74 6f 20 63  teps to try to c
86a0: 72 65 61 74 65 20 74 68 65 20 70 61 67 65 2e 20  reate the page. 
86b0: 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 65 20 29  */.  if( pPage )
86c0: 7b 0a 20 20 20 20 69 66 28 20 21 70 50 61 67 65  {.    if( !pPage
86d0: 2d 3e 69 73 50 69 6e 6e 65 64 20 29 7b 0a 20 20  ->isPinned ){.  
86e0: 20 20 20 20 72 65 74 75 72 6e 20 70 63 61 63 68      return pcach
86f0: 65 31 50 69 6e 50 61 67 65 28 70 50 61 67 65 29  e1PinPage(pPage)
8700: 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ;.    }else{.   
8710: 20 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 3b     return pPage;
8720: 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 20 69  .    }.  }else i
8730: 66 28 20 63 72 65 61 74 65 46 6c 61 67 20 29 7b  f( createFlag ){
8740: 0a 20 20 20 20 2f 2a 20 53 74 65 70 73 20 33 2c  .    /* Steps 3,
8750: 20 34 2c 20 61 6e 64 20 35 20 69 6d 70 6c 65 6d   4, and 5 implem
8760: 65 6e 74 65 64 20 62 79 20 74 68 69 73 20 73 75  ented by this su
8770: 62 72 6f 75 74 69 6e 65 20 2a 2f 0a 20 20 20 20  broutine */.    
8780: 72 65 74 75 72 6e 20 70 63 61 63 68 65 31 46 65  return pcache1Fe
8790: 74 63 68 53 74 61 67 65 32 28 70 43 61 63 68 65  tchStage2(pCache
87a0: 2c 20 69 4b 65 79 2c 20 63 72 65 61 74 65 46 6c  , iKey, createFl
87b0: 61 67 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  ag);.  }else{.  
87c0: 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a    return 0;.  }.
87d0: 7d 0a 23 69 66 20 50 43 41 43 48 45 31 5f 4d 49  }.#if PCACHE1_MI
87e0: 47 48 54 5f 55 53 45 5f 47 52 4f 55 50 5f 4d 55  GHT_USE_GROUP_MU
87f0: 54 45 58 0a 73 74 61 74 69 63 20 50 67 48 64 72  TEX.static PgHdr
8800: 31 20 2a 70 63 61 63 68 65 31 46 65 74 63 68 57  1 *pcache1FetchW
8810: 69 74 68 4d 75 74 65 78 28 0a 20 20 73 71 6c 69  ithMutex(.  sqli
8820: 74 65 33 5f 70 63 61 63 68 65 20 2a 70 2c 20 0a  te3_pcache *p, .
8830: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69    unsigned int i
8840: 4b 65 79 2c 20 0a 20 20 69 6e 74 20 63 72 65 61  Key, .  int crea
8850: 74 65 46 6c 61 67 0a 29 7b 0a 20 20 50 43 61 63  teFlag.){.  PCac
8860: 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50  he1 *pCache = (P
8870: 43 61 63 68 65 31 20 2a 29 70 3b 0a 20 20 50 67  Cache1 *)p;.  Pg
8880: 48 64 72 31 20 2a 70 50 61 67 65 3b 0a 0a 20 20  Hdr1 *pPage;..  
8890: 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65  pcache1EnterMute
88a0: 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70  x(pCache->pGroup
88b0: 29 3b 0a 20 20 70 50 61 67 65 20 3d 20 70 63 61  );.  pPage = pca
88c0: 63 68 65 31 46 65 74 63 68 4e 6f 4d 75 74 65 78  che1FetchNoMutex
88d0: 28 70 2c 20 69 4b 65 79 2c 20 63 72 65 61 74 65  (p, iKey, create
88e0: 46 6c 61 67 29 3b 0a 20 20 61 73 73 65 72 74 28  Flag);.  assert(
88f0: 20 70 50 61 67 65 3d 3d 30 20 7c 7c 20 70 43 61   pPage==0 || pCa
8900: 63 68 65 2d 3e 69 4d 61 78 4b 65 79 3e 3d 69 4b  che->iMaxKey>=iK
8910: 65 79 20 29 3b 0a 20 20 70 63 61 63 68 65 31 4c  ey );.  pcache1L
8920: 65 61 76 65 4d 75 74 65 78 28 70 43 61 63 68 65  eaveMutex(pCache
8930: 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20 72 65 74  ->pGroup);.  ret
8940: 75 72 6e 20 70 50 61 67 65 3b 0a 7d 0a 23 65 6e  urn pPage;.}.#en
8950: 64 69 66 0a 73 74 61 74 69 63 20 73 71 6c 69 74  dif.static sqlit
8960: 65 33 5f 70 63 61 63 68 65 5f 70 61 67 65 20 2a  e3_pcache_page *
8970: 70 63 61 63 68 65 31 46 65 74 63 68 28 0a 20 20  pcache1Fetch(.  
8980: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a  sqlite3_pcache *
8990: 70 2c 20 0a 20 20 75 6e 73 69 67 6e 65 64 20 69  p, .  unsigned i
89a0: 6e 74 20 69 4b 65 79 2c 20 0a 20 20 69 6e 74 20  nt iKey, .  int 
89b0: 63 72 65 61 74 65 46 6c 61 67 0a 29 7b 0a 23 69  createFlag.){.#i
89c0: 66 20 50 43 41 43 48 45 31 5f 4d 49 47 48 54 5f  f PCACHE1_MIGHT_
89d0: 55 53 45 5f 47 52 4f 55 50 5f 4d 55 54 45 58 20  USE_GROUP_MUTEX 
89e0: 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54  || defined(SQLIT
89f0: 45 5f 44 45 42 55 47 29 0a 20 20 50 43 61 63 68  E_DEBUG).  PCach
8a00: 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43  e1 *pCache = (PC
8a10: 61 63 68 65 31 20 2a 29 70 3b 0a 23 65 6e 64 69  ache1 *)p;.#endi
8a20: 66 0a 0a 20 20 61 73 73 65 72 74 28 20 6f 66 66  f..  assert( off
8a30: 73 65 74 6f 66 28 50 67 48 64 72 31 2c 70 61 67  setof(PgHdr1,pag
8a40: 65 29 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72  e)==0 );.  asser
8a50: 74 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67  t( pCache->bPurg
8a60: 65 61 62 6c 65 20 7c 7c 20 63 72 65 61 74 65 46  eable || createF
8a70: 6c 61 67 21 3d 31 20 29 3b 0a 20 20 61 73 73 65  lag!=1 );.  asse
8a80: 72 74 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72  rt( pCache->bPur
8a90: 67 65 61 62 6c 65 20 7c 7c 20 70 43 61 63 68 65  geable || pCache
8aa0: 2d 3e 6e 4d 69 6e 3d 3d 30 20 29 3b 0a 20 20 61  ->nMin==0 );.  a
8ab0: 73 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 62  ssert( pCache->b
8ac0: 50 75 72 67 65 61 62 6c 65 3d 3d 30 20 7c 7c 20  Purgeable==0 || 
8ad0: 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 3d 3d 31 30  pCache->nMin==10
8ae0: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43   );.  assert( pC
8af0: 61 63 68 65 2d 3e 6e 4d 69 6e 3d 3d 30 20 7c 7c  ache->nMin==0 ||
8b00: 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61   pCache->bPurgea
8b10: 62 6c 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28  ble );.  assert(
8b20: 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 3e 30   pCache->nHash>0
8b30: 20 29 3b 0a 23 69 66 20 50 43 41 43 48 45 31 5f   );.#if PCACHE1_
8b40: 4d 49 47 48 54 5f 55 53 45 5f 47 52 4f 55 50 5f  MIGHT_USE_GROUP_
8b50: 4d 55 54 45 58 0a 20 20 69 66 28 20 70 43 61 63  MUTEX.  if( pCac
8b60: 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65  he->pGroup->mute
8b70: 78 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  x ){.    return 
8b80: 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f  (sqlite3_pcache_
8b90: 70 61 67 65 2a 29 70 63 61 63 68 65 31 46 65 74  page*)pcache1Fet
8ba0: 63 68 57 69 74 68 4d 75 74 65 78 28 70 2c 20 69  chWithMutex(p, i
8bb0: 4b 65 79 2c 20 63 72 65 61 74 65 46 6c 61 67 29  Key, createFlag)
8bc0: 3b 0a 20 20 7d 65 6c 73 65 0a 23 65 6e 64 69 66  ;.  }else.#endif
8bd0: 0a 20 20 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  .  {.    return 
8be0: 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f  (sqlite3_pcache_
8bf0: 70 61 67 65 2a 29 70 63 61 63 68 65 31 46 65 74  page*)pcache1Fet
8c00: 63 68 4e 6f 4d 75 74 65 78 28 70 2c 20 69 4b 65  chNoMutex(p, iKe
8c10: 79 2c 20 63 72 65 61 74 65 46 6c 61 67 29 3b 0a  y, createFlag);.
8c20: 20 20 7d 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 49 6d    }.}.../*.** Im
8c30: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20  plementation of 
8c40: 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63  the sqlite3_pcac
8c50: 68 65 2e 78 55 6e 70 69 6e 20 6d 65 74 68 6f 64  he.xUnpin method
8c60: 2e 0a 2a 2a 0a 2a 2a 20 4d 61 72 6b 20 61 20 70  ..**.** Mark a p
8c70: 61 67 65 20 61 73 20 75 6e 70 69 6e 6e 65 64 20  age as unpinned 
8c80: 28 65 6c 69 67 69 62 6c 65 20 66 6f 72 20 61 73  (eligible for as
8c90: 79 6e 63 68 72 6f 6e 6f 75 73 20 72 65 63 79 63  ynchronous recyc
8ca0: 6c 69 6e 67 29 2e 0a 2a 2f 0a 73 74 61 74 69 63  ling)..*/.static
8cb0: 20 76 6f 69 64 20 70 63 61 63 68 65 31 55 6e 70   void pcache1Unp
8cc0: 69 6e 28 0a 20 20 73 71 6c 69 74 65 33 5f 70 63  in(.  sqlite3_pc
8cd0: 61 63 68 65 20 2a 70 2c 20 0a 20 20 73 71 6c 69  ache *p, .  sqli
8ce0: 74 65 33 5f 70 63 61 63 68 65 5f 70 61 67 65 20  te3_pcache_page 
8cf0: 2a 70 50 67 2c 20 0a 20 20 69 6e 74 20 72 65 75  *pPg, .  int reu
8d00: 73 65 55 6e 6c 69 6b 65 6c 79 0a 29 7b 0a 20 20  seUnlikely.){.  
8d10: 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 20  PCache1 *pCache 
8d20: 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b 0a  = (PCache1 *)p;.
8d30: 20 20 50 67 48 64 72 31 20 2a 70 50 61 67 65 20    PgHdr1 *pPage 
8d40: 3d 20 28 50 67 48 64 72 31 20 2a 29 70 50 67 3b  = (PgHdr1 *)pPg;
8d50: 0a 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f 75  .  PGroup *pGrou
8d60: 70 20 3d 20 70 43 61 63 68 65 2d 3e 70 47 72 6f  p = pCache->pGro
8d70: 75 70 3b 0a 20 0a 20 20 61 73 73 65 72 74 28 20  up;. .  assert( 
8d80: 70 50 61 67 65 2d 3e 70 43 61 63 68 65 3d 3d 70  pPage->pCache==p
8d90: 43 61 63 68 65 20 29 3b 0a 20 20 70 63 61 63 68  Cache );.  pcach
8da0: 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70 47 72  e1EnterMutex(pGr
8db0: 6f 75 70 29 3b 0a 0a 20 20 2f 2a 20 49 74 20 69  oup);..  /* It i
8dc0: 73 20 61 6e 20 65 72 72 6f 72 20 74 6f 20 63 61  s an error to ca
8dd0: 6c 6c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e  ll this function
8de0: 20 69 66 20 74 68 65 20 70 61 67 65 20 69 73 20   if the page is 
8df0: 61 6c 72 65 61 64 79 20 0a 20 20 2a 2a 20 70 61  already .  ** pa
8e00: 72 74 20 6f 66 20 74 68 65 20 50 47 72 6f 75 70  rt of the PGroup
8e10: 20 4c 52 55 20 6c 69 73 74 2e 0a 20 20 2a 2f 0a   LRU list..  */.
8e20: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d    assert( pPage-
8e30: 3e 70 4c 72 75 50 72 65 76 3d 3d 30 20 26 26 20  >pLruPrev==0 && 
8e40: 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74 3d  pPage->pLruNext=
8e50: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  =0 );.  assert( 
8e60: 70 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64 3d  pPage->isPinned=
8e70: 3d 31 20 29 3b 0a 0a 20 20 69 66 28 20 72 65 75  =1 );..  if( reu
8e80: 73 65 55 6e 6c 69 6b 65 6c 79 20 7c 7c 20 70 47  seUnlikely || pG
8e90: 72 6f 75 70 2d 3e 6e 43 75 72 72 65 6e 74 50 61  roup->nCurrentPa
8ea0: 67 65 3e 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50  ge>pGroup->nMaxP
8eb0: 61 67 65 20 29 7b 0a 20 20 20 20 70 63 61 63 68  age ){.    pcach
8ec0: 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73 68  e1RemoveFromHash
8ed0: 28 70 50 61 67 65 2c 20 31 29 3b 0a 20 20 7d 65  (pPage, 1);.  }e
8ee0: 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 41 64 64 20  lse{.    /* Add 
8ef0: 74 68 65 20 70 61 67 65 20 74 6f 20 74 68 65 20  the page to the 
8f00: 50 47 72 6f 75 70 20 4c 52 55 20 6c 69 73 74 2e  PGroup LRU list.
8f10: 20 2a 2f 0a 20 20 20 20 50 67 48 64 72 31 20 2a   */.    PgHdr1 *
8f20: 2a 70 70 46 69 72 73 74 20 3d 20 26 70 47 72 6f  *ppFirst = &pGro
8f30: 75 70 2d 3e 6c 72 75 2e 70 4c 72 75 4e 65 78 74  up->lru.pLruNext
8f40: 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 70 4c 72  ;.    pPage->pLr
8f50: 75 50 72 65 76 20 3d 20 26 70 47 72 6f 75 70 2d  uPrev = &pGroup-
8f60: 3e 6c 72 75 3b 0a 20 20 20 20 28 70 50 61 67 65  >lru;.    (pPage
8f70: 2d 3e 70 4c 72 75 4e 65 78 74 20 3d 20 2a 70 70  ->pLruNext = *pp
8f80: 46 69 72 73 74 29 2d 3e 70 4c 72 75 50 72 65 76  First)->pLruPrev
8f90: 20 3d 20 70 50 61 67 65 3b 0a 20 20 20 20 2a 70   = pPage;.    *p
8fa0: 70 46 69 72 73 74 20 3d 20 70 50 61 67 65 3b 0a  pFirst = pPage;.
8fb0: 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 52 65 63      pCache->nRec
8fc0: 79 63 6c 61 62 6c 65 2b 2b 3b 0a 20 20 20 20 70  yclable++;.    p
8fd0: 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64 20 3d  Page->isPinned =
8fe0: 20 30 3b 0a 20 20 7d 0a 0a 20 20 70 63 61 63 68   0;.  }..  pcach
8ff0: 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70 43 61  e1LeaveMutex(pCa
9000: 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 7d 0a  che->pGroup);.}.
9010: 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74  ./*.** Implement
9020: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c  ation of the sql
9030: 69 74 65 33 5f 70 63 61 63 68 65 2e 78 52 65 6b  ite3_pcache.xRek
9040: 65 79 20 6d 65 74 68 6f 64 2e 20 0a 2a 2f 0a 73  ey method. .*/.s
9050: 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68  tatic void pcach
9060: 65 31 52 65 6b 65 79 28 0a 20 20 73 71 6c 69 74  e1Rekey(.  sqlit
9070: 65 33 5f 70 63 61 63 68 65 20 2a 70 2c 0a 20 20  e3_pcache *p,.  
9080: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 70  sqlite3_pcache_p
9090: 61 67 65 20 2a 70 50 67 2c 0a 20 20 75 6e 73 69  age *pPg,.  unsi
90a0: 67 6e 65 64 20 69 6e 74 20 69 4f 6c 64 2c 0a 20  gned int iOld,. 
90b0: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4e   unsigned int iN
90c0: 65 77 0a 29 7b 0a 20 20 50 43 61 63 68 65 31 20  ew.){.  PCache1 
90d0: 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61 63 68  *pCache = (PCach
90e0: 65 31 20 2a 29 70 3b 0a 20 20 50 67 48 64 72 31  e1 *)p;.  PgHdr1
90f0: 20 2a 70 50 61 67 65 20 3d 20 28 50 67 48 64 72   *pPage = (PgHdr
9100: 31 20 2a 29 70 50 67 3b 0a 20 20 50 67 48 64 72  1 *)pPg;.  PgHdr
9110: 31 20 2a 2a 70 70 3b 0a 20 20 75 6e 73 69 67 6e  1 **pp;.  unsign
9120: 65 64 20 69 6e 74 20 68 3b 20 0a 20 20 61 73 73  ed int h; .  ass
9130: 65 72 74 28 20 70 50 61 67 65 2d 3e 69 4b 65 79  ert( pPage->iKey
9140: 3d 3d 69 4f 6c 64 20 29 3b 0a 20 20 61 73 73 65  ==iOld );.  asse
9150: 72 74 28 20 70 50 61 67 65 2d 3e 70 43 61 63 68  rt( pPage->pCach
9160: 65 3d 3d 70 43 61 63 68 65 20 29 3b 0a 0a 20 20  e==pCache );..  
9170: 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65  pcache1EnterMute
9180: 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70  x(pCache->pGroup
9190: 29 3b 0a 0a 20 20 68 20 3d 20 69 4f 6c 64 25 70  );..  h = iOld%p
91a0: 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20  Cache->nHash;.  
91b0: 70 70 20 3d 20 26 70 43 61 63 68 65 2d 3e 61 70  pp = &pCache->ap
91c0: 48 61 73 68 5b 68 5d 3b 0a 20 20 77 68 69 6c 65  Hash[h];.  while
91d0: 28 20 28 2a 70 70 29 21 3d 70 50 61 67 65 20 29  ( (*pp)!=pPage )
91e0: 7b 0a 20 20 20 20 70 70 20 3d 20 26 28 2a 70 70  {.    pp = &(*pp
91f0: 29 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d 0a 20 20  )->pNext;.  }.  
9200: 2a 70 70 20 3d 20 70 50 61 67 65 2d 3e 70 4e 65  *pp = pPage->pNe
9210: 78 74 3b 0a 0a 20 20 68 20 3d 20 69 4e 65 77 25  xt;..  h = iNew%
9220: 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20  pCache->nHash;. 
9230: 20 70 50 61 67 65 2d 3e 69 4b 65 79 20 3d 20 69   pPage->iKey = i
9240: 4e 65 77 3b 0a 20 20 70 50 61 67 65 2d 3e 70 4e  New;.  pPage->pN
9250: 65 78 74 20 3d 20 70 43 61 63 68 65 2d 3e 61 70  ext = pCache->ap
9260: 48 61 73 68 5b 68 5d 3b 0a 20 20 70 43 61 63 68  Hash[h];.  pCach
9270: 65 2d 3e 61 70 48 61 73 68 5b 68 5d 20 3d 20 70  e->apHash[h] = p
9280: 50 61 67 65 3b 0a 20 20 69 66 28 20 69 4e 65 77  Page;.  if( iNew
9290: 3e 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79  >pCache->iMaxKey
92a0: 20 29 7b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e   ){.    pCache->
92b0: 69 4d 61 78 4b 65 79 20 3d 20 69 4e 65 77 3b 0a  iMaxKey = iNew;.
92c0: 20 20 7d 0a 0a 20 20 70 63 61 63 68 65 31 4c 65    }..  pcache1Le
92d0: 61 76 65 4d 75 74 65 78 28 70 43 61 63 68 65 2d  aveMutex(pCache-
92e0: 3e 70 47 72 6f 75 70 29 3b 0a 7d 0a 0a 2f 2a 0a  >pGroup);.}../*.
92f0: 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  ** Implementatio
9300: 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33  n of the sqlite3
9310: 5f 70 63 61 63 68 65 2e 78 54 72 75 6e 63 61 74  _pcache.xTruncat
9320: 65 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a  e method. .**.**
9330: 20 44 69 73 63 61 72 64 20 61 6c 6c 20 75 6e 70   Discard all unp
9340: 69 6e 6e 65 64 20 70 61 67 65 73 20 69 6e 20 74  inned pages in t
9350: 68 65 20 63 61 63 68 65 20 77 69 74 68 20 61 20  he cache with a 
9360: 70 61 67 65 20 6e 75 6d 62 65 72 20 65 71 75 61  page number equa
9370: 6c 20 74 6f 0a 2a 2a 20 6f 72 20 67 72 65 61 74  l to.** or great
9380: 65 72 20 74 68 61 6e 20 70 61 72 61 6d 65 74 65  er than paramete
9390: 72 20 69 4c 69 6d 69 74 2e 20 41 6e 79 20 70 69  r iLimit. Any pi
93a0: 6e 6e 65 64 20 70 61 67 65 73 20 77 69 74 68 20  nned pages with 
93b0: 61 20 70 61 67 65 20 6e 75 6d 62 65 72 0a 2a 2a  a page number.**
93c0: 20 65 71 75 61 6c 20 74 6f 20 6f 72 20 67 72 65   equal to or gre
93d0: 61 74 65 72 20 74 68 61 6e 20 69 4c 69 6d 69 74  ater than iLimit
93e0: 20 61 72 65 20 69 6d 70 6c 69 63 69 74 6c 79 20   are implicitly 
93f0: 75 6e 70 69 6e 6e 65 64 2e 0a 2a 2f 0a 73 74 61  unpinned..*/.sta
9400: 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31  tic void pcache1
9410: 54 72 75 6e 63 61 74 65 28 73 71 6c 69 74 65 33  Truncate(sqlite3
9420: 5f 70 63 61 63 68 65 20 2a 70 2c 20 75 6e 73 69  _pcache *p, unsi
9430: 67 6e 65 64 20 69 6e 74 20 69 4c 69 6d 69 74 29  gned int iLimit)
9440: 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61  {.  PCache1 *pCa
9450: 63 68 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a  che = (PCache1 *
9460: 29 70 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 74  )p;.  pcache1Ent
9470: 65 72 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e  erMutex(pCache->
9480: 70 47 72 6f 75 70 29 3b 0a 20 20 69 66 28 20 69  pGroup);.  if( i
9490: 4c 69 6d 69 74 3c 3d 70 43 61 63 68 65 2d 3e 69  Limit<=pCache->i
94a0: 4d 61 78 4b 65 79 20 29 7b 0a 20 20 20 20 70 63  MaxKey ){.    pc
94b0: 61 63 68 65 31 54 72 75 6e 63 61 74 65 55 6e 73  ache1TruncateUns
94c0: 61 66 65 28 70 43 61 63 68 65 2c 20 69 4c 69 6d  afe(pCache, iLim
94d0: 69 74 29 3b 0a 20 20 20 20 70 43 61 63 68 65 2d  it);.    pCache-
94e0: 3e 69 4d 61 78 4b 65 79 20 3d 20 69 4c 69 6d 69  >iMaxKey = iLimi
94f0: 74 2d 31 3b 0a 20 20 7d 0a 20 20 70 63 61 63 68  t-1;.  }.  pcach
9500: 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70 43 61  e1LeaveMutex(pCa
9510: 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 7d 0a  che->pGroup);.}.
9520: 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74  ./*.** Implement
9530: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c  ation of the sql
9540: 69 74 65 33 5f 70 63 61 63 68 65 2e 78 44 65 73  ite3_pcache.xDes
9550: 74 72 6f 79 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a  troy method. .**
9560: 0a 2a 2a 20 44 65 73 74 72 6f 79 20 61 20 63 61  .** Destroy a ca
9570: 63 68 65 20 61 6c 6c 6f 63 61 74 65 64 20 75 73  che allocated us
9580: 69 6e 67 20 70 63 61 63 68 65 31 43 72 65 61 74  ing pcache1Creat
9590: 65 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  e()..*/.static v
95a0: 6f 69 64 20 70 63 61 63 68 65 31 44 65 73 74 72  oid pcache1Destr
95b0: 6f 79 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68  oy(sqlite3_pcach
95c0: 65 20 2a 70 29 7b 0a 20 20 50 43 61 63 68 65 31  e *p){.  PCache1
95d0: 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61 63   *pCache = (PCac
95e0: 68 65 31 20 2a 29 70 3b 0a 20 20 50 47 72 6f 75  he1 *)p;.  PGrou
95f0: 70 20 2a 70 47 72 6f 75 70 20 3d 20 70 43 61 63  p *pGroup = pCac
9600: 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20 20 61 73  he->pGroup;.  as
9610: 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 62 50  sert( pCache->bP
9620: 75 72 67 65 61 62 6c 65 20 7c 7c 20 28 70 43 61  urgeable || (pCa
9630: 63 68 65 2d 3e 6e 4d 61 78 3d 3d 30 20 26 26 20  che->nMax==0 && 
9640: 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 3d 3d 30 29  pCache->nMin==0)
9650: 20 29 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 74   );.  pcache1Ent
9660: 65 72 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b  erMutex(pGroup);
9670: 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e 6e  .  if( pCache->n
9680: 50 61 67 65 20 29 20 70 63 61 63 68 65 31 54 72  Page ) pcache1Tr
9690: 75 6e 63 61 74 65 55 6e 73 61 66 65 28 70 43 61  uncateUnsafe(pCa
96a0: 63 68 65 2c 20 30 29 3b 0a 20 20 61 73 73 65 72  che, 0);.  asser
96b0: 74 28 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50  t( pGroup->nMaxP
96c0: 61 67 65 20 3e 3d 20 70 43 61 63 68 65 2d 3e 6e  age >= pCache->n
96d0: 4d 61 78 20 29 3b 0a 20 20 70 47 72 6f 75 70 2d  Max );.  pGroup-
96e0: 3e 6e 4d 61 78 50 61 67 65 20 2d 3d 20 70 43 61  >nMaxPage -= pCa
96f0: 63 68 65 2d 3e 6e 4d 61 78 3b 0a 20 20 61 73 73  che->nMax;.  ass
9700: 65 72 74 28 20 70 47 72 6f 75 70 2d 3e 6e 4d 69  ert( pGroup->nMi
9710: 6e 50 61 67 65 20 3e 3d 20 70 43 61 63 68 65 2d  nPage >= pCache-
9720: 3e 6e 4d 69 6e 20 29 3b 0a 20 20 70 47 72 6f 75  >nMin );.  pGrou
9730: 70 2d 3e 6e 4d 69 6e 50 61 67 65 20 2d 3d 20 70  p->nMinPage -= p
9740: 43 61 63 68 65 2d 3e 6e 4d 69 6e 3b 0a 20 20 70  Cache->nMin;.  p
9750: 47 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 20  Group->mxPinned 
9760: 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61  = pGroup->nMaxPa
9770: 67 65 20 2b 20 31 30 20 2d 20 70 47 72 6f 75 70  ge + 10 - pGroup
9780: 2d 3e 6e 4d 69 6e 50 61 67 65 3b 0a 20 20 70 63  ->nMinPage;.  pc
9790: 61 63 68 65 31 45 6e 66 6f 72 63 65 4d 61 78 50  ache1EnforceMaxP
97a0: 61 67 65 28 70 43 61 63 68 65 29 3b 0a 20 20 70  age(pCache);.  p
97b0: 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78  cache1LeaveMutex
97c0: 28 70 47 72 6f 75 70 29 3b 0a 20 20 73 71 6c 69  (pGroup);.  sqli
97d0: 74 65 33 5f 66 72 65 65 28 70 43 61 63 68 65 2d  te3_free(pCache-
97e0: 3e 70 42 75 6c 6b 29 3b 0a 20 20 73 71 6c 69 74  >pBulk);.  sqlit
97f0: 65 33 5f 66 72 65 65 28 70 43 61 63 68 65 2d 3e  e3_free(pCache->
9800: 61 70 48 61 73 68 29 3b 0a 20 20 73 71 6c 69 74  apHash);.  sqlit
9810: 65 33 5f 66 72 65 65 28 70 43 61 63 68 65 29 3b  e3_free(pCache);
9820: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66  .}../*.** This f
9830: 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65  unction is calle
9840: 64 20 64 75 72 69 6e 67 20 69 6e 69 74 69 61 6c  d during initial
9850: 69 7a 61 74 69 6f 6e 20 28 73 71 6c 69 74 65 33  ization (sqlite3
9860: 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 29 20 74  _initialize()) t
9870: 6f 0a 2a 2a 20 69 6e 73 74 61 6c 6c 20 74 68 65  o.** install the
9880: 20 64 65 66 61 75 6c 74 20 70 6c 75 67 67 61 62   default pluggab
9890: 6c 65 20 63 61 63 68 65 20 6d 6f 64 75 6c 65 2c  le cache module,
98a0: 20 61 73 73 75 6d 69 6e 67 20 74 68 65 20 75 73   assuming the us
98b0: 65 72 20 68 61 73 20 6e 6f 74 0a 2a 2a 20 61 6c  er has not.** al
98c0: 72 65 61 64 79 20 70 72 6f 76 69 64 65 64 20 61  ready provided a
98d0: 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 2e 0a 2a  n alternative..*
98e0: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 43  /.void sqlite3PC
98f0: 61 63 68 65 53 65 74 44 65 66 61 75 6c 74 28 76  acheSetDefault(v
9900: 6f 69 64 29 7b 0a 20 20 73 74 61 74 69 63 20 63  oid){.  static c
9910: 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 70 63 61  onst sqlite3_pca
9920: 63 68 65 5f 6d 65 74 68 6f 64 73 32 20 64 65 66  che_methods2 def
9930: 61 75 6c 74 4d 65 74 68 6f 64 73 20 3d 20 7b 0a  aultMethods = {.
9940: 20 20 20 20 31 2c 20 20 20 20 20 20 20 20 20 20      1,          
9950: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
9960: 69 56 65 72 73 69 6f 6e 20 2a 2f 0a 20 20 20 20  iVersion */.    
9970: 30 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  0,              
9980: 20 20 20 20 20 20 20 20 20 2f 2a 20 70 41 72 67           /* pArg
9990: 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 49   */.    pcache1I
99a0: 6e 69 74 2c 20 20 20 20 20 20 20 20 20 20 20 20  nit,            
99b0: 20 2f 2a 20 78 49 6e 69 74 20 2a 2f 0a 20 20 20   /* xInit */.   
99c0: 20 70 63 61 63 68 65 31 53 68 75 74 64 6f 77 6e   pcache1Shutdown
99d0: 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 78 53 68  ,         /* xSh
99e0: 75 74 64 6f 77 6e 20 2a 2f 0a 20 20 20 20 70 63  utdown */.    pc
99f0: 61 63 68 65 31 43 72 65 61 74 65 2c 20 20 20 20  ache1Create,    
9a00: 20 20 20 20 20 20 20 2f 2a 20 78 43 72 65 61 74         /* xCreat
9a10: 65 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31  e */.    pcache1
9a20: 43 61 63 68 65 73 69 7a 65 2c 20 20 20 20 20 20  Cachesize,      
9a30: 20 20 2f 2a 20 78 43 61 63 68 65 73 69 7a 65 20    /* xCachesize 
9a40: 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 50 61  */.    pcache1Pa
9a50: 67 65 63 6f 75 6e 74 2c 20 20 20 20 20 20 20 20  gecount,        
9a60: 2f 2a 20 78 50 61 67 65 63 6f 75 6e 74 20 2a 2f  /* xPagecount */
9a70: 0a 20 20 20 20 70 63 61 63 68 65 31 46 65 74 63  .    pcache1Fetc
9a80: 68 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  h,            /*
9a90: 20 78 46 65 74 63 68 20 2a 2f 0a 20 20 20 20 70   xFetch */.    p
9aa0: 63 61 63 68 65 31 55 6e 70 69 6e 2c 20 20 20 20  cache1Unpin,    
9ab0: 20 20 20 20 20 20 20 20 2f 2a 20 78 55 6e 70 69          /* xUnpi
9ac0: 6e 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31  n */.    pcache1
9ad0: 52 65 6b 65 79 2c 20 20 20 20 20 20 20 20 20 20  Rekey,          
9ae0: 20 20 2f 2a 20 78 52 65 6b 65 79 20 2a 2f 0a 20    /* xRekey */. 
9af0: 20 20 20 70 63 61 63 68 65 31 54 72 75 6e 63 61     pcache1Trunca
9b00: 74 65 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 78  te,         /* x
9b10: 54 72 75 6e 63 61 74 65 20 2a 2f 0a 20 20 20 20  Truncate */.    
9b20: 70 63 61 63 68 65 31 44 65 73 74 72 6f 79 2c 20  pcache1Destroy, 
9b30: 20 20 20 20 20 20 20 20 20 2f 2a 20 78 44 65 73           /* xDes
9b40: 74 72 6f 79 20 2a 2f 0a 20 20 20 20 70 63 61 63  troy */.    pcac
9b50: 68 65 31 53 68 72 69 6e 6b 20 20 20 20 20 20 20  he1Shrink       
9b60: 20 20 20 20 20 2f 2a 20 78 53 68 72 69 6e 6b 20       /* xShrink 
9b70: 2a 2f 0a 20 20 7d 3b 0a 20 20 73 71 6c 69 74 65  */.  };.  sqlite
9b80: 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f  3_config(SQLITE_
9b90: 43 4f 4e 46 49 47 5f 50 43 41 43 48 45 32 2c 20  CONFIG_PCACHE2, 
9ba0: 26 64 65 66 61 75 6c 74 4d 65 74 68 6f 64 73 29  &defaultMethods)
9bb0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  ;.}../*.** Retur
9bc0: 6e 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68  n the size of th
9bd0: 65 20 68 65 61 64 65 72 20 6f 6e 20 65 61 63 68  e header on each
9be0: 20 70 61 67 65 20 6f 66 20 74 68 69 73 20 50 43   page of this PC
9bf0: 41 43 48 45 20 69 6d 70 6c 65 6d 65 6e 74 61 74  ACHE implementat
9c00: 69 6f 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ion..*/.int sqli
9c10: 74 65 33 48 65 61 64 65 72 53 69 7a 65 50 63 61  te3HeaderSizePca
9c20: 63 68 65 31 28 76 6f 69 64 29 7b 20 72 65 74 75  che1(void){ retu
9c30: 72 6e 20 52 4f 55 4e 44 38 28 73 69 7a 65 6f 66  rn ROUND8(sizeof
9c40: 28 50 67 48 64 72 31 29 29 3b 20 7d 0a 0a 2f 2a  (PgHdr1)); }../*
9c50: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 67  .** Return the g
9c60: 6c 6f 62 61 6c 20 6d 75 74 65 78 20 75 73 65 64  lobal mutex used
9c70: 20 62 79 20 74 68 69 73 20 50 43 41 43 48 45 20   by this PCACHE 
9c80: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 20  implementation. 
9c90: 20 54 68 65 0a 2a 2a 20 73 71 6c 69 74 65 33 5f   The.** sqlite3_
9ca0: 73 74 61 74 75 73 28 29 20 72 6f 75 74 69 6e 65  status() routine
9cb0: 20 6e 65 65 64 73 20 61 63 63 65 73 73 20 74 6f   needs access to
9cc0: 20 74 68 69 73 20 6d 75 74 65 78 2e 0a 2a 2f 0a   this mutex..*/.
9cd0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 73  sqlite3_mutex *s
9ce0: 71 6c 69 74 65 33 50 63 61 63 68 65 31 4d 75 74  qlite3Pcache1Mut
9cf0: 65 78 28 76 6f 69 64 29 7b 0a 20 20 72 65 74 75  ex(void){.  retu
9d00: 72 6e 20 70 63 61 63 68 65 31 2e 6d 75 74 65 78  rn pcache1.mutex
9d10: 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49  ;.}..#ifdef SQLI
9d20: 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59  TE_ENABLE_MEMORY
9d30: 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 2f 2a 0a 2a  _MANAGEMENT./*.*
9d40: 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  * This function 
9d50: 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 66 72 65  is called to fre
9d60: 65 20 73 75 70 65 72 66 6c 75 6f 75 73 20 64 79  e superfluous dy
9d70: 6e 61 6d 69 63 61 6c 6c 79 20 61 6c 6c 6f 63 61  namically alloca
9d80: 74 65 64 20 6d 65 6d 6f 72 79 0a 2a 2a 20 68 65  ted memory.** he
9d90: 6c 64 20 62 79 20 74 68 65 20 70 61 67 65 72 20  ld by the pager 
9da0: 73 79 73 74 65 6d 2e 20 4d 65 6d 6f 72 79 20 69  system. Memory i
9db0: 6e 20 75 73 65 20 62 79 20 61 6e 79 20 53 51 4c  n use by any SQL
9dc0: 69 74 65 20 70 61 67 65 72 20 61 6c 6c 6f 63 61  ite pager alloca
9dd0: 74 65 64 0a 2a 2a 20 62 79 20 74 68 65 20 63 75  ted.** by the cu
9de0: 72 72 65 6e 74 20 74 68 72 65 61 64 20 6d 61 79  rrent thread may
9df0: 20 62 65 20 73 71 6c 69 74 65 33 5f 66 72 65 65   be sqlite3_free
9e00: 28 29 65 64 2e 0a 2a 2a 0a 2a 2a 20 6e 52 65 71  ()ed..**.** nReq
9e10: 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f   is the number o
9e20: 66 20 62 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72  f bytes of memor
9e30: 79 20 72 65 71 75 69 72 65 64 2e 20 4f 6e 63 65  y required. Once
9e40: 20 74 68 69 73 20 6d 75 63 68 20 68 61 73 0a 2a   this much has.*
9e50: 2a 20 62 65 65 6e 20 72 65 6c 65 61 73 65 64 2c  * been released,
9e60: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 72 65   the function re
9e70: 74 75 72 6e 73 2e 20 54 68 65 20 72 65 74 75 72  turns. The retur
9e80: 6e 20 76 61 6c 75 65 20 69 73 20 74 68 65 20 74  n value is the t
9e90: 6f 74 61 6c 20 6e 75 6d 62 65 72 20 0a 2a 2a 20  otal number .** 
9ea0: 6f 66 20 62 79 74 65 73 20 6f 66 20 6d 65 6d 6f  of bytes of memo
9eb0: 72 79 20 72 65 6c 65 61 73 65 64 2e 0a 2a 2f 0a  ry released..*/.
9ec0: 69 6e 74 20 73 71 6c 69 74 65 33 50 63 61 63 68  int sqlite3Pcach
9ed0: 65 52 65 6c 65 61 73 65 4d 65 6d 6f 72 79 28 69  eReleaseMemory(i
9ee0: 6e 74 20 6e 52 65 71 29 7b 0a 20 20 69 6e 74 20  nt nReq){.  int 
9ef0: 6e 46 72 65 65 20 3d 20 30 3b 0a 20 20 61 73 73  nFree = 0;.  ass
9f00: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74  ert( sqlite3_mut
9f10: 65 78 5f 6e 6f 74 68 65 6c 64 28 70 63 61 63 68  ex_notheld(pcach
9f20: 65 31 2e 67 72 70 2e 6d 75 74 65 78 29 20 29 3b  e1.grp.mutex) );
9f30: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74  .  assert( sqlit
9f40: 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c 64  e3_mutex_notheld
9f50: 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29 20  (pcache1.mutex) 
9f60: 29 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33  );.  if( sqlite3
9f70: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61  GlobalConfig.pPa
9f80: 67 65 3d 3d 30 20 29 7b 0a 20 20 20 20 50 67 48  ge==0 ){.    PgH
9f90: 64 72 31 20 2a 70 3b 0a 20 20 20 20 70 63 61 63  dr1 *p;.    pcac
9fa0: 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 26 70  he1EnterMutex(&p
9fb0: 63 61 63 68 65 31 2e 67 72 70 29 3b 0a 20 20 20  cache1.grp);.   
9fc0: 20 77 68 69 6c 65 28 20 28 6e 52 65 71 3c 30 20   while( (nReq<0 
9fd0: 7c 7c 20 6e 46 72 65 65 3c 6e 52 65 71 29 0a 20  || nFree<nReq). 
9fe0: 20 20 20 20 20 20 26 26 20 20 28 70 3d 70 63 61        &&  (p=pca
9ff0: 63 68 65 31 2e 67 72 70 2e 6c 72 75 2e 70 4c 72  che1.grp.lru.pLr
a000: 75 50 72 65 76 29 21 3d 30 0a 20 20 20 20 20 20  uPrev)!=0.      
a010: 20 26 26 20 20 70 2d 3e 69 73 41 6e 63 68 6f 72   &&  p->isAnchor
a020: 3d 3d 30 0a 20 20 20 20 29 7b 0a 20 20 20 20 20  ==0.    ){.     
a030: 20 6e 46 72 65 65 20 2b 3d 20 70 63 61 63 68 65   nFree += pcache
a040: 31 4d 65 6d 53 69 7a 65 28 70 2d 3e 70 61 67 65  1MemSize(p->page
a050: 2e 70 42 75 66 29 3b 0a 23 69 66 64 65 66 20 53  .pBuf);.#ifdef S
a060: 51 4c 49 54 45 5f 50 43 41 43 48 45 5f 53 45 50  QLITE_PCACHE_SEP
a070: 41 52 41 54 45 5f 48 45 41 44 45 52 0a 20 20 20  ARATE_HEADER.   
a080: 20 20 20 6e 46 72 65 65 20 2b 3d 20 73 71 6c 69     nFree += sqli
a090: 74 65 33 4d 65 6d 53 69 7a 65 28 70 29 3b 0a 23  te3MemSize(p);.#
a0a0: 65 6e 64 69 66 0a 20 20 20 20 20 20 61 73 73 65  endif.      asse
a0b0: 72 74 28 20 70 2d 3e 69 73 50 69 6e 6e 65 64 3d  rt( p->isPinned=
a0c0: 3d 30 20 29 3b 0a 20 20 20 20 20 20 70 63 61 63  =0 );.      pcac
a0d0: 68 65 31 50 69 6e 50 61 67 65 28 70 29 3b 0a 20  he1PinPage(p);. 
a0e0: 20 20 20 20 20 70 63 61 63 68 65 31 52 65 6d 6f       pcache1Remo
a0f0: 76 65 46 72 6f 6d 48 61 73 68 28 70 2c 20 31 29  veFromHash(p, 1)
a100: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 63 61 63  ;.    }.    pcac
a110: 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 26 70  he1LeaveMutex(&p
a120: 63 61 63 68 65 31 2e 67 72 70 29 3b 0a 20 20 7d  cache1.grp);.  }
a130: 0a 20 20 72 65 74 75 72 6e 20 6e 46 72 65 65 3b  .  return nFree;
a140: 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c  .}.#endif /* SQL
a150: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52  ITE_ENABLE_MEMOR
a160: 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 20 2a 2f 0a  Y_MANAGEMENT */.
a170: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54  .#ifdef SQLITE_T
a180: 45 53 54 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66  EST./*.** This f
a190: 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20  unction is used 
a1a0: 62 79 20 74 65 73 74 20 70 72 6f 63 65 64 75 72  by test procedur
a1b0: 65 73 20 74 6f 20 69 6e 73 70 65 63 74 20 74 68  es to inspect th
a1c0: 65 20 69 6e 74 65 72 6e 61 6c 20 73 74 61 74 65  e internal state
a1d0: 0a 2a 2a 20 6f 66 20 74 68 65 20 67 6c 6f 62 61  .** of the globa
a1e0: 6c 20 63 61 63 68 65 2e 0a 2a 2f 0a 76 6f 69 64  l cache..*/.void
a1f0: 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 53 74   sqlite3PcacheSt
a200: 61 74 73 28 0a 20 20 69 6e 74 20 2a 70 6e 43 75  ats(.  int *pnCu
a210: 72 72 65 6e 74 2c 20 20 20 20 20 20 2f 2a 20 4f  rrent,      /* O
a220: 55 54 3a 20 54 6f 74 61 6c 20 6e 75 6d 62 65 72  UT: Total number
a230: 20 6f 66 20 70 61 67 65 73 20 63 61 63 68 65 64   of pages cached
a240: 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 4d 61 78   */.  int *pnMax
a250: 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55  ,          /* OU
a260: 54 3a 20 47 6c 6f 62 61 6c 20 6d 61 78 69 6d 75  T: Global maximu
a270: 6d 20 63 61 63 68 65 20 73 69 7a 65 20 2a 2f 0a  m cache size */.
a280: 20 20 69 6e 74 20 2a 70 6e 4d 69 6e 2c 20 20 20    int *pnMin,   
a290: 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 53         /* OUT: S
a2a0: 75 6d 20 6f 66 20 50 43 61 63 68 65 31 2e 6e 4d  um of PCache1.nM
a2b0: 69 6e 20 66 6f 72 20 70 75 72 67 65 61 62 6c 65  in for purgeable
a2c0: 20 63 61 63 68 65 73 20 2a 2f 0a 20 20 69 6e 74   caches */.  int
a2d0: 20 2a 70 6e 52 65 63 79 63 6c 61 62 6c 65 20 20   *pnRecyclable  
a2e0: 20 20 2f 2a 20 4f 55 54 3a 20 54 6f 74 61 6c 20    /* OUT: Total 
a2f0: 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20  number of pages 
a300: 61 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 72 65  available for re
a310: 63 79 63 6c 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20  cycling */.){.  
a320: 50 67 48 64 72 31 20 2a 70 3b 0a 20 20 69 6e 74  PgHdr1 *p;.  int
a330: 20 6e 52 65 63 79 63 6c 61 62 6c 65 20 3d 20 30   nRecyclable = 0
a340: 3b 0a 20 20 66 6f 72 28 70 3d 70 63 61 63 68 65  ;.  for(p=pcache
a350: 31 2e 67 72 70 2e 6c 72 75 2e 70 4c 72 75 4e 65  1.grp.lru.pLruNe
a360: 78 74 3b 20 70 20 26 26 20 21 70 2d 3e 69 73 41  xt; p && !p->isA
a370: 6e 63 68 6f 72 3b 20 70 3d 70 2d 3e 70 4c 72 75  nchor; p=p->pLru
a380: 4e 65 78 74 29 7b 0a 20 20 20 20 61 73 73 65 72  Next){.    asser
a390: 74 28 20 70 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d  t( p->isPinned==
a3a0: 30 20 29 3b 0a 20 20 20 20 6e 52 65 63 79 63 6c  0 );.    nRecycl
a3b0: 61 62 6c 65 2b 2b 3b 0a 20 20 7d 0a 20 20 2a 70  able++;.  }.  *p
a3c0: 6e 43 75 72 72 65 6e 74 20 3d 20 70 63 61 63 68  nCurrent = pcach
a3d0: 65 31 2e 67 72 70 2e 6e 43 75 72 72 65 6e 74 50  e1.grp.nCurrentP
a3e0: 61 67 65 3b 0a 20 20 2a 70 6e 4d 61 78 20 3d 20  age;.  *pnMax = 
a3f0: 28 69 6e 74 29 70 63 61 63 68 65 31 2e 67 72 70  (int)pcache1.grp
a400: 2e 6e 4d 61 78 50 61 67 65 3b 0a 20 20 2a 70 6e  .nMaxPage;.  *pn
a410: 4d 69 6e 20 3d 20 28 69 6e 74 29 70 63 61 63 68  Min = (int)pcach
a420: 65 31 2e 67 72 70 2e 6e 4d 69 6e 50 61 67 65 3b  e1.grp.nMinPage;
a430: 0a 20 20 2a 70 6e 52 65 63 79 63 6c 61 62 6c 65  .  *pnRecyclable
a440: 20 3d 20 6e 52 65 63 79 63 6c 61 62 6c 65 3b 0a   = nRecyclable;.
a450: 7d 0a 23 65 6e 64 69 66 0a                       }.#endif.