0000: 2f 2a 0a 2a 2a 20 32 30 30 38 20 4e 6f 76 65 6d /*.** 2008 Novem
0010: 62 65 72 20 30 35 0a 2a 2a 0a 2a 2a 20 54 68 65 ber 05.**.** The
0020: 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 6d author disclaim
0030: 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 74 s copyright to t
0040: 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 2e his source code.
0050: 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a 2a In place of.**
0060: 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 2c a legal notice,
0070: 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 73 here is a bless
0080: 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61 ing:.**.** Ma
0090: 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 6e y you do good an
00a0: 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 20 d not evil..**
00b0: 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 66 May you find f
00c0: 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 79 orgiveness for y
00d0: 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 67 ourself and forg
00e0: 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 20 ive others..**
00f0: 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 20 May you share
0100: 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 61 freely, never ta
0110: 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 79 king more than y
0120: 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a ou give..**.****
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0170: 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 54 68 69 73 *****.**.** This
0180: 20 66 69 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 73 file implements
0190: 20 74 68 65 20 64 65 66 61 75 6c 74 20 70 61 67 the default pag
01a0: 65 20 63 61 63 68 65 20 69 6d 70 6c 65 6d 65 6e e cache implemen
01b0: 74 61 74 69 6f 6e 20 28 74 68 65 0a 2a 2a 20 73 tation (the.** s
01c0: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 69 6e qlite3_pcache in
01d0: 74 65 72 66 61 63 65 29 2e 20 49 74 20 61 6c 73 terface). It als
01e0: 6f 20 63 6f 6e 74 61 69 6e 73 20 70 61 72 74 20 o contains part
01f0: 6f 66 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 of the implement
0200: 61 74 69 6f 6e 0a 2a 2a 20 6f 66 20 74 68 65 20 ation.** of the
0210: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 SQLITE_CONFIG_PA
0220: 47 45 43 41 43 48 45 20 61 6e 64 20 73 71 6c 69 GECACHE and sqli
0230: 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f te3_release_memo
0240: 72 79 28 29 20 66 65 61 74 75 72 65 73 2e 0a 2a ry() features..*
0250: 2a 20 49 66 20 74 68 65 20 64 65 66 61 75 6c 74 * If the default
0260: 20 70 61 67 65 20 63 61 63 68 65 20 69 6d 70 6c page cache impl
0270: 65 6d 65 6e 74 61 74 69 6f 6e 20 69 73 20 6f 76 ementation is ov
0280: 65 72 72 69 64 64 65 6e 2c 20 74 68 65 6e 20 6e erridden, then n
0290: 65 69 74 68 65 72 20 6f 66 0a 2a 2a 20 74 68 65 either of.** the
02a0: 73 65 20 74 77 6f 20 66 65 61 74 75 72 65 73 20 se two features
02b0: 61 72 65 20 61 76 61 69 6c 61 62 6c 65 2e 0a 2a are available..*
02c0: 2a 0a 2a 2a 20 41 20 50 61 67 65 20 63 61 63 68 *.** A Page cach
02d0: 65 20 6c 69 6e 65 20 6c 6f 6f 6b 73 20 6c 69 6b e line looks lik
02e0: 65 20 74 68 69 73 3a 0a 2a 2a 0a 2a 2a 20 20 2d e this:.**.** -
02f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0300: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0310: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0320: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 20 ------------.**
0330: 20 7c 20 20 64 61 74 61 62 61 73 65 20 70 61 67 | database pag
0340: 65 20 63 6f 6e 74 65 6e 74 20 20 20 7c 20 20 50 e content | P
0350: 67 48 64 72 31 20 20 7c 20 20 4d 65 6d 50 61 67 gHdr1 | MemPag
0360: 65 20 20 7c 20 20 50 67 48 64 72 20 20 7c 0a 2a e | PgHdr |.*
0370: 2a 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d * -------------
0380: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0390: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
03a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
03b0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 64 61 74 61 62 .**.** The datab
03c0: 61 73 65 20 70 61 67 65 20 63 6f 6e 74 65 6e 74 ase page content
03d0: 20 69 73 20 75 70 20 66 72 6f 6e 74 20 28 73 6f is up front (so
03e0: 20 74 68 61 74 20 62 75 66 66 65 72 20 6f 76 65 that buffer ove
03f0: 72 72 65 61 64 73 20 74 65 6e 64 20 74 6f 0a 2a rreads tend to.*
0400: 2a 20 66 6c 6f 77 20 68 61 72 6d 6c 65 73 73 6c * flow harmlessl
0410: 79 20 69 6e 74 6f 20 74 68 65 20 50 67 48 64 72 y into the PgHdr
0420: 31 2c 20 4d 65 6d 50 61 67 65 2c 20 61 6e 64 20 1, MemPage, and
0430: 50 67 48 64 72 20 65 78 74 65 6e 73 69 6f 6e 73 PgHdr extensions
0440: 29 2e 20 20 20 4d 65 6d 50 61 67 65 0a 2a 2a 20 ). MemPage.**
0450: 69 73 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e is the extension
0460: 20 61 64 64 65 64 20 62 79 20 74 68 65 20 62 74 added by the bt
0470: 72 65 65 2e 63 20 6d 6f 64 75 6c 65 20 63 6f 6e ree.c module con
0480: 74 61 69 6e 69 6e 67 20 69 6e 66 6f 72 6d 61 74 taining informat
0490: 69 6f 6e 20 73 75 63 68 0a 2a 2a 20 61 73 20 74 ion such.** as t
04a0: 68 65 20 64 61 74 61 62 61 73 65 20 70 61 67 65 he database page
04b0: 20 6e 75 6d 62 65 72 20 61 6e 64 20 68 6f 77 20 number and how
04c0: 74 68 61 74 20 64 61 74 61 62 61 73 65 20 70 61 that database pa
04d0: 67 65 20 69 73 20 75 73 65 64 2e 20 20 50 67 48 ge is used. PgH
04e0: 64 72 0a 2a 2a 20 69 73 20 61 64 64 65 64 20 62 dr.** is added b
04f0: 79 20 74 68 65 20 70 63 61 63 68 65 2e 63 20 6c y the pcache.c l
0500: 61 79 65 72 20 61 6e 64 20 63 6f 6e 74 61 69 6e ayer and contain
0510: 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 75 73 s information us
0520: 65 64 20 74 6f 20 6b 65 65 70 20 74 72 61 63 6b ed to keep track
0530: 0a 2a 2a 20 6f 66 20 77 68 69 63 68 20 70 61 67 .** of which pag
0540: 65 73 20 61 72 65 20 22 64 69 72 74 79 22 2e 20 es are "dirty".
0550: 20 50 67 48 64 72 31 20 69 73 20 61 6e 20 65 78 PgHdr1 is an ex
0560: 74 65 6e 73 69 6f 6e 20 61 64 64 65 64 20 62 79 tension added by
0570: 20 74 68 69 73 0a 2a 2a 20 6d 6f 64 75 6c 65 20 this.** module
0580: 28 70 63 61 63 68 65 31 2e 63 29 2e 20 20 54 68 (pcache1.c). Th
0590: 65 20 50 67 48 64 72 31 20 68 65 61 64 65 72 20 e PgHdr1 header
05a0: 69 73 20 61 20 73 75 62 63 6c 61 73 73 20 6f 66 is a subclass of
05b0: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f sqlite3_pcache_
05c0: 70 61 67 65 2e 0a 2a 2a 20 50 67 48 64 72 31 20 page..** PgHdr1
05d0: 63 6f 6e 74 61 69 6e 73 20 69 6e 66 6f 72 6d 61 contains informa
05e0: 74 69 6f 6e 20 6e 65 65 64 65 64 20 74 6f 20 6c tion needed to l
05f0: 6f 6f 6b 20 75 70 20 61 20 70 61 67 65 20 62 79 ook up a page by
0600: 20 69 74 73 20 70 61 67 65 20 6e 75 6d 62 65 72 its page number
0610: 2e 0a 2a 2a 20 54 68 65 20 73 75 70 65 72 63 6c ..** The supercl
0620: 61 73 73 20 73 71 6c 69 74 65 33 5f 70 63 61 63 ass sqlite3_pcac
0630: 68 65 5f 70 61 67 65 2e 70 42 75 66 20 70 6f 69 he_page.pBuf poi
0640: 6e 74 73 20 74 6f 20 74 68 65 20 73 74 61 72 74 nts to the start
0650: 20 6f 66 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 of the.** datab
0660: 61 73 65 20 70 61 67 65 20 63 6f 6e 74 65 6e 74 ase page content
0670: 20 61 6e 64 20 73 71 6c 69 74 65 33 5f 70 63 61 and sqlite3_pca
0680: 63 68 65 5f 70 61 67 65 2e 70 45 78 74 72 61 20 che_page.pExtra
0690: 70 6f 69 6e 74 73 20 74 6f 20 50 67 48 64 72 2e points to PgHdr.
06a0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 69 7a 65 20 .**.** The size
06b0: 6f 66 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e of the extension
06c0: 20 28 4d 65 6d 50 61 67 65 2b 50 67 48 64 72 2b (MemPage+PgHdr+
06d0: 50 67 48 64 72 31 29 20 63 61 6e 20 62 65 20 64 PgHdr1) can be d
06e0: 65 74 65 72 6d 69 6e 65 64 20 61 74 0a 2a 2a 20 etermined at.**
06f0: 72 75 6e 74 69 6d 65 20 75 73 69 6e 67 20 73 71 runtime using sq
0700: 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c lite3_config(SQL
0710: 49 54 45 5f 43 4f 4e 46 49 47 5f 50 43 41 43 48 ITE_CONFIG_PCACH
0720: 45 5f 48 44 52 53 5a 2c 20 26 73 69 7a 65 29 2e E_HDRSZ, &size).
0730: 20 20 54 68 65 0a 2a 2a 20 73 69 7a 65 73 20 6f The.** sizes o
0740: 66 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e 73 f the extensions
0750: 20 73 75 6d 20 74 6f 20 32 37 32 20 62 79 74 65 sum to 272 byte
0760: 73 20 6f 6e 20 78 36 34 20 66 6f 72 20 33 2e 38 s on x64 for 3.8
0770: 2e 31 30 2c 20 62 75 74 20 74 68 69 73 0a 2a 2a .10, but this.**
0780: 20 73 69 7a 65 20 63 61 6e 20 76 61 72 79 20 61 size can vary a
0790: 63 63 6f 72 64 69 6e 67 20 74 6f 20 61 72 63 68 ccording to arch
07a0: 69 74 65 63 74 75 72 65 2c 20 63 6f 6d 70 69 6c itecture, compil
07b0: 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73 2c 20 e-time options,
07c0: 61 6e 64 0a 2a 2a 20 53 51 4c 69 74 65 20 6c 69 and.** SQLite li
07d0: 62 72 61 72 79 20 76 65 72 73 69 6f 6e 20 6e 75 brary version nu
07e0: 6d 62 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 53 mber..**.** If S
07f0: 51 4c 49 54 45 5f 50 43 41 43 48 45 5f 53 45 50 QLITE_PCACHE_SEP
0800: 41 52 41 54 45 5f 48 45 41 44 45 52 20 69 73 20 ARATE_HEADER is
0810: 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 74 68 defined, then th
0820: 65 20 65 78 74 65 6e 73 69 6f 6e 20 69 73 20 6f e extension is o
0830: 62 74 61 69 6e 65 64 0a 2a 2a 20 75 73 69 6e 67 btained.** using
0840: 20 61 20 73 65 70 61 72 61 74 65 20 6d 65 6d 6f a separate memo
0850: 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 66 72 ry allocation fr
0860: 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 20 om the database
0870: 70 61 67 65 20 63 6f 6e 74 65 6e 74 2e 20 20 54 page content. T
0880: 68 69 73 0a 2a 2a 20 73 65 65 6b 73 20 74 6f 20 his.** seeks to
0890: 6f 76 65 72 63 6f 6d 65 20 74 68 65 20 22 63 6c overcome the "cl
08a0: 6f 77 6e 73 68 6f 65 22 20 70 72 6f 62 6c 65 6d ownshoe" problem
08b0: 20 28 61 6c 73 6f 20 63 61 6c 6c 65 64 20 22 69 (also called "i
08c0: 6e 74 65 72 6e 61 6c 0a 2a 2a 20 66 72 61 67 6d nternal.** fragm
08d0: 65 6e 74 61 74 69 6f 6e 22 20 69 6e 20 61 63 61 entation" in aca
08e0: 64 65 6d 69 63 20 6c 69 74 65 72 61 74 75 72 65 demic literature
08f0: 29 20 6f 66 20 61 6c 6c 6f 63 61 74 69 6e 67 20 ) of allocating
0900: 61 20 66 65 77 20 62 79 74 65 73 20 6d 6f 72 65 a few bytes more
0910: 0a 2a 2a 20 74 68 61 6e 20 61 20 70 6f 77 65 72 .** than a power
0920: 20 6f 66 20 74 77 6f 20 77 69 74 68 20 74 68 65 of two with the
0930: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f memory allocato
0940: 72 20 72 6f 75 6e 64 69 6e 67 20 75 70 20 74 6f r rounding up to
0950: 20 74 68 65 20 6e 65 78 74 0a 2a 2a 20 70 6f 77 the next.** pow
0960: 65 72 20 6f 66 20 74 77 6f 2c 20 61 6e 64 20 6c er of two, and l
0970: 65 61 76 69 6e 67 20 74 68 65 20 72 6f 75 6e 64 eaving the round
0980: 65 64 2d 75 70 20 73 70 61 63 65 20 75 6e 75 73 ed-up space unus
0990: 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 6d ed..**.** This m
09a0: 6f 64 75 6c 65 20 74 72 61 63 6b 73 20 70 6f 69 odule tracks poi
09b0: 6e 74 65 72 73 20 74 6f 20 50 67 48 64 72 31 20 nters to PgHdr1
09c0: 6f 62 6a 65 63 74 73 2e 20 20 4f 6e 6c 79 20 70 objects. Only p
09d0: 63 61 63 68 65 2e 63 20 63 6f 6d 6d 75 6e 69 63 cache.c communic
09e0: 61 74 65 73 0a 2a 2a 20 77 69 74 68 20 74 68 69 ates.** with thi
09f0: 73 20 6d 6f 64 75 6c 65 2e 20 20 49 6e 66 6f 72 s module. Infor
0a00: 6d 61 74 69 6f 6e 20 69 73 20 70 61 73 73 65 64 mation is passed
0a10: 20 62 61 63 6b 20 61 6e 64 20 66 6f 72 74 68 20 back and forth
0a20: 61 73 20 50 67 48 64 72 31 20 70 6f 69 6e 74 65 as PgHdr1 pointe
0a30: 72 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 63 rs..**.** The pc
0a40: 61 63 68 65 2e 63 20 61 6e 64 20 70 61 67 65 72 ache.c and pager
0a50: 2e 63 20 6d 6f 64 75 6c 65 73 20 64 65 61 6c 20 .c modules deal
0a60: 70 6f 69 6e 74 65 72 73 20 74 6f 20 50 67 48 64 pointers to PgHd
0a70: 72 20 6f 62 6a 65 63 74 73 2e 0a 2a 2a 20 54 68 r objects..** Th
0a80: 65 20 62 74 72 65 65 2e 63 20 6d 6f 64 75 6c 65 e btree.c module
0a90: 20 64 65 61 6c 73 20 77 69 74 68 20 70 6f 69 6e deals with poin
0aa0: 74 65 72 73 20 74 6f 20 4d 65 6d 50 61 67 65 20 ters to MemPage
0ab0: 6f 62 6a 65 63 74 73 2e 0a 2a 2a 0a 2a 2a 20 53 objects..**.** S
0ac0: 4f 55 52 43 45 20 4f 46 20 50 41 47 45 20 43 41 OURCE OF PAGE CA
0ad0: 43 48 45 20 4d 45 4d 4f 52 59 3a 0a 2a 2a 0a 2a CHE MEMORY:.**.*
0ae0: 2a 20 4d 65 6d 6f 72 79 20 66 6f 72 20 61 20 70 * Memory for a p
0af0: 61 67 65 20 6d 69 67 68 74 20 63 6f 6d 65 20 66 age might come f
0b00: 72 6f 6d 20 61 6e 79 20 6f 66 20 74 68 72 65 65 rom any of three
0b10: 20 73 6f 75 72 63 65 73 3a 0a 2a 2a 0a 2a 2a 20 sources:.**.**
0b20: 20 20 20 28 31 29 20 20 54 68 65 20 67 65 6e 65 (1) The gene
0b30: 72 61 6c 2d 70 75 72 70 6f 73 65 20 6d 65 6d 6f ral-purpose memo
0b40: 72 79 20 61 6c 6c 6f 63 61 74 6f 72 20 2d 20 73 ry allocator - s
0b50: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 29 0a 2a qlite3Malloc().*
0b60: 2a 20 20 20 20 28 32 29 20 20 47 6c 6f 62 61 6c * (2) Global
0b70: 20 70 61 67 65 2d 63 61 63 68 65 20 6d 65 6d 6f page-cache memo
0b80: 72 79 20 70 72 6f 76 69 64 65 64 20 75 73 69 6e ry provided usin
0b90: 67 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 g sqlite3_config
0ba0: 28 29 20 77 69 74 68 0a 2a 2a 20 20 20 20 20 20 () with.**
0bb0: 20 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 SQLITE_CONFIG
0bc0: 5f 50 41 47 45 43 41 43 48 45 2e 0a 2a 2a 20 20 _PAGECACHE..**
0bd0: 20 20 28 33 29 20 20 50 43 61 63 68 65 2d 6c 6f (3) PCache-lo
0be0: 63 61 6c 20 62 75 6c 6b 20 61 6c 6c 6f 63 61 74 cal bulk allocat
0bf0: 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 74 ion..**.** The t
0c00: 68 69 72 64 20 63 61 73 65 20 69 73 20 61 20 63 hird case is a c
0c10: 68 75 6e 6b 20 6f 66 20 68 65 61 70 20 6d 65 6d hunk of heap mem
0c20: 6f 72 79 20 28 64 65 66 61 75 6c 74 69 6e 67 20 ory (defaulting
0c30: 74 6f 20 31 30 30 20 70 61 67 65 73 20 77 6f 72 to 100 pages wor
0c40: 74 68 29 0a 2a 2a 20 74 68 61 74 20 69 73 20 61 th).** that is a
0c50: 6c 6c 6f 63 61 74 65 64 20 77 68 65 6e 20 74 68 llocated when th
0c60: 65 20 70 61 67 65 20 63 61 63 68 65 20 69 73 20 e page cache is
0c70: 63 72 65 61 74 65 64 2e 20 20 54 68 65 20 73 69 created. The si
0c80: 7a 65 20 6f 66 20 74 68 65 20 6c 6f 63 61 6c 0a ze of the local.
0c90: 2a 2a 20 62 75 6c 6b 20 61 6c 6c 6f 63 61 74 69 ** bulk allocati
0ca0: 6f 6e 20 63 61 6e 20 62 65 20 61 64 6a 75 73 74 on can be adjust
0cb0: 65 64 20 75 73 69 6e 67 20 0a 2a 2a 0a 2a 2a 20 ed using .**.**
0cc0: 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 sqlite3_conf
0cd0: 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 ig(SQLITE_CONFIG
0ce0: 5f 50 41 47 45 43 41 43 48 45 2c 20 28 76 6f 69 _PAGECACHE, (voi
0cf0: 64 2a 29 30 2c 20 30 2c 20 4e 29 2e 0a 2a 2a 0a d*)0, 0, N)..**.
0d00: 2a 2a 20 49 66 20 4e 20 69 73 20 70 6f 73 69 74 ** If N is posit
0d10: 69 76 65 2c 20 74 68 65 6e 20 4e 20 70 61 67 65 ive, then N page
0d20: 73 20 77 6f 72 74 68 20 6f 66 20 6d 65 6d 6f 72 s worth of memor
0d30: 79 20 61 72 65 20 61 6c 6c 6f 63 61 74 65 64 20 y are allocated
0d40: 75 73 69 6e 67 20 61 20 73 69 6e 67 6c 65 0a 2a using a single.*
0d50: 2a 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 * sqlite3Malloc(
0d60: 29 20 63 61 6c 6c 20 61 6e 64 20 74 68 61 74 20 ) call and that
0d70: 6d 65 6d 6f 72 79 20 69 73 20 75 73 65 64 20 66 memory is used f
0d80: 6f 72 20 74 68 65 20 66 69 72 73 74 20 4e 20 70 or the first N p
0d90: 61 67 65 73 20 61 6c 6c 6f 63 61 74 65 64 2e 0a ages allocated..
0da0: 2a 2a 20 4f 72 20 69 66 20 4e 20 69 73 20 6e 65 ** Or if N is ne
0db0: 67 61 74 69 76 65 2c 20 74 68 65 6e 20 2d 31 30 gative, then -10
0dc0: 32 34 2a 4e 20 62 79 74 65 73 20 6f 66 20 6d 65 24*N bytes of me
0dd0: 6d 6f 72 79 20 61 72 65 20 61 6c 6c 6f 63 61 74 mory are allocat
0de0: 65 64 20 61 6e 64 20 75 73 65 64 0a 2a 2a 20 66 ed and used.** f
0df0: 6f 72 20 61 73 20 6d 61 6e 79 20 70 61 67 65 73 or as many pages
0e00: 20 61 73 20 63 61 6e 20 62 65 20 61 63 63 6f 6d as can be accom
0e10: 6f 64 61 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 4f 6e odated..**.** On
0e20: 6c 79 20 6f 6e 65 20 6f 66 20 28 32 29 20 6f 72 ly one of (2) or
0e30: 20 28 33 29 20 63 61 6e 20 62 65 20 75 73 65 64 (3) can be used
0e40: 2e 20 20 4f 6e 63 65 20 74 68 65 20 6d 65 6d 6f . Once the memo
0e50: 72 79 20 61 76 61 69 6c 61 62 6c 65 20 74 6f 20 ry available to
0e60: 28 32 29 20 6f 72 0a 2a 2a 20 28 33 29 20 69 73 (2) or.** (3) is
0e70: 20 65 78 68 61 75 73 74 65 64 2c 20 73 75 62 73 exhausted, subs
0e80: 65 71 75 65 6e 74 20 61 6c 6c 6f 63 61 74 69 6f equent allocatio
0e90: 6e 73 20 66 61 69 6c 20 6f 76 65 72 20 74 6f 20 ns fail over to
0ea0: 74 68 65 20 67 65 6e 65 72 61 6c 2d 70 75 72 70 the general-purp
0eb0: 6f 73 65 0a 2a 2a 20 6d 65 6d 6f 72 79 20 61 6c ose.** memory al
0ec0: 6c 6f 63 61 74 6f 72 20 28 31 29 2e 0a 2a 2a 0a locator (1)..**.
0ed0: 2a 2a 20 45 61 72 6c 69 65 72 20 76 65 72 73 69 ** Earlier versi
0ee0: 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 75 73 ons of SQLite us
0ef0: 65 64 20 6f 6e 6c 79 20 6d 65 74 68 6f 64 73 20 ed only methods
0f00: 28 31 29 20 61 6e 64 20 28 32 29 2e 20 20 42 75 (1) and (2). Bu
0f10: 74 20 65 78 70 65 72 69 6d 65 6e 74 73 0a 2a 2a t experiments.**
0f20: 20 73 68 6f 77 20 74 68 61 74 20 6d 65 74 68 6f show that metho
0f30: 64 20 28 33 29 20 77 69 74 68 20 4e 3d 3d 31 30 d (3) with N==10
0f40: 30 20 70 72 6f 76 69 64 65 73 20 61 62 6f 75 74 0 provides about
0f50: 20 61 20 35 25 20 70 65 72 66 6f 72 6d 61 6e 63 a 5% performanc
0f60: 65 20 62 6f 6f 73 74 20 66 6f 72 0a 2a 2a 20 63 e boost for.** c
0f70: 6f 6d 6d 6f 6e 20 77 6f 72 6b 6c 6f 61 64 73 2e ommon workloads.
0f80: 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 .*/.#include "sq
0f90: 6c 69 74 65 49 6e 74 2e 68 22 0a 0a 74 79 70 65 liteInt.h"..type
0fa0: 64 65 66 20 73 74 72 75 63 74 20 50 43 61 63 68 def struct PCach
0fb0: 65 31 20 50 43 61 63 68 65 31 3b 0a 74 79 70 65 e1 PCache1;.type
0fc0: 64 65 66 20 73 74 72 75 63 74 20 50 67 48 64 72 def struct PgHdr
0fd0: 31 20 50 67 48 64 72 31 3b 0a 74 79 70 65 64 65 1 PgHdr1;.typede
0fe0: 66 20 73 74 72 75 63 74 20 50 67 46 72 65 65 73 f struct PgFrees
0ff0: 6c 6f 74 20 50 67 46 72 65 65 73 6c 6f 74 3b 0a lot PgFreeslot;.
1000: 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 50 typedef struct P
1010: 47 72 6f 75 70 20 50 47 72 6f 75 70 3b 0a 0a 2f Group PGroup;../
1020: 2a 0a 2a 2a 20 45 61 63 68 20 63 61 63 68 65 20 *.** Each cache
1030: 65 6e 74 72 79 20 69 73 20 72 65 70 72 65 73 65 entry is represe
1040: 6e 74 65 64 20 62 79 20 61 6e 20 69 6e 73 74 61 nted by an insta
1050: 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f nce of the follo
1060: 77 69 6e 67 20 0a 2a 2a 20 73 74 72 75 63 74 75 wing .** structu
1070: 72 65 2e 20 55 6e 6c 65 73 73 20 53 51 4c 49 54 re. Unless SQLIT
1080: 45 5f 50 43 41 43 48 45 5f 53 45 50 41 52 41 54 E_PCACHE_SEPARAT
1090: 45 5f 48 45 41 44 45 52 20 69 73 20 64 65 66 69 E_HEADER is defi
10a0: 6e 65 64 2c 20 61 20 62 75 66 66 65 72 20 6f 66 ned, a buffer of
10b0: 0a 2a 2a 20 50 67 48 64 72 31 2e 70 43 61 63 68 .** PgHdr1.pCach
10c0: 65 2d 3e 73 7a 50 61 67 65 20 62 79 74 65 73 20 e->szPage bytes
10d0: 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 64 69 72 is allocated dir
10e0: 65 63 74 6c 79 20 62 65 66 6f 72 65 20 74 68 69 ectly before thi
10f0: 73 20 73 74 72 75 63 74 75 72 65 20 0a 2a 2a 20 s structure .**
1100: 69 6e 20 6d 65 6d 6f 72 79 2e 0a 2a 2a 0a 2a 2a in memory..**.**
1110: 20 4e 6f 74 65 3a 20 56 61 72 69 61 62 6c 65 73 Note: Variables
1120: 20 69 73 42 75 6c 6b 4c 6f 63 61 6c 20 61 6e 64 isBulkLocal and
1130: 20 69 73 41 6e 63 68 6f 72 20 77 65 72 65 20 6f isAnchor were o
1140: 6e 63 65 20 74 79 70 65 20 22 75 38 22 2e 20 54 nce type "u8". T
1150: 68 61 74 20 77 6f 72 6b 73 2c 0a 2a 2a 20 62 75 hat works,.** bu
1160: 74 20 63 61 75 73 65 73 20 61 20 32 2d 62 79 74 t causes a 2-byt
1170: 65 20 67 61 70 20 69 6e 20 74 68 65 20 73 74 72 e gap in the str
1180: 75 63 74 75 72 65 20 66 6f 72 20 6d 6f 73 74 20 ucture for most
1190: 61 72 63 68 69 74 65 63 74 75 72 65 73 20 28 73 architectures (s
11a0: 69 6e 63 65 20 0a 2a 2a 20 70 6f 69 6e 74 65 72 ince .** pointer
11b0: 73 20 6d 75 73 74 20 62 65 20 65 69 74 68 65 72 s must be either
11c0: 20 34 20 6f 72 20 38 2d 62 79 74 65 20 61 6c 69 4 or 8-byte ali
11d0: 67 6e 65 64 29 2e 20 41 73 20 74 68 69 73 20 73 gned). As this s
11e0: 74 72 75 63 74 75 72 65 20 69 73 20 6c 6f 63 61 tructure is loca
11f0: 74 65 64 0a 2a 2a 20 69 6e 20 6d 65 6d 6f 72 79 ted.** in memory
1200: 20 64 69 72 65 63 74 6c 79 20 61 66 74 65 72 20 directly after
1210: 74 68 65 20 61 73 73 6f 63 69 61 74 65 64 20 70 the associated p
1220: 61 67 65 20 64 61 74 61 2c 20 69 66 20 74 68 65 age data, if the
1230: 20 64 61 74 61 62 61 73 65 20 69 73 0a 2a 2a 20 database is.**
1240: 63 6f 72 72 75 70 74 2c 20 63 6f 64 65 20 61 74 corrupt, code at
1250: 20 74 68 65 20 62 2d 74 72 65 65 20 6c 61 79 65 the b-tree laye
1260: 72 20 6d 61 79 20 6f 76 65 72 72 65 61 64 20 74 r may overread t
1270: 68 65 20 70 61 67 65 20 62 75 66 66 65 72 20 61 he page buffer a
1280: 6e 64 20 0a 2a 2a 20 72 65 61 64 20 70 61 72 74 nd .** read part
1290: 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 74 75 of this structu
12a0: 72 65 20 62 65 66 6f 72 65 20 74 68 65 20 63 6f re before the co
12b0: 72 72 75 70 74 69 6f 6e 20 69 73 20 64 65 74 65 rruption is dete
12c0: 63 74 65 64 2e 20 54 68 69 73 0a 2a 2a 20 63 61 cted. This.** ca
12d0: 6e 20 63 61 75 73 65 20 61 20 76 61 6c 67 72 69 n cause a valgri
12e0: 6e 64 20 65 72 72 6f 72 20 69 66 20 74 68 65 20 nd error if the
12f0: 75 6e 69 74 69 61 6c 69 7a 65 64 20 67 61 70 20 unitialized gap
1300: 69 73 20 61 63 63 65 73 73 65 64 2e 20 55 73 69 is accessed. Usi
1310: 6e 67 20 75 31 36 0a 2a 2a 20 65 6e 73 75 72 65 ng u16.** ensure
1320: 73 20 74 68 65 72 65 20 69 73 20 6e 6f 20 73 75 s there is no su
1330: 63 68 20 67 61 70 2c 20 61 6e 64 20 74 68 65 72 ch gap, and ther
1340: 65 66 6f 72 65 20 6e 6f 20 62 79 74 65 73 20 6f efore no bytes o
1350: 66 20 75 6e 69 74 69 61 6c 69 7a 65 64 20 6d 65 f unitialized me
1360: 6d 6f 72 79 0a 2a 2a 20 69 6e 20 74 68 65 20 73 mory.** in the s
1370: 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 73 74 72 tructure..*/.str
1380: 75 63 74 20 50 67 48 64 72 31 20 7b 0a 20 20 73 uct PgHdr1 {. s
1390: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 70 61 qlite3_pcache_pa
13a0: 67 65 20 70 61 67 65 3b 20 20 20 20 20 20 2f 2a ge page; /*
13b0: 20 42 61 73 65 20 63 6c 61 73 73 2e 20 4d 75 73 Base class. Mus
13c0: 74 20 62 65 20 66 69 72 73 74 2e 20 70 42 75 66 t be first. pBuf
13d0: 20 26 20 70 45 78 74 72 61 20 2a 2f 0a 20 20 75 & pExtra */. u
13e0: 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4b 65 79 nsigned int iKey
13f0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a ; /*
1400: 20 4b 65 79 20 76 61 6c 75 65 20 28 70 61 67 65 Key value (page
1410: 20 6e 75 6d 62 65 72 29 20 2a 2f 0a 20 20 75 31 number) */. u1
1420: 36 20 69 73 42 75 6c 6b 4c 6f 63 61 6c 3b 20 20 6 isBulkLocal;
1430: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1440: 54 68 69 73 20 70 61 67 65 20 66 72 6f 6d 20 62 This page from b
1450: 75 6c 6b 20 6c 6f 63 61 6c 20 73 74 6f 72 61 67 ulk local storag
1460: 65 20 2a 2f 0a 20 20 75 31 36 20 69 73 41 6e 63 e */. u16 isAnc
1470: 68 6f 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 hor;
1480: 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 69 73 /* This is
1490: 20 74 68 65 20 50 47 72 6f 75 70 2e 6c 72 75 20 the PGroup.lru
14a0: 65 6c 65 6d 65 6e 74 20 2a 2f 0a 20 20 50 67 48 element */. PgH
14b0: 64 72 31 20 2a 70 4e 65 78 74 3b 20 20 20 20 20 dr1 *pNext;
14c0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
14d0: 65 78 74 20 69 6e 20 68 61 73 68 20 74 61 62 6c ext in hash tabl
14e0: 65 20 63 68 61 69 6e 20 2a 2f 0a 20 20 50 43 61 e chain */. PCa
14f0: 63 68 65 31 20 2a 70 43 61 63 68 65 3b 20 20 20 che1 *pCache;
1500: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 /* C
1510: 61 63 68 65 20 74 68 61 74 20 63 75 72 72 65 6e ache that curren
1520: 74 6c 79 20 6f 77 6e 73 20 74 68 69 73 20 70 61 tly owns this pa
1530: 67 65 20 2a 2f 0a 20 20 50 67 48 64 72 31 20 2a ge */. PgHdr1 *
1540: 70 4c 72 75 4e 65 78 74 3b 20 20 20 20 20 20 20 pLruNext;
1550: 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 69 /* Next i
1560: 6e 20 4c 52 55 20 6c 69 73 74 20 6f 66 20 75 6e n LRU list of un
1570: 70 69 6e 6e 65 64 20 70 61 67 65 73 20 2a 2f 0a pinned pages */.
1580: 20 20 50 67 48 64 72 31 20 2a 70 4c 72 75 50 72 PgHdr1 *pLruPr
1590: 65 76 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ev;
15a0: 20 2f 2a 20 50 72 65 76 69 6f 75 73 20 69 6e 20 /* Previous in
15b0: 4c 52 55 20 6c 69 73 74 20 6f 66 20 75 6e 70 69 LRU list of unpi
15c0: 6e 6e 65 64 20 70 61 67 65 73 20 2a 2f 0a 20 20 nned pages */.
15d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
15e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
15f0: 2a 20 4e 42 3a 20 70 4c 72 75 50 72 65 76 20 69 * NB: pLruPrev i
1600: 73 20 6f 6e 6c 79 20 76 61 6c 69 64 20 69 66 20 s only valid if
1610: 70 4c 72 75 4e 65 78 74 21 3d 30 20 2a 2f 0a 7d pLruNext!=0 */.}
1620: 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 70 61 67 65 20 ;../*.** A page
1630: 69 73 20 70 69 6e 6e 65 64 20 69 66 20 69 74 20 is pinned if it
1640: 69 73 20 6e 6f 74 20 6f 6e 20 74 68 65 20 4c 52 is not on the LR
1650: 55 20 6c 69 73 74 2e 20 20 54 6f 20 62 65 20 22 U list. To be "
1660: 70 69 6e 6e 65 64 22 20 6d 65 61 6e 73 0a 2a 2a pinned" means.**
1670: 20 74 68 61 74 20 74 68 65 20 70 61 67 65 20 69 that the page i
1680: 73 20 69 6e 20 61 63 74 69 76 65 20 75 73 65 20 s in active use
1690: 61 6e 64 20 6d 75 73 74 20 6e 6f 74 20 62 65 20 and must not be
16a0: 64 65 61 6c 6c 6f 63 61 74 65 64 2e 0a 2a 2f 0a deallocated..*/.
16b0: 23 64 65 66 69 6e 65 20 50 41 47 45 5f 49 53 5f #define PAGE_IS_
16c0: 50 49 4e 4e 45 44 28 70 29 20 20 20 20 28 28 70 PINNED(p) ((p
16d0: 29 2d 3e 70 4c 72 75 4e 65 78 74 3d 3d 30 29 0a )->pLruNext==0).
16e0: 23 64 65 66 69 6e 65 20 50 41 47 45 5f 49 53 5f #define PAGE_IS_
16f0: 55 4e 50 49 4e 4e 45 44 28 70 29 20 20 28 28 70 UNPINNED(p) ((p
1700: 29 2d 3e 70 4c 72 75 4e 65 78 74 21 3d 30 29 0a )->pLruNext!=0).
1710: 0a 2f 2a 20 45 61 63 68 20 70 61 67 65 20 63 61 ./* Each page ca
1720: 63 68 65 20 28 6f 72 20 50 43 61 63 68 65 29 20 che (or PCache)
1730: 62 65 6c 6f 6e 67 73 20 74 6f 20 61 20 50 47 72 belongs to a PGr
1740: 6f 75 70 2e 20 20 41 20 50 47 72 6f 75 70 20 69 oup. A PGroup i
1750: 73 20 61 20 73 65 74 20 0a 2a 2a 20 6f 66 20 6f s a set .** of o
1760: 6e 65 20 6f 72 20 6d 6f 72 65 20 50 43 61 63 68 ne or more PCach
1770: 65 73 20 74 68 61 74 20 61 72 65 20 61 62 6c 65 es that are able
1780: 20 74 6f 20 72 65 63 79 63 6c 65 20 65 61 63 68 to recycle each
1790: 20 6f 74 68 65 72 27 73 20 75 6e 70 69 6e 6e 65 other's unpinne
17a0: 64 0a 2a 2a 20 70 61 67 65 73 20 77 68 65 6e 20 d.** pages when
17b0: 74 68 65 79 20 61 72 65 20 75 6e 64 65 72 20 6d they are under m
17c0: 65 6d 6f 72 79 20 70 72 65 73 73 75 72 65 2e 20 emory pressure.
17d0: 20 41 20 50 47 72 6f 75 70 20 69 73 20 61 6e 20 A PGroup is an
17e0: 69 6e 73 74 61 6e 63 65 20 6f 66 0a 2a 2a 20 74 instance of.** t
17f0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 62 6a he following obj
1800: 65 63 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 ect..**.** This
1810: 70 61 67 65 20 63 61 63 68 65 20 69 6d 70 6c 65 page cache imple
1820: 6d 65 6e 74 61 74 69 6f 6e 20 77 6f 72 6b 73 20 mentation works
1830: 69 6e 20 6f 6e 65 20 6f 66 20 74 77 6f 20 6d 6f in one of two mo
1840: 64 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 28 31 29 des:.**.** (1)
1850: 20 20 45 76 65 72 79 20 50 43 61 63 68 65 20 69 Every PCache i
1860: 73 20 74 68 65 20 73 6f 6c 65 20 6d 65 6d 62 65 s the sole membe
1870: 72 20 6f 66 20 69 74 73 20 6f 77 6e 20 50 47 72 r of its own PGr
1880: 6f 75 70 2e 20 20 54 68 65 72 65 20 69 73 0a 2a oup. There is.*
1890: 2a 20 20 20 20 20 20 20 20 6f 6e 65 20 50 47 72 * one PGr
18a0: 6f 75 70 20 70 65 72 20 50 43 61 63 68 65 2e 0a oup per PCache..
18b0: 2a 2a 0a 2a 2a 20 20 20 28 32 29 20 20 54 68 65 **.** (2) The
18c0: 72 65 20 69 73 20 61 20 73 69 6e 67 6c 65 20 67 re is a single g
18d0: 6c 6f 62 61 6c 20 50 47 72 6f 75 70 20 74 68 61 lobal PGroup tha
18e0: 74 20 61 6c 6c 20 50 43 61 63 68 65 73 20 61 72 t all PCaches ar
18f0: 65 20 61 20 6d 65 6d 62 65 72 0a 2a 2a 20 20 20 e a member.**
1900: 20 20 20 20 20 6f 66 2e 0a 2a 2a 0a 2a 2a 20 4d of..**.** M
1910: 6f 64 65 20 31 20 75 73 65 73 20 6d 6f 72 65 20 ode 1 uses more
1920: 6d 65 6d 6f 72 79 20 28 73 69 6e 63 65 20 50 43 memory (since PC
1930: 61 63 68 65 20 69 6e 73 74 61 6e 63 65 73 20 61 ache instances a
1940: 72 65 20 6e 6f 74 20 61 62 6c 65 20 74 6f 20 72 re not able to r
1950: 6f 62 0a 2a 2a 20 75 6e 75 73 65 64 20 70 61 67 ob.** unused pag
1960: 65 73 20 66 72 6f 6d 20 6f 74 68 65 72 20 50 43 es from other PC
1970: 61 63 68 65 73 29 20 62 75 74 20 69 74 20 61 6c aches) but it al
1980: 73 6f 20 6f 70 65 72 61 74 65 73 20 77 69 74 68 so operates with
1990: 6f 75 74 20 61 20 6d 75 74 65 78 2c 0a 2a 2a 20 out a mutex,.**
19a0: 61 6e 64 20 69 73 20 74 68 65 72 65 66 6f 72 65 and is therefore
19b0: 20 6f 66 74 65 6e 20 66 61 73 74 65 72 2e 20 20 often faster.
19c0: 4d 6f 64 65 20 32 20 72 65 71 75 69 72 65 73 20 Mode 2 requires
19d0: 61 20 6d 75 74 65 78 20 69 6e 20 6f 72 64 65 72 a mutex in order
19e0: 20 74 6f 20 62 65 0a 2a 2a 20 74 68 72 65 61 64 to be.** thread
19f0: 73 61 66 65 2c 20 62 75 74 20 72 65 63 79 63 6c safe, but recycl
1a00: 65 73 20 70 61 67 65 73 20 6d 6f 72 65 20 65 66 es pages more ef
1a10: 66 69 63 69 65 6e 74 6c 79 2e 0a 2a 2a 0a 2a 2a ficiently..**.**
1a20: 20 46 6f 72 20 6d 6f 64 65 20 28 31 29 2c 20 50 For mode (1), P
1a30: 47 72 6f 75 70 2e 6d 75 74 65 78 20 69 73 20 4e Group.mutex is N
1a40: 55 4c 4c 2e 20 20 46 6f 72 20 6d 6f 64 65 20 28 ULL. For mode (
1a50: 32 29 20 74 68 65 72 65 20 69 73 20 6f 6e 6c 79 2) there is only
1a60: 20 61 20 73 69 6e 67 6c 65 0a 2a 2a 20 50 47 72 a single.** PGr
1a70: 6f 75 70 20 77 68 69 63 68 20 69 73 20 74 68 65 oup which is the
1a80: 20 70 63 61 63 68 65 31 2e 67 72 70 20 67 6c 6f pcache1.grp glo
1a90: 62 61 6c 20 76 61 72 69 61 62 6c 65 20 61 6e 64 bal variable and
1aa0: 20 69 74 73 20 6d 75 74 65 78 20 69 73 0a 2a 2a its mutex is.**
1ab0: 20 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 SQLITE_MUTEX_ST
1ac0: 41 54 49 43 5f 4c 52 55 2e 0a 2a 2f 0a 73 74 72 ATIC_LRU..*/.str
1ad0: 75 63 74 20 50 47 72 6f 75 70 20 7b 0a 20 20 73 uct PGroup {. s
1ae0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 qlite3_mutex *mu
1af0: 74 65 78 3b 20 20 20 20 20 20 20 20 20 20 2f 2a tex; /*
1b00: 20 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c 52 MUTEX_STATIC_LR
1b10: 55 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20 75 U or NULL */. u
1b20: 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 4d 61 78 nsigned int nMax
1b30: 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 2f 2a Page; /*
1b40: 20 53 75 6d 20 6f 66 20 6e 4d 61 78 20 66 6f 72 Sum of nMax for
1b50: 20 70 75 72 67 65 61 62 6c 65 20 63 61 63 68 65 purgeable cache
1b60: 73 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 s */. unsigned
1b70: 69 6e 74 20 6e 4d 69 6e 50 61 67 65 3b 20 20 20 int nMinPage;
1b80: 20 20 20 20 20 20 2f 2a 20 53 75 6d 20 6f 66 20 /* Sum of
1b90: 6e 4d 69 6e 20 66 6f 72 20 70 75 72 67 65 61 62 nMin for purgeab
1ba0: 6c 65 20 63 61 63 68 65 73 20 2a 2f 0a 20 20 75 le caches */. u
1bb0: 6e 73 69 67 6e 65 64 20 69 6e 74 20 6d 78 50 69 nsigned int mxPi
1bc0: 6e 6e 65 64 3b 20 20 20 20 20 20 20 20 20 2f 2a nned; /*
1bd0: 20 6e 4d 61 78 70 61 67 65 20 2b 20 31 30 20 2d nMaxpage + 10 -
1be0: 20 6e 4d 69 6e 50 61 67 65 20 2a 2f 0a 20 20 75 nMinPage */. u
1bf0: 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 50 75 72 nsigned int nPur
1c00: 67 65 61 62 6c 65 3b 20 20 20 20 20 20 20 2f 2a geable; /*
1c10: 20 4e 75 6d 62 65 72 20 6f 66 20 70 75 72 67 65 Number of purge
1c20: 61 62 6c 65 20 70 61 67 65 73 20 61 6c 6c 6f 63 able pages alloc
1c30: 61 74 65 64 20 2a 2f 0a 20 20 50 67 48 64 72 31 ated */. PgHdr1
1c40: 20 6c 72 75 3b 20 20 20 20 20 20 20 20 20 20 20 lru;
1c50: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
1c60: 62 65 67 69 6e 6e 69 6e 67 20 61 6e 64 20 65 6e beginning and en
1c70: 64 20 6f 66 20 74 68 65 20 4c 52 55 20 6c 69 73 d of the LRU lis
1c80: 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 45 61 63 68 t */.};../* Each
1c90: 20 70 61 67 65 20 63 61 63 68 65 20 69 73 20 61 page cache is a
1ca0: 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 n instance of th
1cb0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 62 6a 65 e following obje
1cc0: 63 74 2e 20 20 45 76 65 72 79 0a 2a 2a 20 6f 70 ct. Every.** op
1cd0: 65 6e 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 en database file
1ce0: 20 28 69 6e 63 6c 75 64 69 6e 67 20 65 61 63 68 (including each
1cf0: 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 in-memory datab
1d00: 61 73 65 20 61 6e 64 20 65 61 63 68 0a 2a 2a 20 ase and each.**
1d10: 74 65 6d 70 6f 72 61 72 79 20 6f 72 20 74 72 61 temporary or tra
1d20: 6e 73 69 65 6e 74 20 64 61 74 61 62 61 73 65 29 nsient database)
1d30: 20 68 61 73 20 61 20 73 69 6e 67 6c 65 20 70 61 has a single pa
1d40: 67 65 20 63 61 63 68 65 20 77 68 69 63 68 0a 2a ge cache which.*
1d50: 2a 20 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 * is an instance
1d60: 20 6f 66 20 74 68 69 73 20 6f 62 6a 65 63 74 2e of this object.
1d70: 0a 2a 2a 0a 2a 2a 20 50 6f 69 6e 74 65 72 73 20 .**.** Pointers
1d80: 74 6f 20 73 74 72 75 63 74 75 72 65 73 20 6f 66 to structures of
1d90: 20 74 68 69 73 20 74 79 70 65 20 61 72 65 20 63 this type are c
1da0: 61 73 74 20 61 6e 64 20 72 65 74 75 72 6e 65 64 ast and returned
1db0: 20 61 73 20 0a 2a 2a 20 6f 70 61 71 75 65 20 73 as .** opaque s
1dc0: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2a 20 68 qlite3_pcache* h
1dd0: 61 6e 64 6c 65 73 2e 0a 2a 2f 0a 73 74 72 75 63 andles..*/.struc
1de0: 74 20 50 43 61 63 68 65 31 20 7b 0a 20 20 2f 2a t PCache1 {. /*
1df0: 20 43 61 63 68 65 20 63 6f 6e 66 69 67 75 72 61 Cache configura
1e00: 74 69 6f 6e 20 70 61 72 61 6d 65 74 65 72 73 2e tion parameters.
1e10: 20 50 61 67 65 20 73 69 7a 65 20 28 73 7a 50 61 Page size (szPa
1e20: 67 65 29 20 61 6e 64 20 74 68 65 20 70 75 72 67 ge) and the purg
1e30: 65 61 62 6c 65 0a 20 20 2a 2a 20 66 6c 61 67 20 eable. ** flag
1e40: 28 62 50 75 72 67 65 61 62 6c 65 29 20 61 6e 64 (bPurgeable) and
1e50: 20 74 68 65 20 70 6e 50 75 72 67 65 61 62 6c 65 the pnPurgeable
1e60: 20 70 6f 69 6e 74 65 72 20 61 72 65 20 61 6c 6c pointer are all
1e70: 20 73 65 74 20 77 68 65 6e 20 74 68 65 0a 20 20 set when the.
1e80: 2a 2a 20 63 61 63 68 65 20 69 73 20 63 72 65 61 ** cache is crea
1e90: 74 65 64 20 61 6e 64 20 61 72 65 20 6e 65 76 65 ted and are neve
1ea0: 72 20 63 68 61 6e 67 65 64 20 74 68 65 72 65 61 r changed therea
1eb0: 66 74 65 72 2e 20 6e 4d 61 78 20 6d 61 79 20 62 fter. nMax may b
1ec0: 65 20 0a 20 20 2a 2a 20 6d 6f 64 69 66 69 65 64 e . ** modified
1ed0: 20 61 74 20 61 6e 79 20 74 69 6d 65 20 62 79 20 at any time by
1ee0: 61 20 63 61 6c 6c 20 74 6f 20 74 68 65 20 70 63 a call to the pc
1ef0: 61 63 68 65 31 43 61 63 68 65 73 69 7a 65 28 29 ache1Cachesize()
1f00: 20 6d 65 74 68 6f 64 2e 0a 20 20 2a 2a 20 54 68 method.. ** Th
1f10: 65 20 50 47 72 6f 75 70 20 6d 75 74 65 78 20 6d e PGroup mutex m
1f20: 75 73 74 20 62 65 20 68 65 6c 64 20 77 68 65 6e ust be held when
1f30: 20 61 63 63 65 73 73 69 6e 67 20 6e 4d 61 78 2e accessing nMax.
1f40: 0a 20 20 2a 2f 0a 20 20 50 47 72 6f 75 70 20 2a . */. PGroup *
1f50: 70 47 72 6f 75 70 3b 20 20 20 20 20 20 20 20 20 pGroup;
1f60: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 /* P
1f70: 47 72 6f 75 70 20 74 68 69 73 20 63 61 63 68 65 Group this cache
1f80: 20 62 65 6c 6f 6e 67 73 20 74 6f 20 2a 2f 0a 20 belongs to */.
1f90: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 2a 70 unsigned int *p
1fa0: 6e 50 75 72 67 65 61 62 6c 65 3b 20 20 20 20 20 nPurgeable;
1fb0: 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 /* Pointer
1fc0: 74 6f 20 70 47 72 6f 75 70 2d 3e 6e 50 75 72 67 to pGroup->nPurg
1fd0: 65 61 62 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 73 eable */. int s
1fe0: 7a 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 zPage;
1ff0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
2000: 2a 20 53 69 7a 65 20 6f 66 20 64 61 74 61 62 61 * Size of databa
2010: 73 65 20 63 6f 6e 74 65 6e 74 20 73 65 63 74 69 se content secti
2020: 6f 6e 20 2a 2f 0a 20 20 69 6e 74 20 73 7a 45 78 on */. int szEx
2030: 74 72 61 3b 20 20 20 20 20 20 20 20 20 20 20 20 tra;
2040: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 73 /* s
2050: 69 7a 65 6f 66 28 4d 65 6d 50 61 67 65 29 2b 73 izeof(MemPage)+s
2060: 69 7a 65 6f 66 28 50 67 48 64 72 29 20 2a 2f 0a izeof(PgHdr) */.
2070: 20 20 69 6e 74 20 73 7a 41 6c 6c 6f 63 3b 20 20 int szAlloc;
2080: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2090: 20 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 73 /* Total s
20a0: 69 7a 65 20 6f 66 20 6f 6e 65 20 70 63 61 63 68 ize of one pcach
20b0: 65 20 6c 69 6e 65 20 2a 2f 0a 20 20 69 6e 74 20 e line */. int
20c0: 62 50 75 72 67 65 61 62 6c 65 3b 20 20 20 20 20 bPurgeable;
20d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20e0: 2f 2a 20 54 72 75 65 20 69 66 20 63 61 63 68 65 /* True if cache
20f0: 20 69 73 20 70 75 72 67 65 61 62 6c 65 20 2a 2f is purgeable */
2100: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 . unsigned int
2110: 6e 4d 69 6e 3b 20 20 20 20 20 20 20 20 20 20 20 nMin;
2120: 20 20 20 20 20 20 20 2f 2a 20 4d 69 6e 69 6d 75 /* Minimu
2130: 6d 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 m number of page
2140: 73 20 72 65 73 65 72 76 65 64 20 2a 2f 0a 20 20 s reserved */.
2150: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 4d 61 unsigned int nMa
2160: 78 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 x;
2170: 20 20 20 20 2f 2a 20 43 6f 6e 66 69 67 75 72 65 /* Configure
2180: 64 20 22 63 61 63 68 65 5f 73 69 7a 65 22 20 76 d "cache_size" v
2190: 61 6c 75 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e alue */. unsign
21a0: 65 64 20 69 6e 74 20 6e 39 30 70 63 74 3b 20 20 ed int n90pct;
21b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
21c0: 20 6e 4d 61 78 2a 39 2f 31 30 20 2a 2f 0a 20 20 nMax*9/10 */.
21d0: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4d 61 unsigned int iMa
21e0: 78 4b 65 79 3b 20 20 20 20 20 20 20 20 20 20 20 xKey;
21f0: 20 20 20 20 2f 2a 20 4c 61 72 67 65 73 74 20 6b /* Largest k
2200: 65 79 20 73 65 65 6e 20 73 69 6e 63 65 20 78 54 ey seen since xT
2210: 72 75 6e 63 61 74 65 28 29 20 2a 2f 0a 20 20 75 runcate() */. u
2220: 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 50 75 72 nsigned int nPur
2230: 67 65 61 62 6c 65 44 75 6d 6d 79 3b 20 20 20 20 geableDummy;
2240: 20 20 20 2f 2a 20 70 6e 50 75 72 67 65 61 62 6c /* pnPurgeabl
2250: 65 20 70 6f 69 6e 74 73 20 68 65 72 65 20 77 68 e points here wh
2260: 65 6e 20 6e 6f 74 20 75 73 65 64 2a 2f 0a 0a 20 en not used*/..
2270: 20 2f 2a 20 48 61 73 68 20 74 61 62 6c 65 20 6f /* Hash table o
2280: 66 20 61 6c 6c 20 70 61 67 65 73 2e 20 54 68 65 f all pages. The
2290: 20 66 6f 6c 6c 6f 77 69 6e 67 20 76 61 72 69 61 following varia
22a0: 62 6c 65 73 20 6d 61 79 20 6f 6e 6c 79 20 62 65 bles may only be
22b0: 20 61 63 63 65 73 73 65 64 0a 20 20 2a 2a 20 77 accessed. ** w
22c0: 68 65 6e 20 74 68 65 20 61 63 63 65 73 73 6f 72 hen the accessor
22d0: 20 69 73 20 68 6f 6c 64 69 6e 67 20 74 68 65 20 is holding the
22e0: 50 47 72 6f 75 70 20 6d 75 74 65 78 2e 0a 20 20 PGroup mutex..
22f0: 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e */. unsigned in
2300: 74 20 6e 52 65 63 79 63 6c 61 62 6c 65 3b 20 20 t nRecyclable;
2310: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
2320: 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 er of pages in t
2330: 68 65 20 4c 52 55 20 6c 69 73 74 20 2a 2f 0a 20 he LRU list */.
2340: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 50 unsigned int nP
2350: 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 age;
2360: 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 6e 75 /* Total nu
2370: 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e mber of pages in
2380: 20 61 70 48 61 73 68 20 2a 2f 0a 20 20 75 6e 73 apHash */. uns
2390: 69 67 6e 65 64 20 69 6e 74 20 6e 48 61 73 68 3b igned int nHash;
23a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23b0: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 73 6c /* Number of sl
23c0: 6f 74 73 20 69 6e 20 61 70 48 61 73 68 5b 5d 20 ots in apHash[]
23d0: 2a 2f 0a 20 20 50 67 48 64 72 31 20 2a 2a 61 70 */. PgHdr1 **ap
23e0: 48 61 73 68 3b 20 20 20 20 20 20 20 20 20 20 20 Hash;
23f0: 20 20 20 20 20 20 20 20 20 2f 2a 20 48 61 73 68 /* Hash
2400: 20 74 61 62 6c 65 20 66 6f 72 20 66 61 73 74 20 table for fast
2410: 6c 6f 6f 6b 75 70 20 62 79 20 6b 65 79 20 2a 2f lookup by key */
2420: 0a 20 20 50 67 48 64 72 31 20 2a 70 46 72 65 65 . PgHdr1 *pFree
2430: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
2440: 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f /* List o
2450: 66 20 75 6e 75 73 65 64 20 70 63 61 63 68 65 2d f unused pcache-
2460: 6c 6f 63 61 6c 20 70 61 67 65 73 20 2a 2f 0a 20 local pages */.
2470: 20 76 6f 69 64 20 2a 70 42 75 6c 6b 3b 20 20 20 void *pBulk;
2480: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2490: 20 20 20 20 20 2f 2a 20 42 75 6c 6b 20 6d 65 6d /* Bulk mem
24a0: 6f 72 79 20 75 73 65 64 20 62 79 20 70 63 61 63 ory used by pcac
24b0: 68 65 2d 6c 6f 63 61 6c 20 2a 2f 0a 7d 3b 0a 0a he-local */.};..
24c0: 2f 2a 0a 2a 2a 20 46 72 65 65 20 73 6c 6f 74 73 /*.** Free slots
24d0: 20 69 6e 20 74 68 65 20 61 6c 6c 6f 63 61 74 6f in the allocato
24e0: 72 20 75 73 65 64 20 74 6f 20 64 69 76 69 64 65 r used to divide
24f0: 20 75 70 20 74 68 65 20 67 6c 6f 62 61 6c 20 70 up the global p
2500: 61 67 65 20 63 61 63 68 65 0a 2a 2a 20 62 75 66 age cache.** buf
2510: 66 65 72 20 70 72 6f 76 69 64 65 64 20 75 73 69 fer provided usi
2520: 6e 67 20 74 68 65 20 53 51 4c 49 54 45 5f 43 4f ng the SQLITE_CO
2530: 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45 20 6d NFIG_PAGECACHE m
2540: 65 63 68 61 6e 69 73 6d 2e 0a 2a 2f 0a 73 74 72 echanism..*/.str
2550: 75 63 74 20 50 67 46 72 65 65 73 6c 6f 74 20 7b uct PgFreeslot {
2560: 0a 20 20 50 67 46 72 65 65 73 6c 6f 74 20 2a 70 . PgFreeslot *p
2570: 4e 65 78 74 3b 20 20 2f 2a 20 4e 65 78 74 20 66 Next; /* Next f
2580: 72 65 65 20 73 6c 6f 74 20 2a 2f 0a 7d 3b 0a 0a ree slot */.};..
2590: 2f 2a 0a 2a 2a 20 47 6c 6f 62 61 6c 20 64 61 74 /*.** Global dat
25a0: 61 20 75 73 65 64 20 62 79 20 74 68 69 73 20 63 a used by this c
25b0: 61 63 68 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 ache..*/.static
25c0: 53 51 4c 49 54 45 5f 57 53 44 20 73 74 72 75 63 SQLITE_WSD struc
25d0: 74 20 50 43 61 63 68 65 47 6c 6f 62 61 6c 20 7b t PCacheGlobal {
25e0: 0a 20 20 50 47 72 6f 75 70 20 67 72 70 3b 20 20 . PGroup grp;
25f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2600: 20 20 2f 2a 20 54 68 65 20 67 6c 6f 62 61 6c 20 /* The global
2610: 50 47 72 6f 75 70 20 66 6f 72 20 6d 6f 64 65 20 PGroup for mode
2620: 28 32 29 20 2a 2f 0a 0a 20 20 2f 2a 20 56 61 72 (2) */.. /* Var
2630: 69 61 62 6c 65 73 20 72 65 6c 61 74 65 64 20 74 iables related t
2640: 6f 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f o SQLITE_CONFIG_
2650: 50 41 47 45 43 41 43 48 45 20 73 65 74 74 69 6e PAGECACHE settin
2660: 67 73 2e 20 20 54 68 65 0a 20 20 2a 2a 20 73 7a gs. The. ** sz
2670: 53 6c 6f 74 2c 20 6e 53 6c 6f 74 2c 20 70 53 74 Slot, nSlot, pSt
2680: 61 72 74 2c 20 70 45 6e 64 2c 20 6e 52 65 73 65 art, pEnd, nRese
2690: 72 76 65 2c 20 61 6e 64 20 69 73 49 6e 69 74 20 rve, and isInit
26a0: 76 61 6c 75 65 73 20 61 72 65 20 61 6c 6c 0a 20 values are all.
26b0: 20 2a 2a 20 66 69 78 65 64 20 61 74 20 73 71 6c ** fixed at sql
26c0: 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 ite3_initialize(
26d0: 29 20 74 69 6d 65 20 61 6e 64 20 64 6f 20 6e 6f ) time and do no
26e0: 74 20 72 65 71 75 69 72 65 20 6d 75 74 65 78 20 t require mutex
26f0: 70 72 6f 74 65 63 74 69 6f 6e 2e 0a 20 20 2a 2a protection.. **
2700: 20 54 68 65 20 6e 46 72 65 65 53 6c 6f 74 20 61 The nFreeSlot a
2710: 6e 64 20 70 46 72 65 65 20 76 61 6c 75 65 73 20 nd pFree values
2720: 64 6f 20 72 65 71 75 69 72 65 20 6d 75 74 65 78 do require mutex
2730: 20 70 72 6f 74 65 63 74 69 6f 6e 2e 0a 20 20 2a protection.. *
2740: 2f 0a 20 20 69 6e 74 20 69 73 49 6e 69 74 3b 20 /. int isInit;
2750: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2760: 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 69 6e /* True if in
2770: 69 74 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 20 69 itialized */. i
2780: 6e 74 20 73 65 70 61 72 61 74 65 43 61 63 68 65 nt separateCache
2790: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a ; /*
27a0: 20 55 73 65 20 61 20 6e 65 77 20 50 47 72 6f 75 Use a new PGrou
27b0: 70 20 66 6f 72 20 65 61 63 68 20 50 43 61 63 68 p for each PCach
27c0: 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 49 6e 69 74 e */. int nInit
27d0: 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 Page;
27e0: 20 20 20 20 20 20 2f 2a 20 49 6e 69 74 69 61 6c /* Initial
27f0: 20 62 75 6c 6b 20 61 6c 6c 6f 63 61 74 69 6f 6e bulk allocation
2800: 20 73 69 7a 65 20 2a 2f 20 20 20 0a 20 20 69 6e size */ . in
2810: 74 20 73 7a 53 6c 6f 74 3b 20 20 20 20 20 20 20 t szSlot;
2820: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
2830: 53 69 7a 65 20 6f 66 20 65 61 63 68 20 66 72 65 Size of each fre
2840: 65 20 73 6c 6f 74 20 2a 2f 0a 20 20 69 6e 74 20 e slot */. int
2850: 6e 53 6c 6f 74 3b 20 20 20 20 20 20 20 20 20 20 nSlot;
2860: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
2870: 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 63 61 63 e number of pcac
2880: 68 65 20 73 6c 6f 74 73 20 2a 2f 0a 20 20 69 6e he slots */. in
2890: 74 20 6e 52 65 73 65 72 76 65 3b 20 20 20 20 20 t nReserve;
28a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
28b0: 54 72 79 20 74 6f 20 6b 65 65 70 20 6e 46 72 65 Try to keep nFre
28c0: 65 53 6c 6f 74 20 61 62 6f 76 65 20 74 68 69 73 eSlot above this
28d0: 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 53 74 61 */. void *pSta
28e0: 72 74 2c 20 2a 70 45 6e 64 3b 20 20 20 20 20 20 rt, *pEnd;
28f0: 20 20 20 20 20 2f 2a 20 42 6f 75 6e 64 73 20 6f /* Bounds o
2900: 66 20 67 6c 6f 62 61 6c 20 70 61 67 65 20 63 61 f global page ca
2910: 63 68 65 20 6d 65 6d 6f 72 79 20 2a 2f 0a 20 20 che memory */.
2920: 2f 2a 20 41 62 6f 76 65 20 72 65 71 75 69 72 65 /* Above require
2930: 73 20 6e 6f 20 6d 75 74 65 78 2e 20 20 55 73 65 s no mutex. Use
2940: 20 6d 75 74 65 78 20 62 65 6c 6f 77 20 66 6f 72 mutex below for
2950: 20 76 61 72 69 61 62 6c 65 20 74 68 61 74 20 66 variable that f
2960: 6f 6c 6c 6f 77 2e 20 2a 2f 0a 20 20 73 71 6c 69 ollow. */. sqli
2970: 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 te3_mutex *mutex
2980: 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 75 ; /* Mu
2990: 74 65 78 20 66 6f 72 20 61 63 63 65 73 73 69 6e tex for accessin
29a0: 67 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a g the following:
29b0: 20 2a 2f 0a 20 20 50 67 46 72 65 65 73 6c 6f 74 */. PgFreeslot
29c0: 20 2a 70 46 72 65 65 3b 20 20 20 20 20 20 20 20 *pFree;
29d0: 20 20 20 20 20 2f 2a 20 46 72 65 65 20 70 61 67 /* Free pag
29e0: 65 20 62 6c 6f 63 6b 73 20 2a 2f 0a 20 20 69 6e e blocks */. in
29f0: 74 20 6e 46 72 65 65 53 6c 6f 74 3b 20 20 20 20 t nFreeSlot;
2a00: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
2a10: 4e 75 6d 62 65 72 20 6f 66 20 75 6e 75 73 65 64 Number of unused
2a20: 20 70 63 61 63 68 65 20 73 6c 6f 74 73 20 2a 2f pcache slots */
2a30: 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 . /* The follow
2a40: 69 6e 67 20 76 61 6c 75 65 20 72 65 71 75 69 72 ing value requir
2a50: 65 73 20 61 20 6d 75 74 65 78 20 74 6f 20 63 68 es a mutex to ch
2a60: 61 6e 67 65 2e 20 20 57 65 20 73 6b 69 70 20 74 ange. We skip t
2a70: 68 65 20 6d 75 74 65 78 20 6f 6e 0a 20 20 2a 2a he mutex on. **
2a80: 20 72 65 61 64 69 6e 67 20 62 65 63 61 75 73 65 reading because
2a90: 20 28 31 29 20 6d 6f 73 74 20 70 6c 61 74 66 6f (1) most platfo
2aa0: 72 6d 73 20 72 65 61 64 20 61 20 33 32 2d 62 69 rms read a 32-bi
2ab0: 74 20 69 6e 74 65 67 65 72 20 61 74 6f 6d 69 63 t integer atomic
2ac0: 61 6c 6c 79 20 61 6e 64 0a 20 20 2a 2a 20 28 32 ally and. ** (2
2ad0: 29 20 65 76 65 6e 20 69 66 20 61 6e 20 69 6e 63 ) even if an inc
2ae0: 6f 72 72 65 63 74 20 76 61 6c 75 65 20 69 73 20 orrect value is
2af0: 72 65 61 64 2c 20 6e 6f 20 67 72 65 61 74 20 68 read, no great h
2b00: 61 72 6d 20 69 73 20 64 6f 6e 65 20 73 69 6e 63 arm is done sinc
2b10: 65 20 74 68 69 73 0a 20 20 2a 2a 20 69 73 20 72 e this. ** is r
2b20: 65 61 6c 6c 79 20 6a 75 73 74 20 61 6e 20 6f 70 eally just an op
2b30: 74 69 6d 69 7a 61 74 69 6f 6e 2e 20 2a 2f 0a 20 timization. */.
2b40: 20 69 6e 74 20 62 55 6e 64 65 72 50 72 65 73 73 int bUnderPress
2b50: 75 72 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ure;
2b60: 2f 2a 20 54 72 75 65 20 69 66 20 6c 6f 77 20 6f /* True if low o
2b70: 6e 20 50 41 47 45 43 41 43 48 45 20 6d 65 6d 6f n PAGECACHE memo
2b80: 72 79 20 2a 2f 0a 7d 20 70 63 61 63 68 65 31 5f ry */.} pcache1_
2b90: 67 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 20 63 6f g;../*.** All co
2ba0: 64 65 20 69 6e 20 74 68 69 73 20 66 69 6c 65 20 de in this file
2bb0: 73 68 6f 75 6c 64 20 61 63 63 65 73 73 20 74 68 should access th
2bc0: 65 20 67 6c 6f 62 61 6c 20 73 74 72 75 63 74 75 e global structu
2bd0: 72 65 20 61 62 6f 76 65 20 76 69 61 20 74 68 65 re above via the
2be0: 0a 2a 2a 20 61 6c 69 61 73 20 22 70 63 61 63 68 .** alias "pcach
2bf0: 65 31 22 2e 20 54 68 69 73 20 65 6e 73 75 72 65 e1". This ensure
2c00: 73 20 74 68 61 74 20 74 68 65 20 57 53 44 20 65 s that the WSD e
2c10: 6d 75 6c 61 74 69 6f 6e 20 69 73 20 75 73 65 64 mulation is used
2c20: 20 77 68 65 6e 0a 2a 2a 20 63 6f 6d 70 69 6c 69 when.** compili
2c30: 6e 67 20 66 6f 72 20 73 79 73 74 65 6d 73 20 74 ng for systems t
2c40: 68 61 74 20 64 6f 20 6e 6f 74 20 73 75 70 70 6f hat do not suppo
2c50: 72 74 20 72 65 61 6c 20 57 53 44 2e 0a 2a 2f 0a rt real WSD..*/.
2c60: 23 64 65 66 69 6e 65 20 70 63 61 63 68 65 31 20 #define pcache1
2c70: 28 47 4c 4f 42 41 4c 28 73 74 72 75 63 74 20 50 (GLOBAL(struct P
2c80: 43 61 63 68 65 47 6c 6f 62 61 6c 2c 20 70 63 61 CacheGlobal, pca
2c90: 63 68 65 31 5f 67 29 29 0a 0a 2f 2a 0a 2a 2a 20 che1_g))../*.**
2ca0: 4d 61 63 72 6f 73 20 74 6f 20 65 6e 74 65 72 20 Macros to enter
2cb0: 61 6e 64 20 6c 65 61 76 65 20 74 68 65 20 50 43 and leave the PC
2cc0: 61 63 68 65 20 4c 52 55 20 6d 75 74 65 78 2e 0a ache LRU mutex..
2cd0: 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 */.#if !defined(
2ce0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 SQLITE_ENABLE_ME
2cf0: 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 29 MORY_MANAGEMENT)
2d00: 20 7c 7c 20 53 51 4c 49 54 45 5f 54 48 52 45 41 || SQLITE_THREA
2d10: 44 53 41 46 45 3d 3d 30 0a 23 20 64 65 66 69 6e DSAFE==0.# defin
2d20: 65 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 e pcache1EnterMu
2d30: 74 65 78 28 58 29 20 20 61 73 73 65 72 74 28 28 tex(X) assert((
2d40: 58 29 2d 3e 6d 75 74 65 78 3d 3d 30 29 0a 23 20 X)->mutex==0).#
2d50: 64 65 66 69 6e 65 20 70 63 61 63 68 65 31 4c 65 define pcache1Le
2d60: 61 76 65 4d 75 74 65 78 28 58 29 20 20 61 73 73 aveMutex(X) ass
2d70: 65 72 74 28 28 58 29 2d 3e 6d 75 74 65 78 3d 3d ert((X)->mutex==
2d80: 30 29 0a 23 20 64 65 66 69 6e 65 20 50 43 41 43 0).# define PCAC
2d90: 48 45 31 5f 4d 49 47 48 54 5f 55 53 45 5f 47 52 HE1_MIGHT_USE_GR
2da0: 4f 55 50 5f 4d 55 54 45 58 20 30 0a 23 65 6c 73 OUP_MUTEX 0.#els
2db0: 65 0a 23 20 64 65 66 69 6e 65 20 70 63 61 63 68 e.# define pcach
2dc0: 65 31 45 6e 74 65 72 4d 75 74 65 78 28 58 29 20 e1EnterMutex(X)
2dd0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e sqlite3_mutex_en
2de0: 74 65 72 28 28 58 29 2d 3e 6d 75 74 65 78 29 0a ter((X)->mutex).
2df0: 23 20 64 65 66 69 6e 65 20 70 63 61 63 68 65 31 # define pcache1
2e00: 4c 65 61 76 65 4d 75 74 65 78 28 58 29 20 73 71 LeaveMutex(X) sq
2e10: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
2e20: 65 28 28 58 29 2d 3e 6d 75 74 65 78 29 0a 23 20 e((X)->mutex).#
2e30: 64 65 66 69 6e 65 20 50 43 41 43 48 45 31 5f 4d define PCACHE1_M
2e40: 49 47 48 54 5f 55 53 45 5f 47 52 4f 55 50 5f 4d IGHT_USE_GROUP_M
2e50: 55 54 45 58 20 31 0a 23 65 6e 64 69 66 0a 0a 2f UTEX 1.#endif../
2e60: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
2e70: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
2e80: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
2e90: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
2ea0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a **************/.
2eb0: 2f 2a 2a 2a 2a 2a 2a 2a 2a 20 50 61 67 65 20 41 /******** Page A
2ec0: 6c 6c 6f 63 61 74 69 6f 6e 2f 53 51 4c 49 54 45 llocation/SQLITE
2ed0: 5f 43 4f 4e 46 49 47 5f 50 43 41 43 48 45 20 52 _CONFIG_PCACHE R
2ee0: 65 6c 61 74 65 64 20 46 75 6e 63 74 69 6f 6e 73 elated Functions
2ef0: 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f **************/
2f00: 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 .../*.** This fu
2f10: 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 nction is called
2f20: 20 64 75 72 69 6e 67 20 69 6e 69 74 69 61 6c 69 during initiali
2f30: 7a 61 74 69 6f 6e 20 69 66 20 61 20 73 74 61 74 zation if a stat
2f40: 69 63 20 62 75 66 66 65 72 20 69 73 20 0a 2a 2a ic buffer is .**
2f50: 20 73 75 70 70 6c 69 65 64 20 74 6f 20 75 73 65 supplied to use
2f60: 20 66 6f 72 20 74 68 65 20 70 61 67 65 2d 63 61 for the page-ca
2f70: 63 68 65 20 62 79 20 70 61 73 73 69 6e 67 20 74 che by passing t
2f80: 68 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 he SQLITE_CONFIG
2f90: 5f 50 41 47 45 43 41 43 48 45 0a 2a 2a 20 76 65 _PAGECACHE.** ve
2fa0: 72 62 20 74 6f 20 73 71 6c 69 74 65 33 5f 63 6f rb to sqlite3_co
2fb0: 6e 66 69 67 28 29 2e 20 50 61 72 61 6d 65 74 65 nfig(). Paramete
2fc0: 72 20 70 42 75 66 20 70 6f 69 6e 74 73 20 74 6f r pBuf points to
2fd0: 20 61 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 6c an allocation l
2fe0: 61 72 67 65 0a 2a 2a 20 65 6e 6f 75 67 68 20 74 arge.** enough t
2ff0: 6f 20 63 6f 6e 74 61 69 6e 20 27 6e 27 20 62 75 o contain 'n' bu
3000: 66 66 65 72 73 20 6f 66 20 27 73 7a 27 20 62 79 ffers of 'sz' by
3010: 74 65 73 20 65 61 63 68 2e 0a 2a 2a 0a 2a 2a 20 tes each..**.**
3020: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 This routine is
3030: 63 61 6c 6c 65 64 20 66 72 6f 6d 20 73 71 6c 69 called from sqli
3040: 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 te3_initialize()
3050: 20 61 6e 64 20 73 6f 20 69 74 20 69 73 20 67 75 and so it is gu
3060: 61 72 61 6e 74 65 65 64 0a 2a 2a 20 74 6f 20 62 aranteed.** to b
3070: 65 20 73 65 72 69 61 6c 69 7a 65 64 20 61 6c 72 e serialized alr
3080: 65 61 64 79 2e 20 20 54 68 65 72 65 20 69 73 20 eady. There is
3090: 6e 6f 20 6e 65 65 64 20 66 6f 72 20 66 75 72 74 no need for furt
30a0: 68 65 72 20 6d 75 74 65 78 69 6e 67 2e 0a 2a 2f her mutexing..*/
30b0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 43 61 .void sqlite3PCa
30c0: 63 68 65 42 75 66 66 65 72 53 65 74 75 70 28 76 cheBufferSetup(v
30d0: 6f 69 64 20 2a 70 42 75 66 2c 20 69 6e 74 20 73 oid *pBuf, int s
30e0: 7a 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 69 66 28 z, int n){. if(
30f0: 20 70 63 61 63 68 65 31 2e 69 73 49 6e 69 74 20 pcache1.isInit
3100: 29 7b 0a 20 20 20 20 50 67 46 72 65 65 73 6c 6f ){. PgFreeslo
3110: 74 20 2a 70 3b 0a 20 20 20 20 69 66 28 20 70 42 t *p;. if( pB
3120: 75 66 3d 3d 30 20 29 20 73 7a 20 3d 20 6e 20 3d uf==0 ) sz = n =
3130: 20 30 3b 0a 20 20 20 20 69 66 28 20 6e 3d 3d 30 0;. if( n==0
3140: 20 29 20 73 7a 20 3d 20 30 3b 0a 20 20 20 20 73 ) sz = 0;. s
3150: 7a 20 3d 20 52 4f 55 4e 44 44 4f 57 4e 38 28 73 z = ROUNDDOWN8(s
3160: 7a 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e z);. pcache1.
3170: 73 7a 53 6c 6f 74 20 3d 20 73 7a 3b 0a 20 20 20 szSlot = sz;.
3180: 20 70 63 61 63 68 65 31 2e 6e 53 6c 6f 74 20 3d pcache1.nSlot =
3190: 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65 53 6c pcache1.nFreeSl
31a0: 6f 74 20 3d 20 6e 3b 0a 20 20 20 20 70 63 61 63 ot = n;. pcac
31b0: 68 65 31 2e 6e 52 65 73 65 72 76 65 20 3d 20 6e he1.nReserve = n
31c0: 3e 39 30 20 3f 20 31 30 20 3a 20 28 6e 2f 31 30 >90 ? 10 : (n/10
31d0: 20 2b 20 31 29 3b 0a 20 20 20 20 70 63 61 63 68 + 1);. pcach
31e0: 65 31 2e 70 53 74 61 72 74 20 3d 20 70 42 75 66 e1.pStart = pBuf
31f0: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 70 46 ;. pcache1.pF
3200: 72 65 65 20 3d 20 30 3b 0a 20 20 20 20 70 63 61 ree = 0;. pca
3210: 63 68 65 31 2e 62 55 6e 64 65 72 50 72 65 73 73 che1.bUnderPress
3220: 75 72 65 20 3d 20 30 3b 0a 20 20 20 20 77 68 69 ure = 0;. whi
3230: 6c 65 28 20 6e 2d 2d 20 29 7b 0a 20 20 20 20 20 le( n-- ){.
3240: 20 70 20 3d 20 28 50 67 46 72 65 65 73 6c 6f 74 p = (PgFreeslot
3250: 2a 29 70 42 75 66 3b 0a 20 20 20 20 20 20 70 2d *)pBuf;. p-
3260: 3e 70 4e 65 78 74 20 3d 20 70 63 61 63 68 65 31 >pNext = pcache1
3270: 2e 70 46 72 65 65 3b 0a 20 20 20 20 20 20 70 63 .pFree;. pc
3280: 61 63 68 65 31 2e 70 46 72 65 65 20 3d 20 70 3b ache1.pFree = p;
3290: 0a 20 20 20 20 20 20 70 42 75 66 20 3d 20 28 76 . pBuf = (v
32a0: 6f 69 64 2a 29 26 28 28 63 68 61 72 2a 29 70 42 oid*)&((char*)pB
32b0: 75 66 29 5b 73 7a 5d 3b 0a 20 20 20 20 7d 0a 20 uf)[sz];. }.
32c0: 20 20 20 70 63 61 63 68 65 31 2e 70 45 6e 64 20 pcache1.pEnd
32d0: 3d 20 70 42 75 66 3b 0a 20 20 7d 0a 7d 0a 0a 2f = pBuf;. }.}../
32e0: 2a 0a 2a 2a 20 54 72 79 20 74 6f 20 69 6e 69 74 *.** Try to init
32f0: 69 61 6c 69 7a 65 20 74 68 65 20 70 43 61 63 68 ialize the pCach
3300: 65 2d 3e 70 46 72 65 65 20 61 6e 64 20 70 43 61 e->pFree and pCa
3310: 63 68 65 2d 3e 70 42 75 6c 6b 20 66 69 65 6c 64 che->pBulk field
3320: 73 2e 20 20 52 65 74 75 72 6e 0a 2a 2a 20 74 72 s. Return.** tr
3330: 75 65 20 69 66 20 70 43 61 63 68 65 2d 3e 70 46 ue if pCache->pF
3340: 72 65 65 20 65 6e 64 73 20 75 70 20 63 6f 6e 74 ree ends up cont
3350: 61 69 6e 69 6e 67 20 6f 6e 65 20 6f 72 20 6d 6f aining one or mo
3360: 72 65 20 66 72 65 65 20 70 61 67 65 73 2e 0a 2a re free pages..*
3370: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 63 61 /.static int pca
3380: 63 68 65 31 49 6e 69 74 42 75 6c 6b 28 50 43 61 che1InitBulk(PCa
3390: 63 68 65 31 20 2a 70 43 61 63 68 65 29 7b 0a 20 che1 *pCache){.
33a0: 20 69 36 34 20 73 7a 42 75 6c 6b 3b 0a 20 20 63 i64 szBulk;. c
33b0: 68 61 72 20 2a 7a 42 75 6c 6b 3b 0a 20 20 69 66 har *zBulk;. if
33c0: 28 20 70 63 61 63 68 65 31 2e 6e 49 6e 69 74 50 ( pcache1.nInitP
33d0: 61 67 65 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 age==0 ) return
33e0: 30 3b 0a 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 62 0;. /* Do not b
33f0: 6f 74 68 65 72 20 77 69 74 68 20 61 20 62 75 6c other with a bul
3400: 6b 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69 66 20 k allocation if
3410: 74 68 65 20 63 61 63 68 65 20 73 69 7a 65 20 76 the cache size v
3420: 65 72 79 20 73 6d 61 6c 6c 20 2a 2f 0a 20 20 69 ery small */. i
3430: 66 28 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 3c f( pCache->nMax<
3440: 33 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 3 ) return 0;.
3450: 73 71 6c 69 74 65 33 42 65 67 69 6e 42 65 6e 69 sqlite3BeginBeni
3460: 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 69 66 gnMalloc();. if
3470: 28 20 70 63 61 63 68 65 31 2e 6e 49 6e 69 74 50 ( pcache1.nInitP
3480: 61 67 65 3e 30 20 29 7b 0a 20 20 20 20 73 7a 42 age>0 ){. szB
3490: 75 6c 6b 20 3d 20 70 43 61 63 68 65 2d 3e 73 7a ulk = pCache->sz
34a0: 41 6c 6c 6f 63 20 2a 20 28 69 36 34 29 70 63 61 Alloc * (i64)pca
34b0: 63 68 65 31 2e 6e 49 6e 69 74 50 61 67 65 3b 0a che1.nInitPage;.
34c0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 7a 42 }else{. szB
34d0: 75 6c 6b 20 3d 20 2d 31 30 32 34 20 2a 20 28 69 ulk = -1024 * (i
34e0: 36 34 29 70 63 61 63 68 65 31 2e 6e 49 6e 69 74 64)pcache1.nInit
34f0: 50 61 67 65 3b 0a 20 20 7d 0a 20 20 69 66 28 20 Page;. }. if(
3500: 73 7a 42 75 6c 6b 20 3e 20 70 43 61 63 68 65 2d szBulk > pCache-
3510: 3e 73 7a 41 6c 6c 6f 63 2a 28 69 36 34 29 70 43 >szAlloc*(i64)pC
3520: 61 63 68 65 2d 3e 6e 4d 61 78 20 29 7b 0a 20 20 ache->nMax ){.
3530: 20 20 73 7a 42 75 6c 6b 20 3d 20 70 43 61 63 68 szBulk = pCach
3540: 65 2d 3e 73 7a 41 6c 6c 6f 63 2a 28 69 36 34 29 e->szAlloc*(i64)
3550: 70 43 61 63 68 65 2d 3e 6e 4d 61 78 3b 0a 20 20 pCache->nMax;.
3560: 7d 0a 20 20 7a 42 75 6c 6b 20 3d 20 70 43 61 63 }. zBulk = pCac
3570: 68 65 2d 3e 70 42 75 6c 6b 20 3d 20 73 71 6c 69 he->pBulk = sqli
3580: 74 65 33 4d 61 6c 6c 6f 63 28 20 73 7a 42 75 6c te3Malloc( szBul
3590: 6b 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 45 6e k );. sqlite3En
35a0: 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b dBenignMalloc();
35b0: 0a 20 20 69 66 28 20 7a 42 75 6c 6b 20 29 7b 0a . if( zBulk ){.
35c0: 20 20 20 20 69 6e 74 20 6e 42 75 6c 6b 20 3d 20 int nBulk =
35d0: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a sqlite3MallocSiz
35e0: 65 28 7a 42 75 6c 6b 29 2f 70 43 61 63 68 65 2d e(zBulk)/pCache-
35f0: 3e 73 7a 41 6c 6c 6f 63 3b 0a 20 20 20 20 64 6f >szAlloc;. do
3600: 7b 0a 20 20 20 20 20 20 50 67 48 64 72 31 20 2a {. PgHdr1 *
3610: 70 58 20 3d 20 28 50 67 48 64 72 31 2a 29 26 7a pX = (PgHdr1*)&z
3620: 42 75 6c 6b 5b 70 43 61 63 68 65 2d 3e 73 7a 50 Bulk[pCache->szP
3630: 61 67 65 5d 3b 0a 20 20 20 20 20 20 70 58 2d 3e age];. pX->
3640: 70 61 67 65 2e 70 42 75 66 20 3d 20 7a 42 75 6c page.pBuf = zBul
3650: 6b 3b 0a 20 20 20 20 20 20 70 58 2d 3e 70 61 67 k;. pX->pag
3660: 65 2e 70 45 78 74 72 61 20 3d 20 26 70 58 5b 31 e.pExtra = &pX[1
3670: 5d 3b 0a 20 20 20 20 20 20 70 58 2d 3e 69 73 42 ];. pX->isB
3680: 75 6c 6b 4c 6f 63 61 6c 20 3d 20 31 3b 0a 20 20 ulkLocal = 1;.
3690: 20 20 20 20 70 58 2d 3e 69 73 41 6e 63 68 6f 72 pX->isAnchor
36a0: 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 58 2d 3e = 0;. pX->
36b0: 70 4e 65 78 74 20 3d 20 70 43 61 63 68 65 2d 3e pNext = pCache->
36c0: 70 46 72 65 65 3b 0a 20 20 20 20 20 20 70 58 2d pFree;. pX-
36d0: 3e 70 4c 72 75 50 72 65 76 20 3d 20 30 3b 20 20 >pLruPrev = 0;
36e0: 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 69 74 /* Init
36f0: 69 61 6c 69 7a 69 6e 67 20 74 68 69 73 20 73 61 ializing this sa
3700: 76 65 73 20 61 20 76 61 6c 67 72 69 6e 64 20 65 ves a valgrind e
3710: 72 72 6f 72 20 2a 2f 0a 20 20 20 20 20 20 70 43 rror */. pC
3720: 61 63 68 65 2d 3e 70 46 72 65 65 20 3d 20 70 58 ache->pFree = pX
3730: 3b 0a 20 20 20 20 20 20 7a 42 75 6c 6b 20 2b 3d ;. zBulk +=
3740: 20 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63 pCache->szAlloc
3750: 3b 0a 20 20 20 20 7d 77 68 69 6c 65 28 20 2d 2d ;. }while( --
3760: 6e 42 75 6c 6b 20 29 3b 0a 20 20 7d 0a 20 20 72 nBulk );. }. r
3770: 65 74 75 72 6e 20 70 43 61 63 68 65 2d 3e 70 46 eturn pCache->pF
3780: 72 65 65 21 3d 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ree!=0;.}../*.**
3790: 20 4d 61 6c 6c 6f 63 20 66 75 6e 63 74 69 6f 6e Malloc function
37a0: 20 75 73 65 64 20 77 69 74 68 69 6e 20 74 68 69 used within thi
37b0: 73 20 66 69 6c 65 20 74 6f 20 61 6c 6c 6f 63 61 s file to alloca
37c0: 74 65 20 73 70 61 63 65 20 66 72 6f 6d 20 74 68 te space from th
37d0: 65 20 62 75 66 66 65 72 0a 2a 2a 20 63 6f 6e 66 e buffer.** conf
37e0: 69 67 75 72 65 64 20 75 73 69 6e 67 20 73 71 6c igured using sql
37f0: 69 74 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49 ite3_config(SQLI
3800: 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 TE_CONFIG_PAGECA
3810: 43 48 45 29 20 6f 70 74 69 6f 6e 2e 20 49 66 20 CHE) option. If
3820: 6e 6f 20 0a 2a 2a 20 73 75 63 68 20 62 75 66 66 no .** such buff
3830: 65 72 20 65 78 69 73 74 73 20 6f 72 20 74 68 65 er exists or the
3840: 72 65 20 69 73 20 6e 6f 20 73 70 61 63 65 20 6c re is no space l
3850: 65 66 74 20 69 6e 20 69 74 2c 20 74 68 69 73 20 eft in it, this
3860: 66 75 6e 63 74 69 6f 6e 20 66 61 6c 6c 73 20 0a function falls .
3870: 2a 2a 20 62 61 63 6b 20 74 6f 20 73 71 6c 69 74 ** back to sqlit
3880: 65 33 4d 61 6c 6c 6f 63 28 29 2e 0a 2a 2a 0a 2a e3Malloc()..**.*
3890: 2a 20 4d 75 6c 74 69 70 6c 65 20 74 68 72 65 61 * Multiple threa
38a0: 64 73 20 63 61 6e 20 72 75 6e 20 74 68 69 73 20 ds can run this
38b0: 72 6f 75 74 69 6e 65 20 61 74 20 74 68 65 20 73 routine at the s
38c0: 61 6d 65 20 74 69 6d 65 2e 20 20 47 6c 6f 62 61 ame time. Globa
38d0: 6c 20 76 61 72 69 61 62 6c 65 73 0a 2a 2a 20 69 l variables.** i
38e0: 6e 20 70 63 61 63 68 65 31 20 6e 65 65 64 20 74 n pcache1 need t
38f0: 6f 20 62 65 20 70 72 6f 74 65 63 74 65 64 20 76 o be protected v
3900: 69 61 20 6d 75 74 65 78 2e 0a 2a 2f 0a 73 74 61 ia mutex..*/.sta
3910: 74 69 63 20 76 6f 69 64 20 2a 70 63 61 63 68 65 tic void *pcache
3920: 31 41 6c 6c 6f 63 28 69 6e 74 20 6e 42 79 74 65 1Alloc(int nByte
3930: 29 7b 0a 20 20 76 6f 69 64 20 2a 70 20 3d 20 30 ){. void *p = 0
3940: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
3950: 74 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c te3_mutex_nothel
3960: 64 28 70 63 61 63 68 65 31 2e 67 72 70 2e 6d 75 d(pcache1.grp.mu
3970: 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 6e 42 tex) );. if( nB
3980: 79 74 65 3c 3d 70 63 61 63 68 65 31 2e 73 7a 53 yte<=pcache1.szS
3990: 6c 6f 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 lot ){. sqlit
39a0: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 e3_mutex_enter(p
39b0: 63 61 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20 cache1.mutex);.
39c0: 20 20 20 70 20 3d 20 28 50 67 48 64 72 31 20 2a p = (PgHdr1 *
39d0: 29 70 63 61 63 68 65 31 2e 70 46 72 65 65 3b 0a )pcache1.pFree;.
39e0: 20 20 20 20 69 66 28 20 70 20 29 7b 0a 20 20 20 if( p ){.
39f0: 20 20 20 70 63 61 63 68 65 31 2e 70 46 72 65 65 pcache1.pFree
3a00: 20 3d 20 70 63 61 63 68 65 31 2e 70 46 72 65 65 = pcache1.pFree
3a10: 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 70 ->pNext;. p
3a20: 63 61 63 68 65 31 2e 6e 46 72 65 65 53 6c 6f 74 cache1.nFreeSlot
3a30: 2d 2d 3b 0a 20 20 20 20 20 20 70 63 61 63 68 65 --;. pcache
3a40: 31 2e 62 55 6e 64 65 72 50 72 65 73 73 75 72 65 1.bUnderPressure
3a50: 20 3d 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65 = pcache1.nFree
3a60: 53 6c 6f 74 3c 70 63 61 63 68 65 31 2e 6e 52 65 Slot<pcache1.nRe
3a70: 73 65 72 76 65 3b 0a 20 20 20 20 20 20 61 73 73 serve;. ass
3a80: 65 72 74 28 20 70 63 61 63 68 65 31 2e 6e 46 72 ert( pcache1.nFr
3a90: 65 65 53 6c 6f 74 3e 3d 30 20 29 3b 0a 20 20 20 eeSlot>=0 );.
3aa0: 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 sqlite3Status
3ab0: 48 69 67 68 77 61 74 65 72 28 53 51 4c 49 54 45 Highwater(SQLITE
3ac0: 5f 53 54 41 54 55 53 5f 50 41 47 45 43 41 43 48 _STATUS_PAGECACH
3ad0: 45 5f 53 49 5a 45 2c 20 6e 42 79 74 65 29 3b 0a E_SIZE, nByte);.
3ae0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 53 74 61 sqlite3Sta
3af0: 74 75 73 55 70 28 53 51 4c 49 54 45 5f 53 54 41 tusUp(SQLITE_STA
3b00: 54 55 53 5f 50 41 47 45 43 41 43 48 45 5f 55 53 TUS_PAGECACHE_US
3b10: 45 44 2c 20 31 29 3b 0a 20 20 20 20 7d 0a 20 20 ED, 1);. }.
3b20: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
3b30: 6c 65 61 76 65 28 70 63 61 63 68 65 31 2e 6d 75 leave(pcache1.mu
3b40: 74 65 78 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 tex);. }. if(
3b50: 70 3d 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 20 4d p==0 ){. /* M
3b60: 65 6d 6f 72 79 20 69 73 20 6e 6f 74 20 61 76 61 emory is not ava
3b70: 69 6c 61 62 6c 65 20 69 6e 20 74 68 65 20 53 51 ilable in the SQ
3b80: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 LITE_CONFIG_PAGE
3b90: 43 41 43 48 45 20 70 6f 6f 6c 2e 20 20 47 65 74 CACHE pool. Get
3ba0: 0a 20 20 20 20 2a 2a 20 69 74 20 66 72 6f 6d 20 . ** it from
3bb0: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 20 69 6e sqlite3Malloc in
3bc0: 73 74 65 61 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 stead.. */.
3bd0: 20 20 70 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c p = sqlite3Mal
3be0: 6c 6f 63 28 6e 42 79 74 65 29 3b 0a 23 69 66 6e loc(nByte);.#ifn
3bf0: 64 65 66 20 53 51 4c 49 54 45 5f 44 49 53 41 42 def SQLITE_DISAB
3c00: 4c 45 5f 50 41 47 45 43 41 43 48 45 5f 4f 56 45 LE_PAGECACHE_OVE
3c10: 52 46 4c 4f 57 5f 53 54 41 54 53 0a 20 20 20 20 RFLOW_STATS.
3c20: 69 66 28 20 70 20 29 7b 0a 20 20 20 20 20 20 69 if( p ){. i
3c30: 6e 74 20 73 7a 20 3d 20 73 71 6c 69 74 65 33 4d nt sz = sqlite3M
3c40: 61 6c 6c 6f 63 53 69 7a 65 28 70 29 3b 0a 20 20 allocSize(p);.
3c50: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 sqlite3_mute
3c60: 78 5f 65 6e 74 65 72 28 70 63 61 63 68 65 31 2e x_enter(pcache1.
3c70: 6d 75 74 65 78 29 3b 0a 20 20 20 20 20 20 73 71 mutex);. sq
3c80: 6c 69 74 65 33 53 74 61 74 75 73 48 69 67 68 77 lite3StatusHighw
3c90: 61 74 65 72 28 53 51 4c 49 54 45 5f 53 54 41 54 ater(SQLITE_STAT
3ca0: 55 53 5f 50 41 47 45 43 41 43 48 45 5f 53 49 5a US_PAGECACHE_SIZ
3cb0: 45 2c 20 6e 42 79 74 65 29 3b 0a 20 20 20 20 20 E, nByte);.
3cc0: 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 55 70 sqlite3StatusUp
3cd0: 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 50 (SQLITE_STATUS_P
3ce0: 41 47 45 43 41 43 48 45 5f 4f 56 45 52 46 4c 4f AGECACHE_OVERFLO
3cf0: 57 2c 20 73 7a 29 3b 0a 20 20 20 20 20 20 73 71 W, sz);. sq
3d00: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
3d10: 65 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29 e(pcache1.mutex)
3d20: 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 ;. }.#endif.
3d30: 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 sqlite3Memdeb
3d40: 75 67 53 65 74 54 79 70 65 28 70 2c 20 4d 45 4d ugSetType(p, MEM
3d50: 54 59 50 45 5f 50 43 41 43 48 45 29 3b 0a 20 20 TYPE_PCACHE);.
3d60: 7d 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a }. return p;.}.
3d70: 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 6e 20 61 ./*.** Free an a
3d80: 6c 6c 6f 63 61 74 65 64 20 62 75 66 66 65 72 20 llocated buffer
3d90: 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 70 63 obtained from pc
3da0: 61 63 68 65 31 41 6c 6c 6f 63 28 29 2e 0a 2a 2f ache1Alloc()..*/
3db0: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 .static void pca
3dc0: 63 68 65 31 46 72 65 65 28 76 6f 69 64 20 2a 70 che1Free(void *p
3dd0: 29 7b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20 ){. if( p==0 )
3de0: 72 65 74 75 72 6e 3b 0a 20 20 69 66 28 20 53 51 return;. if( SQ
3df0: 4c 49 54 45 5f 57 49 54 48 49 4e 28 70 2c 20 70 LITE_WITHIN(p, p
3e00: 63 61 63 68 65 31 2e 70 53 74 61 72 74 2c 20 70 cache1.pStart, p
3e10: 63 61 63 68 65 31 2e 70 45 6e 64 29 20 29 7b 0a cache1.pEnd) ){.
3e20: 20 20 20 20 50 67 46 72 65 65 73 6c 6f 74 20 2a PgFreeslot *
3e30: 70 53 6c 6f 74 3b 0a 20 20 20 20 73 71 6c 69 74 pSlot;. sqlit
3e40: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 e3_mutex_enter(p
3e50: 63 61 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20 cache1.mutex);.
3e60: 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 sqlite3Status
3e70: 44 6f 77 6e 28 53 51 4c 49 54 45 5f 53 54 41 54 Down(SQLITE_STAT
3e80: 55 53 5f 50 41 47 45 43 41 43 48 45 5f 55 53 45 US_PAGECACHE_USE
3e90: 44 2c 20 31 29 3b 0a 20 20 20 20 70 53 6c 6f 74 D, 1);. pSlot
3ea0: 20 3d 20 28 50 67 46 72 65 65 73 6c 6f 74 2a 29 = (PgFreeslot*)
3eb0: 70 3b 0a 20 20 20 20 70 53 6c 6f 74 2d 3e 70 4e p;. pSlot->pN
3ec0: 65 78 74 20 3d 20 70 63 61 63 68 65 31 2e 70 46 ext = pcache1.pF
3ed0: 72 65 65 3b 0a 20 20 20 20 70 63 61 63 68 65 31 ree;. pcache1
3ee0: 2e 70 46 72 65 65 20 3d 20 70 53 6c 6f 74 3b 0a .pFree = pSlot;.
3ef0: 20 20 20 20 70 63 61 63 68 65 31 2e 6e 46 72 65 pcache1.nFre
3f00: 65 53 6c 6f 74 2b 2b 3b 0a 20 20 20 20 70 63 61 eSlot++;. pca
3f10: 63 68 65 31 2e 62 55 6e 64 65 72 50 72 65 73 73 che1.bUnderPress
3f20: 75 72 65 20 3d 20 70 63 61 63 68 65 31 2e 6e 46 ure = pcache1.nF
3f30: 72 65 65 53 6c 6f 74 3c 70 63 61 63 68 65 31 2e reeSlot<pcache1.
3f40: 6e 52 65 73 65 72 76 65 3b 0a 20 20 20 20 61 73 nReserve;. as
3f50: 73 65 72 74 28 20 70 63 61 63 68 65 31 2e 6e 46 sert( pcache1.nF
3f60: 72 65 65 53 6c 6f 74 3c 3d 70 63 61 63 68 65 31 reeSlot<=pcache1
3f70: 2e 6e 53 6c 6f 74 20 29 3b 0a 20 20 20 20 73 71 .nSlot );. sq
3f80: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
3f90: 65 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29 e(pcache1.mutex)
3fa0: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 ;. }else{. a
3fb0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d 65 ssert( sqlite3Me
3fc0: 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 70 2c mdebugHasType(p,
3fd0: 20 4d 45 4d 54 59 50 45 5f 50 43 41 43 48 45 29 MEMTYPE_PCACHE)
3fe0: 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 4d );. sqlite3M
3ff0: 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 28 70 emdebugSetType(p
4000: 2c 20 4d 45 4d 54 59 50 45 5f 48 45 41 50 29 3b , MEMTYPE_HEAP);
4010: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
4020: 44 49 53 41 42 4c 45 5f 50 41 47 45 43 41 43 48 DISABLE_PAGECACH
4030: 45 5f 4f 56 45 52 46 4c 4f 57 5f 53 54 41 54 53 E_OVERFLOW_STATS
4040: 0a 20 20 20 20 7b 0a 20 20 20 20 20 20 69 6e 74 . {. int
4050: 20 6e 46 72 65 65 64 20 3d 20 73 71 6c 69 74 65 nFreed = sqlite
4060: 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 29 3b 0a 3MallocSize(p);.
4070: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 sqlite3_mu
4080: 74 65 78 5f 65 6e 74 65 72 28 70 63 61 63 68 65 tex_enter(pcache
4090: 31 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 20 20 1.mutex);.
40a0: 73 71 6c 69 74 65 33 53 74 61 74 75 73 44 6f 77 sqlite3StatusDow
40b0: 6e 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f n(SQLITE_STATUS_
40c0: 50 41 47 45 43 41 43 48 45 5f 4f 56 45 52 46 4c PAGECACHE_OVERFL
40d0: 4f 57 2c 20 6e 46 72 65 65 64 29 3b 0a 20 20 20 OW, nFreed);.
40e0: 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 sqlite3_mutex
40f0: 5f 6c 65 61 76 65 28 70 63 61 63 68 65 31 2e 6d _leave(pcache1.m
4100: 75 74 65 78 29 3b 0a 20 20 20 20 7d 0a 23 65 6e utex);. }.#en
4110: 64 69 66 0a 20 20 20 20 73 71 6c 69 74 65 33 5f dif. sqlite3_
4120: 66 72 65 65 28 70 29 3b 0a 20 20 7d 0a 7d 0a 0a free(p);. }.}..
4130: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
4140: 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 ABLE_MEMORY_MANA
4150: 47 45 4d 45 4e 54 0a 2f 2a 0a 2a 2a 20 52 65 74 GEMENT./*.** Ret
4160: 75 72 6e 20 74 68 65 20 73 69 7a 65 20 6f 66 20 urn the size of
4170: 61 20 70 63 61 63 68 65 20 61 6c 6c 6f 63 61 74 a pcache allocat
4180: 69 6f 6e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ion.*/.static in
4190: 74 20 70 63 61 63 68 65 31 4d 65 6d 53 69 7a 65 t pcache1MemSize
41a0: 28 76 6f 69 64 20 2a 70 29 7b 0a 20 20 69 66 28 (void *p){. if(
41b0: 20 70 3e 3d 70 63 61 63 68 65 31 2e 70 53 74 61 p>=pcache1.pSta
41c0: 72 74 20 26 26 20 70 3c 70 63 61 63 68 65 31 2e rt && p<pcache1.
41d0: 70 45 6e 64 20 29 7b 0a 20 20 20 20 72 65 74 75 pEnd ){. retu
41e0: 72 6e 20 70 63 61 63 68 65 31 2e 73 7a 53 6c 6f rn pcache1.szSlo
41f0: 74 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 t;. }else{.
4200: 69 6e 74 20 69 53 69 7a 65 3b 0a 20 20 20 20 61 int iSize;. a
4210: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d 65 ssert( sqlite3Me
4220: 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 70 2c mdebugHasType(p,
4230: 20 4d 45 4d 54 59 50 45 5f 50 43 41 43 48 45 29 MEMTYPE_PCACHE)
4240: 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 4d );. sqlite3M
4250: 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 28 70 emdebugSetType(p
4260: 2c 20 4d 45 4d 54 59 50 45 5f 48 45 41 50 29 3b , MEMTYPE_HEAP);
4270: 0a 20 20 20 20 69 53 69 7a 65 20 3d 20 73 71 6c . iSize = sql
4280: 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 ite3MallocSize(p
4290: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 4d 65 );. sqlite3Me
42a0: 6d 64 65 62 75 67 53 65 74 54 79 70 65 28 70 2c mdebugSetType(p,
42b0: 20 4d 45 4d 54 59 50 45 5f 50 43 41 43 48 45 29 MEMTYPE_PCACHE)
42c0: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 69 53 69 ;. return iSi
42d0: 7a 65 3b 0a 20 20 7d 0a 7d 0a 23 65 6e 64 69 66 ze;. }.}.#endif
42e0: 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c /* SQLITE_ENABL
42f0: 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d E_MEMORY_MANAGEM
4300: 45 4e 54 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 6c ENT */../*.** Al
4310: 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 70 61 67 locate a new pag
4320: 65 20 6f 62 6a 65 63 74 20 69 6e 69 74 69 61 6c e object initial
4330: 6c 79 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 ly associated wi
4340: 74 68 20 63 61 63 68 65 20 70 43 61 63 68 65 2e th cache pCache.
4350: 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67 48 64 72 .*/.static PgHdr
4360: 31 20 2a 70 63 61 63 68 65 31 41 6c 6c 6f 63 50 1 *pcache1AllocP
4370: 61 67 65 28 50 43 61 63 68 65 31 20 2a 70 43 61 age(PCache1 *pCa
4380: 63 68 65 2c 20 69 6e 74 20 62 65 6e 69 67 6e 4d che, int benignM
4390: 61 6c 6c 6f 63 29 7b 0a 20 20 50 67 48 64 72 31 alloc){. PgHdr1
43a0: 20 2a 70 20 3d 20 30 3b 0a 20 20 76 6f 69 64 20 *p = 0;. void
43b0: 2a 70 50 67 3b 0a 0a 20 20 61 73 73 65 72 74 28 *pPg;.. assert(
43c0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
43d0: 65 6c 64 28 70 43 61 63 68 65 2d 3e 70 47 72 6f eld(pCache->pGro
43e0: 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 up->mutex) );.
43f0: 69 66 28 20 70 43 61 63 68 65 2d 3e 70 46 72 65 if( pCache->pFre
4400: 65 20 7c 7c 20 28 70 43 61 63 68 65 2d 3e 6e 50 e || (pCache->nP
4410: 61 67 65 3d 3d 30 20 26 26 20 70 63 61 63 68 65 age==0 && pcache
4420: 31 49 6e 69 74 42 75 6c 6b 28 70 43 61 63 68 65 1InitBulk(pCache
4430: 29 29 20 29 7b 0a 20 20 20 20 70 20 3d 20 70 43 )) ){. p = pC
4440: 61 63 68 65 2d 3e 70 46 72 65 65 3b 0a 20 20 20 ache->pFree;.
4450: 20 70 43 61 63 68 65 2d 3e 70 46 72 65 65 20 3d pCache->pFree =
4460: 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 70 p->pNext;. p
4470: 2d 3e 70 4e 65 78 74 20 3d 20 30 3b 0a 20 20 7d ->pNext = 0;. }
4480: 65 6c 73 65 7b 0a 23 69 66 64 65 66 20 53 51 4c else{.#ifdef SQL
4490: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 ITE_ENABLE_MEMOR
44a0: 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 20 20 20 Y_MANAGEMENT.
44b0: 20 2f 2a 20 54 68 65 20 67 72 6f 75 70 20 6d 75 /* The group mu
44c0: 74 65 78 20 6d 75 73 74 20 62 65 20 72 65 6c 65 tex must be rele
44d0: 61 73 65 64 20 62 65 66 6f 72 65 20 70 63 61 63 ased before pcac
44e0: 68 65 31 41 6c 6c 6f 63 28 29 20 69 73 20 63 61 he1Alloc() is ca
44f0: 6c 6c 65 64 2e 20 54 68 69 73 0a 20 20 20 20 2a lled. This. *
4500: 2a 20 69 73 20 62 65 63 61 75 73 65 20 69 74 20 * is because it
4510: 6d 69 67 68 74 20 63 61 6c 6c 20 73 71 6c 69 74 might call sqlit
4520: 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f 72 e3_release_memor
4530: 79 28 29 2c 20 77 68 69 63 68 20 61 73 73 75 6d y(), which assum
4540: 65 73 20 74 68 61 74 20 0a 20 20 20 20 2a 2a 20 es that . **
4550: 74 68 69 73 20 6d 75 74 65 78 20 69 73 20 6e 6f this mutex is no
4560: 74 20 68 65 6c 64 2e 20 2a 2f 0a 20 20 20 20 61 t held. */. a
4570: 73 73 65 72 74 28 20 70 63 61 63 68 65 31 2e 73 ssert( pcache1.s
4580: 65 70 61 72 61 74 65 43 61 63 68 65 3d 3d 30 20 eparateCache==0
4590: 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 );. assert( p
45a0: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3d 3d 26 Cache->pGroup==&
45b0: 70 63 61 63 68 65 31 2e 67 72 70 20 29 3b 0a 20 pcache1.grp );.
45c0: 20 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d pcache1LeaveM
45d0: 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72 utex(pCache->pGr
45e0: 6f 75 70 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 oup);.#endif.
45f0: 20 69 66 28 20 62 65 6e 69 67 6e 4d 61 6c 6c 6f if( benignMallo
4600: 63 20 29 7b 20 73 71 6c 69 74 65 33 42 65 67 69 c ){ sqlite3Begi
4610: 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b nBenignMalloc();
4620: 20 7d 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 }.#ifdef SQLITE
4630: 5f 50 43 41 43 48 45 5f 53 45 50 41 52 41 54 45 _PCACHE_SEPARATE
4640: 5f 48 45 41 44 45 52 0a 20 20 20 20 70 50 67 20 _HEADER. pPg
4650: 3d 20 70 63 61 63 68 65 31 41 6c 6c 6f 63 28 70 = pcache1Alloc(p
4660: 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 29 3b 0a Cache->szPage);.
4670: 20 20 20 20 70 20 3d 20 73 71 6c 69 74 65 33 4d p = sqlite3M
4680: 61 6c 6c 6f 63 28 73 69 7a 65 6f 66 28 50 67 48 alloc(sizeof(PgH
4690: 64 72 31 29 20 2b 20 70 43 61 63 68 65 2d 3e 73 dr1) + pCache->s
46a0: 7a 45 78 74 72 61 29 3b 0a 20 20 20 20 69 66 28 zExtra);. if(
46b0: 20 21 70 50 67 20 7c 7c 20 21 70 20 29 7b 0a 20 !pPg || !p ){.
46c0: 20 20 20 20 20 70 63 61 63 68 65 31 46 72 65 65 pcache1Free
46d0: 28 70 50 67 29 3b 0a 20 20 20 20 20 20 73 71 6c (pPg);. sql
46e0: 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 ite3_free(p);.
46f0: 20 20 20 20 70 50 67 20 3d 20 30 3b 0a 20 20 20 pPg = 0;.
4700: 20 7d 0a 23 65 6c 73 65 0a 20 20 20 20 70 50 67 }.#else. pPg
4710: 20 3d 20 70 63 61 63 68 65 31 41 6c 6c 6f 63 28 = pcache1Alloc(
4720: 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63 29 pCache->szAlloc)
4730: 3b 0a 20 20 20 20 70 20 3d 20 28 50 67 48 64 72 ;. p = (PgHdr
4740: 31 20 2a 29 26 28 28 75 38 20 2a 29 70 50 67 29 1 *)&((u8 *)pPg)
4750: 5b 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 5d [pCache->szPage]
4760: 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 69 66 28 ;.#endif. if(
4770: 20 62 65 6e 69 67 6e 4d 61 6c 6c 6f 63 20 29 7b benignMalloc ){
4780: 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 sqlite3EndBenig
4790: 6e 4d 61 6c 6c 6f 63 28 29 3b 20 7d 0a 23 69 66 nMalloc(); }.#if
47a0: 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
47b0: 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d E_MEMORY_MANAGEM
47c0: 45 4e 54 0a 20 20 20 20 70 63 61 63 68 65 31 45 ENT. pcache1E
47d0: 6e 74 65 72 4d 75 74 65 78 28 70 43 61 63 68 65 nterMutex(pCache
47e0: 2d 3e 70 47 72 6f 75 70 29 3b 0a 23 65 6e 64 69 ->pGroup);.#endi
47f0: 66 0a 20 20 20 20 69 66 28 20 70 50 67 3d 3d 30 f. if( pPg==0
4800: 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 20 ) return 0;.
4810: 20 70 2d 3e 70 61 67 65 2e 70 42 75 66 20 3d 20 p->page.pBuf =
4820: 70 50 67 3b 0a 20 20 20 20 70 2d 3e 70 61 67 65 pPg;. p->page
4830: 2e 70 45 78 74 72 61 20 3d 20 26 70 5b 31 5d 3b .pExtra = &p[1];
4840: 0a 20 20 20 20 70 2d 3e 69 73 42 75 6c 6b 4c 6f . p->isBulkLo
4850: 63 61 6c 20 3d 20 30 3b 0a 20 20 20 20 70 2d 3e cal = 0;. p->
4860: 69 73 41 6e 63 68 6f 72 20 3d 20 30 3b 0a 20 20 isAnchor = 0;.
4870: 7d 0a 20 20 28 2a 70 43 61 63 68 65 2d 3e 70 6e }. (*pCache->pn
4880: 50 75 72 67 65 61 62 6c 65 29 2b 2b 3b 0a 20 20 Purgeable)++;.
4890: 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 2f 2a 0a return p;.}../*.
48a0: 2a 2a 20 46 72 65 65 20 61 20 70 61 67 65 20 6f ** Free a page o
48b0: 62 6a 65 63 74 20 61 6c 6c 6f 63 61 74 65 64 20 bject allocated
48c0: 62 79 20 70 63 61 63 68 65 31 41 6c 6c 6f 63 50 by pcache1AllocP
48d0: 61 67 65 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 age()..*/.static
48e0: 20 76 6f 69 64 20 70 63 61 63 68 65 31 46 72 65 void pcache1Fre
48f0: 65 50 61 67 65 28 50 67 48 64 72 31 20 2a 70 29 ePage(PgHdr1 *p)
4900: 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 {. PCache1 *pCa
4910: 63 68 65 3b 0a 20 20 61 73 73 65 72 74 28 20 70 che;. assert( p
4920: 21 3d 30 20 29 3b 0a 20 20 70 43 61 63 68 65 20 !=0 );. pCache
4930: 3d 20 70 2d 3e 70 43 61 63 68 65 3b 0a 20 20 61 = p->pCache;. a
4940: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
4950: 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 70 43 61 utex_held(p->pCa
4960: 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 che->pGroup->mut
4970: 65 78 29 20 29 3b 0a 20 20 69 66 28 20 70 2d 3e ex) );. if( p->
4980: 69 73 42 75 6c 6b 4c 6f 63 61 6c 20 29 7b 0a 20 isBulkLocal ){.
4990: 20 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20 70 43 p->pNext = pC
49a0: 61 63 68 65 2d 3e 70 46 72 65 65 3b 0a 20 20 20 ache->pFree;.
49b0: 20 70 43 61 63 68 65 2d 3e 70 46 72 65 65 20 3d pCache->pFree =
49c0: 20 70 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 p;. }else{.
49d0: 20 70 63 61 63 68 65 31 46 72 65 65 28 70 2d 3e pcache1Free(p->
49e0: 70 61 67 65 2e 70 42 75 66 29 3b 0a 23 69 66 64 page.pBuf);.#ifd
49f0: 65 66 20 53 51 4c 49 54 45 5f 50 43 41 43 48 45 ef SQLITE_PCACHE
4a00: 5f 53 45 50 41 52 41 54 45 5f 48 45 41 44 45 52 _SEPARATE_HEADER
4a10: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 . sqlite3_fre
4a20: 65 28 70 29 3b 0a 23 65 6e 64 69 66 0a 20 20 7d e(p);.#endif. }
4a30: 0a 20 20 28 2a 70 43 61 63 68 65 2d 3e 70 6e 50 . (*pCache->pnP
4a40: 75 72 67 65 61 62 6c 65 29 2d 2d 3b 0a 7d 0a 0a urgeable)--;.}..
4a50: 2f 2a 0a 2a 2a 20 4d 61 6c 6c 6f 63 20 66 75 6e /*.** Malloc fun
4a60: 63 74 69 6f 6e 20 75 73 65 64 20 62 79 20 53 51 ction used by SQ
4a70: 4c 69 74 65 20 74 6f 20 6f 62 74 61 69 6e 20 73 Lite to obtain s
4a80: 70 61 63 65 20 66 72 6f 6d 20 74 68 65 20 62 75 pace from the bu
4a90: 66 66 65 72 20 63 6f 6e 66 69 67 75 72 65 64 0a ffer configured.
4aa0: 2a 2a 20 75 73 69 6e 67 20 73 71 6c 69 74 65 33 ** using sqlite3
4ab0: 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f 43 _config(SQLITE_C
4ac0: 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45 29 ONFIG_PAGECACHE)
4ad0: 20 6f 70 74 69 6f 6e 2e 20 49 66 20 6e 6f 20 73 option. If no s
4ae0: 75 63 68 20 62 75 66 66 65 72 0a 2a 2a 20 65 78 uch buffer.** ex
4af0: 69 73 74 73 2c 20 74 68 69 73 20 66 75 6e 63 74 ists, this funct
4b00: 69 6f 6e 20 66 61 6c 6c 73 20 62 61 63 6b 20 74 ion falls back t
4b10: 6f 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 o sqlite3Malloc(
4b20: 29 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 )..*/.void *sqli
4b30: 74 65 33 50 61 67 65 4d 61 6c 6c 6f 63 28 69 6e te3PageMalloc(in
4b40: 74 20 73 7a 29 7b 0a 20 20 2f 2a 20 44 75 72 69 t sz){. /* Duri
4b50: 6e 67 20 72 65 62 61 6c 61 6e 63 65 20 6f 70 65 ng rebalance ope
4b60: 72 61 74 69 6f 6e 73 20 6f 6e 20 61 20 63 6f 72 rations on a cor
4b70: 72 75 70 74 20 64 61 74 61 62 61 73 65 20 66 69 rupt database fi
4b80: 6c 65 2c 20 69 74 20 69 73 20 73 6f 6d 65 74 69 le, it is someti
4b90: 6d 65 73 0a 20 20 2a 2a 20 28 72 61 72 65 6c 79 mes. ** (rarely
4ba0: 29 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 6f 76 ) possible to ov
4bb0: 65 72 72 65 61 64 20 74 68 65 20 74 65 6d 70 6f erread the tempo
4bc0: 72 61 72 79 20 70 61 67 65 20 62 75 66 66 65 72 rary page buffer
4bd0: 20 62 79 20 61 20 66 65 77 20 62 79 74 65 73 2e by a few bytes.
4be0: 0a 20 20 2a 2a 20 45 6e 6c 61 72 67 65 20 74 68 . ** Enlarge th
4bf0: 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 73 6c 69 e allocation sli
4c00: 67 68 74 6c 79 20 73 6f 20 74 68 61 74 20 74 68 ghtly so that th
4c10: 69 73 20 64 6f 65 73 20 6e 6f 74 20 63 61 75 73 is does not caus
4c20: 65 20 70 72 6f 62 6c 65 6d 73 2e 20 2a 2f 0a 20 e problems. */.
4c30: 20 72 65 74 75 72 6e 20 70 63 61 63 68 65 31 41 return pcache1A
4c40: 6c 6c 6f 63 28 73 7a 29 3b 0a 7d 0a 0a 2f 2a 0a lloc(sz);.}../*.
4c50: 2a 2a 20 46 72 65 65 20 61 6e 20 61 6c 6c 6f 63 ** Free an alloc
4c60: 61 74 65 64 20 62 75 66 66 65 72 20 6f 62 74 61 ated buffer obta
4c70: 69 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 65 ined from sqlite
4c80: 33 50 61 67 65 4d 61 6c 6c 6f 63 28 29 2e 0a 2a 3PageMalloc()..*
4c90: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 /.void sqlite3Pa
4ca0: 67 65 46 72 65 65 28 76 6f 69 64 20 2a 70 29 7b geFree(void *p){
4cb0: 0a 20 20 70 63 61 63 68 65 31 46 72 65 65 28 70 . pcache1Free(p
4cc0: 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 );.}.../*.** Ret
4cd0: 75 72 6e 20 74 72 75 65 20 69 66 20 69 74 20 64 urn true if it d
4ce0: 65 73 69 72 61 62 6c 65 20 74 6f 20 61 76 6f 69 esirable to avoi
4cf0: 64 20 61 6c 6c 6f 63 61 74 69 6e 67 20 61 20 6e d allocating a n
4d00: 65 77 20 70 61 67 65 20 63 61 63 68 65 0a 2a 2a ew page cache.**
4d10: 20 65 6e 74 72 79 2e 0a 2a 2a 0a 2a 2a 20 49 66 entry..**.** If
4d20: 20 6d 65 6d 6f 72 79 20 77 61 73 20 61 6c 6c 6f memory was allo
4d30: 63 61 74 65 64 20 73 70 65 63 69 66 69 63 61 6c cated specifical
4d40: 6c 79 20 74 6f 20 74 68 65 20 70 61 67 65 20 63 ly to the page c
4d50: 61 63 68 65 20 75 73 69 6e 67 0a 2a 2a 20 53 51 ache using.** SQ
4d60: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 LITE_CONFIG_PAGE
4d70: 43 41 43 48 45 20 62 75 74 20 74 68 61 74 20 6d CACHE but that m
4d80: 65 6d 6f 72 79 20 68 61 73 20 61 6c 6c 20 62 65 emory has all be
4d90: 65 6e 20 75 73 65 64 2c 20 74 68 65 6e 0a 2a 2a en used, then.**
4da0: 20 69 74 20 69 73 20 64 65 73 69 72 61 62 6c 65 it is desirable
4db0: 20 74 6f 20 61 76 6f 69 64 20 61 6c 6c 6f 63 61 to avoid alloca
4dc0: 74 69 6e 67 20 61 20 6e 65 77 20 70 61 67 65 20 ting a new page
4dd0: 63 61 63 68 65 20 65 6e 74 72 79 20 62 65 63 61 cache entry beca
4de0: 75 73 65 0a 2a 2a 20 70 72 65 73 75 6d 61 62 6c use.** presumabl
4df0: 79 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f y SQLITE_CONFIG_
4e00: 50 41 47 45 43 41 43 48 45 20 77 61 73 20 73 75 PAGECACHE was su
4e10: 70 70 6f 73 65 20 74 6f 20 62 65 20 73 75 66 66 ppose to be suff
4e20: 69 63 69 65 6e 74 0a 2a 2a 20 66 6f 72 20 61 6c icient.** for al
4e30: 6c 20 70 61 67 65 20 63 61 63 68 65 20 6e 65 65 l page cache nee
4e40: 64 73 20 61 6e 64 20 77 65 20 73 68 6f 75 6c 64 ds and we should
4e50: 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 73 70 69 not need to spi
4e60: 6c 6c 20 74 68 65 0a 2a 2a 20 61 6c 6c 6f 63 61 ll the.** alloca
4e70: 74 69 6f 6e 20 6f 6e 74 6f 20 74 68 65 20 68 65 tion onto the he
4e80: 61 70 2e 0a 2a 2a 0a 2a 2a 20 4f 72 2c 20 74 68 ap..**.** Or, th
4e90: 65 20 68 65 61 70 20 69 73 20 75 73 65 64 20 66 e heap is used f
4ea0: 6f 72 20 61 6c 6c 20 70 61 67 65 20 63 61 63 68 or all page cach
4eb0: 65 20 6d 65 6d 6f 72 79 20 62 75 74 20 74 68 65 e memory but the
4ec0: 20 68 65 61 70 20 69 73 0a 2a 2a 20 75 6e 64 65 heap is.** unde
4ed0: 72 20 6d 65 6d 6f 72 79 20 70 72 65 73 73 75 72 r memory pressur
4ee0: 65 2c 20 74 68 65 6e 20 61 67 61 69 6e 20 69 74 e, then again it
4ef0: 20 69 73 20 64 65 73 69 72 61 62 6c 65 20 74 6f is desirable to
4f00: 20 61 76 6f 69 64 0a 2a 2a 20 61 6c 6c 6f 63 61 avoid.** alloca
4f10: 74 69 6e 67 20 61 20 6e 65 77 20 70 61 67 65 20 ting a new page
4f20: 63 61 63 68 65 20 65 6e 74 72 79 20 69 6e 20 6f cache entry in o
4f30: 72 64 65 72 20 74 6f 20 61 76 6f 69 64 20 73 74 rder to avoid st
4f40: 72 65 73 73 69 6e 67 0a 2a 2a 20 74 68 65 20 68 ressing.** the h
4f50: 65 61 70 20 65 76 65 6e 20 66 75 72 74 68 65 72 eap even further
4f60: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
4f70: 70 63 61 63 68 65 31 55 6e 64 65 72 4d 65 6d 6f pcache1UnderMemo
4f80: 72 79 50 72 65 73 73 75 72 65 28 50 43 61 63 68 ryPressure(PCach
4f90: 65 31 20 2a 70 43 61 63 68 65 29 7b 0a 20 20 69 e1 *pCache){. i
4fa0: 66 28 20 70 63 61 63 68 65 31 2e 6e 53 6c 6f 74 f( pcache1.nSlot
4fb0: 20 26 26 20 28 70 43 61 63 68 65 2d 3e 73 7a 50 && (pCache->szP
4fc0: 61 67 65 2b 70 43 61 63 68 65 2d 3e 73 7a 45 78 age+pCache->szEx
4fd0: 74 72 61 29 3c 3d 70 63 61 63 68 65 31 2e 73 7a tra)<=pcache1.sz
4fe0: 53 6c 6f 74 20 29 7b 0a 20 20 20 20 72 65 74 75 Slot ){. retu
4ff0: 72 6e 20 70 63 61 63 68 65 31 2e 62 55 6e 64 65 rn pcache1.bUnde
5000: 72 50 72 65 73 73 75 72 65 3b 0a 20 20 7d 65 6c rPressure;. }el
5010: 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 73 se{. return s
5020: 71 6c 69 74 65 33 48 65 61 70 4e 65 61 72 6c 79 qlite3HeapNearly
5030: 46 75 6c 6c 28 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f Full();. }.}../
5040: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
5050: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
5060: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
5070: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
5080: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a **************/.
5090: 2f 2a 2a 2a 2a 2a 2a 2a 2a 20 47 65 6e 65 72 61 /******** Genera
50a0: 6c 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e l Implementation
50b0: 20 46 75 6e 63 74 69 6f 6e 73 20 2a 2a 2a 2a 2a Functions *****
50c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
50d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f ***************/
50e0: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ../*.** This fun
50f0: 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f ction is used to
5100: 20 72 65 73 69 7a 65 20 74 68 65 20 68 61 73 68 resize the hash
5110: 20 74 61 62 6c 65 20 75 73 65 64 20 62 79 20 74 table used by t
5120: 68 65 20 63 61 63 68 65 20 70 61 73 73 65 64 0a he cache passed.
5130: 2a 2a 20 61 73 20 74 68 65 20 66 69 72 73 74 20 ** as the first
5140: 61 72 67 75 6d 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 argument..**.**
5150: 54 68 65 20 50 43 61 63 68 65 20 6d 75 74 65 78 The PCache mutex
5160: 20 6d 75 73 74 20 62 65 20 68 65 6c 64 20 77 68 must be held wh
5170: 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e en this function
5180: 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 is called..*/.s
5190: 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 tatic void pcach
51a0: 65 31 52 65 73 69 7a 65 48 61 73 68 28 50 43 61 e1ResizeHash(PCa
51b0: 63 68 65 31 20 2a 70 29 7b 0a 20 20 50 67 48 64 che1 *p){. PgHd
51c0: 72 31 20 2a 2a 61 70 4e 65 77 3b 0a 20 20 75 6e r1 **apNew;. un
51d0: 73 69 67 6e 65 64 20 69 6e 74 20 6e 4e 65 77 3b signed int nNew;
51e0: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 . unsigned int
51f0: 69 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 i;.. assert( sq
5200: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
5210: 28 70 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 (p->pGroup->mute
5220: 78 29 20 29 3b 0a 0a 20 20 6e 4e 65 77 20 3d 20 x) );.. nNew =
5230: 70 2d 3e 6e 48 61 73 68 2a 32 3b 0a 20 20 69 66 p->nHash*2;. if
5240: 28 20 6e 4e 65 77 3c 32 35 36 20 29 7b 0a 20 20 ( nNew<256 ){.
5250: 20 20 6e 4e 65 77 20 3d 20 32 35 36 3b 0a 20 20 nNew = 256;.
5260: 7d 0a 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76 }.. pcache1Leav
5270: 65 4d 75 74 65 78 28 70 2d 3e 70 47 72 6f 75 70 eMutex(p->pGroup
5280: 29 3b 0a 20 20 69 66 28 20 70 2d 3e 6e 48 61 73 );. if( p->nHas
5290: 68 20 29 7b 20 73 71 6c 69 74 65 33 42 65 67 69 h ){ sqlite3Begi
52a0: 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b nBenignMalloc();
52b0: 20 7d 0a 20 20 61 70 4e 65 77 20 3d 20 28 50 67 }. apNew = (Pg
52c0: 48 64 72 31 20 2a 2a 29 73 71 6c 69 74 65 33 4d Hdr1 **)sqlite3M
52d0: 61 6c 6c 6f 63 5a 65 72 6f 28 73 69 7a 65 6f 66 allocZero(sizeof
52e0: 28 50 67 48 64 72 31 20 2a 29 2a 6e 4e 65 77 29 (PgHdr1 *)*nNew)
52f0: 3b 0a 20 20 69 66 28 20 70 2d 3e 6e 48 61 73 68 ;. if( p->nHash
5300: 20 29 7b 20 73 71 6c 69 74 65 33 45 6e 64 42 65 ){ sqlite3EndBe
5310: 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 20 7d 0a nignMalloc(); }.
5320: 20 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 pcache1EnterMu
5330: 74 65 78 28 70 2d 3e 70 47 72 6f 75 70 29 3b 0a tex(p->pGroup);.
5340: 20 20 69 66 28 20 61 70 4e 65 77 20 29 7b 0a 20 if( apNew ){.
5350: 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d for(i=0; i<p-
5360: 3e 6e 48 61 73 68 3b 20 69 2b 2b 29 7b 0a 20 20 >nHash; i++){.
5370: 20 20 20 20 50 67 48 64 72 31 20 2a 70 50 61 67 PgHdr1 *pPag
5380: 65 3b 0a 20 20 20 20 20 20 50 67 48 64 72 31 20 e;. PgHdr1
5390: 2a 70 4e 65 78 74 20 3d 20 70 2d 3e 61 70 48 61 *pNext = p->apHa
53a0: 73 68 5b 69 5d 3b 0a 20 20 20 20 20 20 77 68 69 sh[i];. whi
53b0: 6c 65 28 20 28 70 50 61 67 65 20 3d 20 70 4e 65 le( (pPage = pNe
53c0: 78 74 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 xt)!=0 ){.
53d0: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 68 unsigned int h
53e0: 20 3d 20 70 50 61 67 65 2d 3e 69 4b 65 79 20 25 = pPage->iKey %
53f0: 20 6e 4e 65 77 3b 0a 20 20 20 20 20 20 20 20 70 nNew;. p
5400: 4e 65 78 74 20 3d 20 70 50 61 67 65 2d 3e 70 4e Next = pPage->pN
5410: 65 78 74 3b 0a 20 20 20 20 20 20 20 20 70 50 61 ext;. pPa
5420: 67 65 2d 3e 70 4e 65 78 74 20 3d 20 61 70 4e 65 ge->pNext = apNe
5430: 77 5b 68 5d 3b 0a 20 20 20 20 20 20 20 20 61 70 w[h];. ap
5440: 4e 65 77 5b 68 5d 20 3d 20 70 50 61 67 65 3b 0a New[h] = pPage;.
5450: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 }. }.
5460: 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 sqlite3_free(p
5470: 2d 3e 61 70 48 61 73 68 29 3b 0a 20 20 20 20 70 ->apHash);. p
5480: 2d 3e 61 70 48 61 73 68 20 3d 20 61 70 4e 65 77 ->apHash = apNew
5490: 3b 0a 20 20 20 20 70 2d 3e 6e 48 61 73 68 20 3d ;. p->nHash =
54a0: 20 6e 4e 65 77 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a nNew;. }.}../*
54b0: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f .** This functio
54c0: 6e 20 69 73 20 75 73 65 64 20 69 6e 74 65 72 6e n is used intern
54d0: 61 6c 6c 79 20 74 6f 20 72 65 6d 6f 76 65 20 74 ally to remove t
54e0: 68 65 20 70 61 67 65 20 70 50 61 67 65 20 66 72 he page pPage fr
54f0: 6f 6d 20 74 68 65 20 0a 2a 2a 20 50 47 72 6f 75 om the .** PGrou
5500: 70 20 4c 52 55 20 6c 69 73 74 2c 20 69 66 20 69 p LRU list, if i
5510: 73 20 70 61 72 74 20 6f 66 20 69 74 2e 20 49 66 s part of it. If
5520: 20 70 50 61 67 65 20 69 73 20 6e 6f 74 20 70 61 pPage is not pa
5530: 72 74 20 6f 66 20 74 68 65 20 50 47 72 6f 75 70 rt of the PGroup
5540: 0a 2a 2a 20 4c 52 55 20 6c 69 73 74 2c 20 74 68 .** LRU list, th
5550: 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e en this function
5560: 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a is a no-op..**.
5570: 2a 2a 20 54 68 65 20 50 47 72 6f 75 70 20 6d 75 ** The PGroup mu
5580: 74 65 78 20 6d 75 73 74 20 62 65 20 68 65 6c 64 tex must be held
5590: 20 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 when this funct
55a0: 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a ion is called..*
55b0: 2f 0a 73 74 61 74 69 63 20 50 67 48 64 72 31 20 /.static PgHdr1
55c0: 2a 70 63 61 63 68 65 31 50 69 6e 50 61 67 65 28 *pcache1PinPage(
55d0: 50 67 48 64 72 31 20 2a 70 50 61 67 65 29 7b 0a PgHdr1 *pPage){.
55e0: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 21 assert( pPage!
55f0: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =0 );. assert(
5600: 50 41 47 45 5f 49 53 5f 55 4e 50 49 4e 4e 45 44 PAGE_IS_UNPINNED
5610: 28 70 50 61 67 65 29 20 29 3b 0a 20 20 61 73 73 (pPage) );. ass
5620: 65 72 74 28 20 70 50 61 67 65 2d 3e 70 4c 72 75 ert( pPage->pLru
5630: 4e 65 78 74 20 29 3b 0a 20 20 61 73 73 65 72 74 Next );. assert
5640: 28 20 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 ( pPage->pLruPre
5650: 76 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 v );. assert( s
5660: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
5670: 64 28 70 50 61 67 65 2d 3e 70 43 61 63 68 65 2d d(pPage->pCache-
5680: 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 >pGroup->mutex)
5690: 29 3b 0a 20 20 70 50 61 67 65 2d 3e 70 4c 72 75 );. pPage->pLru
56a0: 50 72 65 76 2d 3e 70 4c 72 75 4e 65 78 74 20 3d Prev->pLruNext =
56b0: 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74 pPage->pLruNext
56c0: 3b 0a 20 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e ;. pPage->pLruN
56d0: 65 78 74 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20 ext->pLruPrev =
56e0: 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 3b pPage->pLruPrev;
56f0: 0a 20 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 . pPage->pLruNe
5700: 78 74 20 3d 20 30 3b 0a 20 20 2f 2a 20 70 50 61 xt = 0;. /* pPa
5710: 67 65 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20 30 ge->pLruPrev = 0
5720: 3b 0a 20 20 2a 2a 20 4e 6f 20 6e 65 65 64 20 74 ;. ** No need t
5730: 6f 20 63 6c 65 61 72 20 70 4c 72 75 50 72 65 76 o clear pLruPrev
5740: 20 61 73 20 69 74 20 69 73 20 6e 65 76 65 72 20 as it is never
5750: 61 63 63 65 73 73 65 64 20 69 66 20 70 4c 72 75 accessed if pLru
5760: 4e 65 78 74 20 69 73 20 30 20 2a 2f 0a 20 20 61 Next is 0 */. a
5770: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 69 73 ssert( pPage->is
5780: 41 6e 63 68 6f 72 3d 3d 30 20 29 3b 0a 20 20 61 Anchor==0 );. a
5790: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 43 ssert( pPage->pC
57a0: 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6c 72 ache->pGroup->lr
57b0: 75 2e 69 73 41 6e 63 68 6f 72 3d 3d 31 20 29 3b u.isAnchor==1 );
57c0: 0a 20 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65 . pPage->pCache
57d0: 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65 2d 2d 3b ->nRecyclable--;
57e0: 0a 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 3b . return pPage;
57f0: 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 6d 6f 76 .}.../*.** Remov
5800: 65 20 74 68 65 20 70 61 67 65 20 73 75 70 70 6c e the page suppl
5810: 69 65 64 20 61 73 20 61 6e 20 61 72 67 75 6d 65 ied as an argume
5820: 6e 74 20 66 72 6f 6d 20 74 68 65 20 68 61 73 68 nt from the hash
5830: 20 74 61 62 6c 65 20 0a 2a 2a 20 28 50 43 61 63 table .** (PCac
5840: 68 65 31 2e 61 70 48 61 73 68 20 73 74 72 75 63 he1.apHash struc
5850: 74 75 72 65 29 20 74 68 61 74 20 69 74 20 69 73 ture) that it is
5860: 20 63 75 72 72 65 6e 74 6c 79 20 73 74 6f 72 65 currently store
5870: 64 20 69 6e 2e 0a 2a 2a 20 41 6c 73 6f 20 66 72 d in..** Also fr
5880: 65 65 20 74 68 65 20 70 61 67 65 20 69 66 20 66 ee the page if f
5890: 72 65 65 50 61 67 65 20 69 73 20 74 72 75 65 2e reePage is true.
58a0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50 47 72 6f 75 .**.** The PGrou
58b0: 70 20 6d 75 74 65 78 20 6d 75 73 74 20 62 65 20 p mutex must be
58c0: 68 65 6c 64 20 77 68 65 6e 20 74 68 69 73 20 66 held when this f
58d0: 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 unction is calle
58e0: 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 d..*/.static voi
58f0: 64 20 70 63 61 63 68 65 31 52 65 6d 6f 76 65 46 d pcache1RemoveF
5900: 72 6f 6d 48 61 73 68 28 50 67 48 64 72 31 20 2a romHash(PgHdr1 *
5910: 70 50 61 67 65 2c 20 69 6e 74 20 66 72 65 65 46 pPage, int freeF
5920: 6c 61 67 29 7b 0a 20 20 75 6e 73 69 67 6e 65 64 lag){. unsigned
5930: 20 69 6e 74 20 68 3b 0a 20 20 50 43 61 63 68 65 int h;. PCache
5940: 31 20 2a 70 43 61 63 68 65 20 3d 20 70 50 61 67 1 *pCache = pPag
5950: 65 2d 3e 70 43 61 63 68 65 3b 0a 20 20 50 67 48 e->pCache;. PgH
5960: 64 72 31 20 2a 2a 70 70 3b 0a 0a 20 20 61 73 73 dr1 **pp;.. ass
5970: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
5980: 65 78 5f 68 65 6c 64 28 70 43 61 63 68 65 2d 3e ex_held(pCache->
5990: 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29 pGroup->mutex) )
59a0: 3b 0a 20 20 68 20 3d 20 70 50 61 67 65 2d 3e 69 ;. h = pPage->i
59b0: 4b 65 79 20 25 20 70 43 61 63 68 65 2d 3e 6e 48 Key % pCache->nH
59c0: 61 73 68 3b 0a 20 20 66 6f 72 28 70 70 3d 26 70 ash;. for(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 28 2a 70 70 29 21 3d 70 50 61 67 65 3b 20 ; (*pp)!=pPage;
59f0: 70 70 3d 26 28 2a 70 70 29 2d 3e 70 4e 65 78 74 pp=&(*pp)->pNext
5a00: 29 3b 0a 20 20 2a 70 70 20 3d 20 28 2a 70 70 29 );. *pp = (*pp)
5a10: 2d 3e 70 4e 65 78 74 3b 0a 0a 20 20 70 43 61 63 ->pNext;.. pCac
5a20: 68 65 2d 3e 6e 50 61 67 65 2d 2d 3b 0a 20 20 69 he->nPage--;. i
5a30: 66 28 20 66 72 65 65 46 6c 61 67 20 29 20 70 63 f( freeFlag ) pc
5a40: 61 63 68 65 31 46 72 65 65 50 61 67 65 28 70 50 ache1FreePage(pP
5a50: 61 67 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 age);.}../*.** I
5a60: 66 20 74 68 65 72 65 20 61 72 65 20 63 75 72 72 f there are curr
5a70: 65 6e 74 6c 79 20 6d 6f 72 65 20 74 68 61 6e 20 ently more than
5a80: 6e 4d 61 78 50 61 67 65 20 70 61 67 65 73 20 61 nMaxPage pages a
5a90: 6c 6c 6f 63 61 74 65 64 2c 20 74 72 79 0a 2a 2a llocated, try.**
5aa0: 20 74 6f 20 72 65 63 79 63 6c 65 20 70 61 67 65 to recycle page
5ab0: 73 20 74 6f 20 72 65 64 75 63 65 20 74 68 65 20 s to reduce the
5ac0: 6e 75 6d 62 65 72 20 61 6c 6c 6f 63 61 74 65 64 number allocated
5ad0: 20 74 6f 20 6e 4d 61 78 50 61 67 65 2e 0a 2a 2f to nMaxPage..*/
5ae0: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 .static void pca
5af0: 63 68 65 31 45 6e 66 6f 72 63 65 4d 61 78 50 61 che1EnforceMaxPa
5b00: 67 65 28 50 43 61 63 68 65 31 20 2a 70 43 61 63 ge(PCache1 *pCac
5b10: 68 65 29 7b 0a 20 20 50 47 72 6f 75 70 20 2a 70 he){. PGroup *p
5b20: 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65 2d 3e Group = pCache->
5b30: 70 47 72 6f 75 70 3b 0a 20 20 50 67 48 64 72 31 pGroup;. PgHdr1
5b40: 20 2a 70 3b 0a 20 20 61 73 73 65 72 74 28 20 73 *p;. assert( s
5b50: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
5b60: 64 28 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 d(pGroup->mutex)
5b70: 20 29 3b 0a 20 20 77 68 69 6c 65 28 20 70 47 72 );. while( pGr
5b80: 6f 75 70 2d 3e 6e 50 75 72 67 65 61 62 6c 65 3e oup->nPurgeable>
5b90: 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 pGroup->nMaxPage
5ba0: 0a 20 20 20 20 20 20 26 26 20 28 70 3d 70 47 72 . && (p=pGr
5bb0: 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72 75 50 72 65 oup->lru.pLruPre
5bc0: 76 29 2d 3e 69 73 41 6e 63 68 6f 72 3d 3d 30 0a v)->isAnchor==0.
5bd0: 20 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 ){. assert(
5be0: 20 70 2d 3e 70 43 61 63 68 65 2d 3e 70 47 72 6f p->pCache->pGro
5bf0: 75 70 3d 3d 70 47 72 6f 75 70 20 29 3b 0a 20 20 up==pGroup );.
5c00: 20 20 61 73 73 65 72 74 28 20 50 41 47 45 5f 49 assert( PAGE_I
5c10: 53 5f 55 4e 50 49 4e 4e 45 44 28 70 29 20 29 3b S_UNPINNED(p) );
5c20: 0a 20 20 20 20 70 63 61 63 68 65 31 50 69 6e 50 . pcache1PinP
5c30: 61 67 65 28 70 29 3b 0a 20 20 20 20 70 63 61 63 age(p);. pcac
5c40: 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73 he1RemoveFromHas
5c50: 68 28 70 2c 20 31 29 3b 0a 20 20 7d 0a 20 20 69 h(p, 1);. }. i
5c60: 66 28 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 f( pCache->nPage
5c70: 3d 3d 30 20 26 26 20 70 43 61 63 68 65 2d 3e 70 ==0 && pCache->p
5c80: 42 75 6c 6b 20 29 7b 0a 20 20 20 20 73 71 6c 69 Bulk ){. sqli
5c90: 74 65 33 5f 66 72 65 65 28 70 43 61 63 68 65 2d te3_free(pCache-
5ca0: 3e 70 42 75 6c 6b 29 3b 0a 20 20 20 20 70 43 61 >pBulk);. pCa
5cb0: 63 68 65 2d 3e 70 42 75 6c 6b 20 3d 20 70 43 61 che->pBulk = pCa
5cc0: 63 68 65 2d 3e 70 46 72 65 65 20 3d 20 30 3b 0a che->pFree = 0;.
5cd0: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 69 73 }.}../*.** Dis
5ce0: 63 61 72 64 20 61 6c 6c 20 70 61 67 65 73 20 66 card all pages f
5cf0: 72 6f 6d 20 63 61 63 68 65 20 70 43 61 63 68 65 rom cache pCache
5d00: 20 77 69 74 68 20 61 20 70 61 67 65 20 6e 75 6d with a page num
5d10: 62 65 72 20 28 6b 65 79 20 76 61 6c 75 65 29 20 ber (key value)
5d20: 0a 2a 2a 20 67 72 65 61 74 65 72 20 74 68 61 6e .** greater than
5d30: 20 6f 72 20 65 71 75 61 6c 20 74 6f 20 69 4c 69 or equal to iLi
5d40: 6d 69 74 2e 20 41 6e 79 20 70 69 6e 6e 65 64 20 mit. Any pinned
5d50: 70 61 67 65 73 20 74 68 61 74 20 6d 65 65 74 20 pages that meet
5d60: 74 68 69 73 20 0a 2a 2a 20 63 72 69 74 65 72 69 this .** criteri
5d70: 61 20 61 72 65 20 75 6e 70 69 6e 6e 65 64 20 62 a are unpinned b
5d80: 65 66 6f 72 65 20 74 68 65 79 20 61 72 65 20 64 efore they are d
5d90: 69 73 63 61 72 64 65 64 2e 0a 2a 2a 0a 2a 2a 20 iscarded..**.**
5da0: 54 68 65 20 50 43 61 63 68 65 20 6d 75 74 65 78 The PCache mutex
5db0: 20 6d 75 73 74 20 62 65 20 68 65 6c 64 20 77 68 must be held wh
5dc0: 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e en this function
5dd0: 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 is called..*/.s
5de0: 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 tatic void pcach
5df0: 65 31 54 72 75 6e 63 61 74 65 55 6e 73 61 66 65 e1TruncateUnsafe
5e00: 28 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 (. PCache1 *pCa
5e10: 63 68 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 che,
5e20: 20 2f 2a 20 54 68 65 20 63 61 63 68 65 20 74 6f /* The cache to
5e30: 20 74 72 75 6e 63 61 74 65 20 2a 2f 0a 20 20 75 truncate */. u
5e40: 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4c 69 6d nsigned int iLim
5e50: 69 74 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 it /* D
5e60: 72 6f 70 20 70 61 67 65 73 20 77 69 74 68 20 74 rop pages with t
5e70: 68 69 73 20 70 67 6e 6f 20 6f 72 20 6c 61 72 67 his pgno or larg
5e80: 65 72 20 2a 2f 0a 29 7b 0a 20 20 54 45 53 54 4f er */.){. TESTO
5e90: 4e 4c 59 28 20 69 6e 74 20 6e 50 61 67 65 20 3d NLY( int nPage =
5ea0: 20 30 3b 20 29 20 20 2f 2a 20 54 6f 20 61 73 73 0; ) /* To ass
5eb0: 65 72 74 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 ert pCache->nPag
5ec0: 65 20 69 73 20 63 6f 72 72 65 63 74 20 2a 2f 0a e is correct */.
5ed0: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 68 unsigned int h
5ee0: 2c 20 69 53 74 6f 70 3b 0a 20 20 61 73 73 65 72 , iStop;. asser
5ef0: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
5f00: 5f 68 65 6c 64 28 70 43 61 63 68 65 2d 3e 70 47 _held(pCache->pG
5f10: 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a roup->mutex) );.
5f20: 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65 assert( pCache
5f30: 2d 3e 69 4d 61 78 4b 65 79 20 3e 3d 20 69 4c 69 ->iMaxKey >= iLi
5f40: 6d 69 74 20 29 3b 0a 20 20 61 73 73 65 72 74 28 mit );. assert(
5f50: 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 20 3e pCache->nHash >
5f60: 20 30 20 29 3b 0a 20 20 69 66 28 20 70 43 61 63 0 );. if( pCac
5f70: 68 65 2d 3e 69 4d 61 78 4b 65 79 20 2d 20 69 4c he->iMaxKey - iL
5f80: 69 6d 69 74 20 3c 20 70 43 61 63 68 65 2d 3e 6e imit < pCache->n
5f90: 48 61 73 68 20 29 7b 0a 20 20 20 20 2f 2a 20 49 Hash ){. /* I
5fa0: 66 20 77 65 20 61 72 65 20 6a 75 73 74 20 73 68 f we are just sh
5fb0: 61 76 69 6e 67 20 74 68 65 20 6c 61 73 74 20 66 aving the last f
5fc0: 65 77 20 70 61 67 65 73 20 6f 66 66 20 74 68 65 ew pages off the
5fd0: 20 65 6e 64 20 6f 66 20 74 68 65 0a 20 20 20 20 end of the.
5fe0: 2a 2a 20 63 61 63 68 65 2c 20 74 68 65 6e 20 74 ** cache, then t
5ff0: 68 65 72 65 20 69 73 20 6e 6f 20 70 6f 69 6e 74 here is no point
6000: 20 69 6e 20 73 63 61 6e 6e 69 6e 67 20 74 68 65 in scanning the
6010: 20 65 6e 74 69 72 65 20 68 61 73 68 20 74 61 62 entire hash tab
6020: 6c 65 2e 0a 20 20 20 20 2a 2a 20 4f 6e 6c 79 20 le.. ** Only
6030: 73 63 61 6e 20 74 68 6f 73 65 20 68 61 73 68 20 scan those hash
6040: 73 6c 6f 74 73 20 74 68 61 74 20 6d 69 67 68 74 slots that might
6050: 20 63 6f 6e 74 61 69 6e 20 70 61 67 65 73 20 74 contain pages t
6060: 68 61 74 20 6e 65 65 64 20 74 6f 0a 20 20 20 20 hat need to.
6070: 2a 2a 20 62 65 20 72 65 6d 6f 76 65 64 2e 20 2a ** be removed. *
6080: 2f 0a 20 20 20 20 68 20 3d 20 69 4c 69 6d 69 74 /. h = iLimit
6090: 20 25 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 % pCache->nHash
60a0: 3b 0a 20 20 20 20 69 53 74 6f 70 20 3d 20 70 43 ;. iStop = pC
60b0: 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 25 20 ache->iMaxKey %
60c0: 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 pCache->nHash;.
60d0: 20 20 20 54 45 53 54 4f 4e 4c 59 28 20 6e 50 61 TESTONLY( nPa
60e0: 67 65 20 3d 20 2d 31 30 3b 20 29 20 20 2f 2a 20 ge = -10; ) /*
60f0: 44 69 73 61 62 6c 65 20 74 68 65 20 70 43 61 63 Disable the pCac
6100: 68 65 2d 3e 6e 50 61 67 65 20 76 61 6c 69 64 69 he->nPage validi
6110: 74 79 20 63 68 65 63 6b 20 2a 2f 0a 20 20 7d 65 ty check */. }e
6120: 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 54 68 69 73 lse{. /* This
6130: 20 69 73 20 74 68 65 20 67 65 6e 65 72 61 6c 20 is the general
6140: 63 61 73 65 20 77 68 65 72 65 20 6d 61 6e 79 20 case where many
6150: 70 61 67 65 73 20 61 72 65 20 62 65 69 6e 67 20 pages are being
6160: 72 65 6d 6f 76 65 64 2e 0a 20 20 20 20 2a 2a 20 removed.. **
6170: 49 74 20 69 73 20 6e 65 63 65 73 73 61 72 79 20 It is necessary
6180: 74 6f 20 73 63 61 6e 20 74 68 65 20 65 6e 74 69 to scan the enti
6190: 72 65 20 68 61 73 68 20 74 61 62 6c 65 20 2a 2f re hash table */
61a0: 0a 20 20 20 20 68 20 3d 20 70 43 61 63 68 65 2d . h = pCache-
61b0: 3e 6e 48 61 73 68 2f 32 3b 0a 20 20 20 20 69 53 >nHash/2;. iS
61c0: 74 6f 70 20 3d 20 68 20 2d 20 31 3b 0a 20 20 7d top = h - 1;. }
61d0: 0a 20 20 66 6f 72 28 3b 3b 29 7b 0a 20 20 20 20 . for(;;){.
61e0: 50 67 48 64 72 31 20 2a 2a 70 70 3b 0a 20 20 20 PgHdr1 **pp;.
61f0: 20 50 67 48 64 72 31 20 2a 70 50 61 67 65 3b 0a PgHdr1 *pPage;.
6200: 20 20 20 20 61 73 73 65 72 74 28 20 68 3c 70 43 assert( h<pC
6210: 61 63 68 65 2d 3e 6e 48 61 73 68 20 29 3b 0a 20 ache->nHash );.
6220: 20 20 20 70 70 20 3d 20 26 70 43 61 63 68 65 2d pp = &pCache-
6230: 3e 61 70 48 61 73 68 5b 68 5d 3b 20 0a 20 20 20 >apHash[h]; .
6240: 20 77 68 69 6c 65 28 20 28 70 50 61 67 65 20 3d while( (pPage =
6250: 20 2a 70 70 29 21 3d 30 20 29 7b 0a 20 20 20 20 *pp)!=0 ){.
6260: 20 20 69 66 28 20 70 50 61 67 65 2d 3e 69 4b 65 if( pPage->iKe
6270: 79 3e 3d 69 4c 69 6d 69 74 20 29 7b 0a 20 20 20 y>=iLimit ){.
6280: 20 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 50 61 pCache->nPa
6290: 67 65 2d 2d 3b 0a 20 20 20 20 20 20 20 20 2a 70 ge--;. *p
62a0: 70 20 3d 20 70 50 61 67 65 2d 3e 70 4e 65 78 74 p = pPage->pNext
62b0: 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 50 41 ;. if( PA
62c0: 47 45 5f 49 53 5f 55 4e 50 49 4e 4e 45 44 28 70 GE_IS_UNPINNED(p
62d0: 50 61 67 65 29 20 29 20 70 63 61 63 68 65 31 50 Page) ) pcache1P
62e0: 69 6e 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 inPage(pPage);.
62f0: 20 20 20 20 20 20 20 70 63 61 63 68 65 31 46 72 pcache1Fr
6300: 65 65 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 eePage(pPage);.
6310: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
6320: 20 20 20 20 70 70 20 3d 20 26 70 50 61 67 65 2d pp = &pPage-
6330: 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 20 20 >pNext;.
6340: 54 45 53 54 4f 4e 4c 59 28 20 69 66 28 20 6e 50 TESTONLY( if( nP
6350: 61 67 65 3e 3d 30 20 29 20 6e 50 61 67 65 2b 2b age>=0 ) nPage++
6360: 3b 20 29 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 ; ). }.
6370: 7d 0a 20 20 20 20 69 66 28 20 68 3d 3d 69 53 74 }. if( h==iSt
6380: 6f 70 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 op ) break;.
6390: 68 20 3d 20 28 68 2b 31 29 20 25 20 70 43 61 63 h = (h+1) % pCac
63a0: 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 7d 0a 20 he->nHash;. }.
63b0: 20 61 73 73 65 72 74 28 20 6e 50 61 67 65 3c 30 assert( nPage<0
63c0: 20 7c 7c 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 || pCache->nPag
63d0: 65 3d 3d 28 75 6e 73 69 67 6e 65 64 29 6e 50 61 e==(unsigned)nPa
63e0: 67 65 20 29 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a ge );.}../******
63f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
6400: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
6410: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
6420: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
6430: 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 2f 2a 2a 2a 2a 2a ********/./*****
6440: 2a 2a 2a 20 73 71 6c 69 74 65 33 5f 70 63 61 63 *** sqlite3_pcac
6450: 68 65 20 4d 65 74 68 6f 64 73 20 2a 2a 2a 2a 2a he Methods *****
6460: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
6470: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
6480: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 0a 2a *********/../*.*
6490: 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e * Implementation
64a0: 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f of the sqlite3_
64b0: 70 63 61 63 68 65 2e 78 49 6e 69 74 20 6d 65 74 pcache.xInit met
64c0: 68 6f 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 hod..*/.static i
64d0: 6e 74 20 70 63 61 63 68 65 31 49 6e 69 74 28 76 nt pcache1Init(v
64e0: 6f 69 64 20 2a 4e 6f 74 55 73 65 64 29 7b 0a 20 oid *NotUsed){.
64f0: 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 UNUSED_PARAMETE
6500: 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 61 73 R(NotUsed);. as
6510: 73 65 72 74 28 20 70 63 61 63 68 65 31 2e 69 73 sert( pcache1.is
6520: 49 6e 69 74 3d 3d 30 20 29 3b 0a 20 20 6d 65 6d Init==0 );. mem
6530: 73 65 74 28 26 70 63 61 63 68 65 31 2c 20 30 2c set(&pcache1, 0,
6540: 20 73 69 7a 65 6f 66 28 70 63 61 63 68 65 31 29 sizeof(pcache1)
6550: 29 3b 0a 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54 );... /*. ** T
6560: 68 65 20 70 63 61 63 68 65 31 2e 73 65 70 61 72 he pcache1.separ
6570: 61 74 65 43 61 63 68 65 20 76 61 72 69 61 62 6c ateCache variabl
6580: 65 20 69 73 20 74 72 75 65 20 69 66 20 65 61 63 e is true if eac
6590: 68 20 50 43 61 63 68 65 20 68 61 73 20 69 74 73 h PCache has its
65a0: 20 6f 77 6e 0a 20 20 2a 2a 20 70 72 69 76 61 74 own. ** privat
65b0: 65 20 50 47 72 6f 75 70 20 28 6d 6f 64 65 2d 31 e PGroup (mode-1
65c0: 29 2e 20 20 70 63 61 63 68 65 31 2e 73 65 70 61 ). pcache1.sepa
65d0: 72 61 74 65 43 61 63 68 65 20 69 73 20 66 61 6c rateCache is fal
65e0: 73 65 20 69 66 20 74 68 65 20 73 69 6e 67 6c 65 se if the single
65f0: 0a 20 20 2a 2a 20 50 47 72 6f 75 70 20 69 6e 20 . ** PGroup in
6600: 70 63 61 63 68 65 31 2e 67 72 70 20 69 73 20 75 pcache1.grp is u
6610: 73 65 64 20 66 6f 72 20 61 6c 6c 20 70 61 67 65 sed for all page
6620: 20 63 61 63 68 65 73 20 28 6d 6f 64 65 2d 32 29 caches (mode-2)
6630: 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 .. **. ** *
6640: 20 41 6c 77 61 79 73 20 75 73 65 20 61 20 75 6e Always use a un
6650: 69 66 69 65 64 20 63 61 63 68 65 20 28 6d 6f 64 ified cache (mod
6660: 65 2d 32 29 20 69 66 20 45 4e 41 42 4c 45 5f 4d e-2) if ENABLE_M
6670: 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 EMORY_MANAGEMENT
6680: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 20 . **. ** *
6690: 55 73 65 20 61 20 75 6e 69 66 69 65 64 20 63 61 Use a unified ca
66a0: 63 68 65 20 69 6e 20 73 69 6e 67 6c 65 2d 74 68 che in single-th
66b0: 72 65 61 64 65 64 20 61 70 70 6c 69 63 61 74 69 readed applicati
66c0: 6f 6e 73 20 74 68 61 74 20 68 61 76 65 0a 20 20 ons that have.
66d0: 2a 2a 20 20 20 20 20 20 63 6f 6e 66 69 67 75 72 ** configur
66e0: 65 64 20 61 20 73 74 61 72 74 2d 74 69 6d 65 20 ed a start-time
66f0: 62 75 66 66 65 72 20 66 6f 72 20 75 73 65 20 61 buffer for use a
6700: 73 20 70 61 67 65 2d 63 61 63 68 65 20 6d 65 6d s page-cache mem
6710: 6f 72 79 20 75 73 69 6e 67 0a 20 20 2a 2a 20 20 ory using. **
6720: 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 sqlite3_conf
6730: 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 ig(SQLITE_CONFIG
6740: 5f 50 41 47 45 43 41 43 48 45 2c 20 70 42 75 66 _PAGECACHE, pBuf
6750: 2c 20 73 7a 2c 20 4e 29 20 77 69 74 68 20 6e 6f , sz, N) with no
6760: 6e 2d 4e 55 4c 4c 20 0a 20 20 2a 2a 20 20 20 20 n-NULL . **
6770: 20 20 70 42 75 66 20 61 72 67 75 6d 65 6e 74 2e pBuf argument.
6780: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 20 . **. ** *
6790: 4f 74 68 65 72 77 69 73 65 20 75 73 65 20 73 65 Otherwise use se
67a0: 70 61 72 61 74 65 20 63 61 63 68 65 73 20 28 6d parate caches (m
67b0: 6f 64 65 2d 31 29 0a 20 20 2a 2f 0a 23 69 66 20 ode-1). */.#if
67c0: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 defined(SQLITE_E
67d0: 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e NABLE_MEMORY_MAN
67e0: 41 47 45 4d 45 4e 54 29 0a 20 20 70 63 61 63 68 AGEMENT). pcach
67f0: 65 31 2e 73 65 70 61 72 61 74 65 43 61 63 68 65 e1.separateCache
6800: 20 3d 20 30 3b 0a 23 65 6c 69 66 20 53 51 4c 49 = 0;.#elif SQLI
6810: 54 45 5f 54 48 52 45 41 44 53 41 46 45 0a 20 20 TE_THREADSAFE.
6820: 70 63 61 63 68 65 31 2e 73 65 70 61 72 61 74 65 pcache1.separate
6830: 43 61 63 68 65 20 3d 20 73 71 6c 69 74 65 33 47 Cache = sqlite3G
6840: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 lobalConfig.pPag
6850: 65 3d 3d 30 0a 20 20 20 20 20 20 20 20 20 20 20 e==0.
6860: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
6870: 7c 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 | sqlite3GlobalC
6880: 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 onfig.bCoreMutex
6890: 3e 30 3b 0a 23 65 6c 73 65 0a 20 20 70 63 61 63 >0;.#else. pcac
68a0: 68 65 31 2e 73 65 70 61 72 61 74 65 43 61 63 68 he1.separateCach
68b0: 65 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 e = sqlite3Globa
68c0: 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65 3d 3d 30 lConfig.pPage==0
68d0: 3b 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 53 51 ;.#endif..#if SQ
68e0: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 0a LITE_THREADSAFE.
68f0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f if( sqlite3Glo
6900: 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d balConfig.bCoreM
6910: 75 74 65 78 20 29 7b 0a 20 20 20 20 70 63 61 63 utex ){. pcac
6920: 68 65 31 2e 67 72 70 2e 6d 75 74 65 78 20 3d 20 he1.grp.mutex =
6930: 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f sqlite3MutexAllo
6940: 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 c(SQLITE_MUTEX_S
6950: 54 41 54 49 43 5f 4c 52 55 29 3b 0a 20 20 20 20 TATIC_LRU);.
6960: 70 63 61 63 68 65 31 2e 6d 75 74 65 78 20 3d 20 pcache1.mutex =
6970: 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f sqlite3MutexAllo
6980: 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 c(SQLITE_MUTEX_S
6990: 54 41 54 49 43 5f 50 4d 45 4d 29 3b 0a 20 20 7d TATIC_PMEM);. }
69a0: 0a 23 65 6e 64 69 66 0a 20 20 69 66 28 20 70 63 .#endif. if( pc
69b0: 61 63 68 65 31 2e 73 65 70 61 72 61 74 65 43 61 ache1.separateCa
69c0: 63 68 65 0a 20 20 20 26 26 20 73 71 6c 69 74 65 che. && sqlite
69d0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 50 3GlobalConfig.nP
69e0: 61 67 65 21 3d 30 0a 20 20 20 26 26 20 73 71 6c age!=0. && sql
69f0: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
6a00: 2e 70 50 61 67 65 3d 3d 30 0a 20 20 29 7b 0a 20 .pPage==0. ){.
6a10: 20 20 20 70 63 61 63 68 65 31 2e 6e 49 6e 69 74 pcache1.nInit
6a20: 50 61 67 65 20 3d 20 73 71 6c 69 74 65 33 47 6c Page = sqlite3Gl
6a30: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 50 61 67 65 obalConfig.nPage
6a40: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 ;. }else{. p
6a50: 63 61 63 68 65 31 2e 6e 49 6e 69 74 50 61 67 65 cache1.nInitPage
6a60: 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 70 63 61 63 = 0;. }. pcac
6a70: 68 65 31 2e 67 72 70 2e 6d 78 50 69 6e 6e 65 64 he1.grp.mxPinned
6a80: 20 3d 20 31 30 3b 0a 20 20 70 63 61 63 68 65 31 = 10;. pcache1
6a90: 2e 69 73 49 6e 69 74 20 3d 20 31 3b 0a 20 20 72 .isInit = 1;. r
6aa0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
6ab0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d .}../*.** Implem
6ac0: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 entation of the
6ad0: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78 sqlite3_pcache.x
6ae0: 53 68 75 74 64 6f 77 6e 20 6d 65 74 68 6f 64 2e Shutdown method.
6af0: 0a 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 74 68 .** Note that th
6b00: 65 20 73 74 61 74 69 63 20 6d 75 74 65 78 20 61 e static mutex a
6b10: 6c 6c 6f 63 61 74 65 64 20 69 6e 20 78 49 6e 69 llocated in xIni
6b20: 74 20 64 6f 65 73 20 0a 2a 2a 20 6e 6f 74 20 6e t does .** not n
6b30: 65 65 64 20 74 6f 20 62 65 20 66 72 65 65 64 2e eed to be freed.
6b40: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 .*/.static void
6b50: 70 63 61 63 68 65 31 53 68 75 74 64 6f 77 6e 28 pcache1Shutdown(
6b60: 76 6f 69 64 20 2a 4e 6f 74 55 73 65 64 29 7b 0a void *NotUsed){.
6b70: 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 UNUSED_PARAMET
6b80: 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 61 ER(NotUsed);. a
6b90: 73 73 65 72 74 28 20 70 63 61 63 68 65 31 2e 69 ssert( pcache1.i
6ba0: 73 49 6e 69 74 21 3d 30 20 29 3b 0a 20 20 6d 65 sInit!=0 );. me
6bb0: 6d 73 65 74 28 26 70 63 61 63 68 65 31 2c 20 30 mset(&pcache1, 0
6bc0: 2c 20 73 69 7a 65 6f 66 28 70 63 61 63 68 65 31 , sizeof(pcache1
6bd0: 29 29 3b 0a 7d 0a 0a 2f 2a 20 66 6f 72 77 61 72 ));.}../* forwar
6be0: 64 20 64 65 63 6c 61 72 61 74 69 6f 6e 20 2a 2f d declaration */
6bf0: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 .static void pca
6c00: 63 68 65 31 44 65 73 74 72 6f 79 28 73 71 6c 69 che1Destroy(sqli
6c10: 74 65 33 5f 70 63 61 63 68 65 20 2a 70 29 3b 0a te3_pcache *p);.
6c20: 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 ./*.** Implement
6c30: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c ation of the sql
6c40: 69 74 65 33 5f 70 63 61 63 68 65 2e 78 43 72 65 ite3_pcache.xCre
6c50: 61 74 65 20 6d 65 74 68 6f 64 2e 0a 2a 2a 0a 2a ate method..**.*
6c60: 2a 20 41 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 * Allocate a new
6c70: 20 63 61 63 68 65 2e 0a 2a 2f 0a 73 74 61 74 69 cache..*/.stati
6c80: 63 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 c sqlite3_pcache
6c90: 20 2a 70 63 61 63 68 65 31 43 72 65 61 74 65 28 *pcache1Create(
6ca0: 69 6e 74 20 73 7a 50 61 67 65 2c 20 69 6e 74 20 int szPage, int
6cb0: 73 7a 45 78 74 72 61 2c 20 69 6e 74 20 62 50 75 szExtra, int bPu
6cc0: 72 67 65 61 62 6c 65 29 7b 0a 20 20 50 43 61 63 rgeable){. PCac
6cd0: 68 65 31 20 2a 70 43 61 63 68 65 3b 20 20 20 20 he1 *pCache;
6ce0: 20 20 2f 2a 20 54 68 65 20 6e 65 77 6c 79 20 63 /* The newly c
6cf0: 72 65 61 74 65 64 20 70 61 67 65 20 63 61 63 68 reated page cach
6d00: 65 20 2a 2f 0a 20 20 50 47 72 6f 75 70 20 2a 70 e */. PGroup *p
6d10: 47 72 6f 75 70 3b 20 20 20 20 20 20 20 2f 2a 20 Group; /*
6d20: 54 68 65 20 67 72 6f 75 70 20 74 68 65 20 6e 65 The group the ne
6d30: 77 20 70 61 67 65 20 63 61 63 68 65 20 77 69 6c w page cache wil
6d40: 6c 20 62 65 6c 6f 6e 67 20 74 6f 20 2a 2f 0a 20 l belong to */.
6d50: 20 69 6e 74 20 73 7a 3b 20 20 20 20 20 20 20 20 int sz;
6d60: 20 20 20 20 20 20 20 2f 2a 20 42 79 74 65 73 20 /* Bytes
6d70: 6f 66 20 6d 65 6d 6f 72 79 20 72 65 71 75 69 72 of memory requir
6d80: 65 64 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 74 ed to allocate t
6d90: 68 65 20 6e 65 77 20 63 61 63 68 65 20 2a 2f 0a he new cache */.
6da0: 0a 20 20 61 73 73 65 72 74 28 20 28 73 7a 50 61 . assert( (szPa
6db0: 67 65 20 26 20 28 73 7a 50 61 67 65 2d 31 29 29 ge & (szPage-1))
6dc0: 3d 3d 30 20 26 26 20 73 7a 50 61 67 65 3e 3d 35 ==0 && szPage>=5
6dd0: 31 32 20 26 26 20 73 7a 50 61 67 65 3c 3d 36 35 12 && szPage<=65
6de0: 35 33 36 20 29 3b 0a 20 20 61 73 73 65 72 74 28 536 );. assert(
6df0: 20 73 7a 45 78 74 72 61 20 3c 20 33 30 30 20 29 szExtra < 300 )
6e00: 3b 0a 0a 20 20 73 7a 20 3d 20 73 69 7a 65 6f 66 ;.. sz = sizeof
6e10: 28 50 43 61 63 68 65 31 29 20 2b 20 73 69 7a 65 (PCache1) + size
6e20: 6f 66 28 50 47 72 6f 75 70 29 2a 70 63 61 63 68 of(PGroup)*pcach
6e30: 65 31 2e 73 65 70 61 72 61 74 65 43 61 63 68 65 e1.separateCache
6e40: 3b 0a 20 20 70 43 61 63 68 65 20 3d 20 28 50 43 ;. pCache = (PC
6e50: 61 63 68 65 31 20 2a 29 73 71 6c 69 74 65 33 4d ache1 *)sqlite3M
6e60: 61 6c 6c 6f 63 5a 65 72 6f 28 73 7a 29 3b 0a 20 allocZero(sz);.
6e70: 20 69 66 28 20 70 43 61 63 68 65 20 29 7b 0a 20 if( pCache ){.
6e80: 20 20 20 69 66 28 20 70 63 61 63 68 65 31 2e 73 if( pcache1.s
6e90: 65 70 61 72 61 74 65 43 61 63 68 65 20 29 7b 0a eparateCache ){.
6ea0: 20 20 20 20 20 20 70 47 72 6f 75 70 20 3d 20 28 pGroup = (
6eb0: 50 47 72 6f 75 70 2a 29 26 70 43 61 63 68 65 5b PGroup*)&pCache[
6ec0: 31 5d 3b 0a 20 20 20 20 20 20 70 47 72 6f 75 70 1];. pGroup
6ed0: 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 20 31 30 3b ->mxPinned = 10;
6ee0: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
6ef0: 20 20 70 47 72 6f 75 70 20 3d 20 26 70 63 61 63 pGroup = &pcac
6f00: 68 65 31 2e 67 72 70 3b 0a 20 20 20 20 7d 0a 20 he1.grp;. }.
6f10: 20 20 20 69 66 28 20 70 47 72 6f 75 70 2d 3e 6c if( pGroup->l
6f20: 72 75 2e 69 73 41 6e 63 68 6f 72 3d 3d 30 20 29 ru.isAnchor==0 )
6f30: 7b 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e {. pGroup->
6f40: 6c 72 75 2e 69 73 41 6e 63 68 6f 72 20 3d 20 31 lru.isAnchor = 1
6f50: 3b 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e ;. pGroup->
6f60: 6c 72 75 2e 70 4c 72 75 50 72 65 76 20 3d 20 70 lru.pLruPrev = p
6f70: 47 72 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72 75 4e Group->lru.pLruN
6f80: 65 78 74 20 3d 20 26 70 47 72 6f 75 70 2d 3e 6c ext = &pGroup->l
6f90: 72 75 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 43 ru;. }. pC
6fa0: 61 63 68 65 2d 3e 70 47 72 6f 75 70 20 3d 20 70 ache->pGroup = p
6fb0: 47 72 6f 75 70 3b 0a 20 20 20 20 70 43 61 63 68 Group;. pCach
6fc0: 65 2d 3e 73 7a 50 61 67 65 20 3d 20 73 7a 50 61 e->szPage = szPa
6fd0: 67 65 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e ge;. pCache->
6fe0: 73 7a 45 78 74 72 61 20 3d 20 73 7a 45 78 74 72 szExtra = szExtr
6ff0: 61 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 73 a;. pCache->s
7000: 7a 41 6c 6c 6f 63 20 3d 20 73 7a 50 61 67 65 20 zAlloc = szPage
7010: 2b 20 73 7a 45 78 74 72 61 20 2b 20 52 4f 55 4e + szExtra + ROUN
7020: 44 38 28 73 69 7a 65 6f 66 28 50 67 48 64 72 31 D8(sizeof(PgHdr1
7030: 29 29 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e ));. pCache->
7040: 62 50 75 72 67 65 61 62 6c 65 20 3d 20 28 62 50 bPurgeable = (bP
7050: 75 72 67 65 61 62 6c 65 20 3f 20 31 20 3a 20 30 urgeable ? 1 : 0
7060: 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e );. pcache1En
7070: 74 65 72 4d 75 74 65 78 28 70 47 72 6f 75 70 29 terMutex(pGroup)
7080: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 52 65 73 ;. pcache1Res
7090: 69 7a 65 48 61 73 68 28 70 43 61 63 68 65 29 3b izeHash(pCache);
70a0: 0a 20 20 20 20 69 66 28 20 62 50 75 72 67 65 61 . if( bPurgea
70b0: 62 6c 65 20 29 7b 0a 20 20 20 20 20 20 70 43 61 ble ){. pCa
70c0: 63 68 65 2d 3e 6e 4d 69 6e 20 3d 20 31 30 3b 0a che->nMin = 10;.
70d0: 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e 4d pGroup->nM
70e0: 69 6e 50 61 67 65 20 2b 3d 20 70 43 61 63 68 65 inPage += pCache
70f0: 2d 3e 6e 4d 69 6e 3b 0a 20 20 20 20 20 20 70 47 ->nMin;. pG
7100: 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d roup->mxPinned =
7110: 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 pGroup->nMaxPag
7120: 65 20 2b 20 31 30 20 2d 20 70 47 72 6f 75 70 2d e + 10 - pGroup-
7130: 3e 6e 4d 69 6e 50 61 67 65 3b 0a 20 20 20 20 20 >nMinPage;.
7140: 20 70 43 61 63 68 65 2d 3e 70 6e 50 75 72 67 65 pCache->pnPurge
7150: 61 62 6c 65 20 3d 20 26 70 47 72 6f 75 70 2d 3e able = &pGroup->
7160: 6e 50 75 72 67 65 61 62 6c 65 3b 0a 20 20 20 20 nPurgeable;.
7170: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 43 61 }else{. pCa
7180: 63 68 65 2d 3e 70 6e 50 75 72 67 65 61 62 6c 65 che->pnPurgeable
7190: 20 3d 20 26 70 43 61 63 68 65 2d 3e 6e 50 75 72 = &pCache->nPur
71a0: 67 65 61 62 6c 65 44 75 6d 6d 79 3b 0a 20 20 20 geableDummy;.
71b0: 20 7d 0a 20 20 20 20 70 63 61 63 68 65 31 4c 65 }. pcache1Le
71c0: 61 76 65 4d 75 74 65 78 28 70 47 72 6f 75 70 29 aveMutex(pGroup)
71d0: 3b 0a 20 20 20 20 69 66 28 20 70 43 61 63 68 65 ;. if( pCache
71e0: 2d 3e 6e 48 61 73 68 3d 3d 30 20 29 7b 0a 20 20 ->nHash==0 ){.
71f0: 20 20 20 20 70 63 61 63 68 65 31 44 65 73 74 72 pcache1Destr
7200: 6f 79 28 28 73 71 6c 69 74 65 33 5f 70 63 61 63 oy((sqlite3_pcac
7210: 68 65 2a 29 70 43 61 63 68 65 29 3b 0a 20 20 20 he*)pCache);.
7220: 20 20 20 70 43 61 63 68 65 20 3d 20 30 3b 0a 20 pCache = 0;.
7230: 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 }. }. retur
7240: 6e 20 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 n (sqlite3_pcach
7250: 65 20 2a 29 70 43 61 63 68 65 3b 0a 7d 0a 0a 2f e *)pCache;.}../
7260: 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 *.** Implementat
7270: 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74 ion of the sqlit
7280: 65 33 5f 70 63 61 63 68 65 2e 78 43 61 63 68 65 e3_pcache.xCache
7290: 73 69 7a 65 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a size method. .**
72a0: 0a 2a 2a 20 43 6f 6e 66 69 67 75 72 65 20 74 68 .** Configure th
72b0: 65 20 63 61 63 68 65 5f 73 69 7a 65 20 6c 69 6d e cache_size lim
72c0: 69 74 20 66 6f 72 20 61 20 63 61 63 68 65 2e 0a it for a cache..
72d0: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 */.static void p
72e0: 63 61 63 68 65 31 43 61 63 68 65 73 69 7a 65 28 cache1Cachesize(
72f0: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 2a sqlite3_pcache *
7300: 70 2c 20 69 6e 74 20 6e 4d 61 78 29 7b 0a 20 20 p, int nMax){.
7310: 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 20 PCache1 *pCache
7320: 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b 0a = (PCache1 *)p;.
7330: 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e 62 50 if( pCache->bP
7340: 75 72 67 65 61 62 6c 65 20 29 7b 0a 20 20 20 20 urgeable ){.
7350: 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70 20 3d PGroup *pGroup =
7360: 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3b pCache->pGroup;
7370: 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e 74 65 . pcache1Ente
7380: 72 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a rMutex(pGroup);.
7390: 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 pGroup->nMax
73a0: 50 61 67 65 20 2b 3d 20 28 6e 4d 61 78 20 2d 20 Page += (nMax -
73b0: 70 43 61 63 68 65 2d 3e 6e 4d 61 78 29 3b 0a 20 pCache->nMax);.
73c0: 20 20 20 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e pGroup->mxPin
73d0: 6e 65 64 20 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d ned = pGroup->nM
73e0: 61 78 50 61 67 65 20 2b 20 31 30 20 2d 20 70 47 axPage + 10 - pG
73f0: 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 3b 0a roup->nMinPage;.
7400: 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 pCache->nMax
7410: 20 3d 20 6e 4d 61 78 3b 0a 20 20 20 20 70 43 61 = nMax;. pCa
7420: 63 68 65 2d 3e 6e 39 30 70 63 74 20 3d 20 70 43 che->n90pct = pC
7430: 61 63 68 65 2d 3e 6e 4d 61 78 2a 39 2f 31 30 3b ache->nMax*9/10;
7440: 0a 20 20 20 20 70 63 61 63 68 65 31 45 6e 66 6f . pcache1Enfo
7450: 72 63 65 4d 61 78 50 61 67 65 28 70 43 61 63 68 rceMaxPage(pCach
7460: 65 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 4c e);. pcache1L
7470: 65 61 76 65 4d 75 74 65 78 28 70 47 72 6f 75 70 eaveMutex(pGroup
7480: 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 );. }.}../*.**
7490: 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f Implementation o
74a0: 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63 f the sqlite3_pc
74b0: 61 63 68 65 2e 78 53 68 72 69 6e 6b 20 6d 65 74 ache.xShrink met
74c0: 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 46 72 65 65 hod. .**.** Free
74d0: 20 75 70 20 61 73 20 6d 75 63 68 20 6d 65 6d 6f up as much memo
74e0: 72 79 20 61 73 20 70 6f 73 73 69 62 6c 65 2e 0a ry as possible..
74f0: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 */.static void p
7500: 63 61 63 68 65 31 53 68 72 69 6e 6b 28 73 71 6c cache1Shrink(sql
7510: 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 29 7b ite3_pcache *p){
7520: 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 . PCache1 *pCac
7530: 68 65 20 3d 20 28 50 43 61 63 68 65 31 2a 29 70 he = (PCache1*)p
7540: 3b 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e ;. if( pCache->
7550: 62 50 75 72 67 65 61 62 6c 65 20 29 7b 0a 20 20 bPurgeable ){.
7560: 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 70 PGroup *pGroup
7570: 20 3d 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 = pCache->pGrou
7580: 70 3b 0a 20 20 20 20 69 6e 74 20 73 61 76 65 64 p;. int saved
7590: 4d 61 78 50 61 67 65 3b 0a 20 20 20 20 70 63 61 MaxPage;. pca
75a0: 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70 che1EnterMutex(p
75b0: 47 72 6f 75 70 29 3b 0a 20 20 20 20 73 61 76 65 Group);. save
75c0: 64 4d 61 78 50 61 67 65 20 3d 20 70 47 72 6f 75 dMaxPage = pGrou
75d0: 70 2d 3e 6e 4d 61 78 50 61 67 65 3b 0a 20 20 20 p->nMaxPage;.
75e0: 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 pGroup->nMaxPag
75f0: 65 20 3d 20 30 3b 0a 20 20 20 20 70 63 61 63 68 e = 0;. pcach
7600: 65 31 45 6e 66 6f 72 63 65 4d 61 78 50 61 67 65 e1EnforceMaxPage
7610: 28 70 43 61 63 68 65 29 3b 0a 20 20 20 20 70 47 (pCache);. pG
7620: 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 3d roup->nMaxPage =
7630: 20 73 61 76 65 64 4d 61 78 50 61 67 65 3b 0a 20 savedMaxPage;.
7640: 20 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d pcache1LeaveM
7650: 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20 20 utex(pGroup);.
7660: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 }.}../*.** Imple
7670: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 mentation of the
7680: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e sqlite3_pcache.
7690: 78 50 61 67 65 63 6f 75 6e 74 20 6d 65 74 68 6f xPagecount metho
76a0: 64 2e 20 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e d. .*/.static in
76b0: 74 20 70 63 61 63 68 65 31 50 61 67 65 63 6f 75 t pcache1Pagecou
76c0: 6e 74 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 nt(sqlite3_pcach
76d0: 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 6e 3b 0a e *p){. int n;.
76e0: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 PCache1 *pCach
76f0: 65 20 3d 20 28 50 43 61 63 68 65 31 2a 29 70 3b e = (PCache1*)p;
7700: 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d . pcache1EnterM
7710: 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72 utex(pCache->pGr
7720: 6f 75 70 29 3b 0a 20 20 6e 20 3d 20 70 43 61 63 oup);. n = pCac
7730: 68 65 2d 3e 6e 50 61 67 65 3b 0a 20 20 70 63 61 he->nPage;. pca
7740: 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70 che1LeaveMutex(p
7750: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a Cache->pGroup);.
7760: 20 20 72 65 74 75 72 6e 20 6e 3b 0a 7d 0a 0a 0a return n;.}...
7770: 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 20 /*.** Implement
7780: 73 74 65 70 73 20 33 2c 20 34 2c 20 61 6e 64 20 steps 3, 4, and
7790: 35 20 6f 66 20 74 68 65 20 70 63 61 63 68 65 31 5 of the pcache1
77a0: 46 65 74 63 68 28 29 20 61 6c 67 6f 72 69 74 68 Fetch() algorith
77b0: 6d 20 64 65 73 63 72 69 62 65 64 0a 2a 2a 20 69 m described.** i
77c0: 6e 20 74 68 65 20 68 65 61 64 65 72 20 6f 66 20 n the header of
77d0: 74 68 65 20 70 63 61 63 68 65 31 46 65 74 63 68 the pcache1Fetch
77e0: 28 29 20 70 72 6f 63 65 64 75 72 65 2e 0a 2a 2a () procedure..**
77f0: 0a 2a 2a 20 54 68 69 73 20 73 74 65 70 73 20 61 .** This steps a
7800: 72 65 20 62 72 6f 6b 65 6e 20 6f 75 74 20 69 6e re broken out in
7810: 74 6f 20 61 20 73 65 70 61 72 61 74 65 20 70 72 to a separate pr
7820: 6f 63 65 64 75 72 65 20 62 65 63 61 75 73 65 20 ocedure because
7830: 74 68 65 79 20 61 72 65 0a 2a 2a 20 75 73 75 61 they are.** usua
7840: 6c 6c 79 20 6e 6f 74 20 6e 65 65 64 65 64 2c 20 lly not needed,
7850: 61 6e 64 20 62 79 20 61 76 6f 69 64 69 6e 67 20 and by avoiding
7860: 74 68 65 20 73 74 61 63 6b 20 69 6e 69 74 69 61 the stack initia
7870: 6c 69 7a 61 74 69 6f 6e 20 72 65 71 75 69 72 65 lization require
7880: 64 0a 2a 2a 20 66 6f 72 20 74 68 65 73 65 20 73 d.** for these s
7890: 74 65 70 73 2c 20 74 68 65 20 6d 61 69 6e 20 70 teps, the main p
78a0: 63 61 63 68 65 31 46 65 74 63 68 28 29 20 70 72 cache1Fetch() pr
78b0: 6f 63 65 64 75 72 65 20 63 61 6e 20 72 75 6e 20 ocedure can run
78c0: 66 61 73 74 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 faster..*/.stati
78d0: 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e c SQLITE_NOINLIN
78e0: 45 20 50 67 48 64 72 31 20 2a 70 63 61 63 68 65 E PgHdr1 *pcache
78f0: 31 46 65 74 63 68 53 74 61 67 65 32 28 0a 20 20 1FetchStage2(.
7900: 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 2c PCache1 *pCache,
7910: 20 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 . unsigned int
7920: 20 69 4b 65 79 2c 20 0a 20 20 69 6e 74 20 63 72 iKey, . int cr
7930: 65 61 74 65 46 6c 61 67 0a 29 7b 0a 20 20 75 6e eateFlag.){. un
7940: 73 69 67 6e 65 64 20 69 6e 74 20 6e 50 69 6e 6e signed int nPinn
7950: 65 64 3b 0a 20 20 50 47 72 6f 75 70 20 2a 70 47 ed;. PGroup *pG
7960: 72 6f 75 70 20 3d 20 70 43 61 63 68 65 2d 3e 70 roup = pCache->p
7970: 47 72 6f 75 70 3b 0a 20 20 50 67 48 64 72 31 20 Group;. PgHdr1
7980: 2a 70 50 61 67 65 20 3d 20 30 3b 0a 0a 20 20 2f *pPage = 0;.. /
7990: 2a 20 53 74 65 70 20 33 3a 20 41 62 6f 72 74 20 * Step 3: Abort
79a0: 69 66 20 63 72 65 61 74 65 46 6c 61 67 20 69 73 if createFlag is
79b0: 20 31 20 62 75 74 20 74 68 65 20 63 61 63 68 65 1 but the cache
79c0: 20 69 73 20 6e 65 61 72 6c 79 20 66 75 6c 6c 20 is nearly full
79d0: 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 */. assert( pCa
79e0: 63 68 65 2d 3e 6e 50 61 67 65 20 3e 3d 20 70 43 che->nPage >= pC
79f0: 61 63 68 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c ache->nRecyclabl
7a00: 65 20 29 3b 0a 20 20 6e 50 69 6e 6e 65 64 20 3d e );. nPinned =
7a10: 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 20 2d pCache->nPage -
7a20: 20 70 43 61 63 68 65 2d 3e 6e 52 65 63 79 63 6c pCache->nRecycl
7a30: 61 62 6c 65 3b 0a 20 20 61 73 73 65 72 74 28 20 able;. assert(
7a40: 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 pGroup->mxPinned
7a50: 20 3d 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 == pGroup->nMax
7a60: 50 61 67 65 20 2b 20 31 30 20 2d 20 70 47 72 6f Page + 10 - pGro
7a70: 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 20 29 3b 0a up->nMinPage );.
7a80: 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65 assert( pCache
7a90: 2d 3e 6e 39 30 70 63 74 20 3d 3d 20 70 43 61 63 ->n90pct == pCac
7aa0: 68 65 2d 3e 6e 4d 61 78 2a 39 2f 31 30 20 29 3b he->nMax*9/10 );
7ab0: 0a 20 20 69 66 28 20 63 72 65 61 74 65 46 6c 61 . if( createFla
7ac0: 67 3d 3d 31 20 26 26 20 28 0a 20 20 20 20 20 20 g==1 && (.
7ad0: 20 20 6e 50 69 6e 6e 65 64 3e 3d 70 47 72 6f 75 nPinned>=pGrou
7ae0: 70 2d 3e 6d 78 50 69 6e 6e 65 64 0a 20 20 20 20 p->mxPinned.
7af0: 20 7c 7c 20 6e 50 69 6e 6e 65 64 3e 3d 70 43 61 || nPinned>=pCa
7b00: 63 68 65 2d 3e 6e 39 30 70 63 74 0a 20 20 20 20 che->n90pct.
7b10: 20 7c 7c 20 28 70 63 61 63 68 65 31 55 6e 64 65 || (pcache1Unde
7b20: 72 4d 65 6d 6f 72 79 50 72 65 73 73 75 72 65 28 rMemoryPressure(
7b30: 70 43 61 63 68 65 29 20 26 26 20 70 43 61 63 68 pCache) && pCach
7b40: 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65 3c 6e e->nRecyclable<n
7b50: 50 69 6e 6e 65 64 29 0a 20 20 29 29 7b 0a 20 20 Pinned). )){.
7b60: 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a return 0;. }.
7b70: 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e 6e . if( pCache->n
7b80: 50 61 67 65 3e 3d 70 43 61 63 68 65 2d 3e 6e 48 Page>=pCache->nH
7b90: 61 73 68 20 29 20 70 63 61 63 68 65 31 52 65 73 ash ) pcache1Res
7ba0: 69 7a 65 48 61 73 68 28 70 43 61 63 68 65 29 3b izeHash(pCache);
7bb0: 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68 . assert( pCach
7bc0: 65 2d 3e 6e 48 61 73 68 3e 30 20 26 26 20 70 43 e->nHash>0 && pC
7bd0: 61 63 68 65 2d 3e 61 70 48 61 73 68 20 29 3b 0a ache->apHash );.
7be0: 0a 20 20 2f 2a 20 53 74 65 70 20 34 2e 20 54 72 . /* Step 4. Tr
7bf0: 79 20 74 6f 20 72 65 63 79 63 6c 65 20 61 20 70 y to recycle a p
7c00: 61 67 65 2e 20 2a 2f 0a 20 20 69 66 28 20 70 43 age. */. if( pC
7c10: 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 ache->bPurgeable
7c20: 0a 20 20 20 26 26 20 21 70 47 72 6f 75 70 2d 3e . && !pGroup->
7c30: 6c 72 75 2e 70 4c 72 75 50 72 65 76 2d 3e 69 73 lru.pLruPrev->is
7c40: 41 6e 63 68 6f 72 0a 20 20 20 26 26 20 28 28 70 Anchor. && ((p
7c50: 43 61 63 68 65 2d 3e 6e 50 61 67 65 2b 31 3e 3d Cache->nPage+1>=
7c60: 70 43 61 63 68 65 2d 3e 6e 4d 61 78 29 20 7c 7c pCache->nMax) ||
7c70: 20 70 63 61 63 68 65 31 55 6e 64 65 72 4d 65 6d pcache1UnderMem
7c80: 6f 72 79 50 72 65 73 73 75 72 65 28 70 43 61 63 oryPressure(pCac
7c90: 68 65 29 29 0a 20 20 29 7b 0a 20 20 20 20 50 43 he)). ){. PC
7ca0: 61 63 68 65 31 20 2a 70 4f 74 68 65 72 3b 0a 20 ache1 *pOther;.
7cb0: 20 20 20 70 50 61 67 65 20 3d 20 70 47 72 6f 75 pPage = pGrou
7cc0: 70 2d 3e 6c 72 75 2e 70 4c 72 75 50 72 65 76 3b p->lru.pLruPrev;
7cd0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 50 41 47 . assert( PAG
7ce0: 45 5f 49 53 5f 55 4e 50 49 4e 4e 45 44 28 70 50 E_IS_UNPINNED(pP
7cf0: 61 67 65 29 20 29 3b 0a 20 20 20 20 70 63 61 63 age) );. pcac
7d00: 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73 he1RemoveFromHas
7d10: 68 28 70 50 61 67 65 2c 20 30 29 3b 0a 20 20 20 h(pPage, 0);.
7d20: 20 70 63 61 63 68 65 31 50 69 6e 50 61 67 65 28 pcache1PinPage(
7d30: 70 50 61 67 65 29 3b 0a 20 20 20 20 70 4f 74 68 pPage);. pOth
7d40: 65 72 20 3d 20 70 50 61 67 65 2d 3e 70 43 61 63 er = pPage->pCac
7d50: 68 65 3b 0a 20 20 20 20 69 66 28 20 70 4f 74 68 he;. if( pOth
7d60: 65 72 2d 3e 73 7a 41 6c 6c 6f 63 20 21 3d 20 70 er->szAlloc != p
7d70: 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63 20 29 Cache->szAlloc )
7d80: 7b 0a 20 20 20 20 20 20 70 63 61 63 68 65 31 46 {. pcache1F
7d90: 72 65 65 50 61 67 65 28 70 50 61 67 65 29 3b 0a reePage(pPage);.
7da0: 20 20 20 20 20 20 70 50 61 67 65 20 3d 20 30 3b pPage = 0;
7db0: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
7dc0: 20 20 70 47 72 6f 75 70 2d 3e 6e 50 75 72 67 65 pGroup->nPurge
7dd0: 61 62 6c 65 20 2d 3d 20 28 70 4f 74 68 65 72 2d able -= (pOther-
7de0: 3e 62 50 75 72 67 65 61 62 6c 65 20 2d 20 70 43 >bPurgeable - pC
7df0: 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 ache->bPurgeable
7e00: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 );. }. }..
7e10: 2f 2a 20 53 74 65 70 20 35 2e 20 49 66 20 61 20 /* Step 5. If a
7e20: 75 73 61 62 6c 65 20 70 61 67 65 20 62 75 66 66 usable page buff
7e30: 65 72 20 68 61 73 20 73 74 69 6c 6c 20 6e 6f 74 er has still not
7e40: 20 62 65 65 6e 20 66 6f 75 6e 64 2c 20 0a 20 20 been found, .
7e50: 2a 2a 20 61 74 74 65 6d 70 74 20 74 6f 20 61 6c ** attempt to al
7e60: 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 6f 6e 65 locate a new one
7e70: 2e 20 0a 20 20 2a 2f 0a 20 20 69 66 28 20 21 70 . . */. if( !p
7e80: 50 61 67 65 20 29 7b 0a 20 20 20 20 70 50 61 67 Page ){. pPag
7e90: 65 20 3d 20 70 63 61 63 68 65 31 41 6c 6c 6f 63 e = pcache1Alloc
7ea0: 50 61 67 65 28 70 43 61 63 68 65 2c 20 63 72 65 Page(pCache, cre
7eb0: 61 74 65 46 6c 61 67 3d 3d 31 29 3b 0a 20 20 7d ateFlag==1);. }
7ec0: 0a 0a 20 20 69 66 28 20 70 50 61 67 65 20 29 7b .. if( pPage ){
7ed0: 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20 69 6e . unsigned in
7ee0: 74 20 68 20 3d 20 69 4b 65 79 20 25 20 70 43 61 t h = iKey % pCa
7ef0: 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 20 20 che->nHash;.
7f00: 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 2b 2b 3b pCache->nPage++;
7f10: 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 4b 65 79 . pPage->iKey
7f20: 20 3d 20 69 4b 65 79 3b 0a 20 20 20 20 70 50 61 = iKey;. pPa
7f30: 67 65 2d 3e 70 4e 65 78 74 20 3d 20 70 43 61 63 ge->pNext = pCac
7f40: 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 3b 0a 20 he->apHash[h];.
7f50: 20 20 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65 pPage->pCache
7f60: 20 3d 20 70 43 61 63 68 65 3b 0a 20 20 20 20 70 = pCache;. p
7f70: 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74 20 3d Page->pLruNext =
7f80: 20 30 3b 0a 20 20 20 20 2f 2a 20 70 50 61 67 65 0;. /* pPage
7f90: 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20 30 3b 0a ->pLruPrev = 0;.
7fa0: 20 20 20 20 2a 2a 20 4e 6f 20 6e 65 65 64 20 74 ** No need t
7fb0: 6f 20 63 6c 65 61 72 20 70 4c 72 75 50 72 65 76 o clear pLruPrev
7fc0: 20 73 69 6e 63 65 20 69 74 20 69 73 20 6e 6f 74 since it is not
7fd0: 20 61 63 63 65 73 73 65 64 20 77 68 65 6e 20 70 accessed when p
7fe0: 4c 72 75 4e 65 78 74 3d 3d 30 20 2a 2f 0a 20 20 LruNext==0 */.
7ff0: 20 20 2a 28 76 6f 69 64 20 2a 2a 29 70 50 61 67 *(void **)pPag
8000: 65 2d 3e 70 61 67 65 2e 70 45 78 74 72 61 20 3d e->page.pExtra =
8010: 20 30 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 0;. pCache->
8020: 61 70 48 61 73 68 5b 68 5d 20 3d 20 70 50 61 67 apHash[h] = pPag
8030: 65 3b 0a 20 20 20 20 69 66 28 20 69 4b 65 79 3e e;. if( iKey>
8040: 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 pCache->iMaxKey
8050: 29 7b 0a 20 20 20 20 20 20 70 43 61 63 68 65 2d ){. pCache-
8060: 3e 69 4d 61 78 4b 65 79 20 3d 20 69 4b 65 79 3b >iMaxKey = iKey;
8070: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 . }. }. ret
8080: 75 72 6e 20 70 50 61 67 65 3b 0a 7d 0a 0a 2f 2a urn pPage;.}../*
8090: 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 .** Implementati
80a0: 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 on of the sqlite
80b0: 33 5f 70 63 61 63 68 65 2e 78 46 65 74 63 68 20 3_pcache.xFetch
80c0: 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 46 method. .**.** F
80d0: 65 74 63 68 20 61 20 70 61 67 65 20 62 79 20 6b etch a page by k
80e0: 65 79 20 76 61 6c 75 65 2e 0a 2a 2a 0a 2a 2a 20 ey value..**.**
80f0: 57 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 61 Whether or not a
8100: 20 6e 65 77 20 70 61 67 65 20 6d 61 79 20 62 65 new page may be
8110: 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 20 74 68 allocated by th
8120: 69 73 20 66 75 6e 63 74 69 6f 6e 20 64 65 70 65 is function depe
8130: 6e 64 73 20 6f 6e 0a 2a 2a 20 74 68 65 20 76 61 nds on.** the va
8140: 6c 75 65 20 6f 66 20 74 68 65 20 63 72 65 61 74 lue of the creat
8150: 65 46 6c 61 67 20 61 72 67 75 6d 65 6e 74 2e 20 eFlag argument.
8160: 20 30 20 6d 65 61 6e 73 20 64 6f 20 6e 6f 74 20 0 means do not
8170: 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 0a 2a allocate a new.*
8180: 2a 20 70 61 67 65 2e 20 20 31 20 6d 65 61 6e 73 * page. 1 means
8190: 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 allocate a new
81a0: 70 61 67 65 20 69 66 20 73 70 61 63 65 20 69 73 page if space is
81b0: 20 65 61 73 69 6c 79 20 61 76 61 69 6c 61 62 6c easily availabl
81c0: 65 2e 20 20 32 20 0a 2a 2a 20 6d 65 61 6e 73 20 e. 2 .** means
81d0: 74 6f 20 74 72 79 20 72 65 61 6c 6c 79 20 68 61 to try really ha
81e0: 72 64 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 61 rd to allocate a
81f0: 20 6e 65 77 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a new page..**.**
8200: 20 46 6f 72 20 61 20 6e 6f 6e 2d 70 75 72 67 65 For a non-purge
8210: 61 62 6c 65 20 63 61 63 68 65 20 28 61 20 63 61 able cache (a ca
8220: 63 68 65 20 75 73 65 64 20 61 73 20 74 68 65 20 che used as the
8230: 73 74 6f 72 61 67 65 20 66 6f 72 20 61 6e 20 69 storage for an i
8240: 6e 2d 6d 65 6d 6f 72 79 0a 2a 2a 20 64 61 74 61 n-memory.** data
8250: 62 61 73 65 29 20 74 68 65 72 65 20 69 73 20 72 base) there is r
8260: 65 61 6c 6c 79 20 6e 6f 20 64 69 66 66 65 72 65 eally no differe
8270: 6e 63 65 20 62 65 74 77 65 65 6e 20 63 72 65 61 nce between crea
8280: 74 65 46 6c 61 67 20 31 20 61 6e 64 20 32 2e 20 teFlag 1 and 2.
8290: 20 53 6f 0a 2a 2a 20 74 68 65 20 63 61 6c 6c 69 So.** the calli
82a0: 6e 67 20 66 75 6e 63 74 69 6f 6e 20 28 70 63 61 ng function (pca
82b0: 63 68 65 2e 63 29 20 77 69 6c 6c 20 6e 65 76 65 che.c) will neve
82c0: 72 20 68 61 76 65 20 61 20 63 72 65 61 74 65 46 r have a createF
82d0: 6c 61 67 20 6f 66 20 31 20 6f 6e 0a 2a 2a 20 61 lag of 1 on.** a
82e0: 20 6e 6f 6e 2d 70 75 72 67 65 61 62 6c 65 20 63 non-purgeable c
82f0: 61 63 68 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 72 ache..**.** Ther
8300: 65 20 61 72 65 20 74 68 72 65 65 20 64 69 66 66 e are three diff
8310: 65 72 65 6e 74 20 61 70 70 72 6f 61 63 68 65 73 erent approaches
8320: 20 74 6f 20 6f 62 74 61 69 6e 69 6e 67 20 73 70 to obtaining sp
8330: 61 63 65 20 66 6f 72 20 61 20 70 61 67 65 2c 0a ace for a page,.
8340: 2a 2a 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 ** depending on
8350: 74 68 65 20 76 61 6c 75 65 20 6f 66 20 70 61 72 the value of par
8360: 61 6d 65 74 65 72 20 63 72 65 61 74 65 46 6c 61 ameter createFla
8370: 67 20 28 77 68 69 63 68 20 6d 61 79 20 62 65 20 g (which may be
8380: 30 2c 20 31 20 6f 72 20 32 29 2e 0a 2a 2a 0a 2a 0, 1 or 2)..**.*
8390: 2a 20 20 20 31 2e 20 52 65 67 61 72 64 6c 65 73 * 1. Regardles
83a0: 73 20 6f 66 20 74 68 65 20 76 61 6c 75 65 20 6f s of the value o
83b0: 66 20 63 72 65 61 74 65 46 6c 61 67 2c 20 74 68 f createFlag, th
83c0: 65 20 63 61 63 68 65 20 69 73 20 73 65 61 72 63 e cache is searc
83d0: 68 65 64 20 66 6f 72 20 61 20 0a 2a 2a 20 20 20 hed for a .**
83e0: 20 20 20 63 6f 70 79 20 6f 66 20 74 68 65 20 72 copy of the r
83f0: 65 71 75 65 73 74 65 64 20 70 61 67 65 2e 20 49 equested page. I
8400: 66 20 6f 6e 65 20 69 73 20 66 6f 75 6e 64 2c 20 f one is found,
8410: 69 74 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a it is returned..
8420: 2a 2a 0a 2a 2a 20 20 20 32 2e 20 49 66 20 63 72 **.** 2. If cr
8430: 65 61 74 65 46 6c 61 67 3d 3d 30 20 61 6e 64 20 eateFlag==0 and
8440: 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f 74 20 the page is not
8450: 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65 20 63 already in the c
8460: 61 63 68 65 2c 20 4e 55 4c 4c 20 69 73 0a 2a 2a ache, NULL is.**
8470: 20 20 20 20 20 20 72 65 74 75 72 6e 65 64 2e 0a returned..
8480: 2a 2a 0a 2a 2a 20 20 20 33 2e 20 49 66 20 63 72 **.** 3. If cr
8490: 65 61 74 65 46 6c 61 67 20 69 73 20 31 2c 20 61 eateFlag is 1, a
84a0: 6e 64 20 74 68 65 20 70 61 67 65 20 69 73 20 6e nd the page is n
84b0: 6f 74 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 ot already in th
84c0: 65 20 63 61 63 68 65 2c 20 74 68 65 6e 0a 2a 2a e cache, then.**
84d0: 20 20 20 20 20 20 72 65 74 75 72 6e 20 4e 55 4c return NUL
84e0: 4c 20 28 64 6f 20 6e 6f 74 20 61 6c 6c 6f 63 61 L (do not alloca
84f0: 74 65 20 61 20 6e 65 77 20 70 61 67 65 29 20 69 te a new page) i
8500: 66 20 61 6e 79 20 6f 66 20 74 68 65 20 66 6f 6c f any of the fol
8510: 6c 6f 77 69 6e 67 0a 2a 2a 20 20 20 20 20 20 63 lowing.** c
8520: 6f 6e 64 69 74 69 6f 6e 73 20 61 72 65 20 74 72 onditions are tr
8530: 75 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 ue:.**.**
8540: 28 61 29 20 74 68 65 20 6e 75 6d 62 65 72 20 6f (a) the number o
8550: 66 20 70 61 67 65 73 20 70 69 6e 6e 65 64 20 62 f pages pinned b
8560: 79 20 74 68 65 20 63 61 63 68 65 20 69 73 20 67 y the cache is g
8570: 72 65 61 74 65 72 20 74 68 61 6e 0a 2a 2a 20 20 reater than.**
8580: 20 20 20 20 20 20 20 20 20 50 43 61 63 68 65 31 PCache1
8590: 2e 6e 4d 61 78 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 .nMax, or.**.**
85a0: 20 20 20 20 20 20 28 62 29 20 74 68 65 20 6e 75 (b) the nu
85b0: 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 70 69 mber of pages pi
85c0: 6e 6e 65 64 20 62 79 20 74 68 65 20 63 61 63 68 nned by the cach
85d0: 65 20 69 73 20 67 72 65 61 74 65 72 20 74 68 61 e is greater tha
85e0: 6e 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 74 n.** t
85f0: 68 65 20 73 75 6d 20 6f 66 20 6e 4d 61 78 20 66 he sum of nMax f
8600: 6f 72 20 61 6c 6c 20 70 75 72 67 65 61 62 6c 65 or all purgeable
8610: 20 63 61 63 68 65 73 2c 20 6c 65 73 73 20 74 68 caches, less th
8620: 65 20 73 75 6d 20 6f 66 20 0a 2a 2a 20 20 20 20 e sum of .**
8630: 20 20 20 20 20 20 20 6e 4d 69 6e 20 66 6f 72 20 nMin for
8640: 61 6c 6c 20 6f 74 68 65 72 20 70 75 72 67 65 61 all other purgea
8650: 62 6c 65 20 63 61 63 68 65 73 2c 20 6f 72 0a 2a ble caches, or.*
8660: 2a 0a 2a 2a 20 20 20 34 2e 20 49 66 20 6e 6f 6e *.** 4. If non
8670: 65 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 74 e of the first t
8680: 68 72 65 65 20 63 6f 6e 64 69 74 69 6f 6e 73 20 hree conditions
8690: 61 70 70 6c 79 20 61 6e 64 20 74 68 65 20 63 61 apply and the ca
86a0: 63 68 65 20 69 73 20 6d 61 72 6b 65 64 0a 2a 2a che is marked.**
86b0: 20 20 20 20 20 20 61 73 20 70 75 72 67 65 61 62 as purgeab
86c0: 6c 65 2c 20 61 6e 64 20 69 66 20 6f 6e 65 20 6f le, and if one o
86d0: 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 f the following
86e0: 69 73 20 74 72 75 65 3a 0a 2a 2a 0a 2a 2a 20 20 is true:.**.**
86f0: 20 20 20 20 20 28 61 29 20 54 68 65 20 6e 75 6d (a) The num
8700: 62 65 72 20 6f 66 20 70 61 67 65 73 20 61 6c 6c ber of pages all
8710: 6f 63 61 74 65 64 20 66 6f 72 20 74 68 65 20 63 ocated for the c
8720: 61 63 68 65 20 69 73 20 61 6c 72 65 61 64 79 20 ache is already
8730: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 50 43 .** PC
8740: 61 63 68 65 31 2e 6e 4d 61 78 2c 20 6f 72 0a 2a ache1.nMax, or.*
8750: 2a 0a 2a 2a 20 20 20 20 20 20 20 28 62 29 20 54 *.** (b) T
8760: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 he number of pag
8770: 65 73 20 61 6c 6c 6f 63 61 74 65 64 20 66 6f 72 es allocated for
8780: 20 61 6c 6c 20 70 75 72 67 65 61 62 6c 65 20 63 all purgeable c
8790: 61 63 68 65 73 20 69 73 0a 2a 2a 20 20 20 20 20 aches is.**
87a0: 20 20 20 20 20 20 61 6c 72 65 61 64 79 20 65 71 already eq
87b0: 75 61 6c 20 74 6f 20 6f 72 20 67 72 65 61 74 65 ual to or greate
87c0: 72 20 74 68 61 6e 20 74 68 65 20 73 75 6d 20 6f r than the sum o
87d0: 66 20 6e 4d 61 78 20 66 6f 72 20 61 6c 6c 0a 2a f nMax for all.*
87e0: 2a 20 20 20 20 20 20 20 20 20 20 20 70 75 72 67 * purg
87f0: 65 61 62 6c 65 20 63 61 63 68 65 73 2c 0a 2a 2a eable caches,.**
8800: 0a 2a 2a 20 20 20 20 20 20 20 28 63 29 20 54 68 .** (c) Th
8810: 65 20 73 79 73 74 65 6d 20 69 73 20 75 6e 64 65 e system is unde
8820: 72 20 6d 65 6d 6f 72 79 20 70 72 65 73 73 75 72 r memory pressur
8830: 65 20 61 6e 64 20 77 61 6e 74 73 20 74 6f 20 61 e and wants to a
8840: 76 6f 69 64 0a 2a 2a 20 20 20 20 20 20 20 20 20 void.**
8850: 20 20 75 6e 6e 65 63 65 73 73 61 72 79 20 70 61 unnecessary pa
8860: 67 65 73 20 63 61 63 68 65 20 65 6e 74 72 79 20 ges cache entry
8870: 61 6c 6c 6f 63 61 74 69 6f 6e 73 0a 2a 2a 0a 2a allocations.**.*
8880: 2a 20 20 20 20 20 20 74 68 65 6e 20 61 74 74 65 * then atte
8890: 6d 70 74 20 74 6f 20 72 65 63 79 63 6c 65 20 61 mpt to recycle a
88a0: 20 70 61 67 65 20 66 72 6f 6d 20 74 68 65 20 4c page from the L
88b0: 52 55 20 6c 69 73 74 2e 20 49 66 20 69 74 20 69 RU list. If it i
88c0: 73 20 74 68 65 20 72 69 67 68 74 0a 2a 2a 20 20 s the right.**
88d0: 20 20 20 20 73 69 7a 65 2c 20 72 65 74 75 72 6e size, return
88e0: 20 74 68 65 20 72 65 63 79 63 6c 65 64 20 62 75 the recycled bu
88f0: 66 66 65 72 2e 20 4f 74 68 65 72 77 69 73 65 2c ffer. Otherwise,
8900: 20 66 72 65 65 20 74 68 65 20 62 75 66 66 65 72 free the buffer
8910: 20 61 6e 64 0a 2a 2a 20 20 20 20 20 20 70 72 6f and.** pro
8920: 63 65 65 64 20 74 6f 20 73 74 65 70 20 35 2e 20 ceed to step 5.
8930: 0a 2a 2a 0a 2a 2a 20 20 20 35 2e 20 4f 74 68 65 .**.** 5. Othe
8940: 72 77 69 73 65 2c 20 61 6c 6c 6f 63 61 74 65 20 rwise, allocate
8950: 61 6e 64 20 72 65 74 75 72 6e 20 61 20 6e 65 77 and return a new
8960: 20 70 61 67 65 20 62 75 66 66 65 72 2e 0a 2a 2a page buffer..**
8970: 0a 2a 2a 20 54 68 65 72 65 20 61 72 65 20 74 77 .** There are tw
8980: 6f 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 74 68 o versions of th
8990: 69 73 20 72 6f 75 74 69 6e 65 2e 20 20 70 63 61 is routine. pca
89a0: 63 68 65 31 46 65 74 63 68 57 69 74 68 4d 75 74 che1FetchWithMut
89b0: 65 78 28 29 20 69 73 0a 2a 2a 20 74 68 65 20 67 ex() is.** the g
89c0: 65 6e 65 72 61 6c 20 63 61 73 65 2e 20 20 70 63 eneral case. pc
89d0: 61 63 68 65 31 46 65 74 63 68 4e 6f 4d 75 74 65 ache1FetchNoMute
89e0: 78 28 29 20 69 73 20 61 20 66 61 73 74 65 72 20 x() is a faster
89f0: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 66 implementation f
8a00: 6f 72 0a 2a 2a 20 74 68 65 20 63 6f 6d 6d 6f 6e or.** the common
8a10: 20 63 61 73 65 20 77 68 65 72 65 20 70 47 72 6f case where pGro
8a20: 75 70 2d 3e 6d 75 74 65 78 20 69 73 20 4e 55 4c up->mutex is NUL
8a30: 4c 2e 20 20 54 68 65 20 70 63 61 63 68 65 31 46 L. The pcache1F
8a40: 65 74 63 68 28 29 20 77 72 61 70 70 65 72 0a 2a etch() wrapper.*
8a50: 2a 20 69 6e 76 6f 6b 65 73 20 74 68 65 20 61 70 * invokes the ap
8a60: 70 72 6f 70 72 69 61 74 65 20 72 6f 75 74 69 6e propriate routin
8a70: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67 48 e..*/.static PgH
8a80: 64 72 31 20 2a 70 63 61 63 68 65 31 46 65 74 63 dr1 *pcache1Fetc
8a90: 68 4e 6f 4d 75 74 65 78 28 0a 20 20 73 71 6c 69 hNoMutex(. sqli
8aa0: 74 65 33 5f 70 63 61 63 68 65 20 2a 70 2c 20 0a te3_pcache *p, .
8ab0: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 unsigned int i
8ac0: 4b 65 79 2c 20 0a 20 20 69 6e 74 20 63 72 65 61 Key, . int crea
8ad0: 74 65 46 6c 61 67 0a 29 7b 0a 20 20 50 43 61 63 teFlag.){. PCac
8ae0: 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50 he1 *pCache = (P
8af0: 43 61 63 68 65 31 20 2a 29 70 3b 0a 20 20 50 67 Cache1 *)p;. Pg
8b00: 48 64 72 31 20 2a 70 50 61 67 65 20 3d 20 30 3b Hdr1 *pPage = 0;
8b10: 0a 0a 20 20 2f 2a 20 53 74 65 70 20 31 3a 20 53 .. /* Step 1: S
8b20: 65 61 72 63 68 20 74 68 65 20 68 61 73 68 20 74 earch the hash t
8b30: 61 62 6c 65 20 66 6f 72 20 61 6e 20 65 78 69 73 able for an exis
8b40: 74 69 6e 67 20 65 6e 74 72 79 2e 20 2a 2f 0a 20 ting entry. */.
8b50: 20 70 50 61 67 65 20 3d 20 70 43 61 63 68 65 2d pPage = pCache-
8b60: 3e 61 70 48 61 73 68 5b 69 4b 65 79 20 25 20 70 >apHash[iKey % p
8b70: 43 61 63 68 65 2d 3e 6e 48 61 73 68 5d 3b 0a 20 Cache->nHash];.
8b80: 20 77 68 69 6c 65 28 20 70 50 61 67 65 20 26 26 while( pPage &&
8b90: 20 70 50 61 67 65 2d 3e 69 4b 65 79 21 3d 69 4b pPage->iKey!=iK
8ba0: 65 79 20 29 7b 20 70 50 61 67 65 20 3d 20 70 50 ey ){ pPage = pP
8bb0: 61 67 65 2d 3e 70 4e 65 78 74 3b 20 7d 0a 0a 20 age->pNext; }..
8bc0: 20 2f 2a 20 53 74 65 70 20 32 3a 20 49 66 20 74 /* Step 2: If t
8bd0: 68 65 20 70 61 67 65 20 77 61 73 20 66 6f 75 6e he page was foun
8be0: 64 20 69 6e 20 74 68 65 20 68 61 73 68 20 74 61 d in the hash ta
8bf0: 62 6c 65 2c 20 74 68 65 6e 20 72 65 74 75 72 6e ble, then return
8c00: 20 69 74 2e 0a 20 20 2a 2a 20 49 66 20 74 68 65 it.. ** If the
8c10: 20 70 61 67 65 20 77 61 73 20 6e 6f 74 20 69 6e page was not in
8c20: 20 74 68 65 20 68 61 73 68 20 74 61 62 6c 65 20 the hash table
8c30: 61 6e 64 20 63 72 65 61 74 65 46 6c 61 67 20 69 and createFlag i
8c40: 73 20 30 2c 20 61 62 6f 72 74 2e 0a 20 20 2a 2a s 0, abort.. **
8c50: 20 4f 74 68 65 72 77 69 73 65 20 28 70 61 67 65 Otherwise (page
8c60: 20 6e 6f 74 20 69 6e 20 68 61 73 68 20 61 6e 64 not in hash and
8c70: 20 63 72 65 61 74 65 46 6c 61 67 21 3d 30 29 20 createFlag!=0)
8c80: 63 6f 6e 74 69 6e 75 65 20 77 69 74 68 0a 20 20 continue with.
8c90: 2a 2a 20 73 75 62 73 65 71 75 65 6e 74 20 73 74 ** subsequent st
8ca0: 65 70 73 20 74 6f 20 74 72 79 20 74 6f 20 63 72 eps to try to cr
8cb0: 65 61 74 65 20 74 68 65 20 70 61 67 65 2e 20 2a eate the page. *
8cc0: 2f 0a 20 20 69 66 28 20 70 50 61 67 65 20 29 7b /. if( pPage ){
8cd0: 0a 20 20 20 20 69 66 28 20 50 41 47 45 5f 49 53 . if( PAGE_IS
8ce0: 5f 55 4e 50 49 4e 4e 45 44 28 70 50 61 67 65 29 _UNPINNED(pPage)
8cf0: 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e ){. return
8d00: 20 70 63 61 63 68 65 31 50 69 6e 50 61 67 65 28 pcache1PinPage(
8d10: 70 50 61 67 65 29 3b 0a 20 20 20 20 7d 65 6c 73 pPage);. }els
8d20: 65 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 e{. return
8d30: 70 50 61 67 65 3b 0a 20 20 20 20 7d 0a 20 20 7d pPage;. }. }
8d40: 65 6c 73 65 20 69 66 28 20 63 72 65 61 74 65 46 else if( createF
8d50: 6c 61 67 20 29 7b 0a 20 20 20 20 2f 2a 20 53 74 lag ){. /* St
8d60: 65 70 73 20 33 2c 20 34 2c 20 61 6e 64 20 35 20 eps 3, 4, and 5
8d70: 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62 79 20 74 implemented by t
8d80: 68 69 73 20 73 75 62 72 6f 75 74 69 6e 65 20 2a his subroutine *
8d90: 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 70 63 61 /. return pca
8da0: 63 68 65 31 46 65 74 63 68 53 74 61 67 65 32 28 che1FetchStage2(
8db0: 70 43 61 63 68 65 2c 20 69 4b 65 79 2c 20 63 72 pCache, iKey, cr
8dc0: 65 61 74 65 46 6c 61 67 29 3b 0a 20 20 7d 65 6c eateFlag);. }el
8dd0: 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 se{. return 0
8de0: 3b 0a 20 20 7d 0a 7d 0a 23 69 66 20 50 43 41 43 ;. }.}.#if PCAC
8df0: 48 45 31 5f 4d 49 47 48 54 5f 55 53 45 5f 47 52 HE1_MIGHT_USE_GR
8e00: 4f 55 50 5f 4d 55 54 45 58 0a 73 74 61 74 69 63 OUP_MUTEX.static
8e10: 20 50 67 48 64 72 31 20 2a 70 63 61 63 68 65 31 PgHdr1 *pcache1
8e20: 46 65 74 63 68 57 69 74 68 4d 75 74 65 78 28 0a FetchWithMutex(.
8e30: 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 sqlite3_pcache
8e40: 20 2a 70 2c 20 0a 20 20 75 6e 73 69 67 6e 65 64 *p, . unsigned
8e50: 20 69 6e 74 20 69 4b 65 79 2c 20 0a 20 20 69 6e int iKey, . in
8e60: 74 20 63 72 65 61 74 65 46 6c 61 67 0a 29 7b 0a t createFlag.){.
8e70: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 PCache1 *pCach
8e80: 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 e = (PCache1 *)p
8e90: 3b 0a 20 20 50 67 48 64 72 31 20 2a 70 50 61 67 ;. PgHdr1 *pPag
8ea0: 65 3b 0a 0a 20 20 70 63 61 63 68 65 31 45 6e 74 e;.. pcache1Ent
8eb0: 65 72 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e erMutex(pCache->
8ec0: 70 47 72 6f 75 70 29 3b 0a 20 20 70 50 61 67 65 pGroup);. pPage
8ed0: 20 3d 20 70 63 61 63 68 65 31 46 65 74 63 68 4e = pcache1FetchN
8ee0: 6f 4d 75 74 65 78 28 70 2c 20 69 4b 65 79 2c 20 oMutex(p, iKey,
8ef0: 63 72 65 61 74 65 46 6c 61 67 29 3b 0a 20 20 61 createFlag);. a
8f00: 73 73 65 72 74 28 20 70 50 61 67 65 3d 3d 30 20 ssert( pPage==0
8f10: 7c 7c 20 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b || pCache->iMaxK
8f20: 65 79 3e 3d 69 4b 65 79 20 29 3b 0a 20 20 70 63 ey>=iKey );. pc
8f30: 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 ache1LeaveMutex(
8f40: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b pCache->pGroup);
8f50: 0a 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 3b . return pPage;
8f60: 0a 7d 0a 23 65 6e 64 69 66 0a 73 74 61 74 69 63 .}.#endif.static
8f70: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f sqlite3_pcache_
8f80: 70 61 67 65 20 2a 70 63 61 63 68 65 31 46 65 74 page *pcache1Fet
8f90: 63 68 28 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 ch(. sqlite3_pc
8fa0: 61 63 68 65 20 2a 70 2c 20 0a 20 20 75 6e 73 69 ache *p, . unsi
8fb0: 67 6e 65 64 20 69 6e 74 20 69 4b 65 79 2c 20 0a gned int iKey, .
8fc0: 20 20 69 6e 74 20 63 72 65 61 74 65 46 6c 61 67 int createFlag
8fd0: 0a 29 7b 0a 23 69 66 20 50 43 41 43 48 45 31 5f .){.#if PCACHE1_
8fe0: 4d 49 47 48 54 5f 55 53 45 5f 47 52 4f 55 50 5f MIGHT_USE_GROUP_
8ff0: 4d 55 54 45 58 20 7c 7c 20 64 65 66 69 6e 65 64 MUTEX || defined
9000: 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29 0a 20 (SQLITE_DEBUG).
9010: 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 PCache1 *pCache
9020: 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b = (PCache1 *)p;
9030: 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73 73 65 72 .#endif.. asser
9040: 74 28 20 6f 66 66 73 65 74 6f 66 28 50 67 48 64 t( offsetof(PgHd
9050: 72 31 2c 70 61 67 65 29 3d 3d 30 20 29 3b 0a 20 r1,page)==0 );.
9060: 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65 2d assert( pCache-
9070: 3e 62 50 75 72 67 65 61 62 6c 65 20 7c 7c 20 63 >bPurgeable || c
9080: 72 65 61 74 65 46 6c 61 67 21 3d 31 20 29 3b 0a reateFlag!=1 );.
9090: 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65 assert( pCache
90a0: 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 7c 7c 20 ->bPurgeable ||
90b0: 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 3d 3d 30 20 pCache->nMin==0
90c0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 );. assert( pCa
90d0: 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 3d che->bPurgeable=
90e0: 3d 30 20 7c 7c 20 70 43 61 63 68 65 2d 3e 6e 4d =0 || pCache->nM
90f0: 69 6e 3d 3d 31 30 20 29 3b 0a 20 20 61 73 73 65 in==10 );. asse
9100: 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e rt( pCache->nMin
9110: 3d 3d 30 20 7c 7c 20 70 43 61 63 68 65 2d 3e 62 ==0 || pCache->b
9120: 50 75 72 67 65 61 62 6c 65 20 29 3b 0a 20 20 61 Purgeable );. a
9130: 73 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 6e ssert( pCache->n
9140: 48 61 73 68 3e 30 20 29 3b 0a 23 69 66 20 50 43 Hash>0 );.#if PC
9150: 41 43 48 45 31 5f 4d 49 47 48 54 5f 55 53 45 5f ACHE1_MIGHT_USE_
9160: 47 52 4f 55 50 5f 4d 55 54 45 58 0a 20 20 69 66 GROUP_MUTEX. if
9170: 28 20 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 ( pCache->pGroup
9180: 2d 3e 6d 75 74 65 78 20 29 7b 0a 20 20 20 20 72 ->mutex ){. r
9190: 65 74 75 72 6e 20 28 73 71 6c 69 74 65 33 5f 70 eturn (sqlite3_p
91a0: 63 61 63 68 65 5f 70 61 67 65 2a 29 70 63 61 63 cache_page*)pcac
91b0: 68 65 31 46 65 74 63 68 57 69 74 68 4d 75 74 65 he1FetchWithMute
91c0: 78 28 70 2c 20 69 4b 65 79 2c 20 63 72 65 61 74 x(p, iKey, creat
91d0: 65 46 6c 61 67 29 3b 0a 20 20 7d 65 6c 73 65 0a eFlag);. }else.
91e0: 23 65 6e 64 69 66 0a 20 20 7b 0a 20 20 20 20 72 #endif. {. r
91f0: 65 74 75 72 6e 20 28 73 71 6c 69 74 65 33 5f 70 eturn (sqlite3_p
9200: 63 61 63 68 65 5f 70 61 67 65 2a 29 70 63 61 63 cache_page*)pcac
9210: 68 65 31 46 65 74 63 68 4e 6f 4d 75 74 65 78 28 he1FetchNoMutex(
9220: 70 2c 20 69 4b 65 79 2c 20 63 72 65 61 74 65 46 p, iKey, createF
9230: 6c 61 67 29 3b 0a 20 20 7d 0a 7d 0a 0a 0a 2f 2a lag);. }.}.../*
9240: 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 .** Implementati
9250: 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 on of the sqlite
9260: 33 5f 70 63 61 63 68 65 2e 78 55 6e 70 69 6e 20 3_pcache.xUnpin
9270: 6d 65 74 68 6f 64 2e 0a 2a 2a 0a 2a 2a 20 4d 61 method..**.** Ma
9280: 72 6b 20 61 20 70 61 67 65 20 61 73 20 75 6e 70 rk a page as unp
9290: 69 6e 6e 65 64 20 28 65 6c 69 67 69 62 6c 65 20 inned (eligible
92a0: 66 6f 72 20 61 73 79 6e 63 68 72 6f 6e 6f 75 73 for asynchronous
92b0: 20 72 65 63 79 63 6c 69 6e 67 29 2e 0a 2a 2f 0a recycling)..*/.
92c0: 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 static void pcac
92d0: 68 65 31 55 6e 70 69 6e 28 0a 20 20 73 71 6c 69 he1Unpin(. sqli
92e0: 74 65 33 5f 70 63 61 63 68 65 20 2a 70 2c 20 0a te3_pcache *p, .
92f0: 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 sqlite3_pcache
9300: 5f 70 61 67 65 20 2a 70 50 67 2c 20 0a 20 20 69 _page *pPg, . i
9310: 6e 74 20 72 65 75 73 65 55 6e 6c 69 6b 65 6c 79 nt reuseUnlikely
9320: 0a 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 .){. PCache1 *p
9330: 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 65 31 Cache = (PCache1
9340: 20 2a 29 70 3b 0a 20 20 50 67 48 64 72 31 20 2a *)p;. PgHdr1 *
9350: 70 50 61 67 65 20 3d 20 28 50 67 48 64 72 31 20 pPage = (PgHdr1
9360: 2a 29 70 50 67 3b 0a 20 20 50 47 72 6f 75 70 20 *)pPg;. PGroup
9370: 2a 70 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65 *pGroup = pCache
9380: 2d 3e 70 47 72 6f 75 70 3b 0a 20 0a 20 20 61 73 ->pGroup;. . as
9390: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 43 61 sert( pPage->pCa
93a0: 63 68 65 3d 3d 70 43 61 63 68 65 20 29 3b 0a 20 che==pCache );.
93b0: 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 74 pcache1EnterMut
93c0: 65 78 28 70 47 72 6f 75 70 29 3b 0a 0a 20 20 2f ex(pGroup);.. /
93d0: 2a 20 49 74 20 69 73 20 61 6e 20 65 72 72 6f 72 * It is an error
93e0: 20 74 6f 20 63 61 6c 6c 20 74 68 69 73 20 66 75 to call this fu
93f0: 6e 63 74 69 6f 6e 20 69 66 20 74 68 65 20 70 61 nction if the pa
9400: 67 65 20 69 73 20 61 6c 72 65 61 64 79 20 0a 20 ge is already .
9410: 20 2a 2a 20 70 61 72 74 20 6f 66 20 74 68 65 20 ** part of the
9420: 50 47 72 6f 75 70 20 4c 52 55 20 6c 69 73 74 2e PGroup LRU list.
9430: 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 . */. assert(
9440: 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 74 3d pPage->pLruNext=
9450: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =0 );. assert(
9460: 50 41 47 45 5f 49 53 5f 50 49 4e 4e 45 44 28 70 PAGE_IS_PINNED(p
9470: 50 61 67 65 29 20 29 3b 0a 0a 20 20 69 66 28 20 Page) );.. if(
9480: 72 65 75 73 65 55 6e 6c 69 6b 65 6c 79 20 7c 7c reuseUnlikely ||
9490: 20 70 47 72 6f 75 70 2d 3e 6e 50 75 72 67 65 61 pGroup->nPurgea
94a0: 62 6c 65 3e 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 ble>pGroup->nMax
94b0: 50 61 67 65 20 29 7b 0a 20 20 20 20 70 63 61 63 Page ){. pcac
94c0: 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73 he1RemoveFromHas
94d0: 68 28 70 50 61 67 65 2c 20 31 29 3b 0a 20 20 7d h(pPage, 1);. }
94e0: 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 41 64 64 else{. /* Add
94f0: 20 74 68 65 20 70 61 67 65 20 74 6f 20 74 68 65 the page to the
9500: 20 50 47 72 6f 75 70 20 4c 52 55 20 6c 69 73 74 PGroup LRU list
9510: 2e 20 2a 2f 0a 20 20 20 20 50 67 48 64 72 31 20 . */. PgHdr1
9520: 2a 2a 70 70 46 69 72 73 74 20 3d 20 26 70 47 72 **ppFirst = &pGr
9530: 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72 75 4e 65 78 oup->lru.pLruNex
9540: 74 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 70 4c t;. pPage->pL
9550: 72 75 50 72 65 76 20 3d 20 26 70 47 72 6f 75 70 ruPrev = &pGroup
9560: 2d 3e 6c 72 75 3b 0a 20 20 20 20 28 70 50 61 67 ->lru;. (pPag
9570: 65 2d 3e 70 4c 72 75 4e 65 78 74 20 3d 20 2a 70 e->pLruNext = *p
9580: 70 46 69 72 73 74 29 2d 3e 70 4c 72 75 50 72 65 pFirst)->pLruPre
9590: 76 20 3d 20 70 50 61 67 65 3b 0a 20 20 20 20 2a v = pPage;. *
95a0: 70 70 46 69 72 73 74 20 3d 20 70 50 61 67 65 3b ppFirst = pPage;
95b0: 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 52 65 . pCache->nRe
95c0: 63 79 63 6c 61 62 6c 65 2b 2b 3b 0a 20 20 7d 0a cyclable++;. }.
95d0: 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d . pcache1LeaveM
95e0: 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72 utex(pCache->pGr
95f0: 6f 75 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 oup);.}../*.** I
9600: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 mplementation of
9610: 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 the sqlite3_pca
9620: 63 68 65 2e 78 52 65 6b 65 79 20 6d 65 74 68 6f che.xRekey metho
9630: 64 2e 20 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f d. .*/.static vo
9640: 69 64 20 70 63 61 63 68 65 31 52 65 6b 65 79 28 id pcache1Rekey(
9650: 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 . sqlite3_pcach
9660: 65 20 2a 70 2c 0a 20 20 73 71 6c 69 74 65 33 5f e *p,. sqlite3_
9670: 70 63 61 63 68 65 5f 70 61 67 65 20 2a 70 50 67 pcache_page *pPg
9680: 2c 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 ,. unsigned int
9690: 20 69 4f 6c 64 2c 0a 20 20 75 6e 73 69 67 6e 65 iOld,. unsigne
96a0: 64 20 69 6e 74 20 69 4e 65 77 0a 29 7b 0a 20 20 d int iNew.){.
96b0: 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 20 PCache1 *pCache
96c0: 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b 0a = (PCache1 *)p;.
96d0: 20 20 50 67 48 64 72 31 20 2a 70 50 61 67 65 20 PgHdr1 *pPage
96e0: 3d 20 28 50 67 48 64 72 31 20 2a 29 70 50 67 3b = (PgHdr1 *)pPg;
96f0: 0a 20 20 50 67 48 64 72 31 20 2a 2a 70 70 3b 0a . PgHdr1 **pp;.
9700: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 68 unsigned int h
9710: 3b 20 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 ; . assert( pPa
9720: 67 65 2d 3e 69 4b 65 79 3d 3d 69 4f 6c 64 20 29 ge->iKey==iOld )
9730: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
9740: 65 2d 3e 70 43 61 63 68 65 3d 3d 70 43 61 63 68 e->pCache==pCach
9750: 65 20 29 3b 0a 0a 20 20 70 63 61 63 68 65 31 45 e );.. pcache1E
9760: 6e 74 65 72 4d 75 74 65 78 28 70 43 61 63 68 65 nterMutex(pCache
9770: 2d 3e 70 47 72 6f 75 70 29 3b 0a 0a 20 20 68 20 ->pGroup);.. h
9780: 3d 20 69 4f 6c 64 25 70 43 61 63 68 65 2d 3e 6e = iOld%pCache->n
9790: 48 61 73 68 3b 0a 20 20 70 70 20 3d 20 26 70 43 Hash;. pp = &pC
97a0: 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 3b ache->apHash[h];
97b0: 0a 20 20 77 68 69 6c 65 28 20 28 2a 70 70 29 21 . while( (*pp)!
97c0: 3d 70 50 61 67 65 20 29 7b 0a 20 20 20 20 70 70 =pPage ){. pp
97d0: 20 3d 20 26 28 2a 70 70 29 2d 3e 70 4e 65 78 74 = &(*pp)->pNext
97e0: 3b 0a 20 20 7d 0a 20 20 2a 70 70 20 3d 20 70 50 ;. }. *pp = pP
97f0: 61 67 65 2d 3e 70 4e 65 78 74 3b 0a 0a 20 20 68 age->pNext;.. h
9800: 20 3d 20 69 4e 65 77 25 70 43 61 63 68 65 2d 3e = iNew%pCache->
9810: 6e 48 61 73 68 3b 0a 20 20 70 50 61 67 65 2d 3e nHash;. pPage->
9820: 69 4b 65 79 20 3d 20 69 4e 65 77 3b 0a 20 20 70 iKey = iNew;. p
9830: 50 61 67 65 2d 3e 70 4e 65 78 74 20 3d 20 70 43 Page->pNext = pC
9840: 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 3b ache->apHash[h];
9850: 0a 20 20 70 43 61 63 68 65 2d 3e 61 70 48 61 73 . pCache->apHas
9860: 68 5b 68 5d 20 3d 20 70 50 61 67 65 3b 0a 20 20 h[h] = pPage;.
9870: 69 66 28 20 69 4e 65 77 3e 70 43 61 63 68 65 2d if( iNew>pCache-
9880: 3e 69 4d 61 78 4b 65 79 20 29 7b 0a 20 20 20 20 >iMaxKey ){.
9890: 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 pCache->iMaxKey
98a0: 3d 20 69 4e 65 77 3b 0a 20 20 7d 0a 0a 20 20 70 = iNew;. }.. p
98b0: 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 cache1LeaveMutex
98c0: 28 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 (pCache->pGroup)
98d0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 ;.}../*.** Imple
98e0: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 mentation of the
98f0: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e sqlite3_pcache.
9900: 78 54 72 75 6e 63 61 74 65 20 6d 65 74 68 6f 64 xTruncate method
9910: 2e 20 0a 2a 2a 0a 2a 2a 20 44 69 73 63 61 72 64 . .**.** Discard
9920: 20 61 6c 6c 20 75 6e 70 69 6e 6e 65 64 20 70 61 all unpinned pa
9930: 67 65 73 20 69 6e 20 74 68 65 20 63 61 63 68 65 ges in the cache
9940: 20 77 69 74 68 20 61 20 70 61 67 65 20 6e 75 6d with a page num
9950: 62 65 72 20 65 71 75 61 6c 20 74 6f 0a 2a 2a 20 ber equal to.**
9960: 6f 72 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 or greater than
9970: 70 61 72 61 6d 65 74 65 72 20 69 4c 69 6d 69 74 parameter iLimit
9980: 2e 20 41 6e 79 20 70 69 6e 6e 65 64 20 70 61 67 . Any pinned pag
9990: 65 73 20 77 69 74 68 20 61 20 70 61 67 65 20 6e es with a page n
99a0: 75 6d 62 65 72 0a 2a 2a 20 65 71 75 61 6c 20 74 umber.** equal t
99b0: 6f 20 6f 72 20 67 72 65 61 74 65 72 20 74 68 61 o or greater tha
99c0: 6e 20 69 4c 69 6d 69 74 20 61 72 65 20 69 6d 70 n iLimit are imp
99d0: 6c 69 63 69 74 6c 79 20 75 6e 70 69 6e 6e 65 64 licitly unpinned
99e0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 ..*/.static void
99f0: 20 70 63 61 63 68 65 31 54 72 75 6e 63 61 74 65 pcache1Truncate
9a00: 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 (sqlite3_pcache
9a10: 2a 70 2c 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 *p, unsigned int
9a20: 20 69 4c 69 6d 69 74 29 7b 0a 20 20 50 43 61 63 iLimit){. PCac
9a30: 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50 he1 *pCache = (P
9a40: 43 61 63 68 65 31 20 2a 29 70 3b 0a 20 20 70 63 Cache1 *)p;. pc
9a50: 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 ache1EnterMutex(
9a60: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b pCache->pGroup);
9a70: 0a 20 20 69 66 28 20 69 4c 69 6d 69 74 3c 3d 70 . if( iLimit<=p
9a80: 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 29 Cache->iMaxKey )
9a90: 7b 0a 20 20 20 20 70 63 61 63 68 65 31 54 72 75 {. pcache1Tru
9aa0: 6e 63 61 74 65 55 6e 73 61 66 65 28 70 43 61 63 ncateUnsafe(pCac
9ab0: 68 65 2c 20 69 4c 69 6d 69 74 29 3b 0a 20 20 20 he, iLimit);.
9ac0: 20 70 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 pCache->iMaxKey
9ad0: 20 3d 20 69 4c 69 6d 69 74 2d 31 3b 0a 20 20 7d = iLimit-1;. }
9ae0: 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d . pcache1LeaveM
9af0: 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72 utex(pCache->pGr
9b00: 6f 75 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 oup);.}../*.** I
9b10: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 mplementation of
9b20: 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 the sqlite3_pca
9b30: 63 68 65 2e 78 44 65 73 74 72 6f 79 20 6d 65 74 che.xDestroy met
9b40: 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 44 65 73 74 hod. .**.** Dest
9b50: 72 6f 79 20 61 20 63 61 63 68 65 20 61 6c 6c 6f roy a cache allo
9b60: 63 61 74 65 64 20 75 73 69 6e 67 20 70 63 61 63 cated using pcac
9b70: 68 65 31 43 72 65 61 74 65 28 29 2e 0a 2a 2f 0a he1Create()..*/.
9b80: 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 static void pcac
9b90: 68 65 31 44 65 73 74 72 6f 79 28 73 71 6c 69 74 he1Destroy(sqlit
9ba0: 65 33 5f 70 63 61 63 68 65 20 2a 70 29 7b 0a 20 e3_pcache *p){.
9bb0: 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 65 PCache1 *pCache
9bc0: 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 3b = (PCache1 *)p;
9bd0: 0a 20 20 50 47 72 6f 75 70 20 2a 70 47 72 6f 75 . PGroup *pGrou
9be0: 70 20 3d 20 70 43 61 63 68 65 2d 3e 70 47 72 6f p = pCache->pGro
9bf0: 75 70 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 up;. assert( pC
9c00: 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 ache->bPurgeable
9c10: 20 7c 7c 20 28 70 43 61 63 68 65 2d 3e 6e 4d 61 || (pCache->nMa
9c20: 78 3d 3d 30 20 26 26 20 70 43 61 63 68 65 2d 3e x==0 && pCache->
9c30: 6e 4d 69 6e 3d 3d 30 29 20 29 3b 0a 20 20 70 63 nMin==0) );. pc
9c40: 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 ache1EnterMutex(
9c50: 70 47 72 6f 75 70 29 3b 0a 20 20 69 66 28 20 70 pGroup);. if( p
9c60: 43 61 63 68 65 2d 3e 6e 50 61 67 65 20 29 20 70 Cache->nPage ) p
9c70: 63 61 63 68 65 31 54 72 75 6e 63 61 74 65 55 6e cache1TruncateUn
9c80: 73 61 66 65 28 70 43 61 63 68 65 2c 20 30 29 3b safe(pCache, 0);
9c90: 0a 20 20 61 73 73 65 72 74 28 20 70 47 72 6f 75 . assert( pGrou
9ca0: 70 2d 3e 6e 4d 61 78 50 61 67 65 20 3e 3d 20 70 p->nMaxPage >= p
9cb0: 43 61 63 68 65 2d 3e 6e 4d 61 78 20 29 3b 0a 20 Cache->nMax );.
9cc0: 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 pGroup->nMaxPag
9cd0: 65 20 2d 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 61 e -= pCache->nMa
9ce0: 78 3b 0a 20 20 61 73 73 65 72 74 28 20 70 47 72 x;. assert( pGr
9cf0: 6f 75 70 2d 3e 6e 4d 69 6e 50 61 67 65 20 3e 3d oup->nMinPage >=
9d00: 20 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 20 29 3b pCache->nMin );
9d10: 0a 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 . pGroup->nMinP
9d20: 61 67 65 20 2d 3d 20 70 43 61 63 68 65 2d 3e 6e age -= pCache->n
9d30: 4d 69 6e 3b 0a 20 20 70 47 72 6f 75 70 2d 3e 6d Min;. pGroup->m
9d40: 78 50 69 6e 6e 65 64 20 3d 20 70 47 72 6f 75 70 xPinned = pGroup
9d50: 2d 3e 6e 4d 61 78 50 61 67 65 20 2b 20 31 30 20 ->nMaxPage + 10
9d60: 2d 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 - pGroup->nMinPa
9d70: 67 65 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 66 ge;. pcache1Enf
9d80: 6f 72 63 65 4d 61 78 50 61 67 65 28 70 43 61 63 orceMaxPage(pCac
9d90: 68 65 29 3b 0a 20 20 70 63 61 63 68 65 31 4c 65 he);. pcache1Le
9da0: 61 76 65 4d 75 74 65 78 28 70 47 72 6f 75 70 29 aveMutex(pGroup)
9db0: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 ;. sqlite3_free
9dc0: 28 70 43 61 63 68 65 2d 3e 70 42 75 6c 6b 29 3b (pCache->pBulk);
9dd0: 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 . sqlite3_free(
9de0: 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 29 3b pCache->apHash);
9df0: 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 . sqlite3_free(
9e00: 70 43 61 63 68 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a pCache);.}../*.*
9e10: 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 * This function
9e20: 69 73 20 63 61 6c 6c 65 64 20 64 75 72 69 6e 67 is called during
9e30: 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 initialization
9e40: 28 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c (sqlite3_initial
9e50: 69 7a 65 28 29 29 20 74 6f 0a 2a 2a 20 69 6e 73 ize()) to.** ins
9e60: 74 61 6c 6c 20 74 68 65 20 64 65 66 61 75 6c 74 tall the default
9e70: 20 70 6c 75 67 67 61 62 6c 65 20 63 61 63 68 65 pluggable cache
9e80: 20 6d 6f 64 75 6c 65 2c 20 61 73 73 75 6d 69 6e module, assumin
9e90: 67 20 74 68 65 20 75 73 65 72 20 68 61 73 20 6e g the user has n
9ea0: 6f 74 0a 2a 2a 20 61 6c 72 65 61 64 79 20 70 72 ot.** already pr
9eb0: 6f 76 69 64 65 64 20 61 6e 20 61 6c 74 65 72 6e ovided an altern
9ec0: 61 74 69 76 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 ative..*/.void s
9ed0: 71 6c 69 74 65 33 50 43 61 63 68 65 53 65 74 44 qlite3PCacheSetD
9ee0: 65 66 61 75 6c 74 28 76 6f 69 64 29 7b 0a 20 20 efault(void){.
9ef0: 73 74 61 74 69 63 20 63 6f 6e 73 74 20 73 71 6c static const sql
9f00: 69 74 65 33 5f 70 63 61 63 68 65 5f 6d 65 74 68 ite3_pcache_meth
9f10: 6f 64 73 32 20 64 65 66 61 75 6c 74 4d 65 74 68 ods2 defaultMeth
9f20: 6f 64 73 20 3d 20 7b 0a 20 20 20 20 31 2c 20 20 ods = {. 1,
9f30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9f40: 20 20 20 20 20 2f 2a 20 69 56 65 72 73 69 6f 6e /* iVersion
9f50: 20 2a 2f 0a 20 20 20 20 30 2c 20 20 20 20 20 20 */. 0,
9f60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9f70: 20 2f 2a 20 70 41 72 67 20 2a 2f 0a 20 20 20 20 /* pArg */.
9f80: 70 63 61 63 68 65 31 49 6e 69 74 2c 20 20 20 20 pcache1Init,
9f90: 20 20 20 20 20 20 20 20 20 2f 2a 20 78 49 6e 69 /* xIni
9fa0: 74 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 t */. pcache1
9fb0: 53 68 75 74 64 6f 77 6e 2c 20 20 20 20 20 20 20 Shutdown,
9fc0: 20 20 2f 2a 20 78 53 68 75 74 64 6f 77 6e 20 2a /* xShutdown *
9fd0: 2f 0a 20 20 20 20 70 63 61 63 68 65 31 43 72 65 /. pcache1Cre
9fe0: 61 74 65 2c 20 20 20 20 20 20 20 20 20 20 20 2f ate, /
9ff0: 2a 20 78 43 72 65 61 74 65 20 2a 2f 0a 20 20 20 * xCreate */.
a000: 20 70 63 61 63 68 65 31 43 61 63 68 65 73 69 7a pcache1Cachesiz
a010: 65 2c 20 20 20 20 20 20 20 20 2f 2a 20 78 43 61 e, /* xCa
a020: 63 68 65 73 69 7a 65 20 2a 2f 0a 20 20 20 20 70 chesize */. p
a030: 63 61 63 68 65 31 50 61 67 65 63 6f 75 6e 74 2c cache1Pagecount,
a040: 20 20 20 20 20 20 20 20 2f 2a 20 78 50 61 67 65 /* xPage
a050: 63 6f 75 6e 74 20 2a 2f 0a 20 20 20 20 70 63 61 count */. pca
a060: 63 68 65 31 46 65 74 63 68 2c 20 20 20 20 20 20 che1Fetch,
a070: 20 20 20 20 20 20 2f 2a 20 78 46 65 74 63 68 20 /* xFetch
a080: 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 55 6e */. pcache1Un
a090: 70 69 6e 2c 20 20 20 20 20 20 20 20 20 20 20 20 pin,
a0a0: 2f 2a 20 78 55 6e 70 69 6e 20 2a 2f 0a 20 20 20 /* xUnpin */.
a0b0: 20 70 63 61 63 68 65 31 52 65 6b 65 79 2c 20 20 pcache1Rekey,
a0c0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 52 65 /* xRe
a0d0: 6b 65 79 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 key */. pcach
a0e0: 65 31 54 72 75 6e 63 61 74 65 2c 20 20 20 20 20 e1Truncate,
a0f0: 20 20 20 20 2f 2a 20 78 54 72 75 6e 63 61 74 65 /* xTruncate
a100: 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 44 */. pcache1D
a110: 65 73 74 72 6f 79 2c 20 20 20 20 20 20 20 20 20 estroy,
a120: 20 2f 2a 20 78 44 65 73 74 72 6f 79 20 2a 2f 0a /* xDestroy */.
a130: 20 20 20 20 70 63 61 63 68 65 31 53 68 72 69 6e pcache1Shrin
a140: 6b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 k /*
a150: 78 53 68 72 69 6e 6b 20 2a 2f 0a 20 20 7d 3b 0a xShrink */. };.
a160: 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 sqlite3_config
a170: 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 (SQLITE_CONFIG_P
a180: 43 41 43 48 45 32 2c 20 26 64 65 66 61 75 6c 74 CACHE2, &default
a190: 4d 65 74 68 6f 64 73 29 3b 0a 7d 0a 0a 2f 2a 0a Methods);.}../*.
a1a0: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 73 69 ** Return the si
a1b0: 7a 65 20 6f 66 20 74 68 65 20 68 65 61 64 65 72 ze of the header
a1c0: 20 6f 6e 20 65 61 63 68 20 70 61 67 65 20 6f 66 on each page of
a1d0: 20 74 68 69 73 20 50 43 41 43 48 45 20 69 6d 70 this PCACHE imp
a1e0: 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 0a 2a 2f 0a lementation..*/.
a1f0: 69 6e 74 20 73 71 6c 69 74 65 33 48 65 61 64 65 int sqlite3Heade
a200: 72 53 69 7a 65 50 63 61 63 68 65 31 28 76 6f 69 rSizePcache1(voi
a210: 64 29 7b 20 72 65 74 75 72 6e 20 52 4f 55 4e 44 d){ return ROUND
a220: 38 28 73 69 7a 65 6f 66 28 50 67 48 64 72 31 29 8(sizeof(PgHdr1)
a230: 29 3b 20 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 ); }../*.** Retu
a240: 72 6e 20 74 68 65 20 67 6c 6f 62 61 6c 20 6d 75 rn the global mu
a250: 74 65 78 20 75 73 65 64 20 62 79 20 74 68 69 73 tex used by this
a260: 20 50 43 41 43 48 45 20 69 6d 70 6c 65 6d 65 6e PCACHE implemen
a270: 74 61 74 69 6f 6e 2e 20 20 54 68 65 0a 2a 2a 20 tation. The.**
a280: 73 71 6c 69 74 65 33 5f 73 74 61 74 75 73 28 29 sqlite3_status()
a290: 20 72 6f 75 74 69 6e 65 20 6e 65 65 64 73 20 61 routine needs a
a2a0: 63 63 65 73 73 20 74 6f 20 74 68 69 73 20 6d 75 ccess to this mu
a2b0: 74 65 78 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f tex..*/.sqlite3_
a2c0: 6d 75 74 65 78 20 2a 73 71 6c 69 74 65 33 50 63 mutex *sqlite3Pc
a2d0: 61 63 68 65 31 4d 75 74 65 78 28 76 6f 69 64 29 ache1Mutex(void)
a2e0: 7b 0a 20 20 72 65 74 75 72 6e 20 70 63 61 63 68 {. return pcach
a2f0: 65 31 2e 6d 75 74 65 78 3b 0a 7d 0a 0a 23 69 66 e1.mutex;.}..#if
a300: 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
a310: 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d E_MEMORY_MANAGEM
a320: 45 4e 54 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 ENT./*.** This f
a330: 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 unction is calle
a340: 64 20 74 6f 20 66 72 65 65 20 73 75 70 65 72 66 d to free superf
a350: 6c 75 6f 75 73 20 64 79 6e 61 6d 69 63 61 6c 6c luous dynamicall
a360: 79 20 61 6c 6c 6f 63 61 74 65 64 20 6d 65 6d 6f y allocated memo
a370: 72 79 0a 2a 2a 20 68 65 6c 64 20 62 79 20 74 68 ry.** held by th
a380: 65 20 70 61 67 65 72 20 73 79 73 74 65 6d 2e 20 e pager system.
a390: 4d 65 6d 6f 72 79 20 69 6e 20 75 73 65 20 62 79 Memory in use by
a3a0: 20 61 6e 79 20 53 51 4c 69 74 65 20 70 61 67 65 any SQLite page
a3b0: 72 20 61 6c 6c 6f 63 61 74 65 64 0a 2a 2a 20 62 r allocated.** b
a3c0: 79 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 68 y the current th
a3d0: 72 65 61 64 20 6d 61 79 20 62 65 20 73 71 6c 69 read may be sqli
a3e0: 74 65 33 5f 66 72 65 65 28 29 65 64 2e 0a 2a 2a te3_free()ed..**
a3f0: 0a 2a 2a 20 6e 52 65 71 20 69 73 20 74 68 65 20 .** nReq is the
a400: 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 number of bytes
a410: 6f 66 20 6d 65 6d 6f 72 79 20 72 65 71 75 69 72 of memory requir
a420: 65 64 2e 20 4f 6e 63 65 20 74 68 69 73 20 6d 75 ed. Once this mu
a430: 63 68 20 68 61 73 0a 2a 2a 20 62 65 65 6e 20 72 ch has.** been r
a440: 65 6c 65 61 73 65 64 2c 20 74 68 65 20 66 75 6e eleased, the fun
a450: 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 2e 20 54 ction returns. T
a460: 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 he return value
a470: 69 73 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d is the total num
a480: 62 65 72 20 0a 2a 2a 20 6f 66 20 62 79 74 65 73 ber .** of bytes
a490: 20 6f 66 20 6d 65 6d 6f 72 79 20 72 65 6c 65 61 of memory relea
a4a0: 73 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 sed..*/.int sqli
a4b0: 74 65 33 50 63 61 63 68 65 52 65 6c 65 61 73 65 te3PcacheRelease
a4c0: 4d 65 6d 6f 72 79 28 69 6e 74 20 6e 52 65 71 29 Memory(int nReq)
a4d0: 7b 0a 20 20 69 6e 74 20 6e 46 72 65 65 20 3d 20 {. int nFree =
a4e0: 30 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 0;. assert( sql
a4f0: 69 74 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 ite3_mutex_nothe
a500: 6c 64 28 70 63 61 63 68 65 31 2e 67 72 70 2e 6d ld(pcache1.grp.m
a510: 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 utex) );. asser
a520: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
a530: 5f 6e 6f 74 68 65 6c 64 28 70 63 61 63 68 65 31 _notheld(pcache1
a540: 2e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 .mutex) );. if(
a550: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
a560: 6e 66 69 67 2e 70 50 61 67 65 3d 3d 30 20 29 7b nfig.pPage==0 ){
a570: 0a 20 20 20 20 50 67 48 64 72 31 20 2a 70 3b 0a . PgHdr1 *p;.
a580: 20 20 20 20 70 63 61 63 68 65 31 45 6e 74 65 72 pcache1Enter
a590: 4d 75 74 65 78 28 26 70 63 61 63 68 65 31 2e 67 Mutex(&pcache1.g
a5a0: 72 70 29 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 rp);. while(
a5b0: 28 6e 52 65 71 3c 30 20 7c 7c 20 6e 46 72 65 65 (nReq<0 || nFree
a5c0: 3c 6e 52 65 71 29 0a 20 20 20 20 20 20 20 26 26 <nReq). &&
a5d0: 20 20 28 70 3d 70 63 61 63 68 65 31 2e 67 72 70 (p=pcache1.grp
a5e0: 2e 6c 72 75 2e 70 4c 72 75 50 72 65 76 29 21 3d .lru.pLruPrev)!=
a5f0: 30 0a 20 20 20 20 20 20 20 26 26 20 20 70 2d 3e 0. && p->
a600: 69 73 41 6e 63 68 6f 72 3d 3d 30 0a 20 20 20 20 isAnchor==0.
a610: 29 7b 0a 20 20 20 20 20 20 6e 46 72 65 65 20 2b ){. nFree +
a620: 3d 20 70 63 61 63 68 65 31 4d 65 6d 53 69 7a 65 = pcache1MemSize
a630: 28 70 2d 3e 70 61 67 65 2e 70 42 75 66 29 3b 0a (p->page.pBuf);.
a640: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 50 43 #ifdef SQLITE_PC
a650: 41 43 48 45 5f 53 45 50 41 52 41 54 45 5f 48 45 ACHE_SEPARATE_HE
a660: 41 44 45 52 0a 20 20 20 20 20 20 6e 46 72 65 65 ADER. nFree
a670: 20 2b 3d 20 73 71 6c 69 74 65 33 4d 65 6d 53 69 += sqlite3MemSi
a680: 7a 65 28 70 29 3b 0a 23 65 6e 64 69 66 0a 20 20 ze(p);.#endif.
a690: 20 20 20 20 61 73 73 65 72 74 28 20 50 41 47 45 assert( PAGE
a6a0: 5f 49 53 5f 55 4e 50 49 4e 4e 45 44 28 70 29 20 _IS_UNPINNED(p)
a6b0: 29 3b 0a 20 20 20 20 20 20 70 63 61 63 68 65 31 );. pcache1
a6c0: 50 69 6e 50 61 67 65 28 70 29 3b 0a 20 20 20 20 PinPage(p);.
a6d0: 20 20 70 63 61 63 68 65 31 52 65 6d 6f 76 65 46 pcache1RemoveF
a6e0: 72 6f 6d 48 61 73 68 28 70 2c 20 31 29 3b 0a 20 romHash(p, 1);.
a6f0: 20 20 20 7d 0a 20 20 20 20 70 63 61 63 68 65 31 }. pcache1
a700: 4c 65 61 76 65 4d 75 74 65 78 28 26 70 63 61 63 LeaveMutex(&pcac
a710: 68 65 31 2e 67 72 70 29 3b 0a 20 20 7d 0a 20 20 he1.grp);. }.
a720: 72 65 74 75 72 6e 20 6e 46 72 65 65 3b 0a 7d 0a return nFree;.}.
a730: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 #endif /* SQLITE
a740: 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d _ENABLE_MEMORY_M
a750: 41 4e 41 47 45 4d 45 4e 54 20 2a 2f 0a 0a 23 69 ANAGEMENT */..#i
a760: 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45 53 54 fdef SQLITE_TEST
a770: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 ./*.** This func
a780: 74 69 6f 6e 20 69 73 20 75 73 65 64 20 62 79 20 tion is used by
a790: 74 65 73 74 20 70 72 6f 63 65 64 75 72 65 73 20 test procedures
a7a0: 74 6f 20 69 6e 73 70 65 63 74 20 74 68 65 20 69 to inspect the i
a7b0: 6e 74 65 72 6e 61 6c 20 73 74 61 74 65 0a 2a 2a nternal state.**
a7c0: 20 6f 66 20 74 68 65 20 67 6c 6f 62 61 6c 20 63 of the global c
a7d0: 61 63 68 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 ache..*/.void sq
a7e0: 6c 69 74 65 33 50 63 61 63 68 65 53 74 61 74 73 lite3PcacheStats
a7f0: 28 0a 20 20 69 6e 74 20 2a 70 6e 43 75 72 72 65 (. int *pnCurre
a800: 6e 74 2c 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a nt, /* OUT:
a810: 20 54 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 Total number of
a820: 20 70 61 67 65 73 20 63 61 63 68 65 64 20 2a 2f pages cached */
a830: 0a 20 20 69 6e 74 20 2a 70 6e 4d 61 78 2c 20 20 . int *pnMax,
a840: 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 /* OUT:
a850: 47 6c 6f 62 61 6c 20 6d 61 78 69 6d 75 6d 20 63 Global maximum c
a860: 61 63 68 65 20 73 69 7a 65 20 2a 2f 0a 20 20 69 ache size */. i
a870: 6e 74 20 2a 70 6e 4d 69 6e 2c 20 20 20 20 20 20 nt *pnMin,
a880: 20 20 20 20 2f 2a 20 4f 55 54 3a 20 53 75 6d 20 /* OUT: Sum
a890: 6f 66 20 50 43 61 63 68 65 31 2e 6e 4d 69 6e 20 of PCache1.nMin
a8a0: 66 6f 72 20 70 75 72 67 65 61 62 6c 65 20 63 61 for purgeable ca
a8b0: 63 68 65 73 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 ches */. int *p
a8c0: 6e 52 65 63 79 63 6c 61 62 6c 65 20 20 20 20 2f nRecyclable /
a8d0: 2a 20 4f 55 54 3a 20 54 6f 74 61 6c 20 6e 75 6d * OUT: Total num
a8e0: 62 65 72 20 6f 66 20 70 61 67 65 73 20 61 76 61 ber of pages ava
a8f0: 69 6c 61 62 6c 65 20 66 6f 72 20 72 65 63 79 63 ilable for recyc
a900: 6c 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 50 67 48 ling */.){. PgH
a910: 64 72 31 20 2a 70 3b 0a 20 20 69 6e 74 20 6e 52 dr1 *p;. int nR
a920: 65 63 79 63 6c 61 62 6c 65 20 3d 20 30 3b 0a 20 ecyclable = 0;.
a930: 20 66 6f 72 28 70 3d 70 63 61 63 68 65 31 2e 67 for(p=pcache1.g
a940: 72 70 2e 6c 72 75 2e 70 4c 72 75 4e 65 78 74 3b rp.lru.pLruNext;
a950: 20 70 20 26 26 20 21 70 2d 3e 69 73 41 6e 63 68 p && !p->isAnch
a960: 6f 72 3b 20 70 3d 70 2d 3e 70 4c 72 75 4e 65 78 or; p=p->pLruNex
a970: 74 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 t){. assert(
a980: 50 41 47 45 5f 49 53 5f 55 4e 50 49 4e 4e 45 44 PAGE_IS_UNPINNED
a990: 28 70 29 20 29 3b 0a 20 20 20 20 6e 52 65 63 79 (p) );. nRecy
a9a0: 63 6c 61 62 6c 65 2b 2b 3b 0a 20 20 7d 0a 20 20 clable++;. }.
a9b0: 2a 70 6e 43 75 72 72 65 6e 74 20 3d 20 70 63 61 *pnCurrent = pca
a9c0: 63 68 65 31 2e 67 72 70 2e 6e 50 75 72 67 65 61 che1.grp.nPurgea
a9d0: 62 6c 65 3b 0a 20 20 2a 70 6e 4d 61 78 20 3d 20 ble;. *pnMax =
a9e0: 28 69 6e 74 29 70 63 61 63 68 65 31 2e 67 72 70 (int)pcache1.grp
a9f0: 2e 6e 4d 61 78 50 61 67 65 3b 0a 20 20 2a 70 6e .nMaxPage;. *pn
aa00: 4d 69 6e 20 3d 20 28 69 6e 74 29 70 63 61 63 68 Min = (int)pcach
aa10: 65 31 2e 67 72 70 2e 6e 4d 69 6e 50 61 67 65 3b e1.grp.nMinPage;
aa20: 0a 20 20 2a 70 6e 52 65 63 79 63 6c 61 62 6c 65 . *pnRecyclable
aa30: 20 3d 20 6e 52 65 63 79 63 6c 61 62 6c 65 3b 0a = nRecyclable;.
aa40: 7d 0a 23 65 6e 64 69 66 0a }.#endif.