0000: 2f 2a 0a 2a 2a 20 32 30 30 38 20 4f 63 74 6f 62 /*.** 2008 Octob
0010: 65 72 20 37 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 er 7.**.** The a
0020: 75 74 68 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 uthor disclaims
0030: 63 6f 70 79 72 69 67 68 74 20 74 6f 20 74 68 69 copyright to thi
0040: 73 20 73 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 s source code.
0050: 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 In place of.** a
0060: 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 legal notice, h
0070: 65 72 65 20 69 73 20 61 20 62 6c 65 73 73 69 6e ere is a blessin
0080: 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 g:.**.** May
0090: 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 you do good and
00a0: 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 not evil..**
00b0: 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 May you find for
00c0: 67 69 76 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 giveness for you
00d0: 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 rself and forgiv
00e0: 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 e others..**
00f0: 4d 61 79 20 79 6f 75 20 73 68 61 72 65 20 66 72 May you share fr
0100: 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 eely, never taki
0110: 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 ng more than you
0120: 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 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 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 ***.**.** This f
0180: 69 6c 65 20 63 6f 6e 74 61 69 6e 73 20 63 6f 64 ile contains cod
0190: 65 20 75 73 65 20 74 6f 20 69 6d 70 6c 65 6d 65 e use to impleme
01a0: 6e 74 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 nt an in-memory
01b0: 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c rollback journal
01c0: 2e 0a 2a 2a 20 54 68 65 20 69 6e 2d 6d 65 6d 6f ..** The in-memo
01d0: 72 79 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 ry rollback jour
01e0: 6e 61 6c 20 69 73 20 75 73 65 64 20 74 6f 20 6a nal is used to j
01f0: 6f 75 72 6e 61 6c 20 74 72 61 6e 73 61 63 74 69 ournal transacti
0200: 6f 6e 73 20 66 6f 72 0a 2a 2a 20 22 3a 6d 65 6d ons for.** ":mem
0210: 6f 72 79 3a 22 20 64 61 74 61 62 61 73 65 73 20 ory:" databases
0220: 61 6e 64 20 77 68 65 6e 20 74 68 65 20 6a 6f 75 and when the jou
0230: 72 6e 61 6c 5f 6d 6f 64 65 3d 4d 45 4d 4f 52 59 rnal_mode=MEMORY
0240: 20 70 72 61 67 6d 61 20 69 73 20 75 73 65 64 2e pragma is used.
0250: 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 .*/.#include "sq
0260: 6c 69 74 65 49 6e 74 2e 68 22 0a 0a 2f 2a 20 46 liteInt.h"../* F
0270: 6f 72 77 61 72 64 20 72 65 66 65 72 65 6e 63 65 orward reference
0280: 73 20 74 6f 20 69 6e 74 65 72 6e 61 6c 20 73 74 s to internal st
0290: 72 75 63 74 75 72 65 73 20 2a 2f 0a 74 79 70 65 ructures */.type
02a0: 64 65 66 20 73 74 72 75 63 74 20 4d 65 6d 4a 6f def struct MemJo
02b0: 75 72 6e 61 6c 20 4d 65 6d 4a 6f 75 72 6e 61 6c urnal MemJournal
02c0: 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 ;.typedef struct
02d0: 20 46 69 6c 65 50 6f 69 6e 74 20 46 69 6c 65 50 FilePoint FileP
02e0: 6f 69 6e 74 3b 0a 74 79 70 65 64 65 66 20 73 74 oint;.typedef st
02f0: 72 75 63 74 20 46 69 6c 65 43 68 75 6e 6b 20 46 ruct FileChunk F
0300: 69 6c 65 43 68 75 6e 6b 3b 0a 0a 2f 2a 0a 2a 2a ileChunk;../*.**
0310: 20 54 68 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f The rollback jo
0320: 75 72 6e 61 6c 20 69 73 20 63 6f 6d 70 6f 73 65 urnal is compose
0330: 64 20 6f 66 20 61 20 6c 69 6e 6b 65 64 20 6c 69 d of a linked li
0340: 73 74 20 6f 66 20 74 68 65 73 65 20 73 74 72 75 st of these stru
0350: 63 74 75 72 65 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 ctures..**.** Th
0360: 65 20 7a 43 68 75 6e 6b 20 61 72 72 61 79 20 69 e zChunk array i
0370: 73 20 61 6c 77 61 79 73 20 61 74 20 6c 65 61 73 s always at leas
0380: 74 20 38 20 62 79 74 65 73 20 69 6e 20 73 69 7a t 8 bytes in siz
0390: 65 20 2d 20 75 73 75 61 6c 6c 79 20 6d 75 63 68 e - usually much
03a0: 20 6d 6f 72 65 2e 0a 2a 2a 20 49 74 73 20 61 63 more..** Its ac
03b0: 74 75 61 6c 20 73 69 7a 65 20 69 73 20 73 74 6f tual size is sto
03c0: 72 65 64 20 69 6e 20 74 68 65 20 4d 65 6d 4a 6f red in the MemJo
03d0: 75 72 6e 61 6c 2e 6e 43 68 75 6e 6b 53 69 7a 65 urnal.nChunkSize
03e0: 20 76 61 72 69 61 62 6c 65 2e 0a 2a 2f 0a 73 74 variable..*/.st
03f0: 72 75 63 74 20 46 69 6c 65 43 68 75 6e 6b 20 7b ruct FileChunk {
0400: 0a 20 20 46 69 6c 65 43 68 75 6e 6b 20 2a 70 4e . FileChunk *pN
0410: 65 78 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 ext;
0420: 20 20 20 2f 2a 20 4e 65 78 74 20 63 68 75 6e 6b /* Next chunk
0430: 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 in the journal
0440: 2a 2f 0a 20 20 75 38 20 7a 43 68 75 6e 6b 5b 38 */. u8 zChunk[8
0450: 5d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ];
0460: 20 20 20 20 20 2f 2a 20 43 6f 6e 74 65 6e 74 20 /* Content
0470: 6f 66 20 74 68 69 73 20 63 68 75 6e 6b 20 2a 2f of this chunk */
0480: 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 42 79 20 64 65 .};../*.** By de
0490: 66 61 75 6c 74 2c 20 61 6c 6c 6f 63 61 74 65 20 fault, allocate
04a0: 74 68 69 73 20 6d 61 6e 79 20 62 79 74 65 73 20 this many bytes
04b0: 6f 66 20 6d 65 6d 6f 72 79 20 66 6f 72 20 65 61 of memory for ea
04c0: 63 68 20 46 69 6c 65 43 68 75 6e 6b 20 6f 62 6a ch FileChunk obj
04d0: 65 63 74 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 ect..*/.#define
04e0: 4d 45 4d 4a 4f 55 52 4e 41 4c 5f 44 46 4c 54 5f MEMJOURNAL_DFLT_
04f0: 46 49 4c 45 43 48 55 4e 4b 53 49 5a 45 20 31 30 FILECHUNKSIZE 10
0500: 32 34 0a 0a 2f 2a 0a 2a 2a 20 46 6f 72 20 63 68 24../*.** For ch
0510: 75 6e 6b 20 73 69 7a 65 20 6e 43 68 75 6e 6b 53 unk size nChunkS
0520: 69 7a 65 2c 20 72 65 74 75 72 6e 20 74 68 65 20 ize, return the
0530: 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 number of bytes
0540: 74 68 61 74 20 73 68 6f 75 6c 64 0a 2a 2a 20 62 that should.** b
0550: 65 20 61 6c 6c 6f 63 61 74 65 64 20 66 6f 72 20 e allocated for
0560: 65 61 63 68 20 46 69 6c 65 43 68 75 6e 6b 20 73 each FileChunk s
0570: 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 23 64 65 tructure..*/.#de
0580: 66 69 6e 65 20 66 69 6c 65 43 68 75 6e 6b 53 69 fine fileChunkSi
0590: 7a 65 28 6e 43 68 75 6e 6b 53 69 7a 65 29 20 28 ze(nChunkSize) (
05a0: 73 69 7a 65 6f 66 28 46 69 6c 65 43 68 75 6e 6b sizeof(FileChunk
05b0: 29 20 2b 20 28 28 6e 43 68 75 6e 6b 53 69 7a 65 ) + ((nChunkSize
05c0: 29 2d 38 29 29 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 )-8))../*.** An
05d0: 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 73 instance of this
05e0: 20 6f 62 6a 65 63 74 20 73 65 72 76 65 73 20 61 object serves a
05f0: 73 20 61 20 63 75 72 73 6f 72 20 69 6e 74 6f 20 s a cursor into
0600: 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 the rollback jou
0610: 72 6e 61 6c 2e 0a 2a 2a 20 54 68 65 20 63 75 72 rnal..** The cur
0620: 73 6f 72 20 63 61 6e 20 62 65 20 65 69 74 68 65 sor can be eithe
0630: 72 20 66 6f 72 20 72 65 61 64 69 6e 67 20 6f 72 r for reading or
0640: 20 77 72 69 74 69 6e 67 2e 0a 2a 2f 0a 73 74 72 writing..*/.str
0650: 75 63 74 20 46 69 6c 65 50 6f 69 6e 74 20 7b 0a uct FilePoint {.
0660: 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 sqlite3_int64
0670: 69 4f 66 66 73 65 74 3b 20 20 20 20 20 20 20 20 iOffset;
0680: 20 20 2f 2a 20 4f 66 66 73 65 74 20 66 72 6f 6d /* Offset from
0690: 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f the beginning o
06a0: 66 20 74 68 65 20 66 69 6c 65 20 2a 2f 0a 20 20 f the file */.
06b0: 46 69 6c 65 43 68 75 6e 6b 20 2a 70 43 68 75 6e FileChunk *pChun
06c0: 6b 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 k;
06d0: 2f 2a 20 53 70 65 63 69 66 69 63 20 63 68 75 6e /* Specific chun
06e0: 6b 20 69 6e 74 6f 20 77 68 69 63 68 20 63 75 72 k into which cur
06f0: 73 6f 72 20 70 6f 69 6e 74 73 20 2a 2f 0a 7d 3b sor points */.};
0700: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 73 74 72 ../*.** This str
0710: 75 63 74 75 72 65 20 69 73 20 61 20 73 75 62 63 ucture is a subc
0720: 6c 61 73 73 20 6f 66 20 73 71 6c 69 74 65 33 5f lass of sqlite3_
0730: 66 69 6c 65 2e 20 45 61 63 68 20 6f 70 65 6e 20 file. Each open
0740: 6d 65 6d 6f 72 79 2d 6a 6f 75 72 6e 61 6c 0a 2a memory-journal.*
0750: 2a 20 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 * is an instance
0760: 20 6f 66 20 74 68 69 73 20 63 6c 61 73 73 2e 0a of this class..
0770: 2a 2f 0a 73 74 72 75 63 74 20 4d 65 6d 4a 6f 75 */.struct MemJou
0780: 72 6e 61 6c 20 7b 0a 20 20 63 6f 6e 73 74 20 73 rnal {. const s
0790: 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 qlite3_io_method
07a0: 73 20 2a 70 4d 65 74 68 6f 64 3b 20 2f 2a 20 50 s *pMethod; /* P
07b0: 61 72 65 6e 74 20 63 6c 61 73 73 2e 20 4d 55 53 arent class. MUS
07c0: 54 20 42 45 20 46 49 52 53 54 20 2a 2f 0a 20 20 T BE FIRST */.
07d0: 69 6e 74 20 6e 43 68 75 6e 6b 53 69 7a 65 3b 20 int nChunkSize;
07e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
07f0: 2f 2a 20 49 6e 2d 6d 65 6d 6f 72 79 20 63 68 75 /* In-memory chu
0800: 6e 6b 2d 73 69 7a 65 20 2a 2f 0a 0a 20 20 69 6e nk-size */.. in
0810: 74 20 6e 42 75 66 3b 20 20 20 20 20 20 20 20 20 t nBuf;
0820: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
0830: 20 42 79 74 65 73 20 6f 66 20 64 61 74 61 20 62 Bytes of data b
0840: 65 66 6f 72 65 20 66 6c 75 73 68 69 6e 67 20 2a efore flushing *
0850: 2f 0a 20 20 69 6e 74 20 6e 53 69 7a 65 3b 20 20 /. int nSize;
0860: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0870: 20 20 20 20 2f 2a 20 42 79 74 65 73 20 6f 66 20 /* Bytes of
0880: 64 61 74 61 20 63 75 72 72 65 6e 74 6c 79 20 69 data currently i
0890: 6e 20 6d 65 6d 6f 72 79 20 2a 2f 0a 20 20 46 69 n memory */. Fi
08a0: 6c 65 43 68 75 6e 6b 20 2a 70 46 69 72 73 74 3b leChunk *pFirst;
08b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
08c0: 20 48 65 61 64 20 6f 66 20 69 6e 2d 6d 65 6d 6f Head of in-memo
08d0: 72 79 20 63 68 75 6e 6b 2d 6c 69 73 74 20 2a 2f ry chunk-list */
08e0: 0a 20 20 46 69 6c 65 50 6f 69 6e 74 20 65 6e 64 . FilePoint end
08f0: 70 6f 69 6e 74 3b 20 20 20 20 20 20 20 20 20 20 point;
0900: 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f /* Pointer to
0910: 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 the end of the
0920: 66 69 6c 65 20 2a 2f 0a 20 20 46 69 6c 65 50 6f file */. FilePo
0930: 69 6e 74 20 72 65 61 64 70 6f 69 6e 74 3b 20 20 int readpoint;
0940: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 /* Poi
0950: 6e 74 65 72 20 74 6f 20 74 68 65 20 65 6e 64 20 nter to the end
0960: 6f 66 20 74 68 65 20 6c 61 73 74 20 78 52 65 61 of the last xRea
0970: 64 28 29 20 2a 2f 0a 0a 20 20 69 6e 74 20 66 6c d() */.. int fl
0980: 61 67 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 ags;
0990: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 4f 70 /* xOp
09a0: 65 6e 20 66 6c 61 67 73 20 2a 2f 0a 20 20 73 71 en flags */. sq
09b0: 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73 3b lite3_vfs *pVfs;
09c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
09d0: 20 54 68 65 20 22 72 65 61 6c 22 20 75 6e 64 65 The "real" unde
09e0: 72 6c 79 69 6e 67 20 56 46 53 20 2a 2f 0a 20 20 rlying VFS */.
09f0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4a 6f 75 const char *zJou
0a00: 72 6e 61 6c 3b 20 20 20 20 20 20 20 20 20 20 20 rnal;
0a10: 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 6a /* Name of the j
0a20: 6f 75 72 6e 61 6c 20 66 69 6c 65 20 2a 2f 0a 20 ournal file */.
0a30: 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 sqlite3_file *p
0a40: 52 65 61 6c 3b 20 20 20 20 20 20 20 20 20 20 20 Real;
0a50: 20 2f 2a 20 54 68 65 20 22 72 65 61 6c 22 20 75 /* The "real" u
0a60: 6e 64 65 72 6c 79 69 6e 67 20 66 69 6c 65 20 64 nderlying file d
0a70: 65 73 63 72 69 70 74 6f 72 20 2a 2f 0a 7d 3b 0a escriptor */.};.
0a80: 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20 64 61 74 61 ./*.** Read data
0a90: 20 66 72 6f 6d 20 74 68 65 20 69 6e 2d 6d 65 6d from the in-mem
0aa0: 6f 72 79 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 ory journal file
0ab0: 2e 20 20 54 68 69 73 20 69 73 20 74 68 65 20 69 . This is the i
0ac0: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 0a 2a 2a mplementation.**
0ad0: 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f of the sqlite3_
0ae0: 76 66 73 2e 78 52 65 61 64 20 6d 65 74 68 6f 64 vfs.xRead method
0af0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
0b00: 6d 65 6d 6a 72 6e 6c 52 65 61 64 28 0a 20 20 73 memjrnlRead(. s
0b10: 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 4a 66 qlite3_file *pJf
0b20: 64 2c 20 20 20 20 2f 2a 20 54 68 65 20 6a 6f 75 d, /* The jou
0b30: 72 6e 61 6c 20 66 69 6c 65 20 66 72 6f 6d 20 77 rnal file from w
0b40: 68 69 63 68 20 74 6f 20 72 65 61 64 20 2a 2f 0a hich to read */.
0b50: 20 20 76 6f 69 64 20 2a 7a 42 75 66 2c 20 20 20 void *zBuf,
0b60: 20 20 20 20 20 20 20 20 20 2f 2a 20 50 75 74 20 /* Put
0b70: 74 68 65 20 72 65 73 75 6c 74 73 20 68 65 72 65 the results here
0b80: 20 2a 2f 0a 20 20 69 6e 74 20 69 41 6d 74 2c 20 */. int iAmt,
0b90: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
0ba0: 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 Number of bytes
0bb0: 74 6f 20 72 65 61 64 20 2a 2f 0a 20 20 73 71 6c to read */. sql
0bc0: 69 74 65 5f 69 6e 74 36 34 20 69 4f 66 73 74 20 ite_int64 iOfst
0bd0: 20 20 20 20 2f 2a 20 42 65 67 69 6e 20 72 65 61 /* Begin rea
0be0: 64 69 6e 67 20 61 74 20 74 68 69 73 20 6f 66 66 ding at this off
0bf0: 73 65 74 20 2a 2f 0a 29 7b 0a 20 20 4d 65 6d 4a set */.){. MemJ
0c00: 6f 75 72 6e 61 6c 20 2a 70 20 3d 20 28 4d 65 6d ournal *p = (Mem
0c10: 4a 6f 75 72 6e 61 6c 20 2a 29 70 4a 66 64 3b 0a Journal *)pJfd;.
0c20: 20 20 69 66 28 20 70 2d 3e 70 52 65 61 6c 20 29 if( p->pReal )
0c30: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 73 71 6c {. return sql
0c40: 69 74 65 33 4f 73 52 65 61 64 28 70 2d 3e 70 52 ite3OsRead(p->pR
0c50: 65 61 6c 2c 20 7a 42 75 66 2c 20 69 41 6d 74 2c eal, zBuf, iAmt,
0c60: 20 69 4f 66 73 74 29 3b 0a 20 20 7d 65 6c 73 65 iOfst);. }else
0c70: 20 69 66 28 20 28 69 41 6d 74 2b 69 4f 66 73 74 if( (iAmt+iOfst
0c80: 29 3e 70 2d 3e 65 6e 64 70 6f 69 6e 74 2e 69 4f )>p->endpoint.iO
0c90: 66 66 73 65 74 20 29 7b 0a 20 20 20 20 72 65 74 ffset ){. ret
0ca0: 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 urn SQLITE_IOERR
0cb0: 5f 53 48 4f 52 54 5f 52 45 41 44 3b 0a 20 20 7d _SHORT_READ;. }
0cc0: 65 6c 73 65 7b 0a 20 20 20 20 75 38 20 2a 7a 4f else{. u8 *zO
0cd0: 75 74 20 3d 20 7a 42 75 66 3b 0a 20 20 20 20 69 ut = zBuf;. i
0ce0: 6e 74 20 6e 52 65 61 64 20 3d 20 69 41 6d 74 3b nt nRead = iAmt;
0cf0: 0a 20 20 20 20 69 6e 74 20 69 43 68 75 6e 6b 4f . int iChunkO
0d00: 66 66 73 65 74 3b 0a 20 20 20 20 46 69 6c 65 43 ffset;. FileC
0d10: 68 75 6e 6b 20 2a 70 43 68 75 6e 6b 3b 0a 0a 20 hunk *pChunk;..
0d20: 20 20 20 69 66 28 20 70 2d 3e 72 65 61 64 70 6f if( p->readpo
0d30: 69 6e 74 2e 69 4f 66 66 73 65 74 21 3d 69 4f 66 int.iOffset!=iOf
0d40: 73 74 20 7c 7c 20 69 4f 66 73 74 3d 3d 30 20 29 st || iOfst==0 )
0d50: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f {. sqlite3_
0d60: 69 6e 74 36 34 20 69 4f 66 66 20 3d 20 30 3b 0a int64 iOff = 0;.
0d70: 20 20 20 20 20 20 66 6f 72 28 70 43 68 75 6e 6b for(pChunk
0d80: 3d 70 2d 3e 70 46 69 72 73 74 3b 20 0a 20 20 20 =p->pFirst; .
0d90: 20 20 20 20 20 20 20 41 4c 57 41 59 53 28 70 43 ALWAYS(pC
0da0: 68 75 6e 6b 29 20 26 26 20 28 69 4f 66 66 2b 70 hunk) && (iOff+p
0db0: 2d 3e 6e 43 68 75 6e 6b 53 69 7a 65 29 3c 3d 69 ->nChunkSize)<=i
0dc0: 4f 66 73 74 3b 0a 20 20 20 20 20 20 20 20 20 20 Ofst;.
0dd0: 70 43 68 75 6e 6b 3d 70 43 68 75 6e 6b 2d 3e 70 pChunk=pChunk->p
0de0: 4e 65 78 74 0a 20 20 20 20 20 20 29 7b 0a 20 20 Next. ){.
0df0: 20 20 20 20 20 20 69 4f 66 66 20 2b 3d 20 70 2d iOff += p-
0e00: 3e 6e 43 68 75 6e 6b 53 69 7a 65 3b 0a 20 20 20 >nChunkSize;.
0e10: 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a }. }else{.
0e20: 20 20 20 20 20 20 70 43 68 75 6e 6b 20 3d 20 70 pChunk = p
0e30: 2d 3e 72 65 61 64 70 6f 69 6e 74 2e 70 43 68 75 ->readpoint.pChu
0e40: 6e 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 nk;. }.. i
0e50: 43 68 75 6e 6b 4f 66 66 73 65 74 20 3d 20 28 69 ChunkOffset = (i
0e60: 6e 74 29 28 69 4f 66 73 74 25 70 2d 3e 6e 43 68 nt)(iOfst%p->nCh
0e70: 75 6e 6b 53 69 7a 65 29 3b 0a 20 20 20 20 64 6f unkSize);. do
0e80: 20 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 53 70 {. int iSp
0e90: 61 63 65 20 3d 20 70 2d 3e 6e 43 68 75 6e 6b 53 ace = p->nChunkS
0ea0: 69 7a 65 20 2d 20 69 43 68 75 6e 6b 4f 66 66 73 ize - iChunkOffs
0eb0: 65 74 3b 0a 20 20 20 20 20 20 69 6e 74 20 6e 43 et;. int nC
0ec0: 6f 70 79 20 3d 20 4d 49 4e 28 6e 52 65 61 64 2c opy = MIN(nRead,
0ed0: 20 28 70 2d 3e 6e 43 68 75 6e 6b 53 69 7a 65 20 (p->nChunkSize
0ee0: 2d 20 69 43 68 75 6e 6b 4f 66 66 73 65 74 29 29 - iChunkOffset))
0ef0: 3b 0a 20 20 20 20 20 20 6d 65 6d 63 70 79 28 7a ;. memcpy(z
0f00: 4f 75 74 2c 20 26 70 43 68 75 6e 6b 2d 3e 7a 43 Out, &pChunk->zC
0f10: 68 75 6e 6b 5b 69 43 68 75 6e 6b 4f 66 66 73 65 hunk[iChunkOffse
0f20: 74 5d 2c 20 6e 43 6f 70 79 29 3b 0a 20 20 20 20 t], nCopy);.
0f30: 20 20 7a 4f 75 74 20 2b 3d 20 6e 43 6f 70 79 3b zOut += nCopy;
0f40: 0a 20 20 20 20 20 20 6e 52 65 61 64 20 2d 3d 20 . nRead -=
0f50: 69 53 70 61 63 65 3b 0a 20 20 20 20 20 20 69 43 iSpace;. iC
0f60: 68 75 6e 6b 4f 66 66 73 65 74 20 3d 20 30 3b 0a hunkOffset = 0;.
0f70: 20 20 20 20 7d 20 77 68 69 6c 65 28 20 6e 52 65 } while( nRe
0f80: 61 64 3e 3d 30 20 26 26 20 28 70 43 68 75 6e 6b ad>=0 && (pChunk
0f90: 3d 70 43 68 75 6e 6b 2d 3e 70 4e 65 78 74 29 21 =pChunk->pNext)!
0fa0: 3d 30 20 26 26 20 6e 52 65 61 64 3e 30 20 29 3b =0 && nRead>0 );
0fb0: 0a 20 20 20 20 70 2d 3e 72 65 61 64 70 6f 69 6e . p->readpoin
0fc0: 74 2e 69 4f 66 66 73 65 74 20 3d 20 69 4f 66 73 t.iOffset = iOfs
0fd0: 74 2b 69 41 6d 74 3b 0a 20 20 20 20 70 2d 3e 72 t+iAmt;. p->r
0fe0: 65 61 64 70 6f 69 6e 74 2e 70 43 68 75 6e 6b 20 eadpoint.pChunk
0ff0: 3d 20 70 43 68 75 6e 6b 3b 0a 20 20 7d 0a 0a 20 = pChunk;. }..
1000: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
1010: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 K;.}../*.** Free
1020: 20 74 68 65 20 6c 69 73 74 20 6f 66 20 46 69 6c the list of Fil
1030: 65 43 68 75 6e 6b 20 73 74 72 75 63 74 75 72 65 eChunk structure
1040: 73 20 68 65 61 64 65 64 20 61 74 20 4d 65 6d 4a s headed at MemJ
1050: 6f 75 72 6e 61 6c 2e 70 46 69 72 73 74 2e 0a 2a ournal.pFirst..*
1060: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 6d 65 /.static void me
1070: 6d 6a 72 6e 6c 46 72 65 65 43 68 75 6e 6b 73 28 mjrnlFreeChunks(
1080: 4d 65 6d 4a 6f 75 72 6e 61 6c 20 2a 70 29 7b 0a MemJournal *p){.
1090: 20 20 46 69 6c 65 43 68 75 6e 6b 20 2a 70 49 74 FileChunk *pIt
10a0: 65 72 3b 0a 20 20 46 69 6c 65 43 68 75 6e 6b 20 er;. FileChunk
10b0: 2a 70 4e 65 78 74 3b 0a 20 20 66 6f 72 28 70 49 *pNext;. for(pI
10c0: 74 65 72 3d 70 2d 3e 70 46 69 72 73 74 3b 20 70 ter=p->pFirst; p
10d0: 49 74 65 72 3b 20 70 49 74 65 72 3d 70 4e 65 78 Iter; pIter=pNex
10e0: 74 29 7b 0a 20 20 20 20 70 4e 65 78 74 20 3d 20 t){. pNext =
10f0: 70 49 74 65 72 2d 3e 70 4e 65 78 74 3b 0a 20 20 pIter->pNext;.
1100: 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 sqlite3_free(p
1110: 49 74 65 72 29 3b 0a 20 20 7d 20 0a 20 20 70 2d Iter);. } . p-
1120: 3e 70 46 69 72 73 74 20 3d 20 30 3b 0a 7d 0a 0a >pFirst = 0;.}..
1130: 2f 2a 0a 2a 2a 20 46 6c 75 73 68 20 74 68 65 20 /*.** Flush the
1140: 63 6f 6e 74 65 6e 74 73 20 6f 66 20 6d 65 6d 6f contents of memo
1150: 72 79 20 74 6f 20 61 20 72 65 61 6c 20 66 69 6c ry to a real fil
1160: 65 20 6f 6e 20 64 69 73 6b 2e 0a 2a 2f 0a 73 74 e on disk..*/.st
1170: 61 74 69 63 20 69 6e 74 20 63 72 65 61 74 65 46 atic int createF
1180: 69 6c 65 28 4d 65 6d 4a 6f 75 72 6e 61 6c 20 2a ile(MemJournal *
1190: 70 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 p){. int rc = S
11a0: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 QLITE_OK;. if(
11b0: 21 70 2d 3e 70 52 65 61 6c 20 29 7b 0a 20 20 20 !p->pReal ){.
11c0: 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 sqlite3_file *p
11d0: 52 65 61 6c 20 3d 20 28 73 71 6c 69 74 65 33 5f Real = (sqlite3_
11e0: 66 69 6c 65 20 2a 29 26 70 5b 31 5d 3b 0a 20 20 file *)&p[1];.
11f0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
1200: 4f 70 65 6e 28 70 2d 3e 70 56 66 73 2c 20 70 2d Open(p->pVfs, p-
1210: 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 70 52 65 61 6c >zJournal, pReal
1220: 2c 20 70 2d 3e 66 6c 61 67 73 2c 20 30 29 3b 0a , p->flags, 0);.
1230: 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
1240: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69 TE_OK ){. i
1250: 6e 74 20 6e 43 68 75 6e 6b 20 3d 20 70 2d 3e 6e nt nChunk = p->n
1260: 43 68 75 6e 6b 53 69 7a 65 3b 0a 20 20 20 20 20 ChunkSize;.
1270: 20 69 36 34 20 69 4f 66 66 20 3d 20 30 3b 0a 20 i64 iOff = 0;.
1280: 20 20 20 20 20 46 69 6c 65 43 68 75 6e 6b 20 2a FileChunk *
1290: 70 49 74 65 72 3b 0a 20 20 20 20 20 20 70 2d 3e pIter;. p->
12a0: 70 52 65 61 6c 20 3d 20 70 52 65 61 6c 3b 0a 20 pReal = pReal;.
12b0: 20 20 20 20 20 66 6f 72 28 70 49 74 65 72 3d 70 for(pIter=p
12c0: 2d 3e 70 46 69 72 73 74 3b 20 70 49 74 65 72 20 ->pFirst; pIter
12d0: 26 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b && rc==SQLITE_OK
12e0: 3b 20 70 49 74 65 72 3d 70 49 74 65 72 2d 3e 70 ; pIter=pIter->p
12f0: 4e 65 78 74 29 7b 0a 20 20 20 20 20 20 20 20 69 Next){. i
1300: 6e 74 20 6e 57 72 69 74 65 20 3d 20 6e 43 68 75 nt nWrite = nChu
1310: 6e 6b 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 nk;. if(
1320: 70 49 74 65 72 3d 3d 70 2d 3e 65 6e 64 70 6f 69 pIter==p->endpoi
1330: 6e 74 2e 70 43 68 75 6e 6b 20 29 7b 0a 20 20 20 nt.pChunk ){.
1340: 20 20 20 20 20 20 20 6e 57 72 69 74 65 20 3d 20 nWrite =
1350: 70 2d 3e 65 6e 64 70 6f 69 6e 74 2e 69 4f 66 66 p->endpoint.iOff
1360: 73 65 74 20 25 20 70 2d 3e 6e 43 68 75 6e 6b 53 set % p->nChunkS
1370: 69 7a 65 3b 0a 20 20 20 20 20 20 20 20 20 20 69 ize;. i
1380: 66 28 20 6e 57 72 69 74 65 3d 3d 30 20 29 20 6e f( nWrite==0 ) n
1390: 57 72 69 74 65 20 3d 20 70 2d 3e 6e 43 68 75 6e Write = p->nChun
13a0: 6b 53 69 7a 65 3b 0a 20 20 20 20 20 20 20 20 7d kSize;. }
13b0: 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 . rc = sq
13c0: 6c 69 74 65 33 4f 73 57 72 69 74 65 28 70 52 65 lite3OsWrite(pRe
13d0: 61 6c 2c 20 70 49 74 65 72 2d 3e 7a 43 68 75 6e al, pIter->zChun
13e0: 6b 2c 20 6e 57 72 69 74 65 2c 20 69 4f 66 66 29 k, nWrite, iOff)
13f0: 3b 0a 20 20 20 20 20 20 20 20 69 4f 66 66 20 2b ;. iOff +
1400: 3d 20 6e 57 72 69 74 65 3b 0a 20 20 20 20 20 20 = nWrite;.
1410: 7d 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 3d }. if( rc!=
1420: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
1430: 20 20 20 20 20 2f 2a 20 49 66 20 61 6e 20 65 72 /* If an er
1440: 72 6f 72 20 6f 63 63 75 72 72 65 64 20 77 68 69 ror occurred whi
1450: 6c 65 20 77 72 69 74 69 6e 67 20 74 6f 20 74 68 le writing to th
1460: 65 20 66 69 6c 65 2c 20 63 6c 6f 73 65 20 69 74 e file, close it
1470: 20 62 65 66 6f 72 65 0a 20 20 20 20 20 20 20 20 before.
1480: 2a 2a 20 72 65 74 75 72 6e 69 6e 67 2e 20 54 68 ** returning. Th
1490: 69 73 20 77 61 79 2c 20 53 51 4c 69 74 65 20 75 is way, SQLite u
14a0: 73 65 73 20 74 68 65 20 69 6e 2d 6d 65 6d 6f 72 ses the in-memor
14b0: 79 20 6a 6f 75 72 6e 61 6c 20 64 61 74 61 20 74 y journal data t
14c0: 6f 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 72 6f o . ** ro
14d0: 6c 6c 20 62 61 63 6b 20 63 68 61 6e 67 65 73 20 ll back changes
14e0: 6d 61 64 65 20 74 6f 20 74 68 65 20 69 6e 74 65 made to the inte
14f0: 72 6e 61 6c 20 70 61 67 65 2d 63 61 63 68 65 20 rnal page-cache
1500: 62 65 66 6f 72 65 20 74 68 69 73 0a 20 20 20 20 before this.
1510: 20 20 20 20 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 ** function
1520: 77 61 73 20 63 61 6c 6c 65 64 2e 20 20 2a 2f 0a was called. */.
1530: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f sqlite3O
1540: 73 43 6c 6f 73 65 28 70 52 65 61 6c 29 3b 0a 20 sClose(pReal);.
1550: 20 20 20 20 20 20 20 70 2d 3e 70 52 65 61 6c 20 p->pReal
1560: 3d 20 30 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 = 0;. }else
1570: 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 4e 6f 20 {. /* No
1580: 65 72 72 6f 72 20 68 61 73 20 6f 63 63 75 72 72 error has occurr
1590: 65 64 2e 20 46 72 65 65 20 74 68 65 20 69 6e 2d ed. Free the in-
15a0: 6d 65 6d 6f 72 79 20 62 75 66 66 65 72 73 2e 20 memory buffers.
15b0: 2a 2f 0a 20 20 20 20 20 20 20 20 6d 65 6d 6a 72 */. memjr
15c0: 6e 6c 46 72 65 65 43 68 75 6e 6b 73 28 70 29 3b nlFreeChunks(p);
15d0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 . }. }.
15e0: 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a }. return rc;.
15f0: 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 }.../*.** Write
1600: 64 61 74 61 20 74 6f 20 74 68 65 20 66 69 6c 65 data to the file
1610: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
1620: 6d 65 6d 6a 72 6e 6c 57 72 69 74 65 28 0a 20 20 memjrnlWrite(.
1630: 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 4a sqlite3_file *pJ
1640: 66 64 2c 20 20 20 20 2f 2a 20 54 68 65 20 6a 6f fd, /* The jo
1650: 75 72 6e 61 6c 20 66 69 6c 65 20 69 6e 74 6f 20 urnal file into
1660: 77 68 69 63 68 20 74 6f 20 77 72 69 74 65 20 2a which to write *
1670: 2f 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a /. const void *
1680: 7a 42 75 66 2c 20 20 20 20 20 20 2f 2a 20 54 61 zBuf, /* Ta
1690: 6b 65 20 64 61 74 61 20 74 6f 20 62 65 20 77 72 ke data to be wr
16a0: 69 74 74 65 6e 20 66 72 6f 6d 20 68 65 72 65 20 itten from here
16b0: 2a 2f 0a 20 20 69 6e 74 20 69 41 6d 74 2c 20 20 */. int iAmt,
16c0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
16d0: 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 74 umber of bytes t
16e0: 6f 20 77 72 69 74 65 20 2a 2f 0a 20 20 73 71 6c o write */. sql
16f0: 69 74 65 5f 69 6e 74 36 34 20 69 4f 66 73 74 20 ite_int64 iOfst
1700: 20 20 20 20 2f 2a 20 42 65 67 69 6e 20 77 72 69 /* Begin wri
1710: 74 69 6e 67 20 61 74 20 74 68 69 73 20 6f 66 66 ting at this off
1720: 73 65 74 20 69 6e 74 6f 20 74 68 65 20 66 69 6c set into the fil
1730: 65 20 2a 2f 0a 29 7b 0a 20 20 4d 65 6d 4a 6f 75 e */.){. MemJou
1740: 72 6e 61 6c 20 2a 70 20 3d 20 28 4d 65 6d 4a 6f rnal *p = (MemJo
1750: 75 72 6e 61 6c 20 2a 29 70 4a 66 64 3b 0a 20 20 urnal *)pJfd;.
1760: 69 6e 74 20 6e 57 72 69 74 65 20 3d 20 69 41 6d int nWrite = iAm
1770: 74 3b 0a 20 20 75 38 20 2a 7a 57 72 69 74 65 20 t;. u8 *zWrite
1780: 3d 20 28 75 38 20 2a 29 7a 42 75 66 3b 0a 0a 20 = (u8 *)zBuf;..
1790: 20 2f 2a 20 49 66 20 74 68 65 20 66 69 6c 65 20 /* If the file
17a0: 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 65 6e has already been
17b0: 20 63 72 65 61 74 65 64 20 6f 6e 20 64 69 73 6b created on disk
17c0: 2e 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 70 52 . */. if( p->pR
17d0: 65 61 6c 20 29 7b 0a 20 20 20 20 72 65 74 75 72 eal ){. retur
17e0: 6e 20 73 71 6c 69 74 65 33 4f 73 57 72 69 74 65 n sqlite3OsWrite
17f0: 28 70 2d 3e 70 52 65 61 6c 2c 20 7a 42 75 66 2c (p->pReal, zBuf,
1800: 20 69 41 6d 74 2c 20 69 4f 66 73 74 29 3b 0a 20 iAmt, iOfst);.
1810: 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 }.. /* If the
1820: 66 69 6c 65 20 73 68 6f 75 6c 64 20 62 65 20 63 file should be c
1830: 72 65 61 74 65 64 20 6e 6f 77 2e 20 2a 2f 0a 20 reated now. */.
1840: 20 65 6c 73 65 20 69 66 28 20 70 2d 3e 6e 42 75 else if( p->nBu
1850: 66 3e 30 20 26 26 20 28 69 41 6d 74 2b 69 4f 66 f>0 && (iAmt+iOf
1860: 73 74 29 3e 70 2d 3e 6e 42 75 66 20 29 7b 0a 20 st)>p->nBuf ){.
1870: 20 20 20 69 6e 74 20 72 63 20 3d 20 63 72 65 61 int rc = crea
1880: 74 65 46 69 6c 65 28 70 29 3b 0a 20 20 20 20 69 teFile(p);. i
1890: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
18a0: 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 6d ){. rc = m
18b0: 65 6d 6a 72 6e 6c 57 72 69 74 65 28 70 4a 66 64 emjrnlWrite(pJfd
18c0: 2c 20 7a 42 75 66 2c 20 69 41 6d 74 2c 20 69 4f , zBuf, iAmt, iO
18d0: 66 73 74 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 fst);. }.
18e0: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 0a return rc;. }..
18f0: 20 20 2f 2a 20 49 66 20 74 68 65 20 63 6f 6e 74 /* If the cont
1900: 65 6e 74 73 20 6f 66 20 74 68 69 73 20 77 72 69 ents of this wri
1910: 74 65 20 73 68 6f 75 6c 64 20 62 65 20 73 74 6f te should be sto
1920: 72 65 64 20 69 6e 20 6d 65 6d 6f 72 79 20 2a 2f red in memory */
1930: 0a 20 20 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 . else{. /*
1940: 41 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 6a 6f 75 An in-memory jou
1950: 72 6e 61 6c 20 66 69 6c 65 20 73 68 6f 75 6c 64 rnal file should
1960: 20 6f 6e 6c 79 20 65 76 65 72 20 62 65 20 61 70 only ever be ap
1970: 70 65 6e 64 65 64 20 74 6f 2e 20 52 61 6e 64 6f pended to. Rando
1980: 6d 0a 20 20 20 20 2a 2a 20 61 63 63 65 73 73 20 m. ** access
1990: 77 72 69 74 65 73 20 61 72 65 20 6e 6f 74 20 72 writes are not r
19a0: 65 71 75 69 72 65 64 2e 20 54 68 65 20 6f 6e 6c equired. The onl
19b0: 79 20 65 78 63 65 70 74 69 6f 6e 20 74 6f 20 74 y exception to t
19c0: 68 69 73 20 69 73 20 77 68 65 6e 0a 20 20 20 20 his is when.
19d0: 2a 2a 20 74 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 ** the in-memory
19e0: 20 6a 6f 75 72 6e 61 6c 20 69 73 20 62 65 69 6e journal is bein
19f0: 67 20 75 73 65 64 20 62 79 20 61 20 63 6f 6e 6e g used by a conn
1a00: 65 63 74 69 6f 6e 20 75 73 69 6e 67 20 74 68 65 ection using the
1a10: 0a 20 20 20 20 2a 2a 20 61 74 6f 6d 69 63 2d 77 . ** atomic-w
1a20: 72 69 74 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f rite optimizatio
1a30: 6e 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 n. In this case
1a40: 74 68 65 20 66 69 72 73 74 20 32 38 20 62 79 74 the first 28 byt
1a50: 65 73 20 6f 66 20 74 68 65 0a 20 20 20 20 2a 2a es of the. **
1a60: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6d 61 journal file ma
1a70: 79 20 62 65 20 77 72 69 74 74 65 6e 20 61 73 20 y be written as
1a80: 70 61 72 74 20 6f 66 20 63 6f 6d 6d 69 74 74 69 part of committi
1a90: 6e 67 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 ng the transacti
1aa0: 6f 6e 2e 20 2a 2f 20 0a 20 20 20 20 61 73 73 65 on. */ . asse
1ab0: 72 74 28 20 69 4f 66 73 74 3d 3d 70 2d 3e 65 6e rt( iOfst==p->en
1ac0: 64 70 6f 69 6e 74 2e 69 4f 66 66 73 65 74 20 7c dpoint.iOffset |
1ad0: 7c 20 69 4f 66 73 74 3d 3d 30 20 29 3b 0a 20 20 | iOfst==0 );.
1ae0: 20 20 69 66 28 20 69 4f 66 73 74 3d 3d 30 20 26 if( iOfst==0 &
1af0: 26 20 70 2d 3e 70 46 69 72 73 74 20 29 7b 0a 20 & p->pFirst ){.
1b00: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e assert( p->
1b10: 6e 43 68 75 6e 6b 53 69 7a 65 3e 69 41 6d 74 20 nChunkSize>iAmt
1b20: 29 3b 0a 20 20 20 20 20 20 6d 65 6d 63 70 79 28 );. memcpy(
1b30: 70 2d 3e 70 46 69 72 73 74 2d 3e 7a 43 68 75 6e p->pFirst->zChun
1b40: 6b 2c 20 7a 42 75 66 2c 20 69 41 6d 74 29 3b 0a k, zBuf, iAmt);.
1b50: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
1b60: 20 77 68 69 6c 65 28 20 6e 57 72 69 74 65 3e 30 while( nWrite>0
1b70: 20 29 7b 0a 20 20 20 20 20 20 20 20 46 69 6c 65 ){. File
1b80: 43 68 75 6e 6b 20 2a 70 43 68 75 6e 6b 20 3d 20 Chunk *pChunk =
1b90: 70 2d 3e 65 6e 64 70 6f 69 6e 74 2e 70 43 68 75 p->endpoint.pChu
1ba0: 6e 6b 3b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 nk;. int
1bb0: 69 43 68 75 6e 6b 4f 66 66 73 65 74 20 3d 20 28 iChunkOffset = (
1bc0: 69 6e 74 29 28 70 2d 3e 65 6e 64 70 6f 69 6e 74 int)(p->endpoint
1bd0: 2e 69 4f 66 66 73 65 74 25 70 2d 3e 6e 43 68 75 .iOffset%p->nChu
1be0: 6e 6b 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 20 nkSize);.
1bf0: 20 69 6e 74 20 69 53 70 61 63 65 20 3d 20 4d 49 int iSpace = MI
1c00: 4e 28 6e 57 72 69 74 65 2c 20 70 2d 3e 6e 43 68 N(nWrite, p->nCh
1c10: 75 6e 6b 53 69 7a 65 20 2d 20 69 43 68 75 6e 6b unkSize - iChunk
1c20: 4f 66 66 73 65 74 29 3b 0a 0a 20 20 20 20 20 20 Offset);..
1c30: 20 20 69 66 28 20 69 43 68 75 6e 6b 4f 66 66 73 if( iChunkOffs
1c40: 65 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 et==0 ){.
1c50: 20 20 20 2f 2a 20 4e 65 77 20 63 68 75 6e 6b 20 /* New chunk
1c60: 69 73 20 72 65 71 75 69 72 65 64 20 74 6f 20 65 is required to e
1c70: 78 74 65 6e 64 20 74 68 65 20 66 69 6c 65 2e 20 xtend the file.
1c80: 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 46 69 6c */. Fil
1c90: 65 43 68 75 6e 6b 20 2a 70 4e 65 77 20 3d 20 73 eChunk *pNew = s
1ca0: 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 66 69 qlite3_malloc(fi
1cb0: 6c 65 43 68 75 6e 6b 53 69 7a 65 28 70 2d 3e 6e leChunkSize(p->n
1cc0: 43 68 75 6e 6b 53 69 7a 65 29 29 3b 0a 20 20 20 ChunkSize));.
1cd0: 20 20 20 20 20 20 20 69 66 28 20 21 70 4e 65 77 if( !pNew
1ce0: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
1cf0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f return SQLITE_IO
1d00: 45 52 52 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a ERR_NOMEM_BKPT;.
1d10: 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
1d20: 20 20 20 20 20 20 70 4e 65 77 2d 3e 70 4e 65 78 pNew->pNex
1d30: 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 20 t = 0;.
1d40: 20 69 66 28 20 70 43 68 75 6e 6b 20 29 7b 0a 20 if( pChunk ){.
1d50: 20 20 20 20 20 20 20 20 20 20 20 61 73 73 65 72 asser
1d60: 74 28 20 70 2d 3e 70 46 69 72 73 74 20 29 3b 0a t( p->pFirst );.
1d70: 20 20 20 20 20 20 20 20 20 20 20 20 70 43 68 75 pChu
1d80: 6e 6b 2d 3e 70 4e 65 78 74 20 3d 20 70 4e 65 77 nk->pNext = pNew
1d90: 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 65 6c 73 ;. }els
1da0: 65 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 61 e{. a
1db0: 73 73 65 72 74 28 20 21 70 2d 3e 70 46 69 72 73 ssert( !p->pFirs
1dc0: 74 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 t );.
1dd0: 20 70 2d 3e 70 46 69 72 73 74 20 3d 20 70 4e 65 p->pFirst = pNe
1de0: 77 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 w;. }.
1df0: 20 20 20 20 20 20 20 20 20 70 2d 3e 65 6e 64 70 p->endp
1e00: 6f 69 6e 74 2e 70 43 68 75 6e 6b 20 3d 20 70 4e oint.pChunk = pN
1e10: 65 77 3b 0a 20 20 20 20 20 20 20 20 7d 0a 0a 20 ew;. }..
1e20: 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 26 70 memcpy(&p
1e30: 2d 3e 65 6e 64 70 6f 69 6e 74 2e 70 43 68 75 6e ->endpoint.pChun
1e40: 6b 2d 3e 7a 43 68 75 6e 6b 5b 69 43 68 75 6e 6b k->zChunk[iChunk
1e50: 4f 66 66 73 65 74 5d 2c 20 7a 57 72 69 74 65 2c Offset], zWrite,
1e60: 20 69 53 70 61 63 65 29 3b 0a 20 20 20 20 20 20 iSpace);.
1e70: 20 20 7a 57 72 69 74 65 20 2b 3d 20 69 53 70 61 zWrite += iSpa
1e80: 63 65 3b 0a 20 20 20 20 20 20 20 20 6e 57 72 69 ce;. nWri
1e90: 74 65 20 2d 3d 20 69 53 70 61 63 65 3b 0a 20 20 te -= iSpace;.
1ea0: 20 20 20 20 20 20 70 2d 3e 65 6e 64 70 6f 69 6e p->endpoin
1eb0: 74 2e 69 4f 66 66 73 65 74 20 2b 3d 20 69 53 70 t.iOffset += iSp
1ec0: 61 63 65 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 ace;. }.
1ed0: 20 20 20 70 2d 3e 6e 53 69 7a 65 20 3d 20 69 41 p->nSize = iA
1ee0: 6d 74 20 2b 20 69 4f 66 73 74 3b 0a 20 20 20 20 mt + iOfst;.
1ef0: 7d 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 }. }.. return
1f00: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
1f10: 0a 2a 2a 20 54 72 75 6e 63 61 74 65 20 74 68 65 .** Truncate the
1f20: 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 file..**.** If
1f30: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
1f40: 20 69 73 20 61 6c 72 65 61 64 79 20 6f 6e 20 64 is already on d
1f50: 69 73 6b 2c 20 74 72 75 6e 63 61 74 65 20 69 74 isk, truncate it
1f60: 20 74 68 65 72 65 2e 20 4f 72 2c 20 69 66 20 69 there. Or, if i
1f70: 74 0a 2a 2a 20 69 73 20 73 74 69 6c 6c 20 69 6e t.** is still in
1f80: 20 6d 61 69 6e 20 6d 65 6d 6f 72 79 20 62 75 74 main memory but
1f90: 20 69 73 20 62 65 69 6e 67 20 74 72 75 6e 63 61 is being trunca
1fa0: 74 65 64 20 74 6f 20 7a 65 72 6f 20 62 79 74 65 ted to zero byte
1fb0: 73 20 69 6e 20 73 69 7a 65 2c 0a 2a 2a 20 69 67 s in size,.** ig
1fc0: 6e 6f 72 65 20 0a 2a 2f 0a 73 74 61 74 69 63 20 nore .*/.static
1fd0: 69 6e 74 20 6d 65 6d 6a 72 6e 6c 54 72 75 6e 63 int memjrnlTrunc
1fe0: 61 74 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 ate(sqlite3_file
1ff0: 20 2a 70 4a 66 64 2c 20 73 71 6c 69 74 65 5f 69 *pJfd, sqlite_i
2000: 6e 74 36 34 20 73 69 7a 65 29 7b 0a 20 20 4d 65 nt64 size){. Me
2010: 6d 4a 6f 75 72 6e 61 6c 20 2a 70 20 3d 20 28 4d mJournal *p = (M
2020: 65 6d 4a 6f 75 72 6e 61 6c 20 2a 29 70 4a 66 64 emJournal *)pJfd
2030: 3b 0a 20 20 69 66 28 20 70 2d 3e 70 52 65 61 6c ;. if( p->pReal
2040: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 73 ){. return s
2050: 71 6c 69 74 65 33 4f 73 54 72 75 6e 63 61 74 65 qlite3OsTruncate
2060: 28 70 2d 3e 70 52 65 61 6c 2c 20 73 69 7a 65 29 (p->pReal, size)
2070: 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 73 69 ;. }else if( si
2080: 7a 65 3d 3d 30 20 29 7b 0a 20 20 20 20 6d 65 6d ze==0 ){. mem
2090: 6a 72 6e 6c 46 72 65 65 43 68 75 6e 6b 73 28 70 jrnlFreeChunks(p
20a0: 29 3b 0a 20 20 20 20 70 2d 3e 6e 53 69 7a 65 20 );. p->nSize
20b0: 3d 20 30 3b 0a 20 20 20 20 70 2d 3e 65 6e 64 70 = 0;. p->endp
20c0: 6f 69 6e 74 2e 70 43 68 75 6e 6b 20 3d 20 30 3b oint.pChunk = 0;
20d0: 0a 20 20 20 20 70 2d 3e 65 6e 64 70 6f 69 6e 74 . p->endpoint
20e0: 2e 69 4f 66 66 73 65 74 20 3d 20 30 3b 0a 20 20 .iOffset = 0;.
20f0: 20 20 70 2d 3e 72 65 61 64 70 6f 69 6e 74 2e 70 p->readpoint.p
2100: 43 68 75 6e 6b 20 3d 20 30 3b 0a 20 20 20 20 70 Chunk = 0;. p
2110: 2d 3e 72 65 61 64 70 6f 69 6e 74 2e 69 4f 66 66 ->readpoint.iOff
2120: 73 65 74 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 set = 0;. }. r
2130: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
2140: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 .}../*.** Close
2150: 74 68 65 20 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 the file..*/.sta
2160: 74 69 63 20 69 6e 74 20 6d 65 6d 6a 72 6e 6c 43 tic int memjrnlC
2170: 6c 6f 73 65 28 73 71 6c 69 74 65 33 5f 66 69 6c lose(sqlite3_fil
2180: 65 20 2a 70 4a 66 64 29 7b 0a 20 20 4d 65 6d 4a e *pJfd){. MemJ
2190: 6f 75 72 6e 61 6c 20 2a 70 20 3d 20 28 4d 65 6d ournal *p = (Mem
21a0: 4a 6f 75 72 6e 61 6c 20 2a 29 70 4a 66 64 3b 0a Journal *)pJfd;.
21b0: 20 20 6d 65 6d 6a 72 6e 6c 46 72 65 65 43 68 75 memjrnlFreeChu
21c0: 6e 6b 73 28 70 29 3b 0a 20 20 69 66 28 20 70 2d nks(p);. if( p-
21d0: 3e 70 52 65 61 6c 20 29 20 73 71 6c 69 74 65 33 >pReal ) sqlite3
21e0: 4f 73 43 6c 6f 73 65 28 70 2d 3e 70 52 65 61 6c OsClose(p->pReal
21f0: 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 );. return SQLI
2200: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 TE_OK;.}../*.**
2210: 53 79 6e 63 20 74 68 65 20 66 69 6c 65 2e 0a 2a Sync the file..*
2220: 2a 0a 2a 2a 20 49 66 20 74 68 65 20 72 65 61 6c *.** If the real
2230: 20 66 69 6c 65 20 68 61 73 20 62 65 65 6e 20 63 file has been c
2240: 72 65 61 74 65 64 2c 20 63 61 6c 6c 20 69 74 73 reated, call its
2250: 20 78 53 79 6e 63 20 6d 65 74 68 6f 64 2e 20 4f xSync method. O
2260: 74 68 65 72 77 69 73 65 2c 20 0a 2a 2a 20 73 79 therwise, .** sy
2270: 6e 63 69 6e 67 20 61 6e 20 69 6e 2d 6d 65 6d 6f ncing an in-memo
2280: 72 79 20 6a 6f 75 72 6e 61 6c 20 69 73 20 61 20 ry journal is a
2290: 6e 6f 2d 6f 70 2e 20 0a 2a 2f 0a 73 74 61 74 69 no-op. .*/.stati
22a0: 63 20 69 6e 74 20 6d 65 6d 6a 72 6e 6c 53 79 6e c int memjrnlSyn
22b0: 63 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a c(sqlite3_file *
22c0: 70 4a 66 64 2c 20 69 6e 74 20 66 6c 61 67 73 29 pJfd, int flags)
22d0: 7b 0a 20 20 4d 65 6d 4a 6f 75 72 6e 61 6c 20 2a {. MemJournal *
22e0: 70 20 3d 20 28 4d 65 6d 4a 6f 75 72 6e 61 6c 20 p = (MemJournal
22f0: 2a 29 70 4a 66 64 3b 0a 20 20 69 66 28 20 70 2d *)pJfd;. if( p-
2300: 3e 70 52 65 61 6c 20 29 7b 0a 20 20 20 20 72 65 >pReal ){. re
2310: 74 75 72 6e 20 73 71 6c 69 74 65 33 4f 73 53 79 turn sqlite3OsSy
2320: 6e 63 28 70 2d 3e 70 52 65 61 6c 2c 20 66 6c 61 nc(p->pReal, fla
2330: 67 73 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 gs);. }. retur
2340: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
2350: 2f 2a 0a 2a 2a 20 51 75 65 72 79 20 74 68 65 20 /*.** Query the
2360: 73 69 7a 65 20 6f 66 20 74 68 65 20 66 69 6c 65 size of the file
2370: 20 69 6e 20 62 79 74 65 73 2e 0a 2a 2f 0a 73 74 in bytes..*/.st
2380: 61 74 69 63 20 69 6e 74 20 6d 65 6d 6a 72 6e 6c atic int memjrnl
2390: 46 69 6c 65 53 69 7a 65 28 73 71 6c 69 74 65 33 FileSize(sqlite3
23a0: 5f 66 69 6c 65 20 2a 70 4a 66 64 2c 20 73 71 6c _file *pJfd, sql
23b0: 69 74 65 5f 69 6e 74 36 34 20 2a 70 53 69 7a 65 ite_int64 *pSize
23c0: 29 7b 0a 20 20 4d 65 6d 4a 6f 75 72 6e 61 6c 20 ){. MemJournal
23d0: 2a 70 20 3d 20 28 4d 65 6d 4a 6f 75 72 6e 61 6c *p = (MemJournal
23e0: 20 2a 29 70 4a 66 64 3b 0a 20 20 69 66 28 20 70 *)pJfd;. if( p
23f0: 2d 3e 70 52 65 61 6c 20 29 7b 0a 20 20 20 20 72 ->pReal ){. r
2400: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 4f 73 46 eturn sqlite3OsF
2410: 69 6c 65 53 69 7a 65 28 70 2d 3e 70 52 65 61 6c ileSize(p->pReal
2420: 2c 20 70 53 69 7a 65 29 3b 0a 20 20 7d 0a 20 20 , pSize);. }.
2430: 2a 70 53 69 7a 65 20 3d 20 28 73 71 6c 69 74 65 *pSize = (sqlite
2440: 5f 69 6e 74 36 34 29 20 70 2d 3e 65 6e 64 70 6f _int64) p->endpo
2450: 69 6e 74 2e 69 4f 66 66 73 65 74 3b 0a 20 20 72 int.iOffset;. r
2460: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
2470: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 61 62 6c 65 20 .}../*.** Table
2480: 6f 66 20 6d 65 74 68 6f 64 73 20 66 6f 72 20 4d of methods for M
2490: 65 6d 4a 6f 75 72 6e 61 6c 20 73 71 6c 69 74 65 emJournal sqlite
24a0: 33 5f 66 69 6c 65 20 6f 62 6a 65 63 74 2e 0a 2a 3_file object..*
24b0: 2f 0a 73 74 61 74 69 63 20 63 6f 6e 73 74 20 73 /.static const s
24c0: 74 72 75 63 74 20 73 71 6c 69 74 65 33 5f 69 6f truct sqlite3_io
24d0: 5f 6d 65 74 68 6f 64 73 20 4d 65 6d 4a 6f 75 72 _methods MemJour
24e0: 6e 61 6c 4d 65 74 68 6f 64 73 20 3d 20 7b 0a 20 nalMethods = {.
24f0: 20 31 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 1,
2500: 20 20 20 2f 2a 20 69 56 65 72 73 69 6f 6e 20 2a /* iVersion *
2510: 2f 0a 20 20 6d 65 6d 6a 72 6e 6c 43 6c 6f 73 65 /. memjrnlClose
2520: 2c 20 20 20 20 20 2f 2a 20 78 43 6c 6f 73 65 20 , /* xClose
2530: 2a 2f 0a 20 20 6d 65 6d 6a 72 6e 6c 52 65 61 64 */. memjrnlRead
2540: 2c 20 20 20 20 20 20 2f 2a 20 78 52 65 61 64 20 , /* xRead
2550: 2a 2f 0a 20 20 6d 65 6d 6a 72 6e 6c 57 72 69 74 */. memjrnlWrit
2560: 65 2c 20 20 20 20 20 2f 2a 20 78 57 72 69 74 65 e, /* xWrite
2570: 20 2a 2f 0a 20 20 6d 65 6d 6a 72 6e 6c 54 72 75 */. memjrnlTru
2580: 6e 63 61 74 65 2c 20 20 2f 2a 20 78 54 72 75 6e ncate, /* xTrun
2590: 63 61 74 65 20 2a 2f 0a 20 20 6d 65 6d 6a 72 6e cate */. memjrn
25a0: 6c 53 79 6e 63 2c 20 20 20 20 20 20 2f 2a 20 78 lSync, /* x
25b0: 53 79 6e 63 20 2a 2f 0a 20 20 6d 65 6d 6a 72 6e Sync */. memjrn
25c0: 6c 46 69 6c 65 53 69 7a 65 2c 20 20 2f 2a 20 78 lFileSize, /* x
25d0: 46 69 6c 65 53 69 7a 65 20 2a 2f 0a 20 20 30 2c FileSize */. 0,
25e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25f0: 2f 2a 20 78 4c 6f 63 6b 20 2a 2f 0a 20 20 30 2c /* xLock */. 0,
2600: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2610: 2f 2a 20 78 55 6e 6c 6f 63 6b 20 2a 2f 0a 20 20 /* xUnlock */.
2620: 30 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0,
2630: 20 20 2f 2a 20 78 43 68 65 63 6b 52 65 73 65 72 /* xCheckReser
2640: 76 65 64 4c 6f 63 6b 20 2a 2f 0a 20 20 30 2c 20 vedLock */. 0,
2650: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
2660: 2a 20 78 46 69 6c 65 43 6f 6e 74 72 6f 6c 20 2a * xFileControl *
2670: 2f 0a 20 20 30 2c 20 20 20 20 20 20 20 20 20 20 /. 0,
2680: 20 20 20 20 20 20 2f 2a 20 78 53 65 63 74 6f 72 /* xSector
2690: 53 69 7a 65 20 2a 2f 0a 20 20 30 2c 20 20 20 20 Size */. 0,
26a0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 /* x
26b0: 44 65 76 69 63 65 43 68 61 72 61 63 74 65 72 69 DeviceCharacteri
26c0: 73 74 69 63 73 20 2a 2f 0a 20 20 30 2c 20 20 20 stics */. 0,
26d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
26e0: 78 53 68 6d 4d 61 70 20 2a 2f 0a 20 20 30 2c 20 xShmMap */. 0,
26f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
2700: 2a 20 78 53 68 6d 4c 6f 63 6b 20 2a 2f 0a 20 20 * xShmLock */.
2710: 30 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0,
2720: 20 20 2f 2a 20 78 53 68 6d 42 61 72 72 69 65 72 /* xShmBarrier
2730: 20 2a 2f 0a 20 20 30 2c 20 20 20 20 20 20 20 20 */. 0,
2740: 20 20 20 20 20 20 20 20 2f 2a 20 78 53 68 6d 55 /* xShmU
2750: 6e 6d 61 70 20 2a 2f 0a 20 20 30 2c 20 20 20 20 nmap */. 0,
2760: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 /* x
2770: 46 65 74 63 68 20 2a 2f 0a 20 20 30 20 20 20 20 Fetch */. 0
2780: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
2790: 78 55 6e 66 65 74 63 68 20 2a 2f 0a 7d 3b 0a 0a xUnfetch */.};..
27a0: 2f 2a 20 0a 2a 2a 20 4f 70 65 6e 20 61 20 6a 6f /* .** Open a jo
27b0: 75 72 6e 61 6c 20 66 69 6c 65 2e 20 0a 2a 2a 0a urnal file. .**.
27c0: 2a 2a 20 54 68 65 20 62 65 68 61 76 69 6f 75 72 ** The behaviour
27d0: 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 of the journal
27e0: 66 69 6c 65 20 64 65 70 65 6e 64 73 20 6f 6e 20 file depends on
27f0: 74 68 65 20 76 61 6c 75 65 20 6f 66 20 70 61 72 the value of par
2800: 61 6d 65 74 65 72 20 0a 2a 2a 20 6e 42 75 66 2e ameter .** nBuf.
2810: 20 49 66 20 6e 42 75 66 20 69 73 20 30 2c 20 74 If nBuf is 0, t
2820: 68 65 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 hen the journal
2830: 66 69 6c 65 20 69 73 20 61 6c 77 61 79 73 20 63 file is always c
2840: 72 65 61 74 65 20 61 6e 64 20 0a 2a 2a 20 61 63 reate and .** ac
2850: 63 65 73 73 65 64 20 75 73 69 6e 67 20 74 68 65 cessed using the
2860: 20 75 6e 64 65 72 6c 79 69 6e 67 20 56 46 53 2e underlying VFS.
2870: 20 49 66 20 6e 42 75 66 20 69 73 20 6c 65 73 73 If nBuf is less
2880: 20 74 68 61 6e 20 7a 65 72 6f 2c 20 74 68 65 6e than zero, then
2890: 0a 2a 2a 20 61 6c 6c 20 63 6f 6e 74 65 6e 74 20 .** all content
28a0: 69 73 20 61 6c 77 61 79 73 20 73 74 6f 72 65 64 is always stored
28b0: 20 69 6e 20 6d 61 69 6e 2d 6d 65 6d 6f 72 79 2e in main-memory.
28c0: 20 46 69 6e 61 6c 6c 79 2c 20 69 66 20 6e 42 75 Finally, if nBu
28d0: 66 20 69 73 20 61 0a 2a 2a 20 70 6f 73 69 74 69 f is a.** positi
28e0: 76 65 20 76 61 6c 75 65 2c 20 74 68 65 6e 20 74 ve value, then t
28f0: 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
2900: 69 73 20 69 6e 69 74 69 61 6c 6c 79 20 63 72 65 is initially cre
2910: 61 74 65 64 20 69 6e 2d 6d 65 6d 6f 72 79 0a 2a ated in-memory.*
2920: 2a 20 62 75 74 20 6d 61 79 20 62 65 20 66 6c 75 * but may be flu
2930: 73 68 65 64 20 74 6f 20 64 69 73 6b 20 6c 61 74 shed to disk lat
2940: 65 72 20 6f 6e 2e 20 49 6e 20 74 68 69 73 20 63 er on. In this c
2950: 61 73 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 ase the journal
2960: 66 69 6c 65 20 69 73 0a 2a 2a 20 66 6c 75 73 68 file is.** flush
2970: 65 64 20 74 6f 20 64 69 73 6b 20 65 69 74 68 65 ed to disk eithe
2980: 72 20 77 68 65 6e 20 69 74 20 67 72 6f 77 73 20 r when it grows
2990: 6c 61 72 67 65 72 20 74 68 61 6e 20 6e 42 75 66 larger than nBuf
29a0: 20 62 79 74 65 73 20 69 6e 20 73 69 7a 65 2c 0a bytes in size,.
29b0: 2a 2a 20 6f 72 20 77 68 65 6e 20 73 71 6c 69 74 ** or when sqlit
29c0: 65 33 4a 6f 75 72 6e 61 6c 43 72 65 61 74 65 28 e3JournalCreate(
29d0: 29 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a ) is called..*/.
29e0: 69 6e 74 20 73 71 6c 69 74 65 33 4a 6f 75 72 6e int sqlite3Journ
29f0: 61 6c 4f 70 65 6e 28 0a 20 20 73 71 6c 69 74 65 alOpen(. sqlite
2a00: 33 5f 76 66 73 20 2a 70 56 66 73 2c 20 20 20 20 3_vfs *pVfs,
2a10: 20 20 20 20 20 2f 2a 20 54 68 65 20 56 46 53 20 /* The VFS
2a20: 74 6f 20 75 73 65 20 66 6f 72 20 61 63 74 75 61 to use for actua
2a30: 6c 20 66 69 6c 65 20 49 2f 4f 20 2a 2f 0a 20 20 l file I/O */.
2a40: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d const char *zNam
2a50: 65 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 e, /* Na
2a60: 6d 65 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 me of the journa
2a70: 6c 20 66 69 6c 65 20 2a 2f 0a 20 20 73 71 6c 69 l file */. sqli
2a80: 74 65 33 5f 66 69 6c 65 20 2a 70 4a 66 64 2c 20 te3_file *pJfd,
2a90: 20 20 20 20 20 20 20 2f 2a 20 50 72 65 61 6c 6c /* Preall
2aa0: 6f 63 61 74 65 64 2c 20 62 6c 61 6e 6b 20 66 69 ocated, blank fi
2ab0: 6c 65 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 69 le handle */. i
2ac0: 6e 74 20 66 6c 61 67 73 2c 20 20 20 20 20 20 20 nt flags,
2ad0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 70 65 /* Ope
2ae0: 6e 69 6e 67 20 66 6c 61 67 73 20 2a 2f 0a 20 20 ning flags */.
2af0: 69 6e 74 20 6e 42 75 66 20 20 20 20 20 20 20 20 int nBuf
2b00: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 79 /* By
2b10: 74 65 73 20 62 75 66 66 65 72 65 64 20 62 65 66 tes buffered bef
2b20: 6f 72 65 20 6f 70 65 6e 69 6e 67 20 74 68 65 20 ore opening the
2b30: 66 69 6c 65 20 2a 2f 0a 29 7b 0a 20 20 4d 65 6d file */.){. Mem
2b40: 4a 6f 75 72 6e 61 6c 20 2a 70 20 3d 20 28 4d 65 Journal *p = (Me
2b50: 6d 4a 6f 75 72 6e 61 6c 2a 29 70 4a 66 64 3b 0a mJournal*)pJfd;.
2b60: 0a 20 20 2f 2a 20 5a 65 72 6f 20 74 68 65 20 66 . /* Zero the f
2b70: 69 6c 65 2d 68 61 6e 64 6c 65 20 6f 62 6a 65 63 ile-handle objec
2b80: 74 2e 20 49 66 20 6e 42 75 66 20 77 61 73 20 70 t. If nBuf was p
2b90: 61 73 73 65 64 20 7a 65 72 6f 2c 20 69 6e 69 74 assed zero, init
2ba0: 69 61 6c 69 7a 65 0a 20 20 2a 2a 20 69 74 20 75 ialize. ** it u
2bb0: 73 69 6e 67 20 74 68 65 20 73 71 6c 69 74 65 33 sing the sqlite3
2bc0: 4f 73 4f 70 65 6e 28 29 20 66 75 6e 63 74 69 6f OsOpen() functio
2bd0: 6e 20 6f 66 20 74 68 65 20 75 6e 64 65 72 6c 79 n of the underly
2be0: 69 6e 67 20 56 46 53 2e 20 49 6e 20 74 68 69 73 ing VFS. In this
2bf0: 0a 20 20 2a 2a 20 63 61 73 65 20 6e 6f 6e 65 20 . ** case none
2c00: 6f 66 20 74 68 65 20 63 6f 64 65 20 69 6e 20 74 of the code in t
2c10: 68 69 73 20 6d 6f 64 75 6c 65 20 69 73 20 65 78 his module is ex
2c20: 65 63 75 74 65 64 20 61 73 20 61 20 72 65 73 75 ecuted as a resu
2c30: 6c 74 20 6f 66 20 63 61 6c 6c 73 0a 20 20 2a 2a lt of calls. **
2c40: 20 6d 61 64 65 20 6f 6e 20 74 68 65 20 6a 6f 75 made on the jou
2c50: 72 6e 61 6c 20 66 69 6c 65 2d 68 61 6e 64 6c 65 rnal file-handle
2c60: 2e 20 20 2a 2f 0a 20 20 6d 65 6d 73 65 74 28 70 . */. memset(p
2c70: 2c 20 30 2c 20 73 69 7a 65 6f 66 28 4d 65 6d 4a , 0, sizeof(MemJ
2c80: 6f 75 72 6e 61 6c 29 20 2b 20 70 56 66 73 20 3f ournal) + pVfs ?
2c90: 20 70 56 66 73 2d 3e 73 7a 4f 73 46 69 6c 65 20 pVfs->szOsFile
2ca0: 3a 20 30 29 3b 0a 20 20 69 66 28 20 6e 42 75 66 : 0);. if( nBuf
2cb0: 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 ==0 ){. retur
2cc0: 6e 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 28 n sqlite3OsOpen(
2cd0: 70 56 66 73 2c 20 7a 4e 61 6d 65 2c 20 70 4a 66 pVfs, zName, pJf
2ce0: 64 2c 20 66 6c 61 67 73 2c 20 30 29 3b 0a 20 20 d, flags, 0);.
2cf0: 7d 0a 0a 20 20 69 66 28 20 6e 42 75 66 3e 30 20 }.. if( nBuf>0
2d00: 29 7b 0a 20 20 20 20 70 2d 3e 6e 43 68 75 6e 6b ){. p->nChunk
2d10: 53 69 7a 65 20 3d 20 6e 42 75 66 3b 0a 20 20 7d Size = nBuf;. }
2d20: 65 6c 73 65 7b 0a 20 20 20 20 70 2d 3e 6e 43 68 else{. p->nCh
2d30: 75 6e 6b 53 69 7a 65 20 3d 20 38 20 2b 20 4d 45 unkSize = 8 + ME
2d40: 4d 4a 4f 55 52 4e 41 4c 5f 44 46 4c 54 5f 46 49 MJOURNAL_DFLT_FI
2d50: 4c 45 43 48 55 4e 4b 53 49 5a 45 20 2d 20 73 69 LECHUNKSIZE - si
2d60: 7a 65 6f 66 28 46 69 6c 65 43 68 75 6e 6b 29 3b zeof(FileChunk);
2d70: 0a 20 20 20 20 61 73 73 65 72 74 28 20 4d 45 4d . assert( MEM
2d80: 4a 4f 55 52 4e 41 4c 5f 44 46 4c 54 5f 46 49 4c JOURNAL_DFLT_FIL
2d90: 45 43 48 55 4e 4b 53 49 5a 45 3d 3d 66 69 6c 65 ECHUNKSIZE==file
2da0: 43 68 75 6e 6b 53 69 7a 65 28 70 2d 3e 6e 43 68 ChunkSize(p->nCh
2db0: 75 6e 6b 53 69 7a 65 29 20 29 3b 0a 20 20 7d 0a unkSize) );. }.
2dc0: 0a 20 20 70 2d 3e 70 4d 65 74 68 6f 64 20 3d 20 . p->pMethod =
2dd0: 28 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 69 (const sqlite3_i
2de0: 6f 5f 6d 65 74 68 6f 64 73 2a 29 26 4d 65 6d 4a o_methods*)&MemJ
2df0: 6f 75 72 6e 61 6c 4d 65 74 68 6f 64 73 3b 0a 20 ournalMethods;.
2e00: 20 70 2d 3e 6e 42 75 66 20 3d 20 6e 42 75 66 3b p->nBuf = nBuf;
2e10: 0a 20 20 70 2d 3e 66 6c 61 67 73 20 3d 20 66 6c . p->flags = fl
2e20: 61 67 73 3b 0a 20 20 70 2d 3e 7a 4a 6f 75 72 6e ags;. p->zJourn
2e30: 61 6c 20 3d 20 7a 4e 61 6d 65 3b 0a 20 20 70 2d al = zName;. p-
2e40: 3e 70 56 66 73 20 3d 20 70 56 66 73 3b 0a 20 20 >pVfs = pVfs;.
2e50: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
2e60: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 ;.}../*.** Open
2e70: 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 6a 6f 75 an in-memory jou
2e80: 72 6e 61 6c 20 66 69 6c 65 2e 0a 2a 2f 0a 76 6f rnal file..*/.vo
2e90: 69 64 20 73 71 6c 69 74 65 33 4d 65 6d 4a 6f 75 id sqlite3MemJou
2ea0: 72 6e 61 6c 4f 70 65 6e 28 73 71 6c 69 74 65 33 rnalOpen(sqlite3
2eb0: 5f 66 69 6c 65 20 2a 70 4a 66 64 29 7b 0a 20 20 _file *pJfd){.
2ec0: 73 71 6c 69 74 65 33 4a 6f 75 72 6e 61 6c 4f 70 sqlite3JournalOp
2ed0: 65 6e 28 30 2c 20 30 2c 20 70 4a 66 64 2c 20 30 en(0, 0, pJfd, 0
2ee0: 2c 20 2d 31 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 , -1);.}../*.**
2ef0: 49 66 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 If the argument
2f00: 70 20 70 6f 69 6e 74 73 20 74 6f 20 61 20 4d 65 p points to a Me
2f10: 6d 4a 6f 75 72 6e 61 6c 20 73 74 72 75 63 74 75 mJournal structu
2f20: 72 65 20 74 68 61 74 20 69 73 20 6e 6f 74 20 61 re that is not a
2f30: 6e 20 0a 2a 2a 20 69 6e 2d 6d 65 6d 6f 72 79 2d n .** in-memory-
2f40: 6f 6e 6c 79 20 6a 6f 75 72 6e 61 6c 20 66 69 6c only journal fil
2f50: 65 20 28 69 2e 65 2e 20 69 73 20 6f 6e 65 20 74 e (i.e. is one t
2f60: 68 61 74 20 77 61 73 20 6f 70 65 6e 65 64 20 77 hat was opened w
2f70: 69 74 68 20 61 20 2b 76 65 0a 2a 2a 20 6e 42 75 ith a +ve.** nBu
2f80: 66 20 70 61 72 61 6d 65 74 65 72 29 2c 20 61 6e f parameter), an
2f90: 64 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 d the underlying
2fa0: 20 66 69 6c 65 20 68 61 73 20 6e 6f 74 20 79 65 file has not ye
2fb0: 74 20 62 65 65 6e 20 63 72 65 61 74 65 64 2c 20 t been created,
2fc0: 0a 2a 2a 20 63 72 65 61 74 65 20 69 74 20 6e 6f .** create it no
2fd0: 77 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 w..*/.int sqlite
2fe0: 33 4a 6f 75 72 6e 61 6c 43 72 65 61 74 65 28 73 3JournalCreate(s
2ff0: 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 29 7b qlite3_file *p){
3000: 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 . int rc = SQLI
3010: 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 70 2d 3e TE_OK;. if( p->
3020: 70 4d 65 74 68 6f 64 73 3d 3d 26 4d 65 6d 4a 6f pMethods==&MemJo
3030: 75 72 6e 61 6c 4d 65 74 68 6f 64 73 20 26 26 20 urnalMethods &&
3040: 28 28 4d 65 6d 4a 6f 75 72 6e 61 6c 2a 29 70 29 ((MemJournal*)p)
3050: 2d 3e 6e 42 75 66 3e 30 20 29 7b 0a 20 20 20 20 ->nBuf>0 ){.
3060: 72 63 20 3d 20 63 72 65 61 74 65 46 69 6c 65 28 rc = createFile(
3070: 28 4d 65 6d 4a 6f 75 72 6e 61 6c 2a 29 70 29 3b (MemJournal*)p);
3080: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 . }. return rc
3090: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 ;.}../*.** The f
30a0: 69 6c 65 2d 68 61 6e 64 6c 65 20 70 61 73 73 65 ile-handle passe
30b0: 64 20 61 73 20 74 68 65 20 6f 6e 6c 79 20 61 72 d as the only ar
30c0: 67 75 6d 65 6e 74 20 69 73 20 6f 70 65 6e 20 6f gument is open o
30d0: 6e 20 61 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 n a journal file
30e0: 2e 0a 2a 2a 20 52 65 74 75 72 6e 20 74 72 75 65 ..** Return true
30f0: 20 69 66 20 74 68 69 73 20 22 6a 6f 75 72 6e 61 if this "journa
3100: 6c 20 66 69 6c 65 22 20 69 73 20 63 75 72 72 65 l file" is curre
3110: 6e 74 6c 79 20 73 74 6f 72 65 64 20 69 6e 20 68 ntly stored in h
3120: 65 61 70 20 6d 65 6d 6f 72 79 2c 0a 2a 2a 20 6f eap memory,.** o
3130: 72 20 66 61 6c 73 65 20 6f 74 68 65 72 77 69 73 r false otherwis
3140: 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 e..*/.int sqlite
3150: 33 4a 6f 75 72 6e 61 6c 49 73 49 6e 4d 65 6d 6f 3JournalIsInMemo
3160: 72 79 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 ry(sqlite3_file
3170: 2a 70 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 2d *p){. return p-
3180: 3e 70 4d 65 74 68 6f 64 73 3d 3d 26 4d 65 6d 4a >pMethods==&MemJ
3190: 6f 75 72 6e 61 6c 4d 65 74 68 6f 64 73 20 26 26 ournalMethods &&
31a0: 20 28 28 4d 65 6d 4a 6f 75 72 6e 61 6c 2a 29 70 ((MemJournal*)p
31b0: 29 2d 3e 70 52 65 61 6c 3d 3d 30 3b 0a 7d 0a 0a )->pReal==0;.}..
31c0: 2f 2a 20 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 /* .** Return th
31d0: 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 e number of byte
31e0: 73 20 72 65 71 75 69 72 65 64 20 74 6f 20 73 74 s required to st
31f0: 6f 72 65 20 61 20 4a 6f 75 72 6e 61 6c 46 69 6c ore a JournalFil
3200: 65 20 74 68 61 74 20 75 73 65 73 20 76 66 73 0a e that uses vfs.
3210: 2a 2a 20 70 56 66 73 20 74 6f 20 63 72 65 61 74 ** pVfs to creat
3220: 65 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 e the underlying
3230: 20 6f 6e 2d 64 69 73 6b 20 66 69 6c 65 73 2e 0a on-disk files..
3240: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 4a 6f */.int sqlite3Jo
3250: 75 72 6e 61 6c 53 69 7a 65 28 73 71 6c 69 74 65 urnalSize(sqlite
3260: 33 5f 76 66 73 20 2a 70 56 66 73 29 7b 0a 20 20 3_vfs *pVfs){.
3270: 72 65 74 75 72 6e 20 70 56 66 73 2d 3e 73 7a 4f return pVfs->szO
3280: 73 46 69 6c 65 20 2b 20 73 69 7a 65 6f 66 28 4d sFile + sizeof(M
3290: 65 6d 4a 6f 75 72 6e 61 6c 29 3b 0a 7d 0a 0a emJournal);.}..