/ Hex Artifact Content
Login

Artifact 4bb7a6a5300c67d0b033d25adb509c120c03e812:


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 70 43 61  che->szAlloc*pCa
30f0: 63 68 65 2d 3e 6e 4d 61 78 3b 0a 20 20 7d 0a 20  che->nMax;.  }. 
3100: 20 7a 42 75 6c 6b 20 3d 20 70 43 61 63 68 65 2d   zBulk = pCache-
3110: 3e 70 42 75 6c 6b 20 3d 20 73 71 6c 69 74 65 33  >pBulk = sqlite3
3120: 4d 61 6c 6c 6f 63 28 20 73 7a 42 75 6c 6b 20 29  Malloc( szBulk )
3130: 3b 0a 20 20 73 71 6c 69 74 65 33 45 6e 64 42 65  ;.  sqlite3EndBe
3140: 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20  nignMalloc();.  
3150: 69 66 28 20 7a 42 75 6c 6b 20 29 7b 0a 20 20 20  if( zBulk ){.   
3160: 20 69 6e 74 20 6e 42 75 6c 6b 20 3d 20 73 71 6c   int nBulk = sql
3170: 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 7a  ite3MallocSize(z
3180: 42 75 6c 6b 29 2f 70 43 61 63 68 65 2d 3e 73 7a  Bulk)/pCache->sz
3190: 41 6c 6c 6f 63 3b 0a 20 20 20 20 69 6e 74 20 69  Alloc;.    int i
31a0: 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69  ;.    for(i=0; i
31b0: 3c 6e 42 75 6c 6b 3b 20 69 2b 2b 29 7b 0a 20 20  <nBulk; i++){.  
31c0: 20 20 20 20 50 67 48 64 72 31 20 2a 70 58 20 3d      PgHdr1 *pX =
31d0: 20 28 50 67 48 64 72 31 2a 29 26 7a 42 75 6c 6b   (PgHdr1*)&zBulk
31e0: 5b 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 5d  [pCache->szPage]
31f0: 3b 0a 20 20 20 20 20 20 70 58 2d 3e 70 61 67 65  ;.      pX->page
3200: 2e 70 42 75 66 20 3d 20 7a 42 75 6c 6b 3b 0a 20  .pBuf = zBulk;. 
3210: 20 20 20 20 20 70 58 2d 3e 70 61 67 65 2e 70 45       pX->page.pE
3220: 78 74 72 61 20 3d 20 26 70 58 5b 31 5d 3b 0a 20  xtra = &pX[1];. 
3230: 20 20 20 20 20 70 58 2d 3e 69 73 42 75 6c 6b 4c       pX->isBulkL
3240: 6f 63 61 6c 20 3d 20 31 3b 0a 20 20 20 20 20 20  ocal = 1;.      
3250: 70 58 2d 3e 69 73 41 6e 63 68 6f 72 20 3d 20 30  pX->isAnchor = 0
3260: 3b 0a 20 20 20 20 20 20 70 58 2d 3e 70 4e 65 78  ;.      pX->pNex
3270: 74 20 3d 20 70 43 61 63 68 65 2d 3e 70 46 72 65  t = pCache->pFre
3280: 65 3b 0a 20 20 20 20 20 20 70 43 61 63 68 65 2d  e;.      pCache-
3290: 3e 70 46 72 65 65 20 3d 20 70 58 3b 0a 20 20 20  >pFree = pX;.   
32a0: 20 20 20 7a 42 75 6c 6b 20 2b 3d 20 70 43 61 63     zBulk += pCac
32b0: 68 65 2d 3e 73 7a 41 6c 6c 6f 63 3b 0a 20 20 20  he->szAlloc;.   
32c0: 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20   }.  }.  return 
32d0: 70 43 61 63 68 65 2d 3e 70 46 72 65 65 21 3d 30  pCache->pFree!=0
32e0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6c 6c 6f  ;.}../*.** Mallo
32f0: 63 20 66 75 6e 63 74 69 6f 6e 20 75 73 65 64 20  c function used 
3300: 77 69 74 68 69 6e 20 74 68 69 73 20 66 69 6c 65  within this file
3310: 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 73 70 61   to allocate spa
3320: 63 65 20 66 72 6f 6d 20 74 68 65 20 62 75 66 66  ce from the buff
3330: 65 72 0a 2a 2a 20 63 6f 6e 66 69 67 75 72 65 64  er.** configured
3340: 20 75 73 69 6e 67 20 73 71 6c 69 74 65 33 5f 63   using sqlite3_c
3350: 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e  onfig(SQLITE_CON
3360: 46 49 47 5f 50 41 47 45 43 41 43 48 45 29 20 6f  FIG_PAGECACHE) o
3370: 70 74 69 6f 6e 2e 20 49 66 20 6e 6f 20 0a 2a 2a  ption. If no .**
3380: 20 73 75 63 68 20 62 75 66 66 65 72 20 65 78 69   such buffer exi
3390: 73 74 73 20 6f 72 20 74 68 65 72 65 20 69 73 20  sts or there is 
33a0: 6e 6f 20 73 70 61 63 65 20 6c 65 66 74 20 69 6e  no space left in
33b0: 20 69 74 2c 20 74 68 69 73 20 66 75 6e 63 74 69   it, this functi
33c0: 6f 6e 20 66 61 6c 6c 73 20 0a 2a 2a 20 62 61 63  on falls .** bac
33d0: 6b 20 74 6f 20 73 71 6c 69 74 65 33 4d 61 6c 6c  k to sqlite3Mall
33e0: 6f 63 28 29 2e 0a 2a 2a 0a 2a 2a 20 4d 75 6c 74  oc()..**.** Mult
33f0: 69 70 6c 65 20 74 68 72 65 61 64 73 20 63 61 6e  iple threads can
3400: 20 72 75 6e 20 74 68 69 73 20 72 6f 75 74 69 6e   run this routin
3410: 65 20 61 74 20 74 68 65 20 73 61 6d 65 20 74 69  e at the same ti
3420: 6d 65 2e 20 20 47 6c 6f 62 61 6c 20 76 61 72 69  me.  Global vari
3430: 61 62 6c 65 73 0a 2a 2a 20 69 6e 20 70 63 61 63  ables.** in pcac
3440: 68 65 31 20 6e 65 65 64 20 74 6f 20 62 65 20 70  he1 need to be p
3450: 72 6f 74 65 63 74 65 64 20 76 69 61 20 6d 75 74  rotected via mut
3460: 65 78 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  ex..*/.static vo
3470: 69 64 20 2a 70 63 61 63 68 65 31 41 6c 6c 6f 63  id *pcache1Alloc
3480: 28 69 6e 74 20 6e 42 79 74 65 29 7b 0a 20 20 76  (int nByte){.  v
3490: 6f 69 64 20 2a 70 20 3d 20 30 3b 0a 20 20 61 73  oid *p = 0;.  as
34a0: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75  sert( sqlite3_mu
34b0: 74 65 78 5f 6e 6f 74 68 65 6c 64 28 70 63 61 63  tex_notheld(pcac
34c0: 68 65 31 2e 67 72 70 2e 6d 75 74 65 78 29 20 29  he1.grp.mutex) )
34d0: 3b 0a 20 20 69 66 28 20 6e 42 79 74 65 3c 3d 70  ;.  if( nByte<=p
34e0: 63 61 63 68 65 31 2e 73 7a 53 6c 6f 74 20 29 7b  cache1.szSlot ){
34f0: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  .    sqlite3_mut
3500: 65 78 5f 65 6e 74 65 72 28 70 63 61 63 68 65 31  ex_enter(pcache1
3510: 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 70 20 3d  .mutex);.    p =
3520: 20 28 50 67 48 64 72 31 20 2a 29 70 63 61 63 68   (PgHdr1 *)pcach
3530: 65 31 2e 70 46 72 65 65 3b 0a 20 20 20 20 69 66  e1.pFree;.    if
3540: 28 20 70 20 29 7b 0a 20 20 20 20 20 20 70 63 61  ( p ){.      pca
3550: 63 68 65 31 2e 70 46 72 65 65 20 3d 20 70 63 61  che1.pFree = pca
3560: 63 68 65 31 2e 70 46 72 65 65 2d 3e 70 4e 65 78  che1.pFree->pNex
3570: 74 3b 0a 20 20 20 20 20 20 70 63 61 63 68 65 31  t;.      pcache1
3580: 2e 6e 46 72 65 65 53 6c 6f 74 2d 2d 3b 0a 20 20  .nFreeSlot--;.  
3590: 20 20 20 20 70 63 61 63 68 65 31 2e 62 55 6e 64      pcache1.bUnd
35a0: 65 72 50 72 65 73 73 75 72 65 20 3d 20 70 63 61  erPressure = pca
35b0: 63 68 65 31 2e 6e 46 72 65 65 53 6c 6f 74 3c 70  che1.nFreeSlot<p
35c0: 63 61 63 68 65 31 2e 6e 52 65 73 65 72 76 65 3b  cache1.nReserve;
35d0: 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70  .      assert( p
35e0: 63 61 63 68 65 31 2e 6e 46 72 65 65 53 6c 6f 74  cache1.nFreeSlot
35f0: 3e 3d 30 20 29 3b 0a 20 20 20 20 20 20 73 71 6c  >=0 );.      sql
3600: 69 74 65 33 53 74 61 74 75 73 48 69 67 68 77 61  ite3StatusHighwa
3610: 74 65 72 28 53 51 4c 49 54 45 5f 53 54 41 54 55  ter(SQLITE_STATU
3620: 53 5f 50 41 47 45 43 41 43 48 45 5f 53 49 5a 45  S_PAGECACHE_SIZE
3630: 2c 20 6e 42 79 74 65 29 3b 0a 20 20 20 20 20 20  , nByte);.      
3640: 73 71 6c 69 74 65 33 53 74 61 74 75 73 55 70 28  sqlite3StatusUp(
3650: 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 50 41  SQLITE_STATUS_PA
3660: 47 45 43 41 43 48 45 5f 55 53 45 44 2c 20 31 29  GECACHE_USED, 1)
3670: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69  ;.    }.    sqli
3680: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
3690: 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a  pcache1.mutex);.
36a0: 20 20 7d 0a 20 20 69 66 28 20 70 3d 3d 30 20 29    }.  if( p==0 )
36b0: 7b 0a 20 20 20 20 2f 2a 20 4d 65 6d 6f 72 79 20  {.    /* Memory 
36c0: 69 73 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65  is not available
36d0: 20 69 6e 20 74 68 65 20 53 51 4c 49 54 45 5f 43   in the SQLITE_C
36e0: 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45 20  ONFIG_PAGECACHE 
36f0: 70 6f 6f 6c 2e 20 20 47 65 74 0a 20 20 20 20 2a  pool.  Get.    *
3700: 2a 20 69 74 20 66 72 6f 6d 20 73 71 6c 69 74 65  * it from sqlite
3710: 33 4d 61 6c 6c 6f 63 20 69 6e 73 74 65 61 64 2e  3Malloc instead.
3720: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 70 20 3d 20  .    */.    p = 
3730: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 6e 42  sqlite3Malloc(nB
3740: 79 74 65 29 3b 0a 23 69 66 6e 64 65 66 20 53 51  yte);.#ifndef SQ
3750: 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f 50 41 47  LITE_DISABLE_PAG
3760: 45 43 41 43 48 45 5f 4f 56 45 52 46 4c 4f 57 5f  ECACHE_OVERFLOW_
3770: 53 54 41 54 53 0a 20 20 20 20 69 66 28 20 70 20  STATS.    if( p 
3780: 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 73 7a 20  ){.      int sz 
3790: 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53  = sqlite3MallocS
37a0: 69 7a 65 28 70 29 3b 0a 20 20 20 20 20 20 73 71  ize(p);.      sq
37b0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
37c0: 72 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29  r(pcache1.mutex)
37d0: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 53  ;.      sqlite3S
37e0: 74 61 74 75 73 48 69 67 68 77 61 74 65 72 28 53  tatusHighwater(S
37f0: 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 50 41 47  QLITE_STATUS_PAG
3800: 45 43 41 43 48 45 5f 53 49 5a 45 2c 20 6e 42 79  ECACHE_SIZE, nBy
3810: 74 65 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74  te);.      sqlit
3820: 65 33 53 74 61 74 75 73 55 70 28 53 51 4c 49 54  e3StatusUp(SQLIT
3830: 45 5f 53 54 41 54 55 53 5f 50 41 47 45 43 41 43  E_STATUS_PAGECAC
3840: 48 45 5f 4f 56 45 52 46 4c 4f 57 2c 20 73 7a 29  HE_OVERFLOW, sz)
3850: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f  ;.      sqlite3_
3860: 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 63 61 63  mutex_leave(pcac
3870: 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20  he1.mutex);.    
3880: 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 73 71 6c  }.#endif.    sql
3890: 69 74 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54  ite3MemdebugSetT
38a0: 79 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 50  ype(p, MEMTYPE_P
38b0: 43 41 43 48 45 29 3b 0a 20 20 7d 0a 20 20 72 65  CACHE);.  }.  re
38c0: 74 75 72 6e 20 70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  turn p;.}../*.**
38d0: 20 46 72 65 65 20 61 6e 20 61 6c 6c 6f 63 61 74   Free an allocat
38e0: 65 64 20 62 75 66 66 65 72 20 6f 62 74 61 69 6e  ed buffer obtain
38f0: 65 64 20 66 72 6f 6d 20 70 63 61 63 68 65 31 41  ed from pcache1A
3900: 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a 73 74 61 74 69  lloc()..*/.stati
3910: 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 46 72  c void pcache1Fr
3920: 65 65 28 76 6f 69 64 20 2a 70 29 7b 0a 20 20 69  ee(void *p){.  i
3930: 66 28 20 70 3d 3d 30 20 29 20 72 65 74 75 72 6e  f( p==0 ) return
3940: 3b 0a 20 20 69 66 28 20 53 51 4c 49 54 45 5f 57  ;.  if( SQLITE_W
3950: 49 54 48 49 4e 28 70 2c 20 70 63 61 63 68 65 31  ITHIN(p, pcache1
3960: 2e 70 53 74 61 72 74 2c 20 70 63 61 63 68 65 31  .pStart, pcache1
3970: 2e 70 45 6e 64 29 20 29 7b 0a 20 20 20 20 50 67  .pEnd) ){.    Pg
3980: 46 72 65 65 73 6c 6f 74 20 2a 70 53 6c 6f 74 3b  Freeslot *pSlot;
3990: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  .    sqlite3_mut
39a0: 65 78 5f 65 6e 74 65 72 28 70 63 61 63 68 65 31  ex_enter(pcache1
39b0: 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 73 71 6c  .mutex);.    sql
39c0: 69 74 65 33 53 74 61 74 75 73 44 6f 77 6e 28 53  ite3StatusDown(S
39d0: 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 50 41 47  QLITE_STATUS_PAG
39e0: 45 43 41 43 48 45 5f 55 53 45 44 2c 20 31 29 3b  ECACHE_USED, 1);
39f0: 0a 20 20 20 20 70 53 6c 6f 74 20 3d 20 28 50 67  .    pSlot = (Pg
3a00: 46 72 65 65 73 6c 6f 74 2a 29 70 3b 0a 20 20 20  Freeslot*)p;.   
3a10: 20 70 53 6c 6f 74 2d 3e 70 4e 65 78 74 20 3d 20   pSlot->pNext = 
3a20: 70 63 61 63 68 65 31 2e 70 46 72 65 65 3b 0a 20  pcache1.pFree;. 
3a30: 20 20 20 70 63 61 63 68 65 31 2e 70 46 72 65 65     pcache1.pFree
3a40: 20 3d 20 70 53 6c 6f 74 3b 0a 20 20 20 20 70 63   = pSlot;.    pc
3a50: 61 63 68 65 31 2e 6e 46 72 65 65 53 6c 6f 74 2b  ache1.nFreeSlot+
3a60: 2b 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 62  +;.    pcache1.b
3a70: 55 6e 64 65 72 50 72 65 73 73 75 72 65 20 3d 20  UnderPressure = 
3a80: 70 63 61 63 68 65 31 2e 6e 46 72 65 65 53 6c 6f  pcache1.nFreeSlo
3a90: 74 3c 70 63 61 63 68 65 31 2e 6e 52 65 73 65 72  t<pcache1.nReser
3aa0: 76 65 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20  ve;.    assert( 
3ab0: 70 63 61 63 68 65 31 2e 6e 46 72 65 65 53 6c 6f  pcache1.nFreeSlo
3ac0: 74 3c 3d 70 63 61 63 68 65 31 2e 6e 53 6c 6f 74  t<=pcache1.nSlot
3ad0: 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f   );.    sqlite3_
3ae0: 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 63 61 63  mutex_leave(pcac
3af0: 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20 7d 65  he1.mutex);.  }e
3b00: 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 72 74 28  lse{.    assert(
3b10: 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67   sqlite3Memdebug
3b20: 48 61 73 54 79 70 65 28 70 2c 20 4d 45 4d 54 59  HasType(p, MEMTY
3b30: 50 45 5f 50 43 41 43 48 45 29 20 29 3b 0a 20 20  PE_PCACHE) );.  
3b40: 20 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75    sqlite3Memdebu
3b50: 67 53 65 74 54 79 70 65 28 70 2c 20 4d 45 4d 54  gSetType(p, MEMT
3b60: 59 50 45 5f 48 45 41 50 29 3b 0a 23 69 66 6e 64  YPE_HEAP);.#ifnd
3b70: 65 66 20 53 51 4c 49 54 45 5f 44 49 53 41 42 4c  ef SQLITE_DISABL
3b80: 45 5f 50 41 47 45 43 41 43 48 45 5f 4f 56 45 52  E_PAGECACHE_OVER
3b90: 46 4c 4f 57 5f 53 54 41 54 53 0a 20 20 20 20 7b  FLOW_STATS.    {
3ba0: 0a 20 20 20 20 20 20 69 6e 74 20 6e 46 72 65 65  .      int nFree
3bb0: 64 20 3d 20 30 3b 0a 20 20 20 20 20 20 6e 46 72  d = 0;.      nFr
3bc0: 65 65 64 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c  eed = sqlite3Mal
3bd0: 6c 6f 63 53 69 7a 65 28 70 29 3b 0a 20 20 20 20  locSize(p);.    
3be0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f    sqlite3_mutex_
3bf0: 65 6e 74 65 72 28 70 63 61 63 68 65 31 2e 6d 75  enter(pcache1.mu
3c00: 74 65 78 29 3b 0a 20 20 20 20 20 20 73 71 6c 69  tex);.      sqli
3c10: 74 65 33 53 74 61 74 75 73 44 6f 77 6e 28 53 51  te3StatusDown(SQ
3c20: 4c 49 54 45 5f 53 54 41 54 55 53 5f 50 41 47 45  LITE_STATUS_PAGE
3c30: 43 41 43 48 45 5f 4f 56 45 52 46 4c 4f 57 2c 20  CACHE_OVERFLOW, 
3c40: 6e 46 72 65 65 64 29 3b 0a 20 20 20 20 20 20 73  nFreed);.      s
3c50: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
3c60: 76 65 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78  ve(pcache1.mutex
3c70: 29 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a  );.    }.#endif.
3c80: 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65      sqlite3_free
3c90: 28 70 29 3b 0a 20 20 7d 0a 7d 0a 0a 23 69 66 64  (p);.  }.}..#ifd
3ca0: 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  ef SQLITE_ENABLE
3cb0: 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45  _MEMORY_MANAGEME
3cc0: 4e 54 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  NT./*.** Return 
3cd0: 74 68 65 20 73 69 7a 65 20 6f 66 20 61 20 70 63  the size of a pc
3ce0: 61 63 68 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 0a  ache allocation.
3cf0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 63  */.static int pc
3d00: 61 63 68 65 31 4d 65 6d 53 69 7a 65 28 76 6f 69  ache1MemSize(voi
3d10: 64 20 2a 70 29 7b 0a 20 20 69 66 28 20 70 3e 3d  d *p){.  if( p>=
3d20: 70 63 61 63 68 65 31 2e 70 53 74 61 72 74 20 26  pcache1.pStart &
3d30: 26 20 70 3c 70 63 61 63 68 65 31 2e 70 45 6e 64  & p<pcache1.pEnd
3d40: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 70   ){.    return p
3d50: 63 61 63 68 65 31 2e 73 7a 53 6c 6f 74 3b 0a 20  cache1.szSlot;. 
3d60: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 6e 74 20   }else{.    int 
3d70: 69 53 69 7a 65 3b 0a 20 20 20 20 61 73 73 65 72  iSize;.    asser
3d80: 74 28 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62  t( sqlite3Memdeb
3d90: 75 67 48 61 73 54 79 70 65 28 70 2c 20 4d 45 4d  ugHasType(p, MEM
3da0: 54 59 50 45 5f 50 43 41 43 48 45 29 20 29 3b 0a  TYPE_PCACHE) );.
3db0: 20 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 64 65      sqlite3Memde
3dc0: 62 75 67 53 65 74 54 79 70 65 28 70 2c 20 4d 45  bugSetType(p, ME
3dd0: 4d 54 59 50 45 5f 48 45 41 50 29 3b 0a 20 20 20  MTYPE_HEAP);.   
3de0: 20 69 53 69 7a 65 20 3d 20 73 71 6c 69 74 65 33   iSize = sqlite3
3df0: 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 29 3b 0a 20  MallocSize(p);. 
3e00: 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62     sqlite3Memdeb
3e10: 75 67 53 65 74 54 79 70 65 28 70 2c 20 4d 45 4d  ugSetType(p, MEM
3e20: 54 59 50 45 5f 50 43 41 43 48 45 29 3b 0a 20 20  TYPE_PCACHE);.  
3e30: 20 20 72 65 74 75 72 6e 20 69 53 69 7a 65 3b 0a    return iSize;.
3e40: 20 20 7d 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20    }.}.#endif /* 
3e50: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45  SQLITE_ENABLE_ME
3e60: 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 20  MORY_MANAGEMENT 
3e70: 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61  */../*.** Alloca
3e80: 74 65 20 61 20 6e 65 77 20 70 61 67 65 20 6f 62  te a new page ob
3e90: 6a 65 63 74 20 69 6e 69 74 69 61 6c 6c 79 20 61  ject initially a
3ea0: 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 63  ssociated with c
3eb0: 61 63 68 65 20 70 43 61 63 68 65 2e 0a 2a 2f 0a  ache pCache..*/.
3ec0: 73 74 61 74 69 63 20 50 67 48 64 72 31 20 2a 70  static PgHdr1 *p
3ed0: 63 61 63 68 65 31 41 6c 6c 6f 63 50 61 67 65 28  cache1AllocPage(
3ee0: 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 2c  PCache1 *pCache,
3ef0: 20 69 6e 74 20 62 65 6e 69 67 6e 4d 61 6c 6c 6f   int benignMallo
3f00: 63 29 7b 0a 20 20 50 67 48 64 72 31 20 2a 70 20  c){.  PgHdr1 *p 
3f10: 3d 20 30 3b 0a 20 20 76 6f 69 64 20 2a 70 50 67  = 0;.  void *pPg
3f20: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c  ;..  assert( sql
3f30: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28  ite3_mutex_held(
3f40: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e  pCache->pGroup->
3f50: 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20  mutex) );.  if( 
3f60: 70 43 61 63 68 65 2d 3e 70 46 72 65 65 20 7c 7c  pCache->pFree ||
3f70: 20 28 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 3d   (pCache->nPage=
3f80: 3d 30 20 26 26 20 70 63 61 63 68 65 31 49 6e 69  =0 && pcache1Ini
3f90: 74 42 75 6c 6b 28 70 43 61 63 68 65 29 29 20 29  tBulk(pCache)) )
3fa0: 7b 0a 20 20 20 20 70 20 3d 20 70 43 61 63 68 65  {.    p = pCache
3fb0: 2d 3e 70 46 72 65 65 3b 0a 20 20 20 20 70 43 61  ->pFree;.    pCa
3fc0: 63 68 65 2d 3e 70 46 72 65 65 20 3d 20 70 2d 3e  che->pFree = p->
3fd0: 70 4e 65 78 74 3b 0a 20 20 20 20 70 2d 3e 70 4e  pNext;.    p->pN
3fe0: 65 78 74 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65  ext = 0;.  }else
3ff0: 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  {.#ifdef SQLITE_
4000: 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41  ENABLE_MEMORY_MA
4010: 4e 41 47 45 4d 45 4e 54 0a 20 20 20 20 2f 2a 20  NAGEMENT.    /* 
4020: 54 68 65 20 67 72 6f 75 70 20 6d 75 74 65 78 20  The group mutex 
4030: 6d 75 73 74 20 62 65 20 72 65 6c 65 61 73 65 64  must be released
4040: 20 62 65 66 6f 72 65 20 70 63 61 63 68 65 31 41   before pcache1A
4050: 6c 6c 6f 63 28 29 20 69 73 20 63 61 6c 6c 65 64  lloc() is called
4060: 2e 20 54 68 69 73 0a 20 20 20 20 2a 2a 20 69 73  . This.    ** is
4070: 20 62 65 63 61 75 73 65 20 69 74 20 6d 69 67 68   because it migh
4080: 74 20 63 61 6c 6c 20 73 71 6c 69 74 65 33 5f 72  t call sqlite3_r
4090: 65 6c 65 61 73 65 5f 6d 65 6d 6f 72 79 28 29 2c  elease_memory(),
40a0: 20 77 68 69 63 68 20 61 73 73 75 6d 65 73 20 74   which assumes t
40b0: 68 61 74 20 0a 20 20 20 20 2a 2a 20 74 68 69 73  hat .    ** this
40c0: 20 6d 75 74 65 78 20 69 73 20 6e 6f 74 20 68 65   mutex is not he
40d0: 6c 64 2e 20 2a 2f 0a 20 20 20 20 61 73 73 65 72  ld. */.    asser
40e0: 74 28 20 70 63 61 63 68 65 31 2e 73 65 70 61 72  t( pcache1.separ
40f0: 61 74 65 43 61 63 68 65 3d 3d 30 20 29 3b 0a 20  ateCache==0 );. 
4100: 20 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68     assert( pCach
4110: 65 2d 3e 70 47 72 6f 75 70 3d 3d 26 70 63 61 63  e->pGroup==&pcac
4120: 68 65 31 2e 67 72 70 20 29 3b 0a 20 20 20 20 70  he1.grp );.    p
4130: 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78  cache1LeaveMutex
4140: 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29  (pCache->pGroup)
4150: 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 69 66 28  ;.#endif.    if(
4160: 20 62 65 6e 69 67 6e 4d 61 6c 6c 6f 63 20 29 7b   benignMalloc ){
4170: 20 73 71 6c 69 74 65 33 42 65 67 69 6e 42 65 6e   sqlite3BeginBen
4180: 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 20 7d 0a 23  ignMalloc(); }.#
4190: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 50 43 41  ifdef SQLITE_PCA
41a0: 43 48 45 5f 53 45 50 41 52 41 54 45 5f 48 45 41  CHE_SEPARATE_HEA
41b0: 44 45 52 0a 20 20 20 20 70 50 67 20 3d 20 70 63  DER.    pPg = pc
41c0: 61 63 68 65 31 41 6c 6c 6f 63 28 70 43 61 63 68  ache1Alloc(pCach
41d0: 65 2d 3e 73 7a 50 61 67 65 29 3b 0a 20 20 20 20  e->szPage);.    
41e0: 70 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f  p = sqlite3Mallo
41f0: 63 28 73 69 7a 65 6f 66 28 50 67 48 64 72 31 29  c(sizeof(PgHdr1)
4200: 20 2b 20 70 43 61 63 68 65 2d 3e 73 7a 45 78 74   + pCache->szExt
4210: 72 61 29 3b 0a 20 20 20 20 69 66 28 20 21 70 50  ra);.    if( !pP
4220: 67 20 7c 7c 20 21 70 20 29 7b 0a 20 20 20 20 20  g || !p ){.     
4230: 20 70 63 61 63 68 65 31 46 72 65 65 28 70 50 67   pcache1Free(pPg
4240: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  );.      sqlite3
4250: 5f 66 72 65 65 28 70 29 3b 0a 20 20 20 20 20 20  _free(p);.      
4260: 70 50 67 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 23  pPg = 0;.    }.#
4270: 65 6c 73 65 0a 20 20 20 20 70 50 67 20 3d 20 70  else.    pPg = p
4280: 63 61 63 68 65 31 41 6c 6c 6f 63 28 70 43 61 63  cache1Alloc(pCac
4290: 68 65 2d 3e 73 7a 41 6c 6c 6f 63 29 3b 0a 20 20  he->szAlloc);.  
42a0: 20 20 70 20 3d 20 28 50 67 48 64 72 31 20 2a 29    p = (PgHdr1 *)
42b0: 26 28 28 75 38 20 2a 29 70 50 67 29 5b 70 43 61  &((u8 *)pPg)[pCa
42c0: 63 68 65 2d 3e 73 7a 50 61 67 65 5d 3b 0a 23 65  che->szPage];.#e
42d0: 6e 64 69 66 0a 20 20 20 20 69 66 28 20 62 65 6e  ndif.    if( ben
42e0: 69 67 6e 4d 61 6c 6c 6f 63 20 29 7b 20 73 71 6c  ignMalloc ){ sql
42f0: 69 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d 61 6c  ite3EndBenignMal
4300: 6c 6f 63 28 29 3b 20 7d 0a 23 69 66 64 65 66 20  loc(); }.#ifdef 
4310: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45  SQLITE_ENABLE_ME
4320: 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a  MORY_MANAGEMENT.
4330: 20 20 20 20 70 63 61 63 68 65 31 45 6e 74 65 72      pcache1Enter
4340: 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47  Mutex(pCache->pG
4350: 72 6f 75 70 29 3b 0a 23 65 6e 64 69 66 0a 20 20  roup);.#endif.  
4360: 20 20 69 66 28 20 70 50 67 3d 3d 30 20 29 20 72    if( pPg==0 ) r
4370: 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 70 2d 3e  eturn 0;.    p->
4380: 70 61 67 65 2e 70 42 75 66 20 3d 20 70 50 67 3b  page.pBuf = pPg;
4390: 0a 20 20 20 20 70 2d 3e 70 61 67 65 2e 70 45 78  .    p->page.pEx
43a0: 74 72 61 20 3d 20 26 70 5b 31 5d 3b 0a 20 20 20  tra = &p[1];.   
43b0: 20 70 2d 3e 69 73 42 75 6c 6b 4c 6f 63 61 6c 20   p->isBulkLocal 
43c0: 3d 20 30 3b 0a 20 20 20 20 70 2d 3e 69 73 41 6e  = 0;.    p->isAn
43d0: 63 68 6f 72 20 3d 20 30 3b 0a 20 20 7d 0a 20 20  chor = 0;.  }.  
43e0: 69 66 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72  if( pCache->bPur
43f0: 67 65 61 62 6c 65 20 29 7b 0a 20 20 20 20 70 43  geable ){.    pC
4400: 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6e 43  ache->pGroup->nC
4410: 75 72 72 65 6e 74 50 61 67 65 2b 2b 3b 0a 20 20  urrentPage++;.  
4420: 7d 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a  }.  return p;.}.
4430: 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 20 70 61  ./*.** Free a pa
4440: 67 65 20 6f 62 6a 65 63 74 20 61 6c 6c 6f 63 61  ge object alloca
4450: 74 65 64 20 62 79 20 70 63 61 63 68 65 31 41 6c  ted by pcache1Al
4460: 6c 6f 63 50 61 67 65 28 29 2e 0a 2a 2f 0a 73 74  locPage()..*/.st
4470: 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65  atic void pcache
4480: 31 46 72 65 65 50 61 67 65 28 50 67 48 64 72 31  1FreePage(PgHdr1
4490: 20 2a 70 29 7b 0a 20 20 50 43 61 63 68 65 31 20   *p){.  PCache1 
44a0: 2a 70 43 61 63 68 65 3b 0a 20 20 61 73 73 65 72  *pCache;.  asser
44b0: 74 28 20 70 21 3d 30 20 29 3b 0a 20 20 70 43 61  t( p!=0 );.  pCa
44c0: 63 68 65 20 3d 20 70 2d 3e 70 43 61 63 68 65 3b  che = p->pCache;
44d0: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74  .  assert( sqlit
44e0: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d  e3_mutex_held(p-
44f0: 3e 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d  >pCache->pGroup-
4500: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28  >mutex) );.  if(
4510: 20 70 2d 3e 69 73 42 75 6c 6b 4c 6f 63 61 6c 20   p->isBulkLocal 
4520: 29 7b 0a 20 20 20 20 70 2d 3e 70 4e 65 78 74 20  ){.    p->pNext 
4530: 3d 20 70 43 61 63 68 65 2d 3e 70 46 72 65 65 3b  = pCache->pFree;
4540: 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 70 46 72  .    pCache->pFr
4550: 65 65 20 3d 20 70 3b 0a 20 20 7d 65 6c 73 65 7b  ee = p;.  }else{
4560: 0a 20 20 20 20 70 63 61 63 68 65 31 46 72 65 65  .    pcache1Free
4570: 28 70 2d 3e 70 61 67 65 2e 70 42 75 66 29 3b 0a  (p->page.pBuf);.
4580: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 50 43  #ifdef SQLITE_PC
4590: 41 43 48 45 5f 53 45 50 41 52 41 54 45 5f 48 45  ACHE_SEPARATE_HE
45a0: 41 44 45 52 0a 20 20 20 20 73 71 6c 69 74 65 33  ADER.    sqlite3
45b0: 5f 66 72 65 65 28 70 29 3b 0a 23 65 6e 64 69 66  _free(p);.#endif
45c0: 0a 20 20 7d 0a 20 20 69 66 28 20 70 43 61 63 68  .  }.  if( pCach
45d0: 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 29 7b  e->bPurgeable ){
45e0: 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 70 47 72  .    pCache->pGr
45f0: 6f 75 70 2d 3e 6e 43 75 72 72 65 6e 74 50 61 67  oup->nCurrentPag
4600: 65 2d 2d 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a  e--;.  }.}../*.*
4610: 2a 20 4d 61 6c 6c 6f 63 20 66 75 6e 63 74 69 6f  * Malloc functio
4620: 6e 20 75 73 65 64 20 62 79 20 53 51 4c 69 74 65  n used by SQLite
4630: 20 74 6f 20 6f 62 74 61 69 6e 20 73 70 61 63 65   to obtain space
4640: 20 66 72 6f 6d 20 74 68 65 20 62 75 66 66 65 72   from the buffer
4650: 20 63 6f 6e 66 69 67 75 72 65 64 0a 2a 2a 20 75   configured.** u
4660: 73 69 6e 67 20 73 71 6c 69 74 65 33 5f 63 6f 6e  sing sqlite3_con
4670: 66 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49  fig(SQLITE_CONFI
4680: 47 5f 50 41 47 45 43 41 43 48 45 29 20 6f 70 74  G_PAGECACHE) opt
4690: 69 6f 6e 2e 20 49 66 20 6e 6f 20 73 75 63 68 20  ion. If no such 
46a0: 62 75 66 66 65 72 0a 2a 2a 20 65 78 69 73 74 73  buffer.** exists
46b0: 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  , this function 
46c0: 66 61 6c 6c 73 20 62 61 63 6b 20 74 6f 20 73 71  falls back to sq
46d0: 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 29 2e 0a 2a  lite3Malloc()..*
46e0: 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 50  /.void *sqlite3P
46f0: 61 67 65 4d 61 6c 6c 6f 63 28 69 6e 74 20 73 7a  ageMalloc(int sz
4700: 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 63 61 63  ){.  return pcac
4710: 68 65 31 41 6c 6c 6f 63 28 73 7a 29 3b 0a 7d 0a  he1Alloc(sz);.}.
4720: 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 6e 20 61  ./*.** Free an a
4730: 6c 6c 6f 63 61 74 65 64 20 62 75 66 66 65 72 20  llocated buffer 
4740: 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 73 71  obtained from sq
4750: 6c 69 74 65 33 50 61 67 65 4d 61 6c 6c 6f 63 28  lite3PageMalloc(
4760: 29 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  )..*/.void sqlit
4770: 65 33 50 61 67 65 46 72 65 65 28 76 6f 69 64 20  e3PageFree(void 
4780: 2a 70 29 7b 0a 20 20 70 63 61 63 68 65 31 46 72  *p){.  pcache1Fr
4790: 65 65 28 70 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a  ee(p);.}.../*.**
47a0: 20 52 65 74 75 72 6e 20 74 72 75 65 20 69 66 20   Return true if 
47b0: 69 74 20 64 65 73 69 72 61 62 6c 65 20 74 6f 20  it desirable to 
47c0: 61 76 6f 69 64 20 61 6c 6c 6f 63 61 74 69 6e 67  avoid allocating
47d0: 20 61 20 6e 65 77 20 70 61 67 65 20 63 61 63 68   a new page cach
47e0: 65 0a 2a 2a 20 65 6e 74 72 79 2e 0a 2a 2a 0a 2a  e.** entry..**.*
47f0: 2a 20 49 66 20 6d 65 6d 6f 72 79 20 77 61 73 20  * If memory was 
4800: 61 6c 6c 6f 63 61 74 65 64 20 73 70 65 63 69 66  allocated specif
4810: 69 63 61 6c 6c 79 20 74 6f 20 74 68 65 20 70 61  ically to the pa
4820: 67 65 20 63 61 63 68 65 20 75 73 69 6e 67 0a 2a  ge cache using.*
4830: 2a 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f  * SQLITE_CONFIG_
4840: 50 41 47 45 43 41 43 48 45 20 62 75 74 20 74 68  PAGECACHE but th
4850: 61 74 20 6d 65 6d 6f 72 79 20 68 61 73 20 61 6c  at memory has al
4860: 6c 20 62 65 65 6e 20 75 73 65 64 2c 20 74 68 65  l been used, the
4870: 6e 0a 2a 2a 20 69 74 20 69 73 20 64 65 73 69 72  n.** it is desir
4880: 61 62 6c 65 20 74 6f 20 61 76 6f 69 64 20 61 6c  able to avoid al
4890: 6c 6f 63 61 74 69 6e 67 20 61 20 6e 65 77 20 70  locating a new p
48a0: 61 67 65 20 63 61 63 68 65 20 65 6e 74 72 79 20  age cache entry 
48b0: 62 65 63 61 75 73 65 0a 2a 2a 20 70 72 65 73 75  because.** presu
48c0: 6d 61 62 6c 79 20 53 51 4c 49 54 45 5f 43 4f 4e  mably SQLITE_CON
48d0: 46 49 47 5f 50 41 47 45 43 41 43 48 45 20 77 61  FIG_PAGECACHE wa
48e0: 73 20 73 75 70 70 6f 73 65 20 74 6f 20 62 65 20  s suppose to be 
48f0: 73 75 66 66 69 63 69 65 6e 74 0a 2a 2a 20 66 6f  sufficient.** fo
4900: 72 20 61 6c 6c 20 70 61 67 65 20 63 61 63 68 65  r all page cache
4910: 20 6e 65 65 64 73 20 61 6e 64 20 77 65 20 73 68   needs and we sh
4920: 6f 75 6c 64 20 6e 6f 74 20 6e 65 65 64 20 74 6f  ould not need to
4930: 20 73 70 69 6c 6c 20 74 68 65 0a 2a 2a 20 61 6c   spill the.** al
4940: 6c 6f 63 61 74 69 6f 6e 20 6f 6e 74 6f 20 74 68  location onto th
4950: 65 20 68 65 61 70 2e 0a 2a 2a 0a 2a 2a 20 4f 72  e heap..**.** Or
4960: 2c 20 74 68 65 20 68 65 61 70 20 69 73 20 75 73  , the heap is us
4970: 65 64 20 66 6f 72 20 61 6c 6c 20 70 61 67 65 20  ed for all page 
4980: 63 61 63 68 65 20 6d 65 6d 6f 72 79 20 62 75 74  cache memory but
4990: 20 74 68 65 20 68 65 61 70 20 69 73 0a 2a 2a 20   the heap is.** 
49a0: 75 6e 64 65 72 20 6d 65 6d 6f 72 79 20 70 72 65  under memory pre
49b0: 73 73 75 72 65 2c 20 74 68 65 6e 20 61 67 61 69  ssure, then agai
49c0: 6e 20 69 74 20 69 73 20 64 65 73 69 72 61 62 6c  n it is desirabl
49d0: 65 20 74 6f 20 61 76 6f 69 64 0a 2a 2a 20 61 6c  e to avoid.** al
49e0: 6c 6f 63 61 74 69 6e 67 20 61 20 6e 65 77 20 70  locating a new p
49f0: 61 67 65 20 63 61 63 68 65 20 65 6e 74 72 79 20  age cache entry 
4a00: 69 6e 20 6f 72 64 65 72 20 74 6f 20 61 76 6f 69  in order to avoi
4a10: 64 20 73 74 72 65 73 73 69 6e 67 0a 2a 2a 20 74  d stressing.** t
4a20: 68 65 20 68 65 61 70 20 65 76 65 6e 20 66 75 72  he heap even fur
4a30: 74 68 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  ther..*/.static 
4a40: 69 6e 74 20 70 63 61 63 68 65 31 55 6e 64 65 72  int pcache1Under
4a50: 4d 65 6d 6f 72 79 50 72 65 73 73 75 72 65 28 50  MemoryPressure(P
4a60: 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 29 7b  Cache1 *pCache){
4a70: 0a 20 20 69 66 28 20 70 63 61 63 68 65 31 2e 6e  .  if( pcache1.n
4a80: 53 6c 6f 74 20 26 26 20 28 70 43 61 63 68 65 2d  Slot && (pCache-
4a90: 3e 73 7a 50 61 67 65 2b 70 43 61 63 68 65 2d 3e  >szPage+pCache->
4aa0: 73 7a 45 78 74 72 61 29 3c 3d 70 63 61 63 68 65  szExtra)<=pcache
4ab0: 31 2e 73 7a 53 6c 6f 74 20 29 7b 0a 20 20 20 20  1.szSlot ){.    
4ac0: 72 65 74 75 72 6e 20 70 63 61 63 68 65 31 2e 62  return pcache1.b
4ad0: 55 6e 64 65 72 50 72 65 73 73 75 72 65 3b 0a 20  UnderPressure;. 
4ae0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75   }else{.    retu
4af0: 72 6e 20 73 71 6c 69 74 65 33 48 65 61 70 4e 65  rn sqlite3HeapNe
4b00: 61 72 6c 79 46 75 6c 6c 28 29 3b 0a 20 20 7d 0a  arlyFull();.  }.
4b10: 7d 0a 0a 2f 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 2a 2a 2a 2a 2a 2a 2a  ****************
4b60: 2a 2a 2f 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 20 47 65  **/./******** Ge
4b70: 6e 65 72 61 6c 20 49 6d 70 6c 65 6d 65 6e 74 61  neral Implementa
4b80: 74 69 6f 6e 20 46 75 6e 63 74 69 6f 6e 73 20 2a  tion Functions *
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 2a 2a 2a 2a 2a 2a  ****************
4bb0: 2a 2a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  ***/../*.** This
4bc0: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 65   function is use
4bd0: 64 20 74 6f 20 72 65 73 69 7a 65 20 74 68 65 20  d to resize the 
4be0: 68 61 73 68 20 74 61 62 6c 65 20 75 73 65 64 20  hash table used 
4bf0: 62 79 20 74 68 65 20 63 61 63 68 65 20 70 61 73  by the cache pas
4c00: 73 65 64 0a 2a 2a 20 61 73 20 74 68 65 20 66 69  sed.** as the fi
4c10: 72 73 74 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2a  rst argument..**
4c20: 0a 2a 2a 20 54 68 65 20 50 43 61 63 68 65 20 6d  .** The PCache m
4c30: 75 74 65 78 20 6d 75 73 74 20 62 65 20 68 65 6c  utex must be hel
4c40: 64 20 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63  d when this func
4c50: 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2e 0a  tion is called..
4c60: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70  */.static void p
4c70: 63 61 63 68 65 31 52 65 73 69 7a 65 48 61 73 68  cache1ResizeHash
4c80: 28 50 43 61 63 68 65 31 20 2a 70 29 7b 0a 20 20  (PCache1 *p){.  
4c90: 50 67 48 64 72 31 20 2a 2a 61 70 4e 65 77 3b 0a  PgHdr1 **apNew;.
4ca0: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e    unsigned int n
4cb0: 4e 65 77 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20  New;.  unsigned 
4cc0: 69 6e 74 20 69 3b 0a 0a 20 20 61 73 73 65 72 74  int i;..  assert
4cd0: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
4ce0: 68 65 6c 64 28 70 2d 3e 70 47 72 6f 75 70 2d 3e  held(p->pGroup->
4cf0: 6d 75 74 65 78 29 20 29 3b 0a 0a 20 20 6e 4e 65  mutex) );..  nNe
4d00: 77 20 3d 20 70 2d 3e 6e 48 61 73 68 2a 32 3b 0a  w = p->nHash*2;.
4d10: 20 20 69 66 28 20 6e 4e 65 77 3c 32 35 36 20 29    if( nNew<256 )
4d20: 7b 0a 20 20 20 20 6e 4e 65 77 20 3d 20 32 35 36  {.    nNew = 256
4d30: 3b 0a 20 20 7d 0a 0a 20 20 70 63 61 63 68 65 31  ;.  }..  pcache1
4d40: 4c 65 61 76 65 4d 75 74 65 78 28 70 2d 3e 70 47  LeaveMutex(p->pG
4d50: 72 6f 75 70 29 3b 0a 20 20 69 66 28 20 70 2d 3e  roup);.  if( p->
4d60: 6e 48 61 73 68 20 29 7b 20 73 71 6c 69 74 65 33  nHash ){ sqlite3
4d70: 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f  BeginBenignMallo
4d80: 63 28 29 3b 20 7d 0a 20 20 61 70 4e 65 77 20 3d  c(); }.  apNew =
4d90: 20 28 50 67 48 64 72 31 20 2a 2a 29 73 71 6c 69   (PgHdr1 **)sqli
4da0: 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 69  te3MallocZero(si
4db0: 7a 65 6f 66 28 50 67 48 64 72 31 20 2a 29 2a 6e  zeof(PgHdr1 *)*n
4dc0: 4e 65 77 29 3b 0a 20 20 69 66 28 20 70 2d 3e 6e  New);.  if( p->n
4dd0: 48 61 73 68 20 29 7b 20 73 71 6c 69 74 65 33 45  Hash ){ sqlite3E
4de0: 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29  ndBenignMalloc()
4df0: 3b 20 7d 0a 20 20 70 63 61 63 68 65 31 45 6e 74  ; }.  pcache1Ent
4e00: 65 72 4d 75 74 65 78 28 70 2d 3e 70 47 72 6f 75  erMutex(p->pGrou
4e10: 70 29 3b 0a 20 20 69 66 28 20 61 70 4e 65 77 20  p);.  if( apNew 
4e20: 29 7b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20  ){.    for(i=0; 
4e30: 69 3c 70 2d 3e 6e 48 61 73 68 3b 20 69 2b 2b 29  i<p->nHash; i++)
4e40: 7b 0a 20 20 20 20 20 20 50 67 48 64 72 31 20 2a  {.      PgHdr1 *
4e50: 70 50 61 67 65 3b 0a 20 20 20 20 20 20 50 67 48  pPage;.      PgH
4e60: 64 72 31 20 2a 70 4e 65 78 74 20 3d 20 70 2d 3e  dr1 *pNext = p->
4e70: 61 70 48 61 73 68 5b 69 5d 3b 0a 20 20 20 20 20  apHash[i];.     
4e80: 20 77 68 69 6c 65 28 20 28 70 50 61 67 65 20 3d   while( (pPage =
4e90: 20 70 4e 65 78 74 29 21 3d 30 20 29 7b 0a 20 20   pNext)!=0 ){.  
4ea0: 20 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 69        unsigned i
4eb0: 6e 74 20 68 20 3d 20 70 50 61 67 65 2d 3e 69 4b  nt h = pPage->iK
4ec0: 65 79 20 25 20 6e 4e 65 77 3b 0a 20 20 20 20 20  ey % nNew;.     
4ed0: 20 20 20 70 4e 65 78 74 20 3d 20 70 50 61 67 65     pNext = pPage
4ee0: 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 20  ->pNext;.       
4ef0: 20 70 50 61 67 65 2d 3e 70 4e 65 78 74 20 3d 20   pPage->pNext = 
4f00: 61 70 4e 65 77 5b 68 5d 3b 0a 20 20 20 20 20 20  apNew[h];.      
4f10: 20 20 61 70 4e 65 77 5b 68 5d 20 3d 20 70 50 61    apNew[h] = pPa
4f20: 67 65 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  ge;.      }.    
4f30: 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72  }.    sqlite3_fr
4f40: 65 65 28 70 2d 3e 61 70 48 61 73 68 29 3b 0a 20  ee(p->apHash);. 
4f50: 20 20 20 70 2d 3e 61 70 48 61 73 68 20 3d 20 61     p->apHash = a
4f60: 70 4e 65 77 3b 0a 20 20 20 20 70 2d 3e 6e 48 61  pNew;.    p->nHa
4f70: 73 68 20 3d 20 6e 4e 65 77 3b 0a 20 20 7d 0a 7d  sh = nNew;.  }.}
4f80: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e  ../*.** This fun
4f90: 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 69 6e  ction is used in
4fa0: 74 65 72 6e 61 6c 6c 79 20 74 6f 20 72 65 6d 6f  ternally to remo
4fb0: 76 65 20 74 68 65 20 70 61 67 65 20 70 50 61 67  ve the page pPag
4fc0: 65 20 66 72 6f 6d 20 74 68 65 20 0a 2a 2a 20 50  e from the .** P
4fd0: 47 72 6f 75 70 20 4c 52 55 20 6c 69 73 74 2c 20  Group LRU list, 
4fe0: 69 66 20 69 73 20 70 61 72 74 20 6f 66 20 69 74  if is part of it
4ff0: 2e 20 49 66 20 70 50 61 67 65 20 69 73 20 6e 6f  . If pPage is no
5000: 74 20 70 61 72 74 20 6f 66 20 74 68 65 20 50 47  t part of the PG
5010: 72 6f 75 70 0a 2a 2a 20 4c 52 55 20 6c 69 73 74  roup.** LRU list
5020: 2c 20 74 68 65 6e 20 74 68 69 73 20 66 75 6e 63  , then this func
5030: 74 69 6f 6e 20 69 73 20 61 20 6e 6f 2d 6f 70 2e  tion is a no-op.
5040: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50 47 72 6f 75  .**.** The PGrou
5050: 70 20 6d 75 74 65 78 20 6d 75 73 74 20 62 65 20  p mutex must be 
5060: 68 65 6c 64 20 77 68 65 6e 20 74 68 69 73 20 66  held when this f
5070: 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65  unction is calle
5080: 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67 48  d..*/.static PgH
5090: 64 72 31 20 2a 70 63 61 63 68 65 31 50 69 6e 50  dr1 *pcache1PinP
50a0: 61 67 65 28 50 67 48 64 72 31 20 2a 70 50 61 67  age(PgHdr1 *pPag
50b0: 65 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70  e){.  PCache1 *p
50c0: 43 61 63 68 65 3b 0a 0a 20 20 61 73 73 65 72 74  Cache;..  assert
50d0: 28 20 70 50 61 67 65 21 3d 30 20 29 3b 0a 20 20  ( pPage!=0 );.  
50e0: 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 69  assert( pPage->i
50f0: 73 50 69 6e 6e 65 64 3d 3d 30 20 29 3b 0a 20 20  sPinned==0 );.  
5100: 70 43 61 63 68 65 20 3d 20 70 50 61 67 65 2d 3e  pCache = pPage->
5110: 70 43 61 63 68 65 3b 0a 20 20 61 73 73 65 72 74  pCache;.  assert
5120: 28 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78  ( pPage->pLruNex
5130: 74 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  t );.  assert( p
5140: 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 20 29  Page->pLruPrev )
5150: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69  ;.  assert( sqli
5160: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70  te3_mutex_held(p
5170: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6d  Cache->pGroup->m
5180: 75 74 65 78 29 20 29 3b 0a 20 20 70 50 61 67 65  utex) );.  pPage
5190: 2d 3e 70 4c 72 75 50 72 65 76 2d 3e 70 4c 72 75  ->pLruPrev->pLru
51a0: 4e 65 78 74 20 3d 20 70 50 61 67 65 2d 3e 70 4c  Next = pPage->pL
51b0: 72 75 4e 65 78 74 3b 0a 20 20 70 50 61 67 65 2d  ruNext;.  pPage-
51c0: 3e 70 4c 72 75 4e 65 78 74 2d 3e 70 4c 72 75 50  >pLruNext->pLruP
51d0: 72 65 76 20 3d 20 70 50 61 67 65 2d 3e 70 4c 72  rev = pPage->pLr
51e0: 75 50 72 65 76 3b 0a 20 20 70 50 61 67 65 2d 3e  uPrev;.  pPage->
51f0: 70 4c 72 75 4e 65 78 74 20 3d 20 30 3b 0a 20 20  pLruNext = 0;.  
5200: 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 20  pPage->pLruPrev 
5210: 3d 20 30 3b 0a 20 20 70 50 61 67 65 2d 3e 69 73  = 0;.  pPage->is
5220: 50 69 6e 6e 65 64 20 3d 20 31 3b 0a 20 20 61 73  Pinned = 1;.  as
5230: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 69 73 41  sert( pPage->isA
5240: 6e 63 68 6f 72 3d 3d 30 20 29 3b 0a 20 20 61 73  nchor==0 );.  as
5250: 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 70 47  sert( pCache->pG
5260: 72 6f 75 70 2d 3e 6c 72 75 2e 69 73 41 6e 63 68  roup->lru.isAnch
5270: 6f 72 3d 3d 31 20 29 3b 0a 20 20 70 43 61 63 68  or==1 );.  pCach
5280: 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65 2d 2d  e->nRecyclable--
5290: 3b 0a 20 20 72 65 74 75 72 6e 20 70 50 61 67 65  ;.  return pPage
52a0: 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 6d 6f  ;.}.../*.** Remo
52b0: 76 65 20 74 68 65 20 70 61 67 65 20 73 75 70 70  ve the page supp
52c0: 6c 69 65 64 20 61 73 20 61 6e 20 61 72 67 75 6d  lied as an argum
52d0: 65 6e 74 20 66 72 6f 6d 20 74 68 65 20 68 61 73  ent from the has
52e0: 68 20 74 61 62 6c 65 20 0a 2a 2a 20 28 50 43 61  h table .** (PCa
52f0: 63 68 65 31 2e 61 70 48 61 73 68 20 73 74 72 75  che1.apHash stru
5300: 63 74 75 72 65 29 20 74 68 61 74 20 69 74 20 69  cture) that it i
5310: 73 20 63 75 72 72 65 6e 74 6c 79 20 73 74 6f 72  s currently stor
5320: 65 64 20 69 6e 2e 0a 2a 2a 20 41 6c 73 6f 20 66  ed in..** Also f
5330: 72 65 65 20 74 68 65 20 70 61 67 65 20 69 66 20  ree the page if 
5340: 66 72 65 65 50 61 67 65 20 69 73 20 74 72 75 65  freePage is true
5350: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50 47 72 6f  ..**.** The PGro
5360: 75 70 20 6d 75 74 65 78 20 6d 75 73 74 20 62 65  up mutex must be
5370: 20 68 65 6c 64 20 77 68 65 6e 20 74 68 69 73 20   held when this 
5380: 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c  function is call
5390: 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  ed..*/.static vo
53a0: 69 64 20 70 63 61 63 68 65 31 52 65 6d 6f 76 65  id pcache1Remove
53b0: 46 72 6f 6d 48 61 73 68 28 50 67 48 64 72 31 20  FromHash(PgHdr1 
53c0: 2a 70 50 61 67 65 2c 20 69 6e 74 20 66 72 65 65  *pPage, int free
53d0: 46 6c 61 67 29 7b 0a 20 20 75 6e 73 69 67 6e 65  Flag){.  unsigne
53e0: 64 20 69 6e 74 20 68 3b 0a 20 20 50 43 61 63 68  d int h;.  PCach
53f0: 65 31 20 2a 70 43 61 63 68 65 20 3d 20 70 50 61  e1 *pCache = pPa
5400: 67 65 2d 3e 70 43 61 63 68 65 3b 0a 20 20 50 67  ge->pCache;.  Pg
5410: 48 64 72 31 20 2a 2a 70 70 3b 0a 0a 20 20 61 73  Hdr1 **pp;..  as
5420: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75  sert( sqlite3_mu
5430: 74 65 78 5f 68 65 6c 64 28 70 43 61 63 68 65 2d  tex_held(pCache-
5440: 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20  >pGroup->mutex) 
5450: 29 3b 0a 20 20 68 20 3d 20 70 50 61 67 65 2d 3e  );.  h = pPage->
5460: 69 4b 65 79 20 25 20 70 43 61 63 68 65 2d 3e 6e  iKey % pCache->n
5470: 48 61 73 68 3b 0a 20 20 66 6f 72 28 70 70 3d 26  Hash;.  for(pp=&
5480: 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68  pCache->apHash[h
5490: 5d 3b 20 28 2a 70 70 29 21 3d 70 50 61 67 65 3b  ]; (*pp)!=pPage;
54a0: 20 70 70 3d 26 28 2a 70 70 29 2d 3e 70 4e 65 78   pp=&(*pp)->pNex
54b0: 74 29 3b 0a 20 20 2a 70 70 20 3d 20 28 2a 70 70  t);.  *pp = (*pp
54c0: 29 2d 3e 70 4e 65 78 74 3b 0a 0a 20 20 70 43 61  )->pNext;..  pCa
54d0: 63 68 65 2d 3e 6e 50 61 67 65 2d 2d 3b 0a 20 20  che->nPage--;.  
54e0: 69 66 28 20 66 72 65 65 46 6c 61 67 20 29 20 70  if( freeFlag ) p
54f0: 63 61 63 68 65 31 46 72 65 65 50 61 67 65 28 70  cache1FreePage(p
5500: 50 61 67 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  Page);.}../*.** 
5510: 49 66 20 74 68 65 72 65 20 61 72 65 20 63 75 72  If there are cur
5520: 72 65 6e 74 6c 79 20 6d 6f 72 65 20 74 68 61 6e  rently more than
5530: 20 6e 4d 61 78 50 61 67 65 20 70 61 67 65 73 20   nMaxPage pages 
5540: 61 6c 6c 6f 63 61 74 65 64 2c 20 74 72 79 0a 2a  allocated, try.*
5550: 2a 20 74 6f 20 72 65 63 79 63 6c 65 20 70 61 67  * to recycle pag
5560: 65 73 20 74 6f 20 72 65 64 75 63 65 20 74 68 65  es to reduce the
5570: 20 6e 75 6d 62 65 72 20 61 6c 6c 6f 63 61 74 65   number allocate
5580: 64 20 74 6f 20 6e 4d 61 78 50 61 67 65 2e 0a 2a  d to nMaxPage..*
5590: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63  /.static void pc
55a0: 61 63 68 65 31 45 6e 66 6f 72 63 65 4d 61 78 50  ache1EnforceMaxP
55b0: 61 67 65 28 50 43 61 63 68 65 31 20 2a 70 43 61  age(PCache1 *pCa
55c0: 63 68 65 29 7b 0a 20 20 50 47 72 6f 75 70 20 2a  che){.  PGroup *
55d0: 70 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65 2d  pGroup = pCache-
55e0: 3e 70 47 72 6f 75 70 3b 0a 20 20 50 67 48 64 72  >pGroup;.  PgHdr
55f0: 31 20 2a 70 3b 0a 20 20 61 73 73 65 72 74 28 20  1 *p;.  assert( 
5600: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65  sqlite3_mutex_he
5610: 6c 64 28 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78  ld(pGroup->mutex
5620: 29 20 29 3b 0a 20 20 77 68 69 6c 65 28 20 70 47  ) );.  while( pG
5630: 72 6f 75 70 2d 3e 6e 43 75 72 72 65 6e 74 50 61  roup->nCurrentPa
5640: 67 65 3e 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50  ge>pGroup->nMaxP
5650: 61 67 65 0a 20 20 20 20 20 20 26 26 20 28 70 3d  age.      && (p=
5660: 70 47 72 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72 75  pGroup->lru.pLru
5670: 50 72 65 76 29 2d 3e 69 73 41 6e 63 68 6f 72 3d  Prev)->isAnchor=
5680: 3d 30 0a 20 20 29 7b 0a 20 20 20 20 61 73 73 65  =0.  ){.    asse
5690: 72 74 28 20 70 2d 3e 70 43 61 63 68 65 2d 3e 70  rt( p->pCache->p
56a0: 47 72 6f 75 70 3d 3d 70 47 72 6f 75 70 20 29 3b  Group==pGroup );
56b0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e  .    assert( p->
56c0: 69 73 50 69 6e 6e 65 64 3d 3d 30 20 29 3b 0a 20  isPinned==0 );. 
56d0: 20 20 20 70 63 61 63 68 65 31 50 69 6e 50 61 67     pcache1PinPag
56e0: 65 28 70 29 3b 0a 20 20 20 20 70 63 61 63 68 65  e(p);.    pcache
56f0: 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73 68 28  1RemoveFromHash(
5700: 70 2c 20 31 29 3b 0a 20 20 7d 0a 20 20 69 66 28  p, 1);.  }.  if(
5710: 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 3d 3d   pCache->nPage==
5720: 30 20 26 26 20 70 43 61 63 68 65 2d 3e 70 42 75  0 && pCache->pBu
5730: 6c 6b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  lk ){.    sqlite
5740: 33 5f 66 72 65 65 28 70 43 61 63 68 65 2d 3e 70  3_free(pCache->p
5750: 42 75 6c 6b 29 3b 0a 20 20 20 20 70 43 61 63 68  Bulk);.    pCach
5760: 65 2d 3e 70 42 75 6c 6b 20 3d 20 70 43 61 63 68  e->pBulk = pCach
5770: 65 2d 3e 70 46 72 65 65 20 3d 20 30 3b 0a 20 20  e->pFree = 0;.  
5780: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 69 73 63 61  }.}../*.** Disca
5790: 72 64 20 61 6c 6c 20 70 61 67 65 73 20 66 72 6f  rd all pages fro
57a0: 6d 20 63 61 63 68 65 20 70 43 61 63 68 65 20 77  m cache pCache w
57b0: 69 74 68 20 61 20 70 61 67 65 20 6e 75 6d 62 65  ith a page numbe
57c0: 72 20 28 6b 65 79 20 76 61 6c 75 65 29 20 0a 2a  r (key value) .*
57d0: 2a 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 6f  * greater than o
57e0: 72 20 65 71 75 61 6c 20 74 6f 20 69 4c 69 6d 69  r equal to iLimi
57f0: 74 2e 20 41 6e 79 20 70 69 6e 6e 65 64 20 70 61  t. Any pinned pa
5800: 67 65 73 20 74 68 61 74 20 6d 65 65 74 20 74 68  ges that meet th
5810: 69 73 20 0a 2a 2a 20 63 72 69 74 65 72 69 61 20  is .** criteria 
5820: 61 72 65 20 75 6e 70 69 6e 6e 65 64 20 62 65 66  are unpinned bef
5830: 6f 72 65 20 74 68 65 79 20 61 72 65 20 64 69 73  ore they are dis
5840: 63 61 72 64 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68  carded..**.** Th
5850: 65 20 50 43 61 63 68 65 20 6d 75 74 65 78 20 6d  e PCache mutex m
5860: 75 73 74 20 62 65 20 68 65 6c 64 20 77 68 65 6e  ust be held when
5870: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69   this function i
5880: 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61  s called..*/.sta
5890: 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31  tic void pcache1
58a0: 54 72 75 6e 63 61 74 65 55 6e 73 61 66 65 28 0a  TruncateUnsafe(.
58b0: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68    PCache1 *pCach
58c0: 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  e,             /
58d0: 2a 20 54 68 65 20 63 61 63 68 65 20 74 6f 20 74  * The cache to t
58e0: 72 75 6e 63 61 74 65 20 2a 2f 0a 20 20 75 6e 73  runcate */.  uns
58f0: 69 67 6e 65 64 20 69 6e 74 20 69 4c 69 6d 69 74  igned int iLimit
5900: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 72 6f            /* Dro
5910: 70 20 70 61 67 65 73 20 77 69 74 68 20 74 68 69  p pages with thi
5920: 73 20 70 67 6e 6f 20 6f 72 20 6c 61 72 67 65 72  s pgno or larger
5930: 20 2a 2f 0a 29 7b 0a 20 20 54 45 53 54 4f 4e 4c   */.){.  TESTONL
5940: 59 28 20 69 6e 74 20 6e 50 61 67 65 20 3d 20 30  Y( int nPage = 0
5950: 3b 20 29 20 20 2f 2a 20 54 6f 20 61 73 73 65 72  ; )  /* To asser
5960: 74 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 20  t pCache->nPage 
5970: 69 73 20 63 6f 72 72 65 63 74 20 2a 2f 0a 20 20  is correct */.  
5980: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 68 2c 20  unsigned int h, 
5990: 69 53 74 6f 70 3b 0a 20 20 61 73 73 65 72 74 28  iStop;.  assert(
59a0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68   sqlite3_mutex_h
59b0: 65 6c 64 28 70 43 61 63 68 65 2d 3e 70 47 72 6f  eld(pCache->pGro
59c0: 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20  up->mutex) );.  
59d0: 61 73 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e  assert( pCache->
59e0: 69 4d 61 78 4b 65 79 20 3e 3d 20 69 4c 69 6d 69  iMaxKey >= iLimi
59f0: 74 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  t );.  assert( p
5a00: 43 61 63 68 65 2d 3e 6e 48 61 73 68 20 3e 20 30  Cache->nHash > 0
5a10: 20 29 3b 0a 20 20 69 66 28 20 70 43 61 63 68 65   );.  if( pCache
5a20: 2d 3e 69 4d 61 78 4b 65 79 20 2d 20 69 4c 69 6d  ->iMaxKey - iLim
5a30: 69 74 20 3c 20 70 43 61 63 68 65 2d 3e 6e 48 61  it < pCache->nHa
5a40: 73 68 20 29 7b 0a 20 20 20 20 2f 2a 20 49 66 20  sh ){.    /* If 
5a50: 77 65 20 61 72 65 20 6a 75 73 74 20 73 68 61 76  we are just shav
5a60: 69 6e 67 20 74 68 65 20 6c 61 73 74 20 66 65 77  ing the last few
5a70: 20 70 61 67 65 73 20 6f 66 66 20 74 68 65 20 65   pages off the e
5a80: 6e 64 20 6f 66 20 74 68 65 0a 20 20 20 20 2a 2a  nd of the.    **
5a90: 20 63 61 63 68 65 2c 20 74 68 65 6e 20 74 68 65   cache, then the
5aa0: 72 65 20 69 73 20 6e 6f 20 70 6f 69 6e 74 20 69  re is no point i
5ab0: 6e 20 73 63 61 6e 6e 69 6e 67 20 74 68 65 20 65  n scanning the e
5ac0: 6e 74 69 72 65 20 68 61 73 68 20 74 61 62 6c 65  ntire hash table
5ad0: 2e 0a 20 20 20 20 2a 2a 20 4f 6e 6c 79 20 73 63  ..    ** Only sc
5ae0: 61 6e 20 74 68 6f 73 65 20 68 61 73 68 20 73 6c  an those hash sl
5af0: 6f 74 73 20 74 68 61 74 20 6d 69 67 68 74 20 63  ots that might c
5b00: 6f 6e 74 61 69 6e 20 70 61 67 65 73 20 74 68 61  ontain pages tha
5b10: 74 20 6e 65 65 64 20 74 6f 0a 20 20 20 20 2a 2a  t need to.    **
5b20: 20 62 65 20 72 65 6d 6f 76 65 64 2e 20 2a 2f 0a   be removed. */.
5b30: 20 20 20 20 68 20 3d 20 69 4c 69 6d 69 74 20 25      h = iLimit %
5b40: 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a   pCache->nHash;.
5b50: 20 20 20 20 69 53 74 6f 70 20 3d 20 70 43 61 63      iStop = pCac
5b60: 68 65 2d 3e 69 4d 61 78 4b 65 79 20 25 20 70 43  he->iMaxKey % pC
5b70: 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 20  ache->nHash;.   
5b80: 20 54 45 53 54 4f 4e 4c 59 28 20 6e 50 61 67 65   TESTONLY( nPage
5b90: 20 3d 20 2d 31 30 3b 20 29 20 20 2f 2a 20 44 69   = -10; )  /* Di
5ba0: 73 61 62 6c 65 20 74 68 65 20 70 43 61 63 68 65  sable the pCache
5bb0: 2d 3e 6e 50 61 67 65 20 76 61 6c 69 64 69 74 79  ->nPage validity
5bc0: 20 63 68 65 63 6b 20 2a 2f 0a 20 20 7d 65 6c 73   check */.  }els
5bd0: 65 7b 0a 20 20 20 20 2f 2a 20 54 68 69 73 20 69  e{.    /* This i
5be0: 73 20 74 68 65 20 67 65 6e 65 72 61 6c 20 63 61  s the general ca
5bf0: 73 65 20 77 68 65 72 65 20 6d 61 6e 79 20 70 61  se where many pa
5c00: 67 65 73 20 61 72 65 20 62 65 69 6e 67 20 72 65  ges are being re
5c10: 6d 6f 76 65 64 2e 0a 20 20 20 20 2a 2a 20 49 74  moved..    ** It
5c20: 20 69 73 20 6e 65 63 65 73 73 61 72 79 20 74 6f   is necessary to
5c30: 20 73 63 61 6e 20 74 68 65 20 65 6e 74 69 72 65   scan the entire
5c40: 20 68 61 73 68 20 74 61 62 6c 65 20 2a 2f 0a 20   hash table */. 
5c50: 20 20 20 68 20 3d 20 70 43 61 63 68 65 2d 3e 6e     h = pCache->n
5c60: 48 61 73 68 2f 32 3b 0a 20 20 20 20 69 53 74 6f  Hash/2;.    iSto
5c70: 70 20 3d 20 68 20 2d 20 31 3b 0a 20 20 7d 0a 20  p = h - 1;.  }. 
5c80: 20 66 6f 72 28 3b 3b 29 7b 0a 20 20 20 20 50 67   for(;;){.    Pg
5c90: 48 64 72 31 20 2a 2a 70 70 3b 0a 20 20 20 20 50  Hdr1 **pp;.    P
5ca0: 67 48 64 72 31 20 2a 70 50 61 67 65 3b 0a 20 20  gHdr1 *pPage;.  
5cb0: 20 20 61 73 73 65 72 74 28 20 68 3c 70 43 61 63    assert( h<pCac
5cc0: 68 65 2d 3e 6e 48 61 73 68 20 29 3b 0a 20 20 20  he->nHash );.   
5cd0: 20 70 70 20 3d 20 26 70 43 61 63 68 65 2d 3e 61   pp = &pCache->a
5ce0: 70 48 61 73 68 5b 68 5d 3b 20 0a 20 20 20 20 77  pHash[h]; .    w
5cf0: 68 69 6c 65 28 20 28 70 50 61 67 65 20 3d 20 2a  hile( (pPage = *
5d00: 70 70 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20  pp)!=0 ){.      
5d10: 69 66 28 20 70 50 61 67 65 2d 3e 69 4b 65 79 3e  if( pPage->iKey>
5d20: 3d 69 4c 69 6d 69 74 20 29 7b 0a 20 20 20 20 20  =iLimit ){.     
5d30: 20 20 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65     pCache->nPage
5d40: 2d 2d 3b 0a 20 20 20 20 20 20 20 20 2a 70 70 20  --;.        *pp 
5d50: 3d 20 70 50 61 67 65 2d 3e 70 4e 65 78 74 3b 0a  = pPage->pNext;.
5d60: 20 20 20 20 20 20 20 20 69 66 28 20 21 70 50 61          if( !pPa
5d70: 67 65 2d 3e 69 73 50 69 6e 6e 65 64 20 29 20 70  ge->isPinned ) p
5d80: 63 61 63 68 65 31 50 69 6e 50 61 67 65 28 70 50  cache1PinPage(pP
5d90: 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 70 63  age);.        pc
5da0: 61 63 68 65 31 46 72 65 65 50 61 67 65 28 70 50  ache1FreePage(pP
5db0: 61 67 65 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73  age);.      }els
5dc0: 65 7b 0a 20 20 20 20 20 20 20 20 70 70 20 3d 20  e{.        pp = 
5dd0: 26 70 50 61 67 65 2d 3e 70 4e 65 78 74 3b 0a 20  &pPage->pNext;. 
5de0: 20 20 20 20 20 20 20 54 45 53 54 4f 4e 4c 59 28         TESTONLY(
5df0: 20 69 66 28 20 6e 50 61 67 65 3e 3d 30 20 29 20   if( nPage>=0 ) 
5e00: 6e 50 61 67 65 2b 2b 3b 20 29 0a 20 20 20 20 20  nPage++; ).     
5e10: 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28   }.    }.    if(
5e20: 20 68 3d 3d 69 53 74 6f 70 20 29 20 62 72 65 61   h==iStop ) brea
5e30: 6b 3b 0a 20 20 20 20 68 20 3d 20 28 68 2b 31 29  k;.    h = (h+1)
5e40: 20 25 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68   % pCache->nHash
5e50: 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20  ;.  }.  assert( 
5e60: 6e 50 61 67 65 3c 30 20 7c 7c 20 70 43 61 63 68  nPage<0 || pCach
5e70: 65 2d 3e 6e 50 61 67 65 3d 3d 28 75 6e 73 69 67  e->nPage==(unsig
5e80: 6e 65 64 29 6e 50 61 67 65 20 29 3b 0a 7d 0a 0a  ned)nPage );.}..
5e90: 2f 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 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f  ***************/
5ee0: 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74  ./******** sqlit
5ef0: 65 33 5f 70 63 61 63 68 65 20 4d 65 74 68 6f 64  e3_pcache Method
5f00: 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  s **************
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 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5f30: 2f 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65  /../*.** Impleme
5f40: 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73  ntation of the s
5f50: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78 49  qlite3_pcache.xI
5f60: 6e 69 74 20 6d 65 74 68 6f 64 2e 0a 2a 2f 0a 73  nit method..*/.s
5f70: 74 61 74 69 63 20 69 6e 74 20 70 63 61 63 68 65  tatic int pcache
5f80: 31 49 6e 69 74 28 76 6f 69 64 20 2a 4e 6f 74 55  1Init(void *NotU
5f90: 73 65 64 29 7b 0a 20 20 55 4e 55 53 45 44 5f 50  sed){.  UNUSED_P
5fa0: 41 52 41 4d 45 54 45 52 28 4e 6f 74 55 73 65 64  ARAMETER(NotUsed
5fb0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 63 61  );.  assert( pca
5fc0: 63 68 65 31 2e 69 73 49 6e 69 74 3d 3d 30 20 29  che1.isInit==0 )
5fd0: 3b 0a 20 20 6d 65 6d 73 65 74 28 26 70 63 61 63  ;.  memset(&pcac
5fe0: 68 65 31 2c 20 30 2c 20 73 69 7a 65 6f 66 28 70  he1, 0, sizeof(p
5ff0: 63 61 63 68 65 31 29 29 3b 0a 0a 0a 20 20 2f 2a  cache1));...  /*
6000: 0a 20 20 2a 2a 20 54 68 65 20 70 63 61 63 68 65  .  ** The pcache
6010: 31 2e 73 65 70 61 72 61 74 65 43 61 63 68 65 20  1.separateCache 
6020: 76 61 72 69 61 62 6c 65 20 69 73 20 74 72 75 65  variable is true
6030: 20 69 66 20 65 61 63 68 20 50 43 61 63 68 65 20   if each PCache 
6040: 68 61 73 20 69 74 73 20 6f 77 6e 0a 20 20 2a 2a  has its own.  **
6050: 20 70 72 69 76 61 74 65 20 50 47 72 6f 75 70 20   private PGroup 
6060: 28 6d 6f 64 65 2d 31 29 2e 20 20 70 63 61 63 68  (mode-1).  pcach
6070: 65 31 2e 73 65 70 61 72 61 74 65 43 61 63 68 65  e1.separateCache
6080: 20 69 73 20 66 61 6c 73 65 20 69 66 20 74 68 65   is false if the
6090: 20 73 69 6e 67 6c 65 0a 20 20 2a 2a 20 50 47 72   single.  ** PGr
60a0: 6f 75 70 20 69 6e 20 70 63 61 63 68 65 31 2e 67  oup in pcache1.g
60b0: 72 70 20 69 73 20 75 73 65 64 20 66 6f 72 20 61  rp is used for a
60c0: 6c 6c 20 70 61 67 65 20 63 61 63 68 65 73 20 28  ll page caches (
60d0: 6d 6f 64 65 2d 32 29 2e 0a 20 20 2a 2a 0a 20 20  mode-2)..  **.  
60e0: 2a 2a 20 20 20 2a 20 20 41 6c 77 61 79 73 20 75  **   *  Always u
60f0: 73 65 20 61 20 75 6e 69 66 69 65 64 20 63 61 63  se a unified cac
6100: 68 65 20 28 6d 6f 64 65 2d 32 29 20 69 66 20 45  he (mode-2) if E
6110: 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e  NABLE_MEMORY_MAN
6120: 41 47 45 4d 45 4e 54 0a 20 20 2a 2a 0a 20 20 2a  AGEMENT.  **.  *
6130: 2a 20 20 20 2a 20 20 55 73 65 20 61 20 75 6e 69  *   *  Use a uni
6140: 66 69 65 64 20 63 61 63 68 65 20 69 6e 20 73 69  fied cache in si
6150: 6e 67 6c 65 2d 74 68 72 65 61 64 65 64 20 61 70  ngle-threaded ap
6160: 70 6c 69 63 61 74 69 6f 6e 73 20 74 68 61 74 20  plications that 
6170: 68 61 76 65 0a 20 20 2a 2a 20 20 20 20 20 20 63  have.  **      c
6180: 6f 6e 66 69 67 75 72 65 64 20 61 20 73 74 61 72  onfigured a star
6190: 74 2d 74 69 6d 65 20 62 75 66 66 65 72 20 66 6f  t-time buffer fo
61a0: 72 20 75 73 65 20 61 73 20 70 61 67 65 2d 63 61  r use as page-ca
61b0: 63 68 65 20 6d 65 6d 6f 72 79 20 75 73 69 6e 67  che memory using
61c0: 0a 20 20 2a 2a 20 20 20 20 20 20 73 71 6c 69 74  .  **      sqlit
61d0: 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54 45  e3_config(SQLITE
61e0: 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48  _CONFIG_PAGECACH
61f0: 45 2c 20 70 42 75 66 2c 20 73 7a 2c 20 4e 29 20  E, pBuf, sz, N) 
6200: 77 69 74 68 20 6e 6f 6e 2d 4e 55 4c 4c 20 0a 20  with non-NULL . 
6210: 20 2a 2a 20 20 20 20 20 20 70 42 75 66 20 61 72   **      pBuf ar
6220: 67 75 6d 65 6e 74 2e 0a 20 20 2a 2a 0a 20 20 2a  gument..  **.  *
6230: 2a 20 20 20 2a 20 20 4f 74 68 65 72 77 69 73 65  *   *  Otherwise
6240: 20 75 73 65 20 73 65 70 61 72 61 74 65 20 63 61   use separate ca
6250: 63 68 65 73 20 28 6d 6f 64 65 2d 31 29 0a 20 20  ches (mode-1).  
6260: 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53  */.#if defined(S
6270: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d  QLITE_ENABLE_MEM
6280: 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 29 0a  ORY_MANAGEMENT).
6290: 20 20 70 63 61 63 68 65 31 2e 73 65 70 61 72 61    pcache1.separa
62a0: 74 65 43 61 63 68 65 20 3d 20 30 3b 0a 23 65 6c  teCache = 0;.#el
62b0: 69 66 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44  if SQLITE_THREAD
62c0: 53 41 46 45 0a 20 20 70 63 61 63 68 65 31 2e 73  SAFE.  pcache1.s
62d0: 65 70 61 72 61 74 65 43 61 63 68 65 20 3d 20 73  eparateCache = s
62e0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66  qlite3GlobalConf
62f0: 69 67 2e 70 50 61 67 65 3d 3d 30 0a 20 20 20 20  ig.pPage==0.    
6300: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6310: 20 20 20 20 20 20 7c 7c 20 73 71 6c 69 74 65 33        || sqlite3
6320: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f  GlobalConfig.bCo
6330: 72 65 4d 75 74 65 78 3e 30 3b 0a 23 65 6c 73 65  reMutex>0;.#else
6340: 0a 20 20 70 63 61 63 68 65 31 2e 73 65 70 61 72  .  pcache1.separ
6350: 61 74 65 43 61 63 68 65 20 3d 20 73 71 6c 69 74  ateCache = sqlit
6360: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70  e3GlobalConfig.p
6370: 50 61 67 65 3d 3d 30 3b 0a 23 65 6e 64 69 66 0a  Page==0;.#endif.
6380: 0a 23 69 66 20 53 51 4c 49 54 45 5f 54 48 52 45  .#if SQLITE_THRE
6390: 41 44 53 41 46 45 0a 20 20 69 66 28 20 73 71 6c  ADSAFE.  if( sql
63a0: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67  ite3GlobalConfig
63b0: 2e 62 43 6f 72 65 4d 75 74 65 78 20 29 7b 0a 20  .bCoreMutex ){. 
63c0: 20 20 20 70 63 61 63 68 65 31 2e 67 72 70 2e 6d     pcache1.grp.m
63d0: 75 74 65 78 20 3d 20 73 71 6c 69 74 65 33 4d 75  utex = sqlite3Mu
63e0: 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f  texAlloc(SQLITE_
63f0: 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c 52 55  MUTEX_STATIC_LRU
6400: 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 6d  );.    pcache1.m
6410: 75 74 65 78 20 3d 20 73 71 6c 69 74 65 33 4d 75  utex = sqlite3Mu
6420: 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f  texAlloc(SQLITE_
6430: 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 50 4d 45  MUTEX_STATIC_PME
6440: 4d 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20  M);.  }.#endif. 
6450: 20 69 66 28 20 70 63 61 63 68 65 31 2e 73 65 70   if( pcache1.sep
6460: 61 72 61 74 65 43 61 63 68 65 0a 20 20 20 26 26  arateCache.   &&
6470: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f   sqlite3GlobalCo
6480: 6e 66 69 67 2e 6e 50 61 67 65 21 3d 30 0a 20 20  nfig.nPage!=0.  
6490: 20 26 26 20 73 71 6c 69 74 65 33 47 6c 6f 62 61   && sqlite3Globa
64a0: 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65 3d 3d 30  lConfig.pPage==0
64b0: 0a 20 20 29 7b 0a 20 20 20 20 70 63 61 63 68 65  .  ){.    pcache
64c0: 31 2e 6e 49 6e 69 74 50 61 67 65 20 3d 20 73 71  1.nInitPage = sq
64d0: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69  lite3GlobalConfi
64e0: 67 2e 6e 50 61 67 65 3b 0a 20 20 7d 65 6c 73 65  g.nPage;.  }else
64f0: 7b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 6e 49  {.    pcache1.nI
6500: 6e 69 74 50 61 67 65 20 3d 20 30 3b 0a 20 20 7d  nitPage = 0;.  }
6510: 0a 20 20 70 63 61 63 68 65 31 2e 67 72 70 2e 6d  .  pcache1.grp.m
6520: 78 50 69 6e 6e 65 64 20 3d 20 31 30 3b 0a 20 20  xPinned = 10;.  
6530: 70 63 61 63 68 65 31 2e 69 73 49 6e 69 74 20 3d  pcache1.isInit =
6540: 20 31 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c   1;.  return SQL
6550: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ITE_OK;.}../*.**
6560: 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20   Implementation 
6570: 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70  of the sqlite3_p
6580: 63 61 63 68 65 2e 78 53 68 75 74 64 6f 77 6e 20  cache.xShutdown 
6590: 6d 65 74 68 6f 64 2e 0a 2a 2a 20 4e 6f 74 65 20  method..** Note 
65a0: 74 68 61 74 20 74 68 65 20 73 74 61 74 69 63 20  that the static 
65b0: 6d 75 74 65 78 20 61 6c 6c 6f 63 61 74 65 64 20  mutex allocated 
65c0: 69 6e 20 78 49 6e 69 74 20 64 6f 65 73 20 0a 2a  in xInit does .*
65d0: 2a 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 62 65  * not need to be
65e0: 20 66 72 65 65 64 2e 0a 2a 2f 0a 73 74 61 74 69   freed..*/.stati
65f0: 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 53 68  c void pcache1Sh
6600: 75 74 64 6f 77 6e 28 76 6f 69 64 20 2a 4e 6f 74  utdown(void *Not
6610: 55 73 65 64 29 7b 0a 20 20 55 4e 55 53 45 44 5f  Used){.  UNUSED_
6620: 50 41 52 41 4d 45 54 45 52 28 4e 6f 74 55 73 65  PARAMETER(NotUse
6630: 64 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 63  d);.  assert( pc
6640: 61 63 68 65 31 2e 69 73 49 6e 69 74 21 3d 30 20  ache1.isInit!=0 
6650: 29 3b 0a 20 20 6d 65 6d 73 65 74 28 26 70 63 61  );.  memset(&pca
6660: 63 68 65 31 2c 20 30 2c 20 73 69 7a 65 6f 66 28  che1, 0, sizeof(
6670: 70 63 61 63 68 65 31 29 29 3b 0a 7d 0a 0a 2f 2a  pcache1));.}../*
6680: 20 66 6f 72 77 61 72 64 20 64 65 63 6c 61 72 61   forward declara
6690: 74 69 6f 6e 20 2a 2f 0a 73 74 61 74 69 63 20 76  tion */.static v
66a0: 6f 69 64 20 70 63 61 63 68 65 31 44 65 73 74 72  oid pcache1Destr
66b0: 6f 79 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68  oy(sqlite3_pcach
66c0: 65 20 2a 70 29 3b 0a 0a 2f 2a 0a 2a 2a 20 49 6d  e *p);../*.** Im
66d0: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20  plementation of 
66e0: 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63  the sqlite3_pcac
66f0: 68 65 2e 78 43 72 65 61 74 65 20 6d 65 74 68 6f  he.xCreate metho
6700: 64 2e 0a 2a 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74  d..**.** Allocat
6710: 65 20 61 20 6e 65 77 20 63 61 63 68 65 2e 0a 2a  e a new cache..*
6720: 2f 0a 73 74 61 74 69 63 20 73 71 6c 69 74 65 33  /.static sqlite3
6730: 5f 70 63 61 63 68 65 20 2a 70 63 61 63 68 65 31  _pcache *pcache1
6740: 43 72 65 61 74 65 28 69 6e 74 20 73 7a 50 61 67  Create(int szPag
6750: 65 2c 20 69 6e 74 20 73 7a 45 78 74 72 61 2c 20  e, int szExtra, 
6760: 69 6e 74 20 62 50 75 72 67 65 61 62 6c 65 29 7b  int bPurgeable){
6770: 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63  .  PCache1 *pCac
6780: 68 65 3b 20 20 20 20 20 20 2f 2a 20 54 68 65 20  he;      /* The 
6790: 6e 65 77 6c 79 20 63 72 65 61 74 65 64 20 70 61  newly created pa
67a0: 67 65 20 63 61 63 68 65 20 2a 2f 0a 20 20 50 47  ge cache */.  PG
67b0: 72 6f 75 70 20 2a 70 47 72 6f 75 70 3b 20 20 20  roup *pGroup;   
67c0: 20 20 20 20 2f 2a 20 54 68 65 20 67 72 6f 75 70      /* The group
67d0: 20 74 68 65 20 6e 65 77 20 70 61 67 65 20 63 61   the new page ca
67e0: 63 68 65 20 77 69 6c 6c 20 62 65 6c 6f 6e 67 20  che will belong 
67f0: 74 6f 20 2a 2f 0a 20 20 69 6e 74 20 73 7a 3b 20  to */.  int sz; 
6800: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
6810: 20 42 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79   Bytes of memory
6820: 20 72 65 71 75 69 72 65 64 20 74 6f 20 61 6c 6c   required to all
6830: 6f 63 61 74 65 20 74 68 65 20 6e 65 77 20 63 61  ocate the new ca
6840: 63 68 65 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74  che */..  assert
6850: 28 20 28 73 7a 50 61 67 65 20 26 20 28 73 7a 50  ( (szPage & (szP
6860: 61 67 65 2d 31 29 29 3d 3d 30 20 26 26 20 73 7a  age-1))==0 && sz
6870: 50 61 67 65 3e 3d 35 31 32 20 26 26 20 73 7a 50  Page>=512 && szP
6880: 61 67 65 3c 3d 36 35 35 33 36 20 29 3b 0a 20 20  age<=65536 );.  
6890: 61 73 73 65 72 74 28 20 73 7a 45 78 74 72 61 20  assert( szExtra 
68a0: 3c 20 33 30 30 20 29 3b 0a 0a 20 20 73 7a 20 3d  < 300 );..  sz =
68b0: 20 73 69 7a 65 6f 66 28 50 43 61 63 68 65 31 29   sizeof(PCache1)
68c0: 20 2b 20 73 69 7a 65 6f 66 28 50 47 72 6f 75 70   + sizeof(PGroup
68d0: 29 2a 70 63 61 63 68 65 31 2e 73 65 70 61 72 61  )*pcache1.separa
68e0: 74 65 43 61 63 68 65 3b 0a 20 20 70 43 61 63 68  teCache;.  pCach
68f0: 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 73  e = (PCache1 *)s
6900: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f  qlite3MallocZero
6910: 28 73 7a 29 3b 0a 20 20 69 66 28 20 70 43 61 63  (sz);.  if( pCac
6920: 68 65 20 29 7b 0a 20 20 20 20 69 66 28 20 70 63  he ){.    if( pc
6930: 61 63 68 65 31 2e 73 65 70 61 72 61 74 65 43 61  ache1.separateCa
6940: 63 68 65 20 29 7b 0a 20 20 20 20 20 20 70 47 72  che ){.      pGr
6950: 6f 75 70 20 3d 20 28 50 47 72 6f 75 70 2a 29 26  oup = (PGroup*)&
6960: 70 43 61 63 68 65 5b 31 5d 3b 0a 20 20 20 20 20  pCache[1];.     
6970: 20 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65   pGroup->mxPinne
6980: 64 20 3d 20 31 30 3b 0a 20 20 20 20 7d 65 6c 73  d = 10;.    }els
6990: 65 7b 0a 20 20 20 20 20 20 70 47 72 6f 75 70 20  e{.      pGroup 
69a0: 3d 20 26 70 63 61 63 68 65 31 2e 67 72 70 3b 0a  = &pcache1.grp;.
69b0: 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 47      }.    if( pG
69c0: 72 6f 75 70 2d 3e 6c 72 75 2e 69 73 41 6e 63 68  roup->lru.isAnch
69d0: 6f 72 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 70  or==0 ){.      p
69e0: 47 72 6f 75 70 2d 3e 6c 72 75 2e 69 73 41 6e 63  Group->lru.isAnc
69f0: 68 6f 72 20 3d 20 31 3b 0a 20 20 20 20 20 20 70  hor = 1;.      p
6a00: 47 72 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72 75 50  Group->lru.pLruP
6a10: 72 65 76 20 3d 20 70 47 72 6f 75 70 2d 3e 6c 72  rev = pGroup->lr
6a20: 75 2e 70 4c 72 75 4e 65 78 74 20 3d 20 26 70 47  u.pLruNext = &pG
6a30: 72 6f 75 70 2d 3e 6c 72 75 3b 0a 20 20 20 20 7d  roup->lru;.    }
6a40: 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 70 47 72  .    pCache->pGr
6a50: 6f 75 70 20 3d 20 70 47 72 6f 75 70 3b 0a 20 20  oup = pGroup;.  
6a60: 20 20 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65    pCache->szPage
6a70: 20 3d 20 73 7a 50 61 67 65 3b 0a 20 20 20 20 70   = szPage;.    p
6a80: 43 61 63 68 65 2d 3e 73 7a 45 78 74 72 61 20 3d  Cache->szExtra =
6a90: 20 73 7a 45 78 74 72 61 3b 0a 20 20 20 20 70 43   szExtra;.    pC
6aa0: 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63 20 3d 20  ache->szAlloc = 
6ab0: 73 7a 50 61 67 65 20 2b 20 73 7a 45 78 74 72 61  szPage + szExtra
6ac0: 20 2b 20 52 4f 55 4e 44 38 28 73 69 7a 65 6f 66   + ROUND8(sizeof
6ad0: 28 50 67 48 64 72 31 29 29 3b 0a 20 20 20 20 70  (PgHdr1));.    p
6ae0: 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c  Cache->bPurgeabl
6af0: 65 20 3d 20 28 62 50 75 72 67 65 61 62 6c 65 20  e = (bPurgeable 
6b00: 3f 20 31 20 3a 20 30 29 3b 0a 20 20 20 20 70 63  ? 1 : 0);.    pc
6b10: 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28  ache1EnterMutex(
6b20: 70 47 72 6f 75 70 29 3b 0a 20 20 20 20 70 63 61  pGroup);.    pca
6b30: 63 68 65 31 52 65 73 69 7a 65 48 61 73 68 28 70  che1ResizeHash(p
6b40: 43 61 63 68 65 29 3b 0a 20 20 20 20 69 66 28 20  Cache);.    if( 
6b50: 62 50 75 72 67 65 61 62 6c 65 20 29 7b 0a 20 20  bPurgeable ){.  
6b60: 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e      pCache->nMin
6b70: 20 3d 20 31 30 3b 0a 20 20 20 20 20 20 70 47 72   = 10;.      pGr
6b80: 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 20 2b 3d  oup->nMinPage +=
6b90: 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 3b 0a 20   pCache->nMin;. 
6ba0: 20 20 20 20 20 70 47 72 6f 75 70 2d 3e 6d 78 50       pGroup->mxP
6bb0: 69 6e 6e 65 64 20 3d 20 70 47 72 6f 75 70 2d 3e  inned = pGroup->
6bc0: 6e 4d 61 78 50 61 67 65 20 2b 20 31 30 20 2d 20  nMaxPage + 10 - 
6bd0: 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65  pGroup->nMinPage
6be0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 63 61 63  ;.    }.    pcac
6bf0: 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70 47  he1LeaveMutex(pG
6c00: 72 6f 75 70 29 3b 0a 20 20 20 20 69 66 28 20 70  roup);.    if( p
6c10: 43 61 63 68 65 2d 3e 6e 48 61 73 68 3d 3d 30 20  Cache->nHash==0 
6c20: 29 7b 0a 20 20 20 20 20 20 70 63 61 63 68 65 31  ){.      pcache1
6c30: 44 65 73 74 72 6f 79 28 28 73 71 6c 69 74 65 33  Destroy((sqlite3
6c40: 5f 70 63 61 63 68 65 2a 29 70 43 61 63 68 65 29  _pcache*)pCache)
6c50: 3b 0a 20 20 20 20 20 20 70 43 61 63 68 65 20 3d  ;.      pCache =
6c60: 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20   0;.    }.  }.  
6c70: 72 65 74 75 72 6e 20 28 73 71 6c 69 74 65 33 5f  return (sqlite3_
6c80: 70 63 61 63 68 65 20 2a 29 70 43 61 63 68 65 3b  pcache *)pCache;
6c90: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d  .}../*.** Implem
6ca0: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20  entation of the 
6cb0: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78  sqlite3_pcache.x
6cc0: 43 61 63 68 65 73 69 7a 65 20 6d 65 74 68 6f 64  Cachesize method
6cd0: 2e 20 0a 2a 2a 0a 2a 2a 20 43 6f 6e 66 69 67 75  . .**.** Configu
6ce0: 72 65 20 74 68 65 20 63 61 63 68 65 5f 73 69 7a  re the cache_siz
6cf0: 65 20 6c 69 6d 69 74 20 66 6f 72 20 61 20 63 61  e limit for a ca
6d00: 63 68 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  che..*/.static v
6d10: 6f 69 64 20 70 63 61 63 68 65 31 43 61 63 68 65  oid pcache1Cache
6d20: 73 69 7a 65 28 73 71 6c 69 74 65 33 5f 70 63 61  size(sqlite3_pca
6d30: 63 68 65 20 2a 70 2c 20 69 6e 74 20 6e 4d 61 78  che *p, int nMax
6d40: 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43  ){.  PCache1 *pC
6d50: 61 63 68 65 20 3d 20 28 50 43 61 63 68 65 31 20  ache = (PCache1 
6d60: 2a 29 70 3b 0a 20 20 69 66 28 20 70 43 61 63 68  *)p;.  if( pCach
6d70: 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 29 7b  e->bPurgeable ){
6d80: 0a 20 20 20 20 50 47 72 6f 75 70 20 2a 70 47 72  .    PGroup *pGr
6d90: 6f 75 70 20 3d 20 70 43 61 63 68 65 2d 3e 70 47  oup = pCache->pG
6da0: 72 6f 75 70 3b 0a 20 20 20 20 70 63 61 63 68 65  roup;.    pcache
6db0: 31 45 6e 74 65 72 4d 75 74 65 78 28 70 47 72 6f  1EnterMutex(pGro
6dc0: 75 70 29 3b 0a 20 20 20 20 70 47 72 6f 75 70 2d  up);.    pGroup-
6dd0: 3e 6e 4d 61 78 50 61 67 65 20 2b 3d 20 28 6e 4d  >nMaxPage += (nM
6de0: 61 78 20 2d 20 70 43 61 63 68 65 2d 3e 6e 4d 61  ax - pCache->nMa
6df0: 78 29 3b 0a 20 20 20 20 70 47 72 6f 75 70 2d 3e  x);.    pGroup->
6e00: 6d 78 50 69 6e 6e 65 64 20 3d 20 70 47 72 6f 75  mxPinned = pGrou
6e10: 70 2d 3e 6e 4d 61 78 50 61 67 65 20 2b 20 31 30  p->nMaxPage + 10
6e20: 20 2d 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50   - pGroup->nMinP
6e30: 61 67 65 3b 0a 20 20 20 20 70 43 61 63 68 65 2d  age;.    pCache-
6e40: 3e 6e 4d 61 78 20 3d 20 6e 4d 61 78 3b 0a 20 20  >nMax = nMax;.  
6e50: 20 20 70 43 61 63 68 65 2d 3e 6e 39 30 70 63 74    pCache->n90pct
6e60: 20 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 2a   = pCache->nMax*
6e70: 39 2f 31 30 3b 0a 20 20 20 20 70 63 61 63 68 65  9/10;.    pcache
6e80: 31 45 6e 66 6f 72 63 65 4d 61 78 50 61 67 65 28  1EnforceMaxPage(
6e90: 70 43 61 63 68 65 29 3b 0a 20 20 20 20 70 63 61  pCache);.    pca
6ea0: 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70  che1LeaveMutex(p
6eb0: 47 72 6f 75 70 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f  Group);.  }.}../
6ec0: 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74  *.** Implementat
6ed0: 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74  ion of the sqlit
6ee0: 65 33 5f 70 63 61 63 68 65 2e 78 53 68 72 69 6e  e3_pcache.xShrin
6ef0: 6b 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a  k method. .**.**
6f00: 20 46 72 65 65 20 75 70 20 61 73 20 6d 75 63 68   Free up as much
6f10: 20 6d 65 6d 6f 72 79 20 61 73 20 70 6f 73 73 69   memory as possi
6f20: 62 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  ble..*/.static v
6f30: 6f 69 64 20 70 63 61 63 68 65 31 53 68 72 69 6e  oid pcache1Shrin
6f40: 6b 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  k(sqlite3_pcache
6f50: 20 2a 70 29 7b 0a 20 20 50 43 61 63 68 65 31 20   *p){.  PCache1 
6f60: 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61 63 68  *pCache = (PCach
6f70: 65 31 2a 29 70 3b 0a 20 20 69 66 28 20 70 43 61  e1*)p;.  if( pCa
6f80: 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20  che->bPurgeable 
6f90: 29 7b 0a 20 20 20 20 50 47 72 6f 75 70 20 2a 70  ){.    PGroup *p
6fa0: 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65 2d 3e  Group = pCache->
6fb0: 70 47 72 6f 75 70 3b 0a 20 20 20 20 69 6e 74 20  pGroup;.    int 
6fc0: 73 61 76 65 64 4d 61 78 50 61 67 65 3b 0a 20 20  savedMaxPage;.  
6fd0: 20 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75    pcache1EnterMu
6fe0: 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20 20 20  tex(pGroup);.   
6ff0: 20 73 61 76 65 64 4d 61 78 50 61 67 65 20 3d 20   savedMaxPage = 
7000: 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65  pGroup->nMaxPage
7010: 3b 0a 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e 4d  ;.    pGroup->nM
7020: 61 78 50 61 67 65 20 3d 20 30 3b 0a 20 20 20 20  axPage = 0;.    
7030: 70 63 61 63 68 65 31 45 6e 66 6f 72 63 65 4d 61  pcache1EnforceMa
7040: 78 50 61 67 65 28 70 43 61 63 68 65 29 3b 0a 20  xPage(pCache);. 
7050: 20 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50     pGroup->nMaxP
7060: 61 67 65 20 3d 20 73 61 76 65 64 4d 61 78 50 61  age = savedMaxPa
7070: 67 65 3b 0a 20 20 20 20 70 63 61 63 68 65 31 4c  ge;.    pcache1L
7080: 65 61 76 65 4d 75 74 65 78 28 70 47 72 6f 75 70  eaveMutex(pGroup
7090: 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  );.  }.}../*.** 
70a0: 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  Implementation o
70b0: 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63  f the sqlite3_pc
70c0: 61 63 68 65 2e 78 50 61 67 65 63 6f 75 6e 74 20  ache.xPagecount 
70d0: 6d 65 74 68 6f 64 2e 20 0a 2a 2f 0a 73 74 61 74  method. .*/.stat
70e0: 69 63 20 69 6e 74 20 70 63 61 63 68 65 31 50 61  ic int pcache1Pa
70f0: 67 65 63 6f 75 6e 74 28 73 71 6c 69 74 65 33 5f  gecount(sqlite3_
7100: 70 63 61 63 68 65 20 2a 70 29 7b 0a 20 20 69 6e  pcache *p){.  in
7110: 74 20 6e 3b 0a 20 20 50 43 61 63 68 65 31 20 2a  t n;.  PCache1 *
7120: 70 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 65  pCache = (PCache
7130: 31 2a 29 70 3b 0a 20 20 70 63 61 63 68 65 31 45  1*)p;.  pcache1E
7140: 6e 74 65 72 4d 75 74 65 78 28 70 43 61 63 68 65  nterMutex(pCache
7150: 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20 6e 20 3d  ->pGroup);.  n =
7160: 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 3b 0a   pCache->nPage;.
7170: 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75    pcache1LeaveMu
7180: 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f  tex(pCache->pGro
7190: 75 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 6e 3b  up);.  return n;
71a0: 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65  .}.../*.** Imple
71b0: 6d 65 6e 74 20 73 74 65 70 73 20 33 2c 20 34 2c  ment steps 3, 4,
71c0: 20 61 6e 64 20 35 20 6f 66 20 74 68 65 20 70 63   and 5 of the pc
71d0: 61 63 68 65 31 46 65 74 63 68 28 29 20 61 6c 67  ache1Fetch() alg
71e0: 6f 72 69 74 68 6d 20 64 65 73 63 72 69 62 65 64  orithm described
71f0: 0a 2a 2a 20 69 6e 20 74 68 65 20 68 65 61 64 65  .** in the heade
7200: 72 20 6f 66 20 74 68 65 20 70 63 61 63 68 65 31  r of the pcache1
7210: 46 65 74 63 68 28 29 20 70 72 6f 63 65 64 75 72  Fetch() procedur
7220: 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 73 74  e..**.** This st
7230: 65 70 73 20 61 72 65 20 62 72 6f 6b 65 6e 20 6f  eps are broken o
7240: 75 74 20 69 6e 74 6f 20 61 20 73 65 70 61 72 61  ut into a separa
7250: 74 65 20 70 72 6f 63 65 64 75 72 65 20 62 65 63  te procedure bec
7260: 61 75 73 65 20 74 68 65 79 20 61 72 65 0a 2a 2a  ause they are.**
7270: 20 75 73 75 61 6c 6c 79 20 6e 6f 74 20 6e 65 65   usually not nee
7280: 64 65 64 2c 20 61 6e 64 20 62 79 20 61 76 6f 69  ded, and by avoi
7290: 64 69 6e 67 20 74 68 65 20 73 74 61 63 6b 20 69  ding the stack i
72a0: 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 72 65  nitialization re
72b0: 71 75 69 72 65 64 0a 2a 2a 20 66 6f 72 20 74 68  quired.** for th
72c0: 65 73 65 20 73 74 65 70 73 2c 20 74 68 65 20 6d  ese steps, the m
72d0: 61 69 6e 20 70 63 61 63 68 65 31 46 65 74 63 68  ain pcache1Fetch
72e0: 28 29 20 70 72 6f 63 65 64 75 72 65 20 63 61 6e  () procedure can
72f0: 20 72 75 6e 20 66 61 73 74 65 72 2e 0a 2a 2f 0a   run faster..*/.
7300: 73 74 61 74 69 63 20 53 51 4c 49 54 45 5f 4e 4f  static SQLITE_NO
7310: 49 4e 4c 49 4e 45 20 50 67 48 64 72 31 20 2a 70  INLINE PgHdr1 *p
7320: 63 61 63 68 65 31 46 65 74 63 68 53 74 61 67 65  cache1FetchStage
7330: 32 28 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43  2(.  PCache1 *pC
7340: 61 63 68 65 2c 20 0a 20 20 75 6e 73 69 67 6e 65  ache, .  unsigne
7350: 64 20 69 6e 74 20 69 4b 65 79 2c 20 0a 20 20 69  d int iKey, .  i
7360: 6e 74 20 63 72 65 61 74 65 46 6c 61 67 0a 29 7b  nt createFlag.){
7370: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
7380: 6e 50 69 6e 6e 65 64 3b 0a 20 20 50 47 72 6f 75  nPinned;.  PGrou
7390: 70 20 2a 70 47 72 6f 75 70 20 3d 20 70 43 61 63  p *pGroup = pCac
73a0: 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20 20 50 67  he->pGroup;.  Pg
73b0: 48 64 72 31 20 2a 70 50 61 67 65 20 3d 20 30 3b  Hdr1 *pPage = 0;
73c0: 0a 0a 20 20 2f 2a 20 53 74 65 70 20 33 3a 20 41  ..  /* Step 3: A
73d0: 62 6f 72 74 20 69 66 20 63 72 65 61 74 65 46 6c  bort if createFl
73e0: 61 67 20 69 73 20 31 20 62 75 74 20 74 68 65 20  ag is 1 but the 
73f0: 63 61 63 68 65 20 69 73 20 6e 65 61 72 6c 79 20  cache is nearly 
7400: 66 75 6c 6c 20 2a 2f 0a 20 20 61 73 73 65 72 74  full */.  assert
7410: 28 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 20  ( pCache->nPage 
7420: 3e 3d 20 70 43 61 63 68 65 2d 3e 6e 52 65 63 79  >= pCache->nRecy
7430: 63 6c 61 62 6c 65 20 29 3b 0a 20 20 6e 50 69 6e  clable );.  nPin
7440: 6e 65 64 20 3d 20 70 43 61 63 68 65 2d 3e 6e 50  ned = pCache->nP
7450: 61 67 65 20 2d 20 70 43 61 63 68 65 2d 3e 6e 52  age - pCache->nR
7460: 65 63 79 63 6c 61 62 6c 65 3b 0a 20 20 61 73 73  ecyclable;.  ass
7470: 65 72 74 28 20 70 47 72 6f 75 70 2d 3e 6d 78 50  ert( pGroup->mxP
7480: 69 6e 6e 65 64 20 3d 3d 20 70 47 72 6f 75 70 2d  inned == pGroup-
7490: 3e 6e 4d 61 78 50 61 67 65 20 2b 20 31 30 20 2d  >nMaxPage + 10 -
74a0: 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67   pGroup->nMinPag
74b0: 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  e );.  assert( p
74c0: 43 61 63 68 65 2d 3e 6e 39 30 70 63 74 20 3d 3d  Cache->n90pct ==
74d0: 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 2a 39 2f   pCache->nMax*9/
74e0: 31 30 20 29 3b 0a 20 20 69 66 28 20 63 72 65 61  10 );.  if( crea
74f0: 74 65 46 6c 61 67 3d 3d 31 20 26 26 20 28 0a 20  teFlag==1 && (. 
7500: 20 20 20 20 20 20 20 6e 50 69 6e 6e 65 64 3e 3d         nPinned>=
7510: 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64  pGroup->mxPinned
7520: 0a 20 20 20 20 20 7c 7c 20 6e 50 69 6e 6e 65 64  .     || nPinned
7530: 3e 3d 70 43 61 63 68 65 2d 3e 6e 39 30 70 63 74  >=pCache->n90pct
7540: 0a 20 20 20 20 20 7c 7c 20 28 70 63 61 63 68 65  .     || (pcache
7550: 31 55 6e 64 65 72 4d 65 6d 6f 72 79 50 72 65 73  1UnderMemoryPres
7560: 73 75 72 65 28 70 43 61 63 68 65 29 20 26 26 20  sure(pCache) && 
7570: 70 43 61 63 68 65 2d 3e 6e 52 65 63 79 63 6c 61  pCache->nRecycla
7580: 62 6c 65 3c 6e 50 69 6e 6e 65 64 29 0a 20 20 29  ble<nPinned).  )
7590: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b  ){.    return 0;
75a0: 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 43 61 63  .  }..  if( pCac
75b0: 68 65 2d 3e 6e 50 61 67 65 3e 3d 70 43 61 63 68  he->nPage>=pCach
75c0: 65 2d 3e 6e 48 61 73 68 20 29 20 70 63 61 63 68  e->nHash ) pcach
75d0: 65 31 52 65 73 69 7a 65 48 61 73 68 28 70 43 61  e1ResizeHash(pCa
75e0: 63 68 65 29 3b 0a 20 20 61 73 73 65 72 74 28 20  che);.  assert( 
75f0: 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 3e 30 20  pCache->nHash>0 
7600: 26 26 20 70 43 61 63 68 65 2d 3e 61 70 48 61 73  && pCache->apHas
7610: 68 20 29 3b 0a 0a 20 20 2f 2a 20 53 74 65 70 20  h );..  /* Step 
7620: 34 2e 20 54 72 79 20 74 6f 20 72 65 63 79 63 6c  4. Try to recycl
7630: 65 20 61 20 70 61 67 65 2e 20 2a 2f 0a 20 20 69  e a page. */.  i
7640: 66 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67  f( pCache->bPurg
7650: 65 61 62 6c 65 0a 20 20 20 26 26 20 21 70 47 72  eable.   && !pGr
7660: 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72 75 50 72 65  oup->lru.pLruPre
7670: 76 2d 3e 69 73 41 6e 63 68 6f 72 0a 20 20 20 26  v->isAnchor.   &
7680: 26 20 28 28 70 43 61 63 68 65 2d 3e 6e 50 61 67  & ((pCache->nPag
7690: 65 2b 31 3e 3d 70 43 61 63 68 65 2d 3e 6e 4d 61  e+1>=pCache->nMa
76a0: 78 29 20 7c 7c 20 70 63 61 63 68 65 31 55 6e 64  x) || pcache1Und
76b0: 65 72 4d 65 6d 6f 72 79 50 72 65 73 73 75 72 65  erMemoryPressure
76c0: 28 70 43 61 63 68 65 29 29 0a 20 20 29 7b 0a 20  (pCache)).  ){. 
76d0: 20 20 20 50 43 61 63 68 65 31 20 2a 70 4f 74 68     PCache1 *pOth
76e0: 65 72 3b 0a 20 20 20 20 70 50 61 67 65 20 3d 20  er;.    pPage = 
76f0: 70 47 72 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72 75  pGroup->lru.pLru
7700: 50 72 65 76 3b 0a 20 20 20 20 61 73 73 65 72 74  Prev;.    assert
7710: 28 20 70 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65  ( pPage->isPinne
7720: 64 3d 3d 30 20 29 3b 0a 20 20 20 20 70 63 61 63  d==0 );.    pcac
7730: 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73  he1RemoveFromHas
7740: 68 28 70 50 61 67 65 2c 20 30 29 3b 0a 20 20 20  h(pPage, 0);.   
7750: 20 70 63 61 63 68 65 31 50 69 6e 50 61 67 65 28   pcache1PinPage(
7760: 70 50 61 67 65 29 3b 0a 20 20 20 20 70 4f 74 68  pPage);.    pOth
7770: 65 72 20 3d 20 70 50 61 67 65 2d 3e 70 43 61 63  er = pPage->pCac
7780: 68 65 3b 0a 20 20 20 20 69 66 28 20 70 4f 74 68  he;.    if( pOth
7790: 65 72 2d 3e 73 7a 41 6c 6c 6f 63 20 21 3d 20 70  er->szAlloc != p
77a0: 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63 20 29  Cache->szAlloc )
77b0: 7b 0a 20 20 20 20 20 20 70 63 61 63 68 65 31 46  {.      pcache1F
77c0: 72 65 65 50 61 67 65 28 70 50 61 67 65 29 3b 0a  reePage(pPage);.
77d0: 20 20 20 20 20 20 70 50 61 67 65 20 3d 20 30 3b        pPage = 0;
77e0: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  .    }else{.    
77f0: 20 20 70 47 72 6f 75 70 2d 3e 6e 43 75 72 72 65    pGroup->nCurre
7800: 6e 74 50 61 67 65 20 2d 3d 20 28 70 4f 74 68 65  ntPage -= (pOthe
7810: 72 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 2d 20  r->bPurgeable - 
7820: 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62  pCache->bPurgeab
7830: 6c 65 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a  le);.    }.  }..
7840: 20 20 2f 2a 20 53 74 65 70 20 35 2e 20 49 66 20    /* Step 5. If 
7850: 61 20 75 73 61 62 6c 65 20 70 61 67 65 20 62 75  a usable page bu
7860: 66 66 65 72 20 68 61 73 20 73 74 69 6c 6c 20 6e  ffer has still n
7870: 6f 74 20 62 65 65 6e 20 66 6f 75 6e 64 2c 20 0a  ot been found, .
7880: 20 20 2a 2a 20 61 74 74 65 6d 70 74 20 74 6f 20    ** attempt to 
7890: 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 6f  allocate a new o
78a0: 6e 65 2e 20 0a 20 20 2a 2f 0a 20 20 69 66 28 20  ne. .  */.  if( 
78b0: 21 70 50 61 67 65 20 29 7b 0a 20 20 20 20 70 50  !pPage ){.    pP
78c0: 61 67 65 20 3d 20 70 63 61 63 68 65 31 41 6c 6c  age = pcache1All
78d0: 6f 63 50 61 67 65 28 70 43 61 63 68 65 2c 20 63  ocPage(pCache, c
78e0: 72 65 61 74 65 46 6c 61 67 3d 3d 31 29 3b 0a 20  reateFlag==1);. 
78f0: 20 7d 0a 0a 20 20 69 66 28 20 70 50 61 67 65 20   }..  if( pPage 
7900: 29 7b 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20  ){.    unsigned 
7910: 69 6e 74 20 68 20 3d 20 69 4b 65 79 20 25 20 70  int h = iKey % p
7920: 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20  Cache->nHash;.  
7930: 20 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 2b    pCache->nPage+
7940: 2b 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 4b  +;.    pPage->iK
7950: 65 79 20 3d 20 69 4b 65 79 3b 0a 20 20 20 20 70  ey = iKey;.    p
7960: 50 61 67 65 2d 3e 70 4e 65 78 74 20 3d 20 70 43  Page->pNext = pC
7970: 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 3b  ache->apHash[h];
7980: 0a 20 20 20 20 70 50 61 67 65 2d 3e 70 43 61 63  .    pPage->pCac
7990: 68 65 20 3d 20 70 43 61 63 68 65 3b 0a 20 20 20  he = pCache;.   
79a0: 20 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76   pPage->pLruPrev
79b0: 20 3d 20 30 3b 0a 20 20 20 20 70 50 61 67 65 2d   = 0;.    pPage-
79c0: 3e 70 4c 72 75 4e 65 78 74 20 3d 20 30 3b 0a 20  >pLruNext = 0;. 
79d0: 20 20 20 70 50 61 67 65 2d 3e 69 73 50 69 6e 6e     pPage->isPinn
79e0: 65 64 20 3d 20 31 3b 0a 20 20 20 20 2a 28 76 6f  ed = 1;.    *(vo
79f0: 69 64 20 2a 2a 29 70 50 61 67 65 2d 3e 70 61 67  id **)pPage->pag
7a00: 65 2e 70 45 78 74 72 61 20 3d 20 30 3b 0a 20 20  e.pExtra = 0;.  
7a10: 20 20 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68    pCache->apHash
7a20: 5b 68 5d 20 3d 20 70 50 61 67 65 3b 0a 20 20 20  [h] = pPage;.   
7a30: 20 69 66 28 20 69 4b 65 79 3e 70 43 61 63 68 65   if( iKey>pCache
7a40: 2d 3e 69 4d 61 78 4b 65 79 20 29 7b 0a 20 20 20  ->iMaxKey ){.   
7a50: 20 20 20 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b     pCache->iMaxK
7a60: 65 79 20 3d 20 69 4b 65 79 3b 0a 20 20 20 20 7d  ey = iKey;.    }
7a70: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 50  .  }.  return pP
7a80: 61 67 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d  age;.}../*.** Im
7a90: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20  plementation of 
7aa0: 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63  the sqlite3_pcac
7ab0: 68 65 2e 78 46 65 74 63 68 20 6d 65 74 68 6f 64  he.xFetch method
7ac0: 2e 20 0a 2a 2a 0a 2a 2a 20 46 65 74 63 68 20 61  . .**.** Fetch a
7ad0: 20 70 61 67 65 20 62 79 20 6b 65 79 20 76 61 6c   page by key val
7ae0: 75 65 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 74 68 65  ue..**.** Whethe
7af0: 72 20 6f 72 20 6e 6f 74 20 61 20 6e 65 77 20 70  r or not a new p
7b00: 61 67 65 20 6d 61 79 20 62 65 20 61 6c 6c 6f 63  age may be alloc
7b10: 61 74 65 64 20 62 79 20 74 68 69 73 20 66 75 6e  ated by this fun
7b20: 63 74 69 6f 6e 20 64 65 70 65 6e 64 73 20 6f 6e  ction depends on
7b30: 0a 2a 2a 20 74 68 65 20 76 61 6c 75 65 20 6f 66  .** the value of
7b40: 20 74 68 65 20 63 72 65 61 74 65 46 6c 61 67 20   the createFlag 
7b50: 61 72 67 75 6d 65 6e 74 2e 20 20 30 20 6d 65 61  argument.  0 mea
7b60: 6e 73 20 64 6f 20 6e 6f 74 20 61 6c 6c 6f 63 61  ns do not alloca
7b70: 74 65 20 61 20 6e 65 77 0a 2a 2a 20 70 61 67 65  te a new.** page
7b80: 2e 20 20 31 20 6d 65 61 6e 73 20 61 6c 6c 6f 63  .  1 means alloc
7b90: 61 74 65 20 61 20 6e 65 77 20 70 61 67 65 20 69  ate a new page i
7ba0: 66 20 73 70 61 63 65 20 69 73 20 65 61 73 69 6c  f space is easil
7bb0: 79 20 61 76 61 69 6c 61 62 6c 65 2e 20 20 32 20  y available.  2 
7bc0: 0a 2a 2a 20 6d 65 61 6e 73 20 74 6f 20 74 72 79  .** means to try
7bd0: 20 72 65 61 6c 6c 79 20 68 61 72 64 20 74 6f 20   really hard to 
7be0: 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 70  allocate a new p
7bf0: 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 61  age..**.** For a
7c00: 20 6e 6f 6e 2d 70 75 72 67 65 61 62 6c 65 20 63   non-purgeable c
7c10: 61 63 68 65 20 28 61 20 63 61 63 68 65 20 75 73  ache (a cache us
7c20: 65 64 20 61 73 20 74 68 65 20 73 74 6f 72 61 67  ed as the storag
7c30: 65 20 66 6f 72 20 61 6e 20 69 6e 2d 6d 65 6d 6f  e for an in-memo
7c40: 72 79 0a 2a 2a 20 64 61 74 61 62 61 73 65 29 20  ry.** database) 
7c50: 74 68 65 72 65 20 69 73 20 72 65 61 6c 6c 79 20  there is really 
7c60: 6e 6f 20 64 69 66 66 65 72 65 6e 63 65 20 62 65  no difference be
7c70: 74 77 65 65 6e 20 63 72 65 61 74 65 46 6c 61 67  tween createFlag
7c80: 20 31 20 61 6e 64 20 32 2e 20 20 53 6f 0a 2a 2a   1 and 2.  So.**
7c90: 20 74 68 65 20 63 61 6c 6c 69 6e 67 20 66 75 6e   the calling fun
7ca0: 63 74 69 6f 6e 20 28 70 63 61 63 68 65 2e 63 29  ction (pcache.c)
7cb0: 20 77 69 6c 6c 20 6e 65 76 65 72 20 68 61 76 65   will never have
7cc0: 20 61 20 63 72 65 61 74 65 46 6c 61 67 20 6f 66   a createFlag of
7cd0: 20 31 20 6f 6e 0a 2a 2a 20 61 20 6e 6f 6e 2d 70   1 on.** a non-p
7ce0: 75 72 67 65 61 62 6c 65 20 63 61 63 68 65 2e 0a  urgeable cache..
7cf0: 2a 2a 0a 2a 2a 20 54 68 65 72 65 20 61 72 65 20  **.** There are 
7d00: 74 68 72 65 65 20 64 69 66 66 65 72 65 6e 74 20  three different 
7d10: 61 70 70 72 6f 61 63 68 65 73 20 74 6f 20 6f 62  approaches to ob
7d20: 74 61 69 6e 69 6e 67 20 73 70 61 63 65 20 66 6f  taining space fo
7d30: 72 20 61 20 70 61 67 65 2c 0a 2a 2a 20 64 65 70  r a page,.** dep
7d40: 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 76 61  ending on the va
7d50: 6c 75 65 20 6f 66 20 70 61 72 61 6d 65 74 65 72  lue of parameter
7d60: 20 63 72 65 61 74 65 46 6c 61 67 20 28 77 68 69   createFlag (whi
7d70: 63 68 20 6d 61 79 20 62 65 20 30 2c 20 31 20 6f  ch may be 0, 1 o
7d80: 72 20 32 29 2e 0a 2a 2a 0a 2a 2a 20 20 20 31 2e  r 2)..**.**   1.
7d90: 20 52 65 67 61 72 64 6c 65 73 73 20 6f 66 20 74   Regardless of t
7da0: 68 65 20 76 61 6c 75 65 20 6f 66 20 63 72 65 61  he value of crea
7db0: 74 65 46 6c 61 67 2c 20 74 68 65 20 63 61 63 68  teFlag, the cach
7dc0: 65 20 69 73 20 73 65 61 72 63 68 65 64 20 66 6f  e is searched fo
7dd0: 72 20 61 20 0a 2a 2a 20 20 20 20 20 20 63 6f 70  r a .**      cop
7de0: 79 20 6f 66 20 74 68 65 20 72 65 71 75 65 73 74  y of the request
7df0: 65 64 20 70 61 67 65 2e 20 49 66 20 6f 6e 65 20  ed page. If one 
7e00: 69 73 20 66 6f 75 6e 64 2c 20 69 74 20 69 73 20  is found, it is 
7e10: 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20  returned..**.** 
7e20: 20 20 32 2e 20 49 66 20 63 72 65 61 74 65 46 6c    2. If createFl
7e30: 61 67 3d 3d 30 20 61 6e 64 20 74 68 65 20 70 61  ag==0 and the pa
7e40: 67 65 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64  ge is not alread
7e50: 79 20 69 6e 20 74 68 65 20 63 61 63 68 65 2c 20  y in the cache, 
7e60: 4e 55 4c 4c 20 69 73 0a 2a 2a 20 20 20 20 20 20  NULL is.**      
7e70: 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20  returned..**.** 
7e80: 20 20 33 2e 20 49 66 20 63 72 65 61 74 65 46 6c    3. If createFl
7e90: 61 67 20 69 73 20 31 2c 20 61 6e 64 20 74 68 65  ag is 1, and the
7ea0: 20 70 61 67 65 20 69 73 20 6e 6f 74 20 61 6c 72   page is not alr
7eb0: 65 61 64 79 20 69 6e 20 74 68 65 20 63 61 63 68  eady in the cach
7ec0: 65 2c 20 74 68 65 6e 0a 2a 2a 20 20 20 20 20 20  e, then.**      
7ed0: 72 65 74 75 72 6e 20 4e 55 4c 4c 20 28 64 6f 20  return NULL (do 
7ee0: 6e 6f 74 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e  not allocate a n
7ef0: 65 77 20 70 61 67 65 29 20 69 66 20 61 6e 79 20  ew page) if any 
7f00: 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  of the following
7f10: 0a 2a 2a 20 20 20 20 20 20 63 6f 6e 64 69 74 69  .**      conditi
7f20: 6f 6e 73 20 61 72 65 20 74 72 75 65 3a 0a 2a 2a  ons are true:.**
7f30: 0a 2a 2a 20 20 20 20 20 20 20 28 61 29 20 74 68  .**       (a) th
7f40: 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65  e number of page
7f50: 73 20 70 69 6e 6e 65 64 20 62 79 20 74 68 65 20  s pinned by the 
7f60: 63 61 63 68 65 20 69 73 20 67 72 65 61 74 65 72  cache is greater
7f70: 20 74 68 61 6e 0a 2a 2a 20 20 20 20 20 20 20 20   than.**        
7f80: 20 20 20 50 43 61 63 68 65 31 2e 6e 4d 61 78 2c     PCache1.nMax,
7f90: 20 6f 72 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20   or.**.**       
7fa0: 28 62 29 20 74 68 65 20 6e 75 6d 62 65 72 20 6f  (b) the number o
7fb0: 66 20 70 61 67 65 73 20 70 69 6e 6e 65 64 20 62  f pages pinned b
7fc0: 79 20 74 68 65 20 63 61 63 68 65 20 69 73 20 67  y the cache is g
7fd0: 72 65 61 74 65 72 20 74 68 61 6e 0a 2a 2a 20 20  reater than.**  
7fe0: 20 20 20 20 20 20 20 20 20 74 68 65 20 73 75 6d           the sum
7ff0: 20 6f 66 20 6e 4d 61 78 20 66 6f 72 20 61 6c 6c   of nMax for all
8000: 20 70 75 72 67 65 61 62 6c 65 20 63 61 63 68 65   purgeable cache
8010: 73 2c 20 6c 65 73 73 20 74 68 65 20 73 75 6d 20  s, less the sum 
8020: 6f 66 20 0a 2a 2a 20 20 20 20 20 20 20 20 20 20  of .**          
8030: 20 6e 4d 69 6e 20 66 6f 72 20 61 6c 6c 20 6f 74   nMin for all ot
8040: 68 65 72 20 70 75 72 67 65 61 62 6c 65 20 63 61  her purgeable ca
8050: 63 68 65 73 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 20  ches, or.**.**  
8060: 20 34 2e 20 49 66 20 6e 6f 6e 65 20 6f 66 20 74   4. If none of t
8070: 68 65 20 66 69 72 73 74 20 74 68 72 65 65 20 63  he first three c
8080: 6f 6e 64 69 74 69 6f 6e 73 20 61 70 70 6c 79 20  onditions apply 
8090: 61 6e 64 20 74 68 65 20 63 61 63 68 65 20 69 73  and the cache is
80a0: 20 6d 61 72 6b 65 64 0a 2a 2a 20 20 20 20 20 20   marked.**      
80b0: 61 73 20 70 75 72 67 65 61 62 6c 65 2c 20 61 6e  as purgeable, an
80c0: 64 20 69 66 20 6f 6e 65 20 6f 66 20 74 68 65 20  d if one of the 
80d0: 66 6f 6c 6c 6f 77 69 6e 67 20 69 73 20 74 72 75  following is tru
80e0: 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 28  e:.**.**       (
80f0: 61 29 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66  a) The number of
8100: 20 70 61 67 65 73 20 61 6c 6c 6f 63 61 74 65 64   pages allocated
8110: 20 66 6f 72 20 74 68 65 20 63 61 63 68 65 20 69   for the cache i
8120: 73 20 61 6c 72 65 61 64 79 20 0a 2a 2a 20 20 20  s already .**   
8130: 20 20 20 20 20 20 20 20 50 43 61 63 68 65 31 2e          PCache1.
8140: 6e 4d 61 78 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 20  nMax, or.**.**  
8150: 20 20 20 20 20 28 62 29 20 54 68 65 20 6e 75 6d       (b) The num
8160: 62 65 72 20 6f 66 20 70 61 67 65 73 20 61 6c 6c  ber of pages all
8170: 6f 63 61 74 65 64 20 66 6f 72 20 61 6c 6c 20 70  ocated for all p
8180: 75 72 67 65 61 62 6c 65 20 63 61 63 68 65 73 20  urgeable caches 
8190: 69 73 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20  is.**           
81a0: 61 6c 72 65 61 64 79 20 65 71 75 61 6c 20 74 6f  already equal to
81b0: 20 6f 72 20 67 72 65 61 74 65 72 20 74 68 61 6e   or greater than
81c0: 20 74 68 65 20 73 75 6d 20 6f 66 20 6e 4d 61 78   the sum of nMax
81d0: 20 66 6f 72 20 61 6c 6c 0a 2a 2a 20 20 20 20 20   for all.**     
81e0: 20 20 20 20 20 20 70 75 72 67 65 61 62 6c 65 20        purgeable 
81f0: 63 61 63 68 65 73 2c 0a 2a 2a 0a 2a 2a 20 20 20  caches,.**.**   
8200: 20 20 20 20 28 63 29 20 54 68 65 20 73 79 73 74      (c) The syst
8210: 65 6d 20 69 73 20 75 6e 64 65 72 20 6d 65 6d 6f  em is under memo
8220: 72 79 20 70 72 65 73 73 75 72 65 20 61 6e 64 20  ry pressure and 
8230: 77 61 6e 74 73 20 74 6f 20 61 76 6f 69 64 0a 2a  wants to avoid.*
8240: 2a 20 20 20 20 20 20 20 20 20 20 20 75 6e 6e 65  *           unne
8250: 63 65 73 73 61 72 79 20 70 61 67 65 73 20 63 61  cessary pages ca
8260: 63 68 65 20 65 6e 74 72 79 20 61 6c 6c 6f 63 61  che entry alloca
8270: 74 69 6f 6e 73 0a 2a 2a 0a 2a 2a 20 20 20 20 20  tions.**.**     
8280: 20 74 68 65 6e 20 61 74 74 65 6d 70 74 20 74 6f   then attempt to
8290: 20 72 65 63 79 63 6c 65 20 61 20 70 61 67 65 20   recycle a page 
82a0: 66 72 6f 6d 20 74 68 65 20 4c 52 55 20 6c 69 73  from the LRU lis
82b0: 74 2e 20 49 66 20 69 74 20 69 73 20 74 68 65 20  t. If it is the 
82c0: 72 69 67 68 74 0a 2a 2a 20 20 20 20 20 20 73 69  right.**      si
82d0: 7a 65 2c 20 72 65 74 75 72 6e 20 74 68 65 20 72  ze, return the r
82e0: 65 63 79 63 6c 65 64 20 62 75 66 66 65 72 2e 20  ecycled buffer. 
82f0: 4f 74 68 65 72 77 69 73 65 2c 20 66 72 65 65 20  Otherwise, free 
8300: 74 68 65 20 62 75 66 66 65 72 20 61 6e 64 0a 2a  the buffer and.*
8310: 2a 20 20 20 20 20 20 70 72 6f 63 65 65 64 20 74  *      proceed t
8320: 6f 20 73 74 65 70 20 35 2e 20 0a 2a 2a 0a 2a 2a  o step 5. .**.**
8330: 20 20 20 35 2e 20 4f 74 68 65 72 77 69 73 65 2c     5. Otherwise,
8340: 20 61 6c 6c 6f 63 61 74 65 20 61 6e 64 20 72 65   allocate and re
8350: 74 75 72 6e 20 61 20 6e 65 77 20 70 61 67 65 20  turn a new page 
8360: 62 75 66 66 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 68  buffer..**.** Th
8370: 65 72 65 20 61 72 65 20 74 77 6f 20 76 65 72 73  ere are two vers
8380: 69 6f 6e 73 20 6f 66 20 74 68 69 73 20 72 6f 75  ions of this rou
8390: 74 69 6e 65 2e 20 20 70 63 61 63 68 65 31 46 65  tine.  pcache1Fe
83a0: 74 63 68 57 69 74 68 4d 75 74 65 78 28 29 20 69  tchWithMutex() i
83b0: 73 0a 2a 2a 20 74 68 65 20 67 65 6e 65 72 61 6c  s.** the general
83c0: 20 63 61 73 65 2e 20 20 70 63 61 63 68 65 31 46   case.  pcache1F
83d0: 65 74 63 68 4e 6f 4d 75 74 65 78 28 29 20 69 73  etchNoMutex() is
83e0: 20 61 20 66 61 73 74 65 72 20 69 6d 70 6c 65 6d   a faster implem
83f0: 65 6e 74 61 74 69 6f 6e 20 66 6f 72 0a 2a 2a 20  entation for.** 
8400: 74 68 65 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 20  the common case 
8410: 77 68 65 72 65 20 70 47 72 6f 75 70 2d 3e 6d 75  where pGroup->mu
8420: 74 65 78 20 69 73 20 4e 55 4c 4c 2e 20 20 54 68  tex is NULL.  Th
8430: 65 20 70 63 61 63 68 65 31 46 65 74 63 68 28 29  e pcache1Fetch()
8440: 20 77 72 61 70 70 65 72 0a 2a 2a 20 69 6e 76 6f   wrapper.** invo
8450: 6b 65 73 20 74 68 65 20 61 70 70 72 6f 70 72 69  kes the appropri
8460: 61 74 65 20 72 6f 75 74 69 6e 65 2e 0a 2a 2f 0a  ate routine..*/.
8470: 73 74 61 74 69 63 20 50 67 48 64 72 31 20 2a 70  static PgHdr1 *p
8480: 63 61 63 68 65 31 46 65 74 63 68 4e 6f 4d 75 74  cache1FetchNoMut
8490: 65 78 28 0a 20 20 73 71 6c 69 74 65 33 5f 70 63  ex(.  sqlite3_pc
84a0: 61 63 68 65 20 2a 70 2c 20 0a 20 20 75 6e 73 69  ache *p, .  unsi
84b0: 67 6e 65 64 20 69 6e 74 20 69 4b 65 79 2c 20 0a  gned int iKey, .
84c0: 20 20 69 6e 74 20 63 72 65 61 74 65 46 6c 61 67    int createFlag
84d0: 0a 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70  .){.  PCache1 *p
84e0: 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 65 31  Cache = (PCache1
84f0: 20 2a 29 70 3b 0a 20 20 50 67 48 64 72 31 20 2a   *)p;.  PgHdr1 *
8500: 70 50 61 67 65 20 3d 20 30 3b 0a 0a 20 20 2f 2a  pPage = 0;..  /*
8510: 20 53 74 65 70 20 31 3a 20 53 65 61 72 63 68 20   Step 1: Search 
8520: 74 68 65 20 68 61 73 68 20 74 61 62 6c 65 20 66  the hash table f
8530: 6f 72 20 61 6e 20 65 78 69 73 74 69 6e 67 20 65  or an existing e
8540: 6e 74 72 79 2e 20 2a 2f 0a 20 20 70 50 61 67 65  ntry. */.  pPage
8550: 20 3d 20 70 43 61 63 68 65 2d 3e 61 70 48 61 73   = pCache->apHas
8560: 68 5b 69 4b 65 79 20 25 20 70 43 61 63 68 65 2d  h[iKey % pCache-
8570: 3e 6e 48 61 73 68 5d 3b 0a 20 20 77 68 69 6c 65  >nHash];.  while
8580: 28 20 70 50 61 67 65 20 26 26 20 70 50 61 67 65  ( pPage && pPage
8590: 2d 3e 69 4b 65 79 21 3d 69 4b 65 79 20 29 7b 20  ->iKey!=iKey ){ 
85a0: 70 50 61 67 65 20 3d 20 70 50 61 67 65 2d 3e 70  pPage = pPage->p
85b0: 4e 65 78 74 3b 20 7d 0a 0a 20 20 2f 2a 20 53 74  Next; }..  /* St
85c0: 65 70 20 32 3a 20 49 66 20 74 68 65 20 70 61 67  ep 2: If the pag
85d0: 65 20 77 61 73 20 66 6f 75 6e 64 20 69 6e 20 74  e was found in t
85e0: 68 65 20 68 61 73 68 20 74 61 62 6c 65 2c 20 74  he hash table, t
85f0: 68 65 6e 20 72 65 74 75 72 6e 20 69 74 2e 0a 20  hen return it.. 
8600: 20 2a 2a 20 49 66 20 74 68 65 20 70 61 67 65 20   ** If the page 
8610: 77 61 73 20 6e 6f 74 20 69 6e 20 74 68 65 20 68  was not in the h
8620: 61 73 68 20 74 61 62 6c 65 20 61 6e 64 20 63 72  ash table and cr
8630: 65 61 74 65 46 6c 61 67 20 69 73 20 30 2c 20 61  eateFlag is 0, a
8640: 62 6f 72 74 2e 0a 20 20 2a 2a 20 4f 74 68 65 72  bort..  ** Other
8650: 77 69 73 65 20 28 70 61 67 65 20 6e 6f 74 20 69  wise (page not i
8660: 6e 20 68 61 73 68 20 61 6e 64 20 63 72 65 61 74  n hash and creat
8670: 65 46 6c 61 67 21 3d 30 29 20 63 6f 6e 74 69 6e  eFlag!=0) contin
8680: 75 65 20 77 69 74 68 0a 20 20 2a 2a 20 73 75 62  ue with.  ** sub
8690: 73 65 71 75 65 6e 74 20 73 74 65 70 73 20 74 6f  sequent steps to
86a0: 20 74 72 79 20 74 6f 20 63 72 65 61 74 65 20 74   try to create t
86b0: 68 65 20 70 61 67 65 2e 20 2a 2f 0a 20 20 69 66  he page. */.  if
86c0: 28 20 70 50 61 67 65 20 29 7b 0a 20 20 20 20 69  ( pPage ){.    i
86d0: 66 28 20 21 70 50 61 67 65 2d 3e 69 73 50 69 6e  f( !pPage->isPin
86e0: 6e 65 64 20 29 7b 0a 20 20 20 20 20 20 72 65 74  ned ){.      ret
86f0: 75 72 6e 20 70 63 61 63 68 65 31 50 69 6e 50 61  urn pcache1PinPa
8700: 67 65 28 70 50 61 67 65 29 3b 0a 20 20 20 20 7d  ge(pPage);.    }
8710: 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 65 74 75  else{.      retu
8720: 72 6e 20 70 50 61 67 65 3b 0a 20 20 20 20 7d 0a  rn pPage;.    }.
8730: 20 20 7d 65 6c 73 65 20 69 66 28 20 63 72 65 61    }else if( crea
8740: 74 65 46 6c 61 67 20 29 7b 0a 20 20 20 20 2f 2a  teFlag ){.    /*
8750: 20 53 74 65 70 73 20 33 2c 20 34 2c 20 61 6e 64   Steps 3, 4, and
8760: 20 35 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62   5 implemented b
8770: 79 20 74 68 69 73 20 73 75 62 72 6f 75 74 69 6e  y this subroutin
8780: 65 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e 20  e */.    return 
8790: 70 63 61 63 68 65 31 46 65 74 63 68 53 74 61 67  pcache1FetchStag
87a0: 65 32 28 70 43 61 63 68 65 2c 20 69 4b 65 79 2c  e2(pCache, iKey,
87b0: 20 63 72 65 61 74 65 46 6c 61 67 29 3b 0a 20 20   createFlag);.  
87c0: 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72  }else{.    retur
87d0: 6e 20 30 3b 0a 20 20 7d 0a 7d 0a 23 69 66 20 50  n 0;.  }.}.#if P
87e0: 43 41 43 48 45 31 5f 4d 49 47 48 54 5f 55 53 45  CACHE1_MIGHT_USE
87f0: 5f 47 52 4f 55 50 5f 4d 55 54 45 58 0a 73 74 61  _GROUP_MUTEX.sta
8800: 74 69 63 20 50 67 48 64 72 31 20 2a 70 63 61 63  tic PgHdr1 *pcac
8810: 68 65 31 46 65 74 63 68 57 69 74 68 4d 75 74 65  he1FetchWithMute
8820: 78 28 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 61  x(.  sqlite3_pca
8830: 63 68 65 20 2a 70 2c 20 0a 20 20 75 6e 73 69 67  che *p, .  unsig
8840: 6e 65 64 20 69 6e 74 20 69 4b 65 79 2c 20 0a 20  ned int iKey, . 
8850: 20 69 6e 74 20 63 72 65 61 74 65 46 6c 61 67 0a   int createFlag.
8860: 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43  ){.  PCache1 *pC
8870: 61 63 68 65 20 3d 20 28 50 43 61 63 68 65 31 20  ache = (PCache1 
8880: 2a 29 70 3b 0a 20 20 50 67 48 64 72 31 20 2a 70  *)p;.  PgHdr1 *p
8890: 50 61 67 65 3b 0a 0a 20 20 70 63 61 63 68 65 31  Page;..  pcache1
88a0: 45 6e 74 65 72 4d 75 74 65 78 28 70 43 61 63 68  EnterMutex(pCach
88b0: 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20 70 50  e->pGroup);.  pP
88c0: 61 67 65 20 3d 20 70 63 61 63 68 65 31 46 65 74  age = pcache1Fet
88d0: 63 68 4e 6f 4d 75 74 65 78 28 70 2c 20 69 4b 65  chNoMutex(p, iKe
88e0: 79 2c 20 63 72 65 61 74 65 46 6c 61 67 29 3b 0a  y, createFlag);.
88f0: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 3d    assert( pPage=
8900: 3d 30 20 7c 7c 20 70 43 61 63 68 65 2d 3e 69 4d  =0 || pCache->iM
8910: 61 78 4b 65 79 3e 3d 69 4b 65 79 20 29 3b 0a 20  axKey>=iKey );. 
8920: 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74   pcache1LeaveMut
8930: 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75  ex(pCache->pGrou
8940: 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 50 61  p);.  return pPa
8950: 67 65 3b 0a 7d 0a 23 65 6e 64 69 66 0a 73 74 61  ge;.}.#endif.sta
8960: 74 69 63 20 73 71 6c 69 74 65 33 5f 70 63 61 63  tic sqlite3_pcac
8970: 68 65 5f 70 61 67 65 20 2a 70 63 61 63 68 65 31  he_page *pcache1
8980: 46 65 74 63 68 28 0a 20 20 73 71 6c 69 74 65 33  Fetch(.  sqlite3
8990: 5f 70 63 61 63 68 65 20 2a 70 2c 20 0a 20 20 75  _pcache *p, .  u
89a0: 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4b 65 79  nsigned int iKey
89b0: 2c 20 0a 20 20 69 6e 74 20 63 72 65 61 74 65 46  , .  int createF
89c0: 6c 61 67 0a 29 7b 0a 23 69 66 20 50 43 41 43 48  lag.){.#if PCACH
89d0: 45 31 5f 4d 49 47 48 54 5f 55 53 45 5f 47 52 4f  E1_MIGHT_USE_GRO
89e0: 55 50 5f 4d 55 54 45 58 20 7c 7c 20 64 65 66 69  UP_MUTEX || defi
89f0: 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 42 55 47  ned(SQLITE_DEBUG
8a00: 29 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61  ).  PCache1 *pCa
8a10: 63 68 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a  che = (PCache1 *
8a20: 29 70 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73  )p;.#endif..  as
8a30: 73 65 72 74 28 20 6f 66 66 73 65 74 6f 66 28 50  sert( offsetof(P
8a40: 67 48 64 72 31 2c 70 61 67 65 29 3d 3d 30 20 29  gHdr1,page)==0 )
8a50: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63  ;.  assert( pCac
8a60: 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 7c  he->bPurgeable |
8a70: 7c 20 63 72 65 61 74 65 46 6c 61 67 21 3d 31 20  | createFlag!=1 
8a80: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61  );.  assert( pCa
8a90: 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20  che->bPurgeable 
8aa0: 7c 7c 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 3d  || pCache->nMin=
8ab0: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  =0 );.  assert( 
8ac0: 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62  pCache->bPurgeab
8ad0: 6c 65 3d 3d 30 20 7c 7c 20 70 43 61 63 68 65 2d  le==0 || pCache-
8ae0: 3e 6e 4d 69 6e 3d 3d 31 30 20 29 3b 0a 20 20 61  >nMin==10 );.  a
8af0: 73 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 6e  ssert( pCache->n
8b00: 4d 69 6e 3d 3d 30 20 7c 7c 20 70 43 61 63 68 65  Min==0 || pCache
8b10: 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 29 3b 0a  ->bPurgeable );.
8b20: 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65    assert( pCache
8b30: 2d 3e 6e 48 61 73 68 3e 30 20 29 3b 0a 23 69 66  ->nHash>0 );.#if
8b40: 20 50 43 41 43 48 45 31 5f 4d 49 47 48 54 5f 55   PCACHE1_MIGHT_U
8b50: 53 45 5f 47 52 4f 55 50 5f 4d 55 54 45 58 0a 20  SE_GROUP_MUTEX. 
8b60: 20 69 66 28 20 70 43 61 63 68 65 2d 3e 70 47 72   if( pCache->pGr
8b70: 6f 75 70 2d 3e 6d 75 74 65 78 20 29 7b 0a 20 20  oup->mutex ){.  
8b80: 20 20 72 65 74 75 72 6e 20 28 73 71 6c 69 74 65    return (sqlite
8b90: 33 5f 70 63 61 63 68 65 5f 70 61 67 65 2a 29 70  3_pcache_page*)p
8ba0: 63 61 63 68 65 31 46 65 74 63 68 57 69 74 68 4d  cache1FetchWithM
8bb0: 75 74 65 78 28 70 2c 20 69 4b 65 79 2c 20 63 72  utex(p, iKey, cr
8bc0: 65 61 74 65 46 6c 61 67 29 3b 0a 20 20 7d 65 6c  eateFlag);.  }el
8bd0: 73 65 0a 23 65 6e 64 69 66 0a 20 20 7b 0a 20 20  se.#endif.  {.  
8be0: 20 20 72 65 74 75 72 6e 20 28 73 71 6c 69 74 65    return (sqlite
8bf0: 33 5f 70 63 61 63 68 65 5f 70 61 67 65 2a 29 70  3_pcache_page*)p
8c00: 63 61 63 68 65 31 46 65 74 63 68 4e 6f 4d 75 74  cache1FetchNoMut
8c10: 65 78 28 70 2c 20 69 4b 65 79 2c 20 63 72 65 61  ex(p, iKey, crea
8c20: 74 65 46 6c 61 67 29 3b 0a 20 20 7d 0a 7d 0a 0a  teFlag);.  }.}..
8c30: 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74  ./*.** Implement
8c40: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c  ation of the sql
8c50: 69 74 65 33 5f 70 63 61 63 68 65 2e 78 55 6e 70  ite3_pcache.xUnp
8c60: 69 6e 20 6d 65 74 68 6f 64 2e 0a 2a 2a 0a 2a 2a  in method..**.**
8c70: 20 4d 61 72 6b 20 61 20 70 61 67 65 20 61 73 20   Mark a page as 
8c80: 75 6e 70 69 6e 6e 65 64 20 28 65 6c 69 67 69 62  unpinned (eligib
8c90: 6c 65 20 66 6f 72 20 61 73 79 6e 63 68 72 6f 6e  le for asynchron
8ca0: 6f 75 73 20 72 65 63 79 63 6c 69 6e 67 29 2e 0a  ous recycling)..
8cb0: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70  */.static void p
8cc0: 63 61 63 68 65 31 55 6e 70 69 6e 28 0a 20 20 73  cache1Unpin(.  s
8cd0: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70  qlite3_pcache *p
8ce0: 2c 20 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 61  , .  sqlite3_pca
8cf0: 63 68 65 5f 70 61 67 65 20 2a 70 50 67 2c 20 0a  che_page *pPg, .
8d00: 20 20 69 6e 74 20 72 65 75 73 65 55 6e 6c 69 6b    int reuseUnlik
8d10: 65 6c 79 0a 29 7b 0a 20 20 50 43 61 63 68 65 31  ely.){.  PCache1
8d20: 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61 63   *pCache = (PCac
8d30: 68 65 31 20 2a 29 70 3b 0a 20 20 50 67 48 64 72  he1 *)p;.  PgHdr
8d40: 31 20 2a 70 50 61 67 65 20 3d 20 28 50 67 48 64  1 *pPage = (PgHd
8d50: 72 31 20 2a 29 70 50 67 3b 0a 20 20 50 47 72 6f  r1 *)pPg;.  PGro
8d60: 75 70 20 2a 70 47 72 6f 75 70 20 3d 20 70 43 61  up *pGroup = pCa
8d70: 63 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20 0a 20  che->pGroup;. . 
8d80: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e   assert( pPage->
8d90: 70 43 61 63 68 65 3d 3d 70 43 61 63 68 65 20 29  pCache==pCache )
8da0: 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65 72  ;.  pcache1Enter
8db0: 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 0a  Mutex(pGroup);..
8dc0: 20 20 2f 2a 20 49 74 20 69 73 20 61 6e 20 65 72    /* It is an er
8dd0: 72 6f 72 20 74 6f 20 63 61 6c 6c 20 74 68 69 73  ror to call this
8de0: 20 66 75 6e 63 74 69 6f 6e 20 69 66 20 74 68 65   function if the
8df0: 20 70 61 67 65 20 69 73 20 61 6c 72 65 61 64 79   page is already
8e00: 20 0a 20 20 2a 2a 20 70 61 72 74 20 6f 66 20 74   .  ** part of t
8e10: 68 65 20 50 47 72 6f 75 70 20 4c 52 55 20 6c 69  he PGroup LRU li
8e20: 73 74 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72  st..  */.  asser
8e30: 74 28 20 70 50 61 67 65 2d 3e 70 4c 72 75 50 72  t( pPage->pLruPr
8e40: 65 76 3d 3d 30 20 26 26 20 70 50 61 67 65 2d 3e  ev==0 && pPage->
8e50: 70 4c 72 75 4e 65 78 74 3d 3d 30 20 29 3b 0a 20  pLruNext==0 );. 
8e60: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e   assert( pPage->
8e70: 69 73 50 69 6e 6e 65 64 3d 3d 31 20 29 3b 0a 0a  isPinned==1 );..
8e80: 20 20 69 66 28 20 72 65 75 73 65 55 6e 6c 69 6b    if( reuseUnlik
8e90: 65 6c 79 20 7c 7c 20 70 47 72 6f 75 70 2d 3e 6e  ely || pGroup->n
8ea0: 43 75 72 72 65 6e 74 50 61 67 65 3e 70 47 72 6f  CurrentPage>pGro
8eb0: 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 29 7b 0a  up->nMaxPage ){.
8ec0: 20 20 20 20 70 63 61 63 68 65 31 52 65 6d 6f 76      pcache1Remov
8ed0: 65 46 72 6f 6d 48 61 73 68 28 70 50 61 67 65 2c  eFromHash(pPage,
8ee0: 20 31 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20   1);.  }else{.  
8ef0: 20 20 2f 2a 20 41 64 64 20 74 68 65 20 70 61 67    /* Add the pag
8f00: 65 20 74 6f 20 74 68 65 20 50 47 72 6f 75 70 20  e to the PGroup 
8f10: 4c 52 55 20 6c 69 73 74 2e 20 2a 2f 0a 20 20 20  LRU list. */.   
8f20: 20 50 67 48 64 72 31 20 2a 2a 70 70 46 69 72 73   PgHdr1 **ppFirs
8f30: 74 20 3d 20 26 70 47 72 6f 75 70 2d 3e 6c 72 75  t = &pGroup->lru
8f40: 2e 70 4c 72 75 4e 65 78 74 3b 0a 20 20 20 20 70  .pLruNext;.    p
8f50: 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 20 3d  Page->pLruPrev =
8f60: 20 26 70 47 72 6f 75 70 2d 3e 6c 72 75 3b 0a 20   &pGroup->lru;. 
8f70: 20 20 20 28 70 50 61 67 65 2d 3e 70 4c 72 75 4e     (pPage->pLruN
8f80: 65 78 74 20 3d 20 2a 70 70 46 69 72 73 74 29 2d  ext = *ppFirst)-
8f90: 3e 70 4c 72 75 50 72 65 76 20 3d 20 70 50 61 67  >pLruPrev = pPag
8fa0: 65 3b 0a 20 20 20 20 2a 70 70 46 69 72 73 74 20  e;.    *ppFirst 
8fb0: 3d 20 70 50 61 67 65 3b 0a 20 20 20 20 70 43 61  = pPage;.    pCa
8fc0: 63 68 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65  che->nRecyclable
8fd0: 2b 2b 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69  ++;.    pPage->i
8fe0: 73 50 69 6e 6e 65 64 20 3d 20 30 3b 0a 20 20 7d  sPinned = 0;.  }
8ff0: 0a 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76 65  ..  pcache1Leave
9000: 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47  Mutex(pCache->pG
9010: 72 6f 75 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  roup);.}../*.** 
9020: 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  Implementation o
9030: 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63  f the sqlite3_pc
9040: 61 63 68 65 2e 78 52 65 6b 65 79 20 6d 65 74 68  ache.xRekey meth
9050: 6f 64 2e 20 0a 2a 2f 0a 73 74 61 74 69 63 20 76  od. .*/.static v
9060: 6f 69 64 20 70 63 61 63 68 65 31 52 65 6b 65 79  oid pcache1Rekey
9070: 28 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63  (.  sqlite3_pcac
9080: 68 65 20 2a 70 2c 0a 20 20 73 71 6c 69 74 65 33  he *p,.  sqlite3
9090: 5f 70 63 61 63 68 65 5f 70 61 67 65 20 2a 70 50  _pcache_page *pP
90a0: 67 2c 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e  g,.  unsigned in
90b0: 74 20 69 4f 6c 64 2c 0a 20 20 75 6e 73 69 67 6e  t iOld,.  unsign
90c0: 65 64 20 69 6e 74 20 69 4e 65 77 0a 29 7b 0a 20  ed int iNew.){. 
90d0: 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65   PCache1 *pCache
90e0: 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b   = (PCache1 *)p;
90f0: 0a 20 20 50 67 48 64 72 31 20 2a 70 50 61 67 65  .  PgHdr1 *pPage
9100: 20 3d 20 28 50 67 48 64 72 31 20 2a 29 70 50 67   = (PgHdr1 *)pPg
9110: 3b 0a 20 20 50 67 48 64 72 31 20 2a 2a 70 70 3b  ;.  PgHdr1 **pp;
9120: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
9130: 68 3b 20 0a 20 20 61 73 73 65 72 74 28 20 70 50  h; .  assert( pP
9140: 61 67 65 2d 3e 69 4b 65 79 3d 3d 69 4f 6c 64 20  age->iKey==iOld 
9150: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61  );.  assert( pPa
9160: 67 65 2d 3e 70 43 61 63 68 65 3d 3d 70 43 61 63  ge->pCache==pCac
9170: 68 65 20 29 3b 0a 0a 20 20 70 63 61 63 68 65 31  he );..  pcache1
9180: 45 6e 74 65 72 4d 75 74 65 78 28 70 43 61 63 68  EnterMutex(pCach
9190: 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 0a 20 20 68  e->pGroup);..  h
91a0: 20 3d 20 69 4f 6c 64 25 70 43 61 63 68 65 2d 3e   = iOld%pCache->
91b0: 6e 48 61 73 68 3b 0a 20 20 70 70 20 3d 20 26 70  nHash;.  pp = &p
91c0: 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d  Cache->apHash[h]
91d0: 3b 0a 20 20 77 68 69 6c 65 28 20 28 2a 70 70 29  ;.  while( (*pp)
91e0: 21 3d 70 50 61 67 65 20 29 7b 0a 20 20 20 20 70  !=pPage ){.    p
91f0: 70 20 3d 20 26 28 2a 70 70 29 2d 3e 70 4e 65 78  p = &(*pp)->pNex
9200: 74 3b 0a 20 20 7d 0a 20 20 2a 70 70 20 3d 20 70  t;.  }.  *pp = p
9210: 50 61 67 65 2d 3e 70 4e 65 78 74 3b 0a 0a 20 20  Page->pNext;..  
9220: 68 20 3d 20 69 4e 65 77 25 70 43 61 63 68 65 2d  h = iNew%pCache-
9230: 3e 6e 48 61 73 68 3b 0a 20 20 70 50 61 67 65 2d  >nHash;.  pPage-
9240: 3e 69 4b 65 79 20 3d 20 69 4e 65 77 3b 0a 20 20  >iKey = iNew;.  
9250: 70 50 61 67 65 2d 3e 70 4e 65 78 74 20 3d 20 70  pPage->pNext = p
9260: 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d  Cache->apHash[h]
9270: 3b 0a 20 20 70 43 61 63 68 65 2d 3e 61 70 48 61  ;.  pCache->apHa
9280: 73 68 5b 68 5d 20 3d 20 70 50 61 67 65 3b 0a 20  sh[h] = pPage;. 
9290: 20 69 66 28 20 69 4e 65 77 3e 70 43 61 63 68 65   if( iNew>pCache
92a0: 2d 3e 69 4d 61 78 4b 65 79 20 29 7b 0a 20 20 20  ->iMaxKey ){.   
92b0: 20 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79   pCache->iMaxKey
92c0: 20 3d 20 69 4e 65 77 3b 0a 20 20 7d 0a 0a 20 20   = iNew;.  }..  
92d0: 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65  pcache1LeaveMute
92e0: 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70  x(pCache->pGroup
92f0: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c  );.}../*.** Impl
9300: 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68  ementation of th
9310: 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  e sqlite3_pcache
9320: 2e 78 54 72 75 6e 63 61 74 65 20 6d 65 74 68 6f  .xTruncate metho
9330: 64 2e 20 0a 2a 2a 0a 2a 2a 20 44 69 73 63 61 72  d. .**.** Discar
9340: 64 20 61 6c 6c 20 75 6e 70 69 6e 6e 65 64 20 70  d all unpinned p
9350: 61 67 65 73 20 69 6e 20 74 68 65 20 63 61 63 68  ages in the cach
9360: 65 20 77 69 74 68 20 61 20 70 61 67 65 20 6e 75  e with a page nu
9370: 6d 62 65 72 20 65 71 75 61 6c 20 74 6f 0a 2a 2a  mber equal to.**
9380: 20 6f 72 20 67 72 65 61 74 65 72 20 74 68 61 6e   or greater than
9390: 20 70 61 72 61 6d 65 74 65 72 20 69 4c 69 6d 69   parameter iLimi
93a0: 74 2e 20 41 6e 79 20 70 69 6e 6e 65 64 20 70 61  t. Any pinned pa
93b0: 67 65 73 20 77 69 74 68 20 61 20 70 61 67 65 20  ges with a page 
93c0: 6e 75 6d 62 65 72 0a 2a 2a 20 65 71 75 61 6c 20  number.** equal 
93d0: 74 6f 20 6f 72 20 67 72 65 61 74 65 72 20 74 68  to or greater th
93e0: 61 6e 20 69 4c 69 6d 69 74 20 61 72 65 20 69 6d  an iLimit are im
93f0: 70 6c 69 63 69 74 6c 79 20 75 6e 70 69 6e 6e 65  plicitly unpinne
9400: 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  d..*/.static voi
9410: 64 20 70 63 61 63 68 65 31 54 72 75 6e 63 61 74  d pcache1Truncat
9420: 65 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  e(sqlite3_pcache
9430: 20 2a 70 2c 20 75 6e 73 69 67 6e 65 64 20 69 6e   *p, unsigned in
9440: 74 20 69 4c 69 6d 69 74 29 7b 0a 20 20 50 43 61  t iLimit){.  PCa
9450: 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28  che1 *pCache = (
9460: 50 43 61 63 68 65 31 20 2a 29 70 3b 0a 20 20 70  PCache1 *)p;.  p
9470: 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78  cache1EnterMutex
9480: 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29  (pCache->pGroup)
9490: 3b 0a 20 20 69 66 28 20 69 4c 69 6d 69 74 3c 3d  ;.  if( iLimit<=
94a0: 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20  pCache->iMaxKey 
94b0: 29 7b 0a 20 20 20 20 70 63 61 63 68 65 31 54 72  ){.    pcache1Tr
94c0: 75 6e 63 61 74 65 55 6e 73 61 66 65 28 70 43 61  uncateUnsafe(pCa
94d0: 63 68 65 2c 20 69 4c 69 6d 69 74 29 3b 0a 20 20  che, iLimit);.  
94e0: 20 20 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65    pCache->iMaxKe
94f0: 79 20 3d 20 69 4c 69 6d 69 74 2d 31 3b 0a 20 20  y = iLimit-1;.  
9500: 7d 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76 65  }.  pcache1Leave
9510: 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47  Mutex(pCache->pG
9520: 72 6f 75 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  roup);.}../*.** 
9530: 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  Implementation o
9540: 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63  f the sqlite3_pc
9550: 61 63 68 65 2e 78 44 65 73 74 72 6f 79 20 6d 65  ache.xDestroy me
9560: 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 44 65 73  thod. .**.** Des
9570: 74 72 6f 79 20 61 20 63 61 63 68 65 20 61 6c 6c  troy a cache all
9580: 6f 63 61 74 65 64 20 75 73 69 6e 67 20 70 63 61  ocated using pca
9590: 63 68 65 31 43 72 65 61 74 65 28 29 2e 0a 2a 2f  che1Create()..*/
95a0: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61  .static void pca
95b0: 63 68 65 31 44 65 73 74 72 6f 79 28 73 71 6c 69  che1Destroy(sqli
95c0: 74 65 33 5f 70 63 61 63 68 65 20 2a 70 29 7b 0a  te3_pcache *p){.
95d0: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68    PCache1 *pCach
95e0: 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70  e = (PCache1 *)p
95f0: 3b 0a 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f  ;.  PGroup *pGro
9600: 75 70 20 3d 20 70 43 61 63 68 65 2d 3e 70 47 72  up = pCache->pGr
9610: 6f 75 70 3b 0a 20 20 61 73 73 65 72 74 28 20 70  oup;.  assert( p
9620: 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c  Cache->bPurgeabl
9630: 65 20 7c 7c 20 28 70 43 61 63 68 65 2d 3e 6e 4d  e || (pCache->nM
9640: 61 78 3d 3d 30 20 26 26 20 70 43 61 63 68 65 2d  ax==0 && pCache-
9650: 3e 6e 4d 69 6e 3d 3d 30 29 20 29 3b 0a 20 20 70  >nMin==0) );.  p
9660: 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78  cache1EnterMutex
9670: 28 70 47 72 6f 75 70 29 3b 0a 20 20 69 66 28 20  (pGroup);.  if( 
9680: 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 20 29 20  pCache->nPage ) 
9690: 70 63 61 63 68 65 31 54 72 75 6e 63 61 74 65 55  pcache1TruncateU
96a0: 6e 73 61 66 65 28 70 43 61 63 68 65 2c 20 30 29  nsafe(pCache, 0)
96b0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 47 72 6f  ;.  assert( pGro
96c0: 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 3e 3d 20  up->nMaxPage >= 
96d0: 70 43 61 63 68 65 2d 3e 6e 4d 61 78 20 29 3b 0a  pCache->nMax );.
96e0: 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61    pGroup->nMaxPa
96f0: 67 65 20 2d 3d 20 70 43 61 63 68 65 2d 3e 6e 4d  ge -= pCache->nM
9700: 61 78 3b 0a 20 20 61 73 73 65 72 74 28 20 70 47  ax;.  assert( pG
9710: 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 20 3e  roup->nMinPage >
9720: 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 20 29  = pCache->nMin )
9730: 3b 0a 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e  ;.  pGroup->nMin
9740: 50 61 67 65 20 2d 3d 20 70 43 61 63 68 65 2d 3e  Page -= pCache->
9750: 6e 4d 69 6e 3b 0a 20 20 70 47 72 6f 75 70 2d 3e  nMin;.  pGroup->
9760: 6d 78 50 69 6e 6e 65 64 20 3d 20 70 47 72 6f 75  mxPinned = pGrou
9770: 70 2d 3e 6e 4d 61 78 50 61 67 65 20 2b 20 31 30  p->nMaxPage + 10
9780: 20 2d 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50   - pGroup->nMinP
9790: 61 67 65 3b 0a 20 20 70 63 61 63 68 65 31 45 6e  age;.  pcache1En
97a0: 66 6f 72 63 65 4d 61 78 50 61 67 65 28 70 43 61  forceMaxPage(pCa
97b0: 63 68 65 29 3b 0a 20 20 70 63 61 63 68 65 31 4c  che);.  pcache1L
97c0: 65 61 76 65 4d 75 74 65 78 28 70 47 72 6f 75 70  eaveMutex(pGroup
97d0: 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65  );.  sqlite3_fre
97e0: 65 28 70 43 61 63 68 65 2d 3e 70 42 75 6c 6b 29  e(pCache->pBulk)
97f0: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65  ;.  sqlite3_free
9800: 28 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 29  (pCache->apHash)
9810: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65  ;.  sqlite3_free
9820: 28 70 43 61 63 68 65 29 3b 0a 7d 0a 0a 2f 2a 0a  (pCache);.}../*.
9830: 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e  ** This function
9840: 20 69 73 20 63 61 6c 6c 65 64 20 64 75 72 69 6e   is called durin
9850: 67 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e  g initialization
9860: 20 28 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61   (sqlite3_initia
9870: 6c 69 7a 65 28 29 29 20 74 6f 0a 2a 2a 20 69 6e  lize()) to.** in
9880: 73 74 61 6c 6c 20 74 68 65 20 64 65 66 61 75 6c  stall the defaul
9890: 74 20 70 6c 75 67 67 61 62 6c 65 20 63 61 63 68  t pluggable cach
98a0: 65 20 6d 6f 64 75 6c 65 2c 20 61 73 73 75 6d 69  e module, assumi
98b0: 6e 67 20 74 68 65 20 75 73 65 72 20 68 61 73 20  ng the user has 
98c0: 6e 6f 74 0a 2a 2a 20 61 6c 72 65 61 64 79 20 70  not.** already p
98d0: 72 6f 76 69 64 65 64 20 61 6e 20 61 6c 74 65 72  rovided an alter
98e0: 6e 61 74 69 76 65 2e 0a 2a 2f 0a 76 6f 69 64 20  native..*/.void 
98f0: 73 71 6c 69 74 65 33 50 43 61 63 68 65 53 65 74  sqlite3PCacheSet
9900: 44 65 66 61 75 6c 74 28 76 6f 69 64 29 7b 0a 20  Default(void){. 
9910: 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 73 71   static const sq
9920: 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 6d 65 74  lite3_pcache_met
9930: 68 6f 64 73 32 20 64 65 66 61 75 6c 74 4d 65 74  hods2 defaultMet
9940: 68 6f 64 73 20 3d 20 7b 0a 20 20 20 20 31 2c 20  hods = {.    1, 
9950: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
9960: 20 20 20 20 20 20 2f 2a 20 69 56 65 72 73 69 6f        /* iVersio
9970: 6e 20 2a 2f 0a 20 20 20 20 30 2c 20 20 20 20 20  n */.    0,     
9980: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
9990: 20 20 2f 2a 20 70 41 72 67 20 2a 2f 0a 20 20 20    /* pArg */.   
99a0: 20 70 63 61 63 68 65 31 49 6e 69 74 2c 20 20 20   pcache1Init,   
99b0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 49 6e            /* xIn
99c0: 69 74 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65  it */.    pcache
99d0: 31 53 68 75 74 64 6f 77 6e 2c 20 20 20 20 20 20  1Shutdown,      
99e0: 20 20 20 2f 2a 20 78 53 68 75 74 64 6f 77 6e 20     /* xShutdown 
99f0: 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 43 72  */.    pcache1Cr
9a00: 65 61 74 65 2c 20 20 20 20 20 20 20 20 20 20 20  eate,           
9a10: 2f 2a 20 78 43 72 65 61 74 65 20 2a 2f 0a 20 20  /* xCreate */.  
9a20: 20 20 70 63 61 63 68 65 31 43 61 63 68 65 73 69    pcache1Cachesi
9a30: 7a 65 2c 20 20 20 20 20 20 20 20 2f 2a 20 78 43  ze,        /* xC
9a40: 61 63 68 65 73 69 7a 65 20 2a 2f 0a 20 20 20 20  achesize */.    
9a50: 70 63 61 63 68 65 31 50 61 67 65 63 6f 75 6e 74  pcache1Pagecount
9a60: 2c 20 20 20 20 20 20 20 20 2f 2a 20 78 50 61 67  ,        /* xPag
9a70: 65 63 6f 75 6e 74 20 2a 2f 0a 20 20 20 20 70 63  ecount */.    pc
9a80: 61 63 68 65 31 46 65 74 63 68 2c 20 20 20 20 20  ache1Fetch,     
9a90: 20 20 20 20 20 20 20 2f 2a 20 78 46 65 74 63 68         /* xFetch
9aa0: 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 55   */.    pcache1U
9ab0: 6e 70 69 6e 2c 20 20 20 20 20 20 20 20 20 20 20  npin,           
9ac0: 20 2f 2a 20 78 55 6e 70 69 6e 20 2a 2f 0a 20 20   /* xUnpin */.  
9ad0: 20 20 70 63 61 63 68 65 31 52 65 6b 65 79 2c 20    pcache1Rekey, 
9ae0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 52             /* xR
9af0: 65 6b 65 79 20 2a 2f 0a 20 20 20 20 70 63 61 63  ekey */.    pcac
9b00: 68 65 31 54 72 75 6e 63 61 74 65 2c 20 20 20 20  he1Truncate,    
9b10: 20 20 20 20 20 2f 2a 20 78 54 72 75 6e 63 61 74       /* xTruncat
9b20: 65 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31  e */.    pcache1
9b30: 44 65 73 74 72 6f 79 2c 20 20 20 20 20 20 20 20  Destroy,        
9b40: 20 20 2f 2a 20 78 44 65 73 74 72 6f 79 20 2a 2f    /* xDestroy */
9b50: 0a 20 20 20 20 70 63 61 63 68 65 31 53 68 72 69  .    pcache1Shri
9b60: 6e 6b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  nk            /*
9b70: 20 78 53 68 72 69 6e 6b 20 2a 2f 0a 20 20 7d 3b   xShrink */.  };
9b80: 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69  .  sqlite3_confi
9b90: 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f  g(SQLITE_CONFIG_
9ba0: 50 43 41 43 48 45 32 2c 20 26 64 65 66 61 75 6c  PCACHE2, &defaul
9bb0: 74 4d 65 74 68 6f 64 73 29 3b 0a 7d 0a 0a 2f 2a  tMethods);.}../*
9bc0: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 73  .** Return the s
9bd0: 69 7a 65 20 6f 66 20 74 68 65 20 68 65 61 64 65  ize of the heade
9be0: 72 20 6f 6e 20 65 61 63 68 20 70 61 67 65 20 6f  r on each page o
9bf0: 66 20 74 68 69 73 20 50 43 41 43 48 45 20 69 6d  f this PCACHE im
9c00: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 0a 2a 2f  plementation..*/
9c10: 0a 69 6e 74 20 73 71 6c 69 74 65 33 48 65 61 64  .int sqlite3Head
9c20: 65 72 53 69 7a 65 50 63 61 63 68 65 31 28 76 6f  erSizePcache1(vo
9c30: 69 64 29 7b 20 72 65 74 75 72 6e 20 52 4f 55 4e  id){ return ROUN
9c40: 44 38 28 73 69 7a 65 6f 66 28 50 67 48 64 72 31  D8(sizeof(PgHdr1
9c50: 29 29 3b 20 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74  )); }../*.** Ret
9c60: 75 72 6e 20 74 68 65 20 67 6c 6f 62 61 6c 20 6d  urn the global m
9c70: 75 74 65 78 20 75 73 65 64 20 62 79 20 74 68 69  utex used by thi
9c80: 73 20 50 43 41 43 48 45 20 69 6d 70 6c 65 6d 65  s PCACHE impleme
9c90: 6e 74 61 74 69 6f 6e 2e 20 20 54 68 65 0a 2a 2a  ntation.  The.**
9ca0: 20 73 71 6c 69 74 65 33 5f 73 74 61 74 75 73 28   sqlite3_status(
9cb0: 29 20 72 6f 75 74 69 6e 65 20 6e 65 65 64 73 20  ) routine needs 
9cc0: 61 63 63 65 73 73 20 74 6f 20 74 68 69 73 20 6d  access to this m
9cd0: 75 74 65 78 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33  utex..*/.sqlite3
9ce0: 5f 6d 75 74 65 78 20 2a 73 71 6c 69 74 65 33 50  _mutex *sqlite3P
9cf0: 63 61 63 68 65 31 4d 75 74 65 78 28 76 6f 69 64  cache1Mutex(void
9d00: 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 63 61 63  ){.  return pcac
9d10: 68 65 31 2e 6d 75 74 65 78 3b 0a 7d 0a 0a 23 69  he1.mutex;.}..#i
9d20: 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42  fdef SQLITE_ENAB
9d30: 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45  LE_MEMORY_MANAGE
9d40: 4d 45 4e 54 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  MENT./*.** This 
9d50: 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c  function is call
9d60: 65 64 20 74 6f 20 66 72 65 65 20 73 75 70 65 72  ed to free super
9d70: 66 6c 75 6f 75 73 20 64 79 6e 61 6d 69 63 61 6c  fluous dynamical
9d80: 6c 79 20 61 6c 6c 6f 63 61 74 65 64 20 6d 65 6d  ly allocated mem
9d90: 6f 72 79 0a 2a 2a 20 68 65 6c 64 20 62 79 20 74  ory.** held by t
9da0: 68 65 20 70 61 67 65 72 20 73 79 73 74 65 6d 2e  he pager system.
9db0: 20 4d 65 6d 6f 72 79 20 69 6e 20 75 73 65 20 62   Memory in use b
9dc0: 79 20 61 6e 79 20 53 51 4c 69 74 65 20 70 61 67  y any SQLite pag
9dd0: 65 72 20 61 6c 6c 6f 63 61 74 65 64 0a 2a 2a 20  er allocated.** 
9de0: 62 79 20 74 68 65 20 63 75 72 72 65 6e 74 20 74  by the current t
9df0: 68 72 65 61 64 20 6d 61 79 20 62 65 20 73 71 6c  hread may be sql
9e00: 69 74 65 33 5f 66 72 65 65 28 29 65 64 2e 0a 2a  ite3_free()ed..*
9e10: 2a 0a 2a 2a 20 6e 52 65 71 20 69 73 20 74 68 65  *.** nReq is the
9e20: 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73   number of bytes
9e30: 20 6f 66 20 6d 65 6d 6f 72 79 20 72 65 71 75 69   of memory requi
9e40: 72 65 64 2e 20 4f 6e 63 65 20 74 68 69 73 20 6d  red. Once this m
9e50: 75 63 68 20 68 61 73 0a 2a 2a 20 62 65 65 6e 20  uch has.** been 
9e60: 72 65 6c 65 61 73 65 64 2c 20 74 68 65 20 66 75  released, the fu
9e70: 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 2e 20  nction returns. 
9e80: 54 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65  The return value
9e90: 20 69 73 20 74 68 65 20 74 6f 74 61 6c 20 6e 75   is the total nu
9ea0: 6d 62 65 72 20 0a 2a 2a 20 6f 66 20 62 79 74 65  mber .** of byte
9eb0: 73 20 6f 66 20 6d 65 6d 6f 72 79 20 72 65 6c 65  s of memory rele
9ec0: 61 73 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  ased..*/.int sql
9ed0: 69 74 65 33 50 63 61 63 68 65 52 65 6c 65 61 73  ite3PcacheReleas
9ee0: 65 4d 65 6d 6f 72 79 28 69 6e 74 20 6e 52 65 71  eMemory(int nReq
9ef0: 29 7b 0a 20 20 69 6e 74 20 6e 46 72 65 65 20 3d  ){.  int nFree =
9f00: 20 30 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71   0;.  assert( sq
9f10: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68  lite3_mutex_noth
9f20: 65 6c 64 28 70 63 61 63 68 65 31 2e 67 72 70 2e  eld(pcache1.grp.
9f30: 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65  mutex) );.  asse
9f40: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  rt( sqlite3_mute
9f50: 78 5f 6e 6f 74 68 65 6c 64 28 70 63 61 63 68 65  x_notheld(pcache
9f60: 31 2e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66  1.mutex) );.  if
9f70: 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43  ( sqlite3GlobalC
9f80: 6f 6e 66 69 67 2e 6e 50 61 67 65 3d 3d 30 20 29  onfig.nPage==0 )
9f90: 7b 0a 20 20 20 20 50 67 48 64 72 31 20 2a 70 3b  {.    PgHdr1 *p;
9fa0: 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e 74 65  .    pcache1Ente
9fb0: 72 4d 75 74 65 78 28 26 70 63 61 63 68 65 31 2e  rMutex(&pcache1.
9fc0: 67 72 70 29 3b 0a 20 20 20 20 77 68 69 6c 65 28  grp);.    while(
9fd0: 20 28 6e 52 65 71 3c 30 20 7c 7c 20 6e 46 72 65   (nReq<0 || nFre
9fe0: 65 3c 6e 52 65 71 29 0a 20 20 20 20 20 20 20 26  e<nReq).       &
9ff0: 26 20 20 28 70 3d 70 63 61 63 68 65 31 2e 67 72  &  (p=pcache1.gr
a000: 70 2e 6c 72 75 2e 70 4c 72 75 50 72 65 76 29 21  p.lru.pLruPrev)!
a010: 3d 30 0a 20 20 20 20 20 20 20 26 26 20 20 70 2d  =0.       &&  p-
a020: 3e 69 73 41 6e 63 68 6f 72 3d 3d 30 0a 20 20 20  >isAnchor==0.   
a030: 20 29 7b 0a 20 20 20 20 20 20 6e 46 72 65 65 20   ){.      nFree 
a040: 2b 3d 20 70 63 61 63 68 65 31 4d 65 6d 53 69 7a  += pcache1MemSiz
a050: 65 28 70 2d 3e 70 61 67 65 2e 70 42 75 66 29 3b  e(p->page.pBuf);
a060: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 50  .#ifdef SQLITE_P
a070: 43 41 43 48 45 5f 53 45 50 41 52 41 54 45 5f 48  CACHE_SEPARATE_H
a080: 45 41 44 45 52 0a 20 20 20 20 20 20 6e 46 72 65  EADER.      nFre
a090: 65 20 2b 3d 20 73 71 6c 69 74 65 33 4d 65 6d 53  e += sqlite3MemS
a0a0: 69 7a 65 28 70 29 3b 0a 23 65 6e 64 69 66 0a 20  ize(p);.#endif. 
a0b0: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e       assert( p->
a0c0: 69 73 50 69 6e 6e 65 64 3d 3d 30 20 29 3b 0a 20  isPinned==0 );. 
a0d0: 20 20 20 20 20 70 63 61 63 68 65 31 50 69 6e 50       pcache1PinP
a0e0: 61 67 65 28 70 29 3b 0a 20 20 20 20 20 20 70 63  age(p);.      pc
a0f0: 61 63 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48  ache1RemoveFromH
a100: 61 73 68 28 70 2c 20 31 29 3b 0a 20 20 20 20 7d  ash(p, 1);.    }
a110: 0a 20 20 20 20 70 63 61 63 68 65 31 4c 65 61 76  .    pcache1Leav
a120: 65 4d 75 74 65 78 28 26 70 63 61 63 68 65 31 2e  eMutex(&pcache1.
a130: 67 72 70 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75  grp);.  }.  retu
a140: 72 6e 20 6e 46 72 65 65 3b 0a 7d 0a 23 65 6e 64  rn nFree;.}.#end
a150: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41  if /* SQLITE_ENA
a160: 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47  BLE_MEMORY_MANAG
a170: 45 4d 45 4e 54 20 2a 2f 0a 0a 23 69 66 64 65 66  EMENT */..#ifdef
a180: 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 2f 2a 0a   SQLITE_TEST./*.
a190: 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e  ** This function
a1a0: 20 69 73 20 75 73 65 64 20 62 79 20 74 65 73 74   is used by test
a1b0: 20 70 72 6f 63 65 64 75 72 65 73 20 74 6f 20 69   procedures to i
a1c0: 6e 73 70 65 63 74 20 74 68 65 20 69 6e 74 65 72  nspect the inter
a1d0: 6e 61 6c 20 73 74 61 74 65 0a 2a 2a 20 6f 66 20  nal state.** of 
a1e0: 74 68 65 20 67 6c 6f 62 61 6c 20 63 61 63 68 65  the global cache
a1f0: 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65  ..*/.void sqlite
a200: 33 50 63 61 63 68 65 53 74 61 74 73 28 0a 20 20  3PcacheStats(.  
a210: 69 6e 74 20 2a 70 6e 43 75 72 72 65 6e 74 2c 20  int *pnCurrent, 
a220: 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 54 6f 74       /* OUT: Tot
a230: 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67  al number of pag
a240: 65 73 20 63 61 63 68 65 64 20 2a 2f 0a 20 20 69  es cached */.  i
a250: 6e 74 20 2a 70 6e 4d 61 78 2c 20 20 20 20 20 20  nt *pnMax,      
a260: 20 20 20 20 2f 2a 20 4f 55 54 3a 20 47 6c 6f 62      /* OUT: Glob
a270: 61 6c 20 6d 61 78 69 6d 75 6d 20 63 61 63 68 65  al maximum cache
a280: 20 73 69 7a 65 20 2a 2f 0a 20 20 69 6e 74 20 2a   size */.  int *
a290: 70 6e 4d 69 6e 2c 20 20 20 20 20 20 20 20 20 20  pnMin,          
a2a0: 2f 2a 20 4f 55 54 3a 20 53 75 6d 20 6f 66 20 50  /* OUT: Sum of P
a2b0: 43 61 63 68 65 31 2e 6e 4d 69 6e 20 66 6f 72 20  Cache1.nMin for 
a2c0: 70 75 72 67 65 61 62 6c 65 20 63 61 63 68 65 73  purgeable caches
a2d0: 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 52 65 63   */.  int *pnRec
a2e0: 79 63 6c 61 62 6c 65 20 20 20 20 2f 2a 20 4f 55  yclable    /* OU
a2f0: 54 3a 20 54 6f 74 61 6c 20 6e 75 6d 62 65 72 20  T: Total number 
a300: 6f 66 20 70 61 67 65 73 20 61 76 61 69 6c 61 62  of pages availab
a310: 6c 65 20 66 6f 72 20 72 65 63 79 63 6c 69 6e 67  le for recycling
a320: 20 2a 2f 0a 29 7b 0a 20 20 50 67 48 64 72 31 20   */.){.  PgHdr1 
a330: 2a 70 3b 0a 20 20 69 6e 74 20 6e 52 65 63 79 63  *p;.  int nRecyc
a340: 6c 61 62 6c 65 20 3d 20 30 3b 0a 20 20 66 6f 72  lable = 0;.  for
a350: 28 70 3d 70 63 61 63 68 65 31 2e 67 72 70 2e 6c  (p=pcache1.grp.l
a360: 72 75 2e 70 4c 72 75 4e 65 78 74 3b 20 70 20 26  ru.pLruNext; p &
a370: 26 20 21 70 2d 3e 69 73 41 6e 63 68 6f 72 3b 20  & !p->isAnchor; 
a380: 70 3d 70 2d 3e 70 4c 72 75 4e 65 78 74 29 7b 0a  p=p->pLruNext){.
a390: 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 69      assert( p->i
a3a0: 73 50 69 6e 6e 65 64 3d 3d 30 20 29 3b 0a 20 20  sPinned==0 );.  
a3b0: 20 20 6e 52 65 63 79 63 6c 61 62 6c 65 2b 2b 3b    nRecyclable++;
a3c0: 0a 20 20 7d 0a 20 20 2a 70 6e 43 75 72 72 65 6e  .  }.  *pnCurren
a3d0: 74 20 3d 20 70 63 61 63 68 65 31 2e 67 72 70 2e  t = pcache1.grp.
a3e0: 6e 43 75 72 72 65 6e 74 50 61 67 65 3b 0a 20 20  nCurrentPage;.  
a3f0: 2a 70 6e 4d 61 78 20 3d 20 28 69 6e 74 29 70 63  *pnMax = (int)pc
a400: 61 63 68 65 31 2e 67 72 70 2e 6e 4d 61 78 50 61  ache1.grp.nMaxPa
a410: 67 65 3b 0a 20 20 2a 70 6e 4d 69 6e 20 3d 20 28  ge;.  *pnMin = (
a420: 69 6e 74 29 70 63 61 63 68 65 31 2e 67 72 70 2e  int)pcache1.grp.
a430: 6e 4d 69 6e 50 61 67 65 3b 0a 20 20 2a 70 6e 52  nMinPage;.  *pnR
a440: 65 63 79 63 6c 61 62 6c 65 20 3d 20 6e 52 65 63  ecyclable = nRec
a450: 79 63 6c 61 62 6c 65 3b 0a 7d 0a 23 65 6e 64 69  yclable;.}.#endi
a460: 66 0a                                            f.