/ Hex Artifact Content
Login

Artifact b4124532212b6952f42eb2c12fa3c25701d8ba8d:


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 54 68 69 73 20 66  ***.**.** This f
0180: 69 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 73 20 61  ile implements a
0190: 20 73 70 65 63 69 61 6c 20 6b 69 6e 64 20 6f 66   special kind of
01a0: 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 6f 62   sqlite3_file ob
01b0: 6a 65 63 74 20 75 73 65 64 0a 2a 2a 20 62 79 20  ject used.** by 
01c0: 53 51 4c 69 74 65 20 74 6f 20 63 72 65 61 74 65  SQLite to create
01d0: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 73 20 69   journal files i
01e0: 66 20 74 68 65 20 61 74 6f 6d 69 63 2d 77 72 69  f the atomic-wri
01f0: 74 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 0a  te optimization.
0200: 2a 2a 20 69 73 20 65 6e 61 62 6c 65 64 2e 0a 2a  ** is enabled..*
0210: 2a 0a 2a 2a 20 54 68 65 20 64 69 73 74 69 6e 63  *.** The distinc
0220: 74 69 76 65 20 63 68 61 72 61 63 74 65 72 69 73  tive characteris
0230: 74 69 63 20 6f 66 20 74 68 69 73 20 73 71 6c 69  tic of this sqli
0240: 74 65 33 5f 66 69 6c 65 20 69 73 20 74 68 61 74  te3_file is that
0250: 20 74 68 65 0a 2a 2a 20 61 63 74 75 61 6c 20 6f   the.** actual o
0260: 6e 20 64 69 73 6b 20 66 69 6c 65 20 69 73 20 63  n disk file is c
0270: 72 65 61 74 65 64 20 6c 61 7a 69 6c 79 2e 20 57  reated lazily. W
0280: 68 65 6e 20 74 68 65 20 66 69 6c 65 20 69 73 20  hen the file is 
0290: 63 72 65 61 74 65 64 2c 0a 2a 2a 20 74 68 65 20  created,.** the 
02a0: 63 61 6c 6c 65 72 20 73 70 65 63 69 66 69 65 73  caller specifies
02b0: 20 61 20 62 75 66 66 65 72 20 73 69 7a 65 20 66   a buffer size f
02c0: 6f 72 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20  or an in-memory 
02d0: 62 75 66 66 65 72 20 74 6f 0a 2a 2a 20 62 65 20  buffer to.** be 
02e0: 75 73 65 64 20 74 6f 20 73 65 72 76 69 63 65 20  used to service 
02f0: 72 65 61 64 28 29 20 61 6e 64 20 77 72 69 74 65  read() and write
0300: 28 29 20 72 65 71 75 65 73 74 73 2e 20 54 68 65  () requests. The
0310: 20 61 63 74 75 61 6c 20 66 69 6c 65 0a 2a 2a 20   actual file.** 
0320: 6f 6e 20 64 69 73 6b 20 69 73 20 6e 6f 74 20 63  on disk is not c
0330: 72 65 61 74 65 64 20 6f 72 20 70 6f 70 75 6c 61  reated or popula
0340: 74 65 64 20 75 6e 74 69 6c 20 65 69 74 68 65 72  ted until either
0350: 3a 0a 2a 2a 0a 2a 2a 20 20 20 31 29 20 54 68 65  :.**.**   1) The
0360: 20 69 6e 2d 6d 65 6d 6f 72 79 20 72 65 70 72 65   in-memory repre
0370: 73 65 6e 74 61 74 69 6f 6e 20 67 72 6f 77 73 20  sentation grows 
0380: 74 6f 6f 20 6c 61 72 67 65 20 66 6f 72 20 74 68  too large for th
0390: 65 20 61 6c 6c 6f 63 61 74 65 64 20 0a 2a 2a 20  e allocated .** 
03a0: 20 20 20 20 20 62 75 66 66 65 72 2c 20 6f 72 0a       buffer, or.
03b0: 2a 2a 20 20 20 32 29 20 54 68 65 20 73 71 6c 69  **   2) The sqli
03c0: 74 65 33 4a 6f 75 72 6e 61 6c 43 72 65 61 74 65  te3JournalCreate
03d0: 28 29 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63  () function is c
03e0: 61 6c 6c 65 64 2e 0a 2a 2f 0a 23 69 66 64 65 66  alled..*/.#ifdef
03f0: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41   SQLITE_ENABLE_A
0400: 54 4f 4d 49 43 5f 57 52 49 54 45 0a 23 69 6e 63  TOMIC_WRITE.#inc
0410: 6c 75 64 65 20 22 73 71 6c 69 74 65 49 6e 74 2e  lude "sqliteInt.
0420: 68 22 0a 0a 0a 2f 2a 0a 2a 2a 20 41 20 4a 6f 75  h".../*.** A Jou
0430: 72 6e 61 6c 46 69 6c 65 20 6f 62 6a 65 63 74 20  rnalFile object 
0440: 69 73 20 61 20 73 75 62 63 6c 61 73 73 20 6f 66  is a subclass of
0450: 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 75 73   sqlite3_file us
0460: 65 64 20 62 79 0a 2a 2a 20 61 73 20 61 6e 20 6f  ed by.** as an o
0470: 70 65 6e 20 66 69 6c 65 20 68 61 6e 64 6c 65 20  pen file handle 
0480: 66 6f 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  for journal file
0490: 73 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 4a 6f 75  s..*/.struct Jou
04a0: 72 6e 61 6c 46 69 6c 65 20 7b 0a 20 20 73 71 6c  rnalFile {.  sql
04b0: 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20  ite3_io_methods 
04c0: 2a 70 4d 65 74 68 6f 64 3b 20 20 20 20 2f 2a 20  *pMethod;    /* 
04d0: 49 2f 4f 20 6d 65 74 68 6f 64 73 20 6f 6e 20 6a  I/O methods on j
04e0: 6f 75 72 6e 61 6c 20 66 69 6c 65 73 20 2a 2f 0a  ournal files */.
04f0: 20 20 69 6e 74 20 6e 42 75 66 3b 20 20 20 20 20    int nBuf;     
0500: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0510: 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 7a 42 75    /* Size of zBu
0520: 66 5b 5d 20 69 6e 20 62 79 74 65 73 20 2a 2f 0a  f[] in bytes */.
0530: 20 20 63 68 61 72 20 2a 7a 42 75 66 3b 20 20 20    char *zBuf;   
0540: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0550: 20 20 2f 2a 20 53 70 61 63 65 20 74 6f 20 62 75    /* Space to bu
0560: 66 66 65 72 20 6a 6f 75 72 6e 61 6c 20 77 72 69  ffer journal wri
0570: 74 65 73 20 2a 2f 0a 20 20 69 6e 74 20 69 53 69  tes */.  int iSi
0580: 7a 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  ze;             
0590: 20 20 20 20 20 20 20 20 20 2f 2a 20 41 6d 6f 75           /* Amou
05a0: 6e 74 20 6f 66 20 7a 42 75 66 5b 5d 20 63 75 72  nt of zBuf[] cur
05b0: 72 65 6e 74 6c 79 20 75 73 65 64 20 2a 2f 0a 20  rently used */. 
05c0: 20 69 6e 74 20 66 6c 61 67 73 3b 20 20 20 20 20   int flags;     
05d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
05e0: 20 2f 2a 20 78 4f 70 65 6e 20 66 6c 61 67 73 20   /* xOpen flags 
05f0: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73  */.  sqlite3_vfs
0600: 20 2a 70 56 66 73 3b 20 20 20 20 20 20 20 20 20   *pVfs;         
0610: 20 20 20 20 20 2f 2a 20 54 68 65 20 22 72 65 61       /* The "rea
0620: 6c 22 20 75 6e 64 65 72 6c 79 69 6e 67 20 56 46  l" underlying VF
0630: 53 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 66  S */.  sqlite3_f
0640: 69 6c 65 20 2a 70 52 65 61 6c 3b 20 20 20 20 20  ile *pReal;     
0650: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 22 72         /* The "r
0660: 65 61 6c 22 20 75 6e 64 65 72 6c 79 69 6e 67 20  eal" underlying 
0670: 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20  file descriptor 
0680: 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  */.  const char 
0690: 2a 7a 4a 6f 75 72 6e 61 6c 3b 20 20 20 20 20 20  *zJournal;      
06a0: 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20       /* Name of 
06b0: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  the journal file
06c0: 20 2a 2f 0a 7d 3b 0a 74 79 70 65 64 65 66 20 73   */.};.typedef s
06d0: 74 72 75 63 74 20 4a 6f 75 72 6e 61 6c 46 69 6c  truct JournalFil
06e0: 65 20 4a 6f 75 72 6e 61 6c 46 69 6c 65 3b 0a 0a  e JournalFile;..
06f0: 2f 2a 0a 2a 2a 20 49 66 20 69 74 20 64 6f 65 73  /*.** If it does
0700: 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 65 78 69   not already exi
0710: 73 74 73 2c 20 63 72 65 61 74 65 20 61 6e 64 20  sts, create and 
0720: 70 6f 70 75 6c 61 74 65 20 74 68 65 20 6f 6e 2d  populate the on-
0730: 64 69 73 6b 20 66 69 6c 65 20 0a 2a 2a 20 66 6f  disk file .** fo
0740: 72 20 4a 6f 75 72 6e 61 6c 46 69 6c 65 20 70 2e  r JournalFile p.
0750: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 63  .*/.static int c
0760: 72 65 61 74 65 46 69 6c 65 28 4a 6f 75 72 6e 61  reateFile(Journa
0770: 6c 46 69 6c 65 20 2a 70 29 7b 0a 20 20 69 6e 74  lFile *p){.  int
0780: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
0790: 0a 20 20 69 66 28 20 21 70 2d 3e 70 52 65 61 6c  .  if( !p->pReal
07a0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f   ){.    sqlite3_
07b0: 66 69 6c 65 20 2a 70 52 65 61 6c 20 3d 20 28 73  file *pReal = (s
07c0: 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 29 26 70  qlite3_file *)&p
07d0: 5b 31 5d 3b 0a 20 20 20 20 72 63 20 3d 20 73 71  [1];.    rc = sq
07e0: 6c 69 74 65 33 4f 73 4f 70 65 6e 28 70 2d 3e 70  lite3OsOpen(p->p
07f0: 56 66 73 2c 20 70 2d 3e 7a 4a 6f 75 72 6e 61 6c  Vfs, p->zJournal
0800: 2c 20 70 52 65 61 6c 2c 20 70 2d 3e 66 6c 61 67  , pReal, p->flag
0810: 73 2c 20 30 29 3b 0a 20 20 20 20 69 66 28 20 72  s, 0);.    if( r
0820: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c==SQLITE_OK ){.
0830: 20 20 20 20 20 20 70 2d 3e 70 52 65 61 6c 20 3d        p->pReal =
0840: 20 70 52 65 61 6c 3b 0a 20 20 20 20 20 20 69 66   pReal;.      if
0850: 28 20 70 2d 3e 69 53 69 7a 65 3e 30 20 29 7b 0a  ( p->iSize>0 ){.
0860: 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 70          assert(p
0870: 2d 3e 69 53 69 7a 65 3c 3d 70 2d 3e 6e 42 75 66  ->iSize<=p->nBuf
0880: 29 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20  );.        rc = 
0890: 73 71 6c 69 74 65 33 4f 73 57 72 69 74 65 28 70  sqlite3OsWrite(p
08a0: 2d 3e 70 52 65 61 6c 2c 20 70 2d 3e 7a 42 75 66  ->pReal, p->zBuf
08b0: 2c 20 70 2d 3e 69 53 69 7a 65 2c 20 30 29 3b 0a  , p->iSize, 0);.
08c0: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66        }.      if
08d0: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
08e0: 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 49 66  ){.        /* If
08f0: 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 72   an error occurr
0900: 65 64 20 77 68 69 6c 65 20 77 72 69 74 69 6e 67  ed while writing
0910: 20 74 6f 20 74 68 65 20 66 69 6c 65 2c 20 63 6c   to the file, cl
0920: 6f 73 65 20 69 74 20 62 65 66 6f 72 65 0a 20 20  ose it before.  
0930: 20 20 20 20 20 20 2a 2a 20 72 65 74 75 72 6e 69        ** returni
0940: 6e 67 2e 20 54 68 69 73 20 77 61 79 2c 20 53 51  ng. This way, SQ
0950: 4c 69 74 65 20 75 73 65 73 20 74 68 65 20 69 6e  Lite uses the in
0960: 2d 6d 65 6d 6f 72 79 20 6a 6f 75 72 6e 61 6c 20  -memory journal 
0970: 64 61 74 61 20 74 6f 20 0a 20 20 20 20 20 20 20  data to .       
0980: 20 2a 2a 20 72 6f 6c 6c 20 62 61 63 6b 20 63 68   ** roll back ch
0990: 61 6e 67 65 73 20 6d 61 64 65 20 74 6f 20 74 68  anges made to th
09a0: 65 20 69 6e 74 65 72 6e 61 6c 20 70 61 67 65 2d  e internal page-
09b0: 63 61 63 68 65 20 62 65 66 6f 72 65 20 74 68 69  cache before thi
09c0: 73 0a 20 20 20 20 20 20 20 20 2a 2a 20 66 75 6e  s.        ** fun
09d0: 63 74 69 6f 6e 20 77 61 73 20 63 61 6c 6c 65 64  ction was called
09e0: 2e 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 73 71  .  */.        sq
09f0: 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 52 65  lite3OsClose(pRe
0a00: 61 6c 29 3b 0a 20 20 20 20 20 20 20 20 70 2d 3e  al);.        p->
0a10: 70 52 65 61 6c 20 3d 20 30 3b 0a 20 20 20 20 20  pReal = 0;.     
0a20: 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72   }.    }.  }.  r
0a30: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
0a40: 2a 2a 20 43 6c 6f 73 65 20 74 68 65 20 66 69 6c  ** Close the fil
0a50: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  e..*/.static int
0a60: 20 6a 72 6e 6c 43 6c 6f 73 65 28 73 71 6c 69 74   jrnlClose(sqlit
0a70: 65 33 5f 66 69 6c 65 20 2a 70 4a 66 64 29 7b 0a  e3_file *pJfd){.
0a80: 20 20 4a 6f 75 72 6e 61 6c 46 69 6c 65 20 2a 70    JournalFile *p
0a90: 20 3d 20 28 4a 6f 75 72 6e 61 6c 46 69 6c 65 20   = (JournalFile 
0aa0: 2a 29 70 4a 66 64 3b 0a 20 20 69 66 28 20 70 2d  *)pJfd;.  if( p-
0ab0: 3e 70 52 65 61 6c 20 29 7b 0a 20 20 20 20 73 71  >pReal ){.    sq
0ac0: 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 2d 3e  lite3OsClose(p->
0ad0: 70 52 65 61 6c 29 3b 0a 20 20 7d 0a 20 20 73 71  pReal);.  }.  sq
0ae0: 6c 69 74 65 33 5f 66 72 65 65 28 70 2d 3e 7a 42  lite3_free(p->zB
0af0: 75 66 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51  uf);.  return SQ
0b00: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a  LITE_OK;.}../*.*
0b10: 2a 20 52 65 61 64 20 64 61 74 61 20 66 72 6f 6d  * Read data from
0b20: 20 74 68 65 20 66 69 6c 65 2e 0a 2a 2f 0a 73 74   the file..*/.st
0b30: 61 74 69 63 20 69 6e 74 20 6a 72 6e 6c 52 65 61  atic int jrnlRea
0b40: 64 28 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 6c  d(.  sqlite3_fil
0b50: 65 20 2a 70 4a 66 64 2c 20 20 20 20 2f 2a 20 54  e *pJfd,    /* T
0b60: 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20  he journal file 
0b70: 66 72 6f 6d 20 77 68 69 63 68 20 74 6f 20 72 65  from which to re
0b80: 61 64 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 7a 42  ad */.  void *zB
0b90: 75 66 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f  uf,            /
0ba0: 2a 20 50 75 74 20 74 68 65 20 72 65 73 75 6c 74  * Put the result
0bb0: 73 20 68 65 72 65 20 2a 2f 0a 20 20 69 6e 74 20  s here */.  int 
0bc0: 69 41 6d 74 2c 20 20 20 20 20 20 20 20 20 20 20  iAmt,           
0bd0: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20     /* Number of 
0be0: 62 79 74 65 73 20 74 6f 20 72 65 61 64 20 2a 2f  bytes to read */
0bf0: 0a 20 20 73 71 6c 69 74 65 5f 69 6e 74 36 34 20  .  sqlite_int64 
0c00: 69 4f 66 73 74 20 20 20 20 20 2f 2a 20 42 65 67  iOfst     /* Beg
0c10: 69 6e 20 72 65 61 64 69 6e 67 20 61 74 20 74 68  in reading at th
0c20: 69 73 20 6f 66 66 73 65 74 20 2a 2f 0a 29 7b 0a  is offset */.){.
0c30: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
0c40: 45 5f 4f 4b 3b 0a 20 20 4a 6f 75 72 6e 61 6c 46  E_OK;.  JournalF
0c50: 69 6c 65 20 2a 70 20 3d 20 28 4a 6f 75 72 6e 61  ile *p = (Journa
0c60: 6c 46 69 6c 65 20 2a 29 70 4a 66 64 3b 0a 20 20  lFile *)pJfd;.  
0c70: 69 66 28 20 70 2d 3e 70 52 65 61 6c 20 29 7b 0a  if( p->pReal ){.
0c80: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
0c90: 4f 73 52 65 61 64 28 70 2d 3e 70 52 65 61 6c 2c  OsRead(p->pReal,
0ca0: 20 7a 42 75 66 2c 20 69 41 6d 74 2c 20 69 4f 66   zBuf, iAmt, iOf
0cb0: 73 74 29 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28  st);.  }else if(
0cc0: 20 28 69 41 6d 74 2b 69 4f 66 73 74 29 3e 70 2d   (iAmt+iOfst)>p-
0cd0: 3e 69 53 69 7a 65 20 29 7b 0a 20 20 20 20 72 63  >iSize ){.    rc
0ce0: 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f   = SQLITE_IOERR_
0cf0: 53 48 4f 52 54 5f 52 45 41 44 3b 0a 20 20 7d 65  SHORT_READ;.  }e
0d00: 6c 73 65 7b 0a 20 20 20 20 6d 65 6d 63 70 79 28  lse{.    memcpy(
0d10: 7a 42 75 66 2c 20 26 70 2d 3e 7a 42 75 66 5b 69  zBuf, &p->zBuf[i
0d20: 4f 66 73 74 5d 2c 20 69 41 6d 74 29 3b 0a 20 20  Ofst], iAmt);.  
0d30: 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  }.  return rc;.}
0d40: 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 64 61  ../*.** Write da
0d50: 74 61 20 74 6f 20 74 68 65 20 66 69 6c 65 2e 0a  ta to the file..
0d60: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6a 72  */.static int jr
0d70: 6e 6c 57 72 69 74 65 28 0a 20 20 73 71 6c 69 74  nlWrite(.  sqlit
0d80: 65 33 5f 66 69 6c 65 20 2a 70 4a 66 64 2c 20 20  e3_file *pJfd,  
0d90: 20 20 2f 2a 20 54 68 65 20 6a 6f 75 72 6e 61 6c    /* The journal
0da0: 20 66 69 6c 65 20 69 6e 74 6f 20 77 68 69 63 68   file into which
0db0: 20 74 6f 20 77 72 69 74 65 20 2a 2f 0a 20 20 63   to write */.  c
0dc0: 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 42 75 66 2c  onst void *zBuf,
0dd0: 20 20 20 20 20 20 2f 2a 20 54 61 6b 65 20 64 61        /* Take da
0de0: 74 61 20 74 6f 20 62 65 20 77 72 69 74 74 65 6e  ta to be written
0df0: 20 66 72 6f 6d 20 68 65 72 65 20 2a 2f 0a 20 20   from here */.  
0e00: 69 6e 74 20 69 41 6d 74 2c 20 20 20 20 20 20 20  int iAmt,       
0e10: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72         /* Number
0e20: 20 6f 66 20 62 79 74 65 73 20 74 6f 20 77 72 69   of bytes to wri
0e30: 74 65 20 2a 2f 0a 20 20 73 71 6c 69 74 65 5f 69  te */.  sqlite_i
0e40: 6e 74 36 34 20 69 4f 66 73 74 20 20 20 20 20 2f  nt64 iOfst     /
0e50: 2a 20 42 65 67 69 6e 20 77 72 69 74 69 6e 67 20  * Begin writing 
0e60: 61 74 20 74 68 69 73 20 6f 66 66 73 65 74 20 69  at this offset i
0e70: 6e 74 6f 20 74 68 65 20 66 69 6c 65 20 2a 2f 0a  nto the file */.
0e80: 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51  ){.  int rc = SQ
0e90: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 4a 6f 75 72 6e  LITE_OK;.  Journ
0ea0: 61 6c 46 69 6c 65 20 2a 70 20 3d 20 28 4a 6f 75  alFile *p = (Jou
0eb0: 72 6e 61 6c 46 69 6c 65 20 2a 29 70 4a 66 64 3b  rnalFile *)pJfd;
0ec0: 0a 20 20 69 66 28 20 21 70 2d 3e 70 52 65 61 6c  .  if( !p->pReal
0ed0: 20 26 26 20 28 69 4f 66 73 74 2b 69 41 6d 74 29   && (iOfst+iAmt)
0ee0: 3e 70 2d 3e 6e 42 75 66 20 29 7b 0a 20 20 20 20  >p->nBuf ){.    
0ef0: 72 63 20 3d 20 63 72 65 61 74 65 46 69 6c 65 28  rc = createFile(
0f00: 70 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72 63  p);.  }.  if( rc
0f10: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  ==SQLITE_OK ){. 
0f20: 20 20 20 69 66 28 20 70 2d 3e 70 52 65 61 6c 20     if( p->pReal 
0f30: 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71  ){.      rc = sq
0f40: 6c 69 74 65 33 4f 73 57 72 69 74 65 28 70 2d 3e  lite3OsWrite(p->
0f50: 70 52 65 61 6c 2c 20 7a 42 75 66 2c 20 69 41 6d  pReal, zBuf, iAm
0f60: 74 2c 20 69 4f 66 73 74 29 3b 0a 20 20 20 20 7d  t, iOfst);.    }
0f70: 65 6c 73 65 7b 0a 20 20 20 20 20 20 6d 65 6d 63  else{.      memc
0f80: 70 79 28 26 70 2d 3e 7a 42 75 66 5b 69 4f 66 73  py(&p->zBuf[iOfs
0f90: 74 5d 2c 20 7a 42 75 66 2c 20 69 41 6d 74 29 3b  t], zBuf, iAmt);
0fa0: 0a 20 20 20 20 20 20 69 66 28 20 70 2d 3e 69 53  .      if( p->iS
0fb0: 69 7a 65 3c 28 69 4f 66 73 74 2b 69 41 6d 74 29  ize<(iOfst+iAmt)
0fc0: 20 29 7b 0a 20 20 20 20 20 20 20 20 70 2d 3e 69   ){.        p->i
0fd0: 53 69 7a 65 20 3d 20 28 69 4f 66 73 74 2b 69 41  Size = (iOfst+iA
0fe0: 6d 74 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  mt);.      }.   
0ff0: 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20   }.  }.  return 
1000: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 72 75  rc;.}../*.** Tru
1010: 6e 63 61 74 65 20 74 68 65 20 66 69 6c 65 2e 0a  ncate the file..
1020: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6a 72  */.static int jr
1030: 6e 6c 54 72 75 6e 63 61 74 65 28 73 71 6c 69 74  nlTruncate(sqlit
1040: 65 33 5f 66 69 6c 65 20 2a 70 4a 66 64 2c 20 73  e3_file *pJfd, s
1050: 71 6c 69 74 65 5f 69 6e 74 36 34 20 73 69 7a 65  qlite_int64 size
1060: 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51  ){.  int rc = SQ
1070: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 4a 6f 75 72 6e  LITE_OK;.  Journ
1080: 61 6c 46 69 6c 65 20 2a 70 20 3d 20 28 4a 6f 75  alFile *p = (Jou
1090: 72 6e 61 6c 46 69 6c 65 20 2a 29 70 4a 66 64 3b  rnalFile *)pJfd;
10a0: 0a 20 20 69 66 28 20 70 2d 3e 70 52 65 61 6c 20  .  if( p->pReal 
10b0: 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69  ){.    rc = sqli
10c0: 74 65 33 4f 73 54 72 75 6e 63 61 74 65 28 70 2d  te3OsTruncate(p-
10d0: 3e 70 52 65 61 6c 2c 20 73 69 7a 65 29 3b 0a 20  >pReal, size);. 
10e0: 20 7d 65 6c 73 65 20 69 66 28 20 73 69 7a 65 3c   }else if( size<
10f0: 70 2d 3e 69 53 69 7a 65 20 29 7b 0a 20 20 20 20  p->iSize ){.    
1100: 70 2d 3e 69 53 69 7a 65 20 3d 20 73 69 7a 65 3b  p->iSize = size;
1110: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63  .  }.  return rc
1120: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 79 6e 63 20  ;.}../*.** Sync 
1130: 74 68 65 20 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61  the file..*/.sta
1140: 74 69 63 20 69 6e 74 20 6a 72 6e 6c 53 79 6e 63  tic int jrnlSync
1150: 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70  (sqlite3_file *p
1160: 4a 66 64 2c 20 69 6e 74 20 66 6c 61 67 73 29 7b  Jfd, int flags){
1170: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 4a 6f 75  .  int rc;.  Jou
1180: 72 6e 61 6c 46 69 6c 65 20 2a 70 20 3d 20 28 4a  rnalFile *p = (J
1190: 6f 75 72 6e 61 6c 46 69 6c 65 20 2a 29 70 4a 66  ournalFile *)pJf
11a0: 64 3b 0a 20 20 69 66 28 20 70 2d 3e 70 52 65 61  d;.  if( p->pRea
11b0: 6c 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71  l ){.    rc = sq
11c0: 6c 69 74 65 33 4f 73 53 79 6e 63 28 70 2d 3e 70  lite3OsSync(p->p
11d0: 52 65 61 6c 2c 20 66 6c 61 67 73 29 3b 0a 20 20  Real, flags);.  
11e0: 7d 65 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d 20  }else{.    rc = 
11f0: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20  SQLITE_OK;.  }. 
1200: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f   return rc;.}../
1210: 2a 0a 2a 2a 20 51 75 65 72 79 20 74 68 65 20 73  *.** Query the s
1220: 69 7a 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20  ize of the file 
1230: 69 6e 20 62 79 74 65 73 2e 0a 2a 2f 0a 73 74 61  in bytes..*/.sta
1240: 74 69 63 20 69 6e 74 20 6a 72 6e 6c 46 69 6c 65  tic int jrnlFile
1250: 53 69 7a 65 28 73 71 6c 69 74 65 33 5f 66 69 6c  Size(sqlite3_fil
1260: 65 20 2a 70 4a 66 64 2c 20 73 71 6c 69 74 65 5f  e *pJfd, sqlite_
1270: 69 6e 74 36 34 20 2a 70 53 69 7a 65 29 7b 0a 20  int64 *pSize){. 
1280: 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45   int rc = SQLITE
1290: 5f 4f 4b 3b 0a 20 20 4a 6f 75 72 6e 61 6c 46 69  _OK;.  JournalFi
12a0: 6c 65 20 2a 70 20 3d 20 28 4a 6f 75 72 6e 61 6c  le *p = (Journal
12b0: 46 69 6c 65 20 2a 29 70 4a 66 64 3b 0a 20 20 69  File *)pJfd;.  i
12c0: 66 28 20 70 2d 3e 70 52 65 61 6c 20 29 7b 0a 20  f( p->pReal ){. 
12d0: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f     rc = sqlite3O
12e0: 73 46 69 6c 65 53 69 7a 65 28 70 2d 3e 70 52 65  sFileSize(p->pRe
12f0: 61 6c 2c 20 70 53 69 7a 65 29 3b 0a 20 20 7d 65  al, pSize);.  }e
1300: 6c 73 65 7b 0a 20 20 20 20 2a 70 53 69 7a 65 20  lse{.    *pSize 
1310: 3d 20 28 73 71 6c 69 74 65 5f 69 6e 74 36 34 29  = (sqlite_int64)
1320: 20 70 2d 3e 69 53 69 7a 65 3b 0a 20 20 7d 0a 20   p->iSize;.  }. 
1330: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f   return rc;.}../
1340: 2a 0a 2a 2a 20 54 61 62 6c 65 20 6f 66 20 6d 65  *.** Table of me
1350: 74 68 6f 64 73 20 66 6f 72 20 4a 6f 75 72 6e 61  thods for Journa
1360: 6c 46 69 6c 65 20 73 71 6c 69 74 65 33 5f 66 69  lFile sqlite3_fi
1370: 6c 65 20 6f 62 6a 65 63 74 2e 0a 2a 2f 0a 73 74  le object..*/.st
1380: 61 74 69 63 20 73 74 72 75 63 74 20 73 71 6c 69  atic struct sqli
1390: 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 4a  te3_io_methods J
13a0: 6f 75 72 6e 61 6c 46 69 6c 65 4d 65 74 68 6f 64  ournalFileMethod
13b0: 73 20 3d 20 7b 0a 20 20 31 2c 20 20 20 20 20 20  s = {.  1,      
13c0: 20 20 20 20 20 20 20 2f 2a 20 69 56 65 72 73 69         /* iVersi
13d0: 6f 6e 20 2a 2f 0a 20 20 6a 72 6e 6c 43 6c 6f 73  on */.  jrnlClos
13e0: 65 2c 20 20 20 20 20 2f 2a 20 78 43 6c 6f 73 65  e,     /* xClose
13f0: 20 2a 2f 0a 20 20 6a 72 6e 6c 52 65 61 64 2c 20   */.  jrnlRead, 
1400: 20 20 20 20 20 2f 2a 20 78 52 65 61 64 20 2a 2f       /* xRead */
1410: 0a 20 20 6a 72 6e 6c 57 72 69 74 65 2c 20 20 20  .  jrnlWrite,   
1420: 20 20 2f 2a 20 78 57 72 69 74 65 20 2a 2f 0a 20    /* xWrite */. 
1430: 20 6a 72 6e 6c 54 72 75 6e 63 61 74 65 2c 20 20   jrnlTruncate,  
1440: 2f 2a 20 78 54 72 75 6e 63 61 74 65 20 2a 2f 0a  /* xTruncate */.
1450: 20 20 6a 72 6e 6c 53 79 6e 63 2c 20 20 20 20 20    jrnlSync,     
1460: 20 2f 2a 20 78 53 79 6e 63 20 2a 2f 0a 20 20 6a   /* xSync */.  j
1470: 72 6e 6c 46 69 6c 65 53 69 7a 65 2c 20 20 2f 2a  rnlFileSize,  /*
1480: 20 78 46 69 6c 65 53 69 7a 65 20 2a 2f 0a 20 20   xFileSize */.  
1490: 30 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  0,             /
14a0: 2a 20 78 4c 6f 63 6b 20 2a 2f 0a 20 20 30 2c 20  * xLock */.  0, 
14b0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78              /* x
14c0: 55 6e 6c 6f 63 6b 20 2a 2f 0a 20 20 30 2c 20 20  Unlock */.  0,  
14d0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 43             /* xC
14e0: 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b  heckReservedLock
14f0: 20 2a 2f 0a 20 20 30 2c 20 20 20 20 20 20 20 20   */.  0,        
1500: 20 20 20 20 20 2f 2a 20 78 46 69 6c 65 43 6f 6e       /* xFileCon
1510: 74 72 6f 6c 20 2a 2f 0a 20 20 30 2c 20 20 20 20  trol */.  0,    
1520: 20 20 20 20 20 20 20 20 20 2f 2a 20 78 53 65 63           /* xSec
1530: 74 6f 72 53 69 7a 65 20 2a 2f 0a 20 20 30 2c 20  torSize */.  0, 
1540: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78              /* x
1550: 44 65 76 69 63 65 43 68 61 72 61 63 74 65 72 69  DeviceCharacteri
1560: 73 74 69 63 73 20 2a 2f 0a 20 20 30 2c 20 20 20  stics */.  0,   
1570: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 53 68            /* xSh
1580: 6d 4d 61 70 20 2a 2f 0a 20 20 30 2c 20 20 20 20  mMap */.  0,    
1590: 20 20 20 20 20 20 20 20 20 2f 2a 20 78 53 68 6d           /* xShm
15a0: 4c 6f 63 6b 20 2a 2f 0a 20 20 30 2c 20 20 20 20  Lock */.  0,    
15b0: 20 20 20 20 20 20 20 20 20 2f 2a 20 78 53 68 6d           /* xShm
15c0: 42 61 72 72 69 65 72 20 2a 2f 0a 20 20 30 20 20  Barrier */.  0  
15d0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78              /* x
15e0: 53 68 6d 55 6e 6d 61 70 20 2a 2f 0a 7d 3b 0a 0a  ShmUnmap */.};..
15f0: 2f 2a 20 0a 2a 2a 20 4f 70 65 6e 20 61 20 6a 6f  /* .** Open a jo
1600: 75 72 6e 61 6c 20 66 69 6c 65 2e 0a 2a 2f 0a 69  urnal file..*/.i
1610: 6e 74 20 73 71 6c 69 74 65 33 4a 6f 75 72 6e 61  nt sqlite3Journa
1620: 6c 4f 70 65 6e 28 0a 20 20 73 71 6c 69 74 65 33  lOpen(.  sqlite3
1630: 5f 76 66 73 20 2a 70 56 66 73 2c 20 20 20 20 20  _vfs *pVfs,     
1640: 20 20 20 20 2f 2a 20 54 68 65 20 56 46 53 20 74      /* The VFS t
1650: 6f 20 75 73 65 20 66 6f 72 20 61 63 74 75 61 6c  o use for actual
1660: 20 66 69 6c 65 20 49 2f 4f 20 2a 2f 0a 20 20 63   file I/O */.  c
1670: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65  onst char *zName
1680: 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d  ,         /* Nam
1690: 65 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c  e of the journal
16a0: 20 66 69 6c 65 20 2a 2f 0a 20 20 73 71 6c 69 74   file */.  sqlit
16b0: 65 33 5f 66 69 6c 65 20 2a 70 4a 66 64 2c 20 20  e3_file *pJfd,  
16c0: 20 20 20 20 20 20 2f 2a 20 50 72 65 61 6c 6c 6f        /* Preallo
16d0: 63 61 74 65 64 2c 20 62 6c 61 6e 6b 20 66 69 6c  cated, blank fil
16e0: 65 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 69 6e  e handle */.  in
16f0: 74 20 66 6c 61 67 73 2c 20 20 20 20 20 20 20 20  t flags,        
1700: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 70 65 6e           /* Open
1710: 69 6e 67 20 66 6c 61 67 73 20 2a 2f 0a 20 20 69  ing flags */.  i
1720: 6e 74 20 6e 42 75 66 20 20 20 20 20 20 20 20 20  nt nBuf         
1730: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 79 74            /* Byt
1740: 65 73 20 62 75 66 66 65 72 65 64 20 62 65 66 6f  es buffered befo
1750: 72 65 20 6f 70 65 6e 69 6e 67 20 74 68 65 20 66  re opening the f
1760: 69 6c 65 20 2a 2f 0a 29 7b 0a 20 20 4a 6f 75 72  ile */.){.  Jour
1770: 6e 61 6c 46 69 6c 65 20 2a 70 20 3d 20 28 4a 6f  nalFile *p = (Jo
1780: 75 72 6e 61 6c 46 69 6c 65 20 2a 29 70 4a 66 64  urnalFile *)pJfd
1790: 3b 0a 20 20 6d 65 6d 73 65 74 28 70 2c 20 30 2c  ;.  memset(p, 0,
17a0: 20 73 71 6c 69 74 65 33 4a 6f 75 72 6e 61 6c 53   sqlite3JournalS
17b0: 69 7a 65 28 70 56 66 73 29 29 3b 0a 20 20 69 66  ize(pVfs));.  if
17c0: 28 20 6e 42 75 66 3e 30 20 29 7b 0a 20 20 20 20  ( nBuf>0 ){.    
17d0: 70 2d 3e 7a 42 75 66 20 3d 20 73 71 6c 69 74 65  p->zBuf = sqlite
17e0: 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 6e 42 75 66  3MallocZero(nBuf
17f0: 29 3b 0a 20 20 20 20 69 66 28 20 21 70 2d 3e 7a  );.    if( !p->z
1800: 42 75 66 20 29 7b 0a 20 20 20 20 20 20 72 65 74  Buf ){.      ret
1810: 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  urn SQLITE_NOMEM
1820: 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b  ;.    }.  }else{
1830: 0a 20 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69  .    return sqli
1840: 74 65 33 4f 73 4f 70 65 6e 28 70 56 66 73 2c 20  te3OsOpen(pVfs, 
1850: 7a 4e 61 6d 65 2c 20 70 4a 66 64 2c 20 66 6c 61  zName, pJfd, fla
1860: 67 73 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 70 2d  gs, 0);.  }.  p-
1870: 3e 70 4d 65 74 68 6f 64 20 3d 20 26 4a 6f 75 72  >pMethod = &Jour
1880: 6e 61 6c 46 69 6c 65 4d 65 74 68 6f 64 73 3b 0a  nalFileMethods;.
1890: 20 20 70 2d 3e 6e 42 75 66 20 3d 20 6e 42 75 66    p->nBuf = nBuf
18a0: 3b 0a 20 20 70 2d 3e 66 6c 61 67 73 20 3d 20 66  ;.  p->flags = f
18b0: 6c 61 67 73 3b 0a 20 20 70 2d 3e 7a 4a 6f 75 72  lags;.  p->zJour
18c0: 6e 61 6c 20 3d 20 7a 4e 61 6d 65 3b 0a 20 20 70  nal = zName;.  p
18d0: 2d 3e 70 56 66 73 20 3d 20 70 56 66 73 3b 0a 20  ->pVfs = pVfs;. 
18e0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
18f0: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74  K;.}../*.** If t
1900: 68 65 20 61 72 67 75 6d 65 6e 74 20 70 20 70 6f  he argument p po
1910: 69 6e 74 73 20 74 6f 20 61 20 4a 6f 75 72 6e 61  ints to a Journa
1920: 6c 46 69 6c 65 20 73 74 72 75 63 74 75 72 65 2c  lFile structure,
1930: 20 61 6e 64 20 74 68 65 20 75 6e 64 65 72 6c 79   and the underly
1940: 69 6e 67 0a 2a 2a 20 66 69 6c 65 20 68 61 73 20  ing.** file has 
1950: 6e 6f 74 20 79 65 74 20 62 65 65 6e 20 63 72 65  not yet been cre
1960: 61 74 65 64 2c 20 63 72 65 61 74 65 20 69 74 20  ated, create it 
1970: 6e 6f 77 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  now..*/.int sqli
1980: 74 65 33 4a 6f 75 72 6e 61 6c 43 72 65 61 74 65  te3JournalCreate
1990: 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70  (sqlite3_file *p
19a0: 29 7b 0a 20 20 69 66 28 20 70 2d 3e 70 4d 65 74  ){.  if( p->pMet
19b0: 68 6f 64 73 21 3d 26 4a 6f 75 72 6e 61 6c 46 69  hods!=&JournalFi
19c0: 6c 65 4d 65 74 68 6f 64 73 20 29 7b 0a 20 20 20  leMethods ){.   
19d0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
19e0: 4b 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  K;.  }.  return 
19f0: 63 72 65 61 74 65 46 69 6c 65 28 28 4a 6f 75 72  createFile((Jour
1a00: 6e 61 6c 46 69 6c 65 20 2a 29 70 29 3b 0a 7d 0a  nalFile *)p);.}.
1a10: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 69 6c 65 2d  ./*.** The file-
1a20: 68 61 6e 64 6c 65 20 70 61 73 73 65 64 20 61 73  handle passed as
1a30: 20 74 68 65 20 6f 6e 6c 79 20 61 72 67 75 6d 65   the only argume
1a40: 6e 74 20 69 73 20 67 75 61 72 61 6e 74 65 65 64  nt is guaranteed
1a50: 20 74 6f 20 62 65 20 61 6e 20 6f 70 65 6e 0a 2a   to be an open.*
1a60: 2a 20 66 69 6c 65 2e 20 49 74 20 6d 61 79 20 6f  * file. It may o
1a70: 72 20 6d 61 79 20 6e 6f 74 20 62 65 20 6f 66 20  r may not be of 
1a80: 63 6c 61 73 73 20 4a 6f 75 72 6e 61 6c 46 69 6c  class JournalFil
1a90: 65 2e 20 49 66 20 74 68 65 20 66 69 6c 65 20 69  e. If the file i
1aa0: 73 20 61 0a 2a 2a 20 4a 6f 75 72 6e 61 6c 46 69  s a.** JournalFi
1ab0: 6c 65 2c 20 61 6e 64 20 74 68 65 20 75 6e 64 65  le, and the unde
1ac0: 72 6c 79 69 6e 67 20 66 69 6c 65 20 6f 6e 20 64  rlying file on d
1ad0: 69 73 6b 20 68 61 73 20 6e 6f 74 20 79 65 74 20  isk has not yet 
1ae0: 62 65 65 6e 20 6f 70 65 6e 65 64 2c 0a 2a 2a 20  been opened,.** 
1af0: 72 65 74 75 72 6e 20 30 2e 20 4f 74 68 65 72 77  return 0. Otherw
1b00: 69 73 65 2c 20 72 65 74 75 72 6e 20 31 2e 0a 2a  ise, return 1..*
1b10: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 4a 6f 75  /.int sqlite3Jou
1b20: 72 6e 61 6c 45 78 69 73 74 73 28 73 71 6c 69 74  rnalExists(sqlit
1b30: 65 33 5f 66 69 6c 65 20 2a 70 29 7b 0a 20 20 72  e3_file *p){.  r
1b40: 65 74 75 72 6e 20 28 70 2d 3e 70 4d 65 74 68 6f  eturn (p->pMetho
1b50: 64 73 21 3d 26 4a 6f 75 72 6e 61 6c 46 69 6c 65  ds!=&JournalFile
1b60: 4d 65 74 68 6f 64 73 20 7c 7c 20 28 28 4a 6f 75  Methods || ((Jou
1b70: 72 6e 61 6c 46 69 6c 65 20 2a 29 70 29 2d 3e 70  rnalFile *)p)->p
1b80: 52 65 61 6c 21 3d 30 29 3b 0a 7d 0a 0a 2f 2a 20  Real!=0);.}../* 
1b90: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e  .** Return the n
1ba0: 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 72  umber of bytes r
1bb0: 65 71 75 69 72 65 64 20 74 6f 20 73 74 6f 72 65  equired to store
1bc0: 20 61 20 4a 6f 75 72 6e 61 6c 46 69 6c 65 20 74   a JournalFile t
1bd0: 68 61 74 20 75 73 65 73 20 76 66 73 0a 2a 2a 20  hat uses vfs.** 
1be0: 70 56 66 73 20 74 6f 20 63 72 65 61 74 65 20 74  pVfs to create t
1bf0: 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 6f 6e  he underlying on
1c00: 2d 64 69 73 6b 20 66 69 6c 65 73 2e 0a 2a 2f 0a  -disk files..*/.
1c10: 69 6e 74 20 73 71 6c 69 74 65 33 4a 6f 75 72 6e  int sqlite3Journ
1c20: 61 6c 53 69 7a 65 28 73 71 6c 69 74 65 33 5f 76  alSize(sqlite3_v
1c30: 66 73 20 2a 70 56 66 73 29 7b 0a 20 20 72 65 74  fs *pVfs){.  ret
1c40: 75 72 6e 20 28 70 56 66 73 2d 3e 73 7a 4f 73 46  urn (pVfs->szOsF
1c50: 69 6c 65 2b 73 69 7a 65 6f 66 28 4a 6f 75 72 6e  ile+sizeof(Journ
1c60: 61 6c 46 69 6c 65 29 29 3b 0a 7d 0a 23 65 6e 64  alFile));.}.#end
1c70: 69 66 0a                                         if.