/ Hex Artifact Content
Login

Artifact e822007159d53a7ea7aa040d6e28964ddb6de083:


0000: 2f 2a 0a 2a 2a 20 32 30 30 38 20 4e 6f 76 65 6d  /*.** 2008 Novem
0010: 62 65 72 20 30 35 0a 2a 2a 0a 2a 2a 20 54 68 65  ber 05.**.** The
0020: 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 6d   author disclaim
0030: 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 74  s copyright to t
0040: 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 2e  his source code.
0050: 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a 2a    In place of.**
0060: 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 2c   a legal notice,
0070: 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 73   here is a bless
0080: 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61  ing:.**.**    Ma
0090: 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 6e  y you do good an
00a0: 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 20  d not evil..**  
00b0: 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 66    May you find f
00c0: 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 79  orgiveness for y
00d0: 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 67  ourself and forg
00e0: 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 20  ive others..**  
00f0: 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 20    May you share 
0100: 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 61  freely, never ta
0110: 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 79  king more than y
0120: 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a  ou give..**.****
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0170: 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 54 68 69 73  *****.**.** This
0180: 20 66 69 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 73   file implements
0190: 20 74 68 65 20 64 65 66 61 75 6c 74 20 70 61 67   the default pag
01a0: 65 20 63 61 63 68 65 20 69 6d 70 6c 65 6d 65 6e  e cache implemen
01b0: 74 61 74 69 6f 6e 20 28 74 68 65 0a 2a 2a 20 73  tation (the.** s
01c0: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 69 6e  qlite3_pcache in
01d0: 74 65 72 66 61 63 65 29 2e 20 49 74 20 61 6c 73  terface). It als
01e0: 6f 20 63 6f 6e 74 61 69 6e 73 20 70 61 72 74 20  o contains part 
01f0: 6f 66 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74  of the implement
0200: 61 74 69 6f 6e 0a 2a 2a 20 6f 66 20 74 68 65 20  ation.** of the 
0210: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41  SQLITE_CONFIG_PA
0220: 47 45 43 41 43 48 45 20 61 6e 64 20 73 71 6c 69  GECACHE and sqli
0230: 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f  te3_release_memo
0240: 72 79 28 29 20 66 65 61 74 75 72 65 73 2e 0a 2a  ry() features..*
0250: 2a 20 49 66 20 74 68 65 20 64 65 66 61 75 6c 74  * If the default
0260: 20 70 61 67 65 20 63 61 63 68 65 20 69 6d 70 6c   page cache impl
0270: 65 6d 65 6e 74 61 74 69 6f 6e 20 69 73 20 6f 76  ementation is ov
0280: 65 72 72 69 64 64 65 6e 2c 20 74 68 65 6e 20 6e  erridden, then n
0290: 65 69 74 68 65 72 20 6f 66 0a 2a 2a 20 74 68 65  either of.** the
02a0: 73 65 20 74 77 6f 20 66 65 61 74 75 72 65 73 20  se two features 
02b0: 61 72 65 20 61 76 61 69 6c 61 62 6c 65 2e 0a 2a  are available..*
02c0: 2a 0a 2a 2a 20 41 20 50 61 67 65 20 63 61 63 68  *.** A Page cach
02d0: 65 20 6c 69 6e 65 20 6c 6f 6f 6b 73 20 6c 69 6b  e line looks lik
02e0: 65 20 74 68 69 73 3a 0a 2a 2a 0a 2a 2a 20 20 2d  e this:.**.**  -
02f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0300: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0310: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0320: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 20  ------------.** 
0330: 20 7c 20 20 64 61 74 61 62 61 73 65 20 70 61 67   |  database pag
0340: 65 20 63 6f 6e 74 65 6e 74 20 20 20 7c 20 20 50  e content   |  P
0350: 67 48 64 72 31 20 20 7c 20 20 4d 65 6d 50 61 67  gHdr1  |  MemPag
0360: 65 20 20 7c 20 20 50 67 48 64 72 20 20 7c 0a 2a  e  |  PgHdr  |.*
0370: 2a 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  *  -------------
0380: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0390: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
03a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
03b0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 64 61 74 61 62  .**.** The datab
03c0: 61 73 65 20 70 61 67 65 20 63 6f 6e 74 65 6e 74  ase page content
03d0: 20 69 73 20 75 70 20 66 72 6f 6e 74 20 28 73 6f   is up front (so
03e0: 20 74 68 61 74 20 62 75 66 66 65 72 20 6f 76 65   that buffer ove
03f0: 72 72 65 61 64 73 20 74 65 6e 64 20 74 6f 0a 2a  rreads tend to.*
0400: 2a 20 66 6c 6f 77 20 68 61 72 6d 6c 65 73 73 6c  * flow harmlessl
0410: 79 20 69 6e 74 6f 20 74 68 65 20 50 67 48 64 72  y into the PgHdr
0420: 31 2c 20 4d 65 6d 50 61 67 65 2c 20 61 6e 64 20  1, MemPage, and 
0430: 50 67 48 64 72 20 65 78 74 65 6e 73 69 6f 6e 73  PgHdr extensions
0440: 29 2e 20 20 20 4d 65 6d 50 61 67 65 0a 2a 2a 20  ).   MemPage.** 
0450: 69 73 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e  is the extension
0460: 20 61 64 64 65 64 20 62 79 20 74 68 65 20 62 74   added by the bt
0470: 72 65 65 2e 63 20 6d 6f 64 75 6c 65 20 63 6f 6e  ree.c module con
0480: 74 61 69 6e 69 6e 67 20 69 6e 66 6f 72 6d 61 74  taining informat
0490: 69 6f 6e 20 73 75 63 68 0a 2a 2a 20 61 73 20 74  ion such.** as t
04a0: 68 65 20 64 61 74 61 62 61 73 65 20 70 61 67 65  he database page
04b0: 20 6e 75 6d 62 65 72 20 61 6e 64 20 68 6f 77 20   number and how 
04c0: 74 68 61 74 20 64 61 74 61 62 61 73 65 20 70 61  that database pa
04d0: 67 65 20 69 73 20 75 73 65 64 2e 20 20 50 67 48  ge is used.  PgH
04e0: 64 72 0a 2a 2a 20 69 73 20 61 64 64 65 64 20 62  dr.** is added b
04f0: 79 20 74 68 65 20 70 63 61 63 68 65 2e 63 20 6c  y the pcache.c l
0500: 61 79 65 72 20 61 6e 64 20 63 6f 6e 74 61 69 6e  ayer and contain
0510: 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 75 73  s information us
0520: 65 64 20 74 6f 20 6b 65 65 70 20 74 72 61 63 6b  ed to keep track
0530: 0a 2a 2a 20 6f 66 20 77 68 69 63 68 20 70 61 67  .** of which pag
0540: 65 73 20 61 72 65 20 22 64 69 72 74 79 22 2e 20  es are "dirty". 
0550: 20 50 67 48 64 72 31 20 69 73 20 61 6e 20 65 78   PgHdr1 is an ex
0560: 74 65 6e 73 69 6f 6e 20 61 64 64 65 64 20 62 79  tension added by
0570: 20 74 68 69 73 0a 2a 2a 20 6d 6f 64 75 6c 65 20   this.** module 
0580: 28 70 63 61 63 68 65 31 2e 63 29 2e 20 20 54 68  (pcache1.c).  Th
0590: 65 20 50 67 48 64 72 31 20 68 65 61 64 65 72 20  e PgHdr1 header 
05a0: 69 73 20 61 20 73 75 62 63 6c 61 73 73 20 6f 66  is a subclass of
05b0: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f   sqlite3_pcache_
05c0: 70 61 67 65 2e 0a 2a 2a 20 50 67 48 64 72 31 20  page..** PgHdr1 
05d0: 63 6f 6e 74 61 69 6e 73 20 69 6e 66 6f 72 6d 61  contains informa
05e0: 74 69 6f 6e 20 6e 65 65 64 65 64 20 74 6f 20 6c  tion needed to l
05f0: 6f 6f 6b 20 75 70 20 61 20 70 61 67 65 20 62 79  ook up a page by
0600: 20 69 74 73 20 70 61 67 65 20 6e 75 6d 62 65 72   its page number
0610: 2e 0a 2a 2a 20 54 68 65 20 73 75 70 65 72 63 6c  ..** The supercl
0620: 61 73 73 20 73 71 6c 69 74 65 33 5f 70 63 61 63  ass sqlite3_pcac
0630: 68 65 5f 70 61 67 65 2e 70 42 75 66 20 70 6f 69  he_page.pBuf poi
0640: 6e 74 73 20 74 6f 20 74 68 65 20 73 74 61 72 74  nts to the start
0650: 20 6f 66 20 74 68 65 0a 2a 2a 20 64 61 74 61 62   of the.** datab
0660: 61 73 65 20 70 61 67 65 20 63 6f 6e 74 65 6e 74  ase page content
0670: 20 61 6e 64 20 73 71 6c 69 74 65 33 5f 70 63 61   and sqlite3_pca
0680: 63 68 65 5f 70 61 67 65 2e 70 45 78 74 72 61 20  che_page.pExtra 
0690: 70 6f 69 6e 74 73 20 74 6f 20 50 67 48 64 72 2e  points to PgHdr.
06a0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 69 7a 65 20  .**.** The size 
06b0: 6f 66 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e  of the extension
06c0: 20 28 4d 65 6d 50 61 67 65 2b 50 67 48 64 72 2b   (MemPage+PgHdr+
06d0: 50 67 48 64 72 31 29 20 63 61 6e 20 62 65 20 64  PgHdr1) can be d
06e0: 65 74 65 72 6d 69 6e 65 64 20 61 74 0a 2a 2a 20  etermined at.** 
06f0: 72 75 6e 74 69 6d 65 20 75 73 69 6e 67 20 73 71  runtime using sq
0700: 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c  lite3_config(SQL
0710: 49 54 45 5f 43 4f 4e 46 49 47 5f 50 43 41 43 48  ITE_CONFIG_PCACH
0720: 45 5f 48 44 52 53 5a 2c 20 26 73 69 7a 65 29 2e  E_HDRSZ, &size).
0730: 20 20 54 68 65 0a 2a 2a 20 73 69 7a 65 73 20 6f    The.** sizes o
0740: 66 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e 73  f the extensions
0750: 20 73 75 6d 20 74 6f 20 32 37 32 20 62 79 74 65   sum to 272 byte
0760: 73 20 6f 6e 20 78 36 34 20 66 6f 72 20 33 2e 38  s on x64 for 3.8
0770: 2e 31 30 2c 20 62 75 74 20 74 68 69 73 0a 2a 2a  .10, but this.**
0780: 20 73 69 7a 65 20 63 61 6e 20 76 61 72 79 20 61   size can vary a
0790: 63 63 6f 72 64 69 6e 67 20 74 6f 20 61 72 63 68  ccording to arch
07a0: 69 74 65 63 74 75 72 65 2c 20 63 6f 6d 70 69 6c  itecture, compil
07b0: 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73 2c 20  e-time options, 
07c0: 61 6e 64 0a 2a 2a 20 53 51 4c 69 74 65 20 6c 69  and.** SQLite li
07d0: 62 72 61 72 79 20 76 65 72 73 69 6f 6e 20 6e 75  brary version nu
07e0: 6d 62 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 53  mber..**.** If S
07f0: 51 4c 49 54 45 5f 50 43 41 43 48 45 5f 53 45 50  QLITE_PCACHE_SEP
0800: 41 52 41 54 45 5f 48 45 41 44 45 52 20 69 73 20  ARATE_HEADER is 
0810: 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 74 68  defined, then th
0820: 65 20 65 78 74 65 6e 73 69 6f 6e 20 69 73 20 6f  e extension is o
0830: 62 74 61 69 6e 65 64 0a 2a 2a 20 75 73 69 6e 67  btained.** using
0840: 20 61 20 73 65 70 61 72 61 74 65 20 6d 65 6d 6f   a separate memo
0850: 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 66 72  ry allocation fr
0860: 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 20  om the database 
0870: 70 61 67 65 20 63 6f 6e 74 65 6e 74 2e 20 20 54  page content.  T
0880: 68 69 73 0a 2a 2a 20 73 65 65 6b 73 20 74 6f 20  his.** seeks to 
0890: 6f 76 65 72 63 6f 6d 65 20 74 68 65 20 22 63 6c  overcome the "cl
08a0: 6f 77 6e 73 68 6f 65 22 20 70 72 6f 62 6c 65 6d  ownshoe" problem
08b0: 20 28 61 6c 73 6f 20 63 61 6c 6c 65 64 20 22 69   (also called "i
08c0: 6e 74 65 72 6e 61 6c 0a 2a 2a 20 66 72 61 67 6d  nternal.** fragm
08d0: 65 6e 74 61 74 69 6f 6e 22 20 69 6e 20 61 63 61  entation" in aca
08e0: 64 65 6d 69 63 20 6c 69 74 65 72 61 74 75 72 65  demic literature
08f0: 29 20 6f 66 20 61 6c 6c 6f 63 61 74 69 6e 67 20  ) of allocating 
0900: 61 20 66 65 77 20 62 79 74 65 73 20 6d 6f 72 65  a few bytes more
0910: 0a 2a 2a 20 74 68 61 6e 20 61 20 70 6f 77 65 72  .** than a power
0920: 20 6f 66 20 74 77 6f 20 77 69 74 68 20 74 68 65   of two with the
0930: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f   memory allocato
0940: 72 20 72 6f 75 6e 64 69 6e 67 20 75 70 20 74 6f  r rounding up to
0950: 20 74 68 65 20 6e 65 78 74 0a 2a 2a 20 70 6f 77   the next.** pow
0960: 65 72 20 6f 66 20 74 77 6f 2c 20 61 6e 64 20 6c  er of two, and l
0970: 65 61 76 69 6e 67 20 74 68 65 20 72 6f 75 6e 64  eaving the round
0980: 65 64 2d 75 70 20 73 70 61 63 65 20 75 6e 75 73  ed-up space unus
0990: 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 6d  ed..**.** This m
09a0: 6f 64 75 6c 65 20 74 72 61 63 6b 73 20 70 6f 69  odule tracks poi
09b0: 6e 74 65 72 73 20 74 6f 20 50 67 48 64 72 31 20  nters to PgHdr1 
09c0: 6f 62 6a 65 63 74 73 2e 20 20 4f 6e 6c 79 20 70  objects.  Only p
09d0: 63 61 63 68 65 2e 63 20 63 6f 6d 6d 75 6e 69 63  cache.c communic
09e0: 61 74 65 73 0a 2a 2a 20 77 69 74 68 20 74 68 69  ates.** with thi
09f0: 73 20 6d 6f 64 75 6c 65 2e 20 20 49 6e 66 6f 72  s module.  Infor
0a00: 6d 61 74 69 6f 6e 20 69 73 20 70 61 73 73 65 64  mation is passed
0a10: 20 62 61 63 6b 20 61 6e 64 20 66 6f 72 74 68 20   back and forth 
0a20: 61 73 20 50 67 48 64 72 31 20 70 6f 69 6e 74 65  as PgHdr1 pointe
0a30: 72 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 63  rs..**.** The pc
0a40: 61 63 68 65 2e 63 20 61 6e 64 20 70 61 67 65 72  ache.c and pager
0a50: 2e 63 20 6d 6f 64 75 6c 65 73 20 64 65 61 6c 20  .c modules deal 
0a60: 70 6f 69 6e 74 65 72 73 20 74 6f 20 50 67 48 64  pointers to PgHd
0a70: 72 20 6f 62 6a 65 63 74 73 2e 0a 2a 2a 20 54 68  r objects..** Th
0a80: 65 20 62 74 72 65 65 2e 63 20 6d 6f 64 75 6c 65  e btree.c module
0a90: 20 64 65 61 6c 73 20 77 69 74 68 20 70 6f 69 6e   deals with poin
0aa0: 74 65 72 73 20 74 6f 20 4d 65 6d 50 61 67 65 20  ters to MemPage 
0ab0: 6f 62 6a 65 63 74 73 2e 0a 2a 2a 0a 2a 2a 20 53  objects..**.** S
0ac0: 4f 55 52 43 45 20 4f 46 20 50 41 47 45 20 43 41  OURCE OF PAGE CA
0ad0: 43 48 45 20 4d 45 4d 4f 52 59 3a 0a 2a 2a 0a 2a  CHE MEMORY:.**.*
0ae0: 2a 20 4d 65 6d 6f 72 79 20 66 6f 72 20 61 20 70  * Memory for a p
0af0: 61 67 65 20 6d 69 67 68 74 20 63 6f 6d 65 20 66  age might come f
0b00: 72 6f 6d 20 61 6e 79 20 6f 66 20 74 68 72 65 65  rom any of three
0b10: 20 73 6f 75 72 63 65 73 3a 0a 2a 2a 0a 2a 2a 20   sources:.**.** 
0b20: 20 20 20 28 31 29 20 20 54 68 65 20 67 65 6e 65     (1)  The gene
0b30: 72 61 6c 2d 70 75 72 70 6f 73 65 20 6d 65 6d 6f  ral-purpose memo
0b40: 72 79 20 61 6c 6c 6f 63 61 74 6f 72 20 2d 20 73  ry allocator - s
0b50: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 29 0a 2a  qlite3Malloc().*
0b60: 2a 20 20 20 20 28 32 29 20 20 47 6c 6f 62 61 6c  *    (2)  Global
0b70: 20 70 61 67 65 2d 63 61 63 68 65 20 6d 65 6d 6f   page-cache memo
0b80: 72 79 20 70 72 6f 76 69 64 65 64 20 75 73 69 6e  ry provided usin
0b90: 67 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67  g sqlite3_config
0ba0: 28 29 20 77 69 74 68 0a 2a 2a 20 20 20 20 20 20  () with.**      
0bb0: 20 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47     SQLITE_CONFIG
0bc0: 5f 50 41 47 45 43 41 43 48 45 2e 0a 2a 2a 20 20  _PAGECACHE..**  
0bd0: 20 20 28 33 29 20 20 50 43 61 63 68 65 2d 6c 6f    (3)  PCache-lo
0be0: 63 61 6c 20 62 75 6c 6b 20 61 6c 6c 6f 63 61 74  cal bulk allocat
0bf0: 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 74  ion..**.** The t
0c00: 68 69 72 64 20 63 61 73 65 20 69 73 20 61 20 63  hird case is a c
0c10: 68 75 6e 6b 20 6f 66 20 68 65 61 70 20 6d 65 6d  hunk of heap mem
0c20: 6f 72 79 20 28 64 65 66 61 75 6c 74 69 6e 67 20  ory (defaulting 
0c30: 74 6f 20 31 30 30 20 70 61 67 65 73 20 77 6f 72  to 100 pages wor
0c40: 74 68 29 0a 2a 2a 20 74 68 61 74 20 69 73 20 61  th).** that is a
0c50: 6c 6c 6f 63 61 74 65 64 20 77 68 65 6e 20 74 68  llocated when th
0c60: 65 20 70 61 67 65 20 63 61 63 68 65 20 69 73 20  e page cache is 
0c70: 63 72 65 61 74 65 64 2e 20 20 54 68 65 20 73 69  created.  The si
0c80: 7a 65 20 6f 66 20 74 68 65 20 6c 6f 63 61 6c 0a  ze of the local.
0c90: 2a 2a 20 62 75 6c 6b 20 61 6c 6c 6f 63 61 74 69  ** bulk allocati
0ca0: 6f 6e 20 63 61 6e 20 62 65 20 61 64 6a 75 73 74  on can be adjust
0cb0: 65 64 20 75 73 69 6e 67 20 0a 2a 2a 0a 2a 2a 20  ed using .**.** 
0cc0: 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66      sqlite3_conf
0cd0: 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47  ig(SQLITE_CONFIG
0ce0: 5f 50 41 47 45 43 41 43 48 45 2c 20 30 2c 20 30  _PAGECACHE, 0, 0
0cf0: 2c 20 4e 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 4e  , N)..**.** If N
0d00: 20 69 73 20 70 6f 73 69 74 69 76 65 2c 20 74 68   is positive, th
0d10: 65 6e 20 4e 20 70 61 67 65 73 20 77 6f 72 74 68  en N pages worth
0d20: 20 6f 66 20 6d 65 6d 6f 72 79 20 61 72 65 20 61   of memory are a
0d30: 6c 6c 6f 63 61 74 65 64 20 75 73 69 6e 67 20 61  llocated using a
0d40: 20 73 69 6e 67 6c 65 0a 2a 2a 20 73 71 6c 69 74   single.** sqlit
0d50: 65 33 4d 61 6c 6c 6f 63 28 29 20 63 61 6c 6c 20  e3Malloc() call 
0d60: 61 6e 64 20 74 68 61 74 20 6d 65 6d 6f 72 79 20  and that memory 
0d70: 69 73 20 75 73 65 64 20 66 6f 72 20 74 68 65 20  is used for the 
0d80: 66 69 72 73 74 20 4e 20 70 61 67 65 73 20 61 6c  first N pages al
0d90: 6c 6f 63 61 74 65 64 2e 0a 2a 2a 20 4f 72 20 69  located..** Or i
0da0: 66 20 4e 20 69 73 20 6e 65 67 61 74 69 76 65 2c  f N is negative,
0db0: 20 74 68 65 6e 20 2d 31 30 32 34 2a 4e 20 62 79   then -1024*N by
0dc0: 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79 20 61 72  tes of memory ar
0dd0: 65 20 61 6c 6c 6f 63 61 74 65 64 20 61 6e 64 20  e allocated and 
0de0: 75 73 65 64 0a 2a 2a 20 66 6f 72 20 61 73 20 6d  used.** for as m
0df0: 61 6e 79 20 70 61 67 65 73 20 61 73 20 63 61 6e  any pages as can
0e00: 20 62 65 20 61 63 63 6f 6d 6f 64 61 74 65 64 2e   be accomodated.
0e10: 0a 2a 2a 0a 2a 2a 20 4f 6e 6c 79 20 6f 6e 65 20  .**.** Only one 
0e20: 6f 66 20 28 32 29 20 6f 72 20 28 33 29 20 63 61  of (2) or (3) ca
0e30: 6e 20 62 65 20 75 73 65 64 2e 20 20 4f 6e 63 65  n be used.  Once
0e40: 20 74 68 65 20 6d 65 6d 6f 72 79 20 61 76 61 69   the memory avai
0e50: 6c 61 62 6c 65 20 74 6f 20 28 32 29 20 6f 72 0a  lable to (2) or.
0e60: 2a 2a 20 28 33 29 20 69 73 20 65 78 68 61 75 73  ** (3) is exhaus
0e70: 74 65 64 2c 20 73 75 62 73 65 71 75 65 6e 74 20  ted, subsequent 
0e80: 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 66 61 69 6c  allocations fail
0e90: 20 6f 76 65 72 20 74 6f 20 74 68 65 20 67 65 6e   over to the gen
0ea0: 65 72 61 6c 2d 70 75 72 70 6f 73 65 0a 2a 2a 20  eral-purpose.** 
0eb0: 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72  memory allocator
0ec0: 20 28 31 29 2e 0a 2a 2a 0a 2a 2a 20 45 61 72 6c   (1)..**.** Earl
0ed0: 69 65 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 20  ier versions of 
0ee0: 53 51 4c 69 74 65 20 75 73 65 64 20 6f 6e 6c 79  SQLite used only
0ef0: 20 6d 65 74 68 6f 64 73 20 28 31 29 20 61 6e 64   methods (1) and
0f00: 20 28 32 29 2e 20 20 42 75 74 20 65 78 70 65 72   (2).  But exper
0f10: 69 6d 65 6e 74 73 0a 2a 2a 20 73 68 6f 77 20 74  iments.** show t
0f20: 68 61 74 20 6d 65 74 68 6f 64 20 28 33 29 20 77  hat method (3) w
0f30: 69 74 68 20 4e 3d 3d 31 30 30 20 70 72 6f 76 69  ith N==100 provi
0f40: 64 65 73 20 61 62 6f 75 74 20 61 20 35 25 20 70  des about a 5% p
0f50: 65 72 66 6f 72 6d 61 6e 63 65 20 62 6f 6f 73 74  erformance boost
0f60: 20 66 6f 72 0a 2a 2a 20 63 6f 6d 6d 6f 6e 20 77   for.** common w
0f70: 6f 72 6b 6c 6f 61 64 73 2e 0a 2a 2f 0a 23 69 6e  orkloads..*/.#in
0f80: 63 6c 75 64 65 20 22 73 71 6c 69 74 65 49 6e 74  clude "sqliteInt
0f90: 2e 68 22 0a 0a 74 79 70 65 64 65 66 20 73 74 72  .h"..typedef str
0fa0: 75 63 74 20 50 43 61 63 68 65 31 20 50 43 61 63  uct PCache1 PCac
0fb0: 68 65 31 3b 0a 74 79 70 65 64 65 66 20 73 74 72  he1;.typedef str
0fc0: 75 63 74 20 50 67 48 64 72 31 20 50 67 48 64 72  uct PgHdr1 PgHdr
0fd0: 31 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63  1;.typedef struc
0fe0: 74 20 50 67 46 72 65 65 73 6c 6f 74 20 50 67 46  t PgFreeslot PgF
0ff0: 72 65 65 73 6c 6f 74 3b 0a 74 79 70 65 64 65 66  reeslot;.typedef
1000: 20 73 74 72 75 63 74 20 50 47 72 6f 75 70 20 50   struct PGroup P
1010: 47 72 6f 75 70 3b 0a 0a 2f 2a 0a 2a 2a 20 45 61  Group;../*.** Ea
1020: 63 68 20 63 61 63 68 65 20 65 6e 74 72 79 20 69  ch cache entry i
1030: 73 20 72 65 70 72 65 73 65 6e 74 65 64 20 62 79  s represented by
1040: 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20   an instance of 
1050: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 0a 2a  the following .*
1060: 2a 20 73 74 72 75 63 74 75 72 65 2e 20 55 6e 6c  * structure. Unl
1070: 65 73 73 20 53 51 4c 49 54 45 5f 50 43 41 43 48  ess SQLITE_PCACH
1080: 45 5f 53 45 50 41 52 41 54 45 5f 48 45 41 44 45  E_SEPARATE_HEADE
1090: 52 20 69 73 20 64 65 66 69 6e 65 64 2c 20 61 20  R is defined, a 
10a0: 62 75 66 66 65 72 20 6f 66 0a 2a 2a 20 50 67 48  buffer of.** PgH
10b0: 64 72 31 2e 70 43 61 63 68 65 2d 3e 73 7a 50 61  dr1.pCache->szPa
10c0: 67 65 20 62 79 74 65 73 20 69 73 20 61 6c 6c 6f  ge bytes is allo
10d0: 63 61 74 65 64 20 64 69 72 65 63 74 6c 79 20 62  cated directly b
10e0: 65 66 6f 72 65 20 74 68 69 73 20 73 74 72 75 63  efore this struc
10f0: 74 75 72 65 20 0a 2a 2a 20 69 6e 20 6d 65 6d 6f  ture .** in memo
1100: 72 79 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 50 67  ry..*/.struct Pg
1110: 48 64 72 31 20 7b 0a 20 20 73 71 6c 69 74 65 33  Hdr1 {.  sqlite3
1120: 5f 70 63 61 63 68 65 5f 70 61 67 65 20 70 61 67  _pcache_page pag
1130: 65 3b 20 20 20 20 20 20 2f 2a 20 42 61 73 65 20  e;      /* Base 
1140: 63 6c 61 73 73 2e 20 4d 75 73 74 20 62 65 20 66  class. Must be f
1150: 69 72 73 74 2e 20 70 42 75 66 20 26 20 70 45 78  irst. pBuf & pEx
1160: 74 72 61 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65  tra */.  unsigne
1170: 64 20 69 6e 74 20 69 4b 65 79 3b 20 20 20 20 20  d int iKey;     
1180: 20 20 20 20 20 20 20 20 2f 2a 20 4b 65 79 20 76          /* Key v
1190: 61 6c 75 65 20 28 70 61 67 65 20 6e 75 6d 62 65  alue (page numbe
11a0: 72 29 20 2a 2f 0a 20 20 75 38 20 69 73 50 69 6e  r) */.  u8 isPin
11b0: 6e 65 64 3b 20 20 20 20 20 20 20 20 20 20 20 20  ned;            
11c0: 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 69         /* Page i
11d0: 6e 20 75 73 65 2c 20 6e 6f 74 20 6f 6e 20 74 68  n use, not on th
11e0: 65 20 4c 52 55 20 6c 69 73 74 20 2a 2f 0a 20 20  e LRU list */.  
11f0: 75 38 20 69 73 42 75 6c 6b 4c 6f 63 61 6c 3b 20  u8 isBulkLocal; 
1200: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1210: 2a 20 54 68 69 73 20 70 61 67 65 20 66 72 6f 6d  * This page from
1220: 20 62 75 6c 6b 20 6c 6f 63 61 6c 20 73 74 6f 72   bulk local stor
1230: 61 67 65 20 2a 2f 0a 20 20 75 38 20 69 73 41 6e  age */.  u8 isAn
1240: 63 68 6f 72 3b 20 20 20 20 20 20 20 20 20 20 20  chor;           
1250: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20          /* This 
1260: 69 73 20 74 68 65 20 50 47 72 6f 75 70 2e 6c 72  is the PGroup.lr
1270: 75 20 65 6c 65 6d 65 6e 74 20 2a 2f 0a 20 20 50  u element */.  P
1280: 67 48 64 72 31 20 2a 70 4e 65 78 74 3b 20 20 20  gHdr1 *pNext;   
1290: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
12a0: 20 4e 65 78 74 20 69 6e 20 68 61 73 68 20 74 61   Next in hash ta
12b0: 62 6c 65 20 63 68 61 69 6e 20 2a 2f 0a 20 20 50  ble chain */.  P
12c0: 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 3b 20  Cache1 *pCache; 
12d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
12e0: 20 43 61 63 68 65 20 74 68 61 74 20 63 75 72 72   Cache that curr
12f0: 65 6e 74 6c 79 20 6f 77 6e 73 20 74 68 69 73 20  ently owns this 
1300: 70 61 67 65 20 2a 2f 0a 20 20 50 67 48 64 72 31  page */.  PgHdr1
1310: 20 2a 70 4c 72 75 4e 65 78 74 3b 20 20 20 20 20   *pLruNext;     
1320: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 74           /* Next
1330: 20 69 6e 20 4c 52 55 20 6c 69 73 74 20 6f 66 20   in LRU list of 
1340: 75 6e 70 69 6e 6e 65 64 20 70 61 67 65 73 20 2a  unpinned pages *
1350: 2f 0a 20 20 50 67 48 64 72 31 20 2a 70 4c 72 75  /.  PgHdr1 *pLru
1360: 50 72 65 76 3b 20 20 20 20 20 20 20 20 20 20 20  Prev;           
1370: 20 20 20 2f 2a 20 50 72 65 76 69 6f 75 73 20 69     /* Previous i
1380: 6e 20 4c 52 55 20 6c 69 73 74 20 6f 66 20 75 6e  n LRU list of un
1390: 70 69 6e 6e 65 64 20 70 61 67 65 73 20 2a 2f 0a  pinned pages */.
13a0: 7d 3b 0a 0a 2f 2a 20 45 61 63 68 20 70 61 67 65  };../* Each page
13b0: 20 63 61 63 68 65 20 28 6f 72 20 50 43 61 63 68   cache (or PCach
13c0: 65 29 20 62 65 6c 6f 6e 67 73 20 74 6f 20 61 20  e) belongs to a 
13d0: 50 47 72 6f 75 70 2e 20 20 41 20 50 47 72 6f 75  PGroup.  A PGrou
13e0: 70 20 69 73 20 61 20 73 65 74 20 0a 2a 2a 20 6f  p is a set .** o
13f0: 66 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 50 43  f one or more PC
1400: 61 63 68 65 73 20 74 68 61 74 20 61 72 65 20 61  aches that are a
1410: 62 6c 65 20 74 6f 20 72 65 63 79 63 6c 65 20 65  ble to recycle e
1420: 61 63 68 20 6f 74 68 65 72 27 73 20 75 6e 70 69  ach other's unpi
1430: 6e 6e 65 64 0a 2a 2a 20 70 61 67 65 73 20 77 68  nned.** pages wh
1440: 65 6e 20 74 68 65 79 20 61 72 65 20 75 6e 64 65  en they are unde
1450: 72 20 6d 65 6d 6f 72 79 20 70 72 65 73 73 75 72  r memory pressur
1460: 65 2e 20 20 41 20 50 47 72 6f 75 70 20 69 73 20  e.  A PGroup is 
1470: 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 0a 2a  an instance of.*
1480: 2a 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  * the following 
1490: 6f 62 6a 65 63 74 2e 0a 2a 2a 0a 2a 2a 20 54 68  object..**.** Th
14a0: 69 73 20 70 61 67 65 20 63 61 63 68 65 20 69 6d  is page cache im
14b0: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 77 6f 72  plementation wor
14c0: 6b 73 20 69 6e 20 6f 6e 65 20 6f 66 20 74 77 6f  ks in one of two
14d0: 20 6d 6f 64 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20   modes:.**.**   
14e0: 28 31 29 20 20 45 76 65 72 79 20 50 43 61 63 68  (1)  Every PCach
14f0: 65 20 69 73 20 74 68 65 20 73 6f 6c 65 20 6d 65  e is the sole me
1500: 6d 62 65 72 20 6f 66 20 69 74 73 20 6f 77 6e 20  mber of its own 
1510: 50 47 72 6f 75 70 2e 20 20 54 68 65 72 65 20 69  PGroup.  There i
1520: 73 0a 2a 2a 20 20 20 20 20 20 20 20 6f 6e 65 20  s.**        one 
1530: 50 47 72 6f 75 70 20 70 65 72 20 50 43 61 63 68  PGroup per PCach
1540: 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 28 32 29 20 20  e..**.**   (2)  
1550: 54 68 65 72 65 20 69 73 20 61 20 73 69 6e 67 6c  There is a singl
1560: 65 20 67 6c 6f 62 61 6c 20 50 47 72 6f 75 70 20  e global PGroup 
1570: 74 68 61 74 20 61 6c 6c 20 50 43 61 63 68 65 73  that all PCaches
1580: 20 61 72 65 20 61 20 6d 65 6d 62 65 72 0a 2a 2a   are a member.**
1590: 20 20 20 20 20 20 20 20 6f 66 2e 0a 2a 2a 0a 2a          of..**.*
15a0: 2a 20 4d 6f 64 65 20 31 20 75 73 65 73 20 6d 6f  * Mode 1 uses mo
15b0: 72 65 20 6d 65 6d 6f 72 79 20 28 73 69 6e 63 65  re memory (since
15c0: 20 50 43 61 63 68 65 20 69 6e 73 74 61 6e 63 65   PCache instance
15d0: 73 20 61 72 65 20 6e 6f 74 20 61 62 6c 65 20 74  s are not able t
15e0: 6f 20 72 6f 62 0a 2a 2a 20 75 6e 75 73 65 64 20  o rob.** unused 
15f0: 70 61 67 65 73 20 66 72 6f 6d 20 6f 74 68 65 72  pages from other
1600: 20 50 43 61 63 68 65 73 29 20 62 75 74 20 69 74   PCaches) but it
1610: 20 61 6c 73 6f 20 6f 70 65 72 61 74 65 73 20 77   also operates w
1620: 69 74 68 6f 75 74 20 61 20 6d 75 74 65 78 2c 0a  ithout a mutex,.
1630: 2a 2a 20 61 6e 64 20 69 73 20 74 68 65 72 65 66  ** and is theref
1640: 6f 72 65 20 6f 66 74 65 6e 20 66 61 73 74 65 72  ore often faster
1650: 2e 20 20 4d 6f 64 65 20 32 20 72 65 71 75 69 72  .  Mode 2 requir
1660: 65 73 20 61 20 6d 75 74 65 78 20 69 6e 20 6f 72  es a mutex in or
1670: 64 65 72 20 74 6f 20 62 65 0a 2a 2a 20 74 68 72  der to be.** thr
1680: 65 61 64 73 61 66 65 2c 20 62 75 74 20 72 65 63  eadsafe, but rec
1690: 79 63 6c 65 73 20 70 61 67 65 73 20 6d 6f 72 65  ycles pages more
16a0: 20 65 66 66 69 63 69 65 6e 74 6c 79 2e 0a 2a 2a   efficiently..**
16b0: 0a 2a 2a 20 46 6f 72 20 6d 6f 64 65 20 28 31 29  .** For mode (1)
16c0: 2c 20 50 47 72 6f 75 70 2e 6d 75 74 65 78 20 69  , PGroup.mutex i
16d0: 73 20 4e 55 4c 4c 2e 20 20 46 6f 72 20 6d 6f 64  s NULL.  For mod
16e0: 65 20 28 32 29 20 74 68 65 72 65 20 69 73 20 6f  e (2) there is o
16f0: 6e 6c 79 20 61 20 73 69 6e 67 6c 65 0a 2a 2a 20  nly a single.** 
1700: 50 47 72 6f 75 70 20 77 68 69 63 68 20 69 73 20  PGroup which is 
1710: 74 68 65 20 70 63 61 63 68 65 31 2e 67 72 70 20  the pcache1.grp 
1720: 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 20  global variable 
1730: 61 6e 64 20 69 74 73 20 6d 75 74 65 78 20 69 73  and its mutex is
1740: 0a 2a 2a 20 53 51 4c 49 54 45 5f 4d 55 54 45 58  .** SQLITE_MUTEX
1750: 5f 53 54 41 54 49 43 5f 4c 52 55 2e 0a 2a 2f 0a  _STATIC_LRU..*/.
1760: 73 74 72 75 63 74 20 50 47 72 6f 75 70 20 7b 0a  struct PGroup {.
1770: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20    sqlite3_mutex 
1780: 2a 6d 75 74 65 78 3b 20 20 20 20 20 20 20 20 20  *mutex;         
1790: 20 2f 2a 20 4d 55 54 45 58 5f 53 54 41 54 49 43   /* MUTEX_STATIC
17a0: 5f 4c 52 55 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a  _LRU or NULL */.
17b0: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e    unsigned int n
17c0: 4d 61 78 50 61 67 65 3b 20 20 20 20 20 20 20 20  MaxPage;        
17d0: 20 2f 2a 20 53 75 6d 20 6f 66 20 6e 4d 61 78 20   /* Sum of nMax 
17e0: 66 6f 72 20 70 75 72 67 65 61 62 6c 65 20 63 61  for purgeable ca
17f0: 63 68 65 73 20 2a 2f 0a 20 20 75 6e 73 69 67 6e  ches */.  unsign
1800: 65 64 20 69 6e 74 20 6e 4d 69 6e 50 61 67 65 3b  ed int nMinPage;
1810: 20 20 20 20 20 20 20 20 20 2f 2a 20 53 75 6d 20           /* Sum 
1820: 6f 66 20 6e 4d 69 6e 20 66 6f 72 20 70 75 72 67  of nMin for purg
1830: 65 61 62 6c 65 20 63 61 63 68 65 73 20 2a 2f 0a  eable caches */.
1840: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6d    unsigned int m
1850: 78 50 69 6e 6e 65 64 3b 20 20 20 20 20 20 20 20  xPinned;        
1860: 20 2f 2a 20 6e 4d 61 78 70 61 67 65 20 2b 20 31   /* nMaxpage + 1
1870: 30 20 2d 20 6e 4d 69 6e 50 61 67 65 20 2a 2f 0a  0 - nMinPage */.
1880: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e    unsigned int n
1890: 43 75 72 72 65 6e 74 50 61 67 65 3b 20 20 20 20  CurrentPage;    
18a0: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 75   /* Number of pu
18b0: 72 67 65 61 62 6c 65 20 70 61 67 65 73 20 61 6c  rgeable pages al
18c0: 6c 6f 63 61 74 65 64 20 2a 2f 0a 20 20 50 67 48  located */.  PgH
18d0: 64 72 31 20 6c 72 75 3b 20 20 20 20 20 20 20 20  dr1 lru;        
18e0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
18f0: 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 61 6e 64  he beginning and
1900: 20 65 6e 64 20 6f 66 20 74 68 65 20 4c 52 55 20   end of the LRU 
1910: 6c 69 73 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 45  list */.};../* E
1920: 61 63 68 20 70 61 67 65 20 63 61 63 68 65 20 69  ach page cache i
1930: 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66  s an instance of
1940: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f   the following o
1950: 62 6a 65 63 74 2e 20 20 45 76 65 72 79 0a 2a 2a  bject.  Every.**
1960: 20 6f 70 65 6e 20 64 61 74 61 62 61 73 65 20 66   open database f
1970: 69 6c 65 20 28 69 6e 63 6c 75 64 69 6e 67 20 65  ile (including e
1980: 61 63 68 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61  ach in-memory da
1990: 74 61 62 61 73 65 20 61 6e 64 20 65 61 63 68 0a  tabase and each.
19a0: 2a 2a 20 74 65 6d 70 6f 72 61 72 79 20 6f 72 20  ** temporary or 
19b0: 74 72 61 6e 73 69 65 6e 74 20 64 61 74 61 62 61  transient databa
19c0: 73 65 29 20 68 61 73 20 61 20 73 69 6e 67 6c 65  se) has a single
19d0: 20 70 61 67 65 20 63 61 63 68 65 20 77 68 69 63   page cache whic
19e0: 68 0a 2a 2a 20 69 73 20 61 6e 20 69 6e 73 74 61  h.** is an insta
19f0: 6e 63 65 20 6f 66 20 74 68 69 73 20 6f 62 6a 65  nce of this obje
1a00: 63 74 2e 0a 2a 2a 0a 2a 2a 20 50 6f 69 6e 74 65  ct..**.** Pointe
1a10: 72 73 20 74 6f 20 73 74 72 75 63 74 75 72 65 73  rs to structures
1a20: 20 6f 66 20 74 68 69 73 20 74 79 70 65 20 61 72   of this type ar
1a30: 65 20 63 61 73 74 20 61 6e 64 20 72 65 74 75 72  e cast and retur
1a40: 6e 65 64 20 61 73 20 0a 2a 2a 20 6f 70 61 71 75  ned as .** opaqu
1a50: 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  e sqlite3_pcache
1a60: 2a 20 68 61 6e 64 6c 65 73 2e 0a 2a 2f 0a 73 74  * handles..*/.st
1a70: 72 75 63 74 20 50 43 61 63 68 65 31 20 7b 0a 20  ruct PCache1 {. 
1a80: 20 2f 2a 20 43 61 63 68 65 20 63 6f 6e 66 69 67   /* Cache config
1a90: 75 72 61 74 69 6f 6e 20 70 61 72 61 6d 65 74 65  uration paramete
1aa0: 72 73 2e 20 50 61 67 65 20 73 69 7a 65 20 28 73  rs. Page size (s
1ab0: 7a 50 61 67 65 29 20 61 6e 64 20 74 68 65 20 70  zPage) and the p
1ac0: 75 72 67 65 61 62 6c 65 0a 20 20 2a 2a 20 66 6c  urgeable.  ** fl
1ad0: 61 67 20 28 62 50 75 72 67 65 61 62 6c 65 29 20  ag (bPurgeable) 
1ae0: 61 72 65 20 73 65 74 20 77 68 65 6e 20 74 68 65  are set when the
1af0: 20 63 61 63 68 65 20 69 73 20 63 72 65 61 74 65   cache is create
1b00: 64 2e 20 6e 4d 61 78 20 6d 61 79 20 62 65 20 0a  d. nMax may be .
1b10: 20 20 2a 2a 20 6d 6f 64 69 66 69 65 64 20 61 74    ** modified at
1b20: 20 61 6e 79 20 74 69 6d 65 20 62 79 20 61 20 63   any time by a c
1b30: 61 6c 6c 20 74 6f 20 74 68 65 20 70 63 61 63 68  all to the pcach
1b40: 65 31 43 61 63 68 65 73 69 7a 65 28 29 20 6d 65  e1Cachesize() me
1b50: 74 68 6f 64 2e 0a 20 20 2a 2a 20 54 68 65 20 50  thod..  ** The P
1b60: 47 72 6f 75 70 20 6d 75 74 65 78 20 6d 75 73 74  Group mutex must
1b70: 20 62 65 20 68 65 6c 64 20 77 68 65 6e 20 61 63   be held when ac
1b80: 63 65 73 73 69 6e 67 20 6e 4d 61 78 2e 0a 20 20  cessing nMax..  
1b90: 2a 2f 0a 20 20 50 47 72 6f 75 70 20 2a 70 47 72  */.  PGroup *pGr
1ba0: 6f 75 70 3b 20 20 20 20 20 20 20 20 20 20 20 20  oup;            
1bb0: 20 20 20 20 20 20 20 20 20 2f 2a 20 50 47 72 6f           /* PGro
1bc0: 75 70 20 74 68 69 73 20 63 61 63 68 65 20 62 65  up this cache be
1bd0: 6c 6f 6e 67 73 20 74 6f 20 2a 2f 0a 20 20 69 6e  longs to */.  in
1be0: 74 20 73 7a 50 61 67 65 3b 20 20 20 20 20 20 20  t szPage;       
1bf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1c00: 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 64 61 74    /* Size of dat
1c10: 61 62 61 73 65 20 63 6f 6e 74 65 6e 74 20 73 65  abase content se
1c20: 63 74 69 6f 6e 20 2a 2f 0a 20 20 69 6e 74 20 73  ction */.  int s
1c30: 7a 45 78 74 72 61 3b 20 20 20 20 20 20 20 20 20  zExtra;         
1c40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1c50: 2a 20 73 69 7a 65 6f 66 28 4d 65 6d 50 61 67 65  * sizeof(MemPage
1c60: 29 2b 73 69 7a 65 6f 66 28 50 67 48 64 72 29 20  )+sizeof(PgHdr) 
1c70: 2a 2f 0a 20 20 69 6e 74 20 73 7a 41 6c 6c 6f 63  */.  int szAlloc
1c80: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
1c90: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 6f 74 61           /* Tota
1ca0: 6c 20 73 69 7a 65 20 6f 66 20 6f 6e 65 20 70 63  l size of one pc
1cb0: 61 63 68 65 20 6c 69 6e 65 20 2a 2f 0a 20 20 69  ache line */.  i
1cc0: 6e 74 20 62 50 75 72 67 65 61 62 6c 65 3b 20 20  nt bPurgeable;  
1cd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1ce0: 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 63 61     /* True if ca
1cf0: 63 68 65 20 69 73 20 70 75 72 67 65 61 62 6c 65  che is purgeable
1d00: 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69   */.  unsigned i
1d10: 6e 74 20 6e 4d 69 6e 3b 20 20 20 20 20 20 20 20  nt nMin;        
1d20: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 69 6e            /* Min
1d30: 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 70  imum number of p
1d40: 61 67 65 73 20 72 65 73 65 72 76 65 64 20 2a 2f  ages reserved */
1d50: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
1d60: 6e 4d 61 78 3b 20 20 20 20 20 20 20 20 20 20 20  nMax;           
1d70: 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 66 69 67         /* Config
1d80: 75 72 65 64 20 22 63 61 63 68 65 5f 73 69 7a 65  ured "cache_size
1d90: 22 20 76 61 6c 75 65 20 2a 2f 0a 20 20 75 6e 73  " value */.  uns
1da0: 69 67 6e 65 64 20 69 6e 74 20 6e 39 30 70 63 74  igned int n90pct
1db0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
1dc0: 20 2f 2a 20 6e 4d 61 78 2a 39 2f 31 30 20 2a 2f   /* nMax*9/10 */
1dd0: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
1de0: 69 4d 61 78 4b 65 79 3b 20 20 20 20 20 20 20 20  iMaxKey;        
1df0: 20 20 20 20 20 20 20 2f 2a 20 4c 61 72 67 65 73         /* Larges
1e00: 74 20 6b 65 79 20 73 65 65 6e 20 73 69 6e 63 65  t key seen since
1e10: 20 78 54 72 75 6e 63 61 74 65 28 29 20 2a 2f 0a   xTruncate() */.
1e20: 0a 20 20 2f 2a 20 48 61 73 68 20 74 61 62 6c 65  .  /* Hash table
1e30: 20 6f 66 20 61 6c 6c 20 70 61 67 65 73 2e 20 54   of all pages. T
1e40: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 76 61 72  he following var
1e50: 69 61 62 6c 65 73 20 6d 61 79 20 6f 6e 6c 79 20  iables may only 
1e60: 62 65 20 61 63 63 65 73 73 65 64 0a 20 20 2a 2a  be accessed.  **
1e70: 20 77 68 65 6e 20 74 68 65 20 61 63 63 65 73 73   when the access
1e80: 6f 72 20 69 73 20 68 6f 6c 64 69 6e 67 20 74 68  or is holding th
1e90: 65 20 50 47 72 6f 75 70 20 6d 75 74 65 78 2e 0a  e PGroup mutex..
1ea0: 20 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20    */.  unsigned 
1eb0: 69 6e 74 20 6e 52 65 63 79 63 6c 61 62 6c 65 3b  int nRecyclable;
1ec0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75             /* Nu
1ed0: 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e  mber of pages in
1ee0: 20 74 68 65 20 4c 52 55 20 6c 69 73 74 20 2a 2f   the LRU list */
1ef0: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
1f00: 6e 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 20  nPage;          
1f10: 20 20 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20         /* Total 
1f20: 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20  number of pages 
1f30: 69 6e 20 61 70 48 61 73 68 20 2a 2f 0a 20 20 75  in apHash */.  u
1f40: 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 48 61 73  nsigned int nHas
1f50: 68 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  h;              
1f60: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20     /* Number of 
1f70: 73 6c 6f 74 73 20 69 6e 20 61 70 48 61 73 68 5b  slots in apHash[
1f80: 5d 20 2a 2f 0a 20 20 50 67 48 64 72 31 20 2a 2a  ] */.  PgHdr1 **
1f90: 61 70 48 61 73 68 3b 20 20 20 20 20 20 20 20 20  apHash;         
1fa0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 48 61             /* Ha
1fb0: 73 68 20 74 61 62 6c 65 20 66 6f 72 20 66 61 73  sh table for fas
1fc0: 74 20 6c 6f 6f 6b 75 70 20 62 79 20 6b 65 79 20  t lookup by key 
1fd0: 2a 2f 0a 20 20 50 67 48 64 72 31 20 2a 70 46 72  */.  PgHdr1 *pFr
1fe0: 65 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  ee;             
1ff0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 74           /* List
2000: 20 6f 66 20 75 6e 75 73 65 64 20 70 63 61 63 68   of unused pcach
2010: 65 2d 6c 6f 63 61 6c 20 70 61 67 65 73 20 2a 2f  e-local pages */
2020: 0a 20 20 76 6f 69 64 20 2a 70 42 75 6c 6b 3b 20  .  void *pBulk; 
2030: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2040: 20 20 20 20 20 20 20 2f 2a 20 42 75 6c 6b 20 6d         /* Bulk m
2050: 65 6d 6f 72 79 20 75 73 65 64 20 62 79 20 70 63  emory used by pc
2060: 61 63 68 65 2d 6c 6f 63 61 6c 20 2a 2f 0a 7d 3b  ache-local */.};
2070: 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 73 6c 6f  ../*.** Free slo
2080: 74 73 20 69 6e 20 74 68 65 20 61 6c 6c 6f 63 61  ts in the alloca
2090: 74 6f 72 20 75 73 65 64 20 74 6f 20 64 69 76 69  tor used to divi
20a0: 64 65 20 75 70 20 74 68 65 20 67 6c 6f 62 61 6c  de up the global
20b0: 20 70 61 67 65 20 63 61 63 68 65 0a 2a 2a 20 62   page cache.** b
20c0: 75 66 66 65 72 20 70 72 6f 76 69 64 65 64 20 75  uffer provided u
20d0: 73 69 6e 67 20 74 68 65 20 53 51 4c 49 54 45 5f  sing the SQLITE_
20e0: 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45  CONFIG_PAGECACHE
20f0: 20 6d 65 63 68 61 6e 69 73 6d 2e 0a 2a 2f 0a 73   mechanism..*/.s
2100: 74 72 75 63 74 20 50 67 46 72 65 65 73 6c 6f 74  truct PgFreeslot
2110: 20 7b 0a 20 20 50 67 46 72 65 65 73 6c 6f 74 20   {.  PgFreeslot 
2120: 2a 70 4e 65 78 74 3b 20 20 2f 2a 20 4e 65 78 74  *pNext;  /* Next
2130: 20 66 72 65 65 20 73 6c 6f 74 20 2a 2f 0a 7d 3b   free slot */.};
2140: 0a 0a 2f 2a 0a 2a 2a 20 47 6c 6f 62 61 6c 20 64  ../*.** Global d
2150: 61 74 61 20 75 73 65 64 20 62 79 20 74 68 69 73  ata used by this
2160: 20 63 61 63 68 65 2e 0a 2a 2f 0a 73 74 61 74 69   cache..*/.stati
2170: 63 20 53 51 4c 49 54 45 5f 57 53 44 20 73 74 72  c SQLITE_WSD str
2180: 75 63 74 20 50 43 61 63 68 65 47 6c 6f 62 61 6c  uct PCacheGlobal
2190: 20 7b 0a 20 20 50 47 72 6f 75 70 20 67 72 70 3b   {.  PGroup grp;
21a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
21b0: 20 20 20 20 2f 2a 20 54 68 65 20 67 6c 6f 62 61      /* The globa
21c0: 6c 20 50 47 72 6f 75 70 20 66 6f 72 20 6d 6f 64  l PGroup for mod
21d0: 65 20 28 32 29 20 2a 2f 0a 0a 20 20 2f 2a 20 56  e (2) */..  /* V
21e0: 61 72 69 61 62 6c 65 73 20 72 65 6c 61 74 65 64  ariables related
21f0: 20 74 6f 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49   to SQLITE_CONFI
2200: 47 5f 50 41 47 45 43 41 43 48 45 20 73 65 74 74  G_PAGECACHE sett
2210: 69 6e 67 73 2e 20 20 54 68 65 0a 20 20 2a 2a 20  ings.  The.  ** 
2220: 73 7a 53 6c 6f 74 2c 20 6e 53 6c 6f 74 2c 20 70  szSlot, nSlot, p
2230: 53 74 61 72 74 2c 20 70 45 6e 64 2c 20 6e 52 65  Start, pEnd, nRe
2240: 73 65 72 76 65 2c 20 61 6e 64 20 69 73 49 6e 69  serve, and isIni
2250: 74 20 76 61 6c 75 65 73 20 61 72 65 20 61 6c 6c  t values are all
2260: 0a 20 20 2a 2a 20 66 69 78 65 64 20 61 74 20 73  .  ** fixed at s
2270: 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a  qlite3_initializ
2280: 65 28 29 20 74 69 6d 65 20 61 6e 64 20 64 6f 20  e() time and do 
2290: 6e 6f 74 20 72 65 71 75 69 72 65 20 6d 75 74 65  not require mute
22a0: 78 20 70 72 6f 74 65 63 74 69 6f 6e 2e 0a 20 20  x protection..  
22b0: 2a 2a 20 54 68 65 20 6e 46 72 65 65 53 6c 6f 74  ** The nFreeSlot
22c0: 20 61 6e 64 20 70 46 72 65 65 20 76 61 6c 75 65   and pFree value
22d0: 73 20 64 6f 20 72 65 71 75 69 72 65 20 6d 75 74  s do require mut
22e0: 65 78 20 70 72 6f 74 65 63 74 69 6f 6e 2e 0a 20  ex protection.. 
22f0: 20 2a 2f 0a 20 20 69 6e 74 20 69 73 49 6e 69 74   */.  int isInit
2300: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
2310: 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20       /* True if 
2320: 69 6e 69 74 69 61 6c 69 7a 65 64 20 2a 2f 0a 20  initialized */. 
2330: 20 69 6e 74 20 73 65 70 61 72 61 74 65 43 61 63   int separateCac
2340: 68 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  he;             
2350: 2f 2a 20 55 73 65 20 61 20 6e 65 77 20 50 47 72  /* Use a new PGr
2360: 6f 75 70 20 66 6f 72 20 65 61 63 68 20 50 43 61  oup for each PCa
2370: 63 68 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 49 6e  che */.  int nIn
2380: 69 74 50 61 67 65 3b 20 20 20 20 20 20 20 20 20  itPage;         
2390: 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 69 74 69          /* Initi
23a0: 61 6c 20 62 75 6c 6b 20 61 6c 6c 6f 63 61 74 69  al bulk allocati
23b0: 6f 6e 20 73 69 7a 65 20 2a 2f 20 20 20 0a 20 20  on size */   .  
23c0: 69 6e 74 20 73 7a 53 6c 6f 74 3b 20 20 20 20 20  int szSlot;     
23d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
23e0: 2a 20 53 69 7a 65 20 6f 66 20 65 61 63 68 20 66  * Size of each f
23f0: 72 65 65 20 73 6c 6f 74 20 2a 2f 0a 20 20 69 6e  ree slot */.  in
2400: 74 20 6e 53 6c 6f 74 3b 20 20 20 20 20 20 20 20  t nSlot;        
2410: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
2420: 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 63  The number of pc
2430: 61 63 68 65 20 73 6c 6f 74 73 20 2a 2f 0a 20 20  ache slots */.  
2440: 69 6e 74 20 6e 52 65 73 65 72 76 65 3b 20 20 20  int nReserve;   
2450: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
2460: 2a 20 54 72 79 20 74 6f 20 6b 65 65 70 20 6e 46  * Try to keep nF
2470: 72 65 65 53 6c 6f 74 20 61 62 6f 76 65 20 74 68  reeSlot above th
2480: 69 73 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 53  is */.  void *pS
2490: 74 61 72 74 2c 20 2a 70 45 6e 64 3b 20 20 20 20  tart, *pEnd;    
24a0: 20 20 20 20 20 20 20 2f 2a 20 42 6f 75 6e 64 73         /* Bounds
24b0: 20 6f 66 20 67 6c 6f 62 61 6c 20 70 61 67 65 20   of global page 
24c0: 63 61 63 68 65 20 6d 65 6d 6f 72 79 20 2a 2f 0a  cache memory */.
24d0: 20 20 2f 2a 20 41 62 6f 76 65 20 72 65 71 75 69    /* Above requi
24e0: 72 65 73 20 6e 6f 20 6d 75 74 65 78 2e 20 20 55  res no mutex.  U
24f0: 73 65 20 6d 75 74 65 78 20 62 65 6c 6f 77 20 66  se mutex below f
2500: 6f 72 20 76 61 72 69 61 62 6c 65 20 74 68 61 74  or variable that
2510: 20 66 6f 6c 6c 6f 77 2e 20 2a 2f 0a 20 20 73 71   follow. */.  sq
2520: 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74  lite3_mutex *mut
2530: 65 78 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ex;          /* 
2540: 4d 75 74 65 78 20 66 6f 72 20 61 63 63 65 73 73  Mutex for access
2550: 69 6e 67 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e  ing the followin
2560: 67 3a 20 2a 2f 0a 20 20 50 67 46 72 65 65 73 6c  g: */.  PgFreesl
2570: 6f 74 20 2a 70 46 72 65 65 3b 20 20 20 20 20 20  ot *pFree;      
2580: 20 20 20 20 20 20 20 2f 2a 20 46 72 65 65 20 70         /* Free p
2590: 61 67 65 20 62 6c 6f 63 6b 73 20 2a 2f 0a 20 20  age blocks */.  
25a0: 69 6e 74 20 6e 46 72 65 65 53 6c 6f 74 3b 20 20  int nFreeSlot;  
25b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
25c0: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 75 6e 75 73  * Number of unus
25d0: 65 64 20 70 63 61 63 68 65 20 73 6c 6f 74 73 20  ed pcache slots 
25e0: 2a 2f 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c  */.  /* The foll
25f0: 6f 77 69 6e 67 20 76 61 6c 75 65 20 72 65 71 75  owing value requ
2600: 69 72 65 73 20 61 20 6d 75 74 65 78 20 74 6f 20  ires a mutex to 
2610: 63 68 61 6e 67 65 2e 20 20 57 65 20 73 6b 69 70  change.  We skip
2620: 20 74 68 65 20 6d 75 74 65 78 20 6f 6e 0a 20 20   the mutex on.  
2630: 2a 2a 20 72 65 61 64 69 6e 67 20 62 65 63 61 75  ** reading becau
2640: 73 65 20 28 31 29 20 6d 6f 73 74 20 70 6c 61 74  se (1) most plat
2650: 66 6f 72 6d 73 20 72 65 61 64 20 61 20 33 32 2d  forms read a 32-
2660: 62 69 74 20 69 6e 74 65 67 65 72 20 61 74 6f 6d  bit integer atom
2670: 69 63 61 6c 6c 79 20 61 6e 64 0a 20 20 2a 2a 20  ically and.  ** 
2680: 28 32 29 20 65 76 65 6e 20 69 66 20 61 6e 20 69  (2) even if an i
2690: 6e 63 6f 72 72 65 63 74 20 76 61 6c 75 65 20 69  ncorrect value i
26a0: 73 20 72 65 61 64 2c 20 6e 6f 20 67 72 65 61 74  s read, no great
26b0: 20 68 61 72 6d 20 69 73 20 64 6f 6e 65 20 73 69   harm is done si
26c0: 6e 63 65 20 74 68 69 73 0a 20 20 2a 2a 20 69 73  nce this.  ** is
26d0: 20 72 65 61 6c 6c 79 20 6a 75 73 74 20 61 6e 20   really just an 
26e0: 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 2e 20 2a 2f  optimization. */
26f0: 0a 20 20 69 6e 74 20 62 55 6e 64 65 72 50 72 65  .  int bUnderPre
2700: 73 73 75 72 65 3b 20 20 20 20 20 20 20 20 20 20  ssure;          
2710: 20 20 2f 2a 20 54 72 75 65 20 69 66 20 6c 6f 77    /* True if low
2720: 20 6f 6e 20 50 41 47 45 43 41 43 48 45 20 6d 65   on PAGECACHE me
2730: 6d 6f 72 79 20 2a 2f 0a 7d 20 70 63 61 63 68 65  mory */.} pcache
2740: 31 5f 67 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 20  1_g;../*.** All 
2750: 63 6f 64 65 20 69 6e 20 74 68 69 73 20 66 69 6c  code in this fil
2760: 65 20 73 68 6f 75 6c 64 20 61 63 63 65 73 73 20  e should access 
2770: 74 68 65 20 67 6c 6f 62 61 6c 20 73 74 72 75 63  the global struc
2780: 74 75 72 65 20 61 62 6f 76 65 20 76 69 61 20 74  ture above via t
2790: 68 65 0a 2a 2a 20 61 6c 69 61 73 20 22 70 63 61  he.** alias "pca
27a0: 63 68 65 31 22 2e 20 54 68 69 73 20 65 6e 73 75  che1". This ensu
27b0: 72 65 73 20 74 68 61 74 20 74 68 65 20 57 53 44  res that the WSD
27c0: 20 65 6d 75 6c 61 74 69 6f 6e 20 69 73 20 75 73   emulation is us
27d0: 65 64 20 77 68 65 6e 0a 2a 2a 20 63 6f 6d 70 69  ed when.** compi
27e0: 6c 69 6e 67 20 66 6f 72 20 73 79 73 74 65 6d 73  ling for systems
27f0: 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 73 75 70   that do not sup
2800: 70 6f 72 74 20 72 65 61 6c 20 57 53 44 2e 0a 2a  port real WSD..*
2810: 2f 0a 23 64 65 66 69 6e 65 20 70 63 61 63 68 65  /.#define pcache
2820: 31 20 28 47 4c 4f 42 41 4c 28 73 74 72 75 63 74  1 (GLOBAL(struct
2830: 20 50 43 61 63 68 65 47 6c 6f 62 61 6c 2c 20 70   PCacheGlobal, p
2840: 63 61 63 68 65 31 5f 67 29 29 0a 0a 2f 2a 0a 2a  cache1_g))../*.*
2850: 2a 20 4d 61 63 72 6f 73 20 74 6f 20 65 6e 74 65  * Macros to ente
2860: 72 20 61 6e 64 20 6c 65 61 76 65 20 74 68 65 20  r and leave the 
2870: 50 43 61 63 68 65 20 4c 52 55 20 6d 75 74 65 78  PCache LRU mutex
2880: 2e 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65  ..*/.#if !define
2890: 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  d(SQLITE_ENABLE_
28a0: 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e  MEMORY_MANAGEMEN
28b0: 54 29 20 7c 7c 20 53 51 4c 49 54 45 5f 54 48 52  T) || SQLITE_THR
28c0: 45 41 44 53 41 46 45 3d 3d 30 0a 23 20 64 65 66  EADSAFE==0.# def
28d0: 69 6e 65 20 70 63 61 63 68 65 31 45 6e 74 65 72  ine pcache1Enter
28e0: 4d 75 74 65 78 28 58 29 20 20 61 73 73 65 72 74  Mutex(X)  assert
28f0: 28 28 58 29 2d 3e 6d 75 74 65 78 3d 3d 30 29 0a  ((X)->mutex==0).
2900: 23 20 64 65 66 69 6e 65 20 70 63 61 63 68 65 31  # define pcache1
2910: 4c 65 61 76 65 4d 75 74 65 78 28 58 29 20 20 61  LeaveMutex(X)  a
2920: 73 73 65 72 74 28 28 58 29 2d 3e 6d 75 74 65 78  ssert((X)->mutex
2930: 3d 3d 30 29 0a 23 20 64 65 66 69 6e 65 20 50 43  ==0).# define PC
2940: 41 43 48 45 31 5f 4d 49 47 48 54 5f 55 53 45 5f  ACHE1_MIGHT_USE_
2950: 47 52 4f 55 50 5f 4d 55 54 45 58 20 30 0a 23 65  GROUP_MUTEX 0.#e
2960: 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 70 63 61  lse.# define pca
2970: 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 58  che1EnterMutex(X
2980: 29 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ) sqlite3_mutex_
2990: 65 6e 74 65 72 28 28 58 29 2d 3e 6d 75 74 65 78  enter((X)->mutex
29a0: 29 0a 23 20 64 65 66 69 6e 65 20 70 63 61 63 68  ).# define pcach
29b0: 65 31 4c 65 61 76 65 4d 75 74 65 78 28 58 29 20  e1LeaveMutex(X) 
29c0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65  sqlite3_mutex_le
29d0: 61 76 65 28 28 58 29 2d 3e 6d 75 74 65 78 29 0a  ave((X)->mutex).
29e0: 23 20 64 65 66 69 6e 65 20 50 43 41 43 48 45 31  # define PCACHE1
29f0: 5f 4d 49 47 48 54 5f 55 53 45 5f 47 52 4f 55 50  _MIGHT_USE_GROUP
2a00: 5f 4d 55 54 45 58 20 31 0a 23 65 6e 64 69 66 0a  _MUTEX 1.#endif.
2a10: 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ./**************
2a20: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2a30: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2a40: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2a50: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2a60: 2f 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 20 50 61 67 65  /./******** Page
2a70: 20 41 6c 6c 6f 63 61 74 69 6f 6e 2f 53 51 4c 49   Allocation/SQLI
2a80: 54 45 5f 43 4f 4e 46 49 47 5f 50 43 41 43 48 45  TE_CONFIG_PCACHE
2a90: 20 52 65 6c 61 74 65 64 20 46 75 6e 63 74 69 6f   Related Functio
2aa0: 6e 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ns *************
2ab0: 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  */.../*.** This 
2ac0: 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c  function is call
2ad0: 65 64 20 64 75 72 69 6e 67 20 69 6e 69 74 69 61  ed during initia
2ae0: 6c 69 7a 61 74 69 6f 6e 20 69 66 20 61 20 73 74  lization if a st
2af0: 61 74 69 63 20 62 75 66 66 65 72 20 69 73 20 0a  atic buffer is .
2b00: 2a 2a 20 73 75 70 70 6c 69 65 64 20 74 6f 20 75  ** supplied to u
2b10: 73 65 20 66 6f 72 20 74 68 65 20 70 61 67 65 2d  se for the page-
2b20: 63 61 63 68 65 20 62 79 20 70 61 73 73 69 6e 67  cache by passing
2b30: 20 74 68 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46   the SQLITE_CONF
2b40: 49 47 5f 50 41 47 45 43 41 43 48 45 0a 2a 2a 20  IG_PAGECACHE.** 
2b50: 76 65 72 62 20 74 6f 20 73 71 6c 69 74 65 33 5f  verb to sqlite3_
2b60: 63 6f 6e 66 69 67 28 29 2e 20 50 61 72 61 6d 65  config(). Parame
2b70: 74 65 72 20 70 42 75 66 20 70 6f 69 6e 74 73 20  ter pBuf points 
2b80: 74 6f 20 61 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e  to an allocation
2b90: 20 6c 61 72 67 65 0a 2a 2a 20 65 6e 6f 75 67 68   large.** enough
2ba0: 20 74 6f 20 63 6f 6e 74 61 69 6e 20 27 6e 27 20   to contain 'n' 
2bb0: 62 75 66 66 65 72 73 20 6f 66 20 27 73 7a 27 20  buffers of 'sz' 
2bc0: 62 79 74 65 73 20 65 61 63 68 2e 0a 2a 2a 0a 2a  bytes each..**.*
2bd0: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69  * This routine i
2be0: 73 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 73 71  s called from sq
2bf0: 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65  lite3_initialize
2c00: 28 29 20 61 6e 64 20 73 6f 20 69 74 20 69 73 20  () and so it is 
2c10: 67 75 61 72 61 6e 74 65 65 64 0a 2a 2a 20 74 6f  guaranteed.** to
2c20: 20 62 65 20 73 65 72 69 61 6c 69 7a 65 64 20 61   be serialized a
2c30: 6c 72 65 61 64 79 2e 20 20 54 68 65 72 65 20 69  lready.  There i
2c40: 73 20 6e 6f 20 6e 65 65 64 20 66 6f 72 20 66 75  s no need for fu
2c50: 72 74 68 65 72 20 6d 75 74 65 78 69 6e 67 2e 0a  rther mutexing..
2c60: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50  */.void sqlite3P
2c70: 43 61 63 68 65 42 75 66 66 65 72 53 65 74 75 70  CacheBufferSetup
2c80: 28 76 6f 69 64 20 2a 70 42 75 66 2c 20 69 6e 74  (void *pBuf, int
2c90: 20 73 7a 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 69   sz, int n){.  i
2ca0: 66 28 20 70 63 61 63 68 65 31 2e 69 73 49 6e 69  f( pcache1.isIni
2cb0: 74 20 29 7b 0a 20 20 20 20 50 67 46 72 65 65 73  t ){.    PgFrees
2cc0: 6c 6f 74 20 2a 70 3b 0a 20 20 20 20 69 66 28 20  lot *p;.    if( 
2cd0: 70 42 75 66 3d 3d 30 20 29 20 73 7a 20 3d 20 6e  pBuf==0 ) sz = n
2ce0: 20 3d 20 30 3b 0a 20 20 20 20 73 7a 20 3d 20 52   = 0;.    sz = R
2cf0: 4f 55 4e 44 44 4f 57 4e 38 28 73 7a 29 3b 0a 20  OUNDDOWN8(sz);. 
2d00: 20 20 20 70 63 61 63 68 65 31 2e 73 7a 53 6c 6f     pcache1.szSlo
2d10: 74 20 3d 20 73 7a 3b 0a 20 20 20 20 70 63 61 63  t = sz;.    pcac
2d20: 68 65 31 2e 6e 53 6c 6f 74 20 3d 20 70 63 61 63  he1.nSlot = pcac
2d30: 68 65 31 2e 6e 46 72 65 65 53 6c 6f 74 20 3d 20  he1.nFreeSlot = 
2d40: 6e 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 6e  n;.    pcache1.n
2d50: 52 65 73 65 72 76 65 20 3d 20 6e 3e 39 30 20 3f  Reserve = n>90 ?
2d60: 20 31 30 20 3a 20 28 6e 2f 31 30 20 2b 20 31 29   10 : (n/10 + 1)
2d70: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 70 53  ;.    pcache1.pS
2d80: 74 61 72 74 20 3d 20 70 42 75 66 3b 0a 20 20 20  tart = pBuf;.   
2d90: 20 70 63 61 63 68 65 31 2e 70 46 72 65 65 20 3d   pcache1.pFree =
2da0: 20 30 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e   0;.    pcache1.
2db0: 62 55 6e 64 65 72 50 72 65 73 73 75 72 65 20 3d  bUnderPressure =
2dc0: 20 30 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 6e   0;.    while( n
2dd0: 2d 2d 20 29 7b 0a 20 20 20 20 20 20 70 20 3d 20  -- ){.      p = 
2de0: 28 50 67 46 72 65 65 73 6c 6f 74 2a 29 70 42 75  (PgFreeslot*)pBu
2df0: 66 3b 0a 20 20 20 20 20 20 70 2d 3e 70 4e 65 78  f;.      p->pNex
2e00: 74 20 3d 20 70 63 61 63 68 65 31 2e 70 46 72 65  t = pcache1.pFre
2e10: 65 3b 0a 20 20 20 20 20 20 70 63 61 63 68 65 31  e;.      pcache1
2e20: 2e 70 46 72 65 65 20 3d 20 70 3b 0a 20 20 20 20  .pFree = p;.    
2e30: 20 20 70 42 75 66 20 3d 20 28 76 6f 69 64 2a 29    pBuf = (void*)
2e40: 26 28 28 63 68 61 72 2a 29 70 42 75 66 29 5b 73  &((char*)pBuf)[s
2e50: 7a 5d 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 63  z];.    }.    pc
2e60: 61 63 68 65 31 2e 70 45 6e 64 20 3d 20 70 42 75  ache1.pEnd = pBu
2e70: 66 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  f;.  }.}../*.** 
2e80: 54 72 79 20 74 6f 20 69 6e 69 74 69 61 6c 69 7a  Try to initializ
2e90: 65 20 74 68 65 20 70 43 61 63 68 65 2d 3e 70 46  e the pCache->pF
2ea0: 72 65 65 20 61 6e 64 20 70 43 61 63 68 65 2d 3e  ree and pCache->
2eb0: 70 42 75 6c 6b 20 66 69 65 6c 64 73 2e 20 20 52  pBulk fields.  R
2ec0: 65 74 75 72 6e 0a 2a 2a 20 74 72 75 65 20 69 66  eturn.** true if
2ed0: 20 70 43 61 63 68 65 2d 3e 70 46 72 65 65 20 65   pCache->pFree e
2ee0: 6e 64 73 20 75 70 20 63 6f 6e 74 61 69 6e 69 6e  nds up containin
2ef0: 67 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 66 72  g one or more fr
2f00: 65 65 20 70 61 67 65 73 2e 0a 2a 2f 0a 73 74 61  ee pages..*/.sta
2f10: 74 69 63 20 69 6e 74 20 70 63 61 63 68 65 31 49  tic int pcache1I
2f20: 6e 69 74 42 75 6c 6b 28 50 43 61 63 68 65 31 20  nitBulk(PCache1 
2f30: 2a 70 43 61 63 68 65 29 7b 0a 20 20 69 36 34 20  *pCache){.  i64 
2f40: 73 7a 42 75 6c 6b 3b 0a 20 20 63 68 61 72 20 2a  szBulk;.  char *
2f50: 7a 42 75 6c 6b 3b 0a 20 20 69 66 28 20 70 63 61  zBulk;.  if( pca
2f60: 63 68 65 31 2e 6e 49 6e 69 74 50 61 67 65 3d 3d  che1.nInitPage==
2f70: 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20  0 ) return 0;.  
2f80: 2f 2a 20 44 6f 20 6e 6f 74 20 62 6f 74 68 65 72  /* Do not bother
2f90: 20 77 69 74 68 20 61 20 62 75 6c 6b 20 61 6c 6c   with a bulk all
2fa0: 6f 63 61 74 69 6f 6e 20 69 66 20 74 68 65 20 63  ocation if the c
2fb0: 61 63 68 65 20 73 69 7a 65 20 76 65 72 79 20 73  ache size very s
2fc0: 6d 61 6c 6c 20 2a 2f 0a 20 20 69 66 28 20 70 43  mall */.  if( pC
2fd0: 61 63 68 65 2d 3e 6e 4d 61 78 3c 33 20 29 20 72  ache->nMax<3 ) r
2fe0: 65 74 75 72 6e 20 30 3b 0a 20 20 73 71 6c 69 74  eturn 0;.  sqlit
2ff0: 65 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c  e3BeginBenignMal
3000: 6c 6f 63 28 29 3b 0a 20 20 69 66 28 20 70 63 61  loc();.  if( pca
3010: 63 68 65 31 2e 6e 49 6e 69 74 50 61 67 65 3e 30  che1.nInitPage>0
3020: 20 29 7b 0a 20 20 20 20 73 7a 42 75 6c 6b 20 3d   ){.    szBulk =
3030: 20 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63   pCache->szAlloc
3040: 20 2a 20 28 69 36 34 29 70 63 61 63 68 65 31 2e   * (i64)pcache1.
3050: 6e 49 6e 69 74 50 61 67 65 3b 0a 20 20 7d 65 6c  nInitPage;.  }el
3060: 73 65 7b 0a 20 20 20 20 73 7a 42 75 6c 6b 20 3d  se{.    szBulk =
3070: 20 2d 31 30 32 34 20 2a 20 28 69 36 34 29 70 63   -1024 * (i64)pc
3080: 61 63 68 65 31 2e 6e 49 6e 69 74 50 61 67 65 3b  ache1.nInitPage;
3090: 0a 20 20 7d 0a 20 20 69 66 28 20 73 7a 42 75 6c  .  }.  if( szBul
30a0: 6b 20 3e 20 70 43 61 63 68 65 2d 3e 73 7a 41 6c  k > pCache->szAl
30b0: 6c 6f 63 2a 28 69 36 34 29 70 43 61 63 68 65 2d  loc*(i64)pCache-
30c0: 3e 6e 4d 61 78 20 29 7b 0a 20 20 20 20 73 7a 42  >nMax ){.    szB
30d0: 75 6c 6b 20 3d 20 70 43 61 63 68 65 2d 3e 73 7a  ulk = pCache->sz
30e0: 41 6c 6c 6f 63 2a 70 43 61 63 68 65 2d 3e 6e 4d  Alloc*pCache->nM
30f0: 61 78 3b 0a 20 20 7d 0a 20 20 7a 42 75 6c 6b 20  ax;.  }.  zBulk 
3100: 3d 20 70 43 61 63 68 65 2d 3e 70 42 75 6c 6b 20  = pCache->pBulk 
3110: 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28  = sqlite3Malloc(
3120: 20 73 7a 42 75 6c 6b 20 29 3b 0a 20 20 73 71 6c   szBulk );.  sql
3130: 69 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d 61 6c  ite3EndBenignMal
3140: 6c 6f 63 28 29 3b 0a 20 20 69 66 28 20 7a 42 75  loc();.  if( zBu
3150: 6c 6b 20 29 7b 0a 20 20 20 20 69 6e 74 20 6e 42  lk ){.    int nB
3160: 75 6c 6b 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c  ulk = sqlite3Mal
3170: 6c 6f 63 53 69 7a 65 28 7a 42 75 6c 6b 29 2f 70  locSize(zBulk)/p
3180: 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63 3b 0a  Cache->szAlloc;.
3190: 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 66      int i;.    f
31a0: 6f 72 28 69 3d 30 3b 20 69 3c 6e 42 75 6c 6b 3b  or(i=0; i<nBulk;
31b0: 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 50 67 48   i++){.      PgH
31c0: 64 72 31 20 2a 70 58 20 3d 20 28 50 67 48 64 72  dr1 *pX = (PgHdr
31d0: 31 2a 29 26 7a 42 75 6c 6b 5b 70 43 61 63 68 65  1*)&zBulk[pCache
31e0: 2d 3e 73 7a 50 61 67 65 5d 3b 0a 20 20 20 20 20  ->szPage];.     
31f0: 20 70 58 2d 3e 70 61 67 65 2e 70 42 75 66 20 3d   pX->page.pBuf =
3200: 20 7a 42 75 6c 6b 3b 0a 20 20 20 20 20 20 70 58   zBulk;.      pX
3210: 2d 3e 70 61 67 65 2e 70 45 78 74 72 61 20 3d 20  ->page.pExtra = 
3220: 26 70 58 5b 31 5d 3b 0a 20 20 20 20 20 20 70 58  &pX[1];.      pX
3230: 2d 3e 69 73 42 75 6c 6b 4c 6f 63 61 6c 20 3d 20  ->isBulkLocal = 
3240: 31 3b 0a 20 20 20 20 20 20 70 58 2d 3e 69 73 41  1;.      pX->isA
3250: 6e 63 68 6f 72 20 3d 20 30 3b 0a 20 20 20 20 20  nchor = 0;.     
3260: 20 70 58 2d 3e 70 4e 65 78 74 20 3d 20 70 43 61   pX->pNext = pCa
3270: 63 68 65 2d 3e 70 46 72 65 65 3b 0a 20 20 20 20  che->pFree;.    
3280: 20 20 70 43 61 63 68 65 2d 3e 70 46 72 65 65 20    pCache->pFree 
3290: 3d 20 70 58 3b 0a 20 20 20 20 20 20 7a 42 75 6c  = pX;.      zBul
32a0: 6b 20 2b 3d 20 70 43 61 63 68 65 2d 3e 73 7a 41  k += pCache->szA
32b0: 6c 6c 6f 63 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  lloc;.    }.  }.
32c0: 20 20 72 65 74 75 72 6e 20 70 43 61 63 68 65 2d    return pCache-
32d0: 3e 70 46 72 65 65 21 3d 30 3b 0a 7d 0a 0a 2f 2a  >pFree!=0;.}../*
32e0: 0a 2a 2a 20 4d 61 6c 6c 6f 63 20 66 75 6e 63 74  .** Malloc funct
32f0: 69 6f 6e 20 75 73 65 64 20 77 69 74 68 69 6e 20  ion used within 
3300: 74 68 69 73 20 66 69 6c 65 20 74 6f 20 61 6c 6c  this file to all
3310: 6f 63 61 74 65 20 73 70 61 63 65 20 66 72 6f 6d  ocate space from
3320: 20 74 68 65 20 62 75 66 66 65 72 0a 2a 2a 20 63   the buffer.** c
3330: 6f 6e 66 69 67 75 72 65 64 20 75 73 69 6e 67 20  onfigured using 
3340: 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 53  sqlite3_config(S
3350: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47  QLITE_CONFIG_PAG
3360: 45 43 41 43 48 45 29 20 6f 70 74 69 6f 6e 2e 20  ECACHE) option. 
3370: 49 66 20 6e 6f 20 0a 2a 2a 20 73 75 63 68 20 62  If no .** such b
3380: 75 66 66 65 72 20 65 78 69 73 74 73 20 6f 72 20  uffer exists or 
3390: 74 68 65 72 65 20 69 73 20 6e 6f 20 73 70 61 63  there is no spac
33a0: 65 20 6c 65 66 74 20 69 6e 20 69 74 2c 20 74 68  e left in it, th
33b0: 69 73 20 66 75 6e 63 74 69 6f 6e 20 66 61 6c 6c  is function fall
33c0: 73 20 0a 2a 2a 20 62 61 63 6b 20 74 6f 20 73 71  s .** back to sq
33d0: 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 29 2e 0a 2a  lite3Malloc()..*
33e0: 2a 0a 2a 2a 20 4d 75 6c 74 69 70 6c 65 20 74 68  *.** Multiple th
33f0: 72 65 61 64 73 20 63 61 6e 20 72 75 6e 20 74 68  reads can run th
3400: 69 73 20 72 6f 75 74 69 6e 65 20 61 74 20 74 68  is routine at th
3410: 65 20 73 61 6d 65 20 74 69 6d 65 2e 20 20 47 6c  e same time.  Gl
3420: 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 73 0a 2a  obal variables.*
3430: 2a 20 69 6e 20 70 63 61 63 68 65 31 20 6e 65 65  * in pcache1 nee
3440: 64 20 74 6f 20 62 65 20 70 72 6f 74 65 63 74 65  d to be protecte
3450: 64 20 76 69 61 20 6d 75 74 65 78 2e 0a 2a 2f 0a  d via mutex..*/.
3460: 73 74 61 74 69 63 20 76 6f 69 64 20 2a 70 63 61  static void *pca
3470: 63 68 65 31 41 6c 6c 6f 63 28 69 6e 74 20 6e 42  che1Alloc(int nB
3480: 79 74 65 29 7b 0a 20 20 76 6f 69 64 20 2a 70 20  yte){.  void *p 
3490: 3d 20 30 3b 0a 20 20 61 73 73 65 72 74 28 20 73  = 0;.  assert( s
34a0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6e 6f 74  qlite3_mutex_not
34b0: 68 65 6c 64 28 70 63 61 63 68 65 31 2e 67 72 70  held(pcache1.grp
34c0: 2e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28  .mutex) );.  if(
34d0: 20 6e 42 79 74 65 3c 3d 70 63 61 63 68 65 31 2e   nByte<=pcache1.
34e0: 73 7a 53 6c 6f 74 20 29 7b 0a 20 20 20 20 73 71  szSlot ){.    sq
34f0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
3500: 72 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29  r(pcache1.mutex)
3510: 3b 0a 20 20 20 20 70 20 3d 20 28 50 67 48 64 72  ;.    p = (PgHdr
3520: 31 20 2a 29 70 63 61 63 68 65 31 2e 70 46 72 65  1 *)pcache1.pFre
3530: 65 3b 0a 20 20 20 20 69 66 28 20 70 20 29 7b 0a  e;.    if( p ){.
3540: 20 20 20 20 20 20 70 63 61 63 68 65 31 2e 70 46        pcache1.pF
3550: 72 65 65 20 3d 20 70 63 61 63 68 65 31 2e 70 46  ree = pcache1.pF
3560: 72 65 65 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20  ree->pNext;.    
3570: 20 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65 53    pcache1.nFreeS
3580: 6c 6f 74 2d 2d 3b 0a 20 20 20 20 20 20 70 63 61  lot--;.      pca
3590: 63 68 65 31 2e 62 55 6e 64 65 72 50 72 65 73 73  che1.bUnderPress
35a0: 75 72 65 20 3d 20 70 63 61 63 68 65 31 2e 6e 46  ure = pcache1.nF
35b0: 72 65 65 53 6c 6f 74 3c 70 63 61 63 68 65 31 2e  reeSlot<pcache1.
35c0: 6e 52 65 73 65 72 76 65 3b 0a 20 20 20 20 20 20  nReserve;.      
35d0: 61 73 73 65 72 74 28 20 70 63 61 63 68 65 31 2e  assert( pcache1.
35e0: 6e 46 72 65 65 53 6c 6f 74 3e 3d 30 20 29 3b 0a  nFreeSlot>=0 );.
35f0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 53 74 61        sqlite3Sta
3600: 74 75 73 53 65 74 28 53 51 4c 49 54 45 5f 53 54  tusSet(SQLITE_ST
3610: 41 54 55 53 5f 50 41 47 45 43 41 43 48 45 5f 53  ATUS_PAGECACHE_S
3620: 49 5a 45 2c 20 6e 42 79 74 65 29 3b 0a 20 20 20  IZE, nByte);.   
3630: 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73     sqlite3Status
3640: 55 70 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53  Up(SQLITE_STATUS
3650: 5f 50 41 47 45 43 41 43 48 45 5f 55 53 45 44 2c  _PAGECACHE_USED,
3660: 20 31 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73   1);.    }.    s
3670: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
3680: 76 65 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78  ve(pcache1.mutex
3690: 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 3d 3d  );.  }.  if( p==
36a0: 30 20 29 7b 0a 20 20 20 20 2f 2a 20 4d 65 6d 6f  0 ){.    /* Memo
36b0: 72 79 20 69 73 20 6e 6f 74 20 61 76 61 69 6c 61  ry is not availa
36c0: 62 6c 65 20 69 6e 20 74 68 65 20 53 51 4c 49 54  ble in the SQLIT
36d0: 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43  E_CONFIG_PAGECAC
36e0: 48 45 20 70 6f 6f 6c 2e 20 20 47 65 74 0a 20 20  HE pool.  Get.  
36f0: 20 20 2a 2a 20 69 74 20 66 72 6f 6d 20 73 71 6c    ** it from sql
3700: 69 74 65 33 4d 61 6c 6c 6f 63 20 69 6e 73 74 65  ite3Malloc inste
3710: 61 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 70  ad..    */.    p
3720: 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63   = sqlite3Malloc
3730: 28 6e 42 79 74 65 29 3b 0a 23 69 66 6e 64 65 66  (nByte);.#ifndef
3740: 20 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f   SQLITE_DISABLE_
3750: 50 41 47 45 43 41 43 48 45 5f 4f 56 45 52 46 4c  PAGECACHE_OVERFL
3760: 4f 57 5f 53 54 41 54 53 0a 20 20 20 20 69 66 28  OW_STATS.    if(
3770: 20 70 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20   p ){.      int 
3780: 73 7a 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c  sz = sqlite3Mall
3790: 6f 63 53 69 7a 65 28 70 29 3b 0a 20 20 20 20 20  ocSize(p);.     
37a0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65   sqlite3_mutex_e
37b0: 6e 74 65 72 28 70 63 61 63 68 65 31 2e 6d 75 74  nter(pcache1.mut
37c0: 65 78 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74  ex);.      sqlit
37d0: 65 33 53 74 61 74 75 73 53 65 74 28 53 51 4c 49  e3StatusSet(SQLI
37e0: 54 45 5f 53 54 41 54 55 53 5f 50 41 47 45 43 41  TE_STATUS_PAGECA
37f0: 43 48 45 5f 53 49 5a 45 2c 20 6e 42 79 74 65 29  CHE_SIZE, nByte)
3800: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 53  ;.      sqlite3S
3810: 74 61 74 75 73 55 70 28 53 51 4c 49 54 45 5f 53  tatusUp(SQLITE_S
3820: 54 41 54 55 53 5f 50 41 47 45 43 41 43 48 45 5f  TATUS_PAGECACHE_
3830: 4f 56 45 52 46 4c 4f 57 2c 20 73 7a 29 3b 0a 20  OVERFLOW, sz);. 
3840: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74       sqlite3_mut
3850: 65 78 5f 6c 65 61 76 65 28 70 63 61 63 68 65 31  ex_leave(pcache1
3860: 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 7d 0a 23  .mutex);.    }.#
3870: 65 6e 64 69 66 0a 20 20 20 20 73 71 6c 69 74 65  endif.    sqlite
3880: 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65  3MemdebugSetType
3890: 28 70 2c 20 4d 45 4d 54 59 50 45 5f 50 43 41 43  (p, MEMTYPE_PCAC
38a0: 48 45 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72  HE);.  }.  retur
38b0: 6e 20 70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72  n p;.}../*.** Fr
38c0: 65 65 20 61 6e 20 61 6c 6c 6f 63 61 74 65 64 20  ee an allocated 
38d0: 62 75 66 66 65 72 20 6f 62 74 61 69 6e 65 64 20  buffer obtained 
38e0: 66 72 6f 6d 20 70 63 61 63 68 65 31 41 6c 6c 6f  from pcache1Allo
38f0: 63 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  c()..*/.static v
3900: 6f 69 64 20 70 63 61 63 68 65 31 46 72 65 65 28  oid pcache1Free(
3910: 76 6f 69 64 20 2a 70 29 7b 0a 20 20 69 6e 74 20  void *p){.  int 
3920: 6e 46 72 65 65 64 20 3d 20 30 3b 0a 20 20 69 66  nFreed = 0;.  if
3930: 28 20 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b  ( p==0 ) return;
3940: 0a 20 20 69 66 28 20 70 3e 3d 70 63 61 63 68 65  .  if( p>=pcache
3950: 31 2e 70 53 74 61 72 74 20 26 26 20 70 3c 70 63  1.pStart && p<pc
3960: 61 63 68 65 31 2e 70 45 6e 64 20 29 7b 0a 20 20  ache1.pEnd ){.  
3970: 20 20 50 67 46 72 65 65 73 6c 6f 74 20 2a 70 53    PgFreeslot *pS
3980: 6c 6f 74 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  lot;.    sqlite3
3990: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 63 61  _mutex_enter(pca
39a0: 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20 20  che1.mutex);.   
39b0: 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 44 6f   sqlite3StatusDo
39c0: 77 6e 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53  wn(SQLITE_STATUS
39d0: 5f 50 41 47 45 43 41 43 48 45 5f 55 53 45 44 2c  _PAGECACHE_USED,
39e0: 20 31 29 3b 0a 20 20 20 20 70 53 6c 6f 74 20 3d   1);.    pSlot =
39f0: 20 28 50 67 46 72 65 65 73 6c 6f 74 2a 29 70 3b   (PgFreeslot*)p;
3a00: 0a 20 20 20 20 70 53 6c 6f 74 2d 3e 70 4e 65 78  .    pSlot->pNex
3a10: 74 20 3d 20 70 63 61 63 68 65 31 2e 70 46 72 65  t = pcache1.pFre
3a20: 65 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 70  e;.    pcache1.p
3a30: 46 72 65 65 20 3d 20 70 53 6c 6f 74 3b 0a 20 20  Free = pSlot;.  
3a40: 20 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65 53    pcache1.nFreeS
3a50: 6c 6f 74 2b 2b 3b 0a 20 20 20 20 70 63 61 63 68  lot++;.    pcach
3a60: 65 31 2e 62 55 6e 64 65 72 50 72 65 73 73 75 72  e1.bUnderPressur
3a70: 65 20 3d 20 70 63 61 63 68 65 31 2e 6e 46 72 65  e = pcache1.nFre
3a80: 65 53 6c 6f 74 3c 70 63 61 63 68 65 31 2e 6e 52  eSlot<pcache1.nR
3a90: 65 73 65 72 76 65 3b 0a 20 20 20 20 61 73 73 65  eserve;.    asse
3aa0: 72 74 28 20 70 63 61 63 68 65 31 2e 6e 46 72 65  rt( pcache1.nFre
3ab0: 65 53 6c 6f 74 3c 3d 70 63 61 63 68 65 31 2e 6e  eSlot<=pcache1.n
3ac0: 53 6c 6f 74 20 29 3b 0a 20 20 20 20 73 71 6c 69  Slot );.    sqli
3ad0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
3ae0: 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a  pcache1.mutex);.
3af0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73    }else{.    ass
3b00: 65 72 74 28 20 73 71 6c 69 74 65 33 4d 65 6d 64  ert( sqlite3Memd
3b10: 65 62 75 67 48 61 73 54 79 70 65 28 70 2c 20 4d  ebugHasType(p, M
3b20: 45 4d 54 59 50 45 5f 50 43 41 43 48 45 29 20 29  EMTYPE_PCACHE) )
3b30: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 4d 65 6d  ;.    sqlite3Mem
3b40: 64 65 62 75 67 53 65 74 54 79 70 65 28 70 2c 20  debugSetType(p, 
3b50: 4d 45 4d 54 59 50 45 5f 48 45 41 50 29 3b 0a 23  MEMTYPE_HEAP);.#
3b60: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 49  ifndef SQLITE_DI
3b70: 53 41 42 4c 45 5f 50 41 47 45 43 41 43 48 45 5f  SABLE_PAGECACHE_
3b80: 4f 56 45 52 46 4c 4f 57 5f 53 54 41 54 53 0a 20  OVERFLOW_STATS. 
3b90: 20 20 20 6e 46 72 65 65 64 20 3d 20 73 71 6c 69     nFreed = sqli
3ba0: 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 29  te3MallocSize(p)
3bb0: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75  ;.    sqlite3_mu
3bc0: 74 65 78 5f 65 6e 74 65 72 28 70 63 61 63 68 65  tex_enter(pcache
3bd0: 31 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 73 71  1.mutex);.    sq
3be0: 6c 69 74 65 33 53 74 61 74 75 73 44 6f 77 6e 28  lite3StatusDown(
3bf0: 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 50 41  SQLITE_STATUS_PA
3c00: 47 45 43 41 43 48 45 5f 4f 56 45 52 46 4c 4f 57  GECACHE_OVERFLOW
3c10: 2c 20 6e 46 72 65 65 64 29 3b 0a 20 20 20 20 73  , nFreed);.    s
3c20: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
3c30: 76 65 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78  ve(pcache1.mutex
3c40: 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 73 71  );.#endif.    sq
3c50: 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 20  lite3_free(p);. 
3c60: 20 7d 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c   }.}..#ifdef SQL
3c70: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52  ITE_ENABLE_MEMOR
3c80: 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 2f 2a 0a  Y_MANAGEMENT./*.
3c90: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 73 69  ** Return the si
3ca0: 7a 65 20 6f 66 20 61 20 70 63 61 63 68 65 20 61  ze of a pcache a
3cb0: 6c 6c 6f 63 61 74 69 6f 6e 0a 2a 2f 0a 73 74 61  llocation.*/.sta
3cc0: 74 69 63 20 69 6e 74 20 70 63 61 63 68 65 31 4d  tic int pcache1M
3cd0: 65 6d 53 69 7a 65 28 76 6f 69 64 20 2a 70 29 7b  emSize(void *p){
3ce0: 0a 20 20 69 66 28 20 70 3e 3d 70 63 61 63 68 65  .  if( p>=pcache
3cf0: 31 2e 70 53 74 61 72 74 20 26 26 20 70 3c 70 63  1.pStart && p<pc
3d00: 61 63 68 65 31 2e 70 45 6e 64 20 29 7b 0a 20 20  ache1.pEnd ){.  
3d10: 20 20 72 65 74 75 72 6e 20 70 63 61 63 68 65 31    return pcache1
3d20: 2e 73 7a 53 6c 6f 74 3b 0a 20 20 7d 65 6c 73 65  .szSlot;.  }else
3d30: 7b 0a 20 20 20 20 69 6e 74 20 69 53 69 7a 65 3b  {.    int iSize;
3d40: 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c  .    assert( sql
3d50: 69 74 65 33 4d 65 6d 64 65 62 75 67 48 61 73 54  ite3MemdebugHasT
3d60: 79 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 50  ype(p, MEMTYPE_P
3d70: 43 41 43 48 45 29 20 29 3b 0a 20 20 20 20 73 71  CACHE) );.    sq
3d80: 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 53 65 74  lite3MemdebugSet
3d90: 54 79 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f  Type(p, MEMTYPE_
3da0: 48 45 41 50 29 3b 0a 20 20 20 20 69 53 69 7a 65  HEAP);.    iSize
3db0: 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63   = sqlite3Malloc
3dc0: 53 69 7a 65 28 70 29 3b 0a 20 20 20 20 73 71 6c  Size(p);.    sql
3dd0: 69 74 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54  ite3MemdebugSetT
3de0: 79 70 65 28 70 2c 20 4d 45 4d 54 59 50 45 5f 50  ype(p, MEMTYPE_P
3df0: 43 41 43 48 45 29 3b 0a 20 20 20 20 72 65 74 75  CACHE);.    retu
3e00: 72 6e 20 69 53 69 7a 65 3b 0a 20 20 7d 0a 7d 0a  rn iSize;.  }.}.
3e10: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45  #endif /* SQLITE
3e20: 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d  _ENABLE_MEMORY_M
3e30: 41 4e 41 47 45 4d 45 4e 54 20 2a 2f 0a 0a 2f 2a  ANAGEMENT */../*
3e40: 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 61 20 6e  .** Allocate a n
3e50: 65 77 20 70 61 67 65 20 6f 62 6a 65 63 74 20 69  ew page object i
3e60: 6e 69 74 69 61 6c 6c 79 20 61 73 73 6f 63 69 61  nitially associa
3e70: 74 65 64 20 77 69 74 68 20 63 61 63 68 65 20 70  ted with cache p
3e80: 43 61 63 68 65 2e 0a 2a 2f 0a 73 74 61 74 69 63  Cache..*/.static
3e90: 20 50 67 48 64 72 31 20 2a 70 63 61 63 68 65 31   PgHdr1 *pcache1
3ea0: 41 6c 6c 6f 63 50 61 67 65 28 50 43 61 63 68 65  AllocPage(PCache
3eb0: 31 20 2a 70 43 61 63 68 65 2c 20 69 6e 74 20 62  1 *pCache, int b
3ec0: 65 6e 69 67 6e 4d 61 6c 6c 6f 63 29 7b 0a 20 20  enignMalloc){.  
3ed0: 50 67 48 64 72 31 20 2a 70 20 3d 20 30 3b 0a 20  PgHdr1 *p = 0;. 
3ee0: 20 76 6f 69 64 20 2a 70 50 67 3b 0a 0a 20 20 61   void *pPg;..  a
3ef0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d  ssert( sqlite3_m
3f00: 75 74 65 78 5f 68 65 6c 64 28 70 43 61 63 68 65  utex_held(pCache
3f10: 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29  ->pGroup->mutex)
3f20: 20 29 3b 0a 20 20 69 66 28 20 70 43 61 63 68 65   );.  if( pCache
3f30: 2d 3e 70 46 72 65 65 20 7c 7c 20 28 70 43 61 63  ->pFree || (pCac
3f40: 68 65 2d 3e 6e 50 61 67 65 3d 3d 30 20 26 26 20  he->nPage==0 && 
3f50: 70 63 61 63 68 65 31 49 6e 69 74 42 75 6c 6b 28  pcache1InitBulk(
3f60: 70 43 61 63 68 65 29 29 20 29 7b 0a 20 20 20 20  pCache)) ){.    
3f70: 70 20 3d 20 70 43 61 63 68 65 2d 3e 70 46 72 65  p = pCache->pFre
3f80: 65 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 70  e;.    pCache->p
3f90: 46 72 65 65 20 3d 20 70 2d 3e 70 4e 65 78 74 3b  Free = p->pNext;
3fa0: 0a 20 20 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20  .    p->pNext = 
3fb0: 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 23 69 66 64  0;.  }else{.#ifd
3fc0: 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  ef SQLITE_ENABLE
3fd0: 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45  _MEMORY_MANAGEME
3fe0: 4e 54 0a 20 20 20 20 2f 2a 20 54 68 65 20 67 72  NT.    /* The gr
3ff0: 6f 75 70 20 6d 75 74 65 78 20 6d 75 73 74 20 62  oup mutex must b
4000: 65 20 72 65 6c 65 61 73 65 64 20 62 65 66 6f 72  e released befor
4010: 65 20 70 63 61 63 68 65 31 41 6c 6c 6f 63 28 29  e pcache1Alloc()
4020: 20 69 73 20 63 61 6c 6c 65 64 2e 20 54 68 69 73   is called. This
4030: 0a 20 20 20 20 2a 2a 20 69 73 20 62 65 63 61 75  .    ** is becau
4040: 73 65 20 69 74 20 6d 69 67 68 74 20 63 61 6c 6c  se it might call
4050: 20 73 71 6c 69 74 65 33 5f 72 65 6c 65 61 73 65   sqlite3_release
4060: 5f 6d 65 6d 6f 72 79 28 29 2c 20 77 68 69 63 68  _memory(), which
4070: 20 61 73 73 75 6d 65 73 20 74 68 61 74 20 0a 20   assumes that . 
4080: 20 20 20 2a 2a 20 74 68 69 73 20 6d 75 74 65 78     ** this mutex
4090: 20 69 73 20 6e 6f 74 20 68 65 6c 64 2e 20 2a 2f   is not held. */
40a0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 63 61  .    assert( pca
40b0: 63 68 65 31 2e 73 65 70 61 72 61 74 65 43 61 63  che1.separateCac
40c0: 68 65 3d 3d 30 20 29 3b 0a 20 20 20 20 61 73 73  he==0 );.    ass
40d0: 65 72 74 28 20 70 43 61 63 68 65 2d 3e 70 47 72  ert( pCache->pGr
40e0: 6f 75 70 3d 3d 26 70 63 61 63 68 65 31 2e 67 72  oup==&pcache1.gr
40f0: 70 20 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31  p );.    pcache1
4100: 4c 65 61 76 65 4d 75 74 65 78 28 70 43 61 63 68  LeaveMutex(pCach
4110: 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 23 65 6e 64  e->pGroup);.#end
4120: 69 66 0a 20 20 20 20 69 66 28 20 62 65 6e 69 67  if.    if( benig
4130: 6e 4d 61 6c 6c 6f 63 20 29 7b 20 73 71 6c 69 74  nMalloc ){ sqlit
4140: 65 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c  e3BeginBenignMal
4150: 6c 6f 63 28 29 3b 20 7d 0a 23 69 66 64 65 66 20  loc(); }.#ifdef 
4160: 53 51 4c 49 54 45 5f 50 43 41 43 48 45 5f 53 45  SQLITE_PCACHE_SE
4170: 50 41 52 41 54 45 5f 48 45 41 44 45 52 0a 20 20  PARATE_HEADER.  
4180: 20 20 70 50 67 20 3d 20 70 63 61 63 68 65 31 41    pPg = pcache1A
4190: 6c 6c 6f 63 28 70 43 61 63 68 65 2d 3e 73 7a 50  lloc(pCache->szP
41a0: 61 67 65 29 3b 0a 20 20 20 20 70 20 3d 20 73 71  age);.    p = sq
41b0: 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 73 69 7a 65  lite3Malloc(size
41c0: 6f 66 28 50 67 48 64 72 31 29 20 2b 20 70 43 61  of(PgHdr1) + pCa
41d0: 63 68 65 2d 3e 73 7a 45 78 74 72 61 29 3b 0a 20  che->szExtra);. 
41e0: 20 20 20 69 66 28 20 21 70 50 67 20 7c 7c 20 21     if( !pPg || !
41f0: 70 20 29 7b 0a 20 20 20 20 20 20 70 63 61 63 68  p ){.      pcach
4200: 65 31 46 72 65 65 28 70 50 67 29 3b 0a 20 20 20  e1Free(pPg);.   
4210: 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28     sqlite3_free(
4220: 70 29 3b 0a 20 20 20 20 20 20 70 50 67 20 3d 20  p);.      pPg = 
4230: 30 3b 0a 20 20 20 20 7d 0a 23 65 6c 73 65 0a 20  0;.    }.#else. 
4240: 20 20 20 70 50 67 20 3d 20 70 63 61 63 68 65 31     pPg = pcache1
4250: 41 6c 6c 6f 63 28 70 43 61 63 68 65 2d 3e 73 7a  Alloc(pCache->sz
4260: 41 6c 6c 6f 63 29 3b 0a 20 20 20 20 70 20 3d 20  Alloc);.    p = 
4270: 28 50 67 48 64 72 31 20 2a 29 26 28 28 75 38 20  (PgHdr1 *)&((u8 
4280: 2a 29 70 50 67 29 5b 70 43 61 63 68 65 2d 3e 73  *)pPg)[pCache->s
4290: 7a 50 61 67 65 5d 3b 0a 23 65 6e 64 69 66 0a 20  zPage];.#endif. 
42a0: 20 20 20 69 66 28 20 62 65 6e 69 67 6e 4d 61 6c     if( benignMal
42b0: 6c 6f 63 20 29 7b 20 73 71 6c 69 74 65 33 45 6e  loc ){ sqlite3En
42c0: 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b  dBenignMalloc();
42d0: 20 7d 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45   }.#ifdef SQLITE
42e0: 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d  _ENABLE_MEMORY_M
42f0: 41 4e 41 47 45 4d 45 4e 54 0a 20 20 20 20 70 63  ANAGEMENT.    pc
4300: 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28  ache1EnterMutex(
4310: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b  pCache->pGroup);
4320: 0a 23 65 6e 64 69 66 0a 20 20 20 20 69 66 28 20  .#endif.    if( 
4330: 70 50 67 3d 3d 30 20 29 20 72 65 74 75 72 6e 20  pPg==0 ) return 
4340: 30 3b 0a 20 20 20 20 70 2d 3e 70 61 67 65 2e 70  0;.    p->page.p
4350: 42 75 66 20 3d 20 70 50 67 3b 0a 20 20 20 20 70  Buf = pPg;.    p
4360: 2d 3e 70 61 67 65 2e 70 45 78 74 72 61 20 3d 20  ->page.pExtra = 
4370: 26 70 5b 31 5d 3b 0a 20 20 20 20 70 2d 3e 69 73  &p[1];.    p->is
4380: 42 75 6c 6b 4c 6f 63 61 6c 20 3d 20 30 3b 0a 20  BulkLocal = 0;. 
4390: 20 20 20 70 2d 3e 69 73 41 6e 63 68 6f 72 20 3d     p->isAnchor =
43a0: 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 43   0;.  }.  if( pC
43b0: 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65  ache->bPurgeable
43c0: 20 29 7b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e   ){.    pCache->
43d0: 70 47 72 6f 75 70 2d 3e 6e 43 75 72 72 65 6e 74  pGroup->nCurrent
43e0: 50 61 67 65 2b 2b 3b 0a 20 20 7d 0a 20 20 72 65  Page++;.  }.  re
43f0: 74 75 72 6e 20 70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  turn p;.}../*.**
4400: 20 46 72 65 65 20 61 20 70 61 67 65 20 6f 62 6a   Free a page obj
4410: 65 63 74 20 61 6c 6c 6f 63 61 74 65 64 20 62 79  ect allocated by
4420: 20 70 63 61 63 68 65 31 41 6c 6c 6f 63 50 61 67   pcache1AllocPag
4430: 65 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  e()..*/.static v
4440: 6f 69 64 20 70 63 61 63 68 65 31 46 72 65 65 50  oid pcache1FreeP
4450: 61 67 65 28 50 67 48 64 72 31 20 2a 70 29 7b 0a  age(PgHdr1 *p){.
4460: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68    PCache1 *pCach
4470: 65 3b 0a 20 20 61 73 73 65 72 74 28 20 70 21 3d  e;.  assert( p!=
4480: 30 20 29 3b 0a 20 20 70 43 61 63 68 65 20 3d 20  0 );.  pCache = 
4490: 70 2d 3e 70 43 61 63 68 65 3b 0a 20 20 61 73 73  p->pCache;.  ass
44a0: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74  ert( sqlite3_mut
44b0: 65 78 5f 68 65 6c 64 28 70 2d 3e 70 43 61 63 68  ex_held(p->pCach
44c0: 65 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78  e->pGroup->mutex
44d0: 29 20 29 3b 0a 20 20 69 66 28 20 70 2d 3e 69 73  ) );.  if( p->is
44e0: 42 75 6c 6b 4c 6f 63 61 6c 20 29 7b 0a 20 20 20  BulkLocal ){.   
44f0: 20 70 2d 3e 70 4e 65 78 74 20 3d 20 70 43 61 63   p->pNext = pCac
4500: 68 65 2d 3e 70 46 72 65 65 3b 0a 20 20 20 20 70  he->pFree;.    p
4510: 43 61 63 68 65 2d 3e 70 46 72 65 65 20 3d 20 70  Cache->pFree = p
4520: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70  ;.  }else{.    p
4530: 63 61 63 68 65 31 46 72 65 65 28 70 2d 3e 70 61  cache1Free(p->pa
4540: 67 65 2e 70 42 75 66 29 3b 0a 23 69 66 64 65 66  ge.pBuf);.#ifdef
4550: 20 53 51 4c 49 54 45 5f 50 43 41 43 48 45 5f 53   SQLITE_PCACHE_S
4560: 45 50 41 52 41 54 45 5f 48 45 41 44 45 52 0a 20  EPARATE_HEADER. 
4570: 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28     sqlite3_free(
4580: 70 29 3b 0a 23 65 6e 64 69 66 0a 20 20 7d 0a 20  p);.#endif.  }. 
4590: 20 69 66 28 20 70 43 61 63 68 65 2d 3e 62 50 75   if( pCache->bPu
45a0: 72 67 65 61 62 6c 65 20 29 7b 0a 20 20 20 20 70  rgeable ){.    p
45b0: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6e  Cache->pGroup->n
45c0: 43 75 72 72 65 6e 74 50 61 67 65 2d 2d 3b 0a 20  CurrentPage--;. 
45d0: 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6c 6c   }.}../*.** Mall
45e0: 6f 63 20 66 75 6e 63 74 69 6f 6e 20 75 73 65 64  oc function used
45f0: 20 62 79 20 53 51 4c 69 74 65 20 74 6f 20 6f 62   by SQLite to ob
4600: 74 61 69 6e 20 73 70 61 63 65 20 66 72 6f 6d 20  tain space from 
4610: 74 68 65 20 62 75 66 66 65 72 20 63 6f 6e 66 69  the buffer confi
4620: 67 75 72 65 64 0a 2a 2a 20 75 73 69 6e 67 20 73  gured.** using s
4630: 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 53 51  qlite3_config(SQ
4640: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45  LITE_CONFIG_PAGE
4650: 43 41 43 48 45 29 20 6f 70 74 69 6f 6e 2e 20 49  CACHE) option. I
4660: 66 20 6e 6f 20 73 75 63 68 20 62 75 66 66 65 72  f no such buffer
4670: 0a 2a 2a 20 65 78 69 73 74 73 2c 20 74 68 69 73  .** exists, this
4680: 20 66 75 6e 63 74 69 6f 6e 20 66 61 6c 6c 73 20   function falls 
4690: 62 61 63 6b 20 74 6f 20 73 71 6c 69 74 65 33 4d  back to sqlite3M
46a0: 61 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a 76 6f 69 64  alloc()..*/.void
46b0: 20 2a 73 71 6c 69 74 65 33 50 61 67 65 4d 61 6c   *sqlite3PageMal
46c0: 6c 6f 63 28 69 6e 74 20 73 7a 29 7b 0a 20 20 72  loc(int sz){.  r
46d0: 65 74 75 72 6e 20 70 63 61 63 68 65 31 41 6c 6c  eturn pcache1All
46e0: 6f 63 28 73 7a 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  oc(sz);.}../*.**
46f0: 20 46 72 65 65 20 61 6e 20 61 6c 6c 6f 63 61 74   Free an allocat
4700: 65 64 20 62 75 66 66 65 72 20 6f 62 74 61 69 6e  ed buffer obtain
4710: 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 50  ed from sqlite3P
4720: 61 67 65 4d 61 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a  ageMalloc()..*/.
4730: 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 67 65  void sqlite3Page
4740: 46 72 65 65 28 76 6f 69 64 20 2a 70 29 7b 0a 20  Free(void *p){. 
4750: 20 70 63 61 63 68 65 31 46 72 65 65 28 70 29 3b   pcache1Free(p);
4760: 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  .}.../*.** Retur
4770: 6e 20 74 72 75 65 20 69 66 20 69 74 20 64 65 73  n true if it des
4780: 69 72 61 62 6c 65 20 74 6f 20 61 76 6f 69 64 20  irable to avoid 
4790: 61 6c 6c 6f 63 61 74 69 6e 67 20 61 20 6e 65 77  allocating a new
47a0: 20 70 61 67 65 20 63 61 63 68 65 0a 2a 2a 20 65   page cache.** e
47b0: 6e 74 72 79 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6d  ntry..**.** If m
47c0: 65 6d 6f 72 79 20 77 61 73 20 61 6c 6c 6f 63 61  emory was alloca
47d0: 74 65 64 20 73 70 65 63 69 66 69 63 61 6c 6c 79  ted specifically
47e0: 20 74 6f 20 74 68 65 20 70 61 67 65 20 63 61 63   to the page cac
47f0: 68 65 20 75 73 69 6e 67 0a 2a 2a 20 53 51 4c 49  he using.** SQLI
4800: 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41  TE_CONFIG_PAGECA
4810: 43 48 45 20 62 75 74 20 74 68 61 74 20 6d 65 6d  CHE but that mem
4820: 6f 72 79 20 68 61 73 20 61 6c 6c 20 62 65 65 6e  ory has all been
4830: 20 75 73 65 64 2c 20 74 68 65 6e 0a 2a 2a 20 69   used, then.** i
4840: 74 20 69 73 20 64 65 73 69 72 61 62 6c 65 20 74  t is desirable t
4850: 6f 20 61 76 6f 69 64 20 61 6c 6c 6f 63 61 74 69  o avoid allocati
4860: 6e 67 20 61 20 6e 65 77 20 70 61 67 65 20 63 61  ng a new page ca
4870: 63 68 65 20 65 6e 74 72 79 20 62 65 63 61 75 73  che entry becaus
4880: 65 0a 2a 2a 20 70 72 65 73 75 6d 61 62 6c 79 20  e.** presumably 
4890: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41  SQLITE_CONFIG_PA
48a0: 47 45 43 41 43 48 45 20 77 61 73 20 73 75 70 70  GECACHE was supp
48b0: 6f 73 65 20 74 6f 20 62 65 20 73 75 66 66 69 63  ose to be suffic
48c0: 69 65 6e 74 0a 2a 2a 20 66 6f 72 20 61 6c 6c 20  ient.** for all 
48d0: 70 61 67 65 20 63 61 63 68 65 20 6e 65 65 64 73  page cache needs
48e0: 20 61 6e 64 20 77 65 20 73 68 6f 75 6c 64 20 6e   and we should n
48f0: 6f 74 20 6e 65 65 64 20 74 6f 20 73 70 69 6c 6c  ot need to spill
4900: 20 74 68 65 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69   the.** allocati
4910: 6f 6e 20 6f 6e 74 6f 20 74 68 65 20 68 65 61 70  on onto the heap
4920: 2e 0a 2a 2a 0a 2a 2a 20 4f 72 2c 20 74 68 65 20  ..**.** Or, the 
4930: 68 65 61 70 20 69 73 20 75 73 65 64 20 66 6f 72  heap is used for
4940: 20 61 6c 6c 20 70 61 67 65 20 63 61 63 68 65 20   all page cache 
4950: 6d 65 6d 6f 72 79 20 62 75 74 20 74 68 65 20 68  memory but the h
4960: 65 61 70 20 69 73 0a 2a 2a 20 75 6e 64 65 72 20  eap is.** under 
4970: 6d 65 6d 6f 72 79 20 70 72 65 73 73 75 72 65 2c  memory pressure,
4980: 20 74 68 65 6e 20 61 67 61 69 6e 20 69 74 20 69   then again it i
4990: 73 20 64 65 73 69 72 61 62 6c 65 20 74 6f 20 61  s desirable to a
49a0: 76 6f 69 64 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69  void.** allocati
49b0: 6e 67 20 61 20 6e 65 77 20 70 61 67 65 20 63 61  ng a new page ca
49c0: 63 68 65 20 65 6e 74 72 79 20 69 6e 20 6f 72 64  che entry in ord
49d0: 65 72 20 74 6f 20 61 76 6f 69 64 20 73 74 72 65  er to avoid stre
49e0: 73 73 69 6e 67 0a 2a 2a 20 74 68 65 20 68 65 61  ssing.** the hea
49f0: 70 20 65 76 65 6e 20 66 75 72 74 68 65 72 2e 0a  p even further..
4a00: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 63  */.static int pc
4a10: 61 63 68 65 31 55 6e 64 65 72 4d 65 6d 6f 72 79  ache1UnderMemory
4a20: 50 72 65 73 73 75 72 65 28 50 43 61 63 68 65 31  Pressure(PCache1
4a30: 20 2a 70 43 61 63 68 65 29 7b 0a 20 20 69 66 28   *pCache){.  if(
4a40: 20 70 63 61 63 68 65 31 2e 6e 53 6c 6f 74 20 26   pcache1.nSlot &
4a50: 26 20 28 70 43 61 63 68 65 2d 3e 73 7a 50 61 67  & (pCache->szPag
4a60: 65 2b 70 43 61 63 68 65 2d 3e 73 7a 45 78 74 72  e+pCache->szExtr
4a70: 61 29 3c 3d 70 63 61 63 68 65 31 2e 73 7a 53 6c  a)<=pcache1.szSl
4a80: 6f 74 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  ot ){.    return
4a90: 20 70 63 61 63 68 65 31 2e 62 55 6e 64 65 72 50   pcache1.bUnderP
4aa0: 72 65 73 73 75 72 65 3b 0a 20 20 7d 65 6c 73 65  ressure;.  }else
4ab0: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 73 71 6c  {.    return sql
4ac0: 69 74 65 33 48 65 61 70 4e 65 61 72 6c 79 46 75  ite3HeapNearlyFu
4ad0: 6c 6c 28 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 2a  ll();.  }.}../**
4ae0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4af0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4b00: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4b10: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4b20: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 2f 2a  ************/./*
4b30: 2a 2a 2a 2a 2a 2a 2a 20 47 65 6e 65 72 61 6c 20  ******* General 
4b40: 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 46  Implementation F
4b50: 75 6e 63 74 69 6f 6e 73 20 2a 2a 2a 2a 2a 2a 2a  unctions *******
4b60: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4b70: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a  *************/..
4b80: 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74  /*.** This funct
4b90: 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 72  ion is used to r
4ba0: 65 73 69 7a 65 20 74 68 65 20 68 61 73 68 20 74  esize the hash t
4bb0: 61 62 6c 65 20 75 73 65 64 20 62 79 20 74 68 65  able used by the
4bc0: 20 63 61 63 68 65 20 70 61 73 73 65 64 0a 2a 2a   cache passed.**
4bd0: 20 61 73 20 74 68 65 20 66 69 72 73 74 20 61 72   as the first ar
4be0: 67 75 6d 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 54 68  gument..**.** Th
4bf0: 65 20 50 43 61 63 68 65 20 6d 75 74 65 78 20 6d  e PCache mutex m
4c00: 75 73 74 20 62 65 20 68 65 6c 64 20 77 68 65 6e  ust be held when
4c10: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69   this function i
4c20: 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61  s called..*/.sta
4c30: 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31  tic void pcache1
4c40: 52 65 73 69 7a 65 48 61 73 68 28 50 43 61 63 68  ResizeHash(PCach
4c50: 65 31 20 2a 70 29 7b 0a 20 20 50 67 48 64 72 31  e1 *p){.  PgHdr1
4c60: 20 2a 2a 61 70 4e 65 77 3b 0a 20 20 75 6e 73 69   **apNew;.  unsi
4c70: 67 6e 65 64 20 69 6e 74 20 6e 4e 65 77 3b 0a 20  gned int nNew;. 
4c80: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 3b   unsigned int i;
4c90: 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69  ..  assert( sqli
4ca0: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70  te3_mutex_held(p
4cb0: 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29  ->pGroup->mutex)
4cc0: 20 29 3b 0a 0a 20 20 6e 4e 65 77 20 3d 20 70 2d   );..  nNew = p-
4cd0: 3e 6e 48 61 73 68 2a 32 3b 0a 20 20 69 66 28 20  >nHash*2;.  if( 
4ce0: 6e 4e 65 77 3c 32 35 36 20 29 7b 0a 20 20 20 20  nNew<256 ){.    
4cf0: 6e 4e 65 77 20 3d 20 32 35 36 3b 0a 20 20 7d 0a  nNew = 256;.  }.
4d00: 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d  .  pcache1LeaveM
4d10: 75 74 65 78 28 70 2d 3e 70 47 72 6f 75 70 29 3b  utex(p->pGroup);
4d20: 0a 20 20 69 66 28 20 70 2d 3e 6e 48 61 73 68 20  .  if( p->nHash 
4d30: 29 7b 20 73 71 6c 69 74 65 33 42 65 67 69 6e 42  ){ sqlite3BeginB
4d40: 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 20 7d  enignMalloc(); }
4d50: 0a 20 20 61 70 4e 65 77 20 3d 20 28 50 67 48 64  .  apNew = (PgHd
4d60: 72 31 20 2a 2a 29 73 71 6c 69 74 65 33 4d 61 6c  r1 **)sqlite3Mal
4d70: 6c 6f 63 5a 65 72 6f 28 73 69 7a 65 6f 66 28 50  locZero(sizeof(P
4d80: 67 48 64 72 31 20 2a 29 2a 6e 4e 65 77 29 3b 0a  gHdr1 *)*nNew);.
4d90: 20 20 69 66 28 20 70 2d 3e 6e 48 61 73 68 20 29    if( p->nHash )
4da0: 7b 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e 69  { sqlite3EndBeni
4db0: 67 6e 4d 61 6c 6c 6f 63 28 29 3b 20 7d 0a 20 20  gnMalloc(); }.  
4dc0: 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65  pcache1EnterMute
4dd0: 78 28 70 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20  x(p->pGroup);.  
4de0: 69 66 28 20 61 70 4e 65 77 20 29 7b 0a 20 20 20  if( apNew ){.   
4df0: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e   for(i=0; i<p->n
4e00: 48 61 73 68 3b 20 69 2b 2b 29 7b 0a 20 20 20 20  Hash; i++){.    
4e10: 20 20 50 67 48 64 72 31 20 2a 70 50 61 67 65 3b    PgHdr1 *pPage;
4e20: 0a 20 20 20 20 20 20 50 67 48 64 72 31 20 2a 70  .      PgHdr1 *p
4e30: 4e 65 78 74 20 3d 20 70 2d 3e 61 70 48 61 73 68  Next = p->apHash
4e40: 5b 69 5d 3b 0a 20 20 20 20 20 20 77 68 69 6c 65  [i];.      while
4e50: 28 20 28 70 50 61 67 65 20 3d 20 70 4e 65 78 74  ( (pPage = pNext
4e60: 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20  )!=0 ){.        
4e70: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 68 20 3d  unsigned int h =
4e80: 20 70 50 61 67 65 2d 3e 69 4b 65 79 20 25 20 6e   pPage->iKey % n
4e90: 4e 65 77 3b 0a 20 20 20 20 20 20 20 20 70 4e 65  New;.        pNe
4ea0: 78 74 20 3d 20 70 50 61 67 65 2d 3e 70 4e 65 78  xt = pPage->pNex
4eb0: 74 3b 0a 20 20 20 20 20 20 20 20 70 50 61 67 65  t;.        pPage
4ec0: 2d 3e 70 4e 65 78 74 20 3d 20 61 70 4e 65 77 5b  ->pNext = apNew[
4ed0: 68 5d 3b 0a 20 20 20 20 20 20 20 20 61 70 4e 65  h];.        apNe
4ee0: 77 5b 68 5d 20 3d 20 70 50 61 67 65 3b 0a 20 20  w[h] = pPage;.  
4ef0: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20      }.    }.    
4f00: 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 2d 3e  sqlite3_free(p->
4f10: 61 70 48 61 73 68 29 3b 0a 20 20 20 20 70 2d 3e  apHash);.    p->
4f20: 61 70 48 61 73 68 20 3d 20 61 70 4e 65 77 3b 0a  apHash = apNew;.
4f30: 20 20 20 20 70 2d 3e 6e 48 61 73 68 20 3d 20 6e      p->nHash = n
4f40: 4e 65 77 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a  New;.  }.}../*.*
4f50: 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  * This function 
4f60: 69 73 20 75 73 65 64 20 69 6e 74 65 72 6e 61 6c  is used internal
4f70: 6c 79 20 74 6f 20 72 65 6d 6f 76 65 20 74 68 65  ly to remove the
4f80: 20 70 61 67 65 20 70 50 61 67 65 20 66 72 6f 6d   page pPage from
4f90: 20 74 68 65 20 0a 2a 2a 20 50 47 72 6f 75 70 20   the .** PGroup 
4fa0: 4c 52 55 20 6c 69 73 74 2c 20 69 66 20 69 73 20  LRU list, if is 
4fb0: 70 61 72 74 20 6f 66 20 69 74 2e 20 49 66 20 70  part of it. If p
4fc0: 50 61 67 65 20 69 73 20 6e 6f 74 20 70 61 72 74  Page is not part
4fd0: 20 6f 66 20 74 68 65 20 50 47 72 6f 75 70 0a 2a   of the PGroup.*
4fe0: 2a 20 4c 52 55 20 6c 69 73 74 2c 20 74 68 65 6e  * LRU list, then
4ff0: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69   this function i
5000: 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a 2a 2a  s a no-op..**.**
5010: 20 54 68 65 20 50 47 72 6f 75 70 20 6d 75 74 65   The PGroup mute
5020: 78 20 6d 75 73 74 20 62 65 20 68 65 6c 64 20 77  x must be held w
5030: 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f  hen this functio
5040: 6e 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a  n is called..*/.
5050: 73 74 61 74 69 63 20 50 67 48 64 72 31 20 2a 70  static PgHdr1 *p
5060: 63 61 63 68 65 31 50 69 6e 50 61 67 65 28 50 67  cache1PinPage(Pg
5070: 48 64 72 31 20 2a 70 50 61 67 65 29 7b 0a 20 20  Hdr1 *pPage){.  
5080: 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 3b  PCache1 *pCache;
5090: 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67  ..  assert( pPag
50a0: 65 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74  e!=0 );.  assert
50b0: 28 20 70 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65  ( pPage->isPinne
50c0: 64 3d 3d 30 20 29 3b 0a 20 20 70 43 61 63 68 65  d==0 );.  pCache
50d0: 20 3d 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65   = pPage->pCache
50e0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67  ;.  assert( pPag
50f0: 65 2d 3e 70 4c 72 75 4e 65 78 74 20 29 3b 0a 20  e->pLruNext );. 
5100: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e   assert( pPage->
5110: 70 4c 72 75 50 72 65 76 20 29 3b 0a 20 20 61 73  pLruPrev );.  as
5120: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75  sert( sqlite3_mu
5130: 74 65 78 5f 68 65 6c 64 28 70 43 61 63 68 65 2d  tex_held(pCache-
5140: 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20  >pGroup->mutex) 
5150: 29 3b 0a 20 20 70 50 61 67 65 2d 3e 70 4c 72 75  );.  pPage->pLru
5160: 50 72 65 76 2d 3e 70 4c 72 75 4e 65 78 74 20 3d  Prev->pLruNext =
5170: 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74   pPage->pLruNext
5180: 3b 0a 20 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e  ;.  pPage->pLruN
5190: 65 78 74 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20  ext->pLruPrev = 
51a0: 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 3b  pPage->pLruPrev;
51b0: 0a 20 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65  .  pPage->pLruNe
51c0: 78 74 20 3d 20 30 3b 0a 20 20 70 50 61 67 65 2d  xt = 0;.  pPage-
51d0: 3e 70 4c 72 75 50 72 65 76 20 3d 20 30 3b 0a 20  >pLruPrev = 0;. 
51e0: 20 70 50 61 67 65 2d 3e 69 73 50 69 6e 6e 65 64   pPage->isPinned
51f0: 20 3d 20 31 3b 0a 20 20 61 73 73 65 72 74 28 20   = 1;.  assert( 
5200: 70 50 61 67 65 2d 3e 69 73 41 6e 63 68 6f 72 3d  pPage->isAnchor=
5210: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  =0 );.  assert( 
5220: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e  pCache->pGroup->
5230: 6c 72 75 2e 69 73 41 6e 63 68 6f 72 3d 3d 31 20  lru.isAnchor==1 
5240: 29 3b 0a 20 20 70 43 61 63 68 65 2d 3e 6e 52 65  );.  pCache->nRe
5250: 63 79 63 6c 61 62 6c 65 2d 2d 3b 0a 20 20 72 65  cyclable--;.  re
5260: 74 75 72 6e 20 70 50 61 67 65 3b 0a 7d 0a 0a 0a  turn pPage;.}...
5270: 2f 2a 0a 2a 2a 20 52 65 6d 6f 76 65 20 74 68 65  /*.** Remove the
5280: 20 70 61 67 65 20 73 75 70 70 6c 69 65 64 20 61   page supplied a
5290: 73 20 61 6e 20 61 72 67 75 6d 65 6e 74 20 66 72  s an argument fr
52a0: 6f 6d 20 74 68 65 20 68 61 73 68 20 74 61 62 6c  om the hash tabl
52b0: 65 20 0a 2a 2a 20 28 50 43 61 63 68 65 31 2e 61  e .** (PCache1.a
52c0: 70 48 61 73 68 20 73 74 72 75 63 74 75 72 65 29  pHash structure)
52d0: 20 74 68 61 74 20 69 74 20 69 73 20 63 75 72 72   that it is curr
52e0: 65 6e 74 6c 79 20 73 74 6f 72 65 64 20 69 6e 2e  ently stored in.
52f0: 0a 2a 2a 20 41 6c 73 6f 20 66 72 65 65 20 74 68  .** Also free th
5300: 65 20 70 61 67 65 20 69 66 20 66 72 65 65 50 61  e page if freePa
5310: 67 65 20 69 73 20 74 72 75 65 2e 0a 2a 2a 0a 2a  ge is true..**.*
5320: 2a 20 54 68 65 20 50 47 72 6f 75 70 20 6d 75 74  * The PGroup mut
5330: 65 78 20 6d 75 73 74 20 62 65 20 68 65 6c 64 20  ex must be held 
5340: 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69  when this functi
5350: 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f  on is called..*/
5360: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61  .static void pca
5370: 63 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61  che1RemoveFromHa
5380: 73 68 28 50 67 48 64 72 31 20 2a 70 50 61 67 65  sh(PgHdr1 *pPage
5390: 2c 20 69 6e 74 20 66 72 65 65 46 6c 61 67 29 7b  , int freeFlag){
53a0: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
53b0: 68 3b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43  h;.  PCache1 *pC
53c0: 61 63 68 65 20 3d 20 70 50 61 67 65 2d 3e 70 43  ache = pPage->pC
53d0: 61 63 68 65 3b 0a 20 20 50 67 48 64 72 31 20 2a  ache;.  PgHdr1 *
53e0: 2a 70 70 3b 0a 0a 20 20 61 73 73 65 72 74 28 20  *pp;..  assert( 
53f0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65  sqlite3_mutex_he
5400: 6c 64 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75  ld(pCache->pGrou
5410: 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 68  p->mutex) );.  h
5420: 20 3d 20 70 50 61 67 65 2d 3e 69 4b 65 79 20 25   = pPage->iKey %
5430: 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a   pCache->nHash;.
5440: 20 20 66 6f 72 28 70 70 3d 26 70 43 61 63 68 65    for(pp=&pCache
5450: 2d 3e 61 70 48 61 73 68 5b 68 5d 3b 20 28 2a 70  ->apHash[h]; (*p
5460: 70 29 21 3d 70 50 61 67 65 3b 20 70 70 3d 26 28  p)!=pPage; pp=&(
5470: 2a 70 70 29 2d 3e 70 4e 65 78 74 29 3b 0a 20 20  *pp)->pNext);.  
5480: 2a 70 70 20 3d 20 28 2a 70 70 29 2d 3e 70 4e 65  *pp = (*pp)->pNe
5490: 78 74 3b 0a 0a 20 20 70 43 61 63 68 65 2d 3e 6e  xt;..  pCache->n
54a0: 50 61 67 65 2d 2d 3b 0a 20 20 69 66 28 20 66 72  Page--;.  if( fr
54b0: 65 65 46 6c 61 67 20 29 20 70 63 61 63 68 65 31  eeFlag ) pcache1
54c0: 46 72 65 65 50 61 67 65 28 70 50 61 67 65 29 3b  FreePage(pPage);
54d0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65  .}../*.** If the
54e0: 72 65 20 61 72 65 20 63 75 72 72 65 6e 74 6c 79  re are currently
54f0: 20 6d 6f 72 65 20 74 68 61 6e 20 6e 4d 61 78 50   more than nMaxP
5500: 61 67 65 20 70 61 67 65 73 20 61 6c 6c 6f 63 61  age pages alloca
5510: 74 65 64 2c 20 74 72 79 0a 2a 2a 20 74 6f 20 72  ted, try.** to r
5520: 65 63 79 63 6c 65 20 70 61 67 65 73 20 74 6f 20  ecycle pages to 
5530: 72 65 64 75 63 65 20 74 68 65 20 6e 75 6d 62 65  reduce the numbe
5540: 72 20 61 6c 6c 6f 63 61 74 65 64 20 74 6f 20 6e  r allocated to n
5550: 4d 61 78 50 61 67 65 2e 0a 2a 2f 0a 73 74 61 74  MaxPage..*/.stat
5560: 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 45  ic void pcache1E
5570: 6e 66 6f 72 63 65 4d 61 78 50 61 67 65 28 50 43  nforceMaxPage(PC
5580: 61 63 68 65 31 20 2a 70 43 61 63 68 65 29 7b 0a  ache1 *pCache){.
5590: 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70    PGroup *pGroup
55a0: 20 3d 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75   = pCache->pGrou
55b0: 70 3b 0a 20 20 50 67 48 64 72 31 20 2a 70 3b 0a  p;.  PgHdr1 *p;.
55c0: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
55d0: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 47 72  3_mutex_held(pGr
55e0: 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20  oup->mutex) );. 
55f0: 20 77 68 69 6c 65 28 20 70 47 72 6f 75 70 2d 3e   while( pGroup->
5600: 6e 43 75 72 72 65 6e 74 50 61 67 65 3e 70 47 72  nCurrentPage>pGr
5610: 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 0a 20 20  oup->nMaxPage.  
5620: 20 20 20 20 26 26 20 28 70 3d 70 47 72 6f 75 70      && (p=pGroup
5630: 2d 3e 6c 72 75 2e 70 4c 72 75 50 72 65 76 29 2d  ->lru.pLruPrev)-
5640: 3e 69 73 41 6e 63 68 6f 72 3d 3d 30 0a 20 20 29  >isAnchor==0.  )
5650: 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 2d  {.    assert( p-
5660: 3e 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3d  >pCache->pGroup=
5670: 3d 70 47 72 6f 75 70 20 29 3b 0a 20 20 20 20 61  =pGroup );.    a
5680: 73 73 65 72 74 28 20 70 2d 3e 69 73 50 69 6e 6e  ssert( p->isPinn
5690: 65 64 3d 3d 30 20 29 3b 0a 20 20 20 20 70 63 61  ed==0 );.    pca
56a0: 63 68 65 31 50 69 6e 50 61 67 65 28 70 29 3b 0a  che1PinPage(p);.
56b0: 20 20 20 20 70 63 61 63 68 65 31 52 65 6d 6f 76      pcache1Remov
56c0: 65 46 72 6f 6d 48 61 73 68 28 70 2c 20 31 29 3b  eFromHash(p, 1);
56d0: 0a 20 20 7d 0a 20 20 69 66 28 20 70 43 61 63 68  .  }.  if( pCach
56e0: 65 2d 3e 6e 50 61 67 65 3d 3d 30 20 26 26 20 70  e->nPage==0 && p
56f0: 43 61 63 68 65 2d 3e 70 42 75 6c 6b 20 29 7b 0a  Cache->pBulk ){.
5700: 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65      sqlite3_free
5710: 28 70 43 61 63 68 65 2d 3e 70 42 75 6c 6b 29 3b  (pCache->pBulk);
5720: 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 70 42 75  .    pCache->pBu
5730: 6c 6b 20 3d 20 70 43 61 63 68 65 2d 3e 70 46 72  lk = pCache->pFr
5740: 65 65 20 3d 20 30 3b 0a 20 20 7d 0a 7d 0a 0a 2f  ee = 0;.  }.}../
5750: 2a 0a 2a 2a 20 44 69 73 63 61 72 64 20 61 6c 6c  *.** Discard all
5760: 20 70 61 67 65 73 20 66 72 6f 6d 20 63 61 63 68   pages from cach
5770: 65 20 70 43 61 63 68 65 20 77 69 74 68 20 61 20  e pCache with a 
5780: 70 61 67 65 20 6e 75 6d 62 65 72 20 28 6b 65 79  page number (key
5790: 20 76 61 6c 75 65 29 20 0a 2a 2a 20 67 72 65 61   value) .** grea
57a0: 74 65 72 20 74 68 61 6e 20 6f 72 20 65 71 75 61  ter than or equa
57b0: 6c 20 74 6f 20 69 4c 69 6d 69 74 2e 20 41 6e 79  l to iLimit. Any
57c0: 20 70 69 6e 6e 65 64 20 70 61 67 65 73 20 74 68   pinned pages th
57d0: 61 74 20 6d 65 65 74 20 74 68 69 73 20 0a 2a 2a  at meet this .**
57e0: 20 63 72 69 74 65 72 69 61 20 61 72 65 20 75 6e   criteria are un
57f0: 70 69 6e 6e 65 64 20 62 65 66 6f 72 65 20 74 68  pinned before th
5800: 65 79 20 61 72 65 20 64 69 73 63 61 72 64 65 64  ey are discarded
5810: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50 43 61 63  ..**.** The PCac
5820: 68 65 20 6d 75 74 65 78 20 6d 75 73 74 20 62 65  he mutex must be
5830: 20 68 65 6c 64 20 77 68 65 6e 20 74 68 69 73 20   held when this 
5840: 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c  function is call
5850: 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  ed..*/.static vo
5860: 69 64 20 70 63 61 63 68 65 31 54 72 75 6e 63 61  id pcache1Trunca
5870: 74 65 55 6e 73 61 66 65 28 0a 20 20 50 43 61 63  teUnsafe(.  PCac
5880: 68 65 31 20 2a 70 43 61 63 68 65 2c 20 20 20 20  he1 *pCache,    
5890: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20           /* The 
58a0: 63 61 63 68 65 20 74 6f 20 74 72 75 6e 63 61 74  cache to truncat
58b0: 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20  e */.  unsigned 
58c0: 69 6e 74 20 69 4c 69 6d 69 74 20 20 20 20 20 20  int iLimit      
58d0: 20 20 20 20 2f 2a 20 44 72 6f 70 20 70 61 67 65      /* Drop page
58e0: 73 20 77 69 74 68 20 74 68 69 73 20 70 67 6e 6f  s with this pgno
58f0: 20 6f 72 20 6c 61 72 67 65 72 20 2a 2f 0a 29 7b   or larger */.){
5900: 0a 20 20 54 45 53 54 4f 4e 4c 59 28 20 75 6e 73  .  TESTONLY( uns
5910: 69 67 6e 65 64 20 69 6e 74 20 6e 50 61 67 65 20  igned int nPage 
5920: 3d 20 30 3b 20 29 20 20 2f 2a 20 54 6f 20 61 73  = 0; )  /* To as
5930: 73 65 72 74 20 70 43 61 63 68 65 2d 3e 6e 50 61  sert pCache->nPa
5940: 67 65 20 69 73 20 63 6f 72 72 65 63 74 20 2a 2f  ge is correct */
5950: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
5960: 68 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c  h;.  assert( sql
5970: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28  ite3_mutex_held(
5980: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e  pCache->pGroup->
5990: 6d 75 74 65 78 29 20 29 3b 0a 20 20 66 6f 72 28  mutex) );.  for(
59a0: 68 3d 30 3b 20 68 3c 70 43 61 63 68 65 2d 3e 6e  h=0; h<pCache->n
59b0: 48 61 73 68 3b 20 68 2b 2b 29 7b 0a 20 20 20 20  Hash; h++){.    
59c0: 50 67 48 64 72 31 20 2a 2a 70 70 20 3d 20 26 70  PgHdr1 **pp = &p
59d0: 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d  Cache->apHash[h]
59e0: 3b 20 0a 20 20 20 20 50 67 48 64 72 31 20 2a 70  ; .    PgHdr1 *p
59f0: 50 61 67 65 3b 0a 20 20 20 20 77 68 69 6c 65 28  Page;.    while(
5a00: 20 28 70 50 61 67 65 20 3d 20 2a 70 70 29 21 3d   (pPage = *pp)!=
5a10: 30 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70  0 ){.      if( p
5a20: 50 61 67 65 2d 3e 69 4b 65 79 3e 3d 69 4c 69 6d  Page->iKey>=iLim
5a30: 69 74 20 29 7b 0a 20 20 20 20 20 20 20 20 70 43  it ){.        pC
5a40: 61 63 68 65 2d 3e 6e 50 61 67 65 2d 2d 3b 0a 20  ache->nPage--;. 
5a50: 20 20 20 20 20 20 20 2a 70 70 20 3d 20 70 50 61         *pp = pPa
5a60: 67 65 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20  ge->pNext;.     
5a70: 20 20 20 69 66 28 20 21 70 50 61 67 65 2d 3e 69     if( !pPage->i
5a80: 73 50 69 6e 6e 65 64 20 29 20 70 63 61 63 68 65  sPinned ) pcache
5a90: 31 50 69 6e 50 61 67 65 28 70 50 61 67 65 29 3b  1PinPage(pPage);
5aa0: 0a 20 20 20 20 20 20 20 20 70 63 61 63 68 65 31  .        pcache1
5ab0: 46 72 65 65 50 61 67 65 28 70 50 61 67 65 29 3b  FreePage(pPage);
5ac0: 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  .      }else{.  
5ad0: 20 20 20 20 20 20 70 70 20 3d 20 26 70 50 61 67        pp = &pPag
5ae0: 65 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20  e->pNext;.      
5af0: 20 20 54 45 53 54 4f 4e 4c 59 28 20 6e 50 61 67    TESTONLY( nPag
5b00: 65 2b 2b 3b 20 29 0a 20 20 20 20 20 20 7d 0a 20  e++; ).      }. 
5b10: 20 20 20 7d 0a 20 20 7d 0a 20 20 61 73 73 65 72     }.  }.  asser
5b20: 74 28 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65  t( pCache->nPage
5b30: 3d 3d 6e 50 61 67 65 20 29 3b 0a 7d 0a 0a 2f 2a  ==nPage );.}../*
5b40: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5b50: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5b60: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5b70: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5b80: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 2f  *************/./
5b90: 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65 33  ******** sqlite3
5ba0: 5f 70 63 61 63 68 65 20 4d 65 74 68 6f 64 73 20  _pcache Methods 
5bb0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5bc0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5bd0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a  **************/.
5be0: 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74  ./*.** Implement
5bf0: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c  ation of the sql
5c00: 69 74 65 33 5f 70 63 61 63 68 65 2e 78 49 6e 69  ite3_pcache.xIni
5c10: 74 20 6d 65 74 68 6f 64 2e 0a 2a 2f 0a 73 74 61  t method..*/.sta
5c20: 74 69 63 20 69 6e 74 20 70 63 61 63 68 65 31 49  tic int pcache1I
5c30: 6e 69 74 28 76 6f 69 64 20 2a 4e 6f 74 55 73 65  nit(void *NotUse
5c40: 64 29 7b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52  d){.  UNUSED_PAR
5c50: 41 4d 45 54 45 52 28 4e 6f 74 55 73 65 64 29 3b  AMETER(NotUsed);
5c60: 0a 20 20 61 73 73 65 72 74 28 20 70 63 61 63 68  .  assert( pcach
5c70: 65 31 2e 69 73 49 6e 69 74 3d 3d 30 20 29 3b 0a  e1.isInit==0 );.
5c80: 20 20 6d 65 6d 73 65 74 28 26 70 63 61 63 68 65    memset(&pcache
5c90: 31 2c 20 30 2c 20 73 69 7a 65 6f 66 28 70 63 61  1, 0, sizeof(pca
5ca0: 63 68 65 31 29 29 3b 0a 0a 0a 20 20 2f 2a 0a 20  che1));...  /*. 
5cb0: 20 2a 2a 20 54 68 65 20 70 63 61 63 68 65 31 2e   ** The pcache1.
5cc0: 73 65 70 61 72 61 74 65 43 61 63 68 65 20 76 61  separateCache va
5cd0: 72 69 61 62 6c 65 20 69 73 20 74 72 75 65 20 69  riable is true i
5ce0: 66 20 65 61 63 68 20 50 43 61 63 68 65 20 68 61  f each PCache ha
5cf0: 73 20 69 74 73 20 6f 77 6e 0a 20 20 2a 2a 20 70  s its own.  ** p
5d00: 72 69 76 61 74 65 20 50 47 72 6f 75 70 20 28 6d  rivate PGroup (m
5d10: 6f 64 65 2d 31 29 2e 20 20 70 63 61 63 68 65 31  ode-1).  pcache1
5d20: 2e 73 65 70 61 72 61 74 65 43 61 63 68 65 20 69  .separateCache i
5d30: 73 20 66 61 6c 73 65 20 69 66 20 74 68 65 20 73  s false if the s
5d40: 69 6e 67 6c 65 0a 20 20 2a 2a 20 50 47 72 6f 75  ingle.  ** PGrou
5d50: 70 20 69 6e 20 70 63 61 63 68 65 31 2e 67 72 70  p in pcache1.grp
5d60: 20 69 73 20 75 73 65 64 20 66 6f 72 20 61 6c 6c   is used for all
5d70: 20 70 61 67 65 20 63 61 63 68 65 73 20 28 6d 6f   page caches (mo
5d80: 64 65 2d 32 29 2e 0a 20 20 2a 2a 0a 20 20 2a 2a  de-2)..  **.  **
5d90: 20 20 20 2a 20 20 41 6c 77 61 79 73 20 75 73 65     *  Always use
5da0: 20 61 20 75 6e 69 66 69 65 64 20 63 61 63 68 65   a unified cache
5db0: 20 28 6d 6f 64 65 2d 32 29 20 69 66 20 45 4e 41   (mode-2) if ENA
5dc0: 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47  BLE_MEMORY_MANAG
5dd0: 45 4d 45 4e 54 0a 20 20 2a 2a 0a 20 20 2a 2a 20  EMENT.  **.  ** 
5de0: 20 20 2a 20 20 55 73 65 20 61 20 75 6e 69 66 69    *  Use a unifi
5df0: 65 64 20 63 61 63 68 65 20 69 6e 20 73 69 6e 67  ed cache in sing
5e00: 6c 65 2d 74 68 72 65 61 64 65 64 20 61 70 70 6c  le-threaded appl
5e10: 69 63 61 74 69 6f 6e 73 20 74 68 61 74 20 68 61  ications that ha
5e20: 76 65 0a 20 20 2a 2a 20 20 20 20 20 20 63 6f 6e  ve.  **      con
5e30: 66 69 67 75 72 65 64 20 61 20 73 74 61 72 74 2d  figured a start-
5e40: 74 69 6d 65 20 62 75 66 66 65 72 20 66 6f 72 20  time buffer for 
5e50: 75 73 65 20 61 73 20 70 61 67 65 2d 63 61 63 68  use as page-cach
5e60: 65 20 6d 65 6d 6f 72 79 20 75 73 69 6e 67 0a 20  e memory using. 
5e70: 20 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 65 33   **      sqlite3
5e80: 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f 43  _config(SQLITE_C
5e90: 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45 2c  ONFIG_PAGECACHE,
5ea0: 20 70 42 75 66 2c 20 73 7a 2c 20 4e 29 20 77 69   pBuf, sz, N) wi
5eb0: 74 68 20 6e 6f 6e 2d 4e 55 4c 4c 20 0a 20 20 2a  th non-NULL .  *
5ec0: 2a 20 20 20 20 20 20 70 42 75 66 20 61 72 67 75  *      pBuf argu
5ed0: 6d 65 6e 74 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20  ment..  **.  ** 
5ee0: 20 20 2a 20 20 4f 74 68 65 72 77 69 73 65 20 75    *  Otherwise u
5ef0: 73 65 20 73 65 70 61 72 61 74 65 20 63 61 63 68  se separate cach
5f00: 65 73 20 28 6d 6f 64 65 2d 31 29 0a 20 20 2a 2f  es (mode-1).  */
5f10: 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c  .#if defined(SQL
5f20: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52  ITE_ENABLE_MEMOR
5f30: 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 29 0a 20 20  Y_MANAGEMENT).  
5f40: 70 63 61 63 68 65 31 2e 73 65 70 61 72 61 74 65  pcache1.separate
5f50: 43 61 63 68 65 20 3d 20 30 3b 0a 23 65 6c 69 66  Cache = 0;.#elif
5f60: 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41   SQLITE_THREADSA
5f70: 46 45 0a 20 20 70 63 61 63 68 65 31 2e 73 65 70  FE.  pcache1.sep
5f80: 61 72 61 74 65 43 61 63 68 65 20 3d 20 73 71 6c  arateCache = sql
5f90: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67  ite3GlobalConfig
5fa0: 2e 70 50 61 67 65 3d 3d 30 0a 20 20 20 20 20 20  .pPage==0.      
5fb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5fc0: 20 20 20 20 7c 7c 20 73 71 6c 69 74 65 33 47 6c      || sqlite3Gl
5fd0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65  obalConfig.bCore
5fe0: 4d 75 74 65 78 3e 30 3b 0a 23 65 6c 73 65 0a 20  Mutex>0;.#else. 
5ff0: 20 70 63 61 63 68 65 31 2e 73 65 70 61 72 61 74   pcache1.separat
6000: 65 43 61 63 68 65 20 3d 20 73 71 6c 69 74 65 33  eCache = sqlite3
6010: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61  GlobalConfig.pPa
6020: 67 65 3d 3d 30 3b 0a 23 65 6e 64 69 66 0a 0a 23  ge==0;.#endif..#
6030: 69 66 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44  if SQLITE_THREAD
6040: 53 41 46 45 0a 20 20 69 66 28 20 73 71 6c 69 74  SAFE.  if( sqlit
6050: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62  e3GlobalConfig.b
6060: 43 6f 72 65 4d 75 74 65 78 20 29 7b 0a 20 20 20  CoreMutex ){.   
6070: 20 70 63 61 63 68 65 31 2e 67 72 70 2e 6d 75 74   pcache1.grp.mut
6080: 65 78 20 3d 20 73 71 6c 69 74 65 33 5f 6d 75 74  ex = sqlite3_mut
6090: 65 78 5f 61 6c 6c 6f 63 28 53 51 4c 49 54 45 5f  ex_alloc(SQLITE_
60a0: 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c 52 55  MUTEX_STATIC_LRU
60b0: 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 6d  );.    pcache1.m
60c0: 75 74 65 78 20 3d 20 73 71 6c 69 74 65 33 5f 6d  utex = sqlite3_m
60d0: 75 74 65 78 5f 61 6c 6c 6f 63 28 53 51 4c 49 54  utex_alloc(SQLIT
60e0: 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 50  E_MUTEX_STATIC_P
60f0: 4d 45 4d 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66  MEM);.  }.#endif
6100: 0a 20 20 69 66 28 20 70 63 61 63 68 65 31 2e 73  .  if( pcache1.s
6110: 65 70 61 72 61 74 65 43 61 63 68 65 0a 20 20 20  eparateCache.   
6120: 26 26 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c  && sqlite3Global
6130: 43 6f 6e 66 69 67 2e 6e 50 61 67 65 21 3d 30 0a  Config.nPage!=0.
6140: 20 20 20 26 26 20 73 71 6c 69 74 65 33 47 6c 6f     && sqlite3Glo
6150: 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65 3d  balConfig.pPage=
6160: 3d 30 0a 20 20 29 7b 0a 20 20 20 20 70 63 61 63  =0.  ){.    pcac
6170: 68 65 31 2e 6e 49 6e 69 74 50 61 67 65 20 3d 20  he1.nInitPage = 
6180: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
6190: 66 69 67 2e 6e 50 61 67 65 3b 0a 20 20 7d 65 6c  fig.nPage;.  }el
61a0: 73 65 7b 0a 20 20 20 20 70 63 61 63 68 65 31 2e  se{.    pcache1.
61b0: 6e 49 6e 69 74 50 61 67 65 20 3d 20 30 3b 0a 20  nInitPage = 0;. 
61c0: 20 7d 0a 20 20 70 63 61 63 68 65 31 2e 67 72 70   }.  pcache1.grp
61d0: 2e 6d 78 50 69 6e 6e 65 64 20 3d 20 31 30 3b 0a  .mxPinned = 10;.
61e0: 20 20 70 63 61 63 68 65 31 2e 69 73 49 6e 69 74    pcache1.isInit
61f0: 20 3d 20 31 3b 0a 20 20 72 65 74 75 72 6e 20 53   = 1;.  return S
6200: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a  QLITE_OK;.}../*.
6210: 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  ** Implementatio
6220: 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33  n of the sqlite3
6230: 5f 70 63 61 63 68 65 2e 78 53 68 75 74 64 6f 77  _pcache.xShutdow
6240: 6e 20 6d 65 74 68 6f 64 2e 0a 2a 2a 20 4e 6f 74  n method..** Not
6250: 65 20 74 68 61 74 20 74 68 65 20 73 74 61 74 69  e that the stati
6260: 63 20 6d 75 74 65 78 20 61 6c 6c 6f 63 61 74 65  c mutex allocate
6270: 64 20 69 6e 20 78 49 6e 69 74 20 64 6f 65 73 20  d in xInit does 
6280: 0a 2a 2a 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20  .** not need to 
6290: 62 65 20 66 72 65 65 64 2e 0a 2a 2f 0a 73 74 61  be freed..*/.sta
62a0: 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31  tic void pcache1
62b0: 53 68 75 74 64 6f 77 6e 28 76 6f 69 64 20 2a 4e  Shutdown(void *N
62c0: 6f 74 55 73 65 64 29 7b 0a 20 20 55 4e 55 53 45  otUsed){.  UNUSE
62d0: 44 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f 74 55  D_PARAMETER(NotU
62e0: 73 65 64 29 3b 0a 20 20 61 73 73 65 72 74 28 20  sed);.  assert( 
62f0: 70 63 61 63 68 65 31 2e 69 73 49 6e 69 74 21 3d  pcache1.isInit!=
6300: 30 20 29 3b 0a 20 20 6d 65 6d 73 65 74 28 26 70  0 );.  memset(&p
6310: 63 61 63 68 65 31 2c 20 30 2c 20 73 69 7a 65 6f  cache1, 0, sizeo
6320: 66 28 70 63 61 63 68 65 31 29 29 3b 0a 7d 0a 0a  f(pcache1));.}..
6330: 2f 2a 20 66 6f 72 77 61 72 64 20 64 65 63 6c 61  /* forward decla
6340: 72 61 74 69 6f 6e 20 2a 2f 0a 73 74 61 74 69 63  ration */.static
6350: 20 76 6f 69 64 20 70 63 61 63 68 65 31 44 65 73   void pcache1Des
6360: 74 72 6f 79 28 73 71 6c 69 74 65 33 5f 70 63 61  troy(sqlite3_pca
6370: 63 68 65 20 2a 70 29 3b 0a 0a 2f 2a 0a 2a 2a 20  che *p);../*.** 
6380: 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  Implementation o
6390: 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63  f the sqlite3_pc
63a0: 61 63 68 65 2e 78 43 72 65 61 74 65 20 6d 65 74  ache.xCreate met
63b0: 68 6f 64 2e 0a 2a 2a 0a 2a 2a 20 41 6c 6c 6f 63  hod..**.** Alloc
63c0: 61 74 65 20 61 20 6e 65 77 20 63 61 63 68 65 2e  ate a new cache.
63d0: 0a 2a 2f 0a 73 74 61 74 69 63 20 73 71 6c 69 74  .*/.static sqlit
63e0: 65 33 5f 70 63 61 63 68 65 20 2a 70 63 61 63 68  e3_pcache *pcach
63f0: 65 31 43 72 65 61 74 65 28 69 6e 74 20 73 7a 50  e1Create(int szP
6400: 61 67 65 2c 20 69 6e 74 20 73 7a 45 78 74 72 61  age, int szExtra
6410: 2c 20 69 6e 74 20 62 50 75 72 67 65 61 62 6c 65  , int bPurgeable
6420: 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43  ){.  PCache1 *pC
6430: 61 63 68 65 3b 20 20 20 20 20 20 2f 2a 20 54 68  ache;      /* Th
6440: 65 20 6e 65 77 6c 79 20 63 72 65 61 74 65 64 20  e newly created 
6450: 70 61 67 65 20 63 61 63 68 65 20 2a 2f 0a 20 20  page cache */.  
6460: 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70 3b 20  PGroup *pGroup; 
6470: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 67 72 6f        /* The gro
6480: 75 70 20 74 68 65 20 6e 65 77 20 70 61 67 65 20  up the new page 
6490: 63 61 63 68 65 20 77 69 6c 6c 20 62 65 6c 6f 6e  cache will belon
64a0: 67 20 74 6f 20 2a 2f 0a 20 20 69 6e 74 20 73 7a  g to */.  int sz
64b0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
64c0: 2f 2a 20 42 79 74 65 73 20 6f 66 20 6d 65 6d 6f  /* Bytes of memo
64d0: 72 79 20 72 65 71 75 69 72 65 64 20 74 6f 20 61  ry required to a
64e0: 6c 6c 6f 63 61 74 65 20 74 68 65 20 6e 65 77 20  llocate the new 
64f0: 63 61 63 68 65 20 2a 2f 0a 0a 20 20 61 73 73 65  cache */..  asse
6500: 72 74 28 20 28 73 7a 50 61 67 65 20 26 20 28 73  rt( (szPage & (s
6510: 7a 50 61 67 65 2d 31 29 29 3d 3d 30 20 26 26 20  zPage-1))==0 && 
6520: 73 7a 50 61 67 65 3e 3d 35 31 32 20 26 26 20 73  szPage>=512 && s
6530: 7a 50 61 67 65 3c 3d 36 35 35 33 36 20 29 3b 0a  zPage<=65536 );.
6540: 20 20 61 73 73 65 72 74 28 20 73 7a 45 78 74 72    assert( szExtr
6550: 61 20 3c 20 33 30 30 20 29 3b 0a 0a 20 20 73 7a  a < 300 );..  sz
6560: 20 3d 20 73 69 7a 65 6f 66 28 50 43 61 63 68 65   = sizeof(PCache
6570: 31 29 20 2b 20 73 69 7a 65 6f 66 28 50 47 72 6f  1) + sizeof(PGro
6580: 75 70 29 2a 70 63 61 63 68 65 31 2e 73 65 70 61  up)*pcache1.sepa
6590: 72 61 74 65 43 61 63 68 65 3b 0a 20 20 70 43 61  rateCache;.  pCa
65a0: 63 68 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a  che = (PCache1 *
65b0: 29 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a 65  )sqlite3MallocZe
65c0: 72 6f 28 73 7a 29 3b 0a 20 20 69 66 28 20 70 43  ro(sz);.  if( pC
65d0: 61 63 68 65 20 29 7b 0a 20 20 20 20 69 66 28 20  ache ){.    if( 
65e0: 70 63 61 63 68 65 31 2e 73 65 70 61 72 61 74 65  pcache1.separate
65f0: 43 61 63 68 65 20 29 7b 0a 20 20 20 20 20 20 70  Cache ){.      p
6600: 47 72 6f 75 70 20 3d 20 28 50 47 72 6f 75 70 2a  Group = (PGroup*
6610: 29 26 70 43 61 63 68 65 5b 31 5d 3b 0a 20 20 20  )&pCache[1];.   
6620: 20 20 20 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e     pGroup->mxPin
6630: 6e 65 64 20 3d 20 31 30 3b 0a 20 20 20 20 7d 65  ned = 10;.    }e
6640: 6c 73 65 7b 0a 20 20 20 20 20 20 70 47 72 6f 75  lse{.      pGrou
6650: 70 20 3d 20 26 70 63 61 63 68 65 31 2e 67 72 70  p = &pcache1.grp
6660: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20  ;.    }.    if( 
6670: 70 47 72 6f 75 70 2d 3e 6c 72 75 2e 69 73 41 6e  pGroup->lru.isAn
6680: 63 68 6f 72 3d 3d 30 20 29 7b 0a 20 20 20 20 20  chor==0 ){.     
6690: 20 70 47 72 6f 75 70 2d 3e 6c 72 75 2e 69 73 41   pGroup->lru.isA
66a0: 6e 63 68 6f 72 20 3d 20 31 3b 0a 20 20 20 20 20  nchor = 1;.     
66b0: 20 70 47 72 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72   pGroup->lru.pLr
66c0: 75 50 72 65 76 20 3d 20 70 47 72 6f 75 70 2d 3e  uPrev = pGroup->
66d0: 6c 72 75 2e 70 4c 72 75 4e 65 78 74 20 3d 20 26  lru.pLruNext = &
66e0: 70 47 72 6f 75 70 2d 3e 6c 72 75 3b 0a 20 20 20  pGroup->lru;.   
66f0: 20 7d 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 70   }.    pCache->p
6700: 47 72 6f 75 70 20 3d 20 70 47 72 6f 75 70 3b 0a  Group = pGroup;.
6710: 20 20 20 20 70 43 61 63 68 65 2d 3e 73 7a 50 61      pCache->szPa
6720: 67 65 20 3d 20 73 7a 50 61 67 65 3b 0a 20 20 20  ge = szPage;.   
6730: 20 70 43 61 63 68 65 2d 3e 73 7a 45 78 74 72 61   pCache->szExtra
6740: 20 3d 20 73 7a 45 78 74 72 61 3b 0a 20 20 20 20   = szExtra;.    
6750: 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63 20  pCache->szAlloc 
6760: 3d 20 73 7a 50 61 67 65 20 2b 20 73 7a 45 78 74  = szPage + szExt
6770: 72 61 20 2b 20 52 4f 55 4e 44 38 28 73 69 7a 65  ra + ROUND8(size
6780: 6f 66 28 50 67 48 64 72 31 29 29 3b 0a 20 20 20  of(PgHdr1));.   
6790: 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61   pCache->bPurgea
67a0: 62 6c 65 20 3d 20 28 62 50 75 72 67 65 61 62 6c  ble = (bPurgeabl
67b0: 65 20 3f 20 31 20 3a 20 30 29 3b 0a 20 20 20 20  e ? 1 : 0);.    
67c0: 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65  pcache1EnterMute
67d0: 78 28 70 47 72 6f 75 70 29 3b 0a 20 20 20 20 70  x(pGroup);.    p
67e0: 63 61 63 68 65 31 52 65 73 69 7a 65 48 61 73 68  cache1ResizeHash
67f0: 28 70 43 61 63 68 65 29 3b 0a 20 20 20 20 69 66  (pCache);.    if
6800: 28 20 62 50 75 72 67 65 61 62 6c 65 20 29 7b 0a  ( bPurgeable ){.
6810: 20 20 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 4d        pCache->nM
6820: 69 6e 20 3d 20 31 30 3b 0a 20 20 20 20 20 20 70  in = 10;.      p
6830: 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 20  Group->nMinPage 
6840: 2b 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 3b  += pCache->nMin;
6850: 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e 6d  .      pGroup->m
6860: 78 50 69 6e 6e 65 64 20 3d 20 70 47 72 6f 75 70  xPinned = pGroup
6870: 2d 3e 6e 4d 61 78 50 61 67 65 20 2b 20 31 30 20  ->nMaxPage + 10 
6880: 2d 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61  - pGroup->nMinPa
6890: 67 65 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 63  ge;.    }.    pc
68a0: 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28  ache1LeaveMutex(
68b0: 70 47 72 6f 75 70 29 3b 0a 20 20 20 20 69 66 28  pGroup);.    if(
68c0: 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 3d 3d   pCache->nHash==
68d0: 30 20 29 7b 0a 20 20 20 20 20 20 70 63 61 63 68  0 ){.      pcach
68e0: 65 31 44 65 73 74 72 6f 79 28 28 73 71 6c 69 74  e1Destroy((sqlit
68f0: 65 33 5f 70 63 61 63 68 65 2a 29 70 43 61 63 68  e3_pcache*)pCach
6900: 65 29 3b 0a 20 20 20 20 20 20 70 43 61 63 68 65  e);.      pCache
6910: 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a   = 0;.    }.  }.
6920: 20 20 72 65 74 75 72 6e 20 28 73 71 6c 69 74 65    return (sqlite
6930: 33 5f 70 63 61 63 68 65 20 2a 29 70 43 61 63 68  3_pcache *)pCach
6940: 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c  e;.}../*.** Impl
6950: 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68  ementation of th
6960: 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65  e sqlite3_pcache
6970: 2e 78 43 61 63 68 65 73 69 7a 65 20 6d 65 74 68  .xCachesize meth
6980: 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 43 6f 6e 66 69  od. .**.** Confi
6990: 67 75 72 65 20 74 68 65 20 63 61 63 68 65 5f 73  gure the cache_s
69a0: 69 7a 65 20 6c 69 6d 69 74 20 66 6f 72 20 61 20  ize limit for a 
69b0: 63 61 63 68 65 2e 0a 2a 2f 0a 73 74 61 74 69 63  cache..*/.static
69c0: 20 76 6f 69 64 20 70 63 61 63 68 65 31 43 61 63   void pcache1Cac
69d0: 68 65 73 69 7a 65 28 73 71 6c 69 74 65 33 5f 70  hesize(sqlite3_p
69e0: 63 61 63 68 65 20 2a 70 2c 20 69 6e 74 20 6e 4d  cache *p, int nM
69f0: 61 78 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a  ax){.  PCache1 *
6a00: 70 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 65  pCache = (PCache
6a10: 31 20 2a 29 70 3b 0a 20 20 69 66 28 20 70 43 61  1 *)p;.  if( pCa
6a20: 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20  che->bPurgeable 
6a30: 29 7b 0a 20 20 20 20 50 47 72 6f 75 70 20 2a 70  ){.    PGroup *p
6a40: 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65 2d 3e  Group = pCache->
6a50: 70 47 72 6f 75 70 3b 0a 20 20 20 20 70 63 61 63  pGroup;.    pcac
6a60: 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70 47  he1EnterMutex(pG
6a70: 72 6f 75 70 29 3b 0a 20 20 20 20 70 47 72 6f 75  roup);.    pGrou
6a80: 70 2d 3e 6e 4d 61 78 50 61 67 65 20 2b 3d 20 28  p->nMaxPage += (
6a90: 6e 4d 61 78 20 2d 20 70 43 61 63 68 65 2d 3e 6e  nMax - pCache->n
6aa0: 4d 61 78 29 3b 0a 20 20 20 20 70 47 72 6f 75 70  Max);.    pGroup
6ab0: 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 20 70 47 72  ->mxPinned = pGr
6ac0: 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 2b 20  oup->nMaxPage + 
6ad0: 31 30 20 2d 20 70 47 72 6f 75 70 2d 3e 6e 4d 69  10 - pGroup->nMi
6ae0: 6e 50 61 67 65 3b 0a 20 20 20 20 70 43 61 63 68  nPage;.    pCach
6af0: 65 2d 3e 6e 4d 61 78 20 3d 20 6e 4d 61 78 3b 0a  e->nMax = nMax;.
6b00: 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 39 30 70      pCache->n90p
6b10: 63 74 20 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 61  ct = pCache->nMa
6b20: 78 2a 39 2f 31 30 3b 0a 20 20 20 20 70 63 61 63  x*9/10;.    pcac
6b30: 68 65 31 45 6e 66 6f 72 63 65 4d 61 78 50 61 67  he1EnforceMaxPag
6b40: 65 28 70 43 61 63 68 65 29 3b 0a 20 20 20 20 70  e(pCache);.    p
6b50: 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78  cache1LeaveMutex
6b60: 28 70 47 72 6f 75 70 29 3b 0a 20 20 7d 0a 7d 0a  (pGroup);.  }.}.
6b70: 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74  ./*.** Implement
6b80: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c  ation of the sql
6b90: 69 74 65 33 5f 70 63 61 63 68 65 2e 78 53 68 72  ite3_pcache.xShr
6ba0: 69 6e 6b 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a  ink method. .**.
6bb0: 2a 2a 20 46 72 65 65 20 75 70 20 61 73 20 6d 75  ** Free up as mu
6bc0: 63 68 20 6d 65 6d 6f 72 79 20 61 73 20 70 6f 73  ch memory as pos
6bd0: 73 69 62 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63  sible..*/.static
6be0: 20 76 6f 69 64 20 70 63 61 63 68 65 31 53 68 72   void pcache1Shr
6bf0: 69 6e 6b 28 73 71 6c 69 74 65 33 5f 70 63 61 63  ink(sqlite3_pcac
6c00: 68 65 20 2a 70 29 7b 0a 20 20 50 43 61 63 68 65  he *p){.  PCache
6c10: 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61  1 *pCache = (PCa
6c20: 63 68 65 31 2a 29 70 3b 0a 20 20 69 66 28 20 70  che1*)p;.  if( p
6c30: 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c  Cache->bPurgeabl
6c40: 65 20 29 7b 0a 20 20 20 20 50 47 72 6f 75 70 20  e ){.    PGroup 
6c50: 2a 70 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65  *pGroup = pCache
6c60: 2d 3e 70 47 72 6f 75 70 3b 0a 20 20 20 20 69 6e  ->pGroup;.    in
6c70: 74 20 73 61 76 65 64 4d 61 78 50 61 67 65 3b 0a  t savedMaxPage;.
6c80: 20 20 20 20 70 63 61 63 68 65 31 45 6e 74 65 72      pcache1Enter
6c90: 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20  Mutex(pGroup);. 
6ca0: 20 20 20 73 61 76 65 64 4d 61 78 50 61 67 65 20     savedMaxPage 
6cb0: 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61  = pGroup->nMaxPa
6cc0: 67 65 3b 0a 20 20 20 20 70 47 72 6f 75 70 2d 3e  ge;.    pGroup->
6cd0: 6e 4d 61 78 50 61 67 65 20 3d 20 30 3b 0a 20 20  nMaxPage = 0;.  
6ce0: 20 20 70 63 61 63 68 65 31 45 6e 66 6f 72 63 65    pcache1Enforce
6cf0: 4d 61 78 50 61 67 65 28 70 43 61 63 68 65 29 3b  MaxPage(pCache);
6d00: 0a 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 61  .    pGroup->nMa
6d10: 78 50 61 67 65 20 3d 20 73 61 76 65 64 4d 61 78  xPage = savedMax
6d20: 50 61 67 65 3b 0a 20 20 20 20 70 63 61 63 68 65  Page;.    pcache
6d30: 31 4c 65 61 76 65 4d 75 74 65 78 28 70 47 72 6f  1LeaveMutex(pGro
6d40: 75 70 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a  up);.  }.}../*.*
6d50: 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  * Implementation
6d60: 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f   of the sqlite3_
6d70: 70 63 61 63 68 65 2e 78 50 61 67 65 63 6f 75 6e  pcache.xPagecoun
6d80: 74 20 6d 65 74 68 6f 64 2e 20 0a 2a 2f 0a 73 74  t method. .*/.st
6d90: 61 74 69 63 20 69 6e 74 20 70 63 61 63 68 65 31  atic int pcache1
6da0: 50 61 67 65 63 6f 75 6e 74 28 73 71 6c 69 74 65  Pagecount(sqlite
6db0: 33 5f 70 63 61 63 68 65 20 2a 70 29 7b 0a 20 20  3_pcache *p){.  
6dc0: 69 6e 74 20 6e 3b 0a 20 20 50 43 61 63 68 65 31  int n;.  PCache1
6dd0: 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61 63   *pCache = (PCac
6de0: 68 65 31 2a 29 70 3b 0a 20 20 70 63 61 63 68 65  he1*)p;.  pcache
6df0: 31 45 6e 74 65 72 4d 75 74 65 78 28 70 43 61 63  1EnterMutex(pCac
6e00: 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20 6e  he->pGroup);.  n
6e10: 20 3d 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65   = pCache->nPage
6e20: 3b 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76 65  ;.  pcache1Leave
6e30: 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47  Mutex(pCache->pG
6e40: 72 6f 75 70 29 3b 0a 20 20 72 65 74 75 72 6e 20  roup);.  return 
6e50: 6e 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70  n;.}.../*.** Imp
6e60: 6c 65 6d 65 6e 74 20 73 74 65 70 73 20 33 2c 20  lement steps 3, 
6e70: 34 2c 20 61 6e 64 20 35 20 6f 66 20 74 68 65 20  4, and 5 of the 
6e80: 70 63 61 63 68 65 31 46 65 74 63 68 28 29 20 61  pcache1Fetch() a
6e90: 6c 67 6f 72 69 74 68 6d 20 64 65 73 63 72 69 62  lgorithm describ
6ea0: 65 64 0a 2a 2a 20 69 6e 20 74 68 65 20 68 65 61  ed.** in the hea
6eb0: 64 65 72 20 6f 66 20 74 68 65 20 70 63 61 63 68  der of the pcach
6ec0: 65 31 46 65 74 63 68 28 29 20 70 72 6f 63 65 64  e1Fetch() proced
6ed0: 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20  ure..**.** This 
6ee0: 73 74 65 70 73 20 61 72 65 20 62 72 6f 6b 65 6e  steps are broken
6ef0: 20 6f 75 74 20 69 6e 74 6f 20 61 20 73 65 70 61   out into a sepa
6f00: 72 61 74 65 20 70 72 6f 63 65 64 75 72 65 20 62  rate procedure b
6f10: 65 63 61 75 73 65 20 74 68 65 79 20 61 72 65 0a  ecause they are.
6f20: 2a 2a 20 75 73 75 61 6c 6c 79 20 6e 6f 74 20 6e  ** usually not n
6f30: 65 65 64 65 64 2c 20 61 6e 64 20 62 79 20 61 76  eeded, and by av
6f40: 6f 69 64 69 6e 67 20 74 68 65 20 73 74 61 63 6b  oiding the stack
6f50: 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20   initialization 
6f60: 72 65 71 75 69 72 65 64 0a 2a 2a 20 66 6f 72 20  required.** for 
6f70: 74 68 65 73 65 20 73 74 65 70 73 2c 20 74 68 65  these steps, the
6f80: 20 6d 61 69 6e 20 70 63 61 63 68 65 31 46 65 74   main pcache1Fet
6f90: 63 68 28 29 20 70 72 6f 63 65 64 75 72 65 20 63  ch() procedure c
6fa0: 61 6e 20 72 75 6e 20 66 61 73 74 65 72 2e 0a 2a  an run faster..*
6fb0: 2f 0a 73 74 61 74 69 63 20 53 51 4c 49 54 45 5f  /.static SQLITE_
6fc0: 4e 4f 49 4e 4c 49 4e 45 20 50 67 48 64 72 31 20  NOINLINE PgHdr1 
6fd0: 2a 70 63 61 63 68 65 31 46 65 74 63 68 53 74 61  *pcache1FetchSta
6fe0: 67 65 32 28 0a 20 20 50 43 61 63 68 65 31 20 2a  ge2(.  PCache1 *
6ff0: 70 43 61 63 68 65 2c 20 0a 20 20 75 6e 73 69 67  pCache, .  unsig
7000: 6e 65 64 20 69 6e 74 20 69 4b 65 79 2c 20 0a 20  ned int iKey, . 
7010: 20 69 6e 74 20 63 72 65 61 74 65 46 6c 61 67 0a   int createFlag.
7020: 29 7b 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e  ){.  unsigned in
7030: 74 20 6e 50 69 6e 6e 65 64 3b 0a 20 20 50 47 72  t nPinned;.  PGr
7040: 6f 75 70 20 2a 70 47 72 6f 75 70 20 3d 20 70 43  oup *pGroup = pC
7050: 61 63 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20 20  ache->pGroup;.  
7060: 50 67 48 64 72 31 20 2a 70 50 61 67 65 20 3d 20  PgHdr1 *pPage = 
7070: 30 3b 0a 0a 20 20 2f 2a 20 53 74 65 70 20 33 3a  0;..  /* Step 3:
7080: 20 41 62 6f 72 74 20 69 66 20 63 72 65 61 74 65   Abort if create
7090: 46 6c 61 67 20 69 73 20 31 20 62 75 74 20 74 68  Flag is 1 but th
70a0: 65 20 63 61 63 68 65 20 69 73 20 6e 65 61 72 6c  e cache is nearl
70b0: 79 20 66 75 6c 6c 20 2a 2f 0a 20 20 61 73 73 65  y full */.  asse
70c0: 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 50 61 67  rt( pCache->nPag
70d0: 65 20 3e 3d 20 70 43 61 63 68 65 2d 3e 6e 52 65  e >= pCache->nRe
70e0: 63 79 63 6c 61 62 6c 65 20 29 3b 0a 20 20 6e 50  cyclable );.  nP
70f0: 69 6e 6e 65 64 20 3d 20 70 43 61 63 68 65 2d 3e  inned = pCache->
7100: 6e 50 61 67 65 20 2d 20 70 43 61 63 68 65 2d 3e  nPage - pCache->
7110: 6e 52 65 63 79 63 6c 61 62 6c 65 3b 0a 20 20 61  nRecyclable;.  a
7120: 73 73 65 72 74 28 20 70 47 72 6f 75 70 2d 3e 6d  ssert( pGroup->m
7130: 78 50 69 6e 6e 65 64 20 3d 3d 20 70 47 72 6f 75  xPinned == pGrou
7140: 70 2d 3e 6e 4d 61 78 50 61 67 65 20 2b 20 31 30  p->nMaxPage + 10
7150: 20 2d 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50   - pGroup->nMinP
7160: 61 67 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28  age );.  assert(
7170: 20 70 43 61 63 68 65 2d 3e 6e 39 30 70 63 74 20   pCache->n90pct 
7180: 3d 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 2a  == pCache->nMax*
7190: 39 2f 31 30 20 29 3b 0a 20 20 69 66 28 20 63 72  9/10 );.  if( cr
71a0: 65 61 74 65 46 6c 61 67 3d 3d 31 20 26 26 20 28  eateFlag==1 && (
71b0: 0a 20 20 20 20 20 20 20 20 6e 50 69 6e 6e 65 64  .        nPinned
71c0: 3e 3d 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e  >=pGroup->mxPinn
71d0: 65 64 0a 20 20 20 20 20 7c 7c 20 6e 50 69 6e 6e  ed.     || nPinn
71e0: 65 64 3e 3d 70 43 61 63 68 65 2d 3e 6e 39 30 70  ed>=pCache->n90p
71f0: 63 74 0a 20 20 20 20 20 7c 7c 20 28 70 63 61 63  ct.     || (pcac
7200: 68 65 31 55 6e 64 65 72 4d 65 6d 6f 72 79 50 72  he1UnderMemoryPr
7210: 65 73 73 75 72 65 28 70 43 61 63 68 65 29 20 26  essure(pCache) &
7220: 26 20 70 43 61 63 68 65 2d 3e 6e 52 65 63 79 63  & pCache->nRecyc
7230: 6c 61 62 6c 65 3c 6e 50 69 6e 6e 65 64 29 0a 20  lable<nPinned). 
7240: 20 29 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20   )){.    return 
7250: 30 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 43  0;.  }..  if( pC
7260: 61 63 68 65 2d 3e 6e 50 61 67 65 3e 3d 70 43 61  ache->nPage>=pCa
7270: 63 68 65 2d 3e 6e 48 61 73 68 20 29 20 70 63 61  che->nHash ) pca
7280: 63 68 65 31 52 65 73 69 7a 65 48 61 73 68 28 70  che1ResizeHash(p
7290: 43 61 63 68 65 29 3b 0a 20 20 61 73 73 65 72 74  Cache);.  assert
72a0: 28 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 3e  ( pCache->nHash>
72b0: 30 20 26 26 20 70 43 61 63 68 65 2d 3e 61 70 48  0 && pCache->apH
72c0: 61 73 68 20 29 3b 0a 0a 20 20 2f 2a 20 53 74 65  ash );..  /* Ste
72d0: 70 20 34 2e 20 54 72 79 20 74 6f 20 72 65 63 79  p 4. Try to recy
72e0: 63 6c 65 20 61 20 70 61 67 65 2e 20 2a 2f 0a 20  cle a page. */. 
72f0: 20 69 66 28 20 70 43 61 63 68 65 2d 3e 62 50 75   if( pCache->bPu
7300: 72 67 65 61 62 6c 65 0a 20 20 20 26 26 20 21 70  rgeable.   && !p
7310: 47 72 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72 75 50  Group->lru.pLruP
7320: 72 65 76 2d 3e 69 73 41 6e 63 68 6f 72 0a 20 20  rev->isAnchor.  
7330: 20 26 26 20 28 28 70 43 61 63 68 65 2d 3e 6e 50   && ((pCache->nP
7340: 61 67 65 2b 31 3e 3d 70 43 61 63 68 65 2d 3e 6e  age+1>=pCache->n
7350: 4d 61 78 29 20 7c 7c 20 70 63 61 63 68 65 31 55  Max) || pcache1U
7360: 6e 64 65 72 4d 65 6d 6f 72 79 50 72 65 73 73 75  nderMemoryPressu
7370: 72 65 28 70 43 61 63 68 65 29 29 0a 20 20 29 7b  re(pCache)).  ){
7380: 0a 20 20 20 20 50 43 61 63 68 65 31 20 2a 70 4f  .    PCache1 *pO
7390: 74 68 65 72 3b 0a 20 20 20 20 70 50 61 67 65 20  ther;.    pPage 
73a0: 3d 20 70 47 72 6f 75 70 2d 3e 6c 72 75 2e 70 4c  = pGroup->lru.pL
73b0: 72 75 50 72 65 76 3b 0a 20 20 20 20 61 73 73 65  ruPrev;.    asse
73c0: 72 74 28 20 70 50 61 67 65 2d 3e 69 73 50 69 6e  rt( pPage->isPin
73d0: 6e 65 64 3d 3d 30 20 29 3b 0a 20 20 20 20 70 63  ned==0 );.    pc
73e0: 61 63 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48  ache1RemoveFromH
73f0: 61 73 68 28 70 50 61 67 65 2c 20 30 29 3b 0a 20  ash(pPage, 0);. 
7400: 20 20 20 70 63 61 63 68 65 31 50 69 6e 50 61 67     pcache1PinPag
7410: 65 28 70 50 61 67 65 29 3b 0a 20 20 20 20 70 4f  e(pPage);.    pO
7420: 74 68 65 72 20 3d 20 70 50 61 67 65 2d 3e 70 43  ther = pPage->pC
7430: 61 63 68 65 3b 0a 20 20 20 20 69 66 28 20 70 4f  ache;.    if( pO
7440: 74 68 65 72 2d 3e 73 7a 41 6c 6c 6f 63 20 21 3d  ther->szAlloc !=
7450: 20 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63   pCache->szAlloc
7460: 20 29 7b 0a 20 20 20 20 20 20 70 63 61 63 68 65   ){.      pcache
7470: 31 46 72 65 65 50 61 67 65 28 70 50 61 67 65 29  1FreePage(pPage)
7480: 3b 0a 20 20 20 20 20 20 70 50 61 67 65 20 3d 20  ;.      pPage = 
7490: 30 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  0;.    }else{.  
74a0: 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e 43 75 72      pGroup->nCur
74b0: 72 65 6e 74 50 61 67 65 20 2d 3d 20 28 70 4f 74  rentPage -= (pOt
74c0: 68 65 72 2d 3e 62 50 75 72 67 65 61 62 6c 65 20  her->bPurgeable 
74d0: 2d 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65  - pCache->bPurge
74e0: 61 62 6c 65 29 3b 0a 20 20 20 20 7d 0a 20 20 7d  able);.    }.  }
74f0: 0a 0a 20 20 2f 2a 20 53 74 65 70 20 35 2e 20 49  ..  /* Step 5. I
7500: 66 20 61 20 75 73 61 62 6c 65 20 70 61 67 65 20  f a usable page 
7510: 62 75 66 66 65 72 20 68 61 73 20 73 74 69 6c 6c  buffer has still
7520: 20 6e 6f 74 20 62 65 65 6e 20 66 6f 75 6e 64 2c   not been found,
7530: 20 0a 20 20 2a 2a 20 61 74 74 65 6d 70 74 20 74   .  ** attempt t
7540: 6f 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77  o allocate a new
7550: 20 6f 6e 65 2e 20 0a 20 20 2a 2f 0a 20 20 69 66   one. .  */.  if
7560: 28 20 21 70 50 61 67 65 20 29 7b 0a 20 20 20 20  ( !pPage ){.    
7570: 70 50 61 67 65 20 3d 20 70 63 61 63 68 65 31 41  pPage = pcache1A
7580: 6c 6c 6f 63 50 61 67 65 28 70 43 61 63 68 65 2c  llocPage(pCache,
7590: 20 63 72 65 61 74 65 46 6c 61 67 3d 3d 31 29 3b   createFlag==1);
75a0: 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 50 61 67  .  }..  if( pPag
75b0: 65 20 29 7b 0a 20 20 20 20 75 6e 73 69 67 6e 65  e ){.    unsigne
75c0: 64 20 69 6e 74 20 68 20 3d 20 69 4b 65 79 20 25  d int h = iKey %
75d0: 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a   pCache->nHash;.
75e0: 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 50 61 67      pCache->nPag
75f0: 65 2b 2b 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e  e++;.    pPage->
7600: 69 4b 65 79 20 3d 20 69 4b 65 79 3b 0a 20 20 20  iKey = iKey;.   
7610: 20 70 50 61 67 65 2d 3e 70 4e 65 78 74 20 3d 20   pPage->pNext = 
7620: 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68  pCache->apHash[h
7630: 5d 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 70 43  ];.    pPage->pC
7640: 61 63 68 65 20 3d 20 70 43 61 63 68 65 3b 0a 20  ache = pCache;. 
7650: 20 20 20 70 50 61 67 65 2d 3e 70 4c 72 75 50 72     pPage->pLruPr
7660: 65 76 20 3d 20 30 3b 0a 20 20 20 20 70 50 61 67  ev = 0;.    pPag
7670: 65 2d 3e 70 4c 72 75 4e 65 78 74 20 3d 20 30 3b  e->pLruNext = 0;
7680: 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 73 50 69  .    pPage->isPi
7690: 6e 6e 65 64 20 3d 20 31 3b 0a 20 20 20 20 2a 28  nned = 1;.    *(
76a0: 76 6f 69 64 20 2a 2a 29 70 50 61 67 65 2d 3e 70  void **)pPage->p
76b0: 61 67 65 2e 70 45 78 74 72 61 20 3d 20 30 3b 0a  age.pExtra = 0;.
76c0: 20 20 20 20 70 43 61 63 68 65 2d 3e 61 70 48 61      pCache->apHa
76d0: 73 68 5b 68 5d 20 3d 20 70 50 61 67 65 3b 0a 20  sh[h] = pPage;. 
76e0: 20 20 20 69 66 28 20 69 4b 65 79 3e 70 43 61 63     if( iKey>pCac
76f0: 68 65 2d 3e 69 4d 61 78 4b 65 79 20 29 7b 0a 20  he->iMaxKey ){. 
7700: 20 20 20 20 20 70 43 61 63 68 65 2d 3e 69 4d 61       pCache->iMa
7710: 78 4b 65 79 20 3d 20 69 4b 65 79 3b 0a 20 20 20  xKey = iKey;.   
7720: 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20   }.  }.  return 
7730: 70 50 61 67 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  pPage;.}../*.** 
7740: 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  Implementation o
7750: 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63  f the sqlite3_pc
7760: 61 63 68 65 2e 78 46 65 74 63 68 20 6d 65 74 68  ache.xFetch meth
7770: 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 46 65 74 63 68  od. .**.** Fetch
7780: 20 61 20 70 61 67 65 20 62 79 20 6b 65 79 20 76   a page by key v
7790: 61 6c 75 65 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 74  alue..**.** Whet
77a0: 68 65 72 20 6f 72 20 6e 6f 74 20 61 20 6e 65 77  her or not a new
77b0: 20 70 61 67 65 20 6d 61 79 20 62 65 20 61 6c 6c   page may be all
77c0: 6f 63 61 74 65 64 20 62 79 20 74 68 69 73 20 66  ocated by this f
77d0: 75 6e 63 74 69 6f 6e 20 64 65 70 65 6e 64 73 20  unction depends 
77e0: 6f 6e 0a 2a 2a 20 74 68 65 20 76 61 6c 75 65 20  on.** the value 
77f0: 6f 66 20 74 68 65 20 63 72 65 61 74 65 46 6c 61  of the createFla
7800: 67 20 61 72 67 75 6d 65 6e 74 2e 20 20 30 20 6d  g argument.  0 m
7810: 65 61 6e 73 20 64 6f 20 6e 6f 74 20 61 6c 6c 6f  eans do not allo
7820: 63 61 74 65 20 61 20 6e 65 77 0a 2a 2a 20 70 61  cate a new.** pa
7830: 67 65 2e 20 20 31 20 6d 65 61 6e 73 20 61 6c 6c  ge.  1 means all
7840: 6f 63 61 74 65 20 61 20 6e 65 77 20 70 61 67 65  ocate a new page
7850: 20 69 66 20 73 70 61 63 65 20 69 73 20 65 61 73   if space is eas
7860: 69 6c 79 20 61 76 61 69 6c 61 62 6c 65 2e 20 20  ily available.  
7870: 32 20 0a 2a 2a 20 6d 65 61 6e 73 20 74 6f 20 74  2 .** means to t
7880: 72 79 20 72 65 61 6c 6c 79 20 68 61 72 64 20 74  ry really hard t
7890: 6f 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77  o allocate a new
78a0: 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72   page..**.** For
78b0: 20 61 20 6e 6f 6e 2d 70 75 72 67 65 61 62 6c 65   a non-purgeable
78c0: 20 63 61 63 68 65 20 28 61 20 63 61 63 68 65 20   cache (a cache 
78d0: 75 73 65 64 20 61 73 20 74 68 65 20 73 74 6f 72  used as the stor
78e0: 61 67 65 20 66 6f 72 20 61 6e 20 69 6e 2d 6d 65  age for an in-me
78f0: 6d 6f 72 79 0a 2a 2a 20 64 61 74 61 62 61 73 65  mory.** database
7900: 29 20 74 68 65 72 65 20 69 73 20 72 65 61 6c 6c  ) there is reall
7910: 79 20 6e 6f 20 64 69 66 66 65 72 65 6e 63 65 20  y no difference 
7920: 62 65 74 77 65 65 6e 20 63 72 65 61 74 65 46 6c  between createFl
7930: 61 67 20 31 20 61 6e 64 20 32 2e 20 20 53 6f 0a  ag 1 and 2.  So.
7940: 2a 2a 20 74 68 65 20 63 61 6c 6c 69 6e 67 20 66  ** the calling f
7950: 75 6e 63 74 69 6f 6e 20 28 70 63 61 63 68 65 2e  unction (pcache.
7960: 63 29 20 77 69 6c 6c 20 6e 65 76 65 72 20 68 61  c) will never ha
7970: 76 65 20 61 20 63 72 65 61 74 65 46 6c 61 67 20  ve a createFlag 
7980: 6f 66 20 31 20 6f 6e 0a 2a 2a 20 61 20 6e 6f 6e  of 1 on.** a non
7990: 2d 70 75 72 67 65 61 62 6c 65 20 63 61 63 68 65  -purgeable cache
79a0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 72 65 20 61 72  ..**.** There ar
79b0: 65 20 74 68 72 65 65 20 64 69 66 66 65 72 65 6e  e three differen
79c0: 74 20 61 70 70 72 6f 61 63 68 65 73 20 74 6f 20  t approaches to 
79d0: 6f 62 74 61 69 6e 69 6e 67 20 73 70 61 63 65 20  obtaining space 
79e0: 66 6f 72 20 61 20 70 61 67 65 2c 0a 2a 2a 20 64  for a page,.** d
79f0: 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20  epending on the 
7a00: 76 61 6c 75 65 20 6f 66 20 70 61 72 61 6d 65 74  value of paramet
7a10: 65 72 20 63 72 65 61 74 65 46 6c 61 67 20 28 77  er createFlag (w
7a20: 68 69 63 68 20 6d 61 79 20 62 65 20 30 2c 20 31  hich may be 0, 1
7a30: 20 6f 72 20 32 29 2e 0a 2a 2a 0a 2a 2a 20 20 20   or 2)..**.**   
7a40: 31 2e 20 52 65 67 61 72 64 6c 65 73 73 20 6f 66  1. Regardless of
7a50: 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 63 72   the value of cr
7a60: 65 61 74 65 46 6c 61 67 2c 20 74 68 65 20 63 61  eateFlag, the ca
7a70: 63 68 65 20 69 73 20 73 65 61 72 63 68 65 64 20  che is searched 
7a80: 66 6f 72 20 61 20 0a 2a 2a 20 20 20 20 20 20 63  for a .**      c
7a90: 6f 70 79 20 6f 66 20 74 68 65 20 72 65 71 75 65  opy of the reque
7aa0: 73 74 65 64 20 70 61 67 65 2e 20 49 66 20 6f 6e  sted page. If on
7ab0: 65 20 69 73 20 66 6f 75 6e 64 2c 20 69 74 20 69  e is found, it i
7ac0: 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a  s returned..**.*
7ad0: 2a 20 20 20 32 2e 20 49 66 20 63 72 65 61 74 65  *   2. If create
7ae0: 46 6c 61 67 3d 3d 30 20 61 6e 64 20 74 68 65 20  Flag==0 and the 
7af0: 70 61 67 65 20 69 73 20 6e 6f 74 20 61 6c 72 65  page is not alre
7b00: 61 64 79 20 69 6e 20 74 68 65 20 63 61 63 68 65  ady in the cache
7b10: 2c 20 4e 55 4c 4c 20 69 73 0a 2a 2a 20 20 20 20  , NULL is.**    
7b20: 20 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a    returned..**.*
7b30: 2a 20 20 20 33 2e 20 49 66 20 63 72 65 61 74 65  *   3. If create
7b40: 46 6c 61 67 20 69 73 20 31 2c 20 61 6e 64 20 74  Flag is 1, and t
7b50: 68 65 20 70 61 67 65 20 69 73 20 6e 6f 74 20 61  he page is not a
7b60: 6c 72 65 61 64 79 20 69 6e 20 74 68 65 20 63 61  lready in the ca
7b70: 63 68 65 2c 20 74 68 65 6e 0a 2a 2a 20 20 20 20  che, then.**    
7b80: 20 20 72 65 74 75 72 6e 20 4e 55 4c 4c 20 28 64    return NULL (d
7b90: 6f 20 6e 6f 74 20 61 6c 6c 6f 63 61 74 65 20 61  o not allocate a
7ba0: 20 6e 65 77 20 70 61 67 65 29 20 69 66 20 61 6e   new page) if an
7bb0: 79 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69  y of the followi
7bc0: 6e 67 0a 2a 2a 20 20 20 20 20 20 63 6f 6e 64 69  ng.**      condi
7bd0: 74 69 6f 6e 73 20 61 72 65 20 74 72 75 65 3a 0a  tions are true:.
7be0: 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 28 61 29 20  **.**       (a) 
7bf0: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61  the number of pa
7c00: 67 65 73 20 70 69 6e 6e 65 64 20 62 79 20 74 68  ges pinned by th
7c10: 65 20 63 61 63 68 65 20 69 73 20 67 72 65 61 74  e cache is great
7c20: 65 72 20 74 68 61 6e 0a 2a 2a 20 20 20 20 20 20  er than.**      
7c30: 20 20 20 20 20 50 43 61 63 68 65 31 2e 6e 4d 61       PCache1.nMa
7c40: 78 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 20 20 20 20  x, or.**.**     
7c50: 20 20 28 62 29 20 74 68 65 20 6e 75 6d 62 65 72    (b) the number
7c60: 20 6f 66 20 70 61 67 65 73 20 70 69 6e 6e 65 64   of pages pinned
7c70: 20 62 79 20 74 68 65 20 63 61 63 68 65 20 69 73   by the cache is
7c80: 20 67 72 65 61 74 65 72 20 74 68 61 6e 0a 2a 2a   greater than.**
7c90: 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 73             the s
7ca0: 75 6d 20 6f 66 20 6e 4d 61 78 20 66 6f 72 20 61  um of nMax for a
7cb0: 6c 6c 20 70 75 72 67 65 61 62 6c 65 20 63 61 63  ll purgeable cac
7cc0: 68 65 73 2c 20 6c 65 73 73 20 74 68 65 20 73 75  hes, less the su
7cd0: 6d 20 6f 66 20 0a 2a 2a 20 20 20 20 20 20 20 20  m of .**        
7ce0: 20 20 20 6e 4d 69 6e 20 66 6f 72 20 61 6c 6c 20     nMin for all 
7cf0: 6f 74 68 65 72 20 70 75 72 67 65 61 62 6c 65 20  other purgeable 
7d00: 63 61 63 68 65 73 2c 20 6f 72 0a 2a 2a 0a 2a 2a  caches, or.**.**
7d10: 20 20 20 34 2e 20 49 66 20 6e 6f 6e 65 20 6f 66     4. If none of
7d20: 20 74 68 65 20 66 69 72 73 74 20 74 68 72 65 65   the first three
7d30: 20 63 6f 6e 64 69 74 69 6f 6e 73 20 61 70 70 6c   conditions appl
7d40: 79 20 61 6e 64 20 74 68 65 20 63 61 63 68 65 20  y and the cache 
7d50: 69 73 20 6d 61 72 6b 65 64 0a 2a 2a 20 20 20 20  is marked.**    
7d60: 20 20 61 73 20 70 75 72 67 65 61 62 6c 65 2c 20    as purgeable, 
7d70: 61 6e 64 20 69 66 20 6f 6e 65 20 6f 66 20 74 68  and if one of th
7d80: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 73 20 74  e following is t
7d90: 72 75 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20  rue:.**.**      
7da0: 20 28 61 29 20 54 68 65 20 6e 75 6d 62 65 72 20   (a) The number 
7db0: 6f 66 20 70 61 67 65 73 20 61 6c 6c 6f 63 61 74  of pages allocat
7dc0: 65 64 20 66 6f 72 20 74 68 65 20 63 61 63 68 65  ed for the cache
7dd0: 20 69 73 20 61 6c 72 65 61 64 79 20 0a 2a 2a 20   is already .** 
7de0: 20 20 20 20 20 20 20 20 20 20 50 43 61 63 68 65            PCache
7df0: 31 2e 6e 4d 61 78 2c 20 6f 72 0a 2a 2a 0a 2a 2a  1.nMax, or.**.**
7e00: 20 20 20 20 20 20 20 28 62 29 20 54 68 65 20 6e         (b) The n
7e10: 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 61  umber of pages a
7e20: 6c 6c 6f 63 61 74 65 64 20 66 6f 72 20 61 6c 6c  llocated for all
7e30: 20 70 75 72 67 65 61 62 6c 65 20 63 61 63 68 65   purgeable cache
7e40: 73 20 69 73 0a 2a 2a 20 20 20 20 20 20 20 20 20  s is.**         
7e50: 20 20 61 6c 72 65 61 64 79 20 65 71 75 61 6c 20    already equal 
7e60: 74 6f 20 6f 72 20 67 72 65 61 74 65 72 20 74 68  to or greater th
7e70: 61 6e 20 74 68 65 20 73 75 6d 20 6f 66 20 6e 4d  an the sum of nM
7e80: 61 78 20 66 6f 72 20 61 6c 6c 0a 2a 2a 20 20 20  ax for all.**   
7e90: 20 20 20 20 20 20 20 20 70 75 72 67 65 61 62 6c          purgeabl
7ea0: 65 20 63 61 63 68 65 73 2c 0a 2a 2a 0a 2a 2a 20  e caches,.**.** 
7eb0: 20 20 20 20 20 20 28 63 29 20 54 68 65 20 73 79        (c) The sy
7ec0: 73 74 65 6d 20 69 73 20 75 6e 64 65 72 20 6d 65  stem is under me
7ed0: 6d 6f 72 79 20 70 72 65 73 73 75 72 65 20 61 6e  mory pressure an
7ee0: 64 20 77 61 6e 74 73 20 74 6f 20 61 76 6f 69 64  d wants to avoid
7ef0: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 75 6e  .**           un
7f00: 6e 65 63 65 73 73 61 72 79 20 70 61 67 65 73 20  necessary pages 
7f10: 63 61 63 68 65 20 65 6e 74 72 79 20 61 6c 6c 6f  cache entry allo
7f20: 63 61 74 69 6f 6e 73 0a 2a 2a 0a 2a 2a 20 20 20  cations.**.**   
7f30: 20 20 20 74 68 65 6e 20 61 74 74 65 6d 70 74 20     then attempt 
7f40: 74 6f 20 72 65 63 79 63 6c 65 20 61 20 70 61 67  to recycle a pag
7f50: 65 20 66 72 6f 6d 20 74 68 65 20 4c 52 55 20 6c  e from the LRU l
7f60: 69 73 74 2e 20 49 66 20 69 74 20 69 73 20 74 68  ist. If it is th
7f70: 65 20 72 69 67 68 74 0a 2a 2a 20 20 20 20 20 20  e right.**      
7f80: 73 69 7a 65 2c 20 72 65 74 75 72 6e 20 74 68 65  size, return the
7f90: 20 72 65 63 79 63 6c 65 64 20 62 75 66 66 65 72   recycled buffer
7fa0: 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 66 72 65  . Otherwise, fre
7fb0: 65 20 74 68 65 20 62 75 66 66 65 72 20 61 6e 64  e the buffer and
7fc0: 0a 2a 2a 20 20 20 20 20 20 70 72 6f 63 65 65 64  .**      proceed
7fd0: 20 74 6f 20 73 74 65 70 20 35 2e 20 0a 2a 2a 0a   to step 5. .**.
7fe0: 2a 2a 20 20 20 35 2e 20 4f 74 68 65 72 77 69 73  **   5. Otherwis
7ff0: 65 2c 20 61 6c 6c 6f 63 61 74 65 20 61 6e 64 20  e, allocate and 
8000: 72 65 74 75 72 6e 20 61 20 6e 65 77 20 70 61 67  return a new pag
8010: 65 20 62 75 66 66 65 72 2e 0a 2a 2a 0a 2a 2a 20  e buffer..**.** 
8020: 54 68 65 72 65 20 61 72 65 20 74 77 6f 20 76 65  There are two ve
8030: 72 73 69 6f 6e 73 20 6f 66 20 74 68 69 73 20 72  rsions of this r
8040: 6f 75 74 69 6e 65 2e 20 20 70 63 61 63 68 65 31  outine.  pcache1
8050: 46 65 74 63 68 57 69 74 68 4d 75 74 65 78 28 29  FetchWithMutex()
8060: 20 69 73 0a 2a 2a 20 74 68 65 20 67 65 6e 65 72   is.** the gener
8070: 61 6c 20 63 61 73 65 2e 20 20 70 63 61 63 68 65  al case.  pcache
8080: 31 46 65 74 63 68 4e 6f 4d 75 74 65 78 28 29 20  1FetchNoMutex() 
8090: 69 73 20 61 20 66 61 73 74 65 72 20 69 6d 70 6c  is a faster impl
80a0: 65 6d 65 6e 74 61 74 69 6f 6e 20 66 6f 72 0a 2a  ementation for.*
80b0: 2a 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 63 61 73  * the common cas
80c0: 65 20 77 68 65 72 65 20 70 47 72 6f 75 70 2d 3e  e where pGroup->
80d0: 6d 75 74 65 78 20 69 73 20 4e 55 4c 4c 2e 20 20  mutex is NULL.  
80e0: 54 68 65 20 70 63 61 63 68 65 31 46 65 74 63 68  The pcache1Fetch
80f0: 28 29 20 77 72 61 70 70 65 72 0a 2a 2a 20 69 6e  () wrapper.** in
8100: 76 6f 6b 65 73 20 74 68 65 20 61 70 70 72 6f 70  vokes the approp
8110: 72 69 61 74 65 20 72 6f 75 74 69 6e 65 2e 0a 2a  riate routine..*
8120: 2f 0a 73 74 61 74 69 63 20 50 67 48 64 72 31 20  /.static PgHdr1 
8130: 2a 70 63 61 63 68 65 31 46 65 74 63 68 4e 6f 4d  *pcache1FetchNoM
8140: 75 74 65 78 28 0a 20 20 73 71 6c 69 74 65 33 5f  utex(.  sqlite3_
8150: 70 63 61 63 68 65 20 2a 70 2c 20 0a 20 20 75 6e  pcache *p, .  un
8160: 73 69 67 6e 65 64 20 69 6e 74 20 69 4b 65 79 2c  signed int iKey,
8170: 20 0a 20 20 69 6e 74 20 63 72 65 61 74 65 46 6c   .  int createFl
8180: 61 67 0a 29 7b 0a 20 20 50 43 61 63 68 65 31 20  ag.){.  PCache1 
8190: 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61 63 68  *pCache = (PCach
81a0: 65 31 20 2a 29 70 3b 0a 20 20 50 67 48 64 72 31  e1 *)p;.  PgHdr1
81b0: 20 2a 70 50 61 67 65 20 3d 20 30 3b 0a 0a 20 20   *pPage = 0;..  
81c0: 2f 2a 20 53 74 65 70 20 31 3a 20 53 65 61 72 63  /* Step 1: Searc
81d0: 68 20 74 68 65 20 68 61 73 68 20 74 61 62 6c 65  h the hash table
81e0: 20 66 6f 72 20 61 6e 20 65 78 69 73 74 69 6e 67   for an existing
81f0: 20 65 6e 74 72 79 2e 20 2a 2f 0a 20 20 70 50 61   entry. */.  pPa
8200: 67 65 20 3d 20 70 43 61 63 68 65 2d 3e 61 70 48  ge = pCache->apH
8210: 61 73 68 5b 69 4b 65 79 20 25 20 70 43 61 63 68  ash[iKey % pCach
8220: 65 2d 3e 6e 48 61 73 68 5d 3b 0a 20 20 77 68 69  e->nHash];.  whi
8230: 6c 65 28 20 70 50 61 67 65 20 26 26 20 70 50 61  le( pPage && pPa
8240: 67 65 2d 3e 69 4b 65 79 21 3d 69 4b 65 79 20 29  ge->iKey!=iKey )
8250: 7b 20 70 50 61 67 65 20 3d 20 70 50 61 67 65 2d  { pPage = pPage-
8260: 3e 70 4e 65 78 74 3b 20 7d 0a 0a 20 20 2f 2a 20  >pNext; }..  /* 
8270: 53 74 65 70 20 32 3a 20 49 66 20 74 68 65 20 70  Step 2: If the p
8280: 61 67 65 20 77 61 73 20 66 6f 75 6e 64 20 69 6e  age was found in
8290: 20 74 68 65 20 68 61 73 68 20 74 61 62 6c 65 2c   the hash table,
82a0: 20 74 68 65 6e 20 72 65 74 75 72 6e 20 69 74 2e   then return it.
82b0: 0a 20 20 2a 2a 20 49 66 20 74 68 65 20 70 61 67  .  ** If the pag
82c0: 65 20 77 61 73 20 6e 6f 74 20 69 6e 20 74 68 65  e was not in the
82d0: 20 68 61 73 68 20 74 61 62 6c 65 20 61 6e 64 20   hash table and 
82e0: 63 72 65 61 74 65 46 6c 61 67 20 69 73 20 30 2c  createFlag is 0,
82f0: 20 61 62 6f 72 74 2e 0a 20 20 2a 2a 20 4f 74 68   abort..  ** Oth
8300: 65 72 77 69 73 65 20 28 70 61 67 65 20 6e 6f 74  erwise (page not
8310: 20 69 6e 20 68 61 73 68 20 61 6e 64 20 63 72 65   in hash and cre
8320: 61 74 65 46 6c 61 67 21 3d 30 29 20 63 6f 6e 74  ateFlag!=0) cont
8330: 69 6e 75 65 20 77 69 74 68 0a 20 20 2a 2a 20 73  inue with.  ** s
8340: 75 62 73 65 71 75 65 6e 74 20 73 74 65 70 73 20  ubsequent steps 
8350: 74 6f 20 74 72 79 20 74 6f 20 63 72 65 61 74 65  to try to create
8360: 20 74 68 65 20 70 61 67 65 2e 20 2a 2f 0a 20 20   the page. */.  
8370: 69 66 28 20 70 50 61 67 65 20 29 7b 0a 20 20 20  if( pPage ){.   
8380: 20 69 66 28 20 21 70 50 61 67 65 2d 3e 69 73 50   if( !pPage->isP
8390: 69 6e 6e 65 64 20 29 7b 0a 20 20 20 20 20 20 72  inned ){.      r
83a0: 65 74 75 72 6e 20 70 63 61 63 68 65 31 50 69 6e  eturn pcache1Pin
83b0: 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 20 20  Page(pPage);.   
83c0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 65   }else{.      re
83d0: 74 75 72 6e 20 70 50 61 67 65 3b 0a 20 20 20 20  turn pPage;.    
83e0: 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 63 72  }.  }else if( cr
83f0: 65 61 74 65 46 6c 61 67 20 29 7b 0a 20 20 20 20  eateFlag ){.    
8400: 2f 2a 20 53 74 65 70 73 20 33 2c 20 34 2c 20 61  /* Steps 3, 4, a
8410: 6e 64 20 35 20 69 6d 70 6c 65 6d 65 6e 74 65 64  nd 5 implemented
8420: 20 62 79 20 74 68 69 73 20 73 75 62 72 6f 75 74   by this subrout
8430: 69 6e 65 20 2a 2f 0a 20 20 20 20 72 65 74 75 72  ine */.    retur
8440: 6e 20 70 63 61 63 68 65 31 46 65 74 63 68 53 74  n pcache1FetchSt
8450: 61 67 65 32 28 70 43 61 63 68 65 2c 20 69 4b 65  age2(pCache, iKe
8460: 79 2c 20 63 72 65 61 74 65 46 6c 61 67 29 3b 0a  y, createFlag);.
8470: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 74    }else{.    ret
8480: 75 72 6e 20 30 3b 0a 20 20 7d 0a 7d 0a 23 69 66  urn 0;.  }.}.#if
8490: 20 50 43 41 43 48 45 31 5f 4d 49 47 48 54 5f 55   PCACHE1_MIGHT_U
84a0: 53 45 5f 47 52 4f 55 50 5f 4d 55 54 45 58 0a 73  SE_GROUP_MUTEX.s
84b0: 74 61 74 69 63 20 50 67 48 64 72 31 20 2a 70 63  tatic PgHdr1 *pc
84c0: 61 63 68 65 31 46 65 74 63 68 57 69 74 68 4d 75  ache1FetchWithMu
84d0: 74 65 78 28 0a 20 20 73 71 6c 69 74 65 33 5f 70  tex(.  sqlite3_p
84e0: 63 61 63 68 65 20 2a 70 2c 20 0a 20 20 75 6e 73  cache *p, .  uns
84f0: 69 67 6e 65 64 20 69 6e 74 20 69 4b 65 79 2c 20  igned int iKey, 
8500: 0a 20 20 69 6e 74 20 63 72 65 61 74 65 46 6c 61  .  int createFla
8510: 67 0a 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a  g.){.  PCache1 *
8520: 70 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 65  pCache = (PCache
8530: 31 20 2a 29 70 3b 0a 20 20 50 67 48 64 72 31 20  1 *)p;.  PgHdr1 
8540: 2a 70 50 61 67 65 3b 0a 0a 20 20 70 63 61 63 68  *pPage;..  pcach
8550: 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70 43 61  e1EnterMutex(pCa
8560: 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20  che->pGroup);.  
8570: 70 50 61 67 65 20 3d 20 70 63 61 63 68 65 31 46  pPage = pcache1F
8580: 65 74 63 68 4e 6f 4d 75 74 65 78 28 70 2c 20 69  etchNoMutex(p, i
8590: 4b 65 79 2c 20 63 72 65 61 74 65 46 6c 61 67 29  Key, createFlag)
85a0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67  ;.  assert( pPag
85b0: 65 3d 3d 30 20 7c 7c 20 70 43 61 63 68 65 2d 3e  e==0 || pCache->
85c0: 69 4d 61 78 4b 65 79 3e 3d 69 4b 65 79 20 29 3b  iMaxKey>=iKey );
85d0: 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d  .  pcache1LeaveM
85e0: 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72  utex(pCache->pGr
85f0: 6f 75 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 70  oup);.  return p
8600: 50 61 67 65 3b 0a 7d 0a 23 65 6e 64 69 66 0a 73  Page;.}.#endif.s
8610: 74 61 74 69 63 20 73 71 6c 69 74 65 33 5f 70 63  tatic sqlite3_pc
8620: 61 63 68 65 5f 70 61 67 65 20 2a 70 63 61 63 68  ache_page *pcach
8630: 65 31 46 65 74 63 68 28 0a 20 20 73 71 6c 69 74  e1Fetch(.  sqlit
8640: 65 33 5f 70 63 61 63 68 65 20 2a 70 2c 20 0a 20  e3_pcache *p, . 
8650: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4b   unsigned int iK
8660: 65 79 2c 20 0a 20 20 69 6e 74 20 63 72 65 61 74  ey, .  int creat
8670: 65 46 6c 61 67 0a 29 7b 0a 23 69 66 20 50 43 41  eFlag.){.#if PCA
8680: 43 48 45 31 5f 4d 49 47 48 54 5f 55 53 45 5f 47  CHE1_MIGHT_USE_G
8690: 52 4f 55 50 5f 4d 55 54 45 58 20 7c 7c 20 64 65  ROUP_MUTEX || de
86a0: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 42  fined(SQLITE_DEB
86b0: 55 47 29 0a 20 20 50 43 61 63 68 65 31 20 2a 70  UG).  PCache1 *p
86c0: 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 65 31  Cache = (PCache1
86d0: 20 2a 29 70 3b 0a 23 65 6e 64 69 66 0a 0a 20 20   *)p;.#endif..  
86e0: 61 73 73 65 72 74 28 20 6f 66 66 73 65 74 6f 66  assert( offsetof
86f0: 28 50 67 48 64 72 31 2c 70 61 67 65 29 3d 3d 30  (PgHdr1,page)==0
8700: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43   );.  assert( pC
8710: 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65  ache->bPurgeable
8720: 20 7c 7c 20 63 72 65 61 74 65 46 6c 61 67 21 3d   || createFlag!=
8730: 31 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  1 );.  assert( p
8740: 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c  Cache->bPurgeabl
8750: 65 20 7c 7c 20 70 43 61 63 68 65 2d 3e 6e 4d 69  e || pCache->nMi
8760: 6e 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74  n==0 );.  assert
8770: 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65  ( pCache->bPurge
8780: 61 62 6c 65 3d 3d 30 20 7c 7c 20 70 43 61 63 68  able==0 || pCach
8790: 65 2d 3e 6e 4d 69 6e 3d 3d 31 30 20 29 3b 0a 20  e->nMin==10 );. 
87a0: 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65 2d   assert( pCache-
87b0: 3e 6e 4d 69 6e 3d 3d 30 20 7c 7c 20 70 43 61 63  >nMin==0 || pCac
87c0: 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 29  he->bPurgeable )
87d0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63  ;.  assert( pCac
87e0: 68 65 2d 3e 6e 48 61 73 68 3e 30 20 29 3b 0a 23  he->nHash>0 );.#
87f0: 69 66 20 50 43 41 43 48 45 31 5f 4d 49 47 48 54  if PCACHE1_MIGHT
8800: 5f 55 53 45 5f 47 52 4f 55 50 5f 4d 55 54 45 58  _USE_GROUP_MUTEX
8810: 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e 70  .  if( pCache->p
8820: 47 72 6f 75 70 2d 3e 6d 75 74 65 78 20 29 7b 0a  Group->mutex ){.
8830: 20 20 20 20 72 65 74 75 72 6e 20 28 73 71 6c 69      return (sqli
8840: 74 65 33 5f 70 63 61 63 68 65 5f 70 61 67 65 2a  te3_pcache_page*
8850: 29 70 63 61 63 68 65 31 46 65 74 63 68 57 69 74  )pcache1FetchWit
8860: 68 4d 75 74 65 78 28 70 2c 20 69 4b 65 79 2c 20  hMutex(p, iKey, 
8870: 63 72 65 61 74 65 46 6c 61 67 29 3b 0a 20 20 7d  createFlag);.  }
8880: 65 6c 73 65 0a 23 65 6e 64 69 66 0a 20 20 7b 0a  else.#endif.  {.
8890: 20 20 20 20 72 65 74 75 72 6e 20 28 73 71 6c 69      return (sqli
88a0: 74 65 33 5f 70 63 61 63 68 65 5f 70 61 67 65 2a  te3_pcache_page*
88b0: 29 70 63 61 63 68 65 31 46 65 74 63 68 4e 6f 4d  )pcache1FetchNoM
88c0: 75 74 65 78 28 70 2c 20 69 4b 65 79 2c 20 63 72  utex(p, iKey, cr
88d0: 65 61 74 65 46 6c 61 67 29 3b 0a 20 20 7d 0a 7d  eateFlag);.  }.}
88e0: 0a 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65  .../*.** Impleme
88f0: 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73  ntation of the s
8900: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78 55  qlite3_pcache.xU
8910: 6e 70 69 6e 20 6d 65 74 68 6f 64 2e 0a 2a 2a 0a  npin method..**.
8920: 2a 2a 20 4d 61 72 6b 20 61 20 70 61 67 65 20 61  ** Mark a page a
8930: 73 20 75 6e 70 69 6e 6e 65 64 20 28 65 6c 69 67  s unpinned (elig
8940: 69 62 6c 65 20 66 6f 72 20 61 73 79 6e 63 68 72  ible for asynchr
8950: 6f 6e 6f 75 73 20 72 65 63 79 63 6c 69 6e 67 29  onous recycling)
8960: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
8970: 20 70 63 61 63 68 65 31 55 6e 70 69 6e 28 0a 20   pcache1Unpin(. 
8980: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20   sqlite3_pcache 
8990: 2a 70 2c 20 0a 20 20 73 71 6c 69 74 65 33 5f 70  *p, .  sqlite3_p
89a0: 63 61 63 68 65 5f 70 61 67 65 20 2a 70 50 67 2c  cache_page *pPg,
89b0: 20 0a 20 20 69 6e 74 20 72 65 75 73 65 55 6e 6c   .  int reuseUnl
89c0: 69 6b 65 6c 79 0a 29 7b 0a 20 20 50 43 61 63 68  ikely.){.  PCach
89d0: 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43  e1 *pCache = (PC
89e0: 61 63 68 65 31 20 2a 29 70 3b 0a 20 20 50 67 48  ache1 *)p;.  PgH
89f0: 64 72 31 20 2a 70 50 61 67 65 20 3d 20 28 50 67  dr1 *pPage = (Pg
8a00: 48 64 72 31 20 2a 29 70 50 67 3b 0a 20 20 50 47  Hdr1 *)pPg;.  PG
8a10: 72 6f 75 70 20 2a 70 47 72 6f 75 70 20 3d 20 70  roup *pGroup = p
8a20: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20  Cache->pGroup;. 
8a30: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65  .  assert( pPage
8a40: 2d 3e 70 43 61 63 68 65 3d 3d 70 43 61 63 68 65  ->pCache==pCache
8a50: 20 29 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 74   );.  pcache1Ent
8a60: 65 72 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b  erMutex(pGroup);
8a70: 0a 0a 20 20 2f 2a 20 49 74 20 69 73 20 61 6e 20  ..  /* It is an 
8a80: 65 72 72 6f 72 20 74 6f 20 63 61 6c 6c 20 74 68  error to call th
8a90: 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 66 20 74  is function if t
8aa0: 68 65 20 70 61 67 65 20 69 73 20 61 6c 72 65 61  he page is alrea
8ab0: 64 79 20 0a 20 20 2a 2a 20 70 61 72 74 20 6f 66  dy .  ** part of
8ac0: 20 74 68 65 20 50 47 72 6f 75 70 20 4c 52 55 20   the PGroup LRU 
8ad0: 6c 69 73 74 2e 0a 20 20 2a 2f 0a 20 20 61 73 73  list..  */.  ass
8ae0: 65 72 74 28 20 70 50 61 67 65 2d 3e 70 4c 72 75  ert( pPage->pLru
8af0: 50 72 65 76 3d 3d 30 20 26 26 20 70 50 61 67 65  Prev==0 && pPage
8b00: 2d 3e 70 4c 72 75 4e 65 78 74 3d 3d 30 20 29 3b  ->pLruNext==0 );
8b10: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65  .  assert( pPage
8b20: 2d 3e 69 73 50 69 6e 6e 65 64 3d 3d 31 20 29 3b  ->isPinned==1 );
8b30: 0a 0a 20 20 69 66 28 20 72 65 75 73 65 55 6e 6c  ..  if( reuseUnl
8b40: 69 6b 65 6c 79 20 7c 7c 20 70 47 72 6f 75 70 2d  ikely || pGroup-
8b50: 3e 6e 43 75 72 72 65 6e 74 50 61 67 65 3e 70 47  >nCurrentPage>pG
8b60: 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 29  roup->nMaxPage )
8b70: 7b 0a 20 20 20 20 70 63 61 63 68 65 31 52 65 6d  {.    pcache1Rem
8b80: 6f 76 65 46 72 6f 6d 48 61 73 68 28 70 50 61 67  oveFromHash(pPag
8b90: 65 2c 20 31 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a  e, 1);.  }else{.
8ba0: 20 20 20 20 2f 2a 20 41 64 64 20 74 68 65 20 70      /* Add the p
8bb0: 61 67 65 20 74 6f 20 74 68 65 20 50 47 72 6f 75  age to the PGrou
8bc0: 70 20 4c 52 55 20 6c 69 73 74 2e 20 2a 2f 0a 20  p LRU list. */. 
8bd0: 20 20 20 50 67 48 64 72 31 20 2a 2a 70 70 46 69     PgHdr1 **ppFi
8be0: 72 73 74 20 3d 20 26 70 47 72 6f 75 70 2d 3e 6c  rst = &pGroup->l
8bf0: 72 75 2e 70 4c 72 75 4e 65 78 74 3b 0a 20 20 20  ru.pLruNext;.   
8c00: 20 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76   pPage->pLruPrev
8c10: 20 3d 20 26 70 47 72 6f 75 70 2d 3e 6c 72 75 3b   = &pGroup->lru;
8c20: 0a 20 20 20 20 28 70 50 61 67 65 2d 3e 70 4c 72  .    (pPage->pLr
8c30: 75 4e 65 78 74 20 3d 20 2a 70 70 46 69 72 73 74  uNext = *ppFirst
8c40: 29 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20 70 50  )->pLruPrev = pP
8c50: 61 67 65 3b 0a 20 20 20 20 2a 70 70 46 69 72 73  age;.    *ppFirs
8c60: 74 20 3d 20 70 50 61 67 65 3b 0a 20 20 20 20 70  t = pPage;.    p
8c70: 43 61 63 68 65 2d 3e 6e 52 65 63 79 63 6c 61 62  Cache->nRecyclab
8c80: 6c 65 2b 2b 3b 0a 20 20 20 20 70 50 61 67 65 2d  le++;.    pPage-
8c90: 3e 69 73 50 69 6e 6e 65 64 20 3d 20 30 3b 0a 20  >isPinned = 0;. 
8ca0: 20 7d 0a 0a 20 20 70 63 61 63 68 65 31 4c 65 61   }..  pcache1Lea
8cb0: 76 65 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e  veMutex(pCache->
8cc0: 70 47 72 6f 75 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  pGroup);.}../*.*
8cd0: 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  * Implementation
8ce0: 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f   of the sqlite3_
8cf0: 70 63 61 63 68 65 2e 78 52 65 6b 65 79 20 6d 65  pcache.xRekey me
8d00: 74 68 6f 64 2e 20 0a 2a 2f 0a 73 74 61 74 69 63  thod. .*/.static
8d10: 20 76 6f 69 64 20 70 63 61 63 68 65 31 52 65 6b   void pcache1Rek
8d20: 65 79 28 0a 20 20 73 71 6c 69 74 65 33 5f 70 63  ey(.  sqlite3_pc
8d30: 61 63 68 65 20 2a 70 2c 0a 20 20 73 71 6c 69 74  ache *p,.  sqlit
8d40: 65 33 5f 70 63 61 63 68 65 5f 70 61 67 65 20 2a  e3_pcache_page *
8d50: 70 50 67 2c 0a 20 20 75 6e 73 69 67 6e 65 64 20  pPg,.  unsigned 
8d60: 69 6e 74 20 69 4f 6c 64 2c 0a 20 20 75 6e 73 69  int iOld,.  unsi
8d70: 67 6e 65 64 20 69 6e 74 20 69 4e 65 77 0a 29 7b  gned int iNew.){
8d80: 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63  .  PCache1 *pCac
8d90: 68 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29  he = (PCache1 *)
8da0: 70 3b 0a 20 20 50 67 48 64 72 31 20 2a 70 50 61  p;.  PgHdr1 *pPa
8db0: 67 65 20 3d 20 28 50 67 48 64 72 31 20 2a 29 70  ge = (PgHdr1 *)p
8dc0: 50 67 3b 0a 20 20 50 67 48 64 72 31 20 2a 2a 70  Pg;.  PgHdr1 **p
8dd0: 70 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e  p;.  unsigned in
8de0: 74 20 68 3b 20 0a 20 20 61 73 73 65 72 74 28 20  t h; .  assert( 
8df0: 70 50 61 67 65 2d 3e 69 4b 65 79 3d 3d 69 4f 6c  pPage->iKey==iOl
8e00: 64 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  d );.  assert( p
8e10: 50 61 67 65 2d 3e 70 43 61 63 68 65 3d 3d 70 43  Page->pCache==pC
8e20: 61 63 68 65 20 29 3b 0a 0a 20 20 70 63 61 63 68  ache );..  pcach
8e30: 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70 43 61  e1EnterMutex(pCa
8e40: 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 0a 20  che->pGroup);.. 
8e50: 20 68 20 3d 20 69 4f 6c 64 25 70 43 61 63 68 65   h = iOld%pCache
8e60: 2d 3e 6e 48 61 73 68 3b 0a 20 20 70 70 20 3d 20  ->nHash;.  pp = 
8e70: 26 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b  &pCache->apHash[
8e80: 68 5d 3b 0a 20 20 77 68 69 6c 65 28 20 28 2a 70  h];.  while( (*p
8e90: 70 29 21 3d 70 50 61 67 65 20 29 7b 0a 20 20 20  p)!=pPage ){.   
8ea0: 20 70 70 20 3d 20 26 28 2a 70 70 29 2d 3e 70 4e   pp = &(*pp)->pN
8eb0: 65 78 74 3b 0a 20 20 7d 0a 20 20 2a 70 70 20 3d  ext;.  }.  *pp =
8ec0: 20 70 50 61 67 65 2d 3e 70 4e 65 78 74 3b 0a 0a   pPage->pNext;..
8ed0: 20 20 68 20 3d 20 69 4e 65 77 25 70 43 61 63 68    h = iNew%pCach
8ee0: 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 70 50 61 67  e->nHash;.  pPag
8ef0: 65 2d 3e 69 4b 65 79 20 3d 20 69 4e 65 77 3b 0a  e->iKey = iNew;.
8f00: 20 20 70 50 61 67 65 2d 3e 70 4e 65 78 74 20 3d    pPage->pNext =
8f10: 20 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b   pCache->apHash[
8f20: 68 5d 3b 0a 20 20 70 43 61 63 68 65 2d 3e 61 70  h];.  pCache->ap
8f30: 48 61 73 68 5b 68 5d 20 3d 20 70 50 61 67 65 3b  Hash[h] = pPage;
8f40: 0a 20 20 69 66 28 20 69 4e 65 77 3e 70 43 61 63  .  if( iNew>pCac
8f50: 68 65 2d 3e 69 4d 61 78 4b 65 79 20 29 7b 0a 20  he->iMaxKey ){. 
8f60: 20 20 20 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b     pCache->iMaxK
8f70: 65 79 20 3d 20 69 4e 65 77 3b 0a 20 20 7d 0a 0a  ey = iNew;.  }..
8f80: 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d 75    pcache1LeaveMu
8f90: 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f  tex(pCache->pGro
8fa0: 75 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d  up);.}../*.** Im
8fb0: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20  plementation of 
8fc0: 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63  the sqlite3_pcac
8fd0: 68 65 2e 78 54 72 75 6e 63 61 74 65 20 6d 65 74  he.xTruncate met
8fe0: 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 44 69 73 63  hod. .**.** Disc
8ff0: 61 72 64 20 61 6c 6c 20 75 6e 70 69 6e 6e 65 64  ard all unpinned
9000: 20 70 61 67 65 73 20 69 6e 20 74 68 65 20 63 61   pages in the ca
9010: 63 68 65 20 77 69 74 68 20 61 20 70 61 67 65 20  che with a page 
9020: 6e 75 6d 62 65 72 20 65 71 75 61 6c 20 74 6f 0a  number equal to.
9030: 2a 2a 20 6f 72 20 67 72 65 61 74 65 72 20 74 68  ** or greater th
9040: 61 6e 20 70 61 72 61 6d 65 74 65 72 20 69 4c 69  an parameter iLi
9050: 6d 69 74 2e 20 41 6e 79 20 70 69 6e 6e 65 64 20  mit. Any pinned 
9060: 70 61 67 65 73 20 77 69 74 68 20 61 20 70 61 67  pages with a pag
9070: 65 20 6e 75 6d 62 65 72 0a 2a 2a 20 65 71 75 61  e number.** equa
9080: 6c 20 74 6f 20 6f 72 20 67 72 65 61 74 65 72 20  l to or greater 
9090: 74 68 61 6e 20 69 4c 69 6d 69 74 20 61 72 65 20  than iLimit are 
90a0: 69 6d 70 6c 69 63 69 74 6c 79 20 75 6e 70 69 6e  implicitly unpin
90b0: 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  ned..*/.static v
90c0: 6f 69 64 20 70 63 61 63 68 65 31 54 72 75 6e 63  oid pcache1Trunc
90d0: 61 74 65 28 73 71 6c 69 74 65 33 5f 70 63 61 63  ate(sqlite3_pcac
90e0: 68 65 20 2a 70 2c 20 75 6e 73 69 67 6e 65 64 20  he *p, unsigned 
90f0: 69 6e 74 20 69 4c 69 6d 69 74 29 7b 0a 20 20 50  int iLimit){.  P
9100: 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 20 3d  Cache1 *pCache =
9110: 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b 0a 20   (PCache1 *)p;. 
9120: 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74   pcache1EnterMut
9130: 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75  ex(pCache->pGrou
9140: 70 29 3b 0a 20 20 69 66 28 20 69 4c 69 6d 69 74  p);.  if( iLimit
9150: 3c 3d 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65  <=pCache->iMaxKe
9160: 79 20 29 7b 0a 20 20 20 20 70 63 61 63 68 65 31  y ){.    pcache1
9170: 54 72 75 6e 63 61 74 65 55 6e 73 61 66 65 28 70  TruncateUnsafe(p
9180: 43 61 63 68 65 2c 20 69 4c 69 6d 69 74 29 3b 0a  Cache, iLimit);.
9190: 20 20 20 20 70 43 61 63 68 65 2d 3e 69 4d 61 78      pCache->iMax
91a0: 4b 65 79 20 3d 20 69 4c 69 6d 69 74 2d 31 3b 0a  Key = iLimit-1;.
91b0: 20 20 7d 0a 20 20 70 63 61 63 68 65 31 4c 65 61    }.  pcache1Lea
91c0: 76 65 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e  veMutex(pCache->
91d0: 70 47 72 6f 75 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  pGroup);.}../*.*
91e0: 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  * Implementation
91f0: 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f   of the sqlite3_
9200: 70 63 61 63 68 65 2e 78 44 65 73 74 72 6f 79 20  pcache.xDestroy 
9210: 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 44  method. .**.** D
9220: 65 73 74 72 6f 79 20 61 20 63 61 63 68 65 20 61  estroy a cache a
9230: 6c 6c 6f 63 61 74 65 64 20 75 73 69 6e 67 20 70  llocated using p
9240: 63 61 63 68 65 31 43 72 65 61 74 65 28 29 2e 0a  cache1Create()..
9250: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70  */.static void p
9260: 63 61 63 68 65 31 44 65 73 74 72 6f 79 28 73 71  cache1Destroy(sq
9270: 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 29  lite3_pcache *p)
9280: 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61  {.  PCache1 *pCa
9290: 63 68 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a  che = (PCache1 *
92a0: 29 70 3b 0a 20 20 50 47 72 6f 75 70 20 2a 70 47  )p;.  PGroup *pG
92b0: 72 6f 75 70 20 3d 20 70 43 61 63 68 65 2d 3e 70  roup = pCache->p
92c0: 47 72 6f 75 70 3b 0a 20 20 61 73 73 65 72 74 28  Group;.  assert(
92d0: 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61   pCache->bPurgea
92e0: 62 6c 65 20 7c 7c 20 28 70 43 61 63 68 65 2d 3e  ble || (pCache->
92f0: 6e 4d 61 78 3d 3d 30 20 26 26 20 70 43 61 63 68  nMax==0 && pCach
9300: 65 2d 3e 6e 4d 69 6e 3d 3d 30 29 20 29 3b 0a 20  e->nMin==0) );. 
9310: 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74   pcache1EnterMut
9320: 65 78 28 70 47 72 6f 75 70 29 3b 0a 20 20 70 63  ex(pGroup);.  pc
9330: 61 63 68 65 31 54 72 75 6e 63 61 74 65 55 6e 73  ache1TruncateUns
9340: 61 66 65 28 70 43 61 63 68 65 2c 20 30 29 3b 0a  afe(pCache, 0);.
9350: 20 20 61 73 73 65 72 74 28 20 70 47 72 6f 75 70    assert( pGroup
9360: 2d 3e 6e 4d 61 78 50 61 67 65 20 3e 3d 20 70 43  ->nMaxPage >= pC
9370: 61 63 68 65 2d 3e 6e 4d 61 78 20 29 3b 0a 20 20  ache->nMax );.  
9380: 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65  pGroup->nMaxPage
9390: 20 2d 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78   -= pCache->nMax
93a0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 47 72 6f  ;.  assert( pGro
93b0: 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 20 3e 3d 20  up->nMinPage >= 
93c0: 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 20 29 3b 0a  pCache->nMin );.
93d0: 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61    pGroup->nMinPa
93e0: 67 65 20 2d 3d 20 70 43 61 63 68 65 2d 3e 6e 4d  ge -= pCache->nM
93f0: 69 6e 3b 0a 20 20 70 47 72 6f 75 70 2d 3e 6d 78  in;.  pGroup->mx
9400: 50 69 6e 6e 65 64 20 3d 20 70 47 72 6f 75 70 2d  Pinned = pGroup-
9410: 3e 6e 4d 61 78 50 61 67 65 20 2b 20 31 30 20 2d  >nMaxPage + 10 -
9420: 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67   pGroup->nMinPag
9430: 65 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 66 6f  e;.  pcache1Enfo
9440: 72 63 65 4d 61 78 50 61 67 65 28 70 43 61 63 68  rceMaxPage(pCach
9450: 65 29 3b 0a 20 20 70 63 61 63 68 65 31 4c 65 61  e);.  pcache1Lea
9460: 76 65 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b  veMutex(pGroup);
9470: 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28  .  sqlite3_free(
9480: 70 43 61 63 68 65 2d 3e 70 42 75 6c 6b 29 3b 0a  pCache->pBulk);.
9490: 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70    sqlite3_free(p
94a0: 43 61 63 68 65 2d 3e 61 70 48 61 73 68 29 3b 0a  Cache->apHash);.
94b0: 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70    sqlite3_free(p
94c0: 43 61 63 68 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  Cache);.}../*.**
94d0: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69   This function i
94e0: 73 20 63 61 6c 6c 65 64 20 64 75 72 69 6e 67 20  s called during 
94f0: 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 28  initialization (
9500: 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69  sqlite3_initiali
9510: 7a 65 28 29 29 20 74 6f 0a 2a 2a 20 69 6e 73 74  ze()) to.** inst
9520: 61 6c 6c 20 74 68 65 20 64 65 66 61 75 6c 74 20  all the default 
9530: 70 6c 75 67 67 61 62 6c 65 20 63 61 63 68 65 20  pluggable cache 
9540: 6d 6f 64 75 6c 65 2c 20 61 73 73 75 6d 69 6e 67  module, assuming
9550: 20 74 68 65 20 75 73 65 72 20 68 61 73 20 6e 6f   the user has no
9560: 74 0a 2a 2a 20 61 6c 72 65 61 64 79 20 70 72 6f  t.** already pro
9570: 76 69 64 65 64 20 61 6e 20 61 6c 74 65 72 6e 61  vided an alterna
9580: 74 69 76 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  tive..*/.void sq
9590: 6c 69 74 65 33 50 43 61 63 68 65 53 65 74 44 65  lite3PCacheSetDe
95a0: 66 61 75 6c 74 28 76 6f 69 64 29 7b 0a 20 20 73  fault(void){.  s
95b0: 74 61 74 69 63 20 63 6f 6e 73 74 20 73 71 6c 69  tatic const sqli
95c0: 74 65 33 5f 70 63 61 63 68 65 5f 6d 65 74 68 6f  te3_pcache_metho
95d0: 64 73 32 20 64 65 66 61 75 6c 74 4d 65 74 68 6f  ds2 defaultMetho
95e0: 64 73 20 3d 20 7b 0a 20 20 20 20 31 2c 20 20 20  ds = {.    1,   
95f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
9600: 20 20 20 20 2f 2a 20 69 56 65 72 73 69 6f 6e 20      /* iVersion 
9610: 2a 2f 0a 20 20 20 20 30 2c 20 20 20 20 20 20 20  */.    0,       
9620: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
9630: 2f 2a 20 70 41 72 67 20 2a 2f 0a 20 20 20 20 70  /* pArg */.    p
9640: 63 61 63 68 65 31 49 6e 69 74 2c 20 20 20 20 20  cache1Init,     
9650: 20 20 20 20 20 20 20 20 2f 2a 20 78 49 6e 69 74          /* xInit
9660: 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 53   */.    pcache1S
9670: 68 75 74 64 6f 77 6e 2c 20 20 20 20 20 20 20 20  hutdown,        
9680: 20 2f 2a 20 78 53 68 75 74 64 6f 77 6e 20 2a 2f   /* xShutdown */
9690: 0a 20 20 20 20 70 63 61 63 68 65 31 43 72 65 61  .    pcache1Crea
96a0: 74 65 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a  te,           /*
96b0: 20 78 43 72 65 61 74 65 20 2a 2f 0a 20 20 20 20   xCreate */.    
96c0: 70 63 61 63 68 65 31 43 61 63 68 65 73 69 7a 65  pcache1Cachesize
96d0: 2c 20 20 20 20 20 20 20 20 2f 2a 20 78 43 61 63  ,        /* xCac
96e0: 68 65 73 69 7a 65 20 2a 2f 0a 20 20 20 20 70 63  hesize */.    pc
96f0: 61 63 68 65 31 50 61 67 65 63 6f 75 6e 74 2c 20  ache1Pagecount, 
9700: 20 20 20 20 20 20 20 2f 2a 20 78 50 61 67 65 63         /* xPagec
9710: 6f 75 6e 74 20 2a 2f 0a 20 20 20 20 70 63 61 63  ount */.    pcac
9720: 68 65 31 46 65 74 63 68 2c 20 20 20 20 20 20 20  he1Fetch,       
9730: 20 20 20 20 20 2f 2a 20 78 46 65 74 63 68 20 2a       /* xFetch *
9740: 2f 0a 20 20 20 20 70 63 61 63 68 65 31 55 6e 70  /.    pcache1Unp
9750: 69 6e 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f  in,            /
9760: 2a 20 78 55 6e 70 69 6e 20 2a 2f 0a 20 20 20 20  * xUnpin */.    
9770: 70 63 61 63 68 65 31 52 65 6b 65 79 2c 20 20 20  pcache1Rekey,   
9780: 20 20 20 20 20 20 20 20 20 2f 2a 20 78 52 65 6b           /* xRek
9790: 65 79 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65  ey */.    pcache
97a0: 31 54 72 75 6e 63 61 74 65 2c 20 20 20 20 20 20  1Truncate,      
97b0: 20 20 20 2f 2a 20 78 54 72 75 6e 63 61 74 65 20     /* xTruncate 
97c0: 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 44 65  */.    pcache1De
97d0: 73 74 72 6f 79 2c 20 20 20 20 20 20 20 20 20 20  stroy,          
97e0: 2f 2a 20 78 44 65 73 74 72 6f 79 20 2a 2f 0a 20  /* xDestroy */. 
97f0: 20 20 20 70 63 61 63 68 65 31 53 68 72 69 6e 6b     pcache1Shrink
9800: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78              /* x
9810: 53 68 72 69 6e 6b 20 2a 2f 0a 20 20 7d 3b 0a 20  Shrink */.  };. 
9820: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28   sqlite3_config(
9830: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 43  SQLITE_CONFIG_PC
9840: 41 43 48 45 32 2c 20 26 64 65 66 61 75 6c 74 4d  ACHE2, &defaultM
9850: 65 74 68 6f 64 73 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  ethods);.}../*.*
9860: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 73 69 7a  * Return the siz
9870: 65 20 6f 66 20 74 68 65 20 68 65 61 64 65 72 20  e of the header 
9880: 6f 6e 20 65 61 63 68 20 70 61 67 65 20 6f 66 20  on each page of 
9890: 74 68 69 73 20 50 43 41 43 48 45 20 69 6d 70 6c  this PCACHE impl
98a0: 65 6d 65 6e 74 61 74 69 6f 6e 2e 0a 2a 2f 0a 69  ementation..*/.i
98b0: 6e 74 20 73 71 6c 69 74 65 33 48 65 61 64 65 72  nt sqlite3Header
98c0: 53 69 7a 65 50 63 61 63 68 65 31 28 76 6f 69 64  SizePcache1(void
98d0: 29 7b 20 72 65 74 75 72 6e 20 52 4f 55 4e 44 38  ){ return ROUND8
98e0: 28 73 69 7a 65 6f 66 28 50 67 48 64 72 31 29 29  (sizeof(PgHdr1))
98f0: 3b 20 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  ; }../*.** Retur
9900: 6e 20 74 68 65 20 67 6c 6f 62 61 6c 20 6d 75 74  n the global mut
9910: 65 78 20 75 73 65 64 20 62 79 20 74 68 69 73 20  ex used by this 
9920: 50 43 41 43 48 45 20 69 6d 70 6c 65 6d 65 6e 74  PCACHE implement
9930: 61 74 69 6f 6e 2e 20 20 54 68 65 0a 2a 2a 20 73  ation.  The.** s
9940: 71 6c 69 74 65 33 5f 73 74 61 74 75 73 28 29 20  qlite3_status() 
9950: 72 6f 75 74 69 6e 65 20 6e 65 65 64 73 20 61 63  routine needs ac
9960: 63 65 73 73 20 74 6f 20 74 68 69 73 20 6d 75 74  cess to this mut
9970: 65 78 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f 6d  ex..*/.sqlite3_m
9980: 75 74 65 78 20 2a 73 71 6c 69 74 65 33 50 63 61  utex *sqlite3Pca
9990: 63 68 65 31 4d 75 74 65 78 28 76 6f 69 64 29 7b  che1Mutex(void){
99a0: 0a 20 20 72 65 74 75 72 6e 20 70 63 61 63 68 65  .  return pcache
99b0: 31 2e 6d 75 74 65 78 3b 0a 7d 0a 0a 23 69 66 64  1.mutex;.}..#ifd
99c0: 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  ef SQLITE_ENABLE
99d0: 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45  _MEMORY_MANAGEME
99e0: 4e 54 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75  NT./*.** This fu
99f0: 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64  nction is called
9a00: 20 74 6f 20 66 72 65 65 20 73 75 70 65 72 66 6c   to free superfl
9a10: 75 6f 75 73 20 64 79 6e 61 6d 69 63 61 6c 6c 79  uous dynamically
9a20: 20 61 6c 6c 6f 63 61 74 65 64 20 6d 65 6d 6f 72   allocated memor
9a30: 79 0a 2a 2a 20 68 65 6c 64 20 62 79 20 74 68 65  y.** held by the
9a40: 20 70 61 67 65 72 20 73 79 73 74 65 6d 2e 20 4d   pager system. M
9a50: 65 6d 6f 72 79 20 69 6e 20 75 73 65 20 62 79 20  emory in use by 
9a60: 61 6e 79 20 53 51 4c 69 74 65 20 70 61 67 65 72  any SQLite pager
9a70: 20 61 6c 6c 6f 63 61 74 65 64 0a 2a 2a 20 62 79   allocated.** by
9a80: 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 68 72   the current thr
9a90: 65 61 64 20 6d 61 79 20 62 65 20 73 71 6c 69 74  ead may be sqlit
9aa0: 65 33 5f 66 72 65 65 28 29 65 64 2e 0a 2a 2a 0a  e3_free()ed..**.
9ab0: 2a 2a 20 6e 52 65 71 20 69 73 20 74 68 65 20 6e  ** nReq is the n
9ac0: 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f  umber of bytes o
9ad0: 66 20 6d 65 6d 6f 72 79 20 72 65 71 75 69 72 65  f memory require
9ae0: 64 2e 20 4f 6e 63 65 20 74 68 69 73 20 6d 75 63  d. Once this muc
9af0: 68 20 68 61 73 0a 2a 2a 20 62 65 65 6e 20 72 65  h has.** been re
9b00: 6c 65 61 73 65 64 2c 20 74 68 65 20 66 75 6e 63  leased, the func
9b10: 74 69 6f 6e 20 72 65 74 75 72 6e 73 2e 20 54 68  tion returns. Th
9b20: 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69  e return value i
9b30: 73 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62  s the total numb
9b40: 65 72 20 0a 2a 2a 20 6f 66 20 62 79 74 65 73 20  er .** of bytes 
9b50: 6f 66 20 6d 65 6d 6f 72 79 20 72 65 6c 65 61 73  of memory releas
9b60: 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  ed..*/.int sqlit
9b70: 65 33 50 63 61 63 68 65 52 65 6c 65 61 73 65 4d  e3PcacheReleaseM
9b80: 65 6d 6f 72 79 28 69 6e 74 20 6e 52 65 71 29 7b  emory(int nReq){
9b90: 0a 20 20 69 6e 74 20 6e 46 72 65 65 20 3d 20 30  .  int nFree = 0
9ba0: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69  ;.  assert( sqli
9bb0: 74 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c  te3_mutex_nothel
9bc0: 64 28 70 63 61 63 68 65 31 2e 67 72 70 2e 6d 75  d(pcache1.grp.mu
9bd0: 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74  tex) );.  assert
9be0: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
9bf0: 6e 6f 74 68 65 6c 64 28 70 63 61 63 68 65 31 2e  notheld(pcache1.
9c00: 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20  mutex) );.  if( 
9c10: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
9c20: 66 69 67 2e 6e 50 61 67 65 3d 3d 30 20 29 7b 0a  fig.nPage==0 ){.
9c30: 20 20 20 20 50 67 48 64 72 31 20 2a 70 3b 0a 20      PgHdr1 *p;. 
9c40: 20 20 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d     pcache1EnterM
9c50: 75 74 65 78 28 26 70 63 61 63 68 65 31 2e 67 72  utex(&pcache1.gr
9c60: 70 29 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 28  p);.    while( (
9c70: 6e 52 65 71 3c 30 20 7c 7c 20 6e 46 72 65 65 3c  nReq<0 || nFree<
9c80: 6e 52 65 71 29 0a 20 20 20 20 20 20 20 26 26 20  nReq).       && 
9c90: 20 28 70 3d 70 63 61 63 68 65 31 2e 67 72 70 2e   (p=pcache1.grp.
9ca0: 6c 72 75 2e 70 4c 72 75 50 72 65 76 29 21 3d 30  lru.pLruPrev)!=0
9cb0: 0a 20 20 20 20 20 20 20 26 26 20 20 70 2d 3e 69  .       &&  p->i
9cc0: 73 41 6e 63 68 6f 72 3d 3d 30 0a 20 20 20 20 29  sAnchor==0.    )
9cd0: 7b 0a 20 20 20 20 20 20 6e 46 72 65 65 20 2b 3d  {.      nFree +=
9ce0: 20 70 63 61 63 68 65 31 4d 65 6d 53 69 7a 65 28   pcache1MemSize(
9cf0: 70 2d 3e 70 61 67 65 2e 70 42 75 66 29 3b 0a 23  p->page.pBuf);.#
9d00: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 50 43 41  ifdef SQLITE_PCA
9d10: 43 48 45 5f 53 45 50 41 52 41 54 45 5f 48 45 41  CHE_SEPARATE_HEA
9d20: 44 45 52 0a 20 20 20 20 20 20 6e 46 72 65 65 20  DER.      nFree 
9d30: 2b 3d 20 73 71 6c 69 74 65 33 4d 65 6d 53 69 7a  += sqlite3MemSiz
9d40: 65 28 70 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20  e(p);.#endif.   
9d50: 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 69 73     assert( p->is
9d60: 50 69 6e 6e 65 64 3d 3d 30 20 29 3b 0a 20 20 20  Pinned==0 );.   
9d70: 20 20 20 70 63 61 63 68 65 31 50 69 6e 50 61 67     pcache1PinPag
9d80: 65 28 70 29 3b 0a 20 20 20 20 20 20 70 63 61 63  e(p);.      pcac
9d90: 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73  he1RemoveFromHas
9da0: 68 28 70 2c 20 31 29 3b 0a 20 20 20 20 7d 0a 20  h(p, 1);.    }. 
9db0: 20 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d     pcache1LeaveM
9dc0: 75 74 65 78 28 26 70 63 61 63 68 65 31 2e 67 72  utex(&pcache1.gr
9dd0: 70 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e  p);.  }.  return
9de0: 20 6e 46 72 65 65 3b 0a 7d 0a 23 65 6e 64 69 66   nFree;.}.#endif
9df0: 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c   /* SQLITE_ENABL
9e00: 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d  E_MEMORY_MANAGEM
9e10: 45 4e 54 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53  ENT */..#ifdef S
9e20: 51 4c 49 54 45 5f 54 45 53 54 0a 2f 2a 0a 2a 2a  QLITE_TEST./*.**
9e30: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69   This function i
9e40: 73 20 75 73 65 64 20 62 79 20 74 65 73 74 20 70  s used by test p
9e50: 72 6f 63 65 64 75 72 65 73 20 74 6f 20 69 6e 73  rocedures to ins
9e60: 70 65 63 74 20 74 68 65 20 69 6e 74 65 72 6e 61  pect the interna
9e70: 6c 20 73 74 61 74 65 0a 2a 2a 20 6f 66 20 74 68  l state.** of th
9e80: 65 20 67 6c 6f 62 61 6c 20 63 61 63 68 65 2e 0a  e global cache..
9e90: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50  */.void sqlite3P
9ea0: 63 61 63 68 65 53 74 61 74 73 28 0a 20 20 69 6e  cacheStats(.  in
9eb0: 74 20 2a 70 6e 43 75 72 72 65 6e 74 2c 20 20 20  t *pnCurrent,   
9ec0: 20 20 20 2f 2a 20 4f 55 54 3a 20 54 6f 74 61 6c     /* OUT: Total
9ed0: 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73   number of pages
9ee0: 20 63 61 63 68 65 64 20 2a 2f 0a 20 20 69 6e 74   cached */.  int
9ef0: 20 2a 70 6e 4d 61 78 2c 20 20 20 20 20 20 20 20   *pnMax,        
9f00: 20 20 2f 2a 20 4f 55 54 3a 20 47 6c 6f 62 61 6c    /* OUT: Global
9f10: 20 6d 61 78 69 6d 75 6d 20 63 61 63 68 65 20 73   maximum cache s
9f20: 69 7a 65 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e  ize */.  int *pn
9f30: 4d 69 6e 2c 20 20 20 20 20 20 20 20 20 20 2f 2a  Min,          /*
9f40: 20 4f 55 54 3a 20 53 75 6d 20 6f 66 20 50 43 61   OUT: Sum of PCa
9f50: 63 68 65 31 2e 6e 4d 69 6e 20 66 6f 72 20 70 75  che1.nMin for pu
9f60: 72 67 65 61 62 6c 65 20 63 61 63 68 65 73 20 2a  rgeable caches *
9f70: 2f 0a 20 20 69 6e 74 20 2a 70 6e 52 65 63 79 63  /.  int *pnRecyc
9f80: 6c 61 62 6c 65 20 20 20 20 2f 2a 20 4f 55 54 3a  lable    /* OUT:
9f90: 20 54 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66   Total number of
9fa0: 20 70 61 67 65 73 20 61 76 61 69 6c 61 62 6c 65   pages available
9fb0: 20 66 6f 72 20 72 65 63 79 63 6c 69 6e 67 20 2a   for recycling *
9fc0: 2f 0a 29 7b 0a 20 20 50 67 48 64 72 31 20 2a 70  /.){.  PgHdr1 *p
9fd0: 3b 0a 20 20 69 6e 74 20 6e 52 65 63 79 63 6c 61  ;.  int nRecycla
9fe0: 62 6c 65 20 3d 20 30 3b 0a 20 20 66 6f 72 28 70  ble = 0;.  for(p
9ff0: 3d 70 63 61 63 68 65 31 2e 67 72 70 2e 6c 72 75  =pcache1.grp.lru
a000: 2e 70 4c 72 75 4e 65 78 74 3b 20 70 20 26 26 20  .pLruNext; p && 
a010: 21 70 2d 3e 69 73 41 6e 63 68 6f 72 3b 20 70 3d  !p->isAnchor; p=
a020: 70 2d 3e 70 4c 72 75 4e 65 78 74 29 7b 0a 20 20  p->pLruNext){.  
a030: 20 20 61 73 73 65 72 74 28 20 70 2d 3e 69 73 50    assert( p->isP
a040: 69 6e 6e 65 64 3d 3d 30 20 29 3b 0a 20 20 20 20  inned==0 );.    
a050: 6e 52 65 63 79 63 6c 61 62 6c 65 2b 2b 3b 0a 20  nRecyclable++;. 
a060: 20 7d 0a 20 20 2a 70 6e 43 75 72 72 65 6e 74 20   }.  *pnCurrent 
a070: 3d 20 70 63 61 63 68 65 31 2e 67 72 70 2e 6e 43  = pcache1.grp.nC
a080: 75 72 72 65 6e 74 50 61 67 65 3b 0a 20 20 2a 70  urrentPage;.  *p
a090: 6e 4d 61 78 20 3d 20 28 69 6e 74 29 70 63 61 63  nMax = (int)pcac
a0a0: 68 65 31 2e 67 72 70 2e 6e 4d 61 78 50 61 67 65  he1.grp.nMaxPage
a0b0: 3b 0a 20 20 2a 70 6e 4d 69 6e 20 3d 20 28 69 6e  ;.  *pnMin = (in
a0c0: 74 29 70 63 61 63 68 65 31 2e 67 72 70 2e 6e 4d  t)pcache1.grp.nM
a0d0: 69 6e 50 61 67 65 3b 0a 20 20 2a 70 6e 52 65 63  inPage;.  *pnRec
a0e0: 79 63 6c 61 62 6c 65 20 3d 20 6e 52 65 63 79 63  yclable = nRecyc
a0f0: 6c 61 62 6c 65 3b 0a 7d 0a 23 65 6e 64 69 66 0a  lable;.}.#endif.