/ Hex Artifact Content
Login

Artifact 7eaf916c98e8201aba67a907bbd122a1e476049156e1f507b00d4fd8b730eea7:


0000: 2f 2a 0a 2a 2a 20 32 30 30 38 20 4e 6f 76 65 6d  /*.** 2008 Novem
0010: 62 65 72 20 30 35 0a 2a 2a 0a 2a 2a 20 54 68 65  ber 05.**.** The
0020: 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 6d   author disclaim
0030: 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 74  s copyright to t
0040: 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 2e  his source code.
0050: 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a 2a    In place of.**
0060: 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 2c   a legal notice,
0070: 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 73   here is a bless
0080: 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61  ing:.**.**    Ma
0090: 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 6e  y you do good an
00a0: 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 20  d not evil..**  
00b0: 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 66    May you find f
00c0: 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 79  orgiveness for y
00d0: 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 67  ourself and forg
00e0: 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 20  ive others..**  
00f0: 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 20    May you share 
0100: 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 61  freely, never ta
0110: 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 79  king more than y
0120: 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a  ou give..**.****
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0170: 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 54 68 69 73  *****.**.** This
0180: 20 66 69 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 73   file implements
0190: 20 74 68 65 20 64 65 66 61 75 6c 74 20 70 61 67   the default pag
01a0: 65 20 63 61 63 68 65 20 69 6d 70 6c 65 6d 65 6e  e cache implemen
01b0: 74 61 74 69 6f 6e 20 28 74 68 65 0a 2a 2a 20 73  tation (the.** s
01c0: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 69 6e  qlite3_pcache in
01d0: 74 65 72 66 61 63 65 29 2e 20 49 74 20 61 6c 73  terface). It als
01e0: 6f 20 63 6f 6e 74 61 69 6e 73 20 70 61 72 74 20  o contains part 
01f0: 6f 66 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74  of the implement
0200: 61 74 69 6f 6e 0a 2a 2a 20 6f 66 20 74 68 65 20  ation.** of the 
0210: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41  SQLITE_CONFIG_PA
0220: 47 45 43 41 43 48 45 20 61 6e 64 20 73 71 6c 69  GECACHE and sqli
0230: 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f  te3_release_memo
0240: 72 79 28 29 20 66 65 61 74 75 72 65 73 2e 0a 2a  ry() features..*
0250: 2a 20 49 66 20 74 68 65 20 64 65 66 61 75 6c 74  * If the default
0260: 20 70 61 67 65 20 63 61 63 68 65 20 69 6d 70 6c   page cache impl
0270: 65 6d 65 6e 74 61 74 69 6f 6e 20 69 73 20 6f 76  ementation is ov
0280: 65 72 72 69 64 64 65 6e 2c 20 74 68 65 6e 20 6e  erridden, then n
0290: 65 69 74 68 65 72 20 6f 66 0a 2a 2a 20 74 68 65  either of.** the
02a0: 73 65 20 74 77 6f 20 66 65 61 74 75 72 65 73 20  se two features 
02b0: 61 72 65 20 61 76 61 69 6c 61 62 6c 65 2e 0a 2a  are available..*
02c0: 2a 0a 2a 2a 20 41 20 50 61 67 65 20 63 61 63 68  *.** A Page cach
02d0: 65 20 6c 69 6e 65 20 6c 6f 6f 6b 73 20 6c 69 6b  e line looks lik
02e0: 65 20 74 68 69 73 3a 0a 2a 2a 0a 2a 2a 20 20 2d  e this:.**.**  -
02f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0300: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0310: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0320: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 20  ------------.** 
0330: 20 7c 20 20 64 61 74 61 62 61 73 65 20 70 61 67   |  database pag
0340: 65 20 63 6f 6e 74 65 6e 74 20 20 20 7c 20 20 50  e content   |  P
0350: 67 48 64 72 31 20 20 7c 20 20 4d 65 6d 50 61 67  gHdr1  |  MemPag
0360: 65 20 20 7c 20 20 50 67 48 64 72 20 20 7c 0a 2a  e  |  PgHdr  |.*
0370: 2a 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  *  -------------
0380: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0390: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
03a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
03b0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 64 61 74 61 62  .**.** The datab
03c0: 61 73 65 20 70 61 67 65 20 63 6f 6e 74 65 6e 74  ase page content
03d0: 20 69 73 20 75 70 20 66 72 6f 6e 74 20 28 73 6f   is up front (so
03e0: 20 74 68 61 74 20 62 75 66 66 65 72 20 6f 76 65   that buffer ove
03f0: 72 72 65 61 64 73 20 74 65 6e 64 20 74 6f 0a 2a  rreads tend to.*
0400: 2a 20 66 6c 6f 77 20 68 61 72 6d 6c 65 73 73 6c  * flow harmlessl
0410: 79 20 69 6e 74 6f 20 74 68 65 20 50 67 48 64 72  y into the PgHdr
0420: 31 2c 20 4d 65 6d 50 61 67 65 2c 20 61 6e 64 20  1, MemPage, and 
0430: 50 67 48 64 72 20 65 78 74 65 6e 73 69 6f 6e 73  PgHdr extensions
0440: 29 2e 20 20 20 4d 65 6d 50 61 67 65 0a 2a 2a 20  ).   MemPage.** 
0450: 69 73 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e  is the extension
0460: 20 61 64 64 65 64 20 62 79 20 74 68 65 20 62 74   added by the bt
0470: 72 65 65 2e 63 20 6d 6f 64 75 6c 65 20 63 6f 6e  ree.c module con
0480: 74 61 69 6e 69 6e 67 20 69 6e 66 6f 72 6d 61 74  taining informat
0490: 69 6f 6e 20 73 75 63 68 0a 2a 2a 20 61 73 20 74  ion such.** as t
04a0: 68 65 20 64 61 74 61 62 61 73 65 20 70 61 67 65  he database page
04b0: 20 6e 75 6d 62 65 72 20 61 6e 64 20 68 6f 77 20   number and how 
04c0: 74 68 61 74 20 64 61 74 61 62 61 73 65 20 70 61  that database pa
04d0: 67 65 20 69 73 20 75 73 65 64 2e 20 20 50 67 48  ge is used.  PgH
04e0: 64 72 0a 2a 2a 20 69 73 20 61 64 64 65 64 20 62  dr.** is added b
04f0: 79 20 74 68 65 20 70 63 61 63 68 65 2e 63 20 6c  y the pcache.c l
0500: 61 79 65 72 20 61 6e 64 20 63 6f 6e 74 61 69 6e  ayer and contain
0510: 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 75 73  s information us
0520: 65 64 20 74 6f 20 6b 65 65 70 20 74 72 61 63 6b  ed to keep track
0530: 0a 2a 2a 20 6f 66 20 77 68 69 63 68 20 70 61 67  .** of which pag
0540: 65 73 20 61 72 65 20 22 64 69 72 74 79 22 2e 20  es are "dirty". 
0550: 20 50 67 48 64 72 31 20 69 73 20 61 6e 20 65 78   PgHdr1 is an ex
0560: 74 65 6e 73 69 6f 6e 20 61 64 64 65 64 20 62 79  tension added by
0570: 20 74 68 69 73 0a 2a 2a 20 6d 6f 64 75 6c 65 20   this.** module 
0580: 28 70 63 61 63 68 65 31 2e 63 29 2e 20 20 54 68  (pcache1.c).  Th
0590: 65 20 50 67 48 64 72 31 20 68 65 61 64 65 72 20  e PgHdr1 header 
05a0: 69 73 20 61 20 73 75 62 63 6c 61 73 73 20 6f 66  is a subclass of
05b0: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f   sqlite3_pcache_
05c0: 70 61 67 65 2e 0a 2a 2a 20 50 67 48 64 72 31 20  page..** PgHdr1 
05d0: 63 6f 6e 74 61 69 6e 73 20 69 6e 66 6f 72 6d 61  contains informa
05e0: 74 69 6f 6e 20 6e 65 65 64 65 64 20 74 6f 20 6c  tion needed to l
05f0: 6f 6f 6b 20 75 70 20 61 20 70 61 67 65 20 62 79  ook up a page by
0600: 20 69 74 73 20 70 61 67 65 20 6e 75 6d 62 65 72   its page number
0610: 2e 0a 2a 2a 20 54 68 65 20 73 75 70 65 72 63 6c  ..** The supercl
0620: 61 73 73 20 73 71 6c 69 74 65 33 5f 70 63 61 63  ass sqlite3_pcac
0630: 68 65 5f 70 61 67 65 2e 70 42 75 66 20 70 6f 69  he_page.pBuf poi
0640: 6e 74 73 20 74 6f 20 74 68 65 20 73 74 61 72 74  nts to the start
0650: 20 6f 66 20 74 68 65 0a 2a 2a 20 64 61 74 61 62   of the.** datab
0660: 61 73 65 20 70 61 67 65 20 63 6f 6e 74 65 6e 74  ase page content
0670: 20 61 6e 64 20 73 71 6c 69 74 65 33 5f 70 63 61   and sqlite3_pca
0680: 63 68 65 5f 70 61 67 65 2e 70 45 78 74 72 61 20  che_page.pExtra 
0690: 70 6f 69 6e 74 73 20 74 6f 20 50 67 48 64 72 2e  points to PgHdr.
06a0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 69 7a 65 20  .**.** The size 
06b0: 6f 66 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e  of the extension
06c0: 20 28 4d 65 6d 50 61 67 65 2b 50 67 48 64 72 2b   (MemPage+PgHdr+
06d0: 50 67 48 64 72 31 29 20 63 61 6e 20 62 65 20 64  PgHdr1) can be d
06e0: 65 74 65 72 6d 69 6e 65 64 20 61 74 0a 2a 2a 20  etermined at.** 
06f0: 72 75 6e 74 69 6d 65 20 75 73 69 6e 67 20 73 71  runtime using sq
0700: 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c  lite3_config(SQL
0710: 49 54 45 5f 43 4f 4e 46 49 47 5f 50 43 41 43 48  ITE_CONFIG_PCACH
0720: 45 5f 48 44 52 53 5a 2c 20 26 73 69 7a 65 29 2e  E_HDRSZ, &size).
0730: 20 20 54 68 65 0a 2a 2a 20 73 69 7a 65 73 20 6f    The.** sizes o
0740: 66 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e 73  f the extensions
0750: 20 73 75 6d 20 74 6f 20 32 37 32 20 62 79 74 65   sum to 272 byte
0760: 73 20 6f 6e 20 78 36 34 20 66 6f 72 20 33 2e 38  s on x64 for 3.8
0770: 2e 31 30 2c 20 62 75 74 20 74 68 69 73 0a 2a 2a  .10, but this.**
0780: 20 73 69 7a 65 20 63 61 6e 20 76 61 72 79 20 61   size can vary a
0790: 63 63 6f 72 64 69 6e 67 20 74 6f 20 61 72 63 68  ccording to arch
07a0: 69 74 65 63 74 75 72 65 2c 20 63 6f 6d 70 69 6c  itecture, compil
07b0: 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73 2c 20  e-time options, 
07c0: 61 6e 64 0a 2a 2a 20 53 51 4c 69 74 65 20 6c 69  and.** SQLite li
07d0: 62 72 61 72 79 20 76 65 72 73 69 6f 6e 20 6e 75  brary version nu
07e0: 6d 62 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 53  mber..**.** If S
07f0: 51 4c 49 54 45 5f 50 43 41 43 48 45 5f 53 45 50  QLITE_PCACHE_SEP
0800: 41 52 41 54 45 5f 48 45 41 44 45 52 20 69 73 20  ARATE_HEADER is 
0810: 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 74 68  defined, then th
0820: 65 20 65 78 74 65 6e 73 69 6f 6e 20 69 73 20 6f  e extension is o
0830: 62 74 61 69 6e 65 64 0a 2a 2a 20 75 73 69 6e 67  btained.** using
0840: 20 61 20 73 65 70 61 72 61 74 65 20 6d 65 6d 6f   a separate memo
0850: 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 66 72  ry allocation fr
0860: 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 20  om the database 
0870: 70 61 67 65 20 63 6f 6e 74 65 6e 74 2e 20 20 54  page content.  T
0880: 68 69 73 0a 2a 2a 20 73 65 65 6b 73 20 74 6f 20  his.** seeks to 
0890: 6f 76 65 72 63 6f 6d 65 20 74 68 65 20 22 63 6c  overcome the "cl
08a0: 6f 77 6e 73 68 6f 65 22 20 70 72 6f 62 6c 65 6d  ownshoe" problem
08b0: 20 28 61 6c 73 6f 20 63 61 6c 6c 65 64 20 22 69   (also called "i
08c0: 6e 74 65 72 6e 61 6c 0a 2a 2a 20 66 72 61 67 6d  nternal.** fragm
08d0: 65 6e 74 61 74 69 6f 6e 22 20 69 6e 20 61 63 61  entation" in aca
08e0: 64 65 6d 69 63 20 6c 69 74 65 72 61 74 75 72 65  demic literature
08f0: 29 20 6f 66 20 61 6c 6c 6f 63 61 74 69 6e 67 20  ) of allocating 
0900: 61 20 66 65 77 20 62 79 74 65 73 20 6d 6f 72 65  a few bytes more
0910: 0a 2a 2a 20 74 68 61 6e 20 61 20 70 6f 77 65 72  .** than a power
0920: 20 6f 66 20 74 77 6f 20 77 69 74 68 20 74 68 65   of two with the
0930: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f   memory allocato
0940: 72 20 72 6f 75 6e 64 69 6e 67 20 75 70 20 74 6f  r rounding up to
0950: 20 74 68 65 20 6e 65 78 74 0a 2a 2a 20 70 6f 77   the next.** pow
0960: 65 72 20 6f 66 20 74 77 6f 2c 20 61 6e 64 20 6c  er of two, and l
0970: 65 61 76 69 6e 67 20 74 68 65 20 72 6f 75 6e 64  eaving the round
0980: 65 64 2d 75 70 20 73 70 61 63 65 20 75 6e 75 73  ed-up space unus
0990: 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 6d  ed..**.** This m
09a0: 6f 64 75 6c 65 20 74 72 61 63 6b 73 20 70 6f 69  odule tracks poi
09b0: 6e 74 65 72 73 20 74 6f 20 50 67 48 64 72 31 20  nters to PgHdr1 
09c0: 6f 62 6a 65 63 74 73 2e 20 20 4f 6e 6c 79 20 70  objects.  Only p
09d0: 63 61 63 68 65 2e 63 20 63 6f 6d 6d 75 6e 69 63  cache.c communic
09e0: 61 74 65 73 0a 2a 2a 20 77 69 74 68 20 74 68 69  ates.** with thi
09f0: 73 20 6d 6f 64 75 6c 65 2e 20 20 49 6e 66 6f 72  s module.  Infor
0a00: 6d 61 74 69 6f 6e 20 69 73 20 70 61 73 73 65 64  mation is passed
0a10: 20 62 61 63 6b 20 61 6e 64 20 66 6f 72 74 68 20   back and forth 
0a20: 61 73 20 50 67 48 64 72 31 20 70 6f 69 6e 74 65  as PgHdr1 pointe
0a30: 72 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 63  rs..**.** The pc
0a40: 61 63 68 65 2e 63 20 61 6e 64 20 70 61 67 65 72  ache.c and pager
0a50: 2e 63 20 6d 6f 64 75 6c 65 73 20 64 65 61 6c 20  .c modules deal 
0a60: 70 6f 69 6e 74 65 72 73 20 74 6f 20 50 67 48 64  pointers to PgHd
0a70: 72 20 6f 62 6a 65 63 74 73 2e 0a 2a 2a 20 54 68  r objects..** Th
0a80: 65 20 62 74 72 65 65 2e 63 20 6d 6f 64 75 6c 65  e btree.c module
0a90: 20 64 65 61 6c 73 20 77 69 74 68 20 70 6f 69 6e   deals with poin
0aa0: 74 65 72 73 20 74 6f 20 4d 65 6d 50 61 67 65 20  ters to MemPage 
0ab0: 6f 62 6a 65 63 74 73 2e 0a 2a 2a 0a 2a 2a 20 53  objects..**.** S
0ac0: 4f 55 52 43 45 20 4f 46 20 50 41 47 45 20 43 41  OURCE OF PAGE CA
0ad0: 43 48 45 20 4d 45 4d 4f 52 59 3a 0a 2a 2a 0a 2a  CHE MEMORY:.**.*
0ae0: 2a 20 4d 65 6d 6f 72 79 20 66 6f 72 20 61 20 70  * Memory for a p
0af0: 61 67 65 20 6d 69 67 68 74 20 63 6f 6d 65 20 66  age might come f
0b00: 72 6f 6d 20 61 6e 79 20 6f 66 20 74 68 72 65 65  rom any of three
0b10: 20 73 6f 75 72 63 65 73 3a 0a 2a 2a 0a 2a 2a 20   sources:.**.** 
0b20: 20 20 20 28 31 29 20 20 54 68 65 20 67 65 6e 65     (1)  The gene
0b30: 72 61 6c 2d 70 75 72 70 6f 73 65 20 6d 65 6d 6f  ral-purpose memo
0b40: 72 79 20 61 6c 6c 6f 63 61 74 6f 72 20 2d 20 73  ry allocator - s
0b50: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 29 0a 2a  qlite3Malloc().*
0b60: 2a 20 20 20 20 28 32 29 20 20 47 6c 6f 62 61 6c  *    (2)  Global
0b70: 20 70 61 67 65 2d 63 61 63 68 65 20 6d 65 6d 6f   page-cache memo
0b80: 72 79 20 70 72 6f 76 69 64 65 64 20 75 73 69 6e  ry provided usin
0b90: 67 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67  g sqlite3_config
0ba0: 28 29 20 77 69 74 68 0a 2a 2a 20 20 20 20 20 20  () with.**      
0bb0: 20 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47     SQLITE_CONFIG
0bc0: 5f 50 41 47 45 43 41 43 48 45 2e 0a 2a 2a 20 20  _PAGECACHE..**  
0bd0: 20 20 28 33 29 20 20 50 43 61 63 68 65 2d 6c 6f    (3)  PCache-lo
0be0: 63 61 6c 20 62 75 6c 6b 20 61 6c 6c 6f 63 61 74  cal bulk allocat
0bf0: 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 74  ion..**.** The t
0c00: 68 69 72 64 20 63 61 73 65 20 69 73 20 61 20 63  hird case is a c
0c10: 68 75 6e 6b 20 6f 66 20 68 65 61 70 20 6d 65 6d  hunk of heap mem
0c20: 6f 72 79 20 28 64 65 66 61 75 6c 74 69 6e 67 20  ory (defaulting 
0c30: 74 6f 20 31 30 30 20 70 61 67 65 73 20 77 6f 72  to 100 pages wor
0c40: 74 68 29 0a 2a 2a 20 74 68 61 74 20 69 73 20 61  th).** that is a
0c50: 6c 6c 6f 63 61 74 65 64 20 77 68 65 6e 20 74 68  llocated when th
0c60: 65 20 70 61 67 65 20 63 61 63 68 65 20 69 73 20  e page cache is 
0c70: 63 72 65 61 74 65 64 2e 20 20 54 68 65 20 73 69  created.  The si
0c80: 7a 65 20 6f 66 20 74 68 65 20 6c 6f 63 61 6c 0a  ze of the local.
0c90: 2a 2a 20 62 75 6c 6b 20 61 6c 6c 6f 63 61 74 69  ** bulk allocati
0ca0: 6f 6e 20 63 61 6e 20 62 65 20 61 64 6a 75 73 74  on can be adjust
0cb0: 65 64 20 75 73 69 6e 67 20 0a 2a 2a 0a 2a 2a 20  ed using .**.** 
0cc0: 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66      sqlite3_conf
0cd0: 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47  ig(SQLITE_CONFIG
0ce0: 5f 50 41 47 45 43 41 43 48 45 2c 20 28 76 6f 69  _PAGECACHE, (voi
0cf0: 64 2a 29 30 2c 20 30 2c 20 4e 29 2e 0a 2a 2a 0a  d*)0, 0, N)..**.
0d00: 2a 2a 20 49 66 20 4e 20 69 73 20 70 6f 73 69 74  ** If N is posit
0d10: 69 76 65 2c 20 74 68 65 6e 20 4e 20 70 61 67 65  ive, then N page
0d20: 73 20 77 6f 72 74 68 20 6f 66 20 6d 65 6d 6f 72  s worth of memor
0d30: 79 20 61 72 65 20 61 6c 6c 6f 63 61 74 65 64 20  y are allocated 
0d40: 75 73 69 6e 67 20 61 20 73 69 6e 67 6c 65 0a 2a  using a single.*
0d50: 2a 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28  * sqlite3Malloc(
0d60: 29 20 63 61 6c 6c 20 61 6e 64 20 74 68 61 74 20  ) call and that 
0d70: 6d 65 6d 6f 72 79 20 69 73 20 75 73 65 64 20 66  memory is used f
0d80: 6f 72 20 74 68 65 20 66 69 72 73 74 20 4e 20 70  or the first N p
0d90: 61 67 65 73 20 61 6c 6c 6f 63 61 74 65 64 2e 0a  ages allocated..
0da0: 2a 2a 20 4f 72 20 69 66 20 4e 20 69 73 20 6e 65  ** Or if N is ne
0db0: 67 61 74 69 76 65 2c 20 74 68 65 6e 20 2d 31 30  gative, then -10
0dc0: 32 34 2a 4e 20 62 79 74 65 73 20 6f 66 20 6d 65  24*N bytes of me
0dd0: 6d 6f 72 79 20 61 72 65 20 61 6c 6c 6f 63 61 74  mory are allocat
0de0: 65 64 20 61 6e 64 20 75 73 65 64 0a 2a 2a 20 66  ed and used.** f
0df0: 6f 72 20 61 73 20 6d 61 6e 79 20 70 61 67 65 73  or as many pages
0e00: 20 61 73 20 63 61 6e 20 62 65 20 61 63 63 6f 6d   as can be accom
0e10: 6f 64 61 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 4f 6e  odated..**.** On
0e20: 6c 79 20 6f 6e 65 20 6f 66 20 28 32 29 20 6f 72  ly one of (2) or
0e30: 20 28 33 29 20 63 61 6e 20 62 65 20 75 73 65 64   (3) can be used
0e40: 2e 20 20 4f 6e 63 65 20 74 68 65 20 6d 65 6d 6f  .  Once the memo
0e50: 72 79 20 61 76 61 69 6c 61 62 6c 65 20 74 6f 20  ry available to 
0e60: 28 32 29 20 6f 72 0a 2a 2a 20 28 33 29 20 69 73  (2) or.** (3) is
0e70: 20 65 78 68 61 75 73 74 65 64 2c 20 73 75 62 73   exhausted, subs
0e80: 65 71 75 65 6e 74 20 61 6c 6c 6f 63 61 74 69 6f  equent allocatio
0e90: 6e 73 20 66 61 69 6c 20 6f 76 65 72 20 74 6f 20  ns fail over to 
0ea0: 74 68 65 20 67 65 6e 65 72 61 6c 2d 70 75 72 70  the general-purp
0eb0: 6f 73 65 0a 2a 2a 20 6d 65 6d 6f 72 79 20 61 6c  ose.** memory al
0ec0: 6c 6f 63 61 74 6f 72 20 28 31 29 2e 0a 2a 2a 0a  locator (1)..**.
0ed0: 2a 2a 20 45 61 72 6c 69 65 72 20 76 65 72 73 69  ** Earlier versi
0ee0: 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 75 73  ons of SQLite us
0ef0: 65 64 20 6f 6e 6c 79 20 6d 65 74 68 6f 64 73 20  ed only methods 
0f00: 28 31 29 20 61 6e 64 20 28 32 29 2e 20 20 42 75  (1) and (2).  Bu
0f10: 74 20 65 78 70 65 72 69 6d 65 6e 74 73 0a 2a 2a  t experiments.**
0f20: 20 73 68 6f 77 20 74 68 61 74 20 6d 65 74 68 6f   show that metho
0f30: 64 20 28 33 29 20 77 69 74 68 20 4e 3d 3d 31 30  d (3) with N==10
0f40: 30 20 70 72 6f 76 69 64 65 73 20 61 62 6f 75 74  0 provides about
0f50: 20 61 20 35 25 20 70 65 72 66 6f 72 6d 61 6e 63   a 5% performanc
0f60: 65 20 62 6f 6f 73 74 20 66 6f 72 0a 2a 2a 20 63  e boost for.** c
0f70: 6f 6d 6d 6f 6e 20 77 6f 72 6b 6c 6f 61 64 73 2e  ommon workloads.
0f80: 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71  .*/.#include "sq
0f90: 6c 69 74 65 49 6e 74 2e 68 22 0a 0a 74 79 70 65  liteInt.h"..type
0fa0: 64 65 66 20 73 74 72 75 63 74 20 50 43 61 63 68  def struct PCach
0fb0: 65 31 20 50 43 61 63 68 65 31 3b 0a 74 79 70 65  e1 PCache1;.type
0fc0: 64 65 66 20 73 74 72 75 63 74 20 50 67 48 64 72  def struct PgHdr
0fd0: 31 20 50 67 48 64 72 31 3b 0a 74 79 70 65 64 65  1 PgHdr1;.typede
0fe0: 66 20 73 74 72 75 63 74 20 50 67 46 72 65 65 73  f struct PgFrees
0ff0: 6c 6f 74 20 50 67 46 72 65 65 73 6c 6f 74 3b 0a  lot PgFreeslot;.
1000: 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 50  typedef struct P
1010: 47 72 6f 75 70 20 50 47 72 6f 75 70 3b 0a 0a 2f  Group PGroup;../
1020: 2a 0a 2a 2a 20 45 61 63 68 20 63 61 63 68 65 20  *.** Each cache 
1030: 65 6e 74 72 79 20 69 73 20 72 65 70 72 65 73 65  entry is represe
1040: 6e 74 65 64 20 62 79 20 61 6e 20 69 6e 73 74 61  nted by an insta
1050: 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f  nce of the follo
1060: 77 69 6e 67 20 0a 2a 2a 20 73 74 72 75 63 74 75  wing .** structu
1070: 72 65 2e 20 55 6e 6c 65 73 73 20 53 51 4c 49 54  re. Unless SQLIT
1080: 45 5f 50 43 41 43 48 45 5f 53 45 50 41 52 41 54  E_PCACHE_SEPARAT
1090: 45 5f 48 45 41 44 45 52 20 69 73 20 64 65 66 69  E_HEADER is defi
10a0: 6e 65 64 2c 20 61 20 62 75 66 66 65 72 20 6f 66  ned, a buffer of
10b0: 0a 2a 2a 20 50 67 48 64 72 31 2e 70 43 61 63 68  .** PgHdr1.pCach
10c0: 65 2d 3e 73 7a 50 61 67 65 20 62 79 74 65 73 20  e->szPage bytes 
10d0: 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 64 69 72  is allocated dir
10e0: 65 63 74 6c 79 20 62 65 66 6f 72 65 20 74 68 69  ectly before thi
10f0: 73 20 73 74 72 75 63 74 75 72 65 20 0a 2a 2a 20  s structure .** 
1100: 69 6e 20 6d 65 6d 6f 72 79 2e 0a 2a 2f 0a 73 74  in memory..*/.st
1110: 72 75 63 74 20 50 67 48 64 72 31 20 7b 0a 20 20  ruct PgHdr1 {.  
1120: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 70  sqlite3_pcache_p
1130: 61 67 65 20 70 61 67 65 3b 20 20 20 20 20 20 2f  age page;      /
1140: 2a 20 42 61 73 65 20 63 6c 61 73 73 2e 20 4d 75  * Base class. Mu
1150: 73 74 20 62 65 20 66 69 72 73 74 2e 20 70 42 75  st be first. pBu
1160: 66 20 26 20 70 45 78 74 72 61 20 2a 2f 0a 20 20  f & pExtra */.  
1170: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4b 65  unsigned int iKe
1180: 79 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  y;             /
1190: 2a 20 4b 65 79 20 76 61 6c 75 65 20 28 70 61 67  * Key value (pag
11a0: 65 20 6e 75 6d 62 65 72 29 20 2a 2f 0a 20 20 75  e number) */.  u
11b0: 38 20 69 73 50 69 6e 6e 65 64 3b 20 20 20 20 20  8 isPinned;     
11c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
11d0: 20 50 61 67 65 20 69 6e 20 75 73 65 2c 20 6e 6f   Page in use, no
11e0: 74 20 6f 6e 20 74 68 65 20 4c 52 55 20 6c 69 73  t on the LRU lis
11f0: 74 20 2a 2f 0a 20 20 75 38 20 69 73 42 75 6c 6b  t */.  u8 isBulk
1200: 4c 6f 63 61 6c 3b 20 20 20 20 20 20 20 20 20 20  Local;          
1210: 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 70 61        /* This pa
1220: 67 65 20 66 72 6f 6d 20 62 75 6c 6b 20 6c 6f 63  ge from bulk loc
1230: 61 6c 20 73 74 6f 72 61 67 65 20 2a 2f 0a 20 20  al storage */.  
1240: 75 38 20 69 73 41 6e 63 68 6f 72 3b 20 20 20 20  u8 isAnchor;    
1250: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1260: 2a 20 54 68 69 73 20 69 73 20 74 68 65 20 50 47  * This is the PG
1270: 72 6f 75 70 2e 6c 72 75 20 65 6c 65 6d 65 6e 74  roup.lru element
1280: 20 2a 2f 0a 20 20 50 67 48 64 72 31 20 2a 70 4e   */.  PgHdr1 *pN
1290: 65 78 74 3b 20 20 20 20 20 20 20 20 20 20 20 20  ext;            
12a0: 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 69 6e 20       /* Next in 
12b0: 68 61 73 68 20 74 61 62 6c 65 20 63 68 61 69 6e  hash table chain
12c0: 20 2a 2f 0a 20 20 50 43 61 63 68 65 31 20 2a 70   */.  PCache1 *p
12d0: 43 61 63 68 65 3b 20 20 20 20 20 20 20 20 20 20  Cache;          
12e0: 20 20 20 20 20 2f 2a 20 43 61 63 68 65 20 74 68       /* Cache th
12f0: 61 74 20 63 75 72 72 65 6e 74 6c 79 20 6f 77 6e  at currently own
1300: 73 20 74 68 69 73 20 70 61 67 65 20 2a 2f 0a 20  s this page */. 
1310: 20 50 67 48 64 72 31 20 2a 70 4c 72 75 4e 65 78   PgHdr1 *pLruNex
1320: 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  t;              
1330: 2f 2a 20 4e 65 78 74 20 69 6e 20 4c 52 55 20 6c  /* Next in LRU l
1340: 69 73 74 20 6f 66 20 75 6e 70 69 6e 6e 65 64 20  ist of unpinned 
1350: 70 61 67 65 73 20 2a 2f 0a 20 20 50 67 48 64 72  pages */.  PgHdr
1360: 31 20 2a 70 4c 72 75 50 72 65 76 3b 20 20 20 20  1 *pLruPrev;    
1370: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 72 65            /* Pre
1380: 76 69 6f 75 73 20 69 6e 20 4c 52 55 20 6c 69 73  vious in LRU lis
1390: 74 20 6f 66 20 75 6e 70 69 6e 6e 65 64 20 70 61  t of unpinned pa
13a0: 67 65 73 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 45 61  ges */.};../* Ea
13b0: 63 68 20 70 61 67 65 20 63 61 63 68 65 20 28 6f  ch page cache (o
13c0: 72 20 50 43 61 63 68 65 29 20 62 65 6c 6f 6e 67  r PCache) belong
13d0: 73 20 74 6f 20 61 20 50 47 72 6f 75 70 2e 20 20  s to a PGroup.  
13e0: 41 20 50 47 72 6f 75 70 20 69 73 20 61 20 73 65  A PGroup is a se
13f0: 74 20 0a 2a 2a 20 6f 66 20 6f 6e 65 20 6f 72 20  t .** of one or 
1400: 6d 6f 72 65 20 50 43 61 63 68 65 73 20 74 68 61  more PCaches tha
1410: 74 20 61 72 65 20 61 62 6c 65 20 74 6f 20 72 65  t are able to re
1420: 63 79 63 6c 65 20 65 61 63 68 20 6f 74 68 65 72  cycle each other
1430: 27 73 20 75 6e 70 69 6e 6e 65 64 0a 2a 2a 20 70  's unpinned.** p
1440: 61 67 65 73 20 77 68 65 6e 20 74 68 65 79 20 61  ages when they a
1450: 72 65 20 75 6e 64 65 72 20 6d 65 6d 6f 72 79 20  re under memory 
1460: 70 72 65 73 73 75 72 65 2e 20 20 41 20 50 47 72  pressure.  A PGr
1470: 6f 75 70 20 69 73 20 61 6e 20 69 6e 73 74 61 6e  oup is an instan
1480: 63 65 20 6f 66 0a 2a 2a 20 74 68 65 20 66 6f 6c  ce of.** the fol
1490: 6c 6f 77 69 6e 67 20 6f 62 6a 65 63 74 2e 0a 2a  lowing object..*
14a0: 2a 0a 2a 2a 20 54 68 69 73 20 70 61 67 65 20 63  *.** This page c
14b0: 61 63 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74  ache implementat
14c0: 69 6f 6e 20 77 6f 72 6b 73 20 69 6e 20 6f 6e 65  ion works in one
14d0: 20 6f 66 20 74 77 6f 20 6d 6f 64 65 73 3a 0a 2a   of two modes:.*
14e0: 2a 0a 2a 2a 20 20 20 28 31 29 20 20 45 76 65 72  *.**   (1)  Ever
14f0: 79 20 50 43 61 63 68 65 20 69 73 20 74 68 65 20  y PCache is the 
1500: 73 6f 6c 65 20 6d 65 6d 62 65 72 20 6f 66 20 69  sole member of i
1510: 74 73 20 6f 77 6e 20 50 47 72 6f 75 70 2e 20 20  ts own PGroup.  
1520: 54 68 65 72 65 20 69 73 0a 2a 2a 20 20 20 20 20  There is.**     
1530: 20 20 20 6f 6e 65 20 50 47 72 6f 75 70 20 70 65     one PGroup pe
1540: 72 20 50 43 61 63 68 65 2e 0a 2a 2a 0a 2a 2a 20  r PCache..**.** 
1550: 20 20 28 32 29 20 20 54 68 65 72 65 20 69 73 20    (2)  There is 
1560: 61 20 73 69 6e 67 6c 65 20 67 6c 6f 62 61 6c 20  a single global 
1570: 50 47 72 6f 75 70 20 74 68 61 74 20 61 6c 6c 20  PGroup that all 
1580: 50 43 61 63 68 65 73 20 61 72 65 20 61 20 6d 65  PCaches are a me
1590: 6d 62 65 72 0a 2a 2a 20 20 20 20 20 20 20 20 6f  mber.**        o
15a0: 66 2e 0a 2a 2a 0a 2a 2a 20 4d 6f 64 65 20 31 20  f..**.** Mode 1 
15b0: 75 73 65 73 20 6d 6f 72 65 20 6d 65 6d 6f 72 79  uses more memory
15c0: 20 28 73 69 6e 63 65 20 50 43 61 63 68 65 20 69   (since PCache i
15d0: 6e 73 74 61 6e 63 65 73 20 61 72 65 20 6e 6f 74  nstances are not
15e0: 20 61 62 6c 65 20 74 6f 20 72 6f 62 0a 2a 2a 20   able to rob.** 
15f0: 75 6e 75 73 65 64 20 70 61 67 65 73 20 66 72 6f  unused pages fro
1600: 6d 20 6f 74 68 65 72 20 50 43 61 63 68 65 73 29  m other PCaches)
1610: 20 62 75 74 20 69 74 20 61 6c 73 6f 20 6f 70 65   but it also ope
1620: 72 61 74 65 73 20 77 69 74 68 6f 75 74 20 61 20  rates without a 
1630: 6d 75 74 65 78 2c 0a 2a 2a 20 61 6e 64 20 69 73  mutex,.** and is
1640: 20 74 68 65 72 65 66 6f 72 65 20 6f 66 74 65 6e   therefore often
1650: 20 66 61 73 74 65 72 2e 20 20 4d 6f 64 65 20 32   faster.  Mode 2
1660: 20 72 65 71 75 69 72 65 73 20 61 20 6d 75 74 65   requires a mute
1670: 78 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 62 65  x in order to be
1680: 0a 2a 2a 20 74 68 72 65 61 64 73 61 66 65 2c 20  .** threadsafe, 
1690: 62 75 74 20 72 65 63 79 63 6c 65 73 20 70 61 67  but recycles pag
16a0: 65 73 20 6d 6f 72 65 20 65 66 66 69 63 69 65 6e  es more efficien
16b0: 74 6c 79 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 6d  tly..**.** For m
16c0: 6f 64 65 20 28 31 29 2c 20 50 47 72 6f 75 70 2e  ode (1), PGroup.
16d0: 6d 75 74 65 78 20 69 73 20 4e 55 4c 4c 2e 20 20  mutex is NULL.  
16e0: 46 6f 72 20 6d 6f 64 65 20 28 32 29 20 74 68 65  For mode (2) the
16f0: 72 65 20 69 73 20 6f 6e 6c 79 20 61 20 73 69 6e  re is only a sin
1700: 67 6c 65 0a 2a 2a 20 50 47 72 6f 75 70 20 77 68  gle.** PGroup wh
1710: 69 63 68 20 69 73 20 74 68 65 20 70 63 61 63 68  ich is the pcach
1720: 65 31 2e 67 72 70 20 67 6c 6f 62 61 6c 20 76 61  e1.grp global va
1730: 72 69 61 62 6c 65 20 61 6e 64 20 69 74 73 20 6d  riable and its m
1740: 75 74 65 78 20 69 73 0a 2a 2a 20 53 51 4c 49 54  utex is.** SQLIT
1750: 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c  E_MUTEX_STATIC_L
1760: 52 55 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 50 47  RU..*/.struct PG
1770: 72 6f 75 70 20 7b 0a 20 20 73 71 6c 69 74 65 33  roup {.  sqlite3
1780: 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 3b 20 20  _mutex *mutex;  
1790: 20 20 20 20 20 20 20 20 2f 2a 20 4d 55 54 45 58          /* MUTEX
17a0: 5f 53 54 41 54 49 43 5f 4c 52 55 20 6f 72 20 4e  _STATIC_LRU or N
17b0: 55 4c 4c 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65  ULL */.  unsigne
17c0: 64 20 69 6e 74 20 6e 4d 61 78 50 61 67 65 3b 20  d int nMaxPage; 
17d0: 20 20 20 20 20 20 20 20 2f 2a 20 53 75 6d 20 6f          /* Sum o
17e0: 66 20 6e 4d 61 78 20 66 6f 72 20 70 75 72 67 65  f nMax for purge
17f0: 61 62 6c 65 20 63 61 63 68 65 73 20 2a 2f 0a 20  able caches */. 
1800: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 4d   unsigned int nM
1810: 69 6e 50 61 67 65 3b 20 20 20 20 20 20 20 20 20  inPage;         
1820: 2f 2a 20 53 75 6d 20 6f 66 20 6e 4d 69 6e 20 66  /* Sum of nMin f
1830: 6f 72 20 70 75 72 67 65 61 62 6c 65 20 63 61 63  or purgeable cac
1840: 68 65 73 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65  hes */.  unsigne
1850: 64 20 69 6e 74 20 6d 78 50 69 6e 6e 65 64 3b 20  d int mxPinned; 
1860: 20 20 20 20 20 20 20 20 2f 2a 20 6e 4d 61 78 70          /* nMaxp
1870: 61 67 65 20 2b 20 31 30 20 2d 20 6e 4d 69 6e 50  age + 10 - nMinP
1880: 61 67 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65  age */.  unsigne
1890: 64 20 69 6e 74 20 6e 43 75 72 72 65 6e 74 50 61  d int nCurrentPa
18a0: 67 65 3b 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65  ge;     /* Numbe
18b0: 72 20 6f 66 20 70 75 72 67 65 61 62 6c 65 20 70  r of purgeable p
18c0: 61 67 65 73 20 61 6c 6c 6f 63 61 74 65 64 20 2a  ages allocated *
18d0: 2f 0a 20 20 50 67 48 64 72 31 20 6c 72 75 3b 20  /.  PgHdr1 lru; 
18e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
18f0: 20 20 20 2f 2a 20 54 68 65 20 62 65 67 69 6e 6e     /* The beginn
1900: 69 6e 67 20 61 6e 64 20 65 6e 64 20 6f 66 20 74  ing and end of t
1910: 68 65 20 4c 52 55 20 6c 69 73 74 20 2a 2f 0a 7d  he LRU list */.}
1920: 3b 0a 0a 2f 2a 20 45 61 63 68 20 70 61 67 65 20  ;../* Each page 
1930: 63 61 63 68 65 20 69 73 20 61 6e 20 69 6e 73 74  cache is an inst
1940: 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c  ance of the foll
1950: 6f 77 69 6e 67 20 6f 62 6a 65 63 74 2e 20 20 45  owing object.  E
1960: 76 65 72 79 0a 2a 2a 20 6f 70 65 6e 20 64 61 74  very.** open dat
1970: 61 62 61 73 65 20 66 69 6c 65 20 28 69 6e 63 6c  abase file (incl
1980: 75 64 69 6e 67 20 65 61 63 68 20 69 6e 2d 6d 65  uding each in-me
1990: 6d 6f 72 79 20 64 61 74 61 62 61 73 65 20 61 6e  mory database an
19a0: 64 20 65 61 63 68 0a 2a 2a 20 74 65 6d 70 6f 72  d each.** tempor
19b0: 61 72 79 20 6f 72 20 74 72 61 6e 73 69 65 6e 74  ary or transient
19c0: 20 64 61 74 61 62 61 73 65 29 20 68 61 73 20 61   database) has a
19d0: 20 73 69 6e 67 6c 65 20 70 61 67 65 20 63 61 63   single page cac
19e0: 68 65 20 77 68 69 63 68 0a 2a 2a 20 69 73 20 61  he which.** is a
19f0: 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68  n instance of th
1a00: 69 73 20 6f 62 6a 65 63 74 2e 0a 2a 2a 0a 2a 2a  is object..**.**
1a10: 20 50 6f 69 6e 74 65 72 73 20 74 6f 20 73 74 72   Pointers to str
1a20: 75 63 74 75 72 65 73 20 6f 66 20 74 68 69 73 20  uctures of this 
1a30: 74 79 70 65 20 61 72 65 20 63 61 73 74 20 61 6e  type are cast an
1a40: 64 20 72 65 74 75 72 6e 65 64 20 61 73 20 0a 2a  d returned as .*
1a50: 2a 20 6f 70 61 71 75 65 20 73 71 6c 69 74 65 33  * opaque sqlite3
1a60: 5f 70 63 61 63 68 65 2a 20 68 61 6e 64 6c 65 73  _pcache* handles
1a70: 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 50 43 61 63  ..*/.struct PCac
1a80: 68 65 31 20 7b 0a 20 20 2f 2a 20 43 61 63 68 65  he1 {.  /* Cache
1a90: 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 70   configuration p
1aa0: 61 72 61 6d 65 74 65 72 73 2e 20 50 61 67 65 20  arameters. Page 
1ab0: 73 69 7a 65 20 28 73 7a 50 61 67 65 29 20 61 6e  size (szPage) an
1ac0: 64 20 74 68 65 20 70 75 72 67 65 61 62 6c 65 0a  d the purgeable.
1ad0: 20 20 2a 2a 20 66 6c 61 67 20 28 62 50 75 72 67    ** flag (bPurg
1ae0: 65 61 62 6c 65 29 20 61 72 65 20 73 65 74 20 77  eable) are set w
1af0: 68 65 6e 20 74 68 65 20 63 61 63 68 65 20 69 73  hen the cache is
1b00: 20 63 72 65 61 74 65 64 2e 20 6e 4d 61 78 20 6d   created. nMax m
1b10: 61 79 20 62 65 20 0a 20 20 2a 2a 20 6d 6f 64 69  ay be .  ** modi
1b20: 66 69 65 64 20 61 74 20 61 6e 79 20 74 69 6d 65  fied at any time
1b30: 20 62 79 20 61 20 63 61 6c 6c 20 74 6f 20 74 68   by a call to th
1b40: 65 20 70 63 61 63 68 65 31 43 61 63 68 65 73 69  e pcache1Cachesi
1b50: 7a 65 28 29 20 6d 65 74 68 6f 64 2e 0a 20 20 2a  ze() method..  *
1b60: 2a 20 54 68 65 20 50 47 72 6f 75 70 20 6d 75 74  * The PGroup mut
1b70: 65 78 20 6d 75 73 74 20 62 65 20 68 65 6c 64 20  ex must be held 
1b80: 77 68 65 6e 20 61 63 63 65 73 73 69 6e 67 20 6e  when accessing n
1b90: 4d 61 78 2e 0a 20 20 2a 2f 0a 20 20 50 47 72 6f  Max..  */.  PGro
1ba0: 75 70 20 2a 70 47 72 6f 75 70 3b 20 20 20 20 20  up *pGroup;     
1bb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1bc0: 2f 2a 20 50 47 72 6f 75 70 20 74 68 69 73 20 63  /* PGroup this c
1bd0: 61 63 68 65 20 62 65 6c 6f 6e 67 73 20 74 6f 20  ache belongs to 
1be0: 2a 2f 0a 20 20 69 6e 74 20 73 7a 50 61 67 65 3b  */.  int szPage;
1bf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1c00: 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65           /* Size
1c10: 20 6f 66 20 64 61 74 61 62 61 73 65 20 63 6f 6e   of database con
1c20: 74 65 6e 74 20 73 65 63 74 69 6f 6e 20 2a 2f 0a  tent section */.
1c30: 20 20 69 6e 74 20 73 7a 45 78 74 72 61 3b 20 20    int szExtra;  
1c40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1c50: 20 20 20 20 20 20 2f 2a 20 73 69 7a 65 6f 66 28        /* sizeof(
1c60: 4d 65 6d 50 61 67 65 29 2b 73 69 7a 65 6f 66 28  MemPage)+sizeof(
1c70: 50 67 48 64 72 29 20 2a 2f 0a 20 20 69 6e 74 20  PgHdr) */.  int 
1c80: 73 7a 41 6c 6c 6f 63 3b 20 20 20 20 20 20 20 20  szAlloc;        
1c90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1ca0: 2f 2a 20 54 6f 74 61 6c 20 73 69 7a 65 20 6f 66  /* Total size of
1cb0: 20 6f 6e 65 20 70 63 61 63 68 65 20 6c 69 6e 65   one pcache line
1cc0: 20 2a 2f 0a 20 20 69 6e 74 20 62 50 75 72 67 65   */.  int bPurge
1cd0: 61 62 6c 65 3b 20 20 20 20 20 20 20 20 20 20 20  able;           
1ce0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75            /* Tru
1cf0: 65 20 69 66 20 63 61 63 68 65 20 69 73 20 70 75  e if cache is pu
1d00: 72 67 65 61 62 6c 65 20 2a 2f 0a 20 20 75 6e 73  rgeable */.  uns
1d10: 69 67 6e 65 64 20 69 6e 74 20 6e 4d 69 6e 3b 20  igned int nMin; 
1d20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1d30: 20 2f 2a 20 4d 69 6e 69 6d 75 6d 20 6e 75 6d 62   /* Minimum numb
1d40: 65 72 20 6f 66 20 70 61 67 65 73 20 72 65 73 65  er of pages rese
1d50: 72 76 65 64 20 2a 2f 0a 20 20 75 6e 73 69 67 6e  rved */.  unsign
1d60: 65 64 20 69 6e 74 20 6e 4d 61 78 3b 20 20 20 20  ed int nMax;    
1d70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
1d80: 20 43 6f 6e 66 69 67 75 72 65 64 20 22 63 61 63   Configured "cac
1d90: 68 65 5f 73 69 7a 65 22 20 76 61 6c 75 65 20 2a  he_size" value *
1da0: 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74  /.  unsigned int
1db0: 20 6e 39 30 70 63 74 3b 20 20 20 20 20 20 20 20   n90pct;        
1dc0: 20 20 20 20 20 20 20 20 2f 2a 20 6e 4d 61 78 2a          /* nMax*
1dd0: 39 2f 31 30 20 2a 2f 0a 20 20 75 6e 73 69 67 6e  9/10 */.  unsign
1de0: 65 64 20 69 6e 74 20 69 4d 61 78 4b 65 79 3b 20  ed int iMaxKey; 
1df0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
1e00: 20 4c 61 72 67 65 73 74 20 6b 65 79 20 73 65 65   Largest key see
1e10: 6e 20 73 69 6e 63 65 20 78 54 72 75 6e 63 61 74  n since xTruncat
1e20: 65 28 29 20 2a 2f 0a 0a 20 20 2f 2a 20 48 61 73  e() */..  /* Has
1e30: 68 20 74 61 62 6c 65 20 6f 66 20 61 6c 6c 20 70  h table of all p
1e40: 61 67 65 73 2e 20 54 68 65 20 66 6f 6c 6c 6f 77  ages. The follow
1e50: 69 6e 67 20 76 61 72 69 61 62 6c 65 73 20 6d 61  ing variables ma
1e60: 79 20 6f 6e 6c 79 20 62 65 20 61 63 63 65 73 73  y only be access
1e70: 65 64 0a 20 20 2a 2a 20 77 68 65 6e 20 74 68 65  ed.  ** when the
1e80: 20 61 63 63 65 73 73 6f 72 20 69 73 20 68 6f 6c   accessor is hol
1e90: 64 69 6e 67 20 74 68 65 20 50 47 72 6f 75 70 20  ding the PGroup 
1ea0: 6d 75 74 65 78 2e 0a 20 20 2a 2f 0a 20 20 75 6e  mutex..  */.  un
1eb0: 73 69 67 6e 65 64 20 69 6e 74 20 6e 52 65 63 79  signed int nRecy
1ec0: 63 6c 61 62 6c 65 3b 20 20 20 20 20 20 20 20 20  clable;         
1ed0: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70    /* Number of p
1ee0: 61 67 65 73 20 69 6e 20 74 68 65 20 4c 52 55 20  ages in the LRU 
1ef0: 6c 69 73 74 20 2a 2f 0a 20 20 75 6e 73 69 67 6e  list */.  unsign
1f00: 65 64 20 69 6e 74 20 6e 50 61 67 65 3b 20 20 20  ed int nPage;   
1f10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
1f20: 20 54 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66   Total number of
1f30: 20 70 61 67 65 73 20 69 6e 20 61 70 48 61 73 68   pages in apHash
1f40: 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69   */.  unsigned i
1f50: 6e 74 20 6e 48 61 73 68 3b 20 20 20 20 20 20 20  nt nHash;       
1f60: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d            /* Num
1f70: 62 65 72 20 6f 66 20 73 6c 6f 74 73 20 69 6e 20  ber of slots in 
1f80: 61 70 48 61 73 68 5b 5d 20 2a 2f 0a 20 20 50 67  apHash[] */.  Pg
1f90: 48 64 72 31 20 2a 2a 61 70 48 61 73 68 3b 20 20  Hdr1 **apHash;  
1fa0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1fb0: 20 20 2f 2a 20 48 61 73 68 20 74 61 62 6c 65 20    /* Hash table 
1fc0: 66 6f 72 20 66 61 73 74 20 6c 6f 6f 6b 75 70 20  for fast lookup 
1fd0: 62 79 20 6b 65 79 20 2a 2f 0a 20 20 50 67 48 64  by key */.  PgHd
1fe0: 72 31 20 2a 70 46 72 65 65 3b 20 20 20 20 20 20  r1 *pFree;      
1ff0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2000: 2f 2a 20 4c 69 73 74 20 6f 66 20 75 6e 75 73 65  /* List of unuse
2010: 64 20 70 63 61 63 68 65 2d 6c 6f 63 61 6c 20 70  d pcache-local p
2020: 61 67 65 73 20 2a 2f 0a 20 20 76 6f 69 64 20 2a  ages */.  void *
2030: 70 42 75 6c 6b 3b 20 20 20 20 20 20 20 20 20 20  pBulk;          
2040: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
2050: 20 42 75 6c 6b 20 6d 65 6d 6f 72 79 20 75 73 65   Bulk memory use
2060: 64 20 62 79 20 70 63 61 63 68 65 2d 6c 6f 63 61  d by pcache-loca
2070: 6c 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 46  l */.};../*.** F
2080: 72 65 65 20 73 6c 6f 74 73 20 69 6e 20 74 68 65  ree slots in the
2090: 20 61 6c 6c 6f 63 61 74 6f 72 20 75 73 65 64 20   allocator used 
20a0: 74 6f 20 64 69 76 69 64 65 20 75 70 20 74 68 65  to divide up the
20b0: 20 67 6c 6f 62 61 6c 20 70 61 67 65 20 63 61 63   global page cac
20c0: 68 65 0a 2a 2a 20 62 75 66 66 65 72 20 70 72 6f  he.** buffer pro
20d0: 76 69 64 65 64 20 75 73 69 6e 67 20 74 68 65 20  vided using the 
20e0: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41  SQLITE_CONFIG_PA
20f0: 47 45 43 41 43 48 45 20 6d 65 63 68 61 6e 69 73  GECACHE mechanis
2100: 6d 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 50 67 46  m..*/.struct PgF
2110: 72 65 65 73 6c 6f 74 20 7b 0a 20 20 50 67 46 72  reeslot {.  PgFr
2120: 65 65 73 6c 6f 74 20 2a 70 4e 65 78 74 3b 20 20  eeslot *pNext;  
2130: 2f 2a 20 4e 65 78 74 20 66 72 65 65 20 73 6c 6f  /* Next free slo
2140: 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 47  t */.};../*.** G
2150: 6c 6f 62 61 6c 20 64 61 74 61 20 75 73 65 64 20  lobal data used 
2160: 62 79 20 74 68 69 73 20 63 61 63 68 65 2e 0a 2a  by this cache..*
2170: 2f 0a 73 74 61 74 69 63 20 53 51 4c 49 54 45 5f  /.static SQLITE_
2180: 57 53 44 20 73 74 72 75 63 74 20 50 43 61 63 68  WSD struct PCach
2190: 65 47 6c 6f 62 61 6c 20 7b 0a 20 20 50 47 72 6f  eGlobal {.  PGro
21a0: 75 70 20 67 72 70 3b 20 20 20 20 20 20 20 20 20  up grp;         
21b0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68             /* Th
21c0: 65 20 67 6c 6f 62 61 6c 20 50 47 72 6f 75 70 20  e global PGroup 
21d0: 66 6f 72 20 6d 6f 64 65 20 28 32 29 20 2a 2f 0a  for mode (2) */.
21e0: 0a 20 20 2f 2a 20 56 61 72 69 61 62 6c 65 73 20  .  /* Variables 
21f0: 72 65 6c 61 74 65 64 20 74 6f 20 53 51 4c 49 54  related to SQLIT
2200: 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43  E_CONFIG_PAGECAC
2210: 48 45 20 73 65 74 74 69 6e 67 73 2e 20 20 54 68  HE settings.  Th
2220: 65 0a 20 20 2a 2a 20 73 7a 53 6c 6f 74 2c 20 6e  e.  ** szSlot, n
2230: 53 6c 6f 74 2c 20 70 53 74 61 72 74 2c 20 70 45  Slot, pStart, pE
2240: 6e 64 2c 20 6e 52 65 73 65 72 76 65 2c 20 61 6e  nd, nReserve, an
2250: 64 20 69 73 49 6e 69 74 20 76 61 6c 75 65 73 20  d isInit values 
2260: 61 72 65 20 61 6c 6c 0a 20 20 2a 2a 20 66 69 78  are all.  ** fix
2270: 65 64 20 61 74 20 73 71 6c 69 74 65 33 5f 69 6e  ed at sqlite3_in
2280: 69 74 69 61 6c 69 7a 65 28 29 20 74 69 6d 65 20  itialize() time 
2290: 61 6e 64 20 64 6f 20 6e 6f 74 20 72 65 71 75 69  and do not requi
22a0: 72 65 20 6d 75 74 65 78 20 70 72 6f 74 65 63 74  re mutex protect
22b0: 69 6f 6e 2e 0a 20 20 2a 2a 20 54 68 65 20 6e 46  ion..  ** The nF
22c0: 72 65 65 53 6c 6f 74 20 61 6e 64 20 70 46 72 65  reeSlot and pFre
22d0: 65 20 76 61 6c 75 65 73 20 64 6f 20 72 65 71 75  e values do requ
22e0: 69 72 65 20 6d 75 74 65 78 20 70 72 6f 74 65 63  ire mutex protec
22f0: 74 69 6f 6e 2e 0a 20 20 2a 2f 0a 20 20 69 6e 74  tion..  */.  int
2300: 20 69 73 49 6e 69 74 3b 20 20 20 20 20 20 20 20   isInit;        
2310: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
2320: 72 75 65 20 69 66 20 69 6e 69 74 69 61 6c 69 7a  rue if initializ
2330: 65 64 20 2a 2f 0a 20 20 69 6e 74 20 73 65 70 61  ed */.  int sepa
2340: 72 61 74 65 43 61 63 68 65 3b 20 20 20 20 20 20  rateCache;      
2350: 20 20 20 20 20 20 20 2f 2a 20 55 73 65 20 61 20         /* Use a 
2360: 6e 65 77 20 50 47 72 6f 75 70 20 66 6f 72 20 65  new PGroup for e
2370: 61 63 68 20 50 43 61 63 68 65 20 2a 2f 0a 20 20  ach PCache */.  
2380: 69 6e 74 20 6e 49 6e 69 74 50 61 67 65 3b 20 20  int nInitPage;  
2390: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
23a0: 2a 20 49 6e 69 74 69 61 6c 20 62 75 6c 6b 20 61  * Initial bulk a
23b0: 6c 6c 6f 63 61 74 69 6f 6e 20 73 69 7a 65 20 2a  llocation size *
23c0: 2f 20 20 20 0a 20 20 69 6e 74 20 73 7a 53 6c 6f  /   .  int szSlo
23d0: 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  t;              
23e0: 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66        /* Size of
23f0: 20 65 61 63 68 20 66 72 65 65 20 73 6c 6f 74 20   each free slot 
2400: 2a 2f 0a 20 20 69 6e 74 20 6e 53 6c 6f 74 3b 20  */.  int nSlot; 
2410: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2420: 20 20 20 20 2f 2a 20 54 68 65 20 6e 75 6d 62 65      /* The numbe
2430: 72 20 6f 66 20 70 63 61 63 68 65 20 73 6c 6f 74  r of pcache slot
2440: 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 73 65  s */.  int nRese
2450: 72 76 65 3b 20 20 20 20 20 20 20 20 20 20 20 20  rve;            
2460: 20 20 20 20 20 20 2f 2a 20 54 72 79 20 74 6f 20        /* Try to 
2470: 6b 65 65 70 20 6e 46 72 65 65 53 6c 6f 74 20 61  keep nFreeSlot a
2480: 62 6f 76 65 20 74 68 69 73 20 2a 2f 0a 20 20 76  bove this */.  v
2490: 6f 69 64 20 2a 70 53 74 61 72 74 2c 20 2a 70 45  oid *pStart, *pE
24a0: 6e 64 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a  nd;           /*
24b0: 20 42 6f 75 6e 64 73 20 6f 66 20 67 6c 6f 62 61   Bounds of globa
24c0: 6c 20 70 61 67 65 20 63 61 63 68 65 20 6d 65 6d  l page cache mem
24d0: 6f 72 79 20 2a 2f 0a 20 20 2f 2a 20 41 62 6f 76  ory */.  /* Abov
24e0: 65 20 72 65 71 75 69 72 65 73 20 6e 6f 20 6d 75  e requires no mu
24f0: 74 65 78 2e 20 20 55 73 65 20 6d 75 74 65 78 20  tex.  Use mutex 
2500: 62 65 6c 6f 77 20 66 6f 72 20 76 61 72 69 61 62  below for variab
2510: 6c 65 20 74 68 61 74 20 66 6f 6c 6c 6f 77 2e 20  le that follow. 
2520: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  */.  sqlite3_mut
2530: 65 78 20 2a 6d 75 74 65 78 3b 20 20 20 20 20 20  ex *mutex;      
2540: 20 20 20 20 2f 2a 20 4d 75 74 65 78 20 66 6f 72      /* Mutex for
2550: 20 61 63 63 65 73 73 69 6e 67 20 74 68 65 20 66   accessing the f
2560: 6f 6c 6c 6f 77 69 6e 67 3a 20 2a 2f 0a 20 20 50  ollowing: */.  P
2570: 67 46 72 65 65 73 6c 6f 74 20 2a 70 46 72 65 65  gFreeslot *pFree
2580: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ;             /*
2590: 20 46 72 65 65 20 70 61 67 65 20 62 6c 6f 63 6b   Free page block
25a0: 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 46 72 65 65  s */.  int nFree
25b0: 53 6c 6f 74 3b 20 20 20 20 20 20 20 20 20 20 20  Slot;           
25c0: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20        /* Number 
25d0: 6f 66 20 75 6e 75 73 65 64 20 70 63 61 63 68 65  of unused pcache
25e0: 20 73 6c 6f 74 73 20 2a 2f 0a 20 20 2f 2a 20 54   slots */.  /* T
25f0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 76 61 6c  he following val
2600: 75 65 20 72 65 71 75 69 72 65 73 20 61 20 6d 75  ue requires a mu
2610: 74 65 78 20 74 6f 20 63 68 61 6e 67 65 2e 20 20  tex to change.  
2620: 57 65 20 73 6b 69 70 20 74 68 65 20 6d 75 74 65  We skip the mute
2630: 78 20 6f 6e 0a 20 20 2a 2a 20 72 65 61 64 69 6e  x on.  ** readin
2640: 67 20 62 65 63 61 75 73 65 20 28 31 29 20 6d 6f  g because (1) mo
2650: 73 74 20 70 6c 61 74 66 6f 72 6d 73 20 72 65 61  st platforms rea
2660: 64 20 61 20 33 32 2d 62 69 74 20 69 6e 74 65 67  d a 32-bit integ
2670: 65 72 20 61 74 6f 6d 69 63 61 6c 6c 79 20 61 6e  er atomically an
2680: 64 0a 20 20 2a 2a 20 28 32 29 20 65 76 65 6e 20  d.  ** (2) even 
2690: 69 66 20 61 6e 20 69 6e 63 6f 72 72 65 63 74 20  if an incorrect 
26a0: 76 61 6c 75 65 20 69 73 20 72 65 61 64 2c 20 6e  value is read, n
26b0: 6f 20 67 72 65 61 74 20 68 61 72 6d 20 69 73 20  o great harm is 
26c0: 64 6f 6e 65 20 73 69 6e 63 65 20 74 68 69 73 0a  done since this.
26d0: 20 20 2a 2a 20 69 73 20 72 65 61 6c 6c 79 20 6a    ** is really j
26e0: 75 73 74 20 61 6e 20 6f 70 74 69 6d 69 7a 61 74  ust an optimizat
26f0: 69 6f 6e 2e 20 2a 2f 0a 20 20 69 6e 74 20 62 55  ion. */.  int bU
2700: 6e 64 65 72 50 72 65 73 73 75 72 65 3b 20 20 20  nderPressure;   
2710: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65           /* True
2720: 20 69 66 20 6c 6f 77 20 6f 6e 20 50 41 47 45 43   if low on PAGEC
2730: 41 43 48 45 20 6d 65 6d 6f 72 79 20 2a 2f 0a 7d  ACHE memory */.}
2740: 20 70 63 61 63 68 65 31 5f 67 3b 0a 0a 2f 2a 0a   pcache1_g;../*.
2750: 2a 2a 20 41 6c 6c 20 63 6f 64 65 20 69 6e 20 74  ** All code in t
2760: 68 69 73 20 66 69 6c 65 20 73 68 6f 75 6c 64 20  his file should 
2770: 61 63 63 65 73 73 20 74 68 65 20 67 6c 6f 62 61  access the globa
2780: 6c 20 73 74 72 75 63 74 75 72 65 20 61 62 6f 76  l structure abov
2790: 65 20 76 69 61 20 74 68 65 0a 2a 2a 20 61 6c 69  e via the.** ali
27a0: 61 73 20 22 70 63 61 63 68 65 31 22 2e 20 54 68  as "pcache1". Th
27b0: 69 73 20 65 6e 73 75 72 65 73 20 74 68 61 74 20  is ensures that 
27c0: 74 68 65 20 57 53 44 20 65 6d 75 6c 61 74 69 6f  the WSD emulatio
27d0: 6e 20 69 73 20 75 73 65 64 20 77 68 65 6e 0a 2a  n is used when.*
27e0: 2a 20 63 6f 6d 70 69 6c 69 6e 67 20 66 6f 72 20  * compiling for 
27f0: 73 79 73 74 65 6d 73 20 74 68 61 74 20 64 6f 20  systems that do 
2800: 6e 6f 74 20 73 75 70 70 6f 72 74 20 72 65 61 6c  not support real
2810: 20 57 53 44 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65   WSD..*/.#define
2820: 20 70 63 61 63 68 65 31 20 28 47 4c 4f 42 41 4c   pcache1 (GLOBAL
2830: 28 73 74 72 75 63 74 20 50 43 61 63 68 65 47 6c  (struct PCacheGl
2840: 6f 62 61 6c 2c 20 70 63 61 63 68 65 31 5f 67 29  obal, pcache1_g)
2850: 29 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72 6f 73 20  )../*.** Macros 
2860: 74 6f 20 65 6e 74 65 72 20 61 6e 64 20 6c 65 61  to enter and lea
2870: 76 65 20 74 68 65 20 50 43 61 63 68 65 20 4c 52  ve the PCache LR
2880: 55 20 6d 75 74 65 78 2e 0a 2a 2f 0a 23 69 66 20  U mutex..*/.#if 
2890: 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f  !defined(SQLITE_
28a0: 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41  ENABLE_MEMORY_MA
28b0: 4e 41 47 45 4d 45 4e 54 29 20 7c 7c 20 53 51 4c  NAGEMENT) || SQL
28c0: 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d 3d  ITE_THREADSAFE==
28d0: 30 0a 23 20 64 65 66 69 6e 65 20 70 63 61 63 68  0.# define pcach
28e0: 65 31 45 6e 74 65 72 4d 75 74 65 78 28 58 29 20  e1EnterMutex(X) 
28f0: 20 61 73 73 65 72 74 28 28 58 29 2d 3e 6d 75 74   assert((X)->mut
2900: 65 78 3d 3d 30 29 0a 23 20 64 65 66 69 6e 65 20  ex==0).# define 
2910: 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65  pcache1LeaveMute
2920: 78 28 58 29 20 20 61 73 73 65 72 74 28 28 58 29  x(X)  assert((X)
2930: 2d 3e 6d 75 74 65 78 3d 3d 30 29 0a 23 20 64 65  ->mutex==0).# de
2940: 66 69 6e 65 20 50 43 41 43 48 45 31 5f 4d 49 47  fine PCACHE1_MIG
2950: 48 54 5f 55 53 45 5f 47 52 4f 55 50 5f 4d 55 54  HT_USE_GROUP_MUT
2960: 45 58 20 30 0a 23 65 6c 73 65 0a 23 20 64 65 66  EX 0.#else.# def
2970: 69 6e 65 20 70 63 61 63 68 65 31 45 6e 74 65 72  ine pcache1Enter
2980: 4d 75 74 65 78 28 58 29 20 73 71 6c 69 74 65 33  Mutex(X) sqlite3
2990: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 28 58 29  _mutex_enter((X)
29a0: 2d 3e 6d 75 74 65 78 29 0a 23 20 64 65 66 69 6e  ->mutex).# defin
29b0: 65 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75  e pcache1LeaveMu
29c0: 74 65 78 28 58 29 20 73 71 6c 69 74 65 33 5f 6d  tex(X) sqlite3_m
29d0: 75 74 65 78 5f 6c 65 61 76 65 28 28 58 29 2d 3e  utex_leave((X)->
29e0: 6d 75 74 65 78 29 0a 23 20 64 65 66 69 6e 65 20  mutex).# define 
29f0: 50 43 41 43 48 45 31 5f 4d 49 47 48 54 5f 55 53  PCACHE1_MIGHT_US
2a00: 45 5f 47 52 4f 55 50 5f 4d 55 54 45 58 20 31 0a  E_GROUP_MUTEX 1.
2a10: 23 65 6e 64 69 66 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a  #endif../*******
2a20: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2a30: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2a40: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2a50: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2a60: 2a 2a 2a 2a 2a 2a 2a 2f 0a 2f 2a 2a 2a 2a 2a 2a  *******/./******
2a70: 2a 2a 20 50 61 67 65 20 41 6c 6c 6f 63 61 74 69  ** Page Allocati
2a80: 6f 6e 2f 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47  on/SQLITE_CONFIG
2a90: 5f 50 43 41 43 48 45 20 52 65 6c 61 74 65 64 20  _PCACHE Related 
2aa0: 46 75 6e 63 74 69 6f 6e 73 20 2a 2a 2a 2a 2a 2a  Functions ******
2ab0: 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 0a 2f 2a 0a 2a  ********/.../*.*
2ac0: 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  * This function 
2ad0: 69 73 20 63 61 6c 6c 65 64 20 64 75 72 69 6e 67  is called during
2ae0: 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20   initialization 
2af0: 69 66 20 61 20 73 74 61 74 69 63 20 62 75 66 66  if a static buff
2b00: 65 72 20 69 73 20 0a 2a 2a 20 73 75 70 70 6c 69  er is .** suppli
2b10: 65 64 20 74 6f 20 75 73 65 20 66 6f 72 20 74 68  ed to use for th
2b20: 65 20 70 61 67 65 2d 63 61 63 68 65 20 62 79 20  e page-cache by 
2b30: 70 61 73 73 69 6e 67 20 74 68 65 20 53 51 4c 49  passing the SQLI
2b40: 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41  TE_CONFIG_PAGECA
2b50: 43 48 45 0a 2a 2a 20 76 65 72 62 20 74 6f 20 73  CHE.** verb to s
2b60: 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 29 2e  qlite3_config().
2b70: 20 50 61 72 61 6d 65 74 65 72 20 70 42 75 66 20   Parameter pBuf 
2b80: 70 6f 69 6e 74 73 20 74 6f 20 61 6e 20 61 6c 6c  points to an all
2b90: 6f 63 61 74 69 6f 6e 20 6c 61 72 67 65 0a 2a 2a  ocation large.**
2ba0: 20 65 6e 6f 75 67 68 20 74 6f 20 63 6f 6e 74 61   enough to conta
2bb0: 69 6e 20 27 6e 27 20 62 75 66 66 65 72 73 20 6f  in 'n' buffers o
2bc0: 66 20 27 73 7a 27 20 62 79 74 65 73 20 65 61 63  f 'sz' bytes eac
2bd0: 68 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f  h..**.** This ro
2be0: 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 20  utine is called 
2bf0: 66 72 6f 6d 20 73 71 6c 69 74 65 33 5f 69 6e 69  from sqlite3_ini
2c00: 74 69 61 6c 69 7a 65 28 29 20 61 6e 64 20 73 6f  tialize() and so
2c10: 20 69 74 20 69 73 20 67 75 61 72 61 6e 74 65 65   it is guarantee
2c20: 64 0a 2a 2a 20 74 6f 20 62 65 20 73 65 72 69 61  d.** to be seria
2c30: 6c 69 7a 65 64 20 61 6c 72 65 61 64 79 2e 20 20  lized already.  
2c40: 54 68 65 72 65 20 69 73 20 6e 6f 20 6e 65 65 64  There is no need
2c50: 20 66 6f 72 20 66 75 72 74 68 65 72 20 6d 75 74   for further mut
2c60: 65 78 69 6e 67 2e 0a 2a 2f 0a 76 6f 69 64 20 73  exing..*/.void s
2c70: 71 6c 69 74 65 33 50 43 61 63 68 65 42 75 66 66  qlite3PCacheBuff
2c80: 65 72 53 65 74 75 70 28 76 6f 69 64 20 2a 70 42  erSetup(void *pB
2c90: 75 66 2c 20 69 6e 74 20 73 7a 2c 20 69 6e 74 20  uf, int sz, int 
2ca0: 6e 29 7b 0a 20 20 69 66 28 20 70 63 61 63 68 65  n){.  if( pcache
2cb0: 31 2e 69 73 49 6e 69 74 20 29 7b 0a 20 20 20 20  1.isInit ){.    
2cc0: 50 67 46 72 65 65 73 6c 6f 74 20 2a 70 3b 0a 20  PgFreeslot *p;. 
2cd0: 20 20 20 69 66 28 20 70 42 75 66 3d 3d 30 20 29     if( pBuf==0 )
2ce0: 20 73 7a 20 3d 20 6e 20 3d 20 30 3b 0a 20 20 20   sz = n = 0;.   
2cf0: 20 73 7a 20 3d 20 52 4f 55 4e 44 44 4f 57 4e 38   sz = ROUNDDOWN8
2d00: 28 73 7a 29 3b 0a 20 20 20 20 70 63 61 63 68 65  (sz);.    pcache
2d10: 31 2e 73 7a 53 6c 6f 74 20 3d 20 73 7a 3b 0a 20  1.szSlot = sz;. 
2d20: 20 20 20 70 63 61 63 68 65 31 2e 6e 53 6c 6f 74     pcache1.nSlot
2d30: 20 3d 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65   = pcache1.nFree
2d40: 53 6c 6f 74 20 3d 20 6e 3b 0a 20 20 20 20 70 63  Slot = n;.    pc
2d50: 61 63 68 65 31 2e 6e 52 65 73 65 72 76 65 20 3d  ache1.nReserve =
2d60: 20 6e 3e 39 30 20 3f 20 31 30 20 3a 20 28 6e 2f   n>90 ? 10 : (n/
2d70: 31 30 20 2b 20 31 29 3b 0a 20 20 20 20 70 63 61  10 + 1);.    pca
2d80: 63 68 65 31 2e 70 53 74 61 72 74 20 3d 20 70 42  che1.pStart = pB
2d90: 75 66 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e  uf;.    pcache1.
2da0: 70 46 72 65 65 20 3d 20 30 3b 0a 20 20 20 20 70  pFree = 0;.    p
2db0: 63 61 63 68 65 31 2e 62 55 6e 64 65 72 50 72 65  cache1.bUnderPre
2dc0: 73 73 75 72 65 20 3d 20 30 3b 0a 20 20 20 20 77  ssure = 0;.    w
2dd0: 68 69 6c 65 28 20 6e 2d 2d 20 29 7b 0a 20 20 20  hile( n-- ){.   
2de0: 20 20 20 70 20 3d 20 28 50 67 46 72 65 65 73 6c     p = (PgFreesl
2df0: 6f 74 2a 29 70 42 75 66 3b 0a 20 20 20 20 20 20  ot*)pBuf;.      
2e00: 70 2d 3e 70 4e 65 78 74 20 3d 20 70 63 61 63 68  p->pNext = pcach
2e10: 65 31 2e 70 46 72 65 65 3b 0a 20 20 20 20 20 20  e1.pFree;.      
2e20: 70 63 61 63 68 65 31 2e 70 46 72 65 65 20 3d 20  pcache1.pFree = 
2e30: 70 3b 0a 20 20 20 20 20 20 70 42 75 66 20 3d 20  p;.      pBuf = 
2e40: 28 76 6f 69 64 2a 29 26 28 28 63 68 61 72 2a 29  (void*)&((char*)
2e50: 70 42 75 66 29 5b 73 7a 5d 3b 0a 20 20 20 20 7d  pBuf)[sz];.    }
2e60: 0a 20 20 20 20 70 63 61 63 68 65 31 2e 70 45 6e  .    pcache1.pEn
2e70: 64 20 3d 20 70 42 75 66 3b 0a 20 20 7d 0a 7d 0a  d = pBuf;.  }.}.
2e80: 0a 2f 2a 0a 2a 2a 20 54 72 79 20 74 6f 20 69 6e  ./*.** Try to in
2e90: 69 74 69 61 6c 69 7a 65 20 74 68 65 20 70 43 61  itialize the pCa
2ea0: 63 68 65 2d 3e 70 46 72 65 65 20 61 6e 64 20 70  che->pFree and p
2eb0: 43 61 63 68 65 2d 3e 70 42 75 6c 6b 20 66 69 65  Cache->pBulk fie
2ec0: 6c 64 73 2e 20 20 52 65 74 75 72 6e 0a 2a 2a 20  lds.  Return.** 
2ed0: 74 72 75 65 20 69 66 20 70 43 61 63 68 65 2d 3e  true if pCache->
2ee0: 70 46 72 65 65 20 65 6e 64 73 20 75 70 20 63 6f  pFree ends up co
2ef0: 6e 74 61 69 6e 69 6e 67 20 6f 6e 65 20 6f 72 20  ntaining one or 
2f00: 6d 6f 72 65 20 66 72 65 65 20 70 61 67 65 73 2e  more free pages.
2f10: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70  .*/.static int p
2f20: 63 61 63 68 65 31 49 6e 69 74 42 75 6c 6b 28 50  cache1InitBulk(P
2f30: 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 29 7b  Cache1 *pCache){
2f40: 0a 20 20 69 36 34 20 73 7a 42 75 6c 6b 3b 0a 20  .  i64 szBulk;. 
2f50: 20 63 68 61 72 20 2a 7a 42 75 6c 6b 3b 0a 20 20   char *zBulk;.  
2f60: 69 66 28 20 70 63 61 63 68 65 31 2e 6e 49 6e 69  if( pcache1.nIni
2f70: 74 50 61 67 65 3d 3d 30 20 29 20 72 65 74 75 72  tPage==0 ) retur
2f80: 6e 20 30 3b 0a 20 20 2f 2a 20 44 6f 20 6e 6f 74  n 0;.  /* Do not
2f90: 20 62 6f 74 68 65 72 20 77 69 74 68 20 61 20 62   bother with a b
2fa0: 75 6c 6b 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69  ulk allocation i
2fb0: 66 20 74 68 65 20 63 61 63 68 65 20 73 69 7a 65  f the cache size
2fc0: 20 76 65 72 79 20 73 6d 61 6c 6c 20 2a 2f 0a 20   very small */. 
2fd0: 20 69 66 28 20 70 43 61 63 68 65 2d 3e 6e 4d 61   if( pCache->nMa
2fe0: 78 3c 33 20 29 20 72 65 74 75 72 6e 20 30 3b 0a  x<3 ) return 0;.
2ff0: 20 20 73 71 6c 69 74 65 33 42 65 67 69 6e 42 65    sqlite3BeginBe
3000: 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20  nignMalloc();.  
3010: 69 66 28 20 70 63 61 63 68 65 31 2e 6e 49 6e 69  if( pcache1.nIni
3020: 74 50 61 67 65 3e 30 20 29 7b 0a 20 20 20 20 73  tPage>0 ){.    s
3030: 7a 42 75 6c 6b 20 3d 20 70 43 61 63 68 65 2d 3e  zBulk = pCache->
3040: 73 7a 41 6c 6c 6f 63 20 2a 20 28 69 36 34 29 70  szAlloc * (i64)p
3050: 63 61 63 68 65 31 2e 6e 49 6e 69 74 50 61 67 65  cache1.nInitPage
3060: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73  ;.  }else{.    s
3070: 7a 42 75 6c 6b 20 3d 20 2d 31 30 32 34 20 2a 20  zBulk = -1024 * 
3080: 28 69 36 34 29 70 63 61 63 68 65 31 2e 6e 49 6e  (i64)pcache1.nIn
3090: 69 74 50 61 67 65 3b 0a 20 20 7d 0a 20 20 69 66  itPage;.  }.  if
30a0: 28 20 73 7a 42 75 6c 6b 20 3e 20 70 43 61 63 68  ( szBulk > pCach
30b0: 65 2d 3e 73 7a 41 6c 6c 6f 63 2a 28 69 36 34 29  e->szAlloc*(i64)
30c0: 70 43 61 63 68 65 2d 3e 6e 4d 61 78 20 29 7b 0a  pCache->nMax ){.
30d0: 20 20 20 20 73 7a 42 75 6c 6b 20 3d 20 70 43 61      szBulk = pCa
30e0: 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63 2a 28 69 36  che->szAlloc*(i6
30f0: 34 29 70 43 61 63 68 65 2d 3e 6e 4d 61 78 3b 0a  4)pCache->nMax;.
3100: 20 20 7d 0a 20 20 7a 42 75 6c 6b 20 3d 20 70 43    }.  zBulk = pC
3110: 61 63 68 65 2d 3e 70 42 75 6c 6b 20 3d 20 73 71  ache->pBulk = sq
3120: 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 20 73 7a 42  lite3Malloc( szB
3130: 75 6c 6b 20 29 3b 0a 20 20 73 71 6c 69 74 65 33  ulk );.  sqlite3
3140: 45 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28  EndBenignMalloc(
3150: 29 3b 0a 20 20 69 66 28 20 7a 42 75 6c 6b 20 29  );.  if( zBulk )
3160: 7b 0a 20 20 20 20 69 6e 74 20 6e 42 75 6c 6b 20  {.    int nBulk 
3170: 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53  = sqlite3MallocS
3180: 69 7a 65 28 7a 42 75 6c 6b 29 2f 70 43 61 63 68  ize(zBulk)/pCach
3190: 65 2d 3e 73 7a 41 6c 6c 6f 63 3b 0a 20 20 20 20  e->szAlloc;.    
31a0: 69 6e 74 20 69 3b 0a 20 20 20 20 66 6f 72 28 69  int i;.    for(i
31b0: 3d 30 3b 20 69 3c 6e 42 75 6c 6b 3b 20 69 2b 2b  =0; i<nBulk; i++
31c0: 29 7b 0a 20 20 20 20 20 20 50 67 48 64 72 31 20  ){.      PgHdr1 
31d0: 2a 70 58 20 3d 20 28 50 67 48 64 72 31 2a 29 26  *pX = (PgHdr1*)&
31e0: 7a 42 75 6c 6b 5b 70 43 61 63 68 65 2d 3e 73 7a  zBulk[pCache->sz
31f0: 50 61 67 65 5d 3b 0a 20 20 20 20 20 20 70 58 2d  Page];.      pX-
3200: 3e 70 61 67 65 2e 70 42 75 66 20 3d 20 7a 42 75  >page.pBuf = zBu
3210: 6c 6b 3b 0a 20 20 20 20 20 20 70 58 2d 3e 70 61  lk;.      pX->pa
3220: 67 65 2e 70 45 78 74 72 61 20 3d 20 26 70 58 5b  ge.pExtra = &pX[
3230: 31 5d 3b 0a 20 20 20 20 20 20 70 58 2d 3e 69 73  1];.      pX->is
3240: 42 75 6c 6b 4c 6f 63 61 6c 20 3d 20 31 3b 0a 20  BulkLocal = 1;. 
3250: 20 20 20 20 20 70 58 2d 3e 69 73 41 6e 63 68 6f       pX->isAncho
3260: 72 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 58 2d  r = 0;.      pX-
3270: 3e 70 4e 65 78 74 20 3d 20 70 43 61 63 68 65 2d  >pNext = pCache-
3280: 3e 70 46 72 65 65 3b 0a 20 20 20 20 20 20 70 43  >pFree;.      pC
3290: 61 63 68 65 2d 3e 70 46 72 65 65 20 3d 20 70 58  ache->pFree = pX
32a0: 3b 0a 20 20 20 20 20 20 7a 42 75 6c 6b 20 2b 3d  ;.      zBulk +=
32b0: 20 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63   pCache->szAlloc
32c0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65  ;.    }.  }.  re
32d0: 74 75 72 6e 20 70 43 61 63 68 65 2d 3e 70 46 72  turn pCache->pFr
32e0: 65 65 21 3d 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  ee!=0;.}../*.** 
32f0: 4d 61 6c 6c 6f 63 20 66 75 6e 63 74 69 6f 6e 20  Malloc function 
3300: 75 73 65 64 20 77 69 74 68 69 6e 20 74 68 69 73  used within this
3310: 20 66 69 6c 65 20 74 6f 20 61 6c 6c 6f 63 61 74   file to allocat
3320: 65 20 73 70 61 63 65 20 66 72 6f 6d 20 74 68 65  e space from the
3330: 20 62 75 66 66 65 72 0a 2a 2a 20 63 6f 6e 66 69   buffer.** confi
3340: 67 75 72 65 64 20 75 73 69 6e 67 20 73 71 6c 69  gured using sqli
3350: 74 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54  te3_config(SQLIT
3360: 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43  E_CONFIG_PAGECAC
3370: 48 45 29 20 6f 70 74 69 6f 6e 2e 20 49 66 20 6e  HE) option. If n
3380: 6f 20 0a 2a 2a 20 73 75 63 68 20 62 75 66 66 65  o .** such buffe
3390: 72 20 65 78 69 73 74 73 20 6f 72 20 74 68 65 72  r exists or ther
33a0: 65 20 69 73 20 6e 6f 20 73 70 61 63 65 20 6c 65  e is no space le
33b0: 66 74 20 69 6e 20 69 74 2c 20 74 68 69 73 20 66  ft in it, this f
33c0: 75 6e 63 74 69 6f 6e 20 66 61 6c 6c 73 20 0a 2a  unction falls .*
33d0: 2a 20 62 61 63 6b 20 74 6f 20 73 71 6c 69 74 65  * back to sqlite
33e0: 33 4d 61 6c 6c 6f 63 28 29 2e 0a 2a 2a 0a 2a 2a  3Malloc()..**.**
33f0: 20 4d 75 6c 74 69 70 6c 65 20 74 68 72 65 61 64   Multiple thread
3400: 73 20 63 61 6e 20 72 75 6e 20 74 68 69 73 20 72  s can run this r
3410: 6f 75 74 69 6e 65 20 61 74 20 74 68 65 20 73 61  outine at the sa
3420: 6d 65 20 74 69 6d 65 2e 20 20 47 6c 6f 62 61 6c  me time.  Global
3430: 20 76 61 72 69 61 62 6c 65 73 0a 2a 2a 20 69 6e   variables.** in
3440: 20 70 63 61 63 68 65 31 20 6e 65 65 64 20 74 6f   pcache1 need to
3450: 20 62 65 20 70 72 6f 74 65 63 74 65 64 20 76 69   be protected vi
3460: 61 20 6d 75 74 65 78 2e 0a 2a 2f 0a 73 74 61 74  a mutex..*/.stat
3470: 69 63 20 76 6f 69 64 20 2a 70 63 61 63 68 65 31  ic void *pcache1
3480: 41 6c 6c 6f 63 28 69 6e 74 20 6e 42 79 74 65 29  Alloc(int nByte)
3490: 7b 0a 20 20 76 6f 69 64 20 2a 70 20 3d 20 30 3b  {.  void *p = 0;
34a0: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74  .  assert( sqlit
34b0: 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c 64  e3_mutex_notheld
34c0: 28 70 63 61 63 68 65 31 2e 67 72 70 2e 6d 75 74  (pcache1.grp.mut
34d0: 65 78 29 20 29 3b 0a 20 20 69 66 28 20 6e 42 79  ex) );.  if( nBy
34e0: 74 65 3c 3d 70 63 61 63 68 65 31 2e 73 7a 53 6c  te<=pcache1.szSl
34f0: 6f 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  ot ){.    sqlite
3500: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 63  3_mutex_enter(pc
3510: 61 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20  ache1.mutex);.  
3520: 20 20 70 20 3d 20 28 50 67 48 64 72 31 20 2a 29    p = (PgHdr1 *)
3530: 70 63 61 63 68 65 31 2e 70 46 72 65 65 3b 0a 20  pcache1.pFree;. 
3540: 20 20 20 69 66 28 20 70 20 29 7b 0a 20 20 20 20     if( p ){.    
3550: 20 20 70 63 61 63 68 65 31 2e 70 46 72 65 65 20    pcache1.pFree 
3560: 3d 20 70 63 61 63 68 65 31 2e 70 46 72 65 65 2d  = pcache1.pFree-
3570: 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 70 63  >pNext;.      pc
3580: 61 63 68 65 31 2e 6e 46 72 65 65 53 6c 6f 74 2d  ache1.nFreeSlot-
3590: 2d 3b 0a 20 20 20 20 20 20 70 63 61 63 68 65 31  -;.      pcache1
35a0: 2e 62 55 6e 64 65 72 50 72 65 73 73 75 72 65 20  .bUnderPressure 
35b0: 3d 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65 53  = pcache1.nFreeS
35c0: 6c 6f 74 3c 70 63 61 63 68 65 31 2e 6e 52 65 73  lot<pcache1.nRes
35d0: 65 72 76 65 3b 0a 20 20 20 20 20 20 61 73 73 65  erve;.      asse
35e0: 72 74 28 20 70 63 61 63 68 65 31 2e 6e 46 72 65  rt( pcache1.nFre
35f0: 65 53 6c 6f 74 3e 3d 30 20 29 3b 0a 20 20 20 20  eSlot>=0 );.    
3600: 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 48    sqlite3StatusH
3610: 69 67 68 77 61 74 65 72 28 53 51 4c 49 54 45 5f  ighwater(SQLITE_
3620: 53 54 41 54 55 53 5f 50 41 47 45 43 41 43 48 45  STATUS_PAGECACHE
3630: 5f 53 49 5a 45 2c 20 6e 42 79 74 65 29 3b 0a 20  _SIZE, nByte);. 
3640: 20 20 20 20 20 73 71 6c 69 74 65 33 53 74 61 74       sqlite3Stat
3650: 75 73 55 70 28 53 51 4c 49 54 45 5f 53 54 41 54  usUp(SQLITE_STAT
3660: 55 53 5f 50 41 47 45 43 41 43 48 45 5f 55 53 45  US_PAGECACHE_USE
3670: 44 2c 20 31 29 3b 0a 20 20 20 20 7d 0a 20 20 20  D, 1);.    }.   
3680: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c   sqlite3_mutex_l
3690: 65 61 76 65 28 70 63 61 63 68 65 31 2e 6d 75 74  eave(pcache1.mut
36a0: 65 78 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70  ex);.  }.  if( p
36b0: 3d 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 20 4d 65  ==0 ){.    /* Me
36c0: 6d 6f 72 79 20 69 73 20 6e 6f 74 20 61 76 61 69  mory is not avai
36d0: 6c 61 62 6c 65 20 69 6e 20 74 68 65 20 53 51 4c  lable in the SQL
36e0: 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43  ITE_CONFIG_PAGEC
36f0: 41 43 48 45 20 70 6f 6f 6c 2e 20 20 47 65 74 0a  ACHE pool.  Get.
3700: 20 20 20 20 2a 2a 20 69 74 20 66 72 6f 6d 20 73      ** it from s
3710: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 20 69 6e 73  qlite3Malloc ins
3720: 74 65 61 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20  tead..    */.   
3730: 20 70 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c   p = sqlite3Mall
3740: 6f 63 28 6e 42 79 74 65 29 3b 0a 23 69 66 6e 64  oc(nByte);.#ifnd
3750: 65 66 20 53 51 4c 49 54 45 5f 44 49 53 41 42 4c  ef SQLITE_DISABL
3760: 45 5f 50 41 47 45 43 41 43 48 45 5f 4f 56 45 52  E_PAGECACHE_OVER
3770: 46 4c 4f 57 5f 53 54 41 54 53 0a 20 20 20 20 69  FLOW_STATS.    i
3780: 66 28 20 70 20 29 7b 0a 20 20 20 20 20 20 69 6e  f( p ){.      in
3790: 74 20 73 7a 20 3d 20 73 71 6c 69 74 65 33 4d 61  t sz = sqlite3Ma
37a0: 6c 6c 6f 63 53 69 7a 65 28 70 29 3b 0a 20 20 20  llocSize(p);.   
37b0: 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78     sqlite3_mutex
37c0: 5f 65 6e 74 65 72 28 70 63 61 63 68 65 31 2e 6d  _enter(pcache1.m
37d0: 75 74 65 78 29 3b 0a 20 20 20 20 20 20 73 71 6c  utex);.      sql
37e0: 69 74 65 33 53 74 61 74 75 73 48 69 67 68 77 61  ite3StatusHighwa
37f0: 74 65 72 28 53 51 4c 49 54 45 5f 53 54 41 54 55  ter(SQLITE_STATU
3800: 53 5f 50 41 47 45 43 41 43 48 45 5f 53 49 5a 45  S_PAGECACHE_SIZE
3810: 2c 20 6e 42 79 74 65 29 3b 0a 20 20 20 20 20 20  , nByte);.      
3820: 73 71 6c 69 74 65 33 53 74 61 74 75 73 55 70 28  sqlite3StatusUp(
3830: 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 50 41  SQLITE_STATUS_PA
3840: 47 45 43 41 43 48 45 5f 4f 56 45 52 46 4c 4f 57  GECACHE_OVERFLOW
3850: 2c 20 73 7a 29 3b 0a 20 20 20 20 20 20 73 71 6c  , sz);.      sql
3860: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65  ite3_mutex_leave
3870: 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29 3b  (pcache1.mutex);
3880: 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20  .    }.#endif.  
3890: 20 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75    sqlite3Memdebu
38a0: 67 53 65 74 54 79 70 65 28 70 2c 20 4d 45 4d 54  gSetType(p, MEMT
38b0: 59 50 45 5f 50 43 41 43 48 45 29 3b 0a 20 20 7d  YPE_PCACHE);.  }
38c0: 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a  .  return p;.}..
38d0: 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 6e 20 61 6c  /*.** Free an al
38e0: 6c 6f 63 61 74 65 64 20 62 75 66 66 65 72 20 6f  located buffer o
38f0: 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 70 63 61  btained from pca
3900: 63 68 65 31 41 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a  che1Alloc()..*/.
3910: 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63  static void pcac
3920: 68 65 31 46 72 65 65 28 76 6f 69 64 20 2a 70 29  he1Free(void *p)
3930: 7b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20 72  {.  if( p==0 ) r
3940: 65 74 75 72 6e 3b 0a 20 20 69 66 28 20 53 51 4c  eturn;.  if( SQL
3950: 49 54 45 5f 57 49 54 48 49 4e 28 70 2c 20 70 63  ITE_WITHIN(p, pc
3960: 61 63 68 65 31 2e 70 53 74 61 72 74 2c 20 70 63  ache1.pStart, pc
3970: 61 63 68 65 31 2e 70 45 6e 64 29 20 29 7b 0a 20  ache1.pEnd) ){. 
3980: 20 20 20 50 67 46 72 65 65 73 6c 6f 74 20 2a 70     PgFreeslot *p
3990: 53 6c 6f 74 3b 0a 20 20 20 20 73 71 6c 69 74 65  Slot;.    sqlite
39a0: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 63  3_mutex_enter(pc
39b0: 61 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20  ache1.mutex);.  
39c0: 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 44    sqlite3StatusD
39d0: 6f 77 6e 28 53 51 4c 49 54 45 5f 53 54 41 54 55  own(SQLITE_STATU
39e0: 53 5f 50 41 47 45 43 41 43 48 45 5f 55 53 45 44  S_PAGECACHE_USED
39f0: 2c 20 31 29 3b 0a 20 20 20 20 70 53 6c 6f 74 20  , 1);.    pSlot 
3a00: 3d 20 28 50 67 46 72 65 65 73 6c 6f 74 2a 29 70  = (PgFreeslot*)p
3a10: 3b 0a 20 20 20 20 70 53 6c 6f 74 2d 3e 70 4e 65  ;.    pSlot->pNe
3a20: 78 74 20 3d 20 70 63 61 63 68 65 31 2e 70 46 72  xt = pcache1.pFr
3a30: 65 65 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e  ee;.    pcache1.
3a40: 70 46 72 65 65 20 3d 20 70 53 6c 6f 74 3b 0a 20  pFree = pSlot;. 
3a50: 20 20 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65     pcache1.nFree
3a60: 53 6c 6f 74 2b 2b 3b 0a 20 20 20 20 70 63 61 63  Slot++;.    pcac
3a70: 68 65 31 2e 62 55 6e 64 65 72 50 72 65 73 73 75  he1.bUnderPressu
3a80: 72 65 20 3d 20 70 63 61 63 68 65 31 2e 6e 46 72  re = pcache1.nFr
3a90: 65 65 53 6c 6f 74 3c 70 63 61 63 68 65 31 2e 6e  eeSlot<pcache1.n
3aa0: 52 65 73 65 72 76 65 3b 0a 20 20 20 20 61 73 73  Reserve;.    ass
3ab0: 65 72 74 28 20 70 63 61 63 68 65 31 2e 6e 46 72  ert( pcache1.nFr
3ac0: 65 65 53 6c 6f 74 3c 3d 70 63 61 63 68 65 31 2e  eeSlot<=pcache1.
3ad0: 6e 53 6c 6f 74 20 29 3b 0a 20 20 20 20 73 71 6c  nSlot );.    sql
3ae0: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65  ite3_mutex_leave
3af0: 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29 3b  (pcache1.mutex);
3b00: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73  .  }else{.    as
3b10: 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d 65 6d  sert( sqlite3Mem
3b20: 64 65 62 75 67 48 61 73 54 79 70 65 28 70 2c 20  debugHasType(p, 
3b30: 4d 45 4d 54 59 50 45 5f 50 43 41 43 48 45 29 20  MEMTYPE_PCACHE) 
3b40: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 4d 65  );.    sqlite3Me
3b50: 6d 64 65 62 75 67 53 65 74 54 79 70 65 28 70 2c  mdebugSetType(p,
3b60: 20 4d 45 4d 54 59 50 45 5f 48 45 41 50 29 3b 0a   MEMTYPE_HEAP);.
3b70: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 44  #ifndef SQLITE_D
3b80: 49 53 41 42 4c 45 5f 50 41 47 45 43 41 43 48 45  ISABLE_PAGECACHE
3b90: 5f 4f 56 45 52 46 4c 4f 57 5f 53 54 41 54 53 0a  _OVERFLOW_STATS.
3ba0: 20 20 20 20 7b 0a 20 20 20 20 20 20 69 6e 74 20      {.      int 
3bb0: 6e 46 72 65 65 64 20 3d 20 30 3b 0a 20 20 20 20  nFreed = 0;.    
3bc0: 20 20 6e 46 72 65 65 64 20 3d 20 73 71 6c 69 74    nFreed = sqlit
3bd0: 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 29 3b  e3MallocSize(p);
3be0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d  .      sqlite3_m
3bf0: 75 74 65 78 5f 65 6e 74 65 72 28 70 63 61 63 68  utex_enter(pcach
3c00: 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 20  e1.mutex);.     
3c10: 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 44 6f   sqlite3StatusDo
3c20: 77 6e 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53  wn(SQLITE_STATUS
3c30: 5f 50 41 47 45 43 41 43 48 45 5f 4f 56 45 52 46  _PAGECACHE_OVERF
3c40: 4c 4f 57 2c 20 6e 46 72 65 65 64 29 3b 0a 20 20  LOW, nFreed);.  
3c50: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65      sqlite3_mute
3c60: 78 5f 6c 65 61 76 65 28 70 63 61 63 68 65 31 2e  x_leave(pcache1.
3c70: 6d 75 74 65 78 29 3b 0a 20 20 20 20 7d 0a 23 65  mutex);.    }.#e
3c80: 6e 64 69 66 0a 20 20 20 20 73 71 6c 69 74 65 33  ndif.    sqlite3
3c90: 5f 66 72 65 65 28 70 29 3b 0a 20 20 7d 0a 7d 0a  _free(p);.  }.}.
3ca0: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45  .#ifdef SQLITE_E
3cb0: 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e  NABLE_MEMORY_MAN
3cc0: 41 47 45 4d 45 4e 54 0a 2f 2a 0a 2a 2a 20 52 65  AGEMENT./*.** Re
3cd0: 74 75 72 6e 20 74 68 65 20 73 69 7a 65 20 6f 66  turn the size of
3ce0: 20 61 20 70 63 61 63 68 65 20 61 6c 6c 6f 63 61   a pcache alloca
3cf0: 74 69 6f 6e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  tion.*/.static i
3d00: 6e 74 20 70 63 61 63 68 65 31 4d 65 6d 53 69 7a  nt pcache1MemSiz
3d10: 65 28 76 6f 69 64 20 2a 70 29 7b 0a 20 20 69 66  e(void *p){.  if
3d20: 28 20 70 3e 3d 70 63 61 63 68 65 31 2e 70 53 74  ( p>=pcache1.pSt
3d30: 61 72 74 20 26 26 20 70 3c 70 63 61 63 68 65 31  art && p<pcache1
3d40: 2e 70 45 6e 64 20 29 7b 0a 20 20 20 20 72 65 74  .pEnd ){.    ret
3d50: 75 72 6e 20 70 63 61 63 68 65 31 2e 73 7a 53 6c  urn pcache1.szSl
3d60: 6f 74 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ot;.  }else{.   
3d70: 20 69 6e 74 20 69 53 69 7a 65 3b 0a 20 20 20 20   int iSize;.    
3d80: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d  assert( sqlite3M
3d90: 65 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 70  emdebugHasType(p
3da0: 2c 20 4d 45 4d 54 59 50 45 5f 50 43 41 43 48 45  , MEMTYPE_PCACHE
3db0: 29 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  ) );.    sqlite3
3dc0: 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 28  MemdebugSetType(
3dd0: 70 2c 20 4d 45 4d 54 59 50 45 5f 48 45 41 50 29  p, MEMTYPE_HEAP)
3de0: 3b 0a 20 20 20 20 69 53 69 7a 65 20 3d 20 73 71  ;.    iSize = sq
3df0: 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28  lite3MallocSize(
3e00: 70 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 4d  p);.    sqlite3M
3e10: 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 28 70  emdebugSetType(p
3e20: 2c 20 4d 45 4d 54 59 50 45 5f 50 43 41 43 48 45  , MEMTYPE_PCACHE
3e30: 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 69 53  );.    return iS
3e40: 69 7a 65 3b 0a 20 20 7d 0a 7d 0a 23 65 6e 64 69  ize;.  }.}.#endi
3e50: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42  f /* SQLITE_ENAB
3e60: 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45  LE_MEMORY_MANAGE
3e70: 4d 45 4e 54 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41  MENT */../*.** A
3e80: 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 70 61  llocate a new pa
3e90: 67 65 20 6f 62 6a 65 63 74 20 69 6e 69 74 69 61  ge object initia
3ea0: 6c 6c 79 20 61 73 73 6f 63 69 61 74 65 64 20 77  lly associated w
3eb0: 69 74 68 20 63 61 63 68 65 20 70 43 61 63 68 65  ith cache pCache
3ec0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67 48 64  ..*/.static PgHd
3ed0: 72 31 20 2a 70 63 61 63 68 65 31 41 6c 6c 6f 63  r1 *pcache1Alloc
3ee0: 50 61 67 65 28 50 43 61 63 68 65 31 20 2a 70 43  Page(PCache1 *pC
3ef0: 61 63 68 65 2c 20 69 6e 74 20 62 65 6e 69 67 6e  ache, int benign
3f00: 4d 61 6c 6c 6f 63 29 7b 0a 20 20 50 67 48 64 72  Malloc){.  PgHdr
3f10: 31 20 2a 70 20 3d 20 30 3b 0a 20 20 76 6f 69 64  1 *p = 0;.  void
3f20: 20 2a 70 50 67 3b 0a 0a 20 20 61 73 73 65 72 74   *pPg;..  assert
3f30: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
3f40: 68 65 6c 64 28 70 43 61 63 68 65 2d 3e 70 47 72  held(pCache->pGr
3f50: 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20  oup->mutex) );. 
3f60: 20 69 66 28 20 70 43 61 63 68 65 2d 3e 70 46 72   if( pCache->pFr
3f70: 65 65 20 7c 7c 20 28 70 43 61 63 68 65 2d 3e 6e  ee || (pCache->n
3f80: 50 61 67 65 3d 3d 30 20 26 26 20 70 63 61 63 68  Page==0 && pcach
3f90: 65 31 49 6e 69 74 42 75 6c 6b 28 70 43 61 63 68  e1InitBulk(pCach
3fa0: 65 29 29 20 29 7b 0a 20 20 20 20 70 20 3d 20 70  e)) ){.    p = p
3fb0: 43 61 63 68 65 2d 3e 70 46 72 65 65 3b 0a 20 20  Cache->pFree;.  
3fc0: 20 20 70 43 61 63 68 65 2d 3e 70 46 72 65 65 20    pCache->pFree 
3fd0: 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20  = p->pNext;.    
3fe0: 70 2d 3e 70 4e 65 78 74 20 3d 20 30 3b 0a 20 20  p->pNext = 0;.  
3ff0: 7d 65 6c 73 65 7b 0a 23 69 66 64 65 66 20 53 51  }else{.#ifdef SQ
4000: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f  LITE_ENABLE_MEMO
4010: 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 20 20  RY_MANAGEMENT.  
4020: 20 20 2f 2a 20 54 68 65 20 67 72 6f 75 70 20 6d    /* The group m
4030: 75 74 65 78 20 6d 75 73 74 20 62 65 20 72 65 6c  utex must be rel
4040: 65 61 73 65 64 20 62 65 66 6f 72 65 20 70 63 61  eased before pca
4050: 63 68 65 31 41 6c 6c 6f 63 28 29 20 69 73 20 63  che1Alloc() is c
4060: 61 6c 6c 65 64 2e 20 54 68 69 73 0a 20 20 20 20  alled. This.    
4070: 2a 2a 20 69 73 20 62 65 63 61 75 73 65 20 69 74  ** is because it
4080: 20 6d 69 67 68 74 20 63 61 6c 6c 20 73 71 6c 69   might call sqli
4090: 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f  te3_release_memo
40a0: 72 79 28 29 2c 20 77 68 69 63 68 20 61 73 73 75  ry(), which assu
40b0: 6d 65 73 20 74 68 61 74 20 0a 20 20 20 20 2a 2a  mes that .    **
40c0: 20 74 68 69 73 20 6d 75 74 65 78 20 69 73 20 6e   this mutex is n
40d0: 6f 74 20 68 65 6c 64 2e 20 2a 2f 0a 20 20 20 20  ot held. */.    
40e0: 61 73 73 65 72 74 28 20 70 63 61 63 68 65 31 2e  assert( pcache1.
40f0: 73 65 70 61 72 61 74 65 43 61 63 68 65 3d 3d 30  separateCache==0
4100: 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20   );.    assert( 
4110: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3d 3d  pCache->pGroup==
4120: 26 70 63 61 63 68 65 31 2e 67 72 70 20 29 3b 0a  &pcache1.grp );.
4130: 20 20 20 20 70 63 61 63 68 65 31 4c 65 61 76 65      pcache1Leave
4140: 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47  Mutex(pCache->pG
4150: 72 6f 75 70 29 3b 0a 23 65 6e 64 69 66 0a 20 20  roup);.#endif.  
4160: 20 20 69 66 28 20 62 65 6e 69 67 6e 4d 61 6c 6c    if( benignMall
4170: 6f 63 20 29 7b 20 73 71 6c 69 74 65 33 42 65 67  oc ){ sqlite3Beg
4180: 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29  inBenignMalloc()
4190: 3b 20 7d 0a 23 69 66 64 65 66 20 53 51 4c 49 54  ; }.#ifdef SQLIT
41a0: 45 5f 50 43 41 43 48 45 5f 53 45 50 41 52 41 54  E_PCACHE_SEPARAT
41b0: 45 5f 48 45 41 44 45 52 0a 20 20 20 20 70 50 67  E_HEADER.    pPg
41c0: 20 3d 20 70 63 61 63 68 65 31 41 6c 6c 6f 63 28   = pcache1Alloc(
41d0: 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 29 3b  pCache->szPage);
41e0: 0a 20 20 20 20 70 20 3d 20 73 71 6c 69 74 65 33  .    p = sqlite3
41f0: 4d 61 6c 6c 6f 63 28 73 69 7a 65 6f 66 28 50 67  Malloc(sizeof(Pg
4200: 48 64 72 31 29 20 2b 20 70 43 61 63 68 65 2d 3e  Hdr1) + pCache->
4210: 73 7a 45 78 74 72 61 29 3b 0a 20 20 20 20 69 66  szExtra);.    if
4220: 28 20 21 70 50 67 20 7c 7c 20 21 70 20 29 7b 0a  ( !pPg || !p ){.
4230: 20 20 20 20 20 20 70 63 61 63 68 65 31 46 72 65        pcache1Fre
4240: 65 28 70 50 67 29 3b 0a 20 20 20 20 20 20 73 71  e(pPg);.      sq
4250: 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 20  lite3_free(p);. 
4260: 20 20 20 20 20 70 50 67 20 3d 20 30 3b 0a 20 20       pPg = 0;.  
4270: 20 20 7d 0a 23 65 6c 73 65 0a 20 20 20 20 70 50    }.#else.    pP
4280: 67 20 3d 20 70 63 61 63 68 65 31 41 6c 6c 6f 63  g = pcache1Alloc
4290: 28 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63  (pCache->szAlloc
42a0: 29 3b 0a 20 20 20 20 70 20 3d 20 28 50 67 48 64  );.    p = (PgHd
42b0: 72 31 20 2a 29 26 28 28 75 38 20 2a 29 70 50 67  r1 *)&((u8 *)pPg
42c0: 29 5b 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65  )[pCache->szPage
42d0: 5d 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 69 66  ];.#endif.    if
42e0: 28 20 62 65 6e 69 67 6e 4d 61 6c 6c 6f 63 20 29  ( benignMalloc )
42f0: 7b 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e 69  { sqlite3EndBeni
4300: 67 6e 4d 61 6c 6c 6f 63 28 29 3b 20 7d 0a 23 69  gnMalloc(); }.#i
4310: 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42  fdef SQLITE_ENAB
4320: 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45  LE_MEMORY_MANAGE
4330: 4d 45 4e 54 0a 20 20 20 20 70 63 61 63 68 65 31  MENT.    pcache1
4340: 45 6e 74 65 72 4d 75 74 65 78 28 70 43 61 63 68  EnterMutex(pCach
4350: 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 23 65 6e 64  e->pGroup);.#end
4360: 69 66 0a 20 20 20 20 69 66 28 20 70 50 67 3d 3d  if.    if( pPg==
4370: 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20  0 ) return 0;.  
4380: 20 20 70 2d 3e 70 61 67 65 2e 70 42 75 66 20 3d    p->page.pBuf =
4390: 20 70 50 67 3b 0a 20 20 20 20 70 2d 3e 70 61 67   pPg;.    p->pag
43a0: 65 2e 70 45 78 74 72 61 20 3d 20 26 70 5b 31 5d  e.pExtra = &p[1]
43b0: 3b 0a 20 20 20 20 70 2d 3e 69 73 42 75 6c 6b 4c  ;.    p->isBulkL
43c0: 6f 63 61 6c 20 3d 20 30 3b 0a 20 20 20 20 70 2d  ocal = 0;.    p-
43d0: 3e 69 73 41 6e 63 68 6f 72 20 3d 20 30 3b 0a 20  >isAnchor = 0;. 
43e0: 20 7d 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d   }.  if( pCache-
43f0: 3e 62 50 75 72 67 65 61 62 6c 65 20 29 7b 0a 20  >bPurgeable ){. 
4400: 20 20 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75     pCache->pGrou
4410: 70 2d 3e 6e 43 75 72 72 65 6e 74 50 61 67 65 2b  p->nCurrentPage+
4420: 2b 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  +;.  }.  return 
4430: 70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65  p;.}../*.** Free
4440: 20 61 20 70 61 67 65 20 6f 62 6a 65 63 74 20 61   a page object a
4450: 6c 6c 6f 63 61 74 65 64 20 62 79 20 70 63 61 63  llocated by pcac
4460: 68 65 31 41 6c 6c 6f 63 50 61 67 65 28 29 2e 0a  he1AllocPage()..
4470: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70  */.static void p
4480: 63 61 63 68 65 31 46 72 65 65 50 61 67 65 28 50  cache1FreePage(P
4490: 67 48 64 72 31 20 2a 70 29 7b 0a 20 20 50 43 61  gHdr1 *p){.  PCa
44a0: 63 68 65 31 20 2a 70 43 61 63 68 65 3b 0a 20 20  che1 *pCache;.  
44b0: 61 73 73 65 72 74 28 20 70 21 3d 30 20 29 3b 0a  assert( p!=0 );.
44c0: 20 20 70 43 61 63 68 65 20 3d 20 70 2d 3e 70 43    pCache = p->pC
44d0: 61 63 68 65 3b 0a 20 20 61 73 73 65 72 74 28 20  ache;.  assert( 
44e0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65  sqlite3_mutex_he
44f0: 6c 64 28 70 2d 3e 70 43 61 63 68 65 2d 3e 70 47  ld(p->pCache->pG
4500: 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a  roup->mutex) );.
4510: 20 20 69 66 28 20 70 2d 3e 69 73 42 75 6c 6b 4c    if( p->isBulkL
4520: 6f 63 61 6c 20 29 7b 0a 20 20 20 20 70 2d 3e 70  ocal ){.    p->p
4530: 4e 65 78 74 20 3d 20 70 43 61 63 68 65 2d 3e 70  Next = pCache->p
4540: 46 72 65 65 3b 0a 20 20 20 20 70 43 61 63 68 65  Free;.    pCache
4550: 2d 3e 70 46 72 65 65 20 3d 20 70 3b 0a 20 20 7d  ->pFree = p;.  }
4560: 65 6c 73 65 7b 0a 20 20 20 20 70 63 61 63 68 65  else{.    pcache
4570: 31 46 72 65 65 28 70 2d 3e 70 61 67 65 2e 70 42  1Free(p->page.pB
4580: 75 66 29 3b 0a 23 69 66 64 65 66 20 53 51 4c 49  uf);.#ifdef SQLI
4590: 54 45 5f 50 43 41 43 48 45 5f 53 45 50 41 52 41  TE_PCACHE_SEPARA
45a0: 54 45 5f 48 45 41 44 45 52 0a 20 20 20 20 73 71  TE_HEADER.    sq
45b0: 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 23  lite3_free(p);.#
45c0: 65 6e 64 69 66 0a 20 20 7d 0a 20 20 69 66 28 20  endif.  }.  if( 
45d0: 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62  pCache->bPurgeab
45e0: 6c 65 20 29 7b 0a 20 20 20 20 70 43 61 63 68 65  le ){.    pCache
45f0: 2d 3e 70 47 72 6f 75 70 2d 3e 6e 43 75 72 72 65  ->pGroup->nCurre
4600: 6e 74 50 61 67 65 2d 2d 3b 0a 20 20 7d 0a 7d 0a  ntPage--;.  }.}.
4610: 0a 2f 2a 0a 2a 2a 20 4d 61 6c 6c 6f 63 20 66 75  ./*.** Malloc fu
4620: 6e 63 74 69 6f 6e 20 75 73 65 64 20 62 79 20 53  nction used by S
4630: 51 4c 69 74 65 20 74 6f 20 6f 62 74 61 69 6e 20  QLite to obtain 
4640: 73 70 61 63 65 20 66 72 6f 6d 20 74 68 65 20 62  space from the b
4650: 75 66 66 65 72 20 63 6f 6e 66 69 67 75 72 65 64  uffer configured
4660: 0a 2a 2a 20 75 73 69 6e 67 20 73 71 6c 69 74 65  .** using sqlite
4670: 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f  3_config(SQLITE_
4680: 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45  CONFIG_PAGECACHE
4690: 29 20 6f 70 74 69 6f 6e 2e 20 49 66 20 6e 6f 20  ) option. If no 
46a0: 73 75 63 68 20 62 75 66 66 65 72 0a 2a 2a 20 65  such buffer.** e
46b0: 78 69 73 74 73 2c 20 74 68 69 73 20 66 75 6e 63  xists, this func
46c0: 74 69 6f 6e 20 66 61 6c 6c 73 20 62 61 63 6b 20  tion falls back 
46d0: 74 6f 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63  to sqlite3Malloc
46e0: 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c  ()..*/.void *sql
46f0: 69 74 65 33 50 61 67 65 4d 61 6c 6c 6f 63 28 69  ite3PageMalloc(i
4700: 6e 74 20 73 7a 29 7b 0a 20 20 72 65 74 75 72 6e  nt sz){.  return
4710: 20 70 63 61 63 68 65 31 41 6c 6c 6f 63 28 73 7a   pcache1Alloc(sz
4720: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65  );.}../*.** Free
4730: 20 61 6e 20 61 6c 6c 6f 63 61 74 65 64 20 62 75   an allocated bu
4740: 66 66 65 72 20 6f 62 74 61 69 6e 65 64 20 66 72  ffer obtained fr
4750: 6f 6d 20 73 71 6c 69 74 65 33 50 61 67 65 4d 61  om sqlite3PageMa
4760: 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20  lloc()..*/.void 
4770: 73 71 6c 69 74 65 33 50 61 67 65 46 72 65 65 28  sqlite3PageFree(
4780: 76 6f 69 64 20 2a 70 29 7b 0a 20 20 70 63 61 63  void *p){.  pcac
4790: 68 65 31 46 72 65 65 28 70 29 3b 0a 7d 0a 0a 0a  he1Free(p);.}...
47a0: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 72 75  /*.** Return tru
47b0: 65 20 69 66 20 69 74 20 64 65 73 69 72 61 62 6c  e if it desirabl
47c0: 65 20 74 6f 20 61 76 6f 69 64 20 61 6c 6c 6f 63  e to avoid alloc
47d0: 61 74 69 6e 67 20 61 20 6e 65 77 20 70 61 67 65  ating a new page
47e0: 20 63 61 63 68 65 0a 2a 2a 20 65 6e 74 72 79 2e   cache.** entry.
47f0: 0a 2a 2a 0a 2a 2a 20 49 66 20 6d 65 6d 6f 72 79  .**.** If memory
4800: 20 77 61 73 20 61 6c 6c 6f 63 61 74 65 64 20 73   was allocated s
4810: 70 65 63 69 66 69 63 61 6c 6c 79 20 74 6f 20 74  pecifically to t
4820: 68 65 20 70 61 67 65 20 63 61 63 68 65 20 75 73  he page cache us
4830: 69 6e 67 0a 2a 2a 20 53 51 4c 49 54 45 5f 43 4f  ing.** SQLITE_CO
4840: 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45 20 62  NFIG_PAGECACHE b
4850: 75 74 20 74 68 61 74 20 6d 65 6d 6f 72 79 20 68  ut that memory h
4860: 61 73 20 61 6c 6c 20 62 65 65 6e 20 75 73 65 64  as all been used
4870: 2c 20 74 68 65 6e 0a 2a 2a 20 69 74 20 69 73 20  , then.** it is 
4880: 64 65 73 69 72 61 62 6c 65 20 74 6f 20 61 76 6f  desirable to avo
4890: 69 64 20 61 6c 6c 6f 63 61 74 69 6e 67 20 61 20  id allocating a 
48a0: 6e 65 77 20 70 61 67 65 20 63 61 63 68 65 20 65  new page cache e
48b0: 6e 74 72 79 20 62 65 63 61 75 73 65 0a 2a 2a 20  ntry because.** 
48c0: 70 72 65 73 75 6d 61 62 6c 79 20 53 51 4c 49 54  presumably SQLIT
48d0: 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43  E_CONFIG_PAGECAC
48e0: 48 45 20 77 61 73 20 73 75 70 70 6f 73 65 20 74  HE was suppose t
48f0: 6f 20 62 65 20 73 75 66 66 69 63 69 65 6e 74 0a  o be sufficient.
4900: 2a 2a 20 66 6f 72 20 61 6c 6c 20 70 61 67 65 20  ** for all page 
4910: 63 61 63 68 65 20 6e 65 65 64 73 20 61 6e 64 20  cache needs and 
4920: 77 65 20 73 68 6f 75 6c 64 20 6e 6f 74 20 6e 65  we should not ne
4930: 65 64 20 74 6f 20 73 70 69 6c 6c 20 74 68 65 0a  ed to spill the.
4940: 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 6f 6e  ** allocation on
4950: 74 6f 20 74 68 65 20 68 65 61 70 2e 0a 2a 2a 0a  to the heap..**.
4960: 2a 2a 20 4f 72 2c 20 74 68 65 20 68 65 61 70 20  ** Or, the heap 
4970: 69 73 20 75 73 65 64 20 66 6f 72 20 61 6c 6c 20  is used for all 
4980: 70 61 67 65 20 63 61 63 68 65 20 6d 65 6d 6f 72  page cache memor
4990: 79 20 62 75 74 20 74 68 65 20 68 65 61 70 20 69  y but the heap i
49a0: 73 0a 2a 2a 20 75 6e 64 65 72 20 6d 65 6d 6f 72  s.** under memor
49b0: 79 20 70 72 65 73 73 75 72 65 2c 20 74 68 65 6e  y pressure, then
49c0: 20 61 67 61 69 6e 20 69 74 20 69 73 20 64 65 73   again it is des
49d0: 69 72 61 62 6c 65 20 74 6f 20 61 76 6f 69 64 0a  irable to avoid.
49e0: 2a 2a 20 61 6c 6c 6f 63 61 74 69 6e 67 20 61 20  ** allocating a 
49f0: 6e 65 77 20 70 61 67 65 20 63 61 63 68 65 20 65  new page cache e
4a00: 6e 74 72 79 20 69 6e 20 6f 72 64 65 72 20 74 6f  ntry in order to
4a10: 20 61 76 6f 69 64 20 73 74 72 65 73 73 69 6e 67   avoid stressing
4a20: 0a 2a 2a 20 74 68 65 20 68 65 61 70 20 65 76 65  .** the heap eve
4a30: 6e 20 66 75 72 74 68 65 72 2e 0a 2a 2f 0a 73 74  n further..*/.st
4a40: 61 74 69 63 20 69 6e 74 20 70 63 61 63 68 65 31  atic int pcache1
4a50: 55 6e 64 65 72 4d 65 6d 6f 72 79 50 72 65 73 73  UnderMemoryPress
4a60: 75 72 65 28 50 43 61 63 68 65 31 20 2a 70 43 61  ure(PCache1 *pCa
4a70: 63 68 65 29 7b 0a 20 20 69 66 28 20 70 63 61 63  che){.  if( pcac
4a80: 68 65 31 2e 6e 53 6c 6f 74 20 26 26 20 28 70 43  he1.nSlot && (pC
4a90: 61 63 68 65 2d 3e 73 7a 50 61 67 65 2b 70 43 61  ache->szPage+pCa
4aa0: 63 68 65 2d 3e 73 7a 45 78 74 72 61 29 3c 3d 70  che->szExtra)<=p
4ab0: 63 61 63 68 65 31 2e 73 7a 53 6c 6f 74 20 29 7b  cache1.szSlot ){
4ac0: 0a 20 20 20 20 72 65 74 75 72 6e 20 70 63 61 63  .    return pcac
4ad0: 68 65 31 2e 62 55 6e 64 65 72 50 72 65 73 73 75  he1.bUnderPressu
4ae0: 72 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  re;.  }else{.   
4af0: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 48   return sqlite3H
4b00: 65 61 70 4e 65 61 72 6c 79 46 75 6c 6c 28 29 3b  eapNearlyFull();
4b10: 0a 20 20 7d 0a 7d 0a 0a 2f 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 2a 2a 2a 2a 2a 2f 0a 2f 2a 2a 2a 2a 2a 2a  *******/./******
4b70: 2a 2a 20 47 65 6e 65 72 61 6c 20 49 6d 70 6c 65  ** General Imple
4b80: 6d 65 6e 74 61 74 69 6f 6e 20 46 75 6e 63 74 69  mentation Functi
4b90: 6f 6e 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ons ************
4ba0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4bb0: 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 0a 2a 2a  ********/../*.**
4bc0: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69   This function i
4bd0: 73 20 75 73 65 64 20 74 6f 20 72 65 73 69 7a 65  s used to resize
4be0: 20 74 68 65 20 68 61 73 68 20 74 61 62 6c 65 20   the hash table 
4bf0: 75 73 65 64 20 62 79 20 74 68 65 20 63 61 63 68  used by the cach
4c00: 65 20 70 61 73 73 65 64 0a 2a 2a 20 61 73 20 74  e passed.** as t
4c10: 68 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e  he first argumen
4c20: 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50 43 61  t..**.** The PCa
4c30: 63 68 65 20 6d 75 74 65 78 20 6d 75 73 74 20 62  che mutex must b
4c40: 65 20 68 65 6c 64 20 77 68 65 6e 20 74 68 69 73  e held when this
4c50: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c   function is cal
4c60: 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  led..*/.static v
4c70: 6f 69 64 20 70 63 61 63 68 65 31 52 65 73 69 7a  oid pcache1Resiz
4c80: 65 48 61 73 68 28 50 43 61 63 68 65 31 20 2a 70  eHash(PCache1 *p
4c90: 29 7b 0a 20 20 50 67 48 64 72 31 20 2a 2a 61 70  ){.  PgHdr1 **ap
4ca0: 4e 65 77 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20  New;.  unsigned 
4cb0: 69 6e 74 20 6e 4e 65 77 3b 0a 20 20 75 6e 73 69  int nNew;.  unsi
4cc0: 67 6e 65 64 20 69 6e 74 20 69 3b 0a 0a 20 20 61  gned int i;..  a
4cd0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d  ssert( sqlite3_m
4ce0: 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 70 47 72  utex_held(p->pGr
4cf0: 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 0a  oup->mutex) );..
4d00: 20 20 6e 4e 65 77 20 3d 20 70 2d 3e 6e 48 61 73    nNew = p->nHas
4d10: 68 2a 32 3b 0a 20 20 69 66 28 20 6e 4e 65 77 3c  h*2;.  if( nNew<
4d20: 32 35 36 20 29 7b 0a 20 20 20 20 6e 4e 65 77 20  256 ){.    nNew 
4d30: 3d 20 32 35 36 3b 0a 20 20 7d 0a 0a 20 20 70 63  = 256;.  }..  pc
4d40: 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28  ache1LeaveMutex(
4d50: 70 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20 69 66  p->pGroup);.  if
4d60: 28 20 70 2d 3e 6e 48 61 73 68 20 29 7b 20 73 71  ( p->nHash ){ sq
4d70: 6c 69 74 65 33 42 65 67 69 6e 42 65 6e 69 67 6e  lite3BeginBenign
4d80: 4d 61 6c 6c 6f 63 28 29 3b 20 7d 0a 20 20 61 70  Malloc(); }.  ap
4d90: 4e 65 77 20 3d 20 28 50 67 48 64 72 31 20 2a 2a  New = (PgHdr1 **
4da0: 29 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a 65  )sqlite3MallocZe
4db0: 72 6f 28 73 69 7a 65 6f 66 28 50 67 48 64 72 31  ro(sizeof(PgHdr1
4dc0: 20 2a 29 2a 6e 4e 65 77 29 3b 0a 20 20 69 66 28   *)*nNew);.  if(
4dd0: 20 70 2d 3e 6e 48 61 73 68 20 29 7b 20 73 71 6c   p->nHash ){ sql
4de0: 69 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d 61 6c  ite3EndBenignMal
4df0: 6c 6f 63 28 29 3b 20 7d 0a 20 20 70 63 61 63 68  loc(); }.  pcach
4e00: 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70 2d 3e  e1EnterMutex(p->
4e10: 70 47 72 6f 75 70 29 3b 0a 20 20 69 66 28 20 61  pGroup);.  if( a
4e20: 70 4e 65 77 20 29 7b 0a 20 20 20 20 66 6f 72 28  pNew ){.    for(
4e30: 69 3d 30 3b 20 69 3c 70 2d 3e 6e 48 61 73 68 3b  i=0; i<p->nHash;
4e40: 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 50 67 48   i++){.      PgH
4e50: 64 72 31 20 2a 70 50 61 67 65 3b 0a 20 20 20 20  dr1 *pPage;.    
4e60: 20 20 50 67 48 64 72 31 20 2a 70 4e 65 78 74 20    PgHdr1 *pNext 
4e70: 3d 20 70 2d 3e 61 70 48 61 73 68 5b 69 5d 3b 0a  = p->apHash[i];.
4e80: 20 20 20 20 20 20 77 68 69 6c 65 28 20 28 70 50        while( (pP
4e90: 61 67 65 20 3d 20 70 4e 65 78 74 29 21 3d 30 20  age = pNext)!=0 
4ea0: 29 7b 0a 20 20 20 20 20 20 20 20 75 6e 73 69 67  ){.        unsig
4eb0: 6e 65 64 20 69 6e 74 20 68 20 3d 20 70 50 61 67  ned int h = pPag
4ec0: 65 2d 3e 69 4b 65 79 20 25 20 6e 4e 65 77 3b 0a  e->iKey % nNew;.
4ed0: 20 20 20 20 20 20 20 20 70 4e 65 78 74 20 3d 20          pNext = 
4ee0: 70 50 61 67 65 2d 3e 70 4e 65 78 74 3b 0a 20 20  pPage->pNext;.  
4ef0: 20 20 20 20 20 20 70 50 61 67 65 2d 3e 70 4e 65        pPage->pNe
4f00: 78 74 20 3d 20 61 70 4e 65 77 5b 68 5d 3b 0a 20  xt = apNew[h];. 
4f10: 20 20 20 20 20 20 20 61 70 4e 65 77 5b 68 5d 20         apNew[h] 
4f20: 3d 20 70 50 61 67 65 3b 0a 20 20 20 20 20 20 7d  = pPage;.      }
4f30: 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74  .    }.    sqlit
4f40: 65 33 5f 66 72 65 65 28 70 2d 3e 61 70 48 61 73  e3_free(p->apHas
4f50: 68 29 3b 0a 20 20 20 20 70 2d 3e 61 70 48 61 73  h);.    p->apHas
4f60: 68 20 3d 20 61 70 4e 65 77 3b 0a 20 20 20 20 70  h = apNew;.    p
4f70: 2d 3e 6e 48 61 73 68 20 3d 20 6e 4e 65 77 3b 0a  ->nHash = nNew;.
4f80: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69    }.}../*.** Thi
4f90: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73  s function is us
4fa0: 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79 20 74 6f  ed internally to
4fb0: 20 72 65 6d 6f 76 65 20 74 68 65 20 70 61 67 65   remove the page
4fc0: 20 70 50 61 67 65 20 66 72 6f 6d 20 74 68 65 20   pPage from the 
4fd0: 0a 2a 2a 20 50 47 72 6f 75 70 20 4c 52 55 20 6c  .** PGroup LRU l
4fe0: 69 73 74 2c 20 69 66 20 69 73 20 70 61 72 74 20  ist, if is part 
4ff0: 6f 66 20 69 74 2e 20 49 66 20 70 50 61 67 65 20  of it. If pPage 
5000: 69 73 20 6e 6f 74 20 70 61 72 74 20 6f 66 20 74  is not part of t
5010: 68 65 20 50 47 72 6f 75 70 0a 2a 2a 20 4c 52 55  he PGroup.** LRU
5020: 20 6c 69 73 74 2c 20 74 68 65 6e 20 74 68 69 73   list, then this
5030: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 6e   function is a n
5040: 6f 2d 6f 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20  o-op..**.** The 
5050: 50 47 72 6f 75 70 20 6d 75 74 65 78 20 6d 75 73  PGroup mutex mus
5060: 74 20 62 65 20 68 65 6c 64 20 77 68 65 6e 20 74  t be held when t
5070: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  his function is 
5080: 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69  called..*/.stati
5090: 63 20 50 67 48 64 72 31 20 2a 70 63 61 63 68 65  c PgHdr1 *pcache
50a0: 31 50 69 6e 50 61 67 65 28 50 67 48 64 72 31 20  1PinPage(PgHdr1 
50b0: 2a 70 50 61 67 65 29 7b 0a 20 20 50 43 61 63 68  *pPage){.  PCach
50c0: 65 31 20 2a 70 43 61 63 68 65 3b 0a 0a 20 20 61  e1 *pCache;..  a
50d0: 73 73 65 72 74 28 20 70 50 61 67 65 21 3d 30 20  ssert( pPage!=0 
50e0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61  );.  assert( pPa
50f0: 67 65 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d 30 20  ge->isPinned==0 
5100: 29 3b 0a 20 20 70 43 61 63 68 65 20 3d 20 70 50  );.  pCache = pP
5110: 61 67 65 2d 3e 70 43 61 63 68 65 3b 0a 20 20 61  age->pCache;.  a
5120: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 4c  ssert( pPage->pL
5130: 72 75 4e 65 78 74 20 29 3b 0a 20 20 61 73 73 65  ruNext );.  asse
5140: 72 74 28 20 70 50 61 67 65 2d 3e 70 4c 72 75 50  rt( pPage->pLruP
5150: 72 65 76 20 29 3b 0a 20 20 61 73 73 65 72 74 28  rev );.  assert(
5160: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68   sqlite3_mutex_h
5170: 65 6c 64 28 70 43 61 63 68 65 2d 3e 70 47 72 6f  eld(pCache->pGro
5180: 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20  up->mutex) );.  
5190: 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 2d  pPage->pLruPrev-
51a0: 3e 70 4c 72 75 4e 65 78 74 20 3d 20 70 50 61 67  >pLruNext = pPag
51b0: 65 2d 3e 70 4c 72 75 4e 65 78 74 3b 0a 20 20 70  e->pLruNext;.  p
51c0: 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74 2d 3e  Page->pLruNext->
51d0: 70 4c 72 75 50 72 65 76 20 3d 20 70 50 61 67 65  pLruPrev = pPage
51e0: 2d 3e 70 4c 72 75 50 72 65 76 3b 0a 20 20 70 50  ->pLruPrev;.  pP
51f0: 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74 20 3d 20  age->pLruNext = 
5200: 30 3b 0a 20 20 70 50 61 67 65 2d 3e 70 4c 72 75  0;.  pPage->pLru
5210: 50 72 65 76 20 3d 20 30 3b 0a 20 20 70 50 61 67  Prev = 0;.  pPag
5220: 65 2d 3e 69 73 50 69 6e 6e 65 64 20 3d 20 31 3b  e->isPinned = 1;
5230: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65  .  assert( pPage
5240: 2d 3e 69 73 41 6e 63 68 6f 72 3d 3d 30 20 29 3b  ->isAnchor==0 );
5250: 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68  .  assert( pCach
5260: 65 2d 3e 70 47 72 6f 75 70 2d 3e 6c 72 75 2e 69  e->pGroup->lru.i
5270: 73 41 6e 63 68 6f 72 3d 3d 31 20 29 3b 0a 20 20  sAnchor==1 );.  
5280: 70 43 61 63 68 65 2d 3e 6e 52 65 63 79 63 6c 61  pCache->nRecycla
5290: 62 6c 65 2d 2d 3b 0a 20 20 72 65 74 75 72 6e 20  ble--;.  return 
52a0: 70 50 61 67 65 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a  pPage;.}.../*.**
52b0: 20 52 65 6d 6f 76 65 20 74 68 65 20 70 61 67 65   Remove the page
52c0: 20 73 75 70 70 6c 69 65 64 20 61 73 20 61 6e 20   supplied as an 
52d0: 61 72 67 75 6d 65 6e 74 20 66 72 6f 6d 20 74 68  argument from th
52e0: 65 20 68 61 73 68 20 74 61 62 6c 65 20 0a 2a 2a  e hash table .**
52f0: 20 28 50 43 61 63 68 65 31 2e 61 70 48 61 73 68   (PCache1.apHash
5300: 20 73 74 72 75 63 74 75 72 65 29 20 74 68 61 74   structure) that
5310: 20 69 74 20 69 73 20 63 75 72 72 65 6e 74 6c 79   it is currently
5320: 20 73 74 6f 72 65 64 20 69 6e 2e 0a 2a 2a 20 41   stored in..** A
5330: 6c 73 6f 20 66 72 65 65 20 74 68 65 20 70 61 67  lso free the pag
5340: 65 20 69 66 20 66 72 65 65 50 61 67 65 20 69 73  e if freePage is
5350: 20 74 72 75 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65   true..**.** The
5360: 20 50 47 72 6f 75 70 20 6d 75 74 65 78 20 6d 75   PGroup mutex mu
5370: 73 74 20 62 65 20 68 65 6c 64 20 77 68 65 6e 20  st be held when 
5380: 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73  this function is
5390: 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74   called..*/.stat
53a0: 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 52  ic void pcache1R
53b0: 65 6d 6f 76 65 46 72 6f 6d 48 61 73 68 28 50 67  emoveFromHash(Pg
53c0: 48 64 72 31 20 2a 70 50 61 67 65 2c 20 69 6e 74  Hdr1 *pPage, int
53d0: 20 66 72 65 65 46 6c 61 67 29 7b 0a 20 20 75 6e   freeFlag){.  un
53e0: 73 69 67 6e 65 64 20 69 6e 74 20 68 3b 0a 20 20  signed int h;.  
53f0: 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 20  PCache1 *pCache 
5400: 3d 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65 3b  = pPage->pCache;
5410: 0a 20 20 50 67 48 64 72 31 20 2a 2a 70 70 3b 0a  .  PgHdr1 **pp;.
5420: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74  .  assert( sqlit
5430: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43  e3_mutex_held(pC
5440: 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75  ache->pGroup->mu
5450: 74 65 78 29 20 29 3b 0a 20 20 68 20 3d 20 70 50  tex) );.  h = pP
5460: 61 67 65 2d 3e 69 4b 65 79 20 25 20 70 43 61 63  age->iKey % pCac
5470: 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 66 6f 72  he->nHash;.  for
5480: 28 70 70 3d 26 70 43 61 63 68 65 2d 3e 61 70 48  (pp=&pCache->apH
5490: 61 73 68 5b 68 5d 3b 20 28 2a 70 70 29 21 3d 70  ash[h]; (*pp)!=p
54a0: 50 61 67 65 3b 20 70 70 3d 26 28 2a 70 70 29 2d  Page; pp=&(*pp)-
54b0: 3e 70 4e 65 78 74 29 3b 0a 20 20 2a 70 70 20 3d  >pNext);.  *pp =
54c0: 20 28 2a 70 70 29 2d 3e 70 4e 65 78 74 3b 0a 0a   (*pp)->pNext;..
54d0: 20 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 2d    pCache->nPage-
54e0: 2d 3b 0a 20 20 69 66 28 20 66 72 65 65 46 6c 61  -;.  if( freeFla
54f0: 67 20 29 20 70 63 61 63 68 65 31 46 72 65 65 50  g ) pcache1FreeP
5500: 61 67 65 28 70 50 61 67 65 29 3b 0a 7d 0a 0a 2f  age(pPage);.}../
5510: 2a 0a 2a 2a 20 49 66 20 74 68 65 72 65 20 61 72  *.** If there ar
5520: 65 20 63 75 72 72 65 6e 74 6c 79 20 6d 6f 72 65  e currently more
5530: 20 74 68 61 6e 20 6e 4d 61 78 50 61 67 65 20 70   than nMaxPage p
5540: 61 67 65 73 20 61 6c 6c 6f 63 61 74 65 64 2c 20  ages allocated, 
5550: 74 72 79 0a 2a 2a 20 74 6f 20 72 65 63 79 63 6c  try.** to recycl
5560: 65 20 70 61 67 65 73 20 74 6f 20 72 65 64 75 63  e pages to reduc
5570: 65 20 74 68 65 20 6e 75 6d 62 65 72 20 61 6c 6c  e the number all
5580: 6f 63 61 74 65 64 20 74 6f 20 6e 4d 61 78 50 61  ocated to nMaxPa
5590: 67 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  ge..*/.static vo
55a0: 69 64 20 70 63 61 63 68 65 31 45 6e 66 6f 72 63  id pcache1Enforc
55b0: 65 4d 61 78 50 61 67 65 28 50 43 61 63 68 65 31  eMaxPage(PCache1
55c0: 20 2a 70 43 61 63 68 65 29 7b 0a 20 20 50 47 72   *pCache){.  PGr
55d0: 6f 75 70 20 2a 70 47 72 6f 75 70 20 3d 20 70 43  oup *pGroup = pC
55e0: 61 63 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20 20  ache->pGroup;.  
55f0: 50 67 48 64 72 31 20 2a 70 3b 0a 20 20 61 73 73  PgHdr1 *p;.  ass
5600: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74  ert( sqlite3_mut
5610: 65 78 5f 68 65 6c 64 28 70 47 72 6f 75 70 2d 3e  ex_held(pGroup->
5620: 6d 75 74 65 78 29 20 29 3b 0a 20 20 77 68 69 6c  mutex) );.  whil
5630: 65 28 20 70 47 72 6f 75 70 2d 3e 6e 43 75 72 72  e( pGroup->nCurr
5640: 65 6e 74 50 61 67 65 3e 70 47 72 6f 75 70 2d 3e  entPage>pGroup->
5650: 6e 4d 61 78 50 61 67 65 0a 20 20 20 20 20 20 26  nMaxPage.      &
5660: 26 20 28 70 3d 70 47 72 6f 75 70 2d 3e 6c 72 75  & (p=pGroup->lru
5670: 2e 70 4c 72 75 50 72 65 76 29 2d 3e 69 73 41 6e  .pLruPrev)->isAn
5680: 63 68 6f 72 3d 3d 30 0a 20 20 29 7b 0a 20 20 20  chor==0.  ){.   
5690: 20 61 73 73 65 72 74 28 20 70 2d 3e 70 43 61 63   assert( p->pCac
56a0: 68 65 2d 3e 70 47 72 6f 75 70 3d 3d 70 47 72 6f  he->pGroup==pGro
56b0: 75 70 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74  up );.    assert
56c0: 28 20 70 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d 30  ( p->isPinned==0
56d0: 20 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 50   );.    pcache1P
56e0: 69 6e 50 61 67 65 28 70 29 3b 0a 20 20 20 20 70  inPage(p);.    p
56f0: 63 61 63 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d  cache1RemoveFrom
5700: 48 61 73 68 28 70 2c 20 31 29 3b 0a 20 20 7d 0a  Hash(p, 1);.  }.
5710: 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e 6e 50    if( pCache->nP
5720: 61 67 65 3d 3d 30 20 26 26 20 70 43 61 63 68 65  age==0 && pCache
5730: 2d 3e 70 42 75 6c 6b 20 29 7b 0a 20 20 20 20 73  ->pBulk ){.    s
5740: 71 6c 69 74 65 33 5f 66 72 65 65 28 70 43 61 63  qlite3_free(pCac
5750: 68 65 2d 3e 70 42 75 6c 6b 29 3b 0a 20 20 20 20  he->pBulk);.    
5760: 70 43 61 63 68 65 2d 3e 70 42 75 6c 6b 20 3d 20  pCache->pBulk = 
5770: 70 43 61 63 68 65 2d 3e 70 46 72 65 65 20 3d 20  pCache->pFree = 
5780: 30 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  0;.  }.}../*.** 
5790: 44 69 73 63 61 72 64 20 61 6c 6c 20 70 61 67 65  Discard all page
57a0: 73 20 66 72 6f 6d 20 63 61 63 68 65 20 70 43 61  s from cache pCa
57b0: 63 68 65 20 77 69 74 68 20 61 20 70 61 67 65 20  che with a page 
57c0: 6e 75 6d 62 65 72 20 28 6b 65 79 20 76 61 6c 75  number (key valu
57d0: 65 29 20 0a 2a 2a 20 67 72 65 61 74 65 72 20 74  e) .** greater t
57e0: 68 61 6e 20 6f 72 20 65 71 75 61 6c 20 74 6f 20  han or equal to 
57f0: 69 4c 69 6d 69 74 2e 20 41 6e 79 20 70 69 6e 6e  iLimit. Any pinn
5800: 65 64 20 70 61 67 65 73 20 74 68 61 74 20 6d 65  ed pages that me
5810: 65 74 20 74 68 69 73 20 0a 2a 2a 20 63 72 69 74  et this .** crit
5820: 65 72 69 61 20 61 72 65 20 75 6e 70 69 6e 6e 65  eria are unpinne
5830: 64 20 62 65 66 6f 72 65 20 74 68 65 79 20 61 72  d before they ar
5840: 65 20 64 69 73 63 61 72 64 65 64 2e 0a 2a 2a 0a  e discarded..**.
5850: 2a 2a 20 54 68 65 20 50 43 61 63 68 65 20 6d 75  ** The PCache mu
5860: 74 65 78 20 6d 75 73 74 20 62 65 20 68 65 6c 64  tex must be held
5870: 20 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74   when this funct
5880: 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a  ion is called..*
5890: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63  /.static void pc
58a0: 61 63 68 65 31 54 72 75 6e 63 61 74 65 55 6e 73  ache1TruncateUns
58b0: 61 66 65 28 0a 20 20 50 43 61 63 68 65 31 20 2a  afe(.  PCache1 *
58c0: 70 43 61 63 68 65 2c 20 20 20 20 20 20 20 20 20  pCache,         
58d0: 20 20 20 20 2f 2a 20 54 68 65 20 63 61 63 68 65      /* The cache
58e0: 20 74 6f 20 74 72 75 6e 63 61 74 65 20 2a 2f 0a   to truncate */.
58f0: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69    unsigned int i
5900: 4c 69 6d 69 74 20 20 20 20 20 20 20 20 20 20 2f  Limit          /
5910: 2a 20 44 72 6f 70 20 70 61 67 65 73 20 77 69 74  * Drop pages wit
5920: 68 20 74 68 69 73 20 70 67 6e 6f 20 6f 72 20 6c  h this pgno or l
5930: 61 72 67 65 72 20 2a 2f 0a 29 7b 0a 20 20 54 45  arger */.){.  TE
5940: 53 54 4f 4e 4c 59 28 20 69 6e 74 20 6e 50 61 67  STONLY( int nPag
5950: 65 20 3d 20 30 3b 20 29 20 20 2f 2a 20 54 6f 20  e = 0; )  /* To 
5960: 61 73 73 65 72 74 20 70 43 61 63 68 65 2d 3e 6e  assert pCache->n
5970: 50 61 67 65 20 69 73 20 63 6f 72 72 65 63 74 20  Page is correct 
5980: 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e  */.  unsigned in
5990: 74 20 68 2c 20 69 53 74 6f 70 3b 0a 20 20 61 73  t h, iStop;.  as
59a0: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75  sert( sqlite3_mu
59b0: 74 65 78 5f 68 65 6c 64 28 70 43 61 63 68 65 2d  tex_held(pCache-
59c0: 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20  >pGroup->mutex) 
59d0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61  );.  assert( pCa
59e0: 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 3e 3d 20  che->iMaxKey >= 
59f0: 69 4c 69 6d 69 74 20 29 3b 0a 20 20 61 73 73 65  iLimit );.  asse
5a00: 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 48 61 73  rt( pCache->nHas
5a10: 68 20 3e 20 30 20 29 3b 0a 20 20 69 66 28 20 70  h > 0 );.  if( p
5a20: 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 2d  Cache->iMaxKey -
5a30: 20 69 4c 69 6d 69 74 20 3c 20 70 43 61 63 68 65   iLimit < pCache
5a40: 2d 3e 6e 48 61 73 68 20 29 7b 0a 20 20 20 20 2f  ->nHash ){.    /
5a50: 2a 20 49 66 20 77 65 20 61 72 65 20 6a 75 73 74  * If we are just
5a60: 20 73 68 61 76 69 6e 67 20 74 68 65 20 6c 61 73   shaving the las
5a70: 74 20 66 65 77 20 70 61 67 65 73 20 6f 66 66 20  t few pages off 
5a80: 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 0a 20  the end of the. 
5a90: 20 20 20 2a 2a 20 63 61 63 68 65 2c 20 74 68 65     ** cache, the
5aa0: 6e 20 74 68 65 72 65 20 69 73 20 6e 6f 20 70 6f  n there is no po
5ab0: 69 6e 74 20 69 6e 20 73 63 61 6e 6e 69 6e 67 20  int in scanning 
5ac0: 74 68 65 20 65 6e 74 69 72 65 20 68 61 73 68 20  the entire hash 
5ad0: 74 61 62 6c 65 2e 0a 20 20 20 20 2a 2a 20 4f 6e  table..    ** On
5ae0: 6c 79 20 73 63 61 6e 20 74 68 6f 73 65 20 68 61  ly scan those ha
5af0: 73 68 20 73 6c 6f 74 73 20 74 68 61 74 20 6d 69  sh slots that mi
5b00: 67 68 74 20 63 6f 6e 74 61 69 6e 20 70 61 67 65  ght contain page
5b10: 73 20 74 68 61 74 20 6e 65 65 64 20 74 6f 0a 20  s that need to. 
5b20: 20 20 20 2a 2a 20 62 65 20 72 65 6d 6f 76 65 64     ** be removed
5b30: 2e 20 2a 2f 0a 20 20 20 20 68 20 3d 20 69 4c 69  . */.    h = iLi
5b40: 6d 69 74 20 25 20 70 43 61 63 68 65 2d 3e 6e 48  mit % pCache->nH
5b50: 61 73 68 3b 0a 20 20 20 20 69 53 74 6f 70 20 3d  ash;.    iStop =
5b60: 20 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79   pCache->iMaxKey
5b70: 20 25 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68   % pCache->nHash
5b80: 3b 0a 20 20 20 20 54 45 53 54 4f 4e 4c 59 28 20  ;.    TESTONLY( 
5b90: 6e 50 61 67 65 20 3d 20 2d 31 30 3b 20 29 20 20  nPage = -10; )  
5ba0: 2f 2a 20 44 69 73 61 62 6c 65 20 74 68 65 20 70  /* Disable the p
5bb0: 43 61 63 68 65 2d 3e 6e 50 61 67 65 20 76 61 6c  Cache->nPage val
5bc0: 69 64 69 74 79 20 63 68 65 63 6b 20 2a 2f 0a 20  idity check */. 
5bd0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 54   }else{.    /* T
5be0: 68 69 73 20 69 73 20 74 68 65 20 67 65 6e 65 72  his is the gener
5bf0: 61 6c 20 63 61 73 65 20 77 68 65 72 65 20 6d 61  al case where ma
5c00: 6e 79 20 70 61 67 65 73 20 61 72 65 20 62 65 69  ny pages are bei
5c10: 6e 67 20 72 65 6d 6f 76 65 64 2e 0a 20 20 20 20  ng removed..    
5c20: 2a 2a 20 49 74 20 69 73 20 6e 65 63 65 73 73 61  ** It is necessa
5c30: 72 79 20 74 6f 20 73 63 61 6e 20 74 68 65 20 65  ry to scan the e
5c40: 6e 74 69 72 65 20 68 61 73 68 20 74 61 62 6c 65  ntire hash table
5c50: 20 2a 2f 0a 20 20 20 20 68 20 3d 20 70 43 61 63   */.    h = pCac
5c60: 68 65 2d 3e 6e 48 61 73 68 2f 32 3b 0a 20 20 20  he->nHash/2;.   
5c70: 20 69 53 74 6f 70 20 3d 20 68 20 2d 20 31 3b 0a   iStop = h - 1;.
5c80: 20 20 7d 0a 20 20 66 6f 72 28 3b 3b 29 7b 0a 20    }.  for(;;){. 
5c90: 20 20 20 50 67 48 64 72 31 20 2a 2a 70 70 3b 0a     PgHdr1 **pp;.
5ca0: 20 20 20 20 50 67 48 64 72 31 20 2a 70 50 61 67      PgHdr1 *pPag
5cb0: 65 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 68  e;.    assert( h
5cc0: 3c 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 20 29  <pCache->nHash )
5cd0: 3b 0a 20 20 20 20 70 70 20 3d 20 26 70 43 61 63  ;.    pp = &pCac
5ce0: 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 3b 20 0a  he->apHash[h]; .
5cf0: 20 20 20 20 77 68 69 6c 65 28 20 28 70 50 61 67      while( (pPag
5d00: 65 20 3d 20 2a 70 70 29 21 3d 30 20 29 7b 0a 20  e = *pp)!=0 ){. 
5d10: 20 20 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e       if( pPage->
5d20: 69 4b 65 79 3e 3d 69 4c 69 6d 69 74 20 29 7b 0a  iKey>=iLimit ){.
5d30: 20 20 20 20 20 20 20 20 70 43 61 63 68 65 2d 3e          pCache->
5d40: 6e 50 61 67 65 2d 2d 3b 0a 20 20 20 20 20 20 20  nPage--;.       
5d50: 20 2a 70 70 20 3d 20 70 50 61 67 65 2d 3e 70 4e   *pp = pPage->pN
5d60: 65 78 74 3b 0a 20 20 20 20 20 20 20 20 69 66 28  ext;.        if(
5d70: 20 21 70 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65   !pPage->isPinne
5d80: 64 20 29 20 70 63 61 63 68 65 31 50 69 6e 50 61  d ) pcache1PinPa
5d90: 67 65 28 70 50 61 67 65 29 3b 0a 20 20 20 20 20  ge(pPage);.     
5da0: 20 20 20 70 63 61 63 68 65 31 46 72 65 65 50 61     pcache1FreePa
5db0: 67 65 28 70 50 61 67 65 29 3b 0a 20 20 20 20 20  ge(pPage);.     
5dc0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20   }else{.        
5dd0: 70 70 20 3d 20 26 70 50 61 67 65 2d 3e 70 4e 65  pp = &pPage->pNe
5de0: 78 74 3b 0a 20 20 20 20 20 20 20 20 54 45 53 54  xt;.        TEST
5df0: 4f 4e 4c 59 28 20 69 66 28 20 6e 50 61 67 65 3e  ONLY( if( nPage>
5e00: 3d 30 20 29 20 6e 50 61 67 65 2b 2b 3b 20 29 0a  =0 ) nPage++; ).
5e10: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20        }.    }.  
5e20: 20 20 69 66 28 20 68 3d 3d 69 53 74 6f 70 20 29    if( h==iStop )
5e30: 20 62 72 65 61 6b 3b 0a 20 20 20 20 68 20 3d 20   break;.    h = 
5e40: 28 68 2b 31 29 20 25 20 70 43 61 63 68 65 2d 3e  (h+1) % pCache->
5e50: 6e 48 61 73 68 3b 0a 20 20 7d 0a 20 20 61 73 73  nHash;.  }.  ass
5e60: 65 72 74 28 20 6e 50 61 67 65 3c 30 20 7c 7c 20  ert( nPage<0 || 
5e70: 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 3d 3d 28  pCache->nPage==(
5e80: 75 6e 73 69 67 6e 65 64 29 6e 50 61 67 65 20 29  unsigned)nPage )
5e90: 3b 0a 7d 0a 0a 2f 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 2a  ****************
5ee0: 2a 2a 2a 2a 2f 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 20  ****/./******** 
5ef0: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 4d  sqlite3_pcache M
5f00: 65 74 68 6f 64 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a  ethods *********
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: 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 49 6d  *****/../*.** Im
5f40: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20  plementation of 
5f50: 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63  the sqlite3_pcac
5f60: 68 65 2e 78 49 6e 69 74 20 6d 65 74 68 6f 64 2e  he.xInit method.
5f70: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70  .*/.static int p
5f80: 63 61 63 68 65 31 49 6e 69 74 28 76 6f 69 64 20  cache1Init(void 
5f90: 2a 4e 6f 74 55 73 65 64 29 7b 0a 20 20 55 4e 55  *NotUsed){.  UNU
5fa0: 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f  SED_PARAMETER(No
5fb0: 74 55 73 65 64 29 3b 0a 20 20 61 73 73 65 72 74  tUsed);.  assert
5fc0: 28 20 70 63 61 63 68 65 31 2e 69 73 49 6e 69 74  ( pcache1.isInit
5fd0: 3d 3d 30 20 29 3b 0a 20 20 6d 65 6d 73 65 74 28  ==0 );.  memset(
5fe0: 26 70 63 61 63 68 65 31 2c 20 30 2c 20 73 69 7a  &pcache1, 0, siz
5ff0: 65 6f 66 28 70 63 61 63 68 65 31 29 29 3b 0a 0a  eof(pcache1));..
6000: 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54 68 65 20 70  .  /*.  ** The p
6010: 63 61 63 68 65 31 2e 73 65 70 61 72 61 74 65 43  cache1.separateC
6020: 61 63 68 65 20 76 61 72 69 61 62 6c 65 20 69 73  ache variable is
6030: 20 74 72 75 65 20 69 66 20 65 61 63 68 20 50 43   true if each PC
6040: 61 63 68 65 20 68 61 73 20 69 74 73 20 6f 77 6e  ache has its own
6050: 0a 20 20 2a 2a 20 70 72 69 76 61 74 65 20 50 47  .  ** private PG
6060: 72 6f 75 70 20 28 6d 6f 64 65 2d 31 29 2e 20 20  roup (mode-1).  
6070: 70 63 61 63 68 65 31 2e 73 65 70 61 72 61 74 65  pcache1.separate
6080: 43 61 63 68 65 20 69 73 20 66 61 6c 73 65 20 69  Cache is false i
6090: 66 20 74 68 65 20 73 69 6e 67 6c 65 0a 20 20 2a  f the single.  *
60a0: 2a 20 50 47 72 6f 75 70 20 69 6e 20 70 63 61 63  * PGroup in pcac
60b0: 68 65 31 2e 67 72 70 20 69 73 20 75 73 65 64 20  he1.grp is used 
60c0: 66 6f 72 20 61 6c 6c 20 70 61 67 65 20 63 61 63  for all page cac
60d0: 68 65 73 20 28 6d 6f 64 65 2d 32 29 2e 0a 20 20  hes (mode-2)..  
60e0: 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 20 41 6c 77  **.  **   *  Alw
60f0: 61 79 73 20 75 73 65 20 61 20 75 6e 69 66 69 65  ays use a unifie
6100: 64 20 63 61 63 68 65 20 28 6d 6f 64 65 2d 32 29  d cache (mode-2)
6110: 20 69 66 20 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52   if ENABLE_MEMOR
6120: 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 20 20 2a  Y_MANAGEMENT.  *
6130: 2a 0a 20 20 2a 2a 20 20 20 2a 20 20 55 73 65 20  *.  **   *  Use 
6140: 61 20 75 6e 69 66 69 65 64 20 63 61 63 68 65 20  a unified cache 
6150: 69 6e 20 73 69 6e 67 6c 65 2d 74 68 72 65 61 64  in single-thread
6160: 65 64 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 20  ed applications 
6170: 74 68 61 74 20 68 61 76 65 0a 20 20 2a 2a 20 20  that have.  **  
6180: 20 20 20 20 63 6f 6e 66 69 67 75 72 65 64 20 61      configured a
6190: 20 73 74 61 72 74 2d 74 69 6d 65 20 62 75 66 66   start-time buff
61a0: 65 72 20 66 6f 72 20 75 73 65 20 61 73 20 70 61  er for use as pa
61b0: 67 65 2d 63 61 63 68 65 20 6d 65 6d 6f 72 79 20  ge-cache memory 
61c0: 75 73 69 6e 67 0a 20 20 2a 2a 20 20 20 20 20 20  using.  **      
61d0: 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 53  sqlite3_config(S
61e0: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47  QLITE_CONFIG_PAG
61f0: 45 43 41 43 48 45 2c 20 70 42 75 66 2c 20 73 7a  ECACHE, pBuf, sz
6200: 2c 20 4e 29 20 77 69 74 68 20 6e 6f 6e 2d 4e 55  , N) with non-NU
6210: 4c 4c 20 0a 20 20 2a 2a 20 20 20 20 20 20 70 42  LL .  **      pB
6220: 75 66 20 61 72 67 75 6d 65 6e 74 2e 0a 20 20 2a  uf argument..  *
6230: 2a 0a 20 20 2a 2a 20 20 20 2a 20 20 4f 74 68 65  *.  **   *  Othe
6240: 72 77 69 73 65 20 75 73 65 20 73 65 70 61 72 61  rwise use separa
6250: 74 65 20 63 61 63 68 65 73 20 28 6d 6f 64 65 2d  te caches (mode-
6260: 31 29 0a 20 20 2a 2f 0a 23 69 66 20 64 65 66 69  1).  */.#if defi
6270: 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c  ned(SQLITE_ENABL
6280: 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d  E_MEMORY_MANAGEM
6290: 45 4e 54 29 0a 20 20 70 63 61 63 68 65 31 2e 73  ENT).  pcache1.s
62a0: 65 70 61 72 61 74 65 43 61 63 68 65 20 3d 20 30  eparateCache = 0
62b0: 3b 0a 23 65 6c 69 66 20 53 51 4c 49 54 45 5f 54  ;.#elif SQLITE_T
62c0: 48 52 45 41 44 53 41 46 45 0a 20 20 70 63 61 63  HREADSAFE.  pcac
62d0: 68 65 31 2e 73 65 70 61 72 61 74 65 43 61 63 68  he1.separateCach
62e0: 65 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61  e = sqlite3Globa
62f0: 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65 3d 3d 30  lConfig.pPage==0
6300: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
6310: 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 73 71             || sq
6320: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69  lite3GlobalConfi
6330: 67 2e 62 43 6f 72 65 4d 75 74 65 78 3e 30 3b 0a  g.bCoreMutex>0;.
6340: 23 65 6c 73 65 0a 20 20 70 63 61 63 68 65 31 2e  #else.  pcache1.
6350: 73 65 70 61 72 61 74 65 43 61 63 68 65 20 3d 20  separateCache = 
6360: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
6370: 66 69 67 2e 70 50 61 67 65 3d 3d 30 3b 0a 23 65  fig.pPage==0;.#e
6380: 6e 64 69 66 0a 0a 23 69 66 20 53 51 4c 49 54 45  ndif..#if SQLITE
6390: 5f 54 48 52 45 41 44 53 41 46 45 0a 20 20 69 66  _THREADSAFE.  if
63a0: 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43  ( sqlite3GlobalC
63b0: 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78  onfig.bCoreMutex
63c0: 20 29 7b 0a 20 20 20 20 70 63 61 63 68 65 31 2e   ){.    pcache1.
63d0: 67 72 70 2e 6d 75 74 65 78 20 3d 20 73 71 6c 69  grp.mutex = sqli
63e0: 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51  te3MutexAlloc(SQ
63f0: 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49  LITE_MUTEX_STATI
6400: 43 5f 4c 52 55 29 3b 0a 20 20 20 20 70 63 61 63  C_LRU);.    pcac
6410: 68 65 31 2e 6d 75 74 65 78 20 3d 20 73 71 6c 69  he1.mutex = sqli
6420: 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51  te3MutexAlloc(SQ
6430: 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49  LITE_MUTEX_STATI
6440: 43 5f 50 4d 45 4d 29 3b 0a 20 20 7d 0a 23 65 6e  C_PMEM);.  }.#en
6450: 64 69 66 0a 20 20 69 66 28 20 70 63 61 63 68 65  dif.  if( pcache
6460: 31 2e 73 65 70 61 72 61 74 65 43 61 63 68 65 0a  1.separateCache.
6470: 20 20 20 26 26 20 73 71 6c 69 74 65 33 47 6c 6f     && sqlite3Glo
6480: 62 61 6c 43 6f 6e 66 69 67 2e 6e 50 61 67 65 21  balConfig.nPage!
6490: 3d 30 0a 20 20 20 26 26 20 73 71 6c 69 74 65 33  =0.   && sqlite3
64a0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61  GlobalConfig.pPa
64b0: 67 65 3d 3d 30 0a 20 20 29 7b 0a 20 20 20 20 70  ge==0.  ){.    p
64c0: 63 61 63 68 65 31 2e 6e 49 6e 69 74 50 61 67 65  cache1.nInitPage
64d0: 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c   = sqlite3Global
64e0: 43 6f 6e 66 69 67 2e 6e 50 61 67 65 3b 0a 20 20  Config.nPage;.  
64f0: 7d 65 6c 73 65 7b 0a 20 20 20 20 70 63 61 63 68  }else{.    pcach
6500: 65 31 2e 6e 49 6e 69 74 50 61 67 65 20 3d 20 30  e1.nInitPage = 0
6510: 3b 0a 20 20 7d 0a 20 20 70 63 61 63 68 65 31 2e  ;.  }.  pcache1.
6520: 67 72 70 2e 6d 78 50 69 6e 6e 65 64 20 3d 20 31  grp.mxPinned = 1
6530: 30 3b 0a 20 20 70 63 61 63 68 65 31 2e 69 73 49  0;.  pcache1.isI
6540: 6e 69 74 20 3d 20 31 3b 0a 20 20 72 65 74 75 72  nit = 1;.  retur
6550: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a  n SQLITE_OK;.}..
6560: 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61  /*.** Implementa
6570: 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69  tion of the sqli
6580: 74 65 33 5f 70 63 61 63 68 65 2e 78 53 68 75 74  te3_pcache.xShut
6590: 64 6f 77 6e 20 6d 65 74 68 6f 64 2e 0a 2a 2a 20  down method..** 
65a0: 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 73 74  Note that the st
65b0: 61 74 69 63 20 6d 75 74 65 78 20 61 6c 6c 6f 63  atic mutex alloc
65c0: 61 74 65 64 20 69 6e 20 78 49 6e 69 74 20 64 6f  ated in xInit do
65d0: 65 73 20 0a 2a 2a 20 6e 6f 74 20 6e 65 65 64 20  es .** not need 
65e0: 74 6f 20 62 65 20 66 72 65 65 64 2e 0a 2a 2f 0a  to be freed..*/.
65f0: 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63  static void pcac
6600: 68 65 31 53 68 75 74 64 6f 77 6e 28 76 6f 69 64  he1Shutdown(void
6610: 20 2a 4e 6f 74 55 73 65 64 29 7b 0a 20 20 55 4e   *NotUsed){.  UN
6620: 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 4e  USED_PARAMETER(N
6630: 6f 74 55 73 65 64 29 3b 0a 20 20 61 73 73 65 72  otUsed);.  asser
6640: 74 28 20 70 63 61 63 68 65 31 2e 69 73 49 6e 69  t( pcache1.isIni
6650: 74 21 3d 30 20 29 3b 0a 20 20 6d 65 6d 73 65 74  t!=0 );.  memset
6660: 28 26 70 63 61 63 68 65 31 2c 20 30 2c 20 73 69  (&pcache1, 0, si
6670: 7a 65 6f 66 28 70 63 61 63 68 65 31 29 29 3b 0a  zeof(pcache1));.
6680: 7d 0a 0a 2f 2a 20 66 6f 72 77 61 72 64 20 64 65  }../* forward de
6690: 63 6c 61 72 61 74 69 6f 6e 20 2a 2f 0a 73 74 61  claration */.sta
66a0: 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31  tic void pcache1
66b0: 44 65 73 74 72 6f 79 28 73 71 6c 69 74 65 33 5f  Destroy(sqlite3_
66c0: 70 63 61 63 68 65 20 2a 70 29 3b 0a 0a 2f 2a 0a  pcache *p);../*.
66d0: 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  ** Implementatio
66e0: 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33  n of the sqlite3
66f0: 5f 70 63 61 63 68 65 2e 78 43 72 65 61 74 65 20  _pcache.xCreate 
6700: 6d 65 74 68 6f 64 2e 0a 2a 2a 0a 2a 2a 20 41 6c  method..**.** Al
6710: 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 63 61 63  locate a new cac
6720: 68 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 73 71  he..*/.static sq
6730: 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 63  lite3_pcache *pc
6740: 61 63 68 65 31 43 72 65 61 74 65 28 69 6e 74 20  ache1Create(int 
6750: 73 7a 50 61 67 65 2c 20 69 6e 74 20 73 7a 45 78  szPage, int szEx
6760: 74 72 61 2c 20 69 6e 74 20 62 50 75 72 67 65 61  tra, int bPurgea
6770: 62 6c 65 29 7b 0a 20 20 50 43 61 63 68 65 31 20  ble){.  PCache1 
6780: 2a 70 43 61 63 68 65 3b 20 20 20 20 20 20 2f 2a  *pCache;      /*
6790: 20 54 68 65 20 6e 65 77 6c 79 20 63 72 65 61 74   The newly creat
67a0: 65 64 20 70 61 67 65 20 63 61 63 68 65 20 2a 2f  ed page cache */
67b0: 0a 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f 75  .  PGroup *pGrou
67c0: 70 3b 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20  p;       /* The 
67d0: 67 72 6f 75 70 20 74 68 65 20 6e 65 77 20 70 61  group the new pa
67e0: 67 65 20 63 61 63 68 65 20 77 69 6c 6c 20 62 65  ge cache will be
67f0: 6c 6f 6e 67 20 74 6f 20 2a 2f 0a 20 20 69 6e 74  long to */.  int
6800: 20 73 7a 3b 20 20 20 20 20 20 20 20 20 20 20 20   sz;            
6810: 20 20 20 2f 2a 20 42 79 74 65 73 20 6f 66 20 6d     /* Bytes of m
6820: 65 6d 6f 72 79 20 72 65 71 75 69 72 65 64 20 74  emory required t
6830: 6f 20 61 6c 6c 6f 63 61 74 65 20 74 68 65 20 6e  o allocate the n
6840: 65 77 20 63 61 63 68 65 20 2a 2f 0a 0a 20 20 61  ew cache */..  a
6850: 73 73 65 72 74 28 20 28 73 7a 50 61 67 65 20 26  ssert( (szPage &
6860: 20 28 73 7a 50 61 67 65 2d 31 29 29 3d 3d 30 20   (szPage-1))==0 
6870: 26 26 20 73 7a 50 61 67 65 3e 3d 35 31 32 20 26  && szPage>=512 &
6880: 26 20 73 7a 50 61 67 65 3c 3d 36 35 35 33 36 20  & szPage<=65536 
6890: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 7a 45  );.  assert( szE
68a0: 78 74 72 61 20 3c 20 33 30 30 20 29 3b 0a 0a 20  xtra < 300 );.. 
68b0: 20 73 7a 20 3d 20 73 69 7a 65 6f 66 28 50 43 61   sz = sizeof(PCa
68c0: 63 68 65 31 29 20 2b 20 73 69 7a 65 6f 66 28 50  che1) + sizeof(P
68d0: 47 72 6f 75 70 29 2a 70 63 61 63 68 65 31 2e 73  Group)*pcache1.s
68e0: 65 70 61 72 61 74 65 43 61 63 68 65 3b 0a 20 20  eparateCache;.  
68f0: 70 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 65  pCache = (PCache
6900: 31 20 2a 29 73 71 6c 69 74 65 33 4d 61 6c 6c 6f  1 *)sqlite3Mallo
6910: 63 5a 65 72 6f 28 73 7a 29 3b 0a 20 20 69 66 28  cZero(sz);.  if(
6920: 20 70 43 61 63 68 65 20 29 7b 0a 20 20 20 20 69   pCache ){.    i
6930: 66 28 20 70 63 61 63 68 65 31 2e 73 65 70 61 72  f( pcache1.separ
6940: 61 74 65 43 61 63 68 65 20 29 7b 0a 20 20 20 20  ateCache ){.    
6950: 20 20 70 47 72 6f 75 70 20 3d 20 28 50 47 72 6f    pGroup = (PGro
6960: 75 70 2a 29 26 70 43 61 63 68 65 5b 31 5d 3b 0a  up*)&pCache[1];.
6970: 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e 6d 78        pGroup->mx
6980: 50 69 6e 6e 65 64 20 3d 20 31 30 3b 0a 20 20 20  Pinned = 10;.   
6990: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 47   }else{.      pG
69a0: 72 6f 75 70 20 3d 20 26 70 63 61 63 68 65 31 2e  roup = &pcache1.
69b0: 67 72 70 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69  grp;.    }.    i
69c0: 66 28 20 70 47 72 6f 75 70 2d 3e 6c 72 75 2e 69  f( pGroup->lru.i
69d0: 73 41 6e 63 68 6f 72 3d 3d 30 20 29 7b 0a 20 20  sAnchor==0 ){.  
69e0: 20 20 20 20 70 47 72 6f 75 70 2d 3e 6c 72 75 2e      pGroup->lru.
69f0: 69 73 41 6e 63 68 6f 72 20 3d 20 31 3b 0a 20 20  isAnchor = 1;.  
6a00: 20 20 20 20 70 47 72 6f 75 70 2d 3e 6c 72 75 2e      pGroup->lru.
6a10: 70 4c 72 75 50 72 65 76 20 3d 20 70 47 72 6f 75  pLruPrev = pGrou
6a20: 70 2d 3e 6c 72 75 2e 70 4c 72 75 4e 65 78 74 20  p->lru.pLruNext 
6a30: 3d 20 26 70 47 72 6f 75 70 2d 3e 6c 72 75 3b 0a  = &pGroup->lru;.
6a40: 20 20 20 20 7d 0a 20 20 20 20 70 43 61 63 68 65      }.    pCache
6a50: 2d 3e 70 47 72 6f 75 70 20 3d 20 70 47 72 6f 75  ->pGroup = pGrou
6a60: 70 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 73  p;.    pCache->s
6a70: 7a 50 61 67 65 20 3d 20 73 7a 50 61 67 65 3b 0a  zPage = szPage;.
6a80: 20 20 20 20 70 43 61 63 68 65 2d 3e 73 7a 45 78      pCache->szEx
6a90: 74 72 61 20 3d 20 73 7a 45 78 74 72 61 3b 0a 20  tra = szExtra;. 
6aa0: 20 20 20 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c     pCache->szAll
6ab0: 6f 63 20 3d 20 73 7a 50 61 67 65 20 2b 20 73 7a  oc = szPage + sz
6ac0: 45 78 74 72 61 20 2b 20 52 4f 55 4e 44 38 28 73  Extra + ROUND8(s
6ad0: 69 7a 65 6f 66 28 50 67 48 64 72 31 29 29 3b 0a  izeof(PgHdr1));.
6ae0: 20 20 20 20 70 43 61 63 68 65 2d 3e 62 50 75 72      pCache->bPur
6af0: 67 65 61 62 6c 65 20 3d 20 28 62 50 75 72 67 65  geable = (bPurge
6b00: 61 62 6c 65 20 3f 20 31 20 3a 20 30 29 3b 0a 20  able ? 1 : 0);. 
6b10: 20 20 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d     pcache1EnterM
6b20: 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20 20  utex(pGroup);.  
6b30: 20 20 70 63 61 63 68 65 31 52 65 73 69 7a 65 48    pcache1ResizeH
6b40: 61 73 68 28 70 43 61 63 68 65 29 3b 0a 20 20 20  ash(pCache);.   
6b50: 20 69 66 28 20 62 50 75 72 67 65 61 62 6c 65 20   if( bPurgeable 
6b60: 29 7b 0a 20 20 20 20 20 20 70 43 61 63 68 65 2d  ){.      pCache-
6b70: 3e 6e 4d 69 6e 20 3d 20 31 30 3b 0a 20 20 20 20  >nMin = 10;.    
6b80: 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61    pGroup->nMinPa
6b90: 67 65 20 2b 3d 20 70 43 61 63 68 65 2d 3e 6e 4d  ge += pCache->nM
6ba0: 69 6e 3b 0a 20 20 20 20 20 20 70 47 72 6f 75 70  in;.      pGroup
6bb0: 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 20 70 47 72  ->mxPinned = pGr
6bc0: 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 2b 20  oup->nMaxPage + 
6bd0: 31 30 20 2d 20 70 47 72 6f 75 70 2d 3e 6e 4d 69  10 - pGroup->nMi
6be0: 6e 50 61 67 65 3b 0a 20 20 20 20 7d 0a 20 20 20  nPage;.    }.   
6bf0: 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74   pcache1LeaveMut
6c00: 65 78 28 70 47 72 6f 75 70 29 3b 0a 20 20 20 20  ex(pGroup);.    
6c10: 69 66 28 20 70 43 61 63 68 65 2d 3e 6e 48 61 73  if( pCache->nHas
6c20: 68 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 70 63  h==0 ){.      pc
6c30: 61 63 68 65 31 44 65 73 74 72 6f 79 28 28 73 71  ache1Destroy((sq
6c40: 6c 69 74 65 33 5f 70 63 61 63 68 65 2a 29 70 43  lite3_pcache*)pC
6c50: 61 63 68 65 29 3b 0a 20 20 20 20 20 20 70 43 61  ache);.      pCa
6c60: 63 68 65 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20  che = 0;.    }. 
6c70: 20 7d 0a 20 20 72 65 74 75 72 6e 20 28 73 71 6c   }.  return (sql
6c80: 69 74 65 33 5f 70 63 61 63 68 65 20 2a 29 70 43  ite3_pcache *)pC
6c90: 61 63 68 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49  ache;.}../*.** I
6ca0: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66  mplementation of
6cb0: 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61   the sqlite3_pca
6cc0: 63 68 65 2e 78 43 61 63 68 65 73 69 7a 65 20 6d  che.xCachesize m
6cd0: 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 43 6f  ethod. .**.** Co
6ce0: 6e 66 69 67 75 72 65 20 74 68 65 20 63 61 63 68  nfigure the cach
6cf0: 65 5f 73 69 7a 65 20 6c 69 6d 69 74 20 66 6f 72  e_size limit for
6d00: 20 61 20 63 61 63 68 65 2e 0a 2a 2f 0a 73 74 61   a cache..*/.sta
6d10: 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31  tic void pcache1
6d20: 43 61 63 68 65 73 69 7a 65 28 73 71 6c 69 74 65  Cachesize(sqlite
6d30: 33 5f 70 63 61 63 68 65 20 2a 70 2c 20 69 6e 74  3_pcache *p, int
6d40: 20 6e 4d 61 78 29 7b 0a 20 20 50 43 61 63 68 65   nMax){.  PCache
6d50: 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61  1 *pCache = (PCa
6d60: 63 68 65 31 20 2a 29 70 3b 0a 20 20 69 66 28 20  che1 *)p;.  if( 
6d70: 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62  pCache->bPurgeab
6d80: 6c 65 20 29 7b 0a 20 20 20 20 50 47 72 6f 75 70  le ){.    PGroup
6d90: 20 2a 70 47 72 6f 75 70 20 3d 20 70 43 61 63 68   *pGroup = pCach
6da0: 65 2d 3e 70 47 72 6f 75 70 3b 0a 20 20 20 20 70  e->pGroup;.    p
6db0: 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78  cache1EnterMutex
6dc0: 28 70 47 72 6f 75 70 29 3b 0a 20 20 20 20 70 47  (pGroup);.    pG
6dd0: 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 2b  roup->nMaxPage +
6de0: 3d 20 28 6e 4d 61 78 20 2d 20 70 43 61 63 68 65  = (nMax - pCache
6df0: 2d 3e 6e 4d 61 78 29 3b 0a 20 20 20 20 70 47 72  ->nMax);.    pGr
6e00: 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 20  oup->mxPinned = 
6e10: 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65  pGroup->nMaxPage
6e20: 20 2b 20 31 30 20 2d 20 70 47 72 6f 75 70 2d 3e   + 10 - pGroup->
6e30: 6e 4d 69 6e 50 61 67 65 3b 0a 20 20 20 20 70 43  nMinPage;.    pC
6e40: 61 63 68 65 2d 3e 6e 4d 61 78 20 3d 20 6e 4d 61  ache->nMax = nMa
6e50: 78 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 6e  x;.    pCache->n
6e60: 39 30 70 63 74 20 3d 20 70 43 61 63 68 65 2d 3e  90pct = pCache->
6e70: 6e 4d 61 78 2a 39 2f 31 30 3b 0a 20 20 20 20 70  nMax*9/10;.    p
6e80: 63 61 63 68 65 31 45 6e 66 6f 72 63 65 4d 61 78  cache1EnforceMax
6e90: 50 61 67 65 28 70 43 61 63 68 65 29 3b 0a 20 20  Page(pCache);.  
6ea0: 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75    pcache1LeaveMu
6eb0: 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20 20 7d  tex(pGroup);.  }
6ec0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d  .}../*.** Implem
6ed0: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20  entation of the 
6ee0: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78  sqlite3_pcache.x
6ef0: 53 68 72 69 6e 6b 20 6d 65 74 68 6f 64 2e 20 0a  Shrink method. .
6f00: 2a 2a 0a 2a 2a 20 46 72 65 65 20 75 70 20 61 73  **.** Free up as
6f10: 20 6d 75 63 68 20 6d 65 6d 6f 72 79 20 61 73 20   much memory as 
6f20: 70 6f 73 73 69 62 6c 65 2e 0a 2a 2f 0a 73 74 61  possible..*/.sta
6f30: 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31  tic void pcache1
6f40: 53 68 72 69 6e 6b 28 73 71 6c 69 74 65 33 5f 70  Shrink(sqlite3_p
6f50: 63 61 63 68 65 20 2a 70 29 7b 0a 20 20 50 43 61  cache *p){.  PCa
6f60: 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28  che1 *pCache = (
6f70: 50 43 61 63 68 65 31 2a 29 70 3b 0a 20 20 69 66  PCache1*)p;.  if
6f80: 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65  ( pCache->bPurge
6f90: 61 62 6c 65 20 29 7b 0a 20 20 20 20 50 47 72 6f  able ){.    PGro
6fa0: 75 70 20 2a 70 47 72 6f 75 70 20 3d 20 70 43 61  up *pGroup = pCa
6fb0: 63 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20 20 20  che->pGroup;.   
6fc0: 20 69 6e 74 20 73 61 76 65 64 4d 61 78 50 61 67   int savedMaxPag
6fd0: 65 3b 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e  e;.    pcache1En
6fe0: 74 65 72 4d 75 74 65 78 28 70 47 72 6f 75 70 29  terMutex(pGroup)
6ff0: 3b 0a 20 20 20 20 73 61 76 65 64 4d 61 78 50 61  ;.    savedMaxPa
7000: 67 65 20 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d 61  ge = pGroup->nMa
7010: 78 50 61 67 65 3b 0a 20 20 20 20 70 47 72 6f 75  xPage;.    pGrou
7020: 70 2d 3e 6e 4d 61 78 50 61 67 65 20 3d 20 30 3b  p->nMaxPage = 0;
7030: 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e 66 6f  .    pcache1Enfo
7040: 72 63 65 4d 61 78 50 61 67 65 28 70 43 61 63 68  rceMaxPage(pCach
7050: 65 29 3b 0a 20 20 20 20 70 47 72 6f 75 70 2d 3e  e);.    pGroup->
7060: 6e 4d 61 78 50 61 67 65 20 3d 20 73 61 76 65 64  nMaxPage = saved
7070: 4d 61 78 50 61 67 65 3b 0a 20 20 20 20 70 63 61  MaxPage;.    pca
7080: 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70  che1LeaveMutex(p
7090: 47 72 6f 75 70 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f  Group);.  }.}../
70a0: 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74  *.** Implementat
70b0: 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74  ion of the sqlit
70c0: 65 33 5f 70 63 61 63 68 65 2e 78 50 61 67 65 63  e3_pcache.xPagec
70d0: 6f 75 6e 74 20 6d 65 74 68 6f 64 2e 20 0a 2a 2f  ount method. .*/
70e0: 0a 73 74 61 74 69 63 20 69 6e 74 20 70 63 61 63  .static int pcac
70f0: 68 65 31 50 61 67 65 63 6f 75 6e 74 28 73 71 6c  he1Pagecount(sql
7100: 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 29 7b  ite3_pcache *p){
7110: 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 50 43 61 63  .  int n;.  PCac
7120: 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50  he1 *pCache = (P
7130: 43 61 63 68 65 31 2a 29 70 3b 0a 20 20 70 63 61  Cache1*)p;.  pca
7140: 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70  che1EnterMutex(p
7150: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a  Cache->pGroup);.
7160: 20 20 6e 20 3d 20 70 43 61 63 68 65 2d 3e 6e 50    n = pCache->nP
7170: 61 67 65 3b 0a 20 20 70 63 61 63 68 65 31 4c 65  age;.  pcache1Le
7180: 61 76 65 4d 75 74 65 78 28 70 43 61 63 68 65 2d  aveMutex(pCache-
7190: 3e 70 47 72 6f 75 70 29 3b 0a 20 20 72 65 74 75  >pGroup);.  retu
71a0: 72 6e 20 6e 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20  rn n;.}.../*.** 
71b0: 49 6d 70 6c 65 6d 65 6e 74 20 73 74 65 70 73 20  Implement steps 
71c0: 33 2c 20 34 2c 20 61 6e 64 20 35 20 6f 66 20 74  3, 4, and 5 of t
71d0: 68 65 20 70 63 61 63 68 65 31 46 65 74 63 68 28  he pcache1Fetch(
71e0: 29 20 61 6c 67 6f 72 69 74 68 6d 20 64 65 73 63  ) algorithm desc
71f0: 72 69 62 65 64 0a 2a 2a 20 69 6e 20 74 68 65 20  ribed.** in the 
7200: 68 65 61 64 65 72 20 6f 66 20 74 68 65 20 70 63  header of the pc
7210: 61 63 68 65 31 46 65 74 63 68 28 29 20 70 72 6f  ache1Fetch() pro
7220: 63 65 64 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 54 68  cedure..**.** Th
7230: 69 73 20 73 74 65 70 73 20 61 72 65 20 62 72 6f  is steps are bro
7240: 6b 65 6e 20 6f 75 74 20 69 6e 74 6f 20 61 20 73  ken out into a s
7250: 65 70 61 72 61 74 65 20 70 72 6f 63 65 64 75 72  eparate procedur
7260: 65 20 62 65 63 61 75 73 65 20 74 68 65 79 20 61  e because they a
7270: 72 65 0a 2a 2a 20 75 73 75 61 6c 6c 79 20 6e 6f  re.** usually no
7280: 74 20 6e 65 65 64 65 64 2c 20 61 6e 64 20 62 79  t needed, and by
7290: 20 61 76 6f 69 64 69 6e 67 20 74 68 65 20 73 74   avoiding the st
72a0: 61 63 6b 20 69 6e 69 74 69 61 6c 69 7a 61 74 69  ack initializati
72b0: 6f 6e 20 72 65 71 75 69 72 65 64 0a 2a 2a 20 66  on required.** f
72c0: 6f 72 20 74 68 65 73 65 20 73 74 65 70 73 2c 20  or these steps, 
72d0: 74 68 65 20 6d 61 69 6e 20 70 63 61 63 68 65 31  the main pcache1
72e0: 46 65 74 63 68 28 29 20 70 72 6f 63 65 64 75 72  Fetch() procedur
72f0: 65 20 63 61 6e 20 72 75 6e 20 66 61 73 74 65 72  e can run faster
7300: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 53 51 4c 49  ..*/.static SQLI
7310: 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20 50 67 48 64  TE_NOINLINE PgHd
7320: 72 31 20 2a 70 63 61 63 68 65 31 46 65 74 63 68  r1 *pcache1Fetch
7330: 53 74 61 67 65 32 28 0a 20 20 50 43 61 63 68 65  Stage2(.  PCache
7340: 31 20 2a 70 43 61 63 68 65 2c 20 0a 20 20 75 6e  1 *pCache, .  un
7350: 73 69 67 6e 65 64 20 69 6e 74 20 69 4b 65 79 2c  signed int iKey,
7360: 20 0a 20 20 69 6e 74 20 63 72 65 61 74 65 46 6c   .  int createFl
7370: 61 67 0a 29 7b 0a 20 20 75 6e 73 69 67 6e 65 64  ag.){.  unsigned
7380: 20 69 6e 74 20 6e 50 69 6e 6e 65 64 3b 0a 20 20   int nPinned;.  
7390: 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70 20 3d  PGroup *pGroup =
73a0: 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3b   pCache->pGroup;
73b0: 0a 20 20 50 67 48 64 72 31 20 2a 70 50 61 67 65  .  PgHdr1 *pPage
73c0: 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20 53 74 65 70   = 0;..  /* Step
73d0: 20 33 3a 20 41 62 6f 72 74 20 69 66 20 63 72 65   3: Abort if cre
73e0: 61 74 65 46 6c 61 67 20 69 73 20 31 20 62 75 74  ateFlag is 1 but
73f0: 20 74 68 65 20 63 61 63 68 65 20 69 73 20 6e 65   the cache is ne
7400: 61 72 6c 79 20 66 75 6c 6c 20 2a 2f 0a 20 20 61  arly full */.  a
7410: 73 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 6e  ssert( pCache->n
7420: 50 61 67 65 20 3e 3d 20 70 43 61 63 68 65 2d 3e  Page >= pCache->
7430: 6e 52 65 63 79 63 6c 61 62 6c 65 20 29 3b 0a 20  nRecyclable );. 
7440: 20 6e 50 69 6e 6e 65 64 20 3d 20 70 43 61 63 68   nPinned = pCach
7450: 65 2d 3e 6e 50 61 67 65 20 2d 20 70 43 61 63 68  e->nPage - pCach
7460: 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65 3b 0a  e->nRecyclable;.
7470: 20 20 61 73 73 65 72 74 28 20 70 47 72 6f 75 70    assert( pGroup
7480: 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 3d 20 70 47  ->mxPinned == pG
7490: 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 2b  roup->nMaxPage +
74a0: 20 31 30 20 2d 20 70 47 72 6f 75 70 2d 3e 6e 4d   10 - pGroup->nM
74b0: 69 6e 50 61 67 65 20 29 3b 0a 20 20 61 73 73 65  inPage );.  asse
74c0: 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 39 30 70  rt( pCache->n90p
74d0: 63 74 20 3d 3d 20 70 43 61 63 68 65 2d 3e 6e 4d  ct == pCache->nM
74e0: 61 78 2a 39 2f 31 30 20 29 3b 0a 20 20 69 66 28  ax*9/10 );.  if(
74f0: 20 63 72 65 61 74 65 46 6c 61 67 3d 3d 31 20 26   createFlag==1 &
7500: 26 20 28 0a 20 20 20 20 20 20 20 20 6e 50 69 6e  & (.        nPin
7510: 6e 65 64 3e 3d 70 47 72 6f 75 70 2d 3e 6d 78 50  ned>=pGroup->mxP
7520: 69 6e 6e 65 64 0a 20 20 20 20 20 7c 7c 20 6e 50  inned.     || nP
7530: 69 6e 6e 65 64 3e 3d 70 43 61 63 68 65 2d 3e 6e  inned>=pCache->n
7540: 39 30 70 63 74 0a 20 20 20 20 20 7c 7c 20 28 70  90pct.     || (p
7550: 63 61 63 68 65 31 55 6e 64 65 72 4d 65 6d 6f 72  cache1UnderMemor
7560: 79 50 72 65 73 73 75 72 65 28 70 43 61 63 68 65  yPressure(pCache
7570: 29 20 26 26 20 70 43 61 63 68 65 2d 3e 6e 52 65  ) && pCache->nRe
7580: 63 79 63 6c 61 62 6c 65 3c 6e 50 69 6e 6e 65 64  cyclable<nPinned
7590: 29 0a 20 20 29 29 7b 0a 20 20 20 20 72 65 74 75  ).  )){.    retu
75a0: 72 6e 20 30 3b 0a 20 20 7d 0a 0a 20 20 69 66 28  rn 0;.  }..  if(
75b0: 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 3e 3d   pCache->nPage>=
75c0: 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 20 29 20  pCache->nHash ) 
75d0: 70 63 61 63 68 65 31 52 65 73 69 7a 65 48 61 73  pcache1ResizeHas
75e0: 68 28 70 43 61 63 68 65 29 3b 0a 20 20 61 73 73  h(pCache);.  ass
75f0: 65 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 48 61  ert( pCache->nHa
7600: 73 68 3e 30 20 26 26 20 70 43 61 63 68 65 2d 3e  sh>0 && pCache->
7610: 61 70 48 61 73 68 20 29 3b 0a 0a 20 20 2f 2a 20  apHash );..  /* 
7620: 53 74 65 70 20 34 2e 20 54 72 79 20 74 6f 20 72  Step 4. Try to r
7630: 65 63 79 63 6c 65 20 61 20 70 61 67 65 2e 20 2a  ecycle a page. *
7640: 2f 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e  /.  if( pCache->
7650: 62 50 75 72 67 65 61 62 6c 65 0a 20 20 20 26 26  bPurgeable.   &&
7660: 20 21 70 47 72 6f 75 70 2d 3e 6c 72 75 2e 70 4c   !pGroup->lru.pL
7670: 72 75 50 72 65 76 2d 3e 69 73 41 6e 63 68 6f 72  ruPrev->isAnchor
7680: 0a 20 20 20 26 26 20 28 28 70 43 61 63 68 65 2d  .   && ((pCache-
7690: 3e 6e 50 61 67 65 2b 31 3e 3d 70 43 61 63 68 65  >nPage+1>=pCache
76a0: 2d 3e 6e 4d 61 78 29 20 7c 7c 20 70 63 61 63 68  ->nMax) || pcach
76b0: 65 31 55 6e 64 65 72 4d 65 6d 6f 72 79 50 72 65  e1UnderMemoryPre
76c0: 73 73 75 72 65 28 70 43 61 63 68 65 29 29 0a 20  ssure(pCache)). 
76d0: 20 29 7b 0a 20 20 20 20 50 43 61 63 68 65 31 20   ){.    PCache1 
76e0: 2a 70 4f 74 68 65 72 3b 0a 20 20 20 20 70 50 61  *pOther;.    pPa
76f0: 67 65 20 3d 20 70 47 72 6f 75 70 2d 3e 6c 72 75  ge = pGroup->lru
7700: 2e 70 4c 72 75 50 72 65 76 3b 0a 20 20 20 20 61  .pLruPrev;.    a
7710: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 69 73  ssert( pPage->is
7720: 50 69 6e 6e 65 64 3d 3d 30 20 29 3b 0a 20 20 20  Pinned==0 );.   
7730: 20 70 63 61 63 68 65 31 52 65 6d 6f 76 65 46 72   pcache1RemoveFr
7740: 6f 6d 48 61 73 68 28 70 50 61 67 65 2c 20 30 29  omHash(pPage, 0)
7750: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 50 69 6e  ;.    pcache1Pin
7760: 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 20 20  Page(pPage);.   
7770: 20 70 4f 74 68 65 72 20 3d 20 70 50 61 67 65 2d   pOther = pPage-
7780: 3e 70 43 61 63 68 65 3b 0a 20 20 20 20 69 66 28  >pCache;.    if(
7790: 20 70 4f 74 68 65 72 2d 3e 73 7a 41 6c 6c 6f 63   pOther->szAlloc
77a0: 20 21 3d 20 70 43 61 63 68 65 2d 3e 73 7a 41 6c   != pCache->szAl
77b0: 6c 6f 63 20 29 7b 0a 20 20 20 20 20 20 70 63 61  loc ){.      pca
77c0: 63 68 65 31 46 72 65 65 50 61 67 65 28 70 50 61  che1FreePage(pPa
77d0: 67 65 29 3b 0a 20 20 20 20 20 20 70 50 61 67 65  ge);.      pPage
77e0: 20 3d 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65 7b   = 0;.    }else{
77f0: 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e  .      pGroup->n
7800: 43 75 72 72 65 6e 74 50 61 67 65 20 2d 3d 20 28  CurrentPage -= (
7810: 70 4f 74 68 65 72 2d 3e 62 50 75 72 67 65 61 62  pOther->bPurgeab
7820: 6c 65 20 2d 20 70 43 61 63 68 65 2d 3e 62 50 75  le - pCache->bPu
7830: 72 67 65 61 62 6c 65 29 3b 0a 20 20 20 20 7d 0a  rgeable);.    }.
7840: 20 20 7d 0a 0a 20 20 2f 2a 20 53 74 65 70 20 35    }..  /* Step 5
7850: 2e 20 49 66 20 61 20 75 73 61 62 6c 65 20 70 61  . If a usable pa
7860: 67 65 20 62 75 66 66 65 72 20 68 61 73 20 73 74  ge buffer has st
7870: 69 6c 6c 20 6e 6f 74 20 62 65 65 6e 20 66 6f 75  ill not been fou
7880: 6e 64 2c 20 0a 20 20 2a 2a 20 61 74 74 65 6d 70  nd, .  ** attemp
7890: 74 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 61 20  t to allocate a 
78a0: 6e 65 77 20 6f 6e 65 2e 20 0a 20 20 2a 2f 0a 20  new one. .  */. 
78b0: 20 69 66 28 20 21 70 50 61 67 65 20 29 7b 0a 20   if( !pPage ){. 
78c0: 20 20 20 70 50 61 67 65 20 3d 20 70 63 61 63 68     pPage = pcach
78d0: 65 31 41 6c 6c 6f 63 50 61 67 65 28 70 43 61 63  e1AllocPage(pCac
78e0: 68 65 2c 20 63 72 65 61 74 65 46 6c 61 67 3d 3d  he, createFlag==
78f0: 31 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70  1);.  }..  if( p
7900: 50 61 67 65 20 29 7b 0a 20 20 20 20 75 6e 73 69  Page ){.    unsi
7910: 67 6e 65 64 20 69 6e 74 20 68 20 3d 20 69 4b 65  gned int h = iKe
7920: 79 20 25 20 70 43 61 63 68 65 2d 3e 6e 48 61 73  y % pCache->nHas
7930: 68 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 6e  h;.    pCache->n
7940: 50 61 67 65 2b 2b 3b 0a 20 20 20 20 70 50 61 67  Page++;.    pPag
7950: 65 2d 3e 69 4b 65 79 20 3d 20 69 4b 65 79 3b 0a  e->iKey = iKey;.
7960: 20 20 20 20 70 50 61 67 65 2d 3e 70 4e 65 78 74      pPage->pNext
7970: 20 3d 20 70 43 61 63 68 65 2d 3e 61 70 48 61 73   = pCache->apHas
7980: 68 5b 68 5d 3b 0a 20 20 20 20 70 50 61 67 65 2d  h[h];.    pPage-
7990: 3e 70 43 61 63 68 65 20 3d 20 70 43 61 63 68 65  >pCache = pCache
79a0: 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 70 4c 72  ;.    pPage->pLr
79b0: 75 50 72 65 76 20 3d 20 30 3b 0a 20 20 20 20 70  uPrev = 0;.    p
79c0: 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74 20 3d  Page->pLruNext =
79d0: 20 30 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69   0;.    pPage->i
79e0: 73 50 69 6e 6e 65 64 20 3d 20 31 3b 0a 20 20 20  sPinned = 1;.   
79f0: 20 2a 28 76 6f 69 64 20 2a 2a 29 70 50 61 67 65   *(void **)pPage
7a00: 2d 3e 70 61 67 65 2e 70 45 78 74 72 61 20 3d 20  ->page.pExtra = 
7a10: 30 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 61  0;.    pCache->a
7a20: 70 48 61 73 68 5b 68 5d 20 3d 20 70 50 61 67 65  pHash[h] = pPage
7a30: 3b 0a 20 20 20 20 69 66 28 20 69 4b 65 79 3e 70  ;.    if( iKey>p
7a40: 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 29  Cache->iMaxKey )
7a50: 7b 0a 20 20 20 20 20 20 70 43 61 63 68 65 2d 3e  {.      pCache->
7a60: 69 4d 61 78 4b 65 79 20 3d 20 69 4b 65 79 3b 0a  iMaxKey = iKey;.
7a70: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75      }.  }.  retu
7a80: 72 6e 20 70 50 61 67 65 3b 0a 7d 0a 0a 2f 2a 0a  rn pPage;.}../*.
7a90: 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  ** Implementatio
7aa0: 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33  n of the sqlite3
7ab0: 5f 70 63 61 63 68 65 2e 78 46 65 74 63 68 20 6d  _pcache.xFetch m
7ac0: 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 46 65  ethod. .**.** Fe
7ad0: 74 63 68 20 61 20 70 61 67 65 20 62 79 20 6b 65  tch a page by ke
7ae0: 79 20 76 61 6c 75 65 2e 0a 2a 2a 0a 2a 2a 20 57  y value..**.** W
7af0: 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 61 20  hether or not a 
7b00: 6e 65 77 20 70 61 67 65 20 6d 61 79 20 62 65 20  new page may be 
7b10: 61 6c 6c 6f 63 61 74 65 64 20 62 79 20 74 68 69  allocated by thi
7b20: 73 20 66 75 6e 63 74 69 6f 6e 20 64 65 70 65 6e  s function depen
7b30: 64 73 20 6f 6e 0a 2a 2a 20 74 68 65 20 76 61 6c  ds on.** the val
7b40: 75 65 20 6f 66 20 74 68 65 20 63 72 65 61 74 65  ue of the create
7b50: 46 6c 61 67 20 61 72 67 75 6d 65 6e 74 2e 20 20  Flag argument.  
7b60: 30 20 6d 65 61 6e 73 20 64 6f 20 6e 6f 74 20 61  0 means do not a
7b70: 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 0a 2a 2a  llocate a new.**
7b80: 20 70 61 67 65 2e 20 20 31 20 6d 65 61 6e 73 20   page.  1 means 
7b90: 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 70  allocate a new p
7ba0: 61 67 65 20 69 66 20 73 70 61 63 65 20 69 73 20  age if space is 
7bb0: 65 61 73 69 6c 79 20 61 76 61 69 6c 61 62 6c 65  easily available
7bc0: 2e 20 20 32 20 0a 2a 2a 20 6d 65 61 6e 73 20 74  .  2 .** means t
7bd0: 6f 20 74 72 79 20 72 65 61 6c 6c 79 20 68 61 72  o try really har
7be0: 64 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 61 20  d to allocate a 
7bf0: 6e 65 77 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20  new page..**.** 
7c00: 46 6f 72 20 61 20 6e 6f 6e 2d 70 75 72 67 65 61  For a non-purgea
7c10: 62 6c 65 20 63 61 63 68 65 20 28 61 20 63 61 63  ble cache (a cac
7c20: 68 65 20 75 73 65 64 20 61 73 20 74 68 65 20 73  he used as the s
7c30: 74 6f 72 61 67 65 20 66 6f 72 20 61 6e 20 69 6e  torage for an in
7c40: 2d 6d 65 6d 6f 72 79 0a 2a 2a 20 64 61 74 61 62  -memory.** datab
7c50: 61 73 65 29 20 74 68 65 72 65 20 69 73 20 72 65  ase) there is re
7c60: 61 6c 6c 79 20 6e 6f 20 64 69 66 66 65 72 65 6e  ally no differen
7c70: 63 65 20 62 65 74 77 65 65 6e 20 63 72 65 61 74  ce between creat
7c80: 65 46 6c 61 67 20 31 20 61 6e 64 20 32 2e 20 20  eFlag 1 and 2.  
7c90: 53 6f 0a 2a 2a 20 74 68 65 20 63 61 6c 6c 69 6e  So.** the callin
7ca0: 67 20 66 75 6e 63 74 69 6f 6e 20 28 70 63 61 63  g function (pcac
7cb0: 68 65 2e 63 29 20 77 69 6c 6c 20 6e 65 76 65 72  he.c) will never
7cc0: 20 68 61 76 65 20 61 20 63 72 65 61 74 65 46 6c   have a createFl
7cd0: 61 67 20 6f 66 20 31 20 6f 6e 0a 2a 2a 20 61 20  ag of 1 on.** a 
7ce0: 6e 6f 6e 2d 70 75 72 67 65 61 62 6c 65 20 63 61  non-purgeable ca
7cf0: 63 68 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 72 65  che..**.** There
7d00: 20 61 72 65 20 74 68 72 65 65 20 64 69 66 66 65   are three diffe
7d10: 72 65 6e 74 20 61 70 70 72 6f 61 63 68 65 73 20  rent approaches 
7d20: 74 6f 20 6f 62 74 61 69 6e 69 6e 67 20 73 70 61  to obtaining spa
7d30: 63 65 20 66 6f 72 20 61 20 70 61 67 65 2c 0a 2a  ce for a page,.*
7d40: 2a 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74  * depending on t
7d50: 68 65 20 76 61 6c 75 65 20 6f 66 20 70 61 72 61  he value of para
7d60: 6d 65 74 65 72 20 63 72 65 61 74 65 46 6c 61 67  meter createFlag
7d70: 20 28 77 68 69 63 68 20 6d 61 79 20 62 65 20 30   (which may be 0
7d80: 2c 20 31 20 6f 72 20 32 29 2e 0a 2a 2a 0a 2a 2a  , 1 or 2)..**.**
7d90: 20 20 20 31 2e 20 52 65 67 61 72 64 6c 65 73 73     1. Regardless
7da0: 20 6f 66 20 74 68 65 20 76 61 6c 75 65 20 6f 66   of the value of
7db0: 20 63 72 65 61 74 65 46 6c 61 67 2c 20 74 68 65   createFlag, the
7dc0: 20 63 61 63 68 65 20 69 73 20 73 65 61 72 63 68   cache is search
7dd0: 65 64 20 66 6f 72 20 61 20 0a 2a 2a 20 20 20 20  ed for a .**    
7de0: 20 20 63 6f 70 79 20 6f 66 20 74 68 65 20 72 65    copy of the re
7df0: 71 75 65 73 74 65 64 20 70 61 67 65 2e 20 49 66  quested page. If
7e00: 20 6f 6e 65 20 69 73 20 66 6f 75 6e 64 2c 20 69   one is found, i
7e10: 74 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a  t is returned..*
7e20: 2a 0a 2a 2a 20 20 20 32 2e 20 49 66 20 63 72 65  *.**   2. If cre
7e30: 61 74 65 46 6c 61 67 3d 3d 30 20 61 6e 64 20 74  ateFlag==0 and t
7e40: 68 65 20 70 61 67 65 20 69 73 20 6e 6f 74 20 61  he page is not a
7e50: 6c 72 65 61 64 79 20 69 6e 20 74 68 65 20 63 61  lready in the ca
7e60: 63 68 65 2c 20 4e 55 4c 4c 20 69 73 0a 2a 2a 20  che, NULL is.** 
7e70: 20 20 20 20 20 72 65 74 75 72 6e 65 64 2e 0a 2a       returned..*
7e80: 2a 0a 2a 2a 20 20 20 33 2e 20 49 66 20 63 72 65  *.**   3. If cre
7e90: 61 74 65 46 6c 61 67 20 69 73 20 31 2c 20 61 6e  ateFlag is 1, an
7ea0: 64 20 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f  d the page is no
7eb0: 74 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65  t already in the
7ec0: 20 63 61 63 68 65 2c 20 74 68 65 6e 0a 2a 2a 20   cache, then.** 
7ed0: 20 20 20 20 20 72 65 74 75 72 6e 20 4e 55 4c 4c       return NULL
7ee0: 20 28 64 6f 20 6e 6f 74 20 61 6c 6c 6f 63 61 74   (do not allocat
7ef0: 65 20 61 20 6e 65 77 20 70 61 67 65 29 20 69 66  e a new page) if
7f00: 20 61 6e 79 20 6f 66 20 74 68 65 20 66 6f 6c 6c   any of the foll
7f10: 6f 77 69 6e 67 0a 2a 2a 20 20 20 20 20 20 63 6f  owing.**      co
7f20: 6e 64 69 74 69 6f 6e 73 20 61 72 65 20 74 72 75  nditions are tru
7f30: 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 28  e:.**.**       (
7f40: 61 29 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  a) the number of
7f50: 20 70 61 67 65 73 20 70 69 6e 6e 65 64 20 62 79   pages pinned by
7f60: 20 74 68 65 20 63 61 63 68 65 20 69 73 20 67 72   the cache is gr
7f70: 65 61 74 65 72 20 74 68 61 6e 0a 2a 2a 20 20 20  eater than.**   
7f80: 20 20 20 20 20 20 20 20 50 43 61 63 68 65 31 2e          PCache1.
7f90: 6e 4d 61 78 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 20  nMax, or.**.**  
7fa0: 20 20 20 20 20 28 62 29 20 74 68 65 20 6e 75 6d       (b) the num
7fb0: 62 65 72 20 6f 66 20 70 61 67 65 73 20 70 69 6e  ber of pages pin
7fc0: 6e 65 64 20 62 79 20 74 68 65 20 63 61 63 68 65  ned by the cache
7fd0: 20 69 73 20 67 72 65 61 74 65 72 20 74 68 61 6e   is greater than
7fe0: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 74 68  .**           th
7ff0: 65 20 73 75 6d 20 6f 66 20 6e 4d 61 78 20 66 6f  e sum of nMax fo
8000: 72 20 61 6c 6c 20 70 75 72 67 65 61 62 6c 65 20  r all purgeable 
8010: 63 61 63 68 65 73 2c 20 6c 65 73 73 20 74 68 65  caches, less the
8020: 20 73 75 6d 20 6f 66 20 0a 2a 2a 20 20 20 20 20   sum of .**     
8030: 20 20 20 20 20 20 6e 4d 69 6e 20 66 6f 72 20 61        nMin for a
8040: 6c 6c 20 6f 74 68 65 72 20 70 75 72 67 65 61 62  ll other purgeab
8050: 6c 65 20 63 61 63 68 65 73 2c 20 6f 72 0a 2a 2a  le caches, or.**
8060: 0a 2a 2a 20 20 20 34 2e 20 49 66 20 6e 6f 6e 65  .**   4. If none
8070: 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 74 68   of the first th
8080: 72 65 65 20 63 6f 6e 64 69 74 69 6f 6e 73 20 61  ree conditions a
8090: 70 70 6c 79 20 61 6e 64 20 74 68 65 20 63 61 63  pply and the cac
80a0: 68 65 20 69 73 20 6d 61 72 6b 65 64 0a 2a 2a 20  he is marked.** 
80b0: 20 20 20 20 20 61 73 20 70 75 72 67 65 61 62 6c       as purgeabl
80c0: 65 2c 20 61 6e 64 20 69 66 20 6f 6e 65 20 6f 66  e, and if one of
80d0: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69   the following i
80e0: 73 20 74 72 75 65 3a 0a 2a 2a 0a 2a 2a 20 20 20  s true:.**.**   
80f0: 20 20 20 20 28 61 29 20 54 68 65 20 6e 75 6d 62      (a) The numb
8100: 65 72 20 6f 66 20 70 61 67 65 73 20 61 6c 6c 6f  er of pages allo
8110: 63 61 74 65 64 20 66 6f 72 20 74 68 65 20 63 61  cated for the ca
8120: 63 68 65 20 69 73 20 61 6c 72 65 61 64 79 20 0a  che is already .
8130: 2a 2a 20 20 20 20 20 20 20 20 20 20 20 50 43 61  **           PCa
8140: 63 68 65 31 2e 6e 4d 61 78 2c 20 6f 72 0a 2a 2a  che1.nMax, or.**
8150: 0a 2a 2a 20 20 20 20 20 20 20 28 62 29 20 54 68  .**       (b) Th
8160: 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65  e number of page
8170: 73 20 61 6c 6c 6f 63 61 74 65 64 20 66 6f 72 20  s allocated for 
8180: 61 6c 6c 20 70 75 72 67 65 61 62 6c 65 20 63 61  all purgeable ca
8190: 63 68 65 73 20 69 73 0a 2a 2a 20 20 20 20 20 20  ches is.**      
81a0: 20 20 20 20 20 61 6c 72 65 61 64 79 20 65 71 75       already equ
81b0: 61 6c 20 74 6f 20 6f 72 20 67 72 65 61 74 65 72  al to or greater
81c0: 20 74 68 61 6e 20 74 68 65 20 73 75 6d 20 6f 66   than the sum of
81d0: 20 6e 4d 61 78 20 66 6f 72 20 61 6c 6c 0a 2a 2a   nMax for all.**
81e0: 20 20 20 20 20 20 20 20 20 20 20 70 75 72 67 65             purge
81f0: 61 62 6c 65 20 63 61 63 68 65 73 2c 0a 2a 2a 0a  able caches,.**.
8200: 2a 2a 20 20 20 20 20 20 20 28 63 29 20 54 68 65  **       (c) The
8210: 20 73 79 73 74 65 6d 20 69 73 20 75 6e 64 65 72   system is under
8220: 20 6d 65 6d 6f 72 79 20 70 72 65 73 73 75 72 65   memory pressure
8230: 20 61 6e 64 20 77 61 6e 74 73 20 74 6f 20 61 76   and wants to av
8240: 6f 69 64 0a 2a 2a 20 20 20 20 20 20 20 20 20 20  oid.**          
8250: 20 75 6e 6e 65 63 65 73 73 61 72 79 20 70 61 67   unnecessary pag
8260: 65 73 20 63 61 63 68 65 20 65 6e 74 72 79 20 61  es cache entry a
8270: 6c 6c 6f 63 61 74 69 6f 6e 73 0a 2a 2a 0a 2a 2a  llocations.**.**
8280: 20 20 20 20 20 20 74 68 65 6e 20 61 74 74 65 6d        then attem
8290: 70 74 20 74 6f 20 72 65 63 79 63 6c 65 20 61 20  pt to recycle a 
82a0: 70 61 67 65 20 66 72 6f 6d 20 74 68 65 20 4c 52  page from the LR
82b0: 55 20 6c 69 73 74 2e 20 49 66 20 69 74 20 69 73  U list. If it is
82c0: 20 74 68 65 20 72 69 67 68 74 0a 2a 2a 20 20 20   the right.**   
82d0: 20 20 20 73 69 7a 65 2c 20 72 65 74 75 72 6e 20     size, return 
82e0: 74 68 65 20 72 65 63 79 63 6c 65 64 20 62 75 66  the recycled buf
82f0: 66 65 72 2e 20 4f 74 68 65 72 77 69 73 65 2c 20  fer. Otherwise, 
8300: 66 72 65 65 20 74 68 65 20 62 75 66 66 65 72 20  free the buffer 
8310: 61 6e 64 0a 2a 2a 20 20 20 20 20 20 70 72 6f 63  and.**      proc
8320: 65 65 64 20 74 6f 20 73 74 65 70 20 35 2e 20 0a  eed to step 5. .
8330: 2a 2a 0a 2a 2a 20 20 20 35 2e 20 4f 74 68 65 72  **.**   5. Other
8340: 77 69 73 65 2c 20 61 6c 6c 6f 63 61 74 65 20 61  wise, allocate a
8350: 6e 64 20 72 65 74 75 72 6e 20 61 20 6e 65 77 20  nd return a new 
8360: 70 61 67 65 20 62 75 66 66 65 72 2e 0a 2a 2a 0a  page buffer..**.
8370: 2a 2a 20 54 68 65 72 65 20 61 72 65 20 74 77 6f  ** There are two
8380: 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 74 68 69   versions of thi
8390: 73 20 72 6f 75 74 69 6e 65 2e 20 20 70 63 61 63  s routine.  pcac
83a0: 68 65 31 46 65 74 63 68 57 69 74 68 4d 75 74 65  he1FetchWithMute
83b0: 78 28 29 20 69 73 0a 2a 2a 20 74 68 65 20 67 65  x() is.** the ge
83c0: 6e 65 72 61 6c 20 63 61 73 65 2e 20 20 70 63 61  neral case.  pca
83d0: 63 68 65 31 46 65 74 63 68 4e 6f 4d 75 74 65 78  che1FetchNoMutex
83e0: 28 29 20 69 73 20 61 20 66 61 73 74 65 72 20 69  () is a faster i
83f0: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 66 6f  mplementation fo
8400: 72 0a 2a 2a 20 74 68 65 20 63 6f 6d 6d 6f 6e 20  r.** the common 
8410: 63 61 73 65 20 77 68 65 72 65 20 70 47 72 6f 75  case where pGrou
8420: 70 2d 3e 6d 75 74 65 78 20 69 73 20 4e 55 4c 4c  p->mutex is NULL
8430: 2e 20 20 54 68 65 20 70 63 61 63 68 65 31 46 65  .  The pcache1Fe
8440: 74 63 68 28 29 20 77 72 61 70 70 65 72 0a 2a 2a  tch() wrapper.**
8450: 20 69 6e 76 6f 6b 65 73 20 74 68 65 20 61 70 70   invokes the app
8460: 72 6f 70 72 69 61 74 65 20 72 6f 75 74 69 6e 65  ropriate routine
8470: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67 48 64  ..*/.static PgHd
8480: 72 31 20 2a 70 63 61 63 68 65 31 46 65 74 63 68  r1 *pcache1Fetch
8490: 4e 6f 4d 75 74 65 78 28 0a 20 20 73 71 6c 69 74  NoMutex(.  sqlit
84a0: 65 33 5f 70 63 61 63 68 65 20 2a 70 2c 20 0a 20  e3_pcache *p, . 
84b0: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4b   unsigned int iK
84c0: 65 79 2c 20 0a 20 20 69 6e 74 20 63 72 65 61 74  ey, .  int creat
84d0: 65 46 6c 61 67 0a 29 7b 0a 20 20 50 43 61 63 68  eFlag.){.  PCach
84e0: 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43  e1 *pCache = (PC
84f0: 61 63 68 65 31 20 2a 29 70 3b 0a 20 20 50 67 48  ache1 *)p;.  PgH
8500: 64 72 31 20 2a 70 50 61 67 65 20 3d 20 30 3b 0a  dr1 *pPage = 0;.
8510: 0a 20 20 2f 2a 20 53 74 65 70 20 31 3a 20 53 65  .  /* Step 1: Se
8520: 61 72 63 68 20 74 68 65 20 68 61 73 68 20 74 61  arch the hash ta
8530: 62 6c 65 20 66 6f 72 20 61 6e 20 65 78 69 73 74  ble for an exist
8540: 69 6e 67 20 65 6e 74 72 79 2e 20 2a 2f 0a 20 20  ing entry. */.  
8550: 70 50 61 67 65 20 3d 20 70 43 61 63 68 65 2d 3e  pPage = pCache->
8560: 61 70 48 61 73 68 5b 69 4b 65 79 20 25 20 70 43  apHash[iKey % pC
8570: 61 63 68 65 2d 3e 6e 48 61 73 68 5d 3b 0a 20 20  ache->nHash];.  
8580: 77 68 69 6c 65 28 20 70 50 61 67 65 20 26 26 20  while( pPage && 
8590: 70 50 61 67 65 2d 3e 69 4b 65 79 21 3d 69 4b 65  pPage->iKey!=iKe
85a0: 79 20 29 7b 20 70 50 61 67 65 20 3d 20 70 50 61  y ){ pPage = pPa
85b0: 67 65 2d 3e 70 4e 65 78 74 3b 20 7d 0a 0a 20 20  ge->pNext; }..  
85c0: 2f 2a 20 53 74 65 70 20 32 3a 20 49 66 20 74 68  /* Step 2: If th
85d0: 65 20 70 61 67 65 20 77 61 73 20 66 6f 75 6e 64  e page was found
85e0: 20 69 6e 20 74 68 65 20 68 61 73 68 20 74 61 62   in the hash tab
85f0: 6c 65 2c 20 74 68 65 6e 20 72 65 74 75 72 6e 20  le, then return 
8600: 69 74 2e 0a 20 20 2a 2a 20 49 66 20 74 68 65 20  it..  ** If the 
8610: 70 61 67 65 20 77 61 73 20 6e 6f 74 20 69 6e 20  page was not in 
8620: 74 68 65 20 68 61 73 68 20 74 61 62 6c 65 20 61  the hash table a
8630: 6e 64 20 63 72 65 61 74 65 46 6c 61 67 20 69 73  nd createFlag is
8640: 20 30 2c 20 61 62 6f 72 74 2e 0a 20 20 2a 2a 20   0, abort..  ** 
8650: 4f 74 68 65 72 77 69 73 65 20 28 70 61 67 65 20  Otherwise (page 
8660: 6e 6f 74 20 69 6e 20 68 61 73 68 20 61 6e 64 20  not in hash and 
8670: 63 72 65 61 74 65 46 6c 61 67 21 3d 30 29 20 63  createFlag!=0) c
8680: 6f 6e 74 69 6e 75 65 20 77 69 74 68 0a 20 20 2a  ontinue with.  *
8690: 2a 20 73 75 62 73 65 71 75 65 6e 74 20 73 74 65  * subsequent ste
86a0: 70 73 20 74 6f 20 74 72 79 20 74 6f 20 63 72 65  ps to try to cre
86b0: 61 74 65 20 74 68 65 20 70 61 67 65 2e 20 2a 2f  ate the page. */
86c0: 0a 20 20 69 66 28 20 70 50 61 67 65 20 29 7b 0a  .  if( pPage ){.
86d0: 20 20 20 20 69 66 28 20 21 70 50 61 67 65 2d 3e      if( !pPage->
86e0: 69 73 50 69 6e 6e 65 64 20 29 7b 0a 20 20 20 20  isPinned ){.    
86f0: 20 20 72 65 74 75 72 6e 20 70 63 61 63 68 65 31    return pcache1
8700: 50 69 6e 50 61 67 65 28 70 50 61 67 65 29 3b 0a  PinPage(pPage);.
8710: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
8720: 20 72 65 74 75 72 6e 20 70 50 61 67 65 3b 0a 20   return pPage;. 
8730: 20 20 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28     }.  }else if(
8740: 20 63 72 65 61 74 65 46 6c 61 67 20 29 7b 0a 20   createFlag ){. 
8750: 20 20 20 2f 2a 20 53 74 65 70 73 20 33 2c 20 34     /* Steps 3, 4
8760: 2c 20 61 6e 64 20 35 20 69 6d 70 6c 65 6d 65 6e  , and 5 implemen
8770: 74 65 64 20 62 79 20 74 68 69 73 20 73 75 62 72  ted by this subr
8780: 6f 75 74 69 6e 65 20 2a 2f 0a 20 20 20 20 72 65  outine */.    re
8790: 74 75 72 6e 20 70 63 61 63 68 65 31 46 65 74 63  turn pcache1Fetc
87a0: 68 53 74 61 67 65 32 28 70 43 61 63 68 65 2c 20  hStage2(pCache, 
87b0: 69 4b 65 79 2c 20 63 72 65 61 74 65 46 6c 61 67  iKey, createFlag
87c0: 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  );.  }else{.    
87d0: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 7d 0a  return 0;.  }.}.
87e0: 23 69 66 20 50 43 41 43 48 45 31 5f 4d 49 47 48  #if PCACHE1_MIGH
87f0: 54 5f 55 53 45 5f 47 52 4f 55 50 5f 4d 55 54 45  T_USE_GROUP_MUTE
8800: 58 0a 73 74 61 74 69 63 20 50 67 48 64 72 31 20  X.static PgHdr1 
8810: 2a 70 63 61 63 68 65 31 46 65 74 63 68 57 69 74  *pcache1FetchWit
8820: 68 4d 75 74 65 78 28 0a 20 20 73 71 6c 69 74 65  hMutex(.  sqlite
8830: 33 5f 70 63 61 63 68 65 20 2a 70 2c 20 0a 20 20  3_pcache *p, .  
8840: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4b 65  unsigned int iKe
8850: 79 2c 20 0a 20 20 69 6e 74 20 63 72 65 61 74 65  y, .  int create
8860: 46 6c 61 67 0a 29 7b 0a 20 20 50 43 61 63 68 65  Flag.){.  PCache
8870: 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61  1 *pCache = (PCa
8880: 63 68 65 31 20 2a 29 70 3b 0a 20 20 50 67 48 64  che1 *)p;.  PgHd
8890: 72 31 20 2a 70 50 61 67 65 3b 0a 0a 20 20 70 63  r1 *pPage;..  pc
88a0: 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28  ache1EnterMutex(
88b0: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b  pCache->pGroup);
88c0: 0a 20 20 70 50 61 67 65 20 3d 20 70 63 61 63 68  .  pPage = pcach
88d0: 65 31 46 65 74 63 68 4e 6f 4d 75 74 65 78 28 70  e1FetchNoMutex(p
88e0: 2c 20 69 4b 65 79 2c 20 63 72 65 61 74 65 46 6c  , iKey, createFl
88f0: 61 67 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  ag);.  assert( p
8900: 50 61 67 65 3d 3d 30 20 7c 7c 20 70 43 61 63 68  Page==0 || pCach
8910: 65 2d 3e 69 4d 61 78 4b 65 79 3e 3d 69 4b 65 79  e->iMaxKey>=iKey
8920: 20 29 3b 0a 20 20 70 63 61 63 68 65 31 4c 65 61   );.  pcache1Lea
8930: 76 65 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e  veMutex(pCache->
8940: 70 47 72 6f 75 70 29 3b 0a 20 20 72 65 74 75 72  pGroup);.  retur
8950: 6e 20 70 50 61 67 65 3b 0a 7d 0a 23 65 6e 64 69  n pPage;.}.#endi
8960: 66 0a 73 74 61 74 69 63 20 73 71 6c 69 74 65 33  f.static sqlite3
8970: 5f 70 63 61 63 68 65 5f 70 61 67 65 20 2a 70 63  _pcache_page *pc
8980: 61 63 68 65 31 46 65 74 63 68 28 0a 20 20 73 71  ache1Fetch(.  sq
8990: 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 2c  lite3_pcache *p,
89a0: 20 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74   .  unsigned int
89b0: 20 69 4b 65 79 2c 20 0a 20 20 69 6e 74 20 63 72   iKey, .  int cr
89c0: 65 61 74 65 46 6c 61 67 0a 29 7b 0a 23 69 66 20  eateFlag.){.#if 
89d0: 50 43 41 43 48 45 31 5f 4d 49 47 48 54 5f 55 53  PCACHE1_MIGHT_US
89e0: 45 5f 47 52 4f 55 50 5f 4d 55 54 45 58 20 7c 7c  E_GROUP_MUTEX ||
89f0: 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f   defined(SQLITE_
8a00: 44 45 42 55 47 29 0a 20 20 50 43 61 63 68 65 31  DEBUG).  PCache1
8a10: 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61 63   *pCache = (PCac
8a20: 68 65 31 20 2a 29 70 3b 0a 23 65 6e 64 69 66 0a  he1 *)p;.#endif.
8a30: 0a 20 20 61 73 73 65 72 74 28 20 6f 66 66 73 65  .  assert( offse
8a40: 74 6f 66 28 50 67 48 64 72 31 2c 70 61 67 65 29  tof(PgHdr1,page)
8a50: 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28  ==0 );.  assert(
8a60: 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61   pCache->bPurgea
8a70: 62 6c 65 20 7c 7c 20 63 72 65 61 74 65 46 6c 61  ble || createFla
8a80: 67 21 3d 31 20 29 3b 0a 20 20 61 73 73 65 72 74  g!=1 );.  assert
8a90: 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65  ( pCache->bPurge
8aa0: 61 62 6c 65 20 7c 7c 20 70 43 61 63 68 65 2d 3e  able || pCache->
8ab0: 6e 4d 69 6e 3d 3d 30 20 29 3b 0a 20 20 61 73 73  nMin==0 );.  ass
8ac0: 65 72 74 28 20 70 43 61 63 68 65 2d 3e 62 50 75  ert( pCache->bPu
8ad0: 72 67 65 61 62 6c 65 3d 3d 30 20 7c 7c 20 70 43  rgeable==0 || pC
8ae0: 61 63 68 65 2d 3e 6e 4d 69 6e 3d 3d 31 30 20 29  ache->nMin==10 )
8af0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63  ;.  assert( pCac
8b00: 68 65 2d 3e 6e 4d 69 6e 3d 3d 30 20 7c 7c 20 70  he->nMin==0 || p
8b10: 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c  Cache->bPurgeabl
8b20: 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  e );.  assert( p
8b30: 43 61 63 68 65 2d 3e 6e 48 61 73 68 3e 30 20 29  Cache->nHash>0 )
8b40: 3b 0a 23 69 66 20 50 43 41 43 48 45 31 5f 4d 49  ;.#if PCACHE1_MI
8b50: 47 48 54 5f 55 53 45 5f 47 52 4f 55 50 5f 4d 55  GHT_USE_GROUP_MU
8b60: 54 45 58 0a 20 20 69 66 28 20 70 43 61 63 68 65  TEX.  if( pCache
8b70: 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 20  ->pGroup->mutex 
8b80: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 28 73  ){.    return (s
8b90: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 70 61  qlite3_pcache_pa
8ba0: 67 65 2a 29 70 63 61 63 68 65 31 46 65 74 63 68  ge*)pcache1Fetch
8bb0: 57 69 74 68 4d 75 74 65 78 28 70 2c 20 69 4b 65  WithMutex(p, iKe
8bc0: 79 2c 20 63 72 65 61 74 65 46 6c 61 67 29 3b 0a  y, createFlag);.
8bd0: 20 20 7d 65 6c 73 65 0a 23 65 6e 64 69 66 0a 20    }else.#endif. 
8be0: 20 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 28 73   {.    return (s
8bf0: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 70 61  qlite3_pcache_pa
8c00: 67 65 2a 29 70 63 61 63 68 65 31 46 65 74 63 68  ge*)pcache1Fetch
8c10: 4e 6f 4d 75 74 65 78 28 70 2c 20 69 4b 65 79 2c  NoMutex(p, iKey,
8c20: 20 63 72 65 61 74 65 46 6c 61 67 29 3b 0a 20 20   createFlag);.  
8c30: 7d 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c  }.}.../*.** Impl
8c40: 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68  ementation of th
8c50: 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  e sqlite3_pcache
8c60: 2e 78 55 6e 70 69 6e 20 6d 65 74 68 6f 64 2e 0a  .xUnpin method..
8c70: 2a 2a 0a 2a 2a 20 4d 61 72 6b 20 61 20 70 61 67  **.** Mark a pag
8c80: 65 20 61 73 20 75 6e 70 69 6e 6e 65 64 20 28 65  e as unpinned (e
8c90: 6c 69 67 69 62 6c 65 20 66 6f 72 20 61 73 79 6e  ligible for asyn
8ca0: 63 68 72 6f 6e 6f 75 73 20 72 65 63 79 63 6c 69  chronous recycli
8cb0: 6e 67 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  ng)..*/.static v
8cc0: 6f 69 64 20 70 63 61 63 68 65 31 55 6e 70 69 6e  oid pcache1Unpin
8cd0: 28 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63  (.  sqlite3_pcac
8ce0: 68 65 20 2a 70 2c 20 0a 20 20 73 71 6c 69 74 65  he *p, .  sqlite
8cf0: 33 5f 70 63 61 63 68 65 5f 70 61 67 65 20 2a 70  3_pcache_page *p
8d00: 50 67 2c 20 0a 20 20 69 6e 74 20 72 65 75 73 65  Pg, .  int reuse
8d10: 55 6e 6c 69 6b 65 6c 79 0a 29 7b 0a 20 20 50 43  Unlikely.){.  PC
8d20: 61 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20  ache1 *pCache = 
8d30: 28 50 43 61 63 68 65 31 20 2a 29 70 3b 0a 20 20  (PCache1 *)p;.  
8d40: 50 67 48 64 72 31 20 2a 70 50 61 67 65 20 3d 20  PgHdr1 *pPage = 
8d50: 28 50 67 48 64 72 31 20 2a 29 70 50 67 3b 0a 20  (PgHdr1 *)pPg;. 
8d60: 20 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70 20   PGroup *pGroup 
8d70: 3d 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70  = pCache->pGroup
8d80: 3b 0a 20 0a 20 20 61 73 73 65 72 74 28 20 70 50  ;. .  assert( pP
8d90: 61 67 65 2d 3e 70 43 61 63 68 65 3d 3d 70 43 61  age->pCache==pCa
8da0: 63 68 65 20 29 3b 0a 20 20 70 63 61 63 68 65 31  che );.  pcache1
8db0: 45 6e 74 65 72 4d 75 74 65 78 28 70 47 72 6f 75  EnterMutex(pGrou
8dc0: 70 29 3b 0a 0a 20 20 2f 2a 20 49 74 20 69 73 20  p);..  /* It is 
8dd0: 61 6e 20 65 72 72 6f 72 20 74 6f 20 63 61 6c 6c  an error to call
8de0: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69   this function i
8df0: 66 20 74 68 65 20 70 61 67 65 20 69 73 20 61 6c  f the page is al
8e00: 72 65 61 64 79 20 0a 20 20 2a 2a 20 70 61 72 74  ready .  ** part
8e10: 20 6f 66 20 74 68 65 20 50 47 72 6f 75 70 20 4c   of the PGroup L
8e20: 52 55 20 6c 69 73 74 2e 0a 20 20 2a 2f 0a 20 20  RU list..  */.  
8e30: 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70  assert( pPage->p
8e40: 4c 72 75 50 72 65 76 3d 3d 30 20 26 26 20 70 50  LruPrev==0 && pP
8e50: 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74 3d 3d 30  age->pLruNext==0
8e60: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50   );.  assert( pP
8e70: 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d 31  age->isPinned==1
8e80: 20 29 3b 0a 0a 20 20 69 66 28 20 72 65 75 73 65   );..  if( reuse
8e90: 55 6e 6c 69 6b 65 6c 79 20 7c 7c 20 70 47 72 6f  Unlikely || pGro
8ea0: 75 70 2d 3e 6e 43 75 72 72 65 6e 74 50 61 67 65  up->nCurrentPage
8eb0: 3e 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67  >pGroup->nMaxPag
8ec0: 65 20 29 7b 0a 20 20 20 20 70 63 61 63 68 65 31  e ){.    pcache1
8ed0: 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73 68 28 70  RemoveFromHash(p
8ee0: 50 61 67 65 2c 20 31 29 3b 0a 20 20 7d 65 6c 73  Page, 1);.  }els
8ef0: 65 7b 0a 20 20 20 20 2f 2a 20 41 64 64 20 74 68  e{.    /* Add th
8f00: 65 20 70 61 67 65 20 74 6f 20 74 68 65 20 50 47  e page to the PG
8f10: 72 6f 75 70 20 4c 52 55 20 6c 69 73 74 2e 20 2a  roup LRU list. *
8f20: 2f 0a 20 20 20 20 50 67 48 64 72 31 20 2a 2a 70  /.    PgHdr1 **p
8f30: 70 46 69 72 73 74 20 3d 20 26 70 47 72 6f 75 70  pFirst = &pGroup
8f40: 2d 3e 6c 72 75 2e 70 4c 72 75 4e 65 78 74 3b 0a  ->lru.pLruNext;.
8f50: 20 20 20 20 70 50 61 67 65 2d 3e 70 4c 72 75 50      pPage->pLruP
8f60: 72 65 76 20 3d 20 26 70 47 72 6f 75 70 2d 3e 6c  rev = &pGroup->l
8f70: 72 75 3b 0a 20 20 20 20 28 70 50 61 67 65 2d 3e  ru;.    (pPage->
8f80: 70 4c 72 75 4e 65 78 74 20 3d 20 2a 70 70 46 69  pLruNext = *ppFi
8f90: 72 73 74 29 2d 3e 70 4c 72 75 50 72 65 76 20 3d  rst)->pLruPrev =
8fa0: 20 70 50 61 67 65 3b 0a 20 20 20 20 2a 70 70 46   pPage;.    *ppF
8fb0: 69 72 73 74 20 3d 20 70 50 61 67 65 3b 0a 20 20  irst = pPage;.  
8fc0: 20 20 70 43 61 63 68 65 2d 3e 6e 52 65 63 79 63    pCache->nRecyc
8fd0: 6c 61 62 6c 65 2b 2b 3b 0a 20 20 20 20 70 50 61  lable++;.    pPa
8fe0: 67 65 2d 3e 69 73 50 69 6e 6e 65 64 20 3d 20 30  ge->isPinned = 0
8ff0: 3b 0a 20 20 7d 0a 0a 20 20 70 63 61 63 68 65 31  ;.  }..  pcache1
9000: 4c 65 61 76 65 4d 75 74 65 78 28 70 43 61 63 68  LeaveMutex(pCach
9010: 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 7d 0a 0a 2f  e->pGroup);.}../
9020: 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74  *.** Implementat
9030: 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74  ion of the sqlit
9040: 65 33 5f 70 63 61 63 68 65 2e 78 52 65 6b 65 79  e3_pcache.xRekey
9050: 20 6d 65 74 68 6f 64 2e 20 0a 2a 2f 0a 73 74 61   method. .*/.sta
9060: 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31  tic void pcache1
9070: 52 65 6b 65 79 28 0a 20 20 73 71 6c 69 74 65 33  Rekey(.  sqlite3
9080: 5f 70 63 61 63 68 65 20 2a 70 2c 0a 20 20 73 71  _pcache *p,.  sq
9090: 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 70 61 67  lite3_pcache_pag
90a0: 65 20 2a 70 50 67 2c 0a 20 20 75 6e 73 69 67 6e  e *pPg,.  unsign
90b0: 65 64 20 69 6e 74 20 69 4f 6c 64 2c 0a 20 20 75  ed int iOld,.  u
90c0: 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4e 65 77  nsigned int iNew
90d0: 0a 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70  .){.  PCache1 *p
90e0: 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 65 31  Cache = (PCache1
90f0: 20 2a 29 70 3b 0a 20 20 50 67 48 64 72 31 20 2a   *)p;.  PgHdr1 *
9100: 70 50 61 67 65 20 3d 20 28 50 67 48 64 72 31 20  pPage = (PgHdr1 
9110: 2a 29 70 50 67 3b 0a 20 20 50 67 48 64 72 31 20  *)pPg;.  PgHdr1 
9120: 2a 2a 70 70 3b 0a 20 20 75 6e 73 69 67 6e 65 64  **pp;.  unsigned
9130: 20 69 6e 74 20 68 3b 20 0a 20 20 61 73 73 65 72   int h; .  asser
9140: 74 28 20 70 50 61 67 65 2d 3e 69 4b 65 79 3d 3d  t( pPage->iKey==
9150: 69 4f 6c 64 20 29 3b 0a 20 20 61 73 73 65 72 74  iOld );.  assert
9160: 28 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65 3d  ( pPage->pCache=
9170: 3d 70 43 61 63 68 65 20 29 3b 0a 0a 20 20 70 63  =pCache );..  pc
9180: 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28  ache1EnterMutex(
9190: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b  pCache->pGroup);
91a0: 0a 0a 20 20 68 20 3d 20 69 4f 6c 64 25 70 43 61  ..  h = iOld%pCa
91b0: 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 70 70  che->nHash;.  pp
91c0: 20 3d 20 26 70 43 61 63 68 65 2d 3e 61 70 48 61   = &pCache->apHa
91d0: 73 68 5b 68 5d 3b 0a 20 20 77 68 69 6c 65 28 20  sh[h];.  while( 
91e0: 28 2a 70 70 29 21 3d 70 50 61 67 65 20 29 7b 0a  (*pp)!=pPage ){.
91f0: 20 20 20 20 70 70 20 3d 20 26 28 2a 70 70 29 2d      pp = &(*pp)-
9200: 3e 70 4e 65 78 74 3b 0a 20 20 7d 0a 20 20 2a 70  >pNext;.  }.  *p
9210: 70 20 3d 20 70 50 61 67 65 2d 3e 70 4e 65 78 74  p = pPage->pNext
9220: 3b 0a 0a 20 20 68 20 3d 20 69 4e 65 77 25 70 43  ;..  h = iNew%pC
9230: 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 70  ache->nHash;.  p
9240: 50 61 67 65 2d 3e 69 4b 65 79 20 3d 20 69 4e 65  Page->iKey = iNe
9250: 77 3b 0a 20 20 70 50 61 67 65 2d 3e 70 4e 65 78  w;.  pPage->pNex
9260: 74 20 3d 20 70 43 61 63 68 65 2d 3e 61 70 48 61  t = pCache->apHa
9270: 73 68 5b 68 5d 3b 0a 20 20 70 43 61 63 68 65 2d  sh[h];.  pCache-
9280: 3e 61 70 48 61 73 68 5b 68 5d 20 3d 20 70 50 61  >apHash[h] = pPa
9290: 67 65 3b 0a 20 20 69 66 28 20 69 4e 65 77 3e 70  ge;.  if( iNew>p
92a0: 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 29  Cache->iMaxKey )
92b0: 7b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 69 4d  {.    pCache->iM
92c0: 61 78 4b 65 79 20 3d 20 69 4e 65 77 3b 0a 20 20  axKey = iNew;.  
92d0: 7d 0a 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76  }..  pcache1Leav
92e0: 65 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70  eMutex(pCache->p
92f0: 47 72 6f 75 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  Group);.}../*.**
9300: 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20   Implementation 
9310: 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70  of the sqlite3_p
9320: 63 61 63 68 65 2e 78 54 72 75 6e 63 61 74 65 20  cache.xTruncate 
9330: 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 44  method. .**.** D
9340: 69 73 63 61 72 64 20 61 6c 6c 20 75 6e 70 69 6e  iscard all unpin
9350: 6e 65 64 20 70 61 67 65 73 20 69 6e 20 74 68 65  ned pages in the
9360: 20 63 61 63 68 65 20 77 69 74 68 20 61 20 70 61   cache with a pa
9370: 67 65 20 6e 75 6d 62 65 72 20 65 71 75 61 6c 20  ge number equal 
9380: 74 6f 0a 2a 2a 20 6f 72 20 67 72 65 61 74 65 72  to.** or greater
9390: 20 74 68 61 6e 20 70 61 72 61 6d 65 74 65 72 20   than parameter 
93a0: 69 4c 69 6d 69 74 2e 20 41 6e 79 20 70 69 6e 6e  iLimit. Any pinn
93b0: 65 64 20 70 61 67 65 73 20 77 69 74 68 20 61 20  ed pages with a 
93c0: 70 61 67 65 20 6e 75 6d 62 65 72 0a 2a 2a 20 65  page number.** e
93d0: 71 75 61 6c 20 74 6f 20 6f 72 20 67 72 65 61 74  qual to or great
93e0: 65 72 20 74 68 61 6e 20 69 4c 69 6d 69 74 20 61  er than iLimit a
93f0: 72 65 20 69 6d 70 6c 69 63 69 74 6c 79 20 75 6e  re implicitly un
9400: 70 69 6e 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69  pinned..*/.stati
9410: 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 54 72  c void pcache1Tr
9420: 75 6e 63 61 74 65 28 73 71 6c 69 74 65 33 5f 70  uncate(sqlite3_p
9430: 63 61 63 68 65 20 2a 70 2c 20 75 6e 73 69 67 6e  cache *p, unsign
9440: 65 64 20 69 6e 74 20 69 4c 69 6d 69 74 29 7b 0a  ed int iLimit){.
9450: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68    PCache1 *pCach
9460: 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70  e = (PCache1 *)p
9470: 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65 72  ;.  pcache1Enter
9480: 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47  Mutex(pCache->pG
9490: 72 6f 75 70 29 3b 0a 20 20 69 66 28 20 69 4c 69  roup);.  if( iLi
94a0: 6d 69 74 3c 3d 70 43 61 63 68 65 2d 3e 69 4d 61  mit<=pCache->iMa
94b0: 78 4b 65 79 20 29 7b 0a 20 20 20 20 70 63 61 63  xKey ){.    pcac
94c0: 68 65 31 54 72 75 6e 63 61 74 65 55 6e 73 61 66  he1TruncateUnsaf
94d0: 65 28 70 43 61 63 68 65 2c 20 69 4c 69 6d 69 74  e(pCache, iLimit
94e0: 29 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 69  );.    pCache->i
94f0: 4d 61 78 4b 65 79 20 3d 20 69 4c 69 6d 69 74 2d  MaxKey = iLimit-
9500: 31 3b 0a 20 20 7d 0a 20 20 70 63 61 63 68 65 31  1;.  }.  pcache1
9510: 4c 65 61 76 65 4d 75 74 65 78 28 70 43 61 63 68  LeaveMutex(pCach
9520: 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 7d 0a 0a 2f  e->pGroup);.}../
9530: 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74  *.** Implementat
9540: 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74  ion of the sqlit
9550: 65 33 5f 70 63 61 63 68 65 2e 78 44 65 73 74 72  e3_pcache.xDestr
9560: 6f 79 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a  oy method. .**.*
9570: 2a 20 44 65 73 74 72 6f 79 20 61 20 63 61 63 68  * Destroy a cach
9580: 65 20 61 6c 6c 6f 63 61 74 65 64 20 75 73 69 6e  e allocated usin
9590: 67 20 70 63 61 63 68 65 31 43 72 65 61 74 65 28  g pcache1Create(
95a0: 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  )..*/.static voi
95b0: 64 20 70 63 61 63 68 65 31 44 65 73 74 72 6f 79  d pcache1Destroy
95c0: 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20  (sqlite3_pcache 
95d0: 2a 70 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a  *p){.  PCache1 *
95e0: 70 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 65  pCache = (PCache
95f0: 31 20 2a 29 70 3b 0a 20 20 50 47 72 6f 75 70 20  1 *)p;.  PGroup 
9600: 2a 70 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65  *pGroup = pCache
9610: 2d 3e 70 47 72 6f 75 70 3b 0a 20 20 61 73 73 65  ->pGroup;.  asse
9620: 72 74 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72  rt( pCache->bPur
9630: 67 65 61 62 6c 65 20 7c 7c 20 28 70 43 61 63 68  geable || (pCach
9640: 65 2d 3e 6e 4d 61 78 3d 3d 30 20 26 26 20 70 43  e->nMax==0 && pC
9650: 61 63 68 65 2d 3e 6e 4d 69 6e 3d 3d 30 29 20 29  ache->nMin==0) )
9660: 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65 72  ;.  pcache1Enter
9670: 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20  Mutex(pGroup);. 
9680: 20 69 66 28 20 70 43 61 63 68 65 2d 3e 6e 50 61   if( pCache->nPa
9690: 67 65 20 29 20 70 63 61 63 68 65 31 54 72 75 6e  ge ) pcache1Trun
96a0: 63 61 74 65 55 6e 73 61 66 65 28 70 43 61 63 68  cateUnsafe(pCach
96b0: 65 2c 20 30 29 3b 0a 20 20 61 73 73 65 72 74 28  e, 0);.  assert(
96c0: 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67   pGroup->nMaxPag
96d0: 65 20 3e 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 61  e >= pCache->nMa
96e0: 78 20 29 3b 0a 20 20 70 47 72 6f 75 70 2d 3e 6e  x );.  pGroup->n
96f0: 4d 61 78 50 61 67 65 20 2d 3d 20 70 43 61 63 68  MaxPage -= pCach
9700: 65 2d 3e 6e 4d 61 78 3b 0a 20 20 61 73 73 65 72  e->nMax;.  asser
9710: 74 28 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50  t( pGroup->nMinP
9720: 61 67 65 20 3e 3d 20 70 43 61 63 68 65 2d 3e 6e  age >= pCache->n
9730: 4d 69 6e 20 29 3b 0a 20 20 70 47 72 6f 75 70 2d  Min );.  pGroup-
9740: 3e 6e 4d 69 6e 50 61 67 65 20 2d 3d 20 70 43 61  >nMinPage -= pCa
9750: 63 68 65 2d 3e 6e 4d 69 6e 3b 0a 20 20 70 47 72  che->nMin;.  pGr
9760: 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 20  oup->mxPinned = 
9770: 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65  pGroup->nMaxPage
9780: 20 2b 20 31 30 20 2d 20 70 47 72 6f 75 70 2d 3e   + 10 - pGroup->
9790: 6e 4d 69 6e 50 61 67 65 3b 0a 20 20 70 63 61 63  nMinPage;.  pcac
97a0: 68 65 31 45 6e 66 6f 72 63 65 4d 61 78 50 61 67  he1EnforceMaxPag
97b0: 65 28 70 43 61 63 68 65 29 3b 0a 20 20 70 63 61  e(pCache);.  pca
97c0: 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70  che1LeaveMutex(p
97d0: 47 72 6f 75 70 29 3b 0a 20 20 73 71 6c 69 74 65  Group);.  sqlite
97e0: 33 5f 66 72 65 65 28 70 43 61 63 68 65 2d 3e 70  3_free(pCache->p
97f0: 42 75 6c 6b 29 3b 0a 20 20 73 71 6c 69 74 65 33  Bulk);.  sqlite3
9800: 5f 66 72 65 65 28 70 43 61 63 68 65 2d 3e 61 70  _free(pCache->ap
9810: 48 61 73 68 29 3b 0a 20 20 73 71 6c 69 74 65 33  Hash);.  sqlite3
9820: 5f 66 72 65 65 28 70 43 61 63 68 65 29 3b 0a 7d  _free(pCache);.}
9830: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e  ../*.** This fun
9840: 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20  ction is called 
9850: 64 75 72 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a  during initializ
9860: 61 74 69 6f 6e 20 28 73 71 6c 69 74 65 33 5f 69  ation (sqlite3_i
9870: 6e 69 74 69 61 6c 69 7a 65 28 29 29 20 74 6f 0a  nitialize()) to.
9880: 2a 2a 20 69 6e 73 74 61 6c 6c 20 74 68 65 20 64  ** install the d
9890: 65 66 61 75 6c 74 20 70 6c 75 67 67 61 62 6c 65  efault pluggable
98a0: 20 63 61 63 68 65 20 6d 6f 64 75 6c 65 2c 20 61   cache module, a
98b0: 73 73 75 6d 69 6e 67 20 74 68 65 20 75 73 65 72  ssuming the user
98c0: 20 68 61 73 20 6e 6f 74 0a 2a 2a 20 61 6c 72 65   has not.** alre
98d0: 61 64 79 20 70 72 6f 76 69 64 65 64 20 61 6e 20  ady provided an 
98e0: 61 6c 74 65 72 6e 61 74 69 76 65 2e 0a 2a 2f 0a  alternative..*/.
98f0: 76 6f 69 64 20 73 71 6c 69 74 65 33 50 43 61 63  void sqlite3PCac
9900: 68 65 53 65 74 44 65 66 61 75 6c 74 28 76 6f 69  heSetDefault(voi
9910: 64 29 7b 0a 20 20 73 74 61 74 69 63 20 63 6f 6e  d){.  static con
9920: 73 74 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68  st sqlite3_pcach
9930: 65 5f 6d 65 74 68 6f 64 73 32 20 64 65 66 61 75  e_methods2 defau
9940: 6c 74 4d 65 74 68 6f 64 73 20 3d 20 7b 0a 20 20  ltMethods = {.  
9950: 20 20 31 2c 20 20 20 20 20 20 20 20 20 20 20 20    1,            
9960: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 69 56             /* iV
9970: 65 72 73 69 6f 6e 20 2a 2f 0a 20 20 20 20 30 2c  ersion */.    0,
9980: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
9990: 20 20 20 20 20 20 20 2f 2a 20 70 41 72 67 20 2a         /* pArg *
99a0: 2f 0a 20 20 20 20 70 63 61 63 68 65 31 49 6e 69  /.    pcache1Ini
99b0: 74 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  t,             /
99c0: 2a 20 78 49 6e 69 74 20 2a 2f 0a 20 20 20 20 70  * xInit */.    p
99d0: 63 61 63 68 65 31 53 68 75 74 64 6f 77 6e 2c 20  cache1Shutdown, 
99e0: 20 20 20 20 20 20 20 20 2f 2a 20 78 53 68 75 74          /* xShut
99f0: 64 6f 77 6e 20 2a 2f 0a 20 20 20 20 70 63 61 63  down */.    pcac
9a00: 68 65 31 43 72 65 61 74 65 2c 20 20 20 20 20 20  he1Create,      
9a10: 20 20 20 20 20 2f 2a 20 78 43 72 65 61 74 65 20       /* xCreate 
9a20: 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 43 61  */.    pcache1Ca
9a30: 63 68 65 73 69 7a 65 2c 20 20 20 20 20 20 20 20  chesize,        
9a40: 2f 2a 20 78 43 61 63 68 65 73 69 7a 65 20 2a 2f  /* xCachesize */
9a50: 0a 20 20 20 20 70 63 61 63 68 65 31 50 61 67 65  .    pcache1Page
9a60: 63 6f 75 6e 74 2c 20 20 20 20 20 20 20 20 2f 2a  count,        /*
9a70: 20 78 50 61 67 65 63 6f 75 6e 74 20 2a 2f 0a 20   xPagecount */. 
9a80: 20 20 20 70 63 61 63 68 65 31 46 65 74 63 68 2c     pcache1Fetch,
9a90: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78              /* x
9aa0: 46 65 74 63 68 20 2a 2f 0a 20 20 20 20 70 63 61  Fetch */.    pca
9ab0: 63 68 65 31 55 6e 70 69 6e 2c 20 20 20 20 20 20  che1Unpin,      
9ac0: 20 20 20 20 20 20 2f 2a 20 78 55 6e 70 69 6e 20        /* xUnpin 
9ad0: 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 52 65  */.    pcache1Re
9ae0: 6b 65 79 2c 20 20 20 20 20 20 20 20 20 20 20 20  key,            
9af0: 2f 2a 20 78 52 65 6b 65 79 20 2a 2f 0a 20 20 20  /* xRekey */.   
9b00: 20 70 63 61 63 68 65 31 54 72 75 6e 63 61 74 65   pcache1Truncate
9b10: 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 78 54 72  ,         /* xTr
9b20: 75 6e 63 61 74 65 20 2a 2f 0a 20 20 20 20 70 63  uncate */.    pc
9b30: 61 63 68 65 31 44 65 73 74 72 6f 79 2c 20 20 20  ache1Destroy,   
9b40: 20 20 20 20 20 20 20 2f 2a 20 78 44 65 73 74 72         /* xDestr
9b50: 6f 79 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65  oy */.    pcache
9b60: 31 53 68 72 69 6e 6b 20 20 20 20 20 20 20 20 20  1Shrink         
9b70: 20 20 20 2f 2a 20 78 53 68 72 69 6e 6b 20 2a 2f     /* xShrink */
9b80: 0a 20 20 7d 3b 0a 20 20 73 71 6c 69 74 65 33 5f  .  };.  sqlite3_
9b90: 63 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f 43 4f  config(SQLITE_CO
9ba0: 4e 46 49 47 5f 50 43 41 43 48 45 32 2c 20 26 64  NFIG_PCACHE2, &d
9bb0: 65 66 61 75 6c 74 4d 65 74 68 6f 64 73 29 3b 0a  efaultMethods);.
9bc0: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
9bd0: 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20  the size of the 
9be0: 68 65 61 64 65 72 20 6f 6e 20 65 61 63 68 20 70  header on each p
9bf0: 61 67 65 20 6f 66 20 74 68 69 73 20 50 43 41 43  age of this PCAC
9c00: 48 45 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  HE implementatio
9c10: 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  n..*/.int sqlite
9c20: 33 48 65 61 64 65 72 53 69 7a 65 50 63 61 63 68  3HeaderSizePcach
9c30: 65 31 28 76 6f 69 64 29 7b 20 72 65 74 75 72 6e  e1(void){ return
9c40: 20 52 4f 55 4e 44 38 28 73 69 7a 65 6f 66 28 50   ROUND8(sizeof(P
9c50: 67 48 64 72 31 29 29 3b 20 7d 0a 0a 2f 2a 0a 2a  gHdr1)); }../*.*
9c60: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 67 6c 6f  * Return the glo
9c70: 62 61 6c 20 6d 75 74 65 78 20 75 73 65 64 20 62  bal mutex used b
9c80: 79 20 74 68 69 73 20 50 43 41 43 48 45 20 69 6d  y this PCACHE im
9c90: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 20 20 54  plementation.  T
9ca0: 68 65 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 73 74  he.** sqlite3_st
9cb0: 61 74 75 73 28 29 20 72 6f 75 74 69 6e 65 20 6e  atus() routine n
9cc0: 65 65 64 73 20 61 63 63 65 73 73 20 74 6f 20 74  eeds access to t
9cd0: 68 69 73 20 6d 75 74 65 78 2e 0a 2a 2f 0a 73 71  his mutex..*/.sq
9ce0: 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 73 71 6c  lite3_mutex *sql
9cf0: 69 74 65 33 50 63 61 63 68 65 31 4d 75 74 65 78  ite3Pcache1Mutex
9d00: 28 76 6f 69 64 29 7b 0a 20 20 72 65 74 75 72 6e  (void){.  return
9d10: 20 70 63 61 63 68 65 31 2e 6d 75 74 65 78 3b 0a   pcache1.mutex;.
9d20: 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  }..#ifdef SQLITE
9d30: 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d  _ENABLE_MEMORY_M
9d40: 41 4e 41 47 45 4d 45 4e 54 0a 2f 2a 0a 2a 2a 20  ANAGEMENT./*.** 
9d50: 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73  This function is
9d60: 20 63 61 6c 6c 65 64 20 74 6f 20 66 72 65 65 20   called to free 
9d70: 73 75 70 65 72 66 6c 75 6f 75 73 20 64 79 6e 61  superfluous dyna
9d80: 6d 69 63 61 6c 6c 79 20 61 6c 6c 6f 63 61 74 65  mically allocate
9d90: 64 20 6d 65 6d 6f 72 79 0a 2a 2a 20 68 65 6c 64  d memory.** held
9da0: 20 62 79 20 74 68 65 20 70 61 67 65 72 20 73 79   by the pager sy
9db0: 73 74 65 6d 2e 20 4d 65 6d 6f 72 79 20 69 6e 20  stem. Memory in 
9dc0: 75 73 65 20 62 79 20 61 6e 79 20 53 51 4c 69 74  use by any SQLit
9dd0: 65 20 70 61 67 65 72 20 61 6c 6c 6f 63 61 74 65  e pager allocate
9de0: 64 0a 2a 2a 20 62 79 20 74 68 65 20 63 75 72 72  d.** by the curr
9df0: 65 6e 74 20 74 68 72 65 61 64 20 6d 61 79 20 62  ent thread may b
9e00: 65 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 29  e sqlite3_free()
9e10: 65 64 2e 0a 2a 2a 0a 2a 2a 20 6e 52 65 71 20 69  ed..**.** nReq i
9e20: 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  s the number of 
9e30: 62 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79 20  bytes of memory 
9e40: 72 65 71 75 69 72 65 64 2e 20 4f 6e 63 65 20 74  required. Once t
9e50: 68 69 73 20 6d 75 63 68 20 68 61 73 0a 2a 2a 20  his much has.** 
9e60: 62 65 65 6e 20 72 65 6c 65 61 73 65 64 2c 20 74  been released, t
9e70: 68 65 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75  he function retu
9e80: 72 6e 73 2e 20 54 68 65 20 72 65 74 75 72 6e 20  rns. The return 
9e90: 76 61 6c 75 65 20 69 73 20 74 68 65 20 74 6f 74  value is the tot
9ea0: 61 6c 20 6e 75 6d 62 65 72 20 0a 2a 2a 20 6f 66  al number .** of
9eb0: 20 62 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79   bytes of memory
9ec0: 20 72 65 6c 65 61 73 65 64 2e 0a 2a 2f 0a 69 6e   released..*/.in
9ed0: 74 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 52  t sqlite3PcacheR
9ee0: 65 6c 65 61 73 65 4d 65 6d 6f 72 79 28 69 6e 74  eleaseMemory(int
9ef0: 20 6e 52 65 71 29 7b 0a 20 20 69 6e 74 20 6e 46   nReq){.  int nF
9f00: 72 65 65 20 3d 20 30 3b 0a 20 20 61 73 73 65 72  ree = 0;.  asser
9f10: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  t( sqlite3_mutex
9f20: 5f 6e 6f 74 68 65 6c 64 28 70 63 61 63 68 65 31  _notheld(pcache1
9f30: 2e 67 72 70 2e 6d 75 74 65 78 29 20 29 3b 0a 20  .grp.mutex) );. 
9f40: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
9f50: 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c 64 28 70  _mutex_notheld(p
9f60: 63 61 63 68 65 31 2e 6d 75 74 65 78 29 20 29 3b  cache1.mutex) );
9f70: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c  .  if( sqlite3Gl
9f80: 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65  obalConfig.pPage
9f90: 3d 3d 30 20 29 7b 0a 20 20 20 20 50 67 48 64 72  ==0 ){.    PgHdr
9fa0: 31 20 2a 70 3b 0a 20 20 20 20 70 63 61 63 68 65  1 *p;.    pcache
9fb0: 31 45 6e 74 65 72 4d 75 74 65 78 28 26 70 63 61  1EnterMutex(&pca
9fc0: 63 68 65 31 2e 67 72 70 29 3b 0a 20 20 20 20 77  che1.grp);.    w
9fd0: 68 69 6c 65 28 20 28 6e 52 65 71 3c 30 20 7c 7c  hile( (nReq<0 ||
9fe0: 20 6e 46 72 65 65 3c 6e 52 65 71 29 0a 20 20 20   nFree<nReq).   
9ff0: 20 20 20 20 26 26 20 20 28 70 3d 70 63 61 63 68      &&  (p=pcach
a000: 65 31 2e 67 72 70 2e 6c 72 75 2e 70 4c 72 75 50  e1.grp.lru.pLruP
a010: 72 65 76 29 21 3d 30 0a 20 20 20 20 20 20 20 26  rev)!=0.       &
a020: 26 20 20 70 2d 3e 69 73 41 6e 63 68 6f 72 3d 3d  &  p->isAnchor==
a030: 30 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 6e  0.    ){.      n
a040: 46 72 65 65 20 2b 3d 20 70 63 61 63 68 65 31 4d  Free += pcache1M
a050: 65 6d 53 69 7a 65 28 70 2d 3e 70 61 67 65 2e 70  emSize(p->page.p
a060: 42 75 66 29 3b 0a 23 69 66 64 65 66 20 53 51 4c  Buf);.#ifdef SQL
a070: 49 54 45 5f 50 43 41 43 48 45 5f 53 45 50 41 52  ITE_PCACHE_SEPAR
a080: 41 54 45 5f 48 45 41 44 45 52 0a 20 20 20 20 20  ATE_HEADER.     
a090: 20 6e 46 72 65 65 20 2b 3d 20 73 71 6c 69 74 65   nFree += sqlite
a0a0: 33 4d 65 6d 53 69 7a 65 28 70 29 3b 0a 23 65 6e  3MemSize(p);.#en
a0b0: 64 69 66 0a 20 20 20 20 20 20 61 73 73 65 72 74  dif.      assert
a0c0: 28 20 70 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d 30  ( p->isPinned==0
a0d0: 20 29 3b 0a 20 20 20 20 20 20 70 63 61 63 68 65   );.      pcache
a0e0: 31 50 69 6e 50 61 67 65 28 70 29 3b 0a 20 20 20  1PinPage(p);.   
a0f0: 20 20 20 70 63 61 63 68 65 31 52 65 6d 6f 76 65     pcache1Remove
a100: 46 72 6f 6d 48 61 73 68 28 70 2c 20 31 29 3b 0a  FromHash(p, 1);.
a110: 20 20 20 20 7d 0a 20 20 20 20 70 63 61 63 68 65      }.    pcache
a120: 31 4c 65 61 76 65 4d 75 74 65 78 28 26 70 63 61  1LeaveMutex(&pca
a130: 63 68 65 31 2e 67 72 70 29 3b 0a 20 20 7d 0a 20  che1.grp);.  }. 
a140: 20 72 65 74 75 72 6e 20 6e 46 72 65 65 3b 0a 7d   return nFree;.}
a150: 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54  .#endif /* SQLIT
a160: 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f  E_ENABLE_MEMORY_
a170: 4d 41 4e 41 47 45 4d 45 4e 54 20 2a 2f 0a 0a 23  MANAGEMENT */..#
a180: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45 53  ifdef SQLITE_TES
a190: 54 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e  T./*.** This fun
a1a0: 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 62 79  ction is used by
a1b0: 20 74 65 73 74 20 70 72 6f 63 65 64 75 72 65 73   test procedures
a1c0: 20 74 6f 20 69 6e 73 70 65 63 74 20 74 68 65 20   to inspect the 
a1d0: 69 6e 74 65 72 6e 61 6c 20 73 74 61 74 65 0a 2a  internal state.*
a1e0: 2a 20 6f 66 20 74 68 65 20 67 6c 6f 62 61 6c 20  * of the global 
a1f0: 63 61 63 68 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73  cache..*/.void s
a200: 71 6c 69 74 65 33 50 63 61 63 68 65 53 74 61 74  qlite3PcacheStat
a210: 73 28 0a 20 20 69 6e 74 20 2a 70 6e 43 75 72 72  s(.  int *pnCurr
a220: 65 6e 74 2c 20 20 20 20 20 20 2f 2a 20 4f 55 54  ent,      /* OUT
a230: 3a 20 54 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f  : Total number o
a240: 66 20 70 61 67 65 73 20 63 61 63 68 65 64 20 2a  f pages cached *
a250: 2f 0a 20 20 69 6e 74 20 2a 70 6e 4d 61 78 2c 20  /.  int *pnMax, 
a260: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a           /* OUT:
a270: 20 47 6c 6f 62 61 6c 20 6d 61 78 69 6d 75 6d 20   Global maximum 
a280: 63 61 63 68 65 20 73 69 7a 65 20 2a 2f 0a 20 20  cache size */.  
a290: 69 6e 74 20 2a 70 6e 4d 69 6e 2c 20 20 20 20 20  int *pnMin,     
a2a0: 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 53 75 6d       /* OUT: Sum
a2b0: 20 6f 66 20 50 43 61 63 68 65 31 2e 6e 4d 69 6e   of PCache1.nMin
a2c0: 20 66 6f 72 20 70 75 72 67 65 61 62 6c 65 20 63   for purgeable c
a2d0: 61 63 68 65 73 20 2a 2f 0a 20 20 69 6e 74 20 2a  aches */.  int *
a2e0: 70 6e 52 65 63 79 63 6c 61 62 6c 65 20 20 20 20  pnRecyclable    
a2f0: 2f 2a 20 4f 55 54 3a 20 54 6f 74 61 6c 20 6e 75  /* OUT: Total nu
a300: 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 61 76  mber of pages av
a310: 61 69 6c 61 62 6c 65 20 66 6f 72 20 72 65 63 79  ailable for recy
a320: 63 6c 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 50 67  cling */.){.  Pg
a330: 48 64 72 31 20 2a 70 3b 0a 20 20 69 6e 74 20 6e  Hdr1 *p;.  int n
a340: 52 65 63 79 63 6c 61 62 6c 65 20 3d 20 30 3b 0a  Recyclable = 0;.
a350: 20 20 66 6f 72 28 70 3d 70 63 61 63 68 65 31 2e    for(p=pcache1.
a360: 67 72 70 2e 6c 72 75 2e 70 4c 72 75 4e 65 78 74  grp.lru.pLruNext
a370: 3b 20 70 20 26 26 20 21 70 2d 3e 69 73 41 6e 63  ; p && !p->isAnc
a380: 68 6f 72 3b 20 70 3d 70 2d 3e 70 4c 72 75 4e 65  hor; p=p->pLruNe
a390: 78 74 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28  xt){.    assert(
a3a0: 20 70 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d 30 20   p->isPinned==0 
a3b0: 29 3b 0a 20 20 20 20 6e 52 65 63 79 63 6c 61 62  );.    nRecyclab
a3c0: 6c 65 2b 2b 3b 0a 20 20 7d 0a 20 20 2a 70 6e 43  le++;.  }.  *pnC
a3d0: 75 72 72 65 6e 74 20 3d 20 70 63 61 63 68 65 31  urrent = pcache1
a3e0: 2e 67 72 70 2e 6e 43 75 72 72 65 6e 74 50 61 67  .grp.nCurrentPag
a3f0: 65 3b 0a 20 20 2a 70 6e 4d 61 78 20 3d 20 28 69  e;.  *pnMax = (i
a400: 6e 74 29 70 63 61 63 68 65 31 2e 67 72 70 2e 6e  nt)pcache1.grp.n
a410: 4d 61 78 50 61 67 65 3b 0a 20 20 2a 70 6e 4d 69  MaxPage;.  *pnMi
a420: 6e 20 3d 20 28 69 6e 74 29 70 63 61 63 68 65 31  n = (int)pcache1
a430: 2e 67 72 70 2e 6e 4d 69 6e 50 61 67 65 3b 0a 20  .grp.nMinPage;. 
a440: 20 2a 70 6e 52 65 63 79 63 6c 61 62 6c 65 20 3d   *pnRecyclable =
a450: 20 6e 52 65 63 79 63 6c 61 62 6c 65 3b 0a 7d 0a   nRecyclable;.}.
a460: 23 65 6e 64 69 66 0a                             #endif.