/ Hex Artifact Content
Login

Artifact ad0ffc5b35b0280d045ac569d34d4b842e3e6a4a118f6396b320987a0957afcc:


0000: 2f 2a 0a 2a 2a 20 32 30 30 38 20 4e 6f 76 65 6d  /*.** 2008 Novem
0010: 62 65 72 20 30 35 0a 2a 2a 0a 2a 2a 20 54 68 65  ber 05.**.** The
0020: 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 6d   author disclaim
0030: 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 74  s copyright to t
0040: 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 2e  his source code.
0050: 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a 2a    In place of.**
0060: 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 2c   a legal notice,
0070: 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 73   here is a bless
0080: 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61  ing:.**.**    Ma
0090: 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 6e  y you do good an
00a0: 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 20  d not evil..**  
00b0: 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 66    May you find f
00c0: 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 79  orgiveness for y
00d0: 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 67  ourself and forg
00e0: 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 20  ive others..**  
00f0: 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 20    May you share 
0100: 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 61  freely, never ta
0110: 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 79  king more than y
0120: 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a  ou give..**.****
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0170: 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 54 68 69 73  *****.**.** This
0180: 20 66 69 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 73   file implements
0190: 20 74 68 65 20 64 65 66 61 75 6c 74 20 70 61 67   the default pag
01a0: 65 20 63 61 63 68 65 20 69 6d 70 6c 65 6d 65 6e  e cache implemen
01b0: 74 61 74 69 6f 6e 20 28 74 68 65 0a 2a 2a 20 73  tation (the.** s
01c0: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 69 6e  qlite3_pcache in
01d0: 74 65 72 66 61 63 65 29 2e 20 49 74 20 61 6c 73  terface). It als
01e0: 6f 20 63 6f 6e 74 61 69 6e 73 20 70 61 72 74 20  o contains part 
01f0: 6f 66 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74  of the implement
0200: 61 74 69 6f 6e 0a 2a 2a 20 6f 66 20 74 68 65 20  ation.** of the 
0210: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41  SQLITE_CONFIG_PA
0220: 47 45 43 41 43 48 45 20 61 6e 64 20 73 71 6c 69  GECACHE and sqli
0230: 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f  te3_release_memo
0240: 72 79 28 29 20 66 65 61 74 75 72 65 73 2e 0a 2a  ry() features..*
0250: 2a 20 49 66 20 74 68 65 20 64 65 66 61 75 6c 74  * If the default
0260: 20 70 61 67 65 20 63 61 63 68 65 20 69 6d 70 6c   page cache impl
0270: 65 6d 65 6e 74 61 74 69 6f 6e 20 69 73 20 6f 76  ementation is ov
0280: 65 72 72 69 64 64 65 6e 2c 20 74 68 65 6e 20 6e  erridden, then n
0290: 65 69 74 68 65 72 20 6f 66 0a 2a 2a 20 74 68 65  either of.** the
02a0: 73 65 20 74 77 6f 20 66 65 61 74 75 72 65 73 20  se two features 
02b0: 61 72 65 20 61 76 61 69 6c 61 62 6c 65 2e 0a 2a  are available..*
02c0: 2a 0a 2a 2a 20 41 20 50 61 67 65 20 63 61 63 68  *.** A Page cach
02d0: 65 20 6c 69 6e 65 20 6c 6f 6f 6b 73 20 6c 69 6b  e line looks lik
02e0: 65 20 74 68 69 73 3a 0a 2a 2a 0a 2a 2a 20 20 2d  e this:.**.**  -
02f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0300: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0310: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0320: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 20  ------------.** 
0330: 20 7c 20 20 64 61 74 61 62 61 73 65 20 70 61 67   |  database pag
0340: 65 20 63 6f 6e 74 65 6e 74 20 20 20 7c 20 20 50  e content   |  P
0350: 67 48 64 72 31 20 20 7c 20 20 4d 65 6d 50 61 67  gHdr1  |  MemPag
0360: 65 20 20 7c 20 20 50 67 48 64 72 20 20 7c 0a 2a  e  |  PgHdr  |.*
0370: 2a 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  *  -------------
0380: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0390: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
03a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
03b0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 64 61 74 61 62  .**.** The datab
03c0: 61 73 65 20 70 61 67 65 20 63 6f 6e 74 65 6e 74  ase page content
03d0: 20 69 73 20 75 70 20 66 72 6f 6e 74 20 28 73 6f   is up front (so
03e0: 20 74 68 61 74 20 62 75 66 66 65 72 20 6f 76 65   that buffer ove
03f0: 72 72 65 61 64 73 20 74 65 6e 64 20 74 6f 0a 2a  rreads tend to.*
0400: 2a 20 66 6c 6f 77 20 68 61 72 6d 6c 65 73 73 6c  * flow harmlessl
0410: 79 20 69 6e 74 6f 20 74 68 65 20 50 67 48 64 72  y into the PgHdr
0420: 31 2c 20 4d 65 6d 50 61 67 65 2c 20 61 6e 64 20  1, MemPage, and 
0430: 50 67 48 64 72 20 65 78 74 65 6e 73 69 6f 6e 73  PgHdr extensions
0440: 29 2e 20 20 20 4d 65 6d 50 61 67 65 0a 2a 2a 20  ).   MemPage.** 
0450: 69 73 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e  is the extension
0460: 20 61 64 64 65 64 20 62 79 20 74 68 65 20 62 74   added by the bt
0470: 72 65 65 2e 63 20 6d 6f 64 75 6c 65 20 63 6f 6e  ree.c module con
0480: 74 61 69 6e 69 6e 67 20 69 6e 66 6f 72 6d 61 74  taining informat
0490: 69 6f 6e 20 73 75 63 68 0a 2a 2a 20 61 73 20 74  ion such.** as t
04a0: 68 65 20 64 61 74 61 62 61 73 65 20 70 61 67 65  he database page
04b0: 20 6e 75 6d 62 65 72 20 61 6e 64 20 68 6f 77 20   number and how 
04c0: 74 68 61 74 20 64 61 74 61 62 61 73 65 20 70 61  that database pa
04d0: 67 65 20 69 73 20 75 73 65 64 2e 20 20 50 67 48  ge is used.  PgH
04e0: 64 72 0a 2a 2a 20 69 73 20 61 64 64 65 64 20 62  dr.** is added b
04f0: 79 20 74 68 65 20 70 63 61 63 68 65 2e 63 20 6c  y the pcache.c l
0500: 61 79 65 72 20 61 6e 64 20 63 6f 6e 74 61 69 6e  ayer and contain
0510: 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 75 73  s information us
0520: 65 64 20 74 6f 20 6b 65 65 70 20 74 72 61 63 6b  ed to keep track
0530: 0a 2a 2a 20 6f 66 20 77 68 69 63 68 20 70 61 67  .** of which pag
0540: 65 73 20 61 72 65 20 22 64 69 72 74 79 22 2e 20  es are "dirty". 
0550: 20 50 67 48 64 72 31 20 69 73 20 61 6e 20 65 78   PgHdr1 is an ex
0560: 74 65 6e 73 69 6f 6e 20 61 64 64 65 64 20 62 79  tension added by
0570: 20 74 68 69 73 0a 2a 2a 20 6d 6f 64 75 6c 65 20   this.** module 
0580: 28 70 63 61 63 68 65 31 2e 63 29 2e 20 20 54 68  (pcache1.c).  Th
0590: 65 20 50 67 48 64 72 31 20 68 65 61 64 65 72 20  e PgHdr1 header 
05a0: 69 73 20 61 20 73 75 62 63 6c 61 73 73 20 6f 66  is a subclass of
05b0: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f   sqlite3_pcache_
05c0: 70 61 67 65 2e 0a 2a 2a 20 50 67 48 64 72 31 20  page..** PgHdr1 
05d0: 63 6f 6e 74 61 69 6e 73 20 69 6e 66 6f 72 6d 61  contains informa
05e0: 74 69 6f 6e 20 6e 65 65 64 65 64 20 74 6f 20 6c  tion needed to l
05f0: 6f 6f 6b 20 75 70 20 61 20 70 61 67 65 20 62 79  ook up a page by
0600: 20 69 74 73 20 70 61 67 65 20 6e 75 6d 62 65 72   its page number
0610: 2e 0a 2a 2a 20 54 68 65 20 73 75 70 65 72 63 6c  ..** The supercl
0620: 61 73 73 20 73 71 6c 69 74 65 33 5f 70 63 61 63  ass sqlite3_pcac
0630: 68 65 5f 70 61 67 65 2e 70 42 75 66 20 70 6f 69  he_page.pBuf poi
0640: 6e 74 73 20 74 6f 20 74 68 65 20 73 74 61 72 74  nts to the start
0650: 20 6f 66 20 74 68 65 0a 2a 2a 20 64 61 74 61 62   of the.** datab
0660: 61 73 65 20 70 61 67 65 20 63 6f 6e 74 65 6e 74  ase page content
0670: 20 61 6e 64 20 73 71 6c 69 74 65 33 5f 70 63 61   and sqlite3_pca
0680: 63 68 65 5f 70 61 67 65 2e 70 45 78 74 72 61 20  che_page.pExtra 
0690: 70 6f 69 6e 74 73 20 74 6f 20 50 67 48 64 72 2e  points to PgHdr.
06a0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 69 7a 65 20  .**.** The size 
06b0: 6f 66 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e  of the extension
06c0: 20 28 4d 65 6d 50 61 67 65 2b 50 67 48 64 72 2b   (MemPage+PgHdr+
06d0: 50 67 48 64 72 31 29 20 63 61 6e 20 62 65 20 64  PgHdr1) can be d
06e0: 65 74 65 72 6d 69 6e 65 64 20 61 74 0a 2a 2a 20  etermined at.** 
06f0: 72 75 6e 74 69 6d 65 20 75 73 69 6e 67 20 73 71  runtime using sq
0700: 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c  lite3_config(SQL
0710: 49 54 45 5f 43 4f 4e 46 49 47 5f 50 43 41 43 48  ITE_CONFIG_PCACH
0720: 45 5f 48 44 52 53 5a 2c 20 26 73 69 7a 65 29 2e  E_HDRSZ, &size).
0730: 20 20 54 68 65 0a 2a 2a 20 73 69 7a 65 73 20 6f    The.** sizes o
0740: 66 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e 73  f the extensions
0750: 20 73 75 6d 20 74 6f 20 32 37 32 20 62 79 74 65   sum to 272 byte
0760: 73 20 6f 6e 20 78 36 34 20 66 6f 72 20 33 2e 38  s on x64 for 3.8
0770: 2e 31 30 2c 20 62 75 74 20 74 68 69 73 0a 2a 2a  .10, but this.**
0780: 20 73 69 7a 65 20 63 61 6e 20 76 61 72 79 20 61   size can vary a
0790: 63 63 6f 72 64 69 6e 67 20 74 6f 20 61 72 63 68  ccording to arch
07a0: 69 74 65 63 74 75 72 65 2c 20 63 6f 6d 70 69 6c  itecture, compil
07b0: 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73 2c 20  e-time options, 
07c0: 61 6e 64 0a 2a 2a 20 53 51 4c 69 74 65 20 6c 69  and.** SQLite li
07d0: 62 72 61 72 79 20 76 65 72 73 69 6f 6e 20 6e 75  brary version nu
07e0: 6d 62 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 53  mber..**.** If S
07f0: 51 4c 49 54 45 5f 50 43 41 43 48 45 5f 53 45 50  QLITE_PCACHE_SEP
0800: 41 52 41 54 45 5f 48 45 41 44 45 52 20 69 73 20  ARATE_HEADER is 
0810: 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 74 68  defined, then th
0820: 65 20 65 78 74 65 6e 73 69 6f 6e 20 69 73 20 6f  e extension is o
0830: 62 74 61 69 6e 65 64 0a 2a 2a 20 75 73 69 6e 67  btained.** using
0840: 20 61 20 73 65 70 61 72 61 74 65 20 6d 65 6d 6f   a separate memo
0850: 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 66 72  ry allocation fr
0860: 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 20  om the database 
0870: 70 61 67 65 20 63 6f 6e 74 65 6e 74 2e 20 20 54  page content.  T
0880: 68 69 73 0a 2a 2a 20 73 65 65 6b 73 20 74 6f 20  his.** seeks to 
0890: 6f 76 65 72 63 6f 6d 65 20 74 68 65 20 22 63 6c  overcome the "cl
08a0: 6f 77 6e 73 68 6f 65 22 20 70 72 6f 62 6c 65 6d  ownshoe" problem
08b0: 20 28 61 6c 73 6f 20 63 61 6c 6c 65 64 20 22 69   (also called "i
08c0: 6e 74 65 72 6e 61 6c 0a 2a 2a 20 66 72 61 67 6d  nternal.** fragm
08d0: 65 6e 74 61 74 69 6f 6e 22 20 69 6e 20 61 63 61  entation" in aca
08e0: 64 65 6d 69 63 20 6c 69 74 65 72 61 74 75 72 65  demic literature
08f0: 29 20 6f 66 20 61 6c 6c 6f 63 61 74 69 6e 67 20  ) of allocating 
0900: 61 20 66 65 77 20 62 79 74 65 73 20 6d 6f 72 65  a few bytes more
0910: 0a 2a 2a 20 74 68 61 6e 20 61 20 70 6f 77 65 72  .** than a power
0920: 20 6f 66 20 74 77 6f 20 77 69 74 68 20 74 68 65   of two with the
0930: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f   memory allocato
0940: 72 20 72 6f 75 6e 64 69 6e 67 20 75 70 20 74 6f  r rounding up to
0950: 20 74 68 65 20 6e 65 78 74 0a 2a 2a 20 70 6f 77   the next.** pow
0960: 65 72 20 6f 66 20 74 77 6f 2c 20 61 6e 64 20 6c  er of two, and l
0970: 65 61 76 69 6e 67 20 74 68 65 20 72 6f 75 6e 64  eaving the round
0980: 65 64 2d 75 70 20 73 70 61 63 65 20 75 6e 75 73  ed-up space unus
0990: 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 6d  ed..**.** This m
09a0: 6f 64 75 6c 65 20 74 72 61 63 6b 73 20 70 6f 69  odule tracks poi
09b0: 6e 74 65 72 73 20 74 6f 20 50 67 48 64 72 31 20  nters to PgHdr1 
09c0: 6f 62 6a 65 63 74 73 2e 20 20 4f 6e 6c 79 20 70  objects.  Only p
09d0: 63 61 63 68 65 2e 63 20 63 6f 6d 6d 75 6e 69 63  cache.c communic
09e0: 61 74 65 73 0a 2a 2a 20 77 69 74 68 20 74 68 69  ates.** with thi
09f0: 73 20 6d 6f 64 75 6c 65 2e 20 20 49 6e 66 6f 72  s module.  Infor
0a00: 6d 61 74 69 6f 6e 20 69 73 20 70 61 73 73 65 64  mation is passed
0a10: 20 62 61 63 6b 20 61 6e 64 20 66 6f 72 74 68 20   back and forth 
0a20: 61 73 20 50 67 48 64 72 31 20 70 6f 69 6e 74 65  as PgHdr1 pointe
0a30: 72 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 63  rs..**.** The pc
0a40: 61 63 68 65 2e 63 20 61 6e 64 20 70 61 67 65 72  ache.c and pager
0a50: 2e 63 20 6d 6f 64 75 6c 65 73 20 64 65 61 6c 20  .c modules deal 
0a60: 70 6f 69 6e 74 65 72 73 20 74 6f 20 50 67 48 64  pointers to PgHd
0a70: 72 20 6f 62 6a 65 63 74 73 2e 0a 2a 2a 20 54 68  r objects..** Th
0a80: 65 20 62 74 72 65 65 2e 63 20 6d 6f 64 75 6c 65  e btree.c module
0a90: 20 64 65 61 6c 73 20 77 69 74 68 20 70 6f 69 6e   deals with poin
0aa0: 74 65 72 73 20 74 6f 20 4d 65 6d 50 61 67 65 20  ters to MemPage 
0ab0: 6f 62 6a 65 63 74 73 2e 0a 2a 2a 0a 2a 2a 20 53  objects..**.** S
0ac0: 4f 55 52 43 45 20 4f 46 20 50 41 47 45 20 43 41  OURCE OF PAGE CA
0ad0: 43 48 45 20 4d 45 4d 4f 52 59 3a 0a 2a 2a 0a 2a  CHE MEMORY:.**.*
0ae0: 2a 20 4d 65 6d 6f 72 79 20 66 6f 72 20 61 20 70  * Memory for a p
0af0: 61 67 65 20 6d 69 67 68 74 20 63 6f 6d 65 20 66  age might come f
0b00: 72 6f 6d 20 61 6e 79 20 6f 66 20 74 68 72 65 65  rom any of three
0b10: 20 73 6f 75 72 63 65 73 3a 0a 2a 2a 0a 2a 2a 20   sources:.**.** 
0b20: 20 20 20 28 31 29 20 20 54 68 65 20 67 65 6e 65     (1)  The gene
0b30: 72 61 6c 2d 70 75 72 70 6f 73 65 20 6d 65 6d 6f  ral-purpose memo
0b40: 72 79 20 61 6c 6c 6f 63 61 74 6f 72 20 2d 20 73  ry allocator - s
0b50: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 29 0a 2a  qlite3Malloc().*
0b60: 2a 20 20 20 20 28 32 29 20 20 47 6c 6f 62 61 6c  *    (2)  Global
0b70: 20 70 61 67 65 2d 63 61 63 68 65 20 6d 65 6d 6f   page-cache memo
0b80: 72 79 20 70 72 6f 76 69 64 65 64 20 75 73 69 6e  ry provided usin
0b90: 67 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67  g sqlite3_config
0ba0: 28 29 20 77 69 74 68 0a 2a 2a 20 20 20 20 20 20  () with.**      
0bb0: 20 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47     SQLITE_CONFIG
0bc0: 5f 50 41 47 45 43 41 43 48 45 2e 0a 2a 2a 20 20  _PAGECACHE..**  
0bd0: 20 20 28 33 29 20 20 50 43 61 63 68 65 2d 6c 6f    (3)  PCache-lo
0be0: 63 61 6c 20 62 75 6c 6b 20 61 6c 6c 6f 63 61 74  cal bulk allocat
0bf0: 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 74  ion..**.** The t
0c00: 68 69 72 64 20 63 61 73 65 20 69 73 20 61 20 63  hird case is a c
0c10: 68 75 6e 6b 20 6f 66 20 68 65 61 70 20 6d 65 6d  hunk of heap mem
0c20: 6f 72 79 20 28 64 65 66 61 75 6c 74 69 6e 67 20  ory (defaulting 
0c30: 74 6f 20 31 30 30 20 70 61 67 65 73 20 77 6f 72  to 100 pages wor
0c40: 74 68 29 0a 2a 2a 20 74 68 61 74 20 69 73 20 61  th).** that is a
0c50: 6c 6c 6f 63 61 74 65 64 20 77 68 65 6e 20 74 68  llocated when th
0c60: 65 20 70 61 67 65 20 63 61 63 68 65 20 69 73 20  e page cache is 
0c70: 63 72 65 61 74 65 64 2e 20 20 54 68 65 20 73 69  created.  The si
0c80: 7a 65 20 6f 66 20 74 68 65 20 6c 6f 63 61 6c 0a  ze of the local.
0c90: 2a 2a 20 62 75 6c 6b 20 61 6c 6c 6f 63 61 74 69  ** bulk allocati
0ca0: 6f 6e 20 63 61 6e 20 62 65 20 61 64 6a 75 73 74  on can be adjust
0cb0: 65 64 20 75 73 69 6e 67 20 0a 2a 2a 0a 2a 2a 20  ed using .**.** 
0cc0: 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66      sqlite3_conf
0cd0: 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47  ig(SQLITE_CONFIG
0ce0: 5f 50 41 47 45 43 41 43 48 45 2c 20 28 76 6f 69  _PAGECACHE, (voi
0cf0: 64 2a 29 30 2c 20 30 2c 20 4e 29 2e 0a 2a 2a 0a  d*)0, 0, N)..**.
0d00: 2a 2a 20 49 66 20 4e 20 69 73 20 70 6f 73 69 74  ** If N is posit
0d10: 69 76 65 2c 20 74 68 65 6e 20 4e 20 70 61 67 65  ive, then N page
0d20: 73 20 77 6f 72 74 68 20 6f 66 20 6d 65 6d 6f 72  s worth of memor
0d30: 79 20 61 72 65 20 61 6c 6c 6f 63 61 74 65 64 20  y are allocated 
0d40: 75 73 69 6e 67 20 61 20 73 69 6e 67 6c 65 0a 2a  using a single.*
0d50: 2a 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28  * sqlite3Malloc(
0d60: 29 20 63 61 6c 6c 20 61 6e 64 20 74 68 61 74 20  ) call and that 
0d70: 6d 65 6d 6f 72 79 20 69 73 20 75 73 65 64 20 66  memory is used f
0d80: 6f 72 20 74 68 65 20 66 69 72 73 74 20 4e 20 70  or the first N p
0d90: 61 67 65 73 20 61 6c 6c 6f 63 61 74 65 64 2e 0a  ages allocated..
0da0: 2a 2a 20 4f 72 20 69 66 20 4e 20 69 73 20 6e 65  ** Or if N is ne
0db0: 67 61 74 69 76 65 2c 20 74 68 65 6e 20 2d 31 30  gative, then -10
0dc0: 32 34 2a 4e 20 62 79 74 65 73 20 6f 66 20 6d 65  24*N bytes of me
0dd0: 6d 6f 72 79 20 61 72 65 20 61 6c 6c 6f 63 61 74  mory are allocat
0de0: 65 64 20 61 6e 64 20 75 73 65 64 0a 2a 2a 20 66  ed and used.** f
0df0: 6f 72 20 61 73 20 6d 61 6e 79 20 70 61 67 65 73  or as many pages
0e00: 20 61 73 20 63 61 6e 20 62 65 20 61 63 63 6f 6d   as can be accom
0e10: 6f 64 61 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 4f 6e  odated..**.** On
0e20: 6c 79 20 6f 6e 65 20 6f 66 20 28 32 29 20 6f 72  ly one of (2) or
0e30: 20 28 33 29 20 63 61 6e 20 62 65 20 75 73 65 64   (3) can be used
0e40: 2e 20 20 4f 6e 63 65 20 74 68 65 20 6d 65 6d 6f  .  Once the memo
0e50: 72 79 20 61 76 61 69 6c 61 62 6c 65 20 74 6f 20  ry available to 
0e60: 28 32 29 20 6f 72 0a 2a 2a 20 28 33 29 20 69 73  (2) or.** (3) is
0e70: 20 65 78 68 61 75 73 74 65 64 2c 20 73 75 62 73   exhausted, subs
0e80: 65 71 75 65 6e 74 20 61 6c 6c 6f 63 61 74 69 6f  equent allocatio
0e90: 6e 73 20 66 61 69 6c 20 6f 76 65 72 20 74 6f 20  ns fail over to 
0ea0: 74 68 65 20 67 65 6e 65 72 61 6c 2d 70 75 72 70  the general-purp
0eb0: 6f 73 65 0a 2a 2a 20 6d 65 6d 6f 72 79 20 61 6c  ose.** memory al
0ec0: 6c 6f 63 61 74 6f 72 20 28 31 29 2e 0a 2a 2a 0a  locator (1)..**.
0ed0: 2a 2a 20 45 61 72 6c 69 65 72 20 76 65 72 73 69  ** Earlier versi
0ee0: 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 75 73  ons of SQLite us
0ef0: 65 64 20 6f 6e 6c 79 20 6d 65 74 68 6f 64 73 20  ed only methods 
0f00: 28 31 29 20 61 6e 64 20 28 32 29 2e 20 20 42 75  (1) and (2).  Bu
0f10: 74 20 65 78 70 65 72 69 6d 65 6e 74 73 0a 2a 2a  t experiments.**
0f20: 20 73 68 6f 77 20 74 68 61 74 20 6d 65 74 68 6f   show that metho
0f30: 64 20 28 33 29 20 77 69 74 68 20 4e 3d 3d 31 30  d (3) with N==10
0f40: 30 20 70 72 6f 76 69 64 65 73 20 61 62 6f 75 74  0 provides about
0f50: 20 61 20 35 25 20 70 65 72 66 6f 72 6d 61 6e 63   a 5% performanc
0f60: 65 20 62 6f 6f 73 74 20 66 6f 72 0a 2a 2a 20 63  e boost for.** c
0f70: 6f 6d 6d 6f 6e 20 77 6f 72 6b 6c 6f 61 64 73 2e  ommon workloads.
0f80: 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71  .*/.#include "sq
0f90: 6c 69 74 65 49 6e 74 2e 68 22 0a 0a 74 79 70 65  liteInt.h"..type
0fa0: 64 65 66 20 73 74 72 75 63 74 20 50 43 61 63 68  def struct PCach
0fb0: 65 31 20 50 43 61 63 68 65 31 3b 0a 74 79 70 65  e1 PCache1;.type
0fc0: 64 65 66 20 73 74 72 75 63 74 20 50 67 48 64 72  def struct PgHdr
0fd0: 31 20 50 67 48 64 72 31 3b 0a 74 79 70 65 64 65  1 PgHdr1;.typede
0fe0: 66 20 73 74 72 75 63 74 20 50 67 46 72 65 65 73  f struct PgFrees
0ff0: 6c 6f 74 20 50 67 46 72 65 65 73 6c 6f 74 3b 0a  lot PgFreeslot;.
1000: 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 50  typedef struct P
1010: 47 72 6f 75 70 20 50 47 72 6f 75 70 3b 0a 0a 2f  Group PGroup;../
1020: 2a 0a 2a 2a 20 45 61 63 68 20 63 61 63 68 65 20  *.** Each cache 
1030: 65 6e 74 72 79 20 69 73 20 72 65 70 72 65 73 65  entry is represe
1040: 6e 74 65 64 20 62 79 20 61 6e 20 69 6e 73 74 61  nted by an insta
1050: 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f  nce of the follo
1060: 77 69 6e 67 20 0a 2a 2a 20 73 74 72 75 63 74 75  wing .** structu
1070: 72 65 2e 20 55 6e 6c 65 73 73 20 53 51 4c 49 54  re. Unless SQLIT
1080: 45 5f 50 43 41 43 48 45 5f 53 45 50 41 52 41 54  E_PCACHE_SEPARAT
1090: 45 5f 48 45 41 44 45 52 20 69 73 20 64 65 66 69  E_HEADER is defi
10a0: 6e 65 64 2c 20 61 20 62 75 66 66 65 72 20 6f 66  ned, a buffer of
10b0: 0a 2a 2a 20 50 67 48 64 72 31 2e 70 43 61 63 68  .** PgHdr1.pCach
10c0: 65 2d 3e 73 7a 50 61 67 65 20 62 79 74 65 73 20  e->szPage bytes 
10d0: 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 64 69 72  is allocated dir
10e0: 65 63 74 6c 79 20 62 65 66 6f 72 65 20 74 68 69  ectly before thi
10f0: 73 20 73 74 72 75 63 74 75 72 65 20 0a 2a 2a 20  s structure .** 
1100: 69 6e 20 6d 65 6d 6f 72 79 2e 0a 2a 2f 0a 73 74  in memory..*/.st
1110: 72 75 63 74 20 50 67 48 64 72 31 20 7b 0a 20 20  ruct PgHdr1 {.  
1120: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 70  sqlite3_pcache_p
1130: 61 67 65 20 70 61 67 65 3b 20 20 20 20 20 20 2f  age page;      /
1140: 2a 20 42 61 73 65 20 63 6c 61 73 73 2e 20 4d 75  * Base class. Mu
1150: 73 74 20 62 65 20 66 69 72 73 74 2e 20 70 42 75  st be first. pBu
1160: 66 20 26 20 70 45 78 74 72 61 20 2a 2f 0a 20 20  f & pExtra */.  
1170: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4b 65  unsigned int iKe
1180: 79 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  y;             /
1190: 2a 20 4b 65 79 20 76 61 6c 75 65 20 28 70 61 67  * Key value (pag
11a0: 65 20 6e 75 6d 62 65 72 29 20 2a 2f 0a 20 20 75  e number) */.  u
11b0: 38 20 69 73 42 75 6c 6b 4c 6f 63 61 6c 3b 20 20  8 isBulkLocal;  
11c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
11d0: 20 54 68 69 73 20 70 61 67 65 20 66 72 6f 6d 20   This page from 
11e0: 62 75 6c 6b 20 6c 6f 63 61 6c 20 73 74 6f 72 61  bulk local stora
11f0: 67 65 20 2a 2f 0a 20 20 75 38 20 69 73 41 6e 63  ge */.  u8 isAnc
1200: 68 6f 72 3b 20 20 20 20 20 20 20 20 20 20 20 20  hor;            
1210: 20 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 69         /* This i
1220: 73 20 74 68 65 20 50 47 72 6f 75 70 2e 6c 72 75  s the PGroup.lru
1230: 20 65 6c 65 6d 65 6e 74 20 2a 2f 0a 20 20 50 67   element */.  Pg
1240: 48 64 72 31 20 2a 70 4e 65 78 74 3b 20 20 20 20  Hdr1 *pNext;    
1250: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1260: 4e 65 78 74 20 69 6e 20 68 61 73 68 20 74 61 62  Next in hash tab
1270: 6c 65 20 63 68 61 69 6e 20 2a 2f 0a 20 20 50 43  le chain */.  PC
1280: 61 63 68 65 31 20 2a 70 43 61 63 68 65 3b 20 20  ache1 *pCache;  
1290: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
12a0: 43 61 63 68 65 20 74 68 61 74 20 63 75 72 72 65  Cache that curre
12b0: 6e 74 6c 79 20 6f 77 6e 73 20 74 68 69 73 20 70  ntly owns this p
12c0: 61 67 65 20 2a 2f 0a 20 20 50 67 48 64 72 31 20  age */.  PgHdr1 
12d0: 2a 70 4c 72 75 4e 65 78 74 3b 20 20 20 20 20 20  *pLruNext;      
12e0: 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20          /* Next 
12f0: 69 6e 20 4c 52 55 20 6c 69 73 74 20 6f 66 20 75  in LRU list of u
1300: 6e 70 69 6e 6e 65 64 20 70 61 67 65 73 20 2a 2f  npinned pages */
1310: 0a 20 20 50 67 48 64 72 31 20 2a 70 4c 72 75 50  .  PgHdr1 *pLruP
1320: 72 65 76 3b 20 20 20 20 20 20 20 20 20 20 20 20  rev;            
1330: 20 20 2f 2a 20 50 72 65 76 69 6f 75 73 20 69 6e    /* Previous in
1340: 20 4c 52 55 20 6c 69 73 74 20 6f 66 20 75 6e 70   LRU list of unp
1350: 69 6e 6e 65 64 20 70 61 67 65 73 20 2a 2f 0a 20  inned pages */. 
1360: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1370: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1380: 2f 2a 20 4e 42 3a 20 70 4c 72 75 50 72 65 76 20  /* NB: pLruPrev 
1390: 69 73 20 6f 6e 6c 79 20 76 61 6c 69 64 20 69 66  is only valid if
13a0: 20 70 4c 72 75 4e 65 78 74 21 3d 30 20 2a 2f 0a   pLruNext!=0 */.
13b0: 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 70 61 67 65  };../*.** A page
13c0: 20 69 73 20 70 69 6e 6e 65 64 20 69 66 20 69 74   is pinned if it
13d0: 20 69 73 20 6e 6f 74 20 6f 6e 20 74 68 65 20 4c   is not on the L
13e0: 52 55 20 6c 69 73 74 2e 20 20 54 6f 20 62 65 20  RU list.  To be 
13f0: 22 70 69 6e 6e 65 64 22 20 6d 65 61 6e 73 0a 2a  "pinned" means.*
1400: 2a 20 74 68 61 74 20 74 68 65 20 70 61 67 65 20  * that the page 
1410: 69 73 20 69 6e 20 61 63 74 69 76 65 20 75 73 65  is in active use
1420: 20 61 6e 64 20 6d 75 73 74 20 6e 6f 74 20 62 65   and must not be
1430: 20 64 65 61 6c 6c 6f 63 61 74 65 64 2e 0a 2a 2f   deallocated..*/
1440: 0a 23 64 65 66 69 6e 65 20 50 41 47 45 5f 49 53  .#define PAGE_IS
1450: 5f 50 49 4e 4e 45 44 28 70 29 20 20 20 20 28 28  _PINNED(p)    ((
1460: 70 29 2d 3e 70 4c 72 75 4e 65 78 74 3d 3d 30 29  p)->pLruNext==0)
1470: 0a 23 64 65 66 69 6e 65 20 50 41 47 45 5f 49 53  .#define PAGE_IS
1480: 5f 55 4e 50 49 4e 4e 45 44 28 70 29 20 20 28 28  _UNPINNED(p)  ((
1490: 70 29 2d 3e 70 4c 72 75 4e 65 78 74 21 3d 30 29  p)->pLruNext!=0)
14a0: 0a 0a 2f 2a 20 45 61 63 68 20 70 61 67 65 20 63  ../* Each page c
14b0: 61 63 68 65 20 28 6f 72 20 50 43 61 63 68 65 29  ache (or PCache)
14c0: 20 62 65 6c 6f 6e 67 73 20 74 6f 20 61 20 50 47   belongs to a PG
14d0: 72 6f 75 70 2e 20 20 41 20 50 47 72 6f 75 70 20  roup.  A PGroup 
14e0: 69 73 20 61 20 73 65 74 20 0a 2a 2a 20 6f 66 20  is a set .** of 
14f0: 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 50 43 61 63  one or more PCac
1500: 68 65 73 20 74 68 61 74 20 61 72 65 20 61 62 6c  hes that are abl
1510: 65 20 74 6f 20 72 65 63 79 63 6c 65 20 65 61 63  e to recycle eac
1520: 68 20 6f 74 68 65 72 27 73 20 75 6e 70 69 6e 6e  h other's unpinn
1530: 65 64 0a 2a 2a 20 70 61 67 65 73 20 77 68 65 6e  ed.** pages when
1540: 20 74 68 65 79 20 61 72 65 20 75 6e 64 65 72 20   they are under 
1550: 6d 65 6d 6f 72 79 20 70 72 65 73 73 75 72 65 2e  memory pressure.
1560: 20 20 41 20 50 47 72 6f 75 70 20 69 73 20 61 6e    A PGroup is an
1570: 20 69 6e 73 74 61 6e 63 65 20 6f 66 0a 2a 2a 20   instance of.** 
1580: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 62  the following ob
1590: 6a 65 63 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73  ject..**.** This
15a0: 20 70 61 67 65 20 63 61 63 68 65 20 69 6d 70 6c   page cache impl
15b0: 65 6d 65 6e 74 61 74 69 6f 6e 20 77 6f 72 6b 73  ementation works
15c0: 20 69 6e 20 6f 6e 65 20 6f 66 20 74 77 6f 20 6d   in one of two m
15d0: 6f 64 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 28 31  odes:.**.**   (1
15e0: 29 20 20 45 76 65 72 79 20 50 43 61 63 68 65 20  )  Every PCache 
15f0: 69 73 20 74 68 65 20 73 6f 6c 65 20 6d 65 6d 62  is the sole memb
1600: 65 72 20 6f 66 20 69 74 73 20 6f 77 6e 20 50 47  er of its own PG
1610: 72 6f 75 70 2e 20 20 54 68 65 72 65 20 69 73 0a  roup.  There is.
1620: 2a 2a 20 20 20 20 20 20 20 20 6f 6e 65 20 50 47  **        one PG
1630: 72 6f 75 70 20 70 65 72 20 50 43 61 63 68 65 2e  roup per PCache.
1640: 0a 2a 2a 0a 2a 2a 20 20 20 28 32 29 20 20 54 68  .**.**   (2)  Th
1650: 65 72 65 20 69 73 20 61 20 73 69 6e 67 6c 65 20  ere is a single 
1660: 67 6c 6f 62 61 6c 20 50 47 72 6f 75 70 20 74 68  global PGroup th
1670: 61 74 20 61 6c 6c 20 50 43 61 63 68 65 73 20 61  at all PCaches a
1680: 72 65 20 61 20 6d 65 6d 62 65 72 0a 2a 2a 20 20  re a member.**  
1690: 20 20 20 20 20 20 6f 66 2e 0a 2a 2a 0a 2a 2a 20        of..**.** 
16a0: 4d 6f 64 65 20 31 20 75 73 65 73 20 6d 6f 72 65  Mode 1 uses more
16b0: 20 6d 65 6d 6f 72 79 20 28 73 69 6e 63 65 20 50   memory (since P
16c0: 43 61 63 68 65 20 69 6e 73 74 61 6e 63 65 73 20  Cache instances 
16d0: 61 72 65 20 6e 6f 74 20 61 62 6c 65 20 74 6f 20  are not able to 
16e0: 72 6f 62 0a 2a 2a 20 75 6e 75 73 65 64 20 70 61  rob.** unused pa
16f0: 67 65 73 20 66 72 6f 6d 20 6f 74 68 65 72 20 50  ges from other P
1700: 43 61 63 68 65 73 29 20 62 75 74 20 69 74 20 61  Caches) but it a
1710: 6c 73 6f 20 6f 70 65 72 61 74 65 73 20 77 69 74  lso operates wit
1720: 68 6f 75 74 20 61 20 6d 75 74 65 78 2c 0a 2a 2a  hout a mutex,.**
1730: 20 61 6e 64 20 69 73 20 74 68 65 72 65 66 6f 72   and is therefor
1740: 65 20 6f 66 74 65 6e 20 66 61 73 74 65 72 2e 20  e often faster. 
1750: 20 4d 6f 64 65 20 32 20 72 65 71 75 69 72 65 73   Mode 2 requires
1760: 20 61 20 6d 75 74 65 78 20 69 6e 20 6f 72 64 65   a mutex in orde
1770: 72 20 74 6f 20 62 65 0a 2a 2a 20 74 68 72 65 61  r to be.** threa
1780: 64 73 61 66 65 2c 20 62 75 74 20 72 65 63 79 63  dsafe, but recyc
1790: 6c 65 73 20 70 61 67 65 73 20 6d 6f 72 65 20 65  les pages more e
17a0: 66 66 69 63 69 65 6e 74 6c 79 2e 0a 2a 2a 0a 2a  fficiently..**.*
17b0: 2a 20 46 6f 72 20 6d 6f 64 65 20 28 31 29 2c 20  * For mode (1), 
17c0: 50 47 72 6f 75 70 2e 6d 75 74 65 78 20 69 73 20  PGroup.mutex is 
17d0: 4e 55 4c 4c 2e 20 20 46 6f 72 20 6d 6f 64 65 20  NULL.  For mode 
17e0: 28 32 29 20 74 68 65 72 65 20 69 73 20 6f 6e 6c  (2) there is onl
17f0: 79 20 61 20 73 69 6e 67 6c 65 0a 2a 2a 20 50 47  y a single.** PG
1800: 72 6f 75 70 20 77 68 69 63 68 20 69 73 20 74 68  roup which is th
1810: 65 20 70 63 61 63 68 65 31 2e 67 72 70 20 67 6c  e pcache1.grp gl
1820: 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 20 61 6e  obal variable an
1830: 64 20 69 74 73 20 6d 75 74 65 78 20 69 73 0a 2a  d its mutex is.*
1840: 2a 20 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53  * SQLITE_MUTEX_S
1850: 54 41 54 49 43 5f 4c 52 55 2e 0a 2a 2f 0a 73 74  TATIC_LRU..*/.st
1860: 72 75 63 74 20 50 47 72 6f 75 70 20 7b 0a 20 20  ruct PGroup {.  
1870: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d  sqlite3_mutex *m
1880: 75 74 65 78 3b 20 20 20 20 20 20 20 20 20 20 2f  utex;          /
1890: 2a 20 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c  * MUTEX_STATIC_L
18a0: 52 55 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20  RU or NULL */.  
18b0: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 4d 61  unsigned int nMa
18c0: 78 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 2f  xPage;         /
18d0: 2a 20 53 75 6d 20 6f 66 20 6e 4d 61 78 20 66 6f  * Sum of nMax fo
18e0: 72 20 70 75 72 67 65 61 62 6c 65 20 63 61 63 68  r purgeable cach
18f0: 65 73 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64  es */.  unsigned
1900: 20 69 6e 74 20 6e 4d 69 6e 50 61 67 65 3b 20 20   int nMinPage;  
1910: 20 20 20 20 20 20 20 2f 2a 20 53 75 6d 20 6f 66         /* Sum of
1920: 20 6e 4d 69 6e 20 66 6f 72 20 70 75 72 67 65 61   nMin for purgea
1930: 62 6c 65 20 63 61 63 68 65 73 20 2a 2f 0a 20 20  ble caches */.  
1940: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6d 78 50  unsigned int mxP
1950: 69 6e 6e 65 64 3b 20 20 20 20 20 20 20 20 20 2f  inned;         /
1960: 2a 20 6e 4d 61 78 70 61 67 65 20 2b 20 31 30 20  * nMaxpage + 10 
1970: 2d 20 6e 4d 69 6e 50 61 67 65 20 2a 2f 0a 20 20  - nMinPage */.  
1980: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 50 75  unsigned int nPu
1990: 72 67 65 61 62 6c 65 3b 20 20 20 20 20 20 20 2f  rgeable;       /
19a0: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 75 72 67  * Number of purg
19b0: 65 61 62 6c 65 20 70 61 67 65 73 20 61 6c 6c 6f  eable pages allo
19c0: 63 61 74 65 64 20 2a 2f 0a 20 20 50 67 48 64 72  cated */.  PgHdr
19d0: 31 20 6c 72 75 3b 20 20 20 20 20 20 20 20 20 20  1 lru;          
19e0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65            /* The
19f0: 20 62 65 67 69 6e 6e 69 6e 67 20 61 6e 64 20 65   beginning and e
1a00: 6e 64 20 6f 66 20 74 68 65 20 4c 52 55 20 6c 69  nd of the LRU li
1a10: 73 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 45 61 63  st */.};../* Eac
1a20: 68 20 70 61 67 65 20 63 61 63 68 65 20 69 73 20  h page cache is 
1a30: 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74  an instance of t
1a40: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 62 6a  he following obj
1a50: 65 63 74 2e 20 20 45 76 65 72 79 0a 2a 2a 20 6f  ect.  Every.** o
1a60: 70 65 6e 20 64 61 74 61 62 61 73 65 20 66 69 6c  pen database fil
1a70: 65 20 28 69 6e 63 6c 75 64 69 6e 67 20 65 61 63  e (including eac
1a80: 68 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61  h in-memory data
1a90: 62 61 73 65 20 61 6e 64 20 65 61 63 68 0a 2a 2a  base and each.**
1aa0: 20 74 65 6d 70 6f 72 61 72 79 20 6f 72 20 74 72   temporary or tr
1ab0: 61 6e 73 69 65 6e 74 20 64 61 74 61 62 61 73 65  ansient database
1ac0: 29 20 68 61 73 20 61 20 73 69 6e 67 6c 65 20 70  ) has a single p
1ad0: 61 67 65 20 63 61 63 68 65 20 77 68 69 63 68 0a  age cache which.
1ae0: 2a 2a 20 69 73 20 61 6e 20 69 6e 73 74 61 6e 63  ** is an instanc
1af0: 65 20 6f 66 20 74 68 69 73 20 6f 62 6a 65 63 74  e of this object
1b00: 2e 0a 2a 2a 0a 2a 2a 20 50 6f 69 6e 74 65 72 73  ..**.** Pointers
1b10: 20 74 6f 20 73 74 72 75 63 74 75 72 65 73 20 6f   to structures o
1b20: 66 20 74 68 69 73 20 74 79 70 65 20 61 72 65 20  f this type are 
1b30: 63 61 73 74 20 61 6e 64 20 72 65 74 75 72 6e 65  cast and returne
1b40: 64 20 61 73 20 0a 2a 2a 20 6f 70 61 71 75 65 20  d as .** opaque 
1b50: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2a 20  sqlite3_pcache* 
1b60: 68 61 6e 64 6c 65 73 2e 0a 2a 2f 0a 73 74 72 75  handles..*/.stru
1b70: 63 74 20 50 43 61 63 68 65 31 20 7b 0a 20 20 2f  ct PCache1 {.  /
1b80: 2a 20 43 61 63 68 65 20 63 6f 6e 66 69 67 75 72  * Cache configur
1b90: 61 74 69 6f 6e 20 70 61 72 61 6d 65 74 65 72 73  ation parameters
1ba0: 2e 20 50 61 67 65 20 73 69 7a 65 20 28 73 7a 50  . Page size (szP
1bb0: 61 67 65 29 20 61 6e 64 20 74 68 65 20 70 75 72  age) and the pur
1bc0: 67 65 61 62 6c 65 0a 20 20 2a 2a 20 66 6c 61 67  geable.  ** flag
1bd0: 20 28 62 50 75 72 67 65 61 62 6c 65 29 20 61 6e   (bPurgeable) an
1be0: 64 20 74 68 65 20 70 6e 50 75 72 67 65 61 62 6c  d the pnPurgeabl
1bf0: 65 20 70 6f 69 6e 74 65 72 20 61 72 65 20 61 6c  e pointer are al
1c00: 6c 20 73 65 74 20 77 68 65 6e 20 74 68 65 0a 20  l set when the. 
1c10: 20 2a 2a 20 63 61 63 68 65 20 69 73 20 63 72 65   ** cache is cre
1c20: 61 74 65 64 20 61 6e 64 20 61 72 65 20 6e 65 76  ated and are nev
1c30: 65 72 20 63 68 61 6e 67 65 64 20 74 68 65 72 65  er changed there
1c40: 61 66 74 65 72 2e 20 6e 4d 61 78 20 6d 61 79 20  after. nMax may 
1c50: 62 65 20 0a 20 20 2a 2a 20 6d 6f 64 69 66 69 65  be .  ** modifie
1c60: 64 20 61 74 20 61 6e 79 20 74 69 6d 65 20 62 79  d at any time by
1c70: 20 61 20 63 61 6c 6c 20 74 6f 20 74 68 65 20 70   a call to the p
1c80: 63 61 63 68 65 31 43 61 63 68 65 73 69 7a 65 28  cache1Cachesize(
1c90: 29 20 6d 65 74 68 6f 64 2e 0a 20 20 2a 2a 20 54  ) method..  ** T
1ca0: 68 65 20 50 47 72 6f 75 70 20 6d 75 74 65 78 20  he PGroup mutex 
1cb0: 6d 75 73 74 20 62 65 20 68 65 6c 64 20 77 68 65  must be held whe
1cc0: 6e 20 61 63 63 65 73 73 69 6e 67 20 6e 4d 61 78  n accessing nMax
1cd0: 2e 0a 20 20 2a 2f 0a 20 20 50 47 72 6f 75 70 20  ..  */.  PGroup 
1ce0: 2a 70 47 72 6f 75 70 3b 20 20 20 20 20 20 20 20  *pGroup;        
1cf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1d00: 50 47 72 6f 75 70 20 74 68 69 73 20 63 61 63 68  PGroup this cach
1d10: 65 20 62 65 6c 6f 6e 67 73 20 74 6f 20 2a 2f 0a  e belongs to */.
1d20: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 2a    unsigned int *
1d30: 70 6e 50 75 72 67 65 61 62 6c 65 3b 20 20 20 20  pnPurgeable;    
1d40: 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72        /* Pointer
1d50: 20 74 6f 20 70 47 72 6f 75 70 2d 3e 6e 50 75 72   to pGroup->nPur
1d60: 67 65 61 62 6c 65 20 2a 2f 0a 20 20 69 6e 74 20  geable */.  int 
1d70: 73 7a 50 61 67 65 3b 20 20 20 20 20 20 20 20 20  szPage;         
1d80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1d90: 2f 2a 20 53 69 7a 65 20 6f 66 20 64 61 74 61 62  /* Size of datab
1da0: 61 73 65 20 63 6f 6e 74 65 6e 74 20 73 65 63 74  ase content sect
1db0: 69 6f 6e 20 2a 2f 0a 20 20 69 6e 74 20 73 7a 45  ion */.  int szE
1dc0: 78 74 72 61 3b 20 20 20 20 20 20 20 20 20 20 20  xtra;           
1dd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1de0: 73 69 7a 65 6f 66 28 4d 65 6d 50 61 67 65 29 2b  sizeof(MemPage)+
1df0: 73 69 7a 65 6f 66 28 50 67 48 64 72 29 20 2a 2f  sizeof(PgHdr) */
1e00: 0a 20 20 69 6e 74 20 73 7a 41 6c 6c 6f 63 3b 20  .  int szAlloc; 
1e10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1e20: 20 20 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20         /* Total 
1e30: 73 69 7a 65 20 6f 66 20 6f 6e 65 20 70 63 61 63  size of one pcac
1e40: 68 65 20 6c 69 6e 65 20 2a 2f 0a 20 20 69 6e 74  he line */.  int
1e50: 20 62 50 75 72 67 65 61 62 6c 65 3b 20 20 20 20   bPurgeable;    
1e60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1e70: 20 2f 2a 20 54 72 75 65 20 69 66 20 63 61 63 68   /* True if cach
1e80: 65 20 69 73 20 70 75 72 67 65 61 62 6c 65 20 2a  e is purgeable *
1e90: 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74  /.  unsigned int
1ea0: 20 6e 4d 69 6e 3b 20 20 20 20 20 20 20 20 20 20   nMin;          
1eb0: 20 20 20 20 20 20 20 20 2f 2a 20 4d 69 6e 69 6d          /* Minim
1ec0: 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67  um number of pag
1ed0: 65 73 20 72 65 73 65 72 76 65 64 20 2a 2f 0a 20  es reserved */. 
1ee0: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 4d   unsigned int nM
1ef0: 61 78 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  ax;             
1f00: 20 20 20 20 20 2f 2a 20 43 6f 6e 66 69 67 75 72       /* Configur
1f10: 65 64 20 22 63 61 63 68 65 5f 73 69 7a 65 22 20  ed "cache_size" 
1f20: 76 61 6c 75 65 20 2a 2f 0a 20 20 75 6e 73 69 67  value */.  unsig
1f30: 6e 65 64 20 69 6e 74 20 6e 39 30 70 63 74 3b 20  ned int n90pct; 
1f40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1f50: 2a 20 6e 4d 61 78 2a 39 2f 31 30 20 2a 2f 0a 20  * nMax*9/10 */. 
1f60: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4d   unsigned int iM
1f70: 61 78 4b 65 79 3b 20 20 20 20 20 20 20 20 20 20  axKey;          
1f80: 20 20 20 20 20 2f 2a 20 4c 61 72 67 65 73 74 20       /* Largest 
1f90: 6b 65 79 20 73 65 65 6e 20 73 69 6e 63 65 20 78  key seen since x
1fa0: 54 72 75 6e 63 61 74 65 28 29 20 2a 2f 0a 0a 20  Truncate() */.. 
1fb0: 20 2f 2a 20 48 61 73 68 20 74 61 62 6c 65 20 6f   /* Hash table o
1fc0: 66 20 61 6c 6c 20 70 61 67 65 73 2e 20 54 68 65  f all pages. The
1fd0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 76 61 72 69 61   following varia
1fe0: 62 6c 65 73 20 6d 61 79 20 6f 6e 6c 79 20 62 65  bles may only be
1ff0: 20 61 63 63 65 73 73 65 64 0a 20 20 2a 2a 20 77   accessed.  ** w
2000: 68 65 6e 20 74 68 65 20 61 63 63 65 73 73 6f 72  hen the accessor
2010: 20 69 73 20 68 6f 6c 64 69 6e 67 20 74 68 65 20   is holding the 
2020: 50 47 72 6f 75 70 20 6d 75 74 65 78 2e 0a 20 20  PGroup mutex..  
2030: 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e  */.  unsigned in
2040: 74 20 6e 52 65 63 79 63 6c 61 62 6c 65 3b 20 20  t nRecyclable;  
2050: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62           /* Numb
2060: 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74  er of pages in t
2070: 68 65 20 4c 52 55 20 6c 69 73 74 20 2a 2f 0a 20  he LRU list */. 
2080: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 50   unsigned int nP
2090: 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 20  age;            
20a0: 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 6e 75       /* Total nu
20b0: 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e  mber of pages in
20c0: 20 61 70 48 61 73 68 20 2a 2f 0a 20 20 75 6e 73   apHash */.  uns
20d0: 69 67 6e 65 64 20 69 6e 74 20 6e 48 61 73 68 3b  igned int nHash;
20e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
20f0: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 73 6c   /* Number of sl
2100: 6f 74 73 20 69 6e 20 61 70 48 61 73 68 5b 5d 20  ots in apHash[] 
2110: 2a 2f 0a 20 20 50 67 48 64 72 31 20 2a 2a 61 70  */.  PgHdr1 **ap
2120: 48 61 73 68 3b 20 20 20 20 20 20 20 20 20 20 20  Hash;           
2130: 20 20 20 20 20 20 20 20 20 2f 2a 20 48 61 73 68           /* Hash
2140: 20 74 61 62 6c 65 20 66 6f 72 20 66 61 73 74 20   table for fast 
2150: 6c 6f 6f 6b 75 70 20 62 79 20 6b 65 79 20 2a 2f  lookup by key */
2160: 0a 20 20 50 67 48 64 72 31 20 2a 70 46 72 65 65  .  PgHdr1 *pFree
2170: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
2180: 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f         /* List o
2190: 66 20 75 6e 75 73 65 64 20 70 63 61 63 68 65 2d  f unused pcache-
21a0: 6c 6f 63 61 6c 20 70 61 67 65 73 20 2a 2f 0a 20  local pages */. 
21b0: 20 76 6f 69 64 20 2a 70 42 75 6c 6b 3b 20 20 20   void *pBulk;   
21c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
21d0: 20 20 20 20 20 2f 2a 20 42 75 6c 6b 20 6d 65 6d       /* Bulk mem
21e0: 6f 72 79 20 75 73 65 64 20 62 79 20 70 63 61 63  ory used by pcac
21f0: 68 65 2d 6c 6f 63 61 6c 20 2a 2f 0a 7d 3b 0a 0a  he-local */.};..
2200: 2f 2a 0a 2a 2a 20 46 72 65 65 20 73 6c 6f 74 73  /*.** Free slots
2210: 20 69 6e 20 74 68 65 20 61 6c 6c 6f 63 61 74 6f   in the allocato
2220: 72 20 75 73 65 64 20 74 6f 20 64 69 76 69 64 65  r used to divide
2230: 20 75 70 20 74 68 65 20 67 6c 6f 62 61 6c 20 70   up the global p
2240: 61 67 65 20 63 61 63 68 65 0a 2a 2a 20 62 75 66  age cache.** buf
2250: 66 65 72 20 70 72 6f 76 69 64 65 64 20 75 73 69  fer provided usi
2260: 6e 67 20 74 68 65 20 53 51 4c 49 54 45 5f 43 4f  ng the SQLITE_CO
2270: 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45 20 6d  NFIG_PAGECACHE m
2280: 65 63 68 61 6e 69 73 6d 2e 0a 2a 2f 0a 73 74 72  echanism..*/.str
2290: 75 63 74 20 50 67 46 72 65 65 73 6c 6f 74 20 7b  uct PgFreeslot {
22a0: 0a 20 20 50 67 46 72 65 65 73 6c 6f 74 20 2a 70  .  PgFreeslot *p
22b0: 4e 65 78 74 3b 20 20 2f 2a 20 4e 65 78 74 20 66  Next;  /* Next f
22c0: 72 65 65 20 73 6c 6f 74 20 2a 2f 0a 7d 3b 0a 0a  ree slot */.};..
22d0: 2f 2a 0a 2a 2a 20 47 6c 6f 62 61 6c 20 64 61 74  /*.** Global dat
22e0: 61 20 75 73 65 64 20 62 79 20 74 68 69 73 20 63  a used by this c
22f0: 61 63 68 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  ache..*/.static 
2300: 53 51 4c 49 54 45 5f 57 53 44 20 73 74 72 75 63  SQLITE_WSD struc
2310: 74 20 50 43 61 63 68 65 47 6c 6f 62 61 6c 20 7b  t PCacheGlobal {
2320: 0a 20 20 50 47 72 6f 75 70 20 67 72 70 3b 20 20  .  PGroup grp;  
2330: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2340: 20 20 2f 2a 20 54 68 65 20 67 6c 6f 62 61 6c 20    /* The global 
2350: 50 47 72 6f 75 70 20 66 6f 72 20 6d 6f 64 65 20  PGroup for mode 
2360: 28 32 29 20 2a 2f 0a 0a 20 20 2f 2a 20 56 61 72  (2) */..  /* Var
2370: 69 61 62 6c 65 73 20 72 65 6c 61 74 65 64 20 74  iables related t
2380: 6f 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f  o SQLITE_CONFIG_
2390: 50 41 47 45 43 41 43 48 45 20 73 65 74 74 69 6e  PAGECACHE settin
23a0: 67 73 2e 20 20 54 68 65 0a 20 20 2a 2a 20 73 7a  gs.  The.  ** sz
23b0: 53 6c 6f 74 2c 20 6e 53 6c 6f 74 2c 20 70 53 74  Slot, nSlot, pSt
23c0: 61 72 74 2c 20 70 45 6e 64 2c 20 6e 52 65 73 65  art, pEnd, nRese
23d0: 72 76 65 2c 20 61 6e 64 20 69 73 49 6e 69 74 20  rve, and isInit 
23e0: 76 61 6c 75 65 73 20 61 72 65 20 61 6c 6c 0a 20  values are all. 
23f0: 20 2a 2a 20 66 69 78 65 64 20 61 74 20 73 71 6c   ** fixed at sql
2400: 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28  ite3_initialize(
2410: 29 20 74 69 6d 65 20 61 6e 64 20 64 6f 20 6e 6f  ) time and do no
2420: 74 20 72 65 71 75 69 72 65 20 6d 75 74 65 78 20  t require mutex 
2430: 70 72 6f 74 65 63 74 69 6f 6e 2e 0a 20 20 2a 2a  protection..  **
2440: 20 54 68 65 20 6e 46 72 65 65 53 6c 6f 74 20 61   The nFreeSlot a
2450: 6e 64 20 70 46 72 65 65 20 76 61 6c 75 65 73 20  nd pFree values 
2460: 64 6f 20 72 65 71 75 69 72 65 20 6d 75 74 65 78  do require mutex
2470: 20 70 72 6f 74 65 63 74 69 6f 6e 2e 0a 20 20 2a   protection..  *
2480: 2f 0a 20 20 69 6e 74 20 69 73 49 6e 69 74 3b 20  /.  int isInit; 
2490: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
24a0: 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 69 6e     /* True if in
24b0: 69 74 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 20 69  itialized */.  i
24c0: 6e 74 20 73 65 70 61 72 61 74 65 43 61 63 68 65  nt separateCache
24d0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ;             /*
24e0: 20 55 73 65 20 61 20 6e 65 77 20 50 47 72 6f 75   Use a new PGrou
24f0: 70 20 66 6f 72 20 65 61 63 68 20 50 43 61 63 68  p for each PCach
2500: 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 49 6e 69 74  e */.  int nInit
2510: 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 20  Page;           
2520: 20 20 20 20 20 20 2f 2a 20 49 6e 69 74 69 61 6c        /* Initial
2530: 20 62 75 6c 6b 20 61 6c 6c 6f 63 61 74 69 6f 6e   bulk allocation
2540: 20 73 69 7a 65 20 2a 2f 20 20 20 0a 20 20 69 6e   size */   .  in
2550: 74 20 73 7a 53 6c 6f 74 3b 20 20 20 20 20 20 20  t szSlot;       
2560: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
2570: 53 69 7a 65 20 6f 66 20 65 61 63 68 20 66 72 65  Size of each fre
2580: 65 20 73 6c 6f 74 20 2a 2f 0a 20 20 69 6e 74 20  e slot */.  int 
2590: 6e 53 6c 6f 74 3b 20 20 20 20 20 20 20 20 20 20  nSlot;          
25a0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68             /* Th
25b0: 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 63 61 63  e number of pcac
25c0: 68 65 20 73 6c 6f 74 73 20 2a 2f 0a 20 20 69 6e  he slots */.  in
25d0: 74 20 6e 52 65 73 65 72 76 65 3b 20 20 20 20 20  t nReserve;     
25e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
25f0: 54 72 79 20 74 6f 20 6b 65 65 70 20 6e 46 72 65  Try to keep nFre
2600: 65 53 6c 6f 74 20 61 62 6f 76 65 20 74 68 69 73  eSlot above this
2610: 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 53 74 61   */.  void *pSta
2620: 72 74 2c 20 2a 70 45 6e 64 3b 20 20 20 20 20 20  rt, *pEnd;      
2630: 20 20 20 20 20 2f 2a 20 42 6f 75 6e 64 73 20 6f       /* Bounds o
2640: 66 20 67 6c 6f 62 61 6c 20 70 61 67 65 20 63 61  f global page ca
2650: 63 68 65 20 6d 65 6d 6f 72 79 20 2a 2f 0a 20 20  che memory */.  
2660: 2f 2a 20 41 62 6f 76 65 20 72 65 71 75 69 72 65  /* Above require
2670: 73 20 6e 6f 20 6d 75 74 65 78 2e 20 20 55 73 65  s no mutex.  Use
2680: 20 6d 75 74 65 78 20 62 65 6c 6f 77 20 66 6f 72   mutex below for
2690: 20 76 61 72 69 61 62 6c 65 20 74 68 61 74 20 66   variable that f
26a0: 6f 6c 6c 6f 77 2e 20 2a 2f 0a 20 20 73 71 6c 69  ollow. */.  sqli
26b0: 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78  te3_mutex *mutex
26c0: 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 75  ;          /* Mu
26d0: 74 65 78 20 66 6f 72 20 61 63 63 65 73 73 69 6e  tex for accessin
26e0: 67 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a  g the following:
26f0: 20 2a 2f 0a 20 20 50 67 46 72 65 65 73 6c 6f 74   */.  PgFreeslot
2700: 20 2a 70 46 72 65 65 3b 20 20 20 20 20 20 20 20   *pFree;        
2710: 20 20 20 20 20 2f 2a 20 46 72 65 65 20 70 61 67       /* Free pag
2720: 65 20 62 6c 6f 63 6b 73 20 2a 2f 0a 20 20 69 6e  e blocks */.  in
2730: 74 20 6e 46 72 65 65 53 6c 6f 74 3b 20 20 20 20  t nFreeSlot;    
2740: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
2750: 4e 75 6d 62 65 72 20 6f 66 20 75 6e 75 73 65 64  Number of unused
2760: 20 70 63 61 63 68 65 20 73 6c 6f 74 73 20 2a 2f   pcache slots */
2770: 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77  .  /* The follow
2780: 69 6e 67 20 76 61 6c 75 65 20 72 65 71 75 69 72  ing value requir
2790: 65 73 20 61 20 6d 75 74 65 78 20 74 6f 20 63 68  es a mutex to ch
27a0: 61 6e 67 65 2e 20 20 57 65 20 73 6b 69 70 20 74  ange.  We skip t
27b0: 68 65 20 6d 75 74 65 78 20 6f 6e 0a 20 20 2a 2a  he mutex on.  **
27c0: 20 72 65 61 64 69 6e 67 20 62 65 63 61 75 73 65   reading because
27d0: 20 28 31 29 20 6d 6f 73 74 20 70 6c 61 74 66 6f   (1) most platfo
27e0: 72 6d 73 20 72 65 61 64 20 61 20 33 32 2d 62 69  rms read a 32-bi
27f0: 74 20 69 6e 74 65 67 65 72 20 61 74 6f 6d 69 63  t integer atomic
2800: 61 6c 6c 79 20 61 6e 64 0a 20 20 2a 2a 20 28 32  ally and.  ** (2
2810: 29 20 65 76 65 6e 20 69 66 20 61 6e 20 69 6e 63  ) even if an inc
2820: 6f 72 72 65 63 74 20 76 61 6c 75 65 20 69 73 20  orrect value is 
2830: 72 65 61 64 2c 20 6e 6f 20 67 72 65 61 74 20 68  read, no great h
2840: 61 72 6d 20 69 73 20 64 6f 6e 65 20 73 69 6e 63  arm is done sinc
2850: 65 20 74 68 69 73 0a 20 20 2a 2a 20 69 73 20 72  e this.  ** is r
2860: 65 61 6c 6c 79 20 6a 75 73 74 20 61 6e 20 6f 70  eally just an op
2870: 74 69 6d 69 7a 61 74 69 6f 6e 2e 20 2a 2f 0a 20  timization. */. 
2880: 20 69 6e 74 20 62 55 6e 64 65 72 50 72 65 73 73   int bUnderPress
2890: 75 72 65 3b 20 20 20 20 20 20 20 20 20 20 20 20  ure;            
28a0: 2f 2a 20 54 72 75 65 20 69 66 20 6c 6f 77 20 6f  /* True if low o
28b0: 6e 20 50 41 47 45 43 41 43 48 45 20 6d 65 6d 6f  n PAGECACHE memo
28c0: 72 79 20 2a 2f 0a 7d 20 70 63 61 63 68 65 31 5f  ry */.} pcache1_
28d0: 67 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 20 63 6f  g;../*.** All co
28e0: 64 65 20 69 6e 20 74 68 69 73 20 66 69 6c 65 20  de in this file 
28f0: 73 68 6f 75 6c 64 20 61 63 63 65 73 73 20 74 68  should access th
2900: 65 20 67 6c 6f 62 61 6c 20 73 74 72 75 63 74 75  e global structu
2910: 72 65 20 61 62 6f 76 65 20 76 69 61 20 74 68 65  re above via the
2920: 0a 2a 2a 20 61 6c 69 61 73 20 22 70 63 61 63 68  .** alias "pcach
2930: 65 31 22 2e 20 54 68 69 73 20 65 6e 73 75 72 65  e1". This ensure
2940: 73 20 74 68 61 74 20 74 68 65 20 57 53 44 20 65  s that the WSD e
2950: 6d 75 6c 61 74 69 6f 6e 20 69 73 20 75 73 65 64  mulation is used
2960: 20 77 68 65 6e 0a 2a 2a 20 63 6f 6d 70 69 6c 69   when.** compili
2970: 6e 67 20 66 6f 72 20 73 79 73 74 65 6d 73 20 74  ng for systems t
2980: 68 61 74 20 64 6f 20 6e 6f 74 20 73 75 70 70 6f  hat do not suppo
2990: 72 74 20 72 65 61 6c 20 57 53 44 2e 0a 2a 2f 0a  rt real WSD..*/.
29a0: 23 64 65 66 69 6e 65 20 70 63 61 63 68 65 31 20  #define pcache1 
29b0: 28 47 4c 4f 42 41 4c 28 73 74 72 75 63 74 20 50  (GLOBAL(struct P
29c0: 43 61 63 68 65 47 6c 6f 62 61 6c 2c 20 70 63 61  CacheGlobal, pca
29d0: 63 68 65 31 5f 67 29 29 0a 0a 2f 2a 0a 2a 2a 20  che1_g))../*.** 
29e0: 4d 61 63 72 6f 73 20 74 6f 20 65 6e 74 65 72 20  Macros to enter 
29f0: 61 6e 64 20 6c 65 61 76 65 20 74 68 65 20 50 43  and leave the PC
2a00: 61 63 68 65 20 4c 52 55 20 6d 75 74 65 78 2e 0a  ache LRU mutex..
2a10: 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28  */.#if !defined(
2a20: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45  SQLITE_ENABLE_ME
2a30: 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 29  MORY_MANAGEMENT)
2a40: 20 7c 7c 20 53 51 4c 49 54 45 5f 54 48 52 45 41   || SQLITE_THREA
2a50: 44 53 41 46 45 3d 3d 30 0a 23 20 64 65 66 69 6e  DSAFE==0.# defin
2a60: 65 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75  e pcache1EnterMu
2a70: 74 65 78 28 58 29 20 20 61 73 73 65 72 74 28 28  tex(X)  assert((
2a80: 58 29 2d 3e 6d 75 74 65 78 3d 3d 30 29 0a 23 20  X)->mutex==0).# 
2a90: 64 65 66 69 6e 65 20 70 63 61 63 68 65 31 4c 65  define pcache1Le
2aa0: 61 76 65 4d 75 74 65 78 28 58 29 20 20 61 73 73  aveMutex(X)  ass
2ab0: 65 72 74 28 28 58 29 2d 3e 6d 75 74 65 78 3d 3d  ert((X)->mutex==
2ac0: 30 29 0a 23 20 64 65 66 69 6e 65 20 50 43 41 43  0).# define PCAC
2ad0: 48 45 31 5f 4d 49 47 48 54 5f 55 53 45 5f 47 52  HE1_MIGHT_USE_GR
2ae0: 4f 55 50 5f 4d 55 54 45 58 20 30 0a 23 65 6c 73  OUP_MUTEX 0.#els
2af0: 65 0a 23 20 64 65 66 69 6e 65 20 70 63 61 63 68  e.# define pcach
2b00: 65 31 45 6e 74 65 72 4d 75 74 65 78 28 58 29 20  e1EnterMutex(X) 
2b10: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e  sqlite3_mutex_en
2b20: 74 65 72 28 28 58 29 2d 3e 6d 75 74 65 78 29 0a  ter((X)->mutex).
2b30: 23 20 64 65 66 69 6e 65 20 70 63 61 63 68 65 31  # define pcache1
2b40: 4c 65 61 76 65 4d 75 74 65 78 28 58 29 20 73 71  LeaveMutex(X) sq
2b50: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76  lite3_mutex_leav
2b60: 65 28 28 58 29 2d 3e 6d 75 74 65 78 29 0a 23 20  e((X)->mutex).# 
2b70: 64 65 66 69 6e 65 20 50 43 41 43 48 45 31 5f 4d  define PCACHE1_M
2b80: 49 47 48 54 5f 55 53 45 5f 47 52 4f 55 50 5f 4d  IGHT_USE_GROUP_M
2b90: 55 54 45 58 20 31 0a 23 65 6e 64 69 66 0a 0a 2f  UTEX 1.#endif../
2ba0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2bb0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2bc0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2bd0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2be0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a  **************/.
2bf0: 2f 2a 2a 2a 2a 2a 2a 2a 2a 20 50 61 67 65 20 41  /******** Page A
2c00: 6c 6c 6f 63 61 74 69 6f 6e 2f 53 51 4c 49 54 45  llocation/SQLITE
2c10: 5f 43 4f 4e 46 49 47 5f 50 43 41 43 48 45 20 52  _CONFIG_PCACHE R
2c20: 65 6c 61 74 65 64 20 46 75 6e 63 74 69 6f 6e 73  elated Functions
2c30: 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f   **************/
2c40: 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75  .../*.** This fu
2c50: 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64  nction is called
2c60: 20 64 75 72 69 6e 67 20 69 6e 69 74 69 61 6c 69   during initiali
2c70: 7a 61 74 69 6f 6e 20 69 66 20 61 20 73 74 61 74  zation if a stat
2c80: 69 63 20 62 75 66 66 65 72 20 69 73 20 0a 2a 2a  ic buffer is .**
2c90: 20 73 75 70 70 6c 69 65 64 20 74 6f 20 75 73 65   supplied to use
2ca0: 20 66 6f 72 20 74 68 65 20 70 61 67 65 2d 63 61   for the page-ca
2cb0: 63 68 65 20 62 79 20 70 61 73 73 69 6e 67 20 74  che by passing t
2cc0: 68 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47  he SQLITE_CONFIG
2cd0: 5f 50 41 47 45 43 41 43 48 45 0a 2a 2a 20 76 65  _PAGECACHE.** ve
2ce0: 72 62 20 74 6f 20 73 71 6c 69 74 65 33 5f 63 6f  rb to sqlite3_co
2cf0: 6e 66 69 67 28 29 2e 20 50 61 72 61 6d 65 74 65  nfig(). Paramete
2d00: 72 20 70 42 75 66 20 70 6f 69 6e 74 73 20 74 6f  r pBuf points to
2d10: 20 61 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 6c   an allocation l
2d20: 61 72 67 65 0a 2a 2a 20 65 6e 6f 75 67 68 20 74  arge.** enough t
2d30: 6f 20 63 6f 6e 74 61 69 6e 20 27 6e 27 20 62 75  o contain 'n' bu
2d40: 66 66 65 72 73 20 6f 66 20 27 73 7a 27 20 62 79  ffers of 'sz' by
2d50: 74 65 73 20 65 61 63 68 2e 0a 2a 2a 0a 2a 2a 20  tes each..**.** 
2d60: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20  This routine is 
2d70: 63 61 6c 6c 65 64 20 66 72 6f 6d 20 73 71 6c 69  called from sqli
2d80: 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29  te3_initialize()
2d90: 20 61 6e 64 20 73 6f 20 69 74 20 69 73 20 67 75   and so it is gu
2da0: 61 72 61 6e 74 65 65 64 0a 2a 2a 20 74 6f 20 62  aranteed.** to b
2db0: 65 20 73 65 72 69 61 6c 69 7a 65 64 20 61 6c 72  e serialized alr
2dc0: 65 61 64 79 2e 20 20 54 68 65 72 65 20 69 73 20  eady.  There is 
2dd0: 6e 6f 20 6e 65 65 64 20 66 6f 72 20 66 75 72 74  no need for furt
2de0: 68 65 72 20 6d 75 74 65 78 69 6e 67 2e 0a 2a 2f  her mutexing..*/
2df0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 43 61  .void sqlite3PCa
2e00: 63 68 65 42 75 66 66 65 72 53 65 74 75 70 28 76  cheBufferSetup(v
2e10: 6f 69 64 20 2a 70 42 75 66 2c 20 69 6e 74 20 73  oid *pBuf, int s
2e20: 7a 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 69 66 28  z, int n){.  if(
2e30: 20 70 63 61 63 68 65 31 2e 69 73 49 6e 69 74 20   pcache1.isInit 
2e40: 29 7b 0a 20 20 20 20 50 67 46 72 65 65 73 6c 6f  ){.    PgFreeslo
2e50: 74 20 2a 70 3b 0a 20 20 20 20 69 66 28 20 70 42  t *p;.    if( pB
2e60: 75 66 3d 3d 30 20 29 20 73 7a 20 3d 20 6e 20 3d  uf==0 ) sz = n =
2e70: 20 30 3b 0a 20 20 20 20 69 66 28 20 6e 3d 3d 30   0;.    if( n==0
2e80: 20 29 20 73 7a 20 3d 20 30 3b 0a 20 20 20 20 73   ) sz = 0;.    s
2e90: 7a 20 3d 20 52 4f 55 4e 44 44 4f 57 4e 38 28 73  z = ROUNDDOWN8(s
2ea0: 7a 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e  z);.    pcache1.
2eb0: 73 7a 53 6c 6f 74 20 3d 20 73 7a 3b 0a 20 20 20  szSlot = sz;.   
2ec0: 20 70 63 61 63 68 65 31 2e 6e 53 6c 6f 74 20 3d   pcache1.nSlot =
2ed0: 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65 53 6c   pcache1.nFreeSl
2ee0: 6f 74 20 3d 20 6e 3b 0a 20 20 20 20 70 63 61 63  ot = n;.    pcac
2ef0: 68 65 31 2e 6e 52 65 73 65 72 76 65 20 3d 20 6e  he1.nReserve = n
2f00: 3e 39 30 20 3f 20 31 30 20 3a 20 28 6e 2f 31 30  >90 ? 10 : (n/10
2f10: 20 2b 20 31 29 3b 0a 20 20 20 20 70 63 61 63 68   + 1);.    pcach
2f20: 65 31 2e 70 53 74 61 72 74 20 3d 20 70 42 75 66  e1.pStart = pBuf
2f30: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 70 46  ;.    pcache1.pF
2f40: 72 65 65 20 3d 20 30 3b 0a 20 20 20 20 70 63 61  ree = 0;.    pca
2f50: 63 68 65 31 2e 62 55 6e 64 65 72 50 72 65 73 73  che1.bUnderPress
2f60: 75 72 65 20 3d 20 30 3b 0a 20 20 20 20 77 68 69  ure = 0;.    whi
2f70: 6c 65 28 20 6e 2d 2d 20 29 7b 0a 20 20 20 20 20  le( n-- ){.     
2f80: 20 70 20 3d 20 28 50 67 46 72 65 65 73 6c 6f 74   p = (PgFreeslot
2f90: 2a 29 70 42 75 66 3b 0a 20 20 20 20 20 20 70 2d  *)pBuf;.      p-
2fa0: 3e 70 4e 65 78 74 20 3d 20 70 63 61 63 68 65 31  >pNext = pcache1
2fb0: 2e 70 46 72 65 65 3b 0a 20 20 20 20 20 20 70 63  .pFree;.      pc
2fc0: 61 63 68 65 31 2e 70 46 72 65 65 20 3d 20 70 3b  ache1.pFree = p;
2fd0: 0a 20 20 20 20 20 20 70 42 75 66 20 3d 20 28 76  .      pBuf = (v
2fe0: 6f 69 64 2a 29 26 28 28 63 68 61 72 2a 29 70 42  oid*)&((char*)pB
2ff0: 75 66 29 5b 73 7a 5d 3b 0a 20 20 20 20 7d 0a 20  uf)[sz];.    }. 
3000: 20 20 20 70 63 61 63 68 65 31 2e 70 45 6e 64 20     pcache1.pEnd 
3010: 3d 20 70 42 75 66 3b 0a 20 20 7d 0a 7d 0a 0a 2f  = pBuf;.  }.}../
3020: 2a 0a 2a 2a 20 54 72 79 20 74 6f 20 69 6e 69 74  *.** Try to init
3030: 69 61 6c 69 7a 65 20 74 68 65 20 70 43 61 63 68  ialize the pCach
3040: 65 2d 3e 70 46 72 65 65 20 61 6e 64 20 70 43 61  e->pFree and pCa
3050: 63 68 65 2d 3e 70 42 75 6c 6b 20 66 69 65 6c 64  che->pBulk field
3060: 73 2e 20 20 52 65 74 75 72 6e 0a 2a 2a 20 74 72  s.  Return.** tr
3070: 75 65 20 69 66 20 70 43 61 63 68 65 2d 3e 70 46  ue if pCache->pF
3080: 72 65 65 20 65 6e 64 73 20 75 70 20 63 6f 6e 74  ree ends up cont
3090: 61 69 6e 69 6e 67 20 6f 6e 65 20 6f 72 20 6d 6f  aining one or mo
30a0: 72 65 20 66 72 65 65 20 70 61 67 65 73 2e 0a 2a  re free pages..*
30b0: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 63 61  /.static int pca
30c0: 63 68 65 31 49 6e 69 74 42 75 6c 6b 28 50 43 61  che1InitBulk(PCa
30d0: 63 68 65 31 20 2a 70 43 61 63 68 65 29 7b 0a 20  che1 *pCache){. 
30e0: 20 69 36 34 20 73 7a 42 75 6c 6b 3b 0a 20 20 63   i64 szBulk;.  c
30f0: 68 61 72 20 2a 7a 42 75 6c 6b 3b 0a 20 20 69 66  har *zBulk;.  if
3100: 28 20 70 63 61 63 68 65 31 2e 6e 49 6e 69 74 50  ( pcache1.nInitP
3110: 61 67 65 3d 3d 30 20 29 20 72 65 74 75 72 6e 20  age==0 ) return 
3120: 30 3b 0a 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 62  0;.  /* Do not b
3130: 6f 74 68 65 72 20 77 69 74 68 20 61 20 62 75 6c  other with a bul
3140: 6b 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69 66 20  k allocation if 
3150: 74 68 65 20 63 61 63 68 65 20 73 69 7a 65 20 76  the cache size v
3160: 65 72 79 20 73 6d 61 6c 6c 20 2a 2f 0a 20 20 69  ery small */.  i
3170: 66 28 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 3c  f( pCache->nMax<
3180: 33 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20  3 ) return 0;.  
3190: 73 71 6c 69 74 65 33 42 65 67 69 6e 42 65 6e 69  sqlite3BeginBeni
31a0: 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 69 66  gnMalloc();.  if
31b0: 28 20 70 63 61 63 68 65 31 2e 6e 49 6e 69 74 50  ( pcache1.nInitP
31c0: 61 67 65 3e 30 20 29 7b 0a 20 20 20 20 73 7a 42  age>0 ){.    szB
31d0: 75 6c 6b 20 3d 20 70 43 61 63 68 65 2d 3e 73 7a  ulk = pCache->sz
31e0: 41 6c 6c 6f 63 20 2a 20 28 69 36 34 29 70 63 61  Alloc * (i64)pca
31f0: 63 68 65 31 2e 6e 49 6e 69 74 50 61 67 65 3b 0a  che1.nInitPage;.
3200: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 7a 42    }else{.    szB
3210: 75 6c 6b 20 3d 20 2d 31 30 32 34 20 2a 20 28 69  ulk = -1024 * (i
3220: 36 34 29 70 63 61 63 68 65 31 2e 6e 49 6e 69 74  64)pcache1.nInit
3230: 50 61 67 65 3b 0a 20 20 7d 0a 20 20 69 66 28 20  Page;.  }.  if( 
3240: 73 7a 42 75 6c 6b 20 3e 20 70 43 61 63 68 65 2d  szBulk > pCache-
3250: 3e 73 7a 41 6c 6c 6f 63 2a 28 69 36 34 29 70 43  >szAlloc*(i64)pC
3260: 61 63 68 65 2d 3e 6e 4d 61 78 20 29 7b 0a 20 20  ache->nMax ){.  
3270: 20 20 73 7a 42 75 6c 6b 20 3d 20 70 43 61 63 68    szBulk = pCach
3280: 65 2d 3e 73 7a 41 6c 6c 6f 63 2a 28 69 36 34 29  e->szAlloc*(i64)
3290: 70 43 61 63 68 65 2d 3e 6e 4d 61 78 3b 0a 20 20  pCache->nMax;.  
32a0: 7d 0a 20 20 7a 42 75 6c 6b 20 3d 20 70 43 61 63  }.  zBulk = pCac
32b0: 68 65 2d 3e 70 42 75 6c 6b 20 3d 20 73 71 6c 69  he->pBulk = sqli
32c0: 74 65 33 4d 61 6c 6c 6f 63 28 20 73 7a 42 75 6c  te3Malloc( szBul
32d0: 6b 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 45 6e  k );.  sqlite3En
32e0: 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b  dBenignMalloc();
32f0: 0a 20 20 69 66 28 20 7a 42 75 6c 6b 20 29 7b 0a  .  if( zBulk ){.
3300: 20 20 20 20 69 6e 74 20 6e 42 75 6c 6b 20 3d 20      int nBulk = 
3310: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a  sqlite3MallocSiz
3320: 65 28 7a 42 75 6c 6b 29 2f 70 43 61 63 68 65 2d  e(zBulk)/pCache-
3330: 3e 73 7a 41 6c 6c 6f 63 3b 0a 20 20 20 20 64 6f  >szAlloc;.    do
3340: 7b 0a 20 20 20 20 20 20 50 67 48 64 72 31 20 2a  {.      PgHdr1 *
3350: 70 58 20 3d 20 28 50 67 48 64 72 31 2a 29 26 7a  pX = (PgHdr1*)&z
3360: 42 75 6c 6b 5b 70 43 61 63 68 65 2d 3e 73 7a 50  Bulk[pCache->szP
3370: 61 67 65 5d 3b 0a 20 20 20 20 20 20 70 58 2d 3e  age];.      pX->
3380: 70 61 67 65 2e 70 42 75 66 20 3d 20 7a 42 75 6c  page.pBuf = zBul
3390: 6b 3b 0a 20 20 20 20 20 20 70 58 2d 3e 70 61 67  k;.      pX->pag
33a0: 65 2e 70 45 78 74 72 61 20 3d 20 26 70 58 5b 31  e.pExtra = &pX[1
33b0: 5d 3b 0a 20 20 20 20 20 20 70 58 2d 3e 69 73 42  ];.      pX->isB
33c0: 75 6c 6b 4c 6f 63 61 6c 20 3d 20 31 3b 0a 20 20  ulkLocal = 1;.  
33d0: 20 20 20 20 70 58 2d 3e 69 73 41 6e 63 68 6f 72      pX->isAnchor
33e0: 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 58 2d 3e   = 0;.      pX->
33f0: 70 4e 65 78 74 20 3d 20 70 43 61 63 68 65 2d 3e  pNext = pCache->
3400: 70 46 72 65 65 3b 0a 20 20 20 20 20 20 70 43 61  pFree;.      pCa
3410: 63 68 65 2d 3e 70 46 72 65 65 20 3d 20 70 58 3b  che->pFree = pX;
3420: 0a 20 20 20 20 20 20 7a 42 75 6c 6b 20 2b 3d 20  .      zBulk += 
3430: 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63 3b  pCache->szAlloc;
3440: 0a 20 20 20 20 7d 77 68 69 6c 65 28 20 2d 2d 6e  .    }while( --n
3450: 42 75 6c 6b 20 29 3b 0a 20 20 7d 0a 20 20 72 65  Bulk );.  }.  re
3460: 74 75 72 6e 20 70 43 61 63 68 65 2d 3e 70 46 72  turn pCache->pFr
3470: 65 65 21 3d 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  ee!=0;.}../*.** 
3480: 4d 61 6c 6c 6f 63 20 66 75 6e 63 74 69 6f 6e 20  Malloc function 
3490: 75 73 65 64 20 77 69 74 68 69 6e 20 74 68 69 73  used within this
34a0: 20 66 69 6c 65 20 74 6f 20 61 6c 6c 6f 63 61 74   file to allocat
34b0: 65 20 73 70 61 63 65 20 66 72 6f 6d 20 74 68 65  e space from the
34c0: 20 62 75 66 66 65 72 0a 2a 2a 20 63 6f 6e 66 69   buffer.** confi
34d0: 67 75 72 65 64 20 75 73 69 6e 67 20 73 71 6c 69  gured using sqli
34e0: 74 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54  te3_config(SQLIT
34f0: 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43  E_CONFIG_PAGECAC
3500: 48 45 29 20 6f 70 74 69 6f 6e 2e 20 49 66 20 6e  HE) option. If n
3510: 6f 20 0a 2a 2a 20 73 75 63 68 20 62 75 66 66 65  o .** such buffe
3520: 72 20 65 78 69 73 74 73 20 6f 72 20 74 68 65 72  r exists or ther
3530: 65 20 69 73 20 6e 6f 20 73 70 61 63 65 20 6c 65  e is no space le
3540: 66 74 20 69 6e 20 69 74 2c 20 74 68 69 73 20 66  ft in it, this f
3550: 75 6e 63 74 69 6f 6e 20 66 61 6c 6c 73 20 0a 2a  unction falls .*
3560: 2a 20 62 61 63 6b 20 74 6f 20 73 71 6c 69 74 65  * back to sqlite
3570: 33 4d 61 6c 6c 6f 63 28 29 2e 0a 2a 2a 0a 2a 2a  3Malloc()..**.**
3580: 20 4d 75 6c 74 69 70 6c 65 20 74 68 72 65 61 64   Multiple thread
3590: 73 20 63 61 6e 20 72 75 6e 20 74 68 69 73 20 72  s can run this r
35a0: 6f 75 74 69 6e 65 20 61 74 20 74 68 65 20 73 61  outine at the sa
35b0: 6d 65 20 74 69 6d 65 2e 20 20 47 6c 6f 62 61 6c  me time.  Global
35c0: 20 76 61 72 69 61 62 6c 65 73 0a 2a 2a 20 69 6e   variables.** in
35d0: 20 70 63 61 63 68 65 31 20 6e 65 65 64 20 74 6f   pcache1 need to
35e0: 20 62 65 20 70 72 6f 74 65 63 74 65 64 20 76 69   be protected vi
35f0: 61 20 6d 75 74 65 78 2e 0a 2a 2f 0a 73 74 61 74  a mutex..*/.stat
3600: 69 63 20 76 6f 69 64 20 2a 70 63 61 63 68 65 31  ic void *pcache1
3610: 41 6c 6c 6f 63 28 69 6e 74 20 6e 42 79 74 65 29  Alloc(int nByte)
3620: 7b 0a 20 20 76 6f 69 64 20 2a 70 20 3d 20 30 3b  {.  void *p = 0;
3630: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74  .  assert( sqlit
3640: 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c 64  e3_mutex_notheld
3650: 28 70 63 61 63 68 65 31 2e 67 72 70 2e 6d 75 74  (pcache1.grp.mut
3660: 65 78 29 20 29 3b 0a 20 20 69 66 28 20 6e 42 79  ex) );.  if( nBy
3670: 74 65 3c 3d 70 63 61 63 68 65 31 2e 73 7a 53 6c  te<=pcache1.szSl
3680: 6f 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  ot ){.    sqlite
3690: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 63  3_mutex_enter(pc
36a0: 61 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20  ache1.mutex);.  
36b0: 20 20 70 20 3d 20 28 50 67 48 64 72 31 20 2a 29    p = (PgHdr1 *)
36c0: 70 63 61 63 68 65 31 2e 70 46 72 65 65 3b 0a 20  pcache1.pFree;. 
36d0: 20 20 20 69 66 28 20 70 20 29 7b 0a 20 20 20 20     if( p ){.    
36e0: 20 20 70 63 61 63 68 65 31 2e 70 46 72 65 65 20    pcache1.pFree 
36f0: 3d 20 70 63 61 63 68 65 31 2e 70 46 72 65 65 2d  = pcache1.pFree-
3700: 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 70 63  >pNext;.      pc
3710: 61 63 68 65 31 2e 6e 46 72 65 65 53 6c 6f 74 2d  ache1.nFreeSlot-
3720: 2d 3b 0a 20 20 20 20 20 20 70 63 61 63 68 65 31  -;.      pcache1
3730: 2e 62 55 6e 64 65 72 50 72 65 73 73 75 72 65 20  .bUnderPressure 
3740: 3d 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65 53  = pcache1.nFreeS
3750: 6c 6f 74 3c 70 63 61 63 68 65 31 2e 6e 52 65 73  lot<pcache1.nRes
3760: 65 72 76 65 3b 0a 20 20 20 20 20 20 61 73 73 65  erve;.      asse
3770: 72 74 28 20 70 63 61 63 68 65 31 2e 6e 46 72 65  rt( pcache1.nFre
3780: 65 53 6c 6f 74 3e 3d 30 20 29 3b 0a 20 20 20 20  eSlot>=0 );.    
3790: 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 48    sqlite3StatusH
37a0: 69 67 68 77 61 74 65 72 28 53 51 4c 49 54 45 5f  ighwater(SQLITE_
37b0: 53 54 41 54 55 53 5f 50 41 47 45 43 41 43 48 45  STATUS_PAGECACHE
37c0: 5f 53 49 5a 45 2c 20 6e 42 79 74 65 29 3b 0a 20  _SIZE, nByte);. 
37d0: 20 20 20 20 20 73 71 6c 69 74 65 33 53 74 61 74       sqlite3Stat
37e0: 75 73 55 70 28 53 51 4c 49 54 45 5f 53 54 41 54  usUp(SQLITE_STAT
37f0: 55 53 5f 50 41 47 45 43 41 43 48 45 5f 55 53 45  US_PAGECACHE_USE
3800: 44 2c 20 31 29 3b 0a 20 20 20 20 7d 0a 20 20 20  D, 1);.    }.   
3810: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c   sqlite3_mutex_l
3820: 65 61 76 65 28 70 63 61 63 68 65 31 2e 6d 75 74  eave(pcache1.mut
3830: 65 78 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70  ex);.  }.  if( p
3840: 3d 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 20 4d 65  ==0 ){.    /* Me
3850: 6d 6f 72 79 20 69 73 20 6e 6f 74 20 61 76 61 69  mory is not avai
3860: 6c 61 62 6c 65 20 69 6e 20 74 68 65 20 53 51 4c  lable in the SQL
3870: 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43  ITE_CONFIG_PAGEC
3880: 41 43 48 45 20 70 6f 6f 6c 2e 20 20 47 65 74 0a  ACHE pool.  Get.
3890: 20 20 20 20 2a 2a 20 69 74 20 66 72 6f 6d 20 73      ** it from s
38a0: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 20 69 6e 73  qlite3Malloc ins
38b0: 74 65 61 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20  tead..    */.   
38c0: 20 70 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c   p = sqlite3Mall
38d0: 6f 63 28 6e 42 79 74 65 29 3b 0a 23 69 66 6e 64  oc(nByte);.#ifnd
38e0: 65 66 20 53 51 4c 49 54 45 5f 44 49 53 41 42 4c  ef SQLITE_DISABL
38f0: 45 5f 50 41 47 45 43 41 43 48 45 5f 4f 56 45 52  E_PAGECACHE_OVER
3900: 46 4c 4f 57 5f 53 54 41 54 53 0a 20 20 20 20 69  FLOW_STATS.    i
3910: 66 28 20 70 20 29 7b 0a 20 20 20 20 20 20 69 6e  f( p ){.      in
3920: 74 20 73 7a 20 3d 20 73 71 6c 69 74 65 33 4d 61  t sz = sqlite3Ma
3930: 6c 6c 6f 63 53 69 7a 65 28 70 29 3b 0a 20 20 20  llocSize(p);.   
3940: 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78     sqlite3_mutex
3950: 5f 65 6e 74 65 72 28 70 63 61 63 68 65 31 2e 6d  _enter(pcache1.m
3960: 75 74 65 78 29 3b 0a 20 20 20 20 20 20 73 71 6c  utex);.      sql
3970: 69 74 65 33 53 74 61 74 75 73 48 69 67 68 77 61  ite3StatusHighwa
3980: 74 65 72 28 53 51 4c 49 54 45 5f 53 54 41 54 55  ter(SQLITE_STATU
3990: 53 5f 50 41 47 45 43 41 43 48 45 5f 53 49 5a 45  S_PAGECACHE_SIZE
39a0: 2c 20 6e 42 79 74 65 29 3b 0a 20 20 20 20 20 20  , nByte);.      
39b0: 73 71 6c 69 74 65 33 53 74 61 74 75 73 55 70 28  sqlite3StatusUp(
39c0: 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 50 41  SQLITE_STATUS_PA
39d0: 47 45 43 41 43 48 45 5f 4f 56 45 52 46 4c 4f 57  GECACHE_OVERFLOW
39e0: 2c 20 73 7a 29 3b 0a 20 20 20 20 20 20 73 71 6c  , sz);.      sql
39f0: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65  ite3_mutex_leave
3a00: 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29 3b  (pcache1.mutex);
3a10: 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20  .    }.#endif.  
3a20: 20 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75    sqlite3Memdebu
3a30: 67 53 65 74 54 79 70 65 28 70 2c 20 4d 45 4d 54  gSetType(p, MEMT
3a40: 59 50 45 5f 50 43 41 43 48 45 29 3b 0a 20 20 7d  YPE_PCACHE);.  }
3a50: 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a  .  return p;.}..
3a60: 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 6e 20 61 6c  /*.** Free an al
3a70: 6c 6f 63 61 74 65 64 20 62 75 66 66 65 72 20 6f  located buffer o
3a80: 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 70 63 61  btained from pca
3a90: 63 68 65 31 41 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a  che1Alloc()..*/.
3aa0: 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63  static void pcac
3ab0: 68 65 31 46 72 65 65 28 76 6f 69 64 20 2a 70 29  he1Free(void *p)
3ac0: 7b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20 72  {.  if( p==0 ) r
3ad0: 65 74 75 72 6e 3b 0a 20 20 69 66 28 20 53 51 4c  eturn;.  if( SQL
3ae0: 49 54 45 5f 57 49 54 48 49 4e 28 70 2c 20 70 63  ITE_WITHIN(p, pc
3af0: 61 63 68 65 31 2e 70 53 74 61 72 74 2c 20 70 63  ache1.pStart, pc
3b00: 61 63 68 65 31 2e 70 45 6e 64 29 20 29 7b 0a 20  ache1.pEnd) ){. 
3b10: 20 20 20 50 67 46 72 65 65 73 6c 6f 74 20 2a 70     PgFreeslot *p
3b20: 53 6c 6f 74 3b 0a 20 20 20 20 73 71 6c 69 74 65  Slot;.    sqlite
3b30: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 63  3_mutex_enter(pc
3b40: 61 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20  ache1.mutex);.  
3b50: 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 44    sqlite3StatusD
3b60: 6f 77 6e 28 53 51 4c 49 54 45 5f 53 54 41 54 55  own(SQLITE_STATU
3b70: 53 5f 50 41 47 45 43 41 43 48 45 5f 55 53 45 44  S_PAGECACHE_USED
3b80: 2c 20 31 29 3b 0a 20 20 20 20 70 53 6c 6f 74 20  , 1);.    pSlot 
3b90: 3d 20 28 50 67 46 72 65 65 73 6c 6f 74 2a 29 70  = (PgFreeslot*)p
3ba0: 3b 0a 20 20 20 20 70 53 6c 6f 74 2d 3e 70 4e 65  ;.    pSlot->pNe
3bb0: 78 74 20 3d 20 70 63 61 63 68 65 31 2e 70 46 72  xt = pcache1.pFr
3bc0: 65 65 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e  ee;.    pcache1.
3bd0: 70 46 72 65 65 20 3d 20 70 53 6c 6f 74 3b 0a 20  pFree = pSlot;. 
3be0: 20 20 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65     pcache1.nFree
3bf0: 53 6c 6f 74 2b 2b 3b 0a 20 20 20 20 70 63 61 63  Slot++;.    pcac
3c00: 68 65 31 2e 62 55 6e 64 65 72 50 72 65 73 73 75  he1.bUnderPressu
3c10: 72 65 20 3d 20 70 63 61 63 68 65 31 2e 6e 46 72  re = pcache1.nFr
3c20: 65 65 53 6c 6f 74 3c 70 63 61 63 68 65 31 2e 6e  eeSlot<pcache1.n
3c30: 52 65 73 65 72 76 65 3b 0a 20 20 20 20 61 73 73  Reserve;.    ass
3c40: 65 72 74 28 20 70 63 61 63 68 65 31 2e 6e 46 72  ert( pcache1.nFr
3c50: 65 65 53 6c 6f 74 3c 3d 70 63 61 63 68 65 31 2e  eeSlot<=pcache1.
3c60: 6e 53 6c 6f 74 20 29 3b 0a 20 20 20 20 73 71 6c  nSlot );.    sql
3c70: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65  ite3_mutex_leave
3c80: 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29 3b  (pcache1.mutex);
3c90: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73  .  }else{.    as
3ca0: 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d 65 6d  sert( sqlite3Mem
3cb0: 64 65 62 75 67 48 61 73 54 79 70 65 28 70 2c 20  debugHasType(p, 
3cc0: 4d 45 4d 54 59 50 45 5f 50 43 41 43 48 45 29 20  MEMTYPE_PCACHE) 
3cd0: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 4d 65  );.    sqlite3Me
3ce0: 6d 64 65 62 75 67 53 65 74 54 79 70 65 28 70 2c  mdebugSetType(p,
3cf0: 20 4d 45 4d 54 59 50 45 5f 48 45 41 50 29 3b 0a   MEMTYPE_HEAP);.
3d00: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 44  #ifndef SQLITE_D
3d10: 49 53 41 42 4c 45 5f 50 41 47 45 43 41 43 48 45  ISABLE_PAGECACHE
3d20: 5f 4f 56 45 52 46 4c 4f 57 5f 53 54 41 54 53 0a  _OVERFLOW_STATS.
3d30: 20 20 20 20 7b 0a 20 20 20 20 20 20 69 6e 74 20      {.      int 
3d40: 6e 46 72 65 65 64 20 3d 20 30 3b 0a 20 20 20 20  nFreed = 0;.    
3d50: 20 20 6e 46 72 65 65 64 20 3d 20 73 71 6c 69 74    nFreed = sqlit
3d60: 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 29 3b  e3MallocSize(p);
3d70: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d  .      sqlite3_m
3d80: 75 74 65 78 5f 65 6e 74 65 72 28 70 63 61 63 68  utex_enter(pcach
3d90: 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 20  e1.mutex);.     
3da0: 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 44 6f   sqlite3StatusDo
3db0: 77 6e 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53  wn(SQLITE_STATUS
3dc0: 5f 50 41 47 45 43 41 43 48 45 5f 4f 56 45 52 46  _PAGECACHE_OVERF
3dd0: 4c 4f 57 2c 20 6e 46 72 65 65 64 29 3b 0a 20 20  LOW, nFreed);.  
3de0: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65      sqlite3_mute
3df0: 78 5f 6c 65 61 76 65 28 70 63 61 63 68 65 31 2e  x_leave(pcache1.
3e00: 6d 75 74 65 78 29 3b 0a 20 20 20 20 7d 0a 23 65  mutex);.    }.#e
3e10: 6e 64 69 66 0a 20 20 20 20 73 71 6c 69 74 65 33  ndif.    sqlite3
3e20: 5f 66 72 65 65 28 70 29 3b 0a 20 20 7d 0a 7d 0a  _free(p);.  }.}.
3e30: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45  .#ifdef SQLITE_E
3e40: 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e  NABLE_MEMORY_MAN
3e50: 41 47 45 4d 45 4e 54 0a 2f 2a 0a 2a 2a 20 52 65  AGEMENT./*.** Re
3e60: 74 75 72 6e 20 74 68 65 20 73 69 7a 65 20 6f 66  turn the size of
3e70: 20 61 20 70 63 61 63 68 65 20 61 6c 6c 6f 63 61   a pcache alloca
3e80: 74 69 6f 6e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  tion.*/.static i
3e90: 6e 74 20 70 63 61 63 68 65 31 4d 65 6d 53 69 7a  nt pcache1MemSiz
3ea0: 65 28 76 6f 69 64 20 2a 70 29 7b 0a 20 20 69 66  e(void *p){.  if
3eb0: 28 20 70 3e 3d 70 63 61 63 68 65 31 2e 70 53 74  ( p>=pcache1.pSt
3ec0: 61 72 74 20 26 26 20 70 3c 70 63 61 63 68 65 31  art && p<pcache1
3ed0: 2e 70 45 6e 64 20 29 7b 0a 20 20 20 20 72 65 74  .pEnd ){.    ret
3ee0: 75 72 6e 20 70 63 61 63 68 65 31 2e 73 7a 53 6c  urn pcache1.szSl
3ef0: 6f 74 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ot;.  }else{.   
3f00: 20 69 6e 74 20 69 53 69 7a 65 3b 0a 20 20 20 20   int iSize;.    
3f10: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d  assert( sqlite3M
3f20: 65 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 70  emdebugHasType(p
3f30: 2c 20 4d 45 4d 54 59 50 45 5f 50 43 41 43 48 45  , MEMTYPE_PCACHE
3f40: 29 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  ) );.    sqlite3
3f50: 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 28  MemdebugSetType(
3f60: 70 2c 20 4d 45 4d 54 59 50 45 5f 48 45 41 50 29  p, MEMTYPE_HEAP)
3f70: 3b 0a 20 20 20 20 69 53 69 7a 65 20 3d 20 73 71  ;.    iSize = sq
3f80: 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28  lite3MallocSize(
3f90: 70 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 4d  p);.    sqlite3M
3fa0: 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 28 70  emdebugSetType(p
3fb0: 2c 20 4d 45 4d 54 59 50 45 5f 50 43 41 43 48 45  , MEMTYPE_PCACHE
3fc0: 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 69 53  );.    return iS
3fd0: 69 7a 65 3b 0a 20 20 7d 0a 7d 0a 23 65 6e 64 69  ize;.  }.}.#endi
3fe0: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42  f /* SQLITE_ENAB
3ff0: 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45  LE_MEMORY_MANAGE
4000: 4d 45 4e 54 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41  MENT */../*.** A
4010: 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 70 61  llocate a new pa
4020: 67 65 20 6f 62 6a 65 63 74 20 69 6e 69 74 69 61  ge object initia
4030: 6c 6c 79 20 61 73 73 6f 63 69 61 74 65 64 20 77  lly associated w
4040: 69 74 68 20 63 61 63 68 65 20 70 43 61 63 68 65  ith cache pCache
4050: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67 48 64  ..*/.static PgHd
4060: 72 31 20 2a 70 63 61 63 68 65 31 41 6c 6c 6f 63  r1 *pcache1Alloc
4070: 50 61 67 65 28 50 43 61 63 68 65 31 20 2a 70 43  Page(PCache1 *pC
4080: 61 63 68 65 2c 20 69 6e 74 20 62 65 6e 69 67 6e  ache, int benign
4090: 4d 61 6c 6c 6f 63 29 7b 0a 20 20 50 67 48 64 72  Malloc){.  PgHdr
40a0: 31 20 2a 70 20 3d 20 30 3b 0a 20 20 76 6f 69 64  1 *p = 0;.  void
40b0: 20 2a 70 50 67 3b 0a 0a 20 20 61 73 73 65 72 74   *pPg;..  assert
40c0: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
40d0: 68 65 6c 64 28 70 43 61 63 68 65 2d 3e 70 47 72  held(pCache->pGr
40e0: 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20  oup->mutex) );. 
40f0: 20 69 66 28 20 70 43 61 63 68 65 2d 3e 70 46 72   if( pCache->pFr
4100: 65 65 20 7c 7c 20 28 70 43 61 63 68 65 2d 3e 6e  ee || (pCache->n
4110: 50 61 67 65 3d 3d 30 20 26 26 20 70 63 61 63 68  Page==0 && pcach
4120: 65 31 49 6e 69 74 42 75 6c 6b 28 70 43 61 63 68  e1InitBulk(pCach
4130: 65 29 29 20 29 7b 0a 20 20 20 20 70 20 3d 20 70  e)) ){.    p = p
4140: 43 61 63 68 65 2d 3e 70 46 72 65 65 3b 0a 20 20  Cache->pFree;.  
4150: 20 20 70 43 61 63 68 65 2d 3e 70 46 72 65 65 20    pCache->pFree 
4160: 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20  = p->pNext;.    
4170: 70 2d 3e 70 4e 65 78 74 20 3d 20 30 3b 0a 20 20  p->pNext = 0;.  
4180: 7d 65 6c 73 65 7b 0a 23 69 66 64 65 66 20 53 51  }else{.#ifdef SQ
4190: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f  LITE_ENABLE_MEMO
41a0: 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 20 20  RY_MANAGEMENT.  
41b0: 20 20 2f 2a 20 54 68 65 20 67 72 6f 75 70 20 6d    /* The group m
41c0: 75 74 65 78 20 6d 75 73 74 20 62 65 20 72 65 6c  utex must be rel
41d0: 65 61 73 65 64 20 62 65 66 6f 72 65 20 70 63 61  eased before pca
41e0: 63 68 65 31 41 6c 6c 6f 63 28 29 20 69 73 20 63  che1Alloc() is c
41f0: 61 6c 6c 65 64 2e 20 54 68 69 73 0a 20 20 20 20  alled. This.    
4200: 2a 2a 20 69 73 20 62 65 63 61 75 73 65 20 69 74  ** is because it
4210: 20 6d 69 67 68 74 20 63 61 6c 6c 20 73 71 6c 69   might call sqli
4220: 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f  te3_release_memo
4230: 72 79 28 29 2c 20 77 68 69 63 68 20 61 73 73 75  ry(), which assu
4240: 6d 65 73 20 74 68 61 74 20 0a 20 20 20 20 2a 2a  mes that .    **
4250: 20 74 68 69 73 20 6d 75 74 65 78 20 69 73 20 6e   this mutex is n
4260: 6f 74 20 68 65 6c 64 2e 20 2a 2f 0a 20 20 20 20  ot held. */.    
4270: 61 73 73 65 72 74 28 20 70 63 61 63 68 65 31 2e  assert( pcache1.
4280: 73 65 70 61 72 61 74 65 43 61 63 68 65 3d 3d 30  separateCache==0
4290: 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20   );.    assert( 
42a0: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3d 3d  pCache->pGroup==
42b0: 26 70 63 61 63 68 65 31 2e 67 72 70 20 29 3b 0a  &pcache1.grp );.
42c0: 20 20 20 20 70 63 61 63 68 65 31 4c 65 61 76 65      pcache1Leave
42d0: 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47  Mutex(pCache->pG
42e0: 72 6f 75 70 29 3b 0a 23 65 6e 64 69 66 0a 20 20  roup);.#endif.  
42f0: 20 20 69 66 28 20 62 65 6e 69 67 6e 4d 61 6c 6c    if( benignMall
4300: 6f 63 20 29 7b 20 73 71 6c 69 74 65 33 42 65 67  oc ){ sqlite3Beg
4310: 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29  inBenignMalloc()
4320: 3b 20 7d 0a 23 69 66 64 65 66 20 53 51 4c 49 54  ; }.#ifdef SQLIT
4330: 45 5f 50 43 41 43 48 45 5f 53 45 50 41 52 41 54  E_PCACHE_SEPARAT
4340: 45 5f 48 45 41 44 45 52 0a 20 20 20 20 70 50 67  E_HEADER.    pPg
4350: 20 3d 20 70 63 61 63 68 65 31 41 6c 6c 6f 63 28   = pcache1Alloc(
4360: 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 29 3b  pCache->szPage);
4370: 0a 20 20 20 20 70 20 3d 20 73 71 6c 69 74 65 33  .    p = sqlite3
4380: 4d 61 6c 6c 6f 63 28 73 69 7a 65 6f 66 28 50 67  Malloc(sizeof(Pg
4390: 48 64 72 31 29 20 2b 20 70 43 61 63 68 65 2d 3e  Hdr1) + pCache->
43a0: 73 7a 45 78 74 72 61 29 3b 0a 20 20 20 20 69 66  szExtra);.    if
43b0: 28 20 21 70 50 67 20 7c 7c 20 21 70 20 29 7b 0a  ( !pPg || !p ){.
43c0: 20 20 20 20 20 20 70 63 61 63 68 65 31 46 72 65        pcache1Fre
43d0: 65 28 70 50 67 29 3b 0a 20 20 20 20 20 20 73 71  e(pPg);.      sq
43e0: 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 20  lite3_free(p);. 
43f0: 20 20 20 20 20 70 50 67 20 3d 20 30 3b 0a 20 20       pPg = 0;.  
4400: 20 20 7d 0a 23 65 6c 73 65 0a 20 20 20 20 70 50    }.#else.    pP
4410: 67 20 3d 20 70 63 61 63 68 65 31 41 6c 6c 6f 63  g = pcache1Alloc
4420: 28 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63  (pCache->szAlloc
4430: 29 3b 0a 20 20 20 20 70 20 3d 20 28 50 67 48 64  );.    p = (PgHd
4440: 72 31 20 2a 29 26 28 28 75 38 20 2a 29 70 50 67  r1 *)&((u8 *)pPg
4450: 29 5b 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65  )[pCache->szPage
4460: 5d 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 69 66  ];.#endif.    if
4470: 28 20 62 65 6e 69 67 6e 4d 61 6c 6c 6f 63 20 29  ( benignMalloc )
4480: 7b 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e 69  { sqlite3EndBeni
4490: 67 6e 4d 61 6c 6c 6f 63 28 29 3b 20 7d 0a 23 69  gnMalloc(); }.#i
44a0: 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42  fdef SQLITE_ENAB
44b0: 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45  LE_MEMORY_MANAGE
44c0: 4d 45 4e 54 0a 20 20 20 20 70 63 61 63 68 65 31  MENT.    pcache1
44d0: 45 6e 74 65 72 4d 75 74 65 78 28 70 43 61 63 68  EnterMutex(pCach
44e0: 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 23 65 6e 64  e->pGroup);.#end
44f0: 69 66 0a 20 20 20 20 69 66 28 20 70 50 67 3d 3d  if.    if( pPg==
4500: 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20  0 ) return 0;.  
4510: 20 20 70 2d 3e 70 61 67 65 2e 70 42 75 66 20 3d    p->page.pBuf =
4520: 20 70 50 67 3b 0a 20 20 20 20 70 2d 3e 70 61 67   pPg;.    p->pag
4530: 65 2e 70 45 78 74 72 61 20 3d 20 26 70 5b 31 5d  e.pExtra = &p[1]
4540: 3b 0a 20 20 20 20 70 2d 3e 69 73 42 75 6c 6b 4c  ;.    p->isBulkL
4550: 6f 63 61 6c 20 3d 20 30 3b 0a 20 20 20 20 70 2d  ocal = 0;.    p-
4560: 3e 69 73 41 6e 63 68 6f 72 20 3d 20 30 3b 0a 20  >isAnchor = 0;. 
4570: 20 7d 0a 20 20 28 2a 70 43 61 63 68 65 2d 3e 70   }.  (*pCache->p
4580: 6e 50 75 72 67 65 61 62 6c 65 29 2b 2b 3b 0a 20  nPurgeable)++;. 
4590: 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 2f 2a   return p;.}../*
45a0: 0a 2a 2a 20 46 72 65 65 20 61 20 70 61 67 65 20  .** Free a page 
45b0: 6f 62 6a 65 63 74 20 61 6c 6c 6f 63 61 74 65 64  object allocated
45c0: 20 62 79 20 70 63 61 63 68 65 31 41 6c 6c 6f 63   by pcache1Alloc
45d0: 50 61 67 65 28 29 2e 0a 2a 2f 0a 73 74 61 74 69  Page()..*/.stati
45e0: 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 46 72  c void pcache1Fr
45f0: 65 65 50 61 67 65 28 50 67 48 64 72 31 20 2a 70  eePage(PgHdr1 *p
4600: 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43  ){.  PCache1 *pC
4610: 61 63 68 65 3b 0a 20 20 61 73 73 65 72 74 28 20  ache;.  assert( 
4620: 70 21 3d 30 20 29 3b 0a 20 20 70 43 61 63 68 65  p!=0 );.  pCache
4630: 20 3d 20 70 2d 3e 70 43 61 63 68 65 3b 0a 20 20   = p->pCache;.  
4640: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f  assert( sqlite3_
4650: 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 70 43  mutex_held(p->pC
4660: 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75  ache->pGroup->mu
4670: 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 70 2d  tex) );.  if( p-
4680: 3e 69 73 42 75 6c 6b 4c 6f 63 61 6c 20 29 7b 0a  >isBulkLocal ){.
4690: 20 20 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20 70      p->pNext = p
46a0: 43 61 63 68 65 2d 3e 70 46 72 65 65 3b 0a 20 20  Cache->pFree;.  
46b0: 20 20 70 43 61 63 68 65 2d 3e 70 46 72 65 65 20    pCache->pFree 
46c0: 3d 20 70 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  = p;.  }else{.  
46d0: 20 20 70 63 61 63 68 65 31 46 72 65 65 28 70 2d    pcache1Free(p-
46e0: 3e 70 61 67 65 2e 70 42 75 66 29 3b 0a 23 69 66  >page.pBuf);.#if
46f0: 64 65 66 20 53 51 4c 49 54 45 5f 50 43 41 43 48  def SQLITE_PCACH
4700: 45 5f 53 45 50 41 52 41 54 45 5f 48 45 41 44 45  E_SEPARATE_HEADE
4710: 52 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72  R.    sqlite3_fr
4720: 65 65 28 70 29 3b 0a 23 65 6e 64 69 66 0a 20 20  ee(p);.#endif.  
4730: 7d 0a 20 20 28 2a 70 43 61 63 68 65 2d 3e 70 6e  }.  (*pCache->pn
4740: 50 75 72 67 65 61 62 6c 65 29 2d 2d 3b 0a 7d 0a  Purgeable)--;.}.
4750: 0a 2f 2a 0a 2a 2a 20 4d 61 6c 6c 6f 63 20 66 75  ./*.** Malloc fu
4760: 6e 63 74 69 6f 6e 20 75 73 65 64 20 62 79 20 53  nction used by S
4770: 51 4c 69 74 65 20 74 6f 20 6f 62 74 61 69 6e 20  QLite to obtain 
4780: 73 70 61 63 65 20 66 72 6f 6d 20 74 68 65 20 62  space from the b
4790: 75 66 66 65 72 20 63 6f 6e 66 69 67 75 72 65 64  uffer configured
47a0: 0a 2a 2a 20 75 73 69 6e 67 20 73 71 6c 69 74 65  .** using sqlite
47b0: 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f  3_config(SQLITE_
47c0: 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45  CONFIG_PAGECACHE
47d0: 29 20 6f 70 74 69 6f 6e 2e 20 49 66 20 6e 6f 20  ) option. If no 
47e0: 73 75 63 68 20 62 75 66 66 65 72 0a 2a 2a 20 65  such buffer.** e
47f0: 78 69 73 74 73 2c 20 74 68 69 73 20 66 75 6e 63  xists, this func
4800: 74 69 6f 6e 20 66 61 6c 6c 73 20 62 61 63 6b 20  tion falls back 
4810: 74 6f 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63  to sqlite3Malloc
4820: 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c  ()..*/.void *sql
4830: 69 74 65 33 50 61 67 65 4d 61 6c 6c 6f 63 28 69  ite3PageMalloc(i
4840: 6e 74 20 73 7a 29 7b 0a 20 20 72 65 74 75 72 6e  nt sz){.  return
4850: 20 70 63 61 63 68 65 31 41 6c 6c 6f 63 28 73 7a   pcache1Alloc(sz
4860: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65  );.}../*.** Free
4870: 20 61 6e 20 61 6c 6c 6f 63 61 74 65 64 20 62 75   an allocated bu
4880: 66 66 65 72 20 6f 62 74 61 69 6e 65 64 20 66 72  ffer obtained fr
4890: 6f 6d 20 73 71 6c 69 74 65 33 50 61 67 65 4d 61  om sqlite3PageMa
48a0: 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20  lloc()..*/.void 
48b0: 73 71 6c 69 74 65 33 50 61 67 65 46 72 65 65 28  sqlite3PageFree(
48c0: 76 6f 69 64 20 2a 70 29 7b 0a 20 20 70 63 61 63  void *p){.  pcac
48d0: 68 65 31 46 72 65 65 28 70 29 3b 0a 7d 0a 0a 0a  he1Free(p);.}...
48e0: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 72 75  /*.** Return tru
48f0: 65 20 69 66 20 69 74 20 64 65 73 69 72 61 62 6c  e if it desirabl
4900: 65 20 74 6f 20 61 76 6f 69 64 20 61 6c 6c 6f 63  e to avoid alloc
4910: 61 74 69 6e 67 20 61 20 6e 65 77 20 70 61 67 65  ating a new page
4920: 20 63 61 63 68 65 0a 2a 2a 20 65 6e 74 72 79 2e   cache.** entry.
4930: 0a 2a 2a 0a 2a 2a 20 49 66 20 6d 65 6d 6f 72 79  .**.** If memory
4940: 20 77 61 73 20 61 6c 6c 6f 63 61 74 65 64 20 73   was allocated s
4950: 70 65 63 69 66 69 63 61 6c 6c 79 20 74 6f 20 74  pecifically to t
4960: 68 65 20 70 61 67 65 20 63 61 63 68 65 20 75 73  he page cache us
4970: 69 6e 67 0a 2a 2a 20 53 51 4c 49 54 45 5f 43 4f  ing.** SQLITE_CO
4980: 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45 20 62  NFIG_PAGECACHE b
4990: 75 74 20 74 68 61 74 20 6d 65 6d 6f 72 79 20 68  ut that memory h
49a0: 61 73 20 61 6c 6c 20 62 65 65 6e 20 75 73 65 64  as all been used
49b0: 2c 20 74 68 65 6e 0a 2a 2a 20 69 74 20 69 73 20  , then.** it is 
49c0: 64 65 73 69 72 61 62 6c 65 20 74 6f 20 61 76 6f  desirable to avo
49d0: 69 64 20 61 6c 6c 6f 63 61 74 69 6e 67 20 61 20  id allocating a 
49e0: 6e 65 77 20 70 61 67 65 20 63 61 63 68 65 20 65  new page cache e
49f0: 6e 74 72 79 20 62 65 63 61 75 73 65 0a 2a 2a 20  ntry because.** 
4a00: 70 72 65 73 75 6d 61 62 6c 79 20 53 51 4c 49 54  presumably SQLIT
4a10: 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43  E_CONFIG_PAGECAC
4a20: 48 45 20 77 61 73 20 73 75 70 70 6f 73 65 20 74  HE was suppose t
4a30: 6f 20 62 65 20 73 75 66 66 69 63 69 65 6e 74 0a  o be sufficient.
4a40: 2a 2a 20 66 6f 72 20 61 6c 6c 20 70 61 67 65 20  ** for all page 
4a50: 63 61 63 68 65 20 6e 65 65 64 73 20 61 6e 64 20  cache needs and 
4a60: 77 65 20 73 68 6f 75 6c 64 20 6e 6f 74 20 6e 65  we should not ne
4a70: 65 64 20 74 6f 20 73 70 69 6c 6c 20 74 68 65 0a  ed to spill the.
4a80: 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 6f 6e  ** allocation on
4a90: 74 6f 20 74 68 65 20 68 65 61 70 2e 0a 2a 2a 0a  to the heap..**.
4aa0: 2a 2a 20 4f 72 2c 20 74 68 65 20 68 65 61 70 20  ** Or, the heap 
4ab0: 69 73 20 75 73 65 64 20 66 6f 72 20 61 6c 6c 20  is used for all 
4ac0: 70 61 67 65 20 63 61 63 68 65 20 6d 65 6d 6f 72  page cache memor
4ad0: 79 20 62 75 74 20 74 68 65 20 68 65 61 70 20 69  y but the heap i
4ae0: 73 0a 2a 2a 20 75 6e 64 65 72 20 6d 65 6d 6f 72  s.** under memor
4af0: 79 20 70 72 65 73 73 75 72 65 2c 20 74 68 65 6e  y pressure, then
4b00: 20 61 67 61 69 6e 20 69 74 20 69 73 20 64 65 73   again it is des
4b10: 69 72 61 62 6c 65 20 74 6f 20 61 76 6f 69 64 0a  irable to avoid.
4b20: 2a 2a 20 61 6c 6c 6f 63 61 74 69 6e 67 20 61 20  ** allocating a 
4b30: 6e 65 77 20 70 61 67 65 20 63 61 63 68 65 20 65  new page cache e
4b40: 6e 74 72 79 20 69 6e 20 6f 72 64 65 72 20 74 6f  ntry in order to
4b50: 20 61 76 6f 69 64 20 73 74 72 65 73 73 69 6e 67   avoid stressing
4b60: 0a 2a 2a 20 74 68 65 20 68 65 61 70 20 65 76 65  .** the heap eve
4b70: 6e 20 66 75 72 74 68 65 72 2e 0a 2a 2f 0a 73 74  n further..*/.st
4b80: 61 74 69 63 20 69 6e 74 20 70 63 61 63 68 65 31  atic int pcache1
4b90: 55 6e 64 65 72 4d 65 6d 6f 72 79 50 72 65 73 73  UnderMemoryPress
4ba0: 75 72 65 28 50 43 61 63 68 65 31 20 2a 70 43 61  ure(PCache1 *pCa
4bb0: 63 68 65 29 7b 0a 20 20 69 66 28 20 70 63 61 63  che){.  if( pcac
4bc0: 68 65 31 2e 6e 53 6c 6f 74 20 26 26 20 28 70 43  he1.nSlot && (pC
4bd0: 61 63 68 65 2d 3e 73 7a 50 61 67 65 2b 70 43 61  ache->szPage+pCa
4be0: 63 68 65 2d 3e 73 7a 45 78 74 72 61 29 3c 3d 70  che->szExtra)<=p
4bf0: 63 61 63 68 65 31 2e 73 7a 53 6c 6f 74 20 29 7b  cache1.szSlot ){
4c00: 0a 20 20 20 20 72 65 74 75 72 6e 20 70 63 61 63  .    return pcac
4c10: 68 65 31 2e 62 55 6e 64 65 72 50 72 65 73 73 75  he1.bUnderPressu
4c20: 72 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  re;.  }else{.   
4c30: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 48   return sqlite3H
4c40: 65 61 70 4e 65 61 72 6c 79 46 75 6c 6c 28 29 3b  eapNearlyFull();
4c50: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a  .  }.}../*******
4c60: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4c70: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4c80: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4c90: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4ca0: 2a 2a 2a 2a 2a 2a 2a 2f 0a 2f 2a 2a 2a 2a 2a 2a  *******/./******
4cb0: 2a 2a 20 47 65 6e 65 72 61 6c 20 49 6d 70 6c 65  ** General Imple
4cc0: 6d 65 6e 74 61 74 69 6f 6e 20 46 75 6e 63 74 69  mentation Functi
4cd0: 6f 6e 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ons ************
4ce0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4cf0: 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 0a 2a 2a  ********/../*.**
4d00: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69   This function i
4d10: 73 20 75 73 65 64 20 74 6f 20 72 65 73 69 7a 65  s used to resize
4d20: 20 74 68 65 20 68 61 73 68 20 74 61 62 6c 65 20   the hash table 
4d30: 75 73 65 64 20 62 79 20 74 68 65 20 63 61 63 68  used by the cach
4d40: 65 20 70 61 73 73 65 64 0a 2a 2a 20 61 73 20 74  e passed.** as t
4d50: 68 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e  he first argumen
4d60: 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50 43 61  t..**.** The PCa
4d70: 63 68 65 20 6d 75 74 65 78 20 6d 75 73 74 20 62  che mutex must b
4d80: 65 20 68 65 6c 64 20 77 68 65 6e 20 74 68 69 73  e held when this
4d90: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c   function is cal
4da0: 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  led..*/.static v
4db0: 6f 69 64 20 70 63 61 63 68 65 31 52 65 73 69 7a  oid pcache1Resiz
4dc0: 65 48 61 73 68 28 50 43 61 63 68 65 31 20 2a 70  eHash(PCache1 *p
4dd0: 29 7b 0a 20 20 50 67 48 64 72 31 20 2a 2a 61 70  ){.  PgHdr1 **ap
4de0: 4e 65 77 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20  New;.  unsigned 
4df0: 69 6e 74 20 6e 4e 65 77 3b 0a 20 20 75 6e 73 69  int nNew;.  unsi
4e00: 67 6e 65 64 20 69 6e 74 20 69 3b 0a 0a 20 20 61  gned int i;..  a
4e10: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d  ssert( sqlite3_m
4e20: 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 70 47 72  utex_held(p->pGr
4e30: 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 0a  oup->mutex) );..
4e40: 20 20 6e 4e 65 77 20 3d 20 70 2d 3e 6e 48 61 73    nNew = p->nHas
4e50: 68 2a 32 3b 0a 20 20 69 66 28 20 6e 4e 65 77 3c  h*2;.  if( nNew<
4e60: 32 35 36 20 29 7b 0a 20 20 20 20 6e 4e 65 77 20  256 ){.    nNew 
4e70: 3d 20 32 35 36 3b 0a 20 20 7d 0a 0a 20 20 70 63  = 256;.  }..  pc
4e80: 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28  ache1LeaveMutex(
4e90: 70 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20 69 66  p->pGroup);.  if
4ea0: 28 20 70 2d 3e 6e 48 61 73 68 20 29 7b 20 73 71  ( p->nHash ){ sq
4eb0: 6c 69 74 65 33 42 65 67 69 6e 42 65 6e 69 67 6e  lite3BeginBenign
4ec0: 4d 61 6c 6c 6f 63 28 29 3b 20 7d 0a 20 20 61 70  Malloc(); }.  ap
4ed0: 4e 65 77 20 3d 20 28 50 67 48 64 72 31 20 2a 2a  New = (PgHdr1 **
4ee0: 29 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a 65  )sqlite3MallocZe
4ef0: 72 6f 28 73 69 7a 65 6f 66 28 50 67 48 64 72 31  ro(sizeof(PgHdr1
4f00: 20 2a 29 2a 6e 4e 65 77 29 3b 0a 20 20 69 66 28   *)*nNew);.  if(
4f10: 20 70 2d 3e 6e 48 61 73 68 20 29 7b 20 73 71 6c   p->nHash ){ sql
4f20: 69 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d 61 6c  ite3EndBenignMal
4f30: 6c 6f 63 28 29 3b 20 7d 0a 20 20 70 63 61 63 68  loc(); }.  pcach
4f40: 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70 2d 3e  e1EnterMutex(p->
4f50: 70 47 72 6f 75 70 29 3b 0a 20 20 69 66 28 20 61  pGroup);.  if( a
4f60: 70 4e 65 77 20 29 7b 0a 20 20 20 20 66 6f 72 28  pNew ){.    for(
4f70: 69 3d 30 3b 20 69 3c 70 2d 3e 6e 48 61 73 68 3b  i=0; i<p->nHash;
4f80: 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 50 67 48   i++){.      PgH
4f90: 64 72 31 20 2a 70 50 61 67 65 3b 0a 20 20 20 20  dr1 *pPage;.    
4fa0: 20 20 50 67 48 64 72 31 20 2a 70 4e 65 78 74 20    PgHdr1 *pNext 
4fb0: 3d 20 70 2d 3e 61 70 48 61 73 68 5b 69 5d 3b 0a  = p->apHash[i];.
4fc0: 20 20 20 20 20 20 77 68 69 6c 65 28 20 28 70 50        while( (pP
4fd0: 61 67 65 20 3d 20 70 4e 65 78 74 29 21 3d 30 20  age = pNext)!=0 
4fe0: 29 7b 0a 20 20 20 20 20 20 20 20 75 6e 73 69 67  ){.        unsig
4ff0: 6e 65 64 20 69 6e 74 20 68 20 3d 20 70 50 61 67  ned int h = pPag
5000: 65 2d 3e 69 4b 65 79 20 25 20 6e 4e 65 77 3b 0a  e->iKey % nNew;.
5010: 20 20 20 20 20 20 20 20 70 4e 65 78 74 20 3d 20          pNext = 
5020: 70 50 61 67 65 2d 3e 70 4e 65 78 74 3b 0a 20 20  pPage->pNext;.  
5030: 20 20 20 20 20 20 70 50 61 67 65 2d 3e 70 4e 65        pPage->pNe
5040: 78 74 20 3d 20 61 70 4e 65 77 5b 68 5d 3b 0a 20  xt = apNew[h];. 
5050: 20 20 20 20 20 20 20 61 70 4e 65 77 5b 68 5d 20         apNew[h] 
5060: 3d 20 70 50 61 67 65 3b 0a 20 20 20 20 20 20 7d  = pPage;.      }
5070: 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74  .    }.    sqlit
5080: 65 33 5f 66 72 65 65 28 70 2d 3e 61 70 48 61 73  e3_free(p->apHas
5090: 68 29 3b 0a 20 20 20 20 70 2d 3e 61 70 48 61 73  h);.    p->apHas
50a0: 68 20 3d 20 61 70 4e 65 77 3b 0a 20 20 20 20 70  h = apNew;.    p
50b0: 2d 3e 6e 48 61 73 68 20 3d 20 6e 4e 65 77 3b 0a  ->nHash = nNew;.
50c0: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69    }.}../*.** Thi
50d0: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73  s function is us
50e0: 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79 20 74 6f  ed internally to
50f0: 20 72 65 6d 6f 76 65 20 74 68 65 20 70 61 67 65   remove the page
5100: 20 70 50 61 67 65 20 66 72 6f 6d 20 74 68 65 20   pPage from the 
5110: 0a 2a 2a 20 50 47 72 6f 75 70 20 4c 52 55 20 6c  .** PGroup LRU l
5120: 69 73 74 2c 20 69 66 20 69 73 20 70 61 72 74 20  ist, if is part 
5130: 6f 66 20 69 74 2e 20 49 66 20 70 50 61 67 65 20  of it. If pPage 
5140: 69 73 20 6e 6f 74 20 70 61 72 74 20 6f 66 20 74  is not part of t
5150: 68 65 20 50 47 72 6f 75 70 0a 2a 2a 20 4c 52 55  he PGroup.** LRU
5160: 20 6c 69 73 74 2c 20 74 68 65 6e 20 74 68 69 73   list, then this
5170: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 6e   function is a n
5180: 6f 2d 6f 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20  o-op..**.** The 
5190: 50 47 72 6f 75 70 20 6d 75 74 65 78 20 6d 75 73  PGroup mutex mus
51a0: 74 20 62 65 20 68 65 6c 64 20 77 68 65 6e 20 74  t be held when t
51b0: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  his function is 
51c0: 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69  called..*/.stati
51d0: 63 20 50 67 48 64 72 31 20 2a 70 63 61 63 68 65  c PgHdr1 *pcache
51e0: 31 50 69 6e 50 61 67 65 28 50 67 48 64 72 31 20  1PinPage(PgHdr1 
51f0: 2a 70 50 61 67 65 29 7b 0a 20 20 61 73 73 65 72  *pPage){.  asser
5200: 74 28 20 70 50 61 67 65 21 3d 30 20 29 3b 0a 20  t( pPage!=0 );. 
5210: 20 61 73 73 65 72 74 28 20 50 41 47 45 5f 49 53   assert( PAGE_IS
5220: 5f 55 4e 50 49 4e 4e 45 44 28 70 50 61 67 65 29  _UNPINNED(pPage)
5230: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50   );.  assert( pP
5240: 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74 20 29 3b  age->pLruNext );
5250: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65  .  assert( pPage
5260: 2d 3e 70 4c 72 75 50 72 65 76 20 29 3b 0a 20 20  ->pLruPrev );.  
5270: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f  assert( sqlite3_
5280: 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65  mutex_held(pPage
5290: 2d 3e 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70  ->pCache->pGroup
52a0: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 70 50  ->mutex) );.  pP
52b0: 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 2d 3e 70  age->pLruPrev->p
52c0: 4c 72 75 4e 65 78 74 20 3d 20 70 50 61 67 65 2d  LruNext = pPage-
52d0: 3e 70 4c 72 75 4e 65 78 74 3b 0a 20 20 70 50 61  >pLruNext;.  pPa
52e0: 67 65 2d 3e 70 4c 72 75 4e 65 78 74 2d 3e 70 4c  ge->pLruNext->pL
52f0: 72 75 50 72 65 76 20 3d 20 70 50 61 67 65 2d 3e  ruPrev = pPage->
5300: 70 4c 72 75 50 72 65 76 3b 0a 20 20 70 50 61 67  pLruPrev;.  pPag
5310: 65 2d 3e 70 4c 72 75 4e 65 78 74 20 3d 20 30 3b  e->pLruNext = 0;
5320: 0a 20 20 2f 2a 20 70 50 61 67 65 2d 3e 70 4c 72  .  /* pPage->pLr
5330: 75 50 72 65 76 20 3d 20 30 3b 0a 20 20 2a 2a 20  uPrev = 0;.  ** 
5340: 4e 6f 20 6e 65 65 64 20 74 6f 20 63 6c 65 61 72  No need to clear
5350: 20 70 4c 72 75 50 72 65 76 20 61 73 20 69 74 20   pLruPrev as it 
5360: 69 73 20 6e 65 76 65 72 20 61 63 63 65 73 73 65  is never accesse
5370: 64 20 69 66 20 70 4c 72 75 4e 65 78 74 20 69 73  d if pLruNext is
5380: 20 30 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20   0 */.  assert( 
5390: 70 50 61 67 65 2d 3e 69 73 41 6e 63 68 6f 72 3d  pPage->isAnchor=
53a0: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  =0 );.  assert( 
53b0: 70 50 61 67 65 2d 3e 70 43 61 63 68 65 2d 3e 70  pPage->pCache->p
53c0: 47 72 6f 75 70 2d 3e 6c 72 75 2e 69 73 41 6e 63  Group->lru.isAnc
53d0: 68 6f 72 3d 3d 31 20 29 3b 0a 20 20 70 50 61 67  hor==1 );.  pPag
53e0: 65 2d 3e 70 43 61 63 68 65 2d 3e 6e 52 65 63 79  e->pCache->nRecy
53f0: 63 6c 61 62 6c 65 2d 2d 3b 0a 20 20 72 65 74 75  clable--;.  retu
5400: 72 6e 20 70 50 61 67 65 3b 0a 7d 0a 0a 0a 2f 2a  rn pPage;.}.../*
5410: 0a 2a 2a 20 52 65 6d 6f 76 65 20 74 68 65 20 70  .** Remove the p
5420: 61 67 65 20 73 75 70 70 6c 69 65 64 20 61 73 20  age supplied as 
5430: 61 6e 20 61 72 67 75 6d 65 6e 74 20 66 72 6f 6d  an argument from
5440: 20 74 68 65 20 68 61 73 68 20 74 61 62 6c 65 20   the hash table 
5450: 0a 2a 2a 20 28 50 43 61 63 68 65 31 2e 61 70 48  .** (PCache1.apH
5460: 61 73 68 20 73 74 72 75 63 74 75 72 65 29 20 74  ash structure) t
5470: 68 61 74 20 69 74 20 69 73 20 63 75 72 72 65 6e  hat it is curren
5480: 74 6c 79 20 73 74 6f 72 65 64 20 69 6e 2e 0a 2a  tly stored in..*
5490: 2a 20 41 6c 73 6f 20 66 72 65 65 20 74 68 65 20  * Also free the 
54a0: 70 61 67 65 20 69 66 20 66 72 65 65 50 61 67 65  page if freePage
54b0: 20 69 73 20 74 72 75 65 2e 0a 2a 2a 0a 2a 2a 20   is true..**.** 
54c0: 54 68 65 20 50 47 72 6f 75 70 20 6d 75 74 65 78  The PGroup mutex
54d0: 20 6d 75 73 74 20 62 65 20 68 65 6c 64 20 77 68   must be held wh
54e0: 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e  en this function
54f0: 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73   is called..*/.s
5500: 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68  tatic void pcach
5510: 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73 68  e1RemoveFromHash
5520: 28 50 67 48 64 72 31 20 2a 70 50 61 67 65 2c 20  (PgHdr1 *pPage, 
5530: 69 6e 74 20 66 72 65 65 46 6c 61 67 29 7b 0a 20  int freeFlag){. 
5540: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 68 3b   unsigned int h;
5550: 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63  .  PCache1 *pCac
5560: 68 65 20 3d 20 70 50 61 67 65 2d 3e 70 43 61 63  he = pPage->pCac
5570: 68 65 3b 0a 20 20 50 67 48 64 72 31 20 2a 2a 70  he;.  PgHdr1 **p
5580: 70 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71  p;..  assert( sq
5590: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64  lite3_mutex_held
55a0: 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d  (pCache->pGroup-
55b0: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 68 20 3d  >mutex) );.  h =
55c0: 20 70 50 61 67 65 2d 3e 69 4b 65 79 20 25 20 70   pPage->iKey % p
55d0: 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20  Cache->nHash;.  
55e0: 66 6f 72 28 70 70 3d 26 70 43 61 63 68 65 2d 3e  for(pp=&pCache->
55f0: 61 70 48 61 73 68 5b 68 5d 3b 20 28 2a 70 70 29  apHash[h]; (*pp)
5600: 21 3d 70 50 61 67 65 3b 20 70 70 3d 26 28 2a 70  !=pPage; pp=&(*p
5610: 70 29 2d 3e 70 4e 65 78 74 29 3b 0a 20 20 2a 70  p)->pNext);.  *p
5620: 70 20 3d 20 28 2a 70 70 29 2d 3e 70 4e 65 78 74  p = (*pp)->pNext
5630: 3b 0a 0a 20 20 70 43 61 63 68 65 2d 3e 6e 50 61  ;..  pCache->nPa
5640: 67 65 2d 2d 3b 0a 20 20 69 66 28 20 66 72 65 65  ge--;.  if( free
5650: 46 6c 61 67 20 29 20 70 63 61 63 68 65 31 46 72  Flag ) pcache1Fr
5660: 65 65 50 61 67 65 28 70 50 61 67 65 29 3b 0a 7d  eePage(pPage);.}
5670: 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 72 65  ../*.** If there
5680: 20 61 72 65 20 63 75 72 72 65 6e 74 6c 79 20 6d   are currently m
5690: 6f 72 65 20 74 68 61 6e 20 6e 4d 61 78 50 61 67  ore than nMaxPag
56a0: 65 20 70 61 67 65 73 20 61 6c 6c 6f 63 61 74 65  e pages allocate
56b0: 64 2c 20 74 72 79 0a 2a 2a 20 74 6f 20 72 65 63  d, try.** to rec
56c0: 79 63 6c 65 20 70 61 67 65 73 20 74 6f 20 72 65  ycle pages to re
56d0: 64 75 63 65 20 74 68 65 20 6e 75 6d 62 65 72 20  duce the number 
56e0: 61 6c 6c 6f 63 61 74 65 64 20 74 6f 20 6e 4d 61  allocated to nMa
56f0: 78 50 61 67 65 2e 0a 2a 2f 0a 73 74 61 74 69 63  xPage..*/.static
5700: 20 76 6f 69 64 20 70 63 61 63 68 65 31 45 6e 66   void pcache1Enf
5710: 6f 72 63 65 4d 61 78 50 61 67 65 28 50 43 61 63  orceMaxPage(PCac
5720: 68 65 31 20 2a 70 43 61 63 68 65 29 7b 0a 20 20  he1 *pCache){.  
5730: 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70 20 3d  PGroup *pGroup =
5740: 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3b   pCache->pGroup;
5750: 0a 20 20 50 67 48 64 72 31 20 2a 70 3b 0a 20 20  .  PgHdr1 *p;.  
5760: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f  assert( sqlite3_
5770: 6d 75 74 65 78 5f 68 65 6c 64 28 70 47 72 6f 75  mutex_held(pGrou
5780: 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 77  p->mutex) );.  w
5790: 68 69 6c 65 28 20 70 47 72 6f 75 70 2d 3e 6e 50  hile( pGroup->nP
57a0: 75 72 67 65 61 62 6c 65 3e 70 47 72 6f 75 70 2d  urgeable>pGroup-
57b0: 3e 6e 4d 61 78 50 61 67 65 0a 20 20 20 20 20 20  >nMaxPage.      
57c0: 26 26 20 28 70 3d 70 47 72 6f 75 70 2d 3e 6c 72  && (p=pGroup->lr
57d0: 75 2e 70 4c 72 75 50 72 65 76 29 2d 3e 69 73 41  u.pLruPrev)->isA
57e0: 6e 63 68 6f 72 3d 3d 30 0a 20 20 29 7b 0a 20 20  nchor==0.  ){.  
57f0: 20 20 61 73 73 65 72 74 28 20 70 2d 3e 70 43 61    assert( p->pCa
5800: 63 68 65 2d 3e 70 47 72 6f 75 70 3d 3d 70 47 72  che->pGroup==pGr
5810: 6f 75 70 20 29 3b 0a 20 20 20 20 61 73 73 65 72  oup );.    asser
5820: 74 28 20 50 41 47 45 5f 49 53 5f 55 4e 50 49 4e  t( PAGE_IS_UNPIN
5830: 4e 45 44 28 70 29 20 29 3b 0a 20 20 20 20 70 63  NED(p) );.    pc
5840: 61 63 68 65 31 50 69 6e 50 61 67 65 28 70 29 3b  ache1PinPage(p);
5850: 0a 20 20 20 20 70 63 61 63 68 65 31 52 65 6d 6f  .    pcache1Remo
5860: 76 65 46 72 6f 6d 48 61 73 68 28 70 2c 20 31 29  veFromHash(p, 1)
5870: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 43 61 63  ;.  }.  if( pCac
5880: 68 65 2d 3e 6e 50 61 67 65 3d 3d 30 20 26 26 20  he->nPage==0 && 
5890: 70 43 61 63 68 65 2d 3e 70 42 75 6c 6b 20 29 7b  pCache->pBulk ){
58a0: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65  .    sqlite3_fre
58b0: 65 28 70 43 61 63 68 65 2d 3e 70 42 75 6c 6b 29  e(pCache->pBulk)
58c0: 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 70 42  ;.    pCache->pB
58d0: 75 6c 6b 20 3d 20 70 43 61 63 68 65 2d 3e 70 46  ulk = pCache->pF
58e0: 72 65 65 20 3d 20 30 3b 0a 20 20 7d 0a 7d 0a 0a  ree = 0;.  }.}..
58f0: 2f 2a 0a 2a 2a 20 44 69 73 63 61 72 64 20 61 6c  /*.** Discard al
5900: 6c 20 70 61 67 65 73 20 66 72 6f 6d 20 63 61 63  l pages from cac
5910: 68 65 20 70 43 61 63 68 65 20 77 69 74 68 20 61  he pCache with a
5920: 20 70 61 67 65 20 6e 75 6d 62 65 72 20 28 6b 65   page number (ke
5930: 79 20 76 61 6c 75 65 29 20 0a 2a 2a 20 67 72 65  y value) .** gre
5940: 61 74 65 72 20 74 68 61 6e 20 6f 72 20 65 71 75  ater than or equ
5950: 61 6c 20 74 6f 20 69 4c 69 6d 69 74 2e 20 41 6e  al to iLimit. An
5960: 79 20 70 69 6e 6e 65 64 20 70 61 67 65 73 20 74  y pinned pages t
5970: 68 61 74 20 6d 65 65 74 20 74 68 69 73 20 0a 2a  hat meet this .*
5980: 2a 20 63 72 69 74 65 72 69 61 20 61 72 65 20 75  * criteria are u
5990: 6e 70 69 6e 6e 65 64 20 62 65 66 6f 72 65 20 74  npinned before t
59a0: 68 65 79 20 61 72 65 20 64 69 73 63 61 72 64 65  hey are discarde
59b0: 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50 43 61  d..**.** The PCa
59c0: 63 68 65 20 6d 75 74 65 78 20 6d 75 73 74 20 62  che mutex must b
59d0: 65 20 68 65 6c 64 20 77 68 65 6e 20 74 68 69 73  e held when this
59e0: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c   function is cal
59f0: 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  led..*/.static v
5a00: 6f 69 64 20 70 63 61 63 68 65 31 54 72 75 6e 63  oid pcache1Trunc
5a10: 61 74 65 55 6e 73 61 66 65 28 0a 20 20 50 43 61  ateUnsafe(.  PCa
5a20: 63 68 65 31 20 2a 70 43 61 63 68 65 2c 20 20 20  che1 *pCache,   
5a30: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65            /* The
5a40: 20 63 61 63 68 65 20 74 6f 20 74 72 75 6e 63 61   cache to trunca
5a50: 74 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64  te */.  unsigned
5a60: 20 69 6e 74 20 69 4c 69 6d 69 74 20 20 20 20 20   int iLimit     
5a70: 20 20 20 20 20 2f 2a 20 44 72 6f 70 20 70 61 67       /* Drop pag
5a80: 65 73 20 77 69 74 68 20 74 68 69 73 20 70 67 6e  es with this pgn
5a90: 6f 20 6f 72 20 6c 61 72 67 65 72 20 2a 2f 0a 29  o or larger */.)
5aa0: 7b 0a 20 20 54 45 53 54 4f 4e 4c 59 28 20 69 6e  {.  TESTONLY( in
5ab0: 74 20 6e 50 61 67 65 20 3d 20 30 3b 20 29 20 20  t nPage = 0; )  
5ac0: 2f 2a 20 54 6f 20 61 73 73 65 72 74 20 70 43 61  /* To assert pCa
5ad0: 63 68 65 2d 3e 6e 50 61 67 65 20 69 73 20 63 6f  che->nPage is co
5ae0: 72 72 65 63 74 20 2a 2f 0a 20 20 75 6e 73 69 67  rrect */.  unsig
5af0: 6e 65 64 20 69 6e 74 20 68 2c 20 69 53 74 6f 70  ned int h, iStop
5b00: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69  ;.  assert( sqli
5b10: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70  te3_mutex_held(p
5b20: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6d  Cache->pGroup->m
5b30: 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72  utex) );.  asser
5b40: 74 28 20 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b  t( pCache->iMaxK
5b50: 65 79 20 3e 3d 20 69 4c 69 6d 69 74 20 29 3b 0a  ey >= iLimit );.
5b60: 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65    assert( pCache
5b70: 2d 3e 6e 48 61 73 68 20 3e 20 30 20 29 3b 0a 20  ->nHash > 0 );. 
5b80: 20 69 66 28 20 70 43 61 63 68 65 2d 3e 69 4d 61   if( pCache->iMa
5b90: 78 4b 65 79 20 2d 20 69 4c 69 6d 69 74 20 3c 20  xKey - iLimit < 
5ba0: 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 20 29 7b  pCache->nHash ){
5bb0: 0a 20 20 20 20 2f 2a 20 49 66 20 77 65 20 61 72  .    /* If we ar
5bc0: 65 20 6a 75 73 74 20 73 68 61 76 69 6e 67 20 74  e just shaving t
5bd0: 68 65 20 6c 61 73 74 20 66 65 77 20 70 61 67 65  he last few page
5be0: 73 20 6f 66 66 20 74 68 65 20 65 6e 64 20 6f 66  s off the end of
5bf0: 20 74 68 65 0a 20 20 20 20 2a 2a 20 63 61 63 68   the.    ** cach
5c00: 65 2c 20 74 68 65 6e 20 74 68 65 72 65 20 69 73  e, then there is
5c10: 20 6e 6f 20 70 6f 69 6e 74 20 69 6e 20 73 63 61   no point in sca
5c20: 6e 6e 69 6e 67 20 74 68 65 20 65 6e 74 69 72 65  nning the entire
5c30: 20 68 61 73 68 20 74 61 62 6c 65 2e 0a 20 20 20   hash table..   
5c40: 20 2a 2a 20 4f 6e 6c 79 20 73 63 61 6e 20 74 68   ** Only scan th
5c50: 6f 73 65 20 68 61 73 68 20 73 6c 6f 74 73 20 74  ose hash slots t
5c60: 68 61 74 20 6d 69 67 68 74 20 63 6f 6e 74 61 69  hat might contai
5c70: 6e 20 70 61 67 65 73 20 74 68 61 74 20 6e 65 65  n pages that nee
5c80: 64 20 74 6f 0a 20 20 20 20 2a 2a 20 62 65 20 72  d to.    ** be r
5c90: 65 6d 6f 76 65 64 2e 20 2a 2f 0a 20 20 20 20 68  emoved. */.    h
5ca0: 20 3d 20 69 4c 69 6d 69 74 20 25 20 70 43 61 63   = iLimit % pCac
5cb0: 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 20 20 69  he->nHash;.    i
5cc0: 53 74 6f 70 20 3d 20 70 43 61 63 68 65 2d 3e 69  Stop = pCache->i
5cd0: 4d 61 78 4b 65 79 20 25 20 70 43 61 63 68 65 2d  MaxKey % pCache-
5ce0: 3e 6e 48 61 73 68 3b 0a 20 20 20 20 54 45 53 54  >nHash;.    TEST
5cf0: 4f 4e 4c 59 28 20 6e 50 61 67 65 20 3d 20 2d 31  ONLY( nPage = -1
5d00: 30 3b 20 29 20 20 2f 2a 20 44 69 73 61 62 6c 65  0; )  /* Disable
5d10: 20 74 68 65 20 70 43 61 63 68 65 2d 3e 6e 50 61   the pCache->nPa
5d20: 67 65 20 76 61 6c 69 64 69 74 79 20 63 68 65 63  ge validity chec
5d30: 6b 20 2a 2f 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  k */.  }else{.  
5d40: 20 20 2f 2a 20 54 68 69 73 20 69 73 20 74 68 65    /* This is the
5d50: 20 67 65 6e 65 72 61 6c 20 63 61 73 65 20 77 68   general case wh
5d60: 65 72 65 20 6d 61 6e 79 20 70 61 67 65 73 20 61  ere many pages a
5d70: 72 65 20 62 65 69 6e 67 20 72 65 6d 6f 76 65 64  re being removed
5d80: 2e 0a 20 20 20 20 2a 2a 20 49 74 20 69 73 20 6e  ..    ** It is n
5d90: 65 63 65 73 73 61 72 79 20 74 6f 20 73 63 61 6e  ecessary to scan
5da0: 20 74 68 65 20 65 6e 74 69 72 65 20 68 61 73 68   the entire hash
5db0: 20 74 61 62 6c 65 20 2a 2f 0a 20 20 20 20 68 20   table */.    h 
5dc0: 3d 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 2f  = pCache->nHash/
5dd0: 32 3b 0a 20 20 20 20 69 53 74 6f 70 20 3d 20 68  2;.    iStop = h
5de0: 20 2d 20 31 3b 0a 20 20 7d 0a 20 20 66 6f 72 28   - 1;.  }.  for(
5df0: 3b 3b 29 7b 0a 20 20 20 20 50 67 48 64 72 31 20  ;;){.    PgHdr1 
5e00: 2a 2a 70 70 3b 0a 20 20 20 20 50 67 48 64 72 31  **pp;.    PgHdr1
5e10: 20 2a 70 50 61 67 65 3b 0a 20 20 20 20 61 73 73   *pPage;.    ass
5e20: 65 72 74 28 20 68 3c 70 43 61 63 68 65 2d 3e 6e  ert( h<pCache->n
5e30: 48 61 73 68 20 29 3b 0a 20 20 20 20 70 70 20 3d  Hash );.    pp =
5e40: 20 26 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68   &pCache->apHash
5e50: 5b 68 5d 3b 20 0a 20 20 20 20 77 68 69 6c 65 28  [h]; .    while(
5e60: 20 28 70 50 61 67 65 20 3d 20 2a 70 70 29 21 3d   (pPage = *pp)!=
5e70: 30 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70  0 ){.      if( p
5e80: 50 61 67 65 2d 3e 69 4b 65 79 3e 3d 69 4c 69 6d  Page->iKey>=iLim
5e90: 69 74 20 29 7b 0a 20 20 20 20 20 20 20 20 70 43  it ){.        pC
5ea0: 61 63 68 65 2d 3e 6e 50 61 67 65 2d 2d 3b 0a 20  ache->nPage--;. 
5eb0: 20 20 20 20 20 20 20 2a 70 70 20 3d 20 70 50 61         *pp = pPa
5ec0: 67 65 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20  ge->pNext;.     
5ed0: 20 20 20 69 66 28 20 50 41 47 45 5f 49 53 5f 55     if( PAGE_IS_U
5ee0: 4e 50 49 4e 4e 45 44 28 70 50 61 67 65 29 20 29  NPINNED(pPage) )
5ef0: 20 70 63 61 63 68 65 31 50 69 6e 50 61 67 65 28   pcache1PinPage(
5f00: 70 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20  pPage);.        
5f10: 70 63 61 63 68 65 31 46 72 65 65 50 61 67 65 28  pcache1FreePage(
5f20: 70 50 61 67 65 29 3b 0a 20 20 20 20 20 20 7d 65  pPage);.      }e
5f30: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70 70 20  lse{.        pp 
5f40: 3d 20 26 70 50 61 67 65 2d 3e 70 4e 65 78 74 3b  = &pPage->pNext;
5f50: 0a 20 20 20 20 20 20 20 20 54 45 53 54 4f 4e 4c  .        TESTONL
5f60: 59 28 20 69 66 28 20 6e 50 61 67 65 3e 3d 30 20  Y( if( nPage>=0 
5f70: 29 20 6e 50 61 67 65 2b 2b 3b 20 29 0a 20 20 20  ) nPage++; ).   
5f80: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69     }.    }.    i
5f90: 66 28 20 68 3d 3d 69 53 74 6f 70 20 29 20 62 72  f( h==iStop ) br
5fa0: 65 61 6b 3b 0a 20 20 20 20 68 20 3d 20 28 68 2b  eak;.    h = (h+
5fb0: 31 29 20 25 20 70 43 61 63 68 65 2d 3e 6e 48 61  1) % pCache->nHa
5fc0: 73 68 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74  sh;.  }.  assert
5fd0: 28 20 6e 50 61 67 65 3c 30 20 7c 7c 20 70 43 61  ( nPage<0 || pCa
5fe0: 63 68 65 2d 3e 6e 50 61 67 65 3d 3d 28 75 6e 73  che->nPage==(uns
5ff0: 69 67 6e 65 64 29 6e 50 61 67 65 20 29 3b 0a 7d  igned)nPage );.}
6000: 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ../*************
6010: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
6020: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
6030: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
6040: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
6050: 2a 2f 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c  */./******** sql
6060: 69 74 65 33 5f 70 63 61 63 68 65 20 4d 65 74 68  ite3_pcache Meth
6070: 6f 64 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ods ************
6080: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
6090: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
60a0: 2a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65  **/../*.** Imple
60b0: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65  mentation of the
60c0: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e   sqlite3_pcache.
60d0: 78 49 6e 69 74 20 6d 65 74 68 6f 64 2e 0a 2a 2f  xInit method..*/
60e0: 0a 73 74 61 74 69 63 20 69 6e 74 20 70 63 61 63  .static int pcac
60f0: 68 65 31 49 6e 69 74 28 76 6f 69 64 20 2a 4e 6f  he1Init(void *No
6100: 74 55 73 65 64 29 7b 0a 20 20 55 4e 55 53 45 44  tUsed){.  UNUSED
6110: 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f 74 55 73  _PARAMETER(NotUs
6120: 65 64 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  ed);.  assert( p
6130: 63 61 63 68 65 31 2e 69 73 49 6e 69 74 3d 3d 30  cache1.isInit==0
6140: 20 29 3b 0a 20 20 6d 65 6d 73 65 74 28 26 70 63   );.  memset(&pc
6150: 61 63 68 65 31 2c 20 30 2c 20 73 69 7a 65 6f 66  ache1, 0, sizeof
6160: 28 70 63 61 63 68 65 31 29 29 3b 0a 0a 0a 20 20  (pcache1));...  
6170: 2f 2a 0a 20 20 2a 2a 20 54 68 65 20 70 63 61 63  /*.  ** The pcac
6180: 68 65 31 2e 73 65 70 61 72 61 74 65 43 61 63 68  he1.separateCach
6190: 65 20 76 61 72 69 61 62 6c 65 20 69 73 20 74 72  e variable is tr
61a0: 75 65 20 69 66 20 65 61 63 68 20 50 43 61 63 68  ue if each PCach
61b0: 65 20 68 61 73 20 69 74 73 20 6f 77 6e 0a 20 20  e has its own.  
61c0: 2a 2a 20 70 72 69 76 61 74 65 20 50 47 72 6f 75  ** private PGrou
61d0: 70 20 28 6d 6f 64 65 2d 31 29 2e 20 20 70 63 61  p (mode-1).  pca
61e0: 63 68 65 31 2e 73 65 70 61 72 61 74 65 43 61 63  che1.separateCac
61f0: 68 65 20 69 73 20 66 61 6c 73 65 20 69 66 20 74  he is false if t
6200: 68 65 20 73 69 6e 67 6c 65 0a 20 20 2a 2a 20 50  he single.  ** P
6210: 47 72 6f 75 70 20 69 6e 20 70 63 61 63 68 65 31  Group in pcache1
6220: 2e 67 72 70 20 69 73 20 75 73 65 64 20 66 6f 72  .grp is used for
6230: 20 61 6c 6c 20 70 61 67 65 20 63 61 63 68 65 73   all page caches
6240: 20 28 6d 6f 64 65 2d 32 29 2e 0a 20 20 2a 2a 0a   (mode-2)..  **.
6250: 20 20 2a 2a 20 20 20 2a 20 20 41 6c 77 61 79 73    **   *  Always
6260: 20 75 73 65 20 61 20 75 6e 69 66 69 65 64 20 63   use a unified c
6270: 61 63 68 65 20 28 6d 6f 64 65 2d 32 29 20 69 66  ache (mode-2) if
6280: 20 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d   ENABLE_MEMORY_M
6290: 41 4e 41 47 45 4d 45 4e 54 0a 20 20 2a 2a 0a 20  ANAGEMENT.  **. 
62a0: 20 2a 2a 20 20 20 2a 20 20 55 73 65 20 61 20 75   **   *  Use a u
62b0: 6e 69 66 69 65 64 20 63 61 63 68 65 20 69 6e 20  nified cache in 
62c0: 73 69 6e 67 6c 65 2d 74 68 72 65 61 64 65 64 20  single-threaded 
62d0: 61 70 70 6c 69 63 61 74 69 6f 6e 73 20 74 68 61  applications tha
62e0: 74 20 68 61 76 65 0a 20 20 2a 2a 20 20 20 20 20  t have.  **     
62f0: 20 63 6f 6e 66 69 67 75 72 65 64 20 61 20 73 74   configured a st
6300: 61 72 74 2d 74 69 6d 65 20 62 75 66 66 65 72 20  art-time buffer 
6310: 66 6f 72 20 75 73 65 20 61 73 20 70 61 67 65 2d  for use as page-
6320: 63 61 63 68 65 20 6d 65 6d 6f 72 79 20 75 73 69  cache memory usi
6330: 6e 67 0a 20 20 2a 2a 20 20 20 20 20 20 73 71 6c  ng.  **      sql
6340: 69 74 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49  ite3_config(SQLI
6350: 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41  TE_CONFIG_PAGECA
6360: 43 48 45 2c 20 70 42 75 66 2c 20 73 7a 2c 20 4e  CHE, pBuf, sz, N
6370: 29 20 77 69 74 68 20 6e 6f 6e 2d 4e 55 4c 4c 20  ) with non-NULL 
6380: 0a 20 20 2a 2a 20 20 20 20 20 20 70 42 75 66 20  .  **      pBuf 
6390: 61 72 67 75 6d 65 6e 74 2e 0a 20 20 2a 2a 0a 20  argument..  **. 
63a0: 20 2a 2a 20 20 20 2a 20 20 4f 74 68 65 72 77 69   **   *  Otherwi
63b0: 73 65 20 75 73 65 20 73 65 70 61 72 61 74 65 20  se use separate 
63c0: 63 61 63 68 65 73 20 28 6d 6f 64 65 2d 31 29 0a  caches (mode-1).
63d0: 20 20 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64    */.#if defined
63e0: 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d  (SQLITE_ENABLE_M
63f0: 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54  EMORY_MANAGEMENT
6400: 29 0a 20 20 70 63 61 63 68 65 31 2e 73 65 70 61  ).  pcache1.sepa
6410: 72 61 74 65 43 61 63 68 65 20 3d 20 30 3b 0a 23  rateCache = 0;.#
6420: 65 6c 69 66 20 53 51 4c 49 54 45 5f 54 48 52 45  elif SQLITE_THRE
6430: 41 44 53 41 46 45 0a 20 20 70 63 61 63 68 65 31  ADSAFE.  pcache1
6440: 2e 73 65 70 61 72 61 74 65 43 61 63 68 65 20 3d  .separateCache =
6450: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f   sqlite3GlobalCo
6460: 6e 66 69 67 2e 70 50 61 67 65 3d 3d 30 0a 20 20  nfig.pPage==0.  
6470: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6480: 20 20 20 20 20 20 20 20 7c 7c 20 73 71 6c 69 74          || sqlit
6490: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62  e3GlobalConfig.b
64a0: 43 6f 72 65 4d 75 74 65 78 3e 30 3b 0a 23 65 6c  CoreMutex>0;.#el
64b0: 73 65 0a 20 20 70 63 61 63 68 65 31 2e 73 65 70  se.  pcache1.sep
64c0: 61 72 61 74 65 43 61 63 68 65 20 3d 20 73 71 6c  arateCache = sql
64d0: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67  ite3GlobalConfig
64e0: 2e 70 50 61 67 65 3d 3d 30 3b 0a 23 65 6e 64 69  .pPage==0;.#endi
64f0: 66 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f 54 48  f..#if SQLITE_TH
6500: 52 45 41 44 53 41 46 45 0a 20 20 69 66 28 20 73  READSAFE.  if( s
6510: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66  qlite3GlobalConf
6520: 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 20 29 7b  ig.bCoreMutex ){
6530: 0a 20 20 20 20 70 63 61 63 68 65 31 2e 67 72 70  .    pcache1.grp
6540: 2e 6d 75 74 65 78 20 3d 20 73 71 6c 69 74 65 33  .mutex = sqlite3
6550: 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54  MutexAlloc(SQLIT
6560: 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c  E_MUTEX_STATIC_L
6570: 52 55 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31  RU);.    pcache1
6580: 2e 6d 75 74 65 78 20 3d 20 73 71 6c 69 74 65 33  .mutex = sqlite3
6590: 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54  MutexAlloc(SQLIT
65a0: 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 50  E_MUTEX_STATIC_P
65b0: 4d 45 4d 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66  MEM);.  }.#endif
65c0: 0a 20 20 69 66 28 20 70 63 61 63 68 65 31 2e 73  .  if( pcache1.s
65d0: 65 70 61 72 61 74 65 43 61 63 68 65 0a 20 20 20  eparateCache.   
65e0: 26 26 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c  && sqlite3Global
65f0: 43 6f 6e 66 69 67 2e 6e 50 61 67 65 21 3d 30 0a  Config.nPage!=0.
6600: 20 20 20 26 26 20 73 71 6c 69 74 65 33 47 6c 6f     && sqlite3Glo
6610: 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65 3d  balConfig.pPage=
6620: 3d 30 0a 20 20 29 7b 0a 20 20 20 20 70 63 61 63  =0.  ){.    pcac
6630: 68 65 31 2e 6e 49 6e 69 74 50 61 67 65 20 3d 20  he1.nInitPage = 
6640: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
6650: 66 69 67 2e 6e 50 61 67 65 3b 0a 20 20 7d 65 6c  fig.nPage;.  }el
6660: 73 65 7b 0a 20 20 20 20 70 63 61 63 68 65 31 2e  se{.    pcache1.
6670: 6e 49 6e 69 74 50 61 67 65 20 3d 20 30 3b 0a 20  nInitPage = 0;. 
6680: 20 7d 0a 20 20 70 63 61 63 68 65 31 2e 67 72 70   }.  pcache1.grp
6690: 2e 6d 78 50 69 6e 6e 65 64 20 3d 20 31 30 3b 0a  .mxPinned = 10;.
66a0: 20 20 70 63 61 63 68 65 31 2e 69 73 49 6e 69 74    pcache1.isInit
66b0: 20 3d 20 31 3b 0a 20 20 72 65 74 75 72 6e 20 53   = 1;.  return S
66c0: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a  QLITE_OK;.}../*.
66d0: 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  ** Implementatio
66e0: 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33  n of the sqlite3
66f0: 5f 70 63 61 63 68 65 2e 78 53 68 75 74 64 6f 77  _pcache.xShutdow
6700: 6e 20 6d 65 74 68 6f 64 2e 0a 2a 2a 20 4e 6f 74  n method..** Not
6710: 65 20 74 68 61 74 20 74 68 65 20 73 74 61 74 69  e that the stati
6720: 63 20 6d 75 74 65 78 20 61 6c 6c 6f 63 61 74 65  c mutex allocate
6730: 64 20 69 6e 20 78 49 6e 69 74 20 64 6f 65 73 20  d in xInit does 
6740: 0a 2a 2a 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20  .** not need to 
6750: 62 65 20 66 72 65 65 64 2e 0a 2a 2f 0a 73 74 61  be freed..*/.sta
6760: 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31  tic void pcache1
6770: 53 68 75 74 64 6f 77 6e 28 76 6f 69 64 20 2a 4e  Shutdown(void *N
6780: 6f 74 55 73 65 64 29 7b 0a 20 20 55 4e 55 53 45  otUsed){.  UNUSE
6790: 44 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f 74 55  D_PARAMETER(NotU
67a0: 73 65 64 29 3b 0a 20 20 61 73 73 65 72 74 28 20  sed);.  assert( 
67b0: 70 63 61 63 68 65 31 2e 69 73 49 6e 69 74 21 3d  pcache1.isInit!=
67c0: 30 20 29 3b 0a 20 20 6d 65 6d 73 65 74 28 26 70  0 );.  memset(&p
67d0: 63 61 63 68 65 31 2c 20 30 2c 20 73 69 7a 65 6f  cache1, 0, sizeo
67e0: 66 28 70 63 61 63 68 65 31 29 29 3b 0a 7d 0a 0a  f(pcache1));.}..
67f0: 2f 2a 20 66 6f 72 77 61 72 64 20 64 65 63 6c 61  /* forward decla
6800: 72 61 74 69 6f 6e 20 2a 2f 0a 73 74 61 74 69 63  ration */.static
6810: 20 76 6f 69 64 20 70 63 61 63 68 65 31 44 65 73   void pcache1Des
6820: 74 72 6f 79 28 73 71 6c 69 74 65 33 5f 70 63 61  troy(sqlite3_pca
6830: 63 68 65 20 2a 70 29 3b 0a 0a 2f 2a 0a 2a 2a 20  che *p);../*.** 
6840: 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  Implementation o
6850: 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63  f the sqlite3_pc
6860: 61 63 68 65 2e 78 43 72 65 61 74 65 20 6d 65 74  ache.xCreate met
6870: 68 6f 64 2e 0a 2a 2a 0a 2a 2a 20 41 6c 6c 6f 63  hod..**.** Alloc
6880: 61 74 65 20 61 20 6e 65 77 20 63 61 63 68 65 2e  ate a new cache.
6890: 0a 2a 2f 0a 73 74 61 74 69 63 20 73 71 6c 69 74  .*/.static sqlit
68a0: 65 33 5f 70 63 61 63 68 65 20 2a 70 63 61 63 68  e3_pcache *pcach
68b0: 65 31 43 72 65 61 74 65 28 69 6e 74 20 73 7a 50  e1Create(int szP
68c0: 61 67 65 2c 20 69 6e 74 20 73 7a 45 78 74 72 61  age, int szExtra
68d0: 2c 20 69 6e 74 20 62 50 75 72 67 65 61 62 6c 65  , int bPurgeable
68e0: 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43  ){.  PCache1 *pC
68f0: 61 63 68 65 3b 20 20 20 20 20 20 2f 2a 20 54 68  ache;      /* Th
6900: 65 20 6e 65 77 6c 79 20 63 72 65 61 74 65 64 20  e newly created 
6910: 70 61 67 65 20 63 61 63 68 65 20 2a 2f 0a 20 20  page cache */.  
6920: 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70 3b 20  PGroup *pGroup; 
6930: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 67 72 6f        /* The gro
6940: 75 70 20 74 68 65 20 6e 65 77 20 70 61 67 65 20  up the new page 
6950: 63 61 63 68 65 20 77 69 6c 6c 20 62 65 6c 6f 6e  cache will belon
6960: 67 20 74 6f 20 2a 2f 0a 20 20 69 6e 74 20 73 7a  g to */.  int sz
6970: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
6980: 2f 2a 20 42 79 74 65 73 20 6f 66 20 6d 65 6d 6f  /* Bytes of memo
6990: 72 79 20 72 65 71 75 69 72 65 64 20 74 6f 20 61  ry required to a
69a0: 6c 6c 6f 63 61 74 65 20 74 68 65 20 6e 65 77 20  llocate the new 
69b0: 63 61 63 68 65 20 2a 2f 0a 0a 20 20 61 73 73 65  cache */..  asse
69c0: 72 74 28 20 28 73 7a 50 61 67 65 20 26 20 28 73  rt( (szPage & (s
69d0: 7a 50 61 67 65 2d 31 29 29 3d 3d 30 20 26 26 20  zPage-1))==0 && 
69e0: 73 7a 50 61 67 65 3e 3d 35 31 32 20 26 26 20 73  szPage>=512 && s
69f0: 7a 50 61 67 65 3c 3d 36 35 35 33 36 20 29 3b 0a  zPage<=65536 );.
6a00: 20 20 61 73 73 65 72 74 28 20 73 7a 45 78 74 72    assert( szExtr
6a10: 61 20 3c 20 33 30 30 20 29 3b 0a 0a 20 20 73 7a  a < 300 );..  sz
6a20: 20 3d 20 73 69 7a 65 6f 66 28 50 43 61 63 68 65   = sizeof(PCache
6a30: 31 29 20 2b 20 73 69 7a 65 6f 66 28 50 47 72 6f  1) + sizeof(PGro
6a40: 75 70 29 2a 70 63 61 63 68 65 31 2e 73 65 70 61  up)*pcache1.sepa
6a50: 72 61 74 65 43 61 63 68 65 3b 0a 20 20 70 43 61  rateCache;.  pCa
6a60: 63 68 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a  che = (PCache1 *
6a70: 29 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a 65  )sqlite3MallocZe
6a80: 72 6f 28 73 7a 29 3b 0a 20 20 69 66 28 20 70 43  ro(sz);.  if( pC
6a90: 61 63 68 65 20 29 7b 0a 20 20 20 20 69 66 28 20  ache ){.    if( 
6aa0: 70 63 61 63 68 65 31 2e 73 65 70 61 72 61 74 65  pcache1.separate
6ab0: 43 61 63 68 65 20 29 7b 0a 20 20 20 20 20 20 70  Cache ){.      p
6ac0: 47 72 6f 75 70 20 3d 20 28 50 47 72 6f 75 70 2a  Group = (PGroup*
6ad0: 29 26 70 43 61 63 68 65 5b 31 5d 3b 0a 20 20 20  )&pCache[1];.   
6ae0: 20 20 20 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e     pGroup->mxPin
6af0: 6e 65 64 20 3d 20 31 30 3b 0a 20 20 20 20 7d 65  ned = 10;.    }e
6b00: 6c 73 65 7b 0a 20 20 20 20 20 20 70 47 72 6f 75  lse{.      pGrou
6b10: 70 20 3d 20 26 70 63 61 63 68 65 31 2e 67 72 70  p = &pcache1.grp
6b20: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20  ;.    }.    if( 
6b30: 70 47 72 6f 75 70 2d 3e 6c 72 75 2e 69 73 41 6e  pGroup->lru.isAn
6b40: 63 68 6f 72 3d 3d 30 20 29 7b 0a 20 20 20 20 20  chor==0 ){.     
6b50: 20 70 47 72 6f 75 70 2d 3e 6c 72 75 2e 69 73 41   pGroup->lru.isA
6b60: 6e 63 68 6f 72 20 3d 20 31 3b 0a 20 20 20 20 20  nchor = 1;.     
6b70: 20 70 47 72 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72   pGroup->lru.pLr
6b80: 75 50 72 65 76 20 3d 20 70 47 72 6f 75 70 2d 3e  uPrev = pGroup->
6b90: 6c 72 75 2e 70 4c 72 75 4e 65 78 74 20 3d 20 26  lru.pLruNext = &
6ba0: 70 47 72 6f 75 70 2d 3e 6c 72 75 3b 0a 20 20 20  pGroup->lru;.   
6bb0: 20 7d 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 70   }.    pCache->p
6bc0: 47 72 6f 75 70 20 3d 20 70 47 72 6f 75 70 3b 0a  Group = pGroup;.
6bd0: 20 20 20 20 70 43 61 63 68 65 2d 3e 73 7a 50 61      pCache->szPa
6be0: 67 65 20 3d 20 73 7a 50 61 67 65 3b 0a 20 20 20  ge = szPage;.   
6bf0: 20 70 43 61 63 68 65 2d 3e 73 7a 45 78 74 72 61   pCache->szExtra
6c00: 20 3d 20 73 7a 45 78 74 72 61 3b 0a 20 20 20 20   = szExtra;.    
6c10: 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63 20  pCache->szAlloc 
6c20: 3d 20 73 7a 50 61 67 65 20 2b 20 73 7a 45 78 74  = szPage + szExt
6c30: 72 61 20 2b 20 52 4f 55 4e 44 38 28 73 69 7a 65  ra + ROUND8(size
6c40: 6f 66 28 50 67 48 64 72 31 29 29 3b 0a 20 20 20  of(PgHdr1));.   
6c50: 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61   pCache->bPurgea
6c60: 62 6c 65 20 3d 20 28 62 50 75 72 67 65 61 62 6c  ble = (bPurgeabl
6c70: 65 20 3f 20 31 20 3a 20 30 29 3b 0a 20 20 20 20  e ? 1 : 0);.    
6c80: 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65  pcache1EnterMute
6c90: 78 28 70 47 72 6f 75 70 29 3b 0a 20 20 20 20 70  x(pGroup);.    p
6ca0: 63 61 63 68 65 31 52 65 73 69 7a 65 48 61 73 68  cache1ResizeHash
6cb0: 28 70 43 61 63 68 65 29 3b 0a 20 20 20 20 69 66  (pCache);.    if
6cc0: 28 20 62 50 75 72 67 65 61 62 6c 65 20 29 7b 0a  ( bPurgeable ){.
6cd0: 20 20 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 4d        pCache->nM
6ce0: 69 6e 20 3d 20 31 30 3b 0a 20 20 20 20 20 20 70  in = 10;.      p
6cf0: 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 20  Group->nMinPage 
6d00: 2b 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 3b  += pCache->nMin;
6d10: 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e 6d  .      pGroup->m
6d20: 78 50 69 6e 6e 65 64 20 3d 20 70 47 72 6f 75 70  xPinned = pGroup
6d30: 2d 3e 6e 4d 61 78 50 61 67 65 20 2b 20 31 30 20  ->nMaxPage + 10 
6d40: 2d 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61  - pGroup->nMinPa
6d50: 67 65 3b 0a 20 20 20 20 20 20 70 43 61 63 68 65  ge;.      pCache
6d60: 2d 3e 70 6e 50 75 72 67 65 61 62 6c 65 20 3d 20  ->pnPurgeable = 
6d70: 26 70 47 72 6f 75 70 2d 3e 6e 50 75 72 67 65 61  &pGroup->nPurgea
6d80: 62 6c 65 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a  ble;.    }else{.
6d90: 20 20 20 20 20 20 73 74 61 74 69 63 20 75 6e 73        static uns
6da0: 69 67 6e 65 64 20 69 6e 74 20 64 75 6d 6d 79 43  igned int dummyC
6db0: 75 72 72 65 6e 74 50 61 67 65 3b 0a 20 20 20 20  urrentPage;.    
6dc0: 20 20 70 43 61 63 68 65 2d 3e 70 6e 50 75 72 67    pCache->pnPurg
6dd0: 65 61 62 6c 65 20 3d 20 26 64 75 6d 6d 79 43 75  eable = &dummyCu
6de0: 72 72 65 6e 74 50 61 67 65 3b 0a 20 20 20 20 7d  rrentPage;.    }
6df0: 0a 20 20 20 20 70 63 61 63 68 65 31 4c 65 61 76  .    pcache1Leav
6e00: 65 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a  eMutex(pGroup);.
6e10: 20 20 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e      if( pCache->
6e20: 6e 48 61 73 68 3d 3d 30 20 29 7b 0a 20 20 20 20  nHash==0 ){.    
6e30: 20 20 70 63 61 63 68 65 31 44 65 73 74 72 6f 79    pcache1Destroy
6e40: 28 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  ((sqlite3_pcache
6e50: 2a 29 70 43 61 63 68 65 29 3b 0a 20 20 20 20 20  *)pCache);.     
6e60: 20 70 43 61 63 68 65 20 3d 20 30 3b 0a 20 20 20   pCache = 0;.   
6e70: 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20   }.  }.  return 
6e80: 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20  (sqlite3_pcache 
6e90: 2a 29 70 43 61 63 68 65 3b 0a 7d 0a 0a 2f 2a 0a  *)pCache;.}../*.
6ea0: 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  ** Implementatio
6eb0: 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33  n of the sqlite3
6ec0: 5f 70 63 61 63 68 65 2e 78 43 61 63 68 65 73 69  _pcache.xCachesi
6ed0: 7a 65 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a  ze method. .**.*
6ee0: 2a 20 43 6f 6e 66 69 67 75 72 65 20 74 68 65 20  * Configure the 
6ef0: 63 61 63 68 65 5f 73 69 7a 65 20 6c 69 6d 69 74  cache_size limit
6f00: 20 66 6f 72 20 61 20 63 61 63 68 65 2e 0a 2a 2f   for a cache..*/
6f10: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61  .static void pca
6f20: 63 68 65 31 43 61 63 68 65 73 69 7a 65 28 73 71  che1Cachesize(sq
6f30: 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 2c  lite3_pcache *p,
6f40: 20 69 6e 74 20 6e 4d 61 78 29 7b 0a 20 20 50 43   int nMax){.  PC
6f50: 61 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20  ache1 *pCache = 
6f60: 28 50 43 61 63 68 65 31 20 2a 29 70 3b 0a 20 20  (PCache1 *)p;.  
6f70: 69 66 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72  if( pCache->bPur
6f80: 67 65 61 62 6c 65 20 29 7b 0a 20 20 20 20 50 47  geable ){.    PG
6f90: 72 6f 75 70 20 2a 70 47 72 6f 75 70 20 3d 20 70  roup *pGroup = p
6fa0: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20  Cache->pGroup;. 
6fb0: 20 20 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d     pcache1EnterM
6fc0: 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20 20  utex(pGroup);.  
6fd0: 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61    pGroup->nMaxPa
6fe0: 67 65 20 2b 3d 20 28 6e 4d 61 78 20 2d 20 70 43  ge += (nMax - pC
6ff0: 61 63 68 65 2d 3e 6e 4d 61 78 29 3b 0a 20 20 20  ache->nMax);.   
7000: 20 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65   pGroup->mxPinne
7010: 64 20 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78  d = pGroup->nMax
7020: 50 61 67 65 20 2b 20 31 30 20 2d 20 70 47 72 6f  Page + 10 - pGro
7030: 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 3b 0a 20 20  up->nMinPage;.  
7040: 20 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 20 3d    pCache->nMax =
7050: 20 6e 4d 61 78 3b 0a 20 20 20 20 70 43 61 63 68   nMax;.    pCach
7060: 65 2d 3e 6e 39 30 70 63 74 20 3d 20 70 43 61 63  e->n90pct = pCac
7070: 68 65 2d 3e 6e 4d 61 78 2a 39 2f 31 30 3b 0a 20  he->nMax*9/10;. 
7080: 20 20 20 70 63 61 63 68 65 31 45 6e 66 6f 72 63     pcache1Enforc
7090: 65 4d 61 78 50 61 67 65 28 70 43 61 63 68 65 29  eMaxPage(pCache)
70a0: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 4c 65 61  ;.    pcache1Lea
70b0: 76 65 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b  veMutex(pGroup);
70c0: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d  .  }.}../*.** Im
70d0: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20  plementation of 
70e0: 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63  the sqlite3_pcac
70f0: 68 65 2e 78 53 68 72 69 6e 6b 20 6d 65 74 68 6f  he.xShrink metho
7100: 64 2e 20 0a 2a 2a 0a 2a 2a 20 46 72 65 65 20 75  d. .**.** Free u
7110: 70 20 61 73 20 6d 75 63 68 20 6d 65 6d 6f 72 79  p as much memory
7120: 20 61 73 20 70 6f 73 73 69 62 6c 65 2e 0a 2a 2f   as possible..*/
7130: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61  .static void pca
7140: 63 68 65 31 53 68 72 69 6e 6b 28 73 71 6c 69 74  che1Shrink(sqlit
7150: 65 33 5f 70 63 61 63 68 65 20 2a 70 29 7b 0a 20  e3_pcache *p){. 
7160: 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65   PCache1 *pCache
7170: 20 3d 20 28 50 43 61 63 68 65 31 2a 29 70 3b 0a   = (PCache1*)p;.
7180: 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e 62 50    if( pCache->bP
7190: 75 72 67 65 61 62 6c 65 20 29 7b 0a 20 20 20 20  urgeable ){.    
71a0: 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70 20 3d  PGroup *pGroup =
71b0: 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3b   pCache->pGroup;
71c0: 0a 20 20 20 20 69 6e 74 20 73 61 76 65 64 4d 61  .    int savedMa
71d0: 78 50 61 67 65 3b 0a 20 20 20 20 70 63 61 63 68  xPage;.    pcach
71e0: 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70 47 72  e1EnterMutex(pGr
71f0: 6f 75 70 29 3b 0a 20 20 20 20 73 61 76 65 64 4d  oup);.    savedM
7200: 61 78 50 61 67 65 20 3d 20 70 47 72 6f 75 70 2d  axPage = pGroup-
7210: 3e 6e 4d 61 78 50 61 67 65 3b 0a 20 20 20 20 70  >nMaxPage;.    p
7220: 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20  Group->nMaxPage 
7230: 3d 20 30 3b 0a 20 20 20 20 70 63 61 63 68 65 31  = 0;.    pcache1
7240: 45 6e 66 6f 72 63 65 4d 61 78 50 61 67 65 28 70  EnforceMaxPage(p
7250: 43 61 63 68 65 29 3b 0a 20 20 20 20 70 47 72 6f  Cache);.    pGro
7260: 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 3d 20 73  up->nMaxPage = s
7270: 61 76 65 64 4d 61 78 50 61 67 65 3b 0a 20 20 20  avedMaxPage;.   
7280: 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74   pcache1LeaveMut
7290: 65 78 28 70 47 72 6f 75 70 29 3b 0a 20 20 7d 0a  ex(pGroup);.  }.
72a0: 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65  }../*.** Impleme
72b0: 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73  ntation of the s
72c0: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78 50  qlite3_pcache.xP
72d0: 61 67 65 63 6f 75 6e 74 20 6d 65 74 68 6f 64 2e  agecount method.
72e0: 20 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20   .*/.static int 
72f0: 70 63 61 63 68 65 31 50 61 67 65 63 6f 75 6e 74  pcache1Pagecount
7300: 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20  (sqlite3_pcache 
7310: 2a 70 29 7b 0a 20 20 69 6e 74 20 6e 3b 0a 20 20  *p){.  int n;.  
7320: 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 20  PCache1 *pCache 
7330: 3d 20 28 50 43 61 63 68 65 31 2a 29 70 3b 0a 20  = (PCache1*)p;. 
7340: 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74   pcache1EnterMut
7350: 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75  ex(pCache->pGrou
7360: 70 29 3b 0a 20 20 6e 20 3d 20 70 43 61 63 68 65  p);.  n = pCache
7370: 2d 3e 6e 50 61 67 65 3b 0a 20 20 70 63 61 63 68  ->nPage;.  pcach
7380: 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70 43 61  e1LeaveMutex(pCa
7390: 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20  che->pGroup);.  
73a0: 72 65 74 75 72 6e 20 6e 3b 0a 7d 0a 0a 0a 2f 2a  return n;.}.../*
73b0: 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 20 73 74  .** Implement st
73c0: 65 70 73 20 33 2c 20 34 2c 20 61 6e 64 20 35 20  eps 3, 4, and 5 
73d0: 6f 66 20 74 68 65 20 70 63 61 63 68 65 31 46 65  of the pcache1Fe
73e0: 74 63 68 28 29 20 61 6c 67 6f 72 69 74 68 6d 20  tch() algorithm 
73f0: 64 65 73 63 72 69 62 65 64 0a 2a 2a 20 69 6e 20  described.** in 
7400: 74 68 65 20 68 65 61 64 65 72 20 6f 66 20 74 68  the header of th
7410: 65 20 70 63 61 63 68 65 31 46 65 74 63 68 28 29  e pcache1Fetch()
7420: 20 70 72 6f 63 65 64 75 72 65 2e 0a 2a 2a 0a 2a   procedure..**.*
7430: 2a 20 54 68 69 73 20 73 74 65 70 73 20 61 72 65  * This steps are
7440: 20 62 72 6f 6b 65 6e 20 6f 75 74 20 69 6e 74 6f   broken out into
7450: 20 61 20 73 65 70 61 72 61 74 65 20 70 72 6f 63   a separate proc
7460: 65 64 75 72 65 20 62 65 63 61 75 73 65 20 74 68  edure because th
7470: 65 79 20 61 72 65 0a 2a 2a 20 75 73 75 61 6c 6c  ey are.** usuall
7480: 79 20 6e 6f 74 20 6e 65 65 64 65 64 2c 20 61 6e  y not needed, an
7490: 64 20 62 79 20 61 76 6f 69 64 69 6e 67 20 74 68  d by avoiding th
74a0: 65 20 73 74 61 63 6b 20 69 6e 69 74 69 61 6c 69  e stack initiali
74b0: 7a 61 74 69 6f 6e 20 72 65 71 75 69 72 65 64 0a  zation required.
74c0: 2a 2a 20 66 6f 72 20 74 68 65 73 65 20 73 74 65  ** for these ste
74d0: 70 73 2c 20 74 68 65 20 6d 61 69 6e 20 70 63 61  ps, the main pca
74e0: 63 68 65 31 46 65 74 63 68 28 29 20 70 72 6f 63  che1Fetch() proc
74f0: 65 64 75 72 65 20 63 61 6e 20 72 75 6e 20 66 61  edure can run fa
7500: 73 74 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  ster..*/.static 
7510: 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20  SQLITE_NOINLINE 
7520: 50 67 48 64 72 31 20 2a 70 63 61 63 68 65 31 46  PgHdr1 *pcache1F
7530: 65 74 63 68 53 74 61 67 65 32 28 0a 20 20 50 43  etchStage2(.  PC
7540: 61 63 68 65 31 20 2a 70 43 61 63 68 65 2c 20 0a  ache1 *pCache, .
7550: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69    unsigned int i
7560: 4b 65 79 2c 20 0a 20 20 69 6e 74 20 63 72 65 61  Key, .  int crea
7570: 74 65 46 6c 61 67 0a 29 7b 0a 20 20 75 6e 73 69  teFlag.){.  unsi
7580: 67 6e 65 64 20 69 6e 74 20 6e 50 69 6e 6e 65 64  gned int nPinned
7590: 3b 0a 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f  ;.  PGroup *pGro
75a0: 75 70 20 3d 20 70 43 61 63 68 65 2d 3e 70 47 72  up = pCache->pGr
75b0: 6f 75 70 3b 0a 20 20 50 67 48 64 72 31 20 2a 70  oup;.  PgHdr1 *p
75c0: 50 61 67 65 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20  Page = 0;..  /* 
75d0: 53 74 65 70 20 33 3a 20 41 62 6f 72 74 20 69 66  Step 3: Abort if
75e0: 20 63 72 65 61 74 65 46 6c 61 67 20 69 73 20 31   createFlag is 1
75f0: 20 62 75 74 20 74 68 65 20 63 61 63 68 65 20 69   but the cache i
7600: 73 20 6e 65 61 72 6c 79 20 66 75 6c 6c 20 2a 2f  s nearly full */
7610: 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68  .  assert( pCach
7620: 65 2d 3e 6e 50 61 67 65 20 3e 3d 20 70 43 61 63  e->nPage >= pCac
7630: 68 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65 20  he->nRecyclable 
7640: 29 3b 0a 20 20 6e 50 69 6e 6e 65 64 20 3d 20 70  );.  nPinned = p
7650: 43 61 63 68 65 2d 3e 6e 50 61 67 65 20 2d 20 70  Cache->nPage - p
7660: 43 61 63 68 65 2d 3e 6e 52 65 63 79 63 6c 61 62  Cache->nRecyclab
7670: 6c 65 3b 0a 20 20 61 73 73 65 72 74 28 20 70 47  le;.  assert( pG
7680: 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d  roup->mxPinned =
7690: 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61  = pGroup->nMaxPa
76a0: 67 65 20 2b 20 31 30 20 2d 20 70 47 72 6f 75 70  ge + 10 - pGroup
76b0: 2d 3e 6e 4d 69 6e 50 61 67 65 20 29 3b 0a 20 20  ->nMinPage );.  
76c0: 61 73 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e  assert( pCache->
76d0: 6e 39 30 70 63 74 20 3d 3d 20 70 43 61 63 68 65  n90pct == pCache
76e0: 2d 3e 6e 4d 61 78 2a 39 2f 31 30 20 29 3b 0a 20  ->nMax*9/10 );. 
76f0: 20 69 66 28 20 63 72 65 61 74 65 46 6c 61 67 3d   if( createFlag=
7700: 3d 31 20 26 26 20 28 0a 20 20 20 20 20 20 20 20  =1 && (.        
7710: 6e 50 69 6e 6e 65 64 3e 3d 70 47 72 6f 75 70 2d  nPinned>=pGroup-
7720: 3e 6d 78 50 69 6e 6e 65 64 0a 20 20 20 20 20 7c  >mxPinned.     |
7730: 7c 20 6e 50 69 6e 6e 65 64 3e 3d 70 43 61 63 68  | nPinned>=pCach
7740: 65 2d 3e 6e 39 30 70 63 74 0a 20 20 20 20 20 7c  e->n90pct.     |
7750: 7c 20 28 70 63 61 63 68 65 31 55 6e 64 65 72 4d  | (pcache1UnderM
7760: 65 6d 6f 72 79 50 72 65 73 73 75 72 65 28 70 43  emoryPressure(pC
7770: 61 63 68 65 29 20 26 26 20 70 43 61 63 68 65 2d  ache) && pCache-
7780: 3e 6e 52 65 63 79 63 6c 61 62 6c 65 3c 6e 50 69  >nRecyclable<nPi
7790: 6e 6e 65 64 29 0a 20 20 29 29 7b 0a 20 20 20 20  nned).  )){.    
77a0: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 0a 20  return 0;.  }.. 
77b0: 20 69 66 28 20 70 43 61 63 68 65 2d 3e 6e 50 61   if( pCache->nPa
77c0: 67 65 3e 3d 70 43 61 63 68 65 2d 3e 6e 48 61 73  ge>=pCache->nHas
77d0: 68 20 29 20 70 63 61 63 68 65 31 52 65 73 69 7a  h ) pcache1Resiz
77e0: 65 48 61 73 68 28 70 43 61 63 68 65 29 3b 0a 20  eHash(pCache);. 
77f0: 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65 2d   assert( pCache-
7800: 3e 6e 48 61 73 68 3e 30 20 26 26 20 70 43 61 63  >nHash>0 && pCac
7810: 68 65 2d 3e 61 70 48 61 73 68 20 29 3b 0a 0a 20  he->apHash );.. 
7820: 20 2f 2a 20 53 74 65 70 20 34 2e 20 54 72 79 20   /* Step 4. Try 
7830: 74 6f 20 72 65 63 79 63 6c 65 20 61 20 70 61 67  to recycle a pag
7840: 65 2e 20 2a 2f 0a 20 20 69 66 28 20 70 43 61 63  e. */.  if( pCac
7850: 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 0a 20  he->bPurgeable. 
7860: 20 20 26 26 20 21 70 47 72 6f 75 70 2d 3e 6c 72    && !pGroup->lr
7870: 75 2e 70 4c 72 75 50 72 65 76 2d 3e 69 73 41 6e  u.pLruPrev->isAn
7880: 63 68 6f 72 0a 20 20 20 26 26 20 28 28 70 43 61  chor.   && ((pCa
7890: 63 68 65 2d 3e 6e 50 61 67 65 2b 31 3e 3d 70 43  che->nPage+1>=pC
78a0: 61 63 68 65 2d 3e 6e 4d 61 78 29 20 7c 7c 20 70  ache->nMax) || p
78b0: 63 61 63 68 65 31 55 6e 64 65 72 4d 65 6d 6f 72  cache1UnderMemor
78c0: 79 50 72 65 73 73 75 72 65 28 70 43 61 63 68 65  yPressure(pCache
78d0: 29 29 0a 20 20 29 7b 0a 20 20 20 20 50 43 61 63  )).  ){.    PCac
78e0: 68 65 31 20 2a 70 4f 74 68 65 72 3b 0a 20 20 20  he1 *pOther;.   
78f0: 20 70 50 61 67 65 20 3d 20 70 47 72 6f 75 70 2d   pPage = pGroup-
7900: 3e 6c 72 75 2e 70 4c 72 75 50 72 65 76 3b 0a 20  >lru.pLruPrev;. 
7910: 20 20 20 61 73 73 65 72 74 28 20 50 41 47 45 5f     assert( PAGE_
7920: 49 53 5f 55 4e 50 49 4e 4e 45 44 28 70 50 61 67  IS_UNPINNED(pPag
7930: 65 29 20 29 3b 0a 20 20 20 20 70 63 61 63 68 65  e) );.    pcache
7940: 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73 68 28  1RemoveFromHash(
7950: 70 50 61 67 65 2c 20 30 29 3b 0a 20 20 20 20 70  pPage, 0);.    p
7960: 63 61 63 68 65 31 50 69 6e 50 61 67 65 28 70 50  cache1PinPage(pP
7970: 61 67 65 29 3b 0a 20 20 20 20 70 4f 74 68 65 72  age);.    pOther
7980: 20 3d 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65   = pPage->pCache
7990: 3b 0a 20 20 20 20 69 66 28 20 70 4f 74 68 65 72  ;.    if( pOther
79a0: 2d 3e 73 7a 41 6c 6c 6f 63 20 21 3d 20 70 43 61  ->szAlloc != pCa
79b0: 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63 20 29 7b 0a  che->szAlloc ){.
79c0: 20 20 20 20 20 20 70 63 61 63 68 65 31 46 72 65        pcache1Fre
79d0: 65 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 20  ePage(pPage);.  
79e0: 20 20 20 20 70 50 61 67 65 20 3d 20 30 3b 0a 20      pPage = 0;. 
79f0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
7a00: 70 47 72 6f 75 70 2d 3e 6e 50 75 72 67 65 61 62  pGroup->nPurgeab
7a10: 6c 65 20 2d 3d 20 28 70 4f 74 68 65 72 2d 3e 62  le -= (pOther->b
7a20: 50 75 72 67 65 61 62 6c 65 20 2d 20 70 43 61 63  Purgeable - pCac
7a30: 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 29 3b  he->bPurgeable);
7a40: 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a  .    }.  }..  /*
7a50: 20 53 74 65 70 20 35 2e 20 49 66 20 61 20 75 73   Step 5. If a us
7a60: 61 62 6c 65 20 70 61 67 65 20 62 75 66 66 65 72  able page buffer
7a70: 20 68 61 73 20 73 74 69 6c 6c 20 6e 6f 74 20 62   has still not b
7a80: 65 65 6e 20 66 6f 75 6e 64 2c 20 0a 20 20 2a 2a  een found, .  **
7a90: 20 61 74 74 65 6d 70 74 20 74 6f 20 61 6c 6c 6f   attempt to allo
7aa0: 63 61 74 65 20 61 20 6e 65 77 20 6f 6e 65 2e 20  cate a new one. 
7ab0: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 21 70 50 61  .  */.  if( !pPa
7ac0: 67 65 20 29 7b 0a 20 20 20 20 70 50 61 67 65 20  ge ){.    pPage 
7ad0: 3d 20 70 63 61 63 68 65 31 41 6c 6c 6f 63 50 61  = pcache1AllocPa
7ae0: 67 65 28 70 43 61 63 68 65 2c 20 63 72 65 61 74  ge(pCache, creat
7af0: 65 46 6c 61 67 3d 3d 31 29 3b 0a 20 20 7d 0a 0a  eFlag==1);.  }..
7b00: 20 20 69 66 28 20 70 50 61 67 65 20 29 7b 0a 20    if( pPage ){. 
7b10: 20 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20     unsigned int 
7b20: 68 20 3d 20 69 4b 65 79 20 25 20 70 43 61 63 68  h = iKey % pCach
7b30: 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 20 20 70 43  e->nHash;.    pC
7b40: 61 63 68 65 2d 3e 6e 50 61 67 65 2b 2b 3b 0a 20  ache->nPage++;. 
7b50: 20 20 20 70 50 61 67 65 2d 3e 69 4b 65 79 20 3d     pPage->iKey =
7b60: 20 69 4b 65 79 3b 0a 20 20 20 20 70 50 61 67 65   iKey;.    pPage
7b70: 2d 3e 70 4e 65 78 74 20 3d 20 70 43 61 63 68 65  ->pNext = pCache
7b80: 2d 3e 61 70 48 61 73 68 5b 68 5d 3b 0a 20 20 20  ->apHash[h];.   
7b90: 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65 20 3d   pPage->pCache =
7ba0: 20 70 43 61 63 68 65 3b 0a 20 20 20 20 70 50 61   pCache;.    pPa
7bb0: 67 65 2d 3e 70 4c 72 75 4e 65 78 74 20 3d 20 30  ge->pLruNext = 0
7bc0: 3b 0a 20 20 20 20 2f 2a 20 70 50 61 67 65 2d 3e  ;.    /* pPage->
7bd0: 70 4c 72 75 50 72 65 76 20 3d 20 30 3b 0a 20 20  pLruPrev = 0;.  
7be0: 20 20 2a 2a 20 4e 6f 20 6e 65 65 64 20 74 6f 20    ** No need to 
7bf0: 63 6c 65 61 72 20 70 4c 72 75 50 72 65 76 20 73  clear pLruPrev s
7c00: 69 6e 63 65 20 69 74 20 69 73 20 6e 6f 74 20 61  ince it is not a
7c10: 63 63 65 73 73 65 64 20 77 68 65 6e 20 70 4c 72  ccessed when pLr
7c20: 75 4e 65 78 74 3d 3d 30 20 2a 2f 0a 20 20 20 20  uNext==0 */.    
7c30: 2a 28 76 6f 69 64 20 2a 2a 29 70 50 61 67 65 2d  *(void **)pPage-
7c40: 3e 70 61 67 65 2e 70 45 78 74 72 61 20 3d 20 30  >page.pExtra = 0
7c50: 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 61 70  ;.    pCache->ap
7c60: 48 61 73 68 5b 68 5d 20 3d 20 70 50 61 67 65 3b  Hash[h] = pPage;
7c70: 0a 20 20 20 20 69 66 28 20 69 4b 65 79 3e 70 43  .    if( iKey>pC
7c80: 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 29 7b  ache->iMaxKey ){
7c90: 0a 20 20 20 20 20 20 70 43 61 63 68 65 2d 3e 69  .      pCache->i
7ca0: 4d 61 78 4b 65 79 20 3d 20 69 4b 65 79 3b 0a 20  MaxKey = iKey;. 
7cb0: 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72     }.  }.  retur
7cc0: 6e 20 70 50 61 67 65 3b 0a 7d 0a 0a 2f 2a 0a 2a  n pPage;.}../*.*
7cd0: 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  * Implementation
7ce0: 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f   of the sqlite3_
7cf0: 70 63 61 63 68 65 2e 78 46 65 74 63 68 20 6d 65  pcache.xFetch me
7d00: 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 46 65 74  thod. .**.** Fet
7d10: 63 68 20 61 20 70 61 67 65 20 62 79 20 6b 65 79  ch a page by key
7d20: 20 76 61 6c 75 65 2e 0a 2a 2a 0a 2a 2a 20 57 68   value..**.** Wh
7d30: 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 61 20 6e  ether or not a n
7d40: 65 77 20 70 61 67 65 20 6d 61 79 20 62 65 20 61  ew page may be a
7d50: 6c 6c 6f 63 61 74 65 64 20 62 79 20 74 68 69 73  llocated by this
7d60: 20 66 75 6e 63 74 69 6f 6e 20 64 65 70 65 6e 64   function depend
7d70: 73 20 6f 6e 0a 2a 2a 20 74 68 65 20 76 61 6c 75  s on.** the valu
7d80: 65 20 6f 66 20 74 68 65 20 63 72 65 61 74 65 46  e of the createF
7d90: 6c 61 67 20 61 72 67 75 6d 65 6e 74 2e 20 20 30  lag argument.  0
7da0: 20 6d 65 61 6e 73 20 64 6f 20 6e 6f 74 20 61 6c   means do not al
7db0: 6c 6f 63 61 74 65 20 61 20 6e 65 77 0a 2a 2a 20  locate a new.** 
7dc0: 70 61 67 65 2e 20 20 31 20 6d 65 61 6e 73 20 61  page.  1 means a
7dd0: 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 70 61  llocate a new pa
7de0: 67 65 20 69 66 20 73 70 61 63 65 20 69 73 20 65  ge if space is e
7df0: 61 73 69 6c 79 20 61 76 61 69 6c 61 62 6c 65 2e  asily available.
7e00: 20 20 32 20 0a 2a 2a 20 6d 65 61 6e 73 20 74 6f    2 .** means to
7e10: 20 74 72 79 20 72 65 61 6c 6c 79 20 68 61 72 64   try really hard
7e20: 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e   to allocate a n
7e30: 65 77 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 46  ew page..**.** F
7e40: 6f 72 20 61 20 6e 6f 6e 2d 70 75 72 67 65 61 62  or a non-purgeab
7e50: 6c 65 20 63 61 63 68 65 20 28 61 20 63 61 63 68  le cache (a cach
7e60: 65 20 75 73 65 64 20 61 73 20 74 68 65 20 73 74  e used as the st
7e70: 6f 72 61 67 65 20 66 6f 72 20 61 6e 20 69 6e 2d  orage for an in-
7e80: 6d 65 6d 6f 72 79 0a 2a 2a 20 64 61 74 61 62 61  memory.** databa
7e90: 73 65 29 20 74 68 65 72 65 20 69 73 20 72 65 61  se) there is rea
7ea0: 6c 6c 79 20 6e 6f 20 64 69 66 66 65 72 65 6e 63  lly no differenc
7eb0: 65 20 62 65 74 77 65 65 6e 20 63 72 65 61 74 65  e between create
7ec0: 46 6c 61 67 20 31 20 61 6e 64 20 32 2e 20 20 53  Flag 1 and 2.  S
7ed0: 6f 0a 2a 2a 20 74 68 65 20 63 61 6c 6c 69 6e 67  o.** the calling
7ee0: 20 66 75 6e 63 74 69 6f 6e 20 28 70 63 61 63 68   function (pcach
7ef0: 65 2e 63 29 20 77 69 6c 6c 20 6e 65 76 65 72 20  e.c) will never 
7f00: 68 61 76 65 20 61 20 63 72 65 61 74 65 46 6c 61  have a createFla
7f10: 67 20 6f 66 20 31 20 6f 6e 0a 2a 2a 20 61 20 6e  g of 1 on.** a n
7f20: 6f 6e 2d 70 75 72 67 65 61 62 6c 65 20 63 61 63  on-purgeable cac
7f30: 68 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 72 65 20  he..**.** There 
7f40: 61 72 65 20 74 68 72 65 65 20 64 69 66 66 65 72  are three differ
7f50: 65 6e 74 20 61 70 70 72 6f 61 63 68 65 73 20 74  ent approaches t
7f60: 6f 20 6f 62 74 61 69 6e 69 6e 67 20 73 70 61 63  o obtaining spac
7f70: 65 20 66 6f 72 20 61 20 70 61 67 65 2c 0a 2a 2a  e for a page,.**
7f80: 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68   depending on th
7f90: 65 20 76 61 6c 75 65 20 6f 66 20 70 61 72 61 6d  e value of param
7fa0: 65 74 65 72 20 63 72 65 61 74 65 46 6c 61 67 20  eter createFlag 
7fb0: 28 77 68 69 63 68 20 6d 61 79 20 62 65 20 30 2c  (which may be 0,
7fc0: 20 31 20 6f 72 20 32 29 2e 0a 2a 2a 0a 2a 2a 20   1 or 2)..**.** 
7fd0: 20 20 31 2e 20 52 65 67 61 72 64 6c 65 73 73 20    1. Regardless 
7fe0: 6f 66 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20  of the value of 
7ff0: 63 72 65 61 74 65 46 6c 61 67 2c 20 74 68 65 20  createFlag, the 
8000: 63 61 63 68 65 20 69 73 20 73 65 61 72 63 68 65  cache is searche
8010: 64 20 66 6f 72 20 61 20 0a 2a 2a 20 20 20 20 20  d for a .**     
8020: 20 63 6f 70 79 20 6f 66 20 74 68 65 20 72 65 71   copy of the req
8030: 75 65 73 74 65 64 20 70 61 67 65 2e 20 49 66 20  uested page. If 
8040: 6f 6e 65 20 69 73 20 66 6f 75 6e 64 2c 20 69 74  one is found, it
8050: 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a   is returned..**
8060: 0a 2a 2a 20 20 20 32 2e 20 49 66 20 63 72 65 61  .**   2. If crea
8070: 74 65 46 6c 61 67 3d 3d 30 20 61 6e 64 20 74 68  teFlag==0 and th
8080: 65 20 70 61 67 65 20 69 73 20 6e 6f 74 20 61 6c  e page is not al
8090: 72 65 61 64 79 20 69 6e 20 74 68 65 20 63 61 63  ready in the cac
80a0: 68 65 2c 20 4e 55 4c 4c 20 69 73 0a 2a 2a 20 20  he, NULL is.**  
80b0: 20 20 20 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a      returned..**
80c0: 0a 2a 2a 20 20 20 33 2e 20 49 66 20 63 72 65 61  .**   3. If crea
80d0: 74 65 46 6c 61 67 20 69 73 20 31 2c 20 61 6e 64  teFlag is 1, and
80e0: 20 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f 74   the page is not
80f0: 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65 20   already in the 
8100: 63 61 63 68 65 2c 20 74 68 65 6e 0a 2a 2a 20 20  cache, then.**  
8110: 20 20 20 20 72 65 74 75 72 6e 20 4e 55 4c 4c 20      return NULL 
8120: 28 64 6f 20 6e 6f 74 20 61 6c 6c 6f 63 61 74 65  (do not allocate
8130: 20 61 20 6e 65 77 20 70 61 67 65 29 20 69 66 20   a new page) if 
8140: 61 6e 79 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f  any of the follo
8150: 77 69 6e 67 0a 2a 2a 20 20 20 20 20 20 63 6f 6e  wing.**      con
8160: 64 69 74 69 6f 6e 73 20 61 72 65 20 74 72 75 65  ditions are true
8170: 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 28 61  :.**.**       (a
8180: 29 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  ) the number of 
8190: 70 61 67 65 73 20 70 69 6e 6e 65 64 20 62 79 20  pages pinned by 
81a0: 74 68 65 20 63 61 63 68 65 20 69 73 20 67 72 65  the cache is gre
81b0: 61 74 65 72 20 74 68 61 6e 0a 2a 2a 20 20 20 20  ater than.**    
81c0: 20 20 20 20 20 20 20 50 43 61 63 68 65 31 2e 6e         PCache1.n
81d0: 4d 61 78 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 20 20  Max, or.**.**   
81e0: 20 20 20 20 28 62 29 20 74 68 65 20 6e 75 6d 62      (b) the numb
81f0: 65 72 20 6f 66 20 70 61 67 65 73 20 70 69 6e 6e  er of pages pinn
8200: 65 64 20 62 79 20 74 68 65 20 63 61 63 68 65 20  ed by the cache 
8210: 69 73 20 67 72 65 61 74 65 72 20 74 68 61 6e 0a  is greater than.
8220: 2a 2a 20 20 20 20 20 20 20 20 20 20 20 74 68 65  **           the
8230: 20 73 75 6d 20 6f 66 20 6e 4d 61 78 20 66 6f 72   sum of nMax for
8240: 20 61 6c 6c 20 70 75 72 67 65 61 62 6c 65 20 63   all purgeable c
8250: 61 63 68 65 73 2c 20 6c 65 73 73 20 74 68 65 20  aches, less the 
8260: 73 75 6d 20 6f 66 20 0a 2a 2a 20 20 20 20 20 20  sum of .**      
8270: 20 20 20 20 20 6e 4d 69 6e 20 66 6f 72 20 61 6c       nMin for al
8280: 6c 20 6f 74 68 65 72 20 70 75 72 67 65 61 62 6c  l other purgeabl
8290: 65 20 63 61 63 68 65 73 2c 20 6f 72 0a 2a 2a 0a  e caches, or.**.
82a0: 2a 2a 20 20 20 34 2e 20 49 66 20 6e 6f 6e 65 20  **   4. If none 
82b0: 6f 66 20 74 68 65 20 66 69 72 73 74 20 74 68 72  of the first thr
82c0: 65 65 20 63 6f 6e 64 69 74 69 6f 6e 73 20 61 70  ee conditions ap
82d0: 70 6c 79 20 61 6e 64 20 74 68 65 20 63 61 63 68  ply and the cach
82e0: 65 20 69 73 20 6d 61 72 6b 65 64 0a 2a 2a 20 20  e is marked.**  
82f0: 20 20 20 20 61 73 20 70 75 72 67 65 61 62 6c 65      as purgeable
8300: 2c 20 61 6e 64 20 69 66 20 6f 6e 65 20 6f 66 20  , and if one of 
8310: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 73  the following is
8320: 20 74 72 75 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20   true:.**.**    
8330: 20 20 20 28 61 29 20 54 68 65 20 6e 75 6d 62 65     (a) The numbe
8340: 72 20 6f 66 20 70 61 67 65 73 20 61 6c 6c 6f 63  r of pages alloc
8350: 61 74 65 64 20 66 6f 72 20 74 68 65 20 63 61 63  ated for the cac
8360: 68 65 20 69 73 20 61 6c 72 65 61 64 79 20 0a 2a  he is already .*
8370: 2a 20 20 20 20 20 20 20 20 20 20 20 50 43 61 63  *           PCac
8380: 68 65 31 2e 6e 4d 61 78 2c 20 6f 72 0a 2a 2a 0a  he1.nMax, or.**.
8390: 2a 2a 20 20 20 20 20 20 20 28 62 29 20 54 68 65  **       (b) The
83a0: 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73   number of pages
83b0: 20 61 6c 6c 6f 63 61 74 65 64 20 66 6f 72 20 61   allocated for a
83c0: 6c 6c 20 70 75 72 67 65 61 62 6c 65 20 63 61 63  ll purgeable cac
83d0: 68 65 73 20 69 73 0a 2a 2a 20 20 20 20 20 20 20  hes is.**       
83e0: 20 20 20 20 61 6c 72 65 61 64 79 20 65 71 75 61      already equa
83f0: 6c 20 74 6f 20 6f 72 20 67 72 65 61 74 65 72 20  l to or greater 
8400: 74 68 61 6e 20 74 68 65 20 73 75 6d 20 6f 66 20  than the sum of 
8410: 6e 4d 61 78 20 66 6f 72 20 61 6c 6c 0a 2a 2a 20  nMax for all.** 
8420: 20 20 20 20 20 20 20 20 20 20 70 75 72 67 65 61            purgea
8430: 62 6c 65 20 63 61 63 68 65 73 2c 0a 2a 2a 0a 2a  ble caches,.**.*
8440: 2a 20 20 20 20 20 20 20 28 63 29 20 54 68 65 20  *       (c) The 
8450: 73 79 73 74 65 6d 20 69 73 20 75 6e 64 65 72 20  system is under 
8460: 6d 65 6d 6f 72 79 20 70 72 65 73 73 75 72 65 20  memory pressure 
8470: 61 6e 64 20 77 61 6e 74 73 20 74 6f 20 61 76 6f  and wants to avo
8480: 69 64 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20  id.**           
8490: 75 6e 6e 65 63 65 73 73 61 72 79 20 70 61 67 65  unnecessary page
84a0: 73 20 63 61 63 68 65 20 65 6e 74 72 79 20 61 6c  s cache entry al
84b0: 6c 6f 63 61 74 69 6f 6e 73 0a 2a 2a 0a 2a 2a 20  locations.**.** 
84c0: 20 20 20 20 20 74 68 65 6e 20 61 74 74 65 6d 70       then attemp
84d0: 74 20 74 6f 20 72 65 63 79 63 6c 65 20 61 20 70  t to recycle a p
84e0: 61 67 65 20 66 72 6f 6d 20 74 68 65 20 4c 52 55  age from the LRU
84f0: 20 6c 69 73 74 2e 20 49 66 20 69 74 20 69 73 20   list. If it is 
8500: 74 68 65 20 72 69 67 68 74 0a 2a 2a 20 20 20 20  the right.**    
8510: 20 20 73 69 7a 65 2c 20 72 65 74 75 72 6e 20 74    size, return t
8520: 68 65 20 72 65 63 79 63 6c 65 64 20 62 75 66 66  he recycled buff
8530: 65 72 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 66  er. Otherwise, f
8540: 72 65 65 20 74 68 65 20 62 75 66 66 65 72 20 61  ree the buffer a
8550: 6e 64 0a 2a 2a 20 20 20 20 20 20 70 72 6f 63 65  nd.**      proce
8560: 65 64 20 74 6f 20 73 74 65 70 20 35 2e 20 0a 2a  ed to step 5. .*
8570: 2a 0a 2a 2a 20 20 20 35 2e 20 4f 74 68 65 72 77  *.**   5. Otherw
8580: 69 73 65 2c 20 61 6c 6c 6f 63 61 74 65 20 61 6e  ise, allocate an
8590: 64 20 72 65 74 75 72 6e 20 61 20 6e 65 77 20 70  d return a new p
85a0: 61 67 65 20 62 75 66 66 65 72 2e 0a 2a 2a 0a 2a  age buffer..**.*
85b0: 2a 20 54 68 65 72 65 20 61 72 65 20 74 77 6f 20  * There are two 
85c0: 76 65 72 73 69 6f 6e 73 20 6f 66 20 74 68 69 73  versions of this
85d0: 20 72 6f 75 74 69 6e 65 2e 20 20 70 63 61 63 68   routine.  pcach
85e0: 65 31 46 65 74 63 68 57 69 74 68 4d 75 74 65 78  e1FetchWithMutex
85f0: 28 29 20 69 73 0a 2a 2a 20 74 68 65 20 67 65 6e  () is.** the gen
8600: 65 72 61 6c 20 63 61 73 65 2e 20 20 70 63 61 63  eral case.  pcac
8610: 68 65 31 46 65 74 63 68 4e 6f 4d 75 74 65 78 28  he1FetchNoMutex(
8620: 29 20 69 73 20 61 20 66 61 73 74 65 72 20 69 6d  ) is a faster im
8630: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 66 6f 72  plementation for
8640: 0a 2a 2a 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 63  .** the common c
8650: 61 73 65 20 77 68 65 72 65 20 70 47 72 6f 75 70  ase where pGroup
8660: 2d 3e 6d 75 74 65 78 20 69 73 20 4e 55 4c 4c 2e  ->mutex is NULL.
8670: 20 20 54 68 65 20 70 63 61 63 68 65 31 46 65 74    The pcache1Fet
8680: 63 68 28 29 20 77 72 61 70 70 65 72 0a 2a 2a 20  ch() wrapper.** 
8690: 69 6e 76 6f 6b 65 73 20 74 68 65 20 61 70 70 72  invokes the appr
86a0: 6f 70 72 69 61 74 65 20 72 6f 75 74 69 6e 65 2e  opriate routine.
86b0: 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67 48 64 72  .*/.static PgHdr
86c0: 31 20 2a 70 63 61 63 68 65 31 46 65 74 63 68 4e  1 *pcache1FetchN
86d0: 6f 4d 75 74 65 78 28 0a 20 20 73 71 6c 69 74 65  oMutex(.  sqlite
86e0: 33 5f 70 63 61 63 68 65 20 2a 70 2c 20 0a 20 20  3_pcache *p, .  
86f0: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4b 65  unsigned int iKe
8700: 79 2c 20 0a 20 20 69 6e 74 20 63 72 65 61 74 65  y, .  int create
8710: 46 6c 61 67 0a 29 7b 0a 20 20 50 43 61 63 68 65  Flag.){.  PCache
8720: 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61  1 *pCache = (PCa
8730: 63 68 65 31 20 2a 29 70 3b 0a 20 20 50 67 48 64  che1 *)p;.  PgHd
8740: 72 31 20 2a 70 50 61 67 65 20 3d 20 30 3b 0a 0a  r1 *pPage = 0;..
8750: 20 20 2f 2a 20 53 74 65 70 20 31 3a 20 53 65 61    /* Step 1: Sea
8760: 72 63 68 20 74 68 65 20 68 61 73 68 20 74 61 62  rch the hash tab
8770: 6c 65 20 66 6f 72 20 61 6e 20 65 78 69 73 74 69  le for an existi
8780: 6e 67 20 65 6e 74 72 79 2e 20 2a 2f 0a 20 20 70  ng entry. */.  p
8790: 50 61 67 65 20 3d 20 70 43 61 63 68 65 2d 3e 61  Page = pCache->a
87a0: 70 48 61 73 68 5b 69 4b 65 79 20 25 20 70 43 61  pHash[iKey % pCa
87b0: 63 68 65 2d 3e 6e 48 61 73 68 5d 3b 0a 20 20 77  che->nHash];.  w
87c0: 68 69 6c 65 28 20 70 50 61 67 65 20 26 26 20 70  hile( pPage && p
87d0: 50 61 67 65 2d 3e 69 4b 65 79 21 3d 69 4b 65 79  Page->iKey!=iKey
87e0: 20 29 7b 20 70 50 61 67 65 20 3d 20 70 50 61 67   ){ pPage = pPag
87f0: 65 2d 3e 70 4e 65 78 74 3b 20 7d 0a 0a 20 20 2f  e->pNext; }..  /
8800: 2a 20 53 74 65 70 20 32 3a 20 49 66 20 74 68 65  * Step 2: If the
8810: 20 70 61 67 65 20 77 61 73 20 66 6f 75 6e 64 20   page was found 
8820: 69 6e 20 74 68 65 20 68 61 73 68 20 74 61 62 6c  in the hash tabl
8830: 65 2c 20 74 68 65 6e 20 72 65 74 75 72 6e 20 69  e, then return i
8840: 74 2e 0a 20 20 2a 2a 20 49 66 20 74 68 65 20 70  t..  ** If the p
8850: 61 67 65 20 77 61 73 20 6e 6f 74 20 69 6e 20 74  age was not in t
8860: 68 65 20 68 61 73 68 20 74 61 62 6c 65 20 61 6e  he hash table an
8870: 64 20 63 72 65 61 74 65 46 6c 61 67 20 69 73 20  d createFlag is 
8880: 30 2c 20 61 62 6f 72 74 2e 0a 20 20 2a 2a 20 4f  0, abort..  ** O
8890: 74 68 65 72 77 69 73 65 20 28 70 61 67 65 20 6e  therwise (page n
88a0: 6f 74 20 69 6e 20 68 61 73 68 20 61 6e 64 20 63  ot in hash and c
88b0: 72 65 61 74 65 46 6c 61 67 21 3d 30 29 20 63 6f  reateFlag!=0) co
88c0: 6e 74 69 6e 75 65 20 77 69 74 68 0a 20 20 2a 2a  ntinue with.  **
88d0: 20 73 75 62 73 65 71 75 65 6e 74 20 73 74 65 70   subsequent step
88e0: 73 20 74 6f 20 74 72 79 20 74 6f 20 63 72 65 61  s to try to crea
88f0: 74 65 20 74 68 65 20 70 61 67 65 2e 20 2a 2f 0a  te the page. */.
8900: 20 20 69 66 28 20 70 50 61 67 65 20 29 7b 0a 20    if( pPage ){. 
8910: 20 20 20 69 66 28 20 50 41 47 45 5f 49 53 5f 55     if( PAGE_IS_U
8920: 4e 50 49 4e 4e 45 44 28 70 50 61 67 65 29 20 29  NPINNED(pPage) )
8930: 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 70  {.      return p
8940: 63 61 63 68 65 31 50 69 6e 50 61 67 65 28 70 50  cache1PinPage(pP
8950: 61 67 65 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b  age);.    }else{
8960: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 70 50  .      return pP
8970: 61 67 65 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c  age;.    }.  }el
8980: 73 65 20 69 66 28 20 63 72 65 61 74 65 46 6c 61  se if( createFla
8990: 67 20 29 7b 0a 20 20 20 20 2f 2a 20 53 74 65 70  g ){.    /* Step
89a0: 73 20 33 2c 20 34 2c 20 61 6e 64 20 35 20 69 6d  s 3, 4, and 5 im
89b0: 70 6c 65 6d 65 6e 74 65 64 20 62 79 20 74 68 69  plemented by thi
89c0: 73 20 73 75 62 72 6f 75 74 69 6e 65 20 2a 2f 0a  s subroutine */.
89d0: 20 20 20 20 72 65 74 75 72 6e 20 70 63 61 63 68      return pcach
89e0: 65 31 46 65 74 63 68 53 74 61 67 65 32 28 70 43  e1FetchStage2(pC
89f0: 61 63 68 65 2c 20 69 4b 65 79 2c 20 63 72 65 61  ache, iKey, crea
8a00: 74 65 46 6c 61 67 29 3b 0a 20 20 7d 65 6c 73 65  teFlag);.  }else
8a10: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a  {.    return 0;.
8a20: 20 20 7d 0a 7d 0a 23 69 66 20 50 43 41 43 48 45    }.}.#if PCACHE
8a30: 31 5f 4d 49 47 48 54 5f 55 53 45 5f 47 52 4f 55  1_MIGHT_USE_GROU
8a40: 50 5f 4d 55 54 45 58 0a 73 74 61 74 69 63 20 50  P_MUTEX.static P
8a50: 67 48 64 72 31 20 2a 70 63 61 63 68 65 31 46 65  gHdr1 *pcache1Fe
8a60: 74 63 68 57 69 74 68 4d 75 74 65 78 28 0a 20 20  tchWithMutex(.  
8a70: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a  sqlite3_pcache *
8a80: 70 2c 20 0a 20 20 75 6e 73 69 67 6e 65 64 20 69  p, .  unsigned i
8a90: 6e 74 20 69 4b 65 79 2c 20 0a 20 20 69 6e 74 20  nt iKey, .  int 
8aa0: 63 72 65 61 74 65 46 6c 61 67 0a 29 7b 0a 20 20  createFlag.){.  
8ab0: 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 20  PCache1 *pCache 
8ac0: 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b 0a  = (PCache1 *)p;.
8ad0: 20 20 50 67 48 64 72 31 20 2a 70 50 61 67 65 3b    PgHdr1 *pPage;
8ae0: 0a 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65 72  ..  pcache1Enter
8af0: 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47  Mutex(pCache->pG
8b00: 72 6f 75 70 29 3b 0a 20 20 70 50 61 67 65 20 3d  roup);.  pPage =
8b10: 20 70 63 61 63 68 65 31 46 65 74 63 68 4e 6f 4d   pcache1FetchNoM
8b20: 75 74 65 78 28 70 2c 20 69 4b 65 79 2c 20 63 72  utex(p, iKey, cr
8b30: 65 61 74 65 46 6c 61 67 29 3b 0a 20 20 61 73 73  eateFlag);.  ass
8b40: 65 72 74 28 20 70 50 61 67 65 3d 3d 30 20 7c 7c  ert( pPage==0 ||
8b50: 20 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79   pCache->iMaxKey
8b60: 3e 3d 69 4b 65 79 20 29 3b 0a 20 20 70 63 61 63  >=iKey );.  pcac
8b70: 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70 43  he1LeaveMutex(pC
8b80: 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 20  ache->pGroup);. 
8b90: 20 72 65 74 75 72 6e 20 70 50 61 67 65 3b 0a 7d   return pPage;.}
8ba0: 0a 23 65 6e 64 69 66 0a 73 74 61 74 69 63 20 73  .#endif.static s
8bb0: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 70 61  qlite3_pcache_pa
8bc0: 67 65 20 2a 70 63 61 63 68 65 31 46 65 74 63 68  ge *pcache1Fetch
8bd0: 28 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63  (.  sqlite3_pcac
8be0: 68 65 20 2a 70 2c 20 0a 20 20 75 6e 73 69 67 6e  he *p, .  unsign
8bf0: 65 64 20 69 6e 74 20 69 4b 65 79 2c 20 0a 20 20  ed int iKey, .  
8c00: 69 6e 74 20 63 72 65 61 74 65 46 6c 61 67 0a 29  int createFlag.)
8c10: 7b 0a 23 69 66 20 50 43 41 43 48 45 31 5f 4d 49  {.#if PCACHE1_MI
8c20: 47 48 54 5f 55 53 45 5f 47 52 4f 55 50 5f 4d 55  GHT_USE_GROUP_MU
8c30: 54 45 58 20 7c 7c 20 64 65 66 69 6e 65 64 28 53  TEX || defined(S
8c40: 51 4c 49 54 45 5f 44 45 42 55 47 29 0a 20 20 50  QLITE_DEBUG).  P
8c50: 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d  Cache1 *pCache =
8c60: 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b 0a 23   (PCache1 *)p;.#
8c70: 65 6e 64 69 66 0a 0a 20 20 61 73 73 65 72 74 28  endif..  assert(
8c80: 20 6f 66 66 73 65 74 6f 66 28 50 67 48 64 72 31   offsetof(PgHdr1
8c90: 2c 70 61 67 65 29 3d 3d 30 20 29 3b 0a 20 20 61  ,page)==0 );.  a
8ca0: 73 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 62  ssert( pCache->b
8cb0: 50 75 72 67 65 61 62 6c 65 20 7c 7c 20 63 72 65  Purgeable || cre
8cc0: 61 74 65 46 6c 61 67 21 3d 31 20 29 3b 0a 20 20  ateFlag!=1 );.  
8cd0: 61 73 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e  assert( pCache->
8ce0: 62 50 75 72 67 65 61 62 6c 65 20 7c 7c 20 70 43  bPurgeable || pC
8cf0: 61 63 68 65 2d 3e 6e 4d 69 6e 3d 3d 30 20 29 3b  ache->nMin==0 );
8d00: 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68  .  assert( pCach
8d10: 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 3d 3d 30  e->bPurgeable==0
8d20: 20 7c 7c 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e   || pCache->nMin
8d30: 3d 3d 31 30 20 29 3b 0a 20 20 61 73 73 65 72 74  ==10 );.  assert
8d40: 28 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 3d 3d  ( pCache->nMin==
8d50: 30 20 7c 7c 20 70 43 61 63 68 65 2d 3e 62 50 75  0 || pCache->bPu
8d60: 72 67 65 61 62 6c 65 20 29 3b 0a 20 20 61 73 73  rgeable );.  ass
8d70: 65 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 48 61  ert( pCache->nHa
8d80: 73 68 3e 30 20 29 3b 0a 23 69 66 20 50 43 41 43  sh>0 );.#if PCAC
8d90: 48 45 31 5f 4d 49 47 48 54 5f 55 53 45 5f 47 52  HE1_MIGHT_USE_GR
8da0: 4f 55 50 5f 4d 55 54 45 58 0a 20 20 69 66 28 20  OUP_MUTEX.  if( 
8db0: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e  pCache->pGroup->
8dc0: 6d 75 74 65 78 20 29 7b 0a 20 20 20 20 72 65 74  mutex ){.    ret
8dd0: 75 72 6e 20 28 73 71 6c 69 74 65 33 5f 70 63 61  urn (sqlite3_pca
8de0: 63 68 65 5f 70 61 67 65 2a 29 70 63 61 63 68 65  che_page*)pcache
8df0: 31 46 65 74 63 68 57 69 74 68 4d 75 74 65 78 28  1FetchWithMutex(
8e00: 70 2c 20 69 4b 65 79 2c 20 63 72 65 61 74 65 46  p, iKey, createF
8e10: 6c 61 67 29 3b 0a 20 20 7d 65 6c 73 65 0a 23 65  lag);.  }else.#e
8e20: 6e 64 69 66 0a 20 20 7b 0a 20 20 20 20 72 65 74  ndif.  {.    ret
8e30: 75 72 6e 20 28 73 71 6c 69 74 65 33 5f 70 63 61  urn (sqlite3_pca
8e40: 63 68 65 5f 70 61 67 65 2a 29 70 63 61 63 68 65  che_page*)pcache
8e50: 31 46 65 74 63 68 4e 6f 4d 75 74 65 78 28 70 2c  1FetchNoMutex(p,
8e60: 20 69 4b 65 79 2c 20 63 72 65 61 74 65 46 6c 61   iKey, createFla
8e70: 67 29 3b 0a 20 20 7d 0a 7d 0a 0a 0a 2f 2a 0a 2a  g);.  }.}.../*.*
8e80: 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  * Implementation
8e90: 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f   of the sqlite3_
8ea0: 70 63 61 63 68 65 2e 78 55 6e 70 69 6e 20 6d 65  pcache.xUnpin me
8eb0: 74 68 6f 64 2e 0a 2a 2a 0a 2a 2a 20 4d 61 72 6b  thod..**.** Mark
8ec0: 20 61 20 70 61 67 65 20 61 73 20 75 6e 70 69 6e   a page as unpin
8ed0: 6e 65 64 20 28 65 6c 69 67 69 62 6c 65 20 66 6f  ned (eligible fo
8ee0: 72 20 61 73 79 6e 63 68 72 6f 6e 6f 75 73 20 72  r asynchronous r
8ef0: 65 63 79 63 6c 69 6e 67 29 2e 0a 2a 2f 0a 73 74  ecycling)..*/.st
8f00: 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65  atic void pcache
8f10: 31 55 6e 70 69 6e 28 0a 20 20 73 71 6c 69 74 65  1Unpin(.  sqlite
8f20: 33 5f 70 63 61 63 68 65 20 2a 70 2c 20 0a 20 20  3_pcache *p, .  
8f30: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 70  sqlite3_pcache_p
8f40: 61 67 65 20 2a 70 50 67 2c 20 0a 20 20 69 6e 74  age *pPg, .  int
8f50: 20 72 65 75 73 65 55 6e 6c 69 6b 65 6c 79 0a 29   reuseUnlikely.)
8f60: 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61  {.  PCache1 *pCa
8f70: 63 68 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a  che = (PCache1 *
8f80: 29 70 3b 0a 20 20 50 67 48 64 72 31 20 2a 70 50  )p;.  PgHdr1 *pP
8f90: 61 67 65 20 3d 20 28 50 67 48 64 72 31 20 2a 29  age = (PgHdr1 *)
8fa0: 70 50 67 3b 0a 20 20 50 47 72 6f 75 70 20 2a 70  pPg;.  PGroup *p
8fb0: 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65 2d 3e  Group = pCache->
8fc0: 70 47 72 6f 75 70 3b 0a 20 0a 20 20 61 73 73 65  pGroup;. .  asse
8fd0: 72 74 28 20 70 50 61 67 65 2d 3e 70 43 61 63 68  rt( pPage->pCach
8fe0: 65 3d 3d 70 43 61 63 68 65 20 29 3b 0a 20 20 70  e==pCache );.  p
8ff0: 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78  cache1EnterMutex
9000: 28 70 47 72 6f 75 70 29 3b 0a 0a 20 20 2f 2a 20  (pGroup);..  /* 
9010: 49 74 20 69 73 20 61 6e 20 65 72 72 6f 72 20 74  It is an error t
9020: 6f 20 63 61 6c 6c 20 74 68 69 73 20 66 75 6e 63  o call this func
9030: 74 69 6f 6e 20 69 66 20 74 68 65 20 70 61 67 65  tion if the page
9040: 20 69 73 20 61 6c 72 65 61 64 79 20 0a 20 20 2a   is already .  *
9050: 2a 20 70 61 72 74 20 6f 66 20 74 68 65 20 50 47  * part of the PG
9060: 72 6f 75 70 20 4c 52 55 20 6c 69 73 74 2e 0a 20  roup LRU list.. 
9070: 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 50   */.  assert( pP
9080: 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74 3d 3d 30  age->pLruNext==0
9090: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 50 41   );.  assert( PA
90a0: 47 45 5f 49 53 5f 50 49 4e 4e 45 44 28 70 50 61  GE_IS_PINNED(pPa
90b0: 67 65 29 20 29 3b 0a 0a 20 20 69 66 28 20 72 65  ge) );..  if( re
90c0: 75 73 65 55 6e 6c 69 6b 65 6c 79 20 7c 7c 20 70  useUnlikely || p
90d0: 47 72 6f 75 70 2d 3e 6e 50 75 72 67 65 61 62 6c  Group->nPurgeabl
90e0: 65 3e 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61  e>pGroup->nMaxPa
90f0: 67 65 20 29 7b 0a 20 20 20 20 70 63 61 63 68 65  ge ){.    pcache
9100: 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73 68 28  1RemoveFromHash(
9110: 70 50 61 67 65 2c 20 31 29 3b 0a 20 20 7d 65 6c  pPage, 1);.  }el
9120: 73 65 7b 0a 20 20 20 20 2f 2a 20 41 64 64 20 74  se{.    /* Add t
9130: 68 65 20 70 61 67 65 20 74 6f 20 74 68 65 20 50  he page to the P
9140: 47 72 6f 75 70 20 4c 52 55 20 6c 69 73 74 2e 20  Group LRU list. 
9150: 2a 2f 0a 20 20 20 20 50 67 48 64 72 31 20 2a 2a  */.    PgHdr1 **
9160: 70 70 46 69 72 73 74 20 3d 20 26 70 47 72 6f 75  ppFirst = &pGrou
9170: 70 2d 3e 6c 72 75 2e 70 4c 72 75 4e 65 78 74 3b  p->lru.pLruNext;
9180: 0a 20 20 20 20 70 50 61 67 65 2d 3e 70 4c 72 75  .    pPage->pLru
9190: 50 72 65 76 20 3d 20 26 70 47 72 6f 75 70 2d 3e  Prev = &pGroup->
91a0: 6c 72 75 3b 0a 20 20 20 20 28 70 50 61 67 65 2d  lru;.    (pPage-
91b0: 3e 70 4c 72 75 4e 65 78 74 20 3d 20 2a 70 70 46  >pLruNext = *ppF
91c0: 69 72 73 74 29 2d 3e 70 4c 72 75 50 72 65 76 20  irst)->pLruPrev 
91d0: 3d 20 70 50 61 67 65 3b 0a 20 20 20 20 2a 70 70  = pPage;.    *pp
91e0: 46 69 72 73 74 20 3d 20 70 50 61 67 65 3b 0a 20  First = pPage;. 
91f0: 20 20 20 70 43 61 63 68 65 2d 3e 6e 52 65 63 79     pCache->nRecy
9200: 63 6c 61 62 6c 65 2b 2b 3b 0a 20 20 7d 0a 0a 20  clable++;.  }.. 
9210: 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74   pcache1LeaveMut
9220: 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75  ex(pCache->pGrou
9230: 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70  p);.}../*.** Imp
9240: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74  lementation of t
9250: 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68  he sqlite3_pcach
9260: 65 2e 78 52 65 6b 65 79 20 6d 65 74 68 6f 64 2e  e.xRekey method.
9270: 20 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64   .*/.static void
9280: 20 70 63 61 63 68 65 31 52 65 6b 65 79 28 0a 20   pcache1Rekey(. 
9290: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20   sqlite3_pcache 
92a0: 2a 70 2c 0a 20 20 73 71 6c 69 74 65 33 5f 70 63  *p,.  sqlite3_pc
92b0: 61 63 68 65 5f 70 61 67 65 20 2a 70 50 67 2c 0a  ache_page *pPg,.
92c0: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69    unsigned int i
92d0: 4f 6c 64 2c 0a 20 20 75 6e 73 69 67 6e 65 64 20  Old,.  unsigned 
92e0: 69 6e 74 20 69 4e 65 77 0a 29 7b 0a 20 20 50 43  int iNew.){.  PC
92f0: 61 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20  ache1 *pCache = 
9300: 28 50 43 61 63 68 65 31 20 2a 29 70 3b 0a 20 20  (PCache1 *)p;.  
9310: 50 67 48 64 72 31 20 2a 70 50 61 67 65 20 3d 20  PgHdr1 *pPage = 
9320: 28 50 67 48 64 72 31 20 2a 29 70 50 67 3b 0a 20  (PgHdr1 *)pPg;. 
9330: 20 50 67 48 64 72 31 20 2a 2a 70 70 3b 0a 20 20   PgHdr1 **pp;.  
9340: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 68 3b 20  unsigned int h; 
9350: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65  .  assert( pPage
9360: 2d 3e 69 4b 65 79 3d 3d 69 4f 6c 64 20 29 3b 0a  ->iKey==iOld );.
9370: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d    assert( pPage-
9380: 3e 70 43 61 63 68 65 3d 3d 70 43 61 63 68 65 20  >pCache==pCache 
9390: 29 3b 0a 0a 20 20 70 63 61 63 68 65 31 45 6e 74  );..  pcache1Ent
93a0: 65 72 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e  erMutex(pCache->
93b0: 70 47 72 6f 75 70 29 3b 0a 0a 20 20 68 20 3d 20  pGroup);..  h = 
93c0: 69 4f 6c 64 25 70 43 61 63 68 65 2d 3e 6e 48 61  iOld%pCache->nHa
93d0: 73 68 3b 0a 20 20 70 70 20 3d 20 26 70 43 61 63  sh;.  pp = &pCac
93e0: 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 3b 0a 20  he->apHash[h];. 
93f0: 20 77 68 69 6c 65 28 20 28 2a 70 70 29 21 3d 70   while( (*pp)!=p
9400: 50 61 67 65 20 29 7b 0a 20 20 20 20 70 70 20 3d  Page ){.    pp =
9410: 20 26 28 2a 70 70 29 2d 3e 70 4e 65 78 74 3b 0a   &(*pp)->pNext;.
9420: 20 20 7d 0a 20 20 2a 70 70 20 3d 20 70 50 61 67    }.  *pp = pPag
9430: 65 2d 3e 70 4e 65 78 74 3b 0a 0a 20 20 68 20 3d  e->pNext;..  h =
9440: 20 69 4e 65 77 25 70 43 61 63 68 65 2d 3e 6e 48   iNew%pCache->nH
9450: 61 73 68 3b 0a 20 20 70 50 61 67 65 2d 3e 69 4b  ash;.  pPage->iK
9460: 65 79 20 3d 20 69 4e 65 77 3b 0a 20 20 70 50 61  ey = iNew;.  pPa
9470: 67 65 2d 3e 70 4e 65 78 74 20 3d 20 70 43 61 63  ge->pNext = pCac
9480: 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 3b 0a 20  he->apHash[h];. 
9490: 20 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b   pCache->apHash[
94a0: 68 5d 20 3d 20 70 50 61 67 65 3b 0a 20 20 69 66  h] = pPage;.  if
94b0: 28 20 69 4e 65 77 3e 70 43 61 63 68 65 2d 3e 69  ( iNew>pCache->i
94c0: 4d 61 78 4b 65 79 20 29 7b 0a 20 20 20 20 70 43  MaxKey ){.    pC
94d0: 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 3d 20  ache->iMaxKey = 
94e0: 69 4e 65 77 3b 0a 20 20 7d 0a 0a 20 20 70 63 61  iNew;.  }..  pca
94f0: 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70  che1LeaveMutex(p
9500: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a  Cache->pGroup);.
9510: 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65  }../*.** Impleme
9520: 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73  ntation of the s
9530: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78 54  qlite3_pcache.xT
9540: 72 75 6e 63 61 74 65 20 6d 65 74 68 6f 64 2e 20  runcate method. 
9550: 0a 2a 2a 0a 2a 2a 20 44 69 73 63 61 72 64 20 61  .**.** Discard a
9560: 6c 6c 20 75 6e 70 69 6e 6e 65 64 20 70 61 67 65  ll unpinned page
9570: 73 20 69 6e 20 74 68 65 20 63 61 63 68 65 20 77  s in the cache w
9580: 69 74 68 20 61 20 70 61 67 65 20 6e 75 6d 62 65  ith a page numbe
9590: 72 20 65 71 75 61 6c 20 74 6f 0a 2a 2a 20 6f 72  r equal to.** or
95a0: 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 70 61   greater than pa
95b0: 72 61 6d 65 74 65 72 20 69 4c 69 6d 69 74 2e 20  rameter iLimit. 
95c0: 41 6e 79 20 70 69 6e 6e 65 64 20 70 61 67 65 73  Any pinned pages
95d0: 20 77 69 74 68 20 61 20 70 61 67 65 20 6e 75 6d   with a page num
95e0: 62 65 72 0a 2a 2a 20 65 71 75 61 6c 20 74 6f 20  ber.** equal to 
95f0: 6f 72 20 67 72 65 61 74 65 72 20 74 68 61 6e 20  or greater than 
9600: 69 4c 69 6d 69 74 20 61 72 65 20 69 6d 70 6c 69  iLimit are impli
9610: 63 69 74 6c 79 20 75 6e 70 69 6e 6e 65 64 2e 0a  citly unpinned..
9620: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70  */.static void p
9630: 63 61 63 68 65 31 54 72 75 6e 63 61 74 65 28 73  cache1Truncate(s
9640: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70  qlite3_pcache *p
9650: 2c 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69  , unsigned int i
9660: 4c 69 6d 69 74 29 7b 0a 20 20 50 43 61 63 68 65  Limit){.  PCache
9670: 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61  1 *pCache = (PCa
9680: 63 68 65 31 20 2a 29 70 3b 0a 20 20 70 63 61 63  che1 *)p;.  pcac
9690: 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70 43  he1EnterMutex(pC
96a0: 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 20  ache->pGroup);. 
96b0: 20 69 66 28 20 69 4c 69 6d 69 74 3c 3d 70 43 61   if( iLimit<=pCa
96c0: 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 29 7b 0a  che->iMaxKey ){.
96d0: 20 20 20 20 70 63 61 63 68 65 31 54 72 75 6e 63      pcache1Trunc
96e0: 61 74 65 55 6e 73 61 66 65 28 70 43 61 63 68 65  ateUnsafe(pCache
96f0: 2c 20 69 4c 69 6d 69 74 29 3b 0a 20 20 20 20 70  , iLimit);.    p
9700: 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 3d  Cache->iMaxKey =
9710: 20 69 4c 69 6d 69 74 2d 31 3b 0a 20 20 7d 0a 20   iLimit-1;.  }. 
9720: 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74   pcache1LeaveMut
9730: 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75  ex(pCache->pGrou
9740: 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70  p);.}../*.** Imp
9750: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74  lementation of t
9760: 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68  he sqlite3_pcach
9770: 65 2e 78 44 65 73 74 72 6f 79 20 6d 65 74 68 6f  e.xDestroy metho
9780: 64 2e 20 0a 2a 2a 0a 2a 2a 20 44 65 73 74 72 6f  d. .**.** Destro
9790: 79 20 61 20 63 61 63 68 65 20 61 6c 6c 6f 63 61  y a cache alloca
97a0: 74 65 64 20 75 73 69 6e 67 20 70 63 61 63 68 65  ted using pcache
97b0: 31 43 72 65 61 74 65 28 29 2e 0a 2a 2f 0a 73 74  1Create()..*/.st
97c0: 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65  atic void pcache
97d0: 31 44 65 73 74 72 6f 79 28 73 71 6c 69 74 65 33  1Destroy(sqlite3
97e0: 5f 70 63 61 63 68 65 20 2a 70 29 7b 0a 20 20 50  _pcache *p){.  P
97f0: 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d  Cache1 *pCache =
9800: 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b 0a 20   (PCache1 *)p;. 
9810: 20 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70 20   PGroup *pGroup 
9820: 3d 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70  = pCache->pGroup
9830: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63  ;.  assert( pCac
9840: 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 7c  he->bPurgeable |
9850: 7c 20 28 70 43 61 63 68 65 2d 3e 6e 4d 61 78 3d  | (pCache->nMax=
9860: 3d 30 20 26 26 20 70 43 61 63 68 65 2d 3e 6e 4d  =0 && pCache->nM
9870: 69 6e 3d 3d 30 29 20 29 3b 0a 20 20 70 63 61 63  in==0) );.  pcac
9880: 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70 47  he1EnterMutex(pG
9890: 72 6f 75 70 29 3b 0a 20 20 69 66 28 20 70 43 61  roup);.  if( pCa
98a0: 63 68 65 2d 3e 6e 50 61 67 65 20 29 20 70 63 61  che->nPage ) pca
98b0: 63 68 65 31 54 72 75 6e 63 61 74 65 55 6e 73 61  che1TruncateUnsa
98c0: 66 65 28 70 43 61 63 68 65 2c 20 30 29 3b 0a 20  fe(pCache, 0);. 
98d0: 20 61 73 73 65 72 74 28 20 70 47 72 6f 75 70 2d   assert( pGroup-
98e0: 3e 6e 4d 61 78 50 61 67 65 20 3e 3d 20 70 43 61  >nMaxPage >= pCa
98f0: 63 68 65 2d 3e 6e 4d 61 78 20 29 3b 0a 20 20 70  che->nMax );.  p
9900: 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20  Group->nMaxPage 
9910: 2d 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 3b  -= pCache->nMax;
9920: 0a 20 20 61 73 73 65 72 74 28 20 70 47 72 6f 75  .  assert( pGrou
9930: 70 2d 3e 6e 4d 69 6e 50 61 67 65 20 3e 3d 20 70  p->nMinPage >= p
9940: 43 61 63 68 65 2d 3e 6e 4d 69 6e 20 29 3b 0a 20  Cache->nMin );. 
9950: 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67   pGroup->nMinPag
9960: 65 20 2d 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 69  e -= pCache->nMi
9970: 6e 3b 0a 20 20 70 47 72 6f 75 70 2d 3e 6d 78 50  n;.  pGroup->mxP
9980: 69 6e 6e 65 64 20 3d 20 70 47 72 6f 75 70 2d 3e  inned = pGroup->
9990: 6e 4d 61 78 50 61 67 65 20 2b 20 31 30 20 2d 20  nMaxPage + 10 - 
99a0: 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65  pGroup->nMinPage
99b0: 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 66 6f 72  ;.  pcache1Enfor
99c0: 63 65 4d 61 78 50 61 67 65 28 70 43 61 63 68 65  ceMaxPage(pCache
99d0: 29 3b 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76  );.  pcache1Leav
99e0: 65 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a  eMutex(pGroup);.
99f0: 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70    sqlite3_free(p
9a00: 43 61 63 68 65 2d 3e 70 42 75 6c 6b 29 3b 0a 20  Cache->pBulk);. 
9a10: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 43   sqlite3_free(pC
9a20: 61 63 68 65 2d 3e 61 70 48 61 73 68 29 3b 0a 20  ache->apHash);. 
9a30: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 43   sqlite3_free(pC
9a40: 61 63 68 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  ache);.}../*.** 
9a50: 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73  This function is
9a60: 20 63 61 6c 6c 65 64 20 64 75 72 69 6e 67 20 69   called during i
9a70: 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 28 73  nitialization (s
9a80: 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a  qlite3_initializ
9a90: 65 28 29 29 20 74 6f 0a 2a 2a 20 69 6e 73 74 61  e()) to.** insta
9aa0: 6c 6c 20 74 68 65 20 64 65 66 61 75 6c 74 20 70  ll the default p
9ab0: 6c 75 67 67 61 62 6c 65 20 63 61 63 68 65 20 6d  luggable cache m
9ac0: 6f 64 75 6c 65 2c 20 61 73 73 75 6d 69 6e 67 20  odule, assuming 
9ad0: 74 68 65 20 75 73 65 72 20 68 61 73 20 6e 6f 74  the user has not
9ae0: 0a 2a 2a 20 61 6c 72 65 61 64 79 20 70 72 6f 76  .** already prov
9af0: 69 64 65 64 20 61 6e 20 61 6c 74 65 72 6e 61 74  ided an alternat
9b00: 69 76 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  ive..*/.void sql
9b10: 69 74 65 33 50 43 61 63 68 65 53 65 74 44 65 66  ite3PCacheSetDef
9b20: 61 75 6c 74 28 76 6f 69 64 29 7b 0a 20 20 73 74  ault(void){.  st
9b30: 61 74 69 63 20 63 6f 6e 73 74 20 73 71 6c 69 74  atic const sqlit
9b40: 65 33 5f 70 63 61 63 68 65 5f 6d 65 74 68 6f 64  e3_pcache_method
9b50: 73 32 20 64 65 66 61 75 6c 74 4d 65 74 68 6f 64  s2 defaultMethod
9b60: 73 20 3d 20 7b 0a 20 20 20 20 31 2c 20 20 20 20  s = {.    1,    
9b70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
9b80: 20 20 20 2f 2a 20 69 56 65 72 73 69 6f 6e 20 2a     /* iVersion *
9b90: 2f 0a 20 20 20 20 30 2c 20 20 20 20 20 20 20 20  /.    0,        
9ba0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
9bb0: 2a 20 70 41 72 67 20 2a 2f 0a 20 20 20 20 70 63  * pArg */.    pc
9bc0: 61 63 68 65 31 49 6e 69 74 2c 20 20 20 20 20 20  ache1Init,      
9bd0: 20 20 20 20 20 20 20 2f 2a 20 78 49 6e 69 74 20         /* xInit 
9be0: 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 53 68  */.    pcache1Sh
9bf0: 75 74 64 6f 77 6e 2c 20 20 20 20 20 20 20 20 20  utdown,         
9c00: 2f 2a 20 78 53 68 75 74 64 6f 77 6e 20 2a 2f 0a  /* xShutdown */.
9c10: 20 20 20 20 70 63 61 63 68 65 31 43 72 65 61 74      pcache1Creat
9c20: 65 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20  e,           /* 
9c30: 78 43 72 65 61 74 65 20 2a 2f 0a 20 20 20 20 70  xCreate */.    p
9c40: 63 61 63 68 65 31 43 61 63 68 65 73 69 7a 65 2c  cache1Cachesize,
9c50: 20 20 20 20 20 20 20 20 2f 2a 20 78 43 61 63 68          /* xCach
9c60: 65 73 69 7a 65 20 2a 2f 0a 20 20 20 20 70 63 61  esize */.    pca
9c70: 63 68 65 31 50 61 67 65 63 6f 75 6e 74 2c 20 20  che1Pagecount,  
9c80: 20 20 20 20 20 20 2f 2a 20 78 50 61 67 65 63 6f        /* xPageco
9c90: 75 6e 74 20 2a 2f 0a 20 20 20 20 70 63 61 63 68  unt */.    pcach
9ca0: 65 31 46 65 74 63 68 2c 20 20 20 20 20 20 20 20  e1Fetch,        
9cb0: 20 20 20 20 2f 2a 20 78 46 65 74 63 68 20 2a 2f      /* xFetch */
9cc0: 0a 20 20 20 20 70 63 61 63 68 65 31 55 6e 70 69  .    pcache1Unpi
9cd0: 6e 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  n,            /*
9ce0: 20 78 55 6e 70 69 6e 20 2a 2f 0a 20 20 20 20 70   xUnpin */.    p
9cf0: 63 61 63 68 65 31 52 65 6b 65 79 2c 20 20 20 20  cache1Rekey,    
9d00: 20 20 20 20 20 20 20 20 2f 2a 20 78 52 65 6b 65          /* xReke
9d10: 79 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31  y */.    pcache1
9d20: 54 72 75 6e 63 61 74 65 2c 20 20 20 20 20 20 20  Truncate,       
9d30: 20 20 2f 2a 20 78 54 72 75 6e 63 61 74 65 20 2a    /* xTruncate *
9d40: 2f 0a 20 20 20 20 70 63 61 63 68 65 31 44 65 73  /.    pcache1Des
9d50: 74 72 6f 79 2c 20 20 20 20 20 20 20 20 20 20 2f  troy,          /
9d60: 2a 20 78 44 65 73 74 72 6f 79 20 2a 2f 0a 20 20  * xDestroy */.  
9d70: 20 20 70 63 61 63 68 65 31 53 68 72 69 6e 6b 20    pcache1Shrink 
9d80: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 53             /* xS
9d90: 68 72 69 6e 6b 20 2a 2f 0a 20 20 7d 3b 0a 20 20  hrink */.  };.  
9da0: 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 53  sqlite3_config(S
9db0: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 43 41  QLITE_CONFIG_PCA
9dc0: 43 48 45 32 2c 20 26 64 65 66 61 75 6c 74 4d 65  CHE2, &defaultMe
9dd0: 74 68 6f 64 73 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  thods);.}../*.**
9de0: 20 52 65 74 75 72 6e 20 74 68 65 20 73 69 7a 65   Return the size
9df0: 20 6f 66 20 74 68 65 20 68 65 61 64 65 72 20 6f   of the header o
9e00: 6e 20 65 61 63 68 20 70 61 67 65 20 6f 66 20 74  n each page of t
9e10: 68 69 73 20 50 43 41 43 48 45 20 69 6d 70 6c 65  his PCACHE imple
9e20: 6d 65 6e 74 61 74 69 6f 6e 2e 0a 2a 2f 0a 69 6e  mentation..*/.in
9e30: 74 20 73 71 6c 69 74 65 33 48 65 61 64 65 72 53  t sqlite3HeaderS
9e40: 69 7a 65 50 63 61 63 68 65 31 28 76 6f 69 64 29  izePcache1(void)
9e50: 7b 20 72 65 74 75 72 6e 20 52 4f 55 4e 44 38 28  { return ROUND8(
9e60: 73 69 7a 65 6f 66 28 50 67 48 64 72 31 29 29 3b  sizeof(PgHdr1));
9e70: 20 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e   }../*.** Return
9e80: 20 74 68 65 20 67 6c 6f 62 61 6c 20 6d 75 74 65   the global mute
9e90: 78 20 75 73 65 64 20 62 79 20 74 68 69 73 20 50  x used by this P
9ea0: 43 41 43 48 45 20 69 6d 70 6c 65 6d 65 6e 74 61  CACHE implementa
9eb0: 74 69 6f 6e 2e 20 20 54 68 65 0a 2a 2a 20 73 71  tion.  The.** sq
9ec0: 6c 69 74 65 33 5f 73 74 61 74 75 73 28 29 20 72  lite3_status() r
9ed0: 6f 75 74 69 6e 65 20 6e 65 65 64 73 20 61 63 63  outine needs acc
9ee0: 65 73 73 20 74 6f 20 74 68 69 73 20 6d 75 74 65  ess to this mute
9ef0: 78 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f 6d 75  x..*/.sqlite3_mu
9f00: 74 65 78 20 2a 73 71 6c 69 74 65 33 50 63 61 63  tex *sqlite3Pcac
9f10: 68 65 31 4d 75 74 65 78 28 76 6f 69 64 29 7b 0a  he1Mutex(void){.
9f20: 20 20 72 65 74 75 72 6e 20 70 63 61 63 68 65 31    return pcache1
9f30: 2e 6d 75 74 65 78 3b 0a 7d 0a 0a 23 69 66 64 65  .mutex;.}..#ifde
9f40: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  f SQLITE_ENABLE_
9f50: 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e  MEMORY_MANAGEMEN
9f60: 54 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e  T./*.** This fun
9f70: 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20  ction is called 
9f80: 74 6f 20 66 72 65 65 20 73 75 70 65 72 66 6c 75  to free superflu
9f90: 6f 75 73 20 64 79 6e 61 6d 69 63 61 6c 6c 79 20  ous dynamically 
9fa0: 61 6c 6c 6f 63 61 74 65 64 20 6d 65 6d 6f 72 79  allocated memory
9fb0: 0a 2a 2a 20 68 65 6c 64 20 62 79 20 74 68 65 20  .** held by the 
9fc0: 70 61 67 65 72 20 73 79 73 74 65 6d 2e 20 4d 65  pager system. Me
9fd0: 6d 6f 72 79 20 69 6e 20 75 73 65 20 62 79 20 61  mory in use by a
9fe0: 6e 79 20 53 51 4c 69 74 65 20 70 61 67 65 72 20  ny SQLite pager 
9ff0: 61 6c 6c 6f 63 61 74 65 64 0a 2a 2a 20 62 79 20  allocated.** by 
a000: 74 68 65 20 63 75 72 72 65 6e 74 20 74 68 72 65  the current thre
a010: 61 64 20 6d 61 79 20 62 65 20 73 71 6c 69 74 65  ad may be sqlite
a020: 33 5f 66 72 65 65 28 29 65 64 2e 0a 2a 2a 0a 2a  3_free()ed..**.*
a030: 2a 20 6e 52 65 71 20 69 73 20 74 68 65 20 6e 75  * nReq is the nu
a040: 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f 66  mber of bytes of
a050: 20 6d 65 6d 6f 72 79 20 72 65 71 75 69 72 65 64   memory required
a060: 2e 20 4f 6e 63 65 20 74 68 69 73 20 6d 75 63 68  . Once this much
a070: 20 68 61 73 0a 2a 2a 20 62 65 65 6e 20 72 65 6c   has.** been rel
a080: 65 61 73 65 64 2c 20 74 68 65 20 66 75 6e 63 74  eased, the funct
a090: 69 6f 6e 20 72 65 74 75 72 6e 73 2e 20 54 68 65  ion returns. The
a0a0: 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 73   return value is
a0b0: 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65   the total numbe
a0c0: 72 20 0a 2a 2a 20 6f 66 20 62 79 74 65 73 20 6f  r .** of bytes o
a0d0: 66 20 6d 65 6d 6f 72 79 20 72 65 6c 65 61 73 65  f memory release
a0e0: 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  d..*/.int sqlite
a0f0: 33 50 63 61 63 68 65 52 65 6c 65 61 73 65 4d 65  3PcacheReleaseMe
a100: 6d 6f 72 79 28 69 6e 74 20 6e 52 65 71 29 7b 0a  mory(int nReq){.
a110: 20 20 69 6e 74 20 6e 46 72 65 65 20 3d 20 30 3b    int nFree = 0;
a120: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74  .  assert( sqlit
a130: 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c 64  e3_mutex_notheld
a140: 28 70 63 61 63 68 65 31 2e 67 72 70 2e 6d 75 74  (pcache1.grp.mut
a150: 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28  ex) );.  assert(
a160: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6e   sqlite3_mutex_n
a170: 6f 74 68 65 6c 64 28 70 63 61 63 68 65 31 2e 6d  otheld(pcache1.m
a180: 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 73  utex) );.  if( s
a190: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66  qlite3GlobalConf
a1a0: 69 67 2e 70 50 61 67 65 3d 3d 30 20 29 7b 0a 20  ig.pPage==0 ){. 
a1b0: 20 20 20 50 67 48 64 72 31 20 2a 70 3b 0a 20 20     PgHdr1 *p;.  
a1c0: 20 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75    pcache1EnterMu
a1d0: 74 65 78 28 26 70 63 61 63 68 65 31 2e 67 72 70  tex(&pcache1.grp
a1e0: 29 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 28 6e  );.    while( (n
a1f0: 52 65 71 3c 30 20 7c 7c 20 6e 46 72 65 65 3c 6e  Req<0 || nFree<n
a200: 52 65 71 29 0a 20 20 20 20 20 20 20 26 26 20 20  Req).       &&  
a210: 28 70 3d 70 63 61 63 68 65 31 2e 67 72 70 2e 6c  (p=pcache1.grp.l
a220: 72 75 2e 70 4c 72 75 50 72 65 76 29 21 3d 30 0a  ru.pLruPrev)!=0.
a230: 20 20 20 20 20 20 20 26 26 20 20 70 2d 3e 69 73         &&  p->is
a240: 41 6e 63 68 6f 72 3d 3d 30 0a 20 20 20 20 29 7b  Anchor==0.    ){
a250: 0a 20 20 20 20 20 20 6e 46 72 65 65 20 2b 3d 20  .      nFree += 
a260: 70 63 61 63 68 65 31 4d 65 6d 53 69 7a 65 28 70  pcache1MemSize(p
a270: 2d 3e 70 61 67 65 2e 70 42 75 66 29 3b 0a 23 69  ->page.pBuf);.#i
a280: 66 64 65 66 20 53 51 4c 49 54 45 5f 50 43 41 43  fdef SQLITE_PCAC
a290: 48 45 5f 53 45 50 41 52 41 54 45 5f 48 45 41 44  HE_SEPARATE_HEAD
a2a0: 45 52 0a 20 20 20 20 20 20 6e 46 72 65 65 20 2b  ER.      nFree +
a2b0: 3d 20 73 71 6c 69 74 65 33 4d 65 6d 53 69 7a 65  = sqlite3MemSize
a2c0: 28 70 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20  (p);.#endif.    
a2d0: 20 20 61 73 73 65 72 74 28 20 50 41 47 45 5f 49    assert( PAGE_I
a2e0: 53 5f 55 4e 50 49 4e 4e 45 44 28 70 29 20 29 3b  S_UNPINNED(p) );
a2f0: 0a 20 20 20 20 20 20 70 63 61 63 68 65 31 50 69  .      pcache1Pi
a300: 6e 50 61 67 65 28 70 29 3b 0a 20 20 20 20 20 20  nPage(p);.      
a310: 70 63 61 63 68 65 31 52 65 6d 6f 76 65 46 72 6f  pcache1RemoveFro
a320: 6d 48 61 73 68 28 70 2c 20 31 29 3b 0a 20 20 20  mHash(p, 1);.   
a330: 20 7d 0a 20 20 20 20 70 63 61 63 68 65 31 4c 65   }.    pcache1Le
a340: 61 76 65 4d 75 74 65 78 28 26 70 63 61 63 68 65  aveMutex(&pcache
a350: 31 2e 67 72 70 29 3b 0a 20 20 7d 0a 20 20 72 65  1.grp);.  }.  re
a360: 74 75 72 6e 20 6e 46 72 65 65 3b 0a 7d 0a 23 65  turn nFree;.}.#e
a370: 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45  ndif /* SQLITE_E
a380: 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e  NABLE_MEMORY_MAN
a390: 41 47 45 4d 45 4e 54 20 2a 2f 0a 0a 23 69 66 64  AGEMENT */..#ifd
a3a0: 65 66 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 2f  ef SQLITE_TEST./
a3b0: 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69  *.** This functi
a3c0: 6f 6e 20 69 73 20 75 73 65 64 20 62 79 20 74 65  on is used by te
a3d0: 73 74 20 70 72 6f 63 65 64 75 72 65 73 20 74 6f  st procedures to
a3e0: 20 69 6e 73 70 65 63 74 20 74 68 65 20 69 6e 74   inspect the int
a3f0: 65 72 6e 61 6c 20 73 74 61 74 65 0a 2a 2a 20 6f  ernal state.** o
a400: 66 20 74 68 65 20 67 6c 6f 62 61 6c 20 63 61 63  f the global cac
a410: 68 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  he..*/.void sqli
a420: 74 65 33 50 63 61 63 68 65 53 74 61 74 73 28 0a  te3PcacheStats(.
a430: 20 20 69 6e 74 20 2a 70 6e 43 75 72 72 65 6e 74    int *pnCurrent
a440: 2c 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 54  ,      /* OUT: T
a450: 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70  otal number of p
a460: 61 67 65 73 20 63 61 63 68 65 64 20 2a 2f 0a 20  ages cached */. 
a470: 20 69 6e 74 20 2a 70 6e 4d 61 78 2c 20 20 20 20   int *pnMax,    
a480: 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 47 6c        /* OUT: Gl
a490: 6f 62 61 6c 20 6d 61 78 69 6d 75 6d 20 63 61 63  obal maximum cac
a4a0: 68 65 20 73 69 7a 65 20 2a 2f 0a 20 20 69 6e 74  he size */.  int
a4b0: 20 2a 70 6e 4d 69 6e 2c 20 20 20 20 20 20 20 20   *pnMin,        
a4c0: 20 20 2f 2a 20 4f 55 54 3a 20 53 75 6d 20 6f 66    /* OUT: Sum of
a4d0: 20 50 43 61 63 68 65 31 2e 6e 4d 69 6e 20 66 6f   PCache1.nMin fo
a4e0: 72 20 70 75 72 67 65 61 62 6c 65 20 63 61 63 68  r purgeable cach
a4f0: 65 73 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 52  es */.  int *pnR
a500: 65 63 79 63 6c 61 62 6c 65 20 20 20 20 2f 2a 20  ecyclable    /* 
a510: 4f 55 54 3a 20 54 6f 74 61 6c 20 6e 75 6d 62 65  OUT: Total numbe
a520: 72 20 6f 66 20 70 61 67 65 73 20 61 76 61 69 6c  r of pages avail
a530: 61 62 6c 65 20 66 6f 72 20 72 65 63 79 63 6c 69  able for recycli
a540: 6e 67 20 2a 2f 0a 29 7b 0a 20 20 50 67 48 64 72  ng */.){.  PgHdr
a550: 31 20 2a 70 3b 0a 20 20 69 6e 74 20 6e 52 65 63  1 *p;.  int nRec
a560: 79 63 6c 61 62 6c 65 20 3d 20 30 3b 0a 20 20 66  yclable = 0;.  f
a570: 6f 72 28 70 3d 70 63 61 63 68 65 31 2e 67 72 70  or(p=pcache1.grp
a580: 2e 6c 72 75 2e 70 4c 72 75 4e 65 78 74 3b 20 70  .lru.pLruNext; p
a590: 20 26 26 20 21 70 2d 3e 69 73 41 6e 63 68 6f 72   && !p->isAnchor
a5a0: 3b 20 70 3d 70 2d 3e 70 4c 72 75 4e 65 78 74 29  ; p=p->pLruNext)
a5b0: 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 50 41  {.    assert( PA
a5c0: 47 45 5f 49 53 5f 55 4e 50 49 4e 4e 45 44 28 70  GE_IS_UNPINNED(p
a5d0: 29 20 29 3b 0a 20 20 20 20 6e 52 65 63 79 63 6c  ) );.    nRecycl
a5e0: 61 62 6c 65 2b 2b 3b 0a 20 20 7d 0a 20 20 2a 70  able++;.  }.  *p
a5f0: 6e 43 75 72 72 65 6e 74 20 3d 20 70 63 61 63 68  nCurrent = pcach
a600: 65 31 2e 67 72 70 2e 6e 50 75 72 67 65 61 62 6c  e1.grp.nPurgeabl
a610: 65 3b 0a 20 20 2a 70 6e 4d 61 78 20 3d 20 28 69  e;.  *pnMax = (i
a620: 6e 74 29 70 63 61 63 68 65 31 2e 67 72 70 2e 6e  nt)pcache1.grp.n
a630: 4d 61 78 50 61 67 65 3b 0a 20 20 2a 70 6e 4d 69  MaxPage;.  *pnMi
a640: 6e 20 3d 20 28 69 6e 74 29 70 63 61 63 68 65 31  n = (int)pcache1
a650: 2e 67 72 70 2e 6e 4d 69 6e 50 61 67 65 3b 0a 20  .grp.nMinPage;. 
a660: 20 2a 70 6e 52 65 63 79 63 6c 61 62 6c 65 20 3d   *pnRecyclable =
a670: 20 6e 52 65 63 79 63 6c 61 62 6c 65 3b 0a 7d 0a   nRecyclable;.}.
a680: 23 65 6e 64 69 66 0a                             #endif.