0000: 2f 2a 0a 2a 2a 20 32 30 30 38 20 4e 6f 76 65 6d /*.** 2008 Novem
0010: 62 65 72 20 30 35 0a 2a 2a 0a 2a 2a 20 54 68 65 ber 05.**.** The
0020: 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 6d author disclaim
0030: 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 74 s copyright to t
0040: 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 2e his source code.
0050: 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a 2a In place of.**
0060: 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 2c a legal notice,
0070: 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 73 here is a bless
0080: 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61 ing:.**.** Ma
0090: 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 6e y you do good an
00a0: 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 20 d not evil..**
00b0: 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 66 May you find f
00c0: 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 79 orgiveness for y
00d0: 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 67 ourself and forg
00e0: 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 20 ive others..**
00f0: 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 20 May you share
0100: 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 61 freely, never ta
0110: 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 79 king more than y
0120: 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a ou give..**.****
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0170: 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 54 68 69 73 *****.**.** This
0180: 20 66 69 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 73 file implements
0190: 20 74 68 65 20 64 65 66 61 75 6c 74 20 70 61 67 the default pag
01a0: 65 20 63 61 63 68 65 20 69 6d 70 6c 65 6d 65 6e e cache implemen
01b0: 74 61 74 69 6f 6e 20 28 74 68 65 0a 2a 2a 20 73 tation (the.** s
01c0: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 69 6e qlite3_pcache in
01d0: 74 65 72 66 61 63 65 29 2e 20 49 74 20 61 6c 73 terface). It als
01e0: 6f 20 63 6f 6e 74 61 69 6e 73 20 70 61 72 74 20 o contains part
01f0: 6f 66 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 of the implement
0200: 61 74 69 6f 6e 0a 2a 2a 20 6f 66 20 74 68 65 20 ation.** of the
0210: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 SQLITE_CONFIG_PA
0220: 47 45 43 41 43 48 45 20 61 6e 64 20 73 71 6c 69 GECACHE and sqli
0230: 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f te3_release_memo
0240: 72 79 28 29 20 66 65 61 74 75 72 65 73 2e 0a 2a ry() features..*
0250: 2a 20 49 66 20 74 68 65 20 64 65 66 61 75 6c 74 * If the default
0260: 20 70 61 67 65 20 63 61 63 68 65 20 69 6d 70 6c page cache impl
0270: 65 6d 65 6e 74 61 74 69 6f 6e 20 69 73 20 6f 76 ementation is ov
0280: 65 72 72 69 64 64 65 6e 2c 20 74 68 65 6e 20 6e erridden, then n
0290: 65 69 74 68 65 72 20 6f 66 0a 2a 2a 20 74 68 65 either of.** the
02a0: 73 65 20 74 77 6f 20 66 65 61 74 75 72 65 73 20 se two features
02b0: 61 72 65 20 61 76 61 69 6c 61 62 6c 65 2e 0a 2a are available..*
02c0: 2a 0a 2a 2a 20 41 20 50 61 67 65 20 63 61 63 68 *.** A Page cach
02d0: 65 20 6c 69 6e 65 20 6c 6f 6f 6b 73 20 6c 69 6b e line looks lik
02e0: 65 20 74 68 69 73 3a 0a 2a 2a 0a 2a 2a 20 20 2d e this:.**.** -
02f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0300: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0310: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0320: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 20 ------------.**
0330: 20 7c 20 20 64 61 74 61 62 61 73 65 20 70 61 67 | database pag
0340: 65 20 63 6f 6e 74 65 6e 74 20 20 20 7c 20 20 50 e content | P
0350: 67 48 64 72 31 20 20 7c 20 20 4d 65 6d 50 61 67 gHdr1 | MemPag
0360: 65 20 20 7c 20 20 50 67 48 64 72 20 20 7c 0a 2a e | PgHdr |.*
0370: 2a 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d * -------------
0380: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0390: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
03a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
03b0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 64 61 74 61 62 .**.** The datab
03c0: 61 73 65 20 70 61 67 65 20 63 6f 6e 74 65 6e 74 ase page content
03d0: 20 69 73 20 75 70 20 66 72 6f 6e 74 20 28 73 6f is up front (so
03e0: 20 74 68 61 74 20 62 75 66 66 65 72 20 6f 76 65 that buffer ove
03f0: 72 72 65 61 64 73 20 74 65 6e 64 20 74 6f 0a 2a rreads tend to.*
0400: 2a 20 66 6c 6f 77 20 68 61 72 6d 6c 65 73 73 6c * flow harmlessl
0410: 79 20 69 6e 74 6f 20 74 68 65 20 50 67 48 64 72 y into the PgHdr
0420: 31 2c 20 4d 65 6d 50 61 67 65 2c 20 61 6e 64 20 1, MemPage, and
0430: 50 67 48 64 72 20 65 78 74 65 6e 73 69 6f 6e 73 PgHdr extensions
0440: 29 2e 20 20 20 4d 65 6d 50 61 67 65 0a 2a 2a 20 ). MemPage.**
0450: 69 73 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e is the extension
0460: 20 61 64 64 65 64 20 62 79 20 74 68 65 20 62 74 added by the bt
0470: 72 65 65 2e 63 20 6d 6f 64 75 6c 65 20 63 6f 6e ree.c module con
0480: 74 61 69 6e 69 6e 67 20 69 6e 66 6f 72 6d 61 74 taining informat
0490: 69 6f 6e 20 73 75 63 68 0a 2a 2a 20 61 73 20 74 ion such.** as t
04a0: 68 65 20 64 61 74 61 62 61 73 65 20 70 61 67 65 he database page
04b0: 20 6e 75 6d 62 65 72 20 61 6e 64 20 68 6f 77 20 number and how
04c0: 74 68 61 74 20 64 61 74 61 62 61 73 65 20 70 61 that database pa
04d0: 67 65 20 69 73 20 75 73 65 64 2e 20 20 50 67 48 ge is used. PgH
04e0: 64 72 0a 2a 2a 20 69 73 20 61 64 64 65 64 20 62 dr.** is added b
04f0: 79 20 74 68 65 20 70 63 61 63 68 65 2e 63 20 6c y the pcache.c l
0500: 61 79 65 72 20 61 6e 64 20 63 6f 6e 74 61 69 6e ayer and contain
0510: 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 75 73 s information us
0520: 65 64 20 74 6f 20 6b 65 65 70 20 74 72 61 63 6b ed to keep track
0530: 0a 2a 2a 20 6f 66 20 77 68 69 63 68 20 70 61 67 .** of which pag
0540: 65 73 20 61 72 65 20 22 64 69 72 74 79 22 2e 20 es are "dirty".
0550: 20 50 67 48 64 72 31 20 69 73 20 61 6e 20 65 78 PgHdr1 is an ex
0560: 74 65 6e 73 69 6f 6e 20 61 64 64 65 64 20 62 79 tension added by
0570: 20 74 68 69 73 0a 2a 2a 20 6d 6f 64 75 6c 65 20 this.** module
0580: 28 70 63 61 63 68 65 31 2e 63 29 2e 20 20 54 68 (pcache1.c). Th
0590: 65 20 50 67 48 64 72 31 20 68 65 61 64 65 72 20 e PgHdr1 header
05a0: 69 73 20 61 20 73 75 62 63 6c 61 73 73 20 6f 66 is a subclass of
05b0: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f sqlite3_pcache_
05c0: 70 61 67 65 2e 0a 2a 2a 20 50 67 48 64 72 31 20 page..** PgHdr1
05d0: 63 6f 6e 74 61 69 6e 73 20 69 6e 66 6f 72 6d 61 contains informa
05e0: 74 69 6f 6e 20 6e 65 65 64 65 64 20 74 6f 20 6c tion needed to l
05f0: 6f 6f 6b 20 75 70 20 61 20 70 61 67 65 20 62 79 ook up a page by
0600: 20 69 74 73 20 70 61 67 65 20 6e 75 6d 62 65 72 its page number
0610: 2e 0a 2a 2a 20 54 68 65 20 73 75 70 65 72 63 6c ..** The supercl
0620: 61 73 73 20 73 71 6c 69 74 65 33 5f 70 63 61 63 ass sqlite3_pcac
0630: 68 65 5f 70 61 67 65 2e 70 42 75 66 20 70 6f 69 he_page.pBuf poi
0640: 6e 74 73 20 74 6f 20 74 68 65 20 73 74 61 72 74 nts to the start
0650: 20 6f 66 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 of the.** datab
0660: 61 73 65 20 70 61 67 65 20 63 6f 6e 74 65 6e 74 ase page content
0670: 20 61 6e 64 20 73 71 6c 69 74 65 33 5f 70 63 61 and sqlite3_pca
0680: 63 68 65 5f 70 61 67 65 2e 70 45 78 74 72 61 20 che_page.pExtra
0690: 70 6f 69 6e 74 73 20 74 6f 20 50 67 48 64 72 2e points to PgHdr.
06a0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 69 7a 65 20 .**.** The size
06b0: 6f 66 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e of the extension
06c0: 20 28 4d 65 6d 50 61 67 65 2b 50 67 48 64 72 2b (MemPage+PgHdr+
06d0: 50 67 48 64 72 31 29 20 63 61 6e 20 62 65 20 64 PgHdr1) can be d
06e0: 65 74 65 72 6d 69 6e 65 64 20 61 74 0a 2a 2a 20 etermined at.**
06f0: 72 75 6e 74 69 6d 65 20 75 73 69 6e 67 20 73 71 runtime using sq
0700: 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c lite3_config(SQL
0710: 49 54 45 5f 43 4f 4e 46 49 47 5f 50 43 41 43 48 ITE_CONFIG_PCACH
0720: 45 5f 48 44 52 53 5a 2c 20 26 73 69 7a 65 29 2e E_HDRSZ, &size).
0730: 20 20 54 68 65 0a 2a 2a 20 73 69 7a 65 73 20 6f The.** sizes o
0740: 66 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e 73 f the extensions
0750: 20 73 75 6d 20 74 6f 20 32 37 32 20 62 79 74 65 sum to 272 byte
0760: 73 20 6f 6e 20 78 36 34 20 66 6f 72 20 33 2e 38 s on x64 for 3.8
0770: 2e 31 30 2c 20 62 75 74 20 74 68 69 73 0a 2a 2a .10, but this.**
0780: 20 73 69 7a 65 20 63 61 6e 20 76 61 72 79 20 61 size can vary a
0790: 63 63 6f 72 64 69 6e 67 20 74 6f 20 61 72 63 68 ccording to arch
07a0: 69 74 65 63 74 75 72 65 2c 20 63 6f 6d 70 69 6c itecture, compil
07b0: 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73 2c 20 e-time options,
07c0: 61 6e 64 0a 2a 2a 20 53 51 4c 69 74 65 20 6c 69 and.** SQLite li
07d0: 62 72 61 72 79 20 76 65 72 73 69 6f 6e 20 6e 75 brary version nu
07e0: 6d 62 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 53 mber..**.** If S
07f0: 51 4c 49 54 45 5f 50 43 41 43 48 45 5f 53 45 50 QLITE_PCACHE_SEP
0800: 41 52 41 54 45 5f 48 45 41 44 45 52 20 69 73 20 ARATE_HEADER is
0810: 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 74 68 defined, then th
0820: 65 20 65 78 74 65 6e 73 69 6f 6e 20 69 73 20 6f e extension is o
0830: 62 74 61 69 6e 65 64 0a 2a 2a 20 75 73 69 6e 67 btained.** using
0840: 20 61 20 73 65 70 61 72 61 74 65 20 6d 65 6d 6f a separate memo
0850: 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 66 72 ry allocation fr
0860: 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 20 om the database
0870: 70 61 67 65 20 63 6f 6e 74 65 6e 74 2e 20 20 54 page content. T
0880: 68 69 73 0a 2a 2a 20 73 65 65 6b 73 20 74 6f 20 his.** seeks to
0890: 6f 76 65 72 63 6f 6d 65 20 74 68 65 20 22 63 6c overcome the "cl
08a0: 6f 77 6e 73 68 6f 65 22 20 70 72 6f 62 6c 65 6d ownshoe" problem
08b0: 20 28 61 6c 73 6f 20 63 61 6c 6c 65 64 20 22 69 (also called "i
08c0: 6e 74 65 72 6e 61 6c 0a 2a 2a 20 66 72 61 67 6d nternal.** fragm
08d0: 65 6e 74 61 74 69 6f 6e 22 20 69 6e 20 61 63 61 entation" in aca
08e0: 64 65 6d 69 63 20 6c 69 74 65 72 61 74 75 72 65 demic literature
08f0: 29 20 6f 66 20 61 6c 6c 6f 63 61 74 69 6e 67 20 ) of allocating
0900: 61 20 66 65 77 20 62 79 74 65 73 20 6d 6f 72 65 a few bytes more
0910: 0a 2a 2a 20 74 68 61 6e 20 61 20 70 6f 77 65 72 .** than a power
0920: 20 6f 66 20 74 77 6f 20 77 69 74 68 20 74 68 65 of two with the
0930: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f memory allocato
0940: 72 20 72 6f 75 6e 64 69 6e 67 20 75 70 20 74 6f r rounding up to
0950: 20 74 68 65 20 6e 65 78 74 0a 2a 2a 20 70 6f 77 the next.** pow
0960: 65 72 20 6f 66 20 74 77 6f 2c 20 61 6e 64 20 6c er of two, and l
0970: 65 61 76 69 6e 67 20 74 68 65 20 72 6f 75 6e 64 eaving the round
0980: 65 64 2d 75 70 20 73 70 61 63 65 20 75 6e 75 73 ed-up space unus
0990: 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 6d ed..**.** This m
09a0: 6f 64 75 6c 65 20 74 72 61 63 6b 73 20 70 6f 69 odule tracks poi
09b0: 6e 74 65 72 73 20 74 6f 20 50 67 48 64 72 31 20 nters to PgHdr1
09c0: 6f 62 6a 65 63 74 73 2e 20 20 4f 6e 6c 79 20 70 objects. Only p
09d0: 63 61 63 68 65 2e 63 20 63 6f 6d 6d 75 6e 69 63 cache.c communic
09e0: 61 74 65 73 0a 2a 2a 20 77 69 74 68 20 74 68 69 ates.** with thi
09f0: 73 20 6d 6f 64 75 6c 65 2e 20 20 49 6e 66 6f 72 s module. Infor
0a00: 6d 61 74 69 6f 6e 20 69 73 20 70 61 73 73 65 64 mation is passed
0a10: 20 62 61 63 6b 20 61 6e 64 20 66 6f 72 74 68 20 back and forth
0a20: 61 73 20 50 67 48 64 72 31 20 70 6f 69 6e 74 65 as PgHdr1 pointe
0a30: 72 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 63 rs..**.** The pc
0a40: 61 63 68 65 2e 63 20 61 6e 64 20 70 61 67 65 72 ache.c and pager
0a50: 2e 63 20 6d 6f 64 75 6c 65 73 20 64 65 61 6c 20 .c modules deal
0a60: 70 6f 69 6e 74 65 72 73 20 74 6f 20 50 67 48 64 pointers to PgHd
0a70: 72 20 6f 62 6a 65 63 74 73 2e 0a 2a 2a 20 54 68 r objects..** Th
0a80: 65 20 62 74 72 65 65 2e 63 20 6d 6f 64 75 6c 65 e btree.c module
0a90: 20 64 65 61 6c 73 20 77 69 74 68 20 70 6f 69 6e deals with poin
0aa0: 74 65 72 73 20 74 6f 20 4d 65 6d 50 61 67 65 20 ters to MemPage
0ab0: 6f 62 6a 65 63 74 73 2e 0a 2a 2a 0a 2a 2a 20 53 objects..**.** S
0ac0: 4f 55 52 43 45 20 4f 46 20 50 41 47 45 20 43 41 OURCE OF PAGE CA
0ad0: 43 48 45 20 4d 45 4d 4f 52 59 3a 0a 2a 2a 0a 2a CHE MEMORY:.**.*
0ae0: 2a 20 4d 65 6d 6f 72 79 20 66 6f 72 20 61 20 70 * Memory for a p
0af0: 61 67 65 20 6d 69 67 68 74 20 63 6f 6d 65 20 66 age might come f
0b00: 72 6f 6d 20 61 6e 79 20 6f 66 20 74 68 72 65 65 rom any of three
0b10: 20 73 6f 75 72 63 65 73 3a 0a 2a 2a 0a 2a 2a 20 sources:.**.**
0b20: 20 20 20 28 31 29 20 20 54 68 65 20 67 65 6e 65 (1) The gene
0b30: 72 61 6c 2d 70 75 72 70 6f 73 65 20 6d 65 6d 6f ral-purpose memo
0b40: 72 79 20 61 6c 6c 6f 63 61 74 6f 72 20 2d 20 73 ry allocator - s
0b50: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 29 0a 2a qlite3Malloc().*
0b60: 2a 20 20 20 20 28 32 29 20 20 47 6c 6f 62 61 6c * (2) Global
0b70: 20 70 61 67 65 2d 63 61 63 68 65 20 6d 65 6d 6f page-cache memo
0b80: 72 79 20 70 72 6f 76 69 64 65 64 20 75 73 69 6e ry provided usin
0b90: 67 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 g sqlite3_config
0ba0: 28 29 20 77 69 74 68 0a 2a 2a 20 20 20 20 20 20 () with.**
0bb0: 20 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 SQLITE_CONFIG
0bc0: 5f 50 41 47 45 43 41 43 48 45 2e 0a 2a 2a 20 20 _PAGECACHE..**
0bd0: 20 20 28 33 29 20 20 50 43 61 63 68 65 2d 6c 6f (3) PCache-lo
0be0: 63 61 6c 20 62 75 6c 6b 20 61 6c 6c 6f 63 61 74 cal bulk allocat
0bf0: 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 74 ion..**.** The t
0c00: 68 69 72 64 20 63 61 73 65 20 69 73 20 61 20 63 hird case is a c
0c10: 68 75 6e 6b 20 6f 66 20 68 65 61 70 20 6d 65 6d hunk of heap mem
0c20: 6f 72 79 20 28 64 65 66 61 75 6c 74 69 6e 67 20 ory (defaulting
0c30: 74 6f 20 31 30 30 20 70 61 67 65 73 20 77 6f 72 to 100 pages wor
0c40: 74 68 29 0a 2a 2a 20 74 68 61 74 20 69 73 20 61 th).** that is a
0c50: 6c 6c 6f 63 61 74 65 64 20 77 68 65 6e 20 74 68 llocated when th
0c60: 65 20 70 61 67 65 20 63 61 63 68 65 20 69 73 20 e page cache is
0c70: 63 72 65 61 74 65 64 2e 20 20 54 68 65 20 73 69 created. The si
0c80: 7a 65 20 6f 66 20 74 68 65 20 6c 6f 63 61 6c 0a ze of the local.
0c90: 2a 2a 20 62 75 6c 6b 20 61 6c 6c 6f 63 61 74 69 ** bulk allocati
0ca0: 6f 6e 20 63 61 6e 20 62 65 20 61 64 6a 75 73 74 on can be adjust
0cb0: 65 64 20 75 73 69 6e 67 20 0a 2a 2a 0a 2a 2a 20 ed using .**.**
0cc0: 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 sqlite3_conf
0cd0: 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 ig(SQLITE_CONFIG
0ce0: 5f 50 41 47 45 43 41 43 48 45 2c 20 28 76 6f 69 _PAGECACHE, (voi
0cf0: 64 2a 29 30 2c 20 30 2c 20 4e 29 2e 0a 2a 2a 0a d*)0, 0, N)..**.
0d00: 2a 2a 20 49 66 20 4e 20 69 73 20 70 6f 73 69 74 ** If N is posit
0d10: 69 76 65 2c 20 74 68 65 6e 20 4e 20 70 61 67 65 ive, then N page
0d20: 73 20 77 6f 72 74 68 20 6f 66 20 6d 65 6d 6f 72 s worth of memor
0d30: 79 20 61 72 65 20 61 6c 6c 6f 63 61 74 65 64 20 y are allocated
0d40: 75 73 69 6e 67 20 61 20 73 69 6e 67 6c 65 0a 2a using a single.*
0d50: 2a 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 * sqlite3Malloc(
0d60: 29 20 63 61 6c 6c 20 61 6e 64 20 74 68 61 74 20 ) call and that
0d70: 6d 65 6d 6f 72 79 20 69 73 20 75 73 65 64 20 66 memory is used f
0d80: 6f 72 20 74 68 65 20 66 69 72 73 74 20 4e 20 70 or the first N p
0d90: 61 67 65 73 20 61 6c 6c 6f 63 61 74 65 64 2e 0a ages allocated..
0da0: 2a 2a 20 4f 72 20 69 66 20 4e 20 69 73 20 6e 65 ** Or if N is ne
0db0: 67 61 74 69 76 65 2c 20 74 68 65 6e 20 2d 31 30 gative, then -10
0dc0: 32 34 2a 4e 20 62 79 74 65 73 20 6f 66 20 6d 65 24*N bytes of me
0dd0: 6d 6f 72 79 20 61 72 65 20 61 6c 6c 6f 63 61 74 mory are allocat
0de0: 65 64 20 61 6e 64 20 75 73 65 64 0a 2a 2a 20 66 ed and used.** f
0df0: 6f 72 20 61 73 20 6d 61 6e 79 20 70 61 67 65 73 or as many pages
0e00: 20 61 73 20 63 61 6e 20 62 65 20 61 63 63 6f 6d as can be accom
0e10: 6f 64 61 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 4f 6e odated..**.** On
0e20: 6c 79 20 6f 6e 65 20 6f 66 20 28 32 29 20 6f 72 ly one of (2) or
0e30: 20 28 33 29 20 63 61 6e 20 62 65 20 75 73 65 64 (3) can be used
0e40: 2e 20 20 4f 6e 63 65 20 74 68 65 20 6d 65 6d 6f . Once the memo
0e50: 72 79 20 61 76 61 69 6c 61 62 6c 65 20 74 6f 20 ry available to
0e60: 28 32 29 20 6f 72 0a 2a 2a 20 28 33 29 20 69 73 (2) or.** (3) is
0e70: 20 65 78 68 61 75 73 74 65 64 2c 20 73 75 62 73 exhausted, subs
0e80: 65 71 75 65 6e 74 20 61 6c 6c 6f 63 61 74 69 6f equent allocatio
0e90: 6e 73 20 66 61 69 6c 20 6f 76 65 72 20 74 6f 20 ns fail over to
0ea0: 74 68 65 20 67 65 6e 65 72 61 6c 2d 70 75 72 70 the general-purp
0eb0: 6f 73 65 0a 2a 2a 20 6d 65 6d 6f 72 79 20 61 6c ose.** memory al
0ec0: 6c 6f 63 61 74 6f 72 20 28 31 29 2e 0a 2a 2a 0a locator (1)..**.
0ed0: 2a 2a 20 45 61 72 6c 69 65 72 20 76 65 72 73 69 ** Earlier versi
0ee0: 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 75 73 ons of SQLite us
0ef0: 65 64 20 6f 6e 6c 79 20 6d 65 74 68 6f 64 73 20 ed only methods
0f00: 28 31 29 20 61 6e 64 20 28 32 29 2e 20 20 42 75 (1) and (2). Bu
0f10: 74 20 65 78 70 65 72 69 6d 65 6e 74 73 0a 2a 2a t experiments.**
0f20: 20 73 68 6f 77 20 74 68 61 74 20 6d 65 74 68 6f show that metho
0f30: 64 20 28 33 29 20 77 69 74 68 20 4e 3d 3d 31 30 d (3) with N==10
0f40: 30 20 70 72 6f 76 69 64 65 73 20 61 62 6f 75 74 0 provides about
0f50: 20 61 20 35 25 20 70 65 72 66 6f 72 6d 61 6e 63 a 5% performanc
0f60: 65 20 62 6f 6f 73 74 20 66 6f 72 0a 2a 2a 20 63 e boost for.** c
0f70: 6f 6d 6d 6f 6e 20 77 6f 72 6b 6c 6f 61 64 73 2e ommon workloads.
0f80: 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 .*/.#include "sq
0f90: 6c 69 74 65 49 6e 74 2e 68 22 0a 0a 74 79 70 65 liteInt.h"..type
0fa0: 64 65 66 20 73 74 72 75 63 74 20 50 43 61 63 68 def struct PCach
0fb0: 65 31 20 50 43 61 63 68 65 31 3b 0a 74 79 70 65 e1 PCache1;.type
0fc0: 64 65 66 20 73 74 72 75 63 74 20 50 67 48 64 72 def struct PgHdr
0fd0: 31 20 50 67 48 64 72 31 3b 0a 74 79 70 65 64 65 1 PgHdr1;.typede
0fe0: 66 20 73 74 72 75 63 74 20 50 67 46 72 65 65 73 f struct PgFrees
0ff0: 6c 6f 74 20 50 67 46 72 65 65 73 6c 6f 74 3b 0a lot PgFreeslot;.
1000: 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 50 typedef struct P
1010: 47 72 6f 75 70 20 50 47 72 6f 75 70 3b 0a 0a 2f Group PGroup;../
1020: 2a 0a 2a 2a 20 45 61 63 68 20 63 61 63 68 65 20 *.** Each cache
1030: 65 6e 74 72 79 20 69 73 20 72 65 70 72 65 73 65 entry is represe
1040: 6e 74 65 64 20 62 79 20 61 6e 20 69 6e 73 74 61 nted by an insta
1050: 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f nce of the follo
1060: 77 69 6e 67 20 0a 2a 2a 20 73 74 72 75 63 74 75 wing .** structu
1070: 72 65 2e 20 55 6e 6c 65 73 73 20 53 51 4c 49 54 re. Unless SQLIT
1080: 45 5f 50 43 41 43 48 45 5f 53 45 50 41 52 41 54 E_PCACHE_SEPARAT
1090: 45 5f 48 45 41 44 45 52 20 69 73 20 64 65 66 69 E_HEADER is defi
10a0: 6e 65 64 2c 20 61 20 62 75 66 66 65 72 20 6f 66 ned, a buffer of
10b0: 0a 2a 2a 20 50 67 48 64 72 31 2e 70 43 61 63 68 .** PgHdr1.pCach
10c0: 65 2d 3e 73 7a 50 61 67 65 20 62 79 74 65 73 20 e->szPage bytes
10d0: 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 64 69 72 is allocated dir
10e0: 65 63 74 6c 79 20 62 65 66 6f 72 65 20 74 68 69 ectly before thi
10f0: 73 20 73 74 72 75 63 74 75 72 65 20 0a 2a 2a 20 s structure .**
1100: 69 6e 20 6d 65 6d 6f 72 79 2e 0a 2a 2f 0a 73 74 in memory..*/.st
1110: 72 75 63 74 20 50 67 48 64 72 31 20 7b 0a 20 20 ruct PgHdr1 {.
1120: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 70 sqlite3_pcache_p
1130: 61 67 65 20 70 61 67 65 3b 20 20 20 20 20 20 2f age page; /
1140: 2a 20 42 61 73 65 20 63 6c 61 73 73 2e 20 4d 75 * Base class. Mu
1150: 73 74 20 62 65 20 66 69 72 73 74 2e 20 70 42 75 st be first. pBu
1160: 66 20 26 20 70 45 78 74 72 61 20 2a 2f 0a 20 20 f & pExtra */.
1170: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4b 65 unsigned int iKe
1180: 79 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f y; /
1190: 2a 20 4b 65 79 20 76 61 6c 75 65 20 28 70 61 67 * Key value (pag
11a0: 65 20 6e 75 6d 62 65 72 29 20 2a 2f 0a 20 20 75 e number) */. u
11b0: 38 20 69 73 42 75 6c 6b 4c 6f 63 61 6c 3b 20 20 8 isBulkLocal;
11c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
11d0: 20 54 68 69 73 20 70 61 67 65 20 66 72 6f 6d 20 This page from
11e0: 62 75 6c 6b 20 6c 6f 63 61 6c 20 73 74 6f 72 61 bulk local stora
11f0: 67 65 20 2a 2f 0a 20 20 75 38 20 69 73 41 6e 63 ge */. u8 isAnc
1200: 68 6f 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 hor;
1210: 20 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 69 /* This i
1220: 73 20 74 68 65 20 50 47 72 6f 75 70 2e 6c 72 75 s the PGroup.lru
1230: 20 65 6c 65 6d 65 6e 74 20 2a 2f 0a 20 20 50 67 element */. Pg
1240: 48 64 72 31 20 2a 70 4e 65 78 74 3b 20 20 20 20 Hdr1 *pNext;
1250: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1260: 4e 65 78 74 20 69 6e 20 68 61 73 68 20 74 61 62 Next in hash tab
1270: 6c 65 20 63 68 61 69 6e 20 2a 2f 0a 20 20 50 43 le chain */. PC
1280: 61 63 68 65 31 20 2a 70 43 61 63 68 65 3b 20 20 ache1 *pCache;
1290: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
12a0: 43 61 63 68 65 20 74 68 61 74 20 63 75 72 72 65 Cache that curre
12b0: 6e 74 6c 79 20 6f 77 6e 73 20 74 68 69 73 20 70 ntly owns this p
12c0: 61 67 65 20 2a 2f 0a 20 20 50 67 48 64 72 31 20 age */. PgHdr1
12d0: 2a 70 4c 72 75 4e 65 78 74 3b 20 20 20 20 20 20 *pLruNext;
12e0: 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 /* Next
12f0: 69 6e 20 4c 52 55 20 6c 69 73 74 20 6f 66 20 75 in LRU list of u
1300: 6e 70 69 6e 6e 65 64 20 70 61 67 65 73 20 2a 2f npinned pages */
1310: 0a 20 20 50 67 48 64 72 31 20 2a 70 4c 72 75 50 . PgHdr1 *pLruP
1320: 72 65 76 3b 20 20 20 20 20 20 20 20 20 20 20 20 rev;
1330: 20 20 2f 2a 20 50 72 65 76 69 6f 75 73 20 69 6e /* Previous in
1340: 20 4c 52 55 20 6c 69 73 74 20 6f 66 20 75 6e 70 LRU list of unp
1350: 69 6e 6e 65 64 20 70 61 67 65 73 20 2a 2f 0a 20 inned pages */.
1360: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1370: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1380: 2f 2a 20 4e 42 3a 20 70 4c 72 75 50 72 65 76 20 /* NB: pLruPrev
1390: 69 73 20 6f 6e 6c 79 20 76 61 6c 69 64 20 69 66 is only valid if
13a0: 20 70 4c 72 75 4e 65 78 74 21 3d 30 20 2a 2f 0a pLruNext!=0 */.
13b0: 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 70 61 67 65 };../*.** A page
13c0: 20 69 73 20 70 69 6e 6e 65 64 20 69 66 20 69 74 is pinned if it
13d0: 20 69 73 20 6e 6f 74 20 6f 6e 20 74 68 65 20 4c is not on the L
13e0: 52 55 20 6c 69 73 74 2e 20 20 54 6f 20 62 65 20 RU list. To be
13f0: 22 70 69 6e 6e 65 64 22 20 6d 65 61 6e 73 0a 2a "pinned" means.*
1400: 2a 20 74 68 61 74 20 74 68 65 20 70 61 67 65 20 * that the page
1410: 69 73 20 69 6e 20 61 63 74 69 76 65 20 75 73 65 is in active use
1420: 20 61 6e 64 20 6d 75 73 74 20 6e 6f 74 20 62 65 and must not be
1430: 20 64 65 61 6c 6c 6f 63 61 74 65 64 2e 0a 2a 2f deallocated..*/
1440: 0a 23 64 65 66 69 6e 65 20 50 41 47 45 5f 49 53 .#define PAGE_IS
1450: 5f 50 49 4e 4e 45 44 28 70 29 20 20 20 20 28 28 _PINNED(p) ((
1460: 70 29 2d 3e 70 4c 72 75 4e 65 78 74 3d 3d 30 29 p)->pLruNext==0)
1470: 0a 23 64 65 66 69 6e 65 20 50 41 47 45 5f 49 53 .#define PAGE_IS
1480: 5f 55 4e 50 49 4e 4e 45 44 28 70 29 20 20 28 28 _UNPINNED(p) ((
1490: 70 29 2d 3e 70 4c 72 75 4e 65 78 74 21 3d 30 29 p)->pLruNext!=0)
14a0: 0a 0a 2f 2a 20 45 61 63 68 20 70 61 67 65 20 63 ../* Each page c
14b0: 61 63 68 65 20 28 6f 72 20 50 43 61 63 68 65 29 ache (or PCache)
14c0: 20 62 65 6c 6f 6e 67 73 20 74 6f 20 61 20 50 47 belongs to a PG
14d0: 72 6f 75 70 2e 20 20 41 20 50 47 72 6f 75 70 20 roup. A PGroup
14e0: 69 73 20 61 20 73 65 74 20 0a 2a 2a 20 6f 66 20 is a set .** of
14f0: 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 50 43 61 63 one or more PCac
1500: 68 65 73 20 74 68 61 74 20 61 72 65 20 61 62 6c hes that are abl
1510: 65 20 74 6f 20 72 65 63 79 63 6c 65 20 65 61 63 e to recycle eac
1520: 68 20 6f 74 68 65 72 27 73 20 75 6e 70 69 6e 6e h other's unpinn
1530: 65 64 0a 2a 2a 20 70 61 67 65 73 20 77 68 65 6e ed.** pages when
1540: 20 74 68 65 79 20 61 72 65 20 75 6e 64 65 72 20 they are under
1550: 6d 65 6d 6f 72 79 20 70 72 65 73 73 75 72 65 2e memory pressure.
1560: 20 20 41 20 50 47 72 6f 75 70 20 69 73 20 61 6e A PGroup is an
1570: 20 69 6e 73 74 61 6e 63 65 20 6f 66 0a 2a 2a 20 instance of.**
1580: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 62 the following ob
1590: 6a 65 63 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 ject..**.** This
15a0: 20 70 61 67 65 20 63 61 63 68 65 20 69 6d 70 6c page cache impl
15b0: 65 6d 65 6e 74 61 74 69 6f 6e 20 77 6f 72 6b 73 ementation works
15c0: 20 69 6e 20 6f 6e 65 20 6f 66 20 74 77 6f 20 6d in one of two m
15d0: 6f 64 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 28 31 odes:.**.** (1
15e0: 29 20 20 45 76 65 72 79 20 50 43 61 63 68 65 20 ) Every PCache
15f0: 69 73 20 74 68 65 20 73 6f 6c 65 20 6d 65 6d 62 is the sole memb
1600: 65 72 20 6f 66 20 69 74 73 20 6f 77 6e 20 50 47 er of its own PG
1610: 72 6f 75 70 2e 20 20 54 68 65 72 65 20 69 73 0a roup. There is.
1620: 2a 2a 20 20 20 20 20 20 20 20 6f 6e 65 20 50 47 ** one PG
1630: 72 6f 75 70 20 70 65 72 20 50 43 61 63 68 65 2e roup per PCache.
1640: 0a 2a 2a 0a 2a 2a 20 20 20 28 32 29 20 20 54 68 .**.** (2) Th
1650: 65 72 65 20 69 73 20 61 20 73 69 6e 67 6c 65 20 ere is a single
1660: 67 6c 6f 62 61 6c 20 50 47 72 6f 75 70 20 74 68 global PGroup th
1670: 61 74 20 61 6c 6c 20 50 43 61 63 68 65 73 20 61 at all PCaches a
1680: 72 65 20 61 20 6d 65 6d 62 65 72 0a 2a 2a 20 20 re a member.**
1690: 20 20 20 20 20 20 6f 66 2e 0a 2a 2a 0a 2a 2a 20 of..**.**
16a0: 4d 6f 64 65 20 31 20 75 73 65 73 20 6d 6f 72 65 Mode 1 uses more
16b0: 20 6d 65 6d 6f 72 79 20 28 73 69 6e 63 65 20 50 memory (since P
16c0: 43 61 63 68 65 20 69 6e 73 74 61 6e 63 65 73 20 Cache instances
16d0: 61 72 65 20 6e 6f 74 20 61 62 6c 65 20 74 6f 20 are not able to
16e0: 72 6f 62 0a 2a 2a 20 75 6e 75 73 65 64 20 70 61 rob.** unused pa
16f0: 67 65 73 20 66 72 6f 6d 20 6f 74 68 65 72 20 50 ges from other P
1700: 43 61 63 68 65 73 29 20 62 75 74 20 69 74 20 61 Caches) but it a
1710: 6c 73 6f 20 6f 70 65 72 61 74 65 73 20 77 69 74 lso operates wit
1720: 68 6f 75 74 20 61 20 6d 75 74 65 78 2c 0a 2a 2a hout a mutex,.**
1730: 20 61 6e 64 20 69 73 20 74 68 65 72 65 66 6f 72 and is therefor
1740: 65 20 6f 66 74 65 6e 20 66 61 73 74 65 72 2e 20 e often faster.
1750: 20 4d 6f 64 65 20 32 20 72 65 71 75 69 72 65 73 Mode 2 requires
1760: 20 61 20 6d 75 74 65 78 20 69 6e 20 6f 72 64 65 a mutex in orde
1770: 72 20 74 6f 20 62 65 0a 2a 2a 20 74 68 72 65 61 r to be.** threa
1780: 64 73 61 66 65 2c 20 62 75 74 20 72 65 63 79 63 dsafe, but recyc
1790: 6c 65 73 20 70 61 67 65 73 20 6d 6f 72 65 20 65 les pages more e
17a0: 66 66 69 63 69 65 6e 74 6c 79 2e 0a 2a 2a 0a 2a fficiently..**.*
17b0: 2a 20 46 6f 72 20 6d 6f 64 65 20 28 31 29 2c 20 * For mode (1),
17c0: 50 47 72 6f 75 70 2e 6d 75 74 65 78 20 69 73 20 PGroup.mutex is
17d0: 4e 55 4c 4c 2e 20 20 46 6f 72 20 6d 6f 64 65 20 NULL. For mode
17e0: 28 32 29 20 74 68 65 72 65 20 69 73 20 6f 6e 6c (2) there is onl
17f0: 79 20 61 20 73 69 6e 67 6c 65 0a 2a 2a 20 50 47 y a single.** PG
1800: 72 6f 75 70 20 77 68 69 63 68 20 69 73 20 74 68 roup which is th
1810: 65 20 70 63 61 63 68 65 31 2e 67 72 70 20 67 6c e pcache1.grp gl
1820: 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 20 61 6e obal variable an
1830: 64 20 69 74 73 20 6d 75 74 65 78 20 69 73 0a 2a d its mutex is.*
1840: 2a 20 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 * SQLITE_MUTEX_S
1850: 54 41 54 49 43 5f 4c 52 55 2e 0a 2a 2f 0a 73 74 TATIC_LRU..*/.st
1860: 72 75 63 74 20 50 47 72 6f 75 70 20 7b 0a 20 20 ruct PGroup {.
1870: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d sqlite3_mutex *m
1880: 75 74 65 78 3b 20 20 20 20 20 20 20 20 20 20 2f utex; /
1890: 2a 20 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c * MUTEX_STATIC_L
18a0: 52 55 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20 RU or NULL */.
18b0: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 4d 61 unsigned int nMa
18c0: 78 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 2f xPage; /
18d0: 2a 20 53 75 6d 20 6f 66 20 6e 4d 61 78 20 66 6f * Sum of nMax fo
18e0: 72 20 70 75 72 67 65 61 62 6c 65 20 63 61 63 68 r purgeable cach
18f0: 65 73 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 es */. unsigned
1900: 20 69 6e 74 20 6e 4d 69 6e 50 61 67 65 3b 20 20 int nMinPage;
1910: 20 20 20 20 20 20 20 2f 2a 20 53 75 6d 20 6f 66 /* Sum of
1920: 20 6e 4d 69 6e 20 66 6f 72 20 70 75 72 67 65 61 nMin for purgea
1930: 62 6c 65 20 63 61 63 68 65 73 20 2a 2f 0a 20 20 ble caches */.
1940: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6d 78 50 unsigned int mxP
1950: 69 6e 6e 65 64 3b 20 20 20 20 20 20 20 20 20 2f inned; /
1960: 2a 20 6e 4d 61 78 70 61 67 65 20 2b 20 31 30 20 * nMaxpage + 10
1970: 2d 20 6e 4d 69 6e 50 61 67 65 20 2a 2f 0a 20 20 - nMinPage */.
1980: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 50 75 unsigned int nPu
1990: 72 67 65 61 62 6c 65 3b 20 20 20 20 20 20 20 2f rgeable; /
19a0: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 75 72 67 * Number of purg
19b0: 65 61 62 6c 65 20 70 61 67 65 73 20 61 6c 6c 6f eable pages allo
19c0: 63 61 74 65 64 20 2a 2f 0a 20 20 50 67 48 64 72 cated */. PgHdr
19d0: 31 20 6c 72 75 3b 20 20 20 20 20 20 20 20 20 20 1 lru;
19e0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 /* The
19f0: 20 62 65 67 69 6e 6e 69 6e 67 20 61 6e 64 20 65 beginning and e
1a00: 6e 64 20 6f 66 20 74 68 65 20 4c 52 55 20 6c 69 nd of the LRU li
1a10: 73 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 45 61 63 st */.};../* Eac
1a20: 68 20 70 61 67 65 20 63 61 63 68 65 20 69 73 20 h page cache is
1a30: 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 an instance of t
1a40: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 62 6a he following obj
1a50: 65 63 74 2e 20 20 45 76 65 72 79 0a 2a 2a 20 6f ect. Every.** o
1a60: 70 65 6e 20 64 61 74 61 62 61 73 65 20 66 69 6c pen database fil
1a70: 65 20 28 69 6e 63 6c 75 64 69 6e 67 20 65 61 63 e (including eac
1a80: 68 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 h in-memory data
1a90: 62 61 73 65 20 61 6e 64 20 65 61 63 68 0a 2a 2a base and each.**
1aa0: 20 74 65 6d 70 6f 72 61 72 79 20 6f 72 20 74 72 temporary or tr
1ab0: 61 6e 73 69 65 6e 74 20 64 61 74 61 62 61 73 65 ansient database
1ac0: 29 20 68 61 73 20 61 20 73 69 6e 67 6c 65 20 70 ) has a single p
1ad0: 61 67 65 20 63 61 63 68 65 20 77 68 69 63 68 0a age cache which.
1ae0: 2a 2a 20 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 ** is an instanc
1af0: 65 20 6f 66 20 74 68 69 73 20 6f 62 6a 65 63 74 e of this object
1b00: 2e 0a 2a 2a 0a 2a 2a 20 50 6f 69 6e 74 65 72 73 ..**.** Pointers
1b10: 20 74 6f 20 73 74 72 75 63 74 75 72 65 73 20 6f to structures o
1b20: 66 20 74 68 69 73 20 74 79 70 65 20 61 72 65 20 f this type are
1b30: 63 61 73 74 20 61 6e 64 20 72 65 74 75 72 6e 65 cast and returne
1b40: 64 20 61 73 20 0a 2a 2a 20 6f 70 61 71 75 65 20 d as .** opaque
1b50: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2a 20 sqlite3_pcache*
1b60: 68 61 6e 64 6c 65 73 2e 0a 2a 2f 0a 73 74 72 75 handles..*/.stru
1b70: 63 74 20 50 43 61 63 68 65 31 20 7b 0a 20 20 2f ct PCache1 {. /
1b80: 2a 20 43 61 63 68 65 20 63 6f 6e 66 69 67 75 72 * Cache configur
1b90: 61 74 69 6f 6e 20 70 61 72 61 6d 65 74 65 72 73 ation parameters
1ba0: 2e 20 50 61 67 65 20 73 69 7a 65 20 28 73 7a 50 . Page size (szP
1bb0: 61 67 65 29 20 61 6e 64 20 74 68 65 20 70 75 72 age) and the pur
1bc0: 67 65 61 62 6c 65 0a 20 20 2a 2a 20 66 6c 61 67 geable. ** flag
1bd0: 20 28 62 50 75 72 67 65 61 62 6c 65 29 20 61 6e (bPurgeable) an
1be0: 64 20 74 68 65 20 70 6e 50 75 72 67 65 61 62 6c d the pnPurgeabl
1bf0: 65 20 70 6f 69 6e 74 65 72 20 61 72 65 20 61 6c e pointer are al
1c00: 6c 20 73 65 74 20 77 68 65 6e 20 74 68 65 0a 20 l set when the.
1c10: 20 2a 2a 20 63 61 63 68 65 20 69 73 20 63 72 65 ** cache is cre
1c20: 61 74 65 64 20 61 6e 64 20 61 72 65 20 6e 65 76 ated and are nev
1c30: 65 72 20 63 68 61 6e 67 65 64 20 74 68 65 72 65 er changed there
1c40: 61 66 74 65 72 2e 20 6e 4d 61 78 20 6d 61 79 20 after. nMax may
1c50: 62 65 20 0a 20 20 2a 2a 20 6d 6f 64 69 66 69 65 be . ** modifie
1c60: 64 20 61 74 20 61 6e 79 20 74 69 6d 65 20 62 79 d at any time by
1c70: 20 61 20 63 61 6c 6c 20 74 6f 20 74 68 65 20 70 a call to the p
1c80: 63 61 63 68 65 31 43 61 63 68 65 73 69 7a 65 28 cache1Cachesize(
1c90: 29 20 6d 65 74 68 6f 64 2e 0a 20 20 2a 2a 20 54 ) method.. ** T
1ca0: 68 65 20 50 47 72 6f 75 70 20 6d 75 74 65 78 20 he PGroup mutex
1cb0: 6d 75 73 74 20 62 65 20 68 65 6c 64 20 77 68 65 must be held whe
1cc0: 6e 20 61 63 63 65 73 73 69 6e 67 20 6e 4d 61 78 n accessing nMax
1cd0: 2e 0a 20 20 2a 2f 0a 20 20 50 47 72 6f 75 70 20 .. */. PGroup
1ce0: 2a 70 47 72 6f 75 70 3b 20 20 20 20 20 20 20 20 *pGroup;
1cf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1d00: 50 47 72 6f 75 70 20 74 68 69 73 20 63 61 63 68 PGroup this cach
1d10: 65 20 62 65 6c 6f 6e 67 73 20 74 6f 20 2a 2f 0a e belongs to */.
1d20: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 2a unsigned int *
1d30: 70 6e 50 75 72 67 65 61 62 6c 65 3b 20 20 20 20 pnPurgeable;
1d40: 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 /* Pointer
1d50: 20 74 6f 20 70 47 72 6f 75 70 2d 3e 6e 50 75 72 to pGroup->nPur
1d60: 67 65 61 62 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 geable */. int
1d70: 73 7a 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 szPage;
1d80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d90: 2f 2a 20 53 69 7a 65 20 6f 66 20 64 61 74 61 62 /* Size of datab
1da0: 61 73 65 20 63 6f 6e 74 65 6e 74 20 73 65 63 74 ase content sect
1db0: 69 6f 6e 20 2a 2f 0a 20 20 69 6e 74 20 73 7a 45 ion */. int szE
1dc0: 78 74 72 61 3b 20 20 20 20 20 20 20 20 20 20 20 xtra;
1dd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1de0: 73 69 7a 65 6f 66 28 4d 65 6d 50 61 67 65 29 2b sizeof(MemPage)+
1df0: 73 69 7a 65 6f 66 28 50 67 48 64 72 29 20 2a 2f sizeof(PgHdr) */
1e00: 0a 20 20 69 6e 74 20 73 7a 41 6c 6c 6f 63 3b 20 . int szAlloc;
1e10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e20: 20 20 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 /* Total
1e30: 73 69 7a 65 20 6f 66 20 6f 6e 65 20 70 63 61 63 size of one pcac
1e40: 68 65 20 6c 69 6e 65 20 2a 2f 0a 20 20 69 6e 74 he line */. int
1e50: 20 62 50 75 72 67 65 61 62 6c 65 3b 20 20 20 20 bPurgeable;
1e60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e70: 20 2f 2a 20 54 72 75 65 20 69 66 20 63 61 63 68 /* True if cach
1e80: 65 20 69 73 20 70 75 72 67 65 61 62 6c 65 20 2a e is purgeable *
1e90: 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 /. unsigned int
1ea0: 20 6e 4d 69 6e 3b 20 20 20 20 20 20 20 20 20 20 nMin;
1eb0: 20 20 20 20 20 20 20 20 2f 2a 20 4d 69 6e 69 6d /* Minim
1ec0: 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 um number of pag
1ed0: 65 73 20 72 65 73 65 72 76 65 64 20 2a 2f 0a 20 es reserved */.
1ee0: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 4d unsigned int nM
1ef0: 61 78 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ax;
1f00: 20 20 20 20 20 2f 2a 20 43 6f 6e 66 69 67 75 72 /* Configur
1f10: 65 64 20 22 63 61 63 68 65 5f 73 69 7a 65 22 20 ed "cache_size"
1f20: 76 61 6c 75 65 20 2a 2f 0a 20 20 75 6e 73 69 67 value */. unsig
1f30: 6e 65 64 20 69 6e 74 20 6e 39 30 70 63 74 3b 20 ned int n90pct;
1f40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1f50: 2a 20 6e 4d 61 78 2a 39 2f 31 30 20 2a 2f 0a 20 * nMax*9/10 */.
1f60: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4d unsigned int iM
1f70: 61 78 4b 65 79 3b 20 20 20 20 20 20 20 20 20 20 axKey;
1f80: 20 20 20 20 20 2f 2a 20 4c 61 72 67 65 73 74 20 /* Largest
1f90: 6b 65 79 20 73 65 65 6e 20 73 69 6e 63 65 20 78 key seen since x
1fa0: 54 72 75 6e 63 61 74 65 28 29 20 2a 2f 0a 0a 20 Truncate() */..
1fb0: 20 2f 2a 20 48 61 73 68 20 74 61 62 6c 65 20 6f /* Hash table o
1fc0: 66 20 61 6c 6c 20 70 61 67 65 73 2e 20 54 68 65 f all pages. The
1fd0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 76 61 72 69 61 following varia
1fe0: 62 6c 65 73 20 6d 61 79 20 6f 6e 6c 79 20 62 65 bles may only be
1ff0: 20 61 63 63 65 73 73 65 64 0a 20 20 2a 2a 20 77 accessed. ** w
2000: 68 65 6e 20 74 68 65 20 61 63 63 65 73 73 6f 72 hen the accessor
2010: 20 69 73 20 68 6f 6c 64 69 6e 67 20 74 68 65 20 is holding the
2020: 50 47 72 6f 75 70 20 6d 75 74 65 78 2e 0a 20 20 PGroup mutex..
2030: 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e */. unsigned in
2040: 74 20 6e 52 65 63 79 63 6c 61 62 6c 65 3b 20 20 t nRecyclable;
2050: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
2060: 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 er of pages in t
2070: 68 65 20 4c 52 55 20 6c 69 73 74 20 2a 2f 0a 20 he LRU list */.
2080: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 50 unsigned int nP
2090: 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 age;
20a0: 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 6e 75 /* Total nu
20b0: 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e mber of pages in
20c0: 20 61 70 48 61 73 68 20 2a 2f 0a 20 20 75 6e 73 apHash */. uns
20d0: 69 67 6e 65 64 20 69 6e 74 20 6e 48 61 73 68 3b igned int nHash;
20e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20f0: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 73 6c /* Number of sl
2100: 6f 74 73 20 69 6e 20 61 70 48 61 73 68 5b 5d 20 ots in apHash[]
2110: 2a 2f 0a 20 20 50 67 48 64 72 31 20 2a 2a 61 70 */. PgHdr1 **ap
2120: 48 61 73 68 3b 20 20 20 20 20 20 20 20 20 20 20 Hash;
2130: 20 20 20 20 20 20 20 20 20 2f 2a 20 48 61 73 68 /* Hash
2140: 20 74 61 62 6c 65 20 66 6f 72 20 66 61 73 74 20 table for fast
2150: 6c 6f 6f 6b 75 70 20 62 79 20 6b 65 79 20 2a 2f lookup by key */
2160: 0a 20 20 50 67 48 64 72 31 20 2a 70 46 72 65 65 . PgHdr1 *pFree
2170: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
2180: 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f /* List o
2190: 66 20 75 6e 75 73 65 64 20 70 63 61 63 68 65 2d f unused pcache-
21a0: 6c 6f 63 61 6c 20 70 61 67 65 73 20 2a 2f 0a 20 local pages */.
21b0: 20 76 6f 69 64 20 2a 70 42 75 6c 6b 3b 20 20 20 void *pBulk;
21c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21d0: 20 20 20 20 20 2f 2a 20 42 75 6c 6b 20 6d 65 6d /* Bulk mem
21e0: 6f 72 79 20 75 73 65 64 20 62 79 20 70 63 61 63 ory used by pcac
21f0: 68 65 2d 6c 6f 63 61 6c 20 2a 2f 0a 7d 3b 0a 0a he-local */.};..
2200: 2f 2a 0a 2a 2a 20 46 72 65 65 20 73 6c 6f 74 73 /*.** Free slots
2210: 20 69 6e 20 74 68 65 20 61 6c 6c 6f 63 61 74 6f in the allocato
2220: 72 20 75 73 65 64 20 74 6f 20 64 69 76 69 64 65 r used to divide
2230: 20 75 70 20 74 68 65 20 67 6c 6f 62 61 6c 20 70 up the global p
2240: 61 67 65 20 63 61 63 68 65 0a 2a 2a 20 62 75 66 age cache.** buf
2250: 66 65 72 20 70 72 6f 76 69 64 65 64 20 75 73 69 fer provided usi
2260: 6e 67 20 74 68 65 20 53 51 4c 49 54 45 5f 43 4f ng the SQLITE_CO
2270: 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45 20 6d NFIG_PAGECACHE m
2280: 65 63 68 61 6e 69 73 6d 2e 0a 2a 2f 0a 73 74 72 echanism..*/.str
2290: 75 63 74 20 50 67 46 72 65 65 73 6c 6f 74 20 7b uct PgFreeslot {
22a0: 0a 20 20 50 67 46 72 65 65 73 6c 6f 74 20 2a 70 . PgFreeslot *p
22b0: 4e 65 78 74 3b 20 20 2f 2a 20 4e 65 78 74 20 66 Next; /* Next f
22c0: 72 65 65 20 73 6c 6f 74 20 2a 2f 0a 7d 3b 0a 0a ree slot */.};..
22d0: 2f 2a 0a 2a 2a 20 47 6c 6f 62 61 6c 20 64 61 74 /*.** Global dat
22e0: 61 20 75 73 65 64 20 62 79 20 74 68 69 73 20 63 a used by this c
22f0: 61 63 68 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 ache..*/.static
2300: 53 51 4c 49 54 45 5f 57 53 44 20 73 74 72 75 63 SQLITE_WSD struc
2310: 74 20 50 43 61 63 68 65 47 6c 6f 62 61 6c 20 7b t PCacheGlobal {
2320: 0a 20 20 50 47 72 6f 75 70 20 67 72 70 3b 20 20 . PGroup grp;
2330: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2340: 20 20 2f 2a 20 54 68 65 20 67 6c 6f 62 61 6c 20 /* The global
2350: 50 47 72 6f 75 70 20 66 6f 72 20 6d 6f 64 65 20 PGroup for mode
2360: 28 32 29 20 2a 2f 0a 0a 20 20 2f 2a 20 56 61 72 (2) */.. /* Var
2370: 69 61 62 6c 65 73 20 72 65 6c 61 74 65 64 20 74 iables related t
2380: 6f 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f o SQLITE_CONFIG_
2390: 50 41 47 45 43 41 43 48 45 20 73 65 74 74 69 6e PAGECACHE settin
23a0: 67 73 2e 20 20 54 68 65 0a 20 20 2a 2a 20 73 7a gs. The. ** sz
23b0: 53 6c 6f 74 2c 20 6e 53 6c 6f 74 2c 20 70 53 74 Slot, nSlot, pSt
23c0: 61 72 74 2c 20 70 45 6e 64 2c 20 6e 52 65 73 65 art, pEnd, nRese
23d0: 72 76 65 2c 20 61 6e 64 20 69 73 49 6e 69 74 20 rve, and isInit
23e0: 76 61 6c 75 65 73 20 61 72 65 20 61 6c 6c 0a 20 values are all.
23f0: 20 2a 2a 20 66 69 78 65 64 20 61 74 20 73 71 6c ** fixed at sql
2400: 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 ite3_initialize(
2410: 29 20 74 69 6d 65 20 61 6e 64 20 64 6f 20 6e 6f ) time and do no
2420: 74 20 72 65 71 75 69 72 65 20 6d 75 74 65 78 20 t require mutex
2430: 70 72 6f 74 65 63 74 69 6f 6e 2e 0a 20 20 2a 2a protection.. **
2440: 20 54 68 65 20 6e 46 72 65 65 53 6c 6f 74 20 61 The nFreeSlot a
2450: 6e 64 20 70 46 72 65 65 20 76 61 6c 75 65 73 20 nd pFree values
2460: 64 6f 20 72 65 71 75 69 72 65 20 6d 75 74 65 78 do require mutex
2470: 20 70 72 6f 74 65 63 74 69 6f 6e 2e 0a 20 20 2a protection.. *
2480: 2f 0a 20 20 69 6e 74 20 69 73 49 6e 69 74 3b 20 /. int isInit;
2490: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24a0: 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 69 6e /* True if in
24b0: 69 74 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 20 69 itialized */. i
24c0: 6e 74 20 73 65 70 61 72 61 74 65 43 61 63 68 65 nt separateCache
24d0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a ; /*
24e0: 20 55 73 65 20 61 20 6e 65 77 20 50 47 72 6f 75 Use a new PGrou
24f0: 70 20 66 6f 72 20 65 61 63 68 20 50 43 61 63 68 p for each PCach
2500: 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 49 6e 69 74 e */. int nInit
2510: 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 Page;
2520: 20 20 20 20 20 20 2f 2a 20 49 6e 69 74 69 61 6c /* Initial
2530: 20 62 75 6c 6b 20 61 6c 6c 6f 63 61 74 69 6f 6e bulk allocation
2540: 20 73 69 7a 65 20 2a 2f 20 20 20 0a 20 20 69 6e size */ . in
2550: 74 20 73 7a 53 6c 6f 74 3b 20 20 20 20 20 20 20 t szSlot;
2560: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
2570: 53 69 7a 65 20 6f 66 20 65 61 63 68 20 66 72 65 Size of each fre
2580: 65 20 73 6c 6f 74 20 2a 2f 0a 20 20 69 6e 74 20 e slot */. int
2590: 6e 53 6c 6f 74 3b 20 20 20 20 20 20 20 20 20 20 nSlot;
25a0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
25b0: 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 63 61 63 e number of pcac
25c0: 68 65 20 73 6c 6f 74 73 20 2a 2f 0a 20 20 69 6e he slots */. in
25d0: 74 20 6e 52 65 73 65 72 76 65 3b 20 20 20 20 20 t nReserve;
25e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
25f0: 54 72 79 20 74 6f 20 6b 65 65 70 20 6e 46 72 65 Try to keep nFre
2600: 65 53 6c 6f 74 20 61 62 6f 76 65 20 74 68 69 73 eSlot above this
2610: 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 53 74 61 */. void *pSta
2620: 72 74 2c 20 2a 70 45 6e 64 3b 20 20 20 20 20 20 rt, *pEnd;
2630: 20 20 20 20 20 2f 2a 20 42 6f 75 6e 64 73 20 6f /* Bounds o
2640: 66 20 67 6c 6f 62 61 6c 20 70 61 67 65 20 63 61 f global page ca
2650: 63 68 65 20 6d 65 6d 6f 72 79 20 2a 2f 0a 20 20 che memory */.
2660: 2f 2a 20 41 62 6f 76 65 20 72 65 71 75 69 72 65 /* Above require
2670: 73 20 6e 6f 20 6d 75 74 65 78 2e 20 20 55 73 65 s no mutex. Use
2680: 20 6d 75 74 65 78 20 62 65 6c 6f 77 20 66 6f 72 mutex below for
2690: 20 76 61 72 69 61 62 6c 65 20 74 68 61 74 20 66 variable that f
26a0: 6f 6c 6c 6f 77 2e 20 2a 2f 0a 20 20 73 71 6c 69 ollow. */. sqli
26b0: 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 te3_mutex *mutex
26c0: 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 75 ; /* Mu
26d0: 74 65 78 20 66 6f 72 20 61 63 63 65 73 73 69 6e tex for accessin
26e0: 67 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a g the following:
26f0: 20 2a 2f 0a 20 20 50 67 46 72 65 65 73 6c 6f 74 */. PgFreeslot
2700: 20 2a 70 46 72 65 65 3b 20 20 20 20 20 20 20 20 *pFree;
2710: 20 20 20 20 20 2f 2a 20 46 72 65 65 20 70 61 67 /* Free pag
2720: 65 20 62 6c 6f 63 6b 73 20 2a 2f 0a 20 20 69 6e e blocks */. in
2730: 74 20 6e 46 72 65 65 53 6c 6f 74 3b 20 20 20 20 t nFreeSlot;
2740: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
2750: 4e 75 6d 62 65 72 20 6f 66 20 75 6e 75 73 65 64 Number of unused
2760: 20 70 63 61 63 68 65 20 73 6c 6f 74 73 20 2a 2f pcache slots */
2770: 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 . /* The follow
2780: 69 6e 67 20 76 61 6c 75 65 20 72 65 71 75 69 72 ing value requir
2790: 65 73 20 61 20 6d 75 74 65 78 20 74 6f 20 63 68 es a mutex to ch
27a0: 61 6e 67 65 2e 20 20 57 65 20 73 6b 69 70 20 74 ange. We skip t
27b0: 68 65 20 6d 75 74 65 78 20 6f 6e 0a 20 20 2a 2a he mutex on. **
27c0: 20 72 65 61 64 69 6e 67 20 62 65 63 61 75 73 65 reading because
27d0: 20 28 31 29 20 6d 6f 73 74 20 70 6c 61 74 66 6f (1) most platfo
27e0: 72 6d 73 20 72 65 61 64 20 61 20 33 32 2d 62 69 rms read a 32-bi
27f0: 74 20 69 6e 74 65 67 65 72 20 61 74 6f 6d 69 63 t integer atomic
2800: 61 6c 6c 79 20 61 6e 64 0a 20 20 2a 2a 20 28 32 ally and. ** (2
2810: 29 20 65 76 65 6e 20 69 66 20 61 6e 20 69 6e 63 ) even if an inc
2820: 6f 72 72 65 63 74 20 76 61 6c 75 65 20 69 73 20 orrect value is
2830: 72 65 61 64 2c 20 6e 6f 20 67 72 65 61 74 20 68 read, no great h
2840: 61 72 6d 20 69 73 20 64 6f 6e 65 20 73 69 6e 63 arm is done sinc
2850: 65 20 74 68 69 73 0a 20 20 2a 2a 20 69 73 20 72 e this. ** is r
2860: 65 61 6c 6c 79 20 6a 75 73 74 20 61 6e 20 6f 70 eally just an op
2870: 74 69 6d 69 7a 61 74 69 6f 6e 2e 20 2a 2f 0a 20 timization. */.
2880: 20 69 6e 74 20 62 55 6e 64 65 72 50 72 65 73 73 int bUnderPress
2890: 75 72 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ure;
28a0: 2f 2a 20 54 72 75 65 20 69 66 20 6c 6f 77 20 6f /* True if low o
28b0: 6e 20 50 41 47 45 43 41 43 48 45 20 6d 65 6d 6f n PAGECACHE memo
28c0: 72 79 20 2a 2f 0a 7d 20 70 63 61 63 68 65 31 5f ry */.} pcache1_
28d0: 67 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 20 63 6f g;../*.** All co
28e0: 64 65 20 69 6e 20 74 68 69 73 20 66 69 6c 65 20 de in this file
28f0: 73 68 6f 75 6c 64 20 61 63 63 65 73 73 20 74 68 should access th
2900: 65 20 67 6c 6f 62 61 6c 20 73 74 72 75 63 74 75 e global structu
2910: 72 65 20 61 62 6f 76 65 20 76 69 61 20 74 68 65 re above via the
2920: 0a 2a 2a 20 61 6c 69 61 73 20 22 70 63 61 63 68 .** alias "pcach
2930: 65 31 22 2e 20 54 68 69 73 20 65 6e 73 75 72 65 e1". This ensure
2940: 73 20 74 68 61 74 20 74 68 65 20 57 53 44 20 65 s that the WSD e
2950: 6d 75 6c 61 74 69 6f 6e 20 69 73 20 75 73 65 64 mulation is used
2960: 20 77 68 65 6e 0a 2a 2a 20 63 6f 6d 70 69 6c 69 when.** compili
2970: 6e 67 20 66 6f 72 20 73 79 73 74 65 6d 73 20 74 ng for systems t
2980: 68 61 74 20 64 6f 20 6e 6f 74 20 73 75 70 70 6f hat do not suppo
2990: 72 74 20 72 65 61 6c 20 57 53 44 2e 0a 2a 2f 0a rt real WSD..*/.
29a0: 23 64 65 66 69 6e 65 20 70 63 61 63 68 65 31 20 #define pcache1
29b0: 28 47 4c 4f 42 41 4c 28 73 74 72 75 63 74 20 50 (GLOBAL(struct P
29c0: 43 61 63 68 65 47 6c 6f 62 61 6c 2c 20 70 63 61 CacheGlobal, pca
29d0: 63 68 65 31 5f 67 29 29 0a 0a 2f 2a 0a 2a 2a 20 che1_g))../*.**
29e0: 4d 61 63 72 6f 73 20 74 6f 20 65 6e 74 65 72 20 Macros to enter
29f0: 61 6e 64 20 6c 65 61 76 65 20 74 68 65 20 50 43 and leave the PC
2a00: 61 63 68 65 20 4c 52 55 20 6d 75 74 65 78 2e 0a ache LRU mutex..
2a10: 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 */.#if !defined(
2a20: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 SQLITE_ENABLE_ME
2a30: 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 29 MORY_MANAGEMENT)
2a40: 20 7c 7c 20 53 51 4c 49 54 45 5f 54 48 52 45 41 || SQLITE_THREA
2a50: 44 53 41 46 45 3d 3d 30 0a 23 20 64 65 66 69 6e DSAFE==0.# defin
2a60: 65 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d 75 e pcache1EnterMu
2a70: 74 65 78 28 58 29 20 20 61 73 73 65 72 74 28 28 tex(X) assert((
2a80: 58 29 2d 3e 6d 75 74 65 78 3d 3d 30 29 0a 23 20 X)->mutex==0).#
2a90: 64 65 66 69 6e 65 20 70 63 61 63 68 65 31 4c 65 define pcache1Le
2aa0: 61 76 65 4d 75 74 65 78 28 58 29 20 20 61 73 73 aveMutex(X) ass
2ab0: 65 72 74 28 28 58 29 2d 3e 6d 75 74 65 78 3d 3d ert((X)->mutex==
2ac0: 30 29 0a 23 20 64 65 66 69 6e 65 20 50 43 41 43 0).# define PCAC
2ad0: 48 45 31 5f 4d 49 47 48 54 5f 55 53 45 5f 47 52 HE1_MIGHT_USE_GR
2ae0: 4f 55 50 5f 4d 55 54 45 58 20 30 0a 23 65 6c 73 OUP_MUTEX 0.#els
2af0: 65 0a 23 20 64 65 66 69 6e 65 20 70 63 61 63 68 e.# define pcach
2b00: 65 31 45 6e 74 65 72 4d 75 74 65 78 28 58 29 20 e1EnterMutex(X)
2b10: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e sqlite3_mutex_en
2b20: 74 65 72 28 28 58 29 2d 3e 6d 75 74 65 78 29 0a ter((X)->mutex).
2b30: 23 20 64 65 66 69 6e 65 20 70 63 61 63 68 65 31 # define pcache1
2b40: 4c 65 61 76 65 4d 75 74 65 78 28 58 29 20 73 71 LeaveMutex(X) sq
2b50: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
2b60: 65 28 28 58 29 2d 3e 6d 75 74 65 78 29 0a 23 20 e((X)->mutex).#
2b70: 64 65 66 69 6e 65 20 50 43 41 43 48 45 31 5f 4d define PCACHE1_M
2b80: 49 47 48 54 5f 55 53 45 5f 47 52 4f 55 50 5f 4d IGHT_USE_GROUP_M
2b90: 55 54 45 58 20 31 0a 23 65 6e 64 69 66 0a 0a 2f UTEX 1.#endif../
2ba0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
2bb0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
2bc0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
2bd0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
2be0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a **************/.
2bf0: 2f 2a 2a 2a 2a 2a 2a 2a 2a 20 50 61 67 65 20 41 /******** Page A
2c00: 6c 6c 6f 63 61 74 69 6f 6e 2f 53 51 4c 49 54 45 llocation/SQLITE
2c10: 5f 43 4f 4e 46 49 47 5f 50 43 41 43 48 45 20 52 _CONFIG_PCACHE R
2c20: 65 6c 61 74 65 64 20 46 75 6e 63 74 69 6f 6e 73 elated Functions
2c30: 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f **************/
2c40: 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 .../*.** This fu
2c50: 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 nction is called
2c60: 20 64 75 72 69 6e 67 20 69 6e 69 74 69 61 6c 69 during initiali
2c70: 7a 61 74 69 6f 6e 20 69 66 20 61 20 73 74 61 74 zation if a stat
2c80: 69 63 20 62 75 66 66 65 72 20 69 73 20 0a 2a 2a ic buffer is .**
2c90: 20 73 75 70 70 6c 69 65 64 20 74 6f 20 75 73 65 supplied to use
2ca0: 20 66 6f 72 20 74 68 65 20 70 61 67 65 2d 63 61 for the page-ca
2cb0: 63 68 65 20 62 79 20 70 61 73 73 69 6e 67 20 74 che by passing t
2cc0: 68 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 he SQLITE_CONFIG
2cd0: 5f 50 41 47 45 43 41 43 48 45 0a 2a 2a 20 76 65 _PAGECACHE.** ve
2ce0: 72 62 20 74 6f 20 73 71 6c 69 74 65 33 5f 63 6f rb to sqlite3_co
2cf0: 6e 66 69 67 28 29 2e 20 50 61 72 61 6d 65 74 65 nfig(). Paramete
2d00: 72 20 70 42 75 66 20 70 6f 69 6e 74 73 20 74 6f r pBuf points to
2d10: 20 61 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 6c an allocation l
2d20: 61 72 67 65 0a 2a 2a 20 65 6e 6f 75 67 68 20 74 arge.** enough t
2d30: 6f 20 63 6f 6e 74 61 69 6e 20 27 6e 27 20 62 75 o contain 'n' bu
2d40: 66 66 65 72 73 20 6f 66 20 27 73 7a 27 20 62 79 ffers of 'sz' by
2d50: 74 65 73 20 65 61 63 68 2e 0a 2a 2a 0a 2a 2a 20 tes each..**.**
2d60: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 This routine is
2d70: 63 61 6c 6c 65 64 20 66 72 6f 6d 20 73 71 6c 69 called from sqli
2d80: 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 te3_initialize()
2d90: 20 61 6e 64 20 73 6f 20 69 74 20 69 73 20 67 75 and so it is gu
2da0: 61 72 61 6e 74 65 65 64 0a 2a 2a 20 74 6f 20 62 aranteed.** to b
2db0: 65 20 73 65 72 69 61 6c 69 7a 65 64 20 61 6c 72 e serialized alr
2dc0: 65 61 64 79 2e 20 20 54 68 65 72 65 20 69 73 20 eady. There is
2dd0: 6e 6f 20 6e 65 65 64 20 66 6f 72 20 66 75 72 74 no need for furt
2de0: 68 65 72 20 6d 75 74 65 78 69 6e 67 2e 0a 2a 2f her mutexing..*/
2df0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 43 61 .void sqlite3PCa
2e00: 63 68 65 42 75 66 66 65 72 53 65 74 75 70 28 76 cheBufferSetup(v
2e10: 6f 69 64 20 2a 70 42 75 66 2c 20 69 6e 74 20 73 oid *pBuf, int s
2e20: 7a 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 69 66 28 z, int n){. if(
2e30: 20 70 63 61 63 68 65 31 2e 69 73 49 6e 69 74 20 pcache1.isInit
2e40: 29 7b 0a 20 20 20 20 50 67 46 72 65 65 73 6c 6f ){. PgFreeslo
2e50: 74 20 2a 70 3b 0a 20 20 20 20 69 66 28 20 70 42 t *p;. if( pB
2e60: 75 66 3d 3d 30 20 29 20 73 7a 20 3d 20 6e 20 3d uf==0 ) sz = n =
2e70: 20 30 3b 0a 20 20 20 20 69 66 28 20 6e 3d 3d 30 0;. if( n==0
2e80: 20 29 20 73 7a 20 3d 20 30 3b 0a 20 20 20 20 73 ) sz = 0;. s
2e90: 7a 20 3d 20 52 4f 55 4e 44 44 4f 57 4e 38 28 73 z = ROUNDDOWN8(s
2ea0: 7a 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e z);. pcache1.
2eb0: 73 7a 53 6c 6f 74 20 3d 20 73 7a 3b 0a 20 20 20 szSlot = sz;.
2ec0: 20 70 63 61 63 68 65 31 2e 6e 53 6c 6f 74 20 3d pcache1.nSlot =
2ed0: 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65 53 6c pcache1.nFreeSl
2ee0: 6f 74 20 3d 20 6e 3b 0a 20 20 20 20 70 63 61 63 ot = n;. pcac
2ef0: 68 65 31 2e 6e 52 65 73 65 72 76 65 20 3d 20 6e he1.nReserve = n
2f00: 3e 39 30 20 3f 20 31 30 20 3a 20 28 6e 2f 31 30 >90 ? 10 : (n/10
2f10: 20 2b 20 31 29 3b 0a 20 20 20 20 70 63 61 63 68 + 1);. pcach
2f20: 65 31 2e 70 53 74 61 72 74 20 3d 20 70 42 75 66 e1.pStart = pBuf
2f30: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e 70 46 ;. pcache1.pF
2f40: 72 65 65 20 3d 20 30 3b 0a 20 20 20 20 70 63 61 ree = 0;. pca
2f50: 63 68 65 31 2e 62 55 6e 64 65 72 50 72 65 73 73 che1.bUnderPress
2f60: 75 72 65 20 3d 20 30 3b 0a 20 20 20 20 77 68 69 ure = 0;. whi
2f70: 6c 65 28 20 6e 2d 2d 20 29 7b 0a 20 20 20 20 20 le( n-- ){.
2f80: 20 70 20 3d 20 28 50 67 46 72 65 65 73 6c 6f 74 p = (PgFreeslot
2f90: 2a 29 70 42 75 66 3b 0a 20 20 20 20 20 20 70 2d *)pBuf;. p-
2fa0: 3e 70 4e 65 78 74 20 3d 20 70 63 61 63 68 65 31 >pNext = pcache1
2fb0: 2e 70 46 72 65 65 3b 0a 20 20 20 20 20 20 70 63 .pFree;. pc
2fc0: 61 63 68 65 31 2e 70 46 72 65 65 20 3d 20 70 3b ache1.pFree = p;
2fd0: 0a 20 20 20 20 20 20 70 42 75 66 20 3d 20 28 76 . pBuf = (v
2fe0: 6f 69 64 2a 29 26 28 28 63 68 61 72 2a 29 70 42 oid*)&((char*)pB
2ff0: 75 66 29 5b 73 7a 5d 3b 0a 20 20 20 20 7d 0a 20 uf)[sz];. }.
3000: 20 20 20 70 63 61 63 68 65 31 2e 70 45 6e 64 20 pcache1.pEnd
3010: 3d 20 70 42 75 66 3b 0a 20 20 7d 0a 7d 0a 0a 2f = pBuf;. }.}../
3020: 2a 0a 2a 2a 20 54 72 79 20 74 6f 20 69 6e 69 74 *.** Try to init
3030: 69 61 6c 69 7a 65 20 74 68 65 20 70 43 61 63 68 ialize the pCach
3040: 65 2d 3e 70 46 72 65 65 20 61 6e 64 20 70 43 61 e->pFree and pCa
3050: 63 68 65 2d 3e 70 42 75 6c 6b 20 66 69 65 6c 64 che->pBulk field
3060: 73 2e 20 20 52 65 74 75 72 6e 0a 2a 2a 20 74 72 s. Return.** tr
3070: 75 65 20 69 66 20 70 43 61 63 68 65 2d 3e 70 46 ue if pCache->pF
3080: 72 65 65 20 65 6e 64 73 20 75 70 20 63 6f 6e 74 ree ends up cont
3090: 61 69 6e 69 6e 67 20 6f 6e 65 20 6f 72 20 6d 6f aining one or mo
30a0: 72 65 20 66 72 65 65 20 70 61 67 65 73 2e 0a 2a re free pages..*
30b0: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 63 61 /.static int pca
30c0: 63 68 65 31 49 6e 69 74 42 75 6c 6b 28 50 43 61 che1InitBulk(PCa
30d0: 63 68 65 31 20 2a 70 43 61 63 68 65 29 7b 0a 20 che1 *pCache){.
30e0: 20 69 36 34 20 73 7a 42 75 6c 6b 3b 0a 20 20 63 i64 szBulk;. c
30f0: 68 61 72 20 2a 7a 42 75 6c 6b 3b 0a 20 20 69 66 har *zBulk;. if
3100: 28 20 70 63 61 63 68 65 31 2e 6e 49 6e 69 74 50 ( pcache1.nInitP
3110: 61 67 65 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 age==0 ) return
3120: 30 3b 0a 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 62 0;. /* Do not b
3130: 6f 74 68 65 72 20 77 69 74 68 20 61 20 62 75 6c other with a bul
3140: 6b 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69 66 20 k allocation if
3150: 74 68 65 20 63 61 63 68 65 20 73 69 7a 65 20 76 the cache size v
3160: 65 72 79 20 73 6d 61 6c 6c 20 2a 2f 0a 20 20 69 ery small */. i
3170: 66 28 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 3c f( pCache->nMax<
3180: 33 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 3 ) return 0;.
3190: 73 71 6c 69 74 65 33 42 65 67 69 6e 42 65 6e 69 sqlite3BeginBeni
31a0: 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 69 66 gnMalloc();. if
31b0: 28 20 70 63 61 63 68 65 31 2e 6e 49 6e 69 74 50 ( pcache1.nInitP
31c0: 61 67 65 3e 30 20 29 7b 0a 20 20 20 20 73 7a 42 age>0 ){. szB
31d0: 75 6c 6b 20 3d 20 70 43 61 63 68 65 2d 3e 73 7a ulk = pCache->sz
31e0: 41 6c 6c 6f 63 20 2a 20 28 69 36 34 29 70 63 61 Alloc * (i64)pca
31f0: 63 68 65 31 2e 6e 49 6e 69 74 50 61 67 65 3b 0a che1.nInitPage;.
3200: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 7a 42 }else{. szB
3210: 75 6c 6b 20 3d 20 2d 31 30 32 34 20 2a 20 28 69 ulk = -1024 * (i
3220: 36 34 29 70 63 61 63 68 65 31 2e 6e 49 6e 69 74 64)pcache1.nInit
3230: 50 61 67 65 3b 0a 20 20 7d 0a 20 20 69 66 28 20 Page;. }. if(
3240: 73 7a 42 75 6c 6b 20 3e 20 70 43 61 63 68 65 2d szBulk > pCache-
3250: 3e 73 7a 41 6c 6c 6f 63 2a 28 69 36 34 29 70 43 >szAlloc*(i64)pC
3260: 61 63 68 65 2d 3e 6e 4d 61 78 20 29 7b 0a 20 20 ache->nMax ){.
3270: 20 20 73 7a 42 75 6c 6b 20 3d 20 70 43 61 63 68 szBulk = pCach
3280: 65 2d 3e 73 7a 41 6c 6c 6f 63 2a 28 69 36 34 29 e->szAlloc*(i64)
3290: 70 43 61 63 68 65 2d 3e 6e 4d 61 78 3b 0a 20 20 pCache->nMax;.
32a0: 7d 0a 20 20 7a 42 75 6c 6b 20 3d 20 70 43 61 63 }. zBulk = pCac
32b0: 68 65 2d 3e 70 42 75 6c 6b 20 3d 20 73 71 6c 69 he->pBulk = sqli
32c0: 74 65 33 4d 61 6c 6c 6f 63 28 20 73 7a 42 75 6c te3Malloc( szBul
32d0: 6b 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 45 6e k );. sqlite3En
32e0: 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b dBenignMalloc();
32f0: 0a 20 20 69 66 28 20 7a 42 75 6c 6b 20 29 7b 0a . if( zBulk ){.
3300: 20 20 20 20 69 6e 74 20 6e 42 75 6c 6b 20 3d 20 int nBulk =
3310: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a sqlite3MallocSiz
3320: 65 28 7a 42 75 6c 6b 29 2f 70 43 61 63 68 65 2d e(zBulk)/pCache-
3330: 3e 73 7a 41 6c 6c 6f 63 3b 0a 20 20 20 20 64 6f >szAlloc;. do
3340: 7b 0a 20 20 20 20 20 20 50 67 48 64 72 31 20 2a {. PgHdr1 *
3350: 70 58 20 3d 20 28 50 67 48 64 72 31 2a 29 26 7a pX = (PgHdr1*)&z
3360: 42 75 6c 6b 5b 70 43 61 63 68 65 2d 3e 73 7a 50 Bulk[pCache->szP
3370: 61 67 65 5d 3b 0a 20 20 20 20 20 20 70 58 2d 3e age];. pX->
3380: 70 61 67 65 2e 70 42 75 66 20 3d 20 7a 42 75 6c page.pBuf = zBul
3390: 6b 3b 0a 20 20 20 20 20 20 70 58 2d 3e 70 61 67 k;. pX->pag
33a0: 65 2e 70 45 78 74 72 61 20 3d 20 26 70 58 5b 31 e.pExtra = &pX[1
33b0: 5d 3b 0a 20 20 20 20 20 20 70 58 2d 3e 69 73 42 ];. pX->isB
33c0: 75 6c 6b 4c 6f 63 61 6c 20 3d 20 31 3b 0a 20 20 ulkLocal = 1;.
33d0: 20 20 20 20 70 58 2d 3e 69 73 41 6e 63 68 6f 72 pX->isAnchor
33e0: 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 58 2d 3e = 0;. pX->
33f0: 70 4e 65 78 74 20 3d 20 70 43 61 63 68 65 2d 3e pNext = pCache->
3400: 70 46 72 65 65 3b 0a 20 20 20 20 20 20 70 43 61 pFree;. pCa
3410: 63 68 65 2d 3e 70 46 72 65 65 20 3d 20 70 58 3b che->pFree = pX;
3420: 0a 20 20 20 20 20 20 7a 42 75 6c 6b 20 2b 3d 20 . zBulk +=
3430: 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63 3b pCache->szAlloc;
3440: 0a 20 20 20 20 7d 77 68 69 6c 65 28 20 2d 2d 6e . }while( --n
3450: 42 75 6c 6b 20 29 3b 0a 20 20 7d 0a 20 20 72 65 Bulk );. }. re
3460: 74 75 72 6e 20 70 43 61 63 68 65 2d 3e 70 46 72 turn pCache->pFr
3470: 65 65 21 3d 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 ee!=0;.}../*.**
3480: 4d 61 6c 6c 6f 63 20 66 75 6e 63 74 69 6f 6e 20 Malloc function
3490: 75 73 65 64 20 77 69 74 68 69 6e 20 74 68 69 73 used within this
34a0: 20 66 69 6c 65 20 74 6f 20 61 6c 6c 6f 63 61 74 file to allocat
34b0: 65 20 73 70 61 63 65 20 66 72 6f 6d 20 74 68 65 e space from the
34c0: 20 62 75 66 66 65 72 0a 2a 2a 20 63 6f 6e 66 69 buffer.** confi
34d0: 67 75 72 65 64 20 75 73 69 6e 67 20 73 71 6c 69 gured using sqli
34e0: 74 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54 te3_config(SQLIT
34f0: 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 E_CONFIG_PAGECAC
3500: 48 45 29 20 6f 70 74 69 6f 6e 2e 20 49 66 20 6e HE) option. If n
3510: 6f 20 0a 2a 2a 20 73 75 63 68 20 62 75 66 66 65 o .** such buffe
3520: 72 20 65 78 69 73 74 73 20 6f 72 20 74 68 65 72 r exists or ther
3530: 65 20 69 73 20 6e 6f 20 73 70 61 63 65 20 6c 65 e is no space le
3540: 66 74 20 69 6e 20 69 74 2c 20 74 68 69 73 20 66 ft in it, this f
3550: 75 6e 63 74 69 6f 6e 20 66 61 6c 6c 73 20 0a 2a unction falls .*
3560: 2a 20 62 61 63 6b 20 74 6f 20 73 71 6c 69 74 65 * back to sqlite
3570: 33 4d 61 6c 6c 6f 63 28 29 2e 0a 2a 2a 0a 2a 2a 3Malloc()..**.**
3580: 20 4d 75 6c 74 69 70 6c 65 20 74 68 72 65 61 64 Multiple thread
3590: 73 20 63 61 6e 20 72 75 6e 20 74 68 69 73 20 72 s can run this r
35a0: 6f 75 74 69 6e 65 20 61 74 20 74 68 65 20 73 61 outine at the sa
35b0: 6d 65 20 74 69 6d 65 2e 20 20 47 6c 6f 62 61 6c me time. Global
35c0: 20 76 61 72 69 61 62 6c 65 73 0a 2a 2a 20 69 6e variables.** in
35d0: 20 70 63 61 63 68 65 31 20 6e 65 65 64 20 74 6f pcache1 need to
35e0: 20 62 65 20 70 72 6f 74 65 63 74 65 64 20 76 69 be protected vi
35f0: 61 20 6d 75 74 65 78 2e 0a 2a 2f 0a 73 74 61 74 a mutex..*/.stat
3600: 69 63 20 76 6f 69 64 20 2a 70 63 61 63 68 65 31 ic void *pcache1
3610: 41 6c 6c 6f 63 28 69 6e 74 20 6e 42 79 74 65 29 Alloc(int nByte)
3620: 7b 0a 20 20 76 6f 69 64 20 2a 70 20 3d 20 30 3b {. void *p = 0;
3630: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
3640: 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c 64 e3_mutex_notheld
3650: 28 70 63 61 63 68 65 31 2e 67 72 70 2e 6d 75 74 (pcache1.grp.mut
3660: 65 78 29 20 29 3b 0a 20 20 69 66 28 20 6e 42 79 ex) );. if( nBy
3670: 74 65 3c 3d 70 63 61 63 68 65 31 2e 73 7a 53 6c te<=pcache1.szSl
3680: 6f 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 ot ){. sqlite
3690: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 63 3_mutex_enter(pc
36a0: 61 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20 ache1.mutex);.
36b0: 20 20 70 20 3d 20 28 50 67 48 64 72 31 20 2a 29 p = (PgHdr1 *)
36c0: 70 63 61 63 68 65 31 2e 70 46 72 65 65 3b 0a 20 pcache1.pFree;.
36d0: 20 20 20 69 66 28 20 70 20 29 7b 0a 20 20 20 20 if( p ){.
36e0: 20 20 70 63 61 63 68 65 31 2e 70 46 72 65 65 20 pcache1.pFree
36f0: 3d 20 70 63 61 63 68 65 31 2e 70 46 72 65 65 2d = pcache1.pFree-
3700: 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 70 63 >pNext;. pc
3710: 61 63 68 65 31 2e 6e 46 72 65 65 53 6c 6f 74 2d ache1.nFreeSlot-
3720: 2d 3b 0a 20 20 20 20 20 20 70 63 61 63 68 65 31 -;. pcache1
3730: 2e 62 55 6e 64 65 72 50 72 65 73 73 75 72 65 20 .bUnderPressure
3740: 3d 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65 53 = pcache1.nFreeS
3750: 6c 6f 74 3c 70 63 61 63 68 65 31 2e 6e 52 65 73 lot<pcache1.nRes
3760: 65 72 76 65 3b 0a 20 20 20 20 20 20 61 73 73 65 erve;. asse
3770: 72 74 28 20 70 63 61 63 68 65 31 2e 6e 46 72 65 rt( pcache1.nFre
3780: 65 53 6c 6f 74 3e 3d 30 20 29 3b 0a 20 20 20 20 eSlot>=0 );.
3790: 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 48 sqlite3StatusH
37a0: 69 67 68 77 61 74 65 72 28 53 51 4c 49 54 45 5f ighwater(SQLITE_
37b0: 53 54 41 54 55 53 5f 50 41 47 45 43 41 43 48 45 STATUS_PAGECACHE
37c0: 5f 53 49 5a 45 2c 20 6e 42 79 74 65 29 3b 0a 20 _SIZE, nByte);.
37d0: 20 20 20 20 20 73 71 6c 69 74 65 33 53 74 61 74 sqlite3Stat
37e0: 75 73 55 70 28 53 51 4c 49 54 45 5f 53 54 41 54 usUp(SQLITE_STAT
37f0: 55 53 5f 50 41 47 45 43 41 43 48 45 5f 55 53 45 US_PAGECACHE_USE
3800: 44 2c 20 31 29 3b 0a 20 20 20 20 7d 0a 20 20 20 D, 1);. }.
3810: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c sqlite3_mutex_l
3820: 65 61 76 65 28 70 63 61 63 68 65 31 2e 6d 75 74 eave(pcache1.mut
3830: 65 78 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 ex);. }. if( p
3840: 3d 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 20 4d 65 ==0 ){. /* Me
3850: 6d 6f 72 79 20 69 73 20 6e 6f 74 20 61 76 61 69 mory is not avai
3860: 6c 61 62 6c 65 20 69 6e 20 74 68 65 20 53 51 4c lable in the SQL
3870: 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 ITE_CONFIG_PAGEC
3880: 41 43 48 45 20 70 6f 6f 6c 2e 20 20 47 65 74 0a ACHE pool. Get.
3890: 20 20 20 20 2a 2a 20 69 74 20 66 72 6f 6d 20 73 ** it from s
38a0: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 20 69 6e 73 qlite3Malloc ins
38b0: 74 65 61 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 tead.. */.
38c0: 20 70 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c p = sqlite3Mall
38d0: 6f 63 28 6e 42 79 74 65 29 3b 0a 23 69 66 6e 64 oc(nByte);.#ifnd
38e0: 65 66 20 53 51 4c 49 54 45 5f 44 49 53 41 42 4c ef SQLITE_DISABL
38f0: 45 5f 50 41 47 45 43 41 43 48 45 5f 4f 56 45 52 E_PAGECACHE_OVER
3900: 46 4c 4f 57 5f 53 54 41 54 53 0a 20 20 20 20 69 FLOW_STATS. i
3910: 66 28 20 70 20 29 7b 0a 20 20 20 20 20 20 69 6e f( p ){. in
3920: 74 20 73 7a 20 3d 20 73 71 6c 69 74 65 33 4d 61 t sz = sqlite3Ma
3930: 6c 6c 6f 63 53 69 7a 65 28 70 29 3b 0a 20 20 20 llocSize(p);.
3940: 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 sqlite3_mutex
3950: 5f 65 6e 74 65 72 28 70 63 61 63 68 65 31 2e 6d _enter(pcache1.m
3960: 75 74 65 78 29 3b 0a 20 20 20 20 20 20 73 71 6c utex);. sql
3970: 69 74 65 33 53 74 61 74 75 73 48 69 67 68 77 61 ite3StatusHighwa
3980: 74 65 72 28 53 51 4c 49 54 45 5f 53 54 41 54 55 ter(SQLITE_STATU
3990: 53 5f 50 41 47 45 43 41 43 48 45 5f 53 49 5a 45 S_PAGECACHE_SIZE
39a0: 2c 20 6e 42 79 74 65 29 3b 0a 20 20 20 20 20 20 , nByte);.
39b0: 73 71 6c 69 74 65 33 53 74 61 74 75 73 55 70 28 sqlite3StatusUp(
39c0: 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 50 41 SQLITE_STATUS_PA
39d0: 47 45 43 41 43 48 45 5f 4f 56 45 52 46 4c 4f 57 GECACHE_OVERFLOW
39e0: 2c 20 73 7a 29 3b 0a 20 20 20 20 20 20 73 71 6c , sz);. sql
39f0: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
3a00: 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29 3b (pcache1.mutex);
3a10: 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 . }.#endif.
3a20: 20 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 sqlite3Memdebu
3a30: 67 53 65 74 54 79 70 65 28 70 2c 20 4d 45 4d 54 gSetType(p, MEMT
3a40: 59 50 45 5f 50 43 41 43 48 45 29 3b 0a 20 20 7d YPE_PCACHE);. }
3a50: 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a . return p;.}..
3a60: 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 6e 20 61 6c /*.** Free an al
3a70: 6c 6f 63 61 74 65 64 20 62 75 66 66 65 72 20 6f located buffer o
3a80: 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 70 63 61 btained from pca
3a90: 63 68 65 31 41 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a che1Alloc()..*/.
3aa0: 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 static void pcac
3ab0: 68 65 31 46 72 65 65 28 76 6f 69 64 20 2a 70 29 he1Free(void *p)
3ac0: 7b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20 72 {. if( p==0 ) r
3ad0: 65 74 75 72 6e 3b 0a 20 20 69 66 28 20 53 51 4c eturn;. if( SQL
3ae0: 49 54 45 5f 57 49 54 48 49 4e 28 70 2c 20 70 63 ITE_WITHIN(p, pc
3af0: 61 63 68 65 31 2e 70 53 74 61 72 74 2c 20 70 63 ache1.pStart, pc
3b00: 61 63 68 65 31 2e 70 45 6e 64 29 20 29 7b 0a 20 ache1.pEnd) ){.
3b10: 20 20 20 50 67 46 72 65 65 73 6c 6f 74 20 2a 70 PgFreeslot *p
3b20: 53 6c 6f 74 3b 0a 20 20 20 20 73 71 6c 69 74 65 Slot;. sqlite
3b30: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 63 3_mutex_enter(pc
3b40: 61 63 68 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20 ache1.mutex);.
3b50: 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 44 sqlite3StatusD
3b60: 6f 77 6e 28 53 51 4c 49 54 45 5f 53 54 41 54 55 own(SQLITE_STATU
3b70: 53 5f 50 41 47 45 43 41 43 48 45 5f 55 53 45 44 S_PAGECACHE_USED
3b80: 2c 20 31 29 3b 0a 20 20 20 20 70 53 6c 6f 74 20 , 1);. pSlot
3b90: 3d 20 28 50 67 46 72 65 65 73 6c 6f 74 2a 29 70 = (PgFreeslot*)p
3ba0: 3b 0a 20 20 20 20 70 53 6c 6f 74 2d 3e 70 4e 65 ;. pSlot->pNe
3bb0: 78 74 20 3d 20 70 63 61 63 68 65 31 2e 70 46 72 xt = pcache1.pFr
3bc0: 65 65 3b 0a 20 20 20 20 70 63 61 63 68 65 31 2e ee;. pcache1.
3bd0: 70 46 72 65 65 20 3d 20 70 53 6c 6f 74 3b 0a 20 pFree = pSlot;.
3be0: 20 20 20 70 63 61 63 68 65 31 2e 6e 46 72 65 65 pcache1.nFree
3bf0: 53 6c 6f 74 2b 2b 3b 0a 20 20 20 20 70 63 61 63 Slot++;. pcac
3c00: 68 65 31 2e 62 55 6e 64 65 72 50 72 65 73 73 75 he1.bUnderPressu
3c10: 72 65 20 3d 20 70 63 61 63 68 65 31 2e 6e 46 72 re = pcache1.nFr
3c20: 65 65 53 6c 6f 74 3c 70 63 61 63 68 65 31 2e 6e eeSlot<pcache1.n
3c30: 52 65 73 65 72 76 65 3b 0a 20 20 20 20 61 73 73 Reserve;. ass
3c40: 65 72 74 28 20 70 63 61 63 68 65 31 2e 6e 46 72 ert( pcache1.nFr
3c50: 65 65 53 6c 6f 74 3c 3d 70 63 61 63 68 65 31 2e eeSlot<=pcache1.
3c60: 6e 53 6c 6f 74 20 29 3b 0a 20 20 20 20 73 71 6c nSlot );. sql
3c70: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
3c80: 28 70 63 61 63 68 65 31 2e 6d 75 74 65 78 29 3b (pcache1.mutex);
3c90: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 . }else{. as
3ca0: 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d 65 6d sert( sqlite3Mem
3cb0: 64 65 62 75 67 48 61 73 54 79 70 65 28 70 2c 20 debugHasType(p,
3cc0: 4d 45 4d 54 59 50 45 5f 50 43 41 43 48 45 29 20 MEMTYPE_PCACHE)
3cd0: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 4d 65 );. sqlite3Me
3ce0: 6d 64 65 62 75 67 53 65 74 54 79 70 65 28 70 2c mdebugSetType(p,
3cf0: 20 4d 45 4d 54 59 50 45 5f 48 45 41 50 29 3b 0a MEMTYPE_HEAP);.
3d00: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 #ifndef SQLITE_D
3d10: 49 53 41 42 4c 45 5f 50 41 47 45 43 41 43 48 45 ISABLE_PAGECACHE
3d20: 5f 4f 56 45 52 46 4c 4f 57 5f 53 54 41 54 53 0a _OVERFLOW_STATS.
3d30: 20 20 20 20 7b 0a 20 20 20 20 20 20 69 6e 74 20 {. int
3d40: 6e 46 72 65 65 64 20 3d 20 30 3b 0a 20 20 20 20 nFreed = 0;.
3d50: 20 20 6e 46 72 65 65 64 20 3d 20 73 71 6c 69 74 nFreed = sqlit
3d60: 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 29 3b e3MallocSize(p);
3d70: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d . sqlite3_m
3d80: 75 74 65 78 5f 65 6e 74 65 72 28 70 63 61 63 68 utex_enter(pcach
3d90: 65 31 2e 6d 75 74 65 78 29 3b 0a 20 20 20 20 20 e1.mutex);.
3da0: 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 44 6f sqlite3StatusDo
3db0: 77 6e 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53 wn(SQLITE_STATUS
3dc0: 5f 50 41 47 45 43 41 43 48 45 5f 4f 56 45 52 46 _PAGECACHE_OVERF
3dd0: 4c 4f 57 2c 20 6e 46 72 65 65 64 29 3b 0a 20 20 LOW, nFreed);.
3de0: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 sqlite3_mute
3df0: 78 5f 6c 65 61 76 65 28 70 63 61 63 68 65 31 2e x_leave(pcache1.
3e00: 6d 75 74 65 78 29 3b 0a 20 20 20 20 7d 0a 23 65 mutex);. }.#e
3e10: 6e 64 69 66 0a 20 20 20 20 73 71 6c 69 74 65 33 ndif. sqlite3
3e20: 5f 66 72 65 65 28 70 29 3b 0a 20 20 7d 0a 7d 0a _free(p);. }.}.
3e30: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
3e40: 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e NABLE_MEMORY_MAN
3e50: 41 47 45 4d 45 4e 54 0a 2f 2a 0a 2a 2a 20 52 65 AGEMENT./*.** Re
3e60: 74 75 72 6e 20 74 68 65 20 73 69 7a 65 20 6f 66 turn the size of
3e70: 20 61 20 70 63 61 63 68 65 20 61 6c 6c 6f 63 61 a pcache alloca
3e80: 74 69 6f 6e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 tion.*/.static i
3e90: 6e 74 20 70 63 61 63 68 65 31 4d 65 6d 53 69 7a nt pcache1MemSiz
3ea0: 65 28 76 6f 69 64 20 2a 70 29 7b 0a 20 20 69 66 e(void *p){. if
3eb0: 28 20 70 3e 3d 70 63 61 63 68 65 31 2e 70 53 74 ( p>=pcache1.pSt
3ec0: 61 72 74 20 26 26 20 70 3c 70 63 61 63 68 65 31 art && p<pcache1
3ed0: 2e 70 45 6e 64 20 29 7b 0a 20 20 20 20 72 65 74 .pEnd ){. ret
3ee0: 75 72 6e 20 70 63 61 63 68 65 31 2e 73 7a 53 6c urn pcache1.szSl
3ef0: 6f 74 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ot;. }else{.
3f00: 20 69 6e 74 20 69 53 69 7a 65 3b 0a 20 20 20 20 int iSize;.
3f10: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 4d assert( sqlite3M
3f20: 65 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 70 emdebugHasType(p
3f30: 2c 20 4d 45 4d 54 59 50 45 5f 50 43 41 43 48 45 , MEMTYPE_PCACHE
3f40: 29 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 ) );. sqlite3
3f50: 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 28 MemdebugSetType(
3f60: 70 2c 20 4d 45 4d 54 59 50 45 5f 48 45 41 50 29 p, MEMTYPE_HEAP)
3f70: 3b 0a 20 20 20 20 69 53 69 7a 65 20 3d 20 73 71 ;. iSize = sq
3f80: 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 lite3MallocSize(
3f90: 70 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 4d p);. sqlite3M
3fa0: 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 28 70 emdebugSetType(p
3fb0: 2c 20 4d 45 4d 54 59 50 45 5f 50 43 41 43 48 45 , MEMTYPE_PCACHE
3fc0: 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 69 53 );. return iS
3fd0: 69 7a 65 3b 0a 20 20 7d 0a 7d 0a 23 65 6e 64 69 ize;. }.}.#endi
3fe0: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 f /* SQLITE_ENAB
3ff0: 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 LE_MEMORY_MANAGE
4000: 4d 45 4e 54 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 MENT */../*.** A
4010: 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 70 61 llocate a new pa
4020: 67 65 20 6f 62 6a 65 63 74 20 69 6e 69 74 69 61 ge object initia
4030: 6c 6c 79 20 61 73 73 6f 63 69 61 74 65 64 20 77 lly associated w
4040: 69 74 68 20 63 61 63 68 65 20 70 43 61 63 68 65 ith cache pCache
4050: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67 48 64 ..*/.static PgHd
4060: 72 31 20 2a 70 63 61 63 68 65 31 41 6c 6c 6f 63 r1 *pcache1Alloc
4070: 50 61 67 65 28 50 43 61 63 68 65 31 20 2a 70 43 Page(PCache1 *pC
4080: 61 63 68 65 2c 20 69 6e 74 20 62 65 6e 69 67 6e ache, int benign
4090: 4d 61 6c 6c 6f 63 29 7b 0a 20 20 50 67 48 64 72 Malloc){. PgHdr
40a0: 31 20 2a 70 20 3d 20 30 3b 0a 20 20 76 6f 69 64 1 *p = 0;. void
40b0: 20 2a 70 50 67 3b 0a 0a 20 20 61 73 73 65 72 74 *pPg;.. assert
40c0: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
40d0: 68 65 6c 64 28 70 43 61 63 68 65 2d 3e 70 47 72 held(pCache->pGr
40e0: 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 oup->mutex) );.
40f0: 20 69 66 28 20 70 43 61 63 68 65 2d 3e 70 46 72 if( pCache->pFr
4100: 65 65 20 7c 7c 20 28 70 43 61 63 68 65 2d 3e 6e ee || (pCache->n
4110: 50 61 67 65 3d 3d 30 20 26 26 20 70 63 61 63 68 Page==0 && pcach
4120: 65 31 49 6e 69 74 42 75 6c 6b 28 70 43 61 63 68 e1InitBulk(pCach
4130: 65 29 29 20 29 7b 0a 20 20 20 20 70 20 3d 20 70 e)) ){. p = p
4140: 43 61 63 68 65 2d 3e 70 46 72 65 65 3b 0a 20 20 Cache->pFree;.
4150: 20 20 70 43 61 63 68 65 2d 3e 70 46 72 65 65 20 pCache->pFree
4160: 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 = p->pNext;.
4170: 70 2d 3e 70 4e 65 78 74 20 3d 20 30 3b 0a 20 20 p->pNext = 0;.
4180: 7d 65 6c 73 65 7b 0a 23 69 66 64 65 66 20 53 51 }else{.#ifdef SQ
4190: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f LITE_ENABLE_MEMO
41a0: 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 20 20 RY_MANAGEMENT.
41b0: 20 20 2f 2a 20 54 68 65 20 67 72 6f 75 70 20 6d /* The group m
41c0: 75 74 65 78 20 6d 75 73 74 20 62 65 20 72 65 6c utex must be rel
41d0: 65 61 73 65 64 20 62 65 66 6f 72 65 20 70 63 61 eased before pca
41e0: 63 68 65 31 41 6c 6c 6f 63 28 29 20 69 73 20 63 che1Alloc() is c
41f0: 61 6c 6c 65 64 2e 20 54 68 69 73 0a 20 20 20 20 alled. This.
4200: 2a 2a 20 69 73 20 62 65 63 61 75 73 65 20 69 74 ** is because it
4210: 20 6d 69 67 68 74 20 63 61 6c 6c 20 73 71 6c 69 might call sqli
4220: 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f te3_release_memo
4230: 72 79 28 29 2c 20 77 68 69 63 68 20 61 73 73 75 ry(), which assu
4240: 6d 65 73 20 74 68 61 74 20 0a 20 20 20 20 2a 2a mes that . **
4250: 20 74 68 69 73 20 6d 75 74 65 78 20 69 73 20 6e this mutex is n
4260: 6f 74 20 68 65 6c 64 2e 20 2a 2f 0a 20 20 20 20 ot held. */.
4270: 61 73 73 65 72 74 28 20 70 63 61 63 68 65 31 2e assert( pcache1.
4280: 73 65 70 61 72 61 74 65 43 61 63 68 65 3d 3d 30 separateCache==0
4290: 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 );. assert(
42a0: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3d 3d pCache->pGroup==
42b0: 26 70 63 61 63 68 65 31 2e 67 72 70 20 29 3b 0a &pcache1.grp );.
42c0: 20 20 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 pcache1Leave
42d0: 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47 Mutex(pCache->pG
42e0: 72 6f 75 70 29 3b 0a 23 65 6e 64 69 66 0a 20 20 roup);.#endif.
42f0: 20 20 69 66 28 20 62 65 6e 69 67 6e 4d 61 6c 6c if( benignMall
4300: 6f 63 20 29 7b 20 73 71 6c 69 74 65 33 42 65 67 oc ){ sqlite3Beg
4310: 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 inBenignMalloc()
4320: 3b 20 7d 0a 23 69 66 64 65 66 20 53 51 4c 49 54 ; }.#ifdef SQLIT
4330: 45 5f 50 43 41 43 48 45 5f 53 45 50 41 52 41 54 E_PCACHE_SEPARAT
4340: 45 5f 48 45 41 44 45 52 0a 20 20 20 20 70 50 67 E_HEADER. pPg
4350: 20 3d 20 70 63 61 63 68 65 31 41 6c 6c 6f 63 28 = pcache1Alloc(
4360: 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 29 3b pCache->szPage);
4370: 0a 20 20 20 20 70 20 3d 20 73 71 6c 69 74 65 33 . p = sqlite3
4380: 4d 61 6c 6c 6f 63 28 73 69 7a 65 6f 66 28 50 67 Malloc(sizeof(Pg
4390: 48 64 72 31 29 20 2b 20 70 43 61 63 68 65 2d 3e Hdr1) + pCache->
43a0: 73 7a 45 78 74 72 61 29 3b 0a 20 20 20 20 69 66 szExtra);. if
43b0: 28 20 21 70 50 67 20 7c 7c 20 21 70 20 29 7b 0a ( !pPg || !p ){.
43c0: 20 20 20 20 20 20 70 63 61 63 68 65 31 46 72 65 pcache1Fre
43d0: 65 28 70 50 67 29 3b 0a 20 20 20 20 20 20 73 71 e(pPg);. sq
43e0: 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 lite3_free(p);.
43f0: 20 20 20 20 20 70 50 67 20 3d 20 30 3b 0a 20 20 pPg = 0;.
4400: 20 20 7d 0a 23 65 6c 73 65 0a 20 20 20 20 70 50 }.#else. pP
4410: 67 20 3d 20 70 63 61 63 68 65 31 41 6c 6c 6f 63 g = pcache1Alloc
4420: 28 70 43 61 63 68 65 2d 3e 73 7a 41 6c 6c 6f 63 (pCache->szAlloc
4430: 29 3b 0a 20 20 20 20 70 20 3d 20 28 50 67 48 64 );. p = (PgHd
4440: 72 31 20 2a 29 26 28 28 75 38 20 2a 29 70 50 67 r1 *)&((u8 *)pPg
4450: 29 5b 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 )[pCache->szPage
4460: 5d 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 69 66 ];.#endif. if
4470: 28 20 62 65 6e 69 67 6e 4d 61 6c 6c 6f 63 20 29 ( benignMalloc )
4480: 7b 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 { sqlite3EndBeni
4490: 67 6e 4d 61 6c 6c 6f 63 28 29 3b 20 7d 0a 23 69 gnMalloc(); }.#i
44a0: 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
44b0: 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 LE_MEMORY_MANAGE
44c0: 4d 45 4e 54 0a 20 20 20 20 70 63 61 63 68 65 31 MENT. pcache1
44d0: 45 6e 74 65 72 4d 75 74 65 78 28 70 43 61 63 68 EnterMutex(pCach
44e0: 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 23 65 6e 64 e->pGroup);.#end
44f0: 69 66 0a 20 20 20 20 69 66 28 20 70 50 67 3d 3d if. if( pPg==
4500: 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 0 ) return 0;.
4510: 20 20 70 2d 3e 70 61 67 65 2e 70 42 75 66 20 3d p->page.pBuf =
4520: 20 70 50 67 3b 0a 20 20 20 20 70 2d 3e 70 61 67 pPg;. p->pag
4530: 65 2e 70 45 78 74 72 61 20 3d 20 26 70 5b 31 5d e.pExtra = &p[1]
4540: 3b 0a 20 20 20 20 70 2d 3e 69 73 42 75 6c 6b 4c ;. p->isBulkL
4550: 6f 63 61 6c 20 3d 20 30 3b 0a 20 20 20 20 70 2d ocal = 0;. p-
4560: 3e 69 73 41 6e 63 68 6f 72 20 3d 20 30 3b 0a 20 >isAnchor = 0;.
4570: 20 7d 0a 20 20 28 2a 70 43 61 63 68 65 2d 3e 70 }. (*pCache->p
4580: 6e 50 75 72 67 65 61 62 6c 65 29 2b 2b 3b 0a 20 nPurgeable)++;.
4590: 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 2f 2a return p;.}../*
45a0: 0a 2a 2a 20 46 72 65 65 20 61 20 70 61 67 65 20 .** Free a page
45b0: 6f 62 6a 65 63 74 20 61 6c 6c 6f 63 61 74 65 64 object allocated
45c0: 20 62 79 20 70 63 61 63 68 65 31 41 6c 6c 6f 63 by pcache1Alloc
45d0: 50 61 67 65 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 Page()..*/.stati
45e0: 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 46 72 c void pcache1Fr
45f0: 65 65 50 61 67 65 28 50 67 48 64 72 31 20 2a 70 eePage(PgHdr1 *p
4600: 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 ){. PCache1 *pC
4610: 61 63 68 65 3b 0a 20 20 61 73 73 65 72 74 28 20 ache;. assert(
4620: 70 21 3d 30 20 29 3b 0a 20 20 70 43 61 63 68 65 p!=0 );. pCache
4630: 20 3d 20 70 2d 3e 70 43 61 63 68 65 3b 0a 20 20 = p->pCache;.
4640: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
4650: 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 70 43 mutex_held(p->pC
4660: 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 ache->pGroup->mu
4670: 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 70 2d tex) );. if( p-
4680: 3e 69 73 42 75 6c 6b 4c 6f 63 61 6c 20 29 7b 0a >isBulkLocal ){.
4690: 20 20 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20 70 p->pNext = p
46a0: 43 61 63 68 65 2d 3e 70 46 72 65 65 3b 0a 20 20 Cache->pFree;.
46b0: 20 20 70 43 61 63 68 65 2d 3e 70 46 72 65 65 20 pCache->pFree
46c0: 3d 20 70 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 = p;. }else{.
46d0: 20 20 70 63 61 63 68 65 31 46 72 65 65 28 70 2d pcache1Free(p-
46e0: 3e 70 61 67 65 2e 70 42 75 66 29 3b 0a 23 69 66 >page.pBuf);.#if
46f0: 64 65 66 20 53 51 4c 49 54 45 5f 50 43 41 43 48 def SQLITE_PCACH
4700: 45 5f 53 45 50 41 52 41 54 45 5f 48 45 41 44 45 E_SEPARATE_HEADE
4710: 52 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 R. sqlite3_fr
4720: 65 65 28 70 29 3b 0a 23 65 6e 64 69 66 0a 20 20 ee(p);.#endif.
4730: 7d 0a 20 20 28 2a 70 43 61 63 68 65 2d 3e 70 6e }. (*pCache->pn
4740: 50 75 72 67 65 61 62 6c 65 29 2d 2d 3b 0a 7d 0a Purgeable)--;.}.
4750: 0a 2f 2a 0a 2a 2a 20 4d 61 6c 6c 6f 63 20 66 75 ./*.** Malloc fu
4760: 6e 63 74 69 6f 6e 20 75 73 65 64 20 62 79 20 53 nction used by S
4770: 51 4c 69 74 65 20 74 6f 20 6f 62 74 61 69 6e 20 QLite to obtain
4780: 73 70 61 63 65 20 66 72 6f 6d 20 74 68 65 20 62 space from the b
4790: 75 66 66 65 72 20 63 6f 6e 66 69 67 75 72 65 64 uffer configured
47a0: 0a 2a 2a 20 75 73 69 6e 67 20 73 71 6c 69 74 65 .** using sqlite
47b0: 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f 3_config(SQLITE_
47c0: 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45 CONFIG_PAGECACHE
47d0: 29 20 6f 70 74 69 6f 6e 2e 20 49 66 20 6e 6f 20 ) option. If no
47e0: 73 75 63 68 20 62 75 66 66 65 72 0a 2a 2a 20 65 such buffer.** e
47f0: 78 69 73 74 73 2c 20 74 68 69 73 20 66 75 6e 63 xists, this func
4800: 74 69 6f 6e 20 66 61 6c 6c 73 20 62 61 63 6b 20 tion falls back
4810: 74 6f 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 to sqlite3Malloc
4820: 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c ()..*/.void *sql
4830: 69 74 65 33 50 61 67 65 4d 61 6c 6c 6f 63 28 69 ite3PageMalloc(i
4840: 6e 74 20 73 7a 29 7b 0a 20 20 2f 2a 20 44 75 72 nt sz){. /* Dur
4850: 69 6e 67 20 72 65 62 61 6c 61 6e 63 65 20 6f 70 ing rebalance op
4860: 65 72 61 74 69 6f 6e 73 20 6f 6e 20 61 20 63 6f erations on a co
4870: 72 72 75 70 74 20 64 61 74 61 62 61 73 65 20 66 rrupt database f
4880: 69 6c 65 2c 20 69 74 20 69 73 20 73 6f 6d 65 74 ile, it is somet
4890: 69 6d 65 73 0a 20 20 2a 2a 20 28 72 61 72 65 6c imes. ** (rarel
48a0: 79 29 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 6f y) possible to o
48b0: 76 65 72 72 65 61 64 20 74 68 65 20 74 65 6d 70 verread the temp
48c0: 6f 72 61 72 79 20 70 61 67 65 20 62 75 66 66 65 orary page buffe
48d0: 72 20 62 79 20 61 20 66 65 77 20 62 79 74 65 73 r by a few bytes
48e0: 2e 0a 20 20 2a 2a 20 45 6e 6c 61 72 67 65 20 74 .. ** Enlarge t
48f0: 68 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 73 6c he allocation sl
4900: 69 67 68 74 6c 79 20 73 6f 20 74 68 61 74 20 74 ightly so that t
4910: 68 69 73 20 64 6f 65 73 20 6e 6f 74 20 63 61 75 his does not cau
4920: 73 65 20 70 72 6f 62 6c 65 6d 73 2e 20 2a 2f 0a se problems. */.
4930: 20 20 72 65 74 75 72 6e 20 70 63 61 63 68 65 31 return pcache1
4940: 41 6c 6c 6f 63 28 73 7a 29 3b 0a 7d 0a 0a 2f 2a Alloc(sz);.}../*
4950: 0a 2a 2a 20 46 72 65 65 20 61 6e 20 61 6c 6c 6f .** Free an allo
4960: 63 61 74 65 64 20 62 75 66 66 65 72 20 6f 62 74 cated buffer obt
4970: 61 69 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 ained from sqlit
4980: 65 33 50 61 67 65 4d 61 6c 6c 6f 63 28 29 2e 0a e3PageMalloc()..
4990: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 */.void sqlite3P
49a0: 61 67 65 46 72 65 65 28 76 6f 69 64 20 2a 70 29 ageFree(void *p)
49b0: 7b 0a 20 20 70 63 61 63 68 65 31 46 72 65 65 28 {. pcache1Free(
49c0: 70 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 p);.}.../*.** Re
49d0: 74 75 72 6e 20 74 72 75 65 20 69 66 20 69 74 20 turn true if it
49e0: 64 65 73 69 72 61 62 6c 65 20 74 6f 20 61 76 6f desirable to avo
49f0: 69 64 20 61 6c 6c 6f 63 61 74 69 6e 67 20 61 20 id allocating a
4a00: 6e 65 77 20 70 61 67 65 20 63 61 63 68 65 0a 2a new page cache.*
4a10: 2a 20 65 6e 74 72 79 2e 0a 2a 2a 0a 2a 2a 20 49 * entry..**.** I
4a20: 66 20 6d 65 6d 6f 72 79 20 77 61 73 20 61 6c 6c f memory was all
4a30: 6f 63 61 74 65 64 20 73 70 65 63 69 66 69 63 61 ocated specifica
4a40: 6c 6c 79 20 74 6f 20 74 68 65 20 70 61 67 65 20 lly to the page
4a50: 63 61 63 68 65 20 75 73 69 6e 67 0a 2a 2a 20 53 cache using.** S
4a60: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 QLITE_CONFIG_PAG
4a70: 45 43 41 43 48 45 20 62 75 74 20 74 68 61 74 20 ECACHE but that
4a80: 6d 65 6d 6f 72 79 20 68 61 73 20 61 6c 6c 20 62 memory has all b
4a90: 65 65 6e 20 75 73 65 64 2c 20 74 68 65 6e 0a 2a een used, then.*
4aa0: 2a 20 69 74 20 69 73 20 64 65 73 69 72 61 62 6c * it is desirabl
4ab0: 65 20 74 6f 20 61 76 6f 69 64 20 61 6c 6c 6f 63 e to avoid alloc
4ac0: 61 74 69 6e 67 20 61 20 6e 65 77 20 70 61 67 65 ating a new page
4ad0: 20 63 61 63 68 65 20 65 6e 74 72 79 20 62 65 63 cache entry bec
4ae0: 61 75 73 65 0a 2a 2a 20 70 72 65 73 75 6d 61 62 ause.** presumab
4af0: 6c 79 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 ly SQLITE_CONFIG
4b00: 5f 50 41 47 45 43 41 43 48 45 20 77 61 73 20 73 _PAGECACHE was s
4b10: 75 70 70 6f 73 65 20 74 6f 20 62 65 20 73 75 66 uppose to be suf
4b20: 66 69 63 69 65 6e 74 0a 2a 2a 20 66 6f 72 20 61 ficient.** for a
4b30: 6c 6c 20 70 61 67 65 20 63 61 63 68 65 20 6e 65 ll page cache ne
4b40: 65 64 73 20 61 6e 64 20 77 65 20 73 68 6f 75 6c eds and we shoul
4b50: 64 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 73 70 d not need to sp
4b60: 69 6c 6c 20 74 68 65 0a 2a 2a 20 61 6c 6c 6f 63 ill the.** alloc
4b70: 61 74 69 6f 6e 20 6f 6e 74 6f 20 74 68 65 20 68 ation onto the h
4b80: 65 61 70 2e 0a 2a 2a 0a 2a 2a 20 4f 72 2c 20 74 eap..**.** Or, t
4b90: 68 65 20 68 65 61 70 20 69 73 20 75 73 65 64 20 he heap is used
4ba0: 66 6f 72 20 61 6c 6c 20 70 61 67 65 20 63 61 63 for all page cac
4bb0: 68 65 20 6d 65 6d 6f 72 79 20 62 75 74 20 74 68 he memory but th
4bc0: 65 20 68 65 61 70 20 69 73 0a 2a 2a 20 75 6e 64 e heap is.** und
4bd0: 65 72 20 6d 65 6d 6f 72 79 20 70 72 65 73 73 75 er memory pressu
4be0: 72 65 2c 20 74 68 65 6e 20 61 67 61 69 6e 20 69 re, then again i
4bf0: 74 20 69 73 20 64 65 73 69 72 61 62 6c 65 20 74 t is desirable t
4c00: 6f 20 61 76 6f 69 64 0a 2a 2a 20 61 6c 6c 6f 63 o avoid.** alloc
4c10: 61 74 69 6e 67 20 61 20 6e 65 77 20 70 61 67 65 ating a new page
4c20: 20 63 61 63 68 65 20 65 6e 74 72 79 20 69 6e 20 cache entry in
4c30: 6f 72 64 65 72 20 74 6f 20 61 76 6f 69 64 20 73 order to avoid s
4c40: 74 72 65 73 73 69 6e 67 0a 2a 2a 20 74 68 65 20 tressing.** the
4c50: 68 65 61 70 20 65 76 65 6e 20 66 75 72 74 68 65 heap even furthe
4c60: 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 r..*/.static int
4c70: 20 70 63 61 63 68 65 31 55 6e 64 65 72 4d 65 6d pcache1UnderMem
4c80: 6f 72 79 50 72 65 73 73 75 72 65 28 50 43 61 63 oryPressure(PCac
4c90: 68 65 31 20 2a 70 43 61 63 68 65 29 7b 0a 20 20 he1 *pCache){.
4ca0: 69 66 28 20 70 63 61 63 68 65 31 2e 6e 53 6c 6f if( pcache1.nSlo
4cb0: 74 20 26 26 20 28 70 43 61 63 68 65 2d 3e 73 7a t && (pCache->sz
4cc0: 50 61 67 65 2b 70 43 61 63 68 65 2d 3e 73 7a 45 Page+pCache->szE
4cd0: 78 74 72 61 29 3c 3d 70 63 61 63 68 65 31 2e 73 xtra)<=pcache1.s
4ce0: 7a 53 6c 6f 74 20 29 7b 0a 20 20 20 20 72 65 74 zSlot ){. ret
4cf0: 75 72 6e 20 70 63 61 63 68 65 31 2e 62 55 6e 64 urn pcache1.bUnd
4d00: 65 72 50 72 65 73 73 75 72 65 3b 0a 20 20 7d 65 erPressure;. }e
4d10: 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 lse{. return
4d20: 73 71 6c 69 74 65 33 48 65 61 70 4e 65 61 72 6c sqlite3HeapNearl
4d30: 79 46 75 6c 6c 28 29 3b 0a 20 20 7d 0a 7d 0a 0a yFull();. }.}..
4d40: 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a /***************
4d50: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
4d60: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
4d70: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
4d80: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f ***************/
4d90: 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 20 47 65 6e 65 72 ./******** Gener
4da0: 61 6c 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f al Implementatio
4db0: 6e 20 46 75 6e 63 74 69 6f 6e 73 20 2a 2a 2a 2a n Functions ****
4dc0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
4dd0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
4de0: 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 /../*.** This fu
4df0: 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 nction is used t
4e00: 6f 20 72 65 73 69 7a 65 20 74 68 65 20 68 61 73 o resize the has
4e10: 68 20 74 61 62 6c 65 20 75 73 65 64 20 62 79 20 h table used by
4e20: 74 68 65 20 63 61 63 68 65 20 70 61 73 73 65 64 the cache passed
4e30: 0a 2a 2a 20 61 73 20 74 68 65 20 66 69 72 73 74 .** as the first
4e40: 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2a 0a 2a 2a argument..**.**
4e50: 20 54 68 65 20 50 43 61 63 68 65 20 6d 75 74 65 The PCache mute
4e60: 78 20 6d 75 73 74 20 62 65 20 68 65 6c 64 20 77 x must be held w
4e70: 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f hen this functio
4e80: 6e 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a n is called..*/.
4e90: 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 static void pcac
4ea0: 68 65 31 52 65 73 69 7a 65 48 61 73 68 28 50 43 he1ResizeHash(PC
4eb0: 61 63 68 65 31 20 2a 70 29 7b 0a 20 20 50 67 48 ache1 *p){. PgH
4ec0: 64 72 31 20 2a 2a 61 70 4e 65 77 3b 0a 20 20 75 dr1 **apNew;. u
4ed0: 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 4e 65 77 nsigned int nNew
4ee0: 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 ;. unsigned int
4ef0: 20 69 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 i;.. assert( s
4f00: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
4f10: 64 28 70 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 d(p->pGroup->mut
4f20: 65 78 29 20 29 3b 0a 0a 20 20 6e 4e 65 77 20 3d ex) );.. nNew =
4f30: 20 70 2d 3e 6e 48 61 73 68 2a 32 3b 0a 20 20 69 p->nHash*2;. i
4f40: 66 28 20 6e 4e 65 77 3c 32 35 36 20 29 7b 0a 20 f( nNew<256 ){.
4f50: 20 20 20 6e 4e 65 77 20 3d 20 32 35 36 3b 0a 20 nNew = 256;.
4f60: 20 7d 0a 0a 20 20 70 63 61 63 68 65 31 4c 65 61 }.. pcache1Lea
4f70: 76 65 4d 75 74 65 78 28 70 2d 3e 70 47 72 6f 75 veMutex(p->pGrou
4f80: 70 29 3b 0a 20 20 69 66 28 20 70 2d 3e 6e 48 61 p);. if( p->nHa
4f90: 73 68 20 29 7b 20 73 71 6c 69 74 65 33 42 65 67 sh ){ sqlite3Beg
4fa0: 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 inBenignMalloc()
4fb0: 3b 20 7d 0a 20 20 61 70 4e 65 77 20 3d 20 28 50 ; }. apNew = (P
4fc0: 67 48 64 72 31 20 2a 2a 29 73 71 6c 69 74 65 33 gHdr1 **)sqlite3
4fd0: 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 69 7a 65 6f MallocZero(sizeo
4fe0: 66 28 50 67 48 64 72 31 20 2a 29 2a 6e 4e 65 77 f(PgHdr1 *)*nNew
4ff0: 29 3b 0a 20 20 69 66 28 20 70 2d 3e 6e 48 61 73 );. if( p->nHas
5000: 68 20 29 7b 20 73 71 6c 69 74 65 33 45 6e 64 42 h ){ sqlite3EndB
5010: 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 20 7d enignMalloc(); }
5020: 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d . pcache1EnterM
5030: 75 74 65 78 28 70 2d 3e 70 47 72 6f 75 70 29 3b utex(p->pGroup);
5040: 0a 20 20 69 66 28 20 61 70 4e 65 77 20 29 7b 0a . if( apNew ){.
5050: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 for(i=0; i<p
5060: 2d 3e 6e 48 61 73 68 3b 20 69 2b 2b 29 7b 0a 20 ->nHash; i++){.
5070: 20 20 20 20 20 50 67 48 64 72 31 20 2a 70 50 61 PgHdr1 *pPa
5080: 67 65 3b 0a 20 20 20 20 20 20 50 67 48 64 72 31 ge;. PgHdr1
5090: 20 2a 70 4e 65 78 74 20 3d 20 70 2d 3e 61 70 48 *pNext = p->apH
50a0: 61 73 68 5b 69 5d 3b 0a 20 20 20 20 20 20 77 68 ash[i];. wh
50b0: 69 6c 65 28 20 28 70 50 61 67 65 20 3d 20 70 4e ile( (pPage = pN
50c0: 65 78 74 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 ext)!=0 ){.
50d0: 20 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 unsigned int
50e0: 68 20 3d 20 70 50 61 67 65 2d 3e 69 4b 65 79 20 h = pPage->iKey
50f0: 25 20 6e 4e 65 77 3b 0a 20 20 20 20 20 20 20 20 % nNew;.
5100: 70 4e 65 78 74 20 3d 20 70 50 61 67 65 2d 3e 70 pNext = pPage->p
5110: 4e 65 78 74 3b 0a 20 20 20 20 20 20 20 20 70 50 Next;. pP
5120: 61 67 65 2d 3e 70 4e 65 78 74 20 3d 20 61 70 4e age->pNext = apN
5130: 65 77 5b 68 5d 3b 0a 20 20 20 20 20 20 20 20 61 ew[h];. a
5140: 70 4e 65 77 5b 68 5d 20 3d 20 70 50 61 67 65 3b pNew[h] = pPage;
5150: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 . }. }.
5160: 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 sqlite3_free(
5170: 70 2d 3e 61 70 48 61 73 68 29 3b 0a 20 20 20 20 p->apHash);.
5180: 70 2d 3e 61 70 48 61 73 68 20 3d 20 61 70 4e 65 p->apHash = apNe
5190: 77 3b 0a 20 20 20 20 70 2d 3e 6e 48 61 73 68 20 w;. p->nHash
51a0: 3d 20 6e 4e 65 77 3b 0a 20 20 7d 0a 7d 0a 0a 2f = nNew;. }.}../
51b0: 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 *.** This functi
51c0: 6f 6e 20 69 73 20 75 73 65 64 20 69 6e 74 65 72 on is used inter
51d0: 6e 61 6c 6c 79 20 74 6f 20 72 65 6d 6f 76 65 20 nally to remove
51e0: 74 68 65 20 70 61 67 65 20 70 50 61 67 65 20 66 the page pPage f
51f0: 72 6f 6d 20 74 68 65 20 0a 2a 2a 20 50 47 72 6f rom the .** PGro
5200: 75 70 20 4c 52 55 20 6c 69 73 74 2c 20 69 66 20 up LRU list, if
5210: 69 73 20 70 61 72 74 20 6f 66 20 69 74 2e 20 49 is part of it. I
5220: 66 20 70 50 61 67 65 20 69 73 20 6e 6f 74 20 70 f pPage is not p
5230: 61 72 74 20 6f 66 20 74 68 65 20 50 47 72 6f 75 art of the PGrou
5240: 70 0a 2a 2a 20 4c 52 55 20 6c 69 73 74 2c 20 74 p.** LRU list, t
5250: 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f hen this functio
5260: 6e 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a n is a no-op..**
5270: 0a 2a 2a 20 54 68 65 20 50 47 72 6f 75 70 20 6d .** The PGroup m
5280: 75 74 65 78 20 6d 75 73 74 20 62 65 20 68 65 6c utex must be hel
5290: 64 20 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 d when this func
52a0: 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2e 0a tion is called..
52b0: 2a 2f 0a 73 74 61 74 69 63 20 50 67 48 64 72 31 */.static PgHdr1
52c0: 20 2a 70 63 61 63 68 65 31 50 69 6e 50 61 67 65 *pcache1PinPage
52d0: 28 50 67 48 64 72 31 20 2a 70 50 61 67 65 29 7b (PgHdr1 *pPage){
52e0: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
52f0: 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 !=0 );. assert(
5300: 20 50 41 47 45 5f 49 53 5f 55 4e 50 49 4e 4e 45 PAGE_IS_UNPINNE
5310: 44 28 70 50 61 67 65 29 20 29 3b 0a 20 20 61 73 D(pPage) );. as
5320: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 4c 72 sert( pPage->pLr
5330: 75 4e 65 78 74 20 29 3b 0a 20 20 61 73 73 65 72 uNext );. asser
5340: 74 28 20 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 t( pPage->pLruPr
5350: 65 76 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 ev );. assert(
5360: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
5370: 6c 64 28 70 50 61 67 65 2d 3e 70 43 61 63 68 65 ld(pPage->pCache
5380: 2d 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 ->pGroup->mutex)
5390: 20 29 3b 0a 20 20 70 50 61 67 65 2d 3e 70 4c 72 );. pPage->pLr
53a0: 75 50 72 65 76 2d 3e 70 4c 72 75 4e 65 78 74 20 uPrev->pLruNext
53b0: 3d 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 = pPage->pLruNex
53c0: 74 3b 0a 20 20 70 50 61 67 65 2d 3e 70 4c 72 75 t;. pPage->pLru
53d0: 4e 65 78 74 2d 3e 70 4c 72 75 50 72 65 76 20 3d Next->pLruPrev =
53e0: 20 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 pPage->pLruPrev
53f0: 3b 0a 20 20 70 50 61 67 65 2d 3e 70 4c 72 75 4e ;. pPage->pLruN
5400: 65 78 74 20 3d 20 30 3b 0a 20 20 2f 2a 20 70 50 ext = 0;. /* pP
5410: 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20 age->pLruPrev =
5420: 30 3b 0a 20 20 2a 2a 20 4e 6f 20 6e 65 65 64 20 0;. ** No need
5430: 74 6f 20 63 6c 65 61 72 20 70 4c 72 75 50 72 65 to clear pLruPre
5440: 76 20 61 73 20 69 74 20 69 73 20 6e 65 76 65 72 v as it is never
5450: 20 61 63 63 65 73 73 65 64 20 69 66 20 70 4c 72 accessed if pLr
5460: 75 4e 65 78 74 20 69 73 20 30 20 2a 2f 0a 20 20 uNext is 0 */.
5470: 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 69 assert( pPage->i
5480: 73 41 6e 63 68 6f 72 3d 3d 30 20 29 3b 0a 20 20 sAnchor==0 );.
5490: 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 assert( pPage->p
54a0: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 2d 3e 6c Cache->pGroup->l
54b0: 72 75 2e 69 73 41 6e 63 68 6f 72 3d 3d 31 20 29 ru.isAnchor==1 )
54c0: 3b 0a 20 20 70 50 61 67 65 2d 3e 70 43 61 63 68 ;. pPage->pCach
54d0: 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65 2d 2d e->nRecyclable--
54e0: 3b 0a 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 ;. return pPage
54f0: 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 6d 6f ;.}.../*.** Remo
5500: 76 65 20 74 68 65 20 70 61 67 65 20 73 75 70 70 ve the page supp
5510: 6c 69 65 64 20 61 73 20 61 6e 20 61 72 67 75 6d lied as an argum
5520: 65 6e 74 20 66 72 6f 6d 20 74 68 65 20 68 61 73 ent from the has
5530: 68 20 74 61 62 6c 65 20 0a 2a 2a 20 28 50 43 61 h table .** (PCa
5540: 63 68 65 31 2e 61 70 48 61 73 68 20 73 74 72 75 che1.apHash stru
5550: 63 74 75 72 65 29 20 74 68 61 74 20 69 74 20 69 cture) that it i
5560: 73 20 63 75 72 72 65 6e 74 6c 79 20 73 74 6f 72 s currently stor
5570: 65 64 20 69 6e 2e 0a 2a 2a 20 41 6c 73 6f 20 66 ed in..** Also f
5580: 72 65 65 20 74 68 65 20 70 61 67 65 20 69 66 20 ree the page if
5590: 66 72 65 65 50 61 67 65 20 69 73 20 74 72 75 65 freePage is true
55a0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50 47 72 6f ..**.** The PGro
55b0: 75 70 20 6d 75 74 65 78 20 6d 75 73 74 20 62 65 up mutex must be
55c0: 20 68 65 6c 64 20 77 68 65 6e 20 74 68 69 73 20 held when this
55d0: 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c function is call
55e0: 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f ed..*/.static vo
55f0: 69 64 20 70 63 61 63 68 65 31 52 65 6d 6f 76 65 id pcache1Remove
5600: 46 72 6f 6d 48 61 73 68 28 50 67 48 64 72 31 20 FromHash(PgHdr1
5610: 2a 70 50 61 67 65 2c 20 69 6e 74 20 66 72 65 65 *pPage, int free
5620: 46 6c 61 67 29 7b 0a 20 20 75 6e 73 69 67 6e 65 Flag){. unsigne
5630: 64 20 69 6e 74 20 68 3b 0a 20 20 50 43 61 63 68 d int h;. PCach
5640: 65 31 20 2a 70 43 61 63 68 65 20 3d 20 70 50 61 e1 *pCache = pPa
5650: 67 65 2d 3e 70 43 61 63 68 65 3b 0a 20 20 50 67 ge->pCache;. Pg
5660: 48 64 72 31 20 2a 2a 70 70 3b 0a 0a 20 20 61 73 Hdr1 **pp;.. as
5670: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
5680: 74 65 78 5f 68 65 6c 64 28 70 43 61 63 68 65 2d tex_held(pCache-
5690: 3e 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 >pGroup->mutex)
56a0: 29 3b 0a 20 20 68 20 3d 20 70 50 61 67 65 2d 3e );. h = pPage->
56b0: 69 4b 65 79 20 25 20 70 43 61 63 68 65 2d 3e 6e iKey % pCache->n
56c0: 48 61 73 68 3b 0a 20 20 66 6f 72 28 70 70 3d 26 Hash;. for(pp=&
56d0: 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 pCache->apHash[h
56e0: 5d 3b 20 28 2a 70 70 29 21 3d 70 50 61 67 65 3b ]; (*pp)!=pPage;
56f0: 20 70 70 3d 26 28 2a 70 70 29 2d 3e 70 4e 65 78 pp=&(*pp)->pNex
5700: 74 29 3b 0a 20 20 2a 70 70 20 3d 20 28 2a 70 70 t);. *pp = (*pp
5710: 29 2d 3e 70 4e 65 78 74 3b 0a 0a 20 20 70 43 61 )->pNext;.. pCa
5720: 63 68 65 2d 3e 6e 50 61 67 65 2d 2d 3b 0a 20 20 che->nPage--;.
5730: 69 66 28 20 66 72 65 65 46 6c 61 67 20 29 20 70 if( freeFlag ) p
5740: 63 61 63 68 65 31 46 72 65 65 50 61 67 65 28 70 cache1FreePage(p
5750: 50 61 67 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 Page);.}../*.**
5760: 49 66 20 74 68 65 72 65 20 61 72 65 20 63 75 72 If there are cur
5770: 72 65 6e 74 6c 79 20 6d 6f 72 65 20 74 68 61 6e rently more than
5780: 20 6e 4d 61 78 50 61 67 65 20 70 61 67 65 73 20 nMaxPage pages
5790: 61 6c 6c 6f 63 61 74 65 64 2c 20 74 72 79 0a 2a allocated, try.*
57a0: 2a 20 74 6f 20 72 65 63 79 63 6c 65 20 70 61 67 * to recycle pag
57b0: 65 73 20 74 6f 20 72 65 64 75 63 65 20 74 68 65 es to reduce the
57c0: 20 6e 75 6d 62 65 72 20 61 6c 6c 6f 63 61 74 65 number allocate
57d0: 64 20 74 6f 20 6e 4d 61 78 50 61 67 65 2e 0a 2a d to nMaxPage..*
57e0: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 /.static void pc
57f0: 61 63 68 65 31 45 6e 66 6f 72 63 65 4d 61 78 50 ache1EnforceMaxP
5800: 61 67 65 28 50 43 61 63 68 65 31 20 2a 70 43 61 age(PCache1 *pCa
5810: 63 68 65 29 7b 0a 20 20 50 47 72 6f 75 70 20 2a che){. PGroup *
5820: 70 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65 2d pGroup = pCache-
5830: 3e 70 47 72 6f 75 70 3b 0a 20 20 50 67 48 64 72 >pGroup;. PgHdr
5840: 31 20 2a 70 3b 0a 20 20 61 73 73 65 72 74 28 20 1 *p;. assert(
5850: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
5860: 6c 64 28 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 ld(pGroup->mutex
5870: 29 20 29 3b 0a 20 20 77 68 69 6c 65 28 20 70 47 ) );. while( pG
5880: 72 6f 75 70 2d 3e 6e 50 75 72 67 65 61 62 6c 65 roup->nPurgeable
5890: 3e 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 >pGroup->nMaxPag
58a0: 65 0a 20 20 20 20 20 20 26 26 20 28 70 3d 70 47 e. && (p=pG
58b0: 72 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72 75 50 72 roup->lru.pLruPr
58c0: 65 76 29 2d 3e 69 73 41 6e 63 68 6f 72 3d 3d 30 ev)->isAnchor==0
58d0: 0a 20 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 . ){. assert
58e0: 28 20 70 2d 3e 70 43 61 63 68 65 2d 3e 70 47 72 ( p->pCache->pGr
58f0: 6f 75 70 3d 3d 70 47 72 6f 75 70 20 29 3b 0a 20 oup==pGroup );.
5900: 20 20 20 61 73 73 65 72 74 28 20 50 41 47 45 5f assert( PAGE_
5910: 49 53 5f 55 4e 50 49 4e 4e 45 44 28 70 29 20 29 IS_UNPINNED(p) )
5920: 3b 0a 20 20 20 20 70 63 61 63 68 65 31 50 69 6e ;. pcache1Pin
5930: 50 61 67 65 28 70 29 3b 0a 20 20 20 20 70 63 61 Page(p);. pca
5940: 63 68 65 31 52 65 6d 6f 76 65 46 72 6f 6d 48 61 che1RemoveFromHa
5950: 73 68 28 70 2c 20 31 29 3b 0a 20 20 7d 0a 20 20 sh(p, 1);. }.
5960: 69 66 28 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 if( pCache->nPag
5970: 65 3d 3d 30 20 26 26 20 70 43 61 63 68 65 2d 3e e==0 && pCache->
5980: 70 42 75 6c 6b 20 29 7b 0a 20 20 20 20 73 71 6c pBulk ){. sql
5990: 69 74 65 33 5f 66 72 65 65 28 70 43 61 63 68 65 ite3_free(pCache
59a0: 2d 3e 70 42 75 6c 6b 29 3b 0a 20 20 20 20 70 43 ->pBulk);. pC
59b0: 61 63 68 65 2d 3e 70 42 75 6c 6b 20 3d 20 70 43 ache->pBulk = pC
59c0: 61 63 68 65 2d 3e 70 46 72 65 65 20 3d 20 30 3b ache->pFree = 0;
59d0: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 69 . }.}../*.** Di
59e0: 73 63 61 72 64 20 61 6c 6c 20 70 61 67 65 73 20 scard all pages
59f0: 66 72 6f 6d 20 63 61 63 68 65 20 70 43 61 63 68 from cache pCach
5a00: 65 20 77 69 74 68 20 61 20 70 61 67 65 20 6e 75 e with a page nu
5a10: 6d 62 65 72 20 28 6b 65 79 20 76 61 6c 75 65 29 mber (key value)
5a20: 20 0a 2a 2a 20 67 72 65 61 74 65 72 20 74 68 61 .** greater tha
5a30: 6e 20 6f 72 20 65 71 75 61 6c 20 74 6f 20 69 4c n or equal to iL
5a40: 69 6d 69 74 2e 20 41 6e 79 20 70 69 6e 6e 65 64 imit. Any pinned
5a50: 20 70 61 67 65 73 20 74 68 61 74 20 6d 65 65 74 pages that meet
5a60: 20 74 68 69 73 20 0a 2a 2a 20 63 72 69 74 65 72 this .** criter
5a70: 69 61 20 61 72 65 20 75 6e 70 69 6e 6e 65 64 20 ia are unpinned
5a80: 62 65 66 6f 72 65 20 74 68 65 79 20 61 72 65 20 before they are
5a90: 64 69 73 63 61 72 64 65 64 2e 0a 2a 2a 0a 2a 2a discarded..**.**
5aa0: 20 54 68 65 20 50 43 61 63 68 65 20 6d 75 74 65 The PCache mute
5ab0: 78 20 6d 75 73 74 20 62 65 20 68 65 6c 64 20 77 x must be held w
5ac0: 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f hen this functio
5ad0: 6e 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a n is called..*/.
5ae0: 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 static void pcac
5af0: 68 65 31 54 72 75 6e 63 61 74 65 55 6e 73 61 66 he1TruncateUnsaf
5b00: 65 28 0a 20 20 50 43 61 63 68 65 31 20 2a 70 43 e(. PCache1 *pC
5b10: 61 63 68 65 2c 20 20 20 20 20 20 20 20 20 20 20 ache,
5b20: 20 20 2f 2a 20 54 68 65 20 63 61 63 68 65 20 74 /* The cache t
5b30: 6f 20 74 72 75 6e 63 61 74 65 20 2a 2f 0a 20 20 o truncate */.
5b40: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4c 69 unsigned int iLi
5b50: 6d 69 74 20 20 20 20 20 20 20 20 20 20 2f 2a 20 mit /*
5b60: 44 72 6f 70 20 70 61 67 65 73 20 77 69 74 68 20 Drop pages with
5b70: 74 68 69 73 20 70 67 6e 6f 20 6f 72 20 6c 61 72 this pgno or lar
5b80: 67 65 72 20 2a 2f 0a 29 7b 0a 20 20 54 45 53 54 ger */.){. TEST
5b90: 4f 4e 4c 59 28 20 69 6e 74 20 6e 50 61 67 65 20 ONLY( int nPage
5ba0: 3d 20 30 3b 20 29 20 20 2f 2a 20 54 6f 20 61 73 = 0; ) /* To as
5bb0: 73 65 72 74 20 70 43 61 63 68 65 2d 3e 6e 50 61 sert pCache->nPa
5bc0: 67 65 20 69 73 20 63 6f 72 72 65 63 74 20 2a 2f ge is correct */
5bd0: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 . unsigned int
5be0: 68 2c 20 69 53 74 6f 70 3b 0a 20 20 61 73 73 65 h, iStop;. asse
5bf0: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
5c00: 78 5f 68 65 6c 64 28 70 43 61 63 68 65 2d 3e 70 x_held(pCache->p
5c10: 47 72 6f 75 70 2d 3e 6d 75 74 65 78 29 20 29 3b Group->mutex) );
5c20: 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68 . assert( pCach
5c30: 65 2d 3e 69 4d 61 78 4b 65 79 20 3e 3d 20 69 4c e->iMaxKey >= iL
5c40: 69 6d 69 74 20 29 3b 0a 20 20 61 73 73 65 72 74 imit );. assert
5c50: 28 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 20 ( pCache->nHash
5c60: 3e 20 30 20 29 3b 0a 20 20 69 66 28 20 70 43 61 > 0 );. if( pCa
5c70: 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 2d 20 69 che->iMaxKey - i
5c80: 4c 69 6d 69 74 20 3c 20 70 43 61 63 68 65 2d 3e Limit < pCache->
5c90: 6e 48 61 73 68 20 29 7b 0a 20 20 20 20 2f 2a 20 nHash ){. /*
5ca0: 49 66 20 77 65 20 61 72 65 20 6a 75 73 74 20 73 If we are just s
5cb0: 68 61 76 69 6e 67 20 74 68 65 20 6c 61 73 74 20 having the last
5cc0: 66 65 77 20 70 61 67 65 73 20 6f 66 66 20 74 68 few pages off th
5cd0: 65 20 65 6e 64 20 6f 66 20 74 68 65 0a 20 20 20 e end of the.
5ce0: 20 2a 2a 20 63 61 63 68 65 2c 20 74 68 65 6e 20 ** cache, then
5cf0: 74 68 65 72 65 20 69 73 20 6e 6f 20 70 6f 69 6e there is no poin
5d00: 74 20 69 6e 20 73 63 61 6e 6e 69 6e 67 20 74 68 t in scanning th
5d10: 65 20 65 6e 74 69 72 65 20 68 61 73 68 20 74 61 e entire hash ta
5d20: 62 6c 65 2e 0a 20 20 20 20 2a 2a 20 4f 6e 6c 79 ble.. ** Only
5d30: 20 73 63 61 6e 20 74 68 6f 73 65 20 68 61 73 68 scan those hash
5d40: 20 73 6c 6f 74 73 20 74 68 61 74 20 6d 69 67 68 slots that migh
5d50: 74 20 63 6f 6e 74 61 69 6e 20 70 61 67 65 73 20 t contain pages
5d60: 74 68 61 74 20 6e 65 65 64 20 74 6f 0a 20 20 20 that need to.
5d70: 20 2a 2a 20 62 65 20 72 65 6d 6f 76 65 64 2e 20 ** be removed.
5d80: 2a 2f 0a 20 20 20 20 68 20 3d 20 69 4c 69 6d 69 */. h = iLimi
5d90: 74 20 25 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 t % pCache->nHas
5da0: 68 3b 0a 20 20 20 20 69 53 74 6f 70 20 3d 20 70 h;. iStop = p
5db0: 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 25 Cache->iMaxKey %
5dc0: 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a pCache->nHash;.
5dd0: 20 20 20 20 54 45 53 54 4f 4e 4c 59 28 20 6e 50 TESTONLY( nP
5de0: 61 67 65 20 3d 20 2d 31 30 3b 20 29 20 20 2f 2a age = -10; ) /*
5df0: 20 44 69 73 61 62 6c 65 20 74 68 65 20 70 43 61 Disable the pCa
5e00: 63 68 65 2d 3e 6e 50 61 67 65 20 76 61 6c 69 64 che->nPage valid
5e10: 69 74 79 20 63 68 65 63 6b 20 2a 2f 0a 20 20 7d ity check */. }
5e20: 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 54 68 69 else{. /* Thi
5e30: 73 20 69 73 20 74 68 65 20 67 65 6e 65 72 61 6c s is the general
5e40: 20 63 61 73 65 20 77 68 65 72 65 20 6d 61 6e 79 case where many
5e50: 20 70 61 67 65 73 20 61 72 65 20 62 65 69 6e 67 pages are being
5e60: 20 72 65 6d 6f 76 65 64 2e 0a 20 20 20 20 2a 2a removed.. **
5e70: 20 49 74 20 69 73 20 6e 65 63 65 73 73 61 72 79 It is necessary
5e80: 20 74 6f 20 73 63 61 6e 20 74 68 65 20 65 6e 74 to scan the ent
5e90: 69 72 65 20 68 61 73 68 20 74 61 62 6c 65 20 2a ire hash table *
5ea0: 2f 0a 20 20 20 20 68 20 3d 20 70 43 61 63 68 65 /. h = pCache
5eb0: 2d 3e 6e 48 61 73 68 2f 32 3b 0a 20 20 20 20 69 ->nHash/2;. i
5ec0: 53 74 6f 70 20 3d 20 68 20 2d 20 31 3b 0a 20 20 Stop = h - 1;.
5ed0: 7d 0a 20 20 66 6f 72 28 3b 3b 29 7b 0a 20 20 20 }. for(;;){.
5ee0: 20 50 67 48 64 72 31 20 2a 2a 70 70 3b 0a 20 20 PgHdr1 **pp;.
5ef0: 20 20 50 67 48 64 72 31 20 2a 70 50 61 67 65 3b PgHdr1 *pPage;
5f00: 0a 20 20 20 20 61 73 73 65 72 74 28 20 68 3c 70 . assert( h<p
5f10: 43 61 63 68 65 2d 3e 6e 48 61 73 68 20 29 3b 0a Cache->nHash );.
5f20: 20 20 20 20 70 70 20 3d 20 26 70 43 61 63 68 65 pp = &pCache
5f30: 2d 3e 61 70 48 61 73 68 5b 68 5d 3b 20 0a 20 20 ->apHash[h]; .
5f40: 20 20 77 68 69 6c 65 28 20 28 70 50 61 67 65 20 while( (pPage
5f50: 3d 20 2a 70 70 29 21 3d 30 20 29 7b 0a 20 20 20 = *pp)!=0 ){.
5f60: 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e 69 4b if( pPage->iK
5f70: 65 79 3e 3d 69 4c 69 6d 69 74 20 29 7b 0a 20 20 ey>=iLimit ){.
5f80: 20 20 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 50 pCache->nP
5f90: 61 67 65 2d 2d 3b 0a 20 20 20 20 20 20 20 20 2a age--;. *
5fa0: 70 70 20 3d 20 70 50 61 67 65 2d 3e 70 4e 65 78 pp = pPage->pNex
5fb0: 74 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 50 t;. if( P
5fc0: 41 47 45 5f 49 53 5f 55 4e 50 49 4e 4e 45 44 28 AGE_IS_UNPINNED(
5fd0: 70 50 61 67 65 29 20 29 20 70 63 61 63 68 65 31 pPage) ) pcache1
5fe0: 50 69 6e 50 61 67 65 28 70 50 61 67 65 29 3b 0a PinPage(pPage);.
5ff0: 20 20 20 20 20 20 20 20 70 63 61 63 68 65 31 46 pcache1F
6000: 72 65 65 50 61 67 65 28 70 50 61 67 65 29 3b 0a reePage(pPage);.
6010: 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }else{.
6020: 20 20 20 20 20 70 70 20 3d 20 26 70 50 61 67 65 pp = &pPage
6030: 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 20 ->pNext;.
6040: 20 54 45 53 54 4f 4e 4c 59 28 20 69 66 28 20 6e TESTONLY( if( n
6050: 50 61 67 65 3e 3d 30 20 29 20 6e 50 61 67 65 2b Page>=0 ) nPage+
6060: 2b 3b 20 29 0a 20 20 20 20 20 20 7d 0a 20 20 20 +; ). }.
6070: 20 7d 0a 20 20 20 20 69 66 28 20 68 3d 3d 69 53 }. if( h==iS
6080: 74 6f 70 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 top ) break;.
6090: 20 68 20 3d 20 28 68 2b 31 29 20 25 20 70 43 61 h = (h+1) % pCa
60a0: 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 7d 0a che->nHash;. }.
60b0: 20 20 61 73 73 65 72 74 28 20 6e 50 61 67 65 3c assert( nPage<
60c0: 30 20 7c 7c 20 70 43 61 63 68 65 2d 3e 6e 50 61 0 || pCache->nPa
60d0: 67 65 3d 3d 28 75 6e 73 69 67 6e 65 64 29 6e 50 ge==(unsigned)nP
60e0: 61 67 65 20 29 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a age );.}../*****
60f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
6100: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
6110: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
6120: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
6130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 2f 2a 2a 2a 2a *********/./****
6140: 2a 2a 2a 2a 20 73 71 6c 69 74 65 33 5f 70 63 61 **** sqlite3_pca
6150: 63 68 65 20 4d 65 74 68 6f 64 73 20 2a 2a 2a 2a che Methods ****
6160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
6170: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
6180: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 0a **********/../*.
6190: 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f ** Implementatio
61a0: 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 n of the sqlite3
61b0: 5f 70 63 61 63 68 65 2e 78 49 6e 69 74 20 6d 65 _pcache.xInit me
61c0: 74 68 6f 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 thod..*/.static
61d0: 69 6e 74 20 70 63 61 63 68 65 31 49 6e 69 74 28 int pcache1Init(
61e0: 76 6f 69 64 20 2a 4e 6f 74 55 73 65 64 29 7b 0a void *NotUsed){.
61f0: 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 UNUSED_PARAMET
6200: 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 61 ER(NotUsed);. a
6210: 73 73 65 72 74 28 20 70 63 61 63 68 65 31 2e 69 ssert( pcache1.i
6220: 73 49 6e 69 74 3d 3d 30 20 29 3b 0a 20 20 6d 65 sInit==0 );. me
6230: 6d 73 65 74 28 26 70 63 61 63 68 65 31 2c 20 30 mset(&pcache1, 0
6240: 2c 20 73 69 7a 65 6f 66 28 70 63 61 63 68 65 31 , sizeof(pcache1
6250: 29 29 3b 0a 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 ));... /*. **
6260: 54 68 65 20 70 63 61 63 68 65 31 2e 73 65 70 61 The pcache1.sepa
6270: 72 61 74 65 43 61 63 68 65 20 76 61 72 69 61 62 rateCache variab
6280: 6c 65 20 69 73 20 74 72 75 65 20 69 66 20 65 61 le is true if ea
6290: 63 68 20 50 43 61 63 68 65 20 68 61 73 20 69 74 ch PCache has it
62a0: 73 20 6f 77 6e 0a 20 20 2a 2a 20 70 72 69 76 61 s own. ** priva
62b0: 74 65 20 50 47 72 6f 75 70 20 28 6d 6f 64 65 2d te PGroup (mode-
62c0: 31 29 2e 20 20 70 63 61 63 68 65 31 2e 73 65 70 1). pcache1.sep
62d0: 61 72 61 74 65 43 61 63 68 65 20 69 73 20 66 61 arateCache is fa
62e0: 6c 73 65 20 69 66 20 74 68 65 20 73 69 6e 67 6c lse if the singl
62f0: 65 0a 20 20 2a 2a 20 50 47 72 6f 75 70 20 69 6e e. ** PGroup in
6300: 20 70 63 61 63 68 65 31 2e 67 72 70 20 69 73 20 pcache1.grp is
6310: 75 73 65 64 20 66 6f 72 20 61 6c 6c 20 70 61 67 used for all pag
6320: 65 20 63 61 63 68 65 73 20 28 6d 6f 64 65 2d 32 e caches (mode-2
6330: 29 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a ).. **. ** *
6340: 20 20 41 6c 77 61 79 73 20 75 73 65 20 61 20 75 Always use a u
6350: 6e 69 66 69 65 64 20 63 61 63 68 65 20 28 6d 6f nified cache (mo
6360: 64 65 2d 32 29 20 69 66 20 45 4e 41 42 4c 45 5f de-2) if ENABLE_
6370: 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e MEMORY_MANAGEMEN
6380: 54 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 T. **. ** *
6390: 20 55 73 65 20 61 20 75 6e 69 66 69 65 64 20 63 Use a unified c
63a0: 61 63 68 65 20 69 6e 20 73 69 6e 67 6c 65 2d 74 ache in single-t
63b0: 68 72 65 61 64 65 64 20 61 70 70 6c 69 63 61 74 hreaded applicat
63c0: 69 6f 6e 73 20 74 68 61 74 20 68 61 76 65 0a 20 ions that have.
63d0: 20 2a 2a 20 20 20 20 20 20 63 6f 6e 66 69 67 75 ** configu
63e0: 72 65 64 20 61 20 73 74 61 72 74 2d 74 69 6d 65 red a start-time
63f0: 20 62 75 66 66 65 72 20 66 6f 72 20 75 73 65 20 buffer for use
6400: 61 73 20 70 61 67 65 2d 63 61 63 68 65 20 6d 65 as page-cache me
6410: 6d 6f 72 79 20 75 73 69 6e 67 0a 20 20 2a 2a 20 mory using. **
6420: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e sqlite3_con
6430: 66 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 fig(SQLITE_CONFI
6440: 47 5f 50 41 47 45 43 41 43 48 45 2c 20 70 42 75 G_PAGECACHE, pBu
6450: 66 2c 20 73 7a 2c 20 4e 29 20 77 69 74 68 20 6e f, sz, N) with n
6460: 6f 6e 2d 4e 55 4c 4c 20 0a 20 20 2a 2a 20 20 20 on-NULL . **
6470: 20 20 20 70 42 75 66 20 61 72 67 75 6d 65 6e 74 pBuf argument
6480: 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 .. **. ** *
6490: 20 4f 74 68 65 72 77 69 73 65 20 75 73 65 20 73 Otherwise use s
64a0: 65 70 61 72 61 74 65 20 63 61 63 68 65 73 20 28 eparate caches (
64b0: 6d 6f 64 65 2d 31 29 0a 20 20 2a 2f 0a 23 69 66 mode-1). */.#if
64c0: 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
64d0: 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 ENABLE_MEMORY_MA
64e0: 4e 41 47 45 4d 45 4e 54 29 0a 20 20 70 63 61 63 NAGEMENT). pcac
64f0: 68 65 31 2e 73 65 70 61 72 61 74 65 43 61 63 68 he1.separateCach
6500: 65 20 3d 20 30 3b 0a 23 65 6c 69 66 20 53 51 4c e = 0;.#elif SQL
6510: 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 0a 20 ITE_THREADSAFE.
6520: 20 70 63 61 63 68 65 31 2e 73 65 70 61 72 61 74 pcache1.separat
6530: 65 43 61 63 68 65 20 3d 20 73 71 6c 69 74 65 33 eCache = sqlite3
6540: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61 GlobalConfig.pPa
6550: 67 65 3d 3d 30 0a 20 20 20 20 20 20 20 20 20 20 ge==0.
6560: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
6570: 7c 7c 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c || sqlite3Global
6580: 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 Config.bCoreMute
6590: 78 3e 30 3b 0a 23 65 6c 73 65 0a 20 20 70 63 61 x>0;.#else. pca
65a0: 63 68 65 31 2e 73 65 70 61 72 61 74 65 43 61 63 che1.separateCac
65b0: 68 65 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 he = sqlite3Glob
65c0: 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65 3d 3d alConfig.pPage==
65d0: 30 3b 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 53 0;.#endif..#if S
65e0: 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 QLITE_THREADSAFE
65f0: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c . if( sqlite3Gl
6600: 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 obalConfig.bCore
6610: 4d 75 74 65 78 20 29 7b 0a 20 20 20 20 70 63 61 Mutex ){. pca
6620: 63 68 65 31 2e 67 72 70 2e 6d 75 74 65 78 20 3d che1.grp.mutex =
6630: 20 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c sqlite3MutexAll
6640: 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f oc(SQLITE_MUTEX_
6650: 53 54 41 54 49 43 5f 4c 52 55 29 3b 0a 20 20 20 STATIC_LRU);.
6660: 20 70 63 61 63 68 65 31 2e 6d 75 74 65 78 20 3d pcache1.mutex =
6670: 20 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c sqlite3MutexAll
6680: 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f oc(SQLITE_MUTEX_
6690: 53 54 41 54 49 43 5f 50 4d 45 4d 29 3b 0a 20 20 STATIC_PMEM);.
66a0: 7d 0a 23 65 6e 64 69 66 0a 20 20 69 66 28 20 70 }.#endif. if( p
66b0: 63 61 63 68 65 31 2e 73 65 70 61 72 61 74 65 43 cache1.separateC
66c0: 61 63 68 65 0a 20 20 20 26 26 20 73 71 6c 69 74 ache. && sqlit
66d0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e e3GlobalConfig.n
66e0: 50 61 67 65 21 3d 30 0a 20 20 20 26 26 20 73 71 Page!=0. && sq
66f0: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
6700: 67 2e 70 50 61 67 65 3d 3d 30 0a 20 20 29 7b 0a g.pPage==0. ){.
6710: 20 20 20 20 70 63 61 63 68 65 31 2e 6e 49 6e 69 pcache1.nIni
6720: 74 50 61 67 65 20 3d 20 73 71 6c 69 74 65 33 47 tPage = sqlite3G
6730: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 50 61 67 lobalConfig.nPag
6740: 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 e;. }else{.
6750: 70 63 61 63 68 65 31 2e 6e 49 6e 69 74 50 61 67 pcache1.nInitPag
6760: 65 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 70 63 61 e = 0;. }. pca
6770: 63 68 65 31 2e 67 72 70 2e 6d 78 50 69 6e 6e 65 che1.grp.mxPinne
6780: 64 20 3d 20 31 30 3b 0a 20 20 70 63 61 63 68 65 d = 10;. pcache
6790: 31 2e 69 73 49 6e 69 74 20 3d 20 31 3b 0a 20 20 1.isInit = 1;.
67a0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
67b0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 ;.}../*.** Imple
67c0: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 mentation of the
67d0: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e sqlite3_pcache.
67e0: 78 53 68 75 74 64 6f 77 6e 20 6d 65 74 68 6f 64 xShutdown method
67f0: 2e 0a 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 74 ..** Note that t
6800: 68 65 20 73 74 61 74 69 63 20 6d 75 74 65 78 20 he static mutex
6810: 61 6c 6c 6f 63 61 74 65 64 20 69 6e 20 78 49 6e allocated in xIn
6820: 69 74 20 64 6f 65 73 20 0a 2a 2a 20 6e 6f 74 20 it does .** not
6830: 6e 65 65 64 20 74 6f 20 62 65 20 66 72 65 65 64 need to be freed
6840: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 ..*/.static void
6850: 20 70 63 61 63 68 65 31 53 68 75 74 64 6f 77 6e pcache1Shutdown
6860: 28 76 6f 69 64 20 2a 4e 6f 74 55 73 65 64 29 7b (void *NotUsed){
6870: 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 . UNUSED_PARAME
6880: 54 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 TER(NotUsed);.
6890: 61 73 73 65 72 74 28 20 70 63 61 63 68 65 31 2e assert( pcache1.
68a0: 69 73 49 6e 69 74 21 3d 30 20 29 3b 0a 20 20 6d isInit!=0 );. m
68b0: 65 6d 73 65 74 28 26 70 63 61 63 68 65 31 2c 20 emset(&pcache1,
68c0: 30 2c 20 73 69 7a 65 6f 66 28 70 63 61 63 68 65 0, sizeof(pcache
68d0: 31 29 29 3b 0a 7d 0a 0a 2f 2a 20 66 6f 72 77 61 1));.}../* forwa
68e0: 72 64 20 64 65 63 6c 61 72 61 74 69 6f 6e 20 2a rd declaration *
68f0: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 /.static void pc
6900: 61 63 68 65 31 44 65 73 74 72 6f 79 28 73 71 6c ache1Destroy(sql
6910: 69 74 65 33 5f 70 63 61 63 68 65 20 2a 70 29 3b ite3_pcache *p);
6920: 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e ../*.** Implemen
6930: 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 tation of the sq
6940: 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78 43 72 lite3_pcache.xCr
6950: 65 61 74 65 20 6d 65 74 68 6f 64 2e 0a 2a 2a 0a eate method..**.
6960: 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 61 20 6e 65 ** Allocate a ne
6970: 77 20 63 61 63 68 65 2e 0a 2a 2f 0a 73 74 61 74 w cache..*/.stat
6980: 69 63 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 ic sqlite3_pcach
6990: 65 20 2a 70 63 61 63 68 65 31 43 72 65 61 74 65 e *pcache1Create
69a0: 28 69 6e 74 20 73 7a 50 61 67 65 2c 20 69 6e 74 (int szPage, int
69b0: 20 73 7a 45 78 74 72 61 2c 20 69 6e 74 20 62 50 szExtra, int bP
69c0: 75 72 67 65 61 62 6c 65 29 7b 0a 20 20 50 43 61 urgeable){. PCa
69d0: 63 68 65 31 20 2a 70 43 61 63 68 65 3b 20 20 20 che1 *pCache;
69e0: 20 20 20 2f 2a 20 54 68 65 20 6e 65 77 6c 79 20 /* The newly
69f0: 63 72 65 61 74 65 64 20 70 61 67 65 20 63 61 63 created page cac
6a00: 68 65 20 2a 2f 0a 20 20 50 47 72 6f 75 70 20 2a he */. PGroup *
6a10: 70 47 72 6f 75 70 3b 20 20 20 20 20 20 20 2f 2a pGroup; /*
6a20: 20 54 68 65 20 67 72 6f 75 70 20 74 68 65 20 6e The group the n
6a30: 65 77 20 70 61 67 65 20 63 61 63 68 65 20 77 69 ew page cache wi
6a40: 6c 6c 20 62 65 6c 6f 6e 67 20 74 6f 20 2a 2f 0a ll belong to */.
6a50: 20 20 69 6e 74 20 73 7a 3b 20 20 20 20 20 20 20 int sz;
6a60: 20 20 20 20 20 20 20 20 2f 2a 20 42 79 74 65 73 /* Bytes
6a70: 20 6f 66 20 6d 65 6d 6f 72 79 20 72 65 71 75 69 of memory requi
6a80: 72 65 64 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 red to allocate
6a90: 74 68 65 20 6e 65 77 20 63 61 63 68 65 20 2a 2f the new cache */
6aa0: 0a 0a 20 20 61 73 73 65 72 74 28 20 28 73 7a 50 .. assert( (szP
6ab0: 61 67 65 20 26 20 28 73 7a 50 61 67 65 2d 31 29 age & (szPage-1)
6ac0: 29 3d 3d 30 20 26 26 20 73 7a 50 61 67 65 3e 3d )==0 && szPage>=
6ad0: 35 31 32 20 26 26 20 73 7a 50 61 67 65 3c 3d 36 512 && szPage<=6
6ae0: 35 35 33 36 20 29 3b 0a 20 20 61 73 73 65 72 74 5536 );. assert
6af0: 28 20 73 7a 45 78 74 72 61 20 3c 20 33 30 30 20 ( szExtra < 300
6b00: 29 3b 0a 0a 20 20 73 7a 20 3d 20 73 69 7a 65 6f );.. sz = sizeo
6b10: 66 28 50 43 61 63 68 65 31 29 20 2b 20 73 69 7a f(PCache1) + siz
6b20: 65 6f 66 28 50 47 72 6f 75 70 29 2a 70 63 61 63 eof(PGroup)*pcac
6b30: 68 65 31 2e 73 65 70 61 72 61 74 65 43 61 63 68 he1.separateCach
6b40: 65 3b 0a 20 20 70 43 61 63 68 65 20 3d 20 28 50 e;. pCache = (P
6b50: 43 61 63 68 65 31 20 2a 29 73 71 6c 69 74 65 33 Cache1 *)sqlite3
6b60: 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 7a 29 3b 0a MallocZero(sz);.
6b70: 20 20 69 66 28 20 70 43 61 63 68 65 20 29 7b 0a if( pCache ){.
6b80: 20 20 20 20 69 66 28 20 70 63 61 63 68 65 31 2e if( pcache1.
6b90: 73 65 70 61 72 61 74 65 43 61 63 68 65 20 29 7b separateCache ){
6ba0: 0a 20 20 20 20 20 20 70 47 72 6f 75 70 20 3d 20 . pGroup =
6bb0: 28 50 47 72 6f 75 70 2a 29 26 70 43 61 63 68 65 (PGroup*)&pCache
6bc0: 5b 31 5d 3b 0a 20 20 20 20 20 20 70 47 72 6f 75 [1];. pGrou
6bd0: 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 20 31 30 p->mxPinned = 10
6be0: 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ;. }else{.
6bf0: 20 20 20 70 47 72 6f 75 70 20 3d 20 26 70 63 61 pGroup = &pca
6c00: 63 68 65 31 2e 67 72 70 3b 0a 20 20 20 20 7d 0a che1.grp;. }.
6c10: 20 20 20 20 69 66 28 20 70 47 72 6f 75 70 2d 3e if( pGroup->
6c20: 6c 72 75 2e 69 73 41 6e 63 68 6f 72 3d 3d 30 20 lru.isAnchor==0
6c30: 29 7b 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d ){. pGroup-
6c40: 3e 6c 72 75 2e 69 73 41 6e 63 68 6f 72 20 3d 20 >lru.isAnchor =
6c50: 31 3b 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d 1;. pGroup-
6c60: 3e 6c 72 75 2e 70 4c 72 75 50 72 65 76 20 3d 20 >lru.pLruPrev =
6c70: 70 47 72 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72 75 pGroup->lru.pLru
6c80: 4e 65 78 74 20 3d 20 26 70 47 72 6f 75 70 2d 3e Next = &pGroup->
6c90: 6c 72 75 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 lru;. }. p
6ca0: 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 20 3d 20 Cache->pGroup =
6cb0: 70 47 72 6f 75 70 3b 0a 20 20 20 20 70 43 61 63 pGroup;. pCac
6cc0: 68 65 2d 3e 73 7a 50 61 67 65 20 3d 20 73 7a 50 he->szPage = szP
6cd0: 61 67 65 3b 0a 20 20 20 20 70 43 61 63 68 65 2d age;. pCache-
6ce0: 3e 73 7a 45 78 74 72 61 20 3d 20 73 7a 45 78 74 >szExtra = szExt
6cf0: 72 61 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e ra;. pCache->
6d00: 73 7a 41 6c 6c 6f 63 20 3d 20 73 7a 50 61 67 65 szAlloc = szPage
6d10: 20 2b 20 73 7a 45 78 74 72 61 20 2b 20 52 4f 55 + szExtra + ROU
6d20: 4e 44 38 28 73 69 7a 65 6f 66 28 50 67 48 64 72 ND8(sizeof(PgHdr
6d30: 31 29 29 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 1));. pCache-
6d40: 3e 62 50 75 72 67 65 61 62 6c 65 20 3d 20 28 62 >bPurgeable = (b
6d50: 50 75 72 67 65 61 62 6c 65 20 3f 20 31 20 3a 20 Purgeable ? 1 :
6d60: 30 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 45 0);. pcache1E
6d70: 6e 74 65 72 4d 75 74 65 78 28 70 47 72 6f 75 70 nterMutex(pGroup
6d80: 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 52 65 );. pcache1Re
6d90: 73 69 7a 65 48 61 73 68 28 70 43 61 63 68 65 29 sizeHash(pCache)
6da0: 3b 0a 20 20 20 20 69 66 28 20 62 50 75 72 67 65 ;. if( bPurge
6db0: 61 62 6c 65 20 29 7b 0a 20 20 20 20 20 20 70 43 able ){. pC
6dc0: 61 63 68 65 2d 3e 6e 4d 69 6e 20 3d 20 31 30 3b ache->nMin = 10;
6dd0: 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e . pGroup->n
6de0: 4d 69 6e 50 61 67 65 20 2b 3d 20 70 43 61 63 68 MinPage += pCach
6df0: 65 2d 3e 6e 4d 69 6e 3b 0a 20 20 20 20 20 20 70 e->nMin;. p
6e00: 47 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 Group->mxPinned
6e10: 3d 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 = pGroup->nMaxPa
6e20: 67 65 20 2b 20 31 30 20 2d 20 70 47 72 6f 75 70 ge + 10 - pGroup
6e30: 2d 3e 6e 4d 69 6e 50 61 67 65 3b 0a 20 20 20 20 ->nMinPage;.
6e40: 20 20 70 43 61 63 68 65 2d 3e 70 6e 50 75 72 67 pCache->pnPurg
6e50: 65 61 62 6c 65 20 3d 20 26 70 47 72 6f 75 70 2d eable = &pGroup-
6e60: 3e 6e 50 75 72 67 65 61 62 6c 65 3b 0a 20 20 20 >nPurgeable;.
6e70: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 74 }else{. st
6e80: 61 74 69 63 20 75 6e 73 69 67 6e 65 64 20 69 6e atic unsigned in
6e90: 74 20 64 75 6d 6d 79 43 75 72 72 65 6e 74 50 61 t dummyCurrentPa
6ea0: 67 65 3b 0a 20 20 20 20 20 20 70 43 61 63 68 65 ge;. pCache
6eb0: 2d 3e 70 6e 50 75 72 67 65 61 62 6c 65 20 3d 20 ->pnPurgeable =
6ec0: 26 64 75 6d 6d 79 43 75 72 72 65 6e 74 50 61 67 &dummyCurrentPag
6ed0: 65 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 63 61 e;. }. pca
6ee0: 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70 che1LeaveMutex(p
6ef0: 47 72 6f 75 70 29 3b 0a 20 20 20 20 69 66 28 20 Group);. if(
6f00: 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 3d 3d 30 pCache->nHash==0
6f10: 20 29 7b 0a 20 20 20 20 20 20 70 63 61 63 68 65 ){. pcache
6f20: 31 44 65 73 74 72 6f 79 28 28 73 71 6c 69 74 65 1Destroy((sqlite
6f30: 33 5f 70 63 61 63 68 65 2a 29 70 43 61 63 68 65 3_pcache*)pCache
6f40: 29 3b 0a 20 20 20 20 20 20 70 43 61 63 68 65 20 );. pCache
6f50: 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 = 0;. }. }.
6f60: 20 72 65 74 75 72 6e 20 28 73 71 6c 69 74 65 33 return (sqlite3
6f70: 5f 70 63 61 63 68 65 20 2a 29 70 43 61 63 68 65 _pcache *)pCache
6f80: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 ;.}../*.** Imple
6f90: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 mentation of the
6fa0: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e sqlite3_pcache.
6fb0: 78 43 61 63 68 65 73 69 7a 65 20 6d 65 74 68 6f xCachesize metho
6fc0: 64 2e 20 0a 2a 2a 0a 2a 2a 20 43 6f 6e 66 69 67 d. .**.** Config
6fd0: 75 72 65 20 74 68 65 20 63 61 63 68 65 5f 73 69 ure the cache_si
6fe0: 7a 65 20 6c 69 6d 69 74 20 66 6f 72 20 61 20 63 ze limit for a c
6ff0: 61 63 68 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 ache..*/.static
7000: 76 6f 69 64 20 70 63 61 63 68 65 31 43 61 63 68 void pcache1Cach
7010: 65 73 69 7a 65 28 73 71 6c 69 74 65 33 5f 70 63 esize(sqlite3_pc
7020: 61 63 68 65 20 2a 70 2c 20 69 6e 74 20 6e 4d 61 ache *p, int nMa
7030: 78 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 x){. PCache1 *p
7040: 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 65 31 Cache = (PCache1
7050: 20 2a 29 70 3b 0a 20 20 69 66 28 20 70 43 61 63 *)p;. if( pCac
7060: 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 29 he->bPurgeable )
7070: 7b 0a 20 20 20 20 50 47 72 6f 75 70 20 2a 70 47 {. PGroup *pG
7080: 72 6f 75 70 20 3d 20 70 43 61 63 68 65 2d 3e 70 roup = pCache->p
7090: 47 72 6f 75 70 3b 0a 20 20 20 20 70 63 61 63 68 Group;. pcach
70a0: 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70 47 72 e1EnterMutex(pGr
70b0: 6f 75 70 29 3b 0a 20 20 20 20 70 47 72 6f 75 70 oup);. pGroup
70c0: 2d 3e 6e 4d 61 78 50 61 67 65 20 2b 3d 20 28 6e ->nMaxPage += (n
70d0: 4d 61 78 20 2d 20 70 43 61 63 68 65 2d 3e 6e 4d Max - pCache->nM
70e0: 61 78 29 3b 0a 20 20 20 20 70 47 72 6f 75 70 2d ax);. pGroup-
70f0: 3e 6d 78 50 69 6e 6e 65 64 20 3d 20 70 47 72 6f >mxPinned = pGro
7100: 75 70 2d 3e 6e 4d 61 78 50 61 67 65 20 2b 20 31 up->nMaxPage + 1
7110: 30 20 2d 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 0 - pGroup->nMin
7120: 50 61 67 65 3b 0a 20 20 20 20 70 43 61 63 68 65 Page;. pCache
7130: 2d 3e 6e 4d 61 78 20 3d 20 6e 4d 61 78 3b 0a 20 ->nMax = nMax;.
7140: 20 20 20 70 43 61 63 68 65 2d 3e 6e 39 30 70 63 pCache->n90pc
7150: 74 20 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 t = pCache->nMax
7160: 2a 39 2f 31 30 3b 0a 20 20 20 20 70 63 61 63 68 *9/10;. pcach
7170: 65 31 45 6e 66 6f 72 63 65 4d 61 78 50 61 67 65 e1EnforceMaxPage
7180: 28 70 43 61 63 68 65 29 3b 0a 20 20 20 20 70 63 (pCache);. pc
7190: 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 ache1LeaveMutex(
71a0: 70 47 72 6f 75 70 29 3b 0a 20 20 7d 0a 7d 0a 0a pGroup);. }.}..
71b0: 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 /*.** Implementa
71c0: 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 tion of the sqli
71d0: 74 65 33 5f 70 63 61 63 68 65 2e 78 53 68 72 69 te3_pcache.xShri
71e0: 6e 6b 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a nk method. .**.*
71f0: 2a 20 46 72 65 65 20 75 70 20 61 73 20 6d 75 63 * Free up as muc
7200: 68 20 6d 65 6d 6f 72 79 20 61 73 20 70 6f 73 73 h memory as poss
7210: 69 62 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 ible..*/.static
7220: 76 6f 69 64 20 70 63 61 63 68 65 31 53 68 72 69 void pcache1Shri
7230: 6e 6b 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 nk(sqlite3_pcach
7240: 65 20 2a 70 29 7b 0a 20 20 50 43 61 63 68 65 31 e *p){. PCache1
7250: 20 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61 63 *pCache = (PCac
7260: 68 65 31 2a 29 70 3b 0a 20 20 69 66 28 20 70 43 he1*)p;. if( pC
7270: 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 ache->bPurgeable
7280: 20 29 7b 0a 20 20 20 20 50 47 72 6f 75 70 20 2a ){. PGroup *
7290: 70 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65 2d pGroup = pCache-
72a0: 3e 70 47 72 6f 75 70 3b 0a 20 20 20 20 69 6e 74 >pGroup;. int
72b0: 20 73 61 76 65 64 4d 61 78 50 61 67 65 3b 0a 20 savedMaxPage;.
72c0: 20 20 20 70 63 61 63 68 65 31 45 6e 74 65 72 4d pcache1EnterM
72d0: 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20 20 utex(pGroup);.
72e0: 20 20 73 61 76 65 64 4d 61 78 50 61 67 65 20 3d savedMaxPage =
72f0: 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 pGroup->nMaxPag
7300: 65 3b 0a 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e e;. pGroup->n
7310: 4d 61 78 50 61 67 65 20 3d 20 30 3b 0a 20 20 20 MaxPage = 0;.
7320: 20 70 63 61 63 68 65 31 45 6e 66 6f 72 63 65 4d pcache1EnforceM
7330: 61 78 50 61 67 65 28 70 43 61 63 68 65 29 3b 0a axPage(pCache);.
7340: 20 20 20 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 pGroup->nMax
7350: 50 61 67 65 20 3d 20 73 61 76 65 64 4d 61 78 50 Page = savedMaxP
7360: 61 67 65 3b 0a 20 20 20 20 70 63 61 63 68 65 31 age;. pcache1
7370: 4c 65 61 76 65 4d 75 74 65 78 28 70 47 72 6f 75 LeaveMutex(pGrou
7380: 70 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a p);. }.}../*.**
7390: 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 Implementation
73a0: 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 of the sqlite3_p
73b0: 63 61 63 68 65 2e 78 50 61 67 65 63 6f 75 6e 74 cache.xPagecount
73c0: 20 6d 65 74 68 6f 64 2e 20 0a 2a 2f 0a 73 74 61 method. .*/.sta
73d0: 74 69 63 20 69 6e 74 20 70 63 61 63 68 65 31 50 tic int pcache1P
73e0: 61 67 65 63 6f 75 6e 74 28 73 71 6c 69 74 65 33 agecount(sqlite3
73f0: 5f 70 63 61 63 68 65 20 2a 70 29 7b 0a 20 20 69 _pcache *p){. i
7400: 6e 74 20 6e 3b 0a 20 20 50 43 61 63 68 65 31 20 nt n;. PCache1
7410: 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 *pCache = (PCach
7420: 65 31 2a 29 70 3b 0a 20 20 70 63 61 63 68 65 31 e1*)p;. pcache1
7430: 45 6e 74 65 72 4d 75 74 65 78 28 70 43 61 63 68 EnterMutex(pCach
7440: 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 20 6e 20 e->pGroup);. n
7450: 3d 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 3b = pCache->nPage;
7460: 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 4d . pcache1LeaveM
7470: 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47 72 utex(pCache->pGr
7480: 6f 75 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 6e oup);. return n
7490: 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c ;.}.../*.** Impl
74a0: 65 6d 65 6e 74 20 73 74 65 70 73 20 33 2c 20 34 ement steps 3, 4
74b0: 2c 20 61 6e 64 20 35 20 6f 66 20 74 68 65 20 70 , and 5 of the p
74c0: 63 61 63 68 65 31 46 65 74 63 68 28 29 20 61 6c cache1Fetch() al
74d0: 67 6f 72 69 74 68 6d 20 64 65 73 63 72 69 62 65 gorithm describe
74e0: 64 0a 2a 2a 20 69 6e 20 74 68 65 20 68 65 61 64 d.** in the head
74f0: 65 72 20 6f 66 20 74 68 65 20 70 63 61 63 68 65 er of the pcache
7500: 31 46 65 74 63 68 28 29 20 70 72 6f 63 65 64 75 1Fetch() procedu
7510: 72 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 73 re..**.** This s
7520: 74 65 70 73 20 61 72 65 20 62 72 6f 6b 65 6e 20 teps are broken
7530: 6f 75 74 20 69 6e 74 6f 20 61 20 73 65 70 61 72 out into a separ
7540: 61 74 65 20 70 72 6f 63 65 64 75 72 65 20 62 65 ate procedure be
7550: 63 61 75 73 65 20 74 68 65 79 20 61 72 65 0a 2a cause they are.*
7560: 2a 20 75 73 75 61 6c 6c 79 20 6e 6f 74 20 6e 65 * usually not ne
7570: 65 64 65 64 2c 20 61 6e 64 20 62 79 20 61 76 6f eded, and by avo
7580: 69 64 69 6e 67 20 74 68 65 20 73 74 61 63 6b 20 iding the stack
7590: 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 72 initialization r
75a0: 65 71 75 69 72 65 64 0a 2a 2a 20 66 6f 72 20 74 equired.** for t
75b0: 68 65 73 65 20 73 74 65 70 73 2c 20 74 68 65 20 hese steps, the
75c0: 6d 61 69 6e 20 70 63 61 63 68 65 31 46 65 74 63 main pcache1Fetc
75d0: 68 28 29 20 70 72 6f 63 65 64 75 72 65 20 63 61 h() procedure ca
75e0: 6e 20 72 75 6e 20 66 61 73 74 65 72 2e 0a 2a 2f n run faster..*/
75f0: 0a 73 74 61 74 69 63 20 53 51 4c 49 54 45 5f 4e .static SQLITE_N
7600: 4f 49 4e 4c 49 4e 45 20 50 67 48 64 72 31 20 2a OINLINE PgHdr1 *
7610: 70 63 61 63 68 65 31 46 65 74 63 68 53 74 61 67 pcache1FetchStag
7620: 65 32 28 0a 20 20 50 43 61 63 68 65 31 20 2a 70 e2(. PCache1 *p
7630: 43 61 63 68 65 2c 20 0a 20 20 75 6e 73 69 67 6e Cache, . unsign
7640: 65 64 20 69 6e 74 20 69 4b 65 79 2c 20 0a 20 20 ed int iKey, .
7650: 69 6e 74 20 63 72 65 61 74 65 46 6c 61 67 0a 29 int createFlag.)
7660: 7b 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 {. unsigned int
7670: 20 6e 50 69 6e 6e 65 64 3b 0a 20 20 50 47 72 6f nPinned;. PGro
7680: 75 70 20 2a 70 47 72 6f 75 70 20 3d 20 70 43 61 up *pGroup = pCa
7690: 63 68 65 2d 3e 70 47 72 6f 75 70 3b 0a 20 20 50 che->pGroup;. P
76a0: 67 48 64 72 31 20 2a 70 50 61 67 65 20 3d 20 30 gHdr1 *pPage = 0
76b0: 3b 0a 0a 20 20 2f 2a 20 53 74 65 70 20 33 3a 20 ;.. /* Step 3:
76c0: 41 62 6f 72 74 20 69 66 20 63 72 65 61 74 65 46 Abort if createF
76d0: 6c 61 67 20 69 73 20 31 20 62 75 74 20 74 68 65 lag is 1 but the
76e0: 20 63 61 63 68 65 20 69 73 20 6e 65 61 72 6c 79 cache is nearly
76f0: 20 66 75 6c 6c 20 2a 2f 0a 20 20 61 73 73 65 72 full */. asser
7700: 74 28 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 t( pCache->nPage
7710: 20 3e 3d 20 70 43 61 63 68 65 2d 3e 6e 52 65 63 >= pCache->nRec
7720: 79 63 6c 61 62 6c 65 20 29 3b 0a 20 20 6e 50 69 yclable );. nPi
7730: 6e 6e 65 64 20 3d 20 70 43 61 63 68 65 2d 3e 6e nned = pCache->n
7740: 50 61 67 65 20 2d 20 70 43 61 63 68 65 2d 3e 6e Page - pCache->n
7750: 52 65 63 79 63 6c 61 62 6c 65 3b 0a 20 20 61 73 Recyclable;. as
7760: 73 65 72 74 28 20 70 47 72 6f 75 70 2d 3e 6d 78 sert( pGroup->mx
7770: 50 69 6e 6e 65 64 20 3d 3d 20 70 47 72 6f 75 70 Pinned == pGroup
7780: 2d 3e 6e 4d 61 78 50 61 67 65 20 2b 20 31 30 20 ->nMaxPage + 10
7790: 2d 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 61 - pGroup->nMinPa
77a0: 67 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 ge );. assert(
77b0: 70 43 61 63 68 65 2d 3e 6e 39 30 70 63 74 20 3d pCache->n90pct =
77c0: 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 2a 39 = pCache->nMax*9
77d0: 2f 31 30 20 29 3b 0a 20 20 69 66 28 20 63 72 65 /10 );. if( cre
77e0: 61 74 65 46 6c 61 67 3d 3d 31 20 26 26 20 28 0a ateFlag==1 && (.
77f0: 20 20 20 20 20 20 20 20 6e 50 69 6e 6e 65 64 3e nPinned>
7800: 3d 70 47 72 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 =pGroup->mxPinne
7810: 64 0a 20 20 20 20 20 7c 7c 20 6e 50 69 6e 6e 65 d. || nPinne
7820: 64 3e 3d 70 43 61 63 68 65 2d 3e 6e 39 30 70 63 d>=pCache->n90pc
7830: 74 0a 20 20 20 20 20 7c 7c 20 28 70 63 61 63 68 t. || (pcach
7840: 65 31 55 6e 64 65 72 4d 65 6d 6f 72 79 50 72 65 e1UnderMemoryPre
7850: 73 73 75 72 65 28 70 43 61 63 68 65 29 20 26 26 ssure(pCache) &&
7860: 20 70 43 61 63 68 65 2d 3e 6e 52 65 63 79 63 6c pCache->nRecycl
7870: 61 62 6c 65 3c 6e 50 69 6e 6e 65 64 29 0a 20 20 able<nPinned).
7880: 29 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 )){. return 0
7890: 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 43 61 ;. }.. if( pCa
78a0: 63 68 65 2d 3e 6e 50 61 67 65 3e 3d 70 43 61 63 che->nPage>=pCac
78b0: 68 65 2d 3e 6e 48 61 73 68 20 29 20 70 63 61 63 he->nHash ) pcac
78c0: 68 65 31 52 65 73 69 7a 65 48 61 73 68 28 70 43 he1ResizeHash(pC
78d0: 61 63 68 65 29 3b 0a 20 20 61 73 73 65 72 74 28 ache);. assert(
78e0: 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 3e 30 pCache->nHash>0
78f0: 20 26 26 20 70 43 61 63 68 65 2d 3e 61 70 48 61 && pCache->apHa
7900: 73 68 20 29 3b 0a 0a 20 20 2f 2a 20 53 74 65 70 sh );.. /* Step
7910: 20 34 2e 20 54 72 79 20 74 6f 20 72 65 63 79 63 4. Try to recyc
7920: 6c 65 20 61 20 70 61 67 65 2e 20 2a 2f 0a 20 20 le a page. */.
7930: 69 66 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72 if( pCache->bPur
7940: 67 65 61 62 6c 65 0a 20 20 20 26 26 20 21 70 47 geable. && !pG
7950: 72 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72 75 50 72 roup->lru.pLruPr
7960: 65 76 2d 3e 69 73 41 6e 63 68 6f 72 0a 20 20 20 ev->isAnchor.
7970: 26 26 20 28 28 70 43 61 63 68 65 2d 3e 6e 50 61 && ((pCache->nPa
7980: 67 65 2b 31 3e 3d 70 43 61 63 68 65 2d 3e 6e 4d ge+1>=pCache->nM
7990: 61 78 29 20 7c 7c 20 70 63 61 63 68 65 31 55 6e ax) || pcache1Un
79a0: 64 65 72 4d 65 6d 6f 72 79 50 72 65 73 73 75 72 derMemoryPressur
79b0: 65 28 70 43 61 63 68 65 29 29 0a 20 20 29 7b 0a e(pCache)). ){.
79c0: 20 20 20 20 50 43 61 63 68 65 31 20 2a 70 4f 74 PCache1 *pOt
79d0: 68 65 72 3b 0a 20 20 20 20 70 50 61 67 65 20 3d her;. pPage =
79e0: 20 70 47 72 6f 75 70 2d 3e 6c 72 75 2e 70 4c 72 pGroup->lru.pLr
79f0: 75 50 72 65 76 3b 0a 20 20 20 20 61 73 73 65 72 uPrev;. asser
7a00: 74 28 20 50 41 47 45 5f 49 53 5f 55 4e 50 49 4e t( PAGE_IS_UNPIN
7a10: 4e 45 44 28 70 50 61 67 65 29 20 29 3b 0a 20 20 NED(pPage) );.
7a20: 20 20 70 63 61 63 68 65 31 52 65 6d 6f 76 65 46 pcache1RemoveF
7a30: 72 6f 6d 48 61 73 68 28 70 50 61 67 65 2c 20 30 romHash(pPage, 0
7a40: 29 3b 0a 20 20 20 20 70 63 61 63 68 65 31 50 69 );. pcache1Pi
7a50: 6e 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 20 nPage(pPage);.
7a60: 20 20 70 4f 74 68 65 72 20 3d 20 70 50 61 67 65 pOther = pPage
7a70: 2d 3e 70 43 61 63 68 65 3b 0a 20 20 20 20 69 66 ->pCache;. if
7a80: 28 20 70 4f 74 68 65 72 2d 3e 73 7a 41 6c 6c 6f ( pOther->szAllo
7a90: 63 20 21 3d 20 70 43 61 63 68 65 2d 3e 73 7a 41 c != pCache->szA
7aa0: 6c 6c 6f 63 20 29 7b 0a 20 20 20 20 20 20 70 63 lloc ){. pc
7ab0: 61 63 68 65 31 46 72 65 65 50 61 67 65 28 70 50 ache1FreePage(pP
7ac0: 61 67 65 29 3b 0a 20 20 20 20 20 20 70 50 61 67 age);. pPag
7ad0: 65 20 3d 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65 e = 0;. }else
7ae0: 7b 0a 20 20 20 20 20 20 70 47 72 6f 75 70 2d 3e {. pGroup->
7af0: 6e 50 75 72 67 65 61 62 6c 65 20 2d 3d 20 28 70 nPurgeable -= (p
7b00: 4f 74 68 65 72 2d 3e 62 50 75 72 67 65 61 62 6c Other->bPurgeabl
7b10: 65 20 2d 20 70 43 61 63 68 65 2d 3e 62 50 75 72 e - pCache->bPur
7b20: 67 65 61 62 6c 65 29 3b 0a 20 20 20 20 7d 0a 20 geable);. }.
7b30: 20 7d 0a 0a 20 20 2f 2a 20 53 74 65 70 20 35 2e }.. /* Step 5.
7b40: 20 49 66 20 61 20 75 73 61 62 6c 65 20 70 61 67 If a usable pag
7b50: 65 20 62 75 66 66 65 72 20 68 61 73 20 73 74 69 e buffer has sti
7b60: 6c 6c 20 6e 6f 74 20 62 65 65 6e 20 66 6f 75 6e ll not been foun
7b70: 64 2c 20 0a 20 20 2a 2a 20 61 74 74 65 6d 70 74 d, . ** attempt
7b80: 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e to allocate a n
7b90: 65 77 20 6f 6e 65 2e 20 0a 20 20 2a 2f 0a 20 20 ew one. . */.
7ba0: 69 66 28 20 21 70 50 61 67 65 20 29 7b 0a 20 20 if( !pPage ){.
7bb0: 20 20 70 50 61 67 65 20 3d 20 70 63 61 63 68 65 pPage = pcache
7bc0: 31 41 6c 6c 6f 63 50 61 67 65 28 70 43 61 63 68 1AllocPage(pCach
7bd0: 65 2c 20 63 72 65 61 74 65 46 6c 61 67 3d 3d 31 e, createFlag==1
7be0: 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 50 );. }.. if( pP
7bf0: 61 67 65 20 29 7b 0a 20 20 20 20 75 6e 73 69 67 age ){. unsig
7c00: 6e 65 64 20 69 6e 74 20 68 20 3d 20 69 4b 65 79 ned int h = iKey
7c10: 20 25 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68 % pCache->nHash
7c20: 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 50 ;. pCache->nP
7c30: 61 67 65 2b 2b 3b 0a 20 20 20 20 70 50 61 67 65 age++;. pPage
7c40: 2d 3e 69 4b 65 79 20 3d 20 69 4b 65 79 3b 0a 20 ->iKey = iKey;.
7c50: 20 20 20 70 50 61 67 65 2d 3e 70 4e 65 78 74 20 pPage->pNext
7c60: 3d 20 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 = pCache->apHash
7c70: 5b 68 5d 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e [h];. pPage->
7c80: 70 43 61 63 68 65 20 3d 20 70 43 61 63 68 65 3b pCache = pCache;
7c90: 0a 20 20 20 20 70 50 61 67 65 2d 3e 70 4c 72 75 . pPage->pLru
7ca0: 4e 65 78 74 20 3d 20 30 3b 0a 20 20 20 20 2f 2a Next = 0;. /*
7cb0: 20 70 50 61 67 65 2d 3e 70 4c 72 75 50 72 65 76 pPage->pLruPrev
7cc0: 20 3d 20 30 3b 0a 20 20 20 20 2a 2a 20 4e 6f 20 = 0;. ** No
7cd0: 6e 65 65 64 20 74 6f 20 63 6c 65 61 72 20 70 4c need to clear pL
7ce0: 72 75 50 72 65 76 20 73 69 6e 63 65 20 69 74 20 ruPrev since it
7cf0: 69 73 20 6e 6f 74 20 61 63 63 65 73 73 65 64 20 is not accessed
7d00: 77 68 65 6e 20 70 4c 72 75 4e 65 78 74 3d 3d 30 when pLruNext==0
7d10: 20 2a 2f 0a 20 20 20 20 2a 28 76 6f 69 64 20 2a */. *(void *
7d20: 2a 29 70 50 61 67 65 2d 3e 70 61 67 65 2e 70 45 *)pPage->page.pE
7d30: 78 74 72 61 20 3d 20 30 3b 0a 20 20 20 20 70 43 xtra = 0;. pC
7d40: 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 20 ache->apHash[h]
7d50: 3d 20 70 50 61 67 65 3b 0a 20 20 20 20 69 66 28 = pPage;. if(
7d60: 20 69 4b 65 79 3e 70 43 61 63 68 65 2d 3e 69 4d iKey>pCache->iM
7d70: 61 78 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 70 axKey ){. p
7d80: 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 3d Cache->iMaxKey =
7d90: 20 69 4b 65 79 3b 0a 20 20 20 20 7d 0a 20 20 7d iKey;. }. }
7da0: 0a 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 3b . return pPage;
7db0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d .}../*.** Implem
7dc0: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 entation of the
7dd0: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78 sqlite3_pcache.x
7de0: 46 65 74 63 68 20 6d 65 74 68 6f 64 2e 20 0a 2a Fetch method. .*
7df0: 2a 0a 2a 2a 20 46 65 74 63 68 20 61 20 70 61 67 *.** Fetch a pag
7e00: 65 20 62 79 20 6b 65 79 20 76 61 6c 75 65 2e 0a e by key value..
7e10: 2a 2a 0a 2a 2a 20 57 68 65 74 68 65 72 20 6f 72 **.** Whether or
7e20: 20 6e 6f 74 20 61 20 6e 65 77 20 70 61 67 65 20 not a new page
7e30: 6d 61 79 20 62 65 20 61 6c 6c 6f 63 61 74 65 64 may be allocated
7e40: 20 62 79 20 74 68 69 73 20 66 75 6e 63 74 69 6f by this functio
7e50: 6e 20 64 65 70 65 6e 64 73 20 6f 6e 0a 2a 2a 20 n depends on.**
7e60: 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 the value of the
7e70: 20 63 72 65 61 74 65 46 6c 61 67 20 61 72 67 75 createFlag argu
7e80: 6d 65 6e 74 2e 20 20 30 20 6d 65 61 6e 73 20 64 ment. 0 means d
7e90: 6f 20 6e 6f 74 20 61 6c 6c 6f 63 61 74 65 20 61 o not allocate a
7ea0: 20 6e 65 77 0a 2a 2a 20 70 61 67 65 2e 20 20 31 new.** page. 1
7eb0: 20 6d 65 61 6e 73 20 61 6c 6c 6f 63 61 74 65 20 means allocate
7ec0: 61 20 6e 65 77 20 70 61 67 65 20 69 66 20 73 70 a new page if sp
7ed0: 61 63 65 20 69 73 20 65 61 73 69 6c 79 20 61 76 ace is easily av
7ee0: 61 69 6c 61 62 6c 65 2e 20 20 32 20 0a 2a 2a 20 ailable. 2 .**
7ef0: 6d 65 61 6e 73 20 74 6f 20 74 72 79 20 72 65 61 means to try rea
7f00: 6c 6c 79 20 68 61 72 64 20 74 6f 20 61 6c 6c 6f lly hard to allo
7f10: 63 61 74 65 20 61 20 6e 65 77 20 70 61 67 65 2e cate a new page.
7f20: 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 61 20 6e 6f 6e .**.** For a non
7f30: 2d 70 75 72 67 65 61 62 6c 65 20 63 61 63 68 65 -purgeable cache
7f40: 20 28 61 20 63 61 63 68 65 20 75 73 65 64 20 61 (a cache used a
7f50: 73 20 74 68 65 20 73 74 6f 72 61 67 65 20 66 6f s the storage fo
7f60: 72 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 0a 2a r an in-memory.*
7f70: 2a 20 64 61 74 61 62 61 73 65 29 20 74 68 65 72 * database) ther
7f80: 65 20 69 73 20 72 65 61 6c 6c 79 20 6e 6f 20 64 e is really no d
7f90: 69 66 66 65 72 65 6e 63 65 20 62 65 74 77 65 65 ifference betwee
7fa0: 6e 20 63 72 65 61 74 65 46 6c 61 67 20 31 20 61 n createFlag 1 a
7fb0: 6e 64 20 32 2e 20 20 53 6f 0a 2a 2a 20 74 68 65 nd 2. So.** the
7fc0: 20 63 61 6c 6c 69 6e 67 20 66 75 6e 63 74 69 6f calling functio
7fd0: 6e 20 28 70 63 61 63 68 65 2e 63 29 20 77 69 6c n (pcache.c) wil
7fe0: 6c 20 6e 65 76 65 72 20 68 61 76 65 20 61 20 63 l never have a c
7ff0: 72 65 61 74 65 46 6c 61 67 20 6f 66 20 31 20 6f reateFlag of 1 o
8000: 6e 0a 2a 2a 20 61 20 6e 6f 6e 2d 70 75 72 67 65 n.** a non-purge
8010: 61 62 6c 65 20 63 61 63 68 65 2e 0a 2a 2a 0a 2a able cache..**.*
8020: 2a 20 54 68 65 72 65 20 61 72 65 20 74 68 72 65 * There are thre
8030: 65 20 64 69 66 66 65 72 65 6e 74 20 61 70 70 72 e different appr
8040: 6f 61 63 68 65 73 20 74 6f 20 6f 62 74 61 69 6e oaches to obtain
8050: 69 6e 67 20 73 70 61 63 65 20 66 6f 72 20 61 20 ing space for a
8060: 70 61 67 65 2c 0a 2a 2a 20 64 65 70 65 6e 64 69 page,.** dependi
8070: 6e 67 20 6f 6e 20 74 68 65 20 76 61 6c 75 65 20 ng on the value
8080: 6f 66 20 70 61 72 61 6d 65 74 65 72 20 63 72 65 of parameter cre
8090: 61 74 65 46 6c 61 67 20 28 77 68 69 63 68 20 6d ateFlag (which m
80a0: 61 79 20 62 65 20 30 2c 20 31 20 6f 72 20 32 29 ay be 0, 1 or 2)
80b0: 2e 0a 2a 2a 0a 2a 2a 20 20 20 31 2e 20 52 65 67 ..**.** 1. Reg
80c0: 61 72 64 6c 65 73 73 20 6f 66 20 74 68 65 20 76 ardless of the v
80d0: 61 6c 75 65 20 6f 66 20 63 72 65 61 74 65 46 6c alue of createFl
80e0: 61 67 2c 20 74 68 65 20 63 61 63 68 65 20 69 73 ag, the cache is
80f0: 20 73 65 61 72 63 68 65 64 20 66 6f 72 20 61 20 searched for a
8100: 0a 2a 2a 20 20 20 20 20 20 63 6f 70 79 20 6f 66 .** copy of
8110: 20 74 68 65 20 72 65 71 75 65 73 74 65 64 20 70 the requested p
8120: 61 67 65 2e 20 49 66 20 6f 6e 65 20 69 73 20 66 age. If one is f
8130: 6f 75 6e 64 2c 20 69 74 20 69 73 20 72 65 74 75 ound, it is retu
8140: 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 20 20 32 2e rned..**.** 2.
8150: 20 49 66 20 63 72 65 61 74 65 46 6c 61 67 3d 3d If createFlag==
8160: 30 20 61 6e 64 20 74 68 65 20 70 61 67 65 20 69 0 and the page i
8170: 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 69 6e s not already in
8180: 20 74 68 65 20 63 61 63 68 65 2c 20 4e 55 4c 4c the cache, NULL
8190: 20 69 73 0a 2a 2a 20 20 20 20 20 20 72 65 74 75 is.** retu
81a0: 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 20 20 33 2e rned..**.** 3.
81b0: 20 49 66 20 63 72 65 61 74 65 46 6c 61 67 20 69 If createFlag i
81c0: 73 20 31 2c 20 61 6e 64 20 74 68 65 20 70 61 67 s 1, and the pag
81d0: 65 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 e is not already
81e0: 20 69 6e 20 74 68 65 20 63 61 63 68 65 2c 20 74 in the cache, t
81f0: 68 65 6e 0a 2a 2a 20 20 20 20 20 20 72 65 74 75 hen.** retu
8200: 72 6e 20 4e 55 4c 4c 20 28 64 6f 20 6e 6f 74 20 rn NULL (do not
8210: 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 70 allocate a new p
8220: 61 67 65 29 20 69 66 20 61 6e 79 20 6f 66 20 74 age) if any of t
8230: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 2a 2a 20 he following.**
8240: 20 20 20 20 20 63 6f 6e 64 69 74 69 6f 6e 73 20 conditions
8250: 61 72 65 20 74 72 75 65 3a 0a 2a 2a 0a 2a 2a 20 are true:.**.**
8260: 20 20 20 20 20 20 28 61 29 20 74 68 65 20 6e 75 (a) the nu
8270: 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 70 69 mber of pages pi
8280: 6e 6e 65 64 20 62 79 20 74 68 65 20 63 61 63 68 nned by the cach
8290: 65 20 69 73 20 67 72 65 61 74 65 72 20 74 68 61 e is greater tha
82a0: 6e 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 50 n.** P
82b0: 43 61 63 68 65 31 2e 6e 4d 61 78 2c 20 6f 72 0a Cache1.nMax, or.
82c0: 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 28 62 29 20 **.** (b)
82d0: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 the number of pa
82e0: 67 65 73 20 70 69 6e 6e 65 64 20 62 79 20 74 68 ges pinned by th
82f0: 65 20 63 61 63 68 65 20 69 73 20 67 72 65 61 74 e cache is great
8300: 65 72 20 74 68 61 6e 0a 2a 2a 20 20 20 20 20 20 er than.**
8310: 20 20 20 20 20 74 68 65 20 73 75 6d 20 6f 66 20 the sum of
8320: 6e 4d 61 78 20 66 6f 72 20 61 6c 6c 20 70 75 72 nMax for all pur
8330: 67 65 61 62 6c 65 20 63 61 63 68 65 73 2c 20 6c geable caches, l
8340: 65 73 73 20 74 68 65 20 73 75 6d 20 6f 66 20 0a ess the sum of .
8350: 2a 2a 20 20 20 20 20 20 20 20 20 20 20 6e 4d 69 ** nMi
8360: 6e 20 66 6f 72 20 61 6c 6c 20 6f 74 68 65 72 20 n for all other
8370: 70 75 72 67 65 61 62 6c 65 20 63 61 63 68 65 73 purgeable caches
8380: 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 20 20 34 2e 20 , or.**.** 4.
8390: 49 66 20 6e 6f 6e 65 20 6f 66 20 74 68 65 20 66 If none of the f
83a0: 69 72 73 74 20 74 68 72 65 65 20 63 6f 6e 64 69 irst three condi
83b0: 74 69 6f 6e 73 20 61 70 70 6c 79 20 61 6e 64 20 tions apply and
83c0: 74 68 65 20 63 61 63 68 65 20 69 73 20 6d 61 72 the cache is mar
83d0: 6b 65 64 0a 2a 2a 20 20 20 20 20 20 61 73 20 70 ked.** as p
83e0: 75 72 67 65 61 62 6c 65 2c 20 61 6e 64 20 69 66 urgeable, and if
83f0: 20 6f 6e 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c one of the foll
8400: 6f 77 69 6e 67 20 69 73 20 74 72 75 65 3a 0a 2a owing is true:.*
8410: 2a 0a 2a 2a 20 20 20 20 20 20 20 28 61 29 20 54 *.** (a) T
8420: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 he number of pag
8430: 65 73 20 61 6c 6c 6f 63 61 74 65 64 20 66 6f 72 es allocated for
8440: 20 74 68 65 20 63 61 63 68 65 20 69 73 20 61 6c the cache is al
8450: 72 65 61 64 79 20 0a 2a 2a 20 20 20 20 20 20 20 ready .**
8460: 20 20 20 20 50 43 61 63 68 65 31 2e 6e 4d 61 78 PCache1.nMax
8470: 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 , or.**.**
8480: 20 28 62 29 20 54 68 65 20 6e 75 6d 62 65 72 20 (b) The number
8490: 6f 66 20 70 61 67 65 73 20 61 6c 6c 6f 63 61 74 of pages allocat
84a0: 65 64 20 66 6f 72 20 61 6c 6c 20 70 75 72 67 65 ed for all purge
84b0: 61 62 6c 65 20 63 61 63 68 65 73 20 69 73 0a 2a able caches is.*
84c0: 2a 20 20 20 20 20 20 20 20 20 20 20 61 6c 72 65 * alre
84d0: 61 64 79 20 65 71 75 61 6c 20 74 6f 20 6f 72 20 ady equal to or
84e0: 67 72 65 61 74 65 72 20 74 68 61 6e 20 74 68 65 greater than the
84f0: 20 73 75 6d 20 6f 66 20 6e 4d 61 78 20 66 6f 72 sum of nMax for
8500: 20 61 6c 6c 0a 2a 2a 20 20 20 20 20 20 20 20 20 all.**
8510: 20 20 70 75 72 67 65 61 62 6c 65 20 63 61 63 68 purgeable cach
8520: 65 73 2c 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 es,.**.**
8530: 28 63 29 20 54 68 65 20 73 79 73 74 65 6d 20 69 (c) The system i
8540: 73 20 75 6e 64 65 72 20 6d 65 6d 6f 72 79 20 70 s under memory p
8550: 72 65 73 73 75 72 65 20 61 6e 64 20 77 61 6e 74 ressure and want
8560: 73 20 74 6f 20 61 76 6f 69 64 0a 2a 2a 20 20 20 s to avoid.**
8570: 20 20 20 20 20 20 20 20 75 6e 6e 65 63 65 73 73 unnecess
8580: 61 72 79 20 70 61 67 65 73 20 63 61 63 68 65 20 ary pages cache
8590: 65 6e 74 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e entry allocation
85a0: 73 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 74 68 65 s.**.** the
85b0: 6e 20 61 74 74 65 6d 70 74 20 74 6f 20 72 65 63 n attempt to rec
85c0: 79 63 6c 65 20 61 20 70 61 67 65 20 66 72 6f 6d ycle a page from
85d0: 20 74 68 65 20 4c 52 55 20 6c 69 73 74 2e 20 49 the LRU list. I
85e0: 66 20 69 74 20 69 73 20 74 68 65 20 72 69 67 68 f it is the righ
85f0: 74 0a 2a 2a 20 20 20 20 20 20 73 69 7a 65 2c 20 t.** size,
8600: 72 65 74 75 72 6e 20 74 68 65 20 72 65 63 79 63 return the recyc
8610: 6c 65 64 20 62 75 66 66 65 72 2e 20 4f 74 68 65 led buffer. Othe
8620: 72 77 69 73 65 2c 20 66 72 65 65 20 74 68 65 20 rwise, free the
8630: 62 75 66 66 65 72 20 61 6e 64 0a 2a 2a 20 20 20 buffer and.**
8640: 20 20 20 70 72 6f 63 65 65 64 20 74 6f 20 73 74 proceed to st
8650: 65 70 20 35 2e 20 0a 2a 2a 0a 2a 2a 20 20 20 35 ep 5. .**.** 5
8660: 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 61 6c 6c . Otherwise, all
8670: 6f 63 61 74 65 20 61 6e 64 20 72 65 74 75 72 6e ocate and return
8680: 20 61 20 6e 65 77 20 70 61 67 65 20 62 75 66 66 a new page buff
8690: 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 72 65 20 er..**.** There
86a0: 61 72 65 20 74 77 6f 20 76 65 72 73 69 6f 6e 73 are two versions
86b0: 20 6f 66 20 74 68 69 73 20 72 6f 75 74 69 6e 65 of this routine
86c0: 2e 20 20 70 63 61 63 68 65 31 46 65 74 63 68 57 . pcache1FetchW
86d0: 69 74 68 4d 75 74 65 78 28 29 20 69 73 0a 2a 2a ithMutex() is.**
86e0: 20 74 68 65 20 67 65 6e 65 72 61 6c 20 63 61 73 the general cas
86f0: 65 2e 20 20 70 63 61 63 68 65 31 46 65 74 63 68 e. pcache1Fetch
8700: 4e 6f 4d 75 74 65 78 28 29 20 69 73 20 61 20 66 NoMutex() is a f
8710: 61 73 74 65 72 20 69 6d 70 6c 65 6d 65 6e 74 61 aster implementa
8720: 74 69 6f 6e 20 66 6f 72 0a 2a 2a 20 74 68 65 20 tion for.** the
8730: 63 6f 6d 6d 6f 6e 20 63 61 73 65 20 77 68 65 72 common case wher
8740: 65 20 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 20 e pGroup->mutex
8750: 69 73 20 4e 55 4c 4c 2e 20 20 54 68 65 20 70 63 is NULL. The pc
8760: 61 63 68 65 31 46 65 74 63 68 28 29 20 77 72 61 ache1Fetch() wra
8770: 70 70 65 72 0a 2a 2a 20 69 6e 76 6f 6b 65 73 20 pper.** invokes
8780: 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 20 the appropriate
8790: 72 6f 75 74 69 6e 65 2e 0a 2a 2f 0a 73 74 61 74 routine..*/.stat
87a0: 69 63 20 50 67 48 64 72 31 20 2a 70 63 61 63 68 ic PgHdr1 *pcach
87b0: 65 31 46 65 74 63 68 4e 6f 4d 75 74 65 78 28 0a e1FetchNoMutex(.
87c0: 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 sqlite3_pcache
87d0: 20 2a 70 2c 20 0a 20 20 75 6e 73 69 67 6e 65 64 *p, . unsigned
87e0: 20 69 6e 74 20 69 4b 65 79 2c 20 0a 20 20 69 6e int iKey, . in
87f0: 74 20 63 72 65 61 74 65 46 6c 61 67 0a 29 7b 0a t createFlag.){.
8800: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 PCache1 *pCach
8810: 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 e = (PCache1 *)p
8820: 3b 0a 20 20 50 67 48 64 72 31 20 2a 70 50 61 67 ;. PgHdr1 *pPag
8830: 65 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20 53 74 65 e = 0;.. /* Ste
8840: 70 20 31 3a 20 53 65 61 72 63 68 20 74 68 65 20 p 1: Search the
8850: 68 61 73 68 20 74 61 62 6c 65 20 66 6f 72 20 61 hash table for a
8860: 6e 20 65 78 69 73 74 69 6e 67 20 65 6e 74 72 79 n existing entry
8870: 2e 20 2a 2f 0a 20 20 70 50 61 67 65 20 3d 20 70 . */. pPage = p
8880: 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 69 4b Cache->apHash[iK
8890: 65 79 20 25 20 70 43 61 63 68 65 2d 3e 6e 48 61 ey % pCache->nHa
88a0: 73 68 5d 3b 0a 20 20 77 68 69 6c 65 28 20 70 50 sh];. while( pP
88b0: 61 67 65 20 26 26 20 70 50 61 67 65 2d 3e 69 4b age && pPage->iK
88c0: 65 79 21 3d 69 4b 65 79 20 29 7b 20 70 50 61 67 ey!=iKey ){ pPag
88d0: 65 20 3d 20 70 50 61 67 65 2d 3e 70 4e 65 78 74 e = pPage->pNext
88e0: 3b 20 7d 0a 0a 20 20 2f 2a 20 53 74 65 70 20 32 ; }.. /* Step 2
88f0: 3a 20 49 66 20 74 68 65 20 70 61 67 65 20 77 61 : If the page wa
8900: 73 20 66 6f 75 6e 64 20 69 6e 20 74 68 65 20 68 s found in the h
8910: 61 73 68 20 74 61 62 6c 65 2c 20 74 68 65 6e 20 ash table, then
8920: 72 65 74 75 72 6e 20 69 74 2e 0a 20 20 2a 2a 20 return it.. **
8930: 49 66 20 74 68 65 20 70 61 67 65 20 77 61 73 20 If the page was
8940: 6e 6f 74 20 69 6e 20 74 68 65 20 68 61 73 68 20 not in the hash
8950: 74 61 62 6c 65 20 61 6e 64 20 63 72 65 61 74 65 table and create
8960: 46 6c 61 67 20 69 73 20 30 2c 20 61 62 6f 72 74 Flag is 0, abort
8970: 2e 0a 20 20 2a 2a 20 4f 74 68 65 72 77 69 73 65 .. ** Otherwise
8980: 20 28 70 61 67 65 20 6e 6f 74 20 69 6e 20 68 61 (page not in ha
8990: 73 68 20 61 6e 64 20 63 72 65 61 74 65 46 6c 61 sh and createFla
89a0: 67 21 3d 30 29 20 63 6f 6e 74 69 6e 75 65 20 77 g!=0) continue w
89b0: 69 74 68 0a 20 20 2a 2a 20 73 75 62 73 65 71 75 ith. ** subsequ
89c0: 65 6e 74 20 73 74 65 70 73 20 74 6f 20 74 72 79 ent steps to try
89d0: 20 74 6f 20 63 72 65 61 74 65 20 74 68 65 20 70 to create the p
89e0: 61 67 65 2e 20 2a 2f 0a 20 20 69 66 28 20 70 50 age. */. if( pP
89f0: 61 67 65 20 29 7b 0a 20 20 20 20 69 66 28 20 50 age ){. if( P
8a00: 41 47 45 5f 49 53 5f 55 4e 50 49 4e 4e 45 44 28 AGE_IS_UNPINNED(
8a10: 70 50 61 67 65 29 20 29 7b 0a 20 20 20 20 20 20 pPage) ){.
8a20: 72 65 74 75 72 6e 20 70 63 61 63 68 65 31 50 69 return pcache1Pi
8a30: 6e 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 20 nPage(pPage);.
8a40: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 }else{. r
8a50: 65 74 75 72 6e 20 70 50 61 67 65 3b 0a 20 20 20 eturn pPage;.
8a60: 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 63 }. }else if( c
8a70: 72 65 61 74 65 46 6c 61 67 20 29 7b 0a 20 20 20 reateFlag ){.
8a80: 20 2f 2a 20 53 74 65 70 73 20 33 2c 20 34 2c 20 /* Steps 3, 4,
8a90: 61 6e 64 20 35 20 69 6d 70 6c 65 6d 65 6e 74 65 and 5 implemente
8aa0: 64 20 62 79 20 74 68 69 73 20 73 75 62 72 6f 75 d by this subrou
8ab0: 74 69 6e 65 20 2a 2f 0a 20 20 20 20 72 65 74 75 tine */. retu
8ac0: 72 6e 20 70 63 61 63 68 65 31 46 65 74 63 68 53 rn pcache1FetchS
8ad0: 74 61 67 65 32 28 70 43 61 63 68 65 2c 20 69 4b tage2(pCache, iK
8ae0: 65 79 2c 20 63 72 65 61 74 65 46 6c 61 67 29 3b ey, createFlag);
8af0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 . }else{. re
8b00: 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 7d 0a 23 69 turn 0;. }.}.#i
8b10: 66 20 50 43 41 43 48 45 31 5f 4d 49 47 48 54 5f f PCACHE1_MIGHT_
8b20: 55 53 45 5f 47 52 4f 55 50 5f 4d 55 54 45 58 0a USE_GROUP_MUTEX.
8b30: 73 74 61 74 69 63 20 50 67 48 64 72 31 20 2a 70 static PgHdr1 *p
8b40: 63 61 63 68 65 31 46 65 74 63 68 57 69 74 68 4d cache1FetchWithM
8b50: 75 74 65 78 28 0a 20 20 73 71 6c 69 74 65 33 5f utex(. sqlite3_
8b60: 70 63 61 63 68 65 20 2a 70 2c 20 0a 20 20 75 6e pcache *p, . un
8b70: 73 69 67 6e 65 64 20 69 6e 74 20 69 4b 65 79 2c signed int iKey,
8b80: 20 0a 20 20 69 6e 74 20 63 72 65 61 74 65 46 6c . int createFl
8b90: 61 67 0a 29 7b 0a 20 20 50 43 61 63 68 65 31 20 ag.){. PCache1
8ba0: 2a 70 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 *pCache = (PCach
8bb0: 65 31 20 2a 29 70 3b 0a 20 20 50 67 48 64 72 31 e1 *)p;. PgHdr1
8bc0: 20 2a 70 50 61 67 65 3b 0a 0a 20 20 70 63 61 63 *pPage;.. pcac
8bd0: 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 70 43 he1EnterMutex(pC
8be0: 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 20 ache->pGroup);.
8bf0: 20 70 50 61 67 65 20 3d 20 70 63 61 63 68 65 31 pPage = pcache1
8c00: 46 65 74 63 68 4e 6f 4d 75 74 65 78 28 70 2c 20 FetchNoMutex(p,
8c10: 69 4b 65 79 2c 20 63 72 65 61 74 65 46 6c 61 67 iKey, createFlag
8c20: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 );. assert( pPa
8c30: 67 65 3d 3d 30 20 7c 7c 20 70 43 61 63 68 65 2d ge==0 || pCache-
8c40: 3e 69 4d 61 78 4b 65 79 3e 3d 69 4b 65 79 20 29 >iMaxKey>=iKey )
8c50: 3b 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76 65 ;. pcache1Leave
8c60: 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47 Mutex(pCache->pG
8c70: 72 6f 75 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 roup);. return
8c80: 70 50 61 67 65 3b 0a 7d 0a 23 65 6e 64 69 66 0a pPage;.}.#endif.
8c90: 73 74 61 74 69 63 20 73 71 6c 69 74 65 33 5f 70 static sqlite3_p
8ca0: 63 61 63 68 65 5f 70 61 67 65 20 2a 70 63 61 63 cache_page *pcac
8cb0: 68 65 31 46 65 74 63 68 28 0a 20 20 73 71 6c 69 he1Fetch(. sqli
8cc0: 74 65 33 5f 70 63 61 63 68 65 20 2a 70 2c 20 0a te3_pcache *p, .
8cd0: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 unsigned int i
8ce0: 4b 65 79 2c 20 0a 20 20 69 6e 74 20 63 72 65 61 Key, . int crea
8cf0: 74 65 46 6c 61 67 0a 29 7b 0a 23 69 66 20 50 43 teFlag.){.#if PC
8d00: 41 43 48 45 31 5f 4d 49 47 48 54 5f 55 53 45 5f ACHE1_MIGHT_USE_
8d10: 47 52 4f 55 50 5f 4d 55 54 45 58 20 7c 7c 20 64 GROUP_MUTEX || d
8d20: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 efined(SQLITE_DE
8d30: 42 55 47 29 0a 20 20 50 43 61 63 68 65 31 20 2a BUG). PCache1 *
8d40: 70 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 65 pCache = (PCache
8d50: 31 20 2a 29 70 3b 0a 23 65 6e 64 69 66 0a 0a 20 1 *)p;.#endif..
8d60: 20 61 73 73 65 72 74 28 20 6f 66 66 73 65 74 6f assert( offseto
8d70: 66 28 50 67 48 64 72 31 2c 70 61 67 65 29 3d 3d f(PgHdr1,page)==
8d80: 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 0 );. assert( p
8d90: 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c Cache->bPurgeabl
8da0: 65 20 7c 7c 20 63 72 65 61 74 65 46 6c 61 67 21 e || createFlag!
8db0: 3d 31 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =1 );. assert(
8dc0: 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 pCache->bPurgeab
8dd0: 6c 65 20 7c 7c 20 70 43 61 63 68 65 2d 3e 6e 4d le || pCache->nM
8de0: 69 6e 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 in==0 );. asser
8df0: 74 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67 t( pCache->bPurg
8e00: 65 61 62 6c 65 3d 3d 30 20 7c 7c 20 70 43 61 63 eable==0 || pCac
8e10: 68 65 2d 3e 6e 4d 69 6e 3d 3d 31 30 20 29 3b 0a he->nMin==10 );.
8e20: 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65 assert( pCache
8e30: 2d 3e 6e 4d 69 6e 3d 3d 30 20 7c 7c 20 70 43 61 ->nMin==0 || pCa
8e40: 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 che->bPurgeable
8e50: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61 );. assert( pCa
8e60: 63 68 65 2d 3e 6e 48 61 73 68 3e 30 20 29 3b 0a che->nHash>0 );.
8e70: 23 69 66 20 50 43 41 43 48 45 31 5f 4d 49 47 48 #if PCACHE1_MIGH
8e80: 54 5f 55 53 45 5f 47 52 4f 55 50 5f 4d 55 54 45 T_USE_GROUP_MUTE
8e90: 58 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d 3e X. if( pCache->
8ea0: 70 47 72 6f 75 70 2d 3e 6d 75 74 65 78 20 29 7b pGroup->mutex ){
8eb0: 0a 20 20 20 20 72 65 74 75 72 6e 20 28 73 71 6c . return (sql
8ec0: 69 74 65 33 5f 70 63 61 63 68 65 5f 70 61 67 65 ite3_pcache_page
8ed0: 2a 29 70 63 61 63 68 65 31 46 65 74 63 68 57 69 *)pcache1FetchWi
8ee0: 74 68 4d 75 74 65 78 28 70 2c 20 69 4b 65 79 2c thMutex(p, iKey,
8ef0: 20 63 72 65 61 74 65 46 6c 61 67 29 3b 0a 20 20 createFlag);.
8f00: 7d 65 6c 73 65 0a 23 65 6e 64 69 66 0a 20 20 7b }else.#endif. {
8f10: 0a 20 20 20 20 72 65 74 75 72 6e 20 28 73 71 6c . return (sql
8f20: 69 74 65 33 5f 70 63 61 63 68 65 5f 70 61 67 65 ite3_pcache_page
8f30: 2a 29 70 63 61 63 68 65 31 46 65 74 63 68 4e 6f *)pcache1FetchNo
8f40: 4d 75 74 65 78 28 70 2c 20 69 4b 65 79 2c 20 63 Mutex(p, iKey, c
8f50: 72 65 61 74 65 46 6c 61 67 29 3b 0a 20 20 7d 0a reateFlag);. }.
8f60: 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d }.../*.** Implem
8f70: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 entation of the
8f80: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 2e 78 sqlite3_pcache.x
8f90: 55 6e 70 69 6e 20 6d 65 74 68 6f 64 2e 0a 2a 2a Unpin method..**
8fa0: 0a 2a 2a 20 4d 61 72 6b 20 61 20 70 61 67 65 20 .** Mark a page
8fb0: 61 73 20 75 6e 70 69 6e 6e 65 64 20 28 65 6c 69 as unpinned (eli
8fc0: 67 69 62 6c 65 20 66 6f 72 20 61 73 79 6e 63 68 gible for asynch
8fd0: 72 6f 6e 6f 75 73 20 72 65 63 79 63 6c 69 6e 67 ronous recycling
8fe0: 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 )..*/.static voi
8ff0: 64 20 70 63 61 63 68 65 31 55 6e 70 69 6e 28 0a d pcache1Unpin(.
9000: 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 sqlite3_pcache
9010: 20 2a 70 2c 20 0a 20 20 73 71 6c 69 74 65 33 5f *p, . sqlite3_
9020: 70 63 61 63 68 65 5f 70 61 67 65 20 2a 70 50 67 pcache_page *pPg
9030: 2c 20 0a 20 20 69 6e 74 20 72 65 75 73 65 55 6e , . int reuseUn
9040: 6c 69 6b 65 6c 79 0a 29 7b 0a 20 20 50 43 61 63 likely.){. PCac
9050: 68 65 31 20 2a 70 43 61 63 68 65 20 3d 20 28 50 he1 *pCache = (P
9060: 43 61 63 68 65 31 20 2a 29 70 3b 0a 20 20 50 67 Cache1 *)p;. Pg
9070: 48 64 72 31 20 2a 70 50 61 67 65 20 3d 20 28 50 Hdr1 *pPage = (P
9080: 67 48 64 72 31 20 2a 29 70 50 67 3b 0a 20 20 50 gHdr1 *)pPg;. P
9090: 47 72 6f 75 70 20 2a 70 47 72 6f 75 70 20 3d 20 Group *pGroup =
90a0: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 3b 0a pCache->pGroup;.
90b0: 20 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 . assert( pPag
90c0: 65 2d 3e 70 43 61 63 68 65 3d 3d 70 43 61 63 68 e->pCache==pCach
90d0: 65 20 29 3b 0a 20 20 70 63 61 63 68 65 31 45 6e e );. pcache1En
90e0: 74 65 72 4d 75 74 65 78 28 70 47 72 6f 75 70 29 terMutex(pGroup)
90f0: 3b 0a 0a 20 20 2f 2a 20 49 74 20 69 73 20 61 6e ;.. /* It is an
9100: 20 65 72 72 6f 72 20 74 6f 20 63 61 6c 6c 20 74 error to call t
9110: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 66 20 his function if
9120: 74 68 65 20 70 61 67 65 20 69 73 20 61 6c 72 65 the page is alre
9130: 61 64 79 20 0a 20 20 2a 2a 20 70 61 72 74 20 6f ady . ** part o
9140: 66 20 74 68 65 20 50 47 72 6f 75 70 20 4c 52 55 f the PGroup LRU
9150: 20 6c 69 73 74 2e 0a 20 20 2a 2f 0a 20 20 61 73 list.. */. as
9160: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 4c 72 sert( pPage->pLr
9170: 75 4e 65 78 74 3d 3d 30 20 29 3b 0a 20 20 61 73 uNext==0 );. as
9180: 73 65 72 74 28 20 50 41 47 45 5f 49 53 5f 50 49 sert( PAGE_IS_PI
9190: 4e 4e 45 44 28 70 50 61 67 65 29 20 29 3b 0a 0a NNED(pPage) );..
91a0: 20 20 69 66 28 20 72 65 75 73 65 55 6e 6c 69 6b if( reuseUnlik
91b0: 65 6c 79 20 7c 7c 20 70 47 72 6f 75 70 2d 3e 6e ely || pGroup->n
91c0: 50 75 72 67 65 61 62 6c 65 3e 70 47 72 6f 75 70 Purgeable>pGroup
91d0: 2d 3e 6e 4d 61 78 50 61 67 65 20 29 7b 0a 20 20 ->nMaxPage ){.
91e0: 20 20 70 63 61 63 68 65 31 52 65 6d 6f 76 65 46 pcache1RemoveF
91f0: 72 6f 6d 48 61 73 68 28 70 50 61 67 65 2c 20 31 romHash(pPage, 1
9200: 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 );. }else{.
9210: 2f 2a 20 41 64 64 20 74 68 65 20 70 61 67 65 20 /* Add the page
9220: 74 6f 20 74 68 65 20 50 47 72 6f 75 70 20 4c 52 to the PGroup LR
9230: 55 20 6c 69 73 74 2e 20 2a 2f 0a 20 20 20 20 50 U list. */. P
9240: 67 48 64 72 31 20 2a 2a 70 70 46 69 72 73 74 20 gHdr1 **ppFirst
9250: 3d 20 26 70 47 72 6f 75 70 2d 3e 6c 72 75 2e 70 = &pGroup->lru.p
9260: 4c 72 75 4e 65 78 74 3b 0a 20 20 20 20 70 50 61 LruNext;. pPa
9270: 67 65 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20 26 ge->pLruPrev = &
9280: 70 47 72 6f 75 70 2d 3e 6c 72 75 3b 0a 20 20 20 pGroup->lru;.
9290: 20 28 70 50 61 67 65 2d 3e 70 4c 72 75 4e 65 78 (pPage->pLruNex
92a0: 74 20 3d 20 2a 70 70 46 69 72 73 74 29 2d 3e 70 t = *ppFirst)->p
92b0: 4c 72 75 50 72 65 76 20 3d 20 70 50 61 67 65 3b LruPrev = pPage;
92c0: 0a 20 20 20 20 2a 70 70 46 69 72 73 74 20 3d 20 . *ppFirst =
92d0: 70 50 61 67 65 3b 0a 20 20 20 20 70 43 61 63 68 pPage;. pCach
92e0: 65 2d 3e 6e 52 65 63 79 63 6c 61 62 6c 65 2b 2b e->nRecyclable++
92f0: 3b 0a 20 20 7d 0a 0a 20 20 70 63 61 63 68 65 31 ;. }.. pcache1
9300: 4c 65 61 76 65 4d 75 74 65 78 28 70 43 61 63 68 LeaveMutex(pCach
9310: 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 7d 0a 0a 2f e->pGroup);.}../
9320: 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 *.** Implementat
9330: 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74 ion of the sqlit
9340: 65 33 5f 70 63 61 63 68 65 2e 78 52 65 6b 65 79 e3_pcache.xRekey
9350: 20 6d 65 74 68 6f 64 2e 20 0a 2a 2f 0a 73 74 61 method. .*/.sta
9360: 74 69 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 tic void pcache1
9370: 52 65 6b 65 79 28 0a 20 20 73 71 6c 69 74 65 33 Rekey(. sqlite3
9380: 5f 70 63 61 63 68 65 20 2a 70 2c 0a 20 20 73 71 _pcache *p,. sq
9390: 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 70 61 67 lite3_pcache_pag
93a0: 65 20 2a 70 50 67 2c 0a 20 20 75 6e 73 69 67 6e e *pPg,. unsign
93b0: 65 64 20 69 6e 74 20 69 4f 6c 64 2c 0a 20 20 75 ed int iOld,. u
93c0: 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 4e 65 77 nsigned int iNew
93d0: 0a 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a 70 .){. PCache1 *p
93e0: 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 65 31 Cache = (PCache1
93f0: 20 2a 29 70 3b 0a 20 20 50 67 48 64 72 31 20 2a *)p;. PgHdr1 *
9400: 70 50 61 67 65 20 3d 20 28 50 67 48 64 72 31 20 pPage = (PgHdr1
9410: 2a 29 70 50 67 3b 0a 20 20 50 67 48 64 72 31 20 *)pPg;. PgHdr1
9420: 2a 2a 70 70 3b 0a 20 20 75 6e 73 69 67 6e 65 64 **pp;. unsigned
9430: 20 69 6e 74 20 68 3b 20 0a 20 20 61 73 73 65 72 int h; . asser
9440: 74 28 20 70 50 61 67 65 2d 3e 69 4b 65 79 3d 3d t( pPage->iKey==
9450: 69 4f 6c 64 20 29 3b 0a 20 20 61 73 73 65 72 74 iOld );. assert
9460: 28 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65 3d ( pPage->pCache=
9470: 3d 70 43 61 63 68 65 20 29 3b 0a 0a 20 20 70 63 =pCache );.. pc
9480: 61 63 68 65 31 45 6e 74 65 72 4d 75 74 65 78 28 ache1EnterMutex(
9490: 70 43 61 63 68 65 2d 3e 70 47 72 6f 75 70 29 3b pCache->pGroup);
94a0: 0a 0a 20 20 68 20 3d 20 69 4f 6c 64 25 70 43 61 .. h = iOld%pCa
94b0: 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 70 70 che->nHash;. pp
94c0: 20 3d 20 26 70 43 61 63 68 65 2d 3e 61 70 48 61 = &pCache->apHa
94d0: 73 68 5b 68 5d 3b 0a 20 20 77 68 69 6c 65 28 20 sh[h];. while(
94e0: 28 2a 70 70 29 21 3d 70 50 61 67 65 20 29 7b 0a (*pp)!=pPage ){.
94f0: 20 20 20 20 70 70 20 3d 20 26 28 2a 70 70 29 2d pp = &(*pp)-
9500: 3e 70 4e 65 78 74 3b 0a 20 20 7d 0a 20 20 2a 70 >pNext;. }. *p
9510: 70 20 3d 20 70 50 61 67 65 2d 3e 70 4e 65 78 74 p = pPage->pNext
9520: 3b 0a 0a 20 20 68 20 3d 20 69 4e 65 77 25 70 43 ;.. h = iNew%pC
9530: 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 70 ache->nHash;. p
9540: 50 61 67 65 2d 3e 69 4b 65 79 20 3d 20 69 4e 65 Page->iKey = iNe
9550: 77 3b 0a 20 20 70 50 61 67 65 2d 3e 70 4e 65 78 w;. pPage->pNex
9560: 74 20 3d 20 70 43 61 63 68 65 2d 3e 61 70 48 61 t = pCache->apHa
9570: 73 68 5b 68 5d 3b 0a 20 20 70 43 61 63 68 65 2d sh[h];. pCache-
9580: 3e 61 70 48 61 73 68 5b 68 5d 20 3d 20 70 50 61 >apHash[h] = pPa
9590: 67 65 3b 0a 20 20 69 66 28 20 69 4e 65 77 3e 70 ge;. if( iNew>p
95a0: 43 61 63 68 65 2d 3e 69 4d 61 78 4b 65 79 20 29 Cache->iMaxKey )
95b0: 7b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 69 4d {. pCache->iM
95c0: 61 78 4b 65 79 20 3d 20 69 4e 65 77 3b 0a 20 20 axKey = iNew;.
95d0: 7d 0a 0a 20 20 70 63 61 63 68 65 31 4c 65 61 76 }.. pcache1Leav
95e0: 65 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 eMutex(pCache->p
95f0: 47 72 6f 75 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a Group);.}../*.**
9600: 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 Implementation
9610: 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 70 of the sqlite3_p
9620: 63 61 63 68 65 2e 78 54 72 75 6e 63 61 74 65 20 cache.xTruncate
9630: 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 44 method. .**.** D
9640: 69 73 63 61 72 64 20 61 6c 6c 20 75 6e 70 69 6e iscard all unpin
9650: 6e 65 64 20 70 61 67 65 73 20 69 6e 20 74 68 65 ned pages in the
9660: 20 63 61 63 68 65 20 77 69 74 68 20 61 20 70 61 cache with a pa
9670: 67 65 20 6e 75 6d 62 65 72 20 65 71 75 61 6c 20 ge number equal
9680: 74 6f 0a 2a 2a 20 6f 72 20 67 72 65 61 74 65 72 to.** or greater
9690: 20 74 68 61 6e 20 70 61 72 61 6d 65 74 65 72 20 than parameter
96a0: 69 4c 69 6d 69 74 2e 20 41 6e 79 20 70 69 6e 6e iLimit. Any pinn
96b0: 65 64 20 70 61 67 65 73 20 77 69 74 68 20 61 20 ed pages with a
96c0: 70 61 67 65 20 6e 75 6d 62 65 72 0a 2a 2a 20 65 page number.** e
96d0: 71 75 61 6c 20 74 6f 20 6f 72 20 67 72 65 61 74 qual to or great
96e0: 65 72 20 74 68 61 6e 20 69 4c 69 6d 69 74 20 61 er than iLimit a
96f0: 72 65 20 69 6d 70 6c 69 63 69 74 6c 79 20 75 6e re implicitly un
9700: 70 69 6e 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 pinned..*/.stati
9710: 63 20 76 6f 69 64 20 70 63 61 63 68 65 31 54 72 c void pcache1Tr
9720: 75 6e 63 61 74 65 28 73 71 6c 69 74 65 33 5f 70 uncate(sqlite3_p
9730: 63 61 63 68 65 20 2a 70 2c 20 75 6e 73 69 67 6e cache *p, unsign
9740: 65 64 20 69 6e 74 20 69 4c 69 6d 69 74 29 7b 0a ed int iLimit){.
9750: 20 20 50 43 61 63 68 65 31 20 2a 70 43 61 63 68 PCache1 *pCach
9760: 65 20 3d 20 28 50 43 61 63 68 65 31 20 2a 29 70 e = (PCache1 *)p
9770: 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65 72 ;. pcache1Enter
9780: 4d 75 74 65 78 28 70 43 61 63 68 65 2d 3e 70 47 Mutex(pCache->pG
9790: 72 6f 75 70 29 3b 0a 20 20 69 66 28 20 69 4c 69 roup);. if( iLi
97a0: 6d 69 74 3c 3d 70 43 61 63 68 65 2d 3e 69 4d 61 mit<=pCache->iMa
97b0: 78 4b 65 79 20 29 7b 0a 20 20 20 20 70 63 61 63 xKey ){. pcac
97c0: 68 65 31 54 72 75 6e 63 61 74 65 55 6e 73 61 66 he1TruncateUnsaf
97d0: 65 28 70 43 61 63 68 65 2c 20 69 4c 69 6d 69 74 e(pCache, iLimit
97e0: 29 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 69 );. pCache->i
97f0: 4d 61 78 4b 65 79 20 3d 20 69 4c 69 6d 69 74 2d MaxKey = iLimit-
9800: 31 3b 0a 20 20 7d 0a 20 20 70 63 61 63 68 65 31 1;. }. pcache1
9810: 4c 65 61 76 65 4d 75 74 65 78 28 70 43 61 63 68 LeaveMutex(pCach
9820: 65 2d 3e 70 47 72 6f 75 70 29 3b 0a 7d 0a 0a 2f e->pGroup);.}../
9830: 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 *.** Implementat
9840: 69 6f 6e 20 6f 66 20 74 68 65 20 73 71 6c 69 74 ion of the sqlit
9850: 65 33 5f 70 63 61 63 68 65 2e 78 44 65 73 74 72 e3_pcache.xDestr
9860: 6f 79 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a oy method. .**.*
9870: 2a 20 44 65 73 74 72 6f 79 20 61 20 63 61 63 68 * Destroy a cach
9880: 65 20 61 6c 6c 6f 63 61 74 65 64 20 75 73 69 6e e allocated usin
9890: 67 20 70 63 61 63 68 65 31 43 72 65 61 74 65 28 g pcache1Create(
98a0: 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 )..*/.static voi
98b0: 64 20 70 63 61 63 68 65 31 44 65 73 74 72 6f 79 d pcache1Destroy
98c0: 28 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 20 (sqlite3_pcache
98d0: 2a 70 29 7b 0a 20 20 50 43 61 63 68 65 31 20 2a *p){. PCache1 *
98e0: 70 43 61 63 68 65 20 3d 20 28 50 43 61 63 68 65 pCache = (PCache
98f0: 31 20 2a 29 70 3b 0a 20 20 50 47 72 6f 75 70 20 1 *)p;. PGroup
9900: 2a 70 47 72 6f 75 70 20 3d 20 70 43 61 63 68 65 *pGroup = pCache
9910: 2d 3e 70 47 72 6f 75 70 3b 0a 20 20 61 73 73 65 ->pGroup;. asse
9920: 72 74 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72 rt( pCache->bPur
9930: 67 65 61 62 6c 65 20 7c 7c 20 28 70 43 61 63 68 geable || (pCach
9940: 65 2d 3e 6e 4d 61 78 3d 3d 30 20 26 26 20 70 43 e->nMax==0 && pC
9950: 61 63 68 65 2d 3e 6e 4d 69 6e 3d 3d 30 29 20 29 ache->nMin==0) )
9960: 3b 0a 20 20 70 63 61 63 68 65 31 45 6e 74 65 72 ;. pcache1Enter
9970: 4d 75 74 65 78 28 70 47 72 6f 75 70 29 3b 0a 20 Mutex(pGroup);.
9980: 20 69 66 28 20 70 43 61 63 68 65 2d 3e 6e 50 61 if( pCache->nPa
9990: 67 65 20 29 20 70 63 61 63 68 65 31 54 72 75 6e ge ) pcache1Trun
99a0: 63 61 74 65 55 6e 73 61 66 65 28 70 43 61 63 68 cateUnsafe(pCach
99b0: 65 2c 20 30 29 3b 0a 20 20 61 73 73 65 72 74 28 e, 0);. assert(
99c0: 20 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 pGroup->nMaxPag
99d0: 65 20 3e 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 61 e >= pCache->nMa
99e0: 78 20 29 3b 0a 20 20 70 47 72 6f 75 70 2d 3e 6e x );. pGroup->n
99f0: 4d 61 78 50 61 67 65 20 2d 3d 20 70 43 61 63 68 MaxPage -= pCach
9a00: 65 2d 3e 6e 4d 61 78 3b 0a 20 20 61 73 73 65 72 e->nMax;. asser
9a10: 74 28 20 70 47 72 6f 75 70 2d 3e 6e 4d 69 6e 50 t( pGroup->nMinP
9a20: 61 67 65 20 3e 3d 20 70 43 61 63 68 65 2d 3e 6e age >= pCache->n
9a30: 4d 69 6e 20 29 3b 0a 20 20 70 47 72 6f 75 70 2d Min );. pGroup-
9a40: 3e 6e 4d 69 6e 50 61 67 65 20 2d 3d 20 70 43 61 >nMinPage -= pCa
9a50: 63 68 65 2d 3e 6e 4d 69 6e 3b 0a 20 20 70 47 72 che->nMin;. pGr
9a60: 6f 75 70 2d 3e 6d 78 50 69 6e 6e 65 64 20 3d 20 oup->mxPinned =
9a70: 70 47 72 6f 75 70 2d 3e 6e 4d 61 78 50 61 67 65 pGroup->nMaxPage
9a80: 20 2b 20 31 30 20 2d 20 70 47 72 6f 75 70 2d 3e + 10 - pGroup->
9a90: 6e 4d 69 6e 50 61 67 65 3b 0a 20 20 70 63 61 63 nMinPage;. pcac
9aa0: 68 65 31 45 6e 66 6f 72 63 65 4d 61 78 50 61 67 he1EnforceMaxPag
9ab0: 65 28 70 43 61 63 68 65 29 3b 0a 20 20 70 63 61 e(pCache);. pca
9ac0: 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 28 70 che1LeaveMutex(p
9ad0: 47 72 6f 75 70 29 3b 0a 20 20 73 71 6c 69 74 65 Group);. sqlite
9ae0: 33 5f 66 72 65 65 28 70 43 61 63 68 65 2d 3e 70 3_free(pCache->p
9af0: 42 75 6c 6b 29 3b 0a 20 20 73 71 6c 69 74 65 33 Bulk);. sqlite3
9b00: 5f 66 72 65 65 28 70 43 61 63 68 65 2d 3e 61 70 _free(pCache->ap
9b10: 48 61 73 68 29 3b 0a 20 20 73 71 6c 69 74 65 33 Hash);. sqlite3
9b20: 5f 66 72 65 65 28 70 43 61 63 68 65 29 3b 0a 7d _free(pCache);.}
9b30: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ../*.** This fun
9b40: 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 ction is called
9b50: 64 75 72 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a during initializ
9b60: 61 74 69 6f 6e 20 28 73 71 6c 69 74 65 33 5f 69 ation (sqlite3_i
9b70: 6e 69 74 69 61 6c 69 7a 65 28 29 29 20 74 6f 0a nitialize()) to.
9b80: 2a 2a 20 69 6e 73 74 61 6c 6c 20 74 68 65 20 64 ** install the d
9b90: 65 66 61 75 6c 74 20 70 6c 75 67 67 61 62 6c 65 efault pluggable
9ba0: 20 63 61 63 68 65 20 6d 6f 64 75 6c 65 2c 20 61 cache module, a
9bb0: 73 73 75 6d 69 6e 67 20 74 68 65 20 75 73 65 72 ssuming the user
9bc0: 20 68 61 73 20 6e 6f 74 0a 2a 2a 20 61 6c 72 65 has not.** alre
9bd0: 61 64 79 20 70 72 6f 76 69 64 65 64 20 61 6e 20 ady provided an
9be0: 61 6c 74 65 72 6e 61 74 69 76 65 2e 0a 2a 2f 0a alternative..*/.
9bf0: 76 6f 69 64 20 73 71 6c 69 74 65 33 50 43 61 63 void sqlite3PCac
9c00: 68 65 53 65 74 44 65 66 61 75 6c 74 28 76 6f 69 heSetDefault(voi
9c10: 64 29 7b 0a 20 20 73 74 61 74 69 63 20 63 6f 6e d){. static con
9c20: 73 74 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 st sqlite3_pcach
9c30: 65 5f 6d 65 74 68 6f 64 73 32 20 64 65 66 61 75 e_methods2 defau
9c40: 6c 74 4d 65 74 68 6f 64 73 20 3d 20 7b 0a 20 20 ltMethods = {.
9c50: 20 20 31 2c 20 20 20 20 20 20 20 20 20 20 20 20 1,
9c60: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 69 56 /* iV
9c70: 65 72 73 69 6f 6e 20 2a 2f 0a 20 20 20 20 30 2c ersion */. 0,
9c80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9c90: 20 20 20 20 20 20 20 2f 2a 20 70 41 72 67 20 2a /* pArg *
9ca0: 2f 0a 20 20 20 20 70 63 61 63 68 65 31 49 6e 69 /. pcache1Ini
9cb0: 74 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 2f t, /
9cc0: 2a 20 78 49 6e 69 74 20 2a 2f 0a 20 20 20 20 70 * xInit */. p
9cd0: 63 61 63 68 65 31 53 68 75 74 64 6f 77 6e 2c 20 cache1Shutdown,
9ce0: 20 20 20 20 20 20 20 20 2f 2a 20 78 53 68 75 74 /* xShut
9cf0: 64 6f 77 6e 20 2a 2f 0a 20 20 20 20 70 63 61 63 down */. pcac
9d00: 68 65 31 43 72 65 61 74 65 2c 20 20 20 20 20 20 he1Create,
9d10: 20 20 20 20 20 2f 2a 20 78 43 72 65 61 74 65 20 /* xCreate
9d20: 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 43 61 */. pcache1Ca
9d30: 63 68 65 73 69 7a 65 2c 20 20 20 20 20 20 20 20 chesize,
9d40: 2f 2a 20 78 43 61 63 68 65 73 69 7a 65 20 2a 2f /* xCachesize */
9d50: 0a 20 20 20 20 70 63 61 63 68 65 31 50 61 67 65 . pcache1Page
9d60: 63 6f 75 6e 74 2c 20 20 20 20 20 20 20 20 2f 2a count, /*
9d70: 20 78 50 61 67 65 63 6f 75 6e 74 20 2a 2f 0a 20 xPagecount */.
9d80: 20 20 20 70 63 61 63 68 65 31 46 65 74 63 68 2c pcache1Fetch,
9d90: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 /* x
9da0: 46 65 74 63 68 20 2a 2f 0a 20 20 20 20 70 63 61 Fetch */. pca
9db0: 63 68 65 31 55 6e 70 69 6e 2c 20 20 20 20 20 20 che1Unpin,
9dc0: 20 20 20 20 20 20 2f 2a 20 78 55 6e 70 69 6e 20 /* xUnpin
9dd0: 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 31 52 65 */. pcache1Re
9de0: 6b 65 79 2c 20 20 20 20 20 20 20 20 20 20 20 20 key,
9df0: 2f 2a 20 78 52 65 6b 65 79 20 2a 2f 0a 20 20 20 /* xRekey */.
9e00: 20 70 63 61 63 68 65 31 54 72 75 6e 63 61 74 65 pcache1Truncate
9e10: 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 78 54 72 , /* xTr
9e20: 75 6e 63 61 74 65 20 2a 2f 0a 20 20 20 20 70 63 uncate */. pc
9e30: 61 63 68 65 31 44 65 73 74 72 6f 79 2c 20 20 20 ache1Destroy,
9e40: 20 20 20 20 20 20 20 2f 2a 20 78 44 65 73 74 72 /* xDestr
9e50: 6f 79 20 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 oy */. pcache
9e60: 31 53 68 72 69 6e 6b 20 20 20 20 20 20 20 20 20 1Shrink
9e70: 20 20 20 2f 2a 20 78 53 68 72 69 6e 6b 20 2a 2f /* xShrink */
9e80: 0a 20 20 7d 3b 0a 20 20 73 71 6c 69 74 65 33 5f . };. sqlite3_
9e90: 63 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f 43 4f config(SQLITE_CO
9ea0: 4e 46 49 47 5f 50 43 41 43 48 45 32 2c 20 26 64 NFIG_PCACHE2, &d
9eb0: 65 66 61 75 6c 74 4d 65 74 68 6f 64 73 29 3b 0a efaultMethods);.
9ec0: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 }../*.** Return
9ed0: 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 the size of the
9ee0: 68 65 61 64 65 72 20 6f 6e 20 65 61 63 68 20 70 header on each p
9ef0: 61 67 65 20 6f 66 20 74 68 69 73 20 50 43 41 43 age of this PCAC
9f00: 48 45 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f HE implementatio
9f10: 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 n..*/.int sqlite
9f20: 33 48 65 61 64 65 72 53 69 7a 65 50 63 61 63 68 3HeaderSizePcach
9f30: 65 31 28 76 6f 69 64 29 7b 20 72 65 74 75 72 6e e1(void){ return
9f40: 20 52 4f 55 4e 44 38 28 73 69 7a 65 6f 66 28 50 ROUND8(sizeof(P
9f50: 67 48 64 72 31 29 29 3b 20 7d 0a 0a 2f 2a 0a 2a gHdr1)); }../*.*
9f60: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 67 6c 6f * Return the glo
9f70: 62 61 6c 20 6d 75 74 65 78 20 75 73 65 64 20 62 bal mutex used b
9f80: 79 20 74 68 69 73 20 50 43 41 43 48 45 20 69 6d y this PCACHE im
9f90: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 20 20 54 plementation. T
9fa0: 68 65 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 73 74 he.** sqlite3_st
9fb0: 61 74 75 73 28 29 20 72 6f 75 74 69 6e 65 20 6e atus() routine n
9fc0: 65 65 64 73 20 61 63 63 65 73 73 20 74 6f 20 74 eeds access to t
9fd0: 68 69 73 20 6d 75 74 65 78 2e 0a 2a 2f 0a 73 71 his mutex..*/.sq
9fe0: 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 73 71 6c lite3_mutex *sql
9ff0: 69 74 65 33 50 63 61 63 68 65 31 4d 75 74 65 78 ite3Pcache1Mutex
a000: 28 76 6f 69 64 29 7b 0a 20 20 72 65 74 75 72 6e (void){. return
a010: 20 70 63 61 63 68 65 31 2e 6d 75 74 65 78 3b 0a pcache1.mutex;.
a020: 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 }..#ifdef SQLITE
a030: 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d _ENABLE_MEMORY_M
a040: 41 4e 41 47 45 4d 45 4e 54 0a 2f 2a 0a 2a 2a 20 ANAGEMENT./*.**
a050: 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 This function is
a060: 20 63 61 6c 6c 65 64 20 74 6f 20 66 72 65 65 20 called to free
a070: 73 75 70 65 72 66 6c 75 6f 75 73 20 64 79 6e 61 superfluous dyna
a080: 6d 69 63 61 6c 6c 79 20 61 6c 6c 6f 63 61 74 65 mically allocate
a090: 64 20 6d 65 6d 6f 72 79 0a 2a 2a 20 68 65 6c 64 d memory.** held
a0a0: 20 62 79 20 74 68 65 20 70 61 67 65 72 20 73 79 by the pager sy
a0b0: 73 74 65 6d 2e 20 4d 65 6d 6f 72 79 20 69 6e 20 stem. Memory in
a0c0: 75 73 65 20 62 79 20 61 6e 79 20 53 51 4c 69 74 use by any SQLit
a0d0: 65 20 70 61 67 65 72 20 61 6c 6c 6f 63 61 74 65 e pager allocate
a0e0: 64 0a 2a 2a 20 62 79 20 74 68 65 20 63 75 72 72 d.** by the curr
a0f0: 65 6e 74 20 74 68 72 65 61 64 20 6d 61 79 20 62 ent thread may b
a100: 65 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 29 e sqlite3_free()
a110: 65 64 2e 0a 2a 2a 0a 2a 2a 20 6e 52 65 71 20 69 ed..**.** nReq i
a120: 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 s the number of
a130: 62 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79 20 bytes of memory
a140: 72 65 71 75 69 72 65 64 2e 20 4f 6e 63 65 20 74 required. Once t
a150: 68 69 73 20 6d 75 63 68 20 68 61 73 0a 2a 2a 20 his much has.**
a160: 62 65 65 6e 20 72 65 6c 65 61 73 65 64 2c 20 74 been released, t
a170: 68 65 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 he function retu
a180: 72 6e 73 2e 20 54 68 65 20 72 65 74 75 72 6e 20 rns. The return
a190: 76 61 6c 75 65 20 69 73 20 74 68 65 20 74 6f 74 value is the tot
a1a0: 61 6c 20 6e 75 6d 62 65 72 20 0a 2a 2a 20 6f 66 al number .** of
a1b0: 20 62 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79 bytes of memory
a1c0: 20 72 65 6c 65 61 73 65 64 2e 0a 2a 2f 0a 69 6e released..*/.in
a1d0: 74 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 52 t sqlite3PcacheR
a1e0: 65 6c 65 61 73 65 4d 65 6d 6f 72 79 28 69 6e 74 eleaseMemory(int
a1f0: 20 6e 52 65 71 29 7b 0a 20 20 69 6e 74 20 6e 46 nReq){. int nF
a200: 72 65 65 20 3d 20 30 3b 0a 20 20 61 73 73 65 72 ree = 0;. asser
a210: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
a220: 5f 6e 6f 74 68 65 6c 64 28 70 63 61 63 68 65 31 _notheld(pcache1
a230: 2e 67 72 70 2e 6d 75 74 65 78 29 20 29 3b 0a 20 .grp.mutex) );.
a240: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
a250: 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c 64 28 70 _mutex_notheld(p
a260: 63 61 63 68 65 31 2e 6d 75 74 65 78 29 20 29 3b cache1.mutex) );
a270: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c . if( sqlite3Gl
a280: 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65 obalConfig.pPage
a290: 3d 3d 30 20 29 7b 0a 20 20 20 20 50 67 48 64 72 ==0 ){. PgHdr
a2a0: 31 20 2a 70 3b 0a 20 20 20 20 70 63 61 63 68 65 1 *p;. pcache
a2b0: 31 45 6e 74 65 72 4d 75 74 65 78 28 26 70 63 61 1EnterMutex(&pca
a2c0: 63 68 65 31 2e 67 72 70 29 3b 0a 20 20 20 20 77 che1.grp);. w
a2d0: 68 69 6c 65 28 20 28 6e 52 65 71 3c 30 20 7c 7c hile( (nReq<0 ||
a2e0: 20 6e 46 72 65 65 3c 6e 52 65 71 29 0a 20 20 20 nFree<nReq).
a2f0: 20 20 20 20 26 26 20 20 28 70 3d 70 63 61 63 68 && (p=pcach
a300: 65 31 2e 67 72 70 2e 6c 72 75 2e 70 4c 72 75 50 e1.grp.lru.pLruP
a310: 72 65 76 29 21 3d 30 0a 20 20 20 20 20 20 20 26 rev)!=0. &
a320: 26 20 20 70 2d 3e 69 73 41 6e 63 68 6f 72 3d 3d & p->isAnchor==
a330: 30 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 6e 0. ){. n
a340: 46 72 65 65 20 2b 3d 20 70 63 61 63 68 65 31 4d Free += pcache1M
a350: 65 6d 53 69 7a 65 28 70 2d 3e 70 61 67 65 2e 70 emSize(p->page.p
a360: 42 75 66 29 3b 0a 23 69 66 64 65 66 20 53 51 4c Buf);.#ifdef SQL
a370: 49 54 45 5f 50 43 41 43 48 45 5f 53 45 50 41 52 ITE_PCACHE_SEPAR
a380: 41 54 45 5f 48 45 41 44 45 52 0a 20 20 20 20 20 ATE_HEADER.
a390: 20 6e 46 72 65 65 20 2b 3d 20 73 71 6c 69 74 65 nFree += sqlite
a3a0: 33 4d 65 6d 53 69 7a 65 28 70 29 3b 0a 23 65 6e 3MemSize(p);.#en
a3b0: 64 69 66 0a 20 20 20 20 20 20 61 73 73 65 72 74 dif. assert
a3c0: 28 20 50 41 47 45 5f 49 53 5f 55 4e 50 49 4e 4e ( PAGE_IS_UNPINN
a3d0: 45 44 28 70 29 20 29 3b 0a 20 20 20 20 20 20 70 ED(p) );. p
a3e0: 63 61 63 68 65 31 50 69 6e 50 61 67 65 28 70 29 cache1PinPage(p)
a3f0: 3b 0a 20 20 20 20 20 20 70 63 61 63 68 65 31 52 ;. pcache1R
a400: 65 6d 6f 76 65 46 72 6f 6d 48 61 73 68 28 70 2c emoveFromHash(p,
a410: 20 31 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 1);. }. p
a420: 63 61 63 68 65 31 4c 65 61 76 65 4d 75 74 65 78 cache1LeaveMutex
a430: 28 26 70 63 61 63 68 65 31 2e 67 72 70 29 3b 0a (&pcache1.grp);.
a440: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 6e 46 72 }. return nFr
a450: 65 65 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 ee;.}.#endif /*
a460: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 SQLITE_ENABLE_ME
a470: 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 20 MORY_MANAGEMENT
a480: 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 */..#ifdef SQLIT
a490: 45 5f 54 45 53 54 0a 2f 2a 0a 2a 2a 20 54 68 69 E_TEST./*.** Thi
a4a0: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 s function is us
a4b0: 65 64 20 62 79 20 74 65 73 74 20 70 72 6f 63 65 ed by test proce
a4c0: 64 75 72 65 73 20 74 6f 20 69 6e 73 70 65 63 74 dures to inspect
a4d0: 20 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 73 74 the internal st
a4e0: 61 74 65 0a 2a 2a 20 6f 66 20 74 68 65 20 67 6c ate.** of the gl
a4f0: 6f 62 61 6c 20 63 61 63 68 65 2e 0a 2a 2f 0a 76 obal cache..*/.v
a500: 6f 69 64 20 73 71 6c 69 74 65 33 50 63 61 63 68 oid sqlite3Pcach
a510: 65 53 74 61 74 73 28 0a 20 20 69 6e 74 20 2a 70 eStats(. int *p
a520: 6e 43 75 72 72 65 6e 74 2c 20 20 20 20 20 20 2f nCurrent, /
a530: 2a 20 4f 55 54 3a 20 54 6f 74 61 6c 20 6e 75 6d * OUT: Total num
a540: 62 65 72 20 6f 66 20 70 61 67 65 73 20 63 61 63 ber of pages cac
a550: 68 65 64 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e hed */. int *pn
a560: 4d 61 78 2c 20 20 20 20 20 20 20 20 20 20 2f 2a Max, /*
a570: 20 4f 55 54 3a 20 47 6c 6f 62 61 6c 20 6d 61 78 OUT: Global max
a580: 69 6d 75 6d 20 63 61 63 68 65 20 73 69 7a 65 20 imum cache size
a590: 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 4d 69 6e 2c */. int *pnMin,
a5a0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 /* OUT
a5b0: 3a 20 53 75 6d 20 6f 66 20 50 43 61 63 68 65 31 : Sum of PCache1
a5c0: 2e 6e 4d 69 6e 20 66 6f 72 20 70 75 72 67 65 61 .nMin for purgea
a5d0: 62 6c 65 20 63 61 63 68 65 73 20 2a 2f 0a 20 20 ble caches */.
a5e0: 69 6e 74 20 2a 70 6e 52 65 63 79 63 6c 61 62 6c int *pnRecyclabl
a5f0: 65 20 20 20 20 2f 2a 20 4f 55 54 3a 20 54 6f 74 e /* OUT: Tot
a600: 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 al number of pag
a610: 65 73 20 61 76 61 69 6c 61 62 6c 65 20 66 6f 72 es available for
a620: 20 72 65 63 79 63 6c 69 6e 67 20 2a 2f 0a 29 7b recycling */.){
a630: 0a 20 20 50 67 48 64 72 31 20 2a 70 3b 0a 20 20 . PgHdr1 *p;.
a640: 69 6e 74 20 6e 52 65 63 79 63 6c 61 62 6c 65 20 int nRecyclable
a650: 3d 20 30 3b 0a 20 20 66 6f 72 28 70 3d 70 63 61 = 0;. for(p=pca
a660: 63 68 65 31 2e 67 72 70 2e 6c 72 75 2e 70 4c 72 che1.grp.lru.pLr
a670: 75 4e 65 78 74 3b 20 70 20 26 26 20 21 70 2d 3e uNext; p && !p->
a680: 69 73 41 6e 63 68 6f 72 3b 20 70 3d 70 2d 3e 70 isAnchor; p=p->p
a690: 4c 72 75 4e 65 78 74 29 7b 0a 20 20 20 20 61 73 LruNext){. as
a6a0: 73 65 72 74 28 20 50 41 47 45 5f 49 53 5f 55 4e sert( PAGE_IS_UN
a6b0: 50 49 4e 4e 45 44 28 70 29 20 29 3b 0a 20 20 20 PINNED(p) );.
a6c0: 20 6e 52 65 63 79 63 6c 61 62 6c 65 2b 2b 3b 0a nRecyclable++;.
a6d0: 20 20 7d 0a 20 20 2a 70 6e 43 75 72 72 65 6e 74 }. *pnCurrent
a6e0: 20 3d 20 70 63 61 63 68 65 31 2e 67 72 70 2e 6e = pcache1.grp.n
a6f0: 50 75 72 67 65 61 62 6c 65 3b 0a 20 20 2a 70 6e Purgeable;. *pn
a700: 4d 61 78 20 3d 20 28 69 6e 74 29 70 63 61 63 68 Max = (int)pcach
a710: 65 31 2e 67 72 70 2e 6e 4d 61 78 50 61 67 65 3b e1.grp.nMaxPage;
a720: 0a 20 20 2a 70 6e 4d 69 6e 20 3d 20 28 69 6e 74 . *pnMin = (int
a730: 29 70 63 61 63 68 65 31 2e 67 72 70 2e 6e 4d 69 )pcache1.grp.nMi
a740: 6e 50 61 67 65 3b 0a 20 20 2a 70 6e 52 65 63 79 nPage;. *pnRecy
a750: 63 6c 61 62 6c 65 20 3d 20 6e 52 65 63 79 63 6c clable = nRecycl
a760: 61 62 6c 65 3b 0a 7d 0a 23 65 6e 64 69 66 0a able;.}.#endif.