/ Hex Artifact Content
Login

Artifact a0c0bb29f7bd720743a16a95eb5dedba3ade15bc:


0000: 2f 2a 0a 2a 2a 20 32 30 30 38 20 4e 6f 76 65 6d  /*.** 2008 Novem
0010: 62 65 72 20 30 35 0a 2a 2a 0a 2a 2a 20 54 68 65  ber 05.**.** The
0020: 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 6d   author disclaim
0030: 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 74  s copyright to t
0040: 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 2e  his source code.
0050: 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a 2a    In place of.**
0060: 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 2c   a legal notice,
0070: 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 73   here is a bless
0080: 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61  ing:.**.**    Ma
0090: 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 6e  y you do good an
00a0: 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 20  d not evil..**  
00b0: 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 66    May you find f
00c0: 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 79  orgiveness for y
00d0: 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 67  ourself and forg
00e0: 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 20  ive others..**  
00f0: 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 20    May you share 
0100: 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 61  freely, never ta
0110: 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 79  king more than y
0120: 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a  ou give..**.****
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0170: 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 54 68 69 73  *****.**.** This
0180: 20 66 69 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 73   file implements
0190: 20 74 68 65 20 64 65 66 61 75 6c 74 20 70 61 67   the default pag
01a0: 65 20 63 61 63 68 65 20 69 6d 70 6c 65 6d 65 6e  e cache implemen
01b0: 74 61 74 69 6f 6e 20 28 74 68 65 0a 2a 2a 20 73  tation (the.** s
01c0: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 69 6e  qlite3_pcache in
01d0: 74 65 72 66 61 63 65 29 2e 20 49 74 20 61 6c 73  terface). It als
01e0: 6f 20 63 6f 6e 74 61 69 6e 73 20 70 61 72 74 20  o contains part 
01f0: 6f 66 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74  of the implement
0200: 61 74 69 6f 6e 0a 2a 2a 20 6f 66 20 74 68 65 20  ation.** of the 
0210: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41  SQLITE_CONFIG_PA
0220: 47 45 43 41 43 48 45 20 61 6e 64 20 73 71 6c 69  GECACHE and sqli
0230: 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f  te3_release_memo
0240: 72 79 28 29 20 66 65 61 74 75 72 65 73 2e 0a 2a  ry() features..*
0250: 2a 20 49 66 20 74 68 65 20 64 65 66 61 75 6c 74  * If the default
0260: 20 70 61 67 65 20 63 61 63 68 65 20 69 6d 70 6c   page cache impl
0270: 65 6d 65 6e 74 61 74 69 6f 6e 20 69 73 20 6f 76  ementation is ov
0280: 65 72 72 69 64 64 65 6e 2c 20 74 68 65 6e 20 6e  erridden, then n
0290: 65 69 74 68 65 72 20 6f 66 0a 2a 2a 20 74 68 65  either of.** the
02a0: 73 65 20 74 77 6f 20 66 65 61 74 75 72 65 73 20  se two features 
02b0: 61 72 65 20 61 76 61 69 6c 61 62 6c 65 2e 0a 2a  are available..*
02c0: 2a 0a 2a 2a 20 41 20 50 61 67 65 20 63 61 63 68  *.** A Page cach
02d0: 65 20 6c 69 6e 65 20 6c 6f 6f 6b 73 20 6c 69 6b  e line looks lik
02e0: 65 20 74 68 69 73 3a 0a 2a 2a 0a 2a 2a 20 20 2d  e this:.**.**  -
02f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0300: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0310: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0320: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 20  ------------.** 
0330: 20 7c 20 20 64 61 74 61 62 61 73 65 20 70 61 67   |  database pag
0340: 65 20 63 6f 6e 74 65 6e 74 20 20 20 7c 20 20 50  e content   |  P
0350: 67 48 64 72 31 20 20 7c 20 20 4d 65 6d 50 61 67  gHdr1  |  MemPag
0360: 65 20 20 7c 20 20 50 67 48 64 72 20 20 7c 0a 2a  e  |  PgHdr  |.*
0370: 2a 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  *  -------------
0380: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0390: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
03a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
03b0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 64 61 74 61 62  .**.** The datab
03c0: 61 73 65 20 70 61 67 65 20 63 6f 6e 74 65 6e 74  ase page content
03d0: 20 69 73 20 75 70 20 66 72 6f 6e 74 20 28 73 6f   is up front (so
03e0: 20 74 68 61 74 20 62 75 66 66 65 72 20 6f 76 65   that buffer ove
03f0: 72 72 65 61 64 73 20 74 65 6e 64 20 74 6f 0a 2a  rreads tend to.*
0400: 2a 20 66 6c 6f 77 20 68 61 72 6d 6c 65 73 73 6c  * flow harmlessl
0410: 79 20 69 6e 74 6f 20 74 68 65 20 50 67 48 64 72  y into the PgHdr
0420: 31 2c 20 4d 65 6d 50 61 67 65 2c 20 61 6e 64 20  1, MemPage, and 
0430: 50 67 48 64 72 20 65 78 74 65 6e 73 69 6f 6e 73  PgHdr extensions
0440: 29 2e 20 20 20 4d 65 6d 50 61 67 65 0a 2a 2a 20  ).   MemPage.** 
0450: 69 73 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e  is the extension
0460: 20 61 64 64 65 64 20 62 79 20 74 68 65 20 62 74   added by the bt
0470: 72 65 65 2e 63 20 6d 6f 64 75 6c 65 20 63 6f 6e  ree.c module con
0480: 74 61 69 6e 69 6e 67 20 69 6e 66 6f 72 6d 61 74  taining informat
0490: 69 6f 6e 20 73 75 63 68 0a 2a 2a 20 61 73 20 74  ion such.** as t
04a0: 68 65 20 64 61 74 61 62 61 73 65 20 70 61 67 65  he database page
04b0: 20 6e 75 6d 62 65 72 20 61 6e 64 20 68 6f 77 20   number and how 
04c0: 74 68 61 74 20 64 61 74 61 62 61 73 65 20 70 61  that database pa
04d0: 67 65 20 69 73 20 75 73 65 64 2e 20 20 50 67 48  ge is used.  PgH
04e0: 64 72 0a 2a 2a 20 69 73 20 61 64 64 65 64 20 62  dr.** is added b
04f0: 79 20 74 68 65 20 70 63 61 63 68 65 2e 63 20 6c  y the pcache.c l
0500: 61 79 65 72 20 61 6e 64 20 63 6f 6e 74 61 69 6e  ayer and contain
0510: 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 75 73  s information us
0520: 65 64 20 74 6f 20 6b 65 65 70 20 74 72 61 63 6b  ed to keep track
0530: 0a 2a 2a 20 6f 66 20 77 68 69 63 68 20 70 61 67  .** of which pag
0540: 65 73 20 61 72 65 20 22 64 69 72 74 79 22 2e 20  es are "dirty". 
0550: 20 50 67 48 64 72 31 20 69 73 20 61 6e 20 65 78   PgHdr1 is an ex
0560: 74 65 6e 73 69 6f 6e 20 61 64 64 65 64 20 62 79  tension added by
0570: 20 74 68 69 73 0a 2a 2a 20 6d 6f 64 75 6c 65 20   this.** module 
0580: 28 70 63 61 63 68 65 31 2e 63 29 2e 20 20 54 68  (pcache1.c).  Th
0590: 65 20 50 67 48 64 72 31 20 68 65 61 64 65 72 20  e PgHdr1 header 
05a0: 69 73 20 61 20 73 75 62 63 6c 61 73 73 20 6f 66  is a subclass of
05b0: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f   sqlite3_pcache_
05c0: 70 61 67 65 2e 0a 2a 2a 20 50 67 48 64 72 31 20  page..** PgHdr1 
05d0: 63 6f 6e 74 61 69 6e 73 20 69 6e 66 6f 72 6d 61  contains informa
05e0: 74 69 6f 6e 20 6e 65 65 64 65 64 20 74 6f 20 6c  tion needed to l
05f0: 6f 6f 6b 20 75 70 20 61 20 70 61 67 65 20 62 79  ook up a page by
0600: 20 69 74 73 20 70 61 67 65 20 6e 75 6d 62 65 72   its page number
0610: 2e 0a 2a 2a 20 54 68 65 20 73 75 70 65 72 63 6c  ..** The supercl
0620: 61 73 73 20 73 71 6c 69 74 65 33 5f 70 63 61 63  ass sqlite3_pcac
0630: 68 65 5f 70 61 67 65 2e 70 42 75 66 20 70 6f 69  he_page.pBuf poi
0640: 6e 74 73 20 74 6f 20 74 68 65 20 73 74 61 72 74  nts to the start
0650: 20 6f 66 20 74 68 65 0a 2a 2a 20 64 61 74 61 62   of the.** datab
0660: 61 73 65 20 70 61 67 65 20 63 6f 6e 74 65 6e 74  ase page content
0670: 20 61 6e 64 20 73 71 6c 69 74 65 33 5f 70 63 61   and sqlite3_pca
0680: 63 68 65 5f 70 61 67 65 2e 70 45 78 74 72 61 20  che_page.pExtra 
0690: 70 6f 69 6e 74 73 20 74 6f 20 50 67 48 64 72 2e  points to PgHdr.
06a0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 69 7a 65 20  .**.** The size 
06b0: 6f 66 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e  of the extension
06c0: 20 28 4d 65 6d 50 61 67 65 2b 50 67 48 64 72 2b   (MemPage+PgHdr+
06d0: 50 67 48 64 72 31 29 20 63 61 6e 20 62 65 20 64  PgHdr1) can be d
06e0: 65 74 65 72 6d 69 6e 65 64 20 61 74 0a 2a 2a 20  etermined at.** 
06f0: 72 75 6e 74 69 6d 65 20 75 73 69 6e 67 20 73 71  runtime using sq
0700: 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c  lite3_config(SQL
0710: 49 54 45 5f 43 4f 4e 46 49 47 5f 50 43 41 43 48  ITE_CONFIG_PCACH
0720: 45 5f 48 44 52 53 5a 2c 20 26 73 69 7a 65 29 2e  E_HDRSZ, &size).
0730: 20 20 54 68 65 0a 2a 2a 20 73 69 7a 65 73 20 6f    The.** sizes o
0740: 66 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e 73  f the extensions
0750: 20 73 75 6d 20 74 6f 20 32 37 32 20 62 79 74 65   sum to 272 byte
0760: 73 20 6f 6e 20 78 36 34 20 66 6f 72 20 33 2e 38  s on x64 for 3.8
0770: 2e 31 30 2c 20 62 75 74 20 74 68 69 73 0a 2a 2a  .10, but this.**
0780: 20 73 69 7a 65 20 63 61 6e 20 76 61 72 79 20 61   size can vary a
0790: 63 63 6f 72 64 69 6e 67 20 74 6f 20 61 72 63 68  ccording to arch
07a0: 69 74 65 63 74 75 72 65 2c 20 63 6f 6d 70 69 6c  itecture, compil
07b0: 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73 2c 20  e-time options, 
07c0: 61 6e 64 0a 2a 2a 20 53 51 4c 69 74 65 20 6c 69  and.** SQLite li
07d0: 62 72 61 72 79 20 76 65 72 73 69 6f 6e 20 6e 75  brary version nu
07e0: 6d 62 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 53  mber..**.** If S
07f0: 51 4c 49 54 45 5f 50 43 41 43 48 45 5f 53 45 50  QLITE_PCACHE_SEP
0800: 41 52 41 54 45 5f 48 45 41 44 45 52 20 69 73 20  ARATE_HEADER is 
0810: 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 74 68  defined, then th
0820: 65 20 65 78 74 65 6e 73 69 6f 6e 20 69 73 20 6f  e extension is o
0830: 62 74 61 69 6e 65 64 0a 2a 2a 20 75 73 69 6e 67  btained.** using
0840: 20 61 20 73 65 70 61 72 61 74 65 20 6d 65 6d 6f   a separate memo
0850: 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 66 72  ry allocation fr
0860: 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 20  om the database 
0870: 70 61 67 65 20 63 6f 6e 74 65 6e 74 2e 20 20 54  page content.  T
0880: 68 69 73 0a 2a 2a 20 73 65 65 6b 73 20 74 6f 20  his.** seeks to 
0890: 6f 76 65 72 63 6f 6d 65 20 74 68 65 20 22 63 6c  overcome the "cl
08a0: 6f 77 6e 73 68 6f 65 22 20 70 72 6f 62 6c 65 6d  ownshoe" problem
08b0: 20 28 61 6c 73 6f 20 63 61 6c 6c 65 64 20 22 69   (also called "i
08c0: 6e 74 65 72 6e 61 6c 0a 2a 2a 20 66 72 61 67 6d  nternal.** fragm
08d0: 65 6e 74 61 74 69 6f 6e 22 20 69 6e 20 61 63 61  entation" in aca
08e0: 64 65 6d 69 63 20 6c 69 74 65 72 61 74 75 72 65  demic literature
08f0: 29 20 6f 66 20 61 6c 6c 6f 63 61 74 69 6e 67 20  ) of allocating 
0900: 61 20 66 65 77 20 62 79 74 65 73 20 6d 6f 72 65  a few bytes more
0910: 0a 2a 2a 20 74 68 61 6e 20 61 20 70 6f 77 65 72  .** than a power
0920: 20 6f 66 20 74 77 6f 20 77 69 74 68 20 74 68 65   of two with the
0930: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f   memory allocato
0940: 72 20 72 6f 75 6e 64 69 6e 67 20 75 70 20 74 6f  r rounding up to
0950: 20 74 68 65 20 6e 65 78 74 0a 2a 2a 20 70 6f 77   the next.** pow
0960: 65 72 20 6f 66 20 74 77 6f 2c 20 61 6e 64 20 6c  er of two, and l
0970: 65 61 76 69 6e 67 20 74 68 65 20 72 6f 75 6e 64  eaving the round
0980: 65 64 2d 75 70 20 73 70 61 63 65 20 75 6e 75 73  ed-up space unus
0990: 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 6d  ed..**.** This m
09a0: 6f 64 75 6c 65 20 74 72 61 63 6b 73 20 70 6f 69  odule tracks poi
09b0: 6e 74 65 72 73 20 74 6f 20 50 67 48 64 72 31 20  nters to PgHdr1 
09c0: 6f 62 6a 65 63 74 73 2e 20 20 4f 6e 6c 79 20 70  objects.  Only p
09d0: 63 61 63 68 65 2e 63 20 63 6f 6d 6d 75 6e 69 63  cache.c communic
09e0: 61 74 65 73 0a 2a 2a 20 77 69 74 68 20 74 68 69  ates.** with thi
09f0: 73 20 6d 6f 64 75 6c 65 2e 20 20 49 6e 66 6f 72  s module.  Infor
0a00: 6d 61 74 69 6f 6e 20 69 73 20 70 61 73 73 65 64  mation is passed
0a10: 20 62 61 63 6b 20 61 6e 64 20 66 6f 72 74 68 20   back and forth 
0a20: 61 73 20 50 67 48 64 72 31 20 70 6f 69 6e 74 65  as PgHdr1 pointe
0a30: 72 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 63  rs..**.** The pc
0a40: 61 63 68 65 2e 63 20 61 6e 64 20 70 61 67 65 72  ache.c and pager
0a50: 2e 63 20 6d 6f 64 75 6c 65 73 20 64 65 61 6c 20  .c modules deal 
0a60: 70 6f 69 6e 74 65 72 73 20 74 6f 20 50 67 48 64  pointers to PgHd
0a70: 72 20 6f 62 6a 65 63 74 73 2e 0a 2a 2a 20 54 68  r objects..** Th
0a80: 65 20 62 74 72 65 65 2e 63 20 6d 6f 64 75 6c 65  e btree.c module
0a90: 20 64 65 61 6c 73 20 77 69 74 68 20 70 6f 69 6e   deals with poin
0aa0: 74 65 72 73 20 74 6f 20 4d 65 6d 50 61 67 65 20  ters to MemPage 
0ab0: 6f 62 6a 65 63 74 73 2e 0a 2a 2a 0a 2a 2a 20 53  objects..**.** S
0ac0: 4f 55 52 43 45 20 4f 46 20 50 41 47 45 20 43 41  OURCE OF PAGE CA
0ad0: 43 48 45 20 4d 45 4d 4f 52 59 3a 0a 2a 2a 0a 2a  CHE MEMORY:.**.*
0ae0: 2a 20 4d 65 6d 6f 72 79 20 66 6f 72 20 61 20 70  * Memory for a p
0af0: 61 67 65 20 6d 69 67 68 74 20 63 6f 6d 65 20 66  age might come f
0b00: 72 6f 6d 20 61 6e 79 20 6f 66 20 74 68 72 65 65  rom any of three
0b10: 20 73 6f 75 72 63 65 73 3a 0a 2a 2a 0a 2a 2a 20   sources:.**.** 
0b20: 20 20 20 28 31 29 20 20 54 68 65 20 67 65 6e 65     (1)  The gene
0b30: 72 61 6c 2d 70 75 72 70 6f 73 65 20 6d 65 6d 6f  ral-purpose memo
0b40: 72 79 20 61 6c 6c 6f 63 61 74 6f 72 20 2d 20 73  ry allocator - s
0b50: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 29 0a 2a  qlite3Malloc().*
0b60: 2a 20 20 20 20 28 32 29 20 20 47 6c 6f 62 61 6c  *    (2)  Global
0b70: 20 70 61 67 65 2d 63 61 63 68 65 20 6d 65 6d 6f   page-cache memo
0b80: 72 79 20 70 72 6f 76 69 64 65 64 20 75 73 69 6e  ry provided usin
0b90: 67 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67  g sqlite3_config
0ba0: 28 29 20 77 69 74 68 0a 2a 2a 20 20 20 20 20 20  () with.**      
0bb0: 20 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47     SQLITE_CONFIG
0bc0: 5f 50 41 47 45 43 41 43 48 45 2e 0a 2a 2a 20 20  _PAGECACHE..**  
0bd0: 20 20 28 33 29 20 20 50 43 61 63 68 65 2d 6c 6f    (3)  PCache-lo
0be0: 63 61 6c 20 62 75 6c 6b 20 61 6c 6c 6f 63 61 74  cal bulk allocat
0bf0: 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 74  ion..**.** The t
0c00: 68 69 72 64 20 63 61 73 65 20 69 73 20 61 20 63  hird case is a c
0c10: 68 75 6e 6b 20 6f 66 20 68 65 61 70 20 6d 65 6d  hunk of heap mem
0c20: 6f 72 79 20 28 64 65 66 61 75 6c 74 69 6e 67 20  ory (defaulting 
0c30: 74 6f 20 31 30 30 20 70 61 67 65 73 20 77 6f 72  to 100 pages wor
0c40: 74 68 29 0a 2a 2a 20 74 68 61 74 20 69 73 20 61  th).** that is a
0c50: 6c 6c 6f 63 61 74 65 64 20 77 68 65 6e 20 74 68  llocated when th
0c60: 65 20 70 61 67 65 20 63 61 63 68 65 20 69 73 20  e page cache is 
0c70: 63 72 65 61 74 65 64 2e 20 20 54 68 65 20 73 69  created.  The si
0c80: 7a 65 20 6f 66 20 74 68 65 20 6c 6f 63 61 6c 0a  ze of the local.
0c90: 2a 2a 20 62 75 6c 6b 20 61 6c 6c 6f 63 61 74 69  ** bulk allocati
0ca0: 6f 6e 20 63 61 6e 20 62 65 20 61 64 6a 75 73 74  on can be adjust
0cb0: 65 64 20 75 73 69 6e 67 20 0a 2a 2a 0a 2a 2a 20  ed using .**.** 
0cc0: 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66      sqlite3_conf
0cd0: 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47  ig(SQLITE_CONFIG
0ce0: 5f 50 41 47 45 43 41 43 48 45 2c 20 30 2c 20 30  _PAGECACHE, 0, 0
0cf0: 2c 20 4e 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 4e  , N)..**.** If N
0d00: 20 69 73 20 70 6f 73 69 74 69 76 65 2c 20 74 68   is positive, th
0d10: 65 6e 20 4e 20 70 61 67 65 73 20 77 6f 72 74 68  en N pages worth
0d20: 20 6f 66 20 6d 65 6d 6f 72 79 20 61 72 65 20 61   of memory are a
0d30: 6c 6c 6f 63 61 74 65 64 20 75 73 69 6e 67 20 61  llocated using a
0d40: 20 73 69 6e 67 6c 65 0a 2a 2a 20 73 71 6c 69 74   single.** sqlit
0d50: 65 33 4d 61 6c 6c 6f 63 28 29 20 63 61 6c 6c 20  e3Malloc() call 
0d60: 61 6e 64 20 74 68 61 74 20 6d 65 6d 6f 72 79 20  and that memory 
0d70: 69 73 20 75 73 65 64 20 66 6f 72 20 74 68 65 20  is used for the 
0d80: 66 69 72 73 74 20 4e 20 70 61 67 65 73 20 61 6c  first N pages al
0d90: 6c 6f 63 61 74 65 64 2e 0a 2a 2a 20 4f 72 20 69  located..** Or i
0da0: 66 20 4e 20 69 73 20 6e 65 67 61 74 69 76 65 2c  f N is negative,
0db0: 20 74 68 65 6e 20 2d 31 30 32 34 2a 4e 20 62 79   then -1024*N by
0dc0: 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79 20 61 72  tes of memory ar
0dd0: 65 20 61 6c 6c 6f 63 61 74 65 64 20 61 6e 64 20  e allocated and 
0de0: 75 73 65 64 0a 2a 2a 20 66 6f 72 20 61 73 20 6d  used.** for as m
0df0: 61 6e 79 20 70 61 67 65 73 20 61 73 20 63 61 6e  any pages as can
0e00: 20 62 65 20 61 63 63 6f 6d 6f 64 61 74 65 64 2e   be accomodated.
0e10: 0a 2a 2a 0a 2a 2a 20 4f 6e 6c 79 20 6f 6e 65 20  .**.** Only one 
0e20: 6f 66 20 28 32 29 20 6f 72 20 28 33 29 20 63 61  of (2) or (3) ca
0e30: 6e 20 62 65 20 75 73 65 64 2e 20 20 4f 6e 63 65  n be used.  Once
0e40: 20 74 68 65 20 6d 65 6d 6f 72 79 20 61 76 61 69   the memory avai
0e50: 6c 61 62 6c 65 20 74 6f 20 28 32 29 20 6f 72 0a  lable to (2) or.
0e60: 2a 2a 20 28 33 29 20 69 73 20 65 78 68 61 75 73  ** (3) is exhaus
0e70: 74 65 64 2c 20 73 75 62 73 65 71 75 65 6e 74 20  ted, subsequent 
0e80: 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 66 61 69 6c  allocations fail
0e90: 20 6f 76 65 72 20 74 6f 20 74 68 65 20 67 65 6e   over to the gen
0ea0: 65 72 61 6c 2d 70 75 72 70 6f 73 65 0a 2a 2a 20  eral-purpose.** 
0eb0: 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72  memory allocator
0ec0: 20 28 31 29 2e 0a 2a 2a 0a 2a 2a 20 45 61 72 6c   (1)..**.** Earl
0ed0: 69 65 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 20  ier versions of 
0ee0: 53 51 4c 69 74 65 20 75 73 65 64 20 6f 6e 6c 79  SQLite used only
0ef0: 20 6d 65 74 68 6f 64 73 20 28 31 29 20 61 6e 64   methods (1) and
0f00: 20 28 32 29 2e 20 20 42 75 74 20 65 78 70 65 72   (2).  But exper
0f10: 69 6d 65 6e 74 73 0a 2a 2a 20 73 68 6f 77 20 74  iments.** show t
0f20: 68 61 74 20 6d 65 74 68 6f 64 20 28 33 29 20 77  hat method (3) w
0f30: 69 74 68 20 4e 3d 3d 31 30 30 20 70 72 6f 76 69  ith N==100 provi
0f40: 64 65 73 20 61 62 6f 75 74 20 61 20 35 25 20 70  des about a 5% p
0f50: 65 72 66 6f 72 6d 61 6e 63 65 20 62 6f 6f 73 74  erformance boost
0f60: 20 66 6f 72 0a 2a 2a 20 63 6f 6d 6d 6f 6e 20 77   for.** common w
0f70: 6f 72 6b 6c 6f 61 64 73 2e 0a 2a 2f 0a 23 69 6e  orkloads..*/.#in
0f80: 63 6c 75 64 65 20 22 73 71 6c 69 74 65 49 6e 74  clude "sqliteInt
0f90: 2e 68 22 0a 0a 74 79 70 65 64 65 66 20 73 74 72  .h"..typedef str
0fa0: 75 63 74 20 50 43 61 63 68 65 31 20 50 43 61 63  uct PCache1 PCac
0fb0: 68 65 31 3b 0a 74 79 70 65 64 65 66 20 73 74 72  he1;.typedef str
0fc0: 75 63 74 20 50 67 48 64 72 31 20 50 67 48 64 72  uct PgHdr1 PgHdr
0fd0: 31 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63  1;.typedef struc
0fe0: 74 20 50 67 46 72 65 65 73 6c 6f 74 20 50 67 46  t PgFreeslot PgF
0ff0: 72 65 65 73 6c 6f 74 3b 0a 74 79 70 65 64 65 66  reeslot;.typedef
1000: 20 73 74 72 75 63 74 20 50 47 72 6f 75 70 20 50   struct PGroup P
1010: 47 72 6f 75 70 3b 0a 0a 2f 2a 0a 2a 2a 20 45 61  Group;../*.** Ea
1020: 63 68 20 63 61 63 68 65 20 65 6e 74 72 79 20 69  ch cache entry i
1030: 73 20 72 65 70 72 65 73 65 6e 74 65 64 20 62 79  s represented by
1040: 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20   an instance of 
1050: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 0a 2a  the following .*
1060: 2a 20 73 74 72 75 63 74 75 72 65 2e 20 55 6e 6c  * structure. Unl
1070: 65 73 73 20 53 51 4c 49 54 45 5f 50 43 41 43 48  ess SQLITE_PCACH
1080: 45 5f 53 45 50 41 52 41 54 45 5f 48 45 41 44 45  E_SEPARATE_HEADE
1090: 52 20 69 73 20 64 65 66 69 6e 65 64 2c 20 61 20  R is defined, a 
10a0: 62 75 66 66 65 72 20 6f 66 0a 2a 2a 20 50 67 48  buffer of.** PgH
10b0: 64 72 31 2e 70 43 61 63 68 65 2d 3e 73 7a 50 61  dr1.pCache->szPa
10c0: 67 65 20 62 79 74 65 73 20 69 73 20 61 6c 6c 6f  ge bytes is allo
10d0: 63 61 74 65 64 20 64 69 72 65 63 74 6c 79 20 62  cated directly b
10e0: 65 66 6f 72 65 20 74 68 69 73 20 73 74 72 75 63  efore this struc
10f0: 74 75 72 65 20 0a 2a 2a 20 69 6e 20 6d 65 6d 6f  ture .** in memo
1100: 72 79 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 50 67  ry..*/.struct Pg
1110: 48 64 72 31 20 7b 0a 20 20 73 71 6c 69 74 65 33  Hdr1 {.  sqlite3
1120: 5f 70 63 61 63 68 65 5f 70 61 67 65 20 70 61 67  _pcache_page pag
1130: 65 3b 20 20 20 20 20 20 2f 2a 20 42 61 73 65 20  e;      /* Base 
1140: 63 6c 61 73 73 2e 20 4d 75 73 74 20 62 65 20 66  class. Must be f
1150: 69 72 73 74 2e 20 70 42 75 66 20 26 20 70 45 78  irst. pBuf & pEx
1160: 74 72 61 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65  tra */.  unsigne
1170: 64 20 69 6e 74 20 69 4b 65 79 3b 20 20 20 20 20  d int iKey;     
1180: 20 20 20 20 20 20 20 20 2f 2a 20 4b 65 79 20 76          /* Key v
1190: 61 6c 75 65 20 28 70 61 67 65 20 6e 75 6d 62 65  alue (page numbe
11a0: 72 29 20 2a 2f 0a 20 20 75 38 20 69 73 50 69 6e  r) */.  u8 isPin
11b0: 6e 65 64 3b 20 20 20 20 20 20 20 20 20 20 20 20  ned;            
11c0: 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 69         /* Page i
11d0: 6e 20 75 73 65 2c 20 6e 6f 74 20 6f 6e 20 74 68  n use, not on th
11e0: 65 20 4c 52 55 20 6c 69 73 74 20 2a 2f 0a 20 20  e LRU list */.  
11f0: 75 38 20 69 73 42 75 6c 6b 4c 6f 63 61 6c 3b 20  u8 isBulkLocal; 
1200: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1210: 2a 20 54 68 69 73 20 70 61 67 65 20 66 72 6f 6d  * This page from
1220: 20 62 75 6c 6b 20 6c 6f 63 61 6c 20 73 74 6f 72   bulk local stor
1230: 61 67 65 20 2a 2f 0a 20 20 75 38 20 69 73 41 6e  age */.  u8 isAn
1240: 63 68 6f 72 3b 20 20 20 20 20 20 20 20 20 20 20  chor;           
1250: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20          /* This 
1260: 69 73 20 74 68 65 20 50 47 72 6f 75 70 2e 6c 72  is the PGroup.lr
1270: 75 20 65 6c 65 6d 65 6e 74 20 2a 2f 0a 20 20 50  u element */.  P
1280: 67 48 64 72 31 20 2a 70 4e 65 78 74 3b 20 20 20  gHdr1 *pNext;   
1290: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
12a0: 20 4e 65 78 74 20 69 6e 20 68 61 73 68 20 74 61   Next in hash ta
12b0: 62 6c 65 20 63 68 61 69 6e 20 2a 2f 0a 20 20 50  ble chain */.  P
12c0: 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 3b 20  Cache1 *pCache; 
12d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
12e0: 20 43 61 63 68 65 20 74 68 61 74 20 63 75 72 72   Cache that curr
12f0: 65 6e 74 6c 79 20 6f 77 6e 73 20 74 68 69 73 20  ently owns this 
1300: 70 61 67 65 20 2a 2f 0a 20 20 50 67 48 64 72 31  page */.  PgHdr1
1310: 20 2a 70 4c 72 75 4e 65 78 74 3b 20 20 20 20 20   *pLruNext;     
1320: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 74           /* Next
1330: 20 69 6e 20 4c 52 55 20 6c 69 73 74 20 6f 66 20   in LRU list of 
1340: 75 6e 70 69 6e 6e 65 64 20 70 61 67 65 73 20 2a  unpinned pages *
1350: 2f 0a 20 20 50 67 48 64 72 31 20 2a 70 4c 72 75  /.  PgHdr1 *pLru
1360: 50 72 65 76 3b 20 20 20 20 20 20 20 20 20 20 20  Prev;           
1370: 20 20 20 2f 2a 20 50 72 65 76 69 6f 75 73 20 69     /* Previous i
1380: 6e 20 4c 52 55 20 6c 69 73 74 20 6f 66 20 75 6e  n LRU list of un
1390: 70 69 6e 6e 65 64 20 70 61 67 65 73 20 2a 2f 0a  pinned pages */.
13a0: 7d 3b 0a 0a 2f 2a 20 45 61 63 68 20 70 61 67 65  };../* Each page
13b0: 20 63 61 63 68 65 20 28 6f 72 20 50 43 61 63 68   cache (or PCach
13c0: 65 29 20 62 65 6c 6f 6e 67 73 20 74 6f 20 61 20  e) belongs to a 
13d0: 50 47 72 6f 75 70 2e 20 20 41 20 50 47 72 6f 75  PGroup.  A PGrou
13e0: 70 20 69 73 20 61 20 73 65 74 20 0a 2a 2a 20 6f  p is a set .** o
13f0: 66 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 50 43  f one or more PC
1400: 61 63 68 65 73 20 74 68 61 74 20 61 72 65 20 61  aches that are a
1410: 62 6c 65 20 74 6f 20 72 65 63 79 63 6c 65 20 65  ble to recycle e
1420: 61 63 68 20 6f 74 68 65 72 27 73 20 75 6e 70 69  ach other's unpi
1430: 6e 6e 65 64 0a 2a 2a 20 70 61 67 65 73 20 77 68  nned.** pages wh
1440: 65 6e 20 74 68 65 79 20 61 72 65 20 75 6e 64 65  en they are unde
1450: 72 20 6d 65 6d 6f 72 79 20 70 72 65 73 73 75 72  r memory pressur
1460: 65 2e 20 20 41 20 50 47 72 6f 75 70 20 69 73 20  e.  A PGroup is 
1470: 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 0a 2a  an instance of.*
1480: 2a 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  * the following 
1490: 6f 62 6a 65 63 74 2e 0a 2a 2a 0a 2a 2a 20 54 68  object..**.** Th
14a0: 69 73 20 70 61 67 65 20 63 61 63 68 65 20 69 6d  is page cache im
14b0: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 77 6f 72  plementation wor
14c0: 6b 73 20 69 6e 20 6f 6e 65 20 6f 66 20 74 77 6f  ks in one of two
14d0: 20 6d 6f 64 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20   modes:.**.**   
14e0: 28 31 29 20 20 45 76 65 72 79 20 50 43 61 63 68  (1)  Every PCach
14f0: 65 20 69 73 20 74 68 65 20 73 6f 6c 65 20 6d 65  e is the sole me
1500: 6d 62 65 72 20 6f 66 20 69 74 73 20 6f 77 6e 20  mber of its own 
1510: 50 47 72 6f 75 70 2e 20 20 54 68 65 72 65 20 69  PGroup.  There i
1520: 73 0a 2a 2a 20 20 20 20 20 20 20 20 6f 6e 65 20  s.**        one 
1530: 50 47 72 6f 75 70 20 70 65 72 20 50 43 61 63 68  PGroup per PCach
1540: 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 28 32 29 20 20  e..**.**   (2)  
1550: 54 68 65 72 65 20 69 73 20 61 20 73 69 6e 67 6c  There is a singl
1560: 65 20 67 6c 6f 62 61 6c 20 50 47 72 6f 75 70 20  e global PGroup 
1570: 74 68 61 74 20 61 6c 6c 20 50 43 61 63 68 65 73  that all PCaches
1580: 20 61 72 65 20 61 20 6d 65 6d 62 65 72 0a 2a 2a   are a member.**
1590: 20 20 20 20 20 20 20 20 6f 66 2e 0a 2a 2a 0a 2a          of..**.*
15a0: 2a 20 4d 6f 64 65 20 31 20 75 73 65 73 20 6d 6f  * Mode 1 uses mo
15b0: 72 65 20 6d 65 6d 6f 72 79 20 28 73 69 6e 63 65  re memory (since
15c0: 20 50 43 61 63 68 65 20 69 6e 73 74 61 6e 63 65   PCache instance
15d0: 73 20 61 72 65 20 6e 6f 74 20 61 62 6c 65 20 74  s are not able t
15e0: 6f 20 72 6f 62 0a 2a 2a 20 75 6e 75 73 65 64 20  o rob.** unused 
15f0: 70 61 67 65 73 20 66 72 6f 6d 20 6f 74 68 65 72  pages from other
1600: 20 50 43 61 63 68 65 73 29 20 62 75 74 20 69 74   PCaches) but it
1610: 20 61 6c 73 6f 20 6f 70 65 72 61 74 65 73 20 77   also operates w
1620: 69 74 68 6f 75 74 20 61 20 6d 75 74 65 78 2c 0a  ithout a mutex,.
1630: 2a 2a 20 61 6e 64 20 69 73 20 74 68 65 72 65 66  ** and is theref
1640: 6f 72 65 20 6f 66 74 65 6e 20 66 61 73 74 65 72  ore often faster
1650: 2e 20 20 4d 6f 64 65 20 32 20 72 65 71 75 69 72  .  Mode 2 requir
1660: 65 73 20 61 20 6d 75 74 65 78 20 69 6e 20 6f 72  es a mutex in or
1670: 64 65 72 20 74 6f 20 62 65 0a 2a 2a 20 74 68 72  der to be.** thr
1680: 65 61 64 73 61 66 65 2c 20 62 75 74 20 72 65 63  eadsafe, but rec
1690: 79 63 6c 65 73 20 70 61 67 65 73 20 6d 6f 72 65  ycles pages more
16a0: 20 65 66 66 69 63 69 65 6e 74 6c 79 2e 0a 2a 2a   efficiently..**
16b0: 0a 2a 2a 20 46 6f 72 20 6d 6f 64 65 20 28 31 29  .** For mode (1)
16c0: 2c 20 50 47 72 6f 75 70 2e 6d 75 74 65 78 20 69  , PGroup.mutex i
16d0: 73 20 4e 55 4c 4c 2e 20 20 46 6f 72 20 6d 6f 64  s NULL.  For mod
16e0: 65 20 28 32 29 20 74 68 65 72 65 20 69 73 20 6f  e (2) there is o
16f0: 6e 6c 79 20 61 20 73 69 6e 67 6c 65 0a 2a 2a 20  nly a single.** 
1700: 50 47 72 6f 75 70 20 77 68 69 63 68 20 69 73 20  PGroup which is 
1710: 74 68 65 20 70 63 61 63 68 65 31 2e 67 72 70 20  the pcache1.grp 
1720: 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 20  global variable 
1730: 61 6e 64 20 69 74 73 20 6d 75 74 65 78 20 69 73  and its mutex is
1740: 0a 2a 2a 20 53 51 4c 49 54 45 5f 4d 55 54 45 58  .** SQLITE_MUTEX
1750: 5f 53 54 41 54 49 43 5f 4c 52 55 2e 0a 2a 2f 0a  _STATIC_LRU..*/.
1760: 73 74 72 75 63 74 20 50 47 72 6f 75 70 20 7b 0a  struct PGroup {.
1770: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20    sqlite3_mutex 
1780: 2a 6d 75 74 65 78 3b 20 20 20 20 20 20 20 20 20  *mutex;         
1790: 20 2f 2a 20 4d 55 54 45 58 5f 53 54 41 54 49 43   /* MUTEX_STATIC
17a0: 5f 4c 52 55 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a  _LRU or NULL */.
17b0: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e    unsigned int n
17c0: 4d 61 78 50 61 67 65 3b 20 20 20 20 20 20 20 20  MaxPage;        
17d0: 20 2f 2a 20 53 75 6d 20 6f 66 20 6e 4d 61 78 20   /* Sum of nMax 
17e0: 66 6f 72 20 70 75 72 67 65 61 62 6c 65 20 63 61  for purgeable ca
17f0: 63 68 65 73 20 2a 2f 0a 20 20 75 6e 73 69 67 6e  ches */.  unsign
1800: 65 64 20 69 6e 74 20 6e 4d 69 6e 50 61 67 65 3b  ed int nMinPage;
1810: 20 20 20 20 20 20 20 20 20 2f 2a 20 53 75 6d 20           /* Sum 
1820: 6f 66 20 6e 4d 69 6e 20 66 6f 72 20 70 75 72 67  of nMin for purg
1830: 65 61 62 6c 65 20 63 61 63 68 65 73 20 2a 2f 0a  eable caches */.
1840: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6d    unsigned int m
1850: 78 50 69 6e 6e 65 64 3b 20 20 20 20 20 20 20 20  xPinned;        
1860: 20 2f 2a 20 6e 4d 61 78 70 61 67 65 20 2b 20 31   /* nMaxpage + 1
1870: 30 20 2d 20 6e 4d 69 6e 50 61 67 65 20 2a 2f 0a  0 - nMinPage */.
1880: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e    unsigned int n
1890: 43 75 72 72 65 6e 74 50 61 67 65 3b 20 20 20 20  CurrentPage;    
18a0: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 75   /* Number of pu
18b0: 72 67 65 61 62 6c 65 20 70 61 67 65 73 20 61 6c  rgeable pages al
18c0: 6c 6f 63 61 74 65 64 20 2a 2f 0a 20 20 50 67 48  located */.  PgH
18d0: 64 72 31 20 6c 72 75 3b 20 20 20 20 20 20 20 20  dr1 lru;        
18e0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
18f0: 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 61 6e 64  he beginning and
1900: 20 65 6e 64 20 6f 66 20 74 68 65 20 4c 52 55 20   end of the LRU 
1910: 6c 69 73 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 45  list */.};../* E
1920: 61 63 68 20 70 61 67 65 20 63 61 63 68 65 20 69  ach page cache i
1930: 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66  s an instance of
1940: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f   the following o
1950: 62 6a 65 63 74 2e 20 20 45 76 65 72 79 0a 2a 2a  bject.  Every.**
1960: 20 6f 70 65 6e 20 64 61 74 61 62 61 73 65 20 66   open database f
1970: 69 6c 65 20 28 69 6e 63 6c 75 64 69 6e 67 20 65  ile (including e
1980: 61 63 68 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61  ach in-memory da
1990: 74 61 62 61 73 65 20 61 6e 64 20 65 61 63 68 0a  tabase and each.
19a0: 2a 2a 20 74 65 6d 70 6f 72 61 72 79 20 6f 72 20  ** temporary or 
19b0: 74 72 61 6e 73 69 65 6e 74 20 64 61 74 61 62 61  transient databa
19c0: 73 65 29 20 68 61 73 20 61 20 73 69 6e 67 6c 65  se) has a single
19d0: 20 70 61 67 65 20 63 61 63 68 65 20 77 68 69 63   page cache whic
19e0: 68 0a 2a 2a 20 69 73 20 61 6e 20 69 6e 73 74 61  h.** is an insta
19f0: 6e 63 65 20 6f 66 20 74 68 69 73 20 6f 62 6a 65  nce of this obje
1a00: 63 74 2e 0a 2a 2a 0a 2a 2a 20 50 6f 69 6e 74 65  ct..**.** Pointe
1a10: 72 73 20 74 6f 20 73 74 72 75 63 74 75 72 65 73  rs to structures
1a20: 20 6f 66 20 74 68 69 73 20 74 79 70 65 20 61 72   of this type ar
1a30: 65 20 63 61 73 74 20 61 6e 64 20 72 65 74 75 72  e cast and retur
1a40: 6e 65 64 20 61 73 20 0a 2a 2a 20 6f 70 61 71 75  ned as .** opaqu
1a50: 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  e sqlite3_pcache
1a60: 2a 20 68 61 6e 64 6c 65 73 2e 0a 2a 2f 0a 73 74  * handles..*/.st
1a70: 72 75 63 74 20 50 43 61 63 68 65 31 20 7b 0a 20  ruct PCache1 {. 
1a80: 20 2f 2a 20 43 61 63 68 65 20 63 6f 6e 66 69 67   /* Cache config
1a90: 75 72 61 74 69 6f 6e 20 70 61 72 61 6d 65 74 65  uration paramete
1aa0: 72 73 2e 20 50 61 67 65 20 73 69 7a 65 20 28 73  rs. Page size (s
1ab0: 7a 50 61 67 65 29 20 61 6e 64 20 74 68 65 20 70  zPage) and the p
1ac0: 75 72 67 65 61 62 6c 65 0a 20 20 2a 2a 20 66 6c  urgeable.  ** fl
1ad0: 61 67 20 28 62 50 75 72 67 65 61 62 6c 65 29 20  ag (bPurgeable) 
1ae0: 61 72 65 20 73 65 74 20 77 68 65 6e 20 74 68 65  are set when the
1af0: 20 63 61 63 68 65 20 69 73 20 63 72 65 61 74 65   cache is create
1b00: 64 2e 20 6e 4d 61 78 20 6d 61 79 20 62 65 20 0a  d. nMax may be .
1b10: 20 20 2a 2a 20 6d 6f 64 69 66 69 65 64 20 61 74    ** modified at
1b20: 20 61 6e 79 20 74 69 6d 65 20 62 79 20 61 20 63   any time by a c
1b30: 61 6c 6c 20 74 6f 20 74 68 65 20 70 63 61 63 68  all to the pcach
1b40: 65 31 43 61 63 68 65 73 69 7a 65 28 29 20 6d 65  e1Cachesize() me
1b50: 74 68 6f 64 2e 0a 20 20 2a 2a 20 54 68 65 20 50  thod..  ** The P
1b60: 47 72 6f 75 70 20 6d 75 74 65 78 20 6d 75 73 74  Group mutex must
1b70: 20 62 65 20 68 65 6c 64 20 77 68 65 6e 20 61 63   be held when ac
1b80: 63 65 73 73 69 6e 67 20 6e 4d 61 78 2e 0a 20 20  cessing nMax..  
1b90: 2a 2f 0a 20 20 50 47 72 6f 75 70 20 2a 70 47 72  */.  PGroup *pGr
1ba0: 6f 75 70 3b 20 20 20 20 20 20 20 20 20 20 20 20  oup;            
1bb0: 20 20 20 20 20 20 20 20 20 2f 2a 20 50 47 72 6f           /* PGro
1bc0: 75 70 20 74 68 69 73 20 63 61 63 68 65 20 62 65  up this cache be
1bd0: 6c 6f 6e 67 73 20 74 6f 20 2a 2f 0a 20 20 69 6e  longs to */.  in
1be0: 74 20 73 7a 50 61 67 65 3b 20 20 20 20 20 20 20  t szPage;       
1bf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1c00: 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 64 61 74    /* Size of dat
1c10: 61 62 61 73 65 20 63 6f 6e 74 65 6e 74 20 73 65  abase content se
1c20: 63 74 69 6f 6e 20 2a 2f 0a 20 20 69 6e 74 20 73  ction */.  int s
1c30: 7a 45 78 74 72 61 3b 20 20 20 20 20 20 20 20 20  zExtra;         
1c40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1c50: 2a 20 73 69 7a 65 6f 66 28 4d 65 6d 50 61 67 65  * sizeof(MemPage
1c60: 29 2b 73 69 7a 65 6f 66 28 50 67 48 64 72 29 20  )+sizeof(PgHdr) 
1c70: 2a 2f 0a 20 20 69 6e 74 20 73 7a 41 6c 6c 6f 63  */.  int szAlloc
1c80: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
1c90: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 6f 74 61           /* Tota
1ca0: 6c 20 73 69 7a 65 20 6f 66 20 6f 6e 65 20 70 63  l size of one pc
1cb0: 61 63 68 65 20 6c 69 6e 65 20 2a 2f 0a 20 20 69  ache line */.  i
1cc0: 6e 74 20 62 50 75 72 67 65 61 62 6c 65 3b 20 20  nt bPurgeable;  
1cd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1ce0: 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 63 61     /* True if ca
1cf0: 63 68 65 20 69 73 20 70 75 72 67 65 61 62 6c 65  che is purgeable
1d00: 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69   */.  unsigned i
1d10: 6e 74 20 6e 4d 69 6e 3b 20 20 20 20 20 20 20 20  nt nMin;        
1d20: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 69 6e            /* Min
1d30: 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 70  imum number of p
1d40: 61 67 65 73 20 72 65 73 65 72 76 65 64 20 2a 2f  ages reserved */
1d50: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
1d60: 6e 4d 61 78 3b 20 20 20 20 20 20 20 20 20 20 20  nMax;           
1d70: 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 66 69 67         /* Config
1d80: 75 72 65 64 20 22 63 61 63 68 65 5f 73 69 7a 65  ured "cache_size
1d90: 22 20 76 61 6c 75 65 20 2a 2f 0a 20 20 75 6e 73  " value */.  uns
1da0: 69 67 6e 65 64 20 69 6e 74 20 6e 39 30 70 63 74  igned int n90pct
1db0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
1dc0: 20 2f 2a 20 6e 4d 61 78 2a 39 2f 31 30 20 2a 2f   /* nMax*9/10 */
1dd0: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
1de0: 69 4d 61 78 4b 65 79 3b 20 20 20 20 20 20 20 20  iMaxKey;        
1df0: 20 20 20 20 20 20 20 2f 2a 20 4c 61 72 67 65 73         /* Larges
1e00: 74 20 6b 65 79 20 73 65 65 6e 20 73 69 6e 63 65  t key seen since
1e10: 20 78 54 72 75 6e 63 61 74 65 28 29 20 2a 2f 0a   xTruncate() */.
1e20: 0a 20 20 2f 2a 20 48 61 73 68 20 74 61 62 6c 65  .  /* Hash table
1e30: 20 6f 66 20 61 6c 6c 20 70 61 67 65 73 2e 20 54   of all pages. T
1e40: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 76 61 72  he following var
1e50: 69 61 62 6c 65 73 20 6d 61 79 20 6f 6e 6c 79 20  iables may only 
1e60: 62 65 20 61 63 63 65 73 73 65 64 0a 20 20 2a 2a  be accessed.  **
1e70: 20 77 68 65 6e 20 74 68 65 20 61 63 63 65 73 73   when the access
1e80: 6f 72 20 69 73 20 68 6f 6c 64 69 6e 67 20 74 68  or is holding th
1e90: 65 20 50 47 72 6f 75 70 20 6d 75 74 65 78 2e 0a  e PGroup mutex..
1ea0: 20 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20    */.  unsigned 
1eb0: 69 6e 74 20 6e 52 65 63 79 63 6c 61 62 6c 65 3b  int nRecyclable;
1ec0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75             /* Nu
1ed0: 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e  mber of pages in
1ee0: 20 74 68 65 20 4c 52 55 20 6c 69 73 74 20 2a 2f   the LRU list */
1ef0: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
1f00: 6e 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 20  nPage;          
1f10: 20 20 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20         /* Total 
1f20: 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20  number of pages 
1f30: 69 6e 20 61 70 48 61 73 68 20 2a 2f 0a 20 20 75  in apHash */.  u
1f40: 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 48 61 73  nsigned int nHas
1f50: 68 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  h;              
1f60: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20     /* Number of 
1f70: 73 6c 6f 74 73 20 69 6e 20 61 70 48 61 73 68 5b  slots in apHash[
1f80: 5d 20 2a 2f 0a 20 20 50 67 48 64 72 31 20 2a 2a  ] */.  PgHdr1 **
1f90: 61 70 48 61 73 68 3b 20 20 20 20 20 20 20 20 20  apHash;         
1fa0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 48 61             /* Ha
1fb0: 73 68 20 74 61 62 6c 65 20 66 6f 72 20 66 61 73  sh table for fas
1fc0: 74 20 6c 6f 6f 6b 75 70 20 62 79 20 6b 65 79 20  t lookup by key 
1fd0: 2a 2f 0a 20 20 50 67 48 64 72 31 20 2a 70 46 72  */.  PgHdr1 *pFr
1fe0: 65 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  ee;             
1ff0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 74           /* List
2000: 20 6f 66 20 75 6e 75 73 65 64 20 70 63 61 63 68   of unused pcach
2010: 65 2d 6c 6f 63 61 6c 20 70 61 67 65 73 20 2a 2f  e-local pages */
2020: 0a 20 20 76 6f 69 64 20 2a 70 42 75 6c 6b 3b 20  .  void *pBulk; 
2030: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2040: 20 20 20 20 20 20 20 2f 2a 20 42 75 6c 6b 20 6d         /* Bulk m
2050: 65 6d 6f 72 79 20 75 73 65 64 20 62 79 20 70 63  emory used by pc
2060: 61 63 68 65 2d 6c 6f 63 61 6c 20 2a 2f 0a 7d 3b  ache-local */.};
2070: 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 73 6c 6f  ../*.** Free slo
2080: 74 73 20 69 6e 20 74 68 65 20 61 6c 6c 6f 63 61  ts in the alloca
2090: 74 6f 72 20 75 73 65 64 20 74 6f 20 64 69 76 69  tor used to divi
20a0: 64 65 20 75 70 20 74 68 65 20 67 6c 6f 62 61 6c  de up the global
20b0: 20 70 61 67 65 20 63 61 63 68 65 0a 2a 2a 20 62   page cache.** b
20c0: 75 66 66 65 72 20 70 72 6f 76 69 64 65 64 20 75  uffer provided u
20d0: 73 69 6e 67 20 74 68 65 20 53 51 4c 49 54 45 5f  sing the SQLITE_
20e0: 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45  CONFIG_PAGECACHE
20f0: 20 6d 65 63 68 61 6e 69 73 6d 2e 0a 2a 2f 0a 73   mechanism..*/.s
2100: 74 72 75 63 74 20 50 67 46 72 65 65 73 6c 6f 74  truct PgFreeslot
2110: 20 7b 0a 20 20 50 67 46 72 65 65 73 6c 6f 74 20   {.  PgFreeslot 
2120: 2a 70 4e 65 78 74 3b 20 20 2f 2a 20 4e 65 78 74  *pNext;  /* Next
2130: 20 66 72 65 65 20 73 6c 6f 74 20 2a 2f 0a 7d 3b   free slot */.};
2140: 0a 0a 2f 2a 0a 2a 2a 20 47 6c 6f 62 61 6c 20 64  ../*.** Global d
2150: 61 74 61 20 75 73 65 64 20 62 79 20 74 68 69 73  ata used by this
2160: 20 63 61 63 68 65 2e 0a 2a 2f 0a 73 74 61 74 69   cache..*/.stati
2170: 63 20 53 51 4c 49 54 45 5f 57 53 44 20 73 74 72  c SQLITE_WSD str
2180: 75 63 74 20 50 43 61 63 68 65 47 6c 6f 62 61 6c  uct PCacheGlobal
2190: 20 7b 0a 20 20 50 47 72 6f 75 70 20 67 72 70 3b   {.  PGroup grp;
21a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
21b0: 20 20 20 20 2f 2a 20 54 68 65 20 67 6c 6f 62 61      /* The globa
21c0: 6c 20 50 47 72 6f 75 70 20 66 6f 72 20 6d 6f 64  l PGroup for mod
21d0: 65 20 28 32 29 20 2a 2f 0a 0a 20 20 2f 2a 20 56  e (2) */..  /* V
21e0: 61 72 69 61 62 6c 65 73 20 72 65 6c 61 74 65 64  ariables related
21f0: 20 74 6f 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49   to SQLITE_CONFI
2200: 47 5f 50 41 47 45 43 41 43 48 45 20 73 65 74 74  G_PAGECACHE sett
2210: 69 6e 67 73 2e 20 20 54 68 65 0a 20 20 2a 2a 20  ings.  The.  ** 
2220: 73 7a 53 6c 6f 74 2c 20 6e 53 6c 6f 74 2c 20 70  szSlot, nSlot, p
2230: 53 74 61 72 74 2c 20 70 45 6e 64 2c 20 6e 52 65  Start, pEnd, nRe
2240: 73 65 72 76 65 2c 20 61 6e 64 20 69 73 49 6e 69  serve, and isIni
2250: 74 20 76 61 6c 75 65 73 20 61 72 65 20 61 6c 6c  t values are all
2260: 0a 20 20 2a 2a 20 66 69 78 65 64 20 61 74 20 73  .  ** fixed at s
2270: 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a  qlite3_initializ
2280: 65 28 29 20 74 69 6d 65 20 61 6e 64 20 64 6f 20  e() time and do 
2290: 6e 6f 74 20 72 65 71 75 69 72 65 20 6d 75 74 65  not require mute
22a0: 78 20 70 72 6f 74 65 63 74 69 6f 6e 2e 0a 20 20  x protection..  
22b0: 2a 2a 20 54 68 65 20 6e 46 72 65 65 53 6c 6f 74  ** The nFreeSlot
22c0: 20 61 6e 64 20 70 46 72 65 65 20 76 61 6c 75 65   and pFree value
22d0: 73 20 64 6f 20 72 65 71 75 69 72 65 20 6d 75 74  s do require mut
22e0: 65 78 20 70 72 6f 74 65 63 74 69 6f 6e 2e 0a 20  ex protection.. 
22f0: 20 2a 2f 0a 20 20 69 6e 74 20 69 73 49 6e 69 74   */.  int isInit
2300: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
2310: 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20       /* True if 
2320: 69 6e 69 74 69 61 6c 69 7a 65 64 20 2a 2f 0a 20  initialized */. 
2330: 20 69 6e 74 20 73 65 70 61 72 61 74 65 43 61 63   int separateCac
2340: 68 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  he;             
2350: 2f 2a 20 55 73 65 20 61 20 6e 65 77 20 50 47 72  /* Use a new PGr
2360: 6f 75 70 20 66 6f 72 20 65 61 63 68 20 50 43 61  oup for each PCa
2370: 63 68 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 49 6e  che */.  int nIn
2380: 69 74 50 61 67 65 3b 20 20 20 20 20 20 20 20 20  itPage;         
2390: 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 69 74 69          /* Initi
23a0: 61 6c 20 62 75 6c 6b 20 61 6c 6c 6f 63 61 74 69  al bulk allocati
23b0: 6f 6e 20 73 69 7a 65 20 2a 2f 20 20 20 0a 20 20  on size */   .  
23c0: 69 6e 74 20 73 7a 53 6c 6f 74 3b 20 20 20 20 20  int szSlot;     
23d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
23e0: 2a 20 53 69 7a 65 20 6f 66 20 65 61 63 68 20 66  * Size of each f
23f0: 72 65 65 20 73 6c 6f 74 20 2a 2f 0a 20 20 69 6e  ree slot */.  in
2400: 74 20 6e 53 6c 6f 74 3b 20 20 20 20 20 20 20 20  t nSlot;        
2410: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
2420: 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 63  The number of pc
2430: 61 63 68 65 20 73 6c 6f 74 73 20 2a 2f 0a 20 20  ache slots */.  
2440: 69 6e 74 20 6e 52 65 73 65 72 76 65 3b 20 20 20  int nReserve;   
2450: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
2460: 2a 20 54 72 79 20 74 6f 20 6b 65 65 70 20 6e 46  * Try to keep nF
2470: 72 65 65 53 6c 6f 74 20 61 62 6f 76 65 20 74 68  reeSlot above th
2480: 69 73 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 53  is */.  void *pS
2490: 74 61 72 74 2c 20 2a 70 45 6e 64 3b 20 20 20 20  tart, *pEnd;    
24a0: 20 20 20 20 20 20 20 2f 2a 20 42 6f 75 6e 64 73         /* Bounds
24b0: 20 6f 66 20 67 6c 6f 62 61 6c 20 70 61 67 65 20   of global page 
24c0: 63 61 63 68 65 20 6d 65 6d 6f 72 79 20 2a 2f 0a  cache memory */.
24d0: 20 20 2f 2a 20 41 62 6f 76 65 20 72 65 71 75 69    /* Above requi
24e0: 72 65 73 20 6e 6f 20 6d 75 74 65 78 2e 20 20 55  res no mutex.  U
24f0: 73 65 20 6d 75 74 65 78 20 62 65 6c 6f 77 20 66  se mutex below f
2500: 6f 72 20 76 61 72 69 61 62 6c 65 20 74 68 61 74  or variable that
2510: 20 66 6f 6c 6c 6f 77 2e 20 2a 2f 0a 20 20 73 71   follow. */.  sq
2520: 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74  lite3_mutex *mut
2530: 65 78 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ex;          /* 
2540: 4d 75 74 65 78 20 66 6f 72 20 61 63 63 65 73 73  Mutex for access
2550: 69 6e 67 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e  ing the followin
2560: 67 3a 20 2a 2f 0a 20 20 50 67 46 72 65 65 73 6c  g: */.  PgFreesl
2570: 6f 74 20 2a 70 46 72 65 65 3b 20 20 20 20 20 20  ot *pFree;      
2580: 20 20 20 20 20 20 20 2f 2a 20 46 72 65 65 20 70         /* Free p
2590: 61 67 65 20 62 6c 6f 63 6b 73 20 2a 2f 0a 20 20  age blocks */.  
25a0: 69 6e 74 20 6e 46 72 65 65 53 6c 6f 74 3b 20 20  int nFreeSlot;  
25b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
25c0: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 75 6e 75 73  * Number of unus
25d0: 65 64 20 70 63 61 63 68 65 20 73 6c 6f 74 73 20  ed pcache slots 
25e0: 2a 2f 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c  */.  /* The foll
25f0: 6f 77 69 6e 67 20 76 61 6c 75 65 20 72 65 71 75  owing value requ
2600: 69 72 65 73 20 61 20 6d 75 74 65 78 20 74 6f 20  ires a mutex to 
2610: 63 68 61 6e 67 65 2e 20 20 57 65 20 73 6b 69 70  change.  We skip
2620: 20 74 68 65 20 6d 75 74 65 78 20 6f 6e 0a 20 20   the mutex on.  
2630: 2a 2a 20 72 65 61 64 69 6e 67 20 62 65 63 61 75  ** reading becau
2640: 73 65 20 28 31 29 20 6d 6f 73 74 20 70 6c 61 74  se (1) most plat
2650: 66 6f 72 6d 73 20 72 65 61 64 20 61 20 33 32 2d  forms read a 32-
2660: 62 69 74 20 69 6e 74 65 67 65 72 20 61 74 6f 6d  bit integer atom
2670: 69 63 61 6c 6c 79 20 61 6e 64 0a 20 20 2a 2a 20  ically and.  ** 
2680: 28 32 29 20 65 76 65 6e 20 69 66 20 61 6e 20 69  (2) even if an i
2690: 6e 63 6f 72 72 65 63 74 20 76 61 6c 75 65 20 69  ncorrect value i
26a0: 73 20 72 65 61 64 2c 20 6e 6f 20 67 72 65 61 74  s read, no great
26b0: 20 68 61 72 6d 20 69 73 20 64 6f 6e 65 20 73 69   harm is done si
26c0: 6e 63 65 20 74 68 69 73 0a 20 20 2a 2a 20 69 73  nce this.  ** is
26d0: 20 72 65 61 6c 6c 79 20 6a 75 73 74 20 61 6e 20   really just an 
26e0: 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 2e 20 2a 2f  optimization. */
26f0: 0a 20 20 69 6e 74 20 62 55 6e 64 65 72 50 72 65  .  int bUnderPre
2700: 73 73 75 72 65 3b 20 20 20 20 20 20 20 20 20 20  ssure;          
2710: 20 20 2f 2a 20 54 72 75 65 20 69 66 20 6c 6f 77    /* True if low
2720: 20 6f 6e 20 50 41 47 45 43 41 43 48 45 20 6d 65   on PAGECACHE me
2730: 6d 6f 72 79 20 2a 2f 0a 7d 20 70 63 61 63 68 65  mory */.} pcache
2740: 31 5f 67 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 20  1_g;../*.** All 
2750: 63 6f 64 65 20 69 6e 20 74 68 69 73 20 66 69 6c  code in this fil
2760: 65 20 73 68 6f 75 6c 64 20 61 63 63 65 73 73 20  e should access 
2770: 74 68 65 20 67 6c 6f 62 61 6c 20 73 74 72 75 63  the global struc
2780: 74 75 72 65 20 61 62 6f 76 65 20 76 69 61 20 74  ture above via t
2790: 68 65 0a 2a 2a 20 61 6c 69 61 73 20 22 70 63 61  he.** alias "pca
27a0: 63 68 65 31 22 2e 20 54 68 69 73 20 65 6e 73 75  che1". This ensu
27b0: 72 65 73 20 74 68 61 74 20 74 68 65 20 57 53 44  res that the WSD
27c0: 20 65 6d 75 6c 61 74 69 6f 6e 20 69 73 20 75 73   emulation is us
27d0: 65 64 20 77 68 65 6e 0a 2a 2a 20 63 6f 6d 70 69  ed when.** compi
27e0: 6c 69 6e 67 20 66 6f 72 20 73 79 73 74 65 6d 73  ling for systems
27f0: 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 73 75 70   that do not sup
2800: 70 6f 72 74 20 72 65 61 6c 20 57 53 44 2e 0a 2a  port real WSD..*
2810: 2f 0a 23 64 65 66 69 6e 65 20 70 63 61 63 68 65  /.#define pcache
2820: 31 20 28 47 4c 4f 42 41 4c 28 73 74 72 75 63 74  1 (GLOBAL(struct
2830: 20 50 43 61 63 68 65 47 6c 6f 62 61 6c 2c 20 70   PCacheGlobal, p
2840: 63 61 63 68 65 31 5f 67 29 29 0a 0a 2f 2a 0a 2a  cache1_g))../*.*
2850: 2a 20 4d 61 63 72 6f 73 20 74 6f 20 65 6e 74 65  * Macros to ente
2860: 72 20 61 6e 64 20 6c 65 61 76 65 20 74 68 65 20  r and leave the 
2870: 50 43 61 63 68 65 20 4c 52 55 20 6d 75 74 65 78  PCache LRU mutex
2880: 2e 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65  ..*/.#if !define
2890: 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  d(SQLITE_ENABLE_
28a0: 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e  MEMORY_MANAGEMEN
28b0: 54 29 20 7c 7c 20 53 51 4c 49 54 45 5f 54 48 52  T) || SQLITE_THR
28c0: 45 41 44 53 41 46 45 3d 3d 30 0a 23 20 64 65 66  EADSAFE==0.# def
28d0: 69 6e 65 20 70 63 61 63 68 65 31 45 6e 74 65 72  ine pcache1Enter
28e0: 4d 75 74 65 78 28 58 29 20 20 61 73 73 65 72 74  Mutex(X)  assert
28f0: 28 28 58 29 2d 3e 6d 75 74 65 78 3d 3d 30 29 0a  ((X)->mutex==0).
2900: 23 20 64 65 66 69 6e 65 20 70 63 61 63 68 65 31  # define pcache1
2910: 4c 65 61 76 65 4d 75 74 65 78 28 58 29 20 20 61  LeaveMutex(X)  a
2920: 73 73 65 72 74 28 28 58 29 2d 3e 6d 75 74 65 78  ssert((X)->mutex
2930: 3d 3d 30 29 0a 23 20 64 65 66 69 6e 65 20 50 43  ==0).# define PC
2940: 41 43 48 45 31 5f 4d 49 47 48 54 5f 55 53 45 5f  ACHE1_MIGHT_USE_
2950: 47 52 4f 55 50 5f 4d 55 54 45 58 20 30 0a 23 65  GROUP_MUTEX 0.#e
2960: 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 70 63 61  lse.# define pca
2970: 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 58  che1EnterMutex(X
2980: 29 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ) sqlite3_mutex_
2990: 65 6e 74 65 72 28 28 58 29 2d 3e 6d 75 74 65 78  enter((X)->mutex
29a0: 29 0a 23 20 64 65 66 69 6e 65 20 70 63 61 63 68  ).# define pcach
29b0: 65 31 4c 65 61 76 65 4d 75 74 65 78 28 58 29 20  e1LeaveMutex(X) 
29c0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65  sqlite3_mutex_le
29d0: 61 76 65 28 28 58 29 2d 3e 6d 75 74 65 78 29 0a  ave((X)->mutex).
29e0: 23 20 64 65 66 69 6e 65 20 50 43 41 43 48 45 31  # define PCACHE1
29f0: 5f 4d 49 47 48 54 5f 55 53 45 5f 47 52 4f 55 50  _MIGHT_USE_GROUP
2a00: 5f 4d 55 54 45 58 20 31 0a 23 65 6e 64 69 66 0a  _MUTEX 1.#endif.
2a10: 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ./**************
2a20: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2a30: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2a40: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2a50: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2a60: 2f 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 20 50 61 67 65  /./******** Page
2a70: 20 41 6c 6c 6f 63 61 74 69 6f 6e 2f 53 51 4c 49   Allocation/SQLI
2a80: 54 45 5f 43 4f 4e 46 49 47 5f 50 43 41 43 48 45  TE_CONFIG_PCACHE
2a90: 20 52 65 6c 61 74 65 64 20 46 75 6e 63 74 69 6f   Related Functio
2aa0: 6e 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ns *************
2ab0: 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  */.../*.** This 
2ac0: 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c  function is call
2ad0: 65 64 20 64 75 72 69 6e 67 20 69 6e 69 74 69 61  ed during initia
2ae0: 6c 69 7a 61 74 69 6f 6e 20 69 66 20 61 20 73 74  lization if a st
2af0: 61 74 69 63 20 62 75 66 66 65 72 20 69 73 20 0a  atic buffer is .
2b00: 2a 2a 20 73 75 70 70 6c 69 65 64 20 74 6f 20 75  ** supplied to u
2b10: 73 65 20 66 6f 72 20 74 68 65 20 70 61 67 65 2d  se for the page-
2b20: 63 61 63 68 65 20 62 79 20 70 61 73 73 69 6e 67  cache by passing
2b30: 20 74 68 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46   the SQLITE_CONF
2b40: 49 47 5f 50 41 47 45 43 41 43 48 45 0a 2a 2a 20  IG_PAGECACHE.** 
2b50: 76 65 72 62 20 74 6f 20 73 71 6c 69 74 65 33 5f  verb to sqlite3_
2b60: 63 6f 6e 66 69 67 28 29 2e 20 50 61 72 61 6d 65  config(). Parame
2b70: 74 65 72 20 70 42 75 66 20 70 6f 69 6e 74 73 20  ter pBuf points 
2b80: 74 6f 20 61 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e  to an allocation
2b90: 20 6c 61 72 67 65 0a 2a 2a 20 65 6e 6f 75 67 68   large.** enough
2ba0: 20 74 6f 20 63 6f 6e 74 61 69 6e 20 27 6e 27 20   to contain 'n' 
2bb0: 62 75 66 66 65 72 73 20 6f 66 20 27 73 7a 27 20  buffers of 'sz' 
2bc0: 62 79 74 65 73 20 65 61 63 68 2e 0a 2a 2a 0a 2a  bytes each..**.*
2bd0: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69  * This routine i
2be0: 73 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 73 71  s called from sq
2bf0: 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65  lite3_initialize
2c00: 28 29 20 61 6e 64 20 73 6f 20 69 74 20 69 73 20  () and so it is 
2c10: 67 75 61 72 61 6e 74 65 65 64 0a 2a 2a 20 74 6f  guaranteed.** to
2c20: 20 62 65 20 73 65 72 69 61 6c 69 7a 65 64 20 61   be serialized a
2c30: 6c 72 65 61 64 79 2e 20 20 54 68 65 72 65 20 69  lready.  There i
2c40: 73 20 6e 6f 20 6e 65 65 64 20 66 6f 72 20 66 75  s no need for fu
2c50: 72 74 68 65 72 20 6d 75 74 65 78 69 6e 67 2e 0a  rther mutexing..
2c60: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50  */.void sqlite3P
2c70: 43 61 63 68 65 42 75 66 66 65 72 53 65 74 75 70  CacheBufferSetup
2c80: 28 76 6f 69 64 20 2a 70 42 75 66 2c 20 69 6e 74  (void *pBuf, int
2c90: 20 73 7a 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 69   sz, int n){.  i
2ca0: 66 28 20 70 63 61 63 68 65 31 2e 69 73 49 6e 69  f( pcache1.isIni
2cb0: 74 20 29 7b 0a 20 20 20 20 50 67 46 72 65 65 73  t ){.    PgFrees
2cc0: 6c 6f 74 20 2a 70 3b 0a 20 20 20 20 69 66 28 20  lot *p;.    if( 
2cd0: 70 42 75 66 3d 3d 30 20 29 20 73 7a 20 3d 20 6e  pBuf==0 ) sz = n
2ce0: 20 3d 20 30 3b 0a 20 20 20 20 73 7a 20 3d 20 52   = 0;.    sz = R
2cf0: 4f 55 4e 44 44 4f 57 4e 38 28 73 7a 29 3b 0a 20  OUNDDOWN8(sz);. 
2d00: 20 20 20 70 63 61 63 68 65 31 2e 73 7a 53 6c 6f     pcache1.szSlo
2d10: 74 20 3d 20 73 7a 3b 0a 20 20 20 20 70 63 61 63  t = sz;.    pcac
2d20: 68 65 31 2e 6e 53 6c 6f 74 20 3d 20 70 63 61 63  he1.nSlot = pcac
2d30: 68 65 31 2e 6e 46 72 65 65 53 6c 6f 74 20 3d 20  he1.nFreeSlot = 
2d40: 6e 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 6e  n;.    pcache1.n
2d50: 52 65 73 65 72 76 65 20 3d 20 6e 3e 39 30 20 3f  Reserve = n>90 ?
2d60: 20 31 30 20 3a 20 28 6e 2f 31 30 20 2b 20 31 29   10 : (n/10 + 1)
2d70: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 70 53  ;.    pcache1.pS
2d80: 74 61 72 74 20 3d 20 70 42 75 66 3b 0a 20 20 20  tart = pBuf;.   
2d90: 20 70 63 61 63 68 65 31 2e 70 46 72 65 65 20 3d   pcache1.pFree =
2da0: 20 30 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e   0;.    pcache1.
2db0: 62 55 6e 64 65 72 50 72 65 73 73 75 72 65 20 3d  bUnderPressure =
2dc0: 20 30 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 6e   0;.    while( n
2dd0: 2d 2d 20 29 7b 0a 20 20 20 20 20 20 70 20 3d 20  -- ){.      p = 
2de0: 28 50 67 46 72 65 65 73 6c 6f 74 2a 29 70 42 75  (PgFreeslot*)pBu
2df0: 66 3b 0a 20 20 20 20 20 20 70 2d 3e 70 4e 65 78  f;.      p->pNex
2e00: 74 20 3d 20 70 63 61 63 68 65 31 2e 70 46 72 65  t = pcache1.pFre
2e10: 65 3b 0a 20 20 20 20 20 20 70 63 61 63 68 65 31  e;.      pcache1
2e20: 2e 70 46 72 65 65 20 3d 20 70 3b 0a 20 20 20 20  .pFree = p;.    
2e30: 20 20 70 42 75 66 20 3d 20 28 76 6f 69 64 2a 29    pBuf = (void*)
2e40: 26 28 28 63 68 61 72 2a 29 70 42 75 66 29 5b 73  &((char*)pBuf)[s
2e50: 7a 5d 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 63  z];.    }.    pc
2e60: 61 63 68 65 31 2e 70 45 6e 64 20 3d 20 70 42 75  ache1.pEnd = pBu
2e70: 66 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  f;.  }.}../*.** 
2e80: 54 72 79 20 74 6f 20 69 6e 69 74 69 61 6c 69 7a  Try to initializ
2e90: 65 20 74 68 65 20 70 43 61 63 68 65 2d 3e 70 46  e the pCache->pF
2ea0: 72 65 65 20 61 6e 64 20 70 43 61 63 68 65 2d 3e  ree and pCache->
2eb0: 70 42 75 6c 6b 20 66 69 65 6c 64 73 2e 20 20 52  pBulk fields.  R
2ec0: 65 74 75 72 6e 0a 2a 2a 20 74 72 75 65 20 69 66  eturn.** true if
2ed0: 20 70 43 61 63 68 65 2d 3e 70 46 72 65 65 20 65   pCache->pFree e
2ee0: 6e 64 73 20 75 70 20 63 6f 6e 74 61 69 6e 69 6e  nds up containin
2ef0: 67 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 66 72  g one or more fr
2f00: 65 65 20 70 61 67 65 73 2e 0a 2a 2f 0a 73 74 61  ee pages..*/.sta
2f10: 74 69 63 20 69 6e 74 20 70 63 61 63 68 65 31 49  tic int pcache1I
2f20: 6e 69 74 42 75 6c 6b 28 50 43 61 63 68 65 31 20  nitBulk(PCache1 
2f30: 2a 70 43 61 63 68 65 29 7b 0a 20 20 69 36 34 20  *pCache){.  i64 
2f40: 73 7a 42 75 6c 6b 3b 0a 20 20 63 68 61 72 20 2a  szBulk;.  char *
2f50: 7a 42 75 6c 6b 3b 0a 20 20 69 66 28 20 70 63 61  zBulk;.  if( pca
2f60: 63 68 65 31 2e 6e 49 6e 69 74 50 61 67 65 3d 3d  che1.nInitPage==
2f70: 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20  0 ) return 0;.  
2f80: 2f 2a 20 44 6f 20 6e 6f 74 20 62 6f 74 68 65 72  /* Do not bother
2f90: 20 77 69 74 68 20 61 20 62 75 6c 6b 20 61 6c 6c   with a bulk all
2fa0: 6f 63 61 74 69 6f 6e 20 69 66 20 74 68 65 20 63  ocation if the c
2fb0: 61 63 68 65 20 73 69 7a 65 20 76 65 72 79 20 73  ache size very s
2fc0: 6d 61 6c 6c 20 2a 2f 0a 20 20 69 66 28 20 70 43  mall */.  if( pC
2fd0: 61 63 68 65 2d 3e 6e 4d 61 78 3c 33 20 29 20 72  ache->nMax<3 ) r
2fe0: 65 74 75 72 6e 20 30 3b 0a 20 20 73 71 6c 69 74  eturn 0;.  sqlit
2ff0: 65 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c  e3BeginBenignMal
3000: 6c 6f 63 28 29 3b 0a 20 20 69 66 28 20 70 63 61  loc();.  if( pca
3010: 63 68 65 31 2e 6e 49 6e 69 74 50 61 67 65 3e 30  che1.nInitPage>0
3020: 20 29 7b 0a 20 20 20 20 73 7a 42 75 6c 6b 20 3d   ){.    szBulk =
3030: 20 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63   pCache->szAlloc
3040: 20 2a 20 28 69 36 34 29 70 63 61 63 68 65 31 2e   * (i64)pcache1.
3050: 6e 49 6e 69 74 50 61 67 65 3b 0a 20 20 7d 65 6c  nInitPage;.  }el
3060: 73 65 7b 0a 20 20 20 20 73 7a 42 75 6c 6b 20 3d  se{.    szBulk =
3070: 20 2d 31 30 32 34 20 2a 20 28 69 36 34 29 70 63   -1024 * (i64)pc
3080: 61 63 68 65 31 2e 6e 49 6e 69 74 50 61 67 65 3b  ache1.nInitPage;
3090: 0a 20 20 7d 0a 20 20 69 66 28 20 73 7a 42 75 6c  .  }.  if( szBul
30a0: 6b 20 3e 20 70 43 61 63 68 65 2d 3e 73 7a 41 6c  k > pCache->szAl
30b0: 6c 6f 63 2a 28 69 36 34 29 70 43 61 63 68 65 2d  loc*(i64)pCache-
30c0: 3e 6e 4d 61 78 20 29 7b 0a 20 20 20 20 73 7a 42  >nMax ){.    szB
30d0: 75 6c 6b 20 3d 20 70 43 61 63 68 65 2d 3e 73 7a  ulk = pCache->sz
30e0: 41 6c 6c 6f 63 2a 70 43 61 63 68 65 2d 3e 6e 4d  Alloc*pCache->nM
30f0: 61 78 3b 0a 20 20 7d 0a 20 20 7a 42 75 6c 6b 20  ax;.  }.  zBulk 
3100: 3d 20 70 43 61 63 68 65 2d 3e 70 42 75 6c 6b 20  = pCache->pBulk 
3110: 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28  = sqlite3Malloc(
3120: 20 73 7a 42 75 6c 6b 20 29 3b 0a 20 20 73 71 6c   szBulk );.  sql
3130: 69 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d 61 6c  ite3EndBenignMal
3140: 6c 6f 63 28 29 3b 0a 20 20 69 66 28 20 7a 42 75  loc();.  if( zBu
3150: 6c 6b 20 29 7b 0a 20 20 20 20 69 6e 74 20 6e 42  lk ){.    int nB
3160: 75 6c 6b 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c  ulk = sqlite3Mal
3170: 6c 6f 63 53 69 7a 65 28 7a 42 75 6c 6b 29 2f 70  locSize(zBulk)/p
3180: 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63 3b 0a  Cache->szAlloc;.
3190: 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 66      int i;.    f
31a0: 6f 72 28 69 3d 30 3b 20 69 3c 6e 42 75 6c 6b 3b  or(i=0; i<nBulk;
31b0: 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 50 67 48   i++){.      PgH
31c0: 64 72 31 20 2a 70 58 20 3d 20 28 50 67 48 64 72  dr1 *pX = (PgHdr
31d0: 31 2a 29 26 7a 42 75 6c 6b 5b 70 43 61 63 68 65  1*)&zBulk[pCache
31e0: 2d 3e 73 7a 50 61 67 65 5d 3b 0a 20 20 20 20 20  ->szPage];.     
31f0: 20 70 58 2d 3e 70 61 67 65 2e 70 42 75 66 20 3d   pX->page.pBuf =
3200: 20 7a 42 75 6c 6b 3b 0a 20 20 20 20 20 20 70 58   zBulk;.      pX
3210: 2d 3e 70 61 67 65 2e 70 45 78 74 72 61 20 3d 20  ->page.pExtra = 
3220: 26 70 58 5b 31 5d 3b 0a 20 20 20 20 20 20 70 58  &pX[1];.      pX
3230: 2d 3e 69 73 42 75 6c 6b 4c 6f 63 61 6c 20 3d 20  ->isBulkLocal = 
3240: 31 3b 0a 20 20 20 20 20 20 70 58 2d 3e 69 73 41  1;.      pX->isA
3250: 6e 63 68 6f 72 20 3d 20 30 3b 0a 20 20 20 20 20  nchor = 0;.     
3260: 20 70 58 2d 3e 70 4e 65 78 74 20 3d 20 70 43 61   pX->pNext = pCa
3270: 63 68 65 2d 3e 70 46 72 65 65 3b 0a 20 20 20 20  che->pFree;.    
3280: 20 20 70 43 61 63 68 65 2d 3e 70 46 72 65 65 20    pCache->pFree 
3290: 3d 20 70 58 3b 0a 20 20 20 20 20 20 7a 42 75 6c  = pX;.      zBul
32a0: 6b 20 2b 3d 20 70 43 61 63 68 65 2d 3e 73 7a 41  k += pCache->szA
32b0: 6c 6c 6f 63 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  lloc;.    }.  }.
32c0: 20 20 72 65 74 75 72 6e 20 70 43 61 63 68 65 2d    return pCache-
32d0: 3e 70 46 72 65 65 21 3d 30 3b 0a 7d 0a 0a 2f 2a  >pFree!=0;.}../*
32e0: 0a 2a 2a 20 4d 61 6c 6c 6f 63 20 66 75 6e 63 74  .** Malloc funct
32f0: 69 6f 6e 20 75 73 65 64 20 77 69 74 68 69 6e 20  ion used within 
3300: 74 68 69 73 20 66 69 6c 65 20 74 6f 20 61 6c 6c  this file to all
3310: 6f 63 61 74 65 20 73 70 61 63 65 20 66 72 6f 6d  ocate space from
3320: 20 74 68 65 20 62 75 66 66 65 72 0a 2a 2a 20 63   the buffer.** c
3330: 6f 6e 66 69 67 75 72 65 64 20 75 73 69 6e 67 20  onfigured using 
3340: 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 53  sqlite3_config(S
3350: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47  QLITE_CONFIG_PAG
3360: 45 43 41 43 48 45 29 20 6f 70 74 69 6f 6e 2e 20  ECACHE) option. 
3370: 49 66 20 6e 6f 20 0a 2a 2a 20 73 75 63 68 20 62  If no .** such b
3380: 75 66 66 65 72 20 65 78 69 73 74 73 20 6f 72 20  uffer exists or 
3390: 74 68 65 72 65 20 69 73 20 6e 6f 20 73 70 61 63  there is no spac
33a0: 65 20 6c 65 66 74 20 69 6e 20 69 74 2c 20 74 68  e left in it, th
33b0: 69 73 20 66 75 6e 63 74 69 6f 6e 20 66 61 6c 6c  is function fall
33c0: 73 20 0a 2a 2a 20 62 61 63 6b 20 74 6f 20 73 71  s .** back to sq
33d0: 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 29 2e 0a 2a  lite3Malloc()..*
33e0: 2a 0a 2a 2a 20 4d 75 6c 74 69 70 6c 65 20 74 68  *.** Multiple th
33f0: 72 65 61 64 73 20 63 61 6e 20 72 75 6e 20 74 68  reads can run th
3400: 69 73 20 72 6f 75 74 69 6e 65 20 61 74 20 74 68  is routine at th
3410: 65 20 73 61 6d 65 20 74 69 6d 65 2e 20 20 47 6c  e same time.  Gl
3420: 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 73 0a 2a  obal variables.*
3430: 2a 20 69 6e 20 70 63 61 63 68 65 31 20 6e 65 65  * in pcache1 nee
3440: 64 20 74 6f 20 62 65 20 70 72 6f 74 65 63 74 65  d to be protecte
3450: 64 20 76 69 61 20 6d 75 74 65 78 2e 0a 2a 2f 0a  d via mutex..*/.
3460: 73 74 61 74 69 63 20 76 6f 69 64 20 2a 70 63 61  static void *pca
3470: 63 68 65 31 41 6c 6c 6f 63 28 69 6e 74 20 6e 42  che1Alloc(int nB
3480: 79 74 65 29 7b 0a 20 20 76 6f 69 64 20 2a 70 20  yte){.  void *p 
3490: 3d 20 30 3b 0a 20 20 61 73 73 65 72 74 28 20 73  = 0;.  assert( s
34a0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6e 6f 74  qlite3_mutex_not
34b0: 68 65 6c 64 28 70 63 61 63 68 65 31 2e 67 72 70  held(pcache1.grp
34c0: 2e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28  .mutex) );.  if(
34d0: 20 6e 42 79 74 65 3c 3d 70 63 61 63 68 65 31 2e   nByte<=pcache1.
34e0: 73 7a 53 6c 6f 74 20 29 7b 0a 20 20 20 20 73 71  szSlot ){.    sq
34f0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
3500: 72 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29  r(pcache1.mutex)
3510: 3b 0a 20 20 20 20 70 20 3d 20 28 50 67 48 64 72  ;.    p = (PgHdr
3520: 31 20 2a 29 70 63 61 63 68 65 31 2e 70 46 72 65  1 *)pcache1.pFre
3530: 65 3b 0a 20 20 20 20 69 66 28 20 70 20 29 7b 0a  e;.    if( p ){.
3540: 20 20 20 20 20 20 70 63 61 63 68 65 31 2e 70 46        pcache1.pF
3550: 72 65 65 20 3d 20 70 63 61 63 68 65 31 2e 70 46  ree = pcache1.pF
3560: 72 65 65 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20  ree->pNext;.    
3570: 20 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65 53    pcache1.nFreeS
3580: 6c 6f 74 2d 2d 3b 0a 20 20 20 20 20 20 70 63 61  lot--;.      pca
3590: 63 68 65 31 2e 62 55 6e 64 65 72 50 72 65 73 73  che1.bUnderPress
35a0: 75 72 65 20 3d 20 70 63 61 63 68 65 31 2e 6e 46  ure = pcache1.nF
35b0: 72 65 65 53 6c 6f 74 3c 70 63 61 63 68 65 31 2e  reeSlot<pcache1.
35c0: 6e 52 65 73 65 72 76 65 3b 0a 20 20 20 20 20 20  nReserve;.      
35d0: 61 73 73 65 72 74 28 20 70 63 61 63 68 65 31 2e  assert( pcache1.
35e0: 6e 46 72 65 65 53 6c 6f 74 3e 3d 30 20 29 3b 0a  nFreeSlot>=0 );.
35f0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 53 74 61        sqlite3Sta
3600: 74 75 73 53 65 74 28 53 51 4c 49 54 45 5f 53 54  tusSet(SQLITE_ST
3610: 41 54 55 53 5f 50 41 47 45 43 41 43 48 45 5f 53  ATUS_PAGECACHE_S
3620: 49 5a 45 2c 20 6e 42 79 74 65 29 3b 0a 20 20 20  IZE, nByte);.   
3630: 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73     sqlite3Status
3640: 55 70 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53  Up(SQLITE_STATUS
3650: 5f 50 41 47 45 43 41 43 48 45 5f 55 53 45 44 2c  _PAGECACHE_USED,
3660: 20 31 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73   1);.    }.    s
3670: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
3680: 76 65 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78  ve(pcache1.mutex
3690: 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 3d 3d  );.  }.  if( p==
36a0: 30 20 29 7b 0a 20 20 20 20 2f 2a 20 4d 65 6d 6f  0 ){.    /* Memo
36b0: 72 79 20 69 73 20 6e 6f 74 20 61 76 61 69 6c 61  ry is not availa
36c0: 62 6c 65 20 69 6e 20 74 68 65 20 53 51 4c 49 54  ble in the SQLIT
36d0: 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43  E_CONFIG_PAGECAC
36e0: 48 45 20 70 6f 6f 6c 2e 20 20 47 65 74 0a 20 20  HE pool.  Get.  
36f0: 20 20 2a 2a 20 69 74 20 66 72 6f 6d 20 73 71 6c    ** it from sql
3700: 69 74 65 33 4d 61 6c 6c 6f 63 20 69 6e 73 74 65  ite3Malloc inste
3710: 61 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 70  ad..    */.    p
3720: 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63   = sqlite3Malloc
3730: 28 6e 42 79 74 65 29 3b 0a 23 69 66 6e 64 65 66  (nByte);.#ifndef
3740: 20 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f   SQLITE_DISABLE_
3750: 50 41 47 45 43 41 43 48 45 5f 4f 56 45 52 46 4c  PAGECACHE_OVERFL
3760: 4f 57 5f 53 54 41 54 53 0a 20 20 20 20 69 66 28  OW_STATS.    if(
3770: 20 70 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20   p ){.      int 
3780: 73 7a 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c  sz = sqlite3Mall
3790: 6f 63 53 69 7a 65 28 70 29 3b 0a 20 20 20 20 20  ocSize(p);.     
37a0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65   sqlite3_mutex_e
37b0: 6e 74 65 72 28 70 63 61 63 68 65 31 2e 6d 75 74  nter(pcache1.mut
37c0: 65 78 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74  ex);.      sqlit
37d0: 65 33 53 74 61 74 75 73 53 65 74 28 53 51 4c 49  e3StatusSet(SQLI
37e0: 54 45 5f 53 54 41 54 55 53 5f 50 41 47 45 43 41  TE_STATUS_PAGECA
37f0: 43 48 45 5f 53 49 5a 45 2c 20 6e 42 79 74 65 29  CHE_SIZE, nByte)
3800: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 53  ;.      sqlite3S
3810: 74 61 74 75 73 55 70 28 53 51 4c 49 54 45 5f 53  tatusUp(SQLITE_S
3820: 54 41 54 55 53 5f 50 41 47 45 43 41 43 48 45 5f  TATUS_PAGECACHE_
3830: 4f 56 45 52 46 4c 4f 57 2c 20 73 7a 29 3b 0a 20  OVERFLOW, sz);. 
3840: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74       sqlite3_mut
3850: 65 78 5f 6c 65 61 76 65 28 70 63 61 63 68 65 31  ex_leave(pcache1
3860: 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 7d 0a 23  .mutex);.    }.#
3870: 65 6e 64 69 66 0a 20 20 20 20 73 71 6c 69 74 65  endif.    sqlite
3880: 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65  3MemdebugSetType
3890: 28 70 2c 20 4d 45 4d 54 59 50 45 5f 50 43 41 43  (p, MEMTYPE_PCAC
38a0: 48 45 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72  HE);.  }.  retur
38b0: 6e 20 70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72  n p;.}../*.** Fr
38c0: 65 65 20 61 6e 20 61 6c 6c 6f 63 61 74 65 64 20  ee an allocated 
38d0: 62 75 66 66 65 72 20 6f 62 74 61 69 6e 65 64 20  buffer obtained 
38e0: 66 72 6f 6d 20 70 63 61 63 68 65 31 41 6c 6c 6f  from pcache1Allo
38f0: 63 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  c()..*/.static v
3900: 6f 69 64 20 70 63 61 63 68 65 31 46 72 65 65 28  oid pcache1Free(
3910: 76 6f 69 64 20 2a 70 29 7b 0a 20 20 69 6e 74 20  void *p){.  int 
3920: 6e 46 72 65 65 64 20 3d 20 30 3b 0a 20 20 69 66  nFreed = 0;.  if
3930: 28 20 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b  ( p==0 ) return;
3940: 0a 20 20 69 66 28 20 70 3e 3d 70 63 61 63 68 65  .  if( p>=pcache
3950: 31 2e 70 53 74 61 72 74 20 26 26 20 70 3c 70 63  1.pStart && p<pc
3960: 61 63 68 65 31 2e 70 45 6e 64 20 29 7b 0a 20 20  ache1.pEnd ){.  
3970: 20 20 50 67 46 72 65 65 73 6c 6f 74 20 2a 70 53    PgFreeslot *pS
3980: 6c 6f 74 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  lot;.    sqlite3
3990: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 63 61  _mutex_enter(pca
39a0: 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20 20  che1.mutex);.   
39b0: 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 44 6f   sqlite3StatusDo
39c0: 77 6e 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53  wn(SQLITE_STATUS
39d0: 5f 50 41 47 45 43 41 43 48 45 5f 55 53 45 44 2c  _PAGECACHE_USED,
39e0: 20 31 29 3b 0a 20 20 20 20 70 53 6c 6f 74 20 3d   1);.    pSlot =
39f0: 20 28 50 67 46 72 65 65 73 6c 6f 74 2a 29 70 3b   (PgFreeslot*)p;
3a00: 0a 20 20 20 20 70 53 6c 6f 74 2d 3e 70 4e 65 78  .    pSlot->pNex
3a10: 74 20 3d 20 70 63 61 63 68 65 31 2e 70 46 72 65  t = pcache1.pFre
3a20: 65 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 70  e;.    pcache1.p
3a30: 46 72 65 65 20 3d 20 70 53 6c 6f 74 3b 0a 20 20  Free = pSlot;.  
3a40: 20 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65 53    pcache1.nFreeS
3a50: 6c 6f 74 2b 2b 3b 0a 20 20 20 20 70 63 61 63 68  lot++;.    pcach
3a60: 65 31 2e 62 55 6e 64 65 72 50 72 65 73 73 75 72  e1.bUnderPressur
3a70: 65 20 3d 20 70 63 61 63 68 65 31 2e 6e 46 72 65  e = pcache1.nFre
3a80: 65 53 6c 6f 74 3c 70 63 61 63 68 65 31 2e 6e 52  eSlot<pcache1.nR
3a90: 65 73 65 72 76 65 3b 0a 20 20 20 20 61 73 73 65  eserve;.    asse
3aa0: 72 74 28 20 70 63 61 63 68 65 31 2e 6e 46 72 65  rt( pcache1.nFre
3ab0: 65 53 6c 6f 74 3c 3d 70 63 61 63 68 65 31 2e 6e  eSlot<=pcache1.n
3ac0: 53 6c 6f 74 20 29 3b 0a 20 20 20 20 73 71 6c 69  Slot );.    sqli
3ad0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
3ae0: 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a  pcache1.mutex);.
3af0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73    }else{.    ass
3b00: 65 72 74 28 20 73 71 6c 69 74 65 33 4d 65 6d 64  ert( sqlite3Memd
3b10: 65 62 75 67 48 61 73 54 79 70 65 28 70 2c 20 4d  ebugHasType(p, M
3b20: 45 4d 54 59 50 45 5f 50 43 41 43 48 45 29 20 29  EMTYPE_PCACHE) )
3b30: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 4d 65 6d  ;.    sqlite3Mem
3b40: 64 65 62 75 67 53 65 74 54 79 70 65 28 70 2c 20  debugSetType(p, 
3b50: 4d 45 4d 54 59 50 45 5f 48 45 41 50 29 3b 0a 23  MEMTYPE_HEAP);.#
3b60: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 49  ifndef SQLITE_DI
3b70: 53 41 42 4c 45 5f 50 41 47 45 43 41 43 48 45 5f  SABLE_PAGECACHE_
3b80: 4f 56 45 52 46 4c 4f 57 5f 53 54 41 54 53 0a 20  OVERFLOW_STATS. 
3b90: 20 20 20 6e 46 72 65 65 64 20 3d 20 73 71 6c 69     nFreed = sqli
3ba0: 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 29  te3MallocSize(p)
3bb0: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75  ;.    sqlite3_mu
3bc0: 74 65 78 5f 65 6e 74 65 72 28 70 63 61 63 68 65  tex_enter(pcache
3bd0: 31 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 73 71  1.mutex);.    sq
3be0: 6c 69 74 65 33 53 74 61 74 75 73 44 6f 77 6e 28  lite3StatusDown(
3bf0: 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 50 41  SQLITE_STATUS_PA
3c00: 47 45 43 41 43 48 45 5f 4f 56 45 52 46 4c 4f 57  GECACHE_OVERFLOW
3c10: 2c 20 6e 46 72 65 65 64 29 3b 0a 20 20 20 20 73  , nFreed);.    s
3c20: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
3c30: 76 65 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78  ve(pcache1.mutex
3c40: 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 73 71  );.#endif.    sq
3c50: 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 20  lite3_free(p);. 
3c60: 20 7d 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c   }.}..#ifdef SQL
3c70: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52  ITE_ENABLE_MEMOR
3c80: 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 2f 2a 0a  Y_MANAGEMENT./*.
3c90: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 73 69  ** Return the si
3ca0: 7a 65 20 6f 66 20 61 20 70 63 61 63 68 65 20 61  ze of a pcache a
3cb0: 6c 6c 6f 63 61 74 69 6f 6e 0a 2a 2f 0a 73 74 61  llocation.*/.sta
3cc0: 74 69 63 20 69 6e 74 20 70 63 61 63 68 65 31 4d  tic int pcache1M
3cd0: 65 6d 53 69 7a 65 28 76 6f 69 64 20 2a 70 29 7b  emSize(void *p){
3ce0: 0a 20 20 69 66 28 20 70 3e 3d 70 63 61 63 68 65  .  if( p>=pcache
3cf0: 31 2e 70 53 74 61 72 74 20 26 26 20 70 3c 70 63  1.pStart && p<pc
3d00: 61 63 68 65 31 2e 70 45 6e 64 20 29 7b 0a 20 20  ache1.pEnd ){.  
3d10: 20 20 72 65 74 75 72 6e 20 70 63 61 63 68 65 31    return pcache1
3d20: 2e 73 7a 53 6c 6f 74 3b 0a 20 20 7d 65 6c 73 65  .szSlot;.  }else
3d30: 7b 0a 20 20 20 20 69 6e 74 20 69 53 69 7a 65 3b  {.    int iSize;
3d40: 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c  .    assert( sql
3d50: 69 74 65 33 4d 65 6d 64 65 62 75 67 48 61 73 54  ite3MemdebugHasT
3d60: 79 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 50  ype(p, MEMTYPE_P
3d70: 43 41 43 48 45 29 20 29 3b 0a 20 20 20 20 73 71  CACHE) );.    sq
3d80: 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 53 65 74  lite3MemdebugSet
3d90: 54 79 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f  Type(p, MEMTYPE_
3da0: 48 45 41 50 29 3b 0a 20 20 20 20 69 53 69 7a 65  HEAP);.    iSize
3db0: 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63   = sqlite3Malloc
3dc0: 53 69 7a 65 28 70 29 3b 0a 20 20 20 20 73 71 6c  Size(p);.    sql
3dd0: 69 74 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54  ite3MemdebugSetT
3de0: 79 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 50  ype(p, MEMTYPE_P
3df0: 43 41 43 48 45 29 3b 0a 20 20 20 20 72 65 74 75  CACHE);.    retu
3e00: 72 6e 20 69 53 69 7a 65 3b 0a 20 20 7d 0a 7d 0a  rn iSize;.  }.}.
3e10: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45  #endif /* SQLITE
3e20: 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d  _ENABLE_MEMORY_M
3e30: 41 4e 41 47 45 4d 45 4e 54 20 2a 2f 0a 0a 2f 2a  ANAGEMENT */../*
3e40: 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 61 20 6e  .** Allocate a n
3e50: 65 77 20 70 61 67 65 20 6f 62 6a 65 63 74 20 69  ew page object i
3e60: 6e 69 74 69 61 6c 6c 79 20 61 73 73 6f 63 69 61  nitially associa
3e70: 74 65 64 20 77 69 74 68 20 63 61 63 68 65 20 70  ted with cache p
3e80: 43 61 63 68 65 2e 0a 2a 2f 0a 73 74 61 74 69 63  Cache..*/.static
3e90: 20 50 67 48 64 72 31 20 2a 70 63 61 63 68 65 31   PgHdr1 *pcache1
3ea0: 41 6c 6c 6f 63 50 61 67 65 28 50 43 61 63 68 65  AllocPage(PCache
3eb0: 31 20 2a 70 43 61 63 68 65 2c 20 69 6e 74 20 62  1 *pCache, int b
3ec0: 65 6e 69 67 6e 4d 61 6c 6c 6f 63 29 7b 0a 20 20  enignMalloc){.  
3ed0: 50 67 48 64 72 31 20 2a 70 20 3d 20 30 3b 0a 20  PgHdr1 *p = 0;. 
3ee0: 20 76 6f 69 64 20 2a 70 50 67 3b 0a 0a 20 20 61   void *pPg;..  a
3ef0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d  ssert( sqlite3_m
3f00: 75 74 65 78 5f 68 65 6c 64 28 70 43 61 63 68 65  utex_held(pCache
3f10: 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29  ->pGroup->mutex)
3f20: 20 29 3b 0a 20 20 69 66 28 20 70 43 61 63 68 65   );.  if( pCache
3f30: 2d 3e 70 46 72 65 65 20 7c 7c 20 28 70 43 61 63  ->pFree || (pCac
3f40: 68 65 2d 3e 6e 50 61 67 65 3d 3d 30 20 26 26 20  he->nPage==0 && 
3f50: 70 63 61 63 68 65 31 49 6e 69 74 42 75 6c 6b 28  pcache1InitBulk(
3f60: 70 43 61 63 68 65 29 29 20 29 7b 0a 20 20 20 20  pCache)) ){.    
3f70: 70 20 3d 20 70 43 61 63 68 65 2d 3e 70 46 72 65  p = pCache->pFre
3f80: 65 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 70  e;.    pCache->p
3f90: 46 72 65 65 20 3d 20 70 2d 3e 70 4e 65 78 74 3b  Free = p->pNext;
3fa0: 0a 20 20 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20  .    p->pNext = 
3fb0: 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 23 69 66 64  0;.  }else{.#ifd
3fc0: 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  ef SQLITE_ENABLE
3fd0: 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45  _MEMORY_MANAGEME
3fe0: 4e 54 0a 20 20 20 20 2f 2a 20 54 68 65 20 67 72  NT.    /* The gr
3ff0: 6f 75 70 20 6d 75 74 65 78 20 6d 75 73 74 20 62  oup mutex must b
4000: 65 20 72 65 6c 65 61 73 65 64 20 62 65 66 6f 72  e released befor
4010: 65 20 70 63 61 63 68 65 31 41 6c 6c 6f 63 28 29  e pcache1Alloc()
4020: 20 69 73 20 63 61 6c 6c 65 64 2e 20 54 68 69 73   is called. This
4030: 0a 20 20 20 20 2a 2a 20 69 73 20 62 65 63 61 75  .    ** is becau
4040: 73 65 20 69 74 20 6d 69 67 68 74 20 63 61 6c 6c  se it might call
4050: 20 73 71 6c 69 74 65 33 5f 72 65 6c 65 61 73 65   sqlite3_release
4060: 5f 6d 65 6d 6f 72 79 28 29 2c 20 77 68 69 63 68  _memory(), which
4070: 20 61 73 73 75 6d 65 73 20 74 68 61 74 20 0a 20   assumes that . 
4080: 20 20 20 2a 2a 20 74 68 69 73 20 6d 75 74 65 78     ** this mutex
4090: 20 69 73 20 6e 6f 74 20 68 65 6c 64 2e 20 2a 2f   is not held. */
40a0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 63 61  .    assert( pca
40b0: 63 68 65 31 2e 73 65 70 61 72 61 74 65 43 61 63  che1.separateCac
40c0: 68 65 3d 3d 30 20 29 3b 0a 20 20 20 20 61 73 73  he==0 );.    ass
40d0: 65 72 74 28 20 70 43 61 63 68 65 2d 3e 70 47 72  ert( pCache->pGr
40e0: 6f 75 70 3d 3d 26 70 63 61 63 68 65 31 2e 67 72  oup==&pcache1.gr
40f0: 70 20 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31  p );.    pcache1
4100: 4c 65 61 76 65 4d 75 74 65 78 28 70 43 61 63 68  LeaveMutex(pCach
4110: 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 23 65 6e 64  e->pGroup);.#end
4120: 69 66 0a 20 20 20 20 69 66 28 20 62 65 6e 69 67  if.    if( benig
4130: 6e 4d 61 6c 6c 6f 63 20 29 20 73 71 6c 69 74 65  nMalloc ) sqlite
4140: 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c  3BeginBenignMall
4150: 6f 63 28 29 3b 0a 23 69 66 64 65 66 20 53 51 4c  oc();.#ifdef SQL
4160: 49 54 45 5f 50 43 41 43 48 45 5f 53 45 50 41 52  ITE_PCACHE_SEPAR
4170: 41 54 45 5f 48 45 41 44 45 52 0a 20 20 20 20 70  ATE_HEADER.    p
4180: 50 67 20 3d 20 70 63 61 63 68 65 31 41 6c 6c 6f  Pg = pcache1Allo
4190: 63 28 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65  c(pCache->szPage
41a0: 29 3b 0a 20 20 20 20 70 20 3d 20 73 71 6c 69 74  );.    p = sqlit
41b0: 65 33 4d 61 6c 6c 6f 63 28 73 69 7a 65 6f 66 28  e3Malloc(sizeof(
41c0: 50 67 48 64 72 31 29 20 2b 20 70 43 61 63 68 65  PgHdr1) + pCache
41d0: 2d 3e 73 7a 45 78 74 72 61 29 3b 0a 20 20 20 20  ->szExtra);.    
41e0: 69 66 28 20 21 70 50 67 20 7c 7c 20 21 70 20 29  if( !pPg || !p )
41f0: 7b 0a 20 20 20 20 20 20 70 63 61 63 68 65 31 46  {.      pcache1F
4200: 72 65 65 28 70 50 67 29 3b 0a 20 20 20 20 20 20  ree(pPg);.      
4210: 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b  sqlite3_free(p);
4220: 0a 20 20 20 20 20 20 70 50 67 20 3d 20 30 3b 0a  .      pPg = 0;.
4230: 20 20 20 20 7d 0a 23 65 6c 73 65 0a 20 20 20 20      }.#else.    
4240: 70 50 67 20 3d 20 70 63 61 63 68 65 31 41 6c 6c  pPg = pcache1All
4250: 6f 63 28 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c  oc(pCache->szAll
4260: 6f 63 29 3b 0a 20 20 20 20 70 20 3d 20 28 50 67  oc);.    p = (Pg
4270: 48 64 72 31 20 2a 29 26 28 28 75 38 20 2a 29 70  Hdr1 *)&((u8 *)p
4280: 50 67 29 5b 70 43 61 63 68 65 2d 3e 73 7a 50 61  Pg)[pCache->szPa
4290: 67 65 5d 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20  ge];.#endif.    
42a0: 69 66 28 20 62 65 6e 69 67 6e 4d 61 6c 6c 6f 63  if( benignMalloc
42b0: 20 29 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e   ) sqlite3EndBen
42c0: 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 23 69 66  ignMalloc();.#if
42d0: 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c  def SQLITE_ENABL
42e0: 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d  E_MEMORY_MANAGEM
42f0: 45 4e 54 0a 20 20 20 20 70 63 61 63 68 65 31 45  ENT.    pcache1E
4300: 6e 74 65 72 4d 75 74 65 78 28 70 43 61 63 68 65  nterMutex(pCache
4310: 2d 3e 70 47 72 6f 75 70 29 3b 0a 23 65 6e 64 69  ->pGroup);.#endi
4320: 66 0a 20 20 20 20 69 66 28 20 70 50 67 3d 3d 30  f.    if( pPg==0
4330: 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 20   ) return 0;.   
4340: 20 70 2d 3e 70 61 67 65 2e 70 42 75 66 20 3d 20   p->page.pBuf = 
4350: 70 50 67 3b 0a 20 20 20 20 70 2d 3e 70 61 67 65  pPg;.    p->page
4360: 2e 70 45 78 74 72 61 20 3d 20 26 70 5b 31 5d 3b  .pExtra = &p[1];
4370: 0a 20 20 20 20 70 2d 3e 69 73 42 75 6c 6b 4c 6f  .    p->isBulkLo
4380: 63 61 6c 20 3d 20 30 3b 0a 20 20 20 20 70 2d 3e  cal = 0;.    p->
4390: 69 73 41 6e 63 68 6f 72 20 3d 20 30 3b 0a 20 20  isAnchor = 0;.  
43a0: 7d 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e  }.  if( pCache->
43b0: 62 50 75 72 67 65 61 62 6c 65 20 29 7b 0a 20 20  bPurgeable ){.  
43c0: 20 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70    pCache->pGroup
43d0: 2d 3e 6e 43 75 72 72 65 6e 74 50 61 67 65 2b 2b  ->nCurrentPage++
43e0: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70  ;.  }.  return p
43f0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20  ;.}../*.** Free 
4400: 61 20 70 61 67 65 20 6f 62 6a 65 63 74 20 61 6c  a page object al
4410: 6c 6f 63 61 74 65 64 20 62 79 20 70 63 61 63 68  located by pcach
4420: 65 31 41 6c 6c 6f 63 50 61 67 65 28 29 2e 0a 2a  e1AllocPage()..*
4430: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63  /.static void pc
4440: 61 63 68 65 31 46 72 65 65 50 61 67 65 28 50 67  ache1FreePage(Pg
4450: 48 64 72 31 20 2a 70 29 7b 0a 20 20 50 43 61 63  Hdr1 *p){.  PCac
4460: 68 65 31 20 2a 70 43 61 63 68 65 3b 0a 20 20 61  he1 *pCache;.  a
4470: 73 73 65 72 74 28 20 70 21 3d 30 20 29 3b 0a 20  ssert( p!=0 );. 
4480: 20 70 43 61 63 68 65 20 3d 20 70 2d 3e 70 43 61   pCache = p->pCa
4490: 63 68 65 3b 0a 20 20 61 73 73 65 72 74 28 20 73  che;.  assert( s
44a0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c  qlite3_mutex_hel
44b0: 64 28 70 2d 3e 70 43 61 63 68 65 2d 3e 70 47 72  d(p->pCache->pGr
44c0: 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20  oup->mutex) );. 
44d0: 20 69 66 28 20 70 2d 3e 69 73 42 75 6c 6b 4c 6f   if( p->isBulkLo
44e0: 63 61 6c 20 29 7b 0a 20 20 20 20 70 2d 3e 70 4e  cal ){.    p->pN
44f0: 65 78 74 20 3d 20 70 43 61 63 68 65 2d 3e 70 46  ext = pCache->pF
4500: 72 65 65 3b 0a 20 20 20 20 70 43 61 63 68 65 2d  ree;.    pCache-
4510: 3e 70 46 72 65 65 20 3d 20 70 3b 0a 20 20 7d 65  >pFree = p;.  }e
4520: 6c 73 65 7b 0a 20 20 20 20 70 63 61 63 68 65 31  lse{.    pcache1
4530: 46 72 65 65 28 70 2d 3e 70 61 67 65 2e 70 42 75  Free(p->page.pBu
4540: 66 29 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54  f);.#ifdef SQLIT
4550: 45 5f 50 43 41 43 48 45 5f 53 45 50 41 52 41 54  E_PCACHE_SEPARAT
4560: 45 5f 48 45 41 44 45 52 0a 20 20 20 20 73 71 6c  E_HEADER.    sql
4570: 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 23 65  ite3_free(p);.#e
4580: 6e 64 69 66 0a 20 20 7d 0a 20 20 69 66 28 20 70  ndif.  }.  if( p
4590: 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c  Cache->bPurgeabl
45a0: 65 20 29 7b 0a 20 20 20 20 70 43 61 63 68 65 2d  e ){.    pCache-
45b0: 3e 70 47 72 6f 75 70 2d 3e 6e 43 75 72 72 65 6e  >pGroup->nCurren
45c0: 74 50 61 67 65 2d 2d 3b 0a 20 20 7d 0a 7d 0a 0a  tPage--;.  }.}..
45d0: 2f 2a 0a 2a 2a 20 4d 61 6c 6c 6f 63 20 66 75 6e  /*.** Malloc fun
45e0: 63 74 69 6f 6e 20 75 73 65 64 20 62 79 20 53 51  ction used by SQ
45f0: 4c 69 74 65 20 74 6f 20 6f 62 74 61 69 6e 20 73  Lite to obtain s
4600: 70 61 63 65 20 66 72 6f 6d 20 74 68 65 20 62 75  pace from the bu
4610: 66 66 65 72 20 63 6f 6e 66 69 67 75 72 65 64 0a  ffer configured.
4620: 2a 2a 20 75 73 69 6e 67 20 73 71 6c 69 74 65 33  ** using sqlite3
4630: 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f 43  _config(SQLITE_C
4640: 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45 29  ONFIG_PAGECACHE)
4650: 20 6f 70 74 69 6f 6e 2e 20 49 66 20 6e 6f 20 73   option. If no s
4660: 75 63 68 20 62 75 66 66 65 72 0a 2a 2a 20 65 78  uch buffer.** ex
4670: 69 73 74 73 2c 20 74 68 69 73 20 66 75 6e 63 74  ists, this funct
4680: 69 6f 6e 20 66 61 6c 6c 73 20 62 61 63 6b 20 74  ion falls back t
4690: 6f 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28  o sqlite3Malloc(
46a0: 29 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69  )..*/.void *sqli
46b0: 74 65 33 50 61 67 65 4d 61 6c 6c 6f 63 28 69 6e  te3PageMalloc(in
46c0: 74 20 73 7a 29 7b 0a 20 20 72 65 74 75 72 6e 20  t sz){.  return 
46d0: 70 63 61 63 68 65 31 41 6c 6c 6f 63 28 73 7a 29  pcache1Alloc(sz)
46e0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20  ;.}../*.** Free 
46f0: 61 6e 20 61 6c 6c 6f 63 61 74 65 64 20 62 75 66  an allocated buf
4700: 66 65 72 20 6f 62 74 61 69 6e 65 64 20 66 72 6f  fer obtained fro
4710: 6d 20 73 71 6c 69 74 65 33 50 61 67 65 4d 61 6c  m sqlite3PageMal
4720: 6c 6f 63 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 73  loc()..*/.void s
4730: 71 6c 69 74 65 33 50 61 67 65 46 72 65 65 28 76  qlite3PageFree(v
4740: 6f 69 64 20 2a 70 29 7b 0a 20 20 70 63 61 63 68  oid *p){.  pcach
4750: 65 31 46 72 65 65 28 70 29 3b 0a 7d 0a 0a 0a 2f  e1Free(p);.}.../
4760: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 72 75 65  *.** Return true
4770: 20 69 66 20 69 74 20 64 65 73 69 72 61 62 6c 65   if it desirable
4780: 20 74 6f 20 61 76 6f 69 64 20 61 6c 6c 6f 63 61   to avoid alloca
4790: 74 69 6e 67 20 61 20 6e 65 77 20 70 61 67 65 20  ting a new page 
47a0: 63 61 63 68 65 0a 2a 2a 20 65 6e 74 72 79 2e 0a  cache.** entry..
47b0: 2a 2a 0a 2a 2a 20 49 66 20 6d 65 6d 6f 72 79 20  **.** If memory 
47c0: 77 61 73 20 61 6c 6c 6f 63 61 74 65 64 20 73 70  was allocated sp
47d0: 65 63 69 66 69 63 61 6c 6c 79 20 74 6f 20 74 68  ecifically to th
47e0: 65 20 70 61 67 65 20 63 61 63 68 65 20 75 73 69  e page cache usi
47f0: 6e 67 0a 2a 2a 20 53 51 4c 49 54 45 5f 43 4f 4e  ng.** SQLITE_CON
4800: 46 49 47 5f 50 41 47 45 43 41 43 48 45 20 62 75  FIG_PAGECACHE bu
4810: 74 20 74 68 61 74 20 6d 65 6d 6f 72 79 20 68 61  t that memory ha
4820: 73 20 61 6c 6c 20 62 65 65 6e 20 75 73 65 64 2c  s all been used,
4830: 20 74 68 65 6e 0a 2a 2a 20 69 74 20 69 73 20 64   then.** it is d
4840: 65 73 69 72 61 62 6c 65 20 74 6f 20 61 76 6f 69  esirable to avoi
4850: 64 20 61 6c 6c 6f 63 61 74 69 6e 67 20 61 20 6e  d allocating a n
4860: 65 77 20 70 61 67 65 20 63 61 63 68 65 20 65 6e  ew page cache en
4870: 74 72 79 20 62 65 63 61 75 73 65 0a 2a 2a 20 70  try because.** p
4880: 72 65 73 75 6d 61 62 6c 79 20 53 51 4c 49 54 45  resumably SQLITE
4890: 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48  _CONFIG_PAGECACH
48a0: 45 20 77 61 73 20 73 75 70 70 6f 73 65 20 74 6f  E was suppose to
48b0: 20 62 65 20 73 75 66 66 69 63 69 65 6e 74 0a 2a   be sufficient.*
48c0: 2a 20 66 6f 72 20 61 6c 6c 20 70 61 67 65 20 63  * for all page c
48d0: 61 63 68 65 20 6e 65 65 64 73 20 61 6e 64 20 77  ache needs and w
48e0: 65 20 73 68 6f 75 6c 64 20 6e 6f 74 20 6e 65 65  e should not nee
48f0: 64 20 74 6f 20 73 70 69 6c 6c 20 74 68 65 0a 2a  d to spill the.*
4900: 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 6f 6e 74  * allocation ont
4910: 6f 20 74 68 65 20 68 65 61 70 2e 0a 2a 2a 0a 2a  o the heap..**.*
4920: 2a 20 4f 72 2c 20 74 68 65 20 68 65 61 70 20 69  * Or, the heap i
4930: 73 20 75 73 65 64 20 66 6f 72 20 61 6c 6c 20 70  s used for all p
4940: 61 67 65 20 63 61 63 68 65 20 6d 65 6d 6f 72 79  age cache memory
4950: 20 62 75 74 20 74 68 65 20 68 65 61 70 20 69 73   but the heap is
4960: 0a 2a 2a 20 75 6e 64 65 72 20 6d 65 6d 6f 72 79  .** under memory
4970: 20 70 72 65 73 73 75 72 65 2c 20 74 68 65 6e 20   pressure, then 
4980: 61 67 61 69 6e 20 69 74 20 69 73 20 64 65 73 69  again it is desi
4990: 72 61 62 6c 65 20 74 6f 20 61 76 6f 69 64 0a 2a  rable to avoid.*
49a0: 2a 20 61 6c 6c 6f 63 61 74 69 6e 67 20 61 20 6e  * allocating a n
49b0: 65 77 20 70 61 67 65 20 63 61 63 68 65 20 65 6e  ew page cache en
49c0: 74 72 79 20 69 6e 20 6f 72 64 65 72 20 74 6f 20  try in order to 
49d0: 61 76 6f 69 64 20 73 74 72 65 73 73 69 6e 67 0a  avoid stressing.
49e0: 2a 2a 20 74 68 65 20 68 65 61 70 20 65 76 65 6e  ** the heap even
49f0: 20 66 75 72 74 68 65 72 2e 0a 2a 2f 0a 73 74 61   further..*/.sta
4a00: 74 69 63 20 69 6e 74 20 70 63 61 63 68 65 31 55  tic int pcache1U
4a10: 6e 64 65 72 4d 65 6d 6f 72 79 50 72 65 73 73 75  nderMemoryPressu
4a20: 72 65 28 50 43 61 63 68 65 31 20 2a 70 43 61 63  re(PCache1 *pCac
4a30: 68 65 29 7b 0a 20 20 69 66 28 20 70 63 61 63 68  he){.  if( pcach
4a40: 65 31 2e 6e 53 6c 6f 74 20 26 26 20 28 70 43 61  e1.nSlot && (pCa
4a50: 63 68 65 2d 3e 73 7a 50 61 67 65 2b 70 43 61 63  che->szPage+pCac
4a60: 68 65 2d 3e 73 7a 45 78 74 72 61 29 3c 3d 70 63  he->szExtra)<=pc
4a70: 61 63 68 65 31 2e 73 7a 53 6c 6f 74 20 29 7b 0a  ache1.szSlot ){.
4a80: 20 20 20 20 72 65 74 75 72 6e 20 70 63 61 63 68      return pcach
4a90: 65 31 2e 62 55 6e 64 65 72 50 72 65 73 73 75 72  e1.bUnderPressur
4aa0: 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  e;.  }else{.    
4ab0: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 48 65  return sqlite3He
4ac0: 61 70 4e 65 61 72 6c 79 46 75 6c 6c 28 29 3b 0a  apNearlyFull();.
4ad0: 20 20 7d 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a    }.}../********
4ae0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4af0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4b00: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4b10: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4b20: 2a 2a 2a 2a 2a 2a 2f 0a 2f 2a 2a 2a 2a 2a 2a 2a  ******/./*******
4b30: 2a 20 47 65 6e 65 72 61 6c 20 49 6d 70 6c 65 6d  * General Implem
4b40: 65 6e 74 61 74 69 6f 6e 20 46 75 6e 63 74 69 6f  entation Functio
4b50: 6e 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ns *************
4b60: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4b70: 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20  *******/../*.** 
4b80: 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73  This function is
4b90: 20 75 73 65 64 20 74 6f 20 72 65 73 69 7a 65 20   used to resize 
4ba0: 74 68 65 20 68 61 73 68 20 74 61 62 6c 65 20 75  the hash table u
4bb0: 73 65 64 20 62 79 20 74 68 65 20 63 61 63 68 65  sed by the cache
4bc0: 20 70 61 73 73 65 64 0a 2a 2a 20 61 73 20 74 68   passed.** as th
4bd0: 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74  e first argument
4be0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50 43 61 63  ..**.** The PCac
4bf0: 68 65 20 6d 75 74 65 78 20 6d 75 73 74 20 62 65  he mutex must be
4c00: 20 68 65 6c 64 20 77 68 65 6e 20 74 68 69 73 20   held when this 
4c10: 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c  function is call
4c20: 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  ed..*/.static vo
4c30: 69 64 20 70 63 61 63 68 65 31 52 65 73 69 7a 65  id pcache1Resize
4c40: 48 61 73 68 28 50 43 61 63 68 65 31 20 2a 70 29  Hash(PCache1 *p)
4c50: 7b 0a 20 20 50 67 48 64 72 31 20 2a 2a 61 70 4e  {.  PgHdr1 **apN
4c60: 65 77 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20 69  ew;.  unsigned i
4c70: 6e 74 20 6e 4e 65 77 3b 0a 20 20 75 6e 73 69 67  nt nNew;.  unsig
4c80: 6e 65 64 20 69 6e 74 20 69 3b 0a 0a 20 20 61 73  ned int i;..  as
4c90: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75  sert( sqlite3_mu
4ca0: 74 65 78 5f 68 65 6c 64 28 70 2d 3e 70 47 72 6f  tex_held(p->pGro
4cb0: 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 0a 20  up->mutex) );.. 
4cc0: 20 6e 4e 65 77 20 3d 20 70 2d 3e 6e 48 61 73 68   nNew = p->nHash
4cd0: 2a 32 3b 0a 20 20 69 66 28 20 6e 4e 65 77 3c 32  *2;.  if( nNew<2
4ce0: 35 36 20 29 7b 0a 20 20 20 20 6e 4e 65 77 20 3d  56 ){.    nNew =
4cf0: 20 32 35 36 3b 0a 20 20 7d 0a 0a 20 20 70 63 61   256;.  }..  pca
4d00: 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70  che1LeaveMutex(p
4d10: 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20 69 66 28  ->pGroup);.  if(
4d20: 20 70 2d 3e 6e 48 61 73 68 20 29 7b 20 73 71 6c   p->nHash ){ sql
4d30: 69 74 65 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d  ite3BeginBenignM
4d40: 61 6c 6c 6f 63 28 29 3b 20 7d 0a 20 20 61 70 4e  alloc(); }.  apN
4d50: 65 77 20 3d 20 28 50 67 48 64 72 31 20 2a 2a 29  ew = (PgHdr1 **)
4d60: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72  sqlite3MallocZer
4d70: 6f 28 73 69 7a 65 6f 66 28 50 67 48 64 72 31 20  o(sizeof(PgHdr1 
4d80: 2a 29 2a 6e 4e 65 77 29 3b 0a 20 20 69 66 28 20  *)*nNew);.  if( 
4d90: 70 2d 3e 6e 48 61 73 68 20 29 7b 20 73 71 6c 69  p->nHash ){ sqli
4da0: 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c  te3EndBenignMall
4db0: 6f 63 28 29 3b 20 7d 0a 20 20 70 63 61 63 68 65  oc(); }.  pcache
4dc0: 31 45 6e 74 65 72 4d 75 74 65 78 28 70 2d 3e 70  1EnterMutex(p->p
4dd0: 47 72 6f 75 70 29 3b 0a 20 20 69 66 28 20 61 70  Group);.  if( ap
4de0: 4e 65 77 20 29 7b 0a 20 20 20 20 66 6f 72 28 69  New ){.    for(i
4df0: 3d 30 3b 20 69 3c 70 2d 3e 6e 48 61 73 68 3b 20  =0; i<p->nHash; 
4e00: 69 2b 2b 29 7b 0a 20 20 20 20 20 20 50 67 48 64  i++){.      PgHd
4e10: 72 31 20 2a 70 50 61 67 65 3b 0a 20 20 20 20 20  r1 *pPage;.     
4e20: 20 50 67 48 64 72 31 20 2a 70 4e 65 78 74 20 3d   PgHdr1 *pNext =
4e30: 20 70 2d 3e 61 70 48 61 73 68 5b 69 5d 3b 0a 20   p->apHash[i];. 
4e40: 20 20 20 20 20 77 68 69 6c 65 28 20 28 70 50 61       while( (pPa
4e50: 67 65 20 3d 20 70 4e 65 78 74 29 21 3d 30 20 29  ge = pNext)!=0 )
4e60: 7b 0a 20 20 20 20 20 20 20 20 75 6e 73 69 67 6e  {.        unsign
4e70: 65 64 20 69 6e 74 20 68 20 3d 20 70 50 61 67 65  ed int h = pPage
4e80: 2d 3e 69 4b 65 79 20 25 20 6e 4e 65 77 3b 0a 20  ->iKey % nNew;. 
4e90: 20 20 20 20 20 20 20 70 4e 65 78 74 20 3d 20 70         pNext = p
4ea0: 50 61 67 65 2d 3e 70 4e 65 78 74 3b 0a 20 20 20  Page->pNext;.   
4eb0: 20 20 20 20 20 70 50 61 67 65 2d 3e 70 4e 65 78       pPage->pNex
4ec0: 74 20 3d 20 61 70 4e 65 77 5b 68 5d 3b 0a 20 20  t = apNew[h];.  
4ed0: 20 20 20 20 20 20 61 70 4e 65 77 5b 68 5d 20 3d        apNew[h] =
4ee0: 20 70 50 61 67 65 3b 0a 20 20 20 20 20 20 7d 0a   pPage;.      }.
4ef0: 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65      }.    sqlite
4f00: 33 5f 66 72 65 65 28 70 2d 3e 61 70 48 61 73 68  3_free(p->apHash
4f10: 29 3b 0a 20 20 20 20 70 2d 3e 61 70 48 61 73 68  );.    p->apHash
4f20: 20 3d 20 61 70 4e 65 77 3b 0a 20 20 20 20 70 2d   = apNew;.    p-
4f30: 3e 6e 48 61 73 68 20 3d 20 6e 4e 65 77 3b 0a 20  >nHash = nNew;. 
4f40: 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73   }.}../*.** This
4f50: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 65   function is use
4f60: 64 20 69 6e 74 65 72 6e 61 6c 6c 79 20 74 6f 20  d internally to 
4f70: 72 65 6d 6f 76 65 20 74 68 65 20 70 61 67 65 20  remove the page 
4f80: 70 50 61 67 65 20 66 72 6f 6d 20 74 68 65 20 0a  pPage from the .
4f90: 2a 2a 20 50 47 72 6f 75 70 20 4c 52 55 20 6c 69  ** PGroup LRU li
4fa0: 73 74 2c 20 69 66 20 69 73 20 70 61 72 74 20 6f  st, if is part o
4fb0: 66 20 69 74 2e 20 49 66 20 70 50 61 67 65 20 69  f it. If pPage i
4fc0: 73 20 6e 6f 74 20 70 61 72 74 20 6f 66 20 74 68  s not part of th
4fd0: 65 20 50 47 72 6f 75 70 0a 2a 2a 20 4c 52 55 20  e PGroup.** LRU 
4fe0: 6c 69 73 74 2c 20 74 68 65 6e 20 74 68 69 73 20  list, then this 
4ff0: 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 6e 6f  function is a no
5000: 2d 6f 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50  -op..**.** The P
5010: 47 72 6f 75 70 20 6d 75 74 65 78 20 6d 75 73 74  Group mutex must
5020: 20 62 65 20 68 65 6c 64 20 77 68 65 6e 20 74 68   be held when th
5030: 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63  is function is c
5040: 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63  alled..*/.static
5050: 20 50 67 48 64 72 31 20 2a 70 63 61 63 68 65 31   PgHdr1 *pcache1
5060: 50 69 6e 50 61 67 65 28 50 67 48 64 72 31 20 2a  PinPage(PgHdr1 *
5070: 70 50 61 67 65 29 7b 0a 20 20 50 43 61 63 68 65  pPage){.  PCache
5080: 31 20 2a 70 43 61 63 68 65 3b 0a 0a 20 20 61 73  1 *pCache;..  as
5090: 73 65 72 74 28 20 70 50 61 67 65 21 3d 30 20 29  sert( pPage!=0 )
50a0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67  ;.  assert( pPag
50b0: 65 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d 30 20 29  e->isPinned==0 )
50c0: 3b 0a 20 20 70 43 61 63 68 65 20 3d 20 70 50 61  ;.  pCache = pPa
50d0: 67 65 2d 3e 70 43 61 63 68 65 3b 0a 20 20 61 73  ge->pCache;.  as
50e0: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 4c 72  sert( pPage->pLr
50f0: 75 4e 65 78 74 20 29 3b 0a 20 20 61 73 73 65 72  uNext );.  asser
5100: 74 28 20 70 50 61 67 65 2d 3e 70 4c 72 75 50 72  t( pPage->pLruPr
5110: 65 76 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  ev );.  assert( 
5120: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65  sqlite3_mutex_he
5130: 6c 64 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75  ld(pCache->pGrou
5140: 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 70  p->mutex) );.  p
5150: 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 2d 3e  Page->pLruPrev->
5160: 70 4c 72 75 4e 65 78 74 20 3d 20 70 50 61 67 65  pLruNext = pPage
5170: 2d 3e 70 4c 72 75 4e 65 78 74 3b 0a 20 20 70 50  ->pLruNext;.  pP
5180: 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74 2d 3e 70  age->pLruNext->p
5190: 4c 72 75 50 72 65 76 20 3d 20 70 50 61 67 65 2d  LruPrev = pPage-
51a0: 3e 70 4c 72 75 50 72 65 76 3b 0a 20 20 70 50 61  >pLruPrev;.  pPa
51b0: 67 65 2d 3e 70 4c 72 75 4e 65 78 74 20 3d 20 30  ge->pLruNext = 0
51c0: 3b 0a 20 20 70 50 61 67 65 2d 3e 70 4c 72 75 50  ;.  pPage->pLruP
51d0: 72 65 76 20 3d 20 30 3b 0a 20 20 70 50 61 67 65  rev = 0;.  pPage
51e0: 2d 3e 69 73 50 69 6e 6e 65 64 20 3d 20 31 3b 0a  ->isPinned = 1;.
51f0: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d    assert( pPage-
5200: 3e 69 73 41 6e 63 68 6f 72 3d 3d 30 20 29 3b 0a  >isAnchor==0 );.
5210: 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65    assert( pCache
5220: 2d 3e 70 47 72 6f 75 70 2d 3e 6c 72 75 2e 69 73  ->pGroup->lru.is
5230: 41 6e 63 68 6f 72 3d 3d 31 20 29 3b 0a 20 20 70  Anchor==1 );.  p
5240: 43 61 63 68 65 2d 3e 6e 52 65 63 79 63 6c 61 62  Cache->nRecyclab
5250: 6c 65 2d 2d 3b 0a 20 20 72 65 74 75 72 6e 20 70  le--;.  return p
5260: 50 61 67 65 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20  Page;.}.../*.** 
5270: 52 65 6d 6f 76 65 20 74 68 65 20 70 61 67 65 20  Remove the page 
5280: 73 75 70 70 6c 69 65 64 20 61 73 20 61 6e 20 61  supplied as an a
5290: 72 67 75 6d 65 6e 74 20 66 72 6f 6d 20 74 68 65  rgument from the
52a0: 20 68 61 73 68 20 74 61 62 6c 65 20 0a 2a 2a 20   hash table .** 
52b0: 28 50 43 61 63 68 65 31 2e 61 70 48 61 73 68 20  (PCache1.apHash 
52c0: 73 74 72 75 63 74 75 72 65 29 20 74 68 61 74 20  structure) that 
52d0: 69 74 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20  it is currently 
52e0: 73 74 6f 72 65 64 20 69 6e 2e 0a 2a 2a 20 41 6c  stored in..** Al
52f0: 73 6f 20 66 72 65 65 20 74 68 65 20 70 61 67 65  so free the page
5300: 20 69 66 20 66 72 65 65 50 61 67 65 20 69 73 20   if freePage is 
5310: 74 72 75 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20  true..**.** The 
5320: 50 47 72 6f 75 70 20 6d 75 74 65 78 20 6d 75 73  PGroup mutex mus
5330: 74 20 62 65 20 68 65 6c 64 20 77 68 65 6e 20 74  t be held when t
5340: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  his function is 
5350: 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69  called..*/.stati
5360: 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 52 65  c void pcache1Re
5370: 6d 6f 76 65 46 72 6f 6d 48 61 73 68 28 50 67 48  moveFromHash(PgH
5380: 64 72 31 20 2a 70 50 61 67 65 2c 20 69 6e 74 20  dr1 *pPage, int 
5390: 66 72 65 65 46 6c 61 67 29 7b 0a 20 20 75 6e 73  freeFlag){.  uns
53a0: 69 67 6e 65 64 20 69 6e 74 20 68 3b 0a 20 20 50  igned int h;.  P
53b0: 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d  Cache1 *pCache =
53c0: 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65 3b 0a   pPage->pCache;.
53d0: 20 20 50 67 48 64 72 31 20 2a 2a 70 70 3b 0a 0a    PgHdr1 **pp;..
53e0: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
53f0: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 61  3_mutex_held(pCa
5400: 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74  che->pGroup->mut
5410: 65 78 29 20 29 3b 0a 20 20 68 20 3d 20 70 50 61  ex) );.  h = pPa
5420: 67 65 2d 3e 69 4b 65 79 20 25 20 70 43 61 63 68  ge->iKey % pCach
5430: 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 66 6f 72 28  e->nHash;.  for(
5440: 70 70 3d 26 70 43 61 63 68 65 2d 3e 61 70 48 61  pp=&pCache->apHa
5450: 73 68 5b 68 5d 3b 20 28 2a 70 70 29 21 3d 70 50  sh[h]; (*pp)!=pP
5460: 61 67 65 3b 20 70 70 3d 26 28 2a 70 70 29 2d 3e  age; pp=&(*pp)->
5470: 70 4e 65 78 74 29 3b 0a 20 20 2a 70 70 20 3d 20  pNext);.  *pp = 
5480: 28 2a 70 70 29 2d 3e 70 4e 65 78 74 3b 0a 0a 20  (*pp)->pNext;.. 
5490: 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 2d 2d   pCache->nPage--
54a0: 3b 0a 20 20 69 66 28 20 66 72 65 65 46 6c 61 67  ;.  if( freeFlag
54b0: 20 29 20 70 63 61 63 68 65 31 46 72 65 65 50 61   ) pcache1FreePa
54c0: 67 65 28 70 50 61 67 65 29 3b 0a 7d 0a 0a 2f 2a  ge(pPage);.}../*
54d0: 0a 2a 2a 20 49 66 20 74 68 65 72 65 20 61 72 65  .** If there are
54e0: 20 63 75 72 72 65 6e 74 6c 79 20 6d 6f 72 65 20   currently more 
54f0: 74 68 61 6e 20 6e 4d 61 78 50 61 67 65 20 70 61  than nMaxPage pa
5500: 67 65 73 20 61 6c 6c 6f 63 61 74 65 64 2c 20 74  ges allocated, t
5510: 72 79 0a 2a 2a 20 74 6f 20 72 65 63 79 63 6c 65  ry.** to recycle
5520: 20 70 61 67 65 73 20 74 6f 20 72 65 64 75 63 65   pages to reduce
5530: 20 74 68 65 20 6e 75 6d 62 65 72 20 61 6c 6c 6f   the number allo
5540: 63 61 74 65 64 20 74 6f 20 6e 4d 61 78 50 61 67  cated to nMaxPag
5550: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  e..*/.static voi
5560: 64 20 70 63 61 63 68 65 31 45 6e 66 6f 72 63 65  d pcache1Enforce
5570: 4d 61 78 50 61 67 65 28 50 43 61 63 68 65 31 20  MaxPage(PCache1 
5580: 2a 70 43 61 63 68 65 29 7b 0a 20 20 50 47 72 6f  *pCache){.  PGro
5590: 75 70 20 2a 70 47 72 6f 75 70 20 3d 20 70 43 61  up *pGroup = pCa
55a0: 63 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20 20 50  che->pGroup;.  P
55b0: 67 48 64 72 31 20 2a 70 3b 0a 20 20 61 73 73 65  gHdr1 *p;.  asse
55c0: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  rt( sqlite3_mute
55d0: 78 5f 68 65 6c 64 28 70 47 72 6f 75 70 2d 3e 6d  x_held(pGroup->m
55e0: 75 74 65 78 29 20 29 3b 0a 20 20 77 68 69 6c 65  utex) );.  while
55f0: 28 20 70 47 72 6f 75 70 2d 3e 6e 43 75 72 72 65  ( pGroup->nCurre
5600: 6e 74 50 61 67 65 3e 70 47 72 6f 75 70 2d 3e 6e  ntPage>pGroup->n
5610: 4d 61 78 50 61 67 65 0a 20 20 20 20 20 20 26 26  MaxPage.      &&
5620: 20 28 70 3d 70 47 72 6f 75 70 2d 3e 6c 72 75 2e   (p=pGroup->lru.
5630: 70 4c 72 75 50 72 65 76 29 2d 3e 69 73 41 6e 63  pLruPrev)->isAnc
5640: 68 6f 72 3d 3d 30 0a 20 20 29 7b 0a 20 20 20 20  hor==0.  ){.    
5650: 61 73 73 65 72 74 28 20 70 2d 3e 70 43 61 63 68  assert( p->pCach
5660: 65 2d 3e 70 47 72 6f 75 70 3d 3d 70 47 72 6f 75  e->pGroup==pGrou
5670: 70 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28  p );.    assert(
5680: 20 70 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d 30 20   p->isPinned==0 
5690: 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 50 69  );.    pcache1Pi
56a0: 6e 50 61 67 65 28 70 29 3b 0a 20 20 20 20 70 63  nPage(p);.    pc
56b0: 61 63 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48  ache1RemoveFromH
56c0: 61 73 68 28 70 2c 20 31 29 3b 0a 20 20 7d 0a 20  ash(p, 1);.  }. 
56d0: 20 69 66 28 20 70 43 61 63 68 65 2d 3e 6e 50 61   if( pCache->nPa
56e0: 67 65 3d 3d 30 20 26 26 20 70 43 61 63 68 65 2d  ge==0 && pCache-
56f0: 3e 70 42 75 6c 6b 20 29 7b 0a 20 20 20 20 73 71  >pBulk ){.    sq
5700: 6c 69 74 65 33 5f 66 72 65 65 28 70 43 61 63 68  lite3_free(pCach
5710: 65 2d 3e 70 42 75 6c 6b 29 3b 0a 20 20 20 20 70  e->pBulk);.    p
5720: 43 61 63 68 65 2d 3e 70 42 75 6c 6b 20 3d 20 70  Cache->pBulk = p
5730: 43 61 63 68 65 2d 3e 70 46 72 65 65 20 3d 20 30  Cache->pFree = 0
5740: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44  ;.  }.}../*.** D
5750: 69 73 63 61 72 64 20 61 6c 6c 20 70 61 67 65 73  iscard all pages
5760: 20 66 72 6f 6d 20 63 61 63 68 65 20 70 43 61 63   from cache pCac
5770: 68 65 20 77 69 74 68 20 61 20 70 61 67 65 20 6e  he with a page n
5780: 75 6d 62 65 72 20 28 6b 65 79 20 76 61 6c 75 65  umber (key value
5790: 29 20 0a 2a 2a 20 67 72 65 61 74 65 72 20 74 68  ) .** greater th
57a0: 61 6e 20 6f 72 20 65 71 75 61 6c 20 74 6f 20 69  an or equal to i
57b0: 4c 69 6d 69 74 2e 20 41 6e 79 20 70 69 6e 6e 65  Limit. Any pinne
57c0: 64 20 70 61 67 65 73 20 74 68 61 74 20 6d 65 65  d pages that mee
57d0: 74 20 74 68 69 73 20 0a 2a 2a 20 63 72 69 74 65  t this .** crite
57e0: 72 69 61 20 61 72 65 20 75 6e 70 69 6e 6e 65 64  ria are unpinned
57f0: 20 62 65 66 6f 72 65 20 74 68 65 79 20 61 72 65   before they are
5800: 20 64 69 73 63 61 72 64 65 64 2e 0a 2a 2a 0a 2a   discarded..**.*
5810: 2a 20 54 68 65 20 50 43 61 63 68 65 20 6d 75 74  * The PCache mut
5820: 65 78 20 6d 75 73 74 20 62 65 20 68 65 6c 64 20  ex must be held 
5830: 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69  when this functi
5840: 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f  on is called..*/
5850: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61  .static void pca
5860: 63 68 65 31 54 72 75 6e 63 61 74 65 55 6e 73 61  che1TruncateUnsa
5870: 66 65 28 0a 20 20 50 43 61 63 68 65 31 20 2a 70  fe(.  PCache1 *p
5880: 43 61 63 68 65 2c 20 20 20 20 20 20 20 20 20 20  Cache,          
5890: 20 20 20 2f 2a 20 54 68 65 20 63 61 63 68 65 20     /* The cache 
58a0: 74 6f 20 74 72 75 6e 63 61 74 65 20 2a 2f 0a 20  to truncate */. 
58b0: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4c   unsigned int iL
58c0: 69 6d 69 74 20 20 20 20 20 20 20 20 20 20 2f 2a  imit          /*
58d0: 20 44 72 6f 70 20 70 61 67 65 73 20 77 69 74 68   Drop pages with
58e0: 20 74 68 69 73 20 70 67 6e 6f 20 6f 72 20 6c 61   this pgno or la
58f0: 72 67 65 72 20 2a 2f 0a 29 7b 0a 20 20 54 45 53  rger */.){.  TES
5900: 54 4f 4e 4c 59 28 20 75 6e 73 69 67 6e 65 64 20  TONLY( unsigned 
5910: 69 6e 74 20 6e 50 61 67 65 20 3d 20 30 3b 20 29  int nPage = 0; )
5920: 20 20 2f 2a 20 54 6f 20 61 73 73 65 72 74 20 70    /* To assert p
5930: 43 61 63 68 65 2d 3e 6e 50 61 67 65 20 69 73 20  Cache->nPage is 
5940: 63 6f 72 72 65 63 74 20 2a 2f 0a 20 20 75 6e 73  correct */.  uns
5950: 69 67 6e 65 64 20 69 6e 74 20 68 3b 0a 20 20 61  igned int h;.  a
5960: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d  ssert( sqlite3_m
5970: 75 74 65 78 5f 68 65 6c 64 28 70 43 61 63 68 65  utex_held(pCache
5980: 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29  ->pGroup->mutex)
5990: 20 29 3b 0a 20 20 66 6f 72 28 68 3d 30 3b 20 68   );.  for(h=0; h
59a0: 3c 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b 20  <pCache->nHash; 
59b0: 68 2b 2b 29 7b 0a 20 20 20 20 50 67 48 64 72 31  h++){.    PgHdr1
59c0: 20 2a 2a 70 70 20 3d 20 26 70 43 61 63 68 65 2d   **pp = &pCache-
59d0: 3e 61 70 48 61 73 68 5b 68 5d 3b 20 0a 20 20 20  >apHash[h]; .   
59e0: 20 50 67 48 64 72 31 20 2a 70 50 61 67 65 3b 0a   PgHdr1 *pPage;.
59f0: 20 20 20 20 77 68 69 6c 65 28 20 28 70 50 61 67      while( (pPag
5a00: 65 20 3d 20 2a 70 70 29 21 3d 30 20 29 7b 0a 20  e = *pp)!=0 ){. 
5a10: 20 20 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e       if( pPage->
5a20: 69 4b 65 79 3e 3d 69 4c 69 6d 69 74 20 29 7b 0a  iKey>=iLimit ){.
5a30: 20 20 20 20 20 20 20 20 70 43 61 63 68 65 2d 3e          pCache->
5a40: 6e 50 61 67 65 2d 2d 3b 0a 20 20 20 20 20 20 20  nPage--;.       
5a50: 20 2a 70 70 20 3d 20 70 50 61 67 65 2d 3e 70 4e   *pp = pPage->pN
5a60: 65 78 74 3b 0a 20 20 20 20 20 20 20 20 69 66 28  ext;.        if(
5a70: 20 21 70 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65   !pPage->isPinne
5a80: 64 20 29 20 70 63 61 63 68 65 31 50 69 6e 50 61  d ) pcache1PinPa
5a90: 67 65 28 70 50 61 67 65 29 3b 0a 20 20 20 20 20  ge(pPage);.     
5aa0: 20 20 20 70 63 61 63 68 65 31 46 72 65 65 50 61     pcache1FreePa
5ab0: 67 65 28 70 50 61 67 65 29 3b 0a 20 20 20 20 20  ge(pPage);.     
5ac0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20   }else{.        
5ad0: 70 70 20 3d 20 26 70 50 61 67 65 2d 3e 70 4e 65  pp = &pPage->pNe
5ae0: 78 74 3b 0a 20 20 20 20 20 20 20 20 54 45 53 54  xt;.        TEST
5af0: 4f 4e 4c 59 28 20 6e 50 61 67 65 2b 2b 3b 20 29  ONLY( nPage++; )
5b00: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20  .      }.    }. 
5b10: 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 43 61   }.  assert( pCa
5b20: 63 68 65 2d 3e 6e 50 61 67 65 3d 3d 6e 50 61 67  che->nPage==nPag
5b30: 65 20 29 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a  e );.}../*******
5b40: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5b50: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5b60: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5b70: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5b80: 2a 2a 2a 2a 2a 2a 2a 2f 0a 2f 2a 2a 2a 2a 2a 2a  *******/./******
5b90: 2a 2a 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68  ** sqlite3_pcach
5ba0: 65 20 4d 65 74 68 6f 64 73 20 2a 2a 2a 2a 2a 2a  e Methods ******
5bb0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5bc0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5bd0: 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 0a 2a 2a  ********/../*.**
5be0: 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20   Implementation 
5bf0: 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70  of the sqlite3_p
5c00: 63 61 63 68 65 2e 78 49 6e 69 74 20 6d 65 74 68  cache.xInit meth
5c10: 6f 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  od..*/.static in
5c20: 74 20 70 63 61 63 68 65 31 49 6e 69 74 28 76 6f  t pcache1Init(vo
5c30: 69 64 20 2a 4e 6f 74 55 73 65 64 29 7b 0a 20 20  id *NotUsed){.  
5c40: 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52  UNUSED_PARAMETER
5c50: 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 61 73 73  (NotUsed);.  ass
5c60: 65 72 74 28 20 70 63 61 63 68 65 31 2e 69 73 49  ert( pcache1.isI
5c70: 6e 69 74 3d 3d 30 20 29 3b 0a 20 20 6d 65 6d 73  nit==0 );.  mems
5c80: 65 74 28 26 70 63 61 63 68 65 31 2c 20 30 2c 20  et(&pcache1, 0, 
5c90: 73 69 7a 65 6f 66 28 70 63 61 63 68 65 31 29 29  sizeof(pcache1))
5ca0: 3b 0a 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54 68  ;...  /*.  ** Th
5cb0: 65 20 70 63 61 63 68 65 31 2e 73 65 70 61 72 61  e pcache1.separa
5cc0: 74 65 43 61 63 68 65 20 76 61 72 69 61 62 6c 65  teCache variable
5cd0: 20 69 73 20 74 72 75 65 20 69 66 20 65 61 63 68   is true if each
5ce0: 20 50 43 61 63 68 65 20 68 61 73 20 69 74 73 20   PCache has its 
5cf0: 6f 77 6e 0a 20 20 2a 2a 20 70 72 69 76 61 74 65  own.  ** private
5d00: 20 50 47 72 6f 75 70 20 28 6d 6f 64 65 2d 31 29   PGroup (mode-1)
5d10: 2e 20 20 70 63 61 63 68 65 31 2e 73 65 70 61 72  .  pcache1.separ
5d20: 61 74 65 43 61 63 68 65 20 69 73 20 66 61 6c 73  ateCache is fals
5d30: 65 20 69 66 20 74 68 65 20 73 69 6e 67 6c 65 0a  e if the single.
5d40: 20 20 2a 2a 20 50 47 72 6f 75 70 20 69 6e 20 70    ** PGroup in p
5d50: 63 61 63 68 65 31 2e 67 72 70 20 69 73 20 75 73  cache1.grp is us
5d60: 65 64 20 66 6f 72 20 61 6c 6c 20 70 61 67 65 20  ed for all page 
5d70: 63 61 63 68 65 73 20 28 6d 6f 64 65 2d 32 29 2e  caches (mode-2).
5d80: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 20  .  **.  **   *  
5d90: 41 6c 77 61 79 73 20 75 73 65 20 61 20 75 6e 69  Always use a uni
5da0: 66 69 65 64 20 63 61 63 68 65 20 28 6d 6f 64 65  fied cache (mode
5db0: 2d 32 29 20 69 66 20 45 4e 41 42 4c 45 5f 4d 45  -2) if ENABLE_ME
5dc0: 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a  MORY_MANAGEMENT.
5dd0: 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 20 55    **.  **   *  U
5de0: 73 65 20 61 20 75 6e 69 66 69 65 64 20 63 61 63  se a unified cac
5df0: 68 65 20 69 6e 20 73 69 6e 67 6c 65 2d 74 68 72  he in single-thr
5e00: 65 61 64 65 64 20 61 70 70 6c 69 63 61 74 69 6f  eaded applicatio
5e10: 6e 73 20 74 68 61 74 20 68 61 76 65 0a 20 20 2a  ns that have.  *
5e20: 2a 20 20 20 20 20 20 63 6f 6e 66 69 67 75 72 65  *      configure
5e30: 64 20 61 20 73 74 61 72 74 2d 74 69 6d 65 20 62  d a start-time b
5e40: 75 66 66 65 72 20 66 6f 72 20 75 73 65 20 61 73  uffer for use as
5e50: 20 70 61 67 65 2d 63 61 63 68 65 20 6d 65 6d 6f   page-cache memo
5e60: 72 79 20 75 73 69 6e 67 0a 20 20 2a 2a 20 20 20  ry using.  **   
5e70: 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69     sqlite3_confi
5e80: 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f  g(SQLITE_CONFIG_
5e90: 50 41 47 45 43 41 43 48 45 2c 20 70 42 75 66 2c  PAGECACHE, pBuf,
5ea0: 20 73 7a 2c 20 4e 29 20 77 69 74 68 20 6e 6f 6e   sz, N) with non
5eb0: 2d 4e 55 4c 4c 20 0a 20 20 2a 2a 20 20 20 20 20  -NULL .  **     
5ec0: 20 70 42 75 66 20 61 72 67 75 6d 65 6e 74 2e 0a   pBuf argument..
5ed0: 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 20 4f    **.  **   *  O
5ee0: 74 68 65 72 77 69 73 65 20 75 73 65 20 73 65 70  therwise use sep
5ef0: 61 72 61 74 65 20 63 61 63 68 65 73 20 28 6d 6f  arate caches (mo
5f00: 64 65 2d 31 29 0a 20 20 2a 2f 0a 23 69 66 20 64  de-1).  */.#if d
5f10: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e  efined(SQLITE_EN
5f20: 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41  ABLE_MEMORY_MANA
5f30: 47 45 4d 45 4e 54 29 0a 20 20 70 63 61 63 68 65  GEMENT).  pcache
5f40: 31 2e 73 65 70 61 72 61 74 65 43 61 63 68 65 20  1.separateCache 
5f50: 3d 20 30 3b 0a 23 65 6c 69 66 20 53 51 4c 49 54  = 0;.#elif SQLIT
5f60: 45 5f 54 48 52 45 41 44 53 41 46 45 0a 20 20 70  E_THREADSAFE.  p
5f70: 63 61 63 68 65 31 2e 73 65 70 61 72 61 74 65 43  cache1.separateC
5f80: 61 63 68 65 20 3d 20 73 71 6c 69 74 65 33 47 6c  ache = sqlite3Gl
5f90: 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65  obalConfig.pPage
5fa0: 3d 3d 30 0a 20 20 20 20 20 20 20 20 20 20 20 20  ==0.            
5fb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 7c                ||
5fc0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f   sqlite3GlobalCo
5fd0: 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 3e  nfig.bCoreMutex>
5fe0: 30 3b 0a 23 65 6c 73 65 0a 20 20 70 63 61 63 68  0;.#else.  pcach
5ff0: 65 31 2e 73 65 70 61 72 61 74 65 43 61 63 68 65  e1.separateCache
6000: 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c   = sqlite3Global
6010: 43 6f 6e 66 69 67 2e 70 50 61 67 65 3d 3d 30 3b  Config.pPage==0;
6020: 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 53 51 4c  .#endif..#if SQL
6030: 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 0a 20  ITE_THREADSAFE. 
6040: 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62   if( sqlite3Glob
6050: 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75  alConfig.bCoreMu
6060: 74 65 78 20 29 7b 0a 20 20 20 20 70 63 61 63 68  tex ){.    pcach
6070: 65 31 2e 67 72 70 2e 6d 75 74 65 78 20 3d 20 73  e1.grp.mutex = s
6080: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 61 6c 6c  qlite3_mutex_all
6090: 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f  oc(SQLITE_MUTEX_
60a0: 53 54 41 54 49 43 5f 4c 52 55 29 3b 0a 20 20 20  STATIC_LRU);.   
60b0: 20 70 63 61 63 68 65 31 2e 6d 75 74 65 78 20 3d   pcache1.mutex =
60c0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 61   sqlite3_mutex_a
60d0: 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45  lloc(SQLITE_MUTE
60e0: 58 5f 53 54 41 54 49 43 5f 50 4d 45 4d 29 3b 0a  X_STATIC_PMEM);.
60f0: 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 69 66 28    }.#endif.  if(
6100: 20 70 63 61 63 68 65 31 2e 73 65 70 61 72 61 74   pcache1.separat
6110: 65 43 61 63 68 65 0a 20 20 20 26 26 20 73 71 6c  eCache.   && sql
6120: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67  ite3GlobalConfig
6130: 2e 6e 50 61 67 65 21 3d 30 0a 20 20 20 26 26 20  .nPage!=0.   && 
6140: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
6150: 66 69 67 2e 70 50 61 67 65 3d 3d 30 0a 20 20 29  fig.pPage==0.  )
6160: 7b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 6e 49  {.    pcache1.nI
6170: 6e 69 74 50 61 67 65 20 3d 20 73 71 6c 69 74 65  nitPage = sqlite
6180: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 50  3GlobalConfig.nP
6190: 61 67 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  age;.  }else{.  
61a0: 20 20 70 63 61 63 68 65 31 2e 6e 49 6e 69 74 50    pcache1.nInitP
61b0: 61 67 65 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 70  age = 0;.  }.  p
61c0: 63 61 63 68 65 31 2e 67 72 70 2e 6d 78 50 69 6e  cache1.grp.mxPin
61d0: 6e 65 64 20 3d 20 31 30 3b 0a 20 20 70 63 61 63  ned = 10;.  pcac
61e0: 68 65 31 2e 69 73 49 6e 69 74 20 3d 20 31 3b 0a  he1.isInit = 1;.
61f0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
6200: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70  OK;.}../*.** Imp
6210: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74  lementation of t
6220: 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68  he sqlite3_pcach
6230: 65 2e 78 53 68 75 74 64 6f 77 6e 20 6d 65 74 68  e.xShutdown meth
6240: 6f 64 2e 0a 2a 2a 20 4e 6f 74 65 20 74 68 61 74  od..** Note that
6250: 20 74 68 65 20 73 74 61 74 69 63 20 6d 75 74 65   the static mute
6260: 78 20 61 6c 6c 6f 63 61 74 65 64 20 69 6e 20 78  x allocated in x
6270: 49 6e 69 74 20 64 6f 65 73 20 0a 2a 2a 20 6e 6f  Init does .** no
6280: 74 20 6e 65 65 64 20 74 6f 20 62 65 20 66 72 65  t need to be fre
6290: 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  ed..*/.static vo
62a0: 69 64 20 70 63 61 63 68 65 31 53 68 75 74 64 6f  id pcache1Shutdo
62b0: 77 6e 28 76 6f 69 64 20 2a 4e 6f 74 55 73 65 64  wn(void *NotUsed
62c0: 29 7b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41  ){.  UNUSED_PARA
62d0: 4d 45 54 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a  METER(NotUsed);.
62e0: 20 20 61 73 73 65 72 74 28 20 70 63 61 63 68 65    assert( pcache
62f0: 31 2e 69 73 49 6e 69 74 21 3d 30 20 29 3b 0a 20  1.isInit!=0 );. 
6300: 20 6d 65 6d 73 65 74 28 26 70 63 61 63 68 65 31   memset(&pcache1
6310: 2c 20 30 2c 20 73 69 7a 65 6f 66 28 70 63 61 63  , 0, sizeof(pcac
6320: 68 65 31 29 29 3b 0a 7d 0a 0a 2f 2a 20 66 6f 72  he1));.}../* for
6330: 77 61 72 64 20 64 65 63 6c 61 72 61 74 69 6f 6e  ward declaration
6340: 20 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20   */.static void 
6350: 70 63 61 63 68 65 31 44 65 73 74 72 6f 79 28 73  pcache1Destroy(s
6360: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70  qlite3_pcache *p
6370: 29 3b 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d  );../*.** Implem
6380: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20  entation of the 
6390: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78  sqlite3_pcache.x
63a0: 43 72 65 61 74 65 20 6d 65 74 68 6f 64 2e 0a 2a  Create method..*
63b0: 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 61 20  *.** Allocate a 
63c0: 6e 65 77 20 63 61 63 68 65 2e 0a 2a 2f 0a 73 74  new cache..*/.st
63d0: 61 74 69 63 20 73 71 6c 69 74 65 33 5f 70 63 61  atic sqlite3_pca
63e0: 63 68 65 20 2a 70 63 61 63 68 65 31 43 72 65 61  che *pcache1Crea
63f0: 74 65 28 69 6e 74 20 73 7a 50 61 67 65 2c 20 69  te(int szPage, i
6400: 6e 74 20 73 7a 45 78 74 72 61 2c 20 69 6e 74 20  nt szExtra, int 
6410: 62 50 75 72 67 65 61 62 6c 65 29 7b 0a 20 20 50  bPurgeable){.  P
6420: 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 3b 20  Cache1 *pCache; 
6430: 20 20 20 20 20 2f 2a 20 54 68 65 20 6e 65 77 6c       /* The newl
6440: 79 20 63 72 65 61 74 65 64 20 70 61 67 65 20 63  y created page c
6450: 61 63 68 65 20 2a 2f 0a 20 20 50 47 72 6f 75 70  ache */.  PGroup
6460: 20 2a 70 47 72 6f 75 70 3b 20 20 20 20 20 20 20   *pGroup;       
6470: 2f 2a 20 54 68 65 20 67 72 6f 75 70 20 74 68 65  /* The group the
6480: 20 6e 65 77 20 70 61 67 65 20 63 61 63 68 65 20   new page cache 
6490: 77 69 6c 6c 20 62 65 6c 6f 6e 67 20 74 6f 20 2a  will belong to *
64a0: 2f 0a 20 20 69 6e 74 20 73 7a 3b 20 20 20 20 20  /.  int sz;     
64b0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 79 74            /* Byt
64c0: 65 73 20 6f 66 20 6d 65 6d 6f 72 79 20 72 65 71  es of memory req
64d0: 75 69 72 65 64 20 74 6f 20 61 6c 6c 6f 63 61 74  uired to allocat
64e0: 65 20 74 68 65 20 6e 65 77 20 63 61 63 68 65 20  e the new cache 
64f0: 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 28 73  */..  assert( (s
6500: 7a 50 61 67 65 20 26 20 28 73 7a 50 61 67 65 2d  zPage & (szPage-
6510: 31 29 29 3d 3d 30 20 26 26 20 73 7a 50 61 67 65  1))==0 && szPage
6520: 3e 3d 35 31 32 20 26 26 20 73 7a 50 61 67 65 3c  >=512 && szPage<
6530: 3d 36 35 35 33 36 20 29 3b 0a 20 20 61 73 73 65  =65536 );.  asse
6540: 72 74 28 20 73 7a 45 78 74 72 61 20 3c 20 33 30  rt( szExtra < 30
6550: 30 20 29 3b 0a 0a 20 20 73 7a 20 3d 20 73 69 7a  0 );..  sz = siz
6560: 65 6f 66 28 50 43 61 63 68 65 31 29 20 2b 20 73  eof(PCache1) + s
6570: 69 7a 65 6f 66 28 50 47 72 6f 75 70 29 2a 70 63  izeof(PGroup)*pc
6580: 61 63 68 65 31 2e 73 65 70 61 72 61 74 65 43 61  ache1.separateCa
6590: 63 68 65 3b 0a 20 20 70 43 61 63 68 65 20 3d 20  che;.  pCache = 
65a0: 28 50 43 61 63 68 65 31 20 2a 29 73 71 6c 69 74  (PCache1 *)sqlit
65b0: 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 7a 29  e3MallocZero(sz)
65c0: 3b 0a 20 20 69 66 28 20 70 43 61 63 68 65 20 29  ;.  if( pCache )
65d0: 7b 0a 20 20 20 20 69 66 28 20 70 63 61 63 68 65  {.    if( pcache
65e0: 31 2e 73 65 70 61 72 61 74 65 43 61 63 68 65 20  1.separateCache 
65f0: 29 7b 0a 20 20 20 20 20 20 70 47 72 6f 75 70 20  ){.      pGroup 
6600: 3d 20 28 50 47 72 6f 75 70 2a 29 26 70 43 61 63  = (PGroup*)&pCac
6610: 68 65 5b 31 5d 3b 0a 20 20 20 20 20 20 70 47 72  he[1];.      pGr
6620: 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 20  oup->mxPinned = 
6630: 31 30 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20  10;.    }else{. 
6640: 20 20 20 20 20 70 47 72 6f 75 70 20 3d 20 26 70       pGroup = &p
6650: 63 61 63 68 65 31 2e 67 72 70 3b 0a 20 20 20 20  cache1.grp;.    
6660: 7d 0a 20 20 20 20 69 66 28 20 70 47 72 6f 75 70  }.    if( pGroup
6670: 2d 3e 6c 72 75 2e 69 73 41 6e 63 68 6f 72 3d 3d  ->lru.isAnchor==
6680: 30 20 29 7b 0a 20 20 20 20 20 20 70 47 72 6f 75  0 ){.      pGrou
6690: 70 2d 3e 6c 72 75 2e 69 73 41 6e 63 68 6f 72 20  p->lru.isAnchor 
66a0: 3d 20 31 3b 0a 20 20 20 20 20 20 70 47 72 6f 75  = 1;.      pGrou
66b0: 70 2d 3e 6c 72 75 2e 70 4c 72 75 50 72 65 76 20  p->lru.pLruPrev 
66c0: 3d 20 70 47 72 6f 75 70 2d 3e 6c 72 75 2e 70 4c  = pGroup->lru.pL
66d0: 72 75 4e 65 78 74 20 3d 20 26 70 47 72 6f 75 70  ruNext = &pGroup
66e0: 2d 3e 6c 72 75 3b 0a 20 20 20 20 7d 0a 20 20 20  ->lru;.    }.   
66f0: 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 20   pCache->pGroup 
6700: 3d 20 70 47 72 6f 75 70 3b 0a 20 20 20 20 70 43  = pGroup;.    pC
6710: 61 63 68 65 2d 3e 73 7a 50 61 67 65 20 3d 20 73  ache->szPage = s
6720: 7a 50 61 67 65 3b 0a 20 20 20 20 70 43 61 63 68  zPage;.    pCach
6730: 65 2d 3e 73 7a 45 78 74 72 61 20 3d 20 73 7a 45  e->szExtra = szE
6740: 78 74 72 61 3b 0a 20 20 20 20 70 43 61 63 68 65  xtra;.    pCache
6750: 2d 3e 73 7a 41 6c 6c 6f 63 20 3d 20 73 7a 50 61  ->szAlloc = szPa
6760: 67 65 20 2b 20 73 7a 45 78 74 72 61 20 2b 20 52  ge + szExtra + R
6770: 4f 55 4e 44 38 28 73 69 7a 65 6f 66 28 50 67 48  OUND8(sizeof(PgH
6780: 64 72 31 29 29 3b 0a 20 20 20 20 70 43 61 63 68  dr1));.    pCach
6790: 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 3d 20  e->bPurgeable = 
67a0: 28 62 50 75 72 67 65 61 62 6c 65 20 3f 20 31 20  (bPurgeable ? 1 
67b0: 3a 20 30 29 3b 0a 20 20 20 20 70 63 61 63 68 65  : 0);.    pcache
67c0: 31 45 6e 74 65 72 4d 75 74 65 78 28 70 47 72 6f  1EnterMutex(pGro
67d0: 75 70 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31  up);.    pcache1
67e0: 52 65 73 69 7a 65 48 61 73 68 28 70 43 61 63 68  ResizeHash(pCach
67f0: 65 29 3b 0a 20 20 20 20 69 66 28 20 62 50 75 72  e);.    if( bPur
6800: 67 65 61 62 6c 65 20 29 7b 0a 20 20 20 20 20 20  geable ){.      
6810: 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 20 3d 20 31  pCache->nMin = 1
6820: 30 3b 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d  0;.      pGroup-
6830: 3e 6e 4d 69 6e 50 61 67 65 20 2b 3d 20 70 43 61  >nMinPage += pCa
6840: 63 68 65 2d 3e 6e 4d 69 6e 3b 0a 20 20 20 20 20  che->nMin;.     
6850: 20 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65   pGroup->mxPinne
6860: 64 20 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78  d = pGroup->nMax
6870: 50 61 67 65 20 2b 20 31 30 20 2d 20 70 47 72 6f  Page + 10 - pGro
6880: 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 3b 0a 20 20  up->nMinPage;.  
6890: 20 20 7d 0a 20 20 20 20 70 63 61 63 68 65 31 4c    }.    pcache1L
68a0: 65 61 76 65 4d 75 74 65 78 28 70 47 72 6f 75 70  eaveMutex(pGroup
68b0: 29 3b 0a 20 20 20 20 69 66 28 20 70 43 61 63 68  );.    if( pCach
68c0: 65 2d 3e 6e 48 61 73 68 3d 3d 30 20 29 7b 0a 20  e->nHash==0 ){. 
68d0: 20 20 20 20 20 70 63 61 63 68 65 31 44 65 73 74       pcache1Dest
68e0: 72 6f 79 28 28 73 71 6c 69 74 65 33 5f 70 63 61  roy((sqlite3_pca
68f0: 63 68 65 2a 29 70 43 61 63 68 65 29 3b 0a 20 20  che*)pCache);.  
6900: 20 20 20 20 70 43 61 63 68 65 20 3d 20 30 3b 0a      pCache = 0;.
6910: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75      }.  }.  retu
6920: 72 6e 20 28 73 71 6c 69 74 65 33 5f 70 63 61 63  rn (sqlite3_pcac
6930: 68 65 20 2a 29 70 43 61 63 68 65 3b 0a 7d 0a 0a  he *)pCache;.}..
6940: 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61  /*.** Implementa
6950: 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69  tion of the sqli
6960: 74 65 33 5f 70 63 61 63 68 65 2e 78 43 61 63 68  te3_pcache.xCach
6970: 65 73 69 7a 65 20 6d 65 74 68 6f 64 2e 20 0a 2a  esize method. .*
6980: 2a 0a 2a 2a 20 43 6f 6e 66 69 67 75 72 65 20 74  *.** Configure t
6990: 68 65 20 63 61 63 68 65 5f 73 69 7a 65 20 6c 69  he cache_size li
69a0: 6d 69 74 20 66 6f 72 20 61 20 63 61 63 68 65 2e  mit for a cache.
69b0: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
69c0: 70 63 61 63 68 65 31 43 61 63 68 65 73 69 7a 65  pcache1Cachesize
69d0: 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20  (sqlite3_pcache 
69e0: 2a 70 2c 20 69 6e 74 20 6e 4d 61 78 29 7b 0a 20  *p, int nMax){. 
69f0: 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65   PCache1 *pCache
6a00: 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b   = (PCache1 *)p;
6a10: 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e 62  .  if( pCache->b
6a20: 50 75 72 67 65 61 62 6c 65 20 29 7b 0a 20 20 20  Purgeable ){.   
6a30: 20 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70 20   PGroup *pGroup 
6a40: 3d 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70  = pCache->pGroup
6a50: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e 74  ;.    pcache1Ent
6a60: 65 72 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b  erMutex(pGroup);
6a70: 0a 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 61  .    pGroup->nMa
6a80: 78 50 61 67 65 20 2b 3d 20 28 6e 4d 61 78 20 2d  xPage += (nMax -
6a90: 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 29 3b 0a   pCache->nMax);.
6aa0: 20 20 20 20 70 47 72 6f 75 70 2d 3e 6d 78 50 69      pGroup->mxPi
6ab0: 6e 6e 65 64 20 3d 20 70 47 72 6f 75 70 2d 3e 6e  nned = pGroup->n
6ac0: 4d 61 78 50 61 67 65 20 2b 20 31 30 20 2d 20 70  MaxPage + 10 - p
6ad0: 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 3b  Group->nMinPage;
6ae0: 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 4d 61  .    pCache->nMa
6af0: 78 20 3d 20 6e 4d 61 78 3b 0a 20 20 20 20 70 43  x = nMax;.    pC
6b00: 61 63 68 65 2d 3e 6e 39 30 70 63 74 20 3d 20 70  ache->n90pct = p
6b10: 43 61 63 68 65 2d 3e 6e 4d 61 78 2a 39 2f 31 30  Cache->nMax*9/10
6b20: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e 66  ;.    pcache1Enf
6b30: 6f 72 63 65 4d 61 78 50 61 67 65 28 70 43 61 63  orceMaxPage(pCac
6b40: 68 65 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31  he);.    pcache1
6b50: 4c 65 61 76 65 4d 75 74 65 78 28 70 47 72 6f 75  LeaveMutex(pGrou
6b60: 70 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a  p);.  }.}../*.**
6b70: 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20   Implementation 
6b80: 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70  of the sqlite3_p
6b90: 63 61 63 68 65 2e 78 53 68 72 69 6e 6b 20 6d 65  cache.xShrink me
6ba0: 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 46 72 65  thod. .**.** Fre
6bb0: 65 20 75 70 20 61 73 20 6d 75 63 68 20 6d 65 6d  e up as much mem
6bc0: 6f 72 79 20 61 73 20 70 6f 73 73 69 62 6c 65 2e  ory as possible.
6bd0: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
6be0: 70 63 61 63 68 65 31 53 68 72 69 6e 6b 28 73 71  pcache1Shrink(sq
6bf0: 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 29  lite3_pcache *p)
6c00: 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61  {.  PCache1 *pCa
6c10: 63 68 65 20 3d 20 28 50 43 61 63 68 65 31 2a 29  che = (PCache1*)
6c20: 70 3b 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d  p;.  if( pCache-
6c30: 3e 62 50 75 72 67 65 61 62 6c 65 20 29 7b 0a 20  >bPurgeable ){. 
6c40: 20 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f 75     PGroup *pGrou
6c50: 70 20 3d 20 70 43 61 63 68 65 2d 3e 70 47 72 6f  p = pCache->pGro
6c60: 75 70 3b 0a 20 20 20 20 69 6e 74 20 73 61 76 65  up;.    int save
6c70: 64 4d 61 78 50 61 67 65 3b 0a 20 20 20 20 70 63  dMaxPage;.    pc
6c80: 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28  ache1EnterMutex(
6c90: 70 47 72 6f 75 70 29 3b 0a 20 20 20 20 73 61 76  pGroup);.    sav
6ca0: 65 64 4d 61 78 50 61 67 65 20 3d 20 70 47 72 6f  edMaxPage = pGro
6cb0: 75 70 2d 3e 6e 4d 61 78 50 61 67 65 3b 0a 20 20  up->nMaxPage;.  
6cc0: 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61    pGroup->nMaxPa
6cd0: 67 65 20 3d 20 30 3b 0a 20 20 20 20 70 63 61 63  ge = 0;.    pcac
6ce0: 68 65 31 45 6e 66 6f 72 63 65 4d 61 78 50 61 67  he1EnforceMaxPag
6cf0: 65 28 70 43 61 63 68 65 29 3b 0a 20 20 20 20 70  e(pCache);.    p
6d00: 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20  Group->nMaxPage 
6d10: 3d 20 73 61 76 65 64 4d 61 78 50 61 67 65 3b 0a  = savedMaxPage;.
6d20: 20 20 20 20 70 63 61 63 68 65 31 4c 65 61 76 65      pcache1Leave
6d30: 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20  Mutex(pGroup);. 
6d40: 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c   }.}../*.** Impl
6d50: 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68  ementation of th
6d60: 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  e sqlite3_pcache
6d70: 2e 78 50 61 67 65 63 6f 75 6e 74 20 6d 65 74 68  .xPagecount meth
6d80: 6f 64 2e 20 0a 2a 2f 0a 73 74 61 74 69 63 20 69  od. .*/.static i
6d90: 6e 74 20 70 63 61 63 68 65 31 50 61 67 65 63 6f  nt pcache1Pageco
6da0: 75 6e 74 28 73 71 6c 69 74 65 33 5f 70 63 61 63  unt(sqlite3_pcac
6db0: 68 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 6e 3b  he *p){.  int n;
6dc0: 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63  .  PCache1 *pCac
6dd0: 68 65 20 3d 20 28 50 43 61 63 68 65 31 2a 29 70  he = (PCache1*)p
6de0: 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65 72  ;.  pcache1Enter
6df0: 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47  Mutex(pCache->pG
6e00: 72 6f 75 70 29 3b 0a 20 20 6e 20 3d 20 70 43 61  roup);.  n = pCa
6e10: 63 68 65 2d 3e 6e 50 61 67 65 3b 0a 20 20 70 63  che->nPage;.  pc
6e20: 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28  ache1LeaveMutex(
6e30: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b  pCache->pGroup);
6e40: 0a 20 20 72 65 74 75 72 6e 20 6e 3b 0a 7d 0a 0a  .  return n;.}..
6e50: 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74  ./*.** Implement
6e60: 20 73 74 65 70 73 20 33 2c 20 34 2c 20 61 6e 64   steps 3, 4, and
6e70: 20 35 20 6f 66 20 74 68 65 20 70 63 61 63 68 65   5 of the pcache
6e80: 31 46 65 74 63 68 28 29 20 61 6c 67 6f 72 69 74  1Fetch() algorit
6e90: 68 6d 20 64 65 73 63 72 69 62 65 64 0a 2a 2a 20  hm described.** 
6ea0: 69 6e 20 74 68 65 20 68 65 61 64 65 72 20 6f 66  in the header of
6eb0: 20 74 68 65 20 70 63 61 63 68 65 31 46 65 74 63   the pcache1Fetc
6ec0: 68 28 29 20 70 72 6f 63 65 64 75 72 65 2e 0a 2a  h() procedure..*
6ed0: 2a 0a 2a 2a 20 54 68 69 73 20 73 74 65 70 73 20  *.** This steps 
6ee0: 61 72 65 20 62 72 6f 6b 65 6e 20 6f 75 74 20 69  are broken out i
6ef0: 6e 74 6f 20 61 20 73 65 70 61 72 61 74 65 20 70  nto a separate p
6f00: 72 6f 63 65 64 75 72 65 20 62 65 63 61 75 73 65  rocedure because
6f10: 20 74 68 65 79 20 61 72 65 0a 2a 2a 20 75 73 75   they are.** usu
6f20: 61 6c 6c 79 20 6e 6f 74 20 6e 65 65 64 65 64 2c  ally not needed,
6f30: 20 61 6e 64 20 62 79 20 61 76 6f 69 64 69 6e 67   and by avoiding
6f40: 20 74 68 65 20 73 74 61 63 6b 20 69 6e 69 74 69   the stack initi
6f50: 61 6c 69 7a 61 74 69 6f 6e 20 72 65 71 75 69 72  alization requir
6f60: 65 64 0a 2a 2a 20 66 6f 72 20 74 68 65 73 65 20  ed.** for these 
6f70: 73 74 65 70 73 2c 20 74 68 65 20 6d 61 69 6e 20  steps, the main 
6f80: 70 63 61 63 68 65 31 46 65 74 63 68 28 29 20 70  pcache1Fetch() p
6f90: 72 6f 63 65 64 75 72 65 20 63 61 6e 20 72 75 6e  rocedure can run
6fa0: 20 66 61 73 74 65 72 2e 0a 2a 2f 0a 73 74 61 74   faster..*/.stat
6fb0: 69 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49  ic SQLITE_NOINLI
6fc0: 4e 45 20 50 67 48 64 72 31 20 2a 70 63 61 63 68  NE PgHdr1 *pcach
6fd0: 65 31 46 65 74 63 68 53 74 61 67 65 32 28 0a 20  e1FetchStage2(. 
6fe0: 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65   PCache1 *pCache
6ff0: 2c 20 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e  , .  unsigned in
7000: 74 20 69 4b 65 79 2c 20 0a 20 20 69 6e 74 20 63  t iKey, .  int c
7010: 72 65 61 74 65 46 6c 61 67 0a 29 7b 0a 20 20 75  reateFlag.){.  u
7020: 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 50 69 6e  nsigned int nPin
7030: 6e 65 64 3b 0a 20 20 50 47 72 6f 75 70 20 2a 70  ned;.  PGroup *p
7040: 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65 2d 3e  Group = pCache->
7050: 70 47 72 6f 75 70 3b 0a 20 20 50 67 48 64 72 31  pGroup;.  PgHdr1
7060: 20 2a 70 50 61 67 65 20 3d 20 30 3b 0a 0a 20 20   *pPage = 0;..  
7070: 2f 2a 20 53 74 65 70 20 33 3a 20 41 62 6f 72 74  /* Step 3: Abort
7080: 20 69 66 20 63 72 65 61 74 65 46 6c 61 67 20 69   if createFlag i
7090: 73 20 31 20 62 75 74 20 74 68 65 20 63 61 63 68  s 1 but the cach
70a0: 65 20 69 73 20 6e 65 61 72 6c 79 20 66 75 6c 6c  e is nearly full
70b0: 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 43   */.  assert( pC
70c0: 61 63 68 65 2d 3e 6e 50 61 67 65 20 3e 3d 20 70  ache->nPage >= p
70d0: 43 61 63 68 65 2d 3e 6e 52 65 63 79 63 6c 61 62  Cache->nRecyclab
70e0: 6c 65 20 29 3b 0a 20 20 6e 50 69 6e 6e 65 64 20  le );.  nPinned 
70f0: 3d 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 20  = pCache->nPage 
7100: 2d 20 70 43 61 63 68 65 2d 3e 6e 52 65 63 79 63  - pCache->nRecyc
7110: 6c 61 62 6c 65 3b 0a 20 20 61 73 73 65 72 74 28  lable;.  assert(
7120: 20 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65   pGroup->mxPinne
7130: 64 20 3d 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d 61  d == pGroup->nMa
7140: 78 50 61 67 65 20 2b 20 31 30 20 2d 20 70 47 72  xPage + 10 - pGr
7150: 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 20 29 3b  oup->nMinPage );
7160: 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68  .  assert( pCach
7170: 65 2d 3e 6e 39 30 70 63 74 20 3d 3d 20 70 43 61  e->n90pct == pCa
7180: 63 68 65 2d 3e 6e 4d 61 78 2a 39 2f 31 30 20 29  che->nMax*9/10 )
7190: 3b 0a 20 20 69 66 28 20 63 72 65 61 74 65 46 6c  ;.  if( createFl
71a0: 61 67 3d 3d 31 20 26 26 20 28 0a 20 20 20 20 20  ag==1 && (.     
71b0: 20 20 20 6e 50 69 6e 6e 65 64 3e 3d 70 47 72 6f     nPinned>=pGro
71c0: 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 0a 20 20 20  up->mxPinned.   
71d0: 20 20 7c 7c 20 6e 50 69 6e 6e 65 64 3e 3d 70 43    || nPinned>=pC
71e0: 61 63 68 65 2d 3e 6e 39 30 70 63 74 0a 20 20 20  ache->n90pct.   
71f0: 20 20 7c 7c 20 28 70 63 61 63 68 65 31 55 6e 64    || (pcache1Und
7200: 65 72 4d 65 6d 6f 72 79 50 72 65 73 73 75 72 65  erMemoryPressure
7210: 28 70 43 61 63 68 65 29 20 26 26 20 70 43 61 63  (pCache) && pCac
7220: 68 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65 3c  he->nRecyclable<
7230: 6e 50 69 6e 6e 65 64 29 0a 20 20 29 29 7b 0a 20  nPinned).  )){. 
7240: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d     return 0;.  }
7250: 0a 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e  ..  if( pCache->
7260: 6e 50 61 67 65 3e 3d 70 43 61 63 68 65 2d 3e 6e  nPage>=pCache->n
7270: 48 61 73 68 20 29 20 70 63 61 63 68 65 31 52 65  Hash ) pcache1Re
7280: 73 69 7a 65 48 61 73 68 28 70 43 61 63 68 65 29  sizeHash(pCache)
7290: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63  ;.  assert( pCac
72a0: 68 65 2d 3e 6e 48 61 73 68 3e 30 20 26 26 20 70  he->nHash>0 && p
72b0: 43 61 63 68 65 2d 3e 61 70 48 61 73 68 20 29 3b  Cache->apHash );
72c0: 0a 0a 20 20 2f 2a 20 53 74 65 70 20 34 2e 20 54  ..  /* Step 4. T
72d0: 72 79 20 74 6f 20 72 65 63 79 63 6c 65 20 61 20  ry to recycle a 
72e0: 70 61 67 65 2e 20 2a 2f 0a 20 20 69 66 28 20 70  page. */.  if( p
72f0: 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c  Cache->bPurgeabl
7300: 65 0a 20 20 20 26 26 20 21 70 47 72 6f 75 70 2d  e.   && !pGroup-
7310: 3e 6c 72 75 2e 70 4c 72 75 50 72 65 76 2d 3e 69  >lru.pLruPrev->i
7320: 73 41 6e 63 68 6f 72 0a 20 20 20 26 26 20 28 28  sAnchor.   && ((
7330: 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 2b 31 3e  pCache->nPage+1>
7340: 3d 70 43 61 63 68 65 2d 3e 6e 4d 61 78 29 20 7c  =pCache->nMax) |
7350: 7c 20 70 63 61 63 68 65 31 55 6e 64 65 72 4d 65  | pcache1UnderMe
7360: 6d 6f 72 79 50 72 65 73 73 75 72 65 28 70 43 61  moryPressure(pCa
7370: 63 68 65 29 29 0a 20 20 29 7b 0a 20 20 20 20 50  che)).  ){.    P
7380: 43 61 63 68 65 31 20 2a 70 4f 74 68 65 72 3b 0a  Cache1 *pOther;.
7390: 20 20 20 20 70 50 61 67 65 20 3d 20 70 47 72 6f      pPage = pGro
73a0: 75 70 2d 3e 6c 72 75 2e 70 4c 72 75 50 72 65 76  up->lru.pLruPrev
73b0: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50  ;.    assert( pP
73c0: 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d 30  age->isPinned==0
73d0: 20 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 52   );.    pcache1R
73e0: 65 6d 6f 76 65 46 72 6f 6d 48 61 73 68 28 70 50  emoveFromHash(pP
73f0: 61 67 65 2c 20 30 29 3b 0a 20 20 20 20 70 63 61  age, 0);.    pca
7400: 63 68 65 31 50 69 6e 50 61 67 65 28 70 50 61 67  che1PinPage(pPag
7410: 65 29 3b 0a 20 20 20 20 70 4f 74 68 65 72 20 3d  e);.    pOther =
7420: 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65 3b 0a   pPage->pCache;.
7430: 20 20 20 20 69 66 28 20 70 4f 74 68 65 72 2d 3e      if( pOther->
7440: 73 7a 41 6c 6c 6f 63 20 21 3d 20 70 43 61 63 68  szAlloc != pCach
7450: 65 2d 3e 73 7a 41 6c 6c 6f 63 20 29 7b 0a 20 20  e->szAlloc ){.  
7460: 20 20 20 20 70 63 61 63 68 65 31 46 72 65 65 50      pcache1FreeP
7470: 61 67 65 28 70 50 61 67 65 29 3b 0a 20 20 20 20  age(pPage);.    
7480: 20 20 70 50 61 67 65 20 3d 20 30 3b 0a 20 20 20    pPage = 0;.   
7490: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 47   }else{.      pG
74a0: 72 6f 75 70 2d 3e 6e 43 75 72 72 65 6e 74 50 61  roup->nCurrentPa
74b0: 67 65 20 2d 3d 20 28 70 4f 74 68 65 72 2d 3e 62  ge -= (pOther->b
74c0: 50 75 72 67 65 61 62 6c 65 20 2d 20 70 43 61 63  Purgeable - pCac
74d0: 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 29 3b  he->bPurgeable);
74e0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a  .    }.  }..  /*
74f0: 20 53 74 65 70 20 35 2e 20 49 66 20 61 20 75 73   Step 5. If a us
7500: 61 62 6c 65 20 70 61 67 65 20 62 75 66 66 65 72  able page buffer
7510: 20 68 61 73 20 73 74 69 6c 6c 20 6e 6f 74 20 62   has still not b
7520: 65 65 6e 20 66 6f 75 6e 64 2c 20 0a 20 20 2a 2a  een found, .  **
7530: 20 61 74 74 65 6d 70 74 20 74 6f 20 61 6c 6c 6f   attempt to allo
7540: 63 61 74 65 20 61 20 6e 65 77 20 6f 6e 65 2e 20  cate a new one. 
7550: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 21 70 50 61  .  */.  if( !pPa
7560: 67 65 20 29 7b 0a 20 20 20 20 70 50 61 67 65 20  ge ){.    pPage 
7570: 3d 20 70 63 61 63 68 65 31 41 6c 6c 6f 63 50 61  = pcache1AllocPa
7580: 67 65 28 70 43 61 63 68 65 2c 20 63 72 65 61 74  ge(pCache, creat
7590: 65 46 6c 61 67 3d 3d 31 29 3b 0a 20 20 7d 0a 0a  eFlag==1);.  }..
75a0: 20 20 69 66 28 20 70 50 61 67 65 20 29 7b 0a 20    if( pPage ){. 
75b0: 20 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20     unsigned int 
75c0: 68 20 3d 20 69 4b 65 79 20 25 20 70 43 61 63 68  h = iKey % pCach
75d0: 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 20 20 70 43  e->nHash;.    pC
75e0: 61 63 68 65 2d 3e 6e 50 61 67 65 2b 2b 3b 0a 20  ache->nPage++;. 
75f0: 20 20 20 70 50 61 67 65 2d 3e 69 4b 65 79 20 3d     pPage->iKey =
7600: 20 69 4b 65 79 3b 0a 20 20 20 20 70 50 61 67 65   iKey;.    pPage
7610: 2d 3e 70 4e 65 78 74 20 3d 20 70 43 61 63 68 65  ->pNext = pCache
7620: 2d 3e 61 70 48 61 73 68 5b 68 5d 3b 0a 20 20 20  ->apHash[h];.   
7630: 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65 20 3d   pPage->pCache =
7640: 20 70 43 61 63 68 65 3b 0a 20 20 20 20 70 50 61   pCache;.    pPa
7650: 67 65 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20 30  ge->pLruPrev = 0
7660: 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 70 4c 72  ;.    pPage->pLr
7670: 75 4e 65 78 74 20 3d 20 30 3b 0a 20 20 20 20 70  uNext = 0;.    p
7680: 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64 20 3d  Page->isPinned =
7690: 20 31 3b 0a 20 20 20 20 2a 28 76 6f 69 64 20 2a   1;.    *(void *
76a0: 2a 29 70 50 61 67 65 2d 3e 70 61 67 65 2e 70 45  *)pPage->page.pE
76b0: 78 74 72 61 20 3d 20 30 3b 0a 20 20 20 20 70 43  xtra = 0;.    pC
76c0: 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 20  ache->apHash[h] 
76d0: 3d 20 70 50 61 67 65 3b 0a 20 20 20 20 69 66 28  = pPage;.    if(
76e0: 20 69 4b 65 79 3e 70 43 61 63 68 65 2d 3e 69 4d   iKey>pCache->iM
76f0: 61 78 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 70  axKey ){.      p
7700: 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 3d  Cache->iMaxKey =
7710: 20 69 4b 65 79 3b 0a 20 20 20 20 7d 0a 20 20 7d   iKey;.    }.  }
7720: 0a 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 3b  .  return pPage;
7730: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d  .}../*.** Implem
7740: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20  entation of the 
7750: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78  sqlite3_pcache.x
7760: 46 65 74 63 68 20 6d 65 74 68 6f 64 2e 20 0a 2a  Fetch method. .*
7770: 2a 0a 2a 2a 20 46 65 74 63 68 20 61 20 70 61 67  *.** Fetch a pag
7780: 65 20 62 79 20 6b 65 79 20 76 61 6c 75 65 2e 0a  e by key value..
7790: 2a 2a 0a 2a 2a 20 57 68 65 74 68 65 72 20 6f 72  **.** Whether or
77a0: 20 6e 6f 74 20 61 20 6e 65 77 20 70 61 67 65 20   not a new page 
77b0: 6d 61 79 20 62 65 20 61 6c 6c 6f 63 61 74 65 64  may be allocated
77c0: 20 62 79 20 74 68 69 73 20 66 75 6e 63 74 69 6f   by this functio
77d0: 6e 20 64 65 70 65 6e 64 73 20 6f 6e 0a 2a 2a 20  n depends on.** 
77e0: 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65  the value of the
77f0: 20 63 72 65 61 74 65 46 6c 61 67 20 61 72 67 75   createFlag argu
7800: 6d 65 6e 74 2e 20 20 30 20 6d 65 61 6e 73 20 64  ment.  0 means d
7810: 6f 20 6e 6f 74 20 61 6c 6c 6f 63 61 74 65 20 61  o not allocate a
7820: 20 6e 65 77 0a 2a 2a 20 70 61 67 65 2e 20 20 31   new.** page.  1
7830: 20 6d 65 61 6e 73 20 61 6c 6c 6f 63 61 74 65 20   means allocate 
7840: 61 20 6e 65 77 20 70 61 67 65 20 69 66 20 73 70  a new page if sp
7850: 61 63 65 20 69 73 20 65 61 73 69 6c 79 20 61 76  ace is easily av
7860: 61 69 6c 61 62 6c 65 2e 20 20 32 20 0a 2a 2a 20  ailable.  2 .** 
7870: 6d 65 61 6e 73 20 74 6f 20 74 72 79 20 72 65 61  means to try rea
7880: 6c 6c 79 20 68 61 72 64 20 74 6f 20 61 6c 6c 6f  lly hard to allo
7890: 63 61 74 65 20 61 20 6e 65 77 20 70 61 67 65 2e  cate a new page.
78a0: 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 61 20 6e 6f 6e  .**.** For a non
78b0: 2d 70 75 72 67 65 61 62 6c 65 20 63 61 63 68 65  -purgeable cache
78c0: 20 28 61 20 63 61 63 68 65 20 75 73 65 64 20 61   (a cache used a
78d0: 73 20 74 68 65 20 73 74 6f 72 61 67 65 20 66 6f  s the storage fo
78e0: 72 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 0a 2a  r an in-memory.*
78f0: 2a 20 64 61 74 61 62 61 73 65 29 20 74 68 65 72  * database) ther
7900: 65 20 69 73 20 72 65 61 6c 6c 79 20 6e 6f 20 64  e is really no d
7910: 69 66 66 65 72 65 6e 63 65 20 62 65 74 77 65 65  ifference betwee
7920: 6e 20 63 72 65 61 74 65 46 6c 61 67 20 31 20 61  n createFlag 1 a
7930: 6e 64 20 32 2e 20 20 53 6f 0a 2a 2a 20 74 68 65  nd 2.  So.** the
7940: 20 63 61 6c 6c 69 6e 67 20 66 75 6e 63 74 69 6f   calling functio
7950: 6e 20 28 70 63 61 63 68 65 2e 63 29 20 77 69 6c  n (pcache.c) wil
7960: 6c 20 6e 65 76 65 72 20 68 61 76 65 20 61 20 63  l never have a c
7970: 72 65 61 74 65 46 6c 61 67 20 6f 66 20 31 20 6f  reateFlag of 1 o
7980: 6e 0a 2a 2a 20 61 20 6e 6f 6e 2d 70 75 72 67 65  n.** a non-purge
7990: 61 62 6c 65 20 63 61 63 68 65 2e 0a 2a 2a 0a 2a  able cache..**.*
79a0: 2a 20 54 68 65 72 65 20 61 72 65 20 74 68 72 65  * There are thre
79b0: 65 20 64 69 66 66 65 72 65 6e 74 20 61 70 70 72  e different appr
79c0: 6f 61 63 68 65 73 20 74 6f 20 6f 62 74 61 69 6e  oaches to obtain
79d0: 69 6e 67 20 73 70 61 63 65 20 66 6f 72 20 61 20  ing space for a 
79e0: 70 61 67 65 2c 0a 2a 2a 20 64 65 70 65 6e 64 69  page,.** dependi
79f0: 6e 67 20 6f 6e 20 74 68 65 20 76 61 6c 75 65 20  ng on the value 
7a00: 6f 66 20 70 61 72 61 6d 65 74 65 72 20 63 72 65  of parameter cre
7a10: 61 74 65 46 6c 61 67 20 28 77 68 69 63 68 20 6d  ateFlag (which m
7a20: 61 79 20 62 65 20 30 2c 20 31 20 6f 72 20 32 29  ay be 0, 1 or 2)
7a30: 2e 0a 2a 2a 0a 2a 2a 20 20 20 31 2e 20 52 65 67  ..**.**   1. Reg
7a40: 61 72 64 6c 65 73 73 20 6f 66 20 74 68 65 20 76  ardless of the v
7a50: 61 6c 75 65 20 6f 66 20 63 72 65 61 74 65 46 6c  alue of createFl
7a60: 61 67 2c 20 74 68 65 20 63 61 63 68 65 20 69 73  ag, the cache is
7a70: 20 73 65 61 72 63 68 65 64 20 66 6f 72 20 61 20   searched for a 
7a80: 0a 2a 2a 20 20 20 20 20 20 63 6f 70 79 20 6f 66  .**      copy of
7a90: 20 74 68 65 20 72 65 71 75 65 73 74 65 64 20 70   the requested p
7aa0: 61 67 65 2e 20 49 66 20 6f 6e 65 20 69 73 20 66  age. If one is f
7ab0: 6f 75 6e 64 2c 20 69 74 20 69 73 20 72 65 74 75  ound, it is retu
7ac0: 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 20 20 32 2e  rned..**.**   2.
7ad0: 20 49 66 20 63 72 65 61 74 65 46 6c 61 67 3d 3d   If createFlag==
7ae0: 30 20 61 6e 64 20 74 68 65 20 70 61 67 65 20 69  0 and the page i
7af0: 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 69 6e  s not already in
7b00: 20 74 68 65 20 63 61 63 68 65 2c 20 4e 55 4c 4c   the cache, NULL
7b10: 20 69 73 0a 2a 2a 20 20 20 20 20 20 72 65 74 75   is.**      retu
7b20: 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 20 20 33 2e  rned..**.**   3.
7b30: 20 49 66 20 63 72 65 61 74 65 46 6c 61 67 20 69   If createFlag i
7b40: 73 20 31 2c 20 61 6e 64 20 74 68 65 20 70 61 67  s 1, and the pag
7b50: 65 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79  e is not already
7b60: 20 69 6e 20 74 68 65 20 63 61 63 68 65 2c 20 74   in the cache, t
7b70: 68 65 6e 0a 2a 2a 20 20 20 20 20 20 72 65 74 75  hen.**      retu
7b80: 72 6e 20 4e 55 4c 4c 20 28 64 6f 20 6e 6f 74 20  rn NULL (do not 
7b90: 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 70  allocate a new p
7ba0: 61 67 65 29 20 69 66 20 61 6e 79 20 6f 66 20 74  age) if any of t
7bb0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 2a 2a 20  he following.** 
7bc0: 20 20 20 20 20 63 6f 6e 64 69 74 69 6f 6e 73 20       conditions 
7bd0: 61 72 65 20 74 72 75 65 3a 0a 2a 2a 0a 2a 2a 20  are true:.**.** 
7be0: 20 20 20 20 20 20 28 61 29 20 74 68 65 20 6e 75        (a) the nu
7bf0: 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 70 69  mber of pages pi
7c00: 6e 6e 65 64 20 62 79 20 74 68 65 20 63 61 63 68  nned by the cach
7c10: 65 20 69 73 20 67 72 65 61 74 65 72 20 74 68 61  e is greater tha
7c20: 6e 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 50  n.**           P
7c30: 43 61 63 68 65 31 2e 6e 4d 61 78 2c 20 6f 72 0a  Cache1.nMax, or.
7c40: 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 28 62 29 20  **.**       (b) 
7c50: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61  the number of pa
7c60: 67 65 73 20 70 69 6e 6e 65 64 20 62 79 20 74 68  ges pinned by th
7c70: 65 20 63 61 63 68 65 20 69 73 20 67 72 65 61 74  e cache is great
7c80: 65 72 20 74 68 61 6e 0a 2a 2a 20 20 20 20 20 20  er than.**      
7c90: 20 20 20 20 20 74 68 65 20 73 75 6d 20 6f 66 20       the sum of 
7ca0: 6e 4d 61 78 20 66 6f 72 20 61 6c 6c 20 70 75 72  nMax for all pur
7cb0: 67 65 61 62 6c 65 20 63 61 63 68 65 73 2c 20 6c  geable caches, l
7cc0: 65 73 73 20 74 68 65 20 73 75 6d 20 6f 66 20 0a  ess the sum of .
7cd0: 2a 2a 20 20 20 20 20 20 20 20 20 20 20 6e 4d 69  **           nMi
7ce0: 6e 20 66 6f 72 20 61 6c 6c 20 6f 74 68 65 72 20  n for all other 
7cf0: 70 75 72 67 65 61 62 6c 65 20 63 61 63 68 65 73  purgeable caches
7d00: 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 20 20 34 2e 20  , or.**.**   4. 
7d10: 49 66 20 6e 6f 6e 65 20 6f 66 20 74 68 65 20 66  If none of the f
7d20: 69 72 73 74 20 74 68 72 65 65 20 63 6f 6e 64 69  irst three condi
7d30: 74 69 6f 6e 73 20 61 70 70 6c 79 20 61 6e 64 20  tions apply and 
7d40: 74 68 65 20 63 61 63 68 65 20 69 73 20 6d 61 72  the cache is mar
7d50: 6b 65 64 0a 2a 2a 20 20 20 20 20 20 61 73 20 70  ked.**      as p
7d60: 75 72 67 65 61 62 6c 65 2c 20 61 6e 64 20 69 66  urgeable, and if
7d70: 20 6f 6e 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c   one of the foll
7d80: 6f 77 69 6e 67 20 69 73 20 74 72 75 65 3a 0a 2a  owing is true:.*
7d90: 2a 0a 2a 2a 20 20 20 20 20 20 20 28 61 29 20 54  *.**       (a) T
7da0: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67  he number of pag
7db0: 65 73 20 61 6c 6c 6f 63 61 74 65 64 20 66 6f 72  es allocated for
7dc0: 20 74 68 65 20 63 61 63 68 65 20 69 73 20 61 6c   the cache is al
7dd0: 72 65 61 64 79 20 0a 2a 2a 20 20 20 20 20 20 20  ready .**       
7de0: 20 20 20 20 50 43 61 63 68 65 31 2e 6e 4d 61 78      PCache1.nMax
7df0: 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20  , or.**.**      
7e00: 20 28 62 29 20 54 68 65 20 6e 75 6d 62 65 72 20   (b) The number 
7e10: 6f 66 20 70 61 67 65 73 20 61 6c 6c 6f 63 61 74  of pages allocat
7e20: 65 64 20 66 6f 72 20 61 6c 6c 20 70 75 72 67 65  ed for all purge
7e30: 61 62 6c 65 20 63 61 63 68 65 73 20 69 73 0a 2a  able caches is.*
7e40: 2a 20 20 20 20 20 20 20 20 20 20 20 61 6c 72 65  *           alre
7e50: 61 64 79 20 65 71 75 61 6c 20 74 6f 20 6f 72 20  ady equal to or 
7e60: 67 72 65 61 74 65 72 20 74 68 61 6e 20 74 68 65  greater than the
7e70: 20 73 75 6d 20 6f 66 20 6e 4d 61 78 20 66 6f 72   sum of nMax for
7e80: 20 61 6c 6c 0a 2a 2a 20 20 20 20 20 20 20 20 20   all.**         
7e90: 20 20 70 75 72 67 65 61 62 6c 65 20 63 61 63 68    purgeable cach
7ea0: 65 73 2c 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20  es,.**.**       
7eb0: 28 63 29 20 54 68 65 20 73 79 73 74 65 6d 20 69  (c) The system i
7ec0: 73 20 75 6e 64 65 72 20 6d 65 6d 6f 72 79 20 70  s under memory p
7ed0: 72 65 73 73 75 72 65 20 61 6e 64 20 77 61 6e 74  ressure and want
7ee0: 73 20 74 6f 20 61 76 6f 69 64 0a 2a 2a 20 20 20  s to avoid.**   
7ef0: 20 20 20 20 20 20 20 20 75 6e 6e 65 63 65 73 73          unnecess
7f00: 61 72 79 20 70 61 67 65 73 20 63 61 63 68 65 20  ary pages cache 
7f10: 65 6e 74 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e  entry allocation
7f20: 73 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 74 68 65  s.**.**      the
7f30: 6e 20 61 74 74 65 6d 70 74 20 74 6f 20 72 65 63  n attempt to rec
7f40: 79 63 6c 65 20 61 20 70 61 67 65 20 66 72 6f 6d  ycle a page from
7f50: 20 74 68 65 20 4c 52 55 20 6c 69 73 74 2e 20 49   the LRU list. I
7f60: 66 20 69 74 20 69 73 20 74 68 65 20 72 69 67 68  f it is the righ
7f70: 74 0a 2a 2a 20 20 20 20 20 20 73 69 7a 65 2c 20  t.**      size, 
7f80: 72 65 74 75 72 6e 20 74 68 65 20 72 65 63 79 63  return the recyc
7f90: 6c 65 64 20 62 75 66 66 65 72 2e 20 4f 74 68 65  led buffer. Othe
7fa0: 72 77 69 73 65 2c 20 66 72 65 65 20 74 68 65 20  rwise, free the 
7fb0: 62 75 66 66 65 72 20 61 6e 64 0a 2a 2a 20 20 20  buffer and.**   
7fc0: 20 20 20 70 72 6f 63 65 65 64 20 74 6f 20 73 74     proceed to st
7fd0: 65 70 20 35 2e 20 0a 2a 2a 0a 2a 2a 20 20 20 35  ep 5. .**.**   5
7fe0: 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 61 6c 6c  . Otherwise, all
7ff0: 6f 63 61 74 65 20 61 6e 64 20 72 65 74 75 72 6e  ocate and return
8000: 20 61 20 6e 65 77 20 70 61 67 65 20 62 75 66 66   a new page buff
8010: 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 72 65 20  er..**.** There 
8020: 61 72 65 20 74 77 6f 20 76 65 72 73 69 6f 6e 73  are two versions
8030: 20 6f 66 20 74 68 69 73 20 72 6f 75 74 69 6e 65   of this routine
8040: 2e 20 20 70 63 61 63 68 65 31 46 65 74 63 68 57  .  pcache1FetchW
8050: 69 74 68 4d 75 74 65 78 28 29 20 69 73 0a 2a 2a  ithMutex() is.**
8060: 20 74 68 65 20 67 65 6e 65 72 61 6c 20 63 61 73   the general cas
8070: 65 2e 20 20 70 63 61 63 68 65 31 46 65 74 63 68  e.  pcache1Fetch
8080: 4e 6f 4d 75 74 65 78 28 29 20 69 73 20 61 20 66  NoMutex() is a f
8090: 61 73 74 65 72 20 69 6d 70 6c 65 6d 65 6e 74 61  aster implementa
80a0: 74 69 6f 6e 20 66 6f 72 0a 2a 2a 20 74 68 65 20  tion for.** the 
80b0: 63 6f 6d 6d 6f 6e 20 63 61 73 65 20 77 68 65 72  common case wher
80c0: 65 20 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 20  e pGroup->mutex 
80d0: 69 73 20 4e 55 4c 4c 2e 20 20 54 68 65 20 70 63  is NULL.  The pc
80e0: 61 63 68 65 31 46 65 74 63 68 28 29 20 77 72 61  ache1Fetch() wra
80f0: 70 70 65 72 0a 2a 2a 20 69 6e 76 6f 6b 65 73 20  pper.** invokes 
8100: 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 20  the appropriate 
8110: 72 6f 75 74 69 6e 65 2e 0a 2a 2f 0a 73 74 61 74  routine..*/.stat
8120: 69 63 20 50 67 48 64 72 31 20 2a 70 63 61 63 68  ic PgHdr1 *pcach
8130: 65 31 46 65 74 63 68 4e 6f 4d 75 74 65 78 28 0a  e1FetchNoMutex(.
8140: 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65    sqlite3_pcache
8150: 20 2a 70 2c 20 0a 20 20 75 6e 73 69 67 6e 65 64   *p, .  unsigned
8160: 20 69 6e 74 20 69 4b 65 79 2c 20 0a 20 20 69 6e   int iKey, .  in
8170: 74 20 63 72 65 61 74 65 46 6c 61 67 0a 29 7b 0a  t createFlag.){.
8180: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68    PCache1 *pCach
8190: 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70  e = (PCache1 *)p
81a0: 3b 0a 20 20 50 67 48 64 72 31 20 2a 70 50 61 67  ;.  PgHdr1 *pPag
81b0: 65 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20 53 74 65  e = 0;..  /* Ste
81c0: 70 20 31 3a 20 53 65 61 72 63 68 20 74 68 65 20  p 1: Search the 
81d0: 68 61 73 68 20 74 61 62 6c 65 20 66 6f 72 20 61  hash table for a
81e0: 6e 20 65 78 69 73 74 69 6e 67 20 65 6e 74 72 79  n existing entry
81f0: 2e 20 2a 2f 0a 20 20 70 50 61 67 65 20 3d 20 70  . */.  pPage = p
8200: 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 69 4b  Cache->apHash[iK
8210: 65 79 20 25 20 70 43 61 63 68 65 2d 3e 6e 48 61  ey % pCache->nHa
8220: 73 68 5d 3b 0a 20 20 77 68 69 6c 65 28 20 70 50  sh];.  while( pP
8230: 61 67 65 20 26 26 20 70 50 61 67 65 2d 3e 69 4b  age && pPage->iK
8240: 65 79 21 3d 69 4b 65 79 20 29 7b 20 70 50 61 67  ey!=iKey ){ pPag
8250: 65 20 3d 20 70 50 61 67 65 2d 3e 70 4e 65 78 74  e = pPage->pNext
8260: 3b 20 7d 0a 0a 20 20 2f 2a 20 53 74 65 70 20 32  ; }..  /* Step 2
8270: 3a 20 49 66 20 74 68 65 20 70 61 67 65 20 77 61  : If the page wa
8280: 73 20 66 6f 75 6e 64 20 69 6e 20 74 68 65 20 68  s found in the h
8290: 61 73 68 20 74 61 62 6c 65 2c 20 74 68 65 6e 20  ash table, then 
82a0: 72 65 74 75 72 6e 20 69 74 2e 0a 20 20 2a 2a 20  return it..  ** 
82b0: 49 66 20 74 68 65 20 70 61 67 65 20 77 61 73 20  If the page was 
82c0: 6e 6f 74 20 69 6e 20 74 68 65 20 68 61 73 68 20  not in the hash 
82d0: 74 61 62 6c 65 20 61 6e 64 20 63 72 65 61 74 65  table and create
82e0: 46 6c 61 67 20 69 73 20 30 2c 20 61 62 6f 72 74  Flag is 0, abort
82f0: 2e 0a 20 20 2a 2a 20 4f 74 68 65 72 77 69 73 65  ..  ** Otherwise
8300: 20 28 70 61 67 65 20 6e 6f 74 20 69 6e 20 68 61   (page not in ha
8310: 73 68 20 61 6e 64 20 63 72 65 61 74 65 46 6c 61  sh and createFla
8320: 67 21 3d 30 29 20 63 6f 6e 74 69 6e 75 65 20 77  g!=0) continue w
8330: 69 74 68 0a 20 20 2a 2a 20 73 75 62 73 65 71 75  ith.  ** subsequ
8340: 65 6e 74 20 73 74 65 70 73 20 74 6f 20 74 72 79  ent steps to try
8350: 20 74 6f 20 63 72 65 61 74 65 20 74 68 65 20 70   to create the p
8360: 61 67 65 2e 20 2a 2f 0a 20 20 69 66 28 20 70 50  age. */.  if( pP
8370: 61 67 65 20 29 7b 0a 20 20 20 20 69 66 28 20 21  age ){.    if( !
8380: 70 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64 20  pPage->isPinned 
8390: 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  ){.      return 
83a0: 70 63 61 63 68 65 31 50 69 6e 50 61 67 65 28 70  pcache1PinPage(p
83b0: 50 61 67 65 29 3b 0a 20 20 20 20 7d 65 6c 73 65  Page);.    }else
83c0: 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 70  {.      return p
83d0: 50 61 67 65 3b 0a 20 20 20 20 7d 0a 20 20 7d 65  Page;.    }.  }e
83e0: 6c 73 65 20 69 66 28 20 63 72 65 61 74 65 46 6c  lse if( createFl
83f0: 61 67 20 29 7b 0a 20 20 20 20 2f 2a 20 53 74 65  ag ){.    /* Ste
8400: 70 73 20 33 2c 20 34 2c 20 61 6e 64 20 35 20 69  ps 3, 4, and 5 i
8410: 6d 70 6c 65 6d 65 6e 74 65 64 20 62 79 20 74 68  mplemented by th
8420: 69 73 20 73 75 62 72 6f 75 74 69 6e 65 20 2a 2f  is subroutine */
8430: 0a 20 20 20 20 72 65 74 75 72 6e 20 70 63 61 63  .    return pcac
8440: 68 65 31 46 65 74 63 68 53 74 61 67 65 32 28 70  he1FetchStage2(p
8450: 43 61 63 68 65 2c 20 69 4b 65 79 2c 20 63 72 65  Cache, iKey, cre
8460: 61 74 65 46 6c 61 67 29 3b 0a 20 20 7d 65 6c 73  ateFlag);.  }els
8470: 65 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b  e{.    return 0;
8480: 0a 20 20 7d 0a 7d 0a 23 69 66 20 50 43 41 43 48  .  }.}.#if PCACH
8490: 45 31 5f 4d 49 47 48 54 5f 55 53 45 5f 47 52 4f  E1_MIGHT_USE_GRO
84a0: 55 50 5f 4d 55 54 45 58 0a 73 74 61 74 69 63 20  UP_MUTEX.static 
84b0: 50 67 48 64 72 31 20 2a 70 63 61 63 68 65 31 46  PgHdr1 *pcache1F
84c0: 65 74 63 68 57 69 74 68 4d 75 74 65 78 28 0a 20  etchWithMutex(. 
84d0: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20   sqlite3_pcache 
84e0: 2a 70 2c 20 0a 20 20 75 6e 73 69 67 6e 65 64 20  *p, .  unsigned 
84f0: 69 6e 74 20 69 4b 65 79 2c 20 0a 20 20 69 6e 74  int iKey, .  int
8500: 20 63 72 65 61 74 65 46 6c 61 67 0a 29 7b 0a 20   createFlag.){. 
8510: 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65   PCache1 *pCache
8520: 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b   = (PCache1 *)p;
8530: 0a 20 20 50 67 48 64 72 31 20 2a 70 50 61 67 65  .  PgHdr1 *pPage
8540: 3b 0a 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65  ;..  pcache1Ente
8550: 72 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70  rMutex(pCache->p
8560: 47 72 6f 75 70 29 3b 0a 20 20 70 50 61 67 65 20  Group);.  pPage 
8570: 3d 20 70 63 61 63 68 65 31 46 65 74 63 68 4e 6f  = pcache1FetchNo
8580: 4d 75 74 65 78 28 70 2c 20 69 4b 65 79 2c 20 63  Mutex(p, iKey, c
8590: 72 65 61 74 65 46 6c 61 67 29 3b 0a 20 20 61 73  reateFlag);.  as
85a0: 73 65 72 74 28 20 70 50 61 67 65 3d 3d 30 20 7c  sert( pPage==0 |
85b0: 7c 20 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65  | pCache->iMaxKe
85c0: 79 3e 3d 69 4b 65 79 20 29 3b 0a 20 20 70 63 61  y>=iKey );.  pca
85d0: 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70  che1LeaveMutex(p
85e0: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a  Cache->pGroup);.
85f0: 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 3b 0a    return pPage;.
8600: 7d 0a 23 65 6e 64 69 66 0a 73 74 61 74 69 63 20  }.#endif.static 
8610: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 70  sqlite3_pcache_p
8620: 61 67 65 20 2a 70 63 61 63 68 65 31 46 65 74 63  age *pcache1Fetc
8630: 68 28 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 61  h(.  sqlite3_pca
8640: 63 68 65 20 2a 70 2c 20 0a 20 20 75 6e 73 69 67  che *p, .  unsig
8650: 6e 65 64 20 69 6e 74 20 69 4b 65 79 2c 20 0a 20  ned int iKey, . 
8660: 20 69 6e 74 20 63 72 65 61 74 65 46 6c 61 67 0a   int createFlag.
8670: 29 7b 0a 23 69 66 20 50 43 41 43 48 45 31 5f 4d  ){.#if PCACHE1_M
8680: 49 47 48 54 5f 55 53 45 5f 47 52 4f 55 50 5f 4d  IGHT_USE_GROUP_M
8690: 55 54 45 58 20 7c 7c 20 64 65 66 69 6e 65 64 28  UTEX || defined(
86a0: 53 51 4c 49 54 45 5f 44 45 42 55 47 29 0a 20 20  SQLITE_DEBUG).  
86b0: 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 20  PCache1 *pCache 
86c0: 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b 0a  = (PCache1 *)p;.
86d0: 23 65 6e 64 69 66 0a 0a 20 20 61 73 73 65 72 74  #endif..  assert
86e0: 28 20 6f 66 66 73 65 74 6f 66 28 50 67 48 64 72  ( offsetof(PgHdr
86f0: 31 2c 70 61 67 65 29 3d 3d 30 20 29 3b 0a 20 20  1,page)==0 );.  
8700: 61 73 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e  assert( pCache->
8710: 62 50 75 72 67 65 61 62 6c 65 20 7c 7c 20 63 72  bPurgeable || cr
8720: 65 61 74 65 46 6c 61 67 21 3d 31 20 29 3b 0a 20  eateFlag!=1 );. 
8730: 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65 2d   assert( pCache-
8740: 3e 62 50 75 72 67 65 61 62 6c 65 20 7c 7c 20 70  >bPurgeable || p
8750: 43 61 63 68 65 2d 3e 6e 4d 69 6e 3d 3d 30 20 29  Cache->nMin==0 )
8760: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63  ;.  assert( pCac
8770: 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 3d 3d  he->bPurgeable==
8780: 30 20 7c 7c 20 70 43 61 63 68 65 2d 3e 6e 4d 69  0 || pCache->nMi
8790: 6e 3d 3d 31 30 20 29 3b 0a 20 20 61 73 73 65 72  n==10 );.  asser
87a0: 74 28 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 3d  t( pCache->nMin=
87b0: 3d 30 20 7c 7c 20 70 43 61 63 68 65 2d 3e 62 50  =0 || pCache->bP
87c0: 75 72 67 65 61 62 6c 65 20 29 3b 0a 20 20 61 73  urgeable );.  as
87d0: 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 48  sert( pCache->nH
87e0: 61 73 68 3e 30 20 29 3b 0a 23 69 66 20 50 43 41  ash>0 );.#if PCA
87f0: 43 48 45 31 5f 4d 49 47 48 54 5f 55 53 45 5f 47  CHE1_MIGHT_USE_G
8800: 52 4f 55 50 5f 4d 55 54 45 58 0a 20 20 69 66 28  ROUP_MUTEX.  if(
8810: 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d   pCache->pGroup-
8820: 3e 6d 75 74 65 78 20 29 7b 0a 20 20 20 20 72 65  >mutex ){.    re
8830: 74 75 72 6e 20 28 73 71 6c 69 74 65 33 5f 70 63  turn (sqlite3_pc
8840: 61 63 68 65 5f 70 61 67 65 2a 29 70 63 61 63 68  ache_page*)pcach
8850: 65 31 46 65 74 63 68 57 69 74 68 4d 75 74 65 78  e1FetchWithMutex
8860: 28 70 2c 20 69 4b 65 79 2c 20 63 72 65 61 74 65  (p, iKey, create
8870: 46 6c 61 67 29 3b 0a 20 20 7d 65 6c 73 65 0a 23  Flag);.  }else.#
8880: 65 6e 64 69 66 0a 20 20 7b 0a 20 20 20 20 72 65  endif.  {.    re
8890: 74 75 72 6e 20 28 73 71 6c 69 74 65 33 5f 70 63  turn (sqlite3_pc
88a0: 61 63 68 65 5f 70 61 67 65 2a 29 70 63 61 63 68  ache_page*)pcach
88b0: 65 31 46 65 74 63 68 4e 6f 4d 75 74 65 78 28 70  e1FetchNoMutex(p
88c0: 2c 20 69 4b 65 79 2c 20 63 72 65 61 74 65 46 6c  , iKey, createFl
88d0: 61 67 29 3b 0a 20 20 7d 0a 7d 0a 0a 0a 2f 2a 0a  ag);.  }.}.../*.
88e0: 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  ** Implementatio
88f0: 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33  n of the sqlite3
8900: 5f 70 63 61 63 68 65 2e 78 55 6e 70 69 6e 20 6d  _pcache.xUnpin m
8910: 65 74 68 6f 64 2e 0a 2a 2a 0a 2a 2a 20 4d 61 72  ethod..**.** Mar
8920: 6b 20 61 20 70 61 67 65 20 61 73 20 75 6e 70 69  k a page as unpi
8930: 6e 6e 65 64 20 28 65 6c 69 67 69 62 6c 65 20 66  nned (eligible f
8940: 6f 72 20 61 73 79 6e 63 68 72 6f 6e 6f 75 73 20  or asynchronous 
8950: 72 65 63 79 63 6c 69 6e 67 29 2e 0a 2a 2f 0a 73  recycling)..*/.s
8960: 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68  tatic void pcach
8970: 65 31 55 6e 70 69 6e 28 0a 20 20 73 71 6c 69 74  e1Unpin(.  sqlit
8980: 65 33 5f 70 63 61 63 68 65 20 2a 70 2c 20 0a 20  e3_pcache *p, . 
8990: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f   sqlite3_pcache_
89a0: 70 61 67 65 20 2a 70 50 67 2c 20 0a 20 20 69 6e  page *pPg, .  in
89b0: 74 20 72 65 75 73 65 55 6e 6c 69 6b 65 6c 79 0a  t reuseUnlikely.
89c0: 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43  ){.  PCache1 *pC
89d0: 61 63 68 65 20 3d 20 28 50 43 61 63 68 65 31 20  ache = (PCache1 
89e0: 2a 29 70 3b 0a 20 20 50 67 48 64 72 31 20 2a 70  *)p;.  PgHdr1 *p
89f0: 50 61 67 65 20 3d 20 28 50 67 48 64 72 31 20 2a  Page = (PgHdr1 *
8a00: 29 70 50 67 3b 0a 20 20 50 47 72 6f 75 70 20 2a  )pPg;.  PGroup *
8a10: 70 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65 2d  pGroup = pCache-
8a20: 3e 70 47 72 6f 75 70 3b 0a 20 0a 20 20 61 73 73  >pGroup;. .  ass
8a30: 65 72 74 28 20 70 50 61 67 65 2d 3e 70 43 61 63  ert( pPage->pCac
8a40: 68 65 3d 3d 70 43 61 63 68 65 20 29 3b 0a 20 20  he==pCache );.  
8a50: 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65  pcache1EnterMute
8a60: 78 28 70 47 72 6f 75 70 29 3b 0a 0a 20 20 2f 2a  x(pGroup);..  /*
8a70: 20 49 74 20 69 73 20 61 6e 20 65 72 72 6f 72 20   It is an error 
8a80: 74 6f 20 63 61 6c 6c 20 74 68 69 73 20 66 75 6e  to call this fun
8a90: 63 74 69 6f 6e 20 69 66 20 74 68 65 20 70 61 67  ction if the pag
8aa0: 65 20 69 73 20 61 6c 72 65 61 64 79 20 0a 20 20  e is already .  
8ab0: 2a 2a 20 70 61 72 74 20 6f 66 20 74 68 65 20 50  ** part of the P
8ac0: 47 72 6f 75 70 20 4c 52 55 20 6c 69 73 74 2e 0a  Group LRU list..
8ad0: 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70    */.  assert( p
8ae0: 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 3d 3d  Page->pLruPrev==
8af0: 30 20 26 26 20 70 50 61 67 65 2d 3e 70 4c 72 75  0 && pPage->pLru
8b00: 4e 65 78 74 3d 3d 30 20 29 3b 0a 20 20 61 73 73  Next==0 );.  ass
8b10: 65 72 74 28 20 70 50 61 67 65 2d 3e 69 73 50 69  ert( pPage->isPi
8b20: 6e 6e 65 64 3d 3d 31 20 29 3b 0a 0a 20 20 69 66  nned==1 );..  if
8b30: 28 20 72 65 75 73 65 55 6e 6c 69 6b 65 6c 79 20  ( reuseUnlikely 
8b40: 7c 7c 20 70 47 72 6f 75 70 2d 3e 6e 43 75 72 72  || pGroup->nCurr
8b50: 65 6e 74 50 61 67 65 3e 70 47 72 6f 75 70 2d 3e  entPage>pGroup->
8b60: 6e 4d 61 78 50 61 67 65 20 29 7b 0a 20 20 20 20  nMaxPage ){.    
8b70: 70 63 61 63 68 65 31 52 65 6d 6f 76 65 46 72 6f  pcache1RemoveFro
8b80: 6d 48 61 73 68 28 70 50 61 67 65 2c 20 31 29 3b  mHash(pPage, 1);
8b90: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a  .  }else{.    /*
8ba0: 20 41 64 64 20 74 68 65 20 70 61 67 65 20 74 6f   Add the page to
8bb0: 20 74 68 65 20 50 47 72 6f 75 70 20 4c 52 55 20   the PGroup LRU 
8bc0: 6c 69 73 74 2e 20 2a 2f 0a 20 20 20 20 50 67 48  list. */.    PgH
8bd0: 64 72 31 20 2a 2a 70 70 46 69 72 73 74 20 3d 20  dr1 **ppFirst = 
8be0: 26 70 47 72 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72  &pGroup->lru.pLr
8bf0: 75 4e 65 78 74 3b 0a 20 20 20 20 70 50 61 67 65  uNext;.    pPage
8c00: 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20 26 70 47  ->pLruPrev = &pG
8c10: 72 6f 75 70 2d 3e 6c 72 75 3b 0a 20 20 20 20 28  roup->lru;.    (
8c20: 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74 20  pPage->pLruNext 
8c30: 3d 20 2a 70 70 46 69 72 73 74 29 2d 3e 70 4c 72  = *ppFirst)->pLr
8c40: 75 50 72 65 76 20 3d 20 70 50 61 67 65 3b 0a 20  uPrev = pPage;. 
8c50: 20 20 20 2a 70 70 46 69 72 73 74 20 3d 20 70 50     *ppFirst = pP
8c60: 61 67 65 3b 0a 20 20 20 20 70 43 61 63 68 65 2d  age;.    pCache-
8c70: 3e 6e 52 65 63 79 63 6c 61 62 6c 65 2b 2b 3b 0a  >nRecyclable++;.
8c80: 20 20 20 20 70 50 61 67 65 2d 3e 69 73 50 69 6e      pPage->isPin
8c90: 6e 65 64 20 3d 20 30 3b 0a 20 20 7d 0a 0a 20 20  ned = 0;.  }..  
8ca0: 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65  pcache1LeaveMute
8cb0: 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70  x(pCache->pGroup
8cc0: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c  );.}../*.** Impl
8cd0: 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68  ementation of th
8ce0: 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  e sqlite3_pcache
8cf0: 2e 78 52 65 6b 65 79 20 6d 65 74 68 6f 64 2e 20  .xRekey method. 
8d00: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
8d10: 70 63 61 63 68 65 31 52 65 6b 65 79 28 0a 20 20  pcache1Rekey(.  
8d20: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a  sqlite3_pcache *
8d30: 70 2c 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 61  p,.  sqlite3_pca
8d40: 63 68 65 5f 70 61 67 65 20 2a 70 50 67 2c 0a 20  che_page *pPg,. 
8d50: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4f   unsigned int iO
8d60: 6c 64 2c 0a 20 20 75 6e 73 69 67 6e 65 64 20 69  ld,.  unsigned i
8d70: 6e 74 20 69 4e 65 77 0a 29 7b 0a 20 20 50 43 61  nt iNew.){.  PCa
8d80: 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28  che1 *pCache = (
8d90: 50 43 61 63 68 65 31 20 2a 29 70 3b 0a 20 20 50  PCache1 *)p;.  P
8da0: 67 48 64 72 31 20 2a 70 50 61 67 65 20 3d 20 28  gHdr1 *pPage = (
8db0: 50 67 48 64 72 31 20 2a 29 70 50 67 3b 0a 20 20  PgHdr1 *)pPg;.  
8dc0: 50 67 48 64 72 31 20 2a 2a 70 70 3b 0a 20 20 75  PgHdr1 **pp;.  u
8dd0: 6e 73 69 67 6e 65 64 20 69 6e 74 20 68 3b 20 0a  nsigned int h; .
8de0: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d    assert( pPage-
8df0: 3e 69 4b 65 79 3d 3d 69 4f 6c 64 20 29 3b 0a 20  >iKey==iOld );. 
8e00: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e   assert( pPage->
8e10: 70 43 61 63 68 65 3d 3d 70 43 61 63 68 65 20 29  pCache==pCache )
8e20: 3b 0a 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65  ;..  pcache1Ente
8e30: 72 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70  rMutex(pCache->p
8e40: 47 72 6f 75 70 29 3b 0a 0a 20 20 68 20 3d 20 69  Group);..  h = i
8e50: 4f 6c 64 25 70 43 61 63 68 65 2d 3e 6e 48 61 73  Old%pCache->nHas
8e60: 68 3b 0a 20 20 70 70 20 3d 20 26 70 43 61 63 68  h;.  pp = &pCach
8e70: 65 2d 3e 61 70 48 61 73 68 5b 68 5d 3b 0a 20 20  e->apHash[h];.  
8e80: 77 68 69 6c 65 28 20 28 2a 70 70 29 21 3d 70 50  while( (*pp)!=pP
8e90: 61 67 65 20 29 7b 0a 20 20 20 20 70 70 20 3d 20  age ){.    pp = 
8ea0: 26 28 2a 70 70 29 2d 3e 70 4e 65 78 74 3b 0a 20  &(*pp)->pNext;. 
8eb0: 20 7d 0a 20 20 2a 70 70 20 3d 20 70 50 61 67 65   }.  *pp = pPage
8ec0: 2d 3e 70 4e 65 78 74 3b 0a 0a 20 20 68 20 3d 20  ->pNext;..  h = 
8ed0: 69 4e 65 77 25 70 43 61 63 68 65 2d 3e 6e 48 61  iNew%pCache->nHa
8ee0: 73 68 3b 0a 20 20 70 50 61 67 65 2d 3e 69 4b 65  sh;.  pPage->iKe
8ef0: 79 20 3d 20 69 4e 65 77 3b 0a 20 20 70 50 61 67  y = iNew;.  pPag
8f00: 65 2d 3e 70 4e 65 78 74 20 3d 20 70 43 61 63 68  e->pNext = pCach
8f10: 65 2d 3e 61 70 48 61 73 68 5b 68 5d 3b 0a 20 20  e->apHash[h];.  
8f20: 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68  pCache->apHash[h
8f30: 5d 20 3d 20 70 50 61 67 65 3b 0a 20 20 69 66 28  ] = pPage;.  if(
8f40: 20 69 4e 65 77 3e 70 43 61 63 68 65 2d 3e 69 4d   iNew>pCache->iM
8f50: 61 78 4b 65 79 20 29 7b 0a 20 20 20 20 70 43 61  axKey ){.    pCa
8f60: 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 3d 20 69  che->iMaxKey = i
8f70: 4e 65 77 3b 0a 20 20 7d 0a 0a 20 20 70 63 61 63  New;.  }..  pcac
8f80: 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70 43  he1LeaveMutex(pC
8f90: 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 7d  ache->pGroup);.}
8fa0: 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e  ../*.** Implemen
8fb0: 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71  tation of the sq
8fc0: 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78 54 72  lite3_pcache.xTr
8fd0: 75 6e 63 61 74 65 20 6d 65 74 68 6f 64 2e 20 0a  uncate method. .
8fe0: 2a 2a 0a 2a 2a 20 44 69 73 63 61 72 64 20 61 6c  **.** Discard al
8ff0: 6c 20 75 6e 70 69 6e 6e 65 64 20 70 61 67 65 73  l unpinned pages
9000: 20 69 6e 20 74 68 65 20 63 61 63 68 65 20 77 69   in the cache wi
9010: 74 68 20 61 20 70 61 67 65 20 6e 75 6d 62 65 72  th a page number
9020: 20 65 71 75 61 6c 20 74 6f 0a 2a 2a 20 6f 72 20   equal to.** or 
9030: 67 72 65 61 74 65 72 20 74 68 61 6e 20 70 61 72  greater than par
9040: 61 6d 65 74 65 72 20 69 4c 69 6d 69 74 2e 20 41  ameter iLimit. A
9050: 6e 79 20 70 69 6e 6e 65 64 20 70 61 67 65 73 20  ny pinned pages 
9060: 77 69 74 68 20 61 20 70 61 67 65 20 6e 75 6d 62  with a page numb
9070: 65 72 0a 2a 2a 20 65 71 75 61 6c 20 74 6f 20 6f  er.** equal to o
9080: 72 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 69  r greater than i
9090: 4c 69 6d 69 74 20 61 72 65 20 69 6d 70 6c 69 63  Limit are implic
90a0: 69 74 6c 79 20 75 6e 70 69 6e 6e 65 64 2e 0a 2a  itly unpinned..*
90b0: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63  /.static void pc
90c0: 61 63 68 65 31 54 72 75 6e 63 61 74 65 28 73 71  ache1Truncate(sq
90d0: 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 2c  lite3_pcache *p,
90e0: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4c   unsigned int iL
90f0: 69 6d 69 74 29 7b 0a 20 20 50 43 61 63 68 65 31  imit){.  PCache1
9100: 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61 63   *pCache = (PCac
9110: 68 65 31 20 2a 29 70 3b 0a 20 20 70 63 61 63 68  he1 *)p;.  pcach
9120: 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70 43 61  e1EnterMutex(pCa
9130: 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20  che->pGroup);.  
9140: 69 66 28 20 69 4c 69 6d 69 74 3c 3d 70 43 61 63  if( iLimit<=pCac
9150: 68 65 2d 3e 69 4d 61 78 4b 65 79 20 29 7b 0a 20  he->iMaxKey ){. 
9160: 20 20 20 70 63 61 63 68 65 31 54 72 75 6e 63 61     pcache1Trunca
9170: 74 65 55 6e 73 61 66 65 28 70 43 61 63 68 65 2c  teUnsafe(pCache,
9180: 20 69 4c 69 6d 69 74 29 3b 0a 20 20 20 20 70 43   iLimit);.    pC
9190: 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 3d 20  ache->iMaxKey = 
91a0: 69 4c 69 6d 69 74 2d 31 3b 0a 20 20 7d 0a 20 20  iLimit-1;.  }.  
91b0: 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65  pcache1LeaveMute
91c0: 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70  x(pCache->pGroup
91d0: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c  );.}../*.** Impl
91e0: 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68  ementation of th
91f0: 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  e sqlite3_pcache
9200: 2e 78 44 65 73 74 72 6f 79 20 6d 65 74 68 6f 64  .xDestroy method
9210: 2e 20 0a 2a 2a 0a 2a 2a 20 44 65 73 74 72 6f 79  . .**.** Destroy
9220: 20 61 20 63 61 63 68 65 20 61 6c 6c 6f 63 61 74   a cache allocat
9230: 65 64 20 75 73 69 6e 67 20 70 63 61 63 68 65 31  ed using pcache1
9240: 43 72 65 61 74 65 28 29 2e 0a 2a 2f 0a 73 74 61  Create()..*/.sta
9250: 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31  tic void pcache1
9260: 44 65 73 74 72 6f 79 28 73 71 6c 69 74 65 33 5f  Destroy(sqlite3_
9270: 70 63 61 63 68 65 20 2a 70 29 7b 0a 20 20 50 43  pcache *p){.  PC
9280: 61 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20  ache1 *pCache = 
9290: 28 50 43 61 63 68 65 31 20 2a 29 70 3b 0a 20 20  (PCache1 *)p;.  
92a0: 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70 20 3d  PGroup *pGroup =
92b0: 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3b   pCache->pGroup;
92c0: 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68  .  assert( pCach
92d0: 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 7c 7c  e->bPurgeable ||
92e0: 20 28 70 43 61 63 68 65 2d 3e 6e 4d 61 78 3d 3d   (pCache->nMax==
92f0: 30 20 26 26 20 70 43 61 63 68 65 2d 3e 6e 4d 69  0 && pCache->nMi
9300: 6e 3d 3d 30 29 20 29 3b 0a 20 20 70 63 61 63 68  n==0) );.  pcach
9310: 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70 47 72  e1EnterMutex(pGr
9320: 6f 75 70 29 3b 0a 20 20 70 63 61 63 68 65 31 54  oup);.  pcache1T
9330: 72 75 6e 63 61 74 65 55 6e 73 61 66 65 28 70 43  runcateUnsafe(pC
9340: 61 63 68 65 2c 20 30 29 3b 0a 20 20 61 73 73 65  ache, 0);.  asse
9350: 72 74 28 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78  rt( pGroup->nMax
9360: 50 61 67 65 20 3e 3d 20 70 43 61 63 68 65 2d 3e  Page >= pCache->
9370: 6e 4d 61 78 20 29 3b 0a 20 20 70 47 72 6f 75 70  nMax );.  pGroup
9380: 2d 3e 6e 4d 61 78 50 61 67 65 20 2d 3d 20 70 43  ->nMaxPage -= pC
9390: 61 63 68 65 2d 3e 6e 4d 61 78 3b 0a 20 20 61 73  ache->nMax;.  as
93a0: 73 65 72 74 28 20 70 47 72 6f 75 70 2d 3e 6e 4d  sert( pGroup->nM
93b0: 69 6e 50 61 67 65 20 3e 3d 20 70 43 61 63 68 65  inPage >= pCache
93c0: 2d 3e 6e 4d 69 6e 20 29 3b 0a 20 20 70 47 72 6f  ->nMin );.  pGro
93d0: 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 20 2d 3d 20  up->nMinPage -= 
93e0: 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 3b 0a 20 20  pCache->nMin;.  
93f0: 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64  pGroup->mxPinned
9400: 20 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50   = pGroup->nMaxP
9410: 61 67 65 20 2b 20 31 30 20 2d 20 70 47 72 6f 75  age + 10 - pGrou
9420: 70 2d 3e 6e 4d 69 6e 50 61 67 65 3b 0a 20 20 70  p->nMinPage;.  p
9430: 63 61 63 68 65 31 45 6e 66 6f 72 63 65 4d 61 78  cache1EnforceMax
9440: 50 61 67 65 28 70 43 61 63 68 65 29 3b 0a 20 20  Page(pCache);.  
9450: 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65  pcache1LeaveMute
9460: 78 28 70 47 72 6f 75 70 29 3b 0a 20 20 73 71 6c  x(pGroup);.  sql
9470: 69 74 65 33 5f 66 72 65 65 28 70 43 61 63 68 65  ite3_free(pCache
9480: 2d 3e 70 42 75 6c 6b 29 3b 0a 20 20 73 71 6c 69  ->pBulk);.  sqli
9490: 74 65 33 5f 66 72 65 65 28 70 43 61 63 68 65 2d  te3_free(pCache-
94a0: 3e 61 70 48 61 73 68 29 3b 0a 20 20 73 71 6c 69  >apHash);.  sqli
94b0: 74 65 33 5f 66 72 65 65 28 70 43 61 63 68 65 29  te3_free(pCache)
94c0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  ;.}../*.** This 
94d0: 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c  function is call
94e0: 65 64 20 64 75 72 69 6e 67 20 69 6e 69 74 69 61  ed during initia
94f0: 6c 69 7a 61 74 69 6f 6e 20 28 73 71 6c 69 74 65  lization (sqlite
9500: 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 29 20  3_initialize()) 
9510: 74 6f 0a 2a 2a 20 69 6e 73 74 61 6c 6c 20 74 68  to.** install th
9520: 65 20 64 65 66 61 75 6c 74 20 70 6c 75 67 67 61  e default plugga
9530: 62 6c 65 20 63 61 63 68 65 20 6d 6f 64 75 6c 65  ble cache module
9540: 2c 20 61 73 73 75 6d 69 6e 67 20 74 68 65 20 75  , assuming the u
9550: 73 65 72 20 68 61 73 20 6e 6f 74 0a 2a 2a 20 61  ser has not.** a
9560: 6c 72 65 61 64 79 20 70 72 6f 76 69 64 65 64 20  lready provided 
9570: 61 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 2e 0a  an alternative..
9580: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50  */.void sqlite3P
9590: 43 61 63 68 65 53 65 74 44 65 66 61 75 6c 74 28  CacheSetDefault(
95a0: 76 6f 69 64 29 7b 0a 20 20 73 74 61 74 69 63 20  void){.  static 
95b0: 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 70 63  const sqlite3_pc
95c0: 61 63 68 65 5f 6d 65 74 68 6f 64 73 32 20 64 65  ache_methods2 de
95d0: 66 61 75 6c 74 4d 65 74 68 6f 64 73 20 3d 20 7b  faultMethods = {
95e0: 0a 20 20 20 20 31 2c 20 20 20 20 20 20 20 20 20  .    1,         
95f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
9600: 20 69 56 65 72 73 69 6f 6e 20 2a 2f 0a 20 20 20   iVersion */.   
9610: 20 30 2c 20 20 20 20 20 20 20 20 20 20 20 20 20   0,             
9620: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 70 41 72            /* pAr
9630: 67 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31  g */.    pcache1
9640: 49 6e 69 74 2c 20 20 20 20 20 20 20 20 20 20 20  Init,           
9650: 20 20 2f 2a 20 78 49 6e 69 74 20 2a 2f 0a 20 20    /* xInit */.  
9660: 20 20 70 63 61 63 68 65 31 53 68 75 74 64 6f 77    pcache1Shutdow
9670: 6e 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 78 53  n,         /* xS
9680: 68 75 74 64 6f 77 6e 20 2a 2f 0a 20 20 20 20 70  hutdown */.    p
9690: 63 61 63 68 65 31 43 72 65 61 74 65 2c 20 20 20  cache1Create,   
96a0: 20 20 20 20 20 20 20 20 2f 2a 20 78 43 72 65 61          /* xCrea
96b0: 74 65 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65  te */.    pcache
96c0: 31 43 61 63 68 65 73 69 7a 65 2c 20 20 20 20 20  1Cachesize,     
96d0: 20 20 20 2f 2a 20 78 43 61 63 68 65 73 69 7a 65     /* xCachesize
96e0: 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 50   */.    pcache1P
96f0: 61 67 65 63 6f 75 6e 74 2c 20 20 20 20 20 20 20  agecount,       
9700: 20 2f 2a 20 78 50 61 67 65 63 6f 75 6e 74 20 2a   /* xPagecount *
9710: 2f 0a 20 20 20 20 70 63 61 63 68 65 31 46 65 74  /.    pcache1Fet
9720: 63 68 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f  ch,            /
9730: 2a 20 78 46 65 74 63 68 20 2a 2f 0a 20 20 20 20  * xFetch */.    
9740: 70 63 61 63 68 65 31 55 6e 70 69 6e 2c 20 20 20  pcache1Unpin,   
9750: 20 20 20 20 20 20 20 20 20 2f 2a 20 78 55 6e 70           /* xUnp
9760: 69 6e 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65  in */.    pcache
9770: 31 52 65 6b 65 79 2c 20 20 20 20 20 20 20 20 20  1Rekey,         
9780: 20 20 20 2f 2a 20 78 52 65 6b 65 79 20 2a 2f 0a     /* xRekey */.
9790: 20 20 20 20 70 63 61 63 68 65 31 54 72 75 6e 63      pcache1Trunc
97a0: 61 74 65 2c 20 20 20 20 20 20 20 20 20 2f 2a 20  ate,         /* 
97b0: 78 54 72 75 6e 63 61 74 65 20 2a 2f 0a 20 20 20  xTruncate */.   
97c0: 20 70 63 61 63 68 65 31 44 65 73 74 72 6f 79 2c   pcache1Destroy,
97d0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 44 65            /* xDe
97e0: 73 74 72 6f 79 20 2a 2f 0a 20 20 20 20 70 63 61  stroy */.    pca
97f0: 63 68 65 31 53 68 72 69 6e 6b 20 20 20 20 20 20  che1Shrink      
9800: 20 20 20 20 20 20 2f 2a 20 78 53 68 72 69 6e 6b        /* xShrink
9810: 20 2a 2f 0a 20 20 7d 3b 0a 20 20 73 71 6c 69 74   */.  };.  sqlit
9820: 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54 45  e3_config(SQLITE
9830: 5f 43 4f 4e 46 49 47 5f 50 43 41 43 48 45 32 2c  _CONFIG_PCACHE2,
9840: 20 26 64 65 66 61 75 6c 74 4d 65 74 68 6f 64 73   &defaultMethods
9850: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  );.}../*.** Retu
9860: 72 6e 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74  rn the size of t
9870: 68 65 20 68 65 61 64 65 72 20 6f 6e 20 65 61 63  he header on eac
9880: 68 20 70 61 67 65 20 6f 66 20 74 68 69 73 20 50  h page of this P
9890: 43 41 43 48 45 20 69 6d 70 6c 65 6d 65 6e 74 61  CACHE implementa
98a0: 74 69 6f 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  tion..*/.int sql
98b0: 69 74 65 33 48 65 61 64 65 72 53 69 7a 65 50 63  ite3HeaderSizePc
98c0: 61 63 68 65 31 28 76 6f 69 64 29 7b 20 72 65 74  ache1(void){ ret
98d0: 75 72 6e 20 52 4f 55 4e 44 38 28 73 69 7a 65 6f  urn ROUND8(sizeo
98e0: 66 28 50 67 48 64 72 31 29 29 3b 20 7d 0a 0a 2f  f(PgHdr1)); }../
98f0: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
9900: 67 6c 6f 62 61 6c 20 6d 75 74 65 78 20 75 73 65  global mutex use
9910: 64 20 62 79 20 74 68 69 73 20 50 43 41 43 48 45  d by this PCACHE
9920: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e   implementation.
9930: 20 20 54 68 65 0a 2a 2a 20 73 71 6c 69 74 65 33    The.** sqlite3
9940: 5f 73 74 61 74 75 73 28 29 20 72 6f 75 74 69 6e  _status() routin
9950: 65 20 6e 65 65 64 73 20 61 63 63 65 73 73 20 74  e needs access t
9960: 6f 20 74 68 69 73 20 6d 75 74 65 78 2e 0a 2a 2f  o this mutex..*/
9970: 0a 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a  .sqlite3_mutex *
9980: 73 71 6c 69 74 65 33 50 63 61 63 68 65 31 4d 75  sqlite3Pcache1Mu
9990: 74 65 78 28 76 6f 69 64 29 7b 0a 20 20 72 65 74  tex(void){.  ret
99a0: 75 72 6e 20 70 63 61 63 68 65 31 2e 6d 75 74 65  urn pcache1.mute
99b0: 78 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c  x;.}..#ifdef SQL
99c0: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52  ITE_ENABLE_MEMOR
99d0: 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 2f 2a 0a  Y_MANAGEMENT./*.
99e0: 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e  ** This function
99f0: 20 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 66 72   is called to fr
9a00: 65 65 20 73 75 70 65 72 66 6c 75 6f 75 73 20 64  ee superfluous d
9a10: 79 6e 61 6d 69 63 61 6c 6c 79 20 61 6c 6c 6f 63  ynamically alloc
9a20: 61 74 65 64 20 6d 65 6d 6f 72 79 0a 2a 2a 20 68  ated memory.** h
9a30: 65 6c 64 20 62 79 20 74 68 65 20 70 61 67 65 72  eld by the pager
9a40: 20 73 79 73 74 65 6d 2e 20 4d 65 6d 6f 72 79 20   system. Memory 
9a50: 69 6e 20 75 73 65 20 62 79 20 61 6e 79 20 53 51  in use by any SQ
9a60: 4c 69 74 65 20 70 61 67 65 72 20 61 6c 6c 6f 63  Lite pager alloc
9a70: 61 74 65 64 0a 2a 2a 20 62 79 20 74 68 65 20 63  ated.** by the c
9a80: 75 72 72 65 6e 74 20 74 68 72 65 61 64 20 6d 61  urrent thread ma
9a90: 79 20 62 65 20 73 71 6c 69 74 65 33 5f 66 72 65  y be sqlite3_fre
9aa0: 65 28 29 65 64 2e 0a 2a 2a 0a 2a 2a 20 6e 52 65  e()ed..**.** nRe
9ab0: 71 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20  q is the number 
9ac0: 6f 66 20 62 79 74 65 73 20 6f 66 20 6d 65 6d 6f  of bytes of memo
9ad0: 72 79 20 72 65 71 75 69 72 65 64 2e 20 4f 6e 63  ry required. Onc
9ae0: 65 20 74 68 69 73 20 6d 75 63 68 20 68 61 73 0a  e this much has.
9af0: 2a 2a 20 62 65 65 6e 20 72 65 6c 65 61 73 65 64  ** been released
9b00: 2c 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 72  , the function r
9b10: 65 74 75 72 6e 73 2e 20 54 68 65 20 72 65 74 75  eturns. The retu
9b20: 72 6e 20 76 61 6c 75 65 20 69 73 20 74 68 65 20  rn value is the 
9b30: 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 0a 2a 2a  total number .**
9b40: 20 6f 66 20 62 79 74 65 73 20 6f 66 20 6d 65 6d   of bytes of mem
9b50: 6f 72 79 20 72 65 6c 65 61 73 65 64 2e 0a 2a 2f  ory released..*/
9b60: 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 63 61 63  .int sqlite3Pcac
9b70: 68 65 52 65 6c 65 61 73 65 4d 65 6d 6f 72 79 28  heReleaseMemory(
9b80: 69 6e 74 20 6e 52 65 71 29 7b 0a 20 20 69 6e 74  int nReq){.  int
9b90: 20 6e 46 72 65 65 20 3d 20 30 3b 0a 20 20 61 73   nFree = 0;.  as
9ba0: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75  sert( sqlite3_mu
9bb0: 74 65 78 5f 6e 6f 74 68 65 6c 64 28 70 63 61 63  tex_notheld(pcac
9bc0: 68 65 31 2e 67 72 70 2e 6d 75 74 65 78 29 20 29  he1.grp.mutex) )
9bd0: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69  ;.  assert( sqli
9be0: 74 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c  te3_mutex_nothel
9bf0: 64 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29  d(pcache1.mutex)
9c00: 20 29 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65   );.  if( sqlite
9c10: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 50  3GlobalConfig.nP
9c20: 61 67 65 3d 3d 30 20 29 7b 0a 20 20 20 20 50 67  age==0 ){.    Pg
9c30: 48 64 72 31 20 2a 70 3b 0a 20 20 20 20 70 63 61  Hdr1 *p;.    pca
9c40: 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 26  che1EnterMutex(&
9c50: 70 63 61 63 68 65 31 2e 67 72 70 29 3b 0a 20 20  pcache1.grp);.  
9c60: 20 20 77 68 69 6c 65 28 20 28 6e 52 65 71 3c 30    while( (nReq<0
9c70: 20 7c 7c 20 6e 46 72 65 65 3c 6e 52 65 71 29 0a   || nFree<nReq).
9c80: 20 20 20 20 20 20 20 26 26 20 20 28 70 3d 70 63         &&  (p=pc
9c90: 61 63 68 65 31 2e 67 72 70 2e 6c 72 75 2e 70 4c  ache1.grp.lru.pL
9ca0: 72 75 50 72 65 76 29 21 3d 30 0a 20 20 20 20 20  ruPrev)!=0.     
9cb0: 20 20 26 26 20 20 70 2d 3e 69 73 41 6e 63 68 6f    &&  p->isAncho
9cc0: 72 3d 3d 30 0a 20 20 20 20 29 7b 0a 20 20 20 20  r==0.    ){.    
9cd0: 20 20 6e 46 72 65 65 20 2b 3d 20 70 63 61 63 68    nFree += pcach
9ce0: 65 31 4d 65 6d 53 69 7a 65 28 70 2d 3e 70 61 67  e1MemSize(p->pag
9cf0: 65 2e 70 42 75 66 29 3b 0a 23 69 66 64 65 66 20  e.pBuf);.#ifdef 
9d00: 53 51 4c 49 54 45 5f 50 43 41 43 48 45 5f 53 45  SQLITE_PCACHE_SE
9d10: 50 41 52 41 54 45 5f 48 45 41 44 45 52 0a 20 20  PARATE_HEADER.  
9d20: 20 20 20 20 6e 46 72 65 65 20 2b 3d 20 73 71 6c      nFree += sql
9d30: 69 74 65 33 4d 65 6d 53 69 7a 65 28 70 29 3b 0a  ite3MemSize(p);.
9d40: 23 65 6e 64 69 66 0a 20 20 20 20 20 20 61 73 73  #endif.      ass
9d50: 65 72 74 28 20 70 2d 3e 69 73 50 69 6e 6e 65 64  ert( p->isPinned
9d60: 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 70 63 61  ==0 );.      pca
9d70: 63 68 65 31 50 69 6e 50 61 67 65 28 70 29 3b 0a  che1PinPage(p);.
9d80: 20 20 20 20 20 20 70 63 61 63 68 65 31 52 65 6d        pcache1Rem
9d90: 6f 76 65 46 72 6f 6d 48 61 73 68 28 70 2c 20 31  oveFromHash(p, 1
9da0: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 63 61  );.    }.    pca
9db0: 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 26  che1LeaveMutex(&
9dc0: 70 63 61 63 68 65 31 2e 67 72 70 29 3b 0a 20 20  pcache1.grp);.  
9dd0: 7d 0a 20 20 72 65 74 75 72 6e 20 6e 46 72 65 65  }.  return nFree
9de0: 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51  ;.}.#endif /* SQ
9df0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f  LITE_ENABLE_MEMO
9e00: 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 20 2a 2f  RY_MANAGEMENT */
9e10: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ..#ifdef SQLITE_
9e20: 54 45 53 54 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  TEST./*.** This 
9e30: 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 64  function is used
9e40: 20 62 79 20 74 65 73 74 20 70 72 6f 63 65 64 75   by test procedu
9e50: 72 65 73 20 74 6f 20 69 6e 73 70 65 63 74 20 74  res to inspect t
9e60: 68 65 20 69 6e 74 65 72 6e 61 6c 20 73 74 61 74  he internal stat
9e70: 65 0a 2a 2a 20 6f 66 20 74 68 65 20 67 6c 6f 62  e.** of the glob
9e80: 61 6c 20 63 61 63 68 65 2e 0a 2a 2f 0a 76 6f 69  al cache..*/.voi
9e90: 64 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 53  d sqlite3PcacheS
9ea0: 74 61 74 73 28 0a 20 20 69 6e 74 20 2a 70 6e 43  tats(.  int *pnC
9eb0: 75 72 72 65 6e 74 2c 20 20 20 20 20 20 2f 2a 20  urrent,      /* 
9ec0: 4f 55 54 3a 20 54 6f 74 61 6c 20 6e 75 6d 62 65  OUT: Total numbe
9ed0: 72 20 6f 66 20 70 61 67 65 73 20 63 61 63 68 65  r of pages cache
9ee0: 64 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 4d 61  d */.  int *pnMa
9ef0: 78 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f  x,          /* O
9f00: 55 54 3a 20 47 6c 6f 62 61 6c 20 6d 61 78 69 6d  UT: Global maxim
9f10: 75 6d 20 63 61 63 68 65 20 73 69 7a 65 20 2a 2f  um cache size */
9f20: 0a 20 20 69 6e 74 20 2a 70 6e 4d 69 6e 2c 20 20  .  int *pnMin,  
9f30: 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20          /* OUT: 
9f40: 53 75 6d 20 6f 66 20 50 43 61 63 68 65 31 2e 6e  Sum of PCache1.n
9f50: 4d 69 6e 20 66 6f 72 20 70 75 72 67 65 61 62 6c  Min for purgeabl
9f60: 65 20 63 61 63 68 65 73 20 2a 2f 0a 20 20 69 6e  e caches */.  in
9f70: 74 20 2a 70 6e 52 65 63 79 63 6c 61 62 6c 65 20  t *pnRecyclable 
9f80: 20 20 20 2f 2a 20 4f 55 54 3a 20 54 6f 74 61 6c     /* OUT: Total
9f90: 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73   number of pages
9fa0: 20 61 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 72   available for r
9fb0: 65 63 79 63 6c 69 6e 67 20 2a 2f 0a 29 7b 0a 20  ecycling */.){. 
9fc0: 20 50 67 48 64 72 31 20 2a 70 3b 0a 20 20 69 6e   PgHdr1 *p;.  in
9fd0: 74 20 6e 52 65 63 79 63 6c 61 62 6c 65 20 3d 20  t nRecyclable = 
9fe0: 30 3b 0a 20 20 66 6f 72 28 70 3d 70 63 61 63 68  0;.  for(p=pcach
9ff0: 65 31 2e 67 72 70 2e 6c 72 75 2e 70 4c 72 75 4e  e1.grp.lru.pLruN
a000: 65 78 74 3b 20 70 20 26 26 20 21 70 2d 3e 69 73  ext; p && !p->is
a010: 41 6e 63 68 6f 72 3b 20 70 3d 70 2d 3e 70 4c 72  Anchor; p=p->pLr
a020: 75 4e 65 78 74 29 7b 0a 20 20 20 20 61 73 73 65  uNext){.    asse
a030: 72 74 28 20 70 2d 3e 69 73 50 69 6e 6e 65 64 3d  rt( p->isPinned=
a040: 3d 30 20 29 3b 0a 20 20 20 20 6e 52 65 63 79 63  =0 );.    nRecyc
a050: 6c 61 62 6c 65 2b 2b 3b 0a 20 20 7d 0a 20 20 2a  lable++;.  }.  *
a060: 70 6e 43 75 72 72 65 6e 74 20 3d 20 70 63 61 63  pnCurrent = pcac
a070: 68 65 31 2e 67 72 70 2e 6e 43 75 72 72 65 6e 74  he1.grp.nCurrent
a080: 50 61 67 65 3b 0a 20 20 2a 70 6e 4d 61 78 20 3d  Page;.  *pnMax =
a090: 20 28 69 6e 74 29 70 63 61 63 68 65 31 2e 67 72   (int)pcache1.gr
a0a0: 70 2e 6e 4d 61 78 50 61 67 65 3b 0a 20 20 2a 70  p.nMaxPage;.  *p
a0b0: 6e 4d 69 6e 20 3d 20 28 69 6e 74 29 70 63 61 63  nMin = (int)pcac
a0c0: 68 65 31 2e 67 72 70 2e 6e 4d 69 6e 50 61 67 65  he1.grp.nMinPage
a0d0: 3b 0a 20 20 2a 70 6e 52 65 63 79 63 6c 61 62 6c  ;.  *pnRecyclabl
a0e0: 65 20 3d 20 6e 52 65 63 79 63 6c 61 62 6c 65 3b  e = nRecyclable;
a0f0: 0a 7d 0a 23 65 6e 64 69 66 0a                    .}.#endif.