Documentation Source Text

Hex Artifact Content
Login

Artifact 4ee6311085fd3053057fa22d8082cd1773d95f43:


0000: 48 4c 52 20 48 33 35 30 31 30 20 0a 45 78 63 65  HLR H35010 .Exce
0010: 70 74 20 66 6f 72 20 74 68 65 20 72 65 61 64 20  pt for the read 
0020: 6f 70 65 72 61 74 69 6f 6e 20 72 65 71 75 69 72  operation requir
0030: 65 64 20 62 79 20 48 33 35 30 37 30 20 61 6e 64  ed by H35070 and
0040: 20 74 68 6f 73 65 20 72 65 61 64 73 20 6d 61 64   those reads mad
0050: 65 0a 61 73 20 70 61 72 74 20 6f 66 20 6f 70 65  e.as part of ope
0060: 6e 69 6e 67 20 61 20 72 65 61 64 2d 6f 6e 6c 79  ning a read-only
0070: 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 53 51   transaction, SQ
0080: 4c 69 74 65 20 73 68 61 6c 6c 20 65 6e 73 75 72  Lite shall ensur
0090: 65 20 74 68 61 74 0a 61 20 3c 69 3e 64 61 74 61  e that.a <i>data
00a0: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 3c  base connection<
00b0: 2f 69 3e 20 68 61 73 20 61 6e 20 6f 70 65 6e 20  /i> has an open 
00c0: 72 65 61 64 2d 6f 6e 6c 79 20 6f 72 20 72 65 61  read-only or rea
00d0: 64 2f 77 72 69 74 65 0a 74 72 61 6e 73 61 63 74  d/write.transact
00e0: 69 6f 6e 20 77 68 65 6e 20 61 6e 79 20 64 61 74  ion when any dat
00f0: 61 20 69 73 20 72 65 61 64 20 66 72 6f 6d 20 74  a is read from t
0100: 68 65 20 3c 69 3e 64 61 74 61 62 61 73 65 20 66  he <i>database f
0110: 69 6c 65 3c 2f 69 3e 2e 0a 0a 48 4c 52 20 48 33  ile</i>...HLR H3
0120: 35 30 32 30 20 0a 41 73 69 64 65 20 66 72 6f 6d  5020 .Aside from
0130: 20 74 68 6f 73 65 20 72 65 61 64 20 6f 70 65 72   those read oper
0140: 61 74 69 6f 6e 73 20 64 65 73 63 72 69 62 65 64  ations described
0150: 20 62 79 20 48 33 35 30 37 30 20 61 6e 64 20 48   by H35070 and H
0160: 32 31 58 58 58 2c 20 53 51 4c 69 74 65 0a 73 68  21XXX, SQLite.sh
0170: 61 6c 6c 20 72 65 61 64 20 64 61 74 61 20 66 72  all read data fr
0180: 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 20  om the database 
0190: 66 69 6c 65 20 69 6e 20 61 6c 69 67 6e 65 64 20  file in aligned 
01a0: 62 6c 6f 63 6b 73 20 6f 66 0a 3c 69 3e 70 61 67  blocks of.<i>pag
01b0: 65 2d 73 69 7a 65 3c 2f 69 3e 20 62 79 74 65 73  e-size</i> bytes
01c0: 2c 20 77 68 65 72 65 20 3c 69 3e 70 61 67 65 2d  , where <i>page-
01d0: 73 69 7a 65 3c 2f 69 3e 20 69 73 20 74 68 65 20  size</i> is the 
01e0: 64 61 74 61 62 61 73 65 20 70 61 67 65 20 73 69  database page si
01f0: 7a 65 0a 75 73 65 64 20 62 79 20 74 68 65 20 64  ze.used by the d
0200: 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 0a 48  atabase file...H
0210: 4c 52 20 48 33 35 30 33 30 20 0a 57 68 69 6c 65  LR H35030 .While
0220: 20 6f 70 65 6e 69 6e 67 20 61 20 3c 69 3e 72 65   opening a <i>re
0230: 61 64 2d 6f 6e 6c 79 20 74 72 61 6e 73 61 63 74  ad-only transact
0240: 69 6f 6e 3c 2f 69 3e 2c 20 61 66 74 65 72 20 73  ion</i>, after s
0250: 75 63 63 65 73 73 66 75 6c 6c 79 0a 6f 62 74 61  uccessfully.obta
0260: 69 6e 69 6e 67 20 61 20 3c 69 3e 73 68 61 72 65  ining a <i>share
0270: 64 20 6c 6f 63 6b 3c 2f 69 3e 20 6f 6e 20 74 68  d lock</i> on th
0280: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c  e database file,
0290: 20 53 51 4c 69 74 65 20 73 68 61 6c 6c 0a 61 74   SQLite shall.at
02a0: 74 65 6d 70 74 20 74 6f 20 64 65 74 65 63 74 20  tempt to detect 
02b0: 61 6e 64 20 72 6f 6c 6c 20 62 61 63 6b 20 61 20  and roll back a 
02c0: 3c 69 3e 68 6f 74 20 6a 6f 75 72 6e 61 6c 20 66  <i>hot journal f
02d0: 69 6c 65 3c 2f 69 3e 20 61 73 73 6f 63 69 61 74  ile</i> associat
02e0: 65 64 0a 77 69 74 68 20 74 68 65 20 73 61 6d 65  ed.with the same
02f0: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a   database file..
0300: 0a 48 4c 52 20 48 33 35 30 34 30 20 0a 41 73 73  .HLR H35040 .Ass
0310: 75 6d 69 6e 67 20 6e 6f 20 65 72 72 6f 72 73 20  uming no errors 
0320: 68 61 76 65 20 6f 63 63 75 72 72 65 64 2c 20 74  have occurred, t
0330: 68 65 6e 20 61 66 74 65 72 20 61 74 74 65 6d 70  hen after attemp
0340: 74 69 6e 67 20 74 6f 20 64 65 74 65 63 74 20 61  ting to detect a
0350: 6e 64 0a 72 6f 6c 6c 20 62 61 63 6b 20 61 20 3c  nd.roll back a <
0360: 69 3e 68 6f 74 20 6a 6f 75 72 6e 61 6c 20 66 69  i>hot journal fi
0370: 6c 65 3c 2f 69 3e 2c 20 69 66 20 74 68 65 20 3c  le</i>, if the <
0380: 69 3e 70 61 67 65 20 63 61 63 68 65 3c 2f 69 3e  i>page cache</i>
0390: 20 63 6f 6e 74 61 69 6e 73 0a 61 6e 79 20 65 6e   contains.any en
03a0: 74 72 69 65 73 20 61 73 73 6f 63 69 61 74 65 64  tries associated
03b0: 20 77 69 74 68 20 74 68 65 20 63 75 72 72 65 6e   with the curren
03c0: 74 20 3c 69 3e 64 61 74 61 62 61 73 65 20 63 6f  t <i>database co
03d0: 6e 6e 65 63 74 69 6f 6e 3c 2f 69 3e 2c 0a 74 68  nnection</i>,.th
03e0: 65 6e 20 53 51 4c 69 74 65 20 73 68 61 6c 6c 20  en SQLite shall 
03f0: 76 61 6c 69 64 61 74 65 20 74 68 65 20 63 6f 6e  validate the con
0400: 74 65 6e 74 73 20 6f 66 20 74 68 65 20 3c 69 3e  tents of the <i>
0410: 70 61 67 65 20 63 61 63 68 65 3c 2f 69 3e 20 62  page cache</i> b
0420: 79 0a 74 65 73 74 69 6e 67 20 74 68 65 20 3c 69  y.testing the <i
0430: 3e 66 69 6c 65 20 63 68 61 6e 67 65 20 63 6f 75  >file change cou
0440: 6e 74 65 72 3c 2f 69 3e 2e 20 20 54 68 69 73 20  nter</i>.  This 
0450: 70 72 6f 63 65 64 75 72 65 20 69 73 20 6b 6e 6f  procedure is kno
0460: 77 6e 20 61 73 0a 3c 69 3e 63 61 63 68 65 20 76  wn as.<i>cache v
0470: 61 6c 69 64 61 74 69 6f 6e 3c 2f 69 3e 2e 0a 0a  alidation</i>...
0480: 48 4c 52 20 48 33 35 30 35 30 20 0a 49 66 20 74  HLR H35050 .If t
0490: 68 65 20 63 61 63 68 65 20 76 61 6c 69 64 61 74  he cache validat
04a0: 65 20 70 72 6f 63 65 64 75 72 65 20 70 72 65 73  e procedure pres
04b0: 63 72 69 62 65 64 20 62 79 20 48 33 35 30 34 30  cribed by H35040
04c0: 20 69 73 20 72 65 71 75 69 72 65 64 20 61 6e 64   is required and
04d0: 0a 64 6f 65 73 20 6e 6f 74 20 70 72 6f 76 65 20  .does not prove 
04e0: 74 68 61 74 20 74 68 65 20 3c 69 3e 70 61 67 65  that the <i>page
04f0: 20 63 61 63 68 65 3c 2f 69 3e 20 65 6e 74 72 69   cache</i> entri
0500: 65 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 69  es associated wi
0510: 74 68 20 74 68 65 0a 63 75 72 72 65 6e 74 20 3c  th the.current <
0520: 69 3e 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65  i>database conne
0530: 63 74 69 6f 6e 3c 2f 69 3e 20 61 72 65 20 76 61  ction</i> are va
0540: 6c 69 64 2c 20 74 68 65 6e 20 53 51 4c 69 74 65  lid, then SQLite
0550: 20 73 68 61 6c 6c 20 64 69 73 63 61 72 64 0a 61   shall discard.a
0560: 6c 6c 20 65 6e 74 72 69 65 73 20 61 73 73 6f 63  ll entries assoc
0570: 69 61 74 65 64 20 77 69 74 68 20 74 68 65 20 63  iated with the c
0580: 75 72 72 65 6e 74 20 3c 69 3e 64 61 74 61 62 61  urrent <i>databa
0590: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 3c 2f 69  se connection</i
05a0: 3e 20 66 72 6f 6d 0a 74 68 65 20 3c 69 3e 70 61  > from.the <i>pa
05b0: 67 65 20 63 61 63 68 65 3c 2f 69 3e 2e 0a 0a 48  ge cache</i>...H
05c0: 4c 52 20 48 33 35 30 36 30 20 0a 57 68 65 6e 20  LR H35060 .When 
05d0: 61 20 6e 65 77 20 3c 69 3e 64 61 74 61 62 61 73  a new <i>databas
05e0: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 3c 2f 69 3e  e connection</i>
05f0: 20 69 73 20 72 65 71 75 69 72 65 64 2c 20 53 51   is required, SQ
0600: 4c 69 74 65 20 73 68 61 6c 6c 20 61 74 74 65 6d  Lite shall attem
0610: 70 74 0a 74 6f 20 6f 70 65 6e 20 61 20 66 69 6c  pt.to open a fil
0620: 65 2d 68 61 6e 64 6c 65 20 6f 6e 20 74 68 65 20  e-handle on the 
0630: 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 49  database file. I
0640: 66 20 74 68 65 20 61 74 74 65 6d 70 74 20 66 61  f the attempt fa
0650: 69 6c 73 2c 20 74 68 65 6e 0a 6e 6f 20 6e 65 77  ils, then.no new
0660: 20 3c 69 3e 64 61 74 61 62 61 73 65 20 63 6f 6e   <i>database con
0670: 6e 65 63 74 69 6f 6e 3c 2f 69 3e 20 69 73 20 63  nection</i> is c
0680: 72 65 61 74 65 64 20 61 6e 64 20 61 6e 20 65 72  reated and an er
0690: 72 6f 72 20 72 65 74 75 72 6e 65 64 2e 0a 0a 48  ror returned...H
06a0: 4c 52 20 48 33 35 30 37 30 20 0a 57 68 65 6e 20  LR H35070 .When 
06b0: 61 20 6e 65 77 20 3c 69 3e 64 61 74 61 62 61 73  a new <i>databas
06c0: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 3c 2f 69 3e  e connection</i>
06d0: 20 69 73 20 72 65 71 75 69 72 65 64 2c 20 61 66   is required, af
06e0: 74 65 72 20 6f 70 65 6e 69 6e 67 20 74 68 65 0a  ter opening the.
06f0: 6e 65 77 20 66 69 6c 65 2d 68 61 6e 64 6c 65 2c  new file-handle,
0700: 20 53 51 4c 69 74 65 20 73 68 61 6c 6c 20 61 74   SQLite shall at
0710: 74 65 6d 70 74 20 74 6f 20 72 65 61 64 20 74 68  tempt to read th
0720: 65 20 66 69 72 73 74 20 31 30 30 20 62 79 74 65  e first 100 byte
0730: 73 0a 6f 66 20 74 68 65 20 64 61 74 61 62 61 73  s.of the databas
0740: 65 20 66 69 6c 65 2e 20 49 66 20 74 68 65 20 61  e file. If the a
0750: 74 74 65 6d 70 74 20 66 61 69 6c 73 20 66 6f 72  ttempt fails for
0760: 20 61 6e 79 20 6f 74 68 65 72 20 72 65 61 73 6f   any other reaso
0770: 6e 20 74 68 61 6e 0a 74 68 61 74 20 74 68 65 20  n than.that the 
0780: 6f 70 65 6e 65 64 20 66 69 6c 65 20 69 73 20 6c  opened file is l
0790: 65 73 73 20 74 68 61 6e 20 31 30 30 20 62 79 74  ess than 100 byt
07a0: 65 73 20 69 6e 20 73 69 7a 65 2c 20 74 68 65 6e  es in size, then
07b0: 0a 74 68 65 20 66 69 6c 65 2d 68 61 6e 64 6c 65  .the file-handle
07c0: 20 69 73 20 63 6c 6f 73 65 64 2c 20 6e 6f 20 6e   is closed, no n
07d0: 65 77 20 3c 69 3e 64 61 74 61 62 61 73 65 20 63  ew <i>database c
07e0: 6f 6e 6e 65 63 74 69 6f 6e 3c 2f 69 3e 20 69 73  onnection</i> is
07f0: 20 63 72 65 61 74 65 64 0a 61 6e 64 20 61 6e 20   created.and an 
0800: 65 72 72 6f 72 20 72 65 74 75 72 6e 65 64 20 69  error returned i
0810: 6e 73 74 65 61 64 2e 0a 0a 48 4c 52 20 48 33 35  nstead...HLR H35
0820: 30 38 30 20 0a 49 66 20 74 68 65 20 3c 69 3e 64  080 .If the <i>d
0830: 61 74 61 62 61 73 65 20 66 69 6c 65 20 68 65 61  atabase file hea
0840: 64 65 72 3c 2f 69 3e 20 69 73 20 73 75 63 63 65  der</i> is succe
0850: 73 73 66 75 6c 6c 79 20 72 65 61 64 20 66 72 6f  ssfully read fro
0860: 6d 20 61 20 6e 65 77 6c 79 0a 6f 70 65 6e 65 64  m a newly.opened
0870: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20   database file, 
0880: 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20  the connections 
0890: 3c 69 3e 65 78 70 65 63 74 65 64 20 70 61 67 65  <i>expected page
08a0: 2d 73 69 7a 65 3c 2f 69 3e 20 73 68 61 6c 6c 0a  -size</i> shall.
08b0: 62 65 20 73 65 74 20 74 6f 20 74 68 65 20 76 61  be set to the va
08c0: 6c 75 65 20 73 74 6f 72 65 64 20 69 6e 20 74 68  lue stored in th
08d0: 65 20 3c 69 3e 70 61 67 65 2d 73 69 7a 65 20 66  e <i>page-size f
08e0: 69 65 6c 64 3c 2f 69 3e 20 6f 66 20 74 68 65 0a  ield</i> of the.
08f0: 64 61 74 61 62 61 73 65 20 68 65 61 64 65 72 2e  database header.
0900: 0a 0a 48 4c 52 20 48 33 35 30 39 30 20 0a 49 66  ..HLR H35090 .If
0910: 20 74 68 65 20 3c 69 3e 64 61 74 61 62 61 73 65   the <i>database
0920: 20 66 69 6c 65 20 68 65 61 64 65 72 3c 2f 69 3e   file header</i>
0930: 20 63 61 6e 6e 6f 74 20 62 65 20 72 65 61 64 20   cannot be read 
0940: 66 72 6f 6d 20 61 20 6e 65 77 6c 79 20 6f 70 65  from a newly ope
0950: 6e 65 64 0a 64 61 74 61 62 61 73 65 20 66 69 6c  ned.database fil
0960: 65 20 28 62 65 63 61 75 73 65 20 74 68 65 20 66  e (because the f
0970: 69 6c 65 20 69 73 20 6c 65 73 73 20 74 68 61 6e  ile is less than
0980: 20 31 30 30 20 62 79 74 65 73 20 69 6e 20 73 69   100 bytes in si
0990: 7a 65 29 2c 20 74 68 65 0a 63 6f 6e 6e 65 63 74  ze), the.connect
09a0: 69 6f 6e 73 20 3c 69 3e 65 78 70 65 63 74 65 64  ions <i>expected
09b0: 20 70 61 67 65 2d 73 69 7a 65 3c 2f 69 3e 20 73   page-size</i> s
09c0: 68 61 6c 6c 20 62 65 20 73 65 74 20 74 6f 20 74  hall be set to t
09d0: 68 65 20 63 6f 6d 70 69 6c 65 20 74 69 6d 65 0a  he compile time.
09e0: 76 61 6c 75 65 20 6f 66 20 74 68 65 20 53 51 4c  value of the SQL
09f0: 49 54 45 5f 44 45 46 41 55 4c 54 5f 50 41 47 45  ITE_DEFAULT_PAGE
0a00: 53 49 5a 45 20 6f 70 74 69 6f 6e 2e 0a 0a 48 4c  SIZE option...HL
0a10: 52 20 48 33 35 31 30 30 20 0a 57 68 65 6e 20 72  R H35100 .When r
0a20: 65 71 75 69 72 65 64 20 74 6f 20 6f 70 65 6e 20  equired to open 
0a30: 61 20 3c 69 3e 72 65 61 64 2d 6f 6e 6c 79 20 74  a <i>read-only t
0a40: 72 61 6e 73 61 63 74 69 6f 6e 3c 2f 69 3e 20 75  ransaction</i> u
0a50: 73 69 6e 67 20 61 0a 3c 69 3e 64 61 74 61 62 61  sing a.<i>databa
0a60: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 3c 2f 69  se connection</i
0a70: 3e 2c 20 53 51 4c 69 74 65 20 73 68 61 6c 6c 20  >, SQLite shall 
0a80: 66 69 72 73 74 20 61 74 74 65 6d 70 74 20 74 6f  first attempt to
0a90: 20 6f 62 74 61 69 6e 0a 61 20 3c 69 3e 73 68 61   obtain.a <i>sha
0aa0: 72 65 64 2d 6c 6f 63 6b 3c 2f 69 3e 20 6f 6e 20  red-lock</i> on 
0ab0: 74 68 65 20 66 69 6c 65 2d 68 61 6e 64 6c 65 20  the file-handle 
0ac0: 6f 70 65 6e 20 6f 6e 20 74 68 65 20 64 61 74 61  open on the data
0ad0: 62 61 73 65 20 66 69 6c 65 2e 0a 0a 48 4c 52 20  base file...HLR 
0ae0: 48 33 35 31 31 30 20 0a 49 66 2c 20 77 68 69 6c  H35110 .If, whil
0af0: 65 20 6f 70 65 6e 69 6e 67 20 61 20 3c 69 3e 72  e opening a <i>r
0b00: 65 61 64 2d 6f 6e 6c 79 20 74 72 61 6e 73 61 63  ead-only transac
0b10: 74 69 6f 6e 3c 2f 69 3e 2c 20 53 51 4c 69 74 65  tion</i>, SQLite
0b20: 20 66 61 69 6c 73 20 74 6f 20 6f 62 74 61 69 6e   fails to obtain
0b30: 0a 74 68 65 20 3c 69 3e 73 68 61 72 65 64 2d 6c  .the <i>shared-l
0b40: 6f 63 6b 3c 2f 69 3e 20 6f 6e 20 74 68 65 20 64  ock</i> on the d
0b50: 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20 74 68  atabase file, th
0b60: 65 6e 20 74 68 65 20 70 72 6f 63 65 73 73 20 69  en the process i
0b70: 73 0a 61 62 61 6e 64 6f 6e 65 64 2c 20 6e 6f 20  s.abandoned, no 
0b80: 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 6f  transaction is o
0b90: 70 65 6e 65 64 20 61 6e 64 20 61 6e 20 65 72 72  pened and an err
0ba0: 6f 72 20 72 65 74 75 72 6e 65 64 20 74 6f 20 74  or returned to t
0bb0: 68 65 20 75 73 65 72 2e 0a 0a 48 4c 52 20 48 33  he user...HLR H3
0bc0: 35 31 32 30 20 0a 49 66 2c 20 77 68 69 6c 65 20  5120 .If, while 
0bd0: 6f 70 65 6e 69 6e 67 20 61 20 3c 69 3e 72 65 61  opening a <i>rea
0be0: 64 2d 6f 6e 6c 79 20 74 72 61 6e 73 61 63 74 69  d-only transacti
0bf0: 6f 6e 3c 2f 69 3e 2c 20 53 51 4c 69 74 65 20 65  on</i>, SQLite e
0c00: 6e 63 6f 75 6e 74 65 72 73 0a 61 6e 20 65 72 72  ncounters.an err
0c10: 6f 72 20 77 68 69 6c 65 20 61 74 74 65 6d 70 74  or while attempt
0c20: 69 6e 67 20 74 6f 20 64 65 74 65 63 74 20 6f 72  ing to detect or
0c30: 20 72 6f 6c 6c 20 62 61 63 6b 20 61 20 3c 69 3e   roll back a <i>
0c40: 68 6f 74 20 6a 6f 75 72 6e 61 6c 0a 66 69 6c 65  hot journal.file
0c50: 3c 2f 69 3e 2c 20 74 68 65 6e 20 74 68 65 20 3c  </i>, then the <
0c60: 69 3e 73 68 61 72 65 64 2d 6c 6f 63 6b 3c 2f 69  i>shared-lock</i
0c70: 3e 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73  > on the databas
0c80: 65 20 66 69 6c 65 20 69 73 20 72 65 6c 65 61 73  e file is releas
0c90: 65 64 2c 0a 6e 6f 20 74 72 61 6e 73 61 63 74 69  ed,.no transacti
0ca0: 6f 6e 20 69 73 20 6f 70 65 6e 65 64 20 61 6e 64  on is opened and
0cb0: 20 61 6e 20 65 72 72 6f 72 20 72 65 74 75 72 6e   an error return
0cc0: 65 64 20 74 6f 20 74 68 65 20 75 73 65 72 2e 0a  ed to the user..
0cd0: 0a 48 4c 52 20 48 33 35 31 33 30 20 0a 57 68 65  .HLR H35130 .Whe
0ce0: 6e 20 72 65 71 75 69 72 65 64 20 74 6f 20 65 6e  n required to en
0cf0: 64 20 61 20 3c 69 3e 72 65 61 64 2d 6f 6e 6c 79  d a <i>read-only
0d00: 20 74 72 61 6e 73 61 63 74 69 6f 6e 3c 2f 69 3e   transaction</i>
0d10: 2c 20 53 51 4c 69 74 65 20 73 68 61 6c 6c 0a 72  , SQLite shall.r
0d20: 65 6c 69 6e 71 75 69 73 68 20 74 68 65 20 3c 69  elinquish the <i
0d30: 3e 73 68 61 72 65 64 20 6c 6f 63 6b 3c 2f 69 3e  >shared lock</i>
0d40: 20 68 65 6c 64 20 6f 6e 20 74 68 65 20 64 61 74   held on the dat
0d50: 61 62 61 73 65 20 66 69 6c 65 20 62 79 0a 63 61  abase file by.ca
0d60: 6c 6c 69 6e 67 20 74 68 65 20 78 55 6e 6c 6f 63  lling the xUnloc
0d70: 6b 28 29 20 6d 65 74 68 6f 64 20 6f 66 20 74 68  k() method of th
0d80: 65 20 66 69 6c 65 2d 68 61 6e 64 6c 65 2e 0a 0a  e file-handle...
0d90: 48 4c 52 20 48 33 35 31 34 30 20 0a 57 68 65 6e  HLR H35140 .When
0da0: 20 72 65 71 75 69 72 65 64 20 74 6f 20 61 74 74   required to att
0db0: 65 6d 70 74 20 74 6f 20 64 65 74 65 63 74 20 61  empt to detect a
0dc0: 20 3c 69 3e 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20   <i>hot-journal 
0dd0: 66 69 6c 65 3c 2f 69 3e 2c 20 53 51 4c 69 74 65  file</i>, SQLite
0de0: 0a 73 68 61 6c 6c 20 66 69 72 73 74 20 75 73 65  .shall first use
0df0: 20 74 68 65 20 78 41 63 63 65 73 73 28 29 20 6d   the xAccess() m
0e00: 65 74 68 6f 64 20 6f 66 20 74 68 65 20 56 46 53  ethod of the VFS
0e10: 20 6c 61 79 65 72 20 74 6f 20 63 68 65 63 6b 20   layer to check 
0e20: 69 66 20 61 0a 6a 6f 75 72 6e 61 6c 20 66 69 6c  if a.journal fil
0e30: 65 20 65 78 69 73 74 73 20 69 6e 20 74 68 65 20  e exists in the 
0e40: 66 69 6c 65 2d 73 79 73 74 65 6d 2e 0a 0a 48 4c  file-system...HL
0e50: 52 20 48 33 35 31 35 30 20 0a 57 68 65 6e 20 72  R H35150 .When r
0e60: 65 71 75 69 72 65 64 20 74 6f 20 61 74 74 65 6d  equired to attem
0e70: 70 74 20 74 6f 20 64 65 74 65 63 74 20 61 20 3c  pt to detect a <
0e80: 69 3e 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 66 69  i>hot-journal fi
0e90: 6c 65 3c 2f 69 3e 2c 20 69 66 20 74 68 65 0a 63  le</i>, if the.c
0ea0: 61 6c 6c 20 74 6f 20 78 41 63 63 65 73 73 28 29  all to xAccess()
0eb0: 20 72 65 71 75 69 72 65 64 20 62 79 20 48 33 35   required by H35
0ec0: 31 34 30 20 69 6e 64 69 63 61 74 65 73 20 74 68  140 indicates th
0ed0: 61 74 20 61 20 6a 6f 75 72 6e 61 6c 20 66 69 6c  at a journal fil
0ee0: 65 20 64 6f 65 73 0a 6e 6f 74 20 65 78 69 73 74  e does.not exist
0ef0: 2c 20 74 68 65 6e 20 53 51 4c 69 74 65 20 73 68  , then SQLite sh
0f00: 61 6c 6c 20 63 6f 6e 63 6c 75 64 65 20 74 68 61  all conclude tha
0f10: 74 20 74 68 65 72 65 20 69 73 20 6e 6f 20 3c 69  t there is no <i
0f20: 3e 68 6f 74 2d 6a 6f 75 72 6e 61 6c 0a 66 69 6c  >hot-journal.fil
0f30: 65 3c 2f 69 3e 20 69 6e 20 74 68 65 20 66 69 6c  e</i> in the fil
0f40: 65 20 73 79 73 74 65 6d 20 61 6e 64 20 74 68 65  e system and the
0f50: 72 65 66 6f 72 65 20 74 68 61 74 20 6e 6f 20 3c  refore that no <
0f60: 69 3e 68 6f 74 20 6a 6f 75 72 6e 61 6c 0a 72 6f  i>hot journal.ro
0f70: 6c 6c 62 61 63 6b 3c 2f 69 3e 20 69 73 20 72 65  llback</i> is re
0f80: 71 75 69 72 65 64 2e 0a 0a 48 4c 52 20 48 33 35  quired...HLR H35
0f90: 31 36 30 20 0a 57 68 65 6e 20 72 65 71 75 69 72  160 .When requir
0fa0: 65 64 20 74 6f 20 61 74 74 65 6d 70 74 20 74 6f  ed to attempt to
0fb0: 20 64 65 74 65 63 74 20 61 20 3c 69 3e 68 6f 74   detect a <i>hot
0fc0: 2d 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 3c 2f 69  -journal file</i
0fd0: 3e 2c 20 69 66 20 74 68 65 0a 63 61 6c 6c 20 74  >, if the.call t
0fe0: 6f 20 78 41 63 63 65 73 73 28 29 20 72 65 71 75  o xAccess() requ
0ff0: 69 72 65 64 20 62 79 20 48 33 35 31 34 30 20 69  ired by H35140 i
1000: 6e 64 69 63 61 74 65 73 20 74 68 61 74 20 61 20  ndicates that a 
1010: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 0a 69 73 20  journal file.is 
1020: 70 72 65 73 65 6e 74 2c 20 74 68 65 6e 20 74 68  present, then th
1030: 65 20 78 43 68 65 63 6b 52 65 73 65 72 76 65 64  e xCheckReserved
1040: 4c 6f 63 6b 28 29 20 6d 65 74 68 6f 64 20 6f 66  Lock() method of
1050: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69   the database fi
1060: 6c 65 0a 66 69 6c 65 2d 68 61 6e 64 6c 65 20 69  le.file-handle i
1070: 73 20 69 6e 76 6f 6b 65 64 20 74 6f 20 64 65 74  s invoked to det
1080: 65 72 6d 69 6e 65 20 77 68 65 74 68 65 72 20 6f  ermine whether o
1090: 72 20 6e 6f 74 20 73 6f 6d 65 20 6f 74 68 65 72  r not some other
10a0: 0a 70 72 6f 63 65 73 73 20 69 73 20 68 6f 6c 64  .process is hold
10b0: 69 6e 67 20 61 20 3c 69 3e 72 65 73 65 72 76 65  ing a <i>reserve
10c0: 64 3c 2f 69 3e 20 6f 72 20 67 72 65 61 74 65 72  d</i> or greater
10d0: 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74   lock on the dat
10e0: 61 62 61 73 65 0a 66 69 6c 65 2e 0a 0a 48 4c 52  abase.file...HLR
10f0: 20 48 33 35 31 37 30 20 0a 49 66 20 74 68 65 20   H35170 .If the 
1100: 63 61 6c 6c 20 74 6f 20 78 43 68 65 63 6b 52 65  call to xCheckRe
1110: 73 65 72 76 65 64 4c 6f 63 6b 28 29 20 72 65 71  servedLock() req
1120: 75 69 72 65 64 20 62 79 20 48 33 35 31 36 30 20  uired by H35160 
1130: 69 6e 64 69 63 61 74 65 73 20 74 68 61 74 0a 73  indicates that.s
1140: 6f 6d 65 20 6f 74 68 65 72 20 3c 69 3e 64 61 74  ome other <i>dat
1150: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  abase connection
1160: 3c 2f 69 3e 20 69 73 20 68 6f 6c 64 69 6e 67 20  </i> is holding 
1170: 61 20 3c 69 3e 72 65 73 65 72 76 65 64 3c 2f 69  a <i>reserved</i
1180: 3e 0a 6f 72 20 67 72 65 61 74 65 72 20 6c 6f 63  >.or greater loc
1190: 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73  k on the databas
11a0: 65 20 66 69 6c 65 2c 20 74 68 65 6e 20 53 51 4c  e file, then SQL
11b0: 69 74 65 20 73 68 61 6c 6c 20 63 6f 6e 63 6c 75  ite shall conclu
11c0: 64 65 20 74 68 61 74 0a 74 68 65 72 65 20 69 73  de that.there is
11d0: 20 6e 6f 20 3c 69 3e 68 6f 74 20 6a 6f 75 72 6e   no <i>hot journ
11e0: 61 6c 20 66 69 6c 65 3c 2f 69 3e 2e 20 49 6e 20  al file</i>. In 
11f0: 74 68 69 73 20 63 61 73 65 20 74 68 65 20 61 74  this case the at
1200: 74 65 6d 70 74 20 74 6f 20 64 65 74 65 63 74 0a  tempt to detect.
1210: 61 20 3c 69 3e 68 6f 74 20 6a 6f 75 72 6e 61 6c  a <i>hot journal
1220: 20 66 69 6c 65 3c 2f 69 3e 20 69 73 20 63 6f 6e   file</i> is con
1230: 63 6c 75 64 65 64 2e 0a 0a 48 4c 52 20 48 33 35  cluded...HLR H35
1240: 31 38 30 20 0a 57 68 65 6e 20 61 20 66 69 6c 65  180 .When a file
1250: 2d 68 61 6e 64 6c 65 20 6f 70 65 6e 20 6f 6e 20  -handle open on 
1260: 61 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20  a database file 
1270: 69 73 20 75 6e 6c 6f 63 6b 65 64 2c 20 69 66 20  is unlocked, if 
1280: 74 68 65 0a 3c 69 3e 70 61 67 65 20 63 61 63 68  the.<i>page cach
1290: 65 3c 2f 69 3e 20 63 6f 6e 74 61 69 6e 73 20 6f  e</i> contains o
12a0: 6e 65 20 6f 72 20 6d 6f 72 65 20 65 6e 74 72 69  ne or more entri
12b0: 65 73 20 62 65 6c 6f 6e 67 69 6e 67 20 74 6f 20  es belonging to 
12c0: 74 68 65 0a 61 73 73 6f 63 69 61 74 65 64 20 3c  the.associated <
12d0: 69 3e 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65  i>database conne
12e0: 63 74 69 6f 6e 3c 2f 69 3e 2c 20 53 51 4c 69 74  ction</i>, SQLit
12f0: 65 20 73 68 61 6c 6c 20 73 74 6f 72 65 20 74 68  e shall store th
1300: 65 20 76 61 6c 75 65 0a 6f 66 20 74 68 65 20 3c  e value.of the <
1310: 69 3e 66 69 6c 65 20 63 68 61 6e 67 65 20 63 6f  i>file change co
1320: 75 6e 74 65 72 3c 2f 69 3e 20 69 6e 74 65 72 6e  unter</i> intern
1330: 61 6c 6c 79 2e 0a 0a 48 4c 52 20 48 33 35 31 39  ally...HLR H3519
1340: 30 20 0a 57 68 65 6e 20 72 65 71 75 69 72 65 64  0 .When required
1350: 20 74 6f 20 70 65 72 66 6f 72 6d 20 3c 69 3e 63   to perform <i>c
1360: 61 63 68 65 20 76 61 6c 69 64 61 74 69 6f 6e 3c  ache validation<
1370: 2f 69 3e 20 61 73 20 70 61 72 74 20 6f 66 20 6f  /i> as part of o
1380: 70 65 6e 69 6e 67 0a 61 20 3c 69 3e 72 65 61 64  pening.a <i>read
1390: 20 74 72 61 6e 73 61 63 74 69 6f 6e 3c 2f 69 3e   transaction</i>
13a0: 2c 20 53 51 4c 69 74 65 20 73 68 61 6c 6c 20 72  , SQLite shall r
13b0: 65 61 64 20 61 20 31 36 20 62 79 74 65 20 62 6c  ead a 16 byte bl
13c0: 6f 63 6b 0a 73 74 61 72 74 69 6e 67 20 61 74 20  ock.starting at 
13d0: 62 79 74 65 20 6f 66 66 73 65 74 20 32 34 20 6f  byte offset 24 o
13e0: 66 20 74 68 65 20 3c 69 3e 64 61 74 61 62 61 73  f the <i>databas
13f0: 65 20 66 69 6c 65 3c 2f 69 3e 20 75 73 69 6e 67  e file</i> using
1400: 20 74 68 65 20 78 52 65 61 64 28 29 0a 6d 65 74   the xRead().met
1410: 68 6f 64 20 6f 66 20 74 68 65 20 3c 69 3e 64 61  hod of the <i>da
1420: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f  tabase connectio
1430: 6e 73 3c 2f 69 3e 20 66 69 6c 65 20 68 61 6e 64  ns</i> file hand
1440: 6c 65 2e 0a 0a 48 4c 52 20 48 33 35 32 30 30 20  le...HLR H35200 
1450: 0a 57 68 69 6c 65 20 70 65 72 66 6f 72 6d 69 6e  .While performin
1460: 67 20 3c 69 3e 63 61 63 68 65 20 76 61 6c 69 64  g <i>cache valid
1470: 61 74 69 6f 6e 3c 2f 69 3e 2c 20 61 66 74 65 72  ation</i>, after
1480: 20 6c 6f 61 64 69 6e 67 20 74 68 65 20 31 36 20   loading the 16 
1490: 62 79 74 65 0a 62 6c 6f 63 6b 20 61 73 20 72 65  byte.block as re
14a0: 71 75 69 72 65 64 20 62 79 20 48 33 35 31 39 30  quired by H35190
14b0: 2c 20 53 51 4c 69 74 65 20 73 68 61 6c 6c 20 63  , SQLite shall c
14c0: 6f 6d 70 61 72 65 20 74 68 65 20 33 32 2d 62 69  ompare the 32-bi
14d0: 74 20 62 69 67 2d 65 6e 64 69 61 6e 0a 69 6e 74  t big-endian.int
14e0: 65 67 65 72 20 73 74 6f 72 65 64 20 69 6e 20 74  eger stored in t
14f0: 68 65 20 66 69 72 73 74 20 34 20 62 79 74 65 73  he first 4 bytes
1500: 20 6f 66 20 74 68 65 20 62 6c 6f 63 6b 20 74 6f   of the block to
1510: 20 74 68 65 20 6d 6f 73 74 0a 72 65 63 65 6e 74   the most.recent
1520: 6c 79 20 73 74 6f 72 65 64 20 76 61 6c 75 65 20  ly stored value 
1530: 6f 66 20 74 68 65 20 3c 69 3e 66 69 6c 65 20 63  of the <i>file c
1540: 68 61 6e 67 65 20 63 6f 75 6e 74 65 72 3c 2f 69  hange counter</i
1550: 3e 20 28 73 65 65 20 48 33 35 31 38 30 29 2e 0a  > (see H35180)..
1560: 49 66 20 74 68 65 20 76 61 6c 75 65 73 20 61 72  If the values ar
1570: 65 20 6e 6f 74 20 74 68 65 20 73 61 6d 65 2c 20  e not the same, 
1580: 74 68 65 6e 20 53 51 4c 69 74 65 20 73 68 61 6c  then SQLite shal
1590: 6c 20 63 6f 6e 63 6c 75 64 65 20 74 68 61 74 0a  l conclude that.
15a0: 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20  the contents of 
15b0: 74 68 65 20 63 61 63 68 65 20 61 72 65 20 69 6e  the cache are in
15c0: 76 61 6c 69 64 2e 0a 0a 48 4c 52 20 48 33 35 32  valid...HLR H352
15d0: 31 30 20 0a 44 75 72 69 6e 67 20 74 68 65 20 63  10 .During the c
15e0: 6f 6e 63 6c 75 73 69 6f 6e 20 6f 66 20 61 20 3c  onclusion of a <
15f0: 69 3e 72 65 61 64 20 74 72 61 6e 73 61 63 74 69  i>read transacti
1600: 6f 6e 3c 2f 69 3e 2c 20 62 65 66 6f 72 65 20 75  on</i>, before u
1610: 6e 6c 6f 63 6b 69 6e 67 0a 74 68 65 20 64 61 74  nlocking.the dat
1620: 61 62 61 73 65 20 66 69 6c 65 2c 20 53 51 4c 69  abase file, SQLi
1630: 74 65 20 73 68 61 6c 6c 20 73 65 74 20 74 68 65  te shall set the
1640: 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 0a 3c 69 3e   connections.<i>
1650: 65 78 70 65 63 74 65 64 20 70 61 67 65 20 73 69  expected page si
1660: 7a 65 3c 2f 69 3e 20 74 6f 20 74 68 65 20 63 75  ze</i> to the cu
1670: 72 72 65 6e 74 20 64 61 74 61 62 61 73 65 20 3c  rrent database <
1680: 69 3e 70 61 67 65 2d 73 69 7a 65 3c 2f 69 3e 2e  i>page-size</i>.
1690: 0a 0a 48 4c 52 20 48 33 35 32 32 30 20 0a 41 73  ..HLR H35220 .As
16a0: 20 70 61 72 74 20 6f 66 20 6f 70 65 6e 69 6e 67   part of opening
16b0: 20 61 20 6e 65 77 20 3c 69 3e 72 65 61 64 20 74   a new <i>read t
16c0: 72 61 6e 73 61 63 74 69 6f 6e 3c 2f 69 3e 2c 20  ransaction</i>, 
16d0: 69 6d 6d 65 64 69 61 74 65 6c 79 20 61 66 74 65  immediately afte
16e0: 72 0a 70 65 72 66 6f 72 6d 69 6e 67 20 3c 69 3e  r.performing <i>
16f0: 63 61 63 68 65 20 76 61 6c 69 64 61 74 69 6f 6e  cache validation
1700: 3c 2f 69 3e 2c 20 69 66 20 74 68 65 72 65 20 69  </i>, if there i
1710: 73 20 6e 6f 20 64 61 74 61 20 66 6f 72 20 64 61  s no data for da
1720: 74 61 62 61 73 65 0a 70 61 67 65 20 31 20 69 6e  tabase.page 1 in
1730: 20 74 68 65 20 3c 69 3e 70 61 67 65 20 63 61 63   the <i>page cac
1740: 68 65 3c 2f 69 3e 2c 20 53 51 4c 69 74 65 20 73  he</i>, SQLite s
1750: 68 61 6c 6c 20 72 65 61 64 20 3c 69 3e 4e 3c 2f  hall read <i>N</
1760: 69 3e 20 62 79 74 65 73 20 66 72 6f 6d 0a 74 68  i> bytes from.th
1770: 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 20 64  e start of the d
1780: 61 74 61 62 61 73 65 20 66 69 6c 65 20 75 73 69  atabase file usi
1790: 6e 67 20 74 68 65 20 78 52 65 61 64 28 29 20 6d  ng the xRead() m
17a0: 65 74 68 6f 64 20 6f 66 20 74 68 65 0a 63 6f 6e  ethod of the.con
17b0: 6e 65 63 74 69 6f 6e 73 20 66 69 6c 65 20 68 61  nections file ha
17c0: 6e 64 6c 65 2c 20 77 68 65 72 65 20 3c 69 3e 4e  ndle, where <i>N
17d0: 3c 2f 69 3e 20 69 73 20 74 68 65 20 63 6f 6e 6e  </i> is the conn
17e0: 65 63 74 69 6f 6e 73 20 63 75 72 72 65 6e 74 0a  ections current.
17f0: 3c 69 3e 65 78 70 65 63 74 65 64 20 70 61 67 65  <i>expected page
1800: 20 73 69 7a 65 3c 2f 69 3e 20 76 61 6c 75 65 2e   size</i> value.
1810: 0a 0a 48 4c 52 20 48 33 35 32 33 30 20 0a 49 66  ..HLR H35230 .If
1820: 20 70 61 67 65 20 31 20 64 61 74 61 20 69 73 20   page 1 data is 
1830: 72 65 61 64 20 61 73 20 72 65 71 75 69 72 65 64  read as required
1840: 20 62 79 20 48 33 35 32 33 30 2c 20 74 68 65 6e   by H35230, then
1850: 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68   the value of th
1860: 65 0a 3c 69 3e 70 61 67 65 2d 73 69 7a 65 3c 2f  e.<i>page-size</
1870: 69 3e 20 66 69 65 6c 64 20 74 68 61 74 20 61 70  i> field that ap
1880: 70 65 61 72 73 20 69 6e 20 74 68 65 20 64 61 74  pears in the dat
1890: 61 62 61 73 65 20 66 69 6c 65 20 68 65 61 64 65  abase file heade
18a0: 72 20 74 68 61 74 0a 63 6f 6e 73 75 6d 65 73 20  r that.consumes 
18b0: 74 68 65 20 66 69 72 73 74 20 31 30 30 20 62 79  the first 100 by
18c0: 74 65 73 20 6f 66 20 74 68 65 20 72 65 61 64 20  tes of the read 
18d0: 62 6c 6f 63 6b 20 69 73 20 6e 6f 74 20 74 68 65  block is not the
18e0: 20 73 61 6d 65 20 61 73 20 74 68 65 0a 63 6f 6e   same as the.con
18f0: 6e 65 63 74 69 6f 6e 73 20 63 75 72 72 65 6e 74  nections current
1900: 20 3c 69 3e 65 78 70 65 63 74 65 64 20 70 61 67   <i>expected pag
1910: 65 20 73 69 7a 65 3c 2f 69 3e 2c 20 74 68 65 6e  e size</i>, then
1920: 20 74 68 65 0a 3c 69 3e 65 78 70 65 63 74 65 64   the.<i>expected
1930: 20 70 61 67 65 20 73 69 7a 65 3c 2f 69 3e 20 69   page size</i> i
1940: 73 20 73 65 74 20 74 6f 20 74 68 69 73 20 76 61  s set to this va
1950: 6c 75 65 2c 20 74 68 65 20 64 61 74 61 62 61 73  lue, the databas
1960: 65 20 66 69 6c 65 20 69 73 0a 75 6e 6c 6f 63 6b  e file is.unlock
1970: 65 64 20 61 6e 64 20 74 68 65 20 65 6e 74 69 72  ed and the entir
1980: 65 20 70 72 6f 63 65 64 75 72 65 20 74 6f 20 6f  e procedure to o
1990: 70 65 6e 20 61 20 3c 69 3e 72 65 61 64 20 74 72  pen a <i>read tr
19a0: 61 6e 73 61 63 74 69 6f 6e 3c 2f 69 3e 0a 69 73  ansaction</i>.is
19b0: 20 72 65 70 65 61 74 65 64 2e 0a 0a 48 4c 52 20   repeated...HLR 
19c0: 48 33 35 32 34 30 20 0a 49 66 20 70 61 67 65 20  H35240 .If page 
19d0: 31 20 64 61 74 61 20 69 73 20 72 65 61 64 20 61  1 data is read a
19e0: 73 20 72 65 71 75 69 72 65 64 20 62 79 20 48 33  s required by H3
19f0: 35 32 33 30 2c 20 74 68 65 6e 20 74 68 65 20 76  5230, then the v
1a00: 61 6c 75 65 20 6f 66 20 74 68 65 0a 3c 69 3e 70  alue of the.<i>p
1a10: 61 67 65 2d 73 69 7a 65 3c 2f 69 3e 20 66 69 65  age-size</i> fie
1a20: 6c 64 20 74 68 61 74 20 61 70 70 65 61 72 73 20  ld that appears 
1a30: 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20  in the database 
1a40: 66 69 6c 65 20 68 65 61 64 65 72 20 74 68 61 74  file header that
1a50: 0a 63 6f 6e 73 75 6d 65 73 20 74 68 65 20 66 69  .consumes the fi
1a60: 72 73 74 20 31 30 30 20 62 79 74 65 73 20 6f 66  rst 100 bytes of
1a70: 20 74 68 65 20 72 65 61 64 20 62 6c 6f 63 6b 20   the read block 
1a80: 69 73 20 74 68 65 20 73 61 6d 65 20 61 73 20 74  is the same as t
1a90: 68 65 0a 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 63  he.connections c
1aa0: 75 72 72 65 6e 74 20 3c 69 3e 65 78 70 65 63 74  urrent <i>expect
1ab0: 65 64 20 70 61 67 65 20 73 69 7a 65 3c 2f 69 3e  ed page size</i>
1ac0: 2c 20 74 68 65 6e 20 74 68 65 20 62 6c 6f 63 6b  , then the block
1ad0: 20 6f 66 20 64 61 74 61 0a 72 65 61 64 20 69 73   of data.read is
1ae0: 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 3c   stored in the <
1af0: 69 3e 70 61 67 65 20 63 61 63 68 65 3c 2f 69 3e  i>page cache</i>
1b00: 20 61 73 20 70 61 67 65 20 31 2e 0a 0a 48 4c 52   as page 1...HLR
1b10: 20 48 33 35 32 37 30 20 0a 57 68 65 6e 20 72 65   H35270 .When re
1b20: 71 75 69 72 65 64 20 74 6f 20 3c 69 3e 6a 6f 75  quired to <i>jou
1b30: 72 6e 61 6c 20 61 20 64 61 74 61 62 61 73 65 20  rnal a database 
1b40: 70 61 67 65 3c 2f 69 3e 2c 20 53 51 4c 69 74 65  page</i>, SQLite
1b50: 20 73 68 61 6c 6c 20 66 69 72 73 74 0a 61 70 70   shall first.app
1b60: 65 6e 64 20 74 68 65 20 3c 69 3e 70 61 67 65 20  end the <i>page 
1b70: 6e 75 6d 62 65 72 3c 2f 69 3e 20 6f 66 20 74 68  number</i> of th
1b80: 65 20 70 61 67 65 20 62 65 69 6e 67 20 6a 6f 75  e page being jou
1b90: 72 6e 61 6c 6c 65 64 20 74 6f 20 74 68 65 0a 3c  rnalled to the.<
1ba0: 69 3e 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 3c 2f  i>journal file</
1bb0: 69 3e 2c 20 66 6f 72 6d 61 74 74 65 64 20 61 73  i>, formatted as
1bc0: 20 61 20 34 2d 62 79 74 65 20 62 69 67 2d 65 6e   a 4-byte big-en
1bd0: 64 69 61 6e 20 75 6e 73 69 67 6e 65 64 20 69 6e  dian unsigned in
1be0: 74 65 67 65 72 2c 0a 75 73 69 6e 67 20 61 20 73  teger,.using a s
1bf0: 69 6e 67 6c 65 20 63 61 6c 6c 20 74 6f 20 74 68  ingle call to th
1c00: 65 20 78 57 72 69 74 65 20 6d 65 74 68 6f 64 20  e xWrite method 
1c10: 6f 66 20 74 68 65 20 66 69 6c 65 2d 68 61 6e 64  of the file-hand
1c20: 6c 65 20 6f 70 65 6e 65 64 0a 6f 6e 20 74 68 65  le opened.on the
1c30: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 0a 0a   journal file...
1c40: 48 4c 52 20 48 33 35 32 38 30 20 0a 57 68 65 6e  HLR H35280 .When
1c50: 20 72 65 71 75 69 72 65 64 20 74 6f 20 3c 69 3e   required to <i>
1c60: 6a 6f 75 72 6e 61 6c 20 61 20 64 61 74 61 62 61  journal a databa
1c70: 73 65 20 70 61 67 65 3c 2f 69 3e 2c 20 69 66 20  se page</i>, if 
1c80: 74 68 65 20 61 74 74 65 6d 70 74 20 74 6f 0a 61  the attempt to.a
1c90: 70 70 65 6e 64 20 74 68 65 20 3c 69 3e 70 61 67  ppend the <i>pag
1ca0: 65 20 6e 75 6d 62 65 72 3c 2f 69 3e 20 74 6f 20  e number</i> to 
1cb0: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  the journal file
1cc0: 20 69 73 20 73 75 63 63 65 73 73 66 75 6c 2c 0a   is successful,.
1cd0: 74 68 65 6e 20 74 68 65 20 63 75 72 72 65 6e 74  then the current
1ce0: 20 70 61 67 65 20 64 61 74 61 20 28 3c 69 3e 70   page data (<i>p
1cf0: 61 67 65 2d 73 69 7a 65 3c 2f 69 3e 20 62 79 74  age-size</i> byt
1d00: 65 73 29 20 73 68 61 6c 6c 20 62 65 20 61 70 70  es) shall be app
1d10: 65 6e 64 65 64 0a 74 6f 20 74 68 65 20 6a 6f 75  ended.to the jou
1d20: 72 6e 61 6c 20 66 69 6c 65 2c 20 75 73 69 6e 67  rnal file, using
1d30: 20 61 20 73 69 6e 67 6c 65 20 63 61 6c 6c 20 74   a single call t
1d40: 6f 20 74 68 65 20 78 57 72 69 74 65 20 6d 65 74  o the xWrite met
1d50: 68 6f 64 20 6f 66 20 74 68 65 0a 66 69 6c 65 2d  hod of the.file-
1d60: 68 61 6e 64 6c 65 20 6f 70 65 6e 65 64 20 6f 6e  handle opened on
1d70: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c   the journal fil
1d80: 65 2e 0a 0a 48 4c 52 20 48 33 35 32 39 30 20 0a  e...HLR H35290 .
1d90: 57 68 65 6e 20 72 65 71 75 69 72 65 64 20 74 6f  When required to
1da0: 20 3c 69 3e 6a 6f 75 72 6e 61 6c 20 61 20 64 61   <i>journal a da
1db0: 74 61 62 61 73 65 20 70 61 67 65 3c 2f 69 3e 2c  tabase page</i>,
1dc0: 20 69 66 20 74 68 65 20 61 74 74 65 6d 70 74 20   if the attempt 
1dd0: 74 6f 0a 61 70 70 65 6e 64 20 74 68 65 20 63 75  to.append the cu
1de0: 72 72 65 6e 74 20 70 61 67 65 20 64 61 74 61 20  rrent page data 
1df0: 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66  to the journal f
1e00: 69 6c 65 20 69 73 20 73 75 63 63 65 73 73 66 75  ile is successfu
1e10: 6c 2c 0a 74 68 65 6e 20 53 51 4c 69 74 65 20 73  l,.then SQLite s
1e20: 68 61 6c 6c 20 61 70 70 65 6e 64 20 61 20 34 2d  hall append a 4-
1e30: 62 79 74 65 20 62 69 67 2d 65 6e 64 69 61 6e 20  byte big-endian 
1e40: 69 6e 74 65 67 65 72 20 63 68 65 63 6b 73 75 6d  integer checksum
1e50: 20 76 61 6c 75 65 0a 74 6f 20 74 68 65 20 74 6f   value.to the to
1e60: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c   the journal fil
1e70: 65 2c 20 75 73 69 6e 67 20 61 20 73 69 6e 67 6c  e, using a singl
1e80: 65 20 63 61 6c 6c 20 74 6f 20 74 68 65 20 78 57  e call to the xW
1e90: 72 69 74 65 20 6d 65 74 68 6f 64 0a 6f 66 20 74  rite method.of t
1ea0: 68 65 20 66 69 6c 65 2d 68 61 6e 64 6c 65 20 6f  he file-handle o
1eb0: 70 65 6e 65 64 20 6f 6e 20 74 68 65 20 6a 6f 75  pened on the jou
1ec0: 72 6e 61 6c 20 66 69 6c 65 2e 0a 0a 48 4c 52 20  rnal file...HLR 
1ed0: 48 33 35 33 30 30 20 0a 54 68 65 20 63 68 65 63  H35300 .The chec
1ee0: 6b 73 75 6d 20 76 61 6c 75 65 20 77 72 69 74 74  ksum value writt
1ef0: 65 6e 20 74 6f 20 74 68 65 20 3c 69 3e 6a 6f 75  en to the <i>jou
1f00: 72 6e 61 6c 20 66 69 6c 65 3c 2f 69 3e 20 62 79  rnal file</i> by
1f10: 20 74 68 65 20 77 72 69 74 65 0a 72 65 71 75 69   the write.requi
1f20: 72 65 64 20 62 79 20 48 33 35 32 39 30 20 73 68  red by H35290 sh
1f30: 61 6c 6c 20 62 65 20 65 71 75 61 6c 20 74 6f 20  all be equal to 
1f40: 74 68 65 20 73 75 6d 20 6f 66 20 74 68 65 20 3c  the sum of the <
1f50: 69 3e 63 68 65 63 6b 73 75 6d 0a 69 6e 69 74 69  i>checksum.initi
1f60: 61 6c 69 7a 65 72 3c 2f 69 3e 20 66 69 65 6c 64  alizer</i> field
1f70: 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 3c   stored in the <
1f80: 69 3e 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72  i>journal header
1f90: 3c 2f 69 3e 20 28 48 33 35 37 30 30 29 20 61 6e  </i> (H35700) an
1fa0: 64 0a 65 76 65 72 79 20 32 30 30 74 68 20 62 79  d.every 200th by
1fb0: 74 65 20 6f 66 20 74 68 65 20 70 61 67 65 20 64  te of the page d
1fc0: 61 74 61 2c 20 62 65 67 69 6e 6e 69 6e 67 20 77  ata, beginning w
1fd0: 69 74 68 20 74 68 65 0a 28 3c 69 3e 70 61 67 65  ith the.(<i>page
1fe0: 2d 73 69 7a 65 3c 2f 69 3e 20 25 20 32 30 30 29  -size</i> % 200)
1ff0: 74 68 20 62 79 74 65 2e 0a 0a 48 4c 52 20 48 33  th byte...HLR H3
2000: 35 33 35 30 20 0a 57 68 65 6e 20 72 65 71 75 69  5350 .When requi
2010: 72 65 64 20 74 6f 20 6f 70 65 6e 20 61 20 3c 69  red to open a <i
2020: 3e 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 69  >write transacti
2030: 6f 6e 3c 2f 69 3e 20 6f 6e 20 74 68 65 20 64 61  on</i> on the da
2040: 74 61 62 61 73 65 2c 0a 53 51 4c 69 74 65 20 73  tabase,.SQLite s
2050: 68 61 6c 6c 20 66 69 72 73 74 20 6f 70 65 6e 20  hall first open 
2060: 61 20 3c 69 3e 72 65 61 64 20 74 72 61 6e 73 61  a <i>read transa
2070: 63 74 69 6f 6e 3c 2f 69 3e 2c 20 69 66 20 74 68  ction</i>, if th
2080: 65 20 3c 69 3e 64 61 74 61 62 61 73 65 0a 63 6f  e <i>database.co
2090: 6e 6e 65 63 74 69 6f 6e 3c 2f 69 3e 20 69 6e 20  nnection</i> in 
20a0: 71 75 65 73 74 69 6f 6e 20 68 61 73 20 6e 6f 74  question has not
20b0: 20 61 6c 72 65 61 64 79 20 6f 70 65 6e 65 64 20   already opened 
20c0: 6f 6e 65 2e 0a 0a 48 4c 52 20 48 33 35 33 36 30  one...HLR H35360
20d0: 20 0a 57 68 65 6e 20 72 65 71 75 69 72 65 64 20   .When required 
20e0: 74 6f 20 6f 70 65 6e 20 61 20 3c 69 3e 77 72 69  to open a <i>wri
20f0: 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 3c 2f  te transaction</
2100: 69 3e 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61  i> on the databa
2110: 73 65 2c 20 61 66 74 65 72 0a 65 6e 73 75 72 69  se, after.ensuri
2120: 6e 67 20 61 20 3c 69 3e 72 65 61 64 20 74 72 61  ng a <i>read tra
2130: 6e 73 61 63 74 69 6f 6e 3c 2f 69 3e 20 68 61 73  nsaction</i> has
2140: 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 6f 70   already been op
2150: 65 6e 65 64 2c 20 53 51 4c 69 74 65 0a 73 68 61  ened, SQLite.sha
2160: 6c 6c 20 6f 62 74 61 69 6e 20 61 20 3c 69 3e 72  ll obtain a <i>r
2170: 65 73 65 72 76 65 64 20 6c 6f 63 6b 3c 2f 69 3e  eserved lock</i>
2180: 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65   on the database
2190: 20 66 69 6c 65 20 62 79 20 63 61 6c 6c 69 6e 67   file by calling
21a0: 0a 74 68 65 20 78 4c 6f 63 6b 20 6d 65 74 68 6f  .the xLock metho
21b0: 64 20 6f 66 20 74 68 65 20 66 69 6c 65 2d 68 61  d of the file-ha
21c0: 6e 64 6c 65 20 6f 70 65 6e 20 6f 6e 20 74 68 65  ndle open on the
21d0: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a   database file..
21e0: 0a 48 4c 52 20 48 33 35 33 37 30 20 0a 57 68 65  .HLR H35370 .Whe
21f0: 6e 20 72 65 71 75 69 72 65 64 20 74 6f 20 6f 70  n required to op
2200: 65 6e 20 61 20 3c 69 3e 77 72 69 74 65 20 74 72  en a <i>write tr
2210: 61 6e 73 61 63 74 69 6f 6e 3c 2f 69 3e 20 6f 6e  ansaction</i> on
2220: 20 74 68 65 20 64 61 74 61 62 61 73 65 2c 20 61   the database, a
2230: 66 74 65 72 0a 6f 62 74 61 69 6e 69 6e 67 20 61  fter.obtaining a
2240: 20 3c 69 3e 72 65 73 65 72 76 65 64 20 6c 6f 63   <i>reserved loc
2250: 6b 3c 2f 69 3e 20 6f 6e 20 74 68 65 20 64 61 74  k</i> on the dat
2260: 61 62 61 73 65 20 66 69 6c 65 2c 20 53 51 4c 69  abase file, SQLi
2270: 74 65 20 73 68 61 6c 6c 0a 6f 70 65 6e 20 61 20  te shall.open a 
2280: 72 65 61 64 2f 77 72 69 74 65 20 66 69 6c 65 2d  read/write file-
2290: 68 61 6e 64 6c 65 20 6f 6e 20 74 68 65 20 63 6f  handle on the co
22a0: 72 72 65 73 70 6f 6e 64 69 6e 67 20 3c 69 3e 6a  rresponding <i>j
22b0: 6f 75 72 6e 61 6c 20 66 69 6c 65 3c 2f 69 3e 2e  ournal file</i>.
22c0: 0a 0a 48 4c 52 20 48 33 35 33 38 30 20 0a 57 68  ..HLR H35380 .Wh
22d0: 65 6e 20 72 65 71 75 69 72 65 64 20 74 6f 20 6f  en required to o
22e0: 70 65 6e 20 61 20 3c 69 3e 77 72 69 74 65 20 74  pen a <i>write t
22f0: 72 61 6e 73 61 63 74 69 6f 6e 3c 2f 69 3e 20 6f  ransaction</i> o
2300: 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 2c 20  n the database, 
2310: 61 66 74 65 72 0a 6f 70 65 6e 69 6e 67 20 61 20  after.opening a 
2320: 66 69 6c 65 2d 68 61 6e 64 6c 65 20 6f 6e 20 74  file-handle on t
2330: 68 65 20 3c 69 3e 6a 6f 75 72 6e 61 6c 20 66 69  he <i>journal fi
2340: 6c 65 3c 2f 69 3e 2c 20 53 51 4c 69 74 65 20 73  le</i>, SQLite s
2350: 68 61 6c 6c 20 61 70 70 65 6e 64 0a 61 20 3c 69  hall append.a <i
2360: 3e 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 3c  >journal header<
2370: 2f 69 3e 20 74 6f 20 74 68 65 20 28 63 75 72 72  /i> to the (curr
2380: 65 6e 74 6c 79 20 65 6d 70 74 79 29 20 3c 69 3e  ently empty) <i>
2390: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 3c 2f 69 3e  journal file</i>
23a0: 2e 0a 0a 48 4c 52 20 48 33 35 34 30 30 20 0a 57  ...HLR H35400 .W
23b0: 68 65 6e 20 61 20 3c 69 3e 64 61 74 61 62 61 73  hen a <i>databas
23c0: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 3c 2f 69 3e  e connection</i>
23d0: 20 69 73 20 63 6c 6f 73 65 64 2c 20 53 51 4c 69   is closed, SQLi
23e0: 74 65 20 73 68 61 6c 6c 20 63 6c 6f 73 65 20 74  te shall close t
23f0: 68 65 0a 61 73 73 6f 63 69 61 74 65 64 20 66 69  he.associated fi
2400: 6c 65 20 68 61 6e 64 6c 65 20 61 74 20 74 68 65  le handle at the
2410: 20 56 46 53 20 6c 65 76 65 6c 2e 0a 0a 48 4c 52   VFS level...HLR
2420: 20 48 33 35 34 32 30 20 0a 53 51 4c 69 74 65 20   H35420 .SQLite 
2430: 73 68 61 6c 6c 20 65 6e 73 75 72 65 20 74 68 61  shall ensure tha
2440: 74 20 61 20 3c 69 3e 64 61 74 61 62 61 73 65 20  t a <i>database 
2450: 63 6f 6e 6e 65 63 74 69 6f 6e 3c 2f 69 3e 20 68  connection</i> h
2460: 61 73 20 61 6e 20 6f 70 65 6e 0a 72 65 61 64 2d  as an open.read-
2470: 6f 6e 6c 79 20 6f 72 20 72 65 61 64 2f 77 72 69  only or read/wri
2480: 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 62  te transaction b
2490: 65 66 6f 72 65 20 75 73 69 6e 67 20 64 61 74 61  efore using data
24a0: 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 3c   stored in the <
24b0: 69 3e 70 61 67 65 0a 63 61 63 68 65 3c 2f 69 3e  i>page.cache</i>
24c0: 20 74 6f 20 73 61 74 69 73 66 79 20 75 73 65 72   to satisfy user
24d0: 20 71 75 65 72 69 65 73 2e 0a 0a 48 4c 52 20 48   queries...HLR H
24e0: 33 35 34 33 30 20 0a 57 68 65 6e 20 61 20 3c 69  35430 .When a <i
24f0: 3e 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63  >database connec
2500: 74 69 6f 6e 3c 2f 69 3e 20 69 73 20 63 6c 6f 73  tion</i> is clos
2510: 65 64 2c 20 61 6c 6c 20 61 73 73 6f 63 69 61 74  ed, all associat
2520: 65 64 20 3c 69 3e 70 61 67 65 0a 63 61 63 68 65  ed <i>page.cache
2530: 3c 2f 69 3e 20 65 6e 74 72 69 65 73 20 73 68 61  </i> entries sha
2540: 6c 6c 20 62 65 20 64 69 73 63 61 72 64 65 64 2e  ll be discarded.
2550: 0a 0a 48 4c 52 20 48 33 35 34 34 30 20 0a 49 66  ..HLR H35440 .If
2560: 20 77 68 69 6c 65 20 61 74 74 65 6d 70 74 69 6e   while attemptin
2570: 67 20 74 6f 20 64 65 74 65 63 74 20 61 20 3c 69  g to detect a <i
2580: 3e 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 66 69 6c  >hot-journal fil
2590: 65 3c 2f 69 3e 20 74 68 65 20 63 61 6c 6c 20 74  e</i> the call t
25a0: 6f 0a 78 43 68 65 63 6b 52 65 73 65 72 76 65 64  o.xCheckReserved
25b0: 4c 6f 63 6b 28 29 20 69 6e 64 69 63 61 74 65 73  Lock() indicates
25c0: 20 74 68 61 74 20 6e 6f 20 70 72 6f 63 65 73 73   that no process
25d0: 20 68 6f 6c 64 73 20 61 20 3c 69 3e 72 65 73 65   holds a <i>rese
25e0: 72 76 65 64 3c 2f 69 3e 0a 6f 72 20 67 72 65 61  rved</i>.or grea
25f0: 74 65 72 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20  ter lock on the 
2600: 3c 69 3e 64 61 74 61 62 61 73 65 20 66 69 6c 65  <i>database file
2610: 3c 2f 69 3e 2c 20 74 68 65 6e 20 53 51 4c 69 74  </i>, then SQLit
2620: 65 20 73 68 61 6c 6c 20 6f 70 65 6e 0a 61 20 66  e shall open.a f
2630: 69 6c 65 20 68 61 6e 64 6c 65 20 6f 6e 20 74 68  ile handle on th
2640: 65 20 70 6f 74 65 6e 74 69 61 6c 6c 79 20 68 6f  e potentially ho
2650: 74 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 75  t journal file u
2660: 73 69 6e 67 20 74 68 65 20 56 46 53 20 78 4f 70  sing the VFS xOp
2670: 65 6e 28 29 0a 6d 65 74 68 6f 64 2e 0a 0a 48 4c  en().method...HL
2680: 52 20 48 33 35 34 35 30 20 0a 41 66 74 65 72 20  R H35450 .After 
2690: 73 75 63 63 65 73 73 66 75 6c 6c 79 20 6f 70 65  successfully ope
26a0: 6e 69 6e 67 20 61 20 66 69 6c 65 2d 68 61 6e 64  ning a file-hand
26b0: 6c 65 20 6f 6e 20 61 20 70 6f 74 65 6e 74 69 61  le on a potentia
26c0: 6c 6c 79 20 68 6f 74 20 6a 6f 75 72 6e 61 6c 0a  lly hot journal.
26d0: 66 69 6c 65 2c 20 53 51 4c 69 74 65 20 73 68 61  file, SQLite sha
26e0: 6c 6c 20 71 75 65 72 79 20 74 68 65 20 66 69 6c  ll query the fil
26f0: 65 20 66 6f 72 20 69 74 73 20 73 69 7a 65 20 69  e for its size i
2700: 6e 20 62 79 74 65 73 20 75 73 69 6e 67 20 74 68  n bytes using th
2710: 65 0a 78 46 69 6c 65 53 69 7a 65 28 29 20 6d 65  e.xFileSize() me
2720: 74 68 6f 64 20 6f 66 20 74 68 65 20 6f 70 65 6e  thod of the open
2730: 20 66 69 6c 65 20 68 61 6e 64 6c 65 2e 0a 0a 48   file handle...H
2740: 4c 52 20 48 33 35 34 36 30 20 0a 49 66 20 74 68  LR H35460 .If th
2750: 65 20 73 69 7a 65 20 6f 66 20 61 20 70 6f 74 65  e size of a pote
2760: 6e 74 69 61 6c 6c 79 20 68 6f 74 20 6a 6f 75 72  ntially hot jour
2770: 6e 61 6c 20 66 69 6c 65 20 69 73 20 72 65 76 65  nal file is reve
2780: 61 6c 65 64 20 74 6f 20 62 65 20 7a 65 72 6f 0a  aled to be zero.
2790: 62 79 74 65 73 20 62 79 20 61 20 71 75 65 72 79  bytes by a query
27a0: 20 72 65 71 75 69 72 65 64 20 62 79 20 48 33 35   required by H35
27b0: 34 35 30 2c 20 74 68 65 6e 20 53 51 4c 69 74 65  450, then SQLite
27c0: 20 73 68 61 6c 6c 20 63 6c 6f 73 65 20 74 68 65   shall close the
27d0: 0a 66 69 6c 65 20 68 61 6e 64 6c 65 20 6f 70 65  .file handle ope
27e0: 6e 65 64 20 6f 6e 20 74 68 65 20 6a 6f 75 72 6e  ned on the journ
27f0: 61 6c 20 66 69 6c 65 20 61 6e 64 20 64 65 6c 65  al file and dele
2800: 74 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66  te the journal f
2810: 69 6c 65 20 75 73 69 6e 67 0a 61 20 63 61 6c 6c  ile using.a call
2820: 20 74 6f 20 74 68 65 20 56 46 53 20 78 44 65 6c   to the VFS xDel
2830: 65 74 65 28 29 20 6d 65 74 68 6f 64 2e 20 49 6e  ete() method. In
2840: 20 74 68 69 73 20 63 61 73 65 20 53 51 4c 69 74   this case SQLit
2850: 65 20 73 68 61 6c 6c 20 63 6f 6e 63 6c 75 64 65  e shall conclude
2860: 0a 74 68 61 74 20 74 68 65 72 65 20 69 73 20 6e  .that there is n
2870: 6f 20 3c 69 3e 68 6f 74 20 6a 6f 75 72 6e 61 6c  o <i>hot journal
2880: 20 66 69 6c 65 3c 2f 69 3e 2e 0a 0a 48 4c 52 20   file</i>...HLR 
2890: 48 33 35 34 37 30 20 0a 49 66 20 74 68 65 20 73  H35470 .If the s
28a0: 69 7a 65 20 6f 66 20 61 20 70 6f 74 65 6e 74 69  ize of a potenti
28b0: 61 6c 6c 79 20 68 6f 74 20 6a 6f 75 72 6e 61 6c  ally hot journal
28c0: 20 66 69 6c 65 20 69 73 20 72 65 76 65 61 6c 65   file is reveale
28d0: 64 20 74 6f 20 62 65 20 67 72 65 61 74 65 72 0a  d to be greater.
28e0: 74 68 61 6e 20 7a 65 72 6f 20 62 79 74 65 73 20  than zero bytes 
28f0: 62 79 20 61 20 71 75 65 72 79 20 72 65 71 75 69  by a query requi
2900: 72 65 64 20 62 79 20 48 33 35 34 35 30 2c 20 74  red by H35450, t
2910: 68 65 6e 20 53 51 4c 69 74 65 20 73 68 61 6c 6c  hen SQLite shall
2920: 20 61 74 74 65 6d 70 74 0a 74 6f 20 75 70 67 72   attempt.to upgr
2930: 61 64 65 20 74 68 65 20 3c 69 3e 73 68 61 72 65  ade the <i>share
2940: 64 20 6c 6f 63 6b 3c 2f 69 3e 20 68 65 6c 64 20  d lock</i> held 
2950: 62 79 20 74 68 65 20 3c 69 3e 64 61 74 61 62 61  by the <i>databa
2960: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 3c 2f 69  se connection</i
2970: 3e 0a 6f 6e 20 74 68 65 20 3c 69 3e 64 61 74 61  >.on the <i>data
2980: 62 61 73 65 20 66 69 6c 65 3c 2f 69 3e 20 64 69  base file</i> di
2990: 72 65 63 74 6c 79 20 74 6f 20 61 6e 20 3c 69 3e  rectly to an <i>
29a0: 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 3c 2f  exclusive lock</
29b0: 69 3e 2e 0a 0a 48 4c 52 20 48 33 35 34 38 30 20  i>...HLR H35480 
29c0: 0a 49 66 20 61 6e 20 61 74 74 65 6d 70 74 20 74  .If an attempt t
29d0: 6f 20 75 70 67 72 61 64 65 20 74 6f 20 61 6e 20  o upgrade to an 
29e0: 3c 69 3e 65 78 63 6c 75 73 69 76 65 20 6c 6f 63  <i>exclusive loc
29f0: 6b 3c 2f 69 3e 20 70 72 65 73 63 72 69 62 65 64  k</i> prescribed
2a00: 20 62 79 0a 48 33 35 34 37 30 20 66 61 69 6c 73   by.H35470 fails
2a10: 20 66 6f 72 20 61 6e 79 20 72 65 61 73 6f 6e 2c   for any reason,
2a20: 20 74 68 65 6e 20 53 51 4c 69 74 65 20 73 68 61   then SQLite sha
2a30: 6c 6c 20 72 65 6c 65 61 73 65 20 61 6c 6c 20 6c  ll release all l
2a40: 6f 63 6b 73 20 68 65 6c 64 20 62 79 0a 74 68 65  ocks held by.the
2a50: 20 3c 69 3e 64 61 74 61 62 61 73 65 20 63 6f 6e   <i>database con
2a60: 6e 65 63 74 69 6f 6e 3c 2f 69 3e 20 61 6e 64 20  nection</i> and 
2a70: 63 6c 6f 73 65 20 74 68 65 20 66 69 6c 65 20 68  close the file h
2a80: 61 6e 64 6c 65 20 6f 70 65 6e 65 64 20 6f 6e 20  andle opened on 
2a90: 74 68 65 0a 3c 69 3e 6a 6f 75 72 6e 61 6c 20 66  the.<i>journal f
2aa0: 69 6c 65 3c 2f 69 3e 2e 20 54 68 65 20 61 74 74  ile</i>. The att
2ab0: 65 6d 70 74 20 74 6f 20 6f 70 65 6e 20 61 20 3c  empt to open a <
2ac0: 69 3e 72 65 61 64 2d 6f 6e 6c 79 20 74 72 61 6e  i>read-only tran
2ad0: 73 61 63 74 69 6f 6e 3c 2f 69 3e 0a 73 68 61 6c  saction</i>.shal
2ae0: 6c 20 62 65 20 64 65 65 6d 65 64 20 74 6f 20 68  l be deemed to h
2af0: 61 76 65 20 66 61 69 6c 65 64 20 61 6e 64 20 61  ave failed and a
2b00: 6e 20 65 72 72 6f 72 20 72 65 74 75 72 6e 65 64  n error returned
2b10: 20 74 6f 20 74 68 65 20 75 73 65 72 2e 0a 0a 48   to the user...H
2b20: 4c 52 20 48 33 35 34 39 30 20 0a 49 66 2c 20 61  LR H35490 .If, a
2b30: 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 3c 69  s part of the <i
2b40: 3e 68 6f 74 20 6a 6f 75 72 6e 61 6c 20 66 69 6c  >hot journal fil
2b50: 65 3c 2f 69 3e 20 64 65 74 65 63 74 69 6f 6e 20  e</i> detection 
2b60: 70 72 6f 63 65 73 73 2c 20 74 68 65 0a 61 74 74  process, the.att
2b70: 65 6d 70 74 20 74 6f 20 75 70 67 72 61 64 65 20  empt to upgrade 
2b80: 74 6f 20 61 6e 20 3c 69 3e 65 78 63 6c 75 73 69  to an <i>exclusi
2b90: 76 65 20 6c 6f 63 6b 3c 2f 69 3e 20 6d 61 6e 64  ve lock</i> mand
2ba0: 61 74 65 64 20 62 79 20 48 33 35 34 37 30 20 69  ated by H35470 i
2bb0: 73 0a 73 75 63 63 65 73 73 66 75 6c 2c 20 74 68  s.successful, th
2bc0: 65 6e 20 53 51 4c 69 74 65 20 73 68 61 6c 6c 20  en SQLite shall 
2bd0: 71 75 65 72 79 20 74 68 65 20 66 69 6c 65 2d 73  query the file-s
2be0: 79 73 74 65 6d 20 75 73 69 6e 67 20 74 68 65 20  ystem using the 
2bf0: 78 41 63 63 65 73 73 28 29 0a 6d 65 74 68 6f 64  xAccess().method
2c00: 20 6f 66 20 74 68 65 20 56 46 53 20 69 6d 70 6c   of the VFS impl
2c10: 65 6d 65 6e 74 61 74 69 6f 6e 20 74 6f 20 74 65  ementation to te
2c20: 73 74 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f  st whether or no
2c30: 74 20 74 68 65 20 6a 6f 75 72 6e 61 6c 0a 66 69  t the journal.fi
2c40: 6c 65 20 69 73 20 73 74 69 6c 6c 20 70 72 65 73  le is still pres
2c50: 65 6e 74 20 69 6e 20 74 68 65 20 66 69 6c 65 2d  ent in the file-
2c60: 73 79 73 74 65 6d 2e 0a 0a 48 4c 52 20 48 33 35  system...HLR H35
2c70: 35 30 30 20 0a 49 66 20 74 68 65 20 78 41 63 63  500 .If the xAcc
2c80: 65 73 73 28 29 20 71 75 65 72 79 20 72 65 71 75  ess() query requ
2c90: 69 72 65 64 20 62 79 20 48 33 35 34 39 30 20 72  ired by H35490 r
2ca0: 65 76 65 61 6c 73 20 74 68 61 74 20 74 68 65 20  eveals that the 
2cb0: 6a 6f 75 72 6e 61 6c 0a 66 69 6c 65 20 69 73 20  journal.file is 
2cc0: 73 74 69 6c 6c 20 70 72 65 73 65 6e 74 20 69 6e  still present in
2cd0: 20 74 68 65 20 66 69 6c 65 20 73 79 73 74 65 6d   the file system
2ce0: 2c 20 74 68 65 6e 20 53 51 4c 69 74 65 20 73 68  , then SQLite sh
2cf0: 61 6c 6c 20 63 6f 6e 63 6c 75 64 65 0a 74 68 61  all conclude.tha
2d00: 74 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69  t the journal fi
2d10: 6c 65 20 69 73 20 61 20 3c 69 3e 68 6f 74 20 6a  le is a <i>hot j
2d20: 6f 75 72 6e 61 6c 20 66 69 6c 65 3c 2f 69 3e 20  ournal file</i> 
2d30: 74 68 61 74 20 6e 65 65 64 73 20 74 6f 0a 62 65  that needs to.be
2d40: 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 53 51   rolled back. SQ
2d50: 4c 69 74 65 20 73 68 61 6c 6c 20 69 6d 6d 65 64  Lite shall immed
2d60: 69 61 74 65 6c 79 20 62 65 67 69 6e 20 3c 69 3e  iately begin <i>
2d70: 68 6f 74 20 6a 6f 75 72 6e 61 6c 0a 72 6f 6c 6c  hot journal.roll
2d80: 62 61 63 6b 3c 2f 69 3e 2e 0a 0a 48 4c 52 20 48  back</i>...HLR H
2d90: 33 35 35 31 30 20 0a 49 66 20 74 68 65 20 63 61  35510 .If the ca
2da0: 6c 6c 20 74 6f 20 78 41 63 63 65 73 73 28 29 20  ll to xAccess() 
2db0: 72 65 71 75 69 72 65 64 20 62 79 20 48 33 35 31  required by H351
2dc0: 34 30 20 66 61 69 6c 73 20 28 64 75 65 20 74 6f  40 fails (due to
2dd0: 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 6f 72 0a   an IO error or.
2de0: 73 69 6d 69 6c 61 72 29 2c 20 74 68 65 6e 20 53  similar), then S
2df0: 51 4c 69 74 65 20 73 68 61 6c 6c 20 61 62 61 6e  QLite shall aban
2e00: 64 6f 6e 20 74 68 65 20 61 74 74 65 6d 70 74 20  don the attempt 
2e10: 74 6f 20 6f 70 65 6e 20 61 20 3c 69 3e 72 65 61  to open a <i>rea
2e20: 64 2d 6f 6e 6c 79 0a 74 72 61 6e 73 61 63 74 69  d-only.transacti
2e30: 6f 6e 3c 2f 69 3e 2c 20 72 65 6c 69 6e 71 75 69  on</i>, relinqui
2e40: 73 68 20 74 68 65 20 3c 69 3e 73 68 61 72 65 64  sh the <i>shared
2e50: 20 6c 6f 63 6b 3c 2f 69 3e 20 68 65 6c 64 20 6f   lock</i> held o
2e60: 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 66  n the database.f
2e70: 69 6c 65 20 61 6e 64 20 72 65 74 75 72 6e 20 61  ile and return a
2e80: 6e 20 65 72 72 6f 72 20 74 6f 20 74 68 65 20 75  n error to the u
2e90: 73 65 72 2e 0a 0a 48 4c 52 20 48 33 35 35 32 30  ser...HLR H35520
2ea0: 20 0a 49 66 20 74 68 65 20 63 61 6c 6c 20 74 6f   .If the call to
2eb0: 20 78 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c   xCheckReservedL
2ec0: 6f 63 6b 28 29 20 72 65 71 75 69 72 65 64 20 62  ock() required b
2ed0: 79 20 48 33 35 31 36 30 20 66 61 69 6c 73 20 28  y H35160 fails (
2ee0: 64 75 65 20 74 6f 20 61 6e 0a 49 4f 20 6f 72 20  due to an.IO or 
2ef0: 6f 74 68 65 72 20 69 6e 74 65 72 6e 61 6c 20 56  other internal V
2f00: 46 53 20 65 72 72 6f 72 29 2c 20 74 68 65 6e 20  FS error), then 
2f10: 53 51 4c 69 74 65 20 73 68 61 6c 6c 20 61 62 61  SQLite shall aba
2f20: 6e 64 6f 6e 20 74 68 65 20 61 74 74 65 6d 70 74  ndon the attempt
2f30: 0a 74 6f 20 6f 70 65 6e 20 61 20 3c 69 3e 72 65  .to open a <i>re
2f40: 61 64 2d 6f 6e 6c 79 20 74 72 61 6e 73 61 63 74  ad-only transact
2f50: 69 6f 6e 3c 2f 69 3e 2c 20 72 65 6c 69 6e 71 75  ion</i>, relinqu
2f60: 69 73 68 20 74 68 65 20 3c 69 3e 73 68 61 72 65  ish the <i>share
2f70: 64 20 6c 6f 63 6b 3c 2f 69 3e 0a 68 65 6c 64 20  d lock</i>.held 
2f80: 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20  on the database 
2f90: 66 69 6c 65 20 61 6e 64 20 72 65 74 75 72 6e 20  file and return 
2fa0: 61 6e 20 65 72 72 6f 72 20 74 6f 20 74 68 65 20  an error to the 
2fb0: 75 73 65 72 2e 0a 0a 48 4c 52 20 48 33 35 35 33  user...HLR H3553
2fc0: 30 20 0a 49 66 20 74 68 65 20 63 61 6c 6c 20 74  0 .If the call t
2fd0: 6f 20 78 4f 70 65 6e 28 29 20 72 65 71 75 69 72  o xOpen() requir
2fe0: 65 64 20 62 79 20 48 33 35 34 34 30 20 66 61 69  ed by H35440 fai
2ff0: 6c 73 20 28 64 75 65 20 74 6f 20 61 6e 20 49 4f  ls (due to an IO
3000: 20 6f 72 20 6f 74 68 65 72 0a 69 6e 74 65 72 6e   or other.intern
3010: 61 6c 20 56 46 53 20 65 72 72 6f 72 29 2c 20 74  al VFS error), t
3020: 68 65 6e 20 53 51 4c 69 74 65 20 73 68 61 6c 6c  hen SQLite shall
3030: 20 61 62 61 6e 64 6f 6e 20 74 68 65 20 61 74 74   abandon the att
3040: 65 6d 70 74 20 74 6f 20 6f 70 65 6e 20 61 0a 3c  empt to open a.<
3050: 69 3e 72 65 61 64 2d 6f 6e 6c 79 20 74 72 61 6e  i>read-only tran
3060: 73 61 63 74 69 6f 6e 3c 2f 69 3e 2c 20 72 65 6c  saction</i>, rel
3070: 69 6e 71 75 69 73 68 20 74 68 65 20 3c 69 3e 73  inquish the <i>s
3080: 68 61 72 65 64 20 6c 6f 63 6b 3c 2f 69 3e 20 68  hared lock</i> h
3090: 65 6c 64 20 6f 6e 0a 74 68 65 20 64 61 74 61 62  eld on.the datab
30a0: 61 73 65 20 66 69 6c 65 20 61 6e 64 20 72 65 74  ase file and ret
30b0: 75 72 6e 20 61 6e 20 65 72 72 6f 72 20 74 6f 20  urn an error to 
30c0: 74 68 65 20 75 73 65 72 2e 0a 0a 48 4c 52 20 48  the user...HLR H
30d0: 33 35 35 34 30 20 0a 49 66 20 74 68 65 20 63 61  35540 .If the ca
30e0: 6c 6c 20 74 6f 20 78 46 69 6c 65 53 69 7a 65 28  ll to xFileSize(
30f0: 29 20 72 65 71 75 69 72 65 64 20 62 79 20 48 33  ) required by H3
3100: 35 34 35 30 20 66 61 69 6c 73 20 28 64 75 65 20  5450 fails (due 
3110: 74 6f 20 61 6e 20 49 4f 20 6f 72 0a 6f 74 68 65  to an IO or.othe
3120: 72 20 69 6e 74 65 72 6e 61 6c 20 56 46 53 20 65  r internal VFS e
3130: 72 72 6f 72 29 2c 20 74 68 65 6e 20 53 51 4c 69  rror), then SQLi
3140: 74 65 20 73 68 61 6c 6c 20 61 62 61 6e 64 6f 6e  te shall abandon
3150: 20 74 68 65 20 61 74 74 65 6d 70 74 20 74 6f 20   the attempt to 
3160: 6f 70 65 6e 0a 61 20 3c 69 3e 72 65 61 64 2d 6f  open.a <i>read-o
3170: 6e 6c 79 20 74 72 61 6e 73 61 63 74 69 6f 6e 3c  nly transaction<
3180: 2f 69 3e 2c 20 72 65 6c 69 6e 71 75 69 73 68 20  /i>, relinquish 
3190: 74 68 65 20 3c 69 3e 73 68 61 72 65 64 20 6c 6f  the <i>shared lo
31a0: 63 6b 3c 2f 69 3e 20 68 65 6c 64 20 6f 6e 0a 74  ck</i> held on.t
31b0: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  he database file
31c0: 2c 20 63 6c 6f 73 65 20 74 68 65 20 66 69 6c 65  , close the file
31d0: 20 68 61 6e 64 6c 65 20 6f 70 65 6e 65 64 20 6f   handle opened o
31e0: 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69  n the journal fi
31f0: 6c 65 20 61 6e 64 0a 72 65 74 75 72 6e 20 61 6e  le and.return an
3200: 20 65 72 72 6f 72 20 74 6f 20 74 68 65 20 75 73   error to the us
3210: 65 72 2e 0a 0a 48 4c 52 20 48 33 35 35 35 30 20  er...HLR H35550 
3220: 0a 49 66 20 74 68 65 20 63 61 6c 6c 20 74 6f 20  .If the call to 
3230: 78 44 65 6c 65 74 65 28 29 20 72 65 71 75 69 72  xDelete() requir
3240: 65 64 20 62 79 20 48 33 35 34 35 30 20 66 61 69  ed by H35450 fai
3250: 6c 73 20 28 64 75 65 20 74 6f 20 61 6e 20 49 4f  ls (due to an IO
3260: 20 6f 72 0a 6f 74 68 65 72 20 69 6e 74 65 72 6e   or.other intern
3270: 61 6c 20 56 46 53 20 65 72 72 6f 72 29 2c 20 74  al VFS error), t
3280: 68 65 6e 20 53 51 4c 69 74 65 20 73 68 61 6c 6c  hen SQLite shall
3290: 20 61 62 61 6e 64 6f 6e 20 74 68 65 20 61 74 74   abandon the att
32a0: 65 6d 70 74 20 74 6f 20 6f 70 65 6e 0a 61 20 3c  empt to open.a <
32b0: 69 3e 72 65 61 64 2d 6f 6e 6c 79 20 74 72 61 6e  i>read-only tran
32c0: 73 61 63 74 69 6f 6e 3c 2f 69 3e 2c 20 72 65 6c  saction</i>, rel
32d0: 69 6e 71 75 69 73 68 20 74 68 65 20 3c 69 3e 73  inquish the <i>s
32e0: 68 61 72 65 64 20 6c 6f 63 6b 3c 2f 69 3e 20 68  hared lock</i> h
32f0: 65 6c 64 20 6f 6e 0a 74 68 65 20 64 61 74 61 62  eld on.the datab
3300: 61 73 65 20 66 69 6c 65 20 61 6e 64 20 72 65 74  ase file and ret
3310: 75 72 6e 20 61 6e 20 65 72 72 6f 72 20 74 6f 20  urn an error to 
3320: 74 68 65 20 75 73 65 72 2e 0a 0a 48 4c 52 20 48  the user...HLR H
3330: 33 35 35 36 30 20 0a 49 66 20 74 68 65 20 63 61  35560 .If the ca
3340: 6c 6c 20 74 6f 20 78 41 63 63 65 73 73 28 29 20  ll to xAccess() 
3350: 72 65 71 75 69 72 65 64 20 62 79 20 48 33 35 34  required by H354
3360: 39 30 20 66 61 69 6c 73 20 28 64 75 65 20 74 6f  90 fails (due to
3370: 20 61 6e 20 49 4f 20 6f 72 0a 6f 74 68 65 72 20   an IO or.other 
3380: 69 6e 74 65 72 6e 61 6c 20 56 46 53 20 65 72 72  internal VFS err
3390: 6f 72 29 2c 20 74 68 65 6e 20 53 51 4c 69 74 65  or), then SQLite
33a0: 20 73 68 61 6c 6c 20 61 62 61 6e 64 6f 6e 20 74   shall abandon t
33b0: 68 65 20 61 74 74 65 6d 70 74 20 74 6f 20 6f 70  he attempt to op
33c0: 65 6e 0a 61 20 3c 69 3e 72 65 61 64 2d 6f 6e 6c  en.a <i>read-onl
33d0: 79 20 74 72 61 6e 73 61 63 74 69 6f 6e 3c 2f 69  y transaction</i
33e0: 3e 2c 20 72 65 6c 69 6e 71 75 69 73 68 20 74 68  >, relinquish th
33f0: 65 20 6c 6f 63 6b 20 68 65 6c 64 20 6f 6e 20 74  e lock held on t
3400: 68 65 0a 64 61 74 61 62 61 73 65 20 66 69 6c 65  he.database file
3410: 2c 20 63 6c 6f 73 65 20 74 68 65 20 66 69 6c 65  , close the file
3420: 20 68 61 6e 64 6c 65 20 6f 70 65 6e 65 64 20 6f   handle opened o
3430: 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69  n the journal fi
3440: 6c 65 20 61 6e 64 0a 72 65 74 75 72 6e 20 61 6e  le and.return an
3450: 20 65 72 72 6f 72 20 74 6f 20 74 68 65 20 75 73   error to the us
3460: 65 72 2e 0a 0a 48 4c 52 20 48 33 35 35 37 30 20  er...HLR H35570 
3470: 0a 49 66 20 74 68 65 20 63 61 6c 6c 20 74 6f 20  .If the call to 
3480: 78 41 63 63 65 73 73 28 29 20 72 65 71 75 69 72  xAccess() requir
3490: 65 64 20 62 79 20 48 33 35 34 39 30 20 72 65 76  ed by H35490 rev
34a0: 65 61 6c 73 20 74 68 61 74 20 74 68 65 20 6a 6f  eals that the jo
34b0: 75 72 6e 61 6c 0a 66 69 6c 65 20 69 73 20 6e 6f  urnal.file is no
34c0: 20 6c 6f 6e 67 65 72 20 70 72 65 73 65 6e 74 20   longer present 
34d0: 69 6e 20 74 68 65 20 66 69 6c 65 20 73 79 73 74  in the file syst
34e0: 65 6d 2c 20 74 68 65 6e 20 53 51 4c 69 74 65 20  em, then SQLite 
34f0: 73 68 61 6c 6c 20 61 62 61 6e 64 6f 6e 0a 74 68  shall abandon.th
3500: 65 20 61 74 74 65 6d 70 74 20 74 6f 20 6f 70 65  e attempt to ope
3510: 6e 20 61 20 3c 69 3e 72 65 61 64 2d 6f 6e 6c 79  n a <i>read-only
3520: 20 74 72 61 6e 73 61 63 74 69 6f 6e 3c 2f 69 3e   transaction</i>
3530: 2c 20 72 65 6c 69 6e 71 75 69 73 68 20 74 68 65  , relinquish the
3540: 0a 6c 6f 63 6b 20 68 65 6c 64 20 6f 6e 20 74 68  .lock held on th
3550: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c  e database file,
3560: 20 63 6c 6f 73 65 20 74 68 65 20 66 69 6c 65 20   close the file 
3570: 68 61 6e 64 6c 65 20 6f 70 65 6e 65 64 20 6f 6e  handle opened on
3580: 20 74 68 65 0a 6a 6f 75 72 6e 61 6c 20 66 69 6c   the.journal fil
3590: 65 20 61 6e 64 20 72 65 74 75 72 6e 20 61 6e 20  e and return an 
35a0: 53 51 4c 49 54 45 5f 42 55 53 59 20 65 72 72 6f  SQLITE_BUSY erro
35b0: 72 20 74 6f 20 74 68 65 20 75 73 65 72 2e 0a 0a  r to the user...
35c0: 48 4c 52 20 48 33 35 35 38 30 20 0a 49 66 20 61  HLR H35580 .If a
35d0: 6e 20 61 74 74 65 6d 70 74 20 74 6f 20 61 63 71  n attempt to acq
35e0: 75 69 72 65 20 61 20 3c 69 3e 72 65 73 65 72 76  uire a <i>reserv
35f0: 65 64 20 6c 6f 63 6b 3c 2f 69 3e 20 70 72 65 73  ed lock</i> pres
3600: 63 72 69 62 65 64 20 62 79 0a 72 65 71 75 69 72  cribed by.requir
3610: 65 6d 65 6e 74 20 48 33 35 33 36 30 20 66 61 69  ement H35360 fai
3620: 6c 73 2c 20 74 68 65 6e 20 53 51 4c 69 74 65 20  ls, then SQLite 
3630: 73 68 61 6c 6c 20 64 65 65 6d 20 74 68 65 20 61  shall deem the a
3640: 74 74 65 6d 70 74 20 74 6f 0a 6f 70 65 6e 20 61  ttempt to.open a
3650: 20 3c 69 3e 77 72 69 74 65 20 74 72 61 6e 73 61   <i>write transa
3660: 63 74 69 6f 6e 3c 2f 69 3e 20 74 6f 20 68 61 76  ction</i> to hav
3670: 65 20 66 61 69 6c 65 64 20 61 6e 64 20 72 65 74  e failed and ret
3680: 75 72 6e 20 61 6e 20 65 72 72 6f 72 0a 74 6f 20  urn an error.to 
3690: 74 68 65 20 75 73 65 72 2e 0a 0a 48 4c 52 20 48  the user...HLR H
36a0: 33 35 35 39 30 20 0a 57 68 65 6e 20 72 65 71 75  35590 .When requ
36b0: 69 72 65 64 20 74 6f 20 6d 6f 64 69 66 79 20 74  ired to modify t
36c0: 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 61  he contents of a
36d0: 6e 20 65 78 69 73 74 69 6e 67 20 64 61 74 61 62  n existing datab
36e0: 61 73 65 20 70 61 67 65 20 74 68 61 74 0a 65 78  ase page that.ex
36f0: 69 73 74 65 64 20 61 6e 64 20 77 61 73 20 6e 6f  isted and was no
3700: 74 20 61 20 3c 69 3e 66 72 65 65 2d 6c 69 73 74  t a <i>free-list
3710: 20 6c 65 61 66 20 70 61 67 65 3c 2f 69 3e 20 77   leaf page</i> w
3720: 68 65 6e 20 74 68 65 20 3c 69 3e 77 72 69 74 65  hen the <i>write
3730: 0a 74 72 61 6e 73 61 63 74 69 6f 6e 3c 2f 69 3e  .transaction</i>
3740: 20 77 61 73 20 6f 70 65 6e 65 64 2c 20 53 51 4c   was opened, SQL
3750: 69 74 65 20 73 68 61 6c 6c 20 6a 6f 75 72 6e 61  ite shall journa
3760: 6c 20 74 68 65 20 70 61 67 65 20 69 66 20 69 74  l the page if it
3770: 20 68 61 73 20 6e 6f 74 0a 61 6c 72 65 61 64 79   has not.already
3780: 20 62 65 65 6e 20 6a 6f 75 72 6e 61 6c 6c 65 64   been journalled
3790: 20 77 69 74 68 69 6e 20 74 68 65 20 63 75 72 72   within the curr
37a0: 65 6e 74 20 3c 69 3e 77 72 69 74 65 20 74 72 61  ent <i>write tra
37b0: 6e 73 61 63 74 69 6f 6e 3c 2f 69 3e 2e 0a 0a 48  nsaction</i>...H
37c0: 4c 52 20 48 33 35 36 30 30 20 0a 57 68 65 6e 20  LR H35600 .When 
37d0: 72 65 71 75 69 72 65 64 20 74 6f 20 6d 6f 64 69  required to modi
37e0: 66 79 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20  fy the contents 
37f0: 6f 66 20 61 6e 20 65 78 69 73 74 69 6e 67 20 64  of an existing d
3800: 61 74 61 62 61 73 65 20 70 61 67 65 2c 0a 53 51  atabase page,.SQ
3810: 4c 69 74 65 20 73 68 61 6c 6c 20 75 70 64 61 74  Lite shall updat
3820: 65 20 74 68 65 20 63 61 63 68 65 64 20 76 65 72  e the cached ver
3830: 73 69 6f 6e 20 6f 66 20 74 68 65 20 64 61 74 61  sion of the data
3840: 62 61 73 65 20 70 61 67 65 20 63 6f 6e 74 65 6e  base page conten
3850: 74 0a 73 74 6f 72 65 64 20 61 73 20 70 61 72 74  t.stored as part
3860: 20 6f 66 20 74 68 65 20 3c 69 3e 70 61 67 65 20   of the <i>page 
3870: 63 61 63 68 65 20 65 6e 74 72 79 3c 2f 69 3e 20  cache entry</i> 
3880: 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20  associated with 
3890: 74 68 65 20 70 61 67 65 2e 0a 0a 48 4c 52 20 48  the page...HLR H
38a0: 33 35 36 31 30 20 0a 57 68 65 6e 20 72 65 71 75  35610 .When requ
38b0: 69 72 65 64 20 74 6f 20 61 70 70 65 6e 64 20 61  ired to append a
38c0: 20 6e 65 77 20 64 61 74 61 62 61 73 65 20 70 61   new database pa
38d0: 67 65 20 74 6f 20 74 68 65 20 64 61 74 61 62 61  ge to the databa
38e0: 73 65 20 66 69 6c 65 2c 0a 53 51 4c 69 74 65 20  se file,.SQLite 
38f0: 73 68 61 6c 6c 20 63 72 65 61 74 65 20 61 20 6e  shall create a n
3900: 65 77 20 3c 69 3e 70 61 67 65 20 63 61 63 68 65  ew <i>page cache
3910: 20 65 6e 74 72 79 3c 2f 69 3e 20 63 6f 72 72 65   entry</i> corre
3920: 73 70 6f 6e 64 69 6e 67 20 74 6f 0a 74 68 65 20  sponding to.the 
3930: 6e 65 77 20 70 61 67 65 20 61 6e 64 20 69 6e 73  new page and ins
3940: 65 72 74 20 69 74 20 69 6e 74 6f 20 74 68 65 20  ert it into the 
3950: 3c 69 3e 70 61 67 65 20 63 61 63 68 65 3c 2f 69  <i>page cache</i
3960: 3e 2e 20 54 68 65 20 3c 69 3e 64 69 72 74 79 0a  >. The <i>dirty.
3970: 66 6c 61 67 3c 2f 69 3e 20 6f 66 20 74 68 65 20  flag</i> of the 
3980: 6e 65 77 20 3c 69 3e 70 61 67 65 20 63 61 63 68  new <i>page cach
3990: 65 20 65 6e 74 72 79 3c 2f 69 3e 20 73 68 61 6c  e entry</i> shal
39a0: 6c 20 62 65 20 73 65 74 2e 0a 0a 48 4c 52 20 48  l be set...HLR H
39b0: 33 35 36 32 30 20 0a 57 68 65 6e 20 72 65 71 75  35620 .When requ
39c0: 69 72 65 64 20 74 6f 20 74 72 75 6e 63 61 74 65  ired to truncate
39d0: 20 28 72 65 6d 6f 76 65 29 20 61 20 64 61 74 61   (remove) a data
39e0: 62 61 73 65 20 70 61 67 65 20 74 68 61 74 20 65  base page that e
39f0: 78 69 73 74 65 64 20 61 6e 64 20 77 61 73 0a 6e  xisted and was.n
3a00: 6f 74 20 61 20 3c 69 3e 66 72 65 65 2d 6c 69 73  ot a <i>free-lis
3a10: 74 20 6c 65 61 66 20 70 61 67 65 3c 2f 69 3e 20  t leaf page</i> 
3a20: 77 68 65 6e 20 74 68 65 20 3c 69 3e 77 72 69 74  when the <i>writ
3a30: 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 3c 2f 69  e transaction</i
3a40: 3e 20 77 61 73 0a 6f 70 65 6e 65 64 20 66 72 6f  > was.opened fro
3a50: 6d 20 74 68 65 20 65 6e 64 20 6f 66 20 61 20 64  m the end of a d
3a60: 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20 53 51  atabase file, SQ
3a70: 4c 69 74 65 20 73 68 61 6c 6c 20 6a 6f 75 72 6e  Lite shall journ
3a80: 61 6c 20 74 68 65 20 70 61 67 65 20 69 66 0a 69  al the page if.i
3a90: 74 20 68 61 73 20 6e 6f 74 20 61 6c 72 65 61 64  t has not alread
3aa0: 79 20 62 65 65 6e 20 6a 6f 75 72 6e 61 6c 6c 65  y been journalle
3ab0: 64 20 77 69 74 68 69 6e 20 74 68 65 20 63 75 72  d within the cur
3ac0: 72 65 6e 74 20 3c 69 3e 77 72 69 74 65 0a 74 72  rent <i>write.tr
3ad0: 61 6e 73 61 63 74 69 6f 6e 3c 2f 69 3e 2e 0a 0a  ansaction</i>...
3ae0: 48 4c 52 20 48 33 35 36 33 30 20 0a 57 68 65 6e  HLR H35630 .When
3af0: 20 72 65 71 75 69 72 65 64 20 74 6f 20 74 72 75   required to tru
3b00: 6e 63 61 74 65 20 61 20 64 61 74 61 62 61 73 65  ncate a database
3b10: 20 70 61 67 65 20 66 72 6f 6d 20 74 68 65 20 65   page from the e
3b20: 6e 64 20 6f 66 20 74 68 65 20 64 61 74 61 62 61  nd of the databa
3b30: 73 65 0a 66 69 6c 65 2c 20 53 51 4c 69 74 65 20  se.file, SQLite 
3b40: 73 68 61 6c 6c 20 64 69 73 63 61 72 64 20 74 68  shall discard th
3b50: 65 20 61 73 73 6f 63 69 61 74 65 64 20 3c 69 3e  e associated <i>
3b60: 70 61 67 65 20 63 61 63 68 65 20 65 6e 74 72 79  page cache entry
3b70: 3c 2f 69 3e 0a 66 72 6f 6d 20 74 68 65 20 70 61  </i>.from the pa
3b80: 67 65 20 63 61 63 68 65 2e 0a 0a 48 4c 52 20 48  ge cache...HLR H
3b90: 33 35 36 34 30 20 0a 57 68 65 6e 20 72 65 71 75  35640 .When requ
3ba0: 69 72 65 64 20 74 6f 20 70 75 72 67 65 20 61 20  ired to purge a 
3bb0: 3c 69 3e 6e 6f 6e 2d 77 72 69 74 61 62 6c 65 20  <i>non-writable 
3bc0: 64 69 72 74 79 20 70 61 67 65 3c 2f 69 3e 20 66  dirty page</i> f
3bd0: 72 6f 6d 20 74 68 65 0a 3c 69 3e 70 61 67 65 20  rom the.<i>page 
3be0: 63 61 63 68 65 3c 2f 69 3e 2c 20 53 51 4c 69 74  cache</i>, SQLit
3bf0: 65 20 73 68 61 6c 6c 20 3c 69 3e 73 79 6e 63 20  e shall <i>sync 
3c00: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  the journal file
3c10: 3c 2f 69 3e 20 62 65 66 6f 72 65 0a 70 72 6f 63  </i> before.proc
3c20: 65 65 64 69 6e 67 20 77 69 74 68 20 74 68 65 20  eeding with the 
3c30: 77 72 69 74 65 20 6f 70 65 72 61 74 69 6f 6e 20  write operation 
3c40: 72 65 71 75 69 72 65 64 20 62 79 20 48 33 35 36  required by H356
3c50: 37 30 2e 0a 0a 48 4c 52 20 48 33 35 36 36 30 20  70...HLR H35660 
3c60: 0a 41 66 74 65 72 20 3c 69 3e 73 79 6e 63 69 6e  .After <i>syncin
3c70: 67 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69  g the journal fi
3c80: 6c 65 3c 2f 69 3e 20 61 73 20 72 65 71 75 69 72  le</i> as requir
3c90: 65 64 20 62 79 20 48 33 35 36 34 30 2c 20 53 51  ed by H35640, SQ
3ca0: 4c 69 74 65 0a 73 68 61 6c 6c 20 61 70 70 65 6e  Lite.shall appen
3cb0: 64 20 61 20 6e 65 77 20 3c 69 3e 6a 6f 75 72 6e  d a new <i>journ
3cc0: 61 6c 20 68 65 61 64 65 72 3c 2f 69 3e 20 74 6f  al header</i> to
3cd0: 20 74 68 65 20 3c 69 3e 6a 6f 75 72 6e 61 6c 20   the <i>journal 
3ce0: 66 69 6c 65 3c 2f 69 3e 0a 62 65 66 6f 72 65 20  file</i>.before 
3cf0: 70 72 6f 63 65 65 64 69 6e 67 20 77 69 74 68 20  proceeding with 
3d00: 74 68 65 20 77 72 69 74 65 20 6f 70 65 72 61 74  the write operat
3d10: 69 6f 6e 20 72 65 71 75 69 72 65 64 20 62 79 20  ion required by 
3d20: 48 33 35 36 37 30 2e 0a 0a 48 4c 52 20 48 33 35  H35670...HLR H35
3d30: 36 37 30 20 0a 57 68 65 6e 20 72 65 71 75 69 72  670 .When requir
3d40: 65 64 20 74 6f 20 70 75 72 67 65 20 61 20 3c 69  ed to purge a <i
3d50: 3e 70 61 67 65 20 63 61 63 68 65 20 65 6e 74 72  >page cache entr
3d60: 79 3c 2f 69 3e 20 74 68 61 74 20 69 73 20 61 0a  y</i> that is a.
3d70: 3c 69 3e 64 69 72 74 79 20 70 61 67 65 3c 2f 69  <i>dirty page</i
3d80: 3e 20 53 51 4c 69 74 65 20 73 68 61 6c 6c 20 77  > SQLite shall w
3d90: 72 69 74 65 20 74 68 65 20 70 61 67 65 20 64 61  rite the page da
3da0: 74 61 20 69 6e 74 6f 20 74 68 65 20 64 61 74 61  ta into the data
3db0: 62 61 73 65 0a 66 69 6c 65 2c 20 75 73 69 6e 67  base.file, using
3dc0: 20 61 20 73 69 6e 67 6c 65 20 63 61 6c 6c 20 74   a single call t
3dd0: 6f 20 74 68 65 20 78 57 72 69 74 65 20 6d 65 74  o the xWrite met
3de0: 68 6f 64 20 6f 66 20 74 68 65 20 3c 69 3e 64 61  hod of the <i>da
3df0: 74 61 62 61 73 65 0a 63 6f 6e 6e 65 63 74 69 6f  tabase.connectio
3e00: 6e 3c 2f 69 3e 20 66 69 6c 65 20 68 61 6e 64 6c  n</i> file handl
3e10: 65 2e 0a 0a 48 4c 52 20 48 33 35 36 38 30 20 0a  e...HLR H35680 .
3e20: 57 68 65 6e 20 72 65 71 75 69 72 65 64 20 74 6f  When required to
3e30: 20 61 70 70 65 6e 64 20 61 20 3c 69 3e 6a 6f 75   append a <i>jou
3e40: 72 6e 61 6c 20 68 65 61 64 65 72 3c 2f 69 3e 20  rnal header</i> 
3e50: 74 6f 20 74 68 65 20 3c 69 3e 6a 6f 75 72 6e 61  to the <i>journa
3e60: 6c 0a 66 69 6c 65 3c 2f 69 3e 2c 20 53 51 4c 69  l.file</i>, SQLi
3e70: 74 65 20 73 68 61 6c 6c 20 64 6f 20 73 6f 20 62  te shall do so b
3e80: 79 20 77 72 69 74 69 6e 67 20 61 20 62 6c 6f 63  y writing a bloc
3e90: 6b 20 6f 66 20 3c 69 3e 73 65 63 74 6f 72 2d 73  k of <i>sector-s
3ea0: 69 7a 65 3c 2f 69 3e 0a 62 79 74 65 73 20 75 73  ize</i>.bytes us
3eb0: 69 6e 67 20 61 20 73 69 6e 67 6c 65 20 63 61 6c  ing a single cal
3ec0: 6c 20 74 6f 20 74 68 65 20 78 57 72 69 74 65 20  l to the xWrite 
3ed0: 6d 65 74 68 6f 64 20 6f 66 20 74 68 65 20 66 69  method of the fi
3ee0: 6c 65 2d 68 61 6e 64 6c 65 0a 6f 70 65 6e 20 6f  le-handle.open o
3ef0: 6e 20 74 68 65 20 3c 69 3e 6a 6f 75 72 6e 61 6c  n the <i>journal
3f00: 20 66 69 6c 65 3c 2f 69 3e 2e 20 54 68 65 20 62   file</i>. The b
3f10: 6c 6f 63 6b 20 6f 66 20 64 61 74 61 20 77 72 69  lock of data wri
3f20: 74 74 65 6e 20 73 68 61 6c 6c 20 62 65 67 69 6e  tten shall begin
3f30: 0a 61 74 20 74 68 65 20 73 6d 61 6c 6c 65 73 74  .at the smallest
3f40: 20 73 65 63 74 6f 72 2d 73 69 7a 65 20 61 6c 69   sector-size ali
3f50: 67 6e 65 64 20 6f 66 66 73 65 74 20 61 74 20 6f  gned offset at o
3f60: 72 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 20  r following the 
3f70: 63 75 72 72 65 6e 74 0a 65 6e 64 20 6f 66 20 74  current.end of t
3f80: 68 65 20 3c 69 3e 6a 6f 75 72 6e 61 6c 20 66 69  he <i>journal fi
3f90: 6c 65 3c 2f 69 3e 2e 0a 0a 48 4c 52 20 48 33 35  le</i>...HLR H35
3fa0: 36 39 30 20 0a 54 68 65 20 66 69 72 73 74 20 38  690 .The first 8
3fb0: 20 62 79 74 65 73 20 6f 66 20 74 68 65 20 3c 69   bytes of the <i
3fc0: 3e 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 3c  >journal header<
3fd0: 2f 69 3e 20 72 65 71 75 69 72 65 64 20 74 6f 20  /i> required to 
3fe0: 62 65 20 77 72 69 74 74 65 6e 0a 62 79 20 48 33  be written.by H3
3ff0: 35 36 38 30 20 73 68 61 6c 6c 20 63 6f 6e 74 61  5680 shall conta
4000: 69 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  in the following
4010: 20 76 61 6c 75 65 73 2c 20 69 6e 20 6f 72 64 65   values, in orde
4020: 72 20 66 72 6f 6d 20 62 79 74 65 20 6f 66 66 73  r from byte offs
4030: 65 74 20 30 0a 74 6f 20 37 3a 20 30 78 64 39 2c  et 0.to 7: 0xd9,
4040: 20 30 78 64 35 2c 20 30 78 30 35 2c 20 30 78 66   0xd5, 0x05, 0xf
4050: 39 2c 20 30 78 32 30 2c 20 30 78 61 31 2c 20 30  9, 0x20, 0xa1, 0
4060: 78 36 33 20 61 6e 64 20 30 78 64 37 2e 0a 0a 48  x63 and 0xd7...H
4070: 4c 52 20 48 33 35 37 30 30 20 0a 42 79 74 65 73  LR H35700 .Bytes
4080: 20 38 2d 31 31 20 6f 66 20 74 68 65 20 3c 69 3e   8-11 of the <i>
4090: 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 3c 2f  journal header</
40a0: 69 3e 20 72 65 71 75 69 72 65 64 20 74 6f 20 62  i> required to b
40b0: 65 20 77 72 69 74 74 65 6e 20 62 79 0a 48 33 35  e written by.H35
40c0: 36 38 30 20 73 68 61 6c 6c 20 63 6f 6e 74 61 69  680 shall contai
40d0: 6e 20 30 78 30 30 2e 0a 0a 48 4c 52 20 48 33 35  n 0x00...HLR H35
40e0: 37 31 30 20 0a 42 79 74 65 73 20 31 32 2d 31 35  710 .Bytes 12-15
40f0: 20 6f 66 20 74 68 65 20 3c 69 3e 6a 6f 75 72 6e   of the <i>journ
4100: 61 6c 20 68 65 61 64 65 72 3c 2f 69 3e 20 72 65  al header</i> re
4110: 71 75 69 72 65 64 20 74 6f 20 62 65 20 77 72 69  quired to be wri
4120: 74 74 65 6e 20 62 79 0a 48 33 35 36 38 30 20 73  tten by.H35680 s
4130: 68 61 6c 6c 20 63 6f 6e 74 61 69 6e 20 74 68 65  hall contain the
4140: 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73   number of pages
4150: 20 74 68 61 74 20 74 68 65 20 64 61 74 61 62 61   that the databa
4160: 73 65 20 66 69 6c 65 0a 63 6f 6e 74 61 69 6e 65  se file.containe
4170: 64 20 77 68 65 6e 20 74 68 65 20 63 75 72 72 65  d when the curre
4180: 6e 74 20 3c 69 3e 77 72 69 74 65 2d 74 72 61 6e  nt <i>write-tran
4190: 73 61 63 74 69 6f 6e 3c 2f 69 3e 20 77 61 73 20  saction</i> was 
41a0: 73 74 61 72 74 65 64 2c 0a 66 6f 72 6d 61 74 74  started,.formatt
41b0: 65 64 20 61 73 20 61 20 34 2d 62 79 74 65 20 62  ed as a 4-byte b
41c0: 69 67 2d 65 6e 64 69 61 6e 20 75 6e 73 69 67 6e  ig-endian unsign
41d0: 65 64 20 69 6e 74 65 67 65 72 2e 0a 0a 48 4c 52  ed integer...HLR
41e0: 20 48 33 35 37 32 30 20 0a 42 79 74 65 73 20 31   H35720 .Bytes 1
41f0: 36 2d 31 39 20 6f 66 20 74 68 65 20 3c 69 3e 6a  6-19 of the <i>j
4200: 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 3c 2f 69  ournal header</i
4210: 3e 20 72 65 71 75 69 72 65 64 20 74 6f 20 62 65  > required to be
4220: 20 77 72 69 74 74 65 6e 20 62 79 0a 48 33 35 36   written by.H356
4230: 38 30 20 73 68 61 6c 6c 20 63 6f 6e 74 61 69 6e  80 shall contain
4240: 20 70 73 65 75 64 6f 2d 72 61 6e 64 6f 6d 6c 79   pseudo-randomly
4250: 20 67 65 6e 65 72 61 74 65 64 20 76 61 6c 75 65   generated value
4260: 73 2e 0a 0a 48 4c 52 20 48 33 35 37 33 30 20 0a  s...HLR H35730 .
4270: 42 79 74 65 73 20 32 30 2d 32 33 20 6f 66 20 74  Bytes 20-23 of t
4280: 68 65 20 3c 69 3e 6a 6f 75 72 6e 61 6c 20 68 65  he <i>journal he
4290: 61 64 65 72 3c 2f 69 3e 20 72 65 71 75 69 72 65  ader</i> require
42a0: 64 20 74 6f 20 62 65 20 77 72 69 74 74 65 6e 20  d to be written 
42b0: 62 79 0a 48 33 35 36 38 30 20 73 68 61 6c 6c 20  by.H35680 shall 
42c0: 63 6f 6e 74 61 69 6e 20 74 68 65 20 3c 69 3e 73  contain the <i>s
42d0: 65 63 74 6f 72 20 73 69 7a 65 3c 2f 69 3e 20 75  ector size</i> u
42e0: 73 65 64 20 62 79 20 74 68 65 20 56 46 53 20 6c  sed by the VFS l
42f0: 61 79 65 72 2c 0a 66 6f 72 6d 61 74 74 65 64 20  ayer,.formatted 
4300: 61 73 20 61 20 34 2d 62 79 74 65 20 62 69 67 2d  as a 4-byte big-
4310: 65 6e 64 69 61 6e 20 75 6e 73 69 67 6e 65 64 20  endian unsigned 
4320: 69 6e 74 65 67 65 72 2e 0a 0a 48 4c 52 20 48 33  integer...HLR H3
4330: 35 37 34 30 20 0a 42 79 74 65 73 20 32 34 2d 32  5740 .Bytes 24-2
4340: 37 20 6f 66 20 74 68 65 20 3c 69 3e 6a 6f 75 72  7 of the <i>jour
4350: 6e 61 6c 20 68 65 61 64 65 72 3c 2f 69 3e 20 72  nal header</i> r
4360: 65 71 75 69 72 65 64 20 74 6f 20 62 65 20 77 72  equired to be wr
4370: 69 74 74 65 6e 20 62 79 0a 48 33 35 36 38 30 20  itten by.H35680 
4380: 73 68 61 6c 6c 20 63 6f 6e 74 61 69 6e 20 74 68  shall contain th
4390: 65 20 3c 69 3e 70 61 67 65 20 73 69 7a 65 3c 2f  e <i>page size</
43a0: 69 3e 20 75 73 65 64 20 62 79 20 74 68 65 20 64  i> used by the d
43b0: 61 74 61 62 61 73 65 20 61 74 0a 74 68 65 20 73  atabase at.the s
43c0: 74 61 72 74 20 6f 66 20 74 68 65 20 3c 69 3e 77  tart of the <i>w
43d0: 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e  rite transaction
43e0: 3c 2f 69 3e 2c 20 66 6f 72 6d 61 74 74 65 64 20  </i>, formatted 
43f0: 61 73 20 61 20 34 2d 62 79 74 65 0a 62 69 67 2d  as a 4-byte.big-
4400: 65 6e 64 69 61 6e 20 75 6e 73 69 67 6e 65 64 20  endian unsigned 
4410: 69 6e 74 65 67 65 72 2e 0a 0a 48 4c 52 20 48 33  integer...HLR H3
4420: 35 37 35 30 20 0a 57 68 65 6e 20 72 65 71 75 69  5750 .When requi
4430: 72 65 64 20 74 6f 20 3c 69 3e 73 79 6e 63 20 74  red to <i>sync t
4440: 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 3c  he journal file<
4450: 2f 69 3e 2c 20 53 51 4c 69 74 65 20 73 68 61 6c  /i>, SQLite shal
4460: 6c 20 69 6e 76 6f 6b 65 20 74 68 65 0a 78 53 79  l invoke the.xSy
4470: 6e 63 20 6d 65 74 68 6f 64 20 6f 66 20 74 68 65  nc method of the
4480: 20 66 69 6c 65 20 68 61 6e 64 6c 65 20 6f 70 65   file handle ope
4490: 6e 20 6f 6e 20 74 68 65 20 3c 69 3e 6a 6f 75 72  n on the <i>jour
44a0: 6e 61 6c 20 66 69 6c 65 3c 2f 69 3e 2e 0a 0a 48  nal file</i>...H
44b0: 4c 52 20 48 33 35 37 36 30 20 0a 57 68 65 6e 20  LR H35760 .When 
44c0: 72 65 71 75 69 72 65 64 20 74 6f 20 3c 69 3e 73  required to <i>s
44d0: 79 6e 63 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20  ync the journal 
44e0: 66 69 6c 65 3c 2f 69 3e 2c 20 61 66 74 65 72 20  file</i>, after 
44f0: 69 6e 76 6f 6b 69 6e 67 20 74 68 65 0a 78 53 79  invoking the.xSy
4500: 6e 63 20 6d 65 74 68 6f 64 20 61 73 20 72 65 71  nc method as req
4510: 75 69 72 65 64 20 62 79 20 48 33 35 37 35 30 2c  uired by H35750,
4520: 20 53 51 4c 69 74 65 20 73 68 61 6c 6c 20 75 70   SQLite shall up
4530: 64 61 74 65 20 74 68 65 20 3c 69 3e 72 65 63 6f  date the <i>reco
4540: 72 64 0a 63 6f 75 6e 74 3c 2f 69 3e 20 6f 66 20  rd.count</i> of 
4550: 74 68 65 20 3c 69 3e 6a 6f 75 72 6e 61 6c 20 68  the <i>journal h
4560: 65 61 64 65 72 3c 2f 69 3e 20 6d 6f 73 74 20 72  eader</i> most r
4570: 65 63 65 6e 74 6c 79 20 77 72 69 74 74 65 6e 20  ecently written 
4580: 74 6f 20 74 68 65 0a 3c 69 3e 6a 6f 75 72 6e 61  to the.<i>journa
4590: 6c 20 66 69 6c 65 3c 2f 69 3e 2e 20 54 68 65 20  l file</i>. The 
45a0: 34 2d 62 79 74 65 20 66 69 65 6c 64 20 73 68 61  4-byte field sha
45b0: 6c 6c 20 62 65 20 75 70 64 61 74 65 64 20 74 6f  ll be updated to
45c0: 20 63 6f 6e 74 61 69 6e 0a 74 68 65 20 6e 75 6d   contain.the num
45d0: 62 65 72 20 6f 66 20 3c 69 3e 6a 6f 75 72 6e 61  ber of <i>journa
45e0: 6c 20 72 65 63 6f 72 64 73 3c 2f 69 3e 20 74 68  l records</i> th
45f0: 61 74 20 68 61 76 65 20 62 65 65 6e 20 77 72 69  at have been wri
4600: 74 74 65 6e 20 74 6f 20 74 68 65 0a 3c 69 3e 6a  tten to the.<i>j
4610: 6f 75 72 6e 61 6c 20 66 69 6c 65 3c 2f 69 3e 20  ournal file</i> 
4620: 73 69 6e 63 65 20 74 68 65 20 3c 69 3e 6a 6f 75  since the <i>jou
4630: 72 6e 61 6c 20 68 65 61 64 65 72 3c 2f 69 3e 20  rnal header</i> 
4640: 77 61 73 20 77 72 69 74 74 65 6e 2c 0a 66 6f 72  was written,.for
4650: 6d 61 74 74 65 64 20 61 73 20 61 20 34 2d 62 79  matted as a 4-by
4660: 74 65 20 62 69 67 2d 65 6e 64 69 61 6e 20 75 6e  te big-endian un
4670: 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 2e 0a  signed integer..
4680: 0a 48 4c 52 20 48 33 35 37 37 30 20 0a 57 68 65  .HLR H35770 .Whe
4690: 6e 20 72 65 71 75 69 72 65 64 20 74 6f 20 3c 69  n required to <i
46a0: 3e 73 79 6e 63 20 74 68 65 20 6a 6f 75 72 6e 61  >sync the journa
46b0: 6c 20 66 69 6c 65 3c 2f 69 3e 2c 20 61 66 74 65  l file</i>, afte
46c0: 72 20 75 70 64 61 74 69 6e 67 20 74 68 65 0a 3c  r updating the.<
46d0: 69 3e 72 65 63 6f 72 64 20 63 6f 75 6e 74 3c 2f  i>record count</
46e0: 69 3e 20 66 69 65 6c 64 20 6f 66 20 61 20 3c 69  i> field of a <i
46f0: 3e 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 3c  >journal header<
4700: 2f 69 3e 20 61 73 20 72 65 71 75 69 72 65 64 20  /i> as required 
4710: 62 79 0a 48 33 35 37 36 30 2c 20 53 51 4c 69 74  by.H35760, SQLit
4720: 65 20 73 68 61 6c 6c 20 69 6e 76 6f 6b 65 20 74  e shall invoke t
4730: 68 65 20 78 53 79 6e 63 20 6d 65 74 68 6f 64 20  he xSync method 
4740: 6f 66 20 74 68 65 20 66 69 6c 65 20 68 61 6e 64  of the file hand
4750: 6c 65 20 6f 70 65 6e 0a 6f 6e 20 74 68 65 20 3c  le open.on the <
4760: 69 3e 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 3c 2f  i>journal file</
4770: 69 3e 2e 0a 0a 48 4c 52 20 48 33 35 37 38 30 20  i>...HLR H35780 
4780: 0a 57 68 65 6e 20 72 65 71 75 69 72 65 64 20 74  .When required t
4790: 6f 20 75 70 67 72 61 64 65 20 74 6f 20 61 6e 20  o upgrade to an 
47a0: 3c 69 3e 65 78 63 6c 75 73 69 76 65 20 6c 6f 63  <i>exclusive loc
47b0: 6b 3c 2f 69 3e 20 61 73 20 70 61 72 74 20 6f 66  k</i> as part of
47c0: 20 61 20 77 72 69 74 65 0a 74 72 61 6e 73 61 63   a write.transac
47d0: 74 69 6f 6e 2c 20 53 51 4c 69 74 65 20 73 68 61  tion, SQLite sha
47e0: 6c 6c 20 66 69 72 73 74 20 61 74 74 65 6d 70 74  ll first attempt
47f0: 20 74 6f 20 6f 62 74 61 69 6e 20 61 20 3c 69 3e   to obtain a <i>
4800: 70 65 6e 64 69 6e 67 20 6c 6f 63 6b 3c 2f 69 3e  pending lock</i>
4810: 0a 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65  .on the database
4820: 20 66 69 6c 65 20 69 66 20 6f 6e 65 20 69 73 20   file if one is 
4830: 6e 6f 74 20 61 6c 72 65 61 64 79 20 68 65 6c 64  not already held
4840: 20 62 79 20 69 6e 76 6f 6b 69 6e 67 20 74 68 65   by invoking the
4850: 20 78 4c 6f 63 6b 0a 6d 65 74 68 6f 64 20 6f 66   xLock.method of
4860: 20 74 68 65 20 66 69 6c 65 20 68 61 6e 64 6c 65   the file handle
4870: 20 6f 70 65 6e 65 64 20 6f 6e 20 74 68 65 20 3c   opened on the <
4880: 69 3e 64 61 74 61 62 61 73 65 20 66 69 6c 65 3c  i>database file<
4890: 2f 69 3e 2e 0a 0a 48 4c 52 20 48 33 35 37 39 30  /i>...HLR H35790
48a0: 20 0a 57 68 65 6e 20 72 65 71 75 69 72 65 64 20   .When required 
48b0: 74 6f 20 75 70 67 72 61 64 65 20 74 6f 20 61 6e  to upgrade to an
48c0: 20 3c 69 3e 65 78 63 6c 75 73 69 76 65 20 6c 6f   <i>exclusive lo
48d0: 63 6b 3c 2f 69 3e 20 61 73 20 70 61 72 74 20 6f  ck</i> as part o
48e0: 66 20 61 20 77 72 69 74 65 0a 74 72 61 6e 73 61  f a write.transa
48f0: 63 74 69 6f 6e 2c 20 61 66 74 65 72 20 73 75 63  ction, after suc
4900: 63 65 73 73 66 75 6c 6c 79 20 6f 62 74 61 69 6e  cessfully obtain
4910: 69 6e 67 20 61 20 3c 69 3e 70 65 6e 64 69 6e 67  ing a <i>pending
4920: 20 6c 6f 63 6b 3c 2f 69 3e 20 53 51 4c 69 74 65   lock</i> SQLite
4930: 0a 73 68 61 6c 6c 20 61 74 74 65 6d 70 74 20 74  .shall attempt t
4940: 6f 20 6f 62 74 61 69 6e 20 61 6e 20 3c 69 3e 65  o obtain an <i>e
4950: 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 3c 2f 69  xclusive lock</i
4960: 3e 20 62 79 20 69 6e 76 6f 6b 69 6e 67 20 74 68  > by invoking th
4970: 65 0a 78 4c 6f 63 6b 20 6d 65 74 68 6f 64 20 6f  e.xLock method o
4980: 66 20 74 68 65 20 66 69 6c 65 20 68 61 6e 64 6c  f the file handl
4990: 65 20 6f 70 65 6e 65 64 20 6f 6e 20 74 68 65 20  e opened on the 
49a0: 3c 69 3e 64 61 74 61 62 61 73 65 20 66 69 6c 65  <i>database file
49b0: 3c 2f 69 3e 2e 0a 0a 48 4c 52 20 48 33 35 38 30  </i>...HLR H3580
49c0: 30 20 0a 57 68 65 6e 20 72 65 71 75 69 72 65 64  0 .When required
49d0: 20 74 6f 20 3c 69 3e 63 6f 6d 6d 69 74 20 61 20   to <i>commit a 
49e0: 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f  write-transactio
49f0: 6e 3c 2f 69 3e 2c 20 53 51 4c 69 74 65 20 73 68  n</i>, SQLite sh
4a00: 61 6c 6c 0a 6d 6f 64 69 66 79 20 70 61 67 65 20  all.modify page 
4a10: 31 20 74 6f 20 69 6e 63 72 65 6d 65 6e 74 20 74  1 to increment t
4a20: 68 65 20 76 61 6c 75 65 20 73 74 6f 72 65 64 20  he value stored 
4a30: 69 6e 20 74 68 65 20 3c 69 3e 63 68 61 6e 67 65  in the <i>change
4a40: 20 63 6f 75 6e 74 65 72 3c 2f 69 3e 0a 66 69 65   counter</i>.fie
4a50: 6c 64 20 6f 66 20 74 68 65 20 3c 69 3e 64 61 74  ld of the <i>dat
4a60: 61 62 61 73 65 20 66 69 6c 65 20 68 65 61 64 65  abase file heade
4a70: 72 3c 2f 69 3e 2e 0a 0a 48 4c 52 20 48 33 35 38  r</i>...HLR H358
4a80: 31 30 20 0a 57 68 65 6e 20 72 65 71 75 69 72 65  10 .When require
4a90: 64 20 74 6f 20 3c 69 3e 63 6f 6d 6d 69 74 20 61  d to <i>commit a
4aa0: 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69   write-transacti
4ab0: 6f 6e 3c 2f 69 3e 2c 20 61 66 74 65 72 20 69 6e  on</i>, after in
4ac0: 63 72 65 6d 65 6e 74 69 6e 67 0a 74 68 65 20 3c  crementing.the <
4ad0: 69 3e 63 68 61 6e 67 65 20 63 6f 75 6e 74 65 72  i>change counter
4ae0: 3c 2f 69 3e 20 66 69 65 6c 64 2c 20 53 51 4c 69  </i> field, SQLi
4af0: 74 65 20 73 68 61 6c 6c 20 3c 69 3e 73 79 6e 63  te shall <i>sync
4b00: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 0a 66 69 6c   the journal.fil
4b10: 65 3c 2f 69 3e 2e 0a 0a 48 4c 52 20 48 33 35 38  e</i>...HLR H358
4b20: 32 30 20 0a 57 68 65 6e 20 72 65 71 75 69 72 65  20 .When require
4b30: 64 20 74 6f 20 3c 69 3e 63 6f 6d 6d 69 74 20 61  d to <i>commit a
4b40: 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69   write-transacti
4b50: 6f 6e 3c 2f 69 3e 2c 20 61 66 74 65 72 20 3c 69  on</i>, after <i
4b60: 3e 73 79 6e 63 69 6e 67 0a 74 68 65 20 6a 6f 75  >syncing.the jou
4b70: 72 6e 61 6c 20 66 69 6c 65 3c 2f 69 3e 20 61 73  rnal file</i> as
4b80: 20 72 65 71 75 69 72 65 64 20 62 79 20 48 33 35   required by H35
4b90: 38 31 30 2c 20 69 66 20 61 6e 20 3c 69 3e 65 78  810, if an <i>ex
4ba0: 63 6c 75 73 69 76 65 20 6c 6f 63 6b 3c 2f 69 3e  clusive lock</i>
4bb0: 0a 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65  .on the database
4bc0: 20 66 69 6c 65 20 69 73 20 6e 6f 74 20 61 6c 72   file is not alr
4bd0: 65 61 64 79 20 68 65 6c 64 2c 20 53 51 4c 69 74  eady held, SQLit
4be0: 65 20 73 68 61 6c 6c 20 61 74 74 65 6d 70 74 20  e shall attempt 
4bf0: 74 6f 0a 3c 69 3e 75 70 67 72 61 64 65 20 74 6f  to.<i>upgrade to
4c00: 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 6c 6f   an exclusive lo
4c10: 63 6b 3c 2f 69 3e 2e 0a 0a 48 4c 52 20 48 33 35  ck</i>...HLR H35
4c20: 38 33 30 20 0a 57 68 65 6e 20 72 65 71 75 69 72  830 .When requir
4c30: 65 64 20 74 6f 20 3c 69 3e 63 6f 6d 6d 69 74 20  ed to <i>commit 
4c40: 61 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74  a write-transact
4c50: 69 6f 6e 3c 2f 69 3e 2c 20 61 66 74 65 72 20 3c  ion</i>, after <
4c60: 69 3e 73 79 6e 63 69 6e 67 0a 74 68 65 20 6a 6f  i>syncing.the jo
4c70: 75 72 6e 61 6c 20 66 69 6c 65 3c 2f 69 3e 20 61  urnal file</i> a
4c80: 73 20 72 65 71 75 69 72 65 64 20 62 79 20 48 33  s required by H3
4c90: 35 38 31 30 20 61 6e 64 20 65 6e 73 75 72 69 6e  5810 and ensurin
4ca0: 67 20 74 68 61 74 20 61 6e 0a 3c 69 3e 65 78 63  g that an.<i>exc
4cb0: 6c 75 73 69 76 65 20 6c 6f 63 6b 3c 2f 69 3e 20  lusive lock</i> 
4cc0: 69 73 20 68 65 6c 64 20 6f 6e 20 74 68 65 20 64  is held on the d
4cd0: 61 74 61 62 61 73 65 20 66 69 6c 65 20 61 73 20  atabase file as 
4ce0: 72 65 71 75 69 72 65 64 20 62 79 0a 48 33 35 38  required by.H358
4cf0: 33 30 2c 20 53 51 4c 69 74 65 20 73 68 61 6c 6c  30, SQLite shall
4d00: 20 63 6f 70 79 20 74 68 65 20 63 6f 6e 74 65 6e   copy the conten
4d10: 74 73 20 6f 66 20 61 6c 6c 20 3c 69 3e 64 69 72  ts of all <i>dir
4d20: 74 79 20 70 61 67 65 3c 2f 69 3e 0a 73 74 6f 72  ty page</i>.stor
4d30: 65 64 20 69 6e 20 74 68 65 20 3c 69 3e 70 61 67  ed in the <i>pag
4d40: 65 20 63 61 63 68 65 3c 2f 69 3e 20 69 6e 74 6f  e cache</i> into
4d50: 20 74 68 65 20 3c 69 3e 64 61 74 61 62 61 73 65   the <i>database
4d60: 20 66 69 6c 65 3c 2f 69 3e 20 75 73 69 6e 67 0a   file</i> using.
4d70: 63 61 6c 6c 73 20 74 6f 20 74 68 65 20 78 57 72  calls to the xWr
4d80: 69 74 65 20 6d 65 74 68 6f 64 20 6f 66 20 74 68  ite method of th
4d90: 65 20 3c 69 3e 64 61 74 61 62 61 73 65 20 63 6f  e <i>database co
4da0: 6e 6e 65 63 74 69 6f 6e 3c 2f 69 3e 20 66 69 6c  nnection</i> fil
4db0: 65 0a 68 61 6e 64 6c 65 2e 20 45 61 63 68 20 63  e.handle. Each c
4dc0: 61 6c 6c 20 74 6f 20 78 57 72 69 74 65 20 73 68  all to xWrite sh
4dd0: 61 6c 6c 20 77 72 69 74 65 20 74 68 65 20 63 6f  all write the co
4de0: 6e 74 65 6e 74 73 20 6f 66 20 61 20 73 69 6e 67  ntents of a sing
4df0: 6c 65 0a 3c 69 3e 64 69 72 74 79 20 70 61 67 65  le.<i>dirty page
4e00: 3c 2f 69 3e 20 28 3c 69 3e 70 61 67 65 2d 73 69  </i> (<i>page-si
4e10: 7a 65 3c 2f 69 3e 20 62 79 74 65 73 20 6f 66 20  ze</i> bytes of 
4e20: 64 61 74 61 29 20 74 6f 20 74 68 65 20 64 61 74  data) to the dat
4e30: 61 62 61 73 65 0a 66 69 6c 65 2e 20 44 69 72 74  abase.file. Dirt
4e40: 79 20 70 61 67 65 73 20 73 68 61 6c 6c 20 62 65  y pages shall be
4e50: 20 77 72 69 74 74 65 6e 20 69 6e 20 6f 72 64 65   written in orde
4e60: 72 20 6f 66 20 3c 69 3e 70 61 67 65 20 6e 75 6d  r of <i>page num
4e70: 62 65 72 3c 2f 69 3e 2c 0a 66 72 6f 6d 20 6c 6f  ber</i>,.from lo
4e80: 77 65 73 74 20 74 6f 20 68 69 67 68 65 73 74 2e  west to highest.
4e90: 0a 0a 48 4c 52 20 48 33 35 38 34 30 20 0a 57 68  ..HLR H35840 .Wh
4ea0: 65 6e 20 72 65 71 75 69 72 65 64 20 74 6f 20 3c  en required to <
4eb0: 69 3e 63 6f 6d 6d 69 74 20 61 20 77 72 69 74 65  i>commit a write
4ec0: 2d 74 72 61 6e 73 61 63 74 69 6f 6e 3c 2f 69 3e  -transaction</i>
4ed0: 2c 20 61 66 74 65 72 20 63 6f 70 79 69 6e 67 20  , after copying 
4ee0: 74 68 65 0a 63 6f 6e 74 65 6e 74 73 20 6f 66 20  the.contents of 
4ef0: 61 6e 79 20 3c 69 3e 64 69 72 74 79 20 70 61 67  any <i>dirty pag
4f00: 65 73 3c 2f 69 3e 20 74 6f 20 74 68 65 20 64 61  es</i> to the da
4f10: 74 61 62 61 73 65 20 66 69 6c 65 20 61 73 20 72  tabase file as r
4f20: 65 71 75 69 72 65 64 0a 62 79 20 48 33 35 38 33  equired.by H3583
4f30: 30 2c 20 53 51 4c 69 74 65 20 73 68 61 6c 6c 20  0, SQLite shall 
4f40: 73 79 6e 63 20 74 68 65 20 64 61 74 61 62 61 73  sync the databas
4f50: 65 20 66 69 6c 65 20 62 79 20 69 6e 76 6f 6b 69  e file by invoki
4f60: 6e 67 20 74 68 65 20 78 53 79 6e 63 0a 6d 65 74  ng the xSync.met
4f70: 68 6f 64 20 6f 66 20 74 68 65 20 3c 69 3e 64 61  hod of the <i>da
4f80: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f  tabase connectio
4f90: 6e 3c 2f 69 3e 20 66 69 6c 65 20 68 61 6e 64 6c  n</i> file handl
4fa0: 65 2e 0a 0a 48 4c 52 20 48 33 35 38 35 30 20 0a  e...HLR H35850 .
4fb0: 57 68 65 6e 20 72 65 71 75 69 72 65 64 20 74 6f  When required to
4fc0: 20 3c 69 3e 63 6f 6d 6d 69 74 20 61 20 77 72 69   <i>commit a wri
4fd0: 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 3c 2f  te-transaction</
4fe0: 69 3e 2c 20 61 66 74 65 72 20 73 79 6e 63 69 6e  i>, after syncin
4ff0: 67 0a 74 68 65 20 64 61 74 61 62 61 73 65 20 66  g.the database f
5000: 69 6c 65 20 61 73 20 72 65 71 75 69 72 65 64 20  ile as required 
5010: 62 79 20 48 33 35 38 34 30 2c 20 53 51 4c 69 74  by H35840, SQLit
5020: 65 20 73 68 61 6c 6c 20 63 6c 6f 73 65 20 74 68  e shall close th
5030: 65 0a 66 69 6c 65 2d 68 61 6e 64 6c 65 20 6f 70  e.file-handle op
5040: 65 6e 65 64 20 6f 6e 20 74 68 65 20 3c 69 3e 6a  ened on the <i>j
5050: 6f 75 72 6e 61 6c 20 66 69 6c 65 3c 2f 69 3e 20  ournal file</i> 
5060: 61 6e 64 20 64 65 6c 65 74 65 20 74 68 65 0a 3c  and delete the.<
5070: 69 3e 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 3c 2f  i>journal file</
5080: 69 3e 20 66 72 6f 6d 20 74 68 65 20 66 69 6c 65  i> from the file
5090: 20 73 79 73 74 65 6d 20 76 69 61 20 61 20 63 61   system via a ca
50a0: 6c 6c 20 74 6f 20 74 68 65 20 56 46 53 0a 78 44  ll to the VFS.xD
50b0: 65 6c 65 74 65 20 6d 65 74 68 6f 64 2e 0a 0a 48  elete method...H
50c0: 4c 52 20 48 33 35 38 36 30 20 0a 57 68 65 6e 20  LR H35860 .When 
50d0: 72 65 71 75 69 72 65 64 20 74 6f 20 3c 69 3e 63  required to <i>c
50e0: 6f 6d 6d 69 74 20 61 20 77 72 69 74 65 2d 74 72  ommit a write-tr
50f0: 61 6e 73 61 63 74 69 6f 6e 3c 2f 69 3e 2c 20 61  ansaction</i>, a
5100: 66 74 65 72 20 64 65 6c 65 74 69 6e 67 0a 74 68  fter deleting.th
5110: 65 20 3c 69 3e 6a 6f 75 72 6e 61 6c 20 66 69 6c  e <i>journal fil
5120: 65 3c 2f 69 3e 20 61 73 20 72 65 71 75 69 72 65  e</i> as require
5130: 64 20 62 79 20 48 33 35 38 35 30 2c 20 53 51 4c  d by H35850, SQL
5140: 69 74 65 20 73 68 61 6c 6c 20 72 65 6c 69 6e 71  ite shall relinq
5150: 75 69 73 68 0a 61 6c 6c 20 6c 6f 63 6b 73 20 68  uish.all locks h
5160: 65 6c 64 20 6f 6e 20 74 68 65 20 3c 69 3e 64 61  eld on the <i>da
5170: 74 61 62 61 73 65 20 66 69 6c 65 3c 2f 69 3e 20  tabase file</i> 
5180: 62 79 20 69 6e 76 6f 6b 69 6e 67 20 74 68 65 20  by invoking the 
5190: 78 55 6e 6c 6f 63 6b 0a 6d 65 74 68 6f 64 20 6f  xUnlock.method o
51a0: 66 20 74 68 65 20 3c 69 3e 64 61 74 61 62 61 73  f the <i>databas
51b0: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 3c 2f 69 3e  e connection</i>
51c0: 20 66 69 6c 65 20 68 61 6e 64 6c 65 2e 0a 0a      file handle...