0000: 2f 2a 0a 2a 2a 20 32 30 31 30 20 46 65 62 72 75 /*.** 2010 Febru 0010: 61 72 79 20 31 0a 2a 2a 0a 2a 2a 20 54 68 65 20 ary 1.**.** The 0020: 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 6d 73 author disclaims 0030: 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 74 68 copyright to th 0040: 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 2e 20 is source code. 0050: 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 In place of.** 0060: 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 2c 20 a legal notice, 0070: 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 73 69 here is a blessi 0080: 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 ng:.**.** May 0090: 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 6e 64 you do good and 00a0: 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 not evil..** 00b0: 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 66 6f May you find fo 00c0: 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 79 6f rgiveness for yo 00d0: 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 67 69 urself and forgi 00e0: 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 20 20 ve others..** 00f0: 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 20 66 May you share f 0100: 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 61 6b reely, never tak 0110: 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 79 6f ing more than yo 0120: 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a u 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 0a 2a 2a 20 54 68 69 73 20 68 65 61 ****.** This hea 0180: 64 65 72 20 66 69 6c 65 20 64 65 66 69 6e 65 73 der file defines 0190: 20 74 68 65 20 69 6e 74 65 72 66 61 63 65 20 74 the interface t 01a0: 6f 20 74 68 65 20 77 72 69 74 65 2d 61 68 65 61 o the write-ahea 01b0: 64 20 6c 6f 67 67 69 6e 67 20 0a 2a 2a 20 73 79 d logging .** sy 01c0: 73 74 65 6d 2e 20 52 65 66 65 72 20 74 6f 20 74 stem. Refer to t 01d0: 68 65 20 63 6f 6d 6d 65 6e 74 73 20 62 65 6c 6f he comments belo 01e0: 77 20 61 6e 64 20 74 68 65 20 68 65 61 64 65 72 w and the header 01f0: 20 63 6f 6d 6d 65 6e 74 20 61 74 74 61 63 68 65 comment attache 0200: 64 20 74 6f 20 0a 2a 2a 20 74 68 65 20 69 6d 70 d to .** the imp 0210: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 65 lementation of e 0220: 61 63 68 20 66 75 6e 63 74 69 6f 6e 20 69 6e 20 ach function in 0230: 6c 6f 67 2e 63 20 66 6f 72 20 66 75 72 74 68 65 log.c for furthe 0240: 72 20 64 65 74 61 69 6c 73 2e 0a 2a 2f 0a 0a 23 r details..*/..# 0250: 69 66 6e 64 65 66 20 5f 57 41 4c 5f 48 5f 0a 23 ifndef _WAL_H_.# 0260: 64 65 66 69 6e 65 20 5f 57 41 4c 5f 48 5f 0a 0a define _WAL_H_.. 0270: 23 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 #include "sqlite 0280: 49 6e 74 2e 68 22 0a 0a 23 69 66 64 65 66 20 53 Int.h"..#ifdef S 0290: 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 23 QLITE_OMIT_WAL.# 02a0: 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 57 define sqlite3W 02b0: 61 6c 4f 70 65 6e 28 78 2c 79 2c 7a 29 20 20 20 alOpen(x,y,z) 02c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 30 0a 0. 02d0: 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3 02e0: 57 61 6c 43 6c 6f 73 65 28 77 2c 78 2c 79 2c 7a WalClose(w,x,y,z 02f0: 29 20 20 20 20 20 20 20 20 20 20 20 20 20 20 30 ) 0 0300: 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite 0310: 33 57 61 6c 42 65 67 69 6e 52 65 61 64 54 72 61 3WalBeginReadTra 0320: 6e 73 61 63 74 69 6f 6e 28 79 2c 7a 29 20 20 20 nsaction(y,z) 0330: 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 0.# define sqlit 0340: 65 33 57 61 6c 45 6e 64 52 65 61 64 54 72 61 6e e3WalEndReadTran 0350: 73 61 63 74 69 6f 6e 28 7a 29 0a 23 20 64 65 66 saction(z).# def 0360: 69 6e 65 20 73 71 6c 69 74 65 33 57 61 6c 52 65 ine sqlite3WalRe 0370: 61 64 28 76 2c 77 2c 78 2c 79 2c 7a 29 20 20 20 ad(v,w,x,y,z) 0380: 20 20 20 20 20 20 20 20 20 20 30 0a 23 20 64 65 0.# de 0390: 66 69 6e 65 20 73 71 6c 69 74 65 33 57 61 6c 44 fine sqlite3WalD 03a0: 62 73 69 7a 65 28 79 29 20 20 20 20 20 20 20 20 bsize(y) 03b0: 20 20 20 20 20 20 20 20 20 20 20 30 0a 23 20 64 0.# d 03c0: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 57 61 6c efine sqlite3Wal 03d0: 42 65 67 69 6e 57 72 69 74 65 54 72 61 6e 73 61 BeginWriteTransa 03e0: 63 74 69 6f 6e 28 79 29 20 20 20 20 30 0a 23 20 ction(y) 0.# 03f0: 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 57 61 define sqlite3Wa 0400: 6c 45 6e 64 57 72 69 74 65 54 72 61 6e 73 61 63 lEndWriteTransac 0410: 74 69 6f 6e 28 78 29 20 20 20 20 20 20 30 0a 23 tion(x) 0.# 0420: 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 57 define sqlite3W 0430: 61 6c 55 6e 64 6f 28 78 2c 79 2c 7a 29 20 20 20 alUndo(x,y,z) 0440: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 30 0a 0. 0450: 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3 0460: 57 61 6c 53 61 76 65 70 6f 69 6e 74 28 79 2c 7a WalSavepoint(y,z 0470: 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 ).# define sqlit 0480: 65 33 57 61 6c 53 61 76 65 70 6f 69 6e 74 55 6e e3WalSavepointUn 0490: 64 6f 28 79 2c 7a 29 20 20 20 20 20 20 20 20 20 do(y,z) 04a0: 20 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 0.# define sqli 04b0: 74 65 33 57 61 6c 46 72 61 6d 65 73 28 75 2c 76 te3WalFrames(u,v 04c0: 2c 77 2c 78 2c 79 2c 7a 29 20 20 20 20 20 20 20 ,w,x,y,z) 04d0: 20 20 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 0.# define sql 04e0: 69 74 65 33 57 61 6c 43 68 65 63 6b 70 6f 69 6e ite3WalCheckpoin 04f0: 74 28 75 2c 76 2c 77 2c 78 29 20 20 20 20 20 20 t(u,v,w,x) 0500: 20 20 20 30 0a 23 20 64 65 66 69 6e 65 20 73 71 0.# define sq 0510: 6c 69 74 65 33 57 61 6c 43 61 6c 6c 62 61 63 6b lite3WalCallback 0520: 28 7a 29 20 20 20 20 20 20 20 20 20 20 20 20 20 (z) 0530: 20 20 20 20 30 0a 23 20 64 65 66 69 6e 65 20 73 0.# define s 0540: 71 6c 69 74 65 33 57 61 6c 45 78 63 6c 75 73 69 qlite3WalExclusi 0550: 76 65 4d 6f 64 65 28 79 2c 7a 29 20 20 20 20 20 veMode(y,z) 0560: 20 20 20 20 20 30 0a 23 20 64 65 66 69 6e 65 20 0.# define 0570: 73 71 6c 69 74 65 33 57 61 6c 48 65 61 70 4d 65 sqlite3WalHeapMe 0580: 6d 6f 72 79 28 7a 29 20 20 20 20 20 20 20 20 20 mory(z) 0590: 20 20 20 20 20 20 30 0a 23 65 6c 73 65 0a 0a 23 0.#else..# 05a0: 64 65 66 69 6e 65 20 57 41 4c 5f 53 41 56 45 50 define WAL_SAVEP 05b0: 4f 49 4e 54 5f 4e 44 41 54 41 20 34 0a 0a 2f 2a OINT_NDATA 4../* 05c0: 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 61 Connection to a 05d0: 20 77 72 69 74 65 2d 61 68 65 61 64 20 6c 6f 67 write-ahead log 05e0: 20 28 57 41 4c 29 20 66 69 6c 65 2e 20 0a 2a 2a (WAL) file. .** 05f0: 20 54 68 65 72 65 20 69 73 20 6f 6e 65 20 6f 62 There is one ob 0600: 6a 65 63 74 20 6f 66 20 74 68 69 73 20 74 79 70 ject of this typ 0610: 65 20 66 6f 72 20 65 61 63 68 20 70 61 67 65 72 e for each pager 0620: 2e 20 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 . .*/.typedef st 0630: 72 75 63 74 20 57 61 6c 20 57 61 6c 3b 0a 0a 2f ruct Wal Wal;../ 0640: 2a 20 4f 70 65 6e 20 61 6e 64 20 63 6c 6f 73 65 * Open and close 0650: 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f a connection to 0660: 20 61 20 77 72 69 74 65 2d 61 68 65 61 64 20 6c a write-ahead l 0670: 6f 67 2e 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 og. */.int sqlit 0680: 65 33 57 61 6c 4f 70 65 6e 28 73 71 6c 69 74 65 e3WalOpen(sqlite 0690: 33 5f 76 66 73 2a 2c 20 73 71 6c 69 74 65 33 5f 3_vfs*, sqlite3_ 06a0: 66 69 6c 65 2a 2c 20 63 6f 6e 73 74 20 63 68 61 file*, const cha 06b0: 72 20 2a 7a 4e 61 6d 65 2c 20 69 6e 74 2c 20 57 r *zName, int, W 06c0: 61 6c 2a 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 al**);.int sqlit 06d0: 65 33 57 61 6c 43 6c 6f 73 65 28 57 61 6c 20 2a e3WalClose(Wal * 06e0: 70 57 61 6c 2c 20 69 6e 74 20 73 79 6e 63 5f 66 pWal, int sync_f 06f0: 6c 61 67 73 2c 20 69 6e 74 2c 20 75 38 20 2a 29 lags, int, u8 *) 0700: 3b 0a 0a 2f 2a 20 55 73 65 64 20 62 79 20 72 65 ;../* Used by re 0710: 61 64 65 72 73 20 74 6f 20 6f 70 65 6e 20 28 6c aders to open (l 0720: 6f 63 6b 29 20 61 6e 64 20 63 6c 6f 73 65 20 28 ock) and close ( 0730: 75 6e 6c 6f 63 6b 29 20 61 20 73 6e 61 70 73 68 unlock) a snapsh 0740: 6f 74 2e 20 20 41 20 0a 2a 2a 20 73 6e 61 70 73 ot. A .** snaps 0750: 68 6f 74 20 69 73 20 6c 69 6b 65 20 61 20 72 65 hot is like a re 0760: 61 64 2d 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 ad-transaction. 0770: 20 49 74 20 69 73 20 74 68 65 20 73 74 61 74 65 It is the state 0780: 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 of the database 0790: 0a 2a 2a 20 61 74 20 61 6e 20 69 6e 73 74 61 6e .** at an instan 07a0: 74 20 69 6e 20 74 69 6d 65 2e 20 20 73 71 6c 69 t in time. sqli 07b0: 74 65 33 57 61 6c 4f 70 65 6e 53 6e 61 70 73 68 te3WalOpenSnapsh 07c0: 6f 74 20 67 65 74 73 20 61 20 72 65 61 64 20 6c ot gets a read l 07d0: 6f 63 6b 20 61 6e 64 0a 2a 2a 20 70 72 65 73 65 ock and.** prese 07e0: 72 76 65 73 20 74 68 65 20 63 75 72 72 65 6e 74 rves the current 07f0: 20 73 74 61 74 65 20 65 76 65 6e 20 69 66 20 74 state even if t 0800: 68 65 20 6f 74 68 65 72 20 74 68 72 65 61 64 73 he other threads 0810: 20 6f 72 20 70 72 6f 63 65 73 73 65 73 0a 2a 2a or processes.** 0820: 20 77 72 69 74 65 20 74 6f 20 6f 72 20 63 68 65 write to or che 0830: 63 6b 70 6f 69 6e 74 20 74 68 65 20 57 41 4c 2e ckpoint the WAL. 0840: 20 20 73 71 6c 69 74 65 33 57 61 6c 43 6c 6f 73 sqlite3WalClos 0850: 65 53 6e 61 70 73 68 6f 74 28 29 20 63 6c 6f 73 eSnapshot() clos 0860: 65 73 20 74 68 65 0a 2a 2a 20 74 72 61 6e 73 61 es the.** transa 0870: 63 74 69 6f 6e 20 61 6e 64 20 72 65 6c 65 61 73 ction and releas 0880: 65 73 20 74 68 65 20 6c 6f 63 6b 2e 0a 2a 2f 0a es the lock..*/. 0890: 69 6e 74 20 73 71 6c 69 74 65 33 57 61 6c 42 65 int sqlite3WalBe 08a0: 67 69 6e 52 65 61 64 54 72 61 6e 73 61 63 74 69 ginReadTransacti 08b0: 6f 6e 28 57 61 6c 20 2a 70 57 61 6c 2c 20 69 6e on(Wal *pWal, in 08c0: 74 20 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 t *);.void sqlit 08d0: 65 33 57 61 6c 45 6e 64 52 65 61 64 54 72 61 6e e3WalEndReadTran 08e0: 73 61 63 74 69 6f 6e 28 57 61 6c 20 2a 70 57 61 saction(Wal *pWa 08f0: 6c 29 3b 0a 0a 2f 2a 20 52 65 61 64 20 61 20 70 l);../* Read a p 0900: 61 67 65 20 66 72 6f 6d 20 74 68 65 20 77 72 69 age from the wri 0910: 74 65 2d 61 68 65 61 64 20 6c 6f 67 2c 20 69 66 te-ahead log, if 0920: 20 69 74 20 69 73 20 70 72 65 73 65 6e 74 2e 20 it is present. 0930: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 61 */.int sqlite3Wa 0940: 6c 52 65 61 64 28 57 61 6c 20 2a 70 57 61 6c 2c lRead(Wal *pWal, 0950: 20 50 67 6e 6f 20 70 67 6e 6f 2c 20 69 6e 74 20 Pgno pgno, int 0960: 2a 70 49 6e 57 61 6c 2c 20 69 6e 74 20 6e 4f 75 *pInWal, int nOu 0970: 74 2c 20 75 38 20 2a 70 4f 75 74 29 3b 0a 0a 2f t, u8 *pOut);../ 0980: 2a 20 49 66 20 74 68 65 20 57 41 4c 20 69 73 20 * If the WAL is 0990: 6e 6f 74 20 65 6d 70 74 79 2c 20 72 65 74 75 72 not empty, retur 09a0: 6e 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 n the size of th 09b0: 65 20 64 61 74 61 62 61 73 65 2e 20 2a 2f 0a 50 e database. */.P 09c0: 67 6e 6f 20 73 71 6c 69 74 65 33 57 61 6c 44 62 gno sqlite3WalDb 09d0: 73 69 7a 65 28 57 61 6c 20 2a 70 57 61 6c 29 3b size(Wal *pWal); 09e0: 0a 0a 2f 2a 20 4f 62 74 61 69 6e 20 6f 72 20 72 ../* Obtain or r 09f0: 65 6c 65 61 73 65 20 74 68 65 20 57 52 49 54 45 elease the WRITE 0a00: 52 20 6c 6f 63 6b 2e 20 2a 2f 0a 69 6e 74 20 73 R lock. */.int s 0a10: 71 6c 69 74 65 33 57 61 6c 42 65 67 69 6e 57 72 qlite3WalBeginWr 0a20: 69 74 65 54 72 61 6e 73 61 63 74 69 6f 6e 28 57 iteTransaction(W 0a30: 61 6c 20 2a 70 57 61 6c 29 3b 0a 69 6e 74 20 73 al *pWal);.int s 0a40: 71 6c 69 74 65 33 57 61 6c 45 6e 64 57 72 69 74 qlite3WalEndWrit 0a50: 65 54 72 61 6e 73 61 63 74 69 6f 6e 28 57 61 6c eTransaction(Wal 0a60: 20 2a 70 57 61 6c 29 3b 0a 0a 2f 2a 20 55 6e 64 *pWal);../* Und 0a70: 6f 20 61 6e 79 20 66 72 61 6d 65 73 20 77 72 69 o any frames wri 0a80: 74 74 65 6e 20 28 62 75 74 20 6e 6f 74 20 63 6f tten (but not co 0a90: 6d 6d 69 74 74 65 64 29 20 74 6f 20 74 68 65 20 mmitted) to the 0aa0: 6c 6f 67 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 log */.int sqlit 0ab0: 65 33 57 61 6c 55 6e 64 6f 28 57 61 6c 20 2a 70 e3WalUndo(Wal *p 0ac0: 57 61 6c 2c 20 69 6e 74 20 28 2a 78 55 6e 64 6f Wal, int (*xUndo 0ad0: 29 28 76 6f 69 64 20 2a 2c 20 50 67 6e 6f 29 2c )(void *, Pgno), 0ae0: 20 76 6f 69 64 20 2a 70 55 6e 64 6f 43 74 78 29 void *pUndoCtx) 0af0: 3b 0a 0a 2f 2a 20 52 65 74 75 72 6e 20 61 6e 20 ;../* Return an 0b00: 69 6e 74 65 67 65 72 20 74 68 61 74 20 72 65 63 integer that rec 0b10: 6f 72 64 73 20 74 68 65 20 63 75 72 72 65 6e 74 ords the current 0b20: 20 28 75 6e 63 6f 6d 6d 69 74 74 65 64 29 20 77 (uncommitted) w 0b30: 72 69 74 65 0a 2a 2a 20 70 6f 73 69 74 69 6f 6e rite.** position 0b40: 20 69 6e 20 74 68 65 20 57 41 4c 20 2a 2f 0a 76 in the WAL */.v 0b50: 6f 69 64 20 73 71 6c 69 74 65 33 57 61 6c 53 61 oid sqlite3WalSa 0b60: 76 65 70 6f 69 6e 74 28 57 61 6c 20 2a 70 57 61 vepoint(Wal *pWa 0b70: 6c 2c 20 75 33 32 20 2a 61 57 61 6c 44 61 74 61 l, u32 *aWalData 0b80: 29 3b 0a 0a 2f 2a 20 4d 6f 76 65 20 74 68 65 20 );../* Move the 0b90: 77 72 69 74 65 20 70 6f 73 69 74 69 6f 6e 20 6f write position o 0ba0: 66 20 74 68 65 20 57 41 4c 20 62 61 63 6b 20 74 f the WAL back t 0bb0: 6f 20 69 46 72 61 6d 65 2e 20 20 43 61 6c 6c 65 o iFrame. Calle 0bc0: 64 20 69 6e 0a 2a 2a 20 72 65 73 70 6f 6e 73 65 d in.** response 0bd0: 20 74 6f 20 61 20 52 4f 4c 4c 42 41 43 4b 20 54 to a ROLLBACK T 0be0: 4f 20 63 6f 6d 6d 61 6e 64 2e 20 2a 2f 0a 69 6e O command. */.in 0bf0: 74 20 73 71 6c 69 74 65 33 57 61 6c 53 61 76 65 t sqlite3WalSave 0c00: 70 6f 69 6e 74 55 6e 64 6f 28 57 61 6c 20 2a 70 pointUndo(Wal *p 0c10: 57 61 6c 2c 20 75 33 32 20 2a 61 57 61 6c 44 61 Wal, u32 *aWalDa 0c20: 74 61 29 3b 0a 0a 2f 2a 20 57 72 69 74 65 20 61 ta);../* Write a 0c30: 20 66 72 61 6d 65 20 6f 72 20 66 72 61 6d 65 73 frame or frames 0c40: 20 74 6f 20 74 68 65 20 6c 6f 67 2e 20 2a 2f 0a to the log. */. 0c50: 69 6e 74 20 73 71 6c 69 74 65 33 57 61 6c 46 72 int sqlite3WalFr 0c60: 61 6d 65 73 28 57 61 6c 20 2a 70 57 61 6c 2c 20 ames(Wal *pWal, 0c70: 69 6e 74 2c 20 50 67 48 64 72 20 2a 2c 20 50 67 int, PgHdr *, Pg 0c80: 6e 6f 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 0a no, int, int);.. 0c90: 2f 2a 20 43 6f 70 79 20 70 61 67 65 73 20 66 72 /* Copy pages fr 0ca0: 6f 6d 20 74 68 65 20 6c 6f 67 20 74 6f 20 74 68 om the log to th 0cb0: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file 0cc0: 2a 2f 20 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 */ .int sqlite3W 0cd0: 61 6c 43 68 65 63 6b 70 6f 69 6e 74 28 0a 20 20 alCheckpoint(. 0ce0: 57 61 6c 20 2a 70 57 61 6c 2c 20 20 20 20 20 20 Wal *pWal, 0cf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0d00: 2f 2a 20 57 72 69 74 65 2d 61 68 65 61 64 20 6c /* Write-ahead l 0d10: 6f 67 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f og connection */ 0d20: 0a 20 20 69 6e 74 20 73 79 6e 63 5f 66 6c 61 67 . int sync_flag 0d30: 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 s, 0d40: 20 20 20 2f 2a 20 46 6c 61 67 73 20 74 6f 20 73 /* Flags to s 0d50: 79 6e 63 20 64 62 20 66 69 6c 65 20 77 69 74 68 ync db file with 0d60: 20 28 6f 72 20 30 29 20 2a 2f 0a 20 20 69 6e 74 (or 0) */. int 0d70: 20 6e 42 75 66 2c 20 20 20 20 20 20 20 20 20 20 nBuf, 0d80: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /* 0d90: 53 69 7a 65 20 6f 66 20 62 75 66 66 65 72 20 6e Size of buffer n 0da0: 42 75 66 20 2a 2f 0a 20 20 75 38 20 2a 7a 42 75 Buf */. u8 *zBu 0db0: 66 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 f 0dc0: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 65 6d 70 /* Temp 0dd0: 6f 72 61 72 79 20 62 75 66 66 65 72 20 74 6f 20 orary buffer to 0de0: 75 73 65 20 2a 2f 0a 29 3b 0a 0a 2f 2a 20 52 65 use */.);../* Re 0df0: 74 75 72 6e 20 74 68 65 20 76 61 6c 75 65 20 74 turn the value t 0e00: 6f 20 70 61 73 73 20 74 6f 20 61 20 73 71 6c 69 o pass to a sqli 0e10: 74 65 33 5f 77 61 6c 5f 68 6f 6f 6b 20 63 61 6c te3_wal_hook cal 0e20: 6c 62 61 63 6b 2c 20 74 68 65 0a 2a 2a 20 6e 75 lback, the.** nu 0e30: 6d 62 65 72 20 6f 66 20 66 72 61 6d 65 73 20 69 mber of frames i 0e40: 6e 20 74 68 65 20 57 41 4c 20 61 74 20 74 68 65 n the WAL at the 0e50: 20 70 6f 69 6e 74 20 6f 66 20 74 68 65 20 6c 61 point of the la 0e60: 73 74 20 63 6f 6d 6d 69 74 20 73 69 6e 63 65 0a st commit since. 0e70: 2a 2a 20 73 71 6c 69 74 65 33 57 61 6c 43 61 6c ** sqlite3WalCal 0e80: 6c 62 61 63 6b 28 29 20 77 61 73 20 63 61 6c 6c lback() was call 0e90: 65 64 2e 20 20 49 66 20 6e 6f 20 63 6f 6d 6d 69 ed. If no commi 0ea0: 74 73 20 68 61 76 65 20 6f 63 63 75 72 72 65 64 ts have occurred 0eb0: 20 73 69 6e 63 65 0a 2a 2a 20 74 68 65 20 6c 61 since.** the la 0ec0: 73 74 20 63 61 6c 6c 2c 20 74 68 65 6e 20 72 65 st call, then re 0ed0: 74 75 72 6e 20 30 2e 0a 2a 2f 0a 69 6e 74 20 73 turn 0..*/.int s 0ee0: 71 6c 69 74 65 33 57 61 6c 43 61 6c 6c 62 61 63 qlite3WalCallbac 0ef0: 6b 28 57 61 6c 20 2a 70 57 61 6c 29 3b 0a 0a 2f k(Wal *pWal);../ 0f00: 2a 20 54 65 6c 6c 20 74 68 65 20 77 61 6c 20 6c * Tell the wal l 0f10: 61 79 65 72 20 74 68 61 74 20 61 6e 20 45 58 43 ayer that an EXC 0f20: 4c 55 53 49 56 45 20 6c 6f 63 6b 20 68 61 73 20 LUSIVE lock has 0f30: 62 65 65 6e 20 6f 62 74 61 69 6e 65 64 20 28 6f been obtained (o 0f40: 72 20 72 65 6c 65 61 73 65 64 29 0a 2a 2a 20 62 r released).** b 0f50: 79 20 74 68 65 20 70 61 67 65 72 20 6c 61 79 65 y the pager laye 0f60: 72 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 r on the databas 0f70: 65 20 66 69 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 e file..*/.int s 0f80: 71 6c 69 74 65 33 57 61 6c 45 78 63 6c 75 73 69 qlite3WalExclusi 0f90: 76 65 4d 6f 64 65 28 57 61 6c 20 2a 70 57 61 6c veMode(Wal *pWal 0fa0: 2c 20 69 6e 74 20 6f 70 29 3b 0a 0a 2f 2a 20 52 , int op);../* R 0fb0: 65 74 75 72 6e 20 74 72 75 65 20 69 66 20 74 68 eturn true if th 0fc0: 65 20 61 72 67 75 6d 65 6e 74 20 69 73 20 6e 6f e argument is no 0fd0: 6e 2d 4e 55 4c 4c 20 61 6e 64 20 74 68 65 20 57 n-NULL and the W 0fe0: 41 4c 20 6d 6f 64 75 6c 65 20 69 73 20 75 73 69 AL module is usi 0ff0: 6e 67 0a 2a 2a 20 68 65 61 70 2d 6d 65 6d 6f 72 ng.** heap-memor 1000: 79 20 66 6f 72 20 74 68 65 20 77 61 6c 2d 69 6e y for the wal-in 1010: 64 65 78 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 dex. Otherwise, 1020: 69 66 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 if the argument 1030: 69 73 20 4e 55 4c 4c 20 6f 72 20 74 68 65 0a 2a is NULL or the.* 1040: 2a 20 57 41 4c 20 6d 6f 64 75 6c 65 20 69 73 20 * WAL module is 1050: 75 73 69 6e 67 20 73 68 61 72 65 64 2d 6d 65 6d using shared-mem 1060: 6f 72 79 2c 20 72 65 74 75 72 6e 20 66 61 6c 73 ory, return fals 1070: 65 2e 20 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 e. .*/.int sqlit 1080: 65 33 57 61 6c 48 65 61 70 4d 65 6d 6f 72 79 28 e3WalHeapMemory( 1090: 57 61 6c 20 2a 70 57 61 6c 29 3b 0a 0a 23 65 6e Wal *pWal);..#en 10a0: 64 69 66 20 2f 2a 20 69 66 6e 64 65 66 20 53 51 dif /* ifndef SQ 10b0: 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 20 2a 2f LITE_OMIT_WAL */ 10c0: 0a 23 65 6e 64 69 66 20 2f 2a 20 5f 57 41 4c 5f .#endif /* _WAL_ 10d0: 48 5f 20 2a 2f 0a H_ */.