/ Hex Artifact Content
Login

Artifact cffd2cd214e58c0e99c3ff632b3bee6c7cbb260e:


0000: 2f 2a 0a 2a 2a 20 32 30 30 37 20 41 75 67 75 73  /*.** 2007 Augus
0010: 74 20 32 32 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61  t 22.**.** 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 40 28 23 29 20 24  ***.**.** @(#) $
0180: 49 64 3a 20 6a 6f 75 72 6e 61 6c 2e 63 2c 76 20  Id: journal.c,v 
0190: 31 2e 38 20 32 30 30 38 2f 30 35 2f 30 31 20 31  1.8 2008/05/01 1
01a0: 38 3a 30 31 3a 34 37 20 64 72 68 20 45 78 70 20  8:01:47 drh Exp 
01b0: 24 0a 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c  $.*/..#ifdef SQL
01c0: 49 54 45 5f 45 4e 41 42 4c 45 5f 41 54 4f 4d 49  ITE_ENABLE_ATOMI
01d0: 43 5f 57 52 49 54 45 0a 0a 2f 2a 0a 2a 2a 20 54  C_WRITE../*.** T
01e0: 68 69 73 20 66 69 6c 65 20 69 6d 70 6c 65 6d 65  his file impleme
01f0: 6e 74 73 20 61 20 73 70 65 63 69 61 6c 20 6b 69  nts a special ki
0200: 6e 64 20 6f 66 20 73 71 6c 69 74 65 33 5f 66 69  nd of sqlite3_fi
0210: 6c 65 20 6f 62 6a 65 63 74 20 75 73 65 64 0a 2a  le object used.*
0220: 2a 20 62 79 20 53 51 4c 69 74 65 20 74 6f 20 63  * by SQLite to c
0230: 72 65 61 74 65 20 6a 6f 75 72 6e 61 6c 20 66 69  reate journal fi
0240: 6c 65 73 20 69 66 20 74 68 65 20 61 74 6f 6d 69  les if the atomi
0250: 63 2d 77 72 69 74 65 20 6f 70 74 69 6d 69 7a 61  c-write optimiza
0260: 74 69 6f 6e 0a 2a 2a 20 69 73 20 65 6e 61 62 6c  tion.** is enabl
0270: 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 64 69  ed..**.** The di
0280: 73 74 69 6e 63 74 69 76 65 20 63 68 61 72 61 63  stinctive charac
0290: 74 65 72 69 73 74 69 63 20 6f 66 20 74 68 69 73  teristic of this
02a0: 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 69 73   sqlite3_file is
02b0: 20 74 68 61 74 20 74 68 65 0a 2a 2a 20 61 63 74   that the.** act
02c0: 75 61 6c 20 6f 6e 20 64 69 73 6b 20 66 69 6c 65  ual on disk file
02d0: 20 69 73 20 63 72 65 61 74 65 64 20 6c 61 7a 69   is created lazi
02e0: 6c 79 2e 20 57 68 65 6e 20 74 68 65 20 66 69 6c  ly. When the fil
02f0: 65 20 69 73 20 63 72 65 61 74 65 64 2c 0a 2a 2a  e is created,.**
0300: 20 74 68 65 20 63 61 6c 6c 65 72 20 73 70 65 63   the caller spec
0310: 69 66 69 65 73 20 61 20 62 75 66 66 65 72 20 73  ifies a buffer s
0320: 69 7a 65 20 66 6f 72 20 61 6e 20 69 6e 2d 6d 65  ize for an in-me
0330: 6d 6f 72 79 20 62 75 66 66 65 72 20 74 6f 0a 2a  mory buffer to.*
0340: 2a 20 62 65 20 75 73 65 64 20 74 6f 20 73 65 72  * be used to ser
0350: 76 69 63 65 20 72 65 61 64 28 29 20 61 6e 64 20  vice read() and 
0360: 77 72 69 74 65 28 29 20 72 65 71 75 65 73 74 73  write() requests
0370: 2e 20 54 68 65 20 61 63 74 75 61 6c 20 66 69 6c  . The actual fil
0380: 65 0a 2a 2a 20 6f 6e 20 64 69 73 6b 20 69 73 20  e.** on disk is 
0390: 6e 6f 74 20 63 72 65 61 74 65 64 20 6f 72 20 70  not created or p
03a0: 6f 70 75 6c 61 74 65 64 20 75 6e 74 69 6c 20 65  opulated until e
03b0: 69 74 68 65 72 3a 0a 2a 2a 0a 2a 2a 20 20 20 31  ither:.**.**   1
03c0: 29 20 54 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20  ) The in-memory 
03d0: 72 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 67  representation g
03e0: 72 6f 77 73 20 74 6f 6f 20 6c 61 72 67 65 20 66  rows too large f
03f0: 6f 72 20 74 68 65 20 61 6c 6c 6f 63 61 74 65 64  or the allocated
0400: 20 0a 2a 2a 20 20 20 20 20 20 62 75 66 66 65 72   .**      buffer
0410: 2c 20 6f 72 0a 2a 2a 20 20 20 32 29 20 54 68 65  , or.**   2) The
0420: 20 78 53 79 6e 63 28 29 20 6d 65 74 68 6f 64 20   xSync() method 
0430: 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 0a 23  is called..*/..#
0440: 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 49  include "sqliteI
0450: 6e 74 2e 68 22 0a 0a 0a 2f 2a 0a 2a 2a 20 41 20  nt.h".../*.** A 
0460: 4a 6f 75 72 6e 61 6c 46 69 6c 65 20 6f 62 6a 65  JournalFile obje
0470: 63 74 20 69 73 20 61 20 73 75 62 63 6c 61 73 73  ct is a subclass
0480: 20 6f 66 20 73 71 6c 69 74 65 33 5f 66 69 6c 65   of sqlite3_file
0490: 20 75 73 65 64 20 62 79 0a 2a 2a 20 61 73 20 61   used by.** as a
04a0: 6e 20 6f 70 65 6e 20 66 69 6c 65 20 68 61 6e 64  n open file hand
04b0: 6c 65 20 66 6f 72 20 6a 6f 75 72 6e 61 6c 20 66  le for journal f
04c0: 69 6c 65 73 2e 0a 2a 2f 0a 73 74 72 75 63 74 20  iles..*/.struct 
04d0: 4a 6f 75 72 6e 61 6c 46 69 6c 65 20 7b 0a 20 20  JournalFile {.  
04e0: 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f  sqlite3_io_metho
04f0: 64 73 20 2a 70 4d 65 74 68 6f 64 3b 20 20 20 20  ds *pMethod;    
0500: 2f 2a 20 49 2f 4f 20 6d 65 74 68 6f 64 73 20 6f  /* I/O methods o
0510: 6e 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 73 20  n journal files 
0520: 2a 2f 0a 20 20 69 6e 74 20 6e 42 75 66 3b 20 20  */.  int nBuf;  
0530: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0540: 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20       /* Size of 
0550: 7a 42 75 66 5b 5d 20 69 6e 20 62 79 74 65 73 20  zBuf[] in bytes 
0560: 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 42 75 66 3b  */.  char *zBuf;
0570: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0580: 20 20 20 20 20 2f 2a 20 53 70 61 63 65 20 74 6f       /* Space to
0590: 20 62 75 66 66 65 72 20 6a 6f 75 72 6e 61 6c 20   buffer journal 
05a0: 77 72 69 74 65 73 20 2a 2f 0a 20 20 69 6e 74 20  writes */.  int 
05b0: 69 53 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20  iSize;          
05c0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41              /* A
05d0: 6d 6f 75 6e 74 20 6f 66 20 7a 42 75 66 5b 5d 20  mount of zBuf[] 
05e0: 63 75 72 72 65 6e 74 6c 79 20 75 73 65 64 20 2a  currently used *
05f0: 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73 3b 20 20  /.  int flags;  
0600: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0610: 20 20 20 20 2f 2a 20 78 4f 70 65 6e 20 66 6c 61      /* xOpen fla
0620: 67 73 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f  gs */.  sqlite3_
0630: 76 66 73 20 2a 70 56 66 73 3b 20 20 20 20 20 20  vfs *pVfs;      
0640: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 22          /* The "
0650: 72 65 61 6c 22 20 75 6e 64 65 72 6c 79 69 6e 67  real" underlying
0660: 20 56 46 53 20 2a 2f 0a 20 20 73 71 6c 69 74 65   VFS */.  sqlite
0670: 33 5f 66 69 6c 65 20 2a 70 52 65 61 6c 3b 20 20  3_file *pReal;  
0680: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65            /* The
0690: 20 22 72 65 61 6c 22 20 75 6e 64 65 72 6c 79 69   "real" underlyi
06a0: 6e 67 20 66 69 6c 65 20 64 65 73 63 72 69 70 74  ng file descript
06b0: 6f 72 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68  or */.  const ch
06c0: 61 72 20 2a 7a 4a 6f 75 72 6e 61 6c 3b 20 20 20  ar *zJournal;   
06d0: 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20          /* Name 
06e0: 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66  of the journal f
06f0: 69 6c 65 20 2a 2f 0a 7d 3b 0a 74 79 70 65 64 65  ile */.};.typede
0700: 66 20 73 74 72 75 63 74 20 4a 6f 75 72 6e 61 6c  f struct Journal
0710: 46 69 6c 65 20 4a 6f 75 72 6e 61 6c 46 69 6c 65  File JournalFile
0720: 3b 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 69 74 20 64  ;../*.** If it d
0730: 6f 65 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20  oes not already 
0740: 65 78 69 73 74 73 2c 20 63 72 65 61 74 65 20 61  exists, create a
0750: 6e 64 20 70 6f 70 75 6c 61 74 65 20 74 68 65 20  nd populate the 
0760: 6f 6e 2d 64 69 73 6b 20 66 69 6c 65 20 0a 2a 2a  on-disk file .**
0770: 20 66 6f 72 20 4a 6f 75 72 6e 61 6c 46 69 6c 65   for JournalFile
0780: 20 70 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e   p..*/.static in
0790: 74 20 63 72 65 61 74 65 46 69 6c 65 28 4a 6f 75  t createFile(Jou
07a0: 72 6e 61 6c 46 69 6c 65 20 2a 70 29 7b 0a 20 20  rnalFile *p){.  
07b0: 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f  int rc = SQLITE_
07c0: 4f 4b 3b 0a 20 20 69 66 28 20 21 70 2d 3e 70 52  OK;.  if( !p->pR
07d0: 65 61 6c 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  eal ){.    sqlit
07e0: 65 33 5f 66 69 6c 65 20 2a 70 52 65 61 6c 20 3d  e3_file *pReal =
07f0: 20 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a   (sqlite3_file *
0800: 29 26 70 5b 31 5d 3b 0a 20 20 20 20 72 63 20 3d  )&p[1];.    rc =
0810: 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 28 70   sqlite3OsOpen(p
0820: 2d 3e 70 56 66 73 2c 20 70 2d 3e 7a 4a 6f 75 72  ->pVfs, p->zJour
0830: 6e 61 6c 2c 20 70 52 65 61 6c 2c 20 70 2d 3e 66  nal, pReal, p->f
0840: 6c 61 67 73 2c 20 30 29 3b 0a 20 20 20 20 69 66  lags, 0);.    if
0850: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
0860: 29 7b 0a 20 20 20 20 20 20 70 2d 3e 70 52 65 61  ){.      p->pRea
0870: 6c 20 3d 20 70 52 65 61 6c 3b 0a 20 20 20 20 20  l = pReal;.     
0880: 20 69 66 28 20 70 2d 3e 69 53 69 7a 65 3e 30 20   if( p->iSize>0 
0890: 29 7b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72  ){.        asser
08a0: 74 28 70 2d 3e 69 53 69 7a 65 3c 3d 70 2d 3e 6e  t(p->iSize<=p->n
08b0: 42 75 66 29 3b 0a 20 20 20 20 20 20 20 20 72 63  Buf);.        rc
08c0: 20 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 69 74   = sqlite3OsWrit
08d0: 65 28 70 2d 3e 70 52 65 61 6c 2c 20 70 2d 3e 7a  e(p->pReal, p->z
08e0: 42 75 66 2c 20 70 2d 3e 69 53 69 7a 65 2c 20 30  Buf, p->iSize, 0
08f0: 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  );.      }.    }
0900: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63  .  }.  return rc
0910: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65  ;.}../*.** Close
0920: 20 74 68 65 20 66 69 6c 65 2e 0a 2a 2f 0a 73 74   the file..*/.st
0930: 61 74 69 63 20 69 6e 74 20 6a 72 6e 6c 43 6c 6f  atic int jrnlClo
0940: 73 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20  se(sqlite3_file 
0950: 2a 70 4a 66 64 29 7b 0a 20 20 4a 6f 75 72 6e 61  *pJfd){.  Journa
0960: 6c 46 69 6c 65 20 2a 70 20 3d 20 28 4a 6f 75 72  lFile *p = (Jour
0970: 6e 61 6c 46 69 6c 65 20 2a 29 70 4a 66 64 3b 0a  nalFile *)pJfd;.
0980: 20 20 69 66 28 20 70 2d 3e 70 52 65 61 6c 20 29    if( p->pReal )
0990: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43  {.    sqlite3OsC
09a0: 6c 6f 73 65 28 70 2d 3e 70 52 65 61 6c 29 3b 0a  lose(p->pReal);.
09b0: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 66 72    }.  sqlite3_fr
09c0: 65 65 28 70 2d 3e 7a 42 75 66 29 3b 0a 20 20 72  ee(p->zBuf);.  r
09d0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
09e0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20 64  .}../*.** Read d
09f0: 61 74 61 20 66 72 6f 6d 20 74 68 65 20 66 69 6c  ata from the fil
0a00: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  e..*/.static int
0a10: 20 6a 72 6e 6c 52 65 61 64 28 0a 20 20 73 71 6c   jrnlRead(.  sql
0a20: 69 74 65 33 5f 66 69 6c 65 20 2a 70 4a 66 64 2c  ite3_file *pJfd,
0a30: 20 20 20 20 2f 2a 20 54 68 65 20 6a 6f 75 72 6e      /* The journ
0a40: 61 6c 20 66 69 6c 65 20 66 72 6f 6d 20 77 68 69  al file from whi
0a50: 63 68 20 74 6f 20 72 65 61 64 20 2a 2f 0a 20 20  ch to read */.  
0a60: 76 6f 69 64 20 2a 7a 42 75 66 2c 20 20 20 20 20  void *zBuf,     
0a70: 20 20 20 20 20 20 20 2f 2a 20 50 75 74 20 74 68         /* Put th
0a80: 65 20 72 65 73 75 6c 74 73 20 68 65 72 65 20 2a  e results here *
0a90: 2f 0a 20 20 69 6e 74 20 69 41 6d 74 2c 20 20 20  /.  int iAmt,   
0aa0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75             /* Nu
0ab0: 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 74 6f  mber of bytes to
0ac0: 20 72 65 61 64 20 2a 2f 0a 20 20 73 71 6c 69 74   read */.  sqlit
0ad0: 65 5f 69 6e 74 36 34 20 69 4f 66 73 74 20 20 20  e_int64 iOfst   
0ae0: 20 20 2f 2a 20 42 65 67 69 6e 20 72 65 61 64 69    /* Begin readi
0af0: 6e 67 20 61 74 20 74 68 69 73 20 6f 66 66 73 65  ng at this offse
0b00: 74 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63  t */.){.  int rc
0b10: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20   = SQLITE_OK;.  
0b20: 4a 6f 75 72 6e 61 6c 46 69 6c 65 20 2a 70 20 3d  JournalFile *p =
0b30: 20 28 4a 6f 75 72 6e 61 6c 46 69 6c 65 20 2a 29   (JournalFile *)
0b40: 70 4a 66 64 3b 0a 20 20 69 66 28 20 70 2d 3e 70  pJfd;.  if( p->p
0b50: 52 65 61 6c 20 29 7b 0a 20 20 20 20 72 63 20 3d  Real ){.    rc =
0b60: 20 73 71 6c 69 74 65 33 4f 73 52 65 61 64 28 70   sqlite3OsRead(p
0b70: 2d 3e 70 52 65 61 6c 2c 20 7a 42 75 66 2c 20 69  ->pReal, zBuf, i
0b80: 41 6d 74 2c 20 69 4f 66 73 74 29 3b 0a 20 20 7d  Amt, iOfst);.  }
0b90: 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 72 74  else{.    assert
0ba0: 28 20 69 41 6d 74 2b 69 4f 66 73 74 3c 3d 70 2d  ( iAmt+iOfst<=p-
0bb0: 3e 69 53 69 7a 65 20 29 3b 0a 20 20 20 20 6d 65  >iSize );.    me
0bc0: 6d 63 70 79 28 7a 42 75 66 2c 20 26 70 2d 3e 7a  mcpy(zBuf, &p->z
0bd0: 42 75 66 5b 69 4f 66 73 74 5d 2c 20 69 41 6d 74  Buf[iOfst], iAmt
0be0: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  );.  }.  return 
0bf0: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 72 69  rc;.}../*.** Wri
0c00: 74 65 20 64 61 74 61 20 74 6f 20 74 68 65 20 66  te data to the f
0c10: 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ile..*/.static i
0c20: 6e 74 20 6a 72 6e 6c 57 72 69 74 65 28 0a 20 20  nt jrnlWrite(.  
0c30: 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 4a  sqlite3_file *pJ
0c40: 66 64 2c 20 20 20 20 2f 2a 20 54 68 65 20 6a 6f  fd,    /* The jo
0c50: 75 72 6e 61 6c 20 66 69 6c 65 20 69 6e 74 6f 20  urnal file into 
0c60: 77 68 69 63 68 20 74 6f 20 77 72 69 74 65 20 2a  which to write *
0c70: 2f 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a  /.  const void *
0c80: 7a 42 75 66 2c 20 20 20 20 20 20 2f 2a 20 54 61  zBuf,      /* Ta
0c90: 6b 65 20 64 61 74 61 20 74 6f 20 62 65 20 77 72  ke data to be wr
0ca0: 69 74 74 65 6e 20 66 72 6f 6d 20 68 65 72 65 20  itten from here 
0cb0: 2a 2f 0a 20 20 69 6e 74 20 69 41 6d 74 2c 20 20  */.  int iAmt,  
0cc0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e              /* N
0cd0: 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 74  umber of bytes t
0ce0: 6f 20 77 72 69 74 65 20 2a 2f 0a 20 20 73 71 6c  o write */.  sql
0cf0: 69 74 65 5f 69 6e 74 36 34 20 69 4f 66 73 74 20  ite_int64 iOfst 
0d00: 20 20 20 20 2f 2a 20 42 65 67 69 6e 20 77 72 69      /* Begin wri
0d10: 74 69 6e 67 20 61 74 20 74 68 69 73 20 6f 66 66  ting at this off
0d20: 73 65 74 20 69 6e 74 6f 20 74 68 65 20 66 69 6c  set into the fil
0d30: 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63  e */.){.  int rc
0d40: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20   = SQLITE_OK;.  
0d50: 4a 6f 75 72 6e 61 6c 46 69 6c 65 20 2a 70 20 3d  JournalFile *p =
0d60: 20 28 4a 6f 75 72 6e 61 6c 46 69 6c 65 20 2a 29   (JournalFile *)
0d70: 70 4a 66 64 3b 0a 20 20 69 66 28 20 21 70 2d 3e  pJfd;.  if( !p->
0d80: 70 52 65 61 6c 20 26 26 20 28 69 4f 66 73 74 2b  pReal && (iOfst+
0d90: 69 41 6d 74 29 3e 70 2d 3e 6e 42 75 66 20 29 7b  iAmt)>p->nBuf ){
0da0: 0a 20 20 20 20 72 63 20 3d 20 63 72 65 61 74 65  .    rc = create
0db0: 46 69 6c 65 28 70 29 3b 0a 20 20 7d 0a 20 20 69  File(p);.  }.  i
0dc0: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
0dd0: 20 29 7b 0a 20 20 20 20 69 66 28 20 70 2d 3e 70   ){.    if( p->p
0de0: 52 65 61 6c 20 29 7b 0a 20 20 20 20 20 20 72 63  Real ){.      rc
0df0: 20 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 69 74   = sqlite3OsWrit
0e00: 65 28 70 2d 3e 70 52 65 61 6c 2c 20 7a 42 75 66  e(p->pReal, zBuf
0e10: 2c 20 69 41 6d 74 2c 20 69 4f 66 73 74 29 3b 0a  , iAmt, iOfst);.
0e20: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
0e30: 20 6d 65 6d 63 70 79 28 26 70 2d 3e 7a 42 75 66   memcpy(&p->zBuf
0e40: 5b 69 4f 66 73 74 5d 2c 20 7a 42 75 66 2c 20 69  [iOfst], zBuf, i
0e50: 41 6d 74 29 3b 0a 20 20 20 20 20 20 69 66 28 20  Amt);.      if( 
0e60: 70 2d 3e 69 53 69 7a 65 3c 28 69 4f 66 73 74 2b  p->iSize<(iOfst+
0e70: 69 41 6d 74 29 20 29 7b 0a 20 20 20 20 20 20 20  iAmt) ){.       
0e80: 20 70 2d 3e 69 53 69 7a 65 20 3d 20 28 69 4f 66   p->iSize = (iOf
0e90: 73 74 2b 69 41 6d 74 29 3b 0a 20 20 20 20 20 20  st+iAmt);.      
0ea0: 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65  }.    }.  }.  re
0eb0: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a  turn rc;.}../*.*
0ec0: 2a 20 54 72 75 6e 63 61 74 65 20 74 68 65 20 66  * Truncate the f
0ed0: 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ile..*/.static i
0ee0: 6e 74 20 6a 72 6e 6c 54 72 75 6e 63 61 74 65 28  nt jrnlTruncate(
0ef0: 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 4a  sqlite3_file *pJ
0f00: 66 64 2c 20 73 71 6c 69 74 65 5f 69 6e 74 36 34  fd, sqlite_int64
0f10: 20 73 69 7a 65 29 7b 0a 20 20 69 6e 74 20 72 63   size){.  int rc
0f20: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20   = SQLITE_OK;.  
0f30: 4a 6f 75 72 6e 61 6c 46 69 6c 65 20 2a 70 20 3d  JournalFile *p =
0f40: 20 28 4a 6f 75 72 6e 61 6c 46 69 6c 65 20 2a 29   (JournalFile *)
0f50: 70 4a 66 64 3b 0a 20 20 69 66 28 20 70 2d 3e 70  pJfd;.  if( p->p
0f60: 52 65 61 6c 20 29 7b 0a 20 20 20 20 72 63 20 3d  Real ){.    rc =
0f70: 20 73 71 6c 69 74 65 33 4f 73 54 72 75 6e 63 61   sqlite3OsTrunca
0f80: 74 65 28 70 2d 3e 70 52 65 61 6c 2c 20 73 69 7a  te(p->pReal, siz
0f90: 65 29 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20  e);.  }else if( 
0fa0: 73 69 7a 65 3c 70 2d 3e 69 53 69 7a 65 20 29 7b  size<p->iSize ){
0fb0: 0a 20 20 20 20 70 2d 3e 69 53 69 7a 65 20 3d 20  .    p->iSize = 
0fc0: 73 69 7a 65 3b 0a 20 20 7d 0a 20 20 72 65 74 75  size;.  }.  retu
0fd0: 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  rn rc;.}../*.** 
0fe0: 53 79 6e 63 20 74 68 65 20 66 69 6c 65 2e 0a 2a  Sync the file..*
0ff0: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6a 72 6e  /.static int jrn
1000: 6c 53 79 6e 63 28 73 71 6c 69 74 65 33 5f 66 69  lSync(sqlite3_fi
1010: 6c 65 20 2a 70 4a 66 64 2c 20 69 6e 74 20 66 6c  le *pJfd, int fl
1020: 61 67 73 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a  ags){.  int rc;.
1030: 20 20 4a 6f 75 72 6e 61 6c 46 69 6c 65 20 2a 70    JournalFile *p
1040: 20 3d 20 28 4a 6f 75 72 6e 61 6c 46 69 6c 65 20   = (JournalFile 
1050: 2a 29 70 4a 66 64 3b 0a 20 20 69 66 28 20 70 2d  *)pJfd;.  if( p-
1060: 3e 70 52 65 61 6c 20 29 7b 0a 20 20 20 20 72 63  >pReal ){.    rc
1070: 20 3d 20 73 71 6c 69 74 65 33 4f 73 53 79 6e 63   = sqlite3OsSync
1080: 28 70 2d 3e 70 52 65 61 6c 2c 20 66 6c 61 67 73  (p->pReal, flags
1090: 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  );.  }else{.    
10a0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  rc = SQLITE_OK;.
10b0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b    }.  return rc;
10c0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 51 75 65 72 79 20  .}../*.** Query 
10d0: 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20  the size of the 
10e0: 66 69 6c 65 20 69 6e 20 62 79 74 65 73 2e 0a 2a  file in bytes..*
10f0: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6a 72 6e  /.static int jrn
1100: 6c 46 69 6c 65 53 69 7a 65 28 73 71 6c 69 74 65  lFileSize(sqlite
1110: 33 5f 66 69 6c 65 20 2a 70 4a 66 64 2c 20 73 71  3_file *pJfd, sq
1120: 6c 69 74 65 5f 69 6e 74 36 34 20 2a 70 53 69 7a  lite_int64 *pSiz
1130: 65 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53  e){.  int rc = S
1140: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 4a 6f 75 72  QLITE_OK;.  Jour
1150: 6e 61 6c 46 69 6c 65 20 2a 70 20 3d 20 28 4a 6f  nalFile *p = (Jo
1160: 75 72 6e 61 6c 46 69 6c 65 20 2a 29 70 4a 66 64  urnalFile *)pJfd
1170: 3b 0a 20 20 69 66 28 20 70 2d 3e 70 52 65 61 6c  ;.  if( p->pReal
1180: 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c   ){.    rc = sql
1190: 69 74 65 33 4f 73 46 69 6c 65 53 69 7a 65 28 70  ite3OsFileSize(p
11a0: 2d 3e 70 52 65 61 6c 2c 20 70 53 69 7a 65 29 3b  ->pReal, pSize);
11b0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2a 70  .  }else{.    *p
11c0: 53 69 7a 65 20 3d 20 28 73 71 6c 69 74 65 5f 69  Size = (sqlite_i
11d0: 6e 74 36 34 29 20 70 2d 3e 69 53 69 7a 65 3b 0a  nt64) p->iSize;.
11e0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b    }.  return rc;
11f0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 61 62 6c 65 20  .}../*.** Table 
1200: 6f 66 20 6d 65 74 68 6f 64 73 20 66 6f 72 20 4a  of methods for J
1210: 6f 75 72 6e 61 6c 46 69 6c 65 20 73 71 6c 69 74  ournalFile sqlit
1220: 65 33 5f 66 69 6c 65 20 6f 62 6a 65 63 74 2e 0a  e3_file object..
1230: 2a 2f 0a 73 74 61 74 69 63 20 73 74 72 75 63 74  */.static struct
1240: 20 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68   sqlite3_io_meth
1250: 6f 64 73 20 4a 6f 75 72 6e 61 6c 46 69 6c 65 4d  ods JournalFileM
1260: 65 74 68 6f 64 73 20 3d 20 7b 0a 20 20 31 2c 20  ethods = {.  1, 
1270: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 69              /* i
1280: 56 65 72 73 69 6f 6e 20 2a 2f 0a 20 20 6a 72 6e  Version */.  jrn
1290: 6c 43 6c 6f 73 65 2c 20 20 20 20 20 2f 2a 20 78  lClose,     /* x
12a0: 43 6c 6f 73 65 20 2a 2f 0a 20 20 6a 72 6e 6c 52  Close */.  jrnlR
12b0: 65 61 64 2c 20 20 20 20 20 20 2f 2a 20 78 52 65  ead,      /* xRe
12c0: 61 64 20 2a 2f 0a 20 20 6a 72 6e 6c 57 72 69 74  ad */.  jrnlWrit
12d0: 65 2c 20 20 20 20 20 2f 2a 20 78 57 72 69 74 65  e,     /* xWrite
12e0: 20 2a 2f 0a 20 20 6a 72 6e 6c 54 72 75 6e 63 61   */.  jrnlTrunca
12f0: 74 65 2c 20 20 2f 2a 20 78 54 72 75 6e 63 61 74  te,  /* xTruncat
1300: 65 20 2a 2f 0a 20 20 6a 72 6e 6c 53 79 6e 63 2c  e */.  jrnlSync,
1310: 20 20 20 20 20 20 2f 2a 20 78 53 79 6e 63 20 2a        /* xSync *
1320: 2f 0a 20 20 6a 72 6e 6c 46 69 6c 65 53 69 7a 65  /.  jrnlFileSize
1330: 2c 20 20 2f 2a 20 78 46 69 6c 65 53 69 7a 65 20  ,  /* xFileSize 
1340: 2a 2f 0a 20 20 30 2c 20 20 20 20 20 20 20 20 20  */.  0,         
1350: 20 20 20 20 2f 2a 20 78 4c 6f 63 6b 20 2a 2f 0a      /* xLock */.
1360: 20 20 30 2c 20 20 20 20 20 20 20 20 20 20 20 20    0,            
1370: 20 2f 2a 20 78 55 6e 6c 6f 63 6b 20 2a 2f 0a 20   /* xUnlock */. 
1380: 20 30 2c 20 20 20 20 20 20 20 20 20 20 20 20 20   0,             
1390: 2f 2a 20 78 43 68 65 63 6b 52 65 73 65 72 76 65  /* xCheckReserve
13a0: 64 4c 6f 63 6b 20 2a 2f 0a 20 20 30 2c 20 20 20  dLock */.  0,   
13b0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 46 69            /* xFi
13c0: 6c 65 43 6f 6e 74 72 6f 6c 20 2a 2f 0a 20 20 30  leControl */.  0
13d0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ,             /*
13e0: 20 78 53 65 63 74 6f 72 53 69 7a 65 20 2a 2f 0a   xSectorSize */.
13f0: 20 20 30 20 20 20 20 20 20 20 20 20 20 20 20 20    0             
1400: 20 2f 2a 20 78 44 65 76 69 63 65 43 68 61 72 61   /* xDeviceChara
1410: 63 74 65 72 69 73 74 69 63 73 20 2a 2f 0a 7d 3b  cteristics */.};
1420: 0a 0a 2f 2a 20 0a 2a 2a 20 4f 70 65 6e 20 61 20  ../* .** Open a 
1430: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 0a 2a 2f  journal file..*/
1440: 0a 69 6e 74 20 73 71 6c 69 74 65 33 4a 6f 75 72  .int sqlite3Jour
1450: 6e 61 6c 4f 70 65 6e 28 0a 20 20 73 71 6c 69 74  nalOpen(.  sqlit
1460: 65 33 5f 76 66 73 20 2a 70 56 66 73 2c 20 20 20  e3_vfs *pVfs,   
1470: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 56 46 53        /* The VFS
1480: 20 74 6f 20 75 73 65 20 66 6f 72 20 61 63 74 75   to use for actu
1490: 61 6c 20 66 69 6c 65 20 49 2f 4f 20 2a 2f 0a 20  al file I/O */. 
14a0: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61   const char *zNa
14b0: 6d 65 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 4e  me,         /* N
14c0: 61 6d 65 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e  ame of the journ
14d0: 61 6c 20 66 69 6c 65 20 2a 2f 0a 20 20 73 71 6c  al file */.  sql
14e0: 69 74 65 33 5f 66 69 6c 65 20 2a 70 4a 66 64 2c  ite3_file *pJfd,
14f0: 20 20 20 20 20 20 20 20 2f 2a 20 50 72 65 61 6c          /* Preal
1500: 6c 6f 63 61 74 65 64 2c 20 62 6c 61 6e 6b 20 66  located, blank f
1510: 69 6c 65 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20  ile handle */.  
1520: 69 6e 74 20 66 6c 61 67 73 2c 20 20 20 20 20 20  int flags,      
1530: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 70             /* Op
1540: 65 6e 69 6e 67 20 66 6c 61 67 73 20 2a 2f 0a 20  ening flags */. 
1550: 20 69 6e 74 20 6e 42 75 66 20 20 20 20 20 20 20   int nBuf       
1560: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42              /* B
1570: 79 74 65 73 20 62 75 66 66 65 72 65 64 20 62 65  ytes buffered be
1580: 66 6f 72 65 20 6f 70 65 6e 69 6e 67 20 74 68 65  fore opening the
1590: 20 66 69 6c 65 20 2a 2f 0a 29 7b 0a 20 20 4a 6f   file */.){.  Jo
15a0: 75 72 6e 61 6c 46 69 6c 65 20 2a 70 20 3d 20 28  urnalFile *p = (
15b0: 4a 6f 75 72 6e 61 6c 46 69 6c 65 20 2a 29 70 4a  JournalFile *)pJ
15c0: 66 64 3b 0a 20 20 6d 65 6d 73 65 74 28 70 2c 20  fd;.  memset(p, 
15d0: 30 2c 20 73 71 6c 69 74 65 33 4a 6f 75 72 6e 61  0, sqlite3Journa
15e0: 6c 53 69 7a 65 28 70 56 66 73 29 29 3b 0a 20 20  lSize(pVfs));.  
15f0: 69 66 28 20 6e 42 75 66 3e 30 20 29 7b 0a 20 20  if( nBuf>0 ){.  
1600: 20 20 70 2d 3e 7a 42 75 66 20 3d 20 73 71 6c 69    p->zBuf = sqli
1610: 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 6e 42  te3MallocZero(nB
1620: 75 66 29 3b 0a 20 20 20 20 69 66 28 20 21 70 2d  uf);.    if( !p-
1630: 3e 7a 42 75 66 20 29 7b 0a 20 20 20 20 20 20 72  >zBuf ){.      r
1640: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d  eturn SQLITE_NOM
1650: 45 4d 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73  EM;.    }.  }els
1660: 65 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 73 71  e{.    return sq
1670: 6c 69 74 65 33 4f 73 4f 70 65 6e 28 70 56 66 73  lite3OsOpen(pVfs
1680: 2c 20 7a 4e 61 6d 65 2c 20 70 4a 66 64 2c 20 66  , zName, pJfd, f
1690: 6c 61 67 73 2c 20 30 29 3b 0a 20 20 7d 0a 20 20  lags, 0);.  }.  
16a0: 70 2d 3e 70 4d 65 74 68 6f 64 20 3d 20 26 4a 6f  p->pMethod = &Jo
16b0: 75 72 6e 61 6c 46 69 6c 65 4d 65 74 68 6f 64 73  urnalFileMethods
16c0: 3b 0a 20 20 70 2d 3e 6e 42 75 66 20 3d 20 6e 42  ;.  p->nBuf = nB
16d0: 75 66 3b 0a 20 20 70 2d 3e 66 6c 61 67 73 20 3d  uf;.  p->flags =
16e0: 20 66 6c 61 67 73 3b 0a 20 20 70 2d 3e 7a 4a 6f   flags;.  p->zJo
16f0: 75 72 6e 61 6c 20 3d 20 7a 4e 61 6d 65 3b 0a 20  urnal = zName;. 
1700: 20 70 2d 3e 70 56 66 73 20 3d 20 70 56 66 73 3b   p->pVfs = pVfs;
1710: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
1720: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66  _OK;.}../*.** If
1730: 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 70 20   the argument p 
1740: 70 6f 69 6e 74 73 20 74 6f 20 61 20 4a 6f 75 72  points to a Jour
1750: 6e 61 6c 46 69 6c 65 20 73 74 72 75 63 74 75 72  nalFile structur
1760: 65 2c 20 61 6e 64 20 74 68 65 20 75 6e 64 65 72  e, and the under
1770: 6c 79 69 6e 67 0a 2a 2a 20 66 69 6c 65 20 68 61  lying.** file ha
1780: 73 20 6e 6f 74 20 79 65 74 20 62 65 65 6e 20 63  s not yet been c
1790: 72 65 61 74 65 64 2c 20 63 72 65 61 74 65 20 69  reated, create i
17a0: 74 20 6e 6f 77 2e 0a 2a 2f 0a 69 6e 74 20 73 71  t now..*/.int sq
17b0: 6c 69 74 65 33 4a 6f 75 72 6e 61 6c 43 72 65 61  lite3JournalCrea
17c0: 74 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20  te(sqlite3_file 
17d0: 2a 70 29 7b 0a 20 20 69 66 28 20 70 2d 3e 70 4d  *p){.  if( p->pM
17e0: 65 74 68 6f 64 73 21 3d 26 4a 6f 75 72 6e 61 6c  ethods!=&Journal
17f0: 46 69 6c 65 4d 65 74 68 6f 64 73 20 29 7b 0a 20  FileMethods ){. 
1800: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
1810: 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72  _OK;.  }.  retur
1820: 6e 20 63 72 65 61 74 65 46 69 6c 65 28 28 4a 6f  n createFile((Jo
1830: 75 72 6e 61 6c 46 69 6c 65 20 2a 29 70 29 3b 0a  urnalFile *)p);.
1840: 7d 0a 0a 2f 2a 20 0a 2a 2a 20 52 65 74 75 72 6e  }../* .** Return
1850: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62   the number of b
1860: 79 74 65 73 20 72 65 71 75 69 72 65 64 20 74 6f  ytes required to
1870: 20 73 74 6f 72 65 20 61 20 4a 6f 75 72 6e 61 6c   store a Journal
1880: 46 69 6c 65 20 74 68 61 74 20 75 73 65 73 20 76  File that uses v
1890: 66 73 0a 2a 2a 20 70 56 66 73 20 74 6f 20 63 72  fs.** pVfs to cr
18a0: 65 61 74 65 20 74 68 65 20 75 6e 64 65 72 6c 79  eate the underly
18b0: 69 6e 67 20 6f 6e 2d 64 69 73 6b 20 66 69 6c 65  ing on-disk file
18c0: 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  s..*/.int sqlite
18d0: 33 4a 6f 75 72 6e 61 6c 53 69 7a 65 28 73 71 6c  3JournalSize(sql
18e0: 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73 29 7b  ite3_vfs *pVfs){
18f0: 0a 20 20 72 65 74 75 72 6e 20 28 70 56 66 73 2d  .  return (pVfs-
1900: 3e 73 7a 4f 73 46 69 6c 65 2b 73 69 7a 65 6f 66  >szOsFile+sizeof
1910: 28 4a 6f 75 72 6e 61 6c 46 69 6c 65 29 29 3b 0a  (JournalFile));.
1920: 7d 0a 23 65 6e 64 69 66 0a                       }.#endif.