/ Hex Artifact Content
Login

Artifact d08939800abf3031bd0affd5a13fbc4d7ba3fb68:


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 43 41 43 48 45 2c 20 30 2c 20 30 2c 20 4e  _PCACHE, 0, 0, N
0cf0: 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 4e 20 69 73  )..**.** If N is
0d00: 20 70 6f 73 69 74 69 76 65 2c 20 74 68 65 6e 20   positive, then 
0d10: 4e 20 70 61 67 65 73 20 77 6f 72 74 68 20 6f 66  N pages worth of
0d20: 20 6d 65 6d 6f 72 79 20 61 72 65 20 61 6c 6c 6f   memory are allo
0d30: 63 61 74 65 64 20 75 73 69 6e 67 20 61 20 73 69  cated using a si
0d40: 6e 67 6c 65 0a 2a 2a 20 73 71 6c 69 74 65 33 4d  ngle.** sqlite3M
0d50: 61 6c 6c 6f 63 28 29 20 63 61 6c 6c 20 61 6e 64  alloc() call and
0d60: 20 74 68 61 74 20 6d 65 6d 6f 72 79 20 69 73 20   that memory is 
0d70: 75 73 65 64 20 66 6f 72 20 74 68 65 20 66 69 72  used for the fir
0d80: 73 74 20 4e 20 70 61 67 65 73 20 61 6c 6c 6f 63  st N pages alloc
0d90: 61 74 65 64 2e 0a 2a 2a 20 4f 72 20 69 66 20 4e  ated..** Or if N
0da0: 20 69 73 20 6e 65 67 61 74 69 76 65 2c 20 74 68   is negative, th
0db0: 65 6e 20 2d 31 30 32 34 2a 4e 20 62 79 74 65 73  en -1024*N bytes
0dc0: 20 6f 66 20 6d 65 6d 6f 72 79 20 61 72 65 20 61   of memory are a
0dd0: 6c 6c 6f 63 61 74 65 64 20 61 6e 64 20 75 73 65  llocated and use
0de0: 64 0a 2a 2a 20 66 6f 72 20 61 73 20 6d 61 6e 79  d.** for as many
0df0: 20 70 61 67 65 73 20 61 73 20 63 61 6e 20 62 65   pages as can be
0e00: 20 61 63 63 6f 6d 6f 64 61 74 65 64 2e 0a 2a 2a   accomodated..**
0e10: 0a 2a 2a 20 4f 6e 6c 79 20 6f 6e 65 20 6f 66 20  .** Only one of 
0e20: 28 32 29 20 6f 72 20 28 33 29 20 63 61 6e 20 62  (2) or (3) can b
0e30: 65 20 75 73 65 64 2e 20 20 4f 6e 63 65 20 74 68  e used.  Once th
0e40: 65 20 6d 65 6d 6f 72 79 20 61 76 61 69 6c 61 62  e memory availab
0e50: 6c 65 20 74 6f 20 28 32 29 20 6f 72 0a 2a 2a 20  le to (2) or.** 
0e60: 28 33 29 20 69 73 20 65 78 68 61 75 73 74 65 64  (3) is exhausted
0e70: 2c 20 73 75 62 73 65 71 75 65 6e 74 20 61 6c 6c  , subsequent all
0e80: 6f 63 61 74 69 6f 6e 73 20 66 61 69 6c 20 6f 76  ocations fail ov
0e90: 65 72 20 74 6f 20 74 68 65 20 67 65 6e 65 72 61  er to the genera
0ea0: 6c 2d 70 75 72 70 6f 73 65 0a 2a 2a 20 6d 65 6d  l-purpose.** mem
0eb0: 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 20 28 31  ory allocator (1
0ec0: 29 2e 0a 2a 2a 0a 2a 2a 20 45 61 72 6c 69 65 72  )..**.** Earlier
0ed0: 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c   versions of SQL
0ee0: 69 74 65 20 75 73 65 64 20 6f 6e 6c 79 20 6d 65  ite used only me
0ef0: 74 68 6f 64 73 20 28 31 29 20 61 6e 64 20 28 32  thods (1) and (2
0f00: 29 2e 20 20 42 75 74 20 65 78 70 65 72 69 6d 65  ).  But experime
0f10: 6e 74 73 0a 2a 2a 20 73 68 6f 77 20 74 68 61 74  nts.** show that
0f20: 20 6d 65 74 68 6f 64 20 28 33 29 20 77 69 74 68   method (3) with
0f30: 20 4e 3d 3d 31 30 30 20 70 72 6f 76 69 64 65 73   N==100 provides
0f40: 20 61 62 6f 75 74 20 61 20 35 25 20 70 65 72 66   about a 5% perf
0f50: 6f 72 6d 61 6e 63 65 20 62 6f 6f 73 74 20 66 6f  ormance boost fo
0f60: 72 0a 2a 2a 20 63 6f 6d 6d 6f 6e 20 77 6f 72 6b  r.** common work
0f70: 6c 6f 61 64 73 2e 0a 2a 2f 0a 23 69 6e 63 6c 75  loads..*/.#inclu
0f80: 64 65 20 22 73 71 6c 69 74 65 49 6e 74 2e 68 22  de "sqliteInt.h"
0f90: 0a 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74  ..typedef struct
0fa0: 20 50 43 61 63 68 65 31 20 50 43 61 63 68 65 31   PCache1 PCache1
0fb0: 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74  ;.typedef struct
0fc0: 20 50 67 48 64 72 31 20 50 67 48 64 72 31 3b 0a   PgHdr1 PgHdr1;.
0fd0: 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 50  typedef struct P
0fe0: 67 46 72 65 65 73 6c 6f 74 20 50 67 46 72 65 65  gFreeslot PgFree
0ff0: 73 6c 6f 74 3b 0a 74 79 70 65 64 65 66 20 73 74  slot;.typedef st
1000: 72 75 63 74 20 50 47 72 6f 75 70 20 50 47 72 6f  ruct PGroup PGro
1010: 75 70 3b 0a 0a 2f 2a 20 45 61 63 68 20 70 61 67  up;../* Each pag
1020: 65 20 63 61 63 68 65 20 28 6f 72 20 50 43 61 63  e cache (or PCac
1030: 68 65 29 20 62 65 6c 6f 6e 67 73 20 74 6f 20 61  he) belongs to a
1040: 20 50 47 72 6f 75 70 2e 20 20 41 20 50 47 72 6f   PGroup.  A PGro
1050: 75 70 20 69 73 20 61 20 73 65 74 20 0a 2a 2a 20  up is a set .** 
1060: 6f 66 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 50  of one or more P
1070: 43 61 63 68 65 73 20 74 68 61 74 20 61 72 65 20  Caches that are 
1080: 61 62 6c 65 20 74 6f 20 72 65 63 79 63 6c 65 20  able to recycle 
1090: 65 61 63 68 20 6f 74 68 65 72 27 73 20 75 6e 70  each other's unp
10a0: 69 6e 6e 65 64 0a 2a 2a 20 70 61 67 65 73 20 77  inned.** pages w
10b0: 68 65 6e 20 74 68 65 79 20 61 72 65 20 75 6e 64  hen they are und
10c0: 65 72 20 6d 65 6d 6f 72 79 20 70 72 65 73 73 75  er memory pressu
10d0: 72 65 2e 20 20 41 20 50 47 72 6f 75 70 20 69 73  re.  A PGroup is
10e0: 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 0a   an instance of.
10f0: 2a 2a 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  ** the following
1100: 20 6f 62 6a 65 63 74 2e 0a 2a 2a 0a 2a 2a 20 54   object..**.** T
1110: 68 69 73 20 70 61 67 65 20 63 61 63 68 65 20 69  his page cache i
1120: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 77 6f  mplementation wo
1130: 72 6b 73 20 69 6e 20 6f 6e 65 20 6f 66 20 74 77  rks in one of tw
1140: 6f 20 6d 6f 64 65 73 3a 0a 2a 2a 0a 2a 2a 20 20  o modes:.**.**  
1150: 20 28 31 29 20 20 45 76 65 72 79 20 50 43 61 63   (1)  Every PCac
1160: 68 65 20 69 73 20 74 68 65 20 73 6f 6c 65 20 6d  he is the sole m
1170: 65 6d 62 65 72 20 6f 66 20 69 74 73 20 6f 77 6e  ember of its own
1180: 20 50 47 72 6f 75 70 2e 20 20 54 68 65 72 65 20   PGroup.  There 
1190: 69 73 0a 2a 2a 20 20 20 20 20 20 20 20 6f 6e 65  is.**        one
11a0: 20 50 47 72 6f 75 70 20 70 65 72 20 50 43 61 63   PGroup per PCac
11b0: 68 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 28 32 29 20  he..**.**   (2) 
11c0: 20 54 68 65 72 65 20 69 73 20 61 20 73 69 6e 67   There is a sing
11d0: 6c 65 20 67 6c 6f 62 61 6c 20 50 47 72 6f 75 70  le global PGroup
11e0: 20 74 68 61 74 20 61 6c 6c 20 50 43 61 63 68 65   that all PCache
11f0: 73 20 61 72 65 20 61 20 6d 65 6d 62 65 72 0a 2a  s are a member.*
1200: 2a 20 20 20 20 20 20 20 20 6f 66 2e 0a 2a 2a 0a  *        of..**.
1210: 2a 2a 20 4d 6f 64 65 20 31 20 75 73 65 73 20 6d  ** Mode 1 uses m
1220: 6f 72 65 20 6d 65 6d 6f 72 79 20 28 73 69 6e 63  ore memory (sinc
1230: 65 20 50 43 61 63 68 65 20 69 6e 73 74 61 6e 63  e PCache instanc
1240: 65 73 20 61 72 65 20 6e 6f 74 20 61 62 6c 65 20  es are not able 
1250: 74 6f 20 72 6f 62 0a 2a 2a 20 75 6e 75 73 65 64  to rob.** unused
1260: 20 70 61 67 65 73 20 66 72 6f 6d 20 6f 74 68 65   pages from othe
1270: 72 20 50 43 61 63 68 65 73 29 20 62 75 74 20 69  r PCaches) but i
1280: 74 20 61 6c 73 6f 20 6f 70 65 72 61 74 65 73 20  t also operates 
1290: 77 69 74 68 6f 75 74 20 61 20 6d 75 74 65 78 2c  without a mutex,
12a0: 0a 2a 2a 20 61 6e 64 20 69 73 20 74 68 65 72 65  .** and is there
12b0: 66 6f 72 65 20 6f 66 74 65 6e 20 66 61 73 74 65  fore often faste
12c0: 72 2e 20 20 4d 6f 64 65 20 32 20 72 65 71 75 69  r.  Mode 2 requi
12d0: 72 65 73 20 61 20 6d 75 74 65 78 20 69 6e 20 6f  res a mutex in o
12e0: 72 64 65 72 20 74 6f 20 62 65 0a 2a 2a 20 74 68  rder to be.** th
12f0: 72 65 61 64 73 61 66 65 2c 20 62 75 74 20 72 65  readsafe, but re
1300: 63 79 63 6c 65 73 20 70 61 67 65 73 20 6d 6f 72  cycles pages mor
1310: 65 20 65 66 66 69 63 69 65 6e 74 6c 79 2e 0a 2a  e efficiently..*
1320: 2a 0a 2a 2a 20 46 6f 72 20 6d 6f 64 65 20 28 31  *.** For mode (1
1330: 29 2c 20 50 47 72 6f 75 70 2e 6d 75 74 65 78 20  ), PGroup.mutex 
1340: 69 73 20 4e 55 4c 4c 2e 20 20 46 6f 72 20 6d 6f  is NULL.  For mo
1350: 64 65 20 28 32 29 20 74 68 65 72 65 20 69 73 20  de (2) there is 
1360: 6f 6e 6c 79 20 61 20 73 69 6e 67 6c 65 0a 2a 2a  only a single.**
1370: 20 50 47 72 6f 75 70 20 77 68 69 63 68 20 69 73   PGroup which is
1380: 20 74 68 65 20 70 63 61 63 68 65 31 2e 67 72 70   the pcache1.grp
1390: 20 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65   global variable
13a0: 20 61 6e 64 20 69 74 73 20 6d 75 74 65 78 20 69   and its mutex i
13b0: 73 0a 2a 2a 20 53 51 4c 49 54 45 5f 4d 55 54 45  s.** SQLITE_MUTE
13c0: 58 5f 53 54 41 54 49 43 5f 4c 52 55 2e 0a 2a 2f  X_STATIC_LRU..*/
13d0: 0a 73 74 72 75 63 74 20 50 47 72 6f 75 70 20 7b  .struct PGroup {
13e0: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  .  sqlite3_mutex
13f0: 20 2a 6d 75 74 65 78 3b 20 20 20 20 20 20 20 20   *mutex;        
1400: 20 20 2f 2a 20 4d 55 54 45 58 5f 53 54 41 54 49    /* MUTEX_STATI
1410: 43 5f 4c 52 55 20 6f 72 20 4e 55 4c 4c 20 2a 2f  C_LRU or NULL */
1420: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
1430: 6e 4d 61 78 50 61 67 65 3b 20 20 20 20 20 20 20  nMaxPage;       
1440: 20 20 2f 2a 20 53 75 6d 20 6f 66 20 6e 4d 61 78    /* Sum of nMax
1450: 20 66 6f 72 20 70 75 72 67 65 61 62 6c 65 20 63   for purgeable c
1460: 61 63 68 65 73 20 2a 2f 0a 20 20 75 6e 73 69 67  aches */.  unsig
1470: 6e 65 64 20 69 6e 74 20 6e 4d 69 6e 50 61 67 65  ned int nMinPage
1480: 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 53 75 6d  ;         /* Sum
1490: 20 6f 66 20 6e 4d 69 6e 20 66 6f 72 20 70 75 72   of nMin for pur
14a0: 67 65 61 62 6c 65 20 63 61 63 68 65 73 20 2a 2f  geable caches */
14b0: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
14c0: 6d 78 50 69 6e 6e 65 64 3b 20 20 20 20 20 20 20  mxPinned;       
14d0: 20 20 2f 2a 20 6e 4d 61 78 70 61 67 65 20 2b 20    /* nMaxpage + 
14e0: 31 30 20 2d 20 6e 4d 69 6e 50 61 67 65 20 2a 2f  10 - nMinPage */
14f0: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
1500: 6e 43 75 72 72 65 6e 74 50 61 67 65 3b 20 20 20  nCurrentPage;   
1510: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70    /* Number of p
1520: 75 72 67 65 61 62 6c 65 20 70 61 67 65 73 20 61  urgeable pages a
1530: 6c 6c 6f 63 61 74 65 64 20 2a 2f 0a 20 20 50 67  llocated */.  Pg
1540: 48 64 72 31 20 2a 70 4c 72 75 48 65 61 64 2c 20  Hdr1 *pLruHead, 
1550: 2a 70 4c 72 75 54 61 69 6c 3b 20 20 20 2f 2a 20  *pLruTail;   /* 
1560: 4c 52 55 20 6c 69 73 74 20 6f 66 20 75 6e 70 69  LRU list of unpi
1570: 6e 6e 65 64 20 70 61 67 65 73 20 2a 2f 0a 7d 3b  nned pages */.};
1580: 0a 0a 2f 2a 20 45 61 63 68 20 70 61 67 65 20 63  ../* Each page c
1590: 61 63 68 65 20 69 73 20 61 6e 20 69 6e 73 74 61  ache is an insta
15a0: 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f  nce of the follo
15b0: 77 69 6e 67 20 6f 62 6a 65 63 74 2e 20 20 45 76  wing object.  Ev
15c0: 65 72 79 0a 2a 2a 20 6f 70 65 6e 20 64 61 74 61  ery.** open data
15d0: 62 61 73 65 20 66 69 6c 65 20 28 69 6e 63 6c 75  base file (inclu
15e0: 64 69 6e 67 20 65 61 63 68 20 69 6e 2d 6d 65 6d  ding each in-mem
15f0: 6f 72 79 20 64 61 74 61 62 61 73 65 20 61 6e 64  ory database and
1600: 20 65 61 63 68 0a 2a 2a 20 74 65 6d 70 6f 72 61   each.** tempora
1610: 72 79 20 6f 72 20 74 72 61 6e 73 69 65 6e 74 20  ry or transient 
1620: 64 61 74 61 62 61 73 65 29 20 68 61 73 20 61 20  database) has a 
1630: 73 69 6e 67 6c 65 20 70 61 67 65 20 63 61 63 68  single page cach
1640: 65 20 77 68 69 63 68 0a 2a 2a 20 69 73 20 61 6e  e which.** is an
1650: 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69   instance of thi
1660: 73 20 6f 62 6a 65 63 74 2e 0a 2a 2a 0a 2a 2a 20  s object..**.** 
1670: 50 6f 69 6e 74 65 72 73 20 74 6f 20 73 74 72 75  Pointers to stru
1680: 63 74 75 72 65 73 20 6f 66 20 74 68 69 73 20 74  ctures of this t
1690: 79 70 65 20 61 72 65 20 63 61 73 74 20 61 6e 64  ype are cast and
16a0: 20 72 65 74 75 72 6e 65 64 20 61 73 20 0a 2a 2a   returned as .**
16b0: 20 6f 70 61 71 75 65 20 73 71 6c 69 74 65 33 5f   opaque sqlite3_
16c0: 70 63 61 63 68 65 2a 20 68 61 6e 64 6c 65 73 2e  pcache* handles.
16d0: 0a 2a 2f 0a 73 74 72 75 63 74 20 50 43 61 63 68  .*/.struct PCach
16e0: 65 31 20 7b 0a 20 20 2f 2a 20 43 61 63 68 65 20  e1 {.  /* Cache 
16f0: 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 70 61  configuration pa
1700: 72 61 6d 65 74 65 72 73 2e 20 50 61 67 65 20 73  rameters. Page s
1710: 69 7a 65 20 28 73 7a 50 61 67 65 29 20 61 6e 64  ize (szPage) and
1720: 20 74 68 65 20 70 75 72 67 65 61 62 6c 65 0a 20   the purgeable. 
1730: 20 2a 2a 20 66 6c 61 67 20 28 62 50 75 72 67 65   ** flag (bPurge
1740: 61 62 6c 65 29 20 61 72 65 20 73 65 74 20 77 68  able) are set wh
1750: 65 6e 20 74 68 65 20 63 61 63 68 65 20 69 73 20  en the cache is 
1760: 63 72 65 61 74 65 64 2e 20 6e 4d 61 78 20 6d 61  created. nMax ma
1770: 79 20 62 65 20 0a 20 20 2a 2a 20 6d 6f 64 69 66  y be .  ** modif
1780: 69 65 64 20 61 74 20 61 6e 79 20 74 69 6d 65 20  ied at any time 
1790: 62 79 20 61 20 63 61 6c 6c 20 74 6f 20 74 68 65  by a call to the
17a0: 20 70 63 61 63 68 65 31 43 61 63 68 65 73 69 7a   pcache1Cachesiz
17b0: 65 28 29 20 6d 65 74 68 6f 64 2e 0a 20 20 2a 2a  e() method..  **
17c0: 20 54 68 65 20 50 47 72 6f 75 70 20 6d 75 74 65   The PGroup mute
17d0: 78 20 6d 75 73 74 20 62 65 20 68 65 6c 64 20 77  x must be held w
17e0: 68 65 6e 20 61 63 63 65 73 73 69 6e 67 20 6e 4d  hen accessing nM
17f0: 61 78 2e 0a 20 20 2a 2f 0a 20 20 50 47 72 6f 75  ax..  */.  PGrou
1800: 70 20 2a 70 47 72 6f 75 70 3b 20 20 20 20 20 20  p *pGroup;      
1810: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1820: 2a 20 50 47 72 6f 75 70 20 74 68 69 73 20 63 61  * PGroup this ca
1830: 63 68 65 20 62 65 6c 6f 6e 67 73 20 74 6f 20 2a  che belongs to *
1840: 2f 0a 20 20 69 6e 74 20 73 7a 50 61 67 65 3b 20  /.  int szPage; 
1850: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1860: 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20          /* Size 
1870: 6f 66 20 64 61 74 61 62 61 73 65 20 63 6f 6e 74  of database cont
1880: 65 6e 74 20 73 65 63 74 69 6f 6e 20 2a 2f 0a 20  ent section */. 
1890: 20 69 6e 74 20 73 7a 45 78 74 72 61 3b 20 20 20   int szExtra;   
18a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
18b0: 20 20 20 20 20 2f 2a 20 73 69 7a 65 6f 66 28 4d       /* sizeof(M
18c0: 65 6d 50 61 67 65 29 2b 73 69 7a 65 6f 66 28 50  emPage)+sizeof(P
18d0: 67 48 64 72 29 20 2a 2f 0a 20 20 69 6e 74 20 73  gHdr) */.  int s
18e0: 7a 41 6c 6c 6f 63 3b 20 20 20 20 20 20 20 20 20  zAlloc;         
18f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1900: 2a 20 54 6f 74 61 6c 20 73 69 7a 65 20 6f 66 20  * Total size of 
1910: 6f 6e 65 20 70 63 61 63 68 65 20 6c 69 6e 65 20  one pcache line 
1920: 2a 2f 0a 20 20 69 6e 74 20 62 50 75 72 67 65 61  */.  int bPurgea
1930: 62 6c 65 3b 20 20 20 20 20 20 20 20 20 20 20 20  ble;            
1940: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65           /* True
1950: 20 69 66 20 63 61 63 68 65 20 69 73 20 70 75 72   if cache is pur
1960: 67 65 61 62 6c 65 20 2a 2f 0a 20 20 75 6e 73 69  geable */.  unsi
1970: 67 6e 65 64 20 69 6e 74 20 6e 4d 69 6e 3b 20 20  gned int nMin;  
1980: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1990: 2f 2a 20 4d 69 6e 69 6d 75 6d 20 6e 75 6d 62 65  /* Minimum numbe
19a0: 72 20 6f 66 20 70 61 67 65 73 20 72 65 73 65 72  r of pages reser
19b0: 76 65 64 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65  ved */.  unsigne
19c0: 64 20 69 6e 74 20 6e 4d 61 78 3b 20 20 20 20 20  d int nMax;     
19d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
19e0: 43 6f 6e 66 69 67 75 72 65 64 20 22 63 61 63 68  Configured "cach
19f0: 65 5f 73 69 7a 65 22 20 76 61 6c 75 65 20 2a 2f  e_size" value */
1a00: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
1a10: 6e 39 30 70 63 74 3b 20 20 20 20 20 20 20 20 20  n90pct;         
1a20: 20 20 20 20 20 20 20 2f 2a 20 6e 4d 61 78 2a 39         /* nMax*9
1a30: 2f 31 30 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65  /10 */.  unsigne
1a40: 64 20 69 6e 74 20 69 4d 61 78 4b 65 79 3b 20 20  d int iMaxKey;  
1a50: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1a60: 4c 61 72 67 65 73 74 20 6b 65 79 20 73 65 65 6e  Largest key seen
1a70: 20 73 69 6e 63 65 20 78 54 72 75 6e 63 61 74 65   since xTruncate
1a80: 28 29 20 2a 2f 0a 0a 20 20 2f 2a 20 48 61 73 68  () */..  /* Hash
1a90: 20 74 61 62 6c 65 20 6f 66 20 61 6c 6c 20 70 61   table of all pa
1aa0: 67 65 73 2e 20 54 68 65 20 66 6f 6c 6c 6f 77 69  ges. The followi
1ab0: 6e 67 20 76 61 72 69 61 62 6c 65 73 20 6d 61 79  ng variables may
1ac0: 20 6f 6e 6c 79 20 62 65 20 61 63 63 65 73 73 65   only be accesse
1ad0: 64 0a 20 20 2a 2a 20 77 68 65 6e 20 74 68 65 20  d.  ** when the 
1ae0: 61 63 63 65 73 73 6f 72 20 69 73 20 68 6f 6c 64  accessor is hold
1af0: 69 6e 67 20 74 68 65 20 50 47 72 6f 75 70 20 6d  ing the PGroup m
1b00: 75 74 65 78 2e 0a 20 20 2a 2f 0a 20 20 75 6e 73  utex..  */.  uns
1b10: 69 67 6e 65 64 20 69 6e 74 20 6e 52 65 63 79 63  igned int nRecyc
1b20: 6c 61 62 6c 65 3b 20 20 20 20 20 20 20 20 20 20  lable;          
1b30: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61   /* Number of pa
1b40: 67 65 73 20 69 6e 20 74 68 65 20 4c 52 55 20 6c  ges in the LRU l
1b50: 69 73 74 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65  ist */.  unsigne
1b60: 64 20 69 6e 74 20 6e 50 61 67 65 3b 20 20 20 20  d int nPage;    
1b70: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1b80: 54 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20  Total number of 
1b90: 70 61 67 65 73 20 69 6e 20 61 70 48 61 73 68 20  pages in apHash 
1ba0: 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e  */.  unsigned in
1bb0: 74 20 6e 48 61 73 68 3b 20 20 20 20 20 20 20 20  t nHash;        
1bc0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62           /* Numb
1bd0: 65 72 20 6f 66 20 73 6c 6f 74 73 20 69 6e 20 61  er of slots in a
1be0: 70 48 61 73 68 5b 5d 20 2a 2f 0a 20 20 50 67 48  pHash[] */.  PgH
1bf0: 64 72 31 20 2a 2a 61 70 48 61 73 68 3b 20 20 20  dr1 **apHash;   
1c00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1c10: 20 2f 2a 20 48 61 73 68 20 74 61 62 6c 65 20 66   /* Hash table f
1c20: 6f 72 20 66 61 73 74 20 6c 6f 6f 6b 75 70 20 62  or fast lookup b
1c30: 79 20 6b 65 79 20 2a 2f 0a 20 20 50 67 48 64 72  y key */.  PgHdr
1c40: 31 20 2a 70 46 72 65 65 3b 20 20 20 20 20 20 20  1 *pFree;       
1c50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1c60: 2a 20 4c 69 73 74 20 6f 66 20 75 6e 75 73 65 64  * List of unused
1c70: 20 70 63 61 63 68 65 2d 6c 6f 63 61 6c 20 70 61   pcache-local pa
1c80: 67 65 73 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70  ges */.  void *p
1c90: 42 75 6c 6b 3b 20 20 20 20 20 20 20 20 20 20 20  Bulk;           
1ca0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1cb0: 42 75 6c 6b 20 6d 65 6d 6f 72 79 20 75 73 65 64  Bulk memory used
1cc0: 20 62 79 20 70 63 61 63 68 65 2d 6c 6f 63 61 6c   by pcache-local
1cd0: 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 45 61   */.};../*.** Ea
1ce0: 63 68 20 63 61 63 68 65 20 65 6e 74 72 79 20 69  ch cache entry i
1cf0: 73 20 72 65 70 72 65 73 65 6e 74 65 64 20 62 79  s represented by
1d00: 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20   an instance of 
1d10: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 0a 2a  the following .*
1d20: 2a 20 73 74 72 75 63 74 75 72 65 2e 20 55 6e 6c  * structure. Unl
1d30: 65 73 73 20 53 51 4c 49 54 45 5f 50 43 41 43 48  ess SQLITE_PCACH
1d40: 45 5f 53 45 50 41 52 41 54 45 5f 48 45 41 44 45  E_SEPARATE_HEADE
1d50: 52 20 69 73 20 64 65 66 69 6e 65 64 2c 20 61 20  R is defined, a 
1d60: 62 75 66 66 65 72 20 6f 66 0a 2a 2a 20 50 67 48  buffer of.** PgH
1d70: 64 72 31 2e 70 43 61 63 68 65 2d 3e 73 7a 50 61  dr1.pCache->szPa
1d80: 67 65 20 62 79 74 65 73 20 69 73 20 61 6c 6c 6f  ge bytes is allo
1d90: 63 61 74 65 64 20 64 69 72 65 63 74 6c 79 20 62  cated directly b
1da0: 65 66 6f 72 65 20 74 68 69 73 20 73 74 72 75 63  efore this struc
1db0: 74 75 72 65 20 0a 2a 2a 20 69 6e 20 6d 65 6d 6f  ture .** in memo
1dc0: 72 79 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 50 67  ry..*/.struct Pg
1dd0: 48 64 72 31 20 7b 0a 20 20 73 71 6c 69 74 65 33  Hdr1 {.  sqlite3
1de0: 5f 70 63 61 63 68 65 5f 70 61 67 65 20 70 61 67  _pcache_page pag
1df0: 65 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e  e;.  unsigned in
1e00: 74 20 69 4b 65 79 3b 20 20 20 20 20 20 20 20 20  t iKey;         
1e10: 20 20 20 20 2f 2a 20 4b 65 79 20 76 61 6c 75 65      /* Key value
1e20: 20 28 70 61 67 65 20 6e 75 6d 62 65 72 29 20 2a   (page number) *
1e30: 2f 0a 20 20 75 38 20 69 73 50 69 6e 6e 65 64 3b  /.  u8 isPinned;
1e40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1e50: 20 20 20 2f 2a 20 50 61 67 65 20 69 6e 20 75 73     /* Page in us
1e60: 65 2c 20 6e 6f 74 20 6f 6e 20 74 68 65 20 4c 52  e, not on the LR
1e70: 55 20 6c 69 73 74 20 2a 2f 0a 20 20 75 38 20 69  U list */.  u8 i
1e80: 73 42 75 6c 6b 4c 6f 63 61 6c 3b 20 20 20 20 20  sBulkLocal;     
1e90: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68             /* Th
1ea0: 69 73 20 70 61 67 65 20 66 72 6f 6d 20 62 75 6c  is page from bul
1eb0: 6b 20 6c 6f 63 61 6c 20 73 74 6f 72 61 67 65 20  k local storage 
1ec0: 2a 2f 0a 20 20 50 67 48 64 72 31 20 2a 70 4e 65  */.  PgHdr1 *pNe
1ed0: 78 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  xt;             
1ee0: 20 20 20 20 2f 2a 20 4e 65 78 74 20 69 6e 20 68      /* Next in h
1ef0: 61 73 68 20 74 61 62 6c 65 20 63 68 61 69 6e 20  ash table chain 
1f00: 2a 2f 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43  */.  PCache1 *pC
1f10: 61 63 68 65 3b 20 20 20 20 20 20 20 20 20 20 20  ache;           
1f20: 20 20 20 20 2f 2a 20 43 61 63 68 65 20 74 68 61      /* Cache tha
1f30: 74 20 63 75 72 72 65 6e 74 6c 79 20 6f 77 6e 73  t currently owns
1f40: 20 74 68 69 73 20 70 61 67 65 20 2a 2f 0a 20 20   this page */.  
1f50: 50 67 48 64 72 31 20 2a 70 4c 72 75 4e 65 78 74  PgHdr1 *pLruNext
1f60: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  ;              /
1f70: 2a 20 4e 65 78 74 20 69 6e 20 4c 52 55 20 6c 69  * Next in LRU li
1f80: 73 74 20 6f 66 20 75 6e 70 69 6e 6e 65 64 20 70  st of unpinned p
1f90: 61 67 65 73 20 2a 2f 0a 20 20 50 67 48 64 72 31  ages */.  PgHdr1
1fa0: 20 2a 70 4c 72 75 50 72 65 76 3b 20 20 20 20 20   *pLruPrev;     
1fb0: 20 20 20 20 20 20 20 20 20 2f 2a 20 50 72 65 76           /* Prev
1fc0: 69 6f 75 73 20 69 6e 20 4c 52 55 20 6c 69 73 74  ious in LRU list
1fd0: 20 6f 66 20 75 6e 70 69 6e 6e 65 64 20 70 61 67   of unpinned pag
1fe0: 65 73 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20  es */.};../*.** 
1ff0: 46 72 65 65 20 73 6c 6f 74 73 20 69 6e 20 74 68  Free slots in th
2000: 65 20 61 6c 6c 6f 63 61 74 6f 72 20 75 73 65 64  e allocator used
2010: 20 74 6f 20 64 69 76 69 64 65 20 75 70 20 74 68   to divide up th
2020: 65 20 67 6c 6f 62 61 6c 20 70 61 67 65 20 63 61  e global page ca
2030: 63 68 65 0a 2a 2a 20 62 75 66 66 65 72 20 70 72  che.** buffer pr
2040: 6f 76 69 64 65 64 20 75 73 69 6e 67 20 74 68 65  ovided using the
2050: 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50   SQLITE_CONFIG_P
2060: 41 47 45 43 41 43 48 45 20 6d 65 63 68 61 6e 69  AGECACHE mechani
2070: 73 6d 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 50 67  sm..*/.struct Pg
2080: 46 72 65 65 73 6c 6f 74 20 7b 0a 20 20 50 67 46  Freeslot {.  PgF
2090: 72 65 65 73 6c 6f 74 20 2a 70 4e 65 78 74 3b 20  reeslot *pNext; 
20a0: 20 2f 2a 20 4e 65 78 74 20 66 72 65 65 20 73 6c   /* Next free sl
20b0: 6f 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20  ot */.};../*.** 
20c0: 47 6c 6f 62 61 6c 20 64 61 74 61 20 75 73 65 64  Global data used
20d0: 20 62 79 20 74 68 69 73 20 63 61 63 68 65 2e 0a   by this cache..
20e0: 2a 2f 0a 73 74 61 74 69 63 20 53 51 4c 49 54 45  */.static SQLITE
20f0: 5f 57 53 44 20 73 74 72 75 63 74 20 50 43 61 63  _WSD struct PCac
2100: 68 65 47 6c 6f 62 61 6c 20 7b 0a 20 20 50 47 72  heGlobal {.  PGr
2110: 6f 75 70 20 67 72 70 3b 20 20 20 20 20 20 20 20  oup grp;        
2120: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
2130: 68 65 20 67 6c 6f 62 61 6c 20 50 47 72 6f 75 70  he global PGroup
2140: 20 66 6f 72 20 6d 6f 64 65 20 28 32 29 20 2a 2f   for mode (2) */
2150: 0a 0a 20 20 2f 2a 20 56 61 72 69 61 62 6c 65 73  ..  /* Variables
2160: 20 72 65 6c 61 74 65 64 20 74 6f 20 53 51 4c 49   related to SQLI
2170: 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41  TE_CONFIG_PAGECA
2180: 43 48 45 20 73 65 74 74 69 6e 67 73 2e 20 20 54  CHE settings.  T
2190: 68 65 0a 20 20 2a 2a 20 73 7a 53 6c 6f 74 2c 20  he.  ** szSlot, 
21a0: 6e 53 6c 6f 74 2c 20 70 53 74 61 72 74 2c 20 70  nSlot, pStart, p
21b0: 45 6e 64 2c 20 6e 52 65 73 65 72 76 65 2c 20 61  End, nReserve, a
21c0: 6e 64 20 69 73 49 6e 69 74 20 76 61 6c 75 65 73  nd isInit values
21d0: 20 61 72 65 20 61 6c 6c 0a 20 20 2a 2a 20 66 69   are all.  ** fi
21e0: 78 65 64 20 61 74 20 73 71 6c 69 74 65 33 5f 69  xed at sqlite3_i
21f0: 6e 69 74 69 61 6c 69 7a 65 28 29 20 74 69 6d 65  nitialize() time
2200: 20 61 6e 64 20 64 6f 20 6e 6f 74 20 72 65 71 75   and do not requ
2210: 69 72 65 20 6d 75 74 65 78 20 70 72 6f 74 65 63  ire mutex protec
2220: 74 69 6f 6e 2e 0a 20 20 2a 2a 20 54 68 65 20 6e  tion..  ** The n
2230: 46 72 65 65 53 6c 6f 74 20 61 6e 64 20 70 46 72  FreeSlot and pFr
2240: 65 65 20 76 61 6c 75 65 73 20 64 6f 20 72 65 71  ee values do req
2250: 75 69 72 65 20 6d 75 74 65 78 20 70 72 6f 74 65  uire mutex prote
2260: 63 74 69 6f 6e 2e 0a 20 20 2a 2f 0a 20 20 69 6e  ction..  */.  in
2270: 74 20 69 73 49 6e 69 74 3b 20 20 20 20 20 20 20  t isInit;       
2280: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
2290: 54 72 75 65 20 69 66 20 69 6e 69 74 69 61 6c 69  True if initiali
22a0: 7a 65 64 20 2a 2f 0a 20 20 69 6e 74 20 73 65 70  zed */.  int sep
22b0: 61 72 61 74 65 43 61 63 68 65 3b 20 20 20 20 20  arateCache;     
22c0: 20 20 20 20 20 20 20 20 2f 2a 20 55 73 65 20 61          /* Use a
22d0: 20 6e 65 77 20 50 47 72 6f 75 70 20 66 6f 72 20   new PGroup for 
22e0: 65 61 63 68 20 50 43 61 63 68 65 20 2a 2f 0a 20  each PCache */. 
22f0: 20 69 6e 74 20 6e 49 6e 69 74 50 61 67 65 3b 20   int nInitPage; 
2300: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2310: 2f 2a 20 49 6e 69 74 69 61 6c 20 62 75 6c 6b 20  /* Initial bulk 
2320: 61 6c 6c 6f 63 61 74 69 6f 6e 20 73 69 7a 65 20  allocation size 
2330: 2a 2f 20 20 20 0a 20 20 69 6e 74 20 73 7a 53 6c  */   .  int szSl
2340: 6f 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  ot;             
2350: 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f         /* Size o
2360: 66 20 65 61 63 68 20 66 72 65 65 20 73 6c 6f 74  f each free slot
2370: 20 2a 2f 0a 20 20 69 6e 74 20 6e 53 6c 6f 74 3b   */.  int nSlot;
2380: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2390: 20 20 20 20 20 2f 2a 20 54 68 65 20 6e 75 6d 62       /* The numb
23a0: 65 72 20 6f 66 20 70 63 61 63 68 65 20 73 6c 6f  er of pcache slo
23b0: 74 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 73  ts */.  int nRes
23c0: 65 72 76 65 3b 20 20 20 20 20 20 20 20 20 20 20  erve;           
23d0: 20 20 20 20 20 20 20 2f 2a 20 54 72 79 20 74 6f         /* Try to
23e0: 20 6b 65 65 70 20 6e 46 72 65 65 53 6c 6f 74 20   keep nFreeSlot 
23f0: 61 62 6f 76 65 20 74 68 69 73 20 2a 2f 0a 20 20  above this */.  
2400: 76 6f 69 64 20 2a 70 53 74 61 72 74 2c 20 2a 70  void *pStart, *p
2410: 45 6e 64 3b 20 20 20 20 20 20 20 20 20 20 20 2f  End;           /
2420: 2a 20 42 6f 75 6e 64 73 20 6f 66 20 67 6c 6f 62  * Bounds of glob
2430: 61 6c 20 70 61 67 65 20 63 61 63 68 65 20 6d 65  al page cache me
2440: 6d 6f 72 79 20 2a 2f 0a 20 20 2f 2a 20 41 62 6f  mory */.  /* Abo
2450: 76 65 20 72 65 71 75 69 72 65 73 20 6e 6f 20 6d  ve requires no m
2460: 75 74 65 78 2e 20 20 55 73 65 20 6d 75 74 65 78  utex.  Use mutex
2470: 20 62 65 6c 6f 77 20 66 6f 72 20 76 61 72 69 61   below for varia
2480: 62 6c 65 20 74 68 61 74 20 66 6f 6c 6c 6f 77 2e  ble that follow.
2490: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75   */.  sqlite3_mu
24a0: 74 65 78 20 2a 6d 75 74 65 78 3b 20 20 20 20 20  tex *mutex;     
24b0: 20 20 20 20 20 2f 2a 20 4d 75 74 65 78 20 66 6f       /* Mutex fo
24c0: 72 20 61 63 63 65 73 73 69 6e 67 20 74 68 65 20  r accessing the 
24d0: 66 6f 6c 6c 6f 77 69 6e 67 3a 20 2a 2f 0a 20 20  following: */.  
24e0: 50 67 46 72 65 65 73 6c 6f 74 20 2a 70 46 72 65  PgFreeslot *pFre
24f0: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  e;             /
2500: 2a 20 46 72 65 65 20 70 61 67 65 20 62 6c 6f 63  * Free page bloc
2510: 6b 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 46 72 65  ks */.  int nFre
2520: 65 53 6c 6f 74 3b 20 20 20 20 20 20 20 20 20 20  eSlot;          
2530: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72         /* Number
2540: 20 6f 66 20 75 6e 75 73 65 64 20 70 63 61 63 68   of unused pcach
2550: 65 20 73 6c 6f 74 73 20 2a 2f 0a 20 20 2f 2a 20  e slots */.  /* 
2560: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 76 61  The following va
2570: 6c 75 65 20 72 65 71 75 69 72 65 73 20 61 20 6d  lue requires a m
2580: 75 74 65 78 20 74 6f 20 63 68 61 6e 67 65 2e 20  utex to change. 
2590: 20 57 65 20 73 6b 69 70 20 74 68 65 20 6d 75 74   We skip the mut
25a0: 65 78 20 6f 6e 0a 20 20 2a 2a 20 72 65 61 64 69  ex on.  ** readi
25b0: 6e 67 20 62 65 63 61 75 73 65 20 28 31 29 20 6d  ng because (1) m
25c0: 6f 73 74 20 70 6c 61 74 66 6f 72 6d 73 20 72 65  ost platforms re
25d0: 61 64 20 61 20 33 32 2d 62 69 74 20 69 6e 74 65  ad a 32-bit inte
25e0: 67 65 72 20 61 74 6f 6d 69 63 61 6c 6c 79 20 61  ger atomically a
25f0: 6e 64 0a 20 20 2a 2a 20 28 32 29 20 65 76 65 6e  nd.  ** (2) even
2600: 20 69 66 20 61 6e 20 69 6e 63 6f 72 72 65 63 74   if an incorrect
2610: 20 76 61 6c 75 65 20 69 73 20 72 65 61 64 2c 20   value is read, 
2620: 6e 6f 20 67 72 65 61 74 20 68 61 72 6d 20 69 73  no great harm is
2630: 20 64 6f 6e 65 20 73 69 6e 63 65 20 74 68 69 73   done since this
2640: 0a 20 20 2a 2a 20 69 73 20 72 65 61 6c 6c 79 20  .  ** is really 
2650: 6a 75 73 74 20 61 6e 20 6f 70 74 69 6d 69 7a 61  just an optimiza
2660: 74 69 6f 6e 2e 20 2a 2f 0a 20 20 69 6e 74 20 62  tion. */.  int b
2670: 55 6e 64 65 72 50 72 65 73 73 75 72 65 3b 20 20  UnderPressure;  
2680: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75            /* Tru
2690: 65 20 69 66 20 6c 6f 77 20 6f 6e 20 50 41 47 45  e if low on PAGE
26a0: 43 41 43 48 45 20 6d 65 6d 6f 72 79 20 2a 2f 0a  CACHE memory */.
26b0: 7d 20 70 63 61 63 68 65 31 5f 67 3b 0a 0a 2f 2a  } pcache1_g;../*
26c0: 0a 2a 2a 20 41 6c 6c 20 63 6f 64 65 20 69 6e 20  .** All code in 
26d0: 74 68 69 73 20 66 69 6c 65 20 73 68 6f 75 6c 64  this file should
26e0: 20 61 63 63 65 73 73 20 74 68 65 20 67 6c 6f 62   access the glob
26f0: 61 6c 20 73 74 72 75 63 74 75 72 65 20 61 62 6f  al structure abo
2700: 76 65 20 76 69 61 20 74 68 65 0a 2a 2a 20 61 6c  ve via the.** al
2710: 69 61 73 20 22 70 63 61 63 68 65 31 22 2e 20 54  ias "pcache1". T
2720: 68 69 73 20 65 6e 73 75 72 65 73 20 74 68 61 74  his ensures that
2730: 20 74 68 65 20 57 53 44 20 65 6d 75 6c 61 74 69   the WSD emulati
2740: 6f 6e 20 69 73 20 75 73 65 64 20 77 68 65 6e 0a  on is used when.
2750: 2a 2a 20 63 6f 6d 70 69 6c 69 6e 67 20 66 6f 72  ** compiling for
2760: 20 73 79 73 74 65 6d 73 20 74 68 61 74 20 64 6f   systems that do
2770: 20 6e 6f 74 20 73 75 70 70 6f 72 74 20 72 65 61   not support rea
2780: 6c 20 57 53 44 2e 0a 2a 2f 0a 23 64 65 66 69 6e  l WSD..*/.#defin
2790: 65 20 70 63 61 63 68 65 31 20 28 47 4c 4f 42 41  e pcache1 (GLOBA
27a0: 4c 28 73 74 72 75 63 74 20 50 43 61 63 68 65 47  L(struct PCacheG
27b0: 6c 6f 62 61 6c 2c 20 70 63 61 63 68 65 31 5f 67  lobal, pcache1_g
27c0: 29 29 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72 6f 73  ))../*.** Macros
27d0: 20 74 6f 20 65 6e 74 65 72 20 61 6e 64 20 6c 65   to enter and le
27e0: 61 76 65 20 74 68 65 20 50 43 61 63 68 65 20 4c  ave the PCache L
27f0: 52 55 20 6d 75 74 65 78 2e 0a 2a 2f 0a 23 69 66  RU mutex..*/.#if
2800: 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45   !defined(SQLITE
2810: 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d  _ENABLE_MEMORY_M
2820: 41 4e 41 47 45 4d 45 4e 54 29 20 7c 7c 20 53 51  ANAGEMENT) || SQ
2830: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d  LITE_THREADSAFE=
2840: 3d 30 0a 23 20 64 65 66 69 6e 65 20 70 63 61 63  =0.# define pcac
2850: 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 58 29  he1EnterMutex(X)
2860: 20 20 61 73 73 65 72 74 28 28 58 29 2d 3e 6d 75    assert((X)->mu
2870: 74 65 78 3d 3d 30 29 0a 23 20 64 65 66 69 6e 65  tex==0).# define
2880: 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74   pcache1LeaveMut
2890: 65 78 28 58 29 20 20 61 73 73 65 72 74 28 28 58  ex(X)  assert((X
28a0: 29 2d 3e 6d 75 74 65 78 3d 3d 30 29 0a 23 20 64  )->mutex==0).# d
28b0: 65 66 69 6e 65 20 50 43 41 43 48 45 31 5f 4d 49  efine PCACHE1_MI
28c0: 47 48 54 5f 55 53 45 5f 47 52 4f 55 50 5f 4d 55  GHT_USE_GROUP_MU
28d0: 54 45 58 20 30 0a 23 65 6c 73 65 0a 23 20 64 65  TEX 0.#else.# de
28e0: 66 69 6e 65 20 70 63 61 63 68 65 31 45 6e 74 65  fine pcache1Ente
28f0: 72 4d 75 74 65 78 28 58 29 20 73 71 6c 69 74 65  rMutex(X) sqlite
2900: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 28 58  3_mutex_enter((X
2910: 29 2d 3e 6d 75 74 65 78 29 0a 23 20 64 65 66 69  )->mutex).# defi
2920: 6e 65 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d  ne pcache1LeaveM
2930: 75 74 65 78 28 58 29 20 73 71 6c 69 74 65 33 5f  utex(X) sqlite3_
2940: 6d 75 74 65 78 5f 6c 65 61 76 65 28 28 58 29 2d  mutex_leave((X)-
2950: 3e 6d 75 74 65 78 29 0a 23 20 64 65 66 69 6e 65  >mutex).# define
2960: 20 50 43 41 43 48 45 31 5f 4d 49 47 48 54 5f 55   PCACHE1_MIGHT_U
2970: 53 45 5f 47 52 4f 55 50 5f 4d 55 54 45 58 20 31  SE_GROUP_MUTEX 1
2980: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 2a 2a 2a 2a 2a  .#endif../******
2990: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
29a0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
29b0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
29c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
29d0: 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 2f 2a 2a 2a 2a 2a  ********/./*****
29e0: 2a 2a 2a 20 50 61 67 65 20 41 6c 6c 6f 63 61 74  *** Page Allocat
29f0: 69 6f 6e 2f 53 51 4c 49 54 45 5f 43 4f 4e 46 49  ion/SQLITE_CONFI
2a00: 47 5f 50 43 41 43 48 45 20 52 65 6c 61 74 65 64  G_PCACHE Related
2a10: 20 46 75 6e 63 74 69 6f 6e 73 20 2a 2a 2a 2a 2a   Functions *****
2a20: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 0a 2a  *********/../*.*
2a30: 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  * This function 
2a40: 69 73 20 63 61 6c 6c 65 64 20 64 75 72 69 6e 67  is called during
2a50: 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20   initialization 
2a60: 69 66 20 61 20 73 74 61 74 69 63 20 62 75 66 66  if a static buff
2a70: 65 72 20 69 73 20 0a 2a 2a 20 73 75 70 70 6c 69  er is .** suppli
2a80: 65 64 20 74 6f 20 75 73 65 20 66 6f 72 20 74 68  ed to use for th
2a90: 65 20 70 61 67 65 2d 63 61 63 68 65 20 62 79 20  e page-cache by 
2aa0: 70 61 73 73 69 6e 67 20 74 68 65 20 53 51 4c 49  passing the SQLI
2ab0: 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41  TE_CONFIG_PAGECA
2ac0: 43 48 45 0a 2a 2a 20 76 65 72 62 20 74 6f 20 73  CHE.** verb to s
2ad0: 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 29 2e  qlite3_config().
2ae0: 20 50 61 72 61 6d 65 74 65 72 20 70 42 75 66 20   Parameter pBuf 
2af0: 70 6f 69 6e 74 73 20 74 6f 20 61 6e 20 61 6c 6c  points to an all
2b00: 6f 63 61 74 69 6f 6e 20 6c 61 72 67 65 0a 2a 2a  ocation large.**
2b10: 20 65 6e 6f 75 67 68 20 74 6f 20 63 6f 6e 74 61   enough to conta
2b20: 69 6e 20 27 6e 27 20 62 75 66 66 65 72 73 20 6f  in 'n' buffers o
2b30: 66 20 27 73 7a 27 20 62 79 74 65 73 20 65 61 63  f 'sz' bytes eac
2b40: 68 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f  h..**.** This ro
2b50: 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 20  utine is called 
2b60: 66 72 6f 6d 20 73 71 6c 69 74 65 33 5f 69 6e 69  from sqlite3_ini
2b70: 74 69 61 6c 69 7a 65 28 29 20 61 6e 64 20 73 6f  tialize() and so
2b80: 20 69 74 20 69 73 20 67 75 61 72 61 6e 74 65 65   it is guarantee
2b90: 64 0a 2a 2a 20 74 6f 20 62 65 20 73 65 72 69 61  d.** to be seria
2ba0: 6c 69 7a 65 64 20 61 6c 72 65 61 64 79 2e 20 20  lized already.  
2bb0: 54 68 65 72 65 20 69 73 20 6e 6f 20 6e 65 65 64  There is no need
2bc0: 20 66 6f 72 20 66 75 72 74 68 65 72 20 6d 75 74   for further mut
2bd0: 65 78 69 6e 67 2e 0a 2a 2f 0a 76 6f 69 64 20 73  exing..*/.void s
2be0: 71 6c 69 74 65 33 50 43 61 63 68 65 42 75 66 66  qlite3PCacheBuff
2bf0: 65 72 53 65 74 75 70 28 76 6f 69 64 20 2a 70 42  erSetup(void *pB
2c00: 75 66 2c 20 69 6e 74 20 73 7a 2c 20 69 6e 74 20  uf, int sz, int 
2c10: 6e 29 7b 0a 20 20 69 66 28 20 70 63 61 63 68 65  n){.  if( pcache
2c20: 31 2e 69 73 49 6e 69 74 20 29 7b 0a 20 20 20 20  1.isInit ){.    
2c30: 50 67 46 72 65 65 73 6c 6f 74 20 2a 70 3b 0a 20  PgFreeslot *p;. 
2c40: 20 20 20 69 66 28 20 70 42 75 66 3d 3d 30 20 29     if( pBuf==0 )
2c50: 20 73 7a 20 3d 20 6e 20 3d 20 30 3b 0a 20 20 20   sz = n = 0;.   
2c60: 20 73 7a 20 3d 20 52 4f 55 4e 44 44 4f 57 4e 38   sz = ROUNDDOWN8
2c70: 28 73 7a 29 3b 0a 20 20 20 20 70 63 61 63 68 65  (sz);.    pcache
2c80: 31 2e 73 7a 53 6c 6f 74 20 3d 20 73 7a 3b 0a 20  1.szSlot = sz;. 
2c90: 20 20 20 70 63 61 63 68 65 31 2e 6e 53 6c 6f 74     pcache1.nSlot
2ca0: 20 3d 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65   = pcache1.nFree
2cb0: 53 6c 6f 74 20 3d 20 6e 3b 0a 20 20 20 20 70 63  Slot = n;.    pc
2cc0: 61 63 68 65 31 2e 6e 52 65 73 65 72 76 65 20 3d  ache1.nReserve =
2cd0: 20 6e 3e 39 30 20 3f 20 31 30 20 3a 20 28 6e 2f   n>90 ? 10 : (n/
2ce0: 31 30 20 2b 20 31 29 3b 0a 20 20 20 20 70 63 61  10 + 1);.    pca
2cf0: 63 68 65 31 2e 70 53 74 61 72 74 20 3d 20 70 42  che1.pStart = pB
2d00: 75 66 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e  uf;.    pcache1.
2d10: 70 46 72 65 65 20 3d 20 30 3b 0a 20 20 20 20 70  pFree = 0;.    p
2d20: 63 61 63 68 65 31 2e 62 55 6e 64 65 72 50 72 65  cache1.bUnderPre
2d30: 73 73 75 72 65 20 3d 20 30 3b 0a 20 20 20 20 77  ssure = 0;.    w
2d40: 68 69 6c 65 28 20 6e 2d 2d 20 29 7b 0a 20 20 20  hile( n-- ){.   
2d50: 20 20 20 70 20 3d 20 28 50 67 46 72 65 65 73 6c     p = (PgFreesl
2d60: 6f 74 2a 29 70 42 75 66 3b 0a 20 20 20 20 20 20  ot*)pBuf;.      
2d70: 70 2d 3e 70 4e 65 78 74 20 3d 20 70 63 61 63 68  p->pNext = pcach
2d80: 65 31 2e 70 46 72 65 65 3b 0a 20 20 20 20 20 20  e1.pFree;.      
2d90: 70 63 61 63 68 65 31 2e 70 46 72 65 65 20 3d 20  pcache1.pFree = 
2da0: 70 3b 0a 20 20 20 20 20 20 70 42 75 66 20 3d 20  p;.      pBuf = 
2db0: 28 76 6f 69 64 2a 29 26 28 28 63 68 61 72 2a 29  (void*)&((char*)
2dc0: 70 42 75 66 29 5b 73 7a 5d 3b 0a 20 20 20 20 7d  pBuf)[sz];.    }
2dd0: 0a 20 20 20 20 70 63 61 63 68 65 31 2e 70 45 6e  .    pcache1.pEn
2de0: 64 20 3d 20 70 42 75 66 3b 0a 20 20 7d 0a 7d 0a  d = pBuf;.  }.}.
2df0: 0a 2f 2a 0a 2a 2a 20 54 72 79 20 74 6f 20 69 6e  ./*.** Try to in
2e00: 69 74 69 61 6c 69 7a 65 20 74 68 65 20 70 43 61  itialize the pCa
2e10: 63 68 65 2d 3e 70 46 72 65 65 20 61 6e 64 20 70  che->pFree and p
2e20: 43 61 63 68 65 2d 3e 70 42 75 6c 6b 20 66 69 65  Cache->pBulk fie
2e30: 6c 64 73 2e 20 20 52 65 74 75 72 6e 0a 2a 2a 20  lds.  Return.** 
2e40: 74 72 75 65 20 69 66 20 70 43 61 63 68 65 2d 3e  true if pCache->
2e50: 70 46 72 65 65 20 65 6e 64 73 20 75 70 20 63 6f  pFree ends up co
2e60: 6e 74 61 69 6e 69 6e 67 20 6f 6e 65 20 6f 72 20  ntaining one or 
2e70: 6d 6f 72 65 20 66 72 65 65 20 70 61 67 65 73 2e  more free pages.
2e80: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70  .*/.static int p
2e90: 63 61 63 68 65 31 49 6e 69 74 42 75 6c 6b 28 50  cache1InitBulk(P
2ea0: 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 29 7b  Cache1 *pCache){
2eb0: 0a 20 20 69 36 34 20 73 7a 42 75 6c 6b 3b 0a 20  .  i64 szBulk;. 
2ec0: 20 63 68 61 72 20 2a 7a 42 75 6c 6b 3b 0a 20 20   char *zBulk;.  
2ed0: 69 66 28 20 70 63 61 63 68 65 31 2e 6e 49 6e 69  if( pcache1.nIni
2ee0: 74 50 61 67 65 3d 3d 30 20 29 20 72 65 74 75 72  tPage==0 ) retur
2ef0: 6e 20 30 3b 0a 20 20 2f 2a 20 44 6f 20 6e 6f 74  n 0;.  /* Do not
2f00: 20 62 6f 74 68 65 72 20 77 69 74 68 20 61 20 62   bother with a b
2f10: 75 6c 6b 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69  ulk allocation i
2f20: 66 20 74 68 65 20 63 61 63 68 65 20 73 69 7a 65  f the cache size
2f30: 20 76 65 72 79 20 73 6d 61 6c 6c 20 2a 2f 0a 20   very small */. 
2f40: 20 69 66 28 20 70 43 61 63 68 65 2d 3e 6e 4d 61   if( pCache->nMa
2f50: 78 3c 33 20 29 20 72 65 74 75 72 6e 20 30 3b 0a  x<3 ) return 0;.
2f60: 20 20 73 71 6c 69 74 65 33 42 65 67 69 6e 42 65    sqlite3BeginBe
2f70: 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20  nignMalloc();.  
2f80: 69 66 28 20 70 63 61 63 68 65 31 2e 6e 49 6e 69  if( pcache1.nIni
2f90: 74 50 61 67 65 3e 30 20 29 7b 0a 20 20 20 20 73  tPage>0 ){.    s
2fa0: 7a 42 75 6c 6b 20 3d 20 70 43 61 63 68 65 2d 3e  zBulk = pCache->
2fb0: 73 7a 41 6c 6c 6f 63 20 2a 20 28 69 36 34 29 70  szAlloc * (i64)p
2fc0: 63 61 63 68 65 31 2e 6e 49 6e 69 74 50 61 67 65  cache1.nInitPage
2fd0: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73  ;.  }else{.    s
2fe0: 7a 42 75 6c 6b 20 3d 20 2d 31 30 32 34 20 2a 20  zBulk = -1024 * 
2ff0: 28 69 36 34 29 70 63 61 63 68 65 31 2e 6e 49 6e  (i64)pcache1.nIn
3000: 69 74 50 61 67 65 3b 0a 20 20 7d 0a 20 20 69 66  itPage;.  }.  if
3010: 28 20 73 7a 42 75 6c 6b 20 3e 20 70 43 61 63 68  ( szBulk > pCach
3020: 65 2d 3e 73 7a 41 6c 6c 6f 63 2a 28 69 36 34 29  e->szAlloc*(i64)
3030: 70 43 61 63 68 65 2d 3e 6e 4d 61 78 20 29 7b 0a  pCache->nMax ){.
3040: 20 20 20 20 73 7a 42 75 6c 6b 20 3d 20 70 43 61      szBulk = pCa
3050: 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63 2a 70 43 61  che->szAlloc*pCa
3060: 63 68 65 2d 3e 6e 4d 61 78 3b 0a 20 20 7d 0a 20  che->nMax;.  }. 
3070: 20 7a 42 75 6c 6b 20 3d 20 70 43 61 63 68 65 2d   zBulk = pCache-
3080: 3e 70 42 75 6c 6b 20 3d 20 73 71 6c 69 74 65 33  >pBulk = sqlite3
3090: 4d 61 6c 6c 6f 63 28 20 73 7a 42 75 6c 6b 20 29  Malloc( szBulk )
30a0: 3b 0a 20 20 73 71 6c 69 74 65 33 45 6e 64 42 65  ;.  sqlite3EndBe
30b0: 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20  nignMalloc();.  
30c0: 69 66 28 20 7a 42 75 6c 6b 20 29 7b 0a 20 20 20  if( zBulk ){.   
30d0: 20 69 6e 74 20 6e 42 75 6c 6b 20 3d 20 73 71 6c   int nBulk = sql
30e0: 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 7a  ite3MallocSize(z
30f0: 42 75 6c 6b 29 2f 70 43 61 63 68 65 2d 3e 73 7a  Bulk)/pCache->sz
3100: 41 6c 6c 6f 63 3b 0a 20 20 20 20 69 6e 74 20 69  Alloc;.    int i
3110: 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69  ;.    for(i=0; i
3120: 3c 6e 42 75 6c 6b 3b 20 69 2b 2b 29 7b 0a 20 20  <nBulk; i++){.  
3130: 20 20 20 20 50 67 48 64 72 31 20 2a 70 58 20 3d      PgHdr1 *pX =
3140: 20 28 50 67 48 64 72 31 2a 29 26 7a 42 75 6c 6b   (PgHdr1*)&zBulk
3150: 5b 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 5d  [pCache->szPage]
3160: 3b 0a 20 20 20 20 20 20 70 58 2d 3e 70 61 67 65  ;.      pX->page
3170: 2e 70 42 75 66 20 3d 20 7a 42 75 6c 6b 3b 0a 20  .pBuf = zBulk;. 
3180: 20 20 20 20 20 70 58 2d 3e 70 61 67 65 2e 70 45       pX->page.pE
3190: 78 74 72 61 20 3d 20 26 70 58 5b 31 5d 3b 0a 20  xtra = &pX[1];. 
31a0: 20 20 20 20 20 70 58 2d 3e 69 73 42 75 6c 6b 4c       pX->isBulkL
31b0: 6f 63 61 6c 20 3d 20 31 3b 0a 20 20 20 20 20 20  ocal = 1;.      
31c0: 70 58 2d 3e 70 4e 65 78 74 20 3d 20 70 43 61 63  pX->pNext = pCac
31d0: 68 65 2d 3e 70 46 72 65 65 3b 0a 20 20 20 20 20  he->pFree;.     
31e0: 20 70 43 61 63 68 65 2d 3e 70 46 72 65 65 20 3d   pCache->pFree =
31f0: 20 70 58 3b 0a 20 20 20 20 20 20 7a 42 75 6c 6b   pX;.      zBulk
3200: 20 2b 3d 20 70 43 61 63 68 65 2d 3e 73 7a 41 6c   += pCache->szAl
3210: 6c 6f 63 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20  loc;.    }.  }. 
3220: 20 72 65 74 75 72 6e 20 70 43 61 63 68 65 2d 3e   return pCache->
3230: 70 46 72 65 65 21 3d 30 3b 0a 7d 0a 0a 2f 2a 0a  pFree!=0;.}../*.
3240: 2a 2a 20 4d 61 6c 6c 6f 63 20 66 75 6e 63 74 69  ** Malloc functi
3250: 6f 6e 20 75 73 65 64 20 77 69 74 68 69 6e 20 74  on used within t
3260: 68 69 73 20 66 69 6c 65 20 74 6f 20 61 6c 6c 6f  his file to allo
3270: 63 61 74 65 20 73 70 61 63 65 20 66 72 6f 6d 20  cate space from 
3280: 74 68 65 20 62 75 66 66 65 72 0a 2a 2a 20 63 6f  the buffer.** co
3290: 6e 66 69 67 75 72 65 64 20 75 73 69 6e 67 20 73  nfigured using s
32a0: 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 53 51  qlite3_config(SQ
32b0: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45  LITE_CONFIG_PAGE
32c0: 43 41 43 48 45 29 20 6f 70 74 69 6f 6e 2e 20 49  CACHE) option. I
32d0: 66 20 6e 6f 20 0a 2a 2a 20 73 75 63 68 20 62 75  f no .** such bu
32e0: 66 66 65 72 20 65 78 69 73 74 73 20 6f 72 20 74  ffer exists or t
32f0: 68 65 72 65 20 69 73 20 6e 6f 20 73 70 61 63 65  here is no space
3300: 20 6c 65 66 74 20 69 6e 20 69 74 2c 20 74 68 69   left in it, thi
3310: 73 20 66 75 6e 63 74 69 6f 6e 20 66 61 6c 6c 73  s function falls
3320: 20 0a 2a 2a 20 62 61 63 6b 20 74 6f 20 73 71 6c   .** back to sql
3330: 69 74 65 33 4d 61 6c 6c 6f 63 28 29 2e 0a 2a 2a  ite3Malloc()..**
3340: 0a 2a 2a 20 4d 75 6c 74 69 70 6c 65 20 74 68 72  .** Multiple thr
3350: 65 61 64 73 20 63 61 6e 20 72 75 6e 20 74 68 69  eads can run thi
3360: 73 20 72 6f 75 74 69 6e 65 20 61 74 20 74 68 65  s routine at the
3370: 20 73 61 6d 65 20 74 69 6d 65 2e 20 20 47 6c 6f   same time.  Glo
3380: 62 61 6c 20 76 61 72 69 61 62 6c 65 73 0a 2a 2a  bal variables.**
3390: 20 69 6e 20 70 63 61 63 68 65 31 20 6e 65 65 64   in pcache1 need
33a0: 20 74 6f 20 62 65 20 70 72 6f 74 65 63 74 65 64   to be protected
33b0: 20 76 69 61 20 6d 75 74 65 78 2e 0a 2a 2f 0a 73   via mutex..*/.s
33c0: 74 61 74 69 63 20 76 6f 69 64 20 2a 70 63 61 63  tatic void *pcac
33d0: 68 65 31 41 6c 6c 6f 63 28 69 6e 74 20 6e 42 79  he1Alloc(int nBy
33e0: 74 65 29 7b 0a 20 20 76 6f 69 64 20 2a 70 20 3d  te){.  void *p =
33f0: 20 30 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71   0;.  assert( sq
3400: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68  lite3_mutex_noth
3410: 65 6c 64 28 70 63 61 63 68 65 31 2e 67 72 70 2e  eld(pcache1.grp.
3420: 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20  mutex) );.  if( 
3430: 6e 42 79 74 65 3c 3d 70 63 61 63 68 65 31 2e 73  nByte<=pcache1.s
3440: 7a 53 6c 6f 74 20 29 7b 0a 20 20 20 20 73 71 6c  zSlot ){.    sql
3450: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72  ite3_mutex_enter
3460: 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29 3b  (pcache1.mutex);
3470: 0a 20 20 20 20 70 20 3d 20 28 50 67 48 64 72 31  .    p = (PgHdr1
3480: 20 2a 29 70 63 61 63 68 65 31 2e 70 46 72 65 65   *)pcache1.pFree
3490: 3b 0a 20 20 20 20 69 66 28 20 70 20 29 7b 0a 20  ;.    if( p ){. 
34a0: 20 20 20 20 20 70 63 61 63 68 65 31 2e 70 46 72       pcache1.pFr
34b0: 65 65 20 3d 20 70 63 61 63 68 65 31 2e 70 46 72  ee = pcache1.pFr
34c0: 65 65 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20  ee->pNext;.     
34d0: 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65 53 6c   pcache1.nFreeSl
34e0: 6f 74 2d 2d 3b 0a 20 20 20 20 20 20 70 63 61 63  ot--;.      pcac
34f0: 68 65 31 2e 62 55 6e 64 65 72 50 72 65 73 73 75  he1.bUnderPressu
3500: 72 65 20 3d 20 70 63 61 63 68 65 31 2e 6e 46 72  re = pcache1.nFr
3510: 65 65 53 6c 6f 74 3c 70 63 61 63 68 65 31 2e 6e  eeSlot<pcache1.n
3520: 52 65 73 65 72 76 65 3b 0a 20 20 20 20 20 20 61  Reserve;.      a
3530: 73 73 65 72 74 28 20 70 63 61 63 68 65 31 2e 6e  ssert( pcache1.n
3540: 46 72 65 65 53 6c 6f 74 3e 3d 30 20 29 3b 0a 20  FreeSlot>=0 );. 
3550: 20 20 20 20 20 73 71 6c 69 74 65 33 53 74 61 74       sqlite3Stat
3560: 75 73 53 65 74 28 53 51 4c 49 54 45 5f 53 54 41  usSet(SQLITE_STA
3570: 54 55 53 5f 50 41 47 45 43 41 43 48 45 5f 53 49  TUS_PAGECACHE_SI
3580: 5a 45 2c 20 6e 42 79 74 65 29 3b 0a 20 20 20 20  ZE, nByte);.    
3590: 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 55    sqlite3StatusU
35a0: 70 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f  p(SQLITE_STATUS_
35b0: 50 41 47 45 43 41 43 48 45 5f 55 53 45 44 2c 20  PAGECACHE_USED, 
35c0: 31 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71  1);.    }.    sq
35d0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76  lite3_mutex_leav
35e0: 65 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29  e(pcache1.mutex)
35f0: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 3d 3d 30  ;.  }.  if( p==0
3600: 20 29 7b 0a 20 20 20 20 2f 2a 20 4d 65 6d 6f 72   ){.    /* Memor
3610: 79 20 69 73 20 6e 6f 74 20 61 76 61 69 6c 61 62  y is not availab
3620: 6c 65 20 69 6e 20 74 68 65 20 53 51 4c 49 54 45  le in the SQLITE
3630: 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48  _CONFIG_PAGECACH
3640: 45 20 70 6f 6f 6c 2e 20 20 47 65 74 0a 20 20 20  E pool.  Get.   
3650: 20 2a 2a 20 69 74 20 66 72 6f 6d 20 73 71 6c 69   ** it from sqli
3660: 74 65 33 4d 61 6c 6c 6f 63 20 69 6e 73 74 65 61  te3Malloc instea
3670: 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 70 20  d..    */.    p 
3680: 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28  = sqlite3Malloc(
3690: 6e 42 79 74 65 29 3b 0a 23 69 66 6e 64 65 66 20  nByte);.#ifndef 
36a0: 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f 50  SQLITE_DISABLE_P
36b0: 41 47 45 43 41 43 48 45 5f 4f 56 45 52 46 4c 4f  AGECACHE_OVERFLO
36c0: 57 5f 53 54 41 54 53 0a 20 20 20 20 69 66 28 20  W_STATS.    if( 
36d0: 70 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 73  p ){.      int s
36e0: 7a 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f  z = sqlite3Mallo
36f0: 63 53 69 7a 65 28 70 29 3b 0a 20 20 20 20 20 20  cSize(p);.      
3700: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e  sqlite3_mutex_en
3710: 74 65 72 28 70 63 61 63 68 65 31 2e 6d 75 74 65  ter(pcache1.mute
3720: 78 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  x);.      sqlite
3730: 33 53 74 61 74 75 73 53 65 74 28 53 51 4c 49 54  3StatusSet(SQLIT
3740: 45 5f 53 54 41 54 55 53 5f 50 41 47 45 43 41 43  E_STATUS_PAGECAC
3750: 48 45 5f 53 49 5a 45 2c 20 6e 42 79 74 65 29 3b  HE_SIZE, nByte);
3760: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 53 74  .      sqlite3St
3770: 61 74 75 73 55 70 28 53 51 4c 49 54 45 5f 53 54  atusUp(SQLITE_ST
3780: 41 54 55 53 5f 50 41 47 45 43 41 43 48 45 5f 4f  ATUS_PAGECACHE_O
3790: 56 45 52 46 4c 4f 57 2c 20 73 7a 29 3b 0a 20 20  VERFLOW, sz);.  
37a0: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65      sqlite3_mute
37b0: 78 5f 6c 65 61 76 65 28 70 63 61 63 68 65 31 2e  x_leave(pcache1.
37c0: 6d 75 74 65 78 29 3b 0a 20 20 20 20 7d 0a 23 65  mutex);.    }.#e
37d0: 6e 64 69 66 0a 20 20 20 20 73 71 6c 69 74 65 33  ndif.    sqlite3
37e0: 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 28  MemdebugSetType(
37f0: 70 2c 20 4d 45 4d 54 59 50 45 5f 50 43 41 43 48  p, MEMTYPE_PCACH
3800: 45 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e  E);.  }.  return
3810: 20 70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65   p;.}../*.** Fre
3820: 65 20 61 6e 20 61 6c 6c 6f 63 61 74 65 64 20 62  e an allocated b
3830: 75 66 66 65 72 20 6f 62 74 61 69 6e 65 64 20 66  uffer obtained f
3840: 72 6f 6d 20 70 63 61 63 68 65 31 41 6c 6c 6f 63  rom pcache1Alloc
3850: 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  ()..*/.static vo
3860: 69 64 20 70 63 61 63 68 65 31 46 72 65 65 28 76  id pcache1Free(v
3870: 6f 69 64 20 2a 70 29 7b 0a 20 20 69 6e 74 20 6e  oid *p){.  int n
3880: 46 72 65 65 64 20 3d 20 30 3b 0a 20 20 69 66 28  Freed = 0;.  if(
3890: 20 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a   p==0 ) return;.
38a0: 20 20 69 66 28 20 70 3e 3d 70 63 61 63 68 65 31    if( p>=pcache1
38b0: 2e 70 53 74 61 72 74 20 26 26 20 70 3c 70 63 61  .pStart && p<pca
38c0: 63 68 65 31 2e 70 45 6e 64 20 29 7b 0a 20 20 20  che1.pEnd ){.   
38d0: 20 50 67 46 72 65 65 73 6c 6f 74 20 2a 70 53 6c   PgFreeslot *pSl
38e0: 6f 74 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f  ot;.    sqlite3_
38f0: 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 63 61 63  mutex_enter(pcac
3900: 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20  he1.mutex);.    
3910: 73 71 6c 69 74 65 33 53 74 61 74 75 73 44 6f 77  sqlite3StatusDow
3920: 6e 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f  n(SQLITE_STATUS_
3930: 50 41 47 45 43 41 43 48 45 5f 55 53 45 44 2c 20  PAGECACHE_USED, 
3940: 31 29 3b 0a 20 20 20 20 70 53 6c 6f 74 20 3d 20  1);.    pSlot = 
3950: 28 50 67 46 72 65 65 73 6c 6f 74 2a 29 70 3b 0a  (PgFreeslot*)p;.
3960: 20 20 20 20 70 53 6c 6f 74 2d 3e 70 4e 65 78 74      pSlot->pNext
3970: 20 3d 20 70 63 61 63 68 65 31 2e 70 46 72 65 65   = pcache1.pFree
3980: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 70 46  ;.    pcache1.pF
3990: 72 65 65 20 3d 20 70 53 6c 6f 74 3b 0a 20 20 20  ree = pSlot;.   
39a0: 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65 53 6c   pcache1.nFreeSl
39b0: 6f 74 2b 2b 3b 0a 20 20 20 20 70 63 61 63 68 65  ot++;.    pcache
39c0: 31 2e 62 55 6e 64 65 72 50 72 65 73 73 75 72 65  1.bUnderPressure
39d0: 20 3d 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65   = pcache1.nFree
39e0: 53 6c 6f 74 3c 70 63 61 63 68 65 31 2e 6e 52 65  Slot<pcache1.nRe
39f0: 73 65 72 76 65 3b 0a 20 20 20 20 61 73 73 65 72  serve;.    asser
3a00: 74 28 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65  t( pcache1.nFree
3a10: 53 6c 6f 74 3c 3d 70 63 61 63 68 65 31 2e 6e 53  Slot<=pcache1.nS
3a20: 6c 6f 74 20 29 3b 0a 20 20 20 20 73 71 6c 69 74  lot );.    sqlit
3a30: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70  e3_mutex_leave(p
3a40: 63 61 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20  cache1.mutex);. 
3a50: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65   }else{.    asse
3a60: 72 74 28 20 73 71 6c 69 74 65 33 4d 65 6d 64 65  rt( sqlite3Memde
3a70: 62 75 67 48 61 73 54 79 70 65 28 70 2c 20 4d 45  bugHasType(p, ME
3a80: 4d 54 59 50 45 5f 50 43 41 43 48 45 29 20 29 3b  MTYPE_PCACHE) );
3a90: 0a 20 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 64  .    sqlite3Memd
3aa0: 65 62 75 67 53 65 74 54 79 70 65 28 70 2c 20 4d  ebugSetType(p, M
3ab0: 45 4d 54 59 50 45 5f 48 45 41 50 29 3b 0a 23 69  EMTYPE_HEAP);.#i
3ac0: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 49 53  fndef SQLITE_DIS
3ad0: 41 42 4c 45 5f 50 41 47 45 43 41 43 48 45 5f 4f  ABLE_PAGECACHE_O
3ae0: 56 45 52 46 4c 4f 57 5f 53 54 41 54 53 0a 20 20  VERFLOW_STATS.  
3af0: 20 20 6e 46 72 65 65 64 20 3d 20 73 71 6c 69 74    nFreed = sqlit
3b00: 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 29 3b  e3MallocSize(p);
3b10: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  .    sqlite3_mut
3b20: 65 78 5f 65 6e 74 65 72 28 70 63 61 63 68 65 31  ex_enter(pcache1
3b30: 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 73 71 6c  .mutex);.    sql
3b40: 69 74 65 33 53 74 61 74 75 73 44 6f 77 6e 28 53  ite3StatusDown(S
3b50: 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 50 41 47  QLITE_STATUS_PAG
3b60: 45 43 41 43 48 45 5f 4f 56 45 52 46 4c 4f 57 2c  ECACHE_OVERFLOW,
3b70: 20 6e 46 72 65 65 64 29 3b 0a 20 20 20 20 73 71   nFreed);.    sq
3b80: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76  lite3_mutex_leav
3b90: 65 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29  e(pcache1.mutex)
3ba0: 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 73 71 6c  ;.#endif.    sql
3bb0: 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 20  ite3_free(p);.  
3bc0: 7d 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49  }.}..#ifdef SQLI
3bd0: 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59  TE_ENABLE_MEMORY
3be0: 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 2f 2a 0a 2a  _MANAGEMENT./*.*
3bf0: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 73 69 7a  * Return the siz
3c00: 65 20 6f 66 20 61 20 70 63 61 63 68 65 20 61 6c  e of a pcache al
3c10: 6c 6f 63 61 74 69 6f 6e 0a 2a 2f 0a 73 74 61 74  location.*/.stat
3c20: 69 63 20 69 6e 74 20 70 63 61 63 68 65 31 4d 65  ic int pcache1Me
3c30: 6d 53 69 7a 65 28 76 6f 69 64 20 2a 70 29 7b 0a  mSize(void *p){.
3c40: 20 20 69 66 28 20 70 3e 3d 70 63 61 63 68 65 31    if( p>=pcache1
3c50: 2e 70 53 74 61 72 74 20 26 26 20 70 3c 70 63 61  .pStart && p<pca
3c60: 63 68 65 31 2e 70 45 6e 64 20 29 7b 0a 20 20 20  che1.pEnd ){.   
3c70: 20 72 65 74 75 72 6e 20 70 63 61 63 68 65 31 2e   return pcache1.
3c80: 73 7a 53 6c 6f 74 3b 0a 20 20 7d 65 6c 73 65 7b  szSlot;.  }else{
3c90: 0a 20 20 20 20 69 6e 74 20 69 53 69 7a 65 3b 0a  .    int iSize;.
3ca0: 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69      assert( sqli
3cb0: 74 65 33 4d 65 6d 64 65 62 75 67 48 61 73 54 79  te3MemdebugHasTy
3cc0: 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 50 43  pe(p, MEMTYPE_PC
3cd0: 41 43 48 45 29 20 29 3b 0a 20 20 20 20 73 71 6c  ACHE) );.    sql
3ce0: 69 74 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54  ite3MemdebugSetT
3cf0: 79 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 48  ype(p, MEMTYPE_H
3d00: 45 41 50 29 3b 0a 20 20 20 20 69 53 69 7a 65 20  EAP);.    iSize 
3d10: 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53  = sqlite3MallocS
3d20: 69 7a 65 28 70 29 3b 0a 20 20 20 20 73 71 6c 69  ize(p);.    sqli
3d30: 74 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79  te3MemdebugSetTy
3d40: 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 50 43  pe(p, MEMTYPE_PC
3d50: 41 43 48 45 29 3b 0a 20 20 20 20 72 65 74 75 72  ACHE);.    retur
3d60: 6e 20 69 53 69 7a 65 3b 0a 20 20 7d 0a 7d 0a 23  n iSize;.  }.}.#
3d70: 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f  endif /* SQLITE_
3d80: 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41  ENABLE_MEMORY_MA
3d90: 4e 41 47 45 4d 45 4e 54 20 2a 2f 0a 0a 2f 2a 0a  NAGEMENT */../*.
3da0: 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 61 20 6e 65  ** Allocate a ne
3db0: 77 20 70 61 67 65 20 6f 62 6a 65 63 74 20 69 6e  w page object in
3dc0: 69 74 69 61 6c 6c 79 20 61 73 73 6f 63 69 61 74  itially associat
3dd0: 65 64 20 77 69 74 68 20 63 61 63 68 65 20 70 43  ed with cache pC
3de0: 61 63 68 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  ache..*/.static 
3df0: 50 67 48 64 72 31 20 2a 70 63 61 63 68 65 31 41  PgHdr1 *pcache1A
3e00: 6c 6c 6f 63 50 61 67 65 28 50 43 61 63 68 65 31  llocPage(PCache1
3e10: 20 2a 70 43 61 63 68 65 29 7b 0a 20 20 50 67 48   *pCache){.  PgH
3e20: 64 72 31 20 2a 70 20 3d 20 30 3b 0a 20 20 76 6f  dr1 *p = 0;.  vo
3e30: 69 64 20 2a 70 50 67 3b 0a 0a 20 20 61 73 73 65  id *pPg;..  asse
3e40: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  rt( sqlite3_mute
3e50: 78 5f 68 65 6c 64 28 70 43 61 63 68 65 2d 3e 70  x_held(pCache->p
3e60: 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b  Group->mutex) );
3e70: 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e 70  .  if( pCache->p
3e80: 46 72 65 65 20 7c 7c 20 28 70 43 61 63 68 65 2d  Free || (pCache-
3e90: 3e 6e 50 61 67 65 3d 3d 30 20 26 26 20 70 63 61  >nPage==0 && pca
3ea0: 63 68 65 31 49 6e 69 74 42 75 6c 6b 28 70 43 61  che1InitBulk(pCa
3eb0: 63 68 65 29 29 20 29 7b 0a 20 20 20 20 70 20 3d  che)) ){.    p =
3ec0: 20 70 43 61 63 68 65 2d 3e 70 46 72 65 65 3b 0a   pCache->pFree;.
3ed0: 20 20 20 20 70 43 61 63 68 65 2d 3e 70 46 72 65      pCache->pFre
3ee0: 65 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20  e = p->pNext;.  
3ef0: 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20 30 3b 0a    p->pNext = 0;.
3f00: 20 20 7d 65 6c 73 65 7b 0a 23 69 66 64 65 66 20    }else{.#ifdef 
3f10: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45  SQLITE_ENABLE_ME
3f20: 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a  MORY_MANAGEMENT.
3f30: 20 20 20 20 2f 2a 20 54 68 65 20 67 72 6f 75 70      /* The group
3f40: 20 6d 75 74 65 78 20 6d 75 73 74 20 62 65 20 72   mutex must be r
3f50: 65 6c 65 61 73 65 64 20 62 65 66 6f 72 65 20 70  eleased before p
3f60: 63 61 63 68 65 31 41 6c 6c 6f 63 28 29 20 69 73  cache1Alloc() is
3f70: 20 63 61 6c 6c 65 64 2e 20 54 68 69 73 0a 20 20   called. This.  
3f80: 20 20 2a 2a 20 69 73 20 62 65 63 61 75 73 65 20    ** is because 
3f90: 69 74 20 6d 69 67 68 74 20 63 61 6c 6c 20 73 71  it might call sq
3fa0: 6c 69 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65  lite3_release_me
3fb0: 6d 6f 72 79 28 29 2c 20 77 68 69 63 68 20 61 73  mory(), which as
3fc0: 73 75 6d 65 73 20 74 68 61 74 20 0a 20 20 20 20  sumes that .    
3fd0: 2a 2a 20 74 68 69 73 20 6d 75 74 65 78 20 69 73  ** this mutex is
3fe0: 20 6e 6f 74 20 68 65 6c 64 2e 20 2a 2f 0a 20 20   not held. */.  
3ff0: 20 20 61 73 73 65 72 74 28 20 70 63 61 63 68 65    assert( pcache
4000: 31 2e 73 65 70 61 72 61 74 65 43 61 63 68 65 3d  1.separateCache=
4010: 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74  =0 );.    assert
4020: 28 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70  ( pCache->pGroup
4030: 3d 3d 26 70 63 61 63 68 65 31 2e 67 72 70 20 29  ==&pcache1.grp )
4040: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 4c 65 61  ;.    pcache1Lea
4050: 76 65 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e  veMutex(pCache->
4060: 70 47 72 6f 75 70 29 3b 0a 23 65 6e 64 69 66 0a  pGroup);.#endif.
4070: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 50 43  #ifdef SQLITE_PC
4080: 41 43 48 45 5f 53 45 50 41 52 41 54 45 5f 48 45  ACHE_SEPARATE_HE
4090: 41 44 45 52 0a 20 20 20 20 70 50 67 20 3d 20 70  ADER.    pPg = p
40a0: 63 61 63 68 65 31 41 6c 6c 6f 63 28 70 43 61 63  cache1Alloc(pCac
40b0: 68 65 2d 3e 73 7a 50 61 67 65 29 3b 0a 20 20 20  he->szPage);.   
40c0: 20 70 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c   p = sqlite3Mall
40d0: 6f 63 28 73 69 7a 65 6f 66 28 50 67 48 64 72 31  oc(sizeof(PgHdr1
40e0: 29 20 2b 20 70 43 61 63 68 65 2d 3e 73 7a 45 78  ) + pCache->szEx
40f0: 74 72 61 29 3b 0a 20 20 20 20 69 66 28 20 21 70  tra);.    if( !p
4100: 50 67 20 7c 7c 20 21 70 20 29 7b 0a 20 20 20 20  Pg || !p ){.    
4110: 20 20 70 63 61 63 68 65 31 46 72 65 65 28 70 50    pcache1Free(pP
4120: 67 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  g);.      sqlite
4130: 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 20 20 20  3_free(p);.     
4140: 20 70 50 67 20 3d 20 30 3b 0a 20 20 20 20 7d 0a   pPg = 0;.    }.
4150: 23 65 6c 73 65 0a 20 20 20 20 70 50 67 20 3d 20  #else.    pPg = 
4160: 70 63 61 63 68 65 31 41 6c 6c 6f 63 28 70 43 61  pcache1Alloc(pCa
4170: 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63 29 3b 0a 20  che->szAlloc);. 
4180: 20 20 20 70 20 3d 20 28 50 67 48 64 72 31 20 2a     p = (PgHdr1 *
4190: 29 26 28 28 75 38 20 2a 29 70 50 67 29 5b 70 43  )&((u8 *)pPg)[pC
41a0: 61 63 68 65 2d 3e 73 7a 50 61 67 65 5d 3b 0a 23  ache->szPage];.#
41b0: 65 6e 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c  endif.#ifdef SQL
41c0: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52  ITE_ENABLE_MEMOR
41d0: 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 20 20 20  Y_MANAGEMENT.   
41e0: 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74   pcache1EnterMut
41f0: 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75  ex(pCache->pGrou
4200: 70 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 69  p);.#endif.    i
4210: 66 28 20 70 50 67 3d 3d 30 20 29 20 72 65 74 75  f( pPg==0 ) retu
4220: 72 6e 20 30 3b 0a 20 20 20 20 70 2d 3e 70 61 67  rn 0;.    p->pag
4230: 65 2e 70 42 75 66 20 3d 20 70 50 67 3b 0a 20 20  e.pBuf = pPg;.  
4240: 20 20 70 2d 3e 70 61 67 65 2e 70 45 78 74 72 61    p->page.pExtra
4250: 20 3d 20 26 70 5b 31 5d 3b 0a 20 20 20 20 70 2d   = &p[1];.    p-
4260: 3e 69 73 42 75 6c 6b 4c 6f 63 61 6c 20 3d 20 30  >isBulkLocal = 0
4270: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 43 61 63  ;.  }.  if( pCac
4280: 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 29  he->bPurgeable )
4290: 7b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 70 47  {.    pCache->pG
42a0: 72 6f 75 70 2d 3e 6e 43 75 72 72 65 6e 74 50 61  roup->nCurrentPa
42b0: 67 65 2b 2b 3b 0a 20 20 7d 0a 20 20 72 65 74 75  ge++;.  }.  retu
42c0: 72 6e 20 70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46  rn p;.}../*.** F
42d0: 72 65 65 20 61 20 70 61 67 65 20 6f 62 6a 65 63  ree a page objec
42e0: 74 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 20 70  t allocated by p
42f0: 63 61 63 68 65 31 41 6c 6c 6f 63 50 61 67 65 28  cache1AllocPage(
4300: 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  )..*/.static voi
4310: 64 20 70 63 61 63 68 65 31 46 72 65 65 50 61 67  d pcache1FreePag
4320: 65 28 50 67 48 64 72 31 20 2a 70 29 7b 0a 20 20  e(PgHdr1 *p){.  
4330: 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 3b  PCache1 *pCache;
4340: 0a 20 20 61 73 73 65 72 74 28 20 70 21 3d 30 20  .  assert( p!=0 
4350: 29 3b 0a 20 20 70 43 61 63 68 65 20 3d 20 70 2d  );.  pCache = p-
4360: 3e 70 43 61 63 68 65 3b 0a 20 20 61 73 73 65 72  >pCache;.  asser
4370: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  t( sqlite3_mutex
4380: 5f 68 65 6c 64 28 70 2d 3e 70 43 61 63 68 65 2d  _held(p->pCache-
4390: 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20  >pGroup->mutex) 
43a0: 29 3b 0a 20 20 69 66 28 20 70 2d 3e 69 73 42 75  );.  if( p->isBu
43b0: 6c 6b 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 70  lkLocal ){.    p
43c0: 2d 3e 70 4e 65 78 74 20 3d 20 70 43 61 63 68 65  ->pNext = pCache
43d0: 2d 3e 70 46 72 65 65 3b 0a 20 20 20 20 70 43 61  ->pFree;.    pCa
43e0: 63 68 65 2d 3e 70 46 72 65 65 20 3d 20 70 3b 0a  che->pFree = p;.
43f0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 63 61    }else{.    pca
4400: 63 68 65 31 46 72 65 65 28 70 2d 3e 70 61 67 65  che1Free(p->page
4410: 2e 70 42 75 66 29 3b 0a 23 69 66 64 65 66 20 53  .pBuf);.#ifdef S
4420: 51 4c 49 54 45 5f 50 43 41 43 48 45 5f 53 45 50  QLITE_PCACHE_SEP
4430: 41 52 41 54 45 5f 48 45 41 44 45 52 0a 20 20 20  ARATE_HEADER.   
4440: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 29   sqlite3_free(p)
4450: 3b 0a 23 65 6e 64 69 66 0a 20 20 7d 0a 20 20 69  ;.#endif.  }.  i
4460: 66 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67  f( pCache->bPurg
4470: 65 61 62 6c 65 20 29 7b 0a 20 20 20 20 70 43 61  eable ){.    pCa
4480: 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6e 43 75  che->pGroup->nCu
4490: 72 72 65 6e 74 50 61 67 65 2d 2d 3b 0a 20 20 7d  rrentPage--;.  }
44a0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6c 6c 6f 63  .}../*.** Malloc
44b0: 20 66 75 6e 63 74 69 6f 6e 20 75 73 65 64 20 62   function used b
44c0: 79 20 53 51 4c 69 74 65 20 74 6f 20 6f 62 74 61  y SQLite to obta
44d0: 69 6e 20 73 70 61 63 65 20 66 72 6f 6d 20 74 68  in space from th
44e0: 65 20 62 75 66 66 65 72 20 63 6f 6e 66 69 67 75  e buffer configu
44f0: 72 65 64 0a 2a 2a 20 75 73 69 6e 67 20 73 71 6c  red.** using sql
4500: 69 74 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49  ite3_config(SQLI
4510: 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41  TE_CONFIG_PAGECA
4520: 43 48 45 29 20 6f 70 74 69 6f 6e 2e 20 49 66 20  CHE) option. If 
4530: 6e 6f 20 73 75 63 68 20 62 75 66 66 65 72 0a 2a  no such buffer.*
4540: 2a 20 65 78 69 73 74 73 2c 20 74 68 69 73 20 66  * exists, this f
4550: 75 6e 63 74 69 6f 6e 20 66 61 6c 6c 73 20 62 61  unction falls ba
4560: 63 6b 20 74 6f 20 73 71 6c 69 74 65 33 4d 61 6c  ck to sqlite3Mal
4570: 6c 6f 63 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 2a  loc()..*/.void *
4580: 73 71 6c 69 74 65 33 50 61 67 65 4d 61 6c 6c 6f  sqlite3PageMallo
4590: 63 28 69 6e 74 20 73 7a 29 7b 0a 20 20 72 65 74  c(int sz){.  ret
45a0: 75 72 6e 20 70 63 61 63 68 65 31 41 6c 6c 6f 63  urn pcache1Alloc
45b0: 28 73 7a 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46  (sz);.}../*.** F
45c0: 72 65 65 20 61 6e 20 61 6c 6c 6f 63 61 74 65 64  ree an allocated
45d0: 20 62 75 66 66 65 72 20 6f 62 74 61 69 6e 65 64   buffer obtained
45e0: 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 50 61 67   from sqlite3Pag
45f0: 65 4d 61 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a 76 6f  eMalloc()..*/.vo
4600: 69 64 20 73 71 6c 69 74 65 33 50 61 67 65 46 72  id sqlite3PageFr
4610: 65 65 28 76 6f 69 64 20 2a 70 29 7b 0a 20 20 70  ee(void *p){.  p
4620: 63 61 63 68 65 31 46 72 65 65 28 70 29 3b 0a 7d  cache1Free(p);.}
4630: 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  .../*.** Return 
4640: 74 72 75 65 20 69 66 20 69 74 20 64 65 73 69 72  true if it desir
4650: 61 62 6c 65 20 74 6f 20 61 76 6f 69 64 20 61 6c  able to avoid al
4660: 6c 6f 63 61 74 69 6e 67 20 61 20 6e 65 77 20 70  locating a new p
4670: 61 67 65 20 63 61 63 68 65 0a 2a 2a 20 65 6e 74  age cache.** ent
4680: 72 79 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6d 65 6d  ry..**.** If mem
4690: 6f 72 79 20 77 61 73 20 61 6c 6c 6f 63 61 74 65  ory was allocate
46a0: 64 20 73 70 65 63 69 66 69 63 61 6c 6c 79 20 74  d specifically t
46b0: 6f 20 74 68 65 20 70 61 67 65 20 63 61 63 68 65  o the page cache
46c0: 20 75 73 69 6e 67 0a 2a 2a 20 53 51 4c 49 54 45   using.** SQLITE
46d0: 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48  _CONFIG_PAGECACH
46e0: 45 20 62 75 74 20 74 68 61 74 20 6d 65 6d 6f 72  E but that memor
46f0: 79 20 68 61 73 20 61 6c 6c 20 62 65 65 6e 20 75  y has all been u
4700: 73 65 64 2c 20 74 68 65 6e 0a 2a 2a 20 69 74 20  sed, then.** it 
4710: 69 73 20 64 65 73 69 72 61 62 6c 65 20 74 6f 20  is desirable to 
4720: 61 76 6f 69 64 20 61 6c 6c 6f 63 61 74 69 6e 67  avoid allocating
4730: 20 61 20 6e 65 77 20 70 61 67 65 20 63 61 63 68   a new page cach
4740: 65 20 65 6e 74 72 79 20 62 65 63 61 75 73 65 0a  e entry because.
4750: 2a 2a 20 70 72 65 73 75 6d 61 62 6c 79 20 53 51  ** presumably SQ
4760: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45  LITE_CONFIG_PAGE
4770: 43 41 43 48 45 20 77 61 73 20 73 75 70 70 6f 73  CACHE was suppos
4780: 65 20 74 6f 20 62 65 20 73 75 66 66 69 63 69 65  e to be sufficie
4790: 6e 74 0a 2a 2a 20 66 6f 72 20 61 6c 6c 20 70 61  nt.** for all pa
47a0: 67 65 20 63 61 63 68 65 20 6e 65 65 64 73 20 61  ge cache needs a
47b0: 6e 64 20 77 65 20 73 68 6f 75 6c 64 20 6e 6f 74  nd we should not
47c0: 20 6e 65 65 64 20 74 6f 20 73 70 69 6c 6c 20 74   need to spill t
47d0: 68 65 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e  he.** allocation
47e0: 20 6f 6e 74 6f 20 74 68 65 20 68 65 61 70 2e 0a   onto the heap..
47f0: 2a 2a 0a 2a 2a 20 4f 72 2c 20 74 68 65 20 68 65  **.** Or, the he
4800: 61 70 20 69 73 20 75 73 65 64 20 66 6f 72 20 61  ap is used for a
4810: 6c 6c 20 70 61 67 65 20 63 61 63 68 65 20 6d 65  ll page cache me
4820: 6d 6f 72 79 20 62 75 74 20 74 68 65 20 68 65 61  mory but the hea
4830: 70 20 69 73 0a 2a 2a 20 75 6e 64 65 72 20 6d 65  p is.** under me
4840: 6d 6f 72 79 20 70 72 65 73 73 75 72 65 2c 20 74  mory pressure, t
4850: 68 65 6e 20 61 67 61 69 6e 20 69 74 20 69 73 20  hen again it is 
4860: 64 65 73 69 72 61 62 6c 65 20 74 6f 20 61 76 6f  desirable to avo
4870: 69 64 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 6e 67  id.** allocating
4880: 20 61 20 6e 65 77 20 70 61 67 65 20 63 61 63 68   a new page cach
4890: 65 20 65 6e 74 72 79 20 69 6e 20 6f 72 64 65 72  e entry in order
48a0: 20 74 6f 20 61 76 6f 69 64 20 73 74 72 65 73 73   to avoid stress
48b0: 69 6e 67 0a 2a 2a 20 74 68 65 20 68 65 61 70 20  ing.** the heap 
48c0: 65 76 65 6e 20 66 75 72 74 68 65 72 2e 0a 2a 2f  even further..*/
48d0: 0a 73 74 61 74 69 63 20 69 6e 74 20 70 63 61 63  .static int pcac
48e0: 68 65 31 55 6e 64 65 72 4d 65 6d 6f 72 79 50 72  he1UnderMemoryPr
48f0: 65 73 73 75 72 65 28 50 43 61 63 68 65 31 20 2a  essure(PCache1 *
4900: 70 43 61 63 68 65 29 7b 0a 20 20 69 66 28 20 70  pCache){.  if( p
4910: 63 61 63 68 65 31 2e 6e 53 6c 6f 74 20 26 26 20  cache1.nSlot && 
4920: 28 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 2b  (pCache->szPage+
4930: 70 43 61 63 68 65 2d 3e 73 7a 45 78 74 72 61 29  pCache->szExtra)
4940: 3c 3d 70 63 61 63 68 65 31 2e 73 7a 53 6c 6f 74  <=pcache1.szSlot
4950: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 70   ){.    return p
4960: 63 61 63 68 65 31 2e 62 55 6e 64 65 72 50 72 65  cache1.bUnderPre
4970: 73 73 75 72 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a  ssure;.  }else{.
4980: 20 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74      return sqlit
4990: 65 33 48 65 61 70 4e 65 61 72 6c 79 46 75 6c 6c  e3HeapNearlyFull
49a0: 28 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 2a 2a 2a  ();.  }.}../****
49b0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
49c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
49d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
49e0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
49f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 2f 2a 2a 2a  **********/./***
4a00: 2a 2a 2a 2a 2a 20 47 65 6e 65 72 61 6c 20 49 6d  ***** General Im
4a10: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 46 75 6e  plementation Fun
4a20: 63 74 69 6f 6e 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a  ctions *********
4a30: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4a40: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a  ***********/../*
4a50: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f  .** This functio
4a60: 6e 20 69 73 20 75 73 65 64 20 74 6f 20 72 65 73  n is used to res
4a70: 69 7a 65 20 74 68 65 20 68 61 73 68 20 74 61 62  ize the hash tab
4a80: 6c 65 20 75 73 65 64 20 62 79 20 74 68 65 20 63  le used by the c
4a90: 61 63 68 65 20 70 61 73 73 65 64 0a 2a 2a 20 61  ache passed.** a
4aa0: 73 20 74 68 65 20 66 69 72 73 74 20 61 72 67 75  s the first argu
4ab0: 6d 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20  ment..**.** The 
4ac0: 50 43 61 63 68 65 20 6d 75 74 65 78 20 6d 75 73  PCache mutex mus
4ad0: 74 20 62 65 20 68 65 6c 64 20 77 68 65 6e 20 74  t be held when t
4ae0: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  his function is 
4af0: 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69  called..*/.stati
4b00: 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 52 65  c void pcache1Re
4b10: 73 69 7a 65 48 61 73 68 28 50 43 61 63 68 65 31  sizeHash(PCache1
4b20: 20 2a 70 29 7b 0a 20 20 50 67 48 64 72 31 20 2a   *p){.  PgHdr1 *
4b30: 2a 61 70 4e 65 77 3b 0a 20 20 75 6e 73 69 67 6e  *apNew;.  unsign
4b40: 65 64 20 69 6e 74 20 6e 4e 65 77 3b 0a 20 20 75  ed int nNew;.  u
4b50: 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 3b 0a 0a  nsigned int i;..
4b60: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
4b70: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e  3_mutex_held(p->
4b80: 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29  pGroup->mutex) )
4b90: 3b 0a 0a 20 20 6e 4e 65 77 20 3d 20 70 2d 3e 6e  ;..  nNew = p->n
4ba0: 48 61 73 68 2a 32 3b 0a 20 20 69 66 28 20 6e 4e  Hash*2;.  if( nN
4bb0: 65 77 3c 32 35 36 20 29 7b 0a 20 20 20 20 6e 4e  ew<256 ){.    nN
4bc0: 65 77 20 3d 20 32 35 36 3b 0a 20 20 7d 0a 0a 20  ew = 256;.  }.. 
4bd0: 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74   pcache1LeaveMut
4be0: 65 78 28 70 2d 3e 70 47 72 6f 75 70 29 3b 0a 20  ex(p->pGroup);. 
4bf0: 20 69 66 28 20 70 2d 3e 6e 48 61 73 68 20 29 7b   if( p->nHash ){
4c00: 20 73 71 6c 69 74 65 33 42 65 67 69 6e 42 65 6e   sqlite3BeginBen
4c10: 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 20 7d 0a 20  ignMalloc(); }. 
4c20: 20 61 70 4e 65 77 20 3d 20 28 50 67 48 64 72 31   apNew = (PgHdr1
4c30: 20 2a 2a 29 73 71 6c 69 74 65 33 4d 61 6c 6c 6f   **)sqlite3Mallo
4c40: 63 5a 65 72 6f 28 73 69 7a 65 6f 66 28 50 67 48  cZero(sizeof(PgH
4c50: 64 72 31 20 2a 29 2a 6e 4e 65 77 29 3b 0a 20 20  dr1 *)*nNew);.  
4c60: 69 66 28 20 70 2d 3e 6e 48 61 73 68 20 29 7b 20  if( p->nHash ){ 
4c70: 73 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 6e  sqlite3EndBenign
4c80: 4d 61 6c 6c 6f 63 28 29 3b 20 7d 0a 20 20 70 63  Malloc(); }.  pc
4c90: 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28  ache1EnterMutex(
4ca0: 70 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20 69 66  p->pGroup);.  if
4cb0: 28 20 61 70 4e 65 77 20 29 7b 0a 20 20 20 20 66  ( apNew ){.    f
4cc0: 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 48 61  or(i=0; i<p->nHa
4cd0: 73 68 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20  sh; i++){.      
4ce0: 50 67 48 64 72 31 20 2a 70 50 61 67 65 3b 0a 20  PgHdr1 *pPage;. 
4cf0: 20 20 20 20 20 50 67 48 64 72 31 20 2a 70 4e 65       PgHdr1 *pNe
4d00: 78 74 20 3d 20 70 2d 3e 61 70 48 61 73 68 5b 69  xt = p->apHash[i
4d10: 5d 3b 0a 20 20 20 20 20 20 77 68 69 6c 65 28 20  ];.      while( 
4d20: 28 70 50 61 67 65 20 3d 20 70 4e 65 78 74 29 21  (pPage = pNext)!
4d30: 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 75 6e  =0 ){.        un
4d40: 73 69 67 6e 65 64 20 69 6e 74 20 68 20 3d 20 70  signed int h = p
4d50: 50 61 67 65 2d 3e 69 4b 65 79 20 25 20 6e 4e 65  Page->iKey % nNe
4d60: 77 3b 0a 20 20 20 20 20 20 20 20 70 4e 65 78 74  w;.        pNext
4d70: 20 3d 20 70 50 61 67 65 2d 3e 70 4e 65 78 74 3b   = pPage->pNext;
4d80: 0a 20 20 20 20 20 20 20 20 70 50 61 67 65 2d 3e  .        pPage->
4d90: 70 4e 65 78 74 20 3d 20 61 70 4e 65 77 5b 68 5d  pNext = apNew[h]
4da0: 3b 0a 20 20 20 20 20 20 20 20 61 70 4e 65 77 5b  ;.        apNew[
4db0: 68 5d 20 3d 20 70 50 61 67 65 3b 0a 20 20 20 20  h] = pPage;.    
4dc0: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73 71    }.    }.    sq
4dd0: 6c 69 74 65 33 5f 66 72 65 65 28 70 2d 3e 61 70  lite3_free(p->ap
4de0: 48 61 73 68 29 3b 0a 20 20 20 20 70 2d 3e 61 70  Hash);.    p->ap
4df0: 48 61 73 68 20 3d 20 61 70 4e 65 77 3b 0a 20 20  Hash = apNew;.  
4e00: 20 20 70 2d 3e 6e 48 61 73 68 20 3d 20 6e 4e 65    p->nHash = nNe
4e10: 77 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  w;.  }.}../*.** 
4e20: 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73  This function is
4e30: 20 75 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79   used internally
4e40: 20 74 6f 20 72 65 6d 6f 76 65 20 74 68 65 20 70   to remove the p
4e50: 61 67 65 20 70 50 61 67 65 20 66 72 6f 6d 20 74  age pPage from t
4e60: 68 65 20 0a 2a 2a 20 50 47 72 6f 75 70 20 4c 52  he .** PGroup LR
4e70: 55 20 6c 69 73 74 2c 20 69 66 20 69 73 20 70 61  U list, if is pa
4e80: 72 74 20 6f 66 20 69 74 2e 20 49 66 20 70 50 61  rt of it. If pPa
4e90: 67 65 20 69 73 20 6e 6f 74 20 70 61 72 74 20 6f  ge is not part o
4ea0: 66 20 74 68 65 20 50 47 72 6f 75 70 0a 2a 2a 20  f the PGroup.** 
4eb0: 4c 52 55 20 6c 69 73 74 2c 20 74 68 65 6e 20 74  LRU list, then t
4ec0: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  his function is 
4ed0: 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a 2a 2a 20 54  a no-op..**.** T
4ee0: 68 65 20 50 47 72 6f 75 70 20 6d 75 74 65 78 20  he PGroup mutex 
4ef0: 6d 75 73 74 20 62 65 20 68 65 6c 64 20 77 68 65  must be held whe
4f00: 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  n this function 
4f10: 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74  is called..*/.st
4f20: 61 74 69 63 20 50 67 48 64 72 31 20 2a 70 63 61  atic PgHdr1 *pca
4f30: 63 68 65 31 50 69 6e 50 61 67 65 28 50 67 48 64  che1PinPage(PgHd
4f40: 72 31 20 2a 70 50 61 67 65 29 7b 0a 20 20 50 43  r1 *pPage){.  PC
4f50: 61 63 68 65 31 20 2a 70 43 61 63 68 65 3b 0a 0a  ache1 *pCache;..
4f60: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 21    assert( pPage!
4f70: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  =0 );.  assert( 
4f80: 70 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64 3d  pPage->isPinned=
4f90: 3d 30 20 29 3b 0a 20 20 70 43 61 63 68 65 20 3d  =0 );.  pCache =
4fa0: 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65 3b 0a   pPage->pCache;.
4fb0: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d    assert( pPage-
4fc0: 3e 70 4c 72 75 4e 65 78 74 20 7c 7c 20 70 50 61  >pLruNext || pPa
4fd0: 67 65 3d 3d 70 43 61 63 68 65 2d 3e 70 47 72 6f  ge==pCache->pGro
4fe0: 75 70 2d 3e 70 4c 72 75 54 61 69 6c 20 29 3b 0a  up->pLruTail );.
4ff0: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d    assert( pPage-
5000: 3e 70 4c 72 75 50 72 65 76 20 7c 7c 20 70 50 61  >pLruPrev || pPa
5010: 67 65 3d 3d 70 43 61 63 68 65 2d 3e 70 47 72 6f  ge==pCache->pGro
5020: 75 70 2d 3e 70 4c 72 75 48 65 61 64 20 29 3b 0a  up->pLruHead );.
5030: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
5040: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 61  3_mutex_held(pCa
5050: 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74  che->pGroup->mut
5060: 65 78 29 20 29 3b 0a 20 20 69 66 28 20 70 50 61  ex) );.  if( pPa
5070: 67 65 2d 3e 70 4c 72 75 50 72 65 76 20 29 7b 0a  ge->pLruPrev ){.
5080: 20 20 20 20 70 50 61 67 65 2d 3e 70 4c 72 75 50      pPage->pLruP
5090: 72 65 76 2d 3e 70 4c 72 75 4e 65 78 74 20 3d 20  rev->pLruNext = 
50a0: 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74 3b  pPage->pLruNext;
50b0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 43  .  }else{.    pC
50c0: 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 70 4c  ache->pGroup->pL
50d0: 72 75 48 65 61 64 20 3d 20 70 50 61 67 65 2d 3e  ruHead = pPage->
50e0: 70 4c 72 75 4e 65 78 74 3b 0a 20 20 7d 0a 20 20  pLruNext;.  }.  
50f0: 69 66 28 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e  if( pPage->pLruN
5100: 65 78 74 20 29 7b 0a 20 20 20 20 70 50 61 67 65  ext ){.    pPage
5110: 2d 3e 70 4c 72 75 4e 65 78 74 2d 3e 70 4c 72 75  ->pLruNext->pLru
5120: 50 72 65 76 20 3d 20 70 50 61 67 65 2d 3e 70 4c  Prev = pPage->pL
5130: 72 75 50 72 65 76 3b 0a 20 20 7d 65 6c 73 65 7b  ruPrev;.  }else{
5140: 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 70 47 72  .    pCache->pGr
5150: 6f 75 70 2d 3e 70 4c 72 75 54 61 69 6c 20 3d 20  oup->pLruTail = 
5160: 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 3b  pPage->pLruPrev;
5170: 0a 20 20 7d 0a 20 20 70 50 61 67 65 2d 3e 70 4c  .  }.  pPage->pL
5180: 72 75 4e 65 78 74 20 3d 20 30 3b 0a 20 20 70 50  ruNext = 0;.  pP
5190: 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20  age->pLruPrev = 
51a0: 30 3b 0a 20 20 70 50 61 67 65 2d 3e 69 73 50 69  0;.  pPage->isPi
51b0: 6e 6e 65 64 20 3d 20 31 3b 0a 20 20 70 43 61 63  nned = 1;.  pCac
51c0: 68 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65 2d  he->nRecyclable-
51d0: 2d 3b 0a 20 20 72 65 74 75 72 6e 20 70 50 61 67  -;.  return pPag
51e0: 65 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 6d  e;.}.../*.** Rem
51f0: 6f 76 65 20 74 68 65 20 70 61 67 65 20 73 75 70  ove the page sup
5200: 70 6c 69 65 64 20 61 73 20 61 6e 20 61 72 67 75  plied as an argu
5210: 6d 65 6e 74 20 66 72 6f 6d 20 74 68 65 20 68 61  ment from the ha
5220: 73 68 20 74 61 62 6c 65 20 0a 2a 2a 20 28 50 43  sh table .** (PC
5230: 61 63 68 65 31 2e 61 70 48 61 73 68 20 73 74 72  ache1.apHash str
5240: 75 63 74 75 72 65 29 20 74 68 61 74 20 69 74 20  ucture) that it 
5250: 69 73 20 63 75 72 72 65 6e 74 6c 79 20 73 74 6f  is currently sto
5260: 72 65 64 20 69 6e 2e 0a 2a 2a 20 41 6c 73 6f 20  red in..** Also 
5270: 66 72 65 65 20 74 68 65 20 70 61 67 65 20 69 66  free the page if
5280: 20 66 72 65 65 50 61 67 65 20 69 73 20 74 72 75   freePage is tru
5290: 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50 47 72  e..**.** The PGr
52a0: 6f 75 70 20 6d 75 74 65 78 20 6d 75 73 74 20 62  oup mutex must b
52b0: 65 20 68 65 6c 64 20 77 68 65 6e 20 74 68 69 73  e held when this
52c0: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c   function is cal
52d0: 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  led..*/.static v
52e0: 6f 69 64 20 70 63 61 63 68 65 31 52 65 6d 6f 76  oid pcache1Remov
52f0: 65 46 72 6f 6d 48 61 73 68 28 50 67 48 64 72 31  eFromHash(PgHdr1
5300: 20 2a 70 50 61 67 65 2c 20 69 6e 74 20 66 72 65   *pPage, int fre
5310: 65 46 6c 61 67 29 7b 0a 20 20 75 6e 73 69 67 6e  eFlag){.  unsign
5320: 65 64 20 69 6e 74 20 68 3b 0a 20 20 50 43 61 63  ed int h;.  PCac
5330: 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20 70 50  he1 *pCache = pP
5340: 61 67 65 2d 3e 70 43 61 63 68 65 3b 0a 20 20 50  age->pCache;.  P
5350: 67 48 64 72 31 20 2a 2a 70 70 3b 0a 0a 20 20 61  gHdr1 **pp;..  a
5360: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d  ssert( sqlite3_m
5370: 75 74 65 78 5f 68 65 6c 64 28 70 43 61 63 68 65  utex_held(pCache
5380: 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29  ->pGroup->mutex)
5390: 20 29 3b 0a 20 20 68 20 3d 20 70 50 61 67 65 2d   );.  h = pPage-
53a0: 3e 69 4b 65 79 20 25 20 70 43 61 63 68 65 2d 3e  >iKey % pCache->
53b0: 6e 48 61 73 68 3b 0a 20 20 66 6f 72 28 70 70 3d  nHash;.  for(pp=
53c0: 26 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b  &pCache->apHash[
53d0: 68 5d 3b 20 28 2a 70 70 29 21 3d 70 50 61 67 65  h]; (*pp)!=pPage
53e0: 3b 20 70 70 3d 26 28 2a 70 70 29 2d 3e 70 4e 65  ; pp=&(*pp)->pNe
53f0: 78 74 29 3b 0a 20 20 2a 70 70 20 3d 20 28 2a 70  xt);.  *pp = (*p
5400: 70 29 2d 3e 70 4e 65 78 74 3b 0a 0a 20 20 70 43  p)->pNext;..  pC
5410: 61 63 68 65 2d 3e 6e 50 61 67 65 2d 2d 3b 0a 20  ache->nPage--;. 
5420: 20 69 66 28 20 66 72 65 65 46 6c 61 67 20 29 20   if( freeFlag ) 
5430: 70 63 61 63 68 65 31 46 72 65 65 50 61 67 65 28  pcache1FreePage(
5440: 70 50 61 67 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  pPage);.}../*.**
5450: 20 49 66 20 74 68 65 72 65 20 61 72 65 20 63 75   If there are cu
5460: 72 72 65 6e 74 6c 79 20 6d 6f 72 65 20 74 68 61  rrently more tha
5470: 6e 20 6e 4d 61 78 50 61 67 65 20 70 61 67 65 73  n nMaxPage pages
5480: 20 61 6c 6c 6f 63 61 74 65 64 2c 20 74 72 79 0a   allocated, try.
5490: 2a 2a 20 74 6f 20 72 65 63 79 63 6c 65 20 70 61  ** to recycle pa
54a0: 67 65 73 20 74 6f 20 72 65 64 75 63 65 20 74 68  ges to reduce th
54b0: 65 20 6e 75 6d 62 65 72 20 61 6c 6c 6f 63 61 74  e number allocat
54c0: 65 64 20 74 6f 20 6e 4d 61 78 50 61 67 65 2e 0a  ed to nMaxPage..
54d0: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70  */.static void p
54e0: 63 61 63 68 65 31 45 6e 66 6f 72 63 65 4d 61 78  cache1EnforceMax
54f0: 50 61 67 65 28 50 43 61 63 68 65 31 20 2a 70 43  Page(PCache1 *pC
5500: 61 63 68 65 29 7b 0a 20 20 50 47 72 6f 75 70 20  ache){.  PGroup 
5510: 2a 70 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65  *pGroup = pCache
5520: 2d 3e 70 47 72 6f 75 70 3b 0a 20 20 61 73 73 65  ->pGroup;.  asse
5530: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  rt( sqlite3_mute
5540: 78 5f 68 65 6c 64 28 70 47 72 6f 75 70 2d 3e 6d  x_held(pGroup->m
5550: 75 74 65 78 29 20 29 3b 0a 20 20 77 68 69 6c 65  utex) );.  while
5560: 28 20 70 47 72 6f 75 70 2d 3e 6e 43 75 72 72 65  ( pGroup->nCurre
5570: 6e 74 50 61 67 65 3e 70 47 72 6f 75 70 2d 3e 6e  ntPage>pGroup->n
5580: 4d 61 78 50 61 67 65 20 26 26 20 70 47 72 6f 75  MaxPage && pGrou
5590: 70 2d 3e 70 4c 72 75 54 61 69 6c 20 29 7b 0a 20  p->pLruTail ){. 
55a0: 20 20 20 50 67 48 64 72 31 20 2a 70 20 3d 20 70     PgHdr1 *p = p
55b0: 47 72 6f 75 70 2d 3e 70 4c 72 75 54 61 69 6c 3b  Group->pLruTail;
55c0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e  .    assert( p->
55d0: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3d 3d  pCache->pGroup==
55e0: 70 47 72 6f 75 70 20 29 3b 0a 20 20 20 20 61 73  pGroup );.    as
55f0: 73 65 72 74 28 20 70 2d 3e 69 73 50 69 6e 6e 65  sert( p->isPinne
5600: 64 3d 3d 30 20 29 3b 0a 20 20 20 20 70 63 61 63  d==0 );.    pcac
5610: 68 65 31 50 69 6e 50 61 67 65 28 70 29 3b 0a 20  he1PinPage(p);. 
5620: 20 20 20 70 63 61 63 68 65 31 52 65 6d 6f 76 65     pcache1Remove
5630: 46 72 6f 6d 48 61 73 68 28 70 2c 20 31 29 3b 0a  FromHash(p, 1);.
5640: 20 20 7d 0a 20 20 69 66 28 20 70 43 61 63 68 65    }.  if( pCache
5650: 2d 3e 6e 50 61 67 65 3d 3d 30 20 26 26 20 70 43  ->nPage==0 && pC
5660: 61 63 68 65 2d 3e 70 42 75 6c 6b 20 29 7b 0a 20  ache->pBulk ){. 
5670: 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28     sqlite3_free(
5680: 70 43 61 63 68 65 2d 3e 70 42 75 6c 6b 29 3b 0a  pCache->pBulk);.
5690: 20 20 20 20 70 43 61 63 68 65 2d 3e 70 42 75 6c      pCache->pBul
56a0: 6b 20 3d 20 70 43 61 63 68 65 2d 3e 70 46 72 65  k = pCache->pFre
56b0: 65 20 3d 20 30 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a  e = 0;.  }.}../*
56c0: 0a 2a 2a 20 44 69 73 63 61 72 64 20 61 6c 6c 20  .** Discard all 
56d0: 70 61 67 65 73 20 66 72 6f 6d 20 63 61 63 68 65  pages from cache
56e0: 20 70 43 61 63 68 65 20 77 69 74 68 20 61 20 70   pCache with a p
56f0: 61 67 65 20 6e 75 6d 62 65 72 20 28 6b 65 79 20  age number (key 
5700: 76 61 6c 75 65 29 20 0a 2a 2a 20 67 72 65 61 74  value) .** great
5710: 65 72 20 74 68 61 6e 20 6f 72 20 65 71 75 61 6c  er than or equal
5720: 20 74 6f 20 69 4c 69 6d 69 74 2e 20 41 6e 79 20   to iLimit. Any 
5730: 70 69 6e 6e 65 64 20 70 61 67 65 73 20 74 68 61  pinned pages tha
5740: 74 20 6d 65 65 74 20 74 68 69 73 20 0a 2a 2a 20  t meet this .** 
5750: 63 72 69 74 65 72 69 61 20 61 72 65 20 75 6e 70  criteria are unp
5760: 69 6e 6e 65 64 20 62 65 66 6f 72 65 20 74 68 65  inned before the
5770: 79 20 61 72 65 20 64 69 73 63 61 72 64 65 64 2e  y are discarded.
5780: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50 43 61 63 68  .**.** The PCach
5790: 65 20 6d 75 74 65 78 20 6d 75 73 74 20 62 65 20  e mutex must be 
57a0: 68 65 6c 64 20 77 68 65 6e 20 74 68 69 73 20 66  held when this f
57b0: 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65  unction is calle
57c0: 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  d..*/.static voi
57d0: 64 20 70 63 61 63 68 65 31 54 72 75 6e 63 61 74  d pcache1Truncat
57e0: 65 55 6e 73 61 66 65 28 0a 20 20 50 43 61 63 68  eUnsafe(.  PCach
57f0: 65 31 20 2a 70 43 61 63 68 65 2c 20 20 20 20 20  e1 *pCache,     
5800: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 63          /* The c
5810: 61 63 68 65 20 74 6f 20 74 72 75 6e 63 61 74 65  ache to truncate
5820: 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69   */.  unsigned i
5830: 6e 74 20 69 4c 69 6d 69 74 20 20 20 20 20 20 20  nt iLimit       
5840: 20 20 20 2f 2a 20 44 72 6f 70 20 70 61 67 65 73     /* Drop pages
5850: 20 77 69 74 68 20 74 68 69 73 20 70 67 6e 6f 20   with this pgno 
5860: 6f 72 20 6c 61 72 67 65 72 20 2a 2f 0a 29 7b 0a  or larger */.){.
5870: 20 20 54 45 53 54 4f 4e 4c 59 28 20 75 6e 73 69    TESTONLY( unsi
5880: 67 6e 65 64 20 69 6e 74 20 6e 50 61 67 65 20 3d  gned int nPage =
5890: 20 30 3b 20 29 20 20 2f 2a 20 54 6f 20 61 73 73   0; )  /* To ass
58a0: 65 72 74 20 70 43 61 63 68 65 2d 3e 6e 50 61 67  ert pCache->nPag
58b0: 65 20 69 73 20 63 6f 72 72 65 63 74 20 2a 2f 0a  e is correct */.
58c0: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 68    unsigned int h
58d0: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69  ;.  assert( sqli
58e0: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70  te3_mutex_held(p
58f0: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6d  Cache->pGroup->m
5900: 75 74 65 78 29 20 29 3b 0a 20 20 66 6f 72 28 68  utex) );.  for(h
5910: 3d 30 3b 20 68 3c 70 43 61 63 68 65 2d 3e 6e 48  =0; h<pCache->nH
5920: 61 73 68 3b 20 68 2b 2b 29 7b 0a 20 20 20 20 50  ash; h++){.    P
5930: 67 48 64 72 31 20 2a 2a 70 70 20 3d 20 26 70 43  gHdr1 **pp = &pC
5940: 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 3b  ache->apHash[h];
5950: 20 0a 20 20 20 20 50 67 48 64 72 31 20 2a 70 50   .    PgHdr1 *pP
5960: 61 67 65 3b 0a 20 20 20 20 77 68 69 6c 65 28 20  age;.    while( 
5970: 28 70 50 61 67 65 20 3d 20 2a 70 70 29 21 3d 30  (pPage = *pp)!=0
5980: 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 50   ){.      if( pP
5990: 61 67 65 2d 3e 69 4b 65 79 3e 3d 69 4c 69 6d 69  age->iKey>=iLimi
59a0: 74 20 29 7b 0a 20 20 20 20 20 20 20 20 70 43 61  t ){.        pCa
59b0: 63 68 65 2d 3e 6e 50 61 67 65 2d 2d 3b 0a 20 20  che->nPage--;.  
59c0: 20 20 20 20 20 20 2a 70 70 20 3d 20 70 50 61 67        *pp = pPag
59d0: 65 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20  e->pNext;.      
59e0: 20 20 69 66 28 20 21 70 50 61 67 65 2d 3e 69 73    if( !pPage->is
59f0: 50 69 6e 6e 65 64 20 29 20 70 63 61 63 68 65 31  Pinned ) pcache1
5a00: 50 69 6e 50 61 67 65 28 70 50 61 67 65 29 3b 0a  PinPage(pPage);.
5a10: 20 20 20 20 20 20 20 20 70 63 61 63 68 65 31 46          pcache1F
5a20: 72 65 65 50 61 67 65 28 70 50 61 67 65 29 3b 0a  reePage(pPage);.
5a30: 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20        }else{.   
5a40: 20 20 20 20 20 70 70 20 3d 20 26 70 50 61 67 65       pp = &pPage
5a50: 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 20  ->pNext;.       
5a60: 20 54 45 53 54 4f 4e 4c 59 28 20 6e 50 61 67 65   TESTONLY( nPage
5a70: 2b 2b 3b 20 29 0a 20 20 20 20 20 20 7d 0a 20 20  ++; ).      }.  
5a80: 20 20 7d 0a 20 20 7d 0a 20 20 61 73 73 65 72 74    }.  }.  assert
5a90: 28 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 3d  ( pCache->nPage=
5aa0: 3d 6e 50 61 67 65 20 29 3b 0a 7d 0a 0a 2f 2a 2a  =nPage );.}../**
5ab0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5ac0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5ad0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5ae0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5af0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 2f 2a  ************/./*
5b00: 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65 33 5f  ******* sqlite3_
5b10: 70 63 61 63 68 65 20 4d 65 74 68 6f 64 73 20 2a  pcache Methods *
5b20: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5b30: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5b40: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a  *************/..
5b50: 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61  /*.** Implementa
5b60: 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69  tion of the sqli
5b70: 74 65 33 5f 70 63 61 63 68 65 2e 78 49 6e 69 74  te3_pcache.xInit
5b80: 20 6d 65 74 68 6f 64 2e 0a 2a 2f 0a 73 74 61 74   method..*/.stat
5b90: 69 63 20 69 6e 74 20 70 63 61 63 68 65 31 49 6e  ic int pcache1In
5ba0: 69 74 28 76 6f 69 64 20 2a 4e 6f 74 55 73 65 64  it(void *NotUsed
5bb0: 29 7b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41  ){.  UNUSED_PARA
5bc0: 4d 45 54 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a  METER(NotUsed);.
5bd0: 20 20 61 73 73 65 72 74 28 20 70 63 61 63 68 65    assert( pcache
5be0: 31 2e 69 73 49 6e 69 74 3d 3d 30 20 29 3b 0a 20  1.isInit==0 );. 
5bf0: 20 6d 65 6d 73 65 74 28 26 70 63 61 63 68 65 31   memset(&pcache1
5c00: 2c 20 30 2c 20 73 69 7a 65 6f 66 28 70 63 61 63  , 0, sizeof(pcac
5c10: 68 65 31 29 29 3b 0a 0a 0a 20 20 2f 2a 0a 20 20  he1));...  /*.  
5c20: 2a 2a 20 54 68 65 20 70 63 61 63 68 65 31 2e 73  ** The pcache1.s
5c30: 65 70 61 72 61 74 65 43 61 63 68 65 20 76 61 72  eparateCache var
5c40: 69 61 62 6c 65 20 69 73 20 74 72 75 65 20 69 66  iable is true if
5c50: 20 65 61 63 68 20 50 43 61 63 68 65 20 68 61 73   each PCache has
5c60: 20 69 74 73 20 6f 77 6e 0a 20 20 2a 2a 20 70 72   its own.  ** pr
5c70: 69 76 61 74 65 20 50 47 72 6f 75 70 20 28 6d 6f  ivate PGroup (mo
5c80: 64 65 2d 31 29 2e 20 20 70 63 61 63 68 65 31 2e  de-1).  pcache1.
5c90: 73 65 70 61 72 61 74 65 43 61 63 68 65 20 69 73  separateCache is
5ca0: 20 66 61 6c 73 65 20 69 66 20 74 68 65 20 73 69   false if the si
5cb0: 6e 67 6c 65 0a 20 20 2a 2a 20 50 47 72 6f 75 70  ngle.  ** PGroup
5cc0: 20 69 6e 20 70 63 61 63 68 65 31 2e 67 72 70 20   in pcache1.grp 
5cd0: 69 73 20 75 73 65 64 20 66 6f 72 20 61 6c 6c 20  is used for all 
5ce0: 70 61 67 65 20 63 61 63 68 65 73 20 28 6d 6f 64  page caches (mod
5cf0: 65 2d 32 29 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20  e-2)..  **.  ** 
5d00: 20 20 2a 20 20 41 6c 77 61 79 73 20 75 73 65 20    *  Always use 
5d10: 61 20 75 6e 69 66 69 65 64 20 63 61 63 68 65 20  a unified cache 
5d20: 28 6d 6f 64 65 2d 32 29 20 69 66 20 45 4e 41 42  (mode-2) if ENAB
5d30: 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45  LE_MEMORY_MANAGE
5d40: 4d 45 4e 54 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20  MENT.  **.  **  
5d50: 20 2a 20 20 55 73 65 20 61 20 75 6e 69 66 69 65   *  Use a unifie
5d60: 64 20 63 61 63 68 65 20 69 6e 20 73 69 6e 67 6c  d cache in singl
5d70: 65 2d 74 68 72 65 61 64 65 64 20 61 70 70 6c 69  e-threaded appli
5d80: 63 61 74 69 6f 6e 73 20 74 68 61 74 20 68 61 76  cations that hav
5d90: 65 0a 20 20 2a 2a 20 20 20 20 20 20 63 6f 6e 66  e.  **      conf
5da0: 69 67 75 72 65 64 20 61 20 73 74 61 72 74 2d 74  igured a start-t
5db0: 69 6d 65 20 62 75 66 66 65 72 20 66 6f 72 20 75  ime buffer for u
5dc0: 73 65 20 61 73 20 70 61 67 65 2d 63 61 63 68 65  se as page-cache
5dd0: 20 6d 65 6d 6f 72 79 20 75 73 69 6e 67 0a 20 20   memory using.  
5de0: 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f  **      sqlite3_
5df0: 63 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f 43 4f  config(SQLITE_CO
5e00: 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45 2c 20  NFIG_PAGECACHE, 
5e10: 70 42 75 66 2c 20 73 7a 2c 20 4e 29 20 77 69 74  pBuf, sz, N) wit
5e20: 68 20 6e 6f 6e 2d 4e 55 4c 4c 20 0a 20 20 2a 2a  h non-NULL .  **
5e30: 20 20 20 20 20 20 70 42 75 66 20 61 72 67 75 6d        pBuf argum
5e40: 65 6e 74 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20  ent..  **.  **  
5e50: 20 2a 20 20 4f 74 68 65 72 77 69 73 65 20 75 73   *  Otherwise us
5e60: 65 20 73 65 70 61 72 61 74 65 20 63 61 63 68 65  e separate cache
5e70: 73 20 28 6d 6f 64 65 2d 31 29 0a 20 20 2a 2f 0a  s (mode-1).  */.
5e80: 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49  #if defined(SQLI
5e90: 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59  TE_ENABLE_MEMORY
5ea0: 5f 4d 41 4e 41 47 45 4d 45 4e 54 29 0a 20 20 70  _MANAGEMENT).  p
5eb0: 63 61 63 68 65 31 2e 73 65 70 61 72 61 74 65 43  cache1.separateC
5ec0: 61 63 68 65 20 3d 20 30 3b 0a 23 65 6c 69 66 20  ache = 0;.#elif 
5ed0: 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46  SQLITE_THREADSAF
5ee0: 45 0a 20 20 70 63 61 63 68 65 31 2e 73 65 70 61  E.  pcache1.sepa
5ef0: 72 61 74 65 43 61 63 68 65 20 3d 20 73 71 6c 69  rateCache = sqli
5f00: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e  te3GlobalConfig.
5f10: 70 50 61 67 65 3d 3d 30 0a 20 20 20 20 20 20 20  pPage==0.       
5f20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5f30: 20 20 20 7c 7c 20 73 71 6c 69 74 65 33 47 6c 6f     || sqlite3Glo
5f40: 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d  balConfig.bCoreM
5f50: 75 74 65 78 3e 30 3b 0a 23 65 6c 73 65 0a 20 20  utex>0;.#else.  
5f60: 70 63 61 63 68 65 31 2e 73 65 70 61 72 61 74 65  pcache1.separate
5f70: 43 61 63 68 65 20 3d 20 73 71 6c 69 74 65 33 47  Cache = sqlite3G
5f80: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67  lobalConfig.pPag
5f90: 65 3d 3d 30 3b 0a 23 65 6e 64 69 66 0a 0a 23 69  e==0;.#endif..#i
5fa0: 66 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53  f SQLITE_THREADS
5fb0: 41 46 45 0a 20 20 69 66 28 20 73 71 6c 69 74 65  AFE.  if( sqlite
5fc0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43  3GlobalConfig.bC
5fd0: 6f 72 65 4d 75 74 65 78 20 29 7b 0a 20 20 20 20  oreMutex ){.    
5fe0: 70 63 61 63 68 65 31 2e 67 72 70 2e 6d 75 74 65  pcache1.grp.mute
5ff0: 78 20 3d 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  x = sqlite3_mute
6000: 78 5f 61 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d  x_alloc(SQLITE_M
6010: 55 54 45 58 5f 53 54 41 54 49 43 5f 4c 52 55 29  UTEX_STATIC_LRU)
6020: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 6d 75  ;.    pcache1.mu
6030: 74 65 78 20 3d 20 73 71 6c 69 74 65 33 5f 6d 75  tex = sqlite3_mu
6040: 74 65 78 5f 61 6c 6c 6f 63 28 53 51 4c 49 54 45  tex_alloc(SQLITE
6050: 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 50 4d  _MUTEX_STATIC_PM
6060: 45 4d 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a  EM);.  }.#endif.
6070: 20 20 69 66 28 20 70 63 61 63 68 65 31 2e 73 65    if( pcache1.se
6080: 70 61 72 61 74 65 43 61 63 68 65 0a 20 20 20 26  parateCache.   &
6090: 26 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43  & sqlite3GlobalC
60a0: 6f 6e 66 69 67 2e 6e 50 61 67 65 21 3d 30 0a 20  onfig.nPage!=0. 
60b0: 20 20 26 26 20 73 71 6c 69 74 65 33 47 6c 6f 62    && sqlite3Glob
60c0: 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65 3d 3d  alConfig.pPage==
60d0: 30 0a 20 20 29 7b 0a 20 20 20 20 70 63 61 63 68  0.  ){.    pcach
60e0: 65 31 2e 6e 49 6e 69 74 50 61 67 65 20 3d 20 73  e1.nInitPage = s
60f0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66  qlite3GlobalConf
6100: 69 67 2e 6e 50 61 67 65 3b 0a 20 20 7d 65 6c 73  ig.nPage;.  }els
6110: 65 7b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 6e  e{.    pcache1.n
6120: 49 6e 69 74 50 61 67 65 20 3d 20 30 3b 0a 20 20  InitPage = 0;.  
6130: 7d 0a 20 20 70 63 61 63 68 65 31 2e 67 72 70 2e  }.  pcache1.grp.
6140: 6d 78 50 69 6e 6e 65 64 20 3d 20 31 30 3b 0a 20  mxPinned = 10;. 
6150: 20 70 63 61 63 68 65 31 2e 69 73 49 6e 69 74 20   pcache1.isInit 
6160: 3d 20 31 3b 0a 20 20 72 65 74 75 72 6e 20 53 51  = 1;.  return SQ
6170: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a  LITE_OK;.}../*.*
6180: 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  * Implementation
6190: 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f   of the sqlite3_
61a0: 70 63 61 63 68 65 2e 78 53 68 75 74 64 6f 77 6e  pcache.xShutdown
61b0: 20 6d 65 74 68 6f 64 2e 0a 2a 2a 20 4e 6f 74 65   method..** Note
61c0: 20 74 68 61 74 20 74 68 65 20 73 74 61 74 69 63   that the static
61d0: 20 6d 75 74 65 78 20 61 6c 6c 6f 63 61 74 65 64   mutex allocated
61e0: 20 69 6e 20 78 49 6e 69 74 20 64 6f 65 73 20 0a   in xInit does .
61f0: 2a 2a 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 62  ** not need to b
6200: 65 20 66 72 65 65 64 2e 0a 2a 2f 0a 73 74 61 74  e freed..*/.stat
6210: 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 53  ic void pcache1S
6220: 68 75 74 64 6f 77 6e 28 76 6f 69 64 20 2a 4e 6f  hutdown(void *No
6230: 74 55 73 65 64 29 7b 0a 20 20 55 4e 55 53 45 44  tUsed){.  UNUSED
6240: 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f 74 55 73  _PARAMETER(NotUs
6250: 65 64 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  ed);.  assert( p
6260: 63 61 63 68 65 31 2e 69 73 49 6e 69 74 21 3d 30  cache1.isInit!=0
6270: 20 29 3b 0a 20 20 6d 65 6d 73 65 74 28 26 70 63   );.  memset(&pc
6280: 61 63 68 65 31 2c 20 30 2c 20 73 69 7a 65 6f 66  ache1, 0, sizeof
6290: 28 70 63 61 63 68 65 31 29 29 3b 0a 7d 0a 0a 2f  (pcache1));.}../
62a0: 2a 20 66 6f 72 77 61 72 64 20 64 65 63 6c 61 72  * forward declar
62b0: 61 74 69 6f 6e 20 2a 2f 0a 73 74 61 74 69 63 20  ation */.static 
62c0: 76 6f 69 64 20 70 63 61 63 68 65 31 44 65 73 74  void pcache1Dest
62d0: 72 6f 79 28 73 71 6c 69 74 65 33 5f 70 63 61 63  roy(sqlite3_pcac
62e0: 68 65 20 2a 70 29 3b 0a 0a 2f 2a 0a 2a 2a 20 49  he *p);../*.** I
62f0: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66  mplementation of
6300: 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61   the sqlite3_pca
6310: 63 68 65 2e 78 43 72 65 61 74 65 20 6d 65 74 68  che.xCreate meth
6320: 6f 64 2e 0a 2a 2a 0a 2a 2a 20 41 6c 6c 6f 63 61  od..**.** Alloca
6330: 74 65 20 61 20 6e 65 77 20 63 61 63 68 65 2e 0a  te a new cache..
6340: 2a 2f 0a 73 74 61 74 69 63 20 73 71 6c 69 74 65  */.static sqlite
6350: 33 5f 70 63 61 63 68 65 20 2a 70 63 61 63 68 65  3_pcache *pcache
6360: 31 43 72 65 61 74 65 28 69 6e 74 20 73 7a 50 61  1Create(int szPa
6370: 67 65 2c 20 69 6e 74 20 73 7a 45 78 74 72 61 2c  ge, int szExtra,
6380: 20 69 6e 74 20 62 50 75 72 67 65 61 62 6c 65 29   int bPurgeable)
6390: 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61  {.  PCache1 *pCa
63a0: 63 68 65 3b 20 20 20 20 20 20 2f 2a 20 54 68 65  che;      /* The
63b0: 20 6e 65 77 6c 79 20 63 72 65 61 74 65 64 20 70   newly created p
63c0: 61 67 65 20 63 61 63 68 65 20 2a 2f 0a 20 20 50  age cache */.  P
63d0: 47 72 6f 75 70 20 2a 70 47 72 6f 75 70 3b 20 20  Group *pGroup;  
63e0: 20 20 20 20 20 2f 2a 20 54 68 65 20 67 72 6f 75       /* The grou
63f0: 70 20 74 68 65 20 6e 65 77 20 70 61 67 65 20 63  p the new page c
6400: 61 63 68 65 20 77 69 6c 6c 20 62 65 6c 6f 6e 67  ache will belong
6410: 20 74 6f 20 2a 2f 0a 20 20 69 6e 74 20 73 7a 3b   to */.  int sz;
6420: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
6430: 2a 20 42 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72  * Bytes of memor
6440: 79 20 72 65 71 75 69 72 65 64 20 74 6f 20 61 6c  y required to al
6450: 6c 6f 63 61 74 65 20 74 68 65 20 6e 65 77 20 63  locate the new c
6460: 61 63 68 65 20 2a 2f 0a 0a 20 20 61 73 73 65 72  ache */..  asser
6470: 74 28 20 28 73 7a 50 61 67 65 20 26 20 28 73 7a  t( (szPage & (sz
6480: 50 61 67 65 2d 31 29 29 3d 3d 30 20 26 26 20 73  Page-1))==0 && s
6490: 7a 50 61 67 65 3e 3d 35 31 32 20 26 26 20 73 7a  zPage>=512 && sz
64a0: 50 61 67 65 3c 3d 36 35 35 33 36 20 29 3b 0a 20  Page<=65536 );. 
64b0: 20 61 73 73 65 72 74 28 20 73 7a 45 78 74 72 61   assert( szExtra
64c0: 20 3c 20 33 30 30 20 29 3b 0a 0a 20 20 73 7a 20   < 300 );..  sz 
64d0: 3d 20 73 69 7a 65 6f 66 28 50 43 61 63 68 65 31  = sizeof(PCache1
64e0: 29 20 2b 20 73 69 7a 65 6f 66 28 50 47 72 6f 75  ) + sizeof(PGrou
64f0: 70 29 2a 70 63 61 63 68 65 31 2e 73 65 70 61 72  p)*pcache1.separ
6500: 61 74 65 43 61 63 68 65 3b 0a 20 20 70 43 61 63  ateCache;.  pCac
6510: 68 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29  he = (PCache1 *)
6520: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72  sqlite3MallocZer
6530: 6f 28 73 7a 29 3b 0a 20 20 69 66 28 20 70 43 61  o(sz);.  if( pCa
6540: 63 68 65 20 29 7b 0a 20 20 20 20 69 66 28 20 70  che ){.    if( p
6550: 63 61 63 68 65 31 2e 73 65 70 61 72 61 74 65 43  cache1.separateC
6560: 61 63 68 65 20 29 7b 0a 20 20 20 20 20 20 70 47  ache ){.      pG
6570: 72 6f 75 70 20 3d 20 28 50 47 72 6f 75 70 2a 29  roup = (PGroup*)
6580: 26 70 43 61 63 68 65 5b 31 5d 3b 0a 20 20 20 20  &pCache[1];.    
6590: 20 20 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e    pGroup->mxPinn
65a0: 65 64 20 3d 20 31 30 3b 0a 20 20 20 20 7d 65 6c  ed = 10;.    }el
65b0: 73 65 7b 0a 20 20 20 20 20 20 70 47 72 6f 75 70  se{.      pGroup
65c0: 20 3d 20 26 70 63 61 63 68 65 31 2e 67 72 70 3b   = &pcache1.grp;
65d0: 0a 20 20 20 20 7d 0a 20 20 20 20 70 43 61 63 68  .    }.    pCach
65e0: 65 2d 3e 70 47 72 6f 75 70 20 3d 20 70 47 72 6f  e->pGroup = pGro
65f0: 75 70 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e  up;.    pCache->
6600: 73 7a 50 61 67 65 20 3d 20 73 7a 50 61 67 65 3b  szPage = szPage;
6610: 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 73 7a 45  .    pCache->szE
6620: 78 74 72 61 20 3d 20 73 7a 45 78 74 72 61 3b 0a  xtra = szExtra;.
6630: 20 20 20 20 70 43 61 63 68 65 2d 3e 73 7a 41 6c      pCache->szAl
6640: 6c 6f 63 20 3d 20 73 7a 50 61 67 65 20 2b 20 73  loc = szPage + s
6650: 7a 45 78 74 72 61 20 2b 20 52 4f 55 4e 44 38 28  zExtra + ROUND8(
6660: 73 69 7a 65 6f 66 28 50 67 48 64 72 31 29 29 3b  sizeof(PgHdr1));
6670: 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 62 50 75  .    pCache->bPu
6680: 72 67 65 61 62 6c 65 20 3d 20 28 62 50 75 72 67  rgeable = (bPurg
6690: 65 61 62 6c 65 20 3f 20 31 20 3a 20 30 29 3b 0a  eable ? 1 : 0);.
66a0: 20 20 20 20 70 63 61 63 68 65 31 45 6e 74 65 72      pcache1Enter
66b0: 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20  Mutex(pGroup);. 
66c0: 20 20 20 70 63 61 63 68 65 31 52 65 73 69 7a 65     pcache1Resize
66d0: 48 61 73 68 28 70 43 61 63 68 65 29 3b 0a 20 20  Hash(pCache);.  
66e0: 20 20 69 66 28 20 62 50 75 72 67 65 61 62 6c 65    if( bPurgeable
66f0: 20 29 7b 0a 20 20 20 20 20 20 70 43 61 63 68 65   ){.      pCache
6700: 2d 3e 6e 4d 69 6e 20 3d 20 31 30 3b 0a 20 20 20  ->nMin = 10;.   
6710: 20 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50     pGroup->nMinP
6720: 61 67 65 20 2b 3d 20 70 43 61 63 68 65 2d 3e 6e  age += pCache->n
6730: 4d 69 6e 3b 0a 20 20 20 20 20 20 70 47 72 6f 75  Min;.      pGrou
6740: 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 20 70 47  p->mxPinned = pG
6750: 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 2b  roup->nMaxPage +
6760: 20 31 30 20 2d 20 70 47 72 6f 75 70 2d 3e 6e 4d   10 - pGroup->nM
6770: 69 6e 50 61 67 65 3b 0a 20 20 20 20 7d 0a 20 20  inPage;.    }.  
6780: 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75    pcache1LeaveMu
6790: 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20 20 20  tex(pGroup);.   
67a0: 20 69 66 28 20 70 43 61 63 68 65 2d 3e 6e 48 61   if( pCache->nHa
67b0: 73 68 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 70  sh==0 ){.      p
67c0: 63 61 63 68 65 31 44 65 73 74 72 6f 79 28 28 73  cache1Destroy((s
67d0: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2a 29 70  qlite3_pcache*)p
67e0: 43 61 63 68 65 29 3b 0a 20 20 20 20 20 20 70 43  Cache);.      pC
67f0: 61 63 68 65 20 3d 20 30 3b 0a 20 20 20 20 7d 0a  ache = 0;.    }.
6800: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 28 73 71    }.  return (sq
6810: 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 29 70  lite3_pcache *)p
6820: 43 61 63 68 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  Cache;.}../*.** 
6830: 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  Implementation o
6840: 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63  f the sqlite3_pc
6850: 61 63 68 65 2e 78 43 61 63 68 65 73 69 7a 65 20  ache.xCachesize 
6860: 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 43  method. .**.** C
6870: 6f 6e 66 69 67 75 72 65 20 74 68 65 20 63 61 63  onfigure the cac
6880: 68 65 5f 73 69 7a 65 20 6c 69 6d 69 74 20 66 6f  he_size limit fo
6890: 72 20 61 20 63 61 63 68 65 2e 0a 2a 2f 0a 73 74  r a cache..*/.st
68a0: 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65  atic void pcache
68b0: 31 43 61 63 68 65 73 69 7a 65 28 73 71 6c 69 74  1Cachesize(sqlit
68c0: 65 33 5f 70 63 61 63 68 65 20 2a 70 2c 20 69 6e  e3_pcache *p, in
68d0: 74 20 6e 4d 61 78 29 7b 0a 20 20 50 43 61 63 68  t nMax){.  PCach
68e0: 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43  e1 *pCache = (PC
68f0: 61 63 68 65 31 20 2a 29 70 3b 0a 20 20 69 66 28  ache1 *)p;.  if(
6900: 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61   pCache->bPurgea
6910: 62 6c 65 20 29 7b 0a 20 20 20 20 50 47 72 6f 75  ble ){.    PGrou
6920: 70 20 2a 70 47 72 6f 75 70 20 3d 20 70 43 61 63  p *pGroup = pCac
6930: 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20 20 20 20  he->pGroup;.    
6940: 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65  pcache1EnterMute
6950: 78 28 70 47 72 6f 75 70 29 3b 0a 20 20 20 20 70  x(pGroup);.    p
6960: 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20  Group->nMaxPage 
6970: 2b 3d 20 28 6e 4d 61 78 20 2d 20 70 43 61 63 68  += (nMax - pCach
6980: 65 2d 3e 6e 4d 61 78 29 3b 0a 20 20 20 20 70 47  e->nMax);.    pG
6990: 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d  roup->mxPinned =
69a0: 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67   pGroup->nMaxPag
69b0: 65 20 2b 20 31 30 20 2d 20 70 47 72 6f 75 70 2d  e + 10 - pGroup-
69c0: 3e 6e 4d 69 6e 50 61 67 65 3b 0a 20 20 20 20 70  >nMinPage;.    p
69d0: 43 61 63 68 65 2d 3e 6e 4d 61 78 20 3d 20 6e 4d  Cache->nMax = nM
69e0: 61 78 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e  ax;.    pCache->
69f0: 6e 39 30 70 63 74 20 3d 20 70 43 61 63 68 65 2d  n90pct = pCache-
6a00: 3e 6e 4d 61 78 2a 39 2f 31 30 3b 0a 20 20 20 20  >nMax*9/10;.    
6a10: 70 63 61 63 68 65 31 45 6e 66 6f 72 63 65 4d 61  pcache1EnforceMa
6a20: 78 50 61 67 65 28 70 43 61 63 68 65 29 3b 0a 20  xPage(pCache);. 
6a30: 20 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d     pcache1LeaveM
6a40: 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20 20  utex(pGroup);.  
6a50: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65  }.}../*.** Imple
6a60: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65  mentation of the
6a70: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e   sqlite3_pcache.
6a80: 78 53 68 72 69 6e 6b 20 6d 65 74 68 6f 64 2e 20  xShrink method. 
6a90: 0a 2a 2a 0a 2a 2a 20 46 72 65 65 20 75 70 20 61  .**.** Free up a
6aa0: 73 20 6d 75 63 68 20 6d 65 6d 6f 72 79 20 61 73  s much memory as
6ab0: 20 70 6f 73 73 69 62 6c 65 2e 0a 2a 2f 0a 73 74   possible..*/.st
6ac0: 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65  atic void pcache
6ad0: 31 53 68 72 69 6e 6b 28 73 71 6c 69 74 65 33 5f  1Shrink(sqlite3_
6ae0: 70 63 61 63 68 65 20 2a 70 29 7b 0a 20 20 50 43  pcache *p){.  PC
6af0: 61 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20  ache1 *pCache = 
6b00: 28 50 43 61 63 68 65 31 2a 29 70 3b 0a 20 20 69  (PCache1*)p;.  i
6b10: 66 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67  f( pCache->bPurg
6b20: 65 61 62 6c 65 20 29 7b 0a 20 20 20 20 50 47 72  eable ){.    PGr
6b30: 6f 75 70 20 2a 70 47 72 6f 75 70 20 3d 20 70 43  oup *pGroup = pC
6b40: 61 63 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20 20  ache->pGroup;.  
6b50: 20 20 69 6e 74 20 73 61 76 65 64 4d 61 78 50 61    int savedMaxPa
6b60: 67 65 3b 0a 20 20 20 20 70 63 61 63 68 65 31 45  ge;.    pcache1E
6b70: 6e 74 65 72 4d 75 74 65 78 28 70 47 72 6f 75 70  nterMutex(pGroup
6b80: 29 3b 0a 20 20 20 20 73 61 76 65 64 4d 61 78 50  );.    savedMaxP
6b90: 61 67 65 20 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d  age = pGroup->nM
6ba0: 61 78 50 61 67 65 3b 0a 20 20 20 20 70 47 72 6f  axPage;.    pGro
6bb0: 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 3d 20 30  up->nMaxPage = 0
6bc0: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e 66  ;.    pcache1Enf
6bd0: 6f 72 63 65 4d 61 78 50 61 67 65 28 70 43 61 63  orceMaxPage(pCac
6be0: 68 65 29 3b 0a 20 20 20 20 70 47 72 6f 75 70 2d  he);.    pGroup-
6bf0: 3e 6e 4d 61 78 50 61 67 65 20 3d 20 73 61 76 65  >nMaxPage = save
6c00: 64 4d 61 78 50 61 67 65 3b 0a 20 20 20 20 70 63  dMaxPage;.    pc
6c10: 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28  ache1LeaveMutex(
6c20: 70 47 72 6f 75 70 29 3b 0a 20 20 7d 0a 7d 0a 0a  pGroup);.  }.}..
6c30: 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61  /*.** Implementa
6c40: 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69  tion of the sqli
6c50: 74 65 33 5f 70 63 61 63 68 65 2e 78 50 61 67 65  te3_pcache.xPage
6c60: 63 6f 75 6e 74 20 6d 65 74 68 6f 64 2e 20 0a 2a  count method. .*
6c70: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 63 61  /.static int pca
6c80: 63 68 65 31 50 61 67 65 63 6f 75 6e 74 28 73 71  che1Pagecount(sq
6c90: 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 29  lite3_pcache *p)
6ca0: 7b 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 50 43 61  {.  int n;.  PCa
6cb0: 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28  che1 *pCache = (
6cc0: 50 43 61 63 68 65 31 2a 29 70 3b 0a 20 20 70 63  PCache1*)p;.  pc
6cd0: 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28  ache1EnterMutex(
6ce0: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b  pCache->pGroup);
6cf0: 0a 20 20 6e 20 3d 20 70 43 61 63 68 65 2d 3e 6e  .  n = pCache->n
6d00: 50 61 67 65 3b 0a 20 20 70 63 61 63 68 65 31 4c  Page;.  pcache1L
6d10: 65 61 76 65 4d 75 74 65 78 28 70 43 61 63 68 65  eaveMutex(pCache
6d20: 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20 72 65 74  ->pGroup);.  ret
6d30: 75 72 6e 20 6e 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a  urn n;.}.../*.**
6d40: 20 49 6d 70 6c 65 6d 65 6e 74 20 73 74 65 70 73   Implement steps
6d50: 20 33 2c 20 34 2c 20 61 6e 64 20 35 20 6f 66 20   3, 4, and 5 of 
6d60: 74 68 65 20 70 63 61 63 68 65 31 46 65 74 63 68  the pcache1Fetch
6d70: 28 29 20 61 6c 67 6f 72 69 74 68 6d 20 64 65 73  () algorithm des
6d80: 63 72 69 62 65 64 0a 2a 2a 20 69 6e 20 74 68 65  cribed.** in the
6d90: 20 68 65 61 64 65 72 20 6f 66 20 74 68 65 20 70   header of the p
6da0: 63 61 63 68 65 31 46 65 74 63 68 28 29 20 70 72  cache1Fetch() pr
6db0: 6f 63 65 64 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 54  ocedure..**.** T
6dc0: 68 69 73 20 73 74 65 70 73 20 61 72 65 20 62 72  his steps are br
6dd0: 6f 6b 65 6e 20 6f 75 74 20 69 6e 74 6f 20 61 20  oken out into a 
6de0: 73 65 70 61 72 61 74 65 20 70 72 6f 63 65 64 75  separate procedu
6df0: 72 65 20 62 65 63 61 75 73 65 20 74 68 65 79 20  re because they 
6e00: 61 72 65 0a 2a 2a 20 75 73 75 61 6c 6c 79 20 6e  are.** usually n
6e10: 6f 74 20 6e 65 65 64 65 64 2c 20 61 6e 64 20 62  ot needed, and b
6e20: 79 20 61 76 6f 69 64 69 6e 67 20 74 68 65 20 73  y avoiding the s
6e30: 74 61 63 6b 20 69 6e 69 74 69 61 6c 69 7a 61 74  tack initializat
6e40: 69 6f 6e 20 72 65 71 75 69 72 65 64 0a 2a 2a 20  ion required.** 
6e50: 66 6f 72 20 74 68 65 73 65 20 73 74 65 70 73 2c  for these steps,
6e60: 20 74 68 65 20 6d 61 69 6e 20 70 63 61 63 68 65   the main pcache
6e70: 31 46 65 74 63 68 28 29 20 70 72 6f 63 65 64 75  1Fetch() procedu
6e80: 72 65 20 63 61 6e 20 72 75 6e 20 66 61 73 74 65  re can run faste
6e90: 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 53 51 4c  r..*/.static SQL
6ea0: 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20 50 67 48  ITE_NOINLINE PgH
6eb0: 64 72 31 20 2a 70 63 61 63 68 65 31 46 65 74 63  dr1 *pcache1Fetc
6ec0: 68 53 74 61 67 65 32 28 0a 20 20 50 43 61 63 68  hStage2(.  PCach
6ed0: 65 31 20 2a 70 43 61 63 68 65 2c 20 0a 20 20 75  e1 *pCache, .  u
6ee0: 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4b 65 79  nsigned int iKey
6ef0: 2c 20 0a 20 20 69 6e 74 20 63 72 65 61 74 65 46  , .  int createF
6f00: 6c 61 67 0a 29 7b 0a 20 20 75 6e 73 69 67 6e 65  lag.){.  unsigne
6f10: 64 20 69 6e 74 20 6e 50 69 6e 6e 65 64 3b 0a 20  d int nPinned;. 
6f20: 20 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70 20   PGroup *pGroup 
6f30: 3d 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70  = pCache->pGroup
6f40: 3b 0a 20 20 50 67 48 64 72 31 20 2a 70 50 61 67  ;.  PgHdr1 *pPag
6f50: 65 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20 53 74 65  e = 0;..  /* Ste
6f60: 70 20 33 3a 20 41 62 6f 72 74 20 69 66 20 63 72  p 3: Abort if cr
6f70: 65 61 74 65 46 6c 61 67 20 69 73 20 31 20 62 75  eateFlag is 1 bu
6f80: 74 20 74 68 65 20 63 61 63 68 65 20 69 73 20 6e  t the cache is n
6f90: 65 61 72 6c 79 20 66 75 6c 6c 20 2a 2f 0a 20 20  early full */.  
6fa0: 61 73 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e  assert( pCache->
6fb0: 6e 50 61 67 65 20 3e 3d 20 70 43 61 63 68 65 2d  nPage >= pCache-
6fc0: 3e 6e 52 65 63 79 63 6c 61 62 6c 65 20 29 3b 0a  >nRecyclable );.
6fd0: 20 20 6e 50 69 6e 6e 65 64 20 3d 20 70 43 61 63    nPinned = pCac
6fe0: 68 65 2d 3e 6e 50 61 67 65 20 2d 20 70 43 61 63  he->nPage - pCac
6ff0: 68 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65 3b  he->nRecyclable;
7000: 0a 20 20 61 73 73 65 72 74 28 20 70 47 72 6f 75  .  assert( pGrou
7010: 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 3d 20 70  p->mxPinned == p
7020: 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20  Group->nMaxPage 
7030: 2b 20 31 30 20 2d 20 70 47 72 6f 75 70 2d 3e 6e  + 10 - pGroup->n
7040: 4d 69 6e 50 61 67 65 20 29 3b 0a 20 20 61 73 73  MinPage );.  ass
7050: 65 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 39 30  ert( pCache->n90
7060: 70 63 74 20 3d 3d 20 70 43 61 63 68 65 2d 3e 6e  pct == pCache->n
7070: 4d 61 78 2a 39 2f 31 30 20 29 3b 0a 20 20 69 66  Max*9/10 );.  if
7080: 28 20 63 72 65 61 74 65 46 6c 61 67 3d 3d 31 20  ( createFlag==1 
7090: 26 26 20 28 0a 20 20 20 20 20 20 20 20 6e 50 69  && (.        nPi
70a0: 6e 6e 65 64 3e 3d 70 47 72 6f 75 70 2d 3e 6d 78  nned>=pGroup->mx
70b0: 50 69 6e 6e 65 64 0a 20 20 20 20 20 7c 7c 20 6e  Pinned.     || n
70c0: 50 69 6e 6e 65 64 3e 3d 70 43 61 63 68 65 2d 3e  Pinned>=pCache->
70d0: 6e 39 30 70 63 74 0a 20 20 20 20 20 7c 7c 20 28  n90pct.     || (
70e0: 70 63 61 63 68 65 31 55 6e 64 65 72 4d 65 6d 6f  pcache1UnderMemo
70f0: 72 79 50 72 65 73 73 75 72 65 28 70 43 61 63 68  ryPressure(pCach
7100: 65 29 20 26 26 20 70 43 61 63 68 65 2d 3e 6e 52  e) && pCache->nR
7110: 65 63 79 63 6c 61 62 6c 65 3c 6e 50 69 6e 6e 65  ecyclable<nPinne
7120: 64 29 0a 20 20 29 29 7b 0a 20 20 20 20 72 65 74  d).  )){.    ret
7130: 75 72 6e 20 30 3b 0a 20 20 7d 0a 0a 20 20 69 66  urn 0;.  }..  if
7140: 28 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 3e  ( pCache->nPage>
7150: 3d 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 20 29  =pCache->nHash )
7160: 20 70 63 61 63 68 65 31 52 65 73 69 7a 65 48 61   pcache1ResizeHa
7170: 73 68 28 70 43 61 63 68 65 29 3b 0a 20 20 61 73  sh(pCache);.  as
7180: 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 48  sert( pCache->nH
7190: 61 73 68 3e 30 20 26 26 20 70 43 61 63 68 65 2d  ash>0 && pCache-
71a0: 3e 61 70 48 61 73 68 20 29 3b 0a 0a 20 20 2f 2a  >apHash );..  /*
71b0: 20 53 74 65 70 20 34 2e 20 54 72 79 20 74 6f 20   Step 4. Try to 
71c0: 72 65 63 79 63 6c 65 20 61 20 70 61 67 65 2e 20  recycle a page. 
71d0: 2a 2f 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d  */.  if( pCache-
71e0: 3e 62 50 75 72 67 65 61 62 6c 65 0a 20 20 20 26  >bPurgeable.   &
71f0: 26 20 70 47 72 6f 75 70 2d 3e 70 4c 72 75 54 61  & pGroup->pLruTa
7200: 69 6c 0a 20 20 20 26 26 20 28 28 70 43 61 63 68  il.   && ((pCach
7210: 65 2d 3e 6e 50 61 67 65 2b 31 3e 3d 70 43 61 63  e->nPage+1>=pCac
7220: 68 65 2d 3e 6e 4d 61 78 29 20 7c 7c 20 70 63 61  he->nMax) || pca
7230: 63 68 65 31 55 6e 64 65 72 4d 65 6d 6f 72 79 50  che1UnderMemoryP
7240: 72 65 73 73 75 72 65 28 70 43 61 63 68 65 29 29  ressure(pCache))
7250: 0a 20 20 29 7b 0a 20 20 20 20 50 43 61 63 68 65  .  ){.    PCache
7260: 31 20 2a 70 4f 74 68 65 72 3b 0a 20 20 20 20 70  1 *pOther;.    p
7270: 50 61 67 65 20 3d 20 70 47 72 6f 75 70 2d 3e 70  Page = pGroup->p
7280: 4c 72 75 54 61 69 6c 3b 0a 20 20 20 20 61 73 73  LruTail;.    ass
7290: 65 72 74 28 20 70 50 61 67 65 2d 3e 69 73 50 69  ert( pPage->isPi
72a0: 6e 6e 65 64 3d 3d 30 20 29 3b 0a 20 20 20 20 70  nned==0 );.    p
72b0: 63 61 63 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d  cache1RemoveFrom
72c0: 48 61 73 68 28 70 50 61 67 65 2c 20 30 29 3b 0a  Hash(pPage, 0);.
72d0: 20 20 20 20 70 63 61 63 68 65 31 50 69 6e 50 61      pcache1PinPa
72e0: 67 65 28 70 50 61 67 65 29 3b 0a 20 20 20 20 70  ge(pPage);.    p
72f0: 4f 74 68 65 72 20 3d 20 70 50 61 67 65 2d 3e 70  Other = pPage->p
7300: 43 61 63 68 65 3b 0a 20 20 20 20 69 66 28 20 70  Cache;.    if( p
7310: 4f 74 68 65 72 2d 3e 73 7a 41 6c 6c 6f 63 20 21  Other->szAlloc !
7320: 3d 20 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f  = pCache->szAllo
7330: 63 20 29 7b 0a 20 20 20 20 20 20 70 63 61 63 68  c ){.      pcach
7340: 65 31 46 72 65 65 50 61 67 65 28 70 50 61 67 65  e1FreePage(pPage
7350: 29 3b 0a 20 20 20 20 20 20 70 50 61 67 65 20 3d  );.      pPage =
7360: 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20   0;.    }else{. 
7370: 20 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e 43 75       pGroup->nCu
7380: 72 72 65 6e 74 50 61 67 65 20 2d 3d 20 28 70 4f  rrentPage -= (pO
7390: 74 68 65 72 2d 3e 62 50 75 72 67 65 61 62 6c 65  ther->bPurgeable
73a0: 20 2d 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67   - pCache->bPurg
73b0: 65 61 62 6c 65 29 3b 0a 20 20 20 20 7d 0a 20 20  eable);.    }.  
73c0: 7d 0a 0a 20 20 2f 2a 20 53 74 65 70 20 35 2e 20  }..  /* Step 5. 
73d0: 49 66 20 61 20 75 73 61 62 6c 65 20 70 61 67 65  If a usable page
73e0: 20 62 75 66 66 65 72 20 68 61 73 20 73 74 69 6c   buffer has stil
73f0: 6c 20 6e 6f 74 20 62 65 65 6e 20 66 6f 75 6e 64  l not been found
7400: 2c 20 0a 20 20 2a 2a 20 61 74 74 65 6d 70 74 20  , .  ** attempt 
7410: 74 6f 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65  to allocate a ne
7420: 77 20 6f 6e 65 2e 20 0a 20 20 2a 2f 0a 20 20 69  w one. .  */.  i
7430: 66 28 20 21 70 50 61 67 65 20 29 7b 0a 20 20 20  f( !pPage ){.   
7440: 20 69 66 28 20 63 72 65 61 74 65 46 6c 61 67 3d   if( createFlag=
7450: 3d 31 20 29 7b 20 73 71 6c 69 74 65 33 42 65 67  =1 ){ sqlite3Beg
7460: 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29  inBenignMalloc()
7470: 3b 20 7d 0a 20 20 20 20 70 50 61 67 65 20 3d 20  ; }.    pPage = 
7480: 70 63 61 63 68 65 31 41 6c 6c 6f 63 50 61 67 65  pcache1AllocPage
7490: 28 70 43 61 63 68 65 29 3b 0a 20 20 20 20 69 66  (pCache);.    if
74a0: 28 20 63 72 65 61 74 65 46 6c 61 67 3d 3d 31 20  ( createFlag==1 
74b0: 29 7b 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e  ){ sqlite3EndBen
74c0: 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 20 7d 0a 20  ignMalloc(); }. 
74d0: 20 7d 0a 0a 20 20 69 66 28 20 70 50 61 67 65 20   }..  if( pPage 
74e0: 29 7b 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20  ){.    unsigned 
74f0: 69 6e 74 20 68 20 3d 20 69 4b 65 79 20 25 20 70  int h = iKey % p
7500: 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20  Cache->nHash;.  
7510: 20 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 2b    pCache->nPage+
7520: 2b 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 4b  +;.    pPage->iK
7530: 65 79 20 3d 20 69 4b 65 79 3b 0a 20 20 20 20 70  ey = iKey;.    p
7540: 50 61 67 65 2d 3e 70 4e 65 78 74 20 3d 20 70 43  Page->pNext = pC
7550: 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 3b  ache->apHash[h];
7560: 0a 20 20 20 20 70 50 61 67 65 2d 3e 70 43 61 63  .    pPage->pCac
7570: 68 65 20 3d 20 70 43 61 63 68 65 3b 0a 20 20 20  he = pCache;.   
7580: 20 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76   pPage->pLruPrev
7590: 20 3d 20 30 3b 0a 20 20 20 20 70 50 61 67 65 2d   = 0;.    pPage-
75a0: 3e 70 4c 72 75 4e 65 78 74 20 3d 20 30 3b 0a 20  >pLruNext = 0;. 
75b0: 20 20 20 70 50 61 67 65 2d 3e 69 73 50 69 6e 6e     pPage->isPinn
75c0: 65 64 20 3d 20 31 3b 0a 20 20 20 20 2a 28 76 6f  ed = 1;.    *(vo
75d0: 69 64 20 2a 2a 29 70 50 61 67 65 2d 3e 70 61 67  id **)pPage->pag
75e0: 65 2e 70 45 78 74 72 61 20 3d 20 30 3b 0a 20 20  e.pExtra = 0;.  
75f0: 20 20 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68    pCache->apHash
7600: 5b 68 5d 20 3d 20 70 50 61 67 65 3b 0a 20 20 20  [h] = pPage;.   
7610: 20 69 66 28 20 69 4b 65 79 3e 70 43 61 63 68 65   if( iKey>pCache
7620: 2d 3e 69 4d 61 78 4b 65 79 20 29 7b 0a 20 20 20  ->iMaxKey ){.   
7630: 20 20 20 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b     pCache->iMaxK
7640: 65 79 20 3d 20 69 4b 65 79 3b 0a 20 20 20 20 7d  ey = iKey;.    }
7650: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 50  .  }.  return pP
7660: 61 67 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d  age;.}../*.** Im
7670: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20  plementation of 
7680: 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63  the sqlite3_pcac
7690: 68 65 2e 78 46 65 74 63 68 20 6d 65 74 68 6f 64  he.xFetch method
76a0: 2e 20 0a 2a 2a 0a 2a 2a 20 46 65 74 63 68 20 61  . .**.** Fetch a
76b0: 20 70 61 67 65 20 62 79 20 6b 65 79 20 76 61 6c   page by key val
76c0: 75 65 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 74 68 65  ue..**.** Whethe
76d0: 72 20 6f 72 20 6e 6f 74 20 61 20 6e 65 77 20 70  r or not a new p
76e0: 61 67 65 20 6d 61 79 20 62 65 20 61 6c 6c 6f 63  age may be alloc
76f0: 61 74 65 64 20 62 79 20 74 68 69 73 20 66 75 6e  ated by this fun
7700: 63 74 69 6f 6e 20 64 65 70 65 6e 64 73 20 6f 6e  ction depends on
7710: 0a 2a 2a 20 74 68 65 20 76 61 6c 75 65 20 6f 66  .** the value of
7720: 20 74 68 65 20 63 72 65 61 74 65 46 6c 61 67 20   the createFlag 
7730: 61 72 67 75 6d 65 6e 74 2e 20 20 30 20 6d 65 61  argument.  0 mea
7740: 6e 73 20 64 6f 20 6e 6f 74 20 61 6c 6c 6f 63 61  ns do not alloca
7750: 74 65 20 61 20 6e 65 77 0a 2a 2a 20 70 61 67 65  te a new.** page
7760: 2e 20 20 31 20 6d 65 61 6e 73 20 61 6c 6c 6f 63  .  1 means alloc
7770: 61 74 65 20 61 20 6e 65 77 20 70 61 67 65 20 69  ate a new page i
7780: 66 20 73 70 61 63 65 20 69 73 20 65 61 73 69 6c  f space is easil
7790: 79 20 61 76 61 69 6c 61 62 6c 65 2e 20 20 32 20  y available.  2 
77a0: 0a 2a 2a 20 6d 65 61 6e 73 20 74 6f 20 74 72 79  .** means to try
77b0: 20 72 65 61 6c 6c 79 20 68 61 72 64 20 74 6f 20   really hard to 
77c0: 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 70  allocate a new p
77d0: 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 61  age..**.** For a
77e0: 20 6e 6f 6e 2d 70 75 72 67 65 61 62 6c 65 20 63   non-purgeable c
77f0: 61 63 68 65 20 28 61 20 63 61 63 68 65 20 75 73  ache (a cache us
7800: 65 64 20 61 73 20 74 68 65 20 73 74 6f 72 61 67  ed as the storag
7810: 65 20 66 6f 72 20 61 6e 20 69 6e 2d 6d 65 6d 6f  e for an in-memo
7820: 72 79 0a 2a 2a 20 64 61 74 61 62 61 73 65 29 20  ry.** database) 
7830: 74 68 65 72 65 20 69 73 20 72 65 61 6c 6c 79 20  there is really 
7840: 6e 6f 20 64 69 66 66 65 72 65 6e 63 65 20 62 65  no difference be
7850: 74 77 65 65 6e 20 63 72 65 61 74 65 46 6c 61 67  tween createFlag
7860: 20 31 20 61 6e 64 20 32 2e 20 20 53 6f 0a 2a 2a   1 and 2.  So.**
7870: 20 74 68 65 20 63 61 6c 6c 69 6e 67 20 66 75 6e   the calling fun
7880: 63 74 69 6f 6e 20 28 70 63 61 63 68 65 2e 63 29  ction (pcache.c)
7890: 20 77 69 6c 6c 20 6e 65 76 65 72 20 68 61 76 65   will never have
78a0: 20 61 20 63 72 65 61 74 65 46 6c 61 67 20 6f 66   a createFlag of
78b0: 20 31 20 6f 6e 0a 2a 2a 20 61 20 6e 6f 6e 2d 70   1 on.** a non-p
78c0: 75 72 67 65 61 62 6c 65 20 63 61 63 68 65 2e 0a  urgeable cache..
78d0: 2a 2a 0a 2a 2a 20 54 68 65 72 65 20 61 72 65 20  **.** There are 
78e0: 74 68 72 65 65 20 64 69 66 66 65 72 65 6e 74 20  three different 
78f0: 61 70 70 72 6f 61 63 68 65 73 20 74 6f 20 6f 62  approaches to ob
7900: 74 61 69 6e 69 6e 67 20 73 70 61 63 65 20 66 6f  taining space fo
7910: 72 20 61 20 70 61 67 65 2c 0a 2a 2a 20 64 65 70  r a page,.** dep
7920: 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 76 61  ending on the va
7930: 6c 75 65 20 6f 66 20 70 61 72 61 6d 65 74 65 72  lue of parameter
7940: 20 63 72 65 61 74 65 46 6c 61 67 20 28 77 68 69   createFlag (whi
7950: 63 68 20 6d 61 79 20 62 65 20 30 2c 20 31 20 6f  ch may be 0, 1 o
7960: 72 20 32 29 2e 0a 2a 2a 0a 2a 2a 20 20 20 31 2e  r 2)..**.**   1.
7970: 20 52 65 67 61 72 64 6c 65 73 73 20 6f 66 20 74   Regardless of t
7980: 68 65 20 76 61 6c 75 65 20 6f 66 20 63 72 65 61  he value of crea
7990: 74 65 46 6c 61 67 2c 20 74 68 65 20 63 61 63 68  teFlag, the cach
79a0: 65 20 69 73 20 73 65 61 72 63 68 65 64 20 66 6f  e is searched fo
79b0: 72 20 61 20 0a 2a 2a 20 20 20 20 20 20 63 6f 70  r a .**      cop
79c0: 79 20 6f 66 20 74 68 65 20 72 65 71 75 65 73 74  y of the request
79d0: 65 64 20 70 61 67 65 2e 20 49 66 20 6f 6e 65 20  ed page. If one 
79e0: 69 73 20 66 6f 75 6e 64 2c 20 69 74 20 69 73 20  is found, it is 
79f0: 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20  returned..**.** 
7a00: 20 20 32 2e 20 49 66 20 63 72 65 61 74 65 46 6c    2. If createFl
7a10: 61 67 3d 3d 30 20 61 6e 64 20 74 68 65 20 70 61  ag==0 and the pa
7a20: 67 65 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64  ge is not alread
7a30: 79 20 69 6e 20 74 68 65 20 63 61 63 68 65 2c 20  y in the cache, 
7a40: 4e 55 4c 4c 20 69 73 0a 2a 2a 20 20 20 20 20 20  NULL is.**      
7a50: 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20  returned..**.** 
7a60: 20 20 33 2e 20 49 66 20 63 72 65 61 74 65 46 6c    3. If createFl
7a70: 61 67 20 69 73 20 31 2c 20 61 6e 64 20 74 68 65  ag is 1, and the
7a80: 20 70 61 67 65 20 69 73 20 6e 6f 74 20 61 6c 72   page is not alr
7a90: 65 61 64 79 20 69 6e 20 74 68 65 20 63 61 63 68  eady in the cach
7aa0: 65 2c 20 74 68 65 6e 0a 2a 2a 20 20 20 20 20 20  e, then.**      
7ab0: 72 65 74 75 72 6e 20 4e 55 4c 4c 20 28 64 6f 20  return NULL (do 
7ac0: 6e 6f 74 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e  not allocate a n
7ad0: 65 77 20 70 61 67 65 29 20 69 66 20 61 6e 79 20  ew page) if any 
7ae0: 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  of the following
7af0: 0a 2a 2a 20 20 20 20 20 20 63 6f 6e 64 69 74 69  .**      conditi
7b00: 6f 6e 73 20 61 72 65 20 74 72 75 65 3a 0a 2a 2a  ons are true:.**
7b10: 0a 2a 2a 20 20 20 20 20 20 20 28 61 29 20 74 68  .**       (a) th
7b20: 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65  e number of page
7b30: 73 20 70 69 6e 6e 65 64 20 62 79 20 74 68 65 20  s pinned by the 
7b40: 63 61 63 68 65 20 69 73 20 67 72 65 61 74 65 72  cache is greater
7b50: 20 74 68 61 6e 0a 2a 2a 20 20 20 20 20 20 20 20   than.**        
7b60: 20 20 20 50 43 61 63 68 65 31 2e 6e 4d 61 78 2c     PCache1.nMax,
7b70: 20 6f 72 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20   or.**.**       
7b80: 28 62 29 20 74 68 65 20 6e 75 6d 62 65 72 20 6f  (b) the number o
7b90: 66 20 70 61 67 65 73 20 70 69 6e 6e 65 64 20 62  f pages pinned b
7ba0: 79 20 74 68 65 20 63 61 63 68 65 20 69 73 20 67  y the cache is g
7bb0: 72 65 61 74 65 72 20 74 68 61 6e 0a 2a 2a 20 20  reater than.**  
7bc0: 20 20 20 20 20 20 20 20 20 74 68 65 20 73 75 6d           the sum
7bd0: 20 6f 66 20 6e 4d 61 78 20 66 6f 72 20 61 6c 6c   of nMax for all
7be0: 20 70 75 72 67 65 61 62 6c 65 20 63 61 63 68 65   purgeable cache
7bf0: 73 2c 20 6c 65 73 73 20 74 68 65 20 73 75 6d 20  s, less the sum 
7c00: 6f 66 20 0a 2a 2a 20 20 20 20 20 20 20 20 20 20  of .**          
7c10: 20 6e 4d 69 6e 20 66 6f 72 20 61 6c 6c 20 6f 74   nMin for all ot
7c20: 68 65 72 20 70 75 72 67 65 61 62 6c 65 20 63 61  her purgeable ca
7c30: 63 68 65 73 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 20  ches, or.**.**  
7c40: 20 34 2e 20 49 66 20 6e 6f 6e 65 20 6f 66 20 74   4. If none of t
7c50: 68 65 20 66 69 72 73 74 20 74 68 72 65 65 20 63  he first three c
7c60: 6f 6e 64 69 74 69 6f 6e 73 20 61 70 70 6c 79 20  onditions apply 
7c70: 61 6e 64 20 74 68 65 20 63 61 63 68 65 20 69 73  and the cache is
7c80: 20 6d 61 72 6b 65 64 0a 2a 2a 20 20 20 20 20 20   marked.**      
7c90: 61 73 20 70 75 72 67 65 61 62 6c 65 2c 20 61 6e  as purgeable, an
7ca0: 64 20 69 66 20 6f 6e 65 20 6f 66 20 74 68 65 20  d if one of the 
7cb0: 66 6f 6c 6c 6f 77 69 6e 67 20 69 73 20 74 72 75  following is tru
7cc0: 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 28  e:.**.**       (
7cd0: 61 29 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66  a) The number of
7ce0: 20 70 61 67 65 73 20 61 6c 6c 6f 63 61 74 65 64   pages allocated
7cf0: 20 66 6f 72 20 74 68 65 20 63 61 63 68 65 20 69   for the cache i
7d00: 73 20 61 6c 72 65 61 64 79 20 0a 2a 2a 20 20 20  s already .**   
7d10: 20 20 20 20 20 20 20 20 50 43 61 63 68 65 31 2e          PCache1.
7d20: 6e 4d 61 78 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 20  nMax, or.**.**  
7d30: 20 20 20 20 20 28 62 29 20 54 68 65 20 6e 75 6d       (b) The num
7d40: 62 65 72 20 6f 66 20 70 61 67 65 73 20 61 6c 6c  ber of pages all
7d50: 6f 63 61 74 65 64 20 66 6f 72 20 61 6c 6c 20 70  ocated for all p
7d60: 75 72 67 65 61 62 6c 65 20 63 61 63 68 65 73 20  urgeable caches 
7d70: 69 73 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20  is.**           
7d80: 61 6c 72 65 61 64 79 20 65 71 75 61 6c 20 74 6f  already equal to
7d90: 20 6f 72 20 67 72 65 61 74 65 72 20 74 68 61 6e   or greater than
7da0: 20 74 68 65 20 73 75 6d 20 6f 66 20 6e 4d 61 78   the sum of nMax
7db0: 20 66 6f 72 20 61 6c 6c 0a 2a 2a 20 20 20 20 20   for all.**     
7dc0: 20 20 20 20 20 20 70 75 72 67 65 61 62 6c 65 20        purgeable 
7dd0: 63 61 63 68 65 73 2c 0a 2a 2a 0a 2a 2a 20 20 20  caches,.**.**   
7de0: 20 20 20 20 28 63 29 20 54 68 65 20 73 79 73 74      (c) The syst
7df0: 65 6d 20 69 73 20 75 6e 64 65 72 20 6d 65 6d 6f  em is under memo
7e00: 72 79 20 70 72 65 73 73 75 72 65 20 61 6e 64 20  ry pressure and 
7e10: 77 61 6e 74 73 20 74 6f 20 61 76 6f 69 64 0a 2a  wants to avoid.*
7e20: 2a 20 20 20 20 20 20 20 20 20 20 20 75 6e 6e 65  *           unne
7e30: 63 65 73 73 61 72 79 20 70 61 67 65 73 20 63 61  cessary pages ca
7e40: 63 68 65 20 65 6e 74 72 79 20 61 6c 6c 6f 63 61  che entry alloca
7e50: 74 69 6f 6e 73 0a 2a 2a 0a 2a 2a 20 20 20 20 20  tions.**.**     
7e60: 20 74 68 65 6e 20 61 74 74 65 6d 70 74 20 74 6f   then attempt to
7e70: 20 72 65 63 79 63 6c 65 20 61 20 70 61 67 65 20   recycle a page 
7e80: 66 72 6f 6d 20 74 68 65 20 4c 52 55 20 6c 69 73  from the LRU lis
7e90: 74 2e 20 49 66 20 69 74 20 69 73 20 74 68 65 20  t. If it is the 
7ea0: 72 69 67 68 74 0a 2a 2a 20 20 20 20 20 20 73 69  right.**      si
7eb0: 7a 65 2c 20 72 65 74 75 72 6e 20 74 68 65 20 72  ze, return the r
7ec0: 65 63 79 63 6c 65 64 20 62 75 66 66 65 72 2e 20  ecycled buffer. 
7ed0: 4f 74 68 65 72 77 69 73 65 2c 20 66 72 65 65 20  Otherwise, free 
7ee0: 74 68 65 20 62 75 66 66 65 72 20 61 6e 64 0a 2a  the buffer and.*
7ef0: 2a 20 20 20 20 20 20 70 72 6f 63 65 65 64 20 74  *      proceed t
7f00: 6f 20 73 74 65 70 20 35 2e 20 0a 2a 2a 0a 2a 2a  o step 5. .**.**
7f10: 20 20 20 35 2e 20 4f 74 68 65 72 77 69 73 65 2c     5. Otherwise,
7f20: 20 61 6c 6c 6f 63 61 74 65 20 61 6e 64 20 72 65   allocate and re
7f30: 74 75 72 6e 20 61 20 6e 65 77 20 70 61 67 65 20  turn a new page 
7f40: 62 75 66 66 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 68  buffer..**.** Th
7f50: 65 72 65 20 61 72 65 20 74 77 6f 20 76 65 72 73  ere are two vers
7f60: 69 6f 6e 73 20 6f 66 20 74 68 69 73 20 72 6f 75  ions of this rou
7f70: 74 69 6e 65 2e 20 20 70 63 61 63 68 65 31 46 65  tine.  pcache1Fe
7f80: 74 63 68 57 69 74 68 4d 75 74 65 78 28 29 20 69  tchWithMutex() i
7f90: 73 0a 2a 2a 20 74 68 65 20 67 65 6e 65 72 61 6c  s.** the general
7fa0: 20 63 61 73 65 2e 20 20 70 63 61 63 68 65 31 46   case.  pcache1F
7fb0: 65 74 63 68 4e 6f 4d 75 74 65 78 28 29 20 69 73  etchNoMutex() is
7fc0: 20 61 20 66 61 73 74 65 72 20 69 6d 70 6c 65 6d   a faster implem
7fd0: 65 6e 74 61 74 69 6f 6e 20 66 6f 72 0a 2a 2a 20  entation for.** 
7fe0: 74 68 65 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 20  the common case 
7ff0: 77 68 65 72 65 20 70 47 72 6f 75 70 2d 3e 6d 75  where pGroup->mu
8000: 74 65 78 20 69 73 20 4e 55 4c 4c 2e 20 20 54 68  tex is NULL.  Th
8010: 65 20 70 63 61 63 68 65 31 46 65 74 63 68 28 29  e pcache1Fetch()
8020: 20 77 72 61 70 70 65 72 0a 2a 2a 20 69 6e 76 6f   wrapper.** invo
8030: 6b 65 73 20 74 68 65 20 61 70 70 72 6f 70 72 69  kes the appropri
8040: 61 74 65 20 72 6f 75 74 69 6e 65 2e 0a 2a 2f 0a  ate routine..*/.
8050: 73 74 61 74 69 63 20 50 67 48 64 72 31 20 2a 70  static PgHdr1 *p
8060: 63 61 63 68 65 31 46 65 74 63 68 4e 6f 4d 75 74  cache1FetchNoMut
8070: 65 78 28 0a 20 20 73 71 6c 69 74 65 33 5f 70 63  ex(.  sqlite3_pc
8080: 61 63 68 65 20 2a 70 2c 20 0a 20 20 75 6e 73 69  ache *p, .  unsi
8090: 67 6e 65 64 20 69 6e 74 20 69 4b 65 79 2c 20 0a  gned int iKey, .
80a0: 20 20 69 6e 74 20 63 72 65 61 74 65 46 6c 61 67    int createFlag
80b0: 0a 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70  .){.  PCache1 *p
80c0: 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 65 31  Cache = (PCache1
80d0: 20 2a 29 70 3b 0a 20 20 50 67 48 64 72 31 20 2a   *)p;.  PgHdr1 *
80e0: 70 50 61 67 65 20 3d 20 30 3b 0a 0a 20 20 2f 2a  pPage = 0;..  /*
80f0: 20 53 74 65 70 20 31 3a 20 53 65 61 72 63 68 20   Step 1: Search 
8100: 74 68 65 20 68 61 73 68 20 74 61 62 6c 65 20 66  the hash table f
8110: 6f 72 20 61 6e 20 65 78 69 73 74 69 6e 67 20 65  or an existing e
8120: 6e 74 72 79 2e 20 2a 2f 0a 20 20 70 50 61 67 65  ntry. */.  pPage
8130: 20 3d 20 70 43 61 63 68 65 2d 3e 61 70 48 61 73   = pCache->apHas
8140: 68 5b 69 4b 65 79 20 25 20 70 43 61 63 68 65 2d  h[iKey % pCache-
8150: 3e 6e 48 61 73 68 5d 3b 0a 20 20 77 68 69 6c 65  >nHash];.  while
8160: 28 20 70 50 61 67 65 20 26 26 20 70 50 61 67 65  ( pPage && pPage
8170: 2d 3e 69 4b 65 79 21 3d 69 4b 65 79 20 29 7b 20  ->iKey!=iKey ){ 
8180: 70 50 61 67 65 20 3d 20 70 50 61 67 65 2d 3e 70  pPage = pPage->p
8190: 4e 65 78 74 3b 20 7d 0a 0a 20 20 2f 2a 20 53 74  Next; }..  /* St
81a0: 65 70 20 32 3a 20 41 62 6f 72 74 20 69 66 20 6e  ep 2: Abort if n
81b0: 6f 20 65 78 69 73 74 69 6e 67 20 70 61 67 65 20  o existing page 
81c0: 69 73 20 66 6f 75 6e 64 20 61 6e 64 20 63 72 65  is found and cre
81d0: 61 74 65 46 6c 61 67 20 69 73 20 30 20 2a 2f 0a  ateFlag is 0 */.
81e0: 20 20 69 66 28 20 70 50 61 67 65 20 29 7b 0a 20    if( pPage ){. 
81f0: 20 20 20 69 66 28 20 21 70 50 61 67 65 2d 3e 69     if( !pPage->i
8200: 73 50 69 6e 6e 65 64 20 29 7b 0a 20 20 20 20 20  sPinned ){.     
8210: 20 72 65 74 75 72 6e 20 70 63 61 63 68 65 31 50   return pcache1P
8220: 69 6e 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20  inPage(pPage);. 
8230: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
8240: 72 65 74 75 72 6e 20 70 50 61 67 65 3b 0a 20 20  return pPage;.  
8250: 20 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 20    }.  }else if( 
8260: 63 72 65 61 74 65 46 6c 61 67 20 29 7b 0a 20 20  createFlag ){.  
8270: 20 20 2f 2a 20 53 74 65 70 73 20 33 2c 20 34 2c    /* Steps 3, 4,
8280: 20 61 6e 64 20 35 20 69 6d 70 6c 65 6d 65 6e 74   and 5 implement
8290: 65 64 20 62 79 20 74 68 69 73 20 73 75 62 72 6f  ed by this subro
82a0: 75 74 69 6e 65 20 2a 2f 0a 20 20 20 20 72 65 74  utine */.    ret
82b0: 75 72 6e 20 70 63 61 63 68 65 31 46 65 74 63 68  urn pcache1Fetch
82c0: 53 74 61 67 65 32 28 70 43 61 63 68 65 2c 20 69  Stage2(pCache, i
82d0: 4b 65 79 2c 20 63 72 65 61 74 65 46 6c 61 67 29  Key, createFlag)
82e0: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72  ;.  }else{.    r
82f0: 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 7d 0a 23  eturn 0;.  }.}.#
8300: 69 66 20 50 43 41 43 48 45 31 5f 4d 49 47 48 54  if PCACHE1_MIGHT
8310: 5f 55 53 45 5f 47 52 4f 55 50 5f 4d 55 54 45 58  _USE_GROUP_MUTEX
8320: 0a 73 74 61 74 69 63 20 50 67 48 64 72 31 20 2a  .static PgHdr1 *
8330: 70 63 61 63 68 65 31 46 65 74 63 68 57 69 74 68  pcache1FetchWith
8340: 4d 75 74 65 78 28 0a 20 20 73 71 6c 69 74 65 33  Mutex(.  sqlite3
8350: 5f 70 63 61 63 68 65 20 2a 70 2c 20 0a 20 20 75  _pcache *p, .  u
8360: 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4b 65 79  nsigned int iKey
8370: 2c 20 0a 20 20 69 6e 74 20 63 72 65 61 74 65 46  , .  int createF
8380: 6c 61 67 0a 29 7b 0a 20 20 50 43 61 63 68 65 31  lag.){.  PCache1
8390: 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61 63   *pCache = (PCac
83a0: 68 65 31 20 2a 29 70 3b 0a 20 20 50 67 48 64 72  he1 *)p;.  PgHdr
83b0: 31 20 2a 70 50 61 67 65 3b 0a 0a 20 20 70 63 61  1 *pPage;..  pca
83c0: 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70  che1EnterMutex(p
83d0: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a  Cache->pGroup);.
83e0: 20 20 70 50 61 67 65 20 3d 20 70 63 61 63 68 65    pPage = pcache
83f0: 31 46 65 74 63 68 4e 6f 4d 75 74 65 78 28 70 2c  1FetchNoMutex(p,
8400: 20 69 4b 65 79 2c 20 63 72 65 61 74 65 46 6c 61   iKey, createFla
8410: 67 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50  g);.  assert( pP
8420: 61 67 65 3d 3d 30 20 7c 7c 20 70 43 61 63 68 65  age==0 || pCache
8430: 2d 3e 69 4d 61 78 4b 65 79 3e 3d 69 4b 65 79 20  ->iMaxKey>=iKey 
8440: 29 3b 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76  );.  pcache1Leav
8450: 65 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70  eMutex(pCache->p
8460: 47 72 6f 75 70 29 3b 0a 20 20 72 65 74 75 72 6e  Group);.  return
8470: 20 70 50 61 67 65 3b 0a 7d 0a 23 65 6e 64 69 66   pPage;.}.#endif
8480: 0a 73 74 61 74 69 63 20 73 71 6c 69 74 65 33 5f  .static sqlite3_
8490: 70 63 61 63 68 65 5f 70 61 67 65 20 2a 70 63 61  pcache_page *pca
84a0: 63 68 65 31 46 65 74 63 68 28 0a 20 20 73 71 6c  che1Fetch(.  sql
84b0: 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 2c 20  ite3_pcache *p, 
84c0: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
84d0: 69 4b 65 79 2c 20 0a 20 20 69 6e 74 20 63 72 65  iKey, .  int cre
84e0: 61 74 65 46 6c 61 67 0a 29 7b 0a 23 69 66 20 50  ateFlag.){.#if P
84f0: 43 41 43 48 45 31 5f 4d 49 47 48 54 5f 55 53 45  CACHE1_MIGHT_USE
8500: 5f 47 52 4f 55 50 5f 4d 55 54 45 58 20 7c 7c 20  _GROUP_MUTEX || 
8510: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44  defined(SQLITE_D
8520: 45 42 55 47 29 0a 20 20 50 43 61 63 68 65 31 20  EBUG).  PCache1 
8530: 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61 63 68  *pCache = (PCach
8540: 65 31 20 2a 29 70 3b 0a 23 65 6e 64 69 66 0a 0a  e1 *)p;.#endif..
8550: 20 20 61 73 73 65 72 74 28 20 6f 66 66 73 65 74    assert( offset
8560: 6f 66 28 50 67 48 64 72 31 2c 70 61 67 65 29 3d  of(PgHdr1,page)=
8570: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  =0 );.  assert( 
8580: 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62  pCache->bPurgeab
8590: 6c 65 20 7c 7c 20 63 72 65 61 74 65 46 6c 61 67  le || createFlag
85a0: 21 3d 31 20 29 3b 0a 20 20 61 73 73 65 72 74 28  !=1 );.  assert(
85b0: 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61   pCache->bPurgea
85c0: 62 6c 65 20 7c 7c 20 70 43 61 63 68 65 2d 3e 6e  ble || pCache->n
85d0: 4d 69 6e 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65  Min==0 );.  asse
85e0: 72 74 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72  rt( pCache->bPur
85f0: 67 65 61 62 6c 65 3d 3d 30 20 7c 7c 20 70 43 61  geable==0 || pCa
8600: 63 68 65 2d 3e 6e 4d 69 6e 3d 3d 31 30 20 29 3b  che->nMin==10 );
8610: 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68  .  assert( pCach
8620: 65 2d 3e 6e 4d 69 6e 3d 3d 30 20 7c 7c 20 70 43  e->nMin==0 || pC
8630: 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65  ache->bPurgeable
8640: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43   );.  assert( pC
8650: 61 63 68 65 2d 3e 6e 48 61 73 68 3e 30 20 29 3b  ache->nHash>0 );
8660: 0a 23 69 66 20 50 43 41 43 48 45 31 5f 4d 49 47  .#if PCACHE1_MIG
8670: 48 54 5f 55 53 45 5f 47 52 4f 55 50 5f 4d 55 54  HT_USE_GROUP_MUT
8680: 45 58 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d  EX.  if( pCache-
8690: 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 20 29  >pGroup->mutex )
86a0: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 28 73 71  {.    return (sq
86b0: 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 70 61 67  lite3_pcache_pag
86c0: 65 2a 29 70 63 61 63 68 65 31 46 65 74 63 68 57  e*)pcache1FetchW
86d0: 69 74 68 4d 75 74 65 78 28 70 2c 20 69 4b 65 79  ithMutex(p, iKey
86e0: 2c 20 63 72 65 61 74 65 46 6c 61 67 29 3b 0a 20  , createFlag);. 
86f0: 20 7d 65 6c 73 65 0a 23 65 6e 64 69 66 0a 20 20   }else.#endif.  
8700: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 28 73 71  {.    return (sq
8710: 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 70 61 67  lite3_pcache_pag
8720: 65 2a 29 70 63 61 63 68 65 31 46 65 74 63 68 4e  e*)pcache1FetchN
8730: 6f 4d 75 74 65 78 28 70 2c 20 69 4b 65 79 2c 20  oMutex(p, iKey, 
8740: 63 72 65 61 74 65 46 6c 61 67 29 3b 0a 20 20 7d  createFlag);.  }
8750: 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65  .}.../*.** Imple
8760: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65  mentation of the
8770: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e   sqlite3_pcache.
8780: 78 55 6e 70 69 6e 20 6d 65 74 68 6f 64 2e 0a 2a  xUnpin method..*
8790: 2a 0a 2a 2a 20 4d 61 72 6b 20 61 20 70 61 67 65  *.** Mark a page
87a0: 20 61 73 20 75 6e 70 69 6e 6e 65 64 20 28 65 6c   as unpinned (el
87b0: 69 67 69 62 6c 65 20 66 6f 72 20 61 73 79 6e 63  igible for async
87c0: 68 72 6f 6e 6f 75 73 20 72 65 63 79 63 6c 69 6e  hronous recyclin
87d0: 67 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  g)..*/.static vo
87e0: 69 64 20 70 63 61 63 68 65 31 55 6e 70 69 6e 28  id pcache1Unpin(
87f0: 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68  .  sqlite3_pcach
8800: 65 20 2a 70 2c 20 0a 20 20 73 71 6c 69 74 65 33  e *p, .  sqlite3
8810: 5f 70 63 61 63 68 65 5f 70 61 67 65 20 2a 70 50  _pcache_page *pP
8820: 67 2c 20 0a 20 20 69 6e 74 20 72 65 75 73 65 55  g, .  int reuseU
8830: 6e 6c 69 6b 65 6c 79 0a 29 7b 0a 20 20 50 43 61  nlikely.){.  PCa
8840: 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28  che1 *pCache = (
8850: 50 43 61 63 68 65 31 20 2a 29 70 3b 0a 20 20 50  PCache1 *)p;.  P
8860: 67 48 64 72 31 20 2a 70 50 61 67 65 20 3d 20 28  gHdr1 *pPage = (
8870: 50 67 48 64 72 31 20 2a 29 70 50 67 3b 0a 20 20  PgHdr1 *)pPg;.  
8880: 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70 20 3d  PGroup *pGroup =
8890: 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3b   pCache->pGroup;
88a0: 0a 20 0a 20 20 61 73 73 65 72 74 28 20 70 50 61  . .  assert( pPa
88b0: 67 65 2d 3e 70 43 61 63 68 65 3d 3d 70 43 61 63  ge->pCache==pCac
88c0: 68 65 20 29 3b 0a 20 20 70 63 61 63 68 65 31 45  he );.  pcache1E
88d0: 6e 74 65 72 4d 75 74 65 78 28 70 47 72 6f 75 70  nterMutex(pGroup
88e0: 29 3b 0a 0a 20 20 2f 2a 20 49 74 20 69 73 20 61  );..  /* It is a
88f0: 6e 20 65 72 72 6f 72 20 74 6f 20 63 61 6c 6c 20  n error to call 
8900: 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 66  this function if
8910: 20 74 68 65 20 70 61 67 65 20 69 73 20 61 6c 72   the page is alr
8920: 65 61 64 79 20 0a 20 20 2a 2a 20 70 61 72 74 20  eady .  ** part 
8930: 6f 66 20 74 68 65 20 50 47 72 6f 75 70 20 4c 52  of the PGroup LR
8940: 55 20 6c 69 73 74 2e 0a 20 20 2a 2f 0a 20 20 61  U list..  */.  a
8950: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 4c  ssert( pPage->pL
8960: 72 75 50 72 65 76 3d 3d 30 20 26 26 20 70 50 61  ruPrev==0 && pPa
8970: 67 65 2d 3e 70 4c 72 75 4e 65 78 74 3d 3d 30 20  ge->pLruNext==0 
8980: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 47 72  );.  assert( pGr
8990: 6f 75 70 2d 3e 70 4c 72 75 48 65 61 64 21 3d 70  oup->pLruHead!=p
89a0: 50 61 67 65 20 26 26 20 70 47 72 6f 75 70 2d 3e  Page && pGroup->
89b0: 70 4c 72 75 54 61 69 6c 21 3d 70 50 61 67 65 20  pLruTail!=pPage 
89c0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61  );.  assert( pPa
89d0: 67 65 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d 31 20  ge->isPinned==1 
89e0: 29 3b 0a 0a 20 20 69 66 28 20 72 65 75 73 65 55  );..  if( reuseU
89f0: 6e 6c 69 6b 65 6c 79 20 7c 7c 20 70 47 72 6f 75  nlikely || pGrou
8a00: 70 2d 3e 6e 43 75 72 72 65 6e 74 50 61 67 65 3e  p->nCurrentPage>
8a10: 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65  pGroup->nMaxPage
8a20: 20 29 7b 0a 20 20 20 20 70 63 61 63 68 65 31 52   ){.    pcache1R
8a30: 65 6d 6f 76 65 46 72 6f 6d 48 61 73 68 28 70 50  emoveFromHash(pP
8a40: 61 67 65 2c 20 31 29 3b 0a 20 20 7d 65 6c 73 65  age, 1);.  }else
8a50: 7b 0a 20 20 20 20 2f 2a 20 41 64 64 20 74 68 65  {.    /* Add the
8a60: 20 70 61 67 65 20 74 6f 20 74 68 65 20 50 47 72   page to the PGr
8a70: 6f 75 70 20 4c 52 55 20 6c 69 73 74 2e 20 2a 2f  oup LRU list. */
8a80: 0a 20 20 20 20 69 66 28 20 70 47 72 6f 75 70 2d  .    if( pGroup-
8a90: 3e 70 4c 72 75 48 65 61 64 20 29 7b 0a 20 20 20  >pLruHead ){.   
8aa0: 20 20 20 70 47 72 6f 75 70 2d 3e 70 4c 72 75 48     pGroup->pLruH
8ab0: 65 61 64 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20  ead->pLruPrev = 
8ac0: 70 50 61 67 65 3b 0a 20 20 20 20 20 20 70 50 61  pPage;.      pPa
8ad0: 67 65 2d 3e 70 4c 72 75 4e 65 78 74 20 3d 20 70  ge->pLruNext = p
8ae0: 47 72 6f 75 70 2d 3e 70 4c 72 75 48 65 61 64 3b  Group->pLruHead;
8af0: 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e 70  .      pGroup->p
8b00: 4c 72 75 48 65 61 64 20 3d 20 70 50 61 67 65 3b  LruHead = pPage;
8b10: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  .    }else{.    
8b20: 20 20 70 47 72 6f 75 70 2d 3e 70 4c 72 75 54 61    pGroup->pLruTa
8b30: 69 6c 20 3d 20 70 50 61 67 65 3b 0a 20 20 20 20  il = pPage;.    
8b40: 20 20 70 47 72 6f 75 70 2d 3e 70 4c 72 75 48 65    pGroup->pLruHe
8b50: 61 64 20 3d 20 70 50 61 67 65 3b 0a 20 20 20 20  ad = pPage;.    
8b60: 7d 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 52  }.    pCache->nR
8b70: 65 63 79 63 6c 61 62 6c 65 2b 2b 3b 0a 20 20 20  ecyclable++;.   
8b80: 20 70 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64   pPage->isPinned
8b90: 20 3d 20 30 3b 0a 20 20 7d 0a 0a 20 20 70 63 61   = 0;.  }..  pca
8ba0: 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70  che1LeaveMutex(p
8bb0: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a  Cache->pGroup);.
8bc0: 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65  }../*.** Impleme
8bd0: 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73  ntation of the s
8be0: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78 52  qlite3_pcache.xR
8bf0: 65 6b 65 79 20 6d 65 74 68 6f 64 2e 20 0a 2a 2f  ekey method. .*/
8c00: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61  .static void pca
8c10: 63 68 65 31 52 65 6b 65 79 28 0a 20 20 73 71 6c  che1Rekey(.  sql
8c20: 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 2c 0a  ite3_pcache *p,.
8c30: 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65    sqlite3_pcache
8c40: 5f 70 61 67 65 20 2a 70 50 67 2c 0a 20 20 75 6e  _page *pPg,.  un
8c50: 73 69 67 6e 65 64 20 69 6e 74 20 69 4f 6c 64 2c  signed int iOld,
8c60: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
8c70: 69 4e 65 77 0a 29 7b 0a 20 20 50 43 61 63 68 65  iNew.){.  PCache
8c80: 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61  1 *pCache = (PCa
8c90: 63 68 65 31 20 2a 29 70 3b 0a 20 20 50 67 48 64  che1 *)p;.  PgHd
8ca0: 72 31 20 2a 70 50 61 67 65 20 3d 20 28 50 67 48  r1 *pPage = (PgH
8cb0: 64 72 31 20 2a 29 70 50 67 3b 0a 20 20 50 67 48  dr1 *)pPg;.  PgH
8cc0: 64 72 31 20 2a 2a 70 70 3b 0a 20 20 75 6e 73 69  dr1 **pp;.  unsi
8cd0: 67 6e 65 64 20 69 6e 74 20 68 3b 20 0a 20 20 61  gned int h; .  a
8ce0: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 69 4b  ssert( pPage->iK
8cf0: 65 79 3d 3d 69 4f 6c 64 20 29 3b 0a 20 20 61 73  ey==iOld );.  as
8d00: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 43 61  sert( pPage->pCa
8d10: 63 68 65 3d 3d 70 43 61 63 68 65 20 29 3b 0a 0a  che==pCache );..
8d20: 20 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75    pcache1EnterMu
8d30: 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f  tex(pCache->pGro
8d40: 75 70 29 3b 0a 0a 20 20 68 20 3d 20 69 4f 6c 64  up);..  h = iOld
8d50: 25 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a  %pCache->nHash;.
8d60: 20 20 70 70 20 3d 20 26 70 43 61 63 68 65 2d 3e    pp = &pCache->
8d70: 61 70 48 61 73 68 5b 68 5d 3b 0a 20 20 77 68 69  apHash[h];.  whi
8d80: 6c 65 28 20 28 2a 70 70 29 21 3d 70 50 61 67 65  le( (*pp)!=pPage
8d90: 20 29 7b 0a 20 20 20 20 70 70 20 3d 20 26 28 2a   ){.    pp = &(*
8da0: 70 70 29 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d 0a  pp)->pNext;.  }.
8db0: 20 20 2a 70 70 20 3d 20 70 50 61 67 65 2d 3e 70    *pp = pPage->p
8dc0: 4e 65 78 74 3b 0a 0a 20 20 68 20 3d 20 69 4e 65  Next;..  h = iNe
8dd0: 77 25 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b  w%pCache->nHash;
8de0: 0a 20 20 70 50 61 67 65 2d 3e 69 4b 65 79 20 3d  .  pPage->iKey =
8df0: 20 69 4e 65 77 3b 0a 20 20 70 50 61 67 65 2d 3e   iNew;.  pPage->
8e00: 70 4e 65 78 74 20 3d 20 70 43 61 63 68 65 2d 3e  pNext = pCache->
8e10: 61 70 48 61 73 68 5b 68 5d 3b 0a 20 20 70 43 61  apHash[h];.  pCa
8e20: 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 20 3d  che->apHash[h] =
8e30: 20 70 50 61 67 65 3b 0a 20 20 69 66 28 20 69 4e   pPage;.  if( iN
8e40: 65 77 3e 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b  ew>pCache->iMaxK
8e50: 65 79 20 29 7b 0a 20 20 20 20 70 43 61 63 68 65  ey ){.    pCache
8e60: 2d 3e 69 4d 61 78 4b 65 79 20 3d 20 69 4e 65 77  ->iMaxKey = iNew
8e70: 3b 0a 20 20 7d 0a 0a 20 20 70 63 61 63 68 65 31  ;.  }..  pcache1
8e80: 4c 65 61 76 65 4d 75 74 65 78 28 70 43 61 63 68  LeaveMutex(pCach
8e90: 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 7d 0a 0a 2f  e->pGroup);.}../
8ea0: 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74  *.** Implementat
8eb0: 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74  ion of the sqlit
8ec0: 65 33 5f 70 63 61 63 68 65 2e 78 54 72 75 6e 63  e3_pcache.xTrunc
8ed0: 61 74 65 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a  ate method. .**.
8ee0: 2a 2a 20 44 69 73 63 61 72 64 20 61 6c 6c 20 75  ** Discard all u
8ef0: 6e 70 69 6e 6e 65 64 20 70 61 67 65 73 20 69 6e  npinned pages in
8f00: 20 74 68 65 20 63 61 63 68 65 20 77 69 74 68 20   the cache with 
8f10: 61 20 70 61 67 65 20 6e 75 6d 62 65 72 20 65 71  a page number eq
8f20: 75 61 6c 20 74 6f 0a 2a 2a 20 6f 72 20 67 72 65  ual to.** or gre
8f30: 61 74 65 72 20 74 68 61 6e 20 70 61 72 61 6d 65  ater than parame
8f40: 74 65 72 20 69 4c 69 6d 69 74 2e 20 41 6e 79 20  ter iLimit. Any 
8f50: 70 69 6e 6e 65 64 20 70 61 67 65 73 20 77 69 74  pinned pages wit
8f60: 68 20 61 20 70 61 67 65 20 6e 75 6d 62 65 72 0a  h a page number.
8f70: 2a 2a 20 65 71 75 61 6c 20 74 6f 20 6f 72 20 67  ** equal to or g
8f80: 72 65 61 74 65 72 20 74 68 61 6e 20 69 4c 69 6d  reater than iLim
8f90: 69 74 20 61 72 65 20 69 6d 70 6c 69 63 69 74 6c  it are implicitl
8fa0: 79 20 75 6e 70 69 6e 6e 65 64 2e 0a 2a 2f 0a 73  y unpinned..*/.s
8fb0: 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68  tatic void pcach
8fc0: 65 31 54 72 75 6e 63 61 74 65 28 73 71 6c 69 74  e1Truncate(sqlit
8fd0: 65 33 5f 70 63 61 63 68 65 20 2a 70 2c 20 75 6e  e3_pcache *p, un
8fe0: 73 69 67 6e 65 64 20 69 6e 74 20 69 4c 69 6d 69  signed int iLimi
8ff0: 74 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70  t){.  PCache1 *p
9000: 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 65 31  Cache = (PCache1
9010: 20 2a 29 70 3b 0a 20 20 70 63 61 63 68 65 31 45   *)p;.  pcache1E
9020: 6e 74 65 72 4d 75 74 65 78 28 70 43 61 63 68 65  nterMutex(pCache
9030: 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20 69 66 28  ->pGroup);.  if(
9040: 20 69 4c 69 6d 69 74 3c 3d 70 43 61 63 68 65 2d   iLimit<=pCache-
9050: 3e 69 4d 61 78 4b 65 79 20 29 7b 0a 20 20 20 20  >iMaxKey ){.    
9060: 70 63 61 63 68 65 31 54 72 75 6e 63 61 74 65 55  pcache1TruncateU
9070: 6e 73 61 66 65 28 70 43 61 63 68 65 2c 20 69 4c  nsafe(pCache, iL
9080: 69 6d 69 74 29 3b 0a 20 20 20 20 70 43 61 63 68  imit);.    pCach
9090: 65 2d 3e 69 4d 61 78 4b 65 79 20 3d 20 69 4c 69  e->iMaxKey = iLi
90a0: 6d 69 74 2d 31 3b 0a 20 20 7d 0a 20 20 70 63 61  mit-1;.  }.  pca
90b0: 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70  che1LeaveMutex(p
90c0: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a  Cache->pGroup);.
90d0: 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65  }../*.** Impleme
90e0: 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73  ntation of the s
90f0: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78 44  qlite3_pcache.xD
9100: 65 73 74 72 6f 79 20 6d 65 74 68 6f 64 2e 20 0a  estroy method. .
9110: 2a 2a 0a 2a 2a 20 44 65 73 74 72 6f 79 20 61 20  **.** Destroy a 
9120: 63 61 63 68 65 20 61 6c 6c 6f 63 61 74 65 64 20  cache allocated 
9130: 75 73 69 6e 67 20 70 63 61 63 68 65 31 43 72 65  using pcache1Cre
9140: 61 74 65 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 63  ate()..*/.static
9150: 20 76 6f 69 64 20 70 63 61 63 68 65 31 44 65 73   void pcache1Des
9160: 74 72 6f 79 28 73 71 6c 69 74 65 33 5f 70 63 61  troy(sqlite3_pca
9170: 63 68 65 20 2a 70 29 7b 0a 20 20 50 43 61 63 68  che *p){.  PCach
9180: 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43  e1 *pCache = (PC
9190: 61 63 68 65 31 20 2a 29 70 3b 0a 20 20 50 47 72  ache1 *)p;.  PGr
91a0: 6f 75 70 20 2a 70 47 72 6f 75 70 20 3d 20 70 43  oup *pGroup = pC
91b0: 61 63 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20 20  ache->pGroup;.  
91c0: 61 73 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e  assert( pCache->
91d0: 62 50 75 72 67 65 61 62 6c 65 20 7c 7c 20 28 70  bPurgeable || (p
91e0: 43 61 63 68 65 2d 3e 6e 4d 61 78 3d 3d 30 20 26  Cache->nMax==0 &
91f0: 26 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 3d 3d  & pCache->nMin==
9200: 30 29 20 29 3b 0a 20 20 70 63 61 63 68 65 31 45  0) );.  pcache1E
9210: 6e 74 65 72 4d 75 74 65 78 28 70 47 72 6f 75 70  nterMutex(pGroup
9220: 29 3b 0a 20 20 70 63 61 63 68 65 31 54 72 75 6e  );.  pcache1Trun
9230: 63 61 74 65 55 6e 73 61 66 65 28 70 43 61 63 68  cateUnsafe(pCach
9240: 65 2c 20 30 29 3b 0a 20 20 61 73 73 65 72 74 28  e, 0);.  assert(
9250: 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67   pGroup->nMaxPag
9260: 65 20 3e 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 61  e >= pCache->nMa
9270: 78 20 29 3b 0a 20 20 70 47 72 6f 75 70 2d 3e 6e  x );.  pGroup->n
9280: 4d 61 78 50 61 67 65 20 2d 3d 20 70 43 61 63 68  MaxPage -= pCach
9290: 65 2d 3e 6e 4d 61 78 3b 0a 20 20 61 73 73 65 72  e->nMax;.  asser
92a0: 74 28 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50  t( pGroup->nMinP
92b0: 61 67 65 20 3e 3d 20 70 43 61 63 68 65 2d 3e 6e  age >= pCache->n
92c0: 4d 69 6e 20 29 3b 0a 20 20 70 47 72 6f 75 70 2d  Min );.  pGroup-
92d0: 3e 6e 4d 69 6e 50 61 67 65 20 2d 3d 20 70 43 61  >nMinPage -= pCa
92e0: 63 68 65 2d 3e 6e 4d 69 6e 3b 0a 20 20 70 47 72  che->nMin;.  pGr
92f0: 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 20  oup->mxPinned = 
9300: 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65  pGroup->nMaxPage
9310: 20 2b 20 31 30 20 2d 20 70 47 72 6f 75 70 2d 3e   + 10 - pGroup->
9320: 6e 4d 69 6e 50 61 67 65 3b 0a 20 20 70 63 61 63  nMinPage;.  pcac
9330: 68 65 31 45 6e 66 6f 72 63 65 4d 61 78 50 61 67  he1EnforceMaxPag
9340: 65 28 70 43 61 63 68 65 29 3b 0a 20 20 70 63 61  e(pCache);.  pca
9350: 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70  che1LeaveMutex(p
9360: 47 72 6f 75 70 29 3b 0a 20 20 73 71 6c 69 74 65  Group);.  sqlite
9370: 33 5f 66 72 65 65 28 70 43 61 63 68 65 2d 3e 70  3_free(pCache->p
9380: 42 75 6c 6b 29 3b 0a 20 20 73 71 6c 69 74 65 33  Bulk);.  sqlite3
9390: 5f 66 72 65 65 28 70 43 61 63 68 65 2d 3e 61 70  _free(pCache->ap
93a0: 48 61 73 68 29 3b 0a 20 20 73 71 6c 69 74 65 33  Hash);.  sqlite3
93b0: 5f 66 72 65 65 28 70 43 61 63 68 65 29 3b 0a 7d  _free(pCache);.}
93c0: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e  ../*.** This fun
93d0: 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20  ction is called 
93e0: 64 75 72 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a  during initializ
93f0: 61 74 69 6f 6e 20 28 73 71 6c 69 74 65 33 5f 69  ation (sqlite3_i
9400: 6e 69 74 69 61 6c 69 7a 65 28 29 29 20 74 6f 0a  nitialize()) to.
9410: 2a 2a 20 69 6e 73 74 61 6c 6c 20 74 68 65 20 64  ** install the d
9420: 65 66 61 75 6c 74 20 70 6c 75 67 67 61 62 6c 65  efault pluggable
9430: 20 63 61 63 68 65 20 6d 6f 64 75 6c 65 2c 20 61   cache module, a
9440: 73 73 75 6d 69 6e 67 20 74 68 65 20 75 73 65 72  ssuming the user
9450: 20 68 61 73 20 6e 6f 74 0a 2a 2a 20 61 6c 72 65   has not.** alre
9460: 61 64 79 20 70 72 6f 76 69 64 65 64 20 61 6e 20  ady provided an 
9470: 61 6c 74 65 72 6e 61 74 69 76 65 2e 0a 2a 2f 0a  alternative..*/.
9480: 76 6f 69 64 20 73 71 6c 69 74 65 33 50 43 61 63  void sqlite3PCac
9490: 68 65 53 65 74 44 65 66 61 75 6c 74 28 76 6f 69  heSetDefault(voi
94a0: 64 29 7b 0a 20 20 73 74 61 74 69 63 20 63 6f 6e  d){.  static con
94b0: 73 74 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68  st sqlite3_pcach
94c0: 65 5f 6d 65 74 68 6f 64 73 32 20 64 65 66 61 75  e_methods2 defau
94d0: 6c 74 4d 65 74 68 6f 64 73 20 3d 20 7b 0a 20 20  ltMethods = {.  
94e0: 20 20 31 2c 20 20 20 20 20 20 20 20 20 20 20 20    1,            
94f0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 69 56             /* iV
9500: 65 72 73 69 6f 6e 20 2a 2f 0a 20 20 20 20 30 2c  ersion */.    0,
9510: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
9520: 20 20 20 20 20 20 20 2f 2a 20 70 41 72 67 20 2a         /* pArg *
9530: 2f 0a 20 20 20 20 70 63 61 63 68 65 31 49 6e 69  /.    pcache1Ini
9540: 74 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  t,             /
9550: 2a 20 78 49 6e 69 74 20 2a 2f 0a 20 20 20 20 70  * xInit */.    p
9560: 63 61 63 68 65 31 53 68 75 74 64 6f 77 6e 2c 20  cache1Shutdown, 
9570: 20 20 20 20 20 20 20 20 2f 2a 20 78 53 68 75 74          /* xShut
9580: 64 6f 77 6e 20 2a 2f 0a 20 20 20 20 70 63 61 63  down */.    pcac
9590: 68 65 31 43 72 65 61 74 65 2c 20 20 20 20 20 20  he1Create,      
95a0: 20 20 20 20 20 2f 2a 20 78 43 72 65 61 74 65 20       /* xCreate 
95b0: 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 43 61  */.    pcache1Ca
95c0: 63 68 65 73 69 7a 65 2c 20 20 20 20 20 20 20 20  chesize,        
95d0: 2f 2a 20 78 43 61 63 68 65 73 69 7a 65 20 2a 2f  /* xCachesize */
95e0: 0a 20 20 20 20 70 63 61 63 68 65 31 50 61 67 65  .    pcache1Page
95f0: 63 6f 75 6e 74 2c 20 20 20 20 20 20 20 20 2f 2a  count,        /*
9600: 20 78 50 61 67 65 63 6f 75 6e 74 20 2a 2f 0a 20   xPagecount */. 
9610: 20 20 20 70 63 61 63 68 65 31 46 65 74 63 68 2c     pcache1Fetch,
9620: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78              /* x
9630: 46 65 74 63 68 20 2a 2f 0a 20 20 20 20 70 63 61  Fetch */.    pca
9640: 63 68 65 31 55 6e 70 69 6e 2c 20 20 20 20 20 20  che1Unpin,      
9650: 20 20 20 20 20 20 2f 2a 20 78 55 6e 70 69 6e 20        /* xUnpin 
9660: 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 52 65  */.    pcache1Re
9670: 6b 65 79 2c 20 20 20 20 20 20 20 20 20 20 20 20  key,            
9680: 2f 2a 20 78 52 65 6b 65 79 20 2a 2f 0a 20 20 20  /* xRekey */.   
9690: 20 70 63 61 63 68 65 31 54 72 75 6e 63 61 74 65   pcache1Truncate
96a0: 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 78 54 72  ,         /* xTr
96b0: 75 6e 63 61 74 65 20 2a 2f 0a 20 20 20 20 70 63  uncate */.    pc
96c0: 61 63 68 65 31 44 65 73 74 72 6f 79 2c 20 20 20  ache1Destroy,   
96d0: 20 20 20 20 20 20 20 2f 2a 20 78 44 65 73 74 72         /* xDestr
96e0: 6f 79 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65  oy */.    pcache
96f0: 31 53 68 72 69 6e 6b 20 20 20 20 20 20 20 20 20  1Shrink         
9700: 20 20 20 2f 2a 20 78 53 68 72 69 6e 6b 20 2a 2f     /* xShrink */
9710: 0a 20 20 7d 3b 0a 20 20 73 71 6c 69 74 65 33 5f  .  };.  sqlite3_
9720: 63 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f 43 4f  config(SQLITE_CO
9730: 4e 46 49 47 5f 50 43 41 43 48 45 32 2c 20 26 64  NFIG_PCACHE2, &d
9740: 65 66 61 75 6c 74 4d 65 74 68 6f 64 73 29 3b 0a  efaultMethods);.
9750: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
9760: 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20  the size of the 
9770: 68 65 61 64 65 72 20 6f 6e 20 65 61 63 68 20 70  header on each p
9780: 61 67 65 20 6f 66 20 74 68 69 73 20 50 43 41 43  age of this PCAC
9790: 48 45 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  HE implementatio
97a0: 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  n..*/.int sqlite
97b0: 33 48 65 61 64 65 72 53 69 7a 65 50 63 61 63 68  3HeaderSizePcach
97c0: 65 31 28 76 6f 69 64 29 7b 20 72 65 74 75 72 6e  e1(void){ return
97d0: 20 52 4f 55 4e 44 38 28 73 69 7a 65 6f 66 28 50   ROUND8(sizeof(P
97e0: 67 48 64 72 31 29 29 3b 20 7d 0a 0a 2f 2a 0a 2a  gHdr1)); }../*.*
97f0: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 67 6c 6f  * Return the glo
9800: 62 61 6c 20 6d 75 74 65 78 20 75 73 65 64 20 62  bal mutex used b
9810: 79 20 74 68 69 73 20 50 43 41 43 48 45 20 69 6d  y this PCACHE im
9820: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 20 20 54  plementation.  T
9830: 68 65 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 73 74  he.** sqlite3_st
9840: 61 74 75 73 28 29 20 72 6f 75 74 69 6e 65 20 6e  atus() routine n
9850: 65 65 64 73 20 61 63 63 65 73 73 20 74 6f 20 74  eeds access to t
9860: 68 69 73 20 6d 75 74 65 78 2e 0a 2a 2f 0a 73 71  his mutex..*/.sq
9870: 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 73 71 6c  lite3_mutex *sql
9880: 69 74 65 33 50 63 61 63 68 65 31 4d 75 74 65 78  ite3Pcache1Mutex
9890: 28 76 6f 69 64 29 7b 0a 20 20 72 65 74 75 72 6e  (void){.  return
98a0: 20 70 63 61 63 68 65 31 2e 6d 75 74 65 78 3b 0a   pcache1.mutex;.
98b0: 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  }..#ifdef SQLITE
98c0: 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d  _ENABLE_MEMORY_M
98d0: 41 4e 41 47 45 4d 45 4e 54 0a 2f 2a 0a 2a 2a 20  ANAGEMENT./*.** 
98e0: 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73  This function is
98f0: 20 63 61 6c 6c 65 64 20 74 6f 20 66 72 65 65 20   called to free 
9900: 73 75 70 65 72 66 6c 75 6f 75 73 20 64 79 6e 61  superfluous dyna
9910: 6d 69 63 61 6c 6c 79 20 61 6c 6c 6f 63 61 74 65  mically allocate
9920: 64 20 6d 65 6d 6f 72 79 0a 2a 2a 20 68 65 6c 64  d memory.** held
9930: 20 62 79 20 74 68 65 20 70 61 67 65 72 20 73 79   by the pager sy
9940: 73 74 65 6d 2e 20 4d 65 6d 6f 72 79 20 69 6e 20  stem. Memory in 
9950: 75 73 65 20 62 79 20 61 6e 79 20 53 51 4c 69 74  use by any SQLit
9960: 65 20 70 61 67 65 72 20 61 6c 6c 6f 63 61 74 65  e pager allocate
9970: 64 0a 2a 2a 20 62 79 20 74 68 65 20 63 75 72 72  d.** by the curr
9980: 65 6e 74 20 74 68 72 65 61 64 20 6d 61 79 20 62  ent thread may b
9990: 65 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 29  e sqlite3_free()
99a0: 65 64 2e 0a 2a 2a 0a 2a 2a 20 6e 52 65 71 20 69  ed..**.** nReq i
99b0: 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  s the number of 
99c0: 62 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79 20  bytes of memory 
99d0: 72 65 71 75 69 72 65 64 2e 20 4f 6e 63 65 20 74  required. Once t
99e0: 68 69 73 20 6d 75 63 68 20 68 61 73 0a 2a 2a 20  his much has.** 
99f0: 62 65 65 6e 20 72 65 6c 65 61 73 65 64 2c 20 74  been released, t
9a00: 68 65 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75  he function retu
9a10: 72 6e 73 2e 20 54 68 65 20 72 65 74 75 72 6e 20  rns. The return 
9a20: 76 61 6c 75 65 20 69 73 20 74 68 65 20 74 6f 74  value is the tot
9a30: 61 6c 20 6e 75 6d 62 65 72 20 0a 2a 2a 20 6f 66  al number .** of
9a40: 20 62 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79   bytes of memory
9a50: 20 72 65 6c 65 61 73 65 64 2e 0a 2a 2f 0a 69 6e   released..*/.in
9a60: 74 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 52  t sqlite3PcacheR
9a70: 65 6c 65 61 73 65 4d 65 6d 6f 72 79 28 69 6e 74  eleaseMemory(int
9a80: 20 6e 52 65 71 29 7b 0a 20 20 69 6e 74 20 6e 46   nReq){.  int nF
9a90: 72 65 65 20 3d 20 30 3b 0a 20 20 61 73 73 65 72  ree = 0;.  asser
9aa0: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  t( sqlite3_mutex
9ab0: 5f 6e 6f 74 68 65 6c 64 28 70 63 61 63 68 65 31  _notheld(pcache1
9ac0: 2e 67 72 70 2e 6d 75 74 65 78 29 20 29 3b 0a 20  .grp.mutex) );. 
9ad0: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
9ae0: 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c 64 28 70  _mutex_notheld(p
9af0: 63 61 63 68 65 31 2e 6d 75 74 65 78 29 20 29 3b  cache1.mutex) );
9b00: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c  .  if( sqlite3Gl
9b10: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 50 61 67 65  obalConfig.nPage
9b20: 3d 3d 30 20 29 7b 0a 20 20 20 20 50 67 48 64 72  ==0 ){.    PgHdr
9b30: 31 20 2a 70 3b 0a 20 20 20 20 70 63 61 63 68 65  1 *p;.    pcache
9b40: 31 45 6e 74 65 72 4d 75 74 65 78 28 26 70 63 61  1EnterMutex(&pca
9b50: 63 68 65 31 2e 67 72 70 29 3b 0a 20 20 20 20 77  che1.grp);.    w
9b60: 68 69 6c 65 28 20 28 6e 52 65 71 3c 30 20 7c 7c  hile( (nReq<0 ||
9b70: 20 6e 46 72 65 65 3c 6e 52 65 71 29 20 26 26 20   nFree<nReq) && 
9b80: 28 28 70 3d 70 63 61 63 68 65 31 2e 67 72 70 2e  ((p=pcache1.grp.
9b90: 70 4c 72 75 54 61 69 6c 29 21 3d 30 29 20 29 7b  pLruTail)!=0) ){
9ba0: 0a 20 20 20 20 20 20 6e 46 72 65 65 20 2b 3d 20  .      nFree += 
9bb0: 70 63 61 63 68 65 31 4d 65 6d 53 69 7a 65 28 70  pcache1MemSize(p
9bc0: 2d 3e 70 61 67 65 2e 70 42 75 66 29 3b 0a 23 69  ->page.pBuf);.#i
9bd0: 66 64 65 66 20 53 51 4c 49 54 45 5f 50 43 41 43  fdef SQLITE_PCAC
9be0: 48 45 5f 53 45 50 41 52 41 54 45 5f 48 45 41 44  HE_SEPARATE_HEAD
9bf0: 45 52 0a 20 20 20 20 20 20 6e 46 72 65 65 20 2b  ER.      nFree +
9c00: 3d 20 73 71 6c 69 74 65 33 4d 65 6d 53 69 7a 65  = sqlite3MemSize
9c10: 28 70 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20  (p);.#endif.    
9c20: 20 20 61 73 73 65 72 74 28 20 70 2d 3e 69 73 50    assert( p->isP
9c30: 69 6e 6e 65 64 3d 3d 30 20 29 3b 0a 20 20 20 20  inned==0 );.    
9c40: 20 20 70 63 61 63 68 65 31 50 69 6e 50 61 67 65    pcache1PinPage
9c50: 28 70 29 3b 0a 20 20 20 20 20 20 70 63 61 63 68  (p);.      pcach
9c60: 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73 68  e1RemoveFromHash
9c70: 28 70 2c 20 31 29 3b 0a 20 20 20 20 7d 0a 20 20  (p, 1);.    }.  
9c80: 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75    pcache1LeaveMu
9c90: 74 65 78 28 26 70 63 61 63 68 65 31 2e 67 72 70  tex(&pcache1.grp
9ca0: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  );.  }.  return 
9cb0: 6e 46 72 65 65 3b 0a 7d 0a 23 65 6e 64 69 66 20  nFree;.}.#endif 
9cc0: 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  /* SQLITE_ENABLE
9cd0: 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45  _MEMORY_MANAGEME
9ce0: 4e 54 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51  NT */..#ifdef SQ
9cf0: 4c 49 54 45 5f 54 45 53 54 0a 2f 2a 0a 2a 2a 20  LITE_TEST./*.** 
9d00: 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73  This function is
9d10: 20 75 73 65 64 20 62 79 20 74 65 73 74 20 70 72   used by test pr
9d20: 6f 63 65 64 75 72 65 73 20 74 6f 20 69 6e 73 70  ocedures to insp
9d30: 65 63 74 20 74 68 65 20 69 6e 74 65 72 6e 61 6c  ect the internal
9d40: 20 73 74 61 74 65 0a 2a 2a 20 6f 66 20 74 68 65   state.** of the
9d50: 20 67 6c 6f 62 61 6c 20 63 61 63 68 65 2e 0a 2a   global cache..*
9d60: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 63  /.void sqlite3Pc
9d70: 61 63 68 65 53 74 61 74 73 28 0a 20 20 69 6e 74  acheStats(.  int
9d80: 20 2a 70 6e 43 75 72 72 65 6e 74 2c 20 20 20 20   *pnCurrent,    
9d90: 20 20 2f 2a 20 4f 55 54 3a 20 54 6f 74 61 6c 20    /* OUT: Total 
9da0: 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20  number of pages 
9db0: 63 61 63 68 65 64 20 2a 2f 0a 20 20 69 6e 74 20  cached */.  int 
9dc0: 2a 70 6e 4d 61 78 2c 20 20 20 20 20 20 20 20 20  *pnMax,         
9dd0: 20 2f 2a 20 4f 55 54 3a 20 47 6c 6f 62 61 6c 20   /* OUT: Global 
9de0: 6d 61 78 69 6d 75 6d 20 63 61 63 68 65 20 73 69  maximum cache si
9df0: 7a 65 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 4d  ze */.  int *pnM
9e00: 69 6e 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20  in,          /* 
9e10: 4f 55 54 3a 20 53 75 6d 20 6f 66 20 50 43 61 63  OUT: Sum of PCac
9e20: 68 65 31 2e 6e 4d 69 6e 20 66 6f 72 20 70 75 72  he1.nMin for pur
9e30: 67 65 61 62 6c 65 20 63 61 63 68 65 73 20 2a 2f  geable caches */
9e40: 0a 20 20 69 6e 74 20 2a 70 6e 52 65 63 79 63 6c  .  int *pnRecycl
9e50: 61 62 6c 65 20 20 20 20 2f 2a 20 4f 55 54 3a 20  able    /* OUT: 
9e60: 54 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20  Total number of 
9e70: 70 61 67 65 73 20 61 76 61 69 6c 61 62 6c 65 20  pages available 
9e80: 66 6f 72 20 72 65 63 79 63 6c 69 6e 67 20 2a 2f  for recycling */
9e90: 0a 29 7b 0a 20 20 50 67 48 64 72 31 20 2a 70 3b  .){.  PgHdr1 *p;
9ea0: 0a 20 20 69 6e 74 20 6e 52 65 63 79 63 6c 61 62  .  int nRecyclab
9eb0: 6c 65 20 3d 20 30 3b 0a 20 20 66 6f 72 28 70 3d  le = 0;.  for(p=
9ec0: 70 63 61 63 68 65 31 2e 67 72 70 2e 70 4c 72 75  pcache1.grp.pLru
9ed0: 48 65 61 64 3b 20 70 3b 20 70 3d 70 2d 3e 70 4c  Head; p; p=p->pL
9ee0: 72 75 4e 65 78 74 29 7b 0a 20 20 20 20 61 73 73  ruNext){.    ass
9ef0: 65 72 74 28 20 70 2d 3e 69 73 50 69 6e 6e 65 64  ert( p->isPinned
9f00: 3d 3d 30 20 29 3b 0a 20 20 20 20 6e 52 65 63 79  ==0 );.    nRecy
9f10: 63 6c 61 62 6c 65 2b 2b 3b 0a 20 20 7d 0a 20 20  clable++;.  }.  
9f20: 2a 70 6e 43 75 72 72 65 6e 74 20 3d 20 70 63 61  *pnCurrent = pca
9f30: 63 68 65 31 2e 67 72 70 2e 6e 43 75 72 72 65 6e  che1.grp.nCurren
9f40: 74 50 61 67 65 3b 0a 20 20 2a 70 6e 4d 61 78 20  tPage;.  *pnMax 
9f50: 3d 20 28 69 6e 74 29 70 63 61 63 68 65 31 2e 67  = (int)pcache1.g
9f60: 72 70 2e 6e 4d 61 78 50 61 67 65 3b 0a 20 20 2a  rp.nMaxPage;.  *
9f70: 70 6e 4d 69 6e 20 3d 20 28 69 6e 74 29 70 63 61  pnMin = (int)pca
9f80: 63 68 65 31 2e 67 72 70 2e 6e 4d 69 6e 50 61 67  che1.grp.nMinPag
9f90: 65 3b 0a 20 20 2a 70 6e 52 65 63 79 63 6c 61 62  e;.  *pnRecyclab
9fa0: 6c 65 20 3d 20 6e 52 65 63 79 63 6c 61 62 6c 65  le = nRecyclable
9fb0: 3b 0a 7d 0a 23 65 6e 64 69 66 0a                 ;.}.#endif.