/ Hex Artifact Content
Login

Artifact f31e52e891c5fef6709b9fcef54ce660648a34172423a9cbdf4cbce3ba0049f4:


0000: 2f 2a 0a 2a 2a 20 32 30 30 37 20 53 65 70 74 65  /*.** 2007 Septe
0010: 6d 62 65 72 20 31 34 0a 2a 2a 0a 2a 2a 20 54 68  mber 14.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69  e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20  ms copyright to 
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65  this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a  .  In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65  * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73  , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d  sing:.**.**    M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61  ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20  nd not evil..** 
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20     May you find 
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20  forgiveness for 
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72  yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20  give others..** 
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65     May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74   freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20  aking more than 
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a  you give..**.***
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0170: 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 4f 56 45  ******.**.** OVE
0180: 52 56 49 45 57 3a 0a 2a 2a 0a 2a 2a 20 20 20 54  RVIEW:.**.**   T
0190: 68 69 73 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e  his file contain
01a0: 73 20 73 6f 6d 65 20 65 78 61 6d 70 6c 65 20 63  s some example c
01b0: 6f 64 65 20 64 65 6d 6f 6e 73 74 72 61 74 69 6e  ode demonstratin
01c0: 67 20 68 6f 77 20 74 68 65 20 53 51 4c 69 74 65  g how the SQLite
01d0: 20 0a 2a 2a 20 20 20 76 66 73 20 66 65 61 74 75   .**   vfs featu
01e0: 72 65 20 63 61 6e 20 62 65 20 75 73 65 64 20 74  re can be used t
01f0: 6f 20 68 61 76 65 20 53 51 4c 69 74 65 20 6f 70  o have SQLite op
0200: 65 72 61 74 65 20 64 69 72 65 63 74 6c 79 20 6f  erate directly o
0210: 6e 20 61 6e 20 0a 2a 2a 20 20 20 65 6d 62 65 64  n an .**   embed
0220: 64 65 64 20 6d 65 64 69 61 2c 20 77 69 74 68 6f  ded media, witho
0230: 75 74 20 75 73 69 6e 67 20 61 6e 20 69 6e 74 65  ut using an inte
0240: 72 6d 65 64 69 61 74 65 20 66 69 6c 65 20 73 79  rmediate file sy
0250: 73 74 65 6d 2e 0a 2a 2a 0a 2a 2a 20 20 20 42 65  stem..**.**   Be
0260: 63 61 75 73 65 20 74 68 69 73 20 69 73 20 6f 6e  cause this is on
0270: 6c 79 20 61 20 64 65 6d 6f 20 64 65 73 69 67 6e  ly a demo design
0280: 65 64 20 74 6f 20 72 75 6e 20 6f 6e 20 61 20 77  ed to run on a w
0290: 6f 72 6b 73 74 61 74 69 6f 6e 2c 20 74 68 65 0a  orkstation, the.
02a0: 2a 2a 20 20 20 75 6e 64 65 72 6c 79 69 6e 67 20  **   underlying 
02b0: 6d 65 64 69 61 20 69 73 20 73 69 6d 75 6c 61 74  media is simulat
02c0: 65 64 20 75 73 69 6e 67 20 61 20 72 65 67 75 6c  ed using a regul
02d0: 61 72 20 66 69 6c 65 2d 73 79 73 74 65 6d 20 66  ar file-system f
02e0: 69 6c 65 2e 20 54 68 65 0a 2a 2a 20 20 20 73 69  ile. The.**   si
02f0: 7a 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 69  ze of the file i
0300: 73 20 66 69 78 65 64 20 77 68 65 6e 20 69 74 20  s fixed when it 
0310: 69 73 20 66 69 72 73 74 20 63 72 65 61 74 65 64  is first created
0320: 20 28 64 65 66 61 75 6c 74 20 73 69 7a 65 20 31   (default size 1
0330: 30 20 4d 42 29 2e 0a 2a 2a 20 20 20 46 72 6f 6d  0 MB)..**   From
0340: 20 53 51 4c 69 74 65 27 73 20 70 6f 69 6e 74 20   SQLite's point 
0350: 6f 66 20 76 69 65 77 2c 20 74 68 69 73 20 73 70  of view, this sp
0360: 61 63 65 20 69 73 20 75 73 65 64 20 74 6f 20 73  ace is used to s
0370: 74 6f 72 65 20 61 20 73 69 6e 67 6c 65 0a 2a 2a  tore a single.**
0380: 20 20 20 64 61 74 61 62 61 73 65 20 66 69 6c 65     database file
0390: 20 61 6e 64 20 74 68 65 20 6a 6f 75 72 6e 61 6c   and the journal
03a0: 20 66 69 6c 65 2e 20 0a 2a 2a 0a 2a 2a 20 20 20   file. .**.**   
03b0: 41 6e 79 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f  Any statement jo
03c0: 75 72 6e 61 6c 20 63 72 65 61 74 65 64 20 69 73  urnal created is
03d0: 20 73 74 6f 72 65 64 20 69 6e 20 76 6f 6c 61 74   stored in volat
03e0: 69 6c 65 20 6d 65 6d 6f 72 79 20 6f 62 74 61 69  ile memory obtai
03f0: 6e 65 64 20 0a 2a 2a 20 20 20 66 72 6f 6d 20 73  ned .**   from s
0400: 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 29 2e  qlite3_malloc().
0410: 20 41 6e 79 20 61 74 74 65 6d 70 74 20 74 6f 20   Any attempt to 
0420: 63 72 65 61 74 65 20 61 20 74 65 6d 70 6f 72 61  create a tempora
0430: 72 79 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  ry database file
0440: 20 0a 2a 2a 20 20 20 77 69 6c 6c 20 66 61 69 6c   .**   will fail
0450: 20 28 53 51 4c 49 54 45 5f 49 4f 45 52 52 29 2e   (SQLITE_IOERR).
0460: 20 54 6f 20 70 72 65 76 65 6e 74 20 53 51 4c 69   To prevent SQLi
0470: 74 65 20 66 72 6f 6d 20 61 74 74 65 6d 70 74 69  te from attempti
0480: 6e 67 20 74 68 69 73 2c 0a 2a 2a 20 20 20 69 74  ng this,.**   it
0490: 20 73 68 6f 75 6c 64 20 62 65 20 63 6f 6e 66 69   should be confi
04a0: 67 75 72 65 64 20 74 6f 20 73 74 6f 72 65 20 61  gured to store a
04b0: 6c 6c 20 74 65 6d 70 6f 72 61 72 79 20 64 61 74  ll temporary dat
04c0: 61 62 61 73 65 20 66 69 6c 65 73 20 69 6e 20 0a  abase files in .
04d0: 2a 2a 20 20 20 6d 61 69 6e 20 6d 65 6d 6f 72 79  **   main memory
04e0: 20 28 73 65 65 20 70 72 61 67 6d 61 20 22 74 65   (see pragma "te
04f0: 6d 70 5f 73 74 6f 72 65 22 20 6f 72 20 74 68 65  mp_store" or the
0500: 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f   SQLITE_TEMP_STO
0510: 52 45 20 63 6f 6d 70 69 6c 65 20 0a 2a 2a 20 20  RE compile .**  
0520: 20 74 69 6d 65 20 6f 70 74 69 6f 6e 29 2e 0a 2a   time option)..*
0530: 2a 0a 2a 2a 20 41 53 53 55 4d 50 54 49 4f 4e 53  *.** ASSUMPTIONS
0540: 3a 0a 2a 2a 0a 2a 2a 20 20 20 41 66 74 65 72 20  :.**.**   After 
0550: 69 74 20 68 61 73 20 62 65 65 6e 20 63 72 65 61  it has been crea
0560: 74 65 64 2c 20 74 68 65 20 62 6c 6f 62 20 66 69  ted, the blob fi
0570: 6c 65 20 69 73 20 61 63 63 65 73 73 65 64 20 75  le is accessed u
0580: 73 69 6e 67 20 74 68 65 0a 2a 2a 20 20 20 66 6f  sing the.**   fo
0590: 6c 6c 6f 77 69 6e 67 20 74 68 72 65 65 20 66 75  llowing three fu
05a0: 6e 63 74 69 6f 6e 73 20 6f 6e 6c 79 3a 0a 2a 2a  nctions only:.**
05b0: 0a 2a 2a 20 20 20 20 20 20 20 6d 65 64 69 61 52  .**       mediaR
05c0: 65 61 64 28 29 3b 20 20 20 20 20 20 20 20 20 20  ead();          
05d0: 20 20 2d 20 52 65 61 64 20 61 20 35 31 32 20 62    - Read a 512 b
05e0: 79 74 65 20 62 6c 6f 63 6b 20 66 72 6f 6d 20 74  yte block from t
05f0: 68 65 20 66 69 6c 65 2e 0a 2a 2a 20 20 20 20 20  he file..**     
0600: 20 20 6d 65 64 69 61 57 72 69 74 65 28 29 3b 20    mediaWrite(); 
0610: 20 20 20 20 20 20 20 20 20 20 2d 20 57 72 69 74            - Writ
0620: 65 20 61 20 35 31 32 20 62 79 74 65 20 62 6c 6f  e a 512 byte blo
0630: 63 6b 20 74 6f 20 74 68 65 20 66 69 6c 65 2e 0a  ck to the file..
0640: 2a 2a 20 20 20 20 20 20 20 6d 65 64 69 61 53 79  **       mediaSy
0650: 6e 63 28 29 3b 20 20 20 20 20 20 20 20 20 20 20  nc();           
0660: 20 2d 20 54 65 6c 6c 20 74 68 65 20 6d 65 64 69   - Tell the medi
0670: 61 20 68 61 72 64 77 61 72 65 20 74 6f 20 73 79  a hardware to sy
0680: 6e 63 2e 0a 2a 2a 0a 2a 2a 20 20 20 49 74 20 69  nc..**.**   It i
0690: 73 20 61 73 73 75 6d 65 64 20 74 68 61 74 20 74  s assumed that t
06a0: 68 65 73 65 20 63 61 6e 20 62 65 20 65 61 73 69  hese can be easi
06b0: 6c 79 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62  ly implemented b
06c0: 79 20 61 6e 79 20 22 72 65 61 6c 22 0a 2a 2a 20  y any "real".** 
06d0: 20 20 6d 65 64 69 61 20 76 66 73 20 64 72 69 76    media vfs driv
06e0: 65 72 20 61 64 61 70 74 69 6e 67 20 74 68 69 73  er adapting this
06f0: 20 63 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 46 49 4c   code..**.** FIL
0700: 45 20 46 4f 52 4d 41 54 3a 0a 2a 2a 0a 2a 2a 20  E FORMAT:.**.** 
0710: 20 20 54 68 65 20 62 61 73 69 63 20 70 72 69 6e    The basic prin
0720: 63 69 70 6c 65 20 69 73 20 74 68 61 74 20 74 68  ciple is that th
0730: 65 20 22 64 61 74 61 62 61 73 65 20 66 69 6c 65  e "database file
0740: 22 20 69 73 20 73 74 6f 72 65 64 20 61 74 20 74  " is stored at t
0750: 68 65 0a 2a 2a 20 20 20 62 65 67 69 6e 6e 69 6e  he.**   beginnin
0760: 67 20 6f 66 20 74 68 65 20 31 30 20 4d 42 20 62  g of the 10 MB b
0770: 6c 6f 62 20 61 6e 64 20 67 72 6f 77 73 20 69 6e  lob and grows in
0780: 20 61 20 66 6f 72 77 61 72 64 20 64 69 72 65 63   a forward direc
0790: 74 69 6f 6e 2e 20 54 68 65 20 0a 2a 2a 20 20 20  tion. The .**   
07a0: 22 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 22 20 69  "journal file" i
07b0: 73 20 73 74 6f 72 65 64 20 61 74 20 74 68 65 20  s stored at the 
07c0: 65 6e 64 20 6f 66 20 74 68 65 20 31 30 4d 42 20  end of the 10MB 
07d0: 62 6c 6f 62 20 61 6e 64 20 67 72 6f 77 73 0a 2a  blob and grows.*
07e0: 2a 20 20 20 69 6e 20 74 68 65 20 72 65 76 65 72  *   in the rever
07f0: 73 65 20 64 69 72 65 63 74 69 6f 6e 2e 20 49 66  se direction. If
0800: 2c 20 64 75 72 69 6e 67 20 61 20 74 72 61 6e 73  , during a trans
0810: 61 63 74 69 6f 6e 2c 20 69 6e 73 75 66 66 69 63  action, insuffic
0820: 69 65 6e 74 0a 2a 2a 20 20 20 73 70 61 63 65 20  ient.**   space 
0830: 69 73 20 61 76 61 69 6c 61 62 6c 65 20 74 6f 20  is available to 
0840: 65 78 70 61 6e 64 20 65 69 74 68 65 72 20 74 68  expand either th
0850: 65 20 6a 6f 75 72 6e 61 6c 20 6f 72 20 64 61 74  e journal or dat
0860: 61 62 61 73 65 20 66 69 6c 65 2c 0a 2a 2a 20 20  abase file,.**  
0870: 20 61 6e 20 53 51 4c 49 54 45 5f 46 55 4c 4c 20   an SQLITE_FULL 
0880: 65 72 72 6f 72 20 69 73 20 72 65 74 75 72 6e 65  error is returne
0890: 64 2e 20 54 68 65 20 64 61 74 61 62 61 73 65 20  d. The database 
08a0: 66 69 6c 65 20 69 73 20 6e 65 76 65 72 20 61 6c  file is never al
08b0: 6c 6f 77 65 64 0a 2a 2a 20 20 20 74 6f 20 63 6f  lowed.**   to co
08c0: 6e 73 75 6d 65 20 6d 6f 72 65 20 74 68 61 6e 20  nsume more than 
08d0: 39 30 25 20 6f 66 20 74 68 65 20 62 6c 6f 62 20  90% of the blob 
08e0: 73 70 61 63 65 2e 20 49 66 20 53 51 4c 69 74 65  space. If SQLite
08f0: 20 74 72 69 65 73 20 74 6f 0a 2a 2a 20 20 20 63   tries to.**   c
0900: 72 65 61 74 65 20 61 20 66 69 6c 65 20 6c 61 72  reate a file lar
0910: 67 65 72 20 74 68 61 6e 20 74 68 69 73 2c 20 53  ger than this, S
0920: 51 4c 49 54 45 5f 46 55 4c 4c 20 69 73 20 72 65  QLITE_FULL is re
0930: 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 20 20  turned..**.**   
0940: 4e 6f 20 61 6c 6c 6f 77 61 6e 63 65 20 69 73 20  No allowance is 
0950: 6d 61 64 65 20 66 6f 72 20 22 77 65 61 72 2d 6c  made for "wear-l
0960: 65 76 65 6c 69 6e 67 22 2c 20 61 73 20 69 73 20  eveling", as is 
0970: 72 65 71 75 69 72 65 64 20 62 79 2e 0a 2a 2a 20  required by..** 
0980: 20 20 65 6d 62 65 64 64 65 64 20 64 65 76 69 63    embedded devic
0990: 65 73 20 69 6e 20 74 68 65 20 61 62 73 65 6e 63  es in the absenc
09a0: 65 20 6f 66 20 65 71 75 69 76 61 6c 65 6e 74 20  e of equivalent 
09b0: 68 61 72 64 77 61 72 65 20 66 65 61 74 75 72 65  hardware feature
09c0: 73 2e 0a 2a 2a 0a 2a 2a 20 20 20 54 68 65 20 66  s..**.**   The f
09d0: 69 72 73 74 20 35 31 32 20 62 6c 6f 63 6b 20 62  irst 512 block b
09e0: 79 74 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20  yte of the file 
09f0: 69 73 20 72 65 73 65 72 76 65 64 20 66 6f 72 20  is reserved for 
0a00: 73 74 6f 72 69 6e 67 20 74 68 65 0a 2a 2a 20 20  storing the.**  
0a10: 20 73 69 7a 65 20 6f 66 20 74 68 65 20 22 64 61   size of the "da
0a20: 74 61 62 61 73 65 20 66 69 6c 65 22 2e 20 49 74  tabase file". It
0a30: 20 69 73 20 75 70 64 61 74 65 64 20 61 73 20 70   is updated as p
0a40: 61 72 74 20 6f 66 20 74 68 65 20 73 79 6e 63 28  art of the sync(
0a50: 29 0a 2a 2a 20 20 20 6f 70 65 72 61 74 69 6f 6e  ).**   operation
0a60: 2e 20 4f 6e 20 73 74 61 72 74 75 70 2c 20 69 74  . On startup, it
0a70: 20 63 61 6e 20 6f 6e 6c 79 20 62 65 20 74 72 75   can only be tru
0a80: 73 74 65 64 20 69 66 20 6e 6f 20 6a 6f 75 72 6e  sted if no journ
0a90: 61 6c 20 66 69 6c 65 0a 2a 2a 20 20 20 65 78 69  al file.**   exi
0aa0: 73 74 73 2e 20 49 66 20 61 20 6a 6f 75 72 6e 61  sts. If a journa
0ab0: 6c 2d 66 69 6c 65 20 64 6f 65 73 20 65 78 69 73  l-file does exis
0ac0: 74 2c 20 74 68 65 6e 20 69 74 20 73 74 6f 72 65  t, then it store
0ad0: 73 20 74 68 65 20 72 65 61 6c 20 73 69 7a 65 0a  s the real size.
0ae0: 2a 2a 20 20 20 6f 66 20 74 68 65 20 64 61 74 61  **   of the data
0af0: 62 61 73 65 20 72 65 67 69 6f 6e 2e 20 54 68 65  base region. The
0b00: 20 73 65 63 6f 6e 64 20 61 6e 64 20 73 75 62 73   second and subs
0b10: 65 71 75 65 6e 74 20 62 6c 6f 63 6b 73 20 73 74  equent blocks st
0b20: 6f 72 65 20 74 68 65 20 0a 2a 2a 20 20 20 61 63  ore the .**   ac
0b30: 74 75 61 6c 20 64 61 74 61 62 61 73 65 20 63 6f  tual database co
0b40: 6e 74 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 20 20 54  ntent..**.**   T
0b50: 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 22  he size of the "
0b60: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 22 20 69 73  journal file" is
0b70: 20 6e 6f 74 20 73 74 6f 72 65 64 20 70 65 72 73   not stored pers
0b80: 69 73 74 65 6e 74 6c 79 20 69 6e 20 74 68 65 20  istently in the 
0b90: 0a 2a 2a 20 20 20 66 69 6c 65 2e 20 57 68 65 6e  .**   file. When
0ba0: 20 74 68 65 20 73 79 73 74 65 6d 20 69 73 20 72   the system is r
0bb0: 75 6e 6e 69 6e 67 2c 20 74 68 65 20 73 69 7a 65  unning, the size
0bc0: 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20   of the journal 
0bd0: 66 69 6c 65 20 69 73 0a 2a 2a 20 20 20 73 74 6f  file is.**   sto
0be0: 72 65 64 20 69 6e 20 76 6f 6c 61 74 69 6c 65 20  red in volatile 
0bf0: 6d 65 6d 6f 72 79 2e 20 57 68 65 6e 20 72 65 63  memory. When rec
0c00: 6f 76 65 72 69 6e 67 20 66 72 6f 6d 20 61 20 63  overing from a c
0c10: 72 61 73 68 2c 20 74 68 69 73 20 76 66 73 0a 2a  rash, this vfs.*
0c20: 2a 20 20 20 72 65 70 6f 72 74 73 20 61 20 76 65  *   reports a ve
0c30: 72 79 20 6c 61 72 67 65 20 73 69 7a 65 20 66 6f  ry large size fo
0c40: 72 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69  r the journal fi
0c50: 6c 65 2e 20 54 68 65 20 6e 6f 72 6d 61 6c 20 6a  le. The normal j
0c60: 6f 75 72 6e 61 6c 0a 2a 2a 20 20 20 68 65 61 64  ournal.**   head
0c70: 65 72 20 61 6e 64 20 63 68 65 63 6b 73 75 6d 20  er and checksum 
0c80: 6d 65 63 68 61 6e 69 73 6d 73 20 73 65 72 76 65  mechanisms serve
0c90: 20 74 6f 20 70 72 65 76 65 6e 74 20 53 51 4c 69   to prevent SQLi
0ca0: 74 65 20 66 72 6f 6d 20 0a 2a 2a 20 20 20 70 72  te from .**   pr
0cb0: 6f 63 65 73 73 69 6e 67 20 61 6e 79 20 64 61 74  ocessing any dat
0cc0: 61 20 74 68 61 74 20 6c 69 65 73 20 70 61 73 74  a that lies past
0cd0: 20 74 68 65 20 6c 6f 67 69 63 61 6c 20 65 6e 64   the logical end
0ce0: 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e   of the journal.
0cf0: 0a 2a 2a 0a 2a 2a 20 20 20 57 68 65 6e 20 53 51  .**.**   When SQ
0d00: 4c 69 74 65 20 63 61 6c 6c 73 20 4f 73 44 65 6c  Lite calls OsDel
0d10: 65 74 65 28 29 20 74 6f 20 64 65 6c 65 74 65 20  ete() to delete 
0d20: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  the journal file
0d30: 2c 20 74 68 65 20 66 69 6e 61 6c 0a 2a 2a 20 20  , the final.**  
0d40: 20 35 31 32 20 62 79 74 65 73 20 6f 66 20 74 68   512 bytes of th
0d50: 65 20 62 6c 6f 62 20 28 74 68 65 20 61 72 65 61  e blob (the area
0d60: 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20   containing the 
0d70: 66 69 72 73 74 20 6a 6f 75 72 6e 61 6c 20 68 65  first journal he
0d80: 61 64 65 72 29 0a 2a 2a 20 20 20 61 72 65 20 7a  ader).**   are z
0d90: 65 72 6f 65 64 2e 0a 2a 2a 0a 2a 2a 20 4c 4f 43  eroed..**.** LOC
0da0: 4b 49 4e 47 3a 0a 2a 2a 0a 2a 2a 20 20 20 46 69  KING:.**.**   Fi
0db0: 6c 65 20 6c 6f 63 6b 69 6e 67 20 69 73 20 61 20  le locking is a 
0dc0: 6e 6f 2d 6f 70 2e 20 4f 6e 6c 79 20 6f 6e 65 20  no-op. Only one 
0dd0: 63 6f 6e 6e 65 63 74 69 6f 6e 20 6d 61 79 20 62  connection may b
0de0: 65 20 6f 70 65 6e 20 61 74 20 61 6e 79 20 6f 6e  e open at any on
0df0: 65 0a 2a 2a 20 20 20 74 69 6d 65 20 75 73 69 6e  e.**   time usin
0e00: 67 20 74 68 69 73 20 64 65 6d 6f 20 76 66 73 2e  g this demo vfs.
0e10: 0a 2a 2f 0a 0a 23 69 6e 63 6c 75 64 65 20 22 73  .*/..#include "s
0e20: 71 6c 69 74 65 33 2e 68 22 0a 23 69 6e 63 6c 75  qlite3.h".#inclu
0e30: 64 65 20 3c 61 73 73 65 72 74 2e 68 3e 0a 23 69  de <assert.h>.#i
0e40: 6e 63 6c 75 64 65 20 3c 73 74 72 69 6e 67 2e 68  nclude <string.h
0e50: 3e 0a 0a 2f 2a 0a 2a 2a 20 4d 61 78 69 6d 75 6d  >../*.** Maximum
0e60: 20 70 61 74 68 6e 61 6d 65 20 6c 65 6e 67 74 68   pathname length
0e70: 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 74 68   supported by th
0e80: 65 20 66 73 20 62 61 63 6b 65 6e 64 2e 0a 2a 2f  e fs backend..*/
0e90: 0a 23 64 65 66 69 6e 65 20 42 4c 4f 43 4b 53 49  .#define BLOCKSI
0ea0: 5a 45 20 35 31 32 0a 23 64 65 66 69 6e 65 20 42  ZE 512.#define B
0eb0: 4c 4f 42 53 49 5a 45 20 31 30 34 38 35 37 36 30  LOBSIZE 10485760
0ec0: 0a 0a 2f 2a 0a 2a 2a 20 4e 61 6d 65 20 75 73 65  ../*.** Name use
0ed0: 64 20 74 6f 20 69 64 65 6e 74 69 66 79 20 74 68  d to identify th
0ee0: 69 73 20 56 46 53 2e 0a 2a 2f 0a 23 64 65 66 69  is VFS..*/.#defi
0ef0: 6e 65 20 46 53 5f 56 46 53 5f 4e 41 4d 45 20 22  ne FS_VFS_NAME "
0f00: 66 73 22 0a 0a 74 79 70 65 64 65 66 20 73 74 72  fs"..typedef str
0f10: 75 63 74 20 66 73 5f 72 65 61 6c 5f 66 69 6c 65  uct fs_real_file
0f20: 20 66 73 5f 72 65 61 6c 5f 66 69 6c 65 3b 0a 73   fs_real_file;.s
0f30: 74 72 75 63 74 20 66 73 5f 72 65 61 6c 5f 66 69  truct fs_real_fi
0f40: 6c 65 20 7b 0a 20 20 73 71 6c 69 74 65 33 5f 66  le {.  sqlite3_f
0f50: 69 6c 65 20 2a 70 46 69 6c 65 3b 0a 20 20 63 6f  ile *pFile;.  co
0f60: 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b  nst char *zName;
0f70: 0a 20 20 69 6e 74 20 6e 44 61 74 61 62 61 73 65  .  int nDatabase
0f80: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  ;              /
0f90: 2a 20 43 75 72 72 65 6e 74 20 73 69 7a 65 20 6f  * Current size o
0fa0: 66 20 64 61 74 61 62 61 73 65 20 72 65 67 69 6f  f database regio
0fb0: 6e 20 2a 2f 0a 20 20 69 6e 74 20 6e 4a 6f 75 72  n */.  int nJour
0fc0: 6e 61 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20  nal;            
0fd0: 20 20 20 2f 2a 20 43 75 72 72 65 6e 74 20 73 69     /* Current si
0fe0: 7a 65 20 6f 66 20 6a 6f 75 72 6e 61 6c 20 72 65  ze of journal re
0ff0: 67 69 6f 6e 20 2a 2f 0a 20 20 69 6e 74 20 6e 42  gion */.  int nB
1000: 6c 6f 62 3b 20 20 20 20 20 20 20 20 20 20 20 20  lob;            
1010: 20 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 73        /* Total s
1020: 69 7a 65 20 6f 66 20 61 6c 6c 6f 63 61 74 65 64  ize of allocated
1030: 20 62 6c 6f 62 20 2a 2f 0a 20 20 69 6e 74 20 6e   blob */.  int n
1040: 52 65 66 3b 20 20 20 20 20 20 20 20 20 20 20 20  Ref;            
1050: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72         /* Number
1060: 20 6f 66 20 70 6f 69 6e 74 65 72 73 20 74 6f 20   of pointers to 
1070: 74 68 69 73 20 73 74 72 75 63 74 75 72 65 20 2a  this structure *
1080: 2f 0a 20 20 66 73 5f 72 65 61 6c 5f 66 69 6c 65  /.  fs_real_file
1090: 20 2a 70 4e 65 78 74 3b 0a 20 20 66 73 5f 72 65   *pNext;.  fs_re
10a0: 61 6c 5f 66 69 6c 65 20 2a 2a 70 70 54 68 69 73  al_file **ppThis
10b0: 3b 0a 7d 3b 0a 0a 74 79 70 65 64 65 66 20 73 74  ;.};..typedef st
10c0: 72 75 63 74 20 66 73 5f 66 69 6c 65 20 66 73 5f  ruct fs_file fs_
10d0: 66 69 6c 65 3b 0a 73 74 72 75 63 74 20 66 73 5f  file;.struct fs_
10e0: 66 69 6c 65 20 7b 0a 20 20 73 71 6c 69 74 65 33  file {.  sqlite3
10f0: 5f 66 69 6c 65 20 62 61 73 65 3b 0a 20 20 69 6e  _file base;.  in
1100: 74 20 65 54 79 70 65 3b 0a 20 20 66 73 5f 72 65  t eType;.  fs_re
1110: 61 6c 5f 66 69 6c 65 20 2a 70 52 65 61 6c 3b 0a  al_file *pReal;.
1120: 7d 3b 0a 0a 74 79 70 65 64 65 66 20 73 74 72 75  };..typedef stru
1130: 63 74 20 74 6d 70 5f 66 69 6c 65 20 74 6d 70 5f  ct tmp_file tmp_
1140: 66 69 6c 65 3b 0a 73 74 72 75 63 74 20 74 6d 70  file;.struct tmp
1150: 5f 66 69 6c 65 20 7b 0a 20 20 73 71 6c 69 74 65  _file {.  sqlite
1160: 33 5f 66 69 6c 65 20 62 61 73 65 3b 0a 20 20 69  3_file base;.  i
1170: 6e 74 20 6e 53 69 7a 65 3b 0a 20 20 69 6e 74 20  nt nSize;.  int 
1180: 6e 41 6c 6c 6f 63 3b 0a 20 20 63 68 61 72 20 2a  nAlloc;.  char *
1190: 7a 41 6c 6c 6f 63 3b 0a 7d 3b 0a 0a 2f 2a 20 56  zAlloc;.};../* V
11a0: 61 6c 75 65 73 20 66 6f 72 20 66 73 5f 66 69 6c  alues for fs_fil
11b0: 65 2e 65 54 79 70 65 2e 20 2a 2f 0a 23 64 65 66  e.eType. */.#def
11c0: 69 6e 65 20 44 41 54 41 42 41 53 45 5f 46 49 4c  ine DATABASE_FIL
11d0: 45 20 20 20 31 0a 23 64 65 66 69 6e 65 20 4a 4f  E   1.#define JO
11e0: 55 52 4e 41 4c 5f 46 49 4c 45 20 20 20 20 32 0a  URNAL_FILE    2.
11f0: 0a 2f 2a 0a 2a 2a 20 4d 65 74 68 6f 64 20 64 65  ./*.** Method de
1200: 63 6c 61 72 61 74 69 6f 6e 73 20 66 6f 72 20 66  clarations for f
1210: 73 5f 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69  s_file..*/.stati
1220: 63 20 69 6e 74 20 66 73 43 6c 6f 73 65 28 73 71  c int fsClose(sq
1230: 6c 69 74 65 33 5f 66 69 6c 65 2a 29 3b 0a 73 74  lite3_file*);.st
1240: 61 74 69 63 20 69 6e 74 20 66 73 52 65 61 64 28  atic int fsRead(
1250: 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a 2c 20 76  sqlite3_file*, v
1260: 6f 69 64 2a 2c 20 69 6e 74 20 69 41 6d 74 2c 20  oid*, int iAmt, 
1270: 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 69 4f  sqlite3_int64 iO
1280: 66 73 74 29 3b 0a 73 74 61 74 69 63 20 69 6e 74  fst);.static int
1290: 20 66 73 57 72 69 74 65 28 73 71 6c 69 74 65 33   fsWrite(sqlite3
12a0: 5f 66 69 6c 65 2a 2c 20 63 6f 6e 73 74 20 76 6f  _file*, const vo
12b0: 69 64 2a 2c 20 69 6e 74 20 69 41 6d 74 2c 20 73  id*, int iAmt, s
12c0: 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 69 4f 66  qlite3_int64 iOf
12d0: 73 74 29 3b 0a 73 74 61 74 69 63 20 69 6e 74 20  st);.static int 
12e0: 66 73 54 72 75 6e 63 61 74 65 28 73 71 6c 69 74  fsTruncate(sqlit
12f0: 65 33 5f 66 69 6c 65 2a 2c 20 73 71 6c 69 74 65  e3_file*, sqlite
1300: 33 5f 69 6e 74 36 34 20 73 69 7a 65 29 3b 0a 73  3_int64 size);.s
1310: 74 61 74 69 63 20 69 6e 74 20 66 73 53 79 6e 63  tatic int fsSync
1320: 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a 2c 20  (sqlite3_file*, 
1330: 69 6e 74 20 66 6c 61 67 73 29 3b 0a 73 74 61 74  int flags);.stat
1340: 69 63 20 69 6e 74 20 66 73 46 69 6c 65 53 69 7a  ic int fsFileSiz
1350: 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a 2c  e(sqlite3_file*,
1360: 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 2a   sqlite3_int64 *
1370: 70 53 69 7a 65 29 3b 0a 73 74 61 74 69 63 20 69  pSize);.static i
1380: 6e 74 20 66 73 4c 6f 63 6b 28 73 71 6c 69 74 65  nt fsLock(sqlite
1390: 33 5f 66 69 6c 65 2a 2c 20 69 6e 74 29 3b 0a 73  3_file*, int);.s
13a0: 74 61 74 69 63 20 69 6e 74 20 66 73 55 6e 6c 6f  tatic int fsUnlo
13b0: 63 6b 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a  ck(sqlite3_file*
13c0: 2c 20 69 6e 74 29 3b 0a 73 74 61 74 69 63 20 69  , int);.static i
13d0: 6e 74 20 66 73 43 68 65 63 6b 52 65 73 65 72 76  nt fsCheckReserv
13e0: 65 64 4c 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66  edLock(sqlite3_f
13f0: 69 6c 65 2a 2c 20 69 6e 74 20 2a 70 52 65 73 4f  ile*, int *pResO
1400: 75 74 29 3b 0a 73 74 61 74 69 63 20 69 6e 74 20  ut);.static int 
1410: 66 73 46 69 6c 65 43 6f 6e 74 72 6f 6c 28 73 71  fsFileControl(sq
1420: 6c 69 74 65 33 5f 66 69 6c 65 2a 2c 20 69 6e 74  lite3_file*, int
1430: 20 6f 70 2c 20 76 6f 69 64 20 2a 70 41 72 67 29   op, void *pArg)
1440: 3b 0a 73 74 61 74 69 63 20 69 6e 74 20 66 73 53  ;.static int fsS
1450: 65 63 74 6f 72 53 69 7a 65 28 73 71 6c 69 74 65  ectorSize(sqlite
1460: 33 5f 66 69 6c 65 2a 29 3b 0a 73 74 61 74 69 63  3_file*);.static
1470: 20 69 6e 74 20 66 73 44 65 76 69 63 65 43 68 61   int fsDeviceCha
1480: 72 61 63 74 65 72 69 73 74 69 63 73 28 73 71 6c  racteristics(sql
1490: 69 74 65 33 5f 66 69 6c 65 2a 29 3b 0a 0a 2f 2a  ite3_file*);../*
14a0: 0a 2a 2a 20 4d 65 74 68 6f 64 20 64 65 63 6c 61  .** Method decla
14b0: 72 61 74 69 6f 6e 73 20 66 6f 72 20 74 6d 70 5f  rations for tmp_
14c0: 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  file..*/.static 
14d0: 69 6e 74 20 74 6d 70 43 6c 6f 73 65 28 73 71 6c  int tmpClose(sql
14e0: 69 74 65 33 5f 66 69 6c 65 2a 29 3b 0a 73 74 61  ite3_file*);.sta
14f0: 74 69 63 20 69 6e 74 20 74 6d 70 52 65 61 64 28  tic int tmpRead(
1500: 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a 2c 20 76  sqlite3_file*, v
1510: 6f 69 64 2a 2c 20 69 6e 74 20 69 41 6d 74 2c 20  oid*, int iAmt, 
1520: 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 69 4f  sqlite3_int64 iO
1530: 66 73 74 29 3b 0a 73 74 61 74 69 63 20 69 6e 74  fst);.static int
1540: 20 74 6d 70 57 72 69 74 65 28 73 71 6c 69 74 65   tmpWrite(sqlite
1550: 33 5f 66 69 6c 65 2a 2c 20 63 6f 6e 73 74 20 76  3_file*, const v
1560: 6f 69 64 2a 2c 20 69 6e 74 20 69 41 6d 74 2c 20  oid*, int iAmt, 
1570: 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 69 4f  sqlite3_int64 iO
1580: 66 73 74 29 3b 0a 73 74 61 74 69 63 20 69 6e 74  fst);.static int
1590: 20 74 6d 70 54 72 75 6e 63 61 74 65 28 73 71 6c   tmpTruncate(sql
15a0: 69 74 65 33 5f 66 69 6c 65 2a 2c 20 73 71 6c 69  ite3_file*, sqli
15b0: 74 65 33 5f 69 6e 74 36 34 20 73 69 7a 65 29 3b  te3_int64 size);
15c0: 0a 73 74 61 74 69 63 20 69 6e 74 20 74 6d 70 53  .static int tmpS
15d0: 79 6e 63 28 73 71 6c 69 74 65 33 5f 66 69 6c 65  ync(sqlite3_file
15e0: 2a 2c 20 69 6e 74 20 66 6c 61 67 73 29 3b 0a 73  *, int flags);.s
15f0: 74 61 74 69 63 20 69 6e 74 20 74 6d 70 46 69 6c  tatic int tmpFil
1600: 65 53 69 7a 65 28 73 71 6c 69 74 65 33 5f 66 69  eSize(sqlite3_fi
1610: 6c 65 2a 2c 20 73 71 6c 69 74 65 33 5f 69 6e 74  le*, sqlite3_int
1620: 36 34 20 2a 70 53 69 7a 65 29 3b 0a 73 74 61 74  64 *pSize);.stat
1630: 69 63 20 69 6e 74 20 74 6d 70 4c 6f 63 6b 28 73  ic int tmpLock(s
1640: 71 6c 69 74 65 33 5f 66 69 6c 65 2a 2c 20 69 6e  qlite3_file*, in
1650: 74 29 3b 0a 73 74 61 74 69 63 20 69 6e 74 20 74  t);.static int t
1660: 6d 70 55 6e 6c 6f 63 6b 28 73 71 6c 69 74 65 33  mpUnlock(sqlite3
1670: 5f 66 69 6c 65 2a 2c 20 69 6e 74 29 3b 0a 73 74  _file*, int);.st
1680: 61 74 69 63 20 69 6e 74 20 74 6d 70 43 68 65 63  atic int tmpChec
1690: 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b 28 73 71  kReservedLock(sq
16a0: 6c 69 74 65 33 5f 66 69 6c 65 2a 2c 20 69 6e 74  lite3_file*, int
16b0: 20 2a 70 52 65 73 4f 75 74 29 3b 0a 73 74 61 74   *pResOut);.stat
16c0: 69 63 20 69 6e 74 20 74 6d 70 46 69 6c 65 43 6f  ic int tmpFileCo
16d0: 6e 74 72 6f 6c 28 73 71 6c 69 74 65 33 5f 66 69  ntrol(sqlite3_fi
16e0: 6c 65 2a 2c 20 69 6e 74 20 6f 70 2c 20 76 6f 69  le*, int op, voi
16f0: 64 20 2a 70 41 72 67 29 3b 0a 73 74 61 74 69 63  d *pArg);.static
1700: 20 69 6e 74 20 74 6d 70 53 65 63 74 6f 72 53 69   int tmpSectorSi
1710: 7a 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a  ze(sqlite3_file*
1720: 29 3b 0a 73 74 61 74 69 63 20 69 6e 74 20 74 6d  );.static int tm
1730: 70 44 65 76 69 63 65 43 68 61 72 61 63 74 65 72  pDeviceCharacter
1740: 69 73 74 69 63 73 28 73 71 6c 69 74 65 33 5f 66  istics(sqlite3_f
1750: 69 6c 65 2a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 4d 65  ile*);../*.** Me
1760: 74 68 6f 64 20 64 65 63 6c 61 72 61 74 69 6f 6e  thod declaration
1770: 73 20 66 6f 72 20 66 73 5f 76 66 73 2e 0a 2a 2f  s for fs_vfs..*/
1780: 0a 73 74 61 74 69 63 20 69 6e 74 20 66 73 4f 70  .static int fsOp
1790: 65 6e 28 73 71 6c 69 74 65 33 5f 76 66 73 2a 2c  en(sqlite3_vfs*,
17a0: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 2c 20 73   const char *, s
17b0: 71 6c 69 74 65 33 5f 66 69 6c 65 2a 2c 20 69 6e  qlite3_file*, in
17c0: 74 20 2c 20 69 6e 74 20 2a 29 3b 0a 73 74 61 74  t , int *);.stat
17d0: 69 63 20 69 6e 74 20 66 73 44 65 6c 65 74 65 28  ic int fsDelete(
17e0: 73 71 6c 69 74 65 33 5f 76 66 73 2a 2c 20 63 6f  sqlite3_vfs*, co
17f0: 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c  nst char *zName,
1800: 20 69 6e 74 20 73 79 6e 63 44 69 72 29 3b 0a 73   int syncDir);.s
1810: 74 61 74 69 63 20 69 6e 74 20 66 73 41 63 63 65  tatic int fsAcce
1820: 73 73 28 73 71 6c 69 74 65 33 5f 76 66 73 2a 2c  ss(sqlite3_vfs*,
1830: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61   const char *zNa
1840: 6d 65 2c 20 69 6e 74 20 66 6c 61 67 73 2c 20 69  me, int flags, i
1850: 6e 74 20 2a 29 3b 0a 73 74 61 74 69 63 20 69 6e  nt *);.static in
1860: 74 20 66 73 46 75 6c 6c 50 61 74 68 6e 61 6d 65  t fsFullPathname
1870: 28 73 71 6c 69 74 65 33 5f 76 66 73 2a 2c 20 63  (sqlite3_vfs*, c
1880: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65  onst char *zName
1890: 2c 20 69 6e 74 20 6e 4f 75 74 2c 63 68 61 72 20  , int nOut,char 
18a0: 2a 7a 4f 75 74 29 3b 0a 73 74 61 74 69 63 20 76  *zOut);.static v
18b0: 6f 69 64 20 2a 66 73 44 6c 4f 70 65 6e 28 73 71  oid *fsDlOpen(sq
18c0: 6c 69 74 65 33 5f 76 66 73 2a 2c 20 63 6f 6e 73  lite3_vfs*, cons
18d0: 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d  t char *zFilenam
18e0: 65 29 3b 0a 73 74 61 74 69 63 20 76 6f 69 64 20  e);.static void 
18f0: 66 73 44 6c 45 72 72 6f 72 28 73 71 6c 69 74 65  fsDlError(sqlite
1900: 33 5f 76 66 73 2a 2c 20 69 6e 74 20 6e 42 79 74  3_vfs*, int nByt
1910: 65 2c 20 63 68 61 72 20 2a 7a 45 72 72 4d 73 67  e, char *zErrMsg
1920: 29 3b 0a 73 74 61 74 69 63 20 76 6f 69 64 20 28  );.static void (
1930: 2a 66 73 44 6c 53 79 6d 28 73 71 6c 69 74 65 33  *fsDlSym(sqlite3
1940: 5f 76 66 73 2a 2c 76 6f 69 64 2a 2c 20 63 6f 6e  _vfs*,void*, con
1950: 73 74 20 63 68 61 72 20 2a 7a 53 79 6d 62 6f 6c  st char *zSymbol
1960: 29 29 28 76 6f 69 64 29 3b 0a 73 74 61 74 69 63  ))(void);.static
1970: 20 76 6f 69 64 20 66 73 44 6c 43 6c 6f 73 65 28   void fsDlClose(
1980: 73 71 6c 69 74 65 33 5f 76 66 73 2a 2c 20 76 6f  sqlite3_vfs*, vo
1990: 69 64 2a 29 3b 0a 73 74 61 74 69 63 20 69 6e 74  id*);.static int
19a0: 20 66 73 52 61 6e 64 6f 6d 6e 65 73 73 28 73 71   fsRandomness(sq
19b0: 6c 69 74 65 33 5f 76 66 73 2a 2c 20 69 6e 74 20  lite3_vfs*, int 
19c0: 6e 42 79 74 65 2c 20 63 68 61 72 20 2a 7a 4f 75  nByte, char *zOu
19d0: 74 29 3b 0a 73 74 61 74 69 63 20 69 6e 74 20 66  t);.static int f
19e0: 73 53 6c 65 65 70 28 73 71 6c 69 74 65 33 5f 76  sSleep(sqlite3_v
19f0: 66 73 2a 2c 20 69 6e 74 20 6d 69 63 72 6f 73 65  fs*, int microse
1a00: 63 6f 6e 64 73 29 3b 0a 73 74 61 74 69 63 20 69  conds);.static i
1a10: 6e 74 20 66 73 43 75 72 72 65 6e 74 54 69 6d 65  nt fsCurrentTime
1a20: 28 73 71 6c 69 74 65 33 5f 76 66 73 2a 2c 20 64  (sqlite3_vfs*, d
1a30: 6f 75 62 6c 65 2a 29 3b 0a 0a 0a 74 79 70 65 64  ouble*);...typed
1a40: 65 66 20 73 74 72 75 63 74 20 66 73 5f 76 66 73  ef struct fs_vfs
1a50: 5f 74 20 66 73 5f 76 66 73 5f 74 3b 0a 73 74 72  _t fs_vfs_t;.str
1a60: 75 63 74 20 66 73 5f 76 66 73 5f 74 20 7b 0a 20  uct fs_vfs_t {. 
1a70: 20 73 71 6c 69 74 65 33 5f 76 66 73 20 62 61 73   sqlite3_vfs bas
1a80: 65 3b 0a 20 20 66 73 5f 72 65 61 6c 5f 66 69 6c  e;.  fs_real_fil
1a90: 65 20 2a 70 46 69 6c 65 4c 69 73 74 3b 0a 20 20  e *pFileList;.  
1aa0: 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 50 61  sqlite3_vfs *pPa
1ab0: 72 65 6e 74 3b 0a 7d 3b 0a 0a 73 74 61 74 69 63  rent;.};..static
1ac0: 20 66 73 5f 76 66 73 5f 74 20 66 73 5f 76 66 73   fs_vfs_t fs_vfs
1ad0: 20 3d 20 7b 0a 20 20 7b 0a 20 20 20 20 31 2c 20   = {.  {.    1, 
1ae0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1af0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1b00: 20 20 20 20 20 20 20 20 20 2f 2a 20 69 56 65 72           /* iVer
1b10: 73 69 6f 6e 20 2a 2f 0a 20 20 20 20 30 2c 20 20  sion */.    0,  
1b20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1b30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1b40: 20 20 20 20 20 20 20 20 2f 2a 20 73 7a 4f 73 46          /* szOsF
1b50: 69 6c 65 20 2a 2f 0a 20 20 20 20 30 2c 20 20 20  ile */.    0,   
1b60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1b70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1b80: 20 20 20 20 20 20 20 2f 2a 20 6d 78 50 61 74 68         /* mxPath
1b90: 6e 61 6d 65 20 2a 2f 0a 20 20 20 20 30 2c 20 20  name */.    0,  
1ba0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1bb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1bc0: 20 20 20 20 20 20 20 20 2f 2a 20 70 4e 65 78 74          /* pNext
1bd0: 20 2a 2f 0a 20 20 20 20 46 53 5f 56 46 53 5f 4e   */.    FS_VFS_N
1be0: 41 4d 45 2c 20 20 20 20 20 20 20 20 20 20 20 20  AME,            
1bf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1c00: 20 20 20 20 2f 2a 20 7a 4e 61 6d 65 20 2a 2f 0a      /* zName */.
1c10: 20 20 20 20 30 2c 20 20 20 20 20 20 20 20 20 20      0,          
1c20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1c30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1c40: 2f 2a 20 70 41 70 70 44 61 74 61 20 2a 2f 0a 20  /* pAppData */. 
1c50: 20 20 20 66 73 4f 70 65 6e 2c 20 20 20 20 20 20     fsOpen,      
1c60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1c70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1c80: 2a 20 78 4f 70 65 6e 20 2a 2f 0a 20 20 20 20 66  * xOpen */.    f
1c90: 73 44 65 6c 65 74 65 2c 20 20 20 20 20 20 20 20  sDelete,        
1ca0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1cb0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 44             /* xD
1cc0: 65 6c 65 74 65 20 2a 2f 0a 20 20 20 20 66 73 41  elete */.    fsA
1cd0: 63 63 65 73 73 2c 20 20 20 20 20 20 20 20 20 20  ccess,          
1ce0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1cf0: 20 20 20 20 20 20 20 20 20 2f 2a 20 78 41 63 63           /* xAcc
1d00: 65 73 73 20 2a 2f 0a 20 20 20 20 66 73 46 75 6c  ess */.    fsFul
1d10: 6c 50 61 74 68 6e 61 6d 65 2c 20 20 20 20 20 20  lPathname,      
1d20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1d30: 20 20 20 20 20 20 20 2f 2a 20 78 46 75 6c 6c 50         /* xFullP
1d40: 61 74 68 6e 61 6d 65 20 2a 2f 0a 20 20 20 20 66  athname */.    f
1d50: 73 44 6c 4f 70 65 6e 2c 20 20 20 20 20 20 20 20  sDlOpen,        
1d60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1d70: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 44             /* xD
1d80: 6c 4f 70 65 6e 20 2a 2f 0a 20 20 20 20 66 73 44  lOpen */.    fsD
1d90: 6c 45 72 72 6f 72 2c 20 20 20 20 20 20 20 20 20  lError,         
1da0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1db0: 20 20 20 20 20 20 20 20 20 2f 2a 20 78 44 6c 45           /* xDlE
1dc0: 72 72 6f 72 20 2a 2f 0a 20 20 20 20 66 73 44 6c  rror */.    fsDl
1dd0: 53 79 6d 2c 20 20 20 20 20 20 20 20 20 20 20 20  Sym,            
1de0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1df0: 20 20 20 20 20 20 20 20 2f 2a 20 78 44 6c 53 79          /* xDlSy
1e00: 6d 20 2a 2f 0a 20 20 20 20 66 73 44 6c 43 6c 6f  m */.    fsDlClo
1e10: 73 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  se,             
1e20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1e30: 20 20 20 20 20 2f 2a 20 78 44 6c 43 6c 6f 73 65       /* xDlClose
1e40: 20 2a 2f 0a 20 20 20 20 66 73 52 61 6e 64 6f 6d   */.    fsRandom
1e50: 6e 65 73 73 2c 20 20 20 20 20 20 20 20 20 20 20  ness,           
1e60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1e70: 20 20 20 20 2f 2a 20 78 52 61 6e 64 6f 6d 6e 65      /* xRandomne
1e80: 73 73 20 2a 2f 0a 20 20 20 20 66 73 53 6c 65 65  ss */.    fsSlee
1e90: 70 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  p,              
1ea0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1eb0: 20 20 20 20 20 20 2f 2a 20 78 53 6c 65 65 70 20        /* xSleep 
1ec0: 2a 2f 0a 20 20 20 20 66 73 43 75 72 72 65 6e 74  */.    fsCurrent
1ed0: 54 69 6d 65 2c 20 20 20 20 20 20 20 20 20 20 20  Time,           
1ee0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1ef0: 20 20 20 2f 2a 20 78 43 75 72 72 65 6e 74 54 69     /* xCurrentTi
1f00: 6d 65 20 2a 2f 0a 20 20 20 20 30 20 20 20 20 20  me */.    0     
1f10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1f20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1f30: 20 20 20 20 20 20 2f 2a 20 78 43 75 72 72 65 6e        /* xCurren
1f40: 74 54 69 6d 65 49 6e 74 36 34 20 2a 2f 0a 20 20  tTimeInt64 */.  
1f50: 7d 2c 20 0a 20 20 30 2c 20 20 20 20 20 20 20 20  }, .  0,        
1f60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1f70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1f80: 20 20 20 20 2f 2a 20 70 46 69 6c 65 4c 69 73 74      /* pFileList
1f90: 20 2a 2f 0a 20 20 30 20 20 20 20 20 20 20 20 20   */.  0         
1fa0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1fb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1fc0: 20 20 20 20 2f 2a 20 70 50 61 72 65 6e 74 20 2a      /* pParent *
1fd0: 2f 0a 7d 3b 0a 0a 73 74 61 74 69 63 20 73 71 6c  /.};..static sql
1fe0: 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20  ite3_io_methods 
1ff0: 66 73 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 3d 20  fs_io_methods = 
2000: 7b 0a 20 20 31 2c 20 20 20 20 20 20 20 20 20 20  {.  1,          
2010: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2020: 20 20 2f 2a 20 69 56 65 72 73 69 6f 6e 20 2a 2f    /* iVersion */
2030: 0a 20 20 66 73 43 6c 6f 73 65 2c 20 20 20 20 20  .  fsClose,     
2040: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2050: 20 2f 2a 20 78 43 6c 6f 73 65 20 2a 2f 0a 20 20   /* xClose */.  
2060: 66 73 52 65 61 64 2c 20 20 20 20 20 20 20 20 20  fsRead,         
2070: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
2080: 20 78 52 65 61 64 20 2a 2f 0a 20 20 66 73 57 72   xRead */.  fsWr
2090: 69 74 65 2c 20 20 20 20 20 20 20 20 20 20 20 20  ite,            
20a0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 57 72            /* xWr
20b0: 69 74 65 20 2a 2f 0a 20 20 66 73 54 72 75 6e 63  ite */.  fsTrunc
20c0: 61 74 65 2c 20 20 20 20 20 20 20 20 20 20 20 20  ate,            
20d0: 20 20 20 20 20 20 20 2f 2a 20 78 54 72 75 6e 63         /* xTrunc
20e0: 61 74 65 20 2a 2f 0a 20 20 66 73 53 79 6e 63 2c  ate */.  fsSync,
20f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2100: 20 20 20 20 20 20 20 2f 2a 20 78 53 79 6e 63 20         /* xSync 
2110: 2a 2f 0a 20 20 66 73 46 69 6c 65 53 69 7a 65 2c  */.  fsFileSize,
2120: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2130: 20 20 20 2f 2a 20 78 46 69 6c 65 53 69 7a 65 20     /* xFileSize 
2140: 2a 2f 0a 20 20 66 73 4c 6f 63 6b 2c 20 20 20 20  */.  fsLock,    
2150: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2160: 20 20 20 2f 2a 20 78 4c 6f 63 6b 20 2a 2f 0a 20     /* xLock */. 
2170: 20 66 73 55 6e 6c 6f 63 6b 2c 20 20 20 20 20 20   fsUnlock,      
2180: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
2190: 2a 20 78 55 6e 6c 6f 63 6b 20 2a 2f 0a 20 20 66  * xUnlock */.  f
21a0: 73 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f  sCheckReservedLo
21b0: 63 6b 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ck,          /* 
21c0: 78 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f  xCheckReservedLo
21d0: 63 6b 20 2a 2f 0a 20 20 66 73 46 69 6c 65 43 6f  ck */.  fsFileCo
21e0: 6e 74 72 6f 6c 2c 20 20 20 20 20 20 20 20 20 20  ntrol,          
21f0: 20 20 20 20 20 20 2f 2a 20 78 46 69 6c 65 43 6f        /* xFileCo
2200: 6e 74 72 6f 6c 20 2a 2f 0a 20 20 66 73 53 65 63  ntrol */.  fsSec
2210: 74 6f 72 53 69 7a 65 2c 20 20 20 20 20 20 20 20  torSize,        
2220: 20 20 20 20 20 20 20 20 20 2f 2a 20 78 53 65 63           /* xSec
2230: 74 6f 72 53 69 7a 65 20 2a 2f 0a 20 20 66 73 44  torSize */.  fsD
2240: 65 76 69 63 65 43 68 61 72 61 63 74 65 72 69 73  eviceCharacteris
2250: 74 69 63 73 2c 20 20 20 20 20 20 2f 2a 20 78 44  tics,      /* xD
2260: 65 76 69 63 65 43 68 61 72 61 63 74 65 72 69 73  eviceCharacteris
2270: 74 69 63 73 20 2a 2f 0a 20 20 30 2c 20 20 20 20  tics */.  0,    
2280: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2290: 20 20 20 20 20 20 20 20 2f 2a 20 78 53 68 6d 4d          /* xShmM
22a0: 61 70 20 2a 2f 0a 20 20 30 2c 20 20 20 20 20 20  ap */.  0,      
22b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
22c0: 20 20 20 20 20 20 2f 2a 20 78 53 68 6d 4c 6f 63        /* xShmLoc
22d0: 6b 20 2a 2f 0a 20 20 30 2c 20 20 20 20 20 20 20  k */.  0,       
22e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
22f0: 20 20 20 20 20 2f 2a 20 78 53 68 6d 42 61 72 72       /* xShmBarr
2300: 69 65 72 20 2a 2f 0a 20 20 30 20 20 20 20 20 20  ier */.  0      
2310: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2320: 20 20 20 20 20 20 20 2f 2a 20 78 53 68 6d 55 6e         /* xShmUn
2330: 6d 61 70 20 2a 2f 0a 7d 3b 0a 0a 0a 73 74 61 74  map */.};...stat
2340: 69 63 20 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65  ic sqlite3_io_me
2350: 74 68 6f 64 73 20 74 6d 70 5f 69 6f 5f 6d 65 74  thods tmp_io_met
2360: 68 6f 64 73 20 3d 20 7b 0a 20 20 31 2c 20 20 20  hods = {.  1,   
2370: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2380: 20 20 20 20 20 20 20 20 20 2f 2a 20 69 56 65 72           /* iVer
2390: 73 69 6f 6e 20 2a 2f 0a 20 20 74 6d 70 43 6c 6f  sion */.  tmpClo
23a0: 73 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  se,             
23b0: 20 20 20 20 20 20 20 20 2f 2a 20 78 43 6c 6f 73          /* xClos
23c0: 65 20 2a 2f 0a 20 20 74 6d 70 52 65 61 64 2c 20  e */.  tmpRead, 
23d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
23e0: 20 20 20 20 20 2f 2a 20 78 52 65 61 64 20 2a 2f       /* xRead */
23f0: 0a 20 20 74 6d 70 57 72 69 74 65 2c 20 20 20 20  .  tmpWrite,    
2400: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2410: 20 2f 2a 20 78 57 72 69 74 65 20 2a 2f 0a 20 20   /* xWrite */.  
2420: 74 6d 70 54 72 75 6e 63 61 74 65 2c 20 20 20 20  tmpTruncate,    
2430: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
2440: 20 78 54 72 75 6e 63 61 74 65 20 2a 2f 0a 20 20   xTruncate */.  
2450: 74 6d 70 53 79 6e 63 2c 20 20 20 20 20 20 20 20  tmpSync,        
2460: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
2470: 20 78 53 79 6e 63 20 2a 2f 0a 20 20 74 6d 70 46   xSync */.  tmpF
2480: 69 6c 65 53 69 7a 65 2c 20 20 20 20 20 20 20 20  ileSize,        
2490: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 46 69            /* xFi
24a0: 6c 65 53 69 7a 65 20 2a 2f 0a 20 20 74 6d 70 4c  leSize */.  tmpL
24b0: 6f 63 6b 2c 20 20 20 20 20 20 20 20 20 20 20 20  ock,            
24c0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 4c 6f            /* xLo
24d0: 63 6b 20 2a 2f 0a 20 20 74 6d 70 55 6e 6c 6f 63  ck */.  tmpUnloc
24e0: 6b 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  k,              
24f0: 20 20 20 20 20 20 2f 2a 20 78 55 6e 6c 6f 63 6b        /* xUnlock
2500: 20 2a 2f 0a 20 20 74 6d 70 43 68 65 63 6b 52 65   */.  tmpCheckRe
2510: 73 65 72 76 65 64 4c 6f 63 6b 2c 20 20 20 20 20  servedLock,     
2520: 20 20 20 20 2f 2a 20 78 43 68 65 63 6b 52 65 73      /* xCheckRes
2530: 65 72 76 65 64 4c 6f 63 6b 20 2a 2f 0a 20 20 74  ervedLock */.  t
2540: 6d 70 46 69 6c 65 43 6f 6e 74 72 6f 6c 2c 20 20  mpFileControl,  
2550: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
2560: 78 46 69 6c 65 43 6f 6e 74 72 6f 6c 20 2a 2f 0a  xFileControl */.
2570: 20 20 74 6d 70 53 65 63 74 6f 72 53 69 7a 65 2c    tmpSectorSize,
2580: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2590: 2f 2a 20 78 53 65 63 74 6f 72 53 69 7a 65 20 2a  /* xSectorSize *
25a0: 2f 0a 20 20 74 6d 70 44 65 76 69 63 65 43 68 61  /.  tmpDeviceCha
25b0: 72 61 63 74 65 72 69 73 74 69 63 73 2c 20 20 20  racteristics,   
25c0: 20 20 2f 2a 20 78 44 65 76 69 63 65 43 68 61 72    /* xDeviceChar
25d0: 61 63 74 65 72 69 73 74 69 63 73 20 2a 2f 0a 20  acteristics */. 
25e0: 20 30 2c 20 20 20 20 20 20 20 20 20 20 20 20 20   0,             
25f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
2600: 2a 20 78 53 68 6d 4d 61 70 20 2a 2f 0a 20 20 30  * xShmMap */.  0
2610: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
2620: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
2630: 78 53 68 6d 4c 6f 63 6b 20 2a 2f 0a 20 20 30 2c  xShmLock */.  0,
2640: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2650: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78              /* x
2660: 53 68 6d 42 61 72 72 69 65 72 20 2a 2f 0a 20 20  ShmBarrier */.  
2670: 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  0               
2680: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
2690: 20 78 53 68 6d 55 6e 6d 61 70 20 2a 2f 0a 7d 3b   xShmUnmap */.};
26a0: 0a 0a 2f 2a 20 55 73 65 66 75 6c 20 6d 61 63 72  ../* Useful macr
26b0: 6f 73 20 75 73 65 64 20 69 6e 20 73 65 76 65 72  os used in sever
26c0: 61 6c 20 70 6c 61 63 65 73 20 2a 2f 0a 23 64 65  al places */.#de
26d0: 66 69 6e 65 20 4d 49 4e 28 78 2c 79 29 20 28 28  fine MIN(x,y) ((
26e0: 78 29 3c 28 79 29 3f 28 78 29 3a 28 79 29 29 0a  x)<(y)?(x):(y)).
26f0: 23 64 65 66 69 6e 65 20 4d 41 58 28 78 2c 79 29  #define MAX(x,y)
2700: 20 28 28 78 29 3e 28 79 29 3f 28 78 29 3a 28 79   ((x)>(y)?(x):(y
2710: 29 29 0a 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65  )).../*.** Close
2720: 20 61 20 74 6d 70 2d 66 69 6c 65 2e 0a 2a 2f 0a   a tmp-file..*/.
2730: 73 74 61 74 69 63 20 69 6e 74 20 74 6d 70 43 6c  static int tmpCl
2740: 6f 73 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65  ose(sqlite3_file
2750: 20 2a 70 46 69 6c 65 29 7b 0a 20 20 74 6d 70 5f   *pFile){.  tmp_
2760: 66 69 6c 65 20 2a 70 54 6d 70 20 3d 20 28 74 6d  file *pTmp = (tm
2770: 70 5f 66 69 6c 65 20 2a 29 70 46 69 6c 65 3b 0a  p_file *)pFile;.
2780: 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70    sqlite3_free(p
2790: 54 6d 70 2d 3e 7a 41 6c 6c 6f 63 29 3b 0a 20 20  Tmp->zAlloc);.  
27a0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
27b0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20  ;.}../*.** Read 
27c0: 64 61 74 61 20 66 72 6f 6d 20 61 20 74 6d 70 2d  data from a tmp-
27d0: 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  file..*/.static 
27e0: 69 6e 74 20 74 6d 70 52 65 61 64 28 0a 20 20 73  int tmpRead(.  s
27f0: 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 46 69  qlite3_file *pFi
2800: 6c 65 2c 20 0a 20 20 76 6f 69 64 20 2a 7a 42 75  le, .  void *zBu
2810: 66 2c 20 0a 20 20 69 6e 74 20 69 41 6d 74 2c 20  f, .  int iAmt, 
2820: 0a 20 20 73 71 6c 69 74 65 5f 69 6e 74 36 34 20  .  sqlite_int64 
2830: 69 4f 66 73 74 0a 29 7b 0a 20 20 74 6d 70 5f 66  iOfst.){.  tmp_f
2840: 69 6c 65 20 2a 70 54 6d 70 20 3d 20 28 74 6d 70  ile *pTmp = (tmp
2850: 5f 66 69 6c 65 20 2a 29 70 46 69 6c 65 3b 0a 20  _file *)pFile;. 
2860: 20 69 66 28 20 28 69 41 6d 74 2b 69 4f 66 73 74   if( (iAmt+iOfst
2870: 29 3e 70 54 6d 70 2d 3e 6e 53 69 7a 65 20 29 7b  )>pTmp->nSize ){
2880: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
2890: 54 45 5f 49 4f 45 52 52 5f 53 48 4f 52 54 5f 52  TE_IOERR_SHORT_R
28a0: 45 41 44 3b 0a 20 20 7d 0a 20 20 6d 65 6d 63 70  EAD;.  }.  memcp
28b0: 79 28 7a 42 75 66 2c 20 26 70 54 6d 70 2d 3e 7a  y(zBuf, &pTmp->z
28c0: 41 6c 6c 6f 63 5b 69 4f 66 73 74 5d 2c 20 69 41  Alloc[iOfst], iA
28d0: 6d 74 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51  mt);.  return SQ
28e0: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a  LITE_OK;.}../*.*
28f0: 2a 20 57 72 69 74 65 20 64 61 74 61 20 74 6f 20  * Write data to 
2900: 61 20 74 6d 70 2d 66 69 6c 65 2e 0a 2a 2f 0a 73  a tmp-file..*/.s
2910: 74 61 74 69 63 20 69 6e 74 20 74 6d 70 57 72 69  tatic int tmpWri
2920: 74 65 28 0a 20 20 73 71 6c 69 74 65 33 5f 66 69  te(.  sqlite3_fi
2930: 6c 65 20 2a 70 46 69 6c 65 2c 20 0a 20 20 63 6f  le *pFile, .  co
2940: 6e 73 74 20 76 6f 69 64 20 2a 7a 42 75 66 2c 20  nst void *zBuf, 
2950: 0a 20 20 69 6e 74 20 69 41 6d 74 2c 20 0a 20 20  .  int iAmt, .  
2960: 73 71 6c 69 74 65 5f 69 6e 74 36 34 20 69 4f 66  sqlite_int64 iOf
2970: 73 74 0a 29 7b 0a 20 20 74 6d 70 5f 66 69 6c 65  st.){.  tmp_file
2980: 20 2a 70 54 6d 70 20 3d 20 28 74 6d 70 5f 66 69   *pTmp = (tmp_fi
2990: 6c 65 20 2a 29 70 46 69 6c 65 3b 0a 20 20 69 66  le *)pFile;.  if
29a0: 28 20 28 69 41 6d 74 2b 69 4f 66 73 74 29 3e 70  ( (iAmt+iOfst)>p
29b0: 54 6d 70 2d 3e 6e 41 6c 6c 6f 63 20 29 7b 0a 20  Tmp->nAlloc ){. 
29c0: 20 20 20 69 6e 74 20 6e 4e 65 77 20 3d 20 28 69     int nNew = (i
29d0: 6e 74 29 28 32 2a 28 69 41 6d 74 2b 69 4f 66 73  nt)(2*(iAmt+iOfs
29e0: 74 2b 70 54 6d 70 2d 3e 6e 41 6c 6c 6f 63 29 29  t+pTmp->nAlloc))
29f0: 3b 0a 20 20 20 20 63 68 61 72 20 2a 7a 4e 65 77  ;.    char *zNew
2a00: 20 3d 20 73 71 6c 69 74 65 33 5f 72 65 61 6c 6c   = sqlite3_reall
2a10: 6f 63 28 70 54 6d 70 2d 3e 7a 41 6c 6c 6f 63 2c  oc(pTmp->zAlloc,
2a20: 20 6e 4e 65 77 29 3b 0a 20 20 20 20 69 66 28 20   nNew);.    if( 
2a30: 21 7a 4e 65 77 20 29 7b 0a 20 20 20 20 20 20 72  !zNew ){.      r
2a40: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d  eturn SQLITE_NOM
2a50: 45 4d 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 54  EM;.    }.    pT
2a60: 6d 70 2d 3e 7a 41 6c 6c 6f 63 20 3d 20 7a 4e 65  mp->zAlloc = zNe
2a70: 77 3b 0a 20 20 20 20 70 54 6d 70 2d 3e 6e 41 6c  w;.    pTmp->nAl
2a80: 6c 6f 63 20 3d 20 6e 4e 65 77 3b 0a 20 20 7d 0a  loc = nNew;.  }.
2a90: 20 20 6d 65 6d 63 70 79 28 26 70 54 6d 70 2d 3e    memcpy(&pTmp->
2aa0: 7a 41 6c 6c 6f 63 5b 69 4f 66 73 74 5d 2c 20 7a  zAlloc[iOfst], z
2ab0: 42 75 66 2c 20 69 41 6d 74 29 3b 0a 20 20 70 54  Buf, iAmt);.  pT
2ac0: 6d 70 2d 3e 6e 53 69 7a 65 20 3d 20 28 69 6e 74  mp->nSize = (int
2ad0: 29 4d 41 58 28 70 54 6d 70 2d 3e 6e 53 69 7a 65  )MAX(pTmp->nSize
2ae0: 2c 20 69 4f 66 73 74 2b 69 41 6d 74 29 3b 0a 20  , iOfst+iAmt);. 
2af0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
2b00: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 72 75 6e  K;.}../*.** Trun
2b10: 63 61 74 65 20 61 20 74 6d 70 2d 66 69 6c 65 2e  cate a tmp-file.
2b20: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 74  .*/.static int t
2b30: 6d 70 54 72 75 6e 63 61 74 65 28 73 71 6c 69 74  mpTruncate(sqlit
2b40: 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65 2c 20  e3_file *pFile, 
2b50: 73 71 6c 69 74 65 5f 69 6e 74 36 34 20 73 69 7a  sqlite_int64 siz
2b60: 65 29 7b 0a 20 20 74 6d 70 5f 66 69 6c 65 20 2a  e){.  tmp_file *
2b70: 70 54 6d 70 20 3d 20 28 74 6d 70 5f 66 69 6c 65  pTmp = (tmp_file
2b80: 20 2a 29 70 46 69 6c 65 3b 0a 20 20 70 54 6d 70   *)pFile;.  pTmp
2b90: 2d 3e 6e 53 69 7a 65 20 3d 20 28 69 6e 74 29 4d  ->nSize = (int)M
2ba0: 49 4e 28 70 54 6d 70 2d 3e 6e 53 69 7a 65 2c 20  IN(pTmp->nSize, 
2bb0: 73 69 7a 65 29 3b 0a 20 20 72 65 74 75 72 6e 20  size);.  return 
2bc0: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a  SQLITE_OK;.}../*
2bd0: 0a 2a 2a 20 53 79 6e 63 20 61 20 74 6d 70 2d 66  .** Sync a tmp-f
2be0: 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ile..*/.static i
2bf0: 6e 74 20 74 6d 70 53 79 6e 63 28 73 71 6c 69 74  nt tmpSync(sqlit
2c00: 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65 2c 20  e3_file *pFile, 
2c10: 69 6e 74 20 66 6c 61 67 73 29 7b 0a 20 20 72 65  int flags){.  re
2c20: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
2c30: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
2c40: 74 68 65 20 63 75 72 72 65 6e 74 20 66 69 6c 65  the current file
2c50: 2d 73 69 7a 65 20 6f 66 20 61 20 74 6d 70 2d 66  -size of a tmp-f
2c60: 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ile..*/.static i
2c70: 6e 74 20 74 6d 70 46 69 6c 65 53 69 7a 65 28 73  nt tmpFileSize(s
2c80: 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 46 69  qlite3_file *pFi
2c90: 6c 65 2c 20 73 71 6c 69 74 65 5f 69 6e 74 36 34  le, sqlite_int64
2ca0: 20 2a 70 53 69 7a 65 29 7b 0a 20 20 74 6d 70 5f   *pSize){.  tmp_
2cb0: 66 69 6c 65 20 2a 70 54 6d 70 20 3d 20 28 74 6d  file *pTmp = (tm
2cc0: 70 5f 66 69 6c 65 20 2a 29 70 46 69 6c 65 3b 0a  p_file *)pFile;.
2cd0: 20 20 2a 70 53 69 7a 65 20 3d 20 70 54 6d 70 2d    *pSize = pTmp-
2ce0: 3e 6e 53 69 7a 65 3b 0a 20 20 72 65 74 75 72 6e  >nSize;.  return
2cf0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f   SQLITE_OK;.}../
2d00: 2a 0a 2a 2a 20 4c 6f 63 6b 20 61 20 74 6d 70 2d  *.** Lock a tmp-
2d10: 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  file..*/.static 
2d20: 69 6e 74 20 74 6d 70 4c 6f 63 6b 28 73 71 6c 69  int tmpLock(sqli
2d30: 74 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65 2c  te3_file *pFile,
2d40: 20 69 6e 74 20 65 4c 6f 63 6b 29 7b 0a 20 20 72   int eLock){.  r
2d50: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
2d60: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55 6e 6c 6f 63 6b  .}../*.** Unlock
2d70: 20 61 20 74 6d 70 2d 66 69 6c 65 2e 0a 2a 2f 0a   a tmp-file..*/.
2d80: 73 74 61 74 69 63 20 69 6e 74 20 74 6d 70 55 6e  static int tmpUn
2d90: 6c 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66 69 6c  lock(sqlite3_fil
2da0: 65 20 2a 70 46 69 6c 65 2c 20 69 6e 74 20 65 4c  e *pFile, int eL
2db0: 6f 63 6b 29 7b 0a 20 20 72 65 74 75 72 6e 20 53  ock){.  return S
2dc0: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a  QLITE_OK;.}../*.
2dd0: 2a 2a 20 43 68 65 63 6b 20 69 66 20 61 6e 6f 74  ** Check if anot
2de0: 68 65 72 20 66 69 6c 65 2d 68 61 6e 64 6c 65 20  her file-handle 
2df0: 68 6f 6c 64 73 20 61 20 52 45 53 45 52 56 45 44  holds a RESERVED
2e00: 20 6c 6f 63 6b 20 6f 6e 20 61 20 74 6d 70 2d 66   lock on a tmp-f
2e10: 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ile..*/.static i
2e20: 6e 74 20 74 6d 70 43 68 65 63 6b 52 65 73 65 72  nt tmpCheckReser
2e30: 76 65 64 4c 6f 63 6b 28 73 71 6c 69 74 65 33 5f  vedLock(sqlite3_
2e40: 66 69 6c 65 20 2a 70 46 69 6c 65 2c 20 69 6e 74  file *pFile, int
2e50: 20 2a 70 52 65 73 4f 75 74 29 7b 0a 20 20 2a 70   *pResOut){.  *p
2e60: 52 65 73 4f 75 74 20 3d 20 30 3b 0a 20 20 72 65  ResOut = 0;.  re
2e70: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
2e80: 7d 0a 0a 2f 2a 0a 2a 2a 20 46 69 6c 65 20 63 6f  }../*.** File co
2e90: 6e 74 72 6f 6c 20 6d 65 74 68 6f 64 2e 20 46 6f  ntrol method. Fo
2ea0: 72 20 63 75 73 74 6f 6d 20 6f 70 65 72 61 74 69  r custom operati
2eb0: 6f 6e 73 20 6f 6e 20 61 20 74 6d 70 2d 66 69 6c  ons on a tmp-fil
2ec0: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  e..*/.static int
2ed0: 20 74 6d 70 46 69 6c 65 43 6f 6e 74 72 6f 6c 28   tmpFileControl(
2ee0: 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 46  sqlite3_file *pF
2ef0: 69 6c 65 2c 20 69 6e 74 20 6f 70 2c 20 76 6f 69  ile, int op, voi
2f00: 64 20 2a 70 41 72 67 29 7b 0a 20 20 72 65 74 75  d *pArg){.  retu
2f10: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a  rn SQLITE_OK;.}.
2f20: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68  ./*.** Return th
2f30: 65 20 73 65 63 74 6f 72 2d 73 69 7a 65 20 69 6e  e sector-size in
2f40: 20 62 79 74 65 73 20 66 6f 72 20 61 20 74 6d 70   bytes for a tmp
2f50: 2d 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63  -file..*/.static
2f60: 20 69 6e 74 20 74 6d 70 53 65 63 74 6f 72 53 69   int tmpSectorSi
2f70: 7a 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20  ze(sqlite3_file 
2f80: 2a 70 46 69 6c 65 29 7b 0a 20 20 72 65 74 75 72  *pFile){.  retur
2f90: 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  n 0;.}../*.** Re
2fa0: 74 75 72 6e 20 74 68 65 20 64 65 76 69 63 65 20  turn the device 
2fb0: 63 68 61 72 61 63 74 65 72 69 73 74 69 63 20 66  characteristic f
2fc0: 6c 61 67 73 20 73 75 70 70 6f 72 74 65 64 20 62  lags supported b
2fd0: 79 20 61 20 74 6d 70 2d 66 69 6c 65 2e 0a 2a 2f  y a tmp-file..*/
2fe0: 0a 73 74 61 74 69 63 20 69 6e 74 20 74 6d 70 44  .static int tmpD
2ff0: 65 76 69 63 65 43 68 61 72 61 63 74 65 72 69 73  eviceCharacteris
3000: 74 69 63 73 28 73 71 6c 69 74 65 33 5f 66 69 6c  tics(sqlite3_fil
3010: 65 20 2a 70 46 69 6c 65 29 7b 0a 20 20 72 65 74  e *pFile){.  ret
3020: 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  urn 0;.}../*.** 
3030: 43 6c 6f 73 65 20 61 6e 20 66 73 2d 66 69 6c 65  Close an fs-file
3040: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
3050: 66 73 43 6c 6f 73 65 28 73 71 6c 69 74 65 33 5f  fsClose(sqlite3_
3060: 66 69 6c 65 20 2a 70 46 69 6c 65 29 7b 0a 20 20  file *pFile){.  
3070: 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f  int rc = SQLITE_
3080: 4f 4b 3b 0a 20 20 66 73 5f 66 69 6c 65 20 2a 70  OK;.  fs_file *p
3090: 20 3d 20 28 66 73 5f 66 69 6c 65 20 2a 29 70 46   = (fs_file *)pF
30a0: 69 6c 65 3b 0a 20 20 66 73 5f 72 65 61 6c 5f 66  ile;.  fs_real_f
30b0: 69 6c 65 20 2a 70 52 65 61 6c 20 3d 20 70 2d 3e  ile *pReal = p->
30c0: 70 52 65 61 6c 3b 0a 0a 20 20 2f 2a 20 44 65 63  pReal;..  /* Dec
30d0: 72 65 6d 65 6e 74 20 74 68 65 20 72 65 61 6c 5f  rement the real_
30e0: 66 69 6c 65 20 72 65 66 2d 63 6f 75 6e 74 2e 20  file ref-count. 
30f0: 2a 2f 0a 20 20 70 52 65 61 6c 2d 3e 6e 52 65 66  */.  pReal->nRef
3100: 2d 2d 3b 0a 20 20 61 73 73 65 72 74 28 70 52 65  --;.  assert(pRe
3110: 61 6c 2d 3e 6e 52 65 66 3e 3d 30 29 3b 0a 0a 20  al->nRef>=0);.. 
3120: 20 2f 2a 20 57 68 65 6e 20 74 68 65 20 72 65 66   /* When the ref
3130: 2d 63 6f 75 6e 74 20 72 65 61 63 68 65 73 20 30  -count reaches 0
3140: 2c 20 64 65 73 74 72 6f 79 20 74 68 65 20 73 74  , destroy the st
3150: 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 69 66 28  ructure */.  if(
3160: 20 70 52 65 61 6c 2d 3e 6e 52 65 66 3d 3d 30 20   pReal->nRef==0 
3170: 29 7b 0a 20 20 20 20 2a 70 52 65 61 6c 2d 3e 70  ){.    *pReal->p
3180: 70 54 68 69 73 20 3d 20 70 52 65 61 6c 2d 3e 70  pThis = pReal->p
3190: 4e 65 78 74 3b 0a 20 20 20 20 69 66 28 20 70 52  Next;.    if( pR
31a0: 65 61 6c 2d 3e 70 4e 65 78 74 20 29 7b 0a 20 20  eal->pNext ){.  
31b0: 20 20 20 20 70 52 65 61 6c 2d 3e 70 4e 65 78 74      pReal->pNext
31c0: 2d 3e 70 70 54 68 69 73 20 3d 20 70 52 65 61 6c  ->ppThis = pReal
31d0: 2d 3e 70 70 54 68 69 73 3b 0a 20 20 20 20 7d 0a  ->ppThis;.    }.
31e0: 20 20 20 20 72 63 20 3d 20 70 52 65 61 6c 2d 3e      rc = pReal->
31f0: 70 46 69 6c 65 2d 3e 70 4d 65 74 68 6f 64 73 2d  pFile->pMethods-
3200: 3e 78 43 6c 6f 73 65 28 70 52 65 61 6c 2d 3e 70  >xClose(pReal->p
3210: 46 69 6c 65 29 3b 0a 20 20 20 20 73 71 6c 69 74  File);.    sqlit
3220: 65 33 5f 66 72 65 65 28 70 52 65 61 6c 29 3b 0a  e3_free(pReal);.
3230: 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72 63    }..  return rc
3240: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20  ;.}../*.** Read 
3250: 64 61 74 61 20 66 72 6f 6d 20 61 6e 20 66 73 2d  data from an fs-
3260: 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  file..*/.static 
3270: 69 6e 74 20 66 73 52 65 61 64 28 0a 20 20 73 71  int fsRead(.  sq
3280: 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c  lite3_file *pFil
3290: 65 2c 20 0a 20 20 76 6f 69 64 20 2a 7a 42 75 66  e, .  void *zBuf
32a0: 2c 20 0a 20 20 69 6e 74 20 69 41 6d 74 2c 20 0a  , .  int iAmt, .
32b0: 20 20 73 71 6c 69 74 65 5f 69 6e 74 36 34 20 69    sqlite_int64 i
32c0: 4f 66 73 74 0a 29 7b 0a 20 20 69 6e 74 20 72 63  Ofst.){.  int rc
32d0: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20   = SQLITE_OK;.  
32e0: 66 73 5f 66 69 6c 65 20 2a 70 20 3d 20 28 66 73  fs_file *p = (fs
32f0: 5f 66 69 6c 65 20 2a 29 70 46 69 6c 65 3b 0a 20  _file *)pFile;. 
3300: 20 66 73 5f 72 65 61 6c 5f 66 69 6c 65 20 2a 70   fs_real_file *p
3310: 52 65 61 6c 20 3d 20 70 2d 3e 70 52 65 61 6c 3b  Real = p->pReal;
3320: 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20  .  sqlite3_file 
3330: 2a 70 46 20 3d 20 70 52 65 61 6c 2d 3e 70 46 69  *pF = pReal->pFi
3340: 6c 65 3b 0a 0a 20 20 69 66 28 20 28 70 2d 3e 65  le;..  if( (p->e
3350: 54 79 70 65 3d 3d 44 41 54 41 42 41 53 45 5f 46  Type==DATABASE_F
3360: 49 4c 45 20 26 26 20 28 69 41 6d 74 2b 69 4f 66  ILE && (iAmt+iOf
3370: 73 74 29 3e 70 52 65 61 6c 2d 3e 6e 44 61 74 61  st)>pReal->nData
3380: 62 61 73 65 29 0a 20 20 20 7c 7c 20 28 70 2d 3e  base).   || (p->
3390: 65 54 79 70 65 3d 3d 4a 4f 55 52 4e 41 4c 5f 46  eType==JOURNAL_F
33a0: 49 4c 45 20 26 26 20 28 69 41 6d 74 2b 69 4f 66  ILE && (iAmt+iOf
33b0: 73 74 29 3e 70 52 65 61 6c 2d 3e 6e 4a 6f 75 72  st)>pReal->nJour
33c0: 6e 61 6c 29 0a 20 20 29 7b 0a 20 20 20 20 72 63  nal).  ){.    rc
33d0: 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f   = SQLITE_IOERR_
33e0: 53 48 4f 52 54 5f 52 45 41 44 3b 0a 20 20 7d 65  SHORT_READ;.  }e
33f0: 6c 73 65 20 69 66 28 20 70 2d 3e 65 54 79 70 65  lse if( p->eType
3400: 3d 3d 44 41 54 41 42 41 53 45 5f 46 49 4c 45 20  ==DATABASE_FILE 
3410: 29 7b 0a 20 20 20 20 72 63 20 3d 20 70 46 2d 3e  ){.    rc = pF->
3420: 70 4d 65 74 68 6f 64 73 2d 3e 78 52 65 61 64 28  pMethods->xRead(
3430: 70 46 2c 20 7a 42 75 66 2c 20 69 41 6d 74 2c 20  pF, zBuf, iAmt, 
3440: 69 4f 66 73 74 2b 42 4c 4f 43 4b 53 49 5a 45 29  iOfst+BLOCKSIZE)
3450: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f  ;.  }else{.    /
3460: 2a 20 4a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20  * Journal file. 
3470: 2a 2f 0a 20 20 20 20 69 6e 74 20 69 52 65 6d 20  */.    int iRem 
3480: 3d 20 69 41 6d 74 3b 0a 20 20 20 20 69 6e 74 20  = iAmt;.    int 
3490: 69 42 75 66 20 3d 20 30 3b 0a 20 20 20 20 69 6e  iBuf = 0;.    in
34a0: 74 20 69 69 20 3d 20 28 69 6e 74 29 69 4f 66 73  t ii = (int)iOfs
34b0: 74 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 69 52  t;.    while( iR
34c0: 65 6d 3e 30 20 26 26 20 72 63 3d 3d 53 51 4c 49  em>0 && rc==SQLI
34d0: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69  TE_OK ){.      i
34e0: 6e 74 20 69 52 65 61 6c 4f 66 66 20 3d 20 70 52  nt iRealOff = pR
34f0: 65 61 6c 2d 3e 6e 42 6c 6f 62 20 2d 20 42 4c 4f  eal->nBlob - BLO
3500: 43 4b 53 49 5a 45 2a 28 28 69 69 2f 42 4c 4f 43  CKSIZE*((ii/BLOC
3510: 4b 53 49 5a 45 29 2b 31 29 20 2b 20 69 69 25 42  KSIZE)+1) + ii%B
3520: 4c 4f 43 4b 53 49 5a 45 3b 0a 20 20 20 20 20 20  LOCKSIZE;.      
3530: 69 6e 74 20 69 52 65 61 6c 41 6d 74 20 3d 20 4d  int iRealAmt = M
3540: 49 4e 28 69 52 65 6d 2c 20 42 4c 4f 43 4b 53 49  IN(iRem, BLOCKSI
3550: 5a 45 20 2d 20 28 69 52 65 61 6c 4f 66 66 25 42  ZE - (iRealOff%B
3560: 4c 4f 43 4b 53 49 5a 45 29 29 3b 0a 0a 20 20 20  LOCKSIZE));..   
3570: 20 20 20 72 63 20 3d 20 70 46 2d 3e 70 4d 65 74     rc = pF->pMet
3580: 68 6f 64 73 2d 3e 78 52 65 61 64 28 70 46 2c 20  hods->xRead(pF, 
3590: 26 28 28 63 68 61 72 20 2a 29 7a 42 75 66 29 5b  &((char *)zBuf)[
35a0: 69 42 75 66 5d 2c 20 69 52 65 61 6c 41 6d 74 2c  iBuf], iRealAmt,
35b0: 20 69 52 65 61 6c 4f 66 66 29 3b 0a 20 20 20 20   iRealOff);.    
35c0: 20 20 69 69 20 2b 3d 20 69 52 65 61 6c 41 6d 74    ii += iRealAmt
35d0: 3b 0a 20 20 20 20 20 20 69 42 75 66 20 2b 3d 20  ;.      iBuf += 
35e0: 69 52 65 61 6c 41 6d 74 3b 0a 20 20 20 20 20 20  iRealAmt;.      
35f0: 69 52 65 6d 20 2d 3d 20 69 52 65 61 6c 41 6d 74  iRem -= iRealAmt
3600: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 72  ;.    }.  }..  r
3610: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
3620: 2a 2a 20 57 72 69 74 65 20 64 61 74 61 20 74 6f  ** Write data to
3630: 20 61 6e 20 66 73 2d 66 69 6c 65 2e 0a 2a 2f 0a   an fs-file..*/.
3640: 73 74 61 74 69 63 20 69 6e 74 20 66 73 57 72 69  static int fsWri
3650: 74 65 28 0a 20 20 73 71 6c 69 74 65 33 5f 66 69  te(.  sqlite3_fi
3660: 6c 65 20 2a 70 46 69 6c 65 2c 20 0a 20 20 63 6f  le *pFile, .  co
3670: 6e 73 74 20 76 6f 69 64 20 2a 7a 42 75 66 2c 20  nst void *zBuf, 
3680: 0a 20 20 69 6e 74 20 69 41 6d 74 2c 20 0a 20 20  .  int iAmt, .  
3690: 73 71 6c 69 74 65 5f 69 6e 74 36 34 20 69 4f 66  sqlite_int64 iOf
36a0: 73 74 0a 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d  st.){.  int rc =
36b0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 66 73   SQLITE_OK;.  fs
36c0: 5f 66 69 6c 65 20 2a 70 20 3d 20 28 66 73 5f 66  _file *p = (fs_f
36d0: 69 6c 65 20 2a 29 70 46 69 6c 65 3b 0a 20 20 66  ile *)pFile;.  f
36e0: 73 5f 72 65 61 6c 5f 66 69 6c 65 20 2a 70 52 65  s_real_file *pRe
36f0: 61 6c 20 3d 20 70 2d 3e 70 52 65 61 6c 3b 0a 20  al = p->pReal;. 
3700: 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70   sqlite3_file *p
3710: 46 20 3d 20 70 52 65 61 6c 2d 3e 70 46 69 6c 65  F = pReal->pFile
3720: 3b 0a 0a 20 20 69 66 28 20 70 2d 3e 65 54 79 70  ;..  if( p->eTyp
3730: 65 3d 3d 44 41 54 41 42 41 53 45 5f 46 49 4c 45  e==DATABASE_FILE
3740: 20 29 7b 0a 20 20 20 20 69 66 28 20 28 69 41 6d   ){.    if( (iAm
3750: 74 2b 69 4f 66 73 74 2b 42 4c 4f 43 4b 53 49 5a  t+iOfst+BLOCKSIZ
3760: 45 29 3e 28 70 52 65 61 6c 2d 3e 6e 42 6c 6f 62  E)>(pReal->nBlob
3770: 2d 70 52 65 61 6c 2d 3e 6e 4a 6f 75 72 6e 61 6c  -pReal->nJournal
3780: 29 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20  ) ){.      rc = 
3790: 53 51 4c 49 54 45 5f 46 55 4c 4c 3b 0a 20 20 20  SQLITE_FULL;.   
37a0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 63   }else{.      rc
37b0: 20 3d 20 70 46 2d 3e 70 4d 65 74 68 6f 64 73 2d   = pF->pMethods-
37c0: 3e 78 57 72 69 74 65 28 70 46 2c 20 7a 42 75 66  >xWrite(pF, zBuf
37d0: 2c 20 69 41 6d 74 2c 20 69 4f 66 73 74 2b 42 4c  , iAmt, iOfst+BL
37e0: 4f 43 4b 53 49 5a 45 29 3b 0a 20 20 20 20 20 20  OCKSIZE);.      
37f0: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
3800: 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 70 52 65  K ){.        pRe
3810: 61 6c 2d 3e 6e 44 61 74 61 62 61 73 65 20 3d 20  al->nDatabase = 
3820: 28 69 6e 74 29 4d 41 58 28 70 52 65 61 6c 2d 3e  (int)MAX(pReal->
3830: 6e 44 61 74 61 62 61 73 65 2c 20 69 41 6d 74 2b  nDatabase, iAmt+
3840: 69 4f 66 73 74 29 3b 0a 20 20 20 20 20 20 7d 0a  iOfst);.      }.
3850: 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20      }.  }else{. 
3860: 20 20 20 2f 2a 20 4a 6f 75 72 6e 61 6c 20 66 69     /* Journal fi
3870: 6c 65 2e 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69  le. */.    int i
3880: 52 65 6d 20 3d 20 69 41 6d 74 3b 0a 20 20 20 20  Rem = iAmt;.    
3890: 69 6e 74 20 69 42 75 66 20 3d 20 30 3b 0a 20 20  int iBuf = 0;.  
38a0: 20 20 69 6e 74 20 69 69 20 3d 20 28 69 6e 74 29    int ii = (int)
38b0: 69 4f 66 73 74 3b 0a 20 20 20 20 77 68 69 6c 65  iOfst;.    while
38c0: 28 20 69 52 65 6d 3e 30 20 26 26 20 72 63 3d 3d  ( iRem>0 && rc==
38d0: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
38e0: 20 20 20 69 6e 74 20 69 52 65 61 6c 4f 66 66 20     int iRealOff 
38f0: 3d 20 70 52 65 61 6c 2d 3e 6e 42 6c 6f 62 20 2d  = pReal->nBlob -
3900: 20 42 4c 4f 43 4b 53 49 5a 45 2a 28 28 69 69 2f   BLOCKSIZE*((ii/
3910: 42 4c 4f 43 4b 53 49 5a 45 29 2b 31 29 20 2b 20  BLOCKSIZE)+1) + 
3920: 69 69 25 42 4c 4f 43 4b 53 49 5a 45 3b 0a 20 20  ii%BLOCKSIZE;.  
3930: 20 20 20 20 69 6e 74 20 69 52 65 61 6c 41 6d 74      int iRealAmt
3940: 20 3d 20 4d 49 4e 28 69 52 65 6d 2c 20 42 4c 4f   = MIN(iRem, BLO
3950: 43 4b 53 49 5a 45 20 2d 20 28 69 52 65 61 6c 4f  CKSIZE - (iRealO
3960: 66 66 25 42 4c 4f 43 4b 53 49 5a 45 29 29 3b 0a  ff%BLOCKSIZE));.
3970: 0a 20 20 20 20 20 20 69 66 28 20 69 52 65 61 6c  .      if( iReal
3980: 4f 66 66 3c 28 70 52 65 61 6c 2d 3e 6e 44 61 74  Off<(pReal->nDat
3990: 61 62 61 73 65 2b 42 4c 4f 43 4b 53 49 5a 45 29  abase+BLOCKSIZE)
39a0: 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d   ){.        rc =
39b0: 20 53 51 4c 49 54 45 5f 46 55 4c 4c 3b 0a 20 20   SQLITE_FULL;.  
39c0: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
39d0: 20 20 20 72 63 20 3d 20 70 46 2d 3e 70 4d 65 74     rc = pF->pMet
39e0: 68 6f 64 73 2d 3e 78 57 72 69 74 65 28 70 46 2c  hods->xWrite(pF,
39f0: 20 26 28 28 63 68 61 72 20 2a 29 7a 42 75 66 29   &((char *)zBuf)
3a00: 5b 69 42 75 66 5d 2c 20 69 52 65 61 6c 41 6d 74  [iBuf], iRealAmt
3a10: 2c 69 52 65 61 6c 4f 66 66 29 3b 0a 20 20 20 20  ,iRealOff);.    
3a20: 20 20 20 20 69 69 20 2b 3d 20 69 52 65 61 6c 41      ii += iRealA
3a30: 6d 74 3b 0a 20 20 20 20 20 20 20 20 69 42 75 66  mt;.        iBuf
3a40: 20 2b 3d 20 69 52 65 61 6c 41 6d 74 3b 0a 20 20   += iRealAmt;.  
3a50: 20 20 20 20 20 20 69 52 65 6d 20 2d 3d 20 69 52        iRem -= iR
3a60: 65 61 6c 41 6d 74 3b 0a 20 20 20 20 20 20 7d 0a  ealAmt;.      }.
3a70: 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63      }.    if( rc
3a80: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  ==SQLITE_OK ){. 
3a90: 20 20 20 20 20 70 52 65 61 6c 2d 3e 6e 4a 6f 75       pReal->nJou
3aa0: 72 6e 61 6c 20 3d 20 28 69 6e 74 29 4d 41 58 28  rnal = (int)MAX(
3ab0: 70 52 65 61 6c 2d 3e 6e 4a 6f 75 72 6e 61 6c 2c  pReal->nJournal,
3ac0: 20 69 41 6d 74 2b 69 4f 66 73 74 29 3b 0a 20 20   iAmt+iOfst);.  
3ad0: 20 20 7d 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72    }.  }..  retur
3ae0: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  n rc;.}../*.** T
3af0: 72 75 6e 63 61 74 65 20 61 6e 20 66 73 2d 66 69  runcate an fs-fi
3b00: 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  le..*/.static in
3b10: 74 20 66 73 54 72 75 6e 63 61 74 65 28 73 71 6c  t fsTruncate(sql
3b20: 69 74 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65  ite3_file *pFile
3b30: 2c 20 73 71 6c 69 74 65 5f 69 6e 74 36 34 20 73  , sqlite_int64 s
3b40: 69 7a 65 29 7b 0a 20 20 66 73 5f 66 69 6c 65 20  ize){.  fs_file 
3b50: 2a 70 20 3d 20 28 66 73 5f 66 69 6c 65 20 2a 29  *p = (fs_file *)
3b60: 70 46 69 6c 65 3b 0a 20 20 66 73 5f 72 65 61 6c  pFile;.  fs_real
3b70: 5f 66 69 6c 65 20 2a 70 52 65 61 6c 20 3d 20 70  _file *pReal = p
3b80: 2d 3e 70 52 65 61 6c 3b 0a 20 20 69 66 28 20 70  ->pReal;.  if( p
3b90: 2d 3e 65 54 79 70 65 3d 3d 44 41 54 41 42 41 53  ->eType==DATABAS
3ba0: 45 5f 46 49 4c 45 20 29 7b 0a 20 20 20 20 70 52  E_FILE ){.    pR
3bb0: 65 61 6c 2d 3e 6e 44 61 74 61 62 61 73 65 20 3d  eal->nDatabase =
3bc0: 20 28 69 6e 74 29 4d 49 4e 28 70 52 65 61 6c 2d   (int)MIN(pReal-
3bd0: 3e 6e 44 61 74 61 62 61 73 65 2c 20 73 69 7a 65  >nDatabase, size
3be0: 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  );.  }else{.    
3bf0: 70 52 65 61 6c 2d 3e 6e 4a 6f 75 72 6e 61 6c 20  pReal->nJournal 
3c00: 3d 20 28 69 6e 74 29 4d 49 4e 28 70 52 65 61 6c  = (int)MIN(pReal
3c10: 2d 3e 6e 4a 6f 75 72 6e 61 6c 2c 20 73 69 7a 65  ->nJournal, size
3c20: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  );.  }.  return 
3c30: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a  SQLITE_OK;.}../*
3c40: 0a 2a 2a 20 53 79 6e 63 20 61 6e 20 66 73 2d 66  .** Sync an fs-f
3c50: 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ile..*/.static i
3c60: 6e 74 20 66 73 53 79 6e 63 28 73 71 6c 69 74 65  nt fsSync(sqlite
3c70: 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65 2c 20 69  3_file *pFile, i
3c80: 6e 74 20 66 6c 61 67 73 29 7b 0a 20 20 66 73 5f  nt flags){.  fs_
3c90: 66 69 6c 65 20 2a 70 20 3d 20 28 66 73 5f 66 69  file *p = (fs_fi
3ca0: 6c 65 20 2a 29 70 46 69 6c 65 3b 0a 20 20 66 73  le *)pFile;.  fs
3cb0: 5f 72 65 61 6c 5f 66 69 6c 65 20 2a 70 52 65 61  _real_file *pRea
3cc0: 6c 20 3d 20 70 2d 3e 70 52 65 61 6c 3b 0a 20 20  l = p->pReal;.  
3cd0: 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 52  sqlite3_file *pR
3ce0: 65 61 6c 46 69 6c 65 20 3d 20 70 52 65 61 6c 2d  ealFile = pReal-
3cf0: 3e 70 46 69 6c 65 3b 0a 20 20 69 6e 74 20 72 63  >pFile;.  int rc
3d00: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20   = SQLITE_OK;.. 
3d10: 20 69 66 28 20 70 2d 3e 65 54 79 70 65 3d 3d 44   if( p->eType==D
3d20: 41 54 41 42 41 53 45 5f 46 49 4c 45 20 29 7b 0a  ATABASE_FILE ){.
3d30: 20 20 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61      unsigned cha
3d40: 72 20 7a 53 69 7a 65 5b 34 5d 3b 0a 20 20 20 20  r zSize[4];.    
3d50: 7a 53 69 7a 65 5b 30 5d 20 3d 20 28 70 52 65 61  zSize[0] = (pRea
3d60: 6c 2d 3e 6e 44 61 74 61 62 61 73 65 26 30 78 46  l->nDatabase&0xF
3d70: 46 30 30 30 30 30 30 29 3e 3e 32 34 3b 0a 20 20  F000000)>>24;.  
3d80: 20 20 7a 53 69 7a 65 5b 31 5d 20 3d 20 28 75 6e    zSize[1] = (un
3d90: 73 69 67 6e 65 64 20 63 68 61 72 29 28 28 70 52  signed char)((pR
3da0: 65 61 6c 2d 3e 6e 44 61 74 61 62 61 73 65 26 30  eal->nDatabase&0
3db0: 78 30 30 46 46 30 30 30 30 29 3e 3e 31 36 29 3b  x00FF0000)>>16);
3dc0: 0a 20 20 20 20 7a 53 69 7a 65 5b 32 5d 20 3d 20  .    zSize[2] = 
3dd0: 28 70 52 65 61 6c 2d 3e 6e 44 61 74 61 62 61 73  (pReal->nDatabas
3de0: 65 26 30 78 30 30 30 30 46 46 30 30 29 3e 3e 38  e&0x0000FF00)>>8
3df0: 3b 0a 20 20 20 20 7a 53 69 7a 65 5b 33 5d 20 3d  ;.    zSize[3] =
3e00: 20 28 70 52 65 61 6c 2d 3e 6e 44 61 74 61 62 61   (pReal->nDataba
3e10: 73 65 26 30 78 30 30 30 30 30 30 46 46 29 3b 0a  se&0x000000FF);.
3e20: 20 20 20 20 72 63 20 3d 20 70 52 65 61 6c 46 69      rc = pRealFi
3e30: 6c 65 2d 3e 70 4d 65 74 68 6f 64 73 2d 3e 78 57  le->pMethods->xW
3e40: 72 69 74 65 28 70 52 65 61 6c 46 69 6c 65 2c 20  rite(pRealFile, 
3e50: 7a 53 69 7a 65 2c 20 34 2c 20 30 29 3b 0a 20 20  zSize, 4, 0);.  
3e60: 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49  }.  if( rc==SQLI
3e70: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20  TE_OK ){.    rc 
3e80: 3d 20 70 52 65 61 6c 46 69 6c 65 2d 3e 70 4d 65  = pRealFile->pMe
3e90: 74 68 6f 64 73 2d 3e 78 53 79 6e 63 28 70 52 65  thods->xSync(pRe
3ea0: 61 6c 46 69 6c 65 2c 20 66 6c 61 67 73 26 28 7e  alFile, flags&(~
3eb0: 53 51 4c 49 54 45 5f 53 59 4e 43 5f 44 41 54 41  SQLITE_SYNC_DATA
3ec0: 4f 4e 4c 59 29 29 3b 0a 20 20 7d 0a 0a 20 20 72  ONLY));.  }..  r
3ed0: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
3ee0: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 63 75  ** Return the cu
3ef0: 72 72 65 6e 74 20 66 69 6c 65 2d 73 69 7a 65 20  rrent file-size 
3f00: 6f 66 20 61 6e 20 66 73 2d 66 69 6c 65 2e 0a 2a  of an fs-file..*
3f10: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 66 73 46  /.static int fsF
3f20: 69 6c 65 53 69 7a 65 28 73 71 6c 69 74 65 33 5f  ileSize(sqlite3_
3f30: 66 69 6c 65 20 2a 70 46 69 6c 65 2c 20 73 71 6c  file *pFile, sql
3f40: 69 74 65 5f 69 6e 74 36 34 20 2a 70 53 69 7a 65  ite_int64 *pSize
3f50: 29 7b 0a 20 20 66 73 5f 66 69 6c 65 20 2a 70 20  ){.  fs_file *p 
3f60: 3d 20 28 66 73 5f 66 69 6c 65 20 2a 29 70 46 69  = (fs_file *)pFi
3f70: 6c 65 3b 0a 20 20 66 73 5f 72 65 61 6c 5f 66 69  le;.  fs_real_fi
3f80: 6c 65 20 2a 70 52 65 61 6c 20 3d 20 70 2d 3e 70  le *pReal = p->p
3f90: 52 65 61 6c 3b 0a 20 20 69 66 28 20 70 2d 3e 65  Real;.  if( p->e
3fa0: 54 79 70 65 3d 3d 44 41 54 41 42 41 53 45 5f 46  Type==DATABASE_F
3fb0: 49 4c 45 20 29 7b 0a 20 20 20 20 2a 70 53 69 7a  ILE ){.    *pSiz
3fc0: 65 20 3d 20 70 52 65 61 6c 2d 3e 6e 44 61 74 61  e = pReal->nData
3fd0: 62 61 73 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  base;.  }else{. 
3fe0: 20 20 20 2a 70 53 69 7a 65 20 3d 20 70 52 65 61     *pSize = pRea
3ff0: 6c 2d 3e 6e 4a 6f 75 72 6e 61 6c 3b 0a 20 20 7d  l->nJournal;.  }
4000: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
4010: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4c 6f  _OK;.}../*.** Lo
4020: 63 6b 20 61 6e 20 66 73 2d 66 69 6c 65 2e 0a 2a  ck an fs-file..*
4030: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 66 73 4c  /.static int fsL
4040: 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66 69 6c 65  ock(sqlite3_file
4050: 20 2a 70 46 69 6c 65 2c 20 69 6e 74 20 65 4c 6f   *pFile, int eLo
4060: 63 6b 29 7b 0a 20 20 72 65 74 75 72 6e 20 53 51  ck){.  return SQ
4070: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a  LITE_OK;.}../*.*
4080: 2a 20 55 6e 6c 6f 63 6b 20 61 6e 20 66 73 2d 66  * Unlock an fs-f
4090: 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ile..*/.static i
40a0: 6e 74 20 66 73 55 6e 6c 6f 63 6b 28 73 71 6c 69  nt fsUnlock(sqli
40b0: 74 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65 2c  te3_file *pFile,
40c0: 20 69 6e 74 20 65 4c 6f 63 6b 29 7b 0a 20 20 72   int eLock){.  r
40d0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
40e0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 65 63 6b 20  .}../*.** Check 
40f0: 69 66 20 61 6e 6f 74 68 65 72 20 66 69 6c 65 2d  if another file-
4100: 68 61 6e 64 6c 65 20 68 6f 6c 64 73 20 61 20 52  handle holds a R
4110: 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 6f 6e 20  ESERVED lock on 
4120: 61 6e 20 66 73 2d 66 69 6c 65 2e 0a 2a 2f 0a 73  an fs-file..*/.s
4130: 74 61 74 69 63 20 69 6e 74 20 66 73 43 68 65 63  tatic int fsChec
4140: 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b 28 73 71  kReservedLock(sq
4150: 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c  lite3_file *pFil
4160: 65 2c 20 69 6e 74 20 2a 70 52 65 73 4f 75 74 29  e, int *pResOut)
4170: 7b 0a 20 20 2a 70 52 65 73 4f 75 74 20 3d 20 30  {.  *pResOut = 0
4180: 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54  ;.  return SQLIT
4190: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46  E_OK;.}../*.** F
41a0: 69 6c 65 20 63 6f 6e 74 72 6f 6c 20 6d 65 74 68  ile control meth
41b0: 6f 64 2e 20 46 6f 72 20 63 75 73 74 6f 6d 20 6f  od. For custom o
41c0: 70 65 72 61 74 69 6f 6e 73 20 6f 6e 20 61 6e 20  perations on an 
41d0: 66 73 2d 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74  fs-file..*/.stat
41e0: 69 63 20 69 6e 74 20 66 73 46 69 6c 65 43 6f 6e  ic int fsFileCon
41f0: 74 72 6f 6c 28 73 71 6c 69 74 65 33 5f 66 69 6c  trol(sqlite3_fil
4200: 65 20 2a 70 46 69 6c 65 2c 20 69 6e 74 20 6f 70  e *pFile, int op
4210: 2c 20 76 6f 69 64 20 2a 70 41 72 67 29 7b 0a 20  , void *pArg){. 
4220: 20 69 66 28 20 6f 70 3d 3d 53 51 4c 49 54 45 5f   if( op==SQLITE_
4230: 46 43 4e 54 4c 5f 50 52 41 47 4d 41 20 29 20 72  FCNTL_PRAGMA ) r
4240: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 54  eturn SQLITE_NOT
4250: 46 4f 55 4e 44 3b 0a 20 20 72 65 74 75 72 6e 20  FOUND;.  return 
4260: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a  SQLITE_OK;.}../*
4270: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 73  .** Return the s
4280: 65 63 74 6f 72 2d 73 69 7a 65 20 69 6e 20 62 79  ector-size in by
4290: 74 65 73 20 66 6f 72 20 61 6e 20 66 73 2d 66 69  tes for an fs-fi
42a0: 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  le..*/.static in
42b0: 74 20 66 73 53 65 63 74 6f 72 53 69 7a 65 28 73  t fsSectorSize(s
42c0: 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 46 69  qlite3_file *pFi
42d0: 6c 65 29 7b 0a 20 20 72 65 74 75 72 6e 20 42 4c  le){.  return BL
42e0: 4f 43 4b 53 49 5a 45 3b 0a 7d 0a 0a 2f 2a 0a 2a  OCKSIZE;.}../*.*
42f0: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 64 65 76  * Return the dev
4300: 69 63 65 20 63 68 61 72 61 63 74 65 72 69 73 74  ice characterist
4310: 69 63 20 66 6c 61 67 73 20 73 75 70 70 6f 72 74  ic flags support
4320: 65 64 20 62 79 20 61 6e 20 66 73 2d 66 69 6c 65  ed by an fs-file
4330: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
4340: 66 73 44 65 76 69 63 65 43 68 61 72 61 63 74 65  fsDeviceCharacte
4350: 72 69 73 74 69 63 73 28 73 71 6c 69 74 65 33 5f  ristics(sqlite3_
4360: 66 69 6c 65 20 2a 70 46 69 6c 65 29 7b 0a 20 20  file *pFile){.  
4370: 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a  return 0;.}../*.
4380: 2a 2a 20 4f 70 65 6e 20 61 6e 20 66 73 20 66 69  ** Open an fs fi
4390: 6c 65 20 68 61 6e 64 6c 65 2e 0a 2a 2f 0a 73 74  le handle..*/.st
43a0: 61 74 69 63 20 69 6e 74 20 66 73 4f 70 65 6e 28  atic int fsOpen(
43b0: 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a  .  sqlite3_vfs *
43c0: 70 56 66 73 2c 0a 20 20 63 6f 6e 73 74 20 63 68  pVfs,.  const ch
43d0: 61 72 20 2a 7a 4e 61 6d 65 2c 0a 20 20 73 71 6c  ar *zName,.  sql
43e0: 69 74 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65  ite3_file *pFile
43f0: 2c 0a 20 20 69 6e 74 20 66 6c 61 67 73 2c 0a 20  ,.  int flags,. 
4400: 20 69 6e 74 20 2a 70 4f 75 74 46 6c 61 67 73 0a   int *pOutFlags.
4410: 29 7b 0a 20 20 66 73 5f 76 66 73 5f 74 20 2a 70  ){.  fs_vfs_t *p
4420: 46 73 56 66 73 20 3d 20 28 66 73 5f 76 66 73 5f  FsVfs = (fs_vfs_
4430: 74 20 2a 29 70 56 66 73 3b 0a 20 20 66 73 5f 66  t *)pVfs;.  fs_f
4440: 69 6c 65 20 2a 70 20 3d 20 28 66 73 5f 66 69 6c  ile *p = (fs_fil
4450: 65 20 2a 29 70 46 69 6c 65 3b 0a 20 20 66 73 5f  e *)pFile;.  fs_
4460: 72 65 61 6c 5f 66 69 6c 65 20 2a 70 52 65 61 6c  real_file *pReal
4470: 20 3d 20 30 3b 0a 20 20 69 6e 74 20 65 54 79 70   = 0;.  int eTyp
4480: 65 3b 0a 20 20 69 6e 74 20 6e 4e 61 6d 65 3b 0a  e;.  int nName;.
4490: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
44a0: 45 5f 4f 4b 3b 0a 0a 20 20 69 66 28 20 30 3d 3d  E_OK;..  if( 0==
44b0: 28 66 6c 61 67 73 26 28 53 51 4c 49 54 45 5f 4f  (flags&(SQLITE_O
44c0: 50 45 4e 5f 4d 41 49 4e 5f 44 42 7c 53 51 4c 49  PEN_MAIN_DB|SQLI
44d0: 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 4a 4f 55  TE_OPEN_MAIN_JOU
44e0: 52 4e 41 4c 29 29 20 29 7b 0a 20 20 20 20 74 6d  RNAL)) ){.    tm
44f0: 70 5f 66 69 6c 65 20 2a 70 32 20 3d 20 28 74 6d  p_file *p2 = (tm
4500: 70 5f 66 69 6c 65 20 2a 29 70 46 69 6c 65 3b 0a  p_file *)pFile;.
4510: 20 20 20 20 6d 65 6d 73 65 74 28 70 32 2c 20 30      memset(p2, 0
4520: 2c 20 73 69 7a 65 6f 66 28 2a 70 32 29 29 3b 0a  , sizeof(*p2));.
4530: 20 20 20 20 70 32 2d 3e 62 61 73 65 2e 70 4d 65      p2->base.pMe
4540: 74 68 6f 64 73 20 3d 20 26 74 6d 70 5f 69 6f 5f  thods = &tmp_io_
4550: 6d 65 74 68 6f 64 73 3b 0a 20 20 20 20 72 65 74  methods;.    ret
4560: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  urn SQLITE_OK;. 
4570: 20 7d 0a 0a 20 20 65 54 79 70 65 20 3d 20 28 28   }..  eType = ((
4580: 66 6c 61 67 73 26 28 53 51 4c 49 54 45 5f 4f 50  flags&(SQLITE_OP
4590: 45 4e 5f 4d 41 49 4e 5f 44 42 29 29 3f 44 41 54  EN_MAIN_DB))?DAT
45a0: 41 42 41 53 45 5f 46 49 4c 45 3a 4a 4f 55 52 4e  ABASE_FILE:JOURN
45b0: 41 4c 5f 46 49 4c 45 29 3b 0a 20 20 70 2d 3e 62  AL_FILE);.  p->b
45c0: 61 73 65 2e 70 4d 65 74 68 6f 64 73 20 3d 20 26  ase.pMethods = &
45d0: 66 73 5f 69 6f 5f 6d 65 74 68 6f 64 73 3b 0a 20  fs_io_methods;. 
45e0: 20 70 2d 3e 65 54 79 70 65 20 3d 20 65 54 79 70   p->eType = eTyp
45f0: 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 73 74 72  e;..  assert(str
4600: 6c 65 6e 28 22 2d 6a 6f 75 72 6e 61 6c 22 29 3d  len("-journal")=
4610: 3d 38 29 3b 0a 20 20 6e 4e 61 6d 65 20 3d 20 28  =8);.  nName = (
4620: 69 6e 74 29 73 74 72 6c 65 6e 28 7a 4e 61 6d 65  int)strlen(zName
4630: 29 2d 28 28 65 54 79 70 65 3d 3d 4a 4f 55 52 4e  )-((eType==JOURN
4640: 41 4c 5f 46 49 4c 45 29 3f 38 3a 30 29 3b 0a 20  AL_FILE)?8:0);. 
4650: 20 70 52 65 61 6c 3d 70 46 73 56 66 73 2d 3e 70   pReal=pFsVfs->p
4660: 46 69 6c 65 4c 69 73 74 3b 20 0a 20 20 66 6f 72  FileList; .  for
4670: 28 3b 20 70 52 65 61 6c 20 26 26 20 73 74 72 6e  (; pReal && strn
4680: 63 6d 70 28 70 52 65 61 6c 2d 3e 7a 4e 61 6d 65  cmp(pReal->zName
4690: 2c 20 7a 4e 61 6d 65 2c 20 6e 4e 61 6d 65 29 3b  , zName, nName);
46a0: 20 70 52 65 61 6c 3d 70 52 65 61 6c 2d 3e 70 4e   pReal=pReal->pN
46b0: 65 78 74 29 3b 0a 0a 20 20 69 66 28 20 21 70 52  ext);..  if( !pR
46c0: 65 61 6c 20 29 7b 0a 20 20 20 20 69 6e 74 20 72  eal ){.    int r
46d0: 65 61 6c 5f 66 6c 61 67 73 20 3d 20 28 66 6c 61  eal_flags = (fla
46e0: 67 73 26 7e 28 53 51 4c 49 54 45 5f 4f 50 45 4e  gs&~(SQLITE_OPEN
46f0: 5f 4d 41 49 4e 5f 44 42 29 29 7c 53 51 4c 49 54  _MAIN_DB))|SQLIT
4700: 45 5f 4f 50 45 4e 5f 54 45 4d 50 5f 44 42 3b 0a  E_OPEN_TEMP_DB;.
4710: 20 20 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36      sqlite3_int6
4720: 34 20 73 69 7a 65 3b 0a 20 20 20 20 73 71 6c 69  4 size;.    sqli
4730: 74 65 33 5f 66 69 6c 65 20 2a 70 52 65 61 6c 46  te3_file *pRealF
4740: 69 6c 65 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  ile;.    sqlite3
4750: 5f 76 66 73 20 2a 70 50 61 72 65 6e 74 20 3d 20  _vfs *pParent = 
4760: 70 46 73 56 66 73 2d 3e 70 50 61 72 65 6e 74 3b  pFsVfs->pParent;
4770: 0a 20 20 20 20 61 73 73 65 72 74 28 65 54 79 70  .    assert(eTyp
4780: 65 3d 3d 44 41 54 41 42 41 53 45 5f 46 49 4c 45  e==DATABASE_FILE
4790: 29 3b 0a 0a 20 20 20 20 70 52 65 61 6c 20 3d 20  );..    pReal = 
47a0: 28 66 73 5f 72 65 61 6c 5f 66 69 6c 65 20 2a 29  (fs_real_file *)
47b0: 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 73  sqlite3_malloc(s
47c0: 69 7a 65 6f 66 28 2a 70 52 65 61 6c 29 2b 70 50  izeof(*pReal)+pP
47d0: 61 72 65 6e 74 2d 3e 73 7a 4f 73 46 69 6c 65 29  arent->szOsFile)
47e0: 3b 0a 20 20 20 20 69 66 28 20 21 70 52 65 61 6c  ;.    if( !pReal
47f0: 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53   ){.      rc = S
4800: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20  QLITE_NOMEM;.   
4810: 20 20 20 67 6f 74 6f 20 6f 70 65 6e 5f 6f 75 74     goto open_out
4820: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6d 65 6d 73  ;.    }.    mems
4830: 65 74 28 70 52 65 61 6c 2c 20 30 2c 20 73 69 7a  et(pReal, 0, siz
4840: 65 6f 66 28 2a 70 52 65 61 6c 29 2b 70 50 61 72  eof(*pReal)+pPar
4850: 65 6e 74 2d 3e 73 7a 4f 73 46 69 6c 65 29 3b 0a  ent->szOsFile);.
4860: 20 20 20 20 70 52 65 61 6c 2d 3e 7a 4e 61 6d 65      pReal->zName
4870: 20 3d 20 7a 4e 61 6d 65 3b 0a 20 20 20 20 70 52   = zName;.    pR
4880: 65 61 6c 2d 3e 70 46 69 6c 65 20 3d 20 28 73 71  eal->pFile = (sq
4890: 6c 69 74 65 33 5f 66 69 6c 65 20 2a 29 28 26 70  lite3_file *)(&p
48a0: 52 65 61 6c 5b 31 5d 29 3b 0a 0a 20 20 20 20 72  Real[1]);..    r
48b0: 63 20 3d 20 70 50 61 72 65 6e 74 2d 3e 78 4f 70  c = pParent->xOp
48c0: 65 6e 28 70 50 61 72 65 6e 74 2c 20 7a 4e 61 6d  en(pParent, zNam
48d0: 65 2c 20 70 52 65 61 6c 2d 3e 70 46 69 6c 65 2c  e, pReal->pFile,
48e0: 20 72 65 61 6c 5f 66 6c 61 67 73 2c 20 70 4f 75   real_flags, pOu
48f0: 74 46 6c 61 67 73 29 3b 0a 20 20 20 20 69 66 28  tFlags);.    if(
4900: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc!=SQLITE_OK )
4910: 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 6f 70 65  {.      goto ope
4920: 6e 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20  n_out;.    }.   
4930: 20 70 52 65 61 6c 46 69 6c 65 20 3d 20 70 52 65   pRealFile = pRe
4940: 61 6c 2d 3e 70 46 69 6c 65 3b 0a 0a 20 20 20 20  al->pFile;..    
4950: 72 63 20 3d 20 70 52 65 61 6c 46 69 6c 65 2d 3e  rc = pRealFile->
4960: 70 4d 65 74 68 6f 64 73 2d 3e 78 46 69 6c 65 53  pMethods->xFileS
4970: 69 7a 65 28 70 52 65 61 6c 46 69 6c 65 2c 20 26  ize(pRealFile, &
4980: 73 69 7a 65 29 3b 0a 20 20 20 20 69 66 28 20 72  size);.    if( r
4990: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c!=SQLITE_OK ){.
49a0: 20 20 20 20 20 20 67 6f 74 6f 20 6f 70 65 6e 5f        goto open_
49b0: 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69  out;.    }.    i
49c0: 66 28 20 73 69 7a 65 3d 3d 30 20 29 7b 0a 20 20  f( size==0 ){.  
49d0: 20 20 20 20 72 63 20 3d 20 70 52 65 61 6c 46 69      rc = pRealFi
49e0: 6c 65 2d 3e 70 4d 65 74 68 6f 64 73 2d 3e 78 57  le->pMethods->xW
49f0: 72 69 74 65 28 70 52 65 61 6c 46 69 6c 65 2c 20  rite(pRealFile, 
4a00: 22 5c 30 22 2c 20 31 2c 20 42 4c 4f 42 53 49 5a  "\0", 1, BLOBSIZ
4a10: 45 2d 31 29 3b 0a 20 20 20 20 20 20 70 52 65 61  E-1);.      pRea
4a20: 6c 2d 3e 6e 42 6c 6f 62 20 3d 20 42 4c 4f 42 53  l->nBlob = BLOBS
4a30: 49 5a 45 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a  IZE;.    }else{.
4a40: 20 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 63        unsigned c
4a50: 68 61 72 20 7a 53 5b 34 5d 3b 0a 20 20 20 20 20  har zS[4];.     
4a60: 20 70 52 65 61 6c 2d 3e 6e 42 6c 6f 62 20 3d 20   pReal->nBlob = 
4a70: 28 69 6e 74 29 73 69 7a 65 3b 0a 20 20 20 20 20  (int)size;.     
4a80: 20 72 63 20 3d 20 70 52 65 61 6c 46 69 6c 65 2d   rc = pRealFile-
4a90: 3e 70 4d 65 74 68 6f 64 73 2d 3e 78 52 65 61 64  >pMethods->xRead
4aa0: 28 70 52 65 61 6c 46 69 6c 65 2c 20 7a 53 2c 20  (pRealFile, zS, 
4ab0: 34 2c 20 30 29 3b 0a 20 20 20 20 20 20 70 52 65  4, 0);.      pRe
4ac0: 61 6c 2d 3e 6e 44 61 74 61 62 61 73 65 20 3d 20  al->nDatabase = 
4ad0: 28 7a 53 5b 30 5d 3c 3c 32 34 29 2b 28 7a 53 5b  (zS[0]<<24)+(zS[
4ae0: 31 5d 3c 3c 31 36 29 2b 28 7a 53 5b 32 5d 3c 3c  1]<<16)+(zS[2]<<
4af0: 38 29 2b 7a 53 5b 33 5d 3b 0a 20 20 20 20 20 20  8)+zS[3];.      
4b00: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
4b10: 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20  K ){.        rc 
4b20: 3d 20 70 52 65 61 6c 46 69 6c 65 2d 3e 70 4d 65  = pRealFile->pMe
4b30: 74 68 6f 64 73 2d 3e 78 52 65 61 64 28 70 52 65  thods->xRead(pRe
4b40: 61 6c 46 69 6c 65 2c 20 7a 53 2c 20 34 2c 20 70  alFile, zS, 4, p
4b50: 52 65 61 6c 2d 3e 6e 42 6c 6f 62 2d 34 29 3b 0a  Real->nBlob-4);.
4b60: 20 20 20 20 20 20 20 20 69 66 28 20 7a 53 5b 30          if( zS[0
4b70: 5d 20 7c 7c 20 7a 53 5b 31 5d 20 7c 7c 20 7a 53  ] || zS[1] || zS
4b80: 5b 32 5d 20 7c 7c 20 7a 53 5b 33 5d 20 29 7b 0a  [2] || zS[3] ){.
4b90: 20 20 20 20 20 20 20 20 20 20 70 52 65 61 6c 2d            pReal-
4ba0: 3e 6e 4a 6f 75 72 6e 61 6c 20 3d 20 70 52 65 61  >nJournal = pRea
4bb0: 6c 2d 3e 6e 42 6c 6f 62 3b 0a 20 20 20 20 20 20  l->nBlob;.      
4bc0: 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20    }.      }.    
4bd0: 7d 0a 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53  }..    if( rc==S
4be0: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
4bf0: 20 20 70 52 65 61 6c 2d 3e 70 4e 65 78 74 20 3d    pReal->pNext =
4c00: 20 70 46 73 56 66 73 2d 3e 70 46 69 6c 65 4c 69   pFsVfs->pFileLi
4c10: 73 74 3b 0a 20 20 20 20 20 20 69 66 28 20 70 52  st;.      if( pR
4c20: 65 61 6c 2d 3e 70 4e 65 78 74 20 29 7b 0a 20 20  eal->pNext ){.  
4c30: 20 20 20 20 20 20 70 52 65 61 6c 2d 3e 70 4e 65        pReal->pNe
4c40: 78 74 2d 3e 70 70 54 68 69 73 20 3d 20 26 70 52  xt->ppThis = &pR
4c50: 65 61 6c 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20  eal->pNext;.    
4c60: 20 20 7d 0a 20 20 20 20 20 20 70 52 65 61 6c 2d    }.      pReal-
4c70: 3e 70 70 54 68 69 73 20 3d 20 26 70 46 73 56 66  >ppThis = &pFsVf
4c80: 73 2d 3e 70 46 69 6c 65 4c 69 73 74 3b 0a 20 20  s->pFileList;.  
4c90: 20 20 20 20 70 46 73 56 66 73 2d 3e 70 46 69 6c      pFsVfs->pFil
4ca0: 65 4c 69 73 74 20 3d 20 70 52 65 61 6c 3b 0a 20  eList = pReal;. 
4cb0: 20 20 20 7d 0a 20 20 7d 0a 0a 6f 70 65 6e 5f 6f     }.  }..open_o
4cc0: 75 74 3a 0a 20 20 69 66 28 20 70 52 65 61 6c 20  ut:.  if( pReal 
4cd0: 29 7b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53  ){.    if( rc==S
4ce0: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
4cf0: 20 20 70 2d 3e 70 52 65 61 6c 20 3d 20 70 52 65    p->pReal = pRe
4d00: 61 6c 3b 0a 20 20 20 20 20 20 70 52 65 61 6c 2d  al;.      pReal-
4d10: 3e 6e 52 65 66 2b 2b 3b 0a 20 20 20 20 7d 65 6c  >nRef++;.    }el
4d20: 73 65 7b 0a 20 20 20 20 20 20 69 66 28 20 70 52  se{.      if( pR
4d30: 65 61 6c 2d 3e 70 46 69 6c 65 2d 3e 70 4d 65 74  eal->pFile->pMet
4d40: 68 6f 64 73 20 29 7b 0a 20 20 20 20 20 20 20 20  hods ){.        
4d50: 70 52 65 61 6c 2d 3e 70 46 69 6c 65 2d 3e 70 4d  pReal->pFile->pM
4d60: 65 74 68 6f 64 73 2d 3e 78 43 6c 6f 73 65 28 70  ethods->xClose(p
4d70: 52 65 61 6c 2d 3e 70 46 69 6c 65 29 3b 0a 20 20  Real->pFile);.  
4d80: 20 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c 69      }.      sqli
4d90: 74 65 33 5f 66 72 65 65 28 70 52 65 61 6c 29 3b  te3_free(pReal);
4da0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74  .    }.  }.  ret
4db0: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  urn rc;.}../*.**
4dc0: 20 44 65 6c 65 74 65 20 74 68 65 20 66 69 6c 65   Delete the file
4dd0: 20 6c 6f 63 61 74 65 64 20 61 74 20 7a 50 61 74   located at zPat
4de0: 68 2e 20 49 66 20 74 68 65 20 64 69 72 53 79 6e  h. If the dirSyn
4df0: 63 20 61 72 67 75 6d 65 6e 74 20 69 73 20 74 72  c argument is tr
4e00: 75 65 2c 0a 2a 2a 20 65 6e 73 75 72 65 20 74 68  ue,.** ensure th
4e10: 65 20 66 69 6c 65 2d 73 79 73 74 65 6d 20 6d 6f  e file-system mo
4e20: 64 69 66 69 63 61 74 69 6f 6e 73 20 61 72 65 20  difications are 
4e30: 73 79 6e 63 65 64 20 74 6f 20 64 69 73 6b 20 62  synced to disk b
4e40: 65 66 6f 72 65 0a 2a 2a 20 72 65 74 75 72 6e 69  efore.** returni
4e50: 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  ng..*/.static in
4e60: 74 20 66 73 44 65 6c 65 74 65 28 73 71 6c 69 74  t fsDelete(sqlit
4e70: 65 33 5f 76 66 73 20 2a 70 56 66 73 2c 20 63 6f  e3_vfs *pVfs, co
4e80: 6e 73 74 20 63 68 61 72 20 2a 7a 50 61 74 68 2c  nst char *zPath,
4e90: 20 69 6e 74 20 64 69 72 53 79 6e 63 29 7b 0a 20   int dirSync){. 
4ea0: 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45   int rc = SQLITE
4eb0: 5f 4f 4b 3b 0a 20 20 66 73 5f 76 66 73 5f 74 20  _OK;.  fs_vfs_t 
4ec0: 2a 70 46 73 56 66 73 20 3d 20 28 66 73 5f 76 66  *pFsVfs = (fs_vf
4ed0: 73 5f 74 20 2a 29 70 56 66 73 3b 0a 20 20 66 73  s_t *)pVfs;.  fs
4ee0: 5f 72 65 61 6c 5f 66 69 6c 65 20 2a 70 52 65 61  _real_file *pRea
4ef0: 6c 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 6c  l;.  sqlite3_fil
4f00: 65 20 2a 70 46 3b 0a 20 20 69 6e 74 20 6e 4e 61  e *pF;.  int nNa
4f10: 6d 65 20 3d 20 28 69 6e 74 29 73 74 72 6c 65 6e  me = (int)strlen
4f20: 28 7a 50 61 74 68 29 20 2d 20 38 3b 0a 0a 20 20  (zPath) - 8;..  
4f30: 61 73 73 65 72 74 28 73 74 72 6c 65 6e 28 22 2d  assert(strlen("-
4f40: 6a 6f 75 72 6e 61 6c 22 29 3d 3d 38 29 3b 0a 20  journal")==8);. 
4f50: 20 61 73 73 65 72 74 28 73 74 72 63 6d 70 28 22   assert(strcmp("
4f60: 2d 6a 6f 75 72 6e 61 6c 22 2c 20 26 7a 50 61 74  -journal", &zPat
4f70: 68 5b 6e 4e 61 6d 65 5d 29 3d 3d 30 29 3b 0a 0a  h[nName])==0);..
4f80: 20 20 70 52 65 61 6c 20 3d 20 70 46 73 56 66 73    pReal = pFsVfs
4f90: 2d 3e 70 46 69 6c 65 4c 69 73 74 3b 20 0a 20 20  ->pFileList; .  
4fa0: 66 6f 72 28 3b 20 70 52 65 61 6c 20 26 26 20 73  for(; pReal && s
4fb0: 74 72 6e 63 6d 70 28 70 52 65 61 6c 2d 3e 7a 4e  trncmp(pReal->zN
4fc0: 61 6d 65 2c 20 7a 50 61 74 68 2c 20 6e 4e 61 6d  ame, zPath, nNam
4fd0: 65 29 3b 20 70 52 65 61 6c 3d 70 52 65 61 6c 2d  e); pReal=pReal-
4fe0: 3e 70 4e 65 78 74 29 3b 0a 20 20 69 66 28 20 70  >pNext);.  if( p
4ff0: 52 65 61 6c 20 29 7b 0a 20 20 20 20 70 46 20 3d  Real ){.    pF =
5000: 20 70 52 65 61 6c 2d 3e 70 46 69 6c 65 3b 0a 20   pReal->pFile;. 
5010: 20 20 20 72 63 20 3d 20 70 46 2d 3e 70 4d 65 74     rc = pF->pMet
5020: 68 6f 64 73 2d 3e 78 57 72 69 74 65 28 70 46 2c  hods->xWrite(pF,
5030: 20 22 5c 30 5c 30 5c 30 5c 30 22 2c 20 34 2c 20   "\0\0\0\0", 4, 
5040: 70 52 65 61 6c 2d 3e 6e 42 6c 6f 62 2d 42 4c 4f  pReal->nBlob-BLO
5050: 43 4b 53 49 5a 45 29 3b 0a 20 20 20 20 69 66 28  CKSIZE);.    if(
5060: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc==SQLITE_OK )
5070: 7b 0a 20 20 20 20 20 20 70 52 65 61 6c 2d 3e 6e  {.      pReal->n
5080: 4a 6f 75 72 6e 61 6c 20 3d 20 30 3b 0a 20 20 20  Journal = 0;.   
5090: 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20   }.  }.  return 
50a0: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 65 73  rc;.}../*.** Tes
50b0: 74 20 66 6f 72 20 61 63 63 65 73 73 20 70 65 72  t for access per
50c0: 6d 69 73 73 69 6f 6e 73 2e 20 52 65 74 75 72 6e  missions. Return
50d0: 20 74 72 75 65 20 69 66 20 74 68 65 20 72 65 71   true if the req
50e0: 75 65 73 74 65 64 20 70 65 72 6d 69 73 73 69 6f  uested permissio
50f0: 6e 0a 2a 2a 20 69 73 20 61 76 61 69 6c 61 62 6c  n.** is availabl
5100: 65 2c 20 6f 72 20 66 61 6c 73 65 20 6f 74 68 65  e, or false othe
5110: 72 77 69 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63  rwise..*/.static
5120: 20 69 6e 74 20 66 73 41 63 63 65 73 73 28 0a 20   int fsAccess(. 
5130: 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56   sqlite3_vfs *pV
5140: 66 73 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68 61  fs, .  const cha
5150: 72 20 2a 7a 50 61 74 68 2c 20 0a 20 20 69 6e 74  r *zPath, .  int
5160: 20 66 6c 61 67 73 2c 20 0a 20 20 69 6e 74 20 2a   flags, .  int *
5170: 70 52 65 73 4f 75 74 0a 29 7b 0a 20 20 66 73 5f  pResOut.){.  fs_
5180: 76 66 73 5f 74 20 2a 70 46 73 56 66 73 20 3d 20  vfs_t *pFsVfs = 
5190: 28 66 73 5f 76 66 73 5f 74 20 2a 29 70 56 66 73  (fs_vfs_t *)pVfs
51a0: 3b 0a 20 20 66 73 5f 72 65 61 6c 5f 66 69 6c 65  ;.  fs_real_file
51b0: 20 2a 70 52 65 61 6c 3b 0a 20 20 69 6e 74 20 69   *pReal;.  int i
51c0: 73 4a 6f 75 72 6e 61 6c 20 3d 20 30 3b 0a 20 20  sJournal = 0;.  
51d0: 69 6e 74 20 6e 4e 61 6d 65 20 3d 20 28 69 6e 74  int nName = (int
51e0: 29 73 74 72 6c 65 6e 28 7a 50 61 74 68 29 3b 0a  )strlen(zPath);.
51f0: 0a 20 20 69 66 28 20 66 6c 61 67 73 21 3d 53 51  .  if( flags!=SQ
5200: 4c 49 54 45 5f 41 43 43 45 53 53 5f 45 58 49 53  LITE_ACCESS_EXIS
5210: 54 53 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  TS ){.    sqlite
5220: 33 5f 76 66 73 20 2a 70 50 61 72 65 6e 74 20 3d  3_vfs *pParent =
5230: 20 28 28 66 73 5f 76 66 73 5f 74 20 2a 29 70 56   ((fs_vfs_t *)pV
5240: 66 73 29 2d 3e 70 50 61 72 65 6e 74 3b 0a 20 20  fs)->pParent;.  
5250: 20 20 72 65 74 75 72 6e 20 70 50 61 72 65 6e 74    return pParent
5260: 2d 3e 78 41 63 63 65 73 73 28 70 50 61 72 65 6e  ->xAccess(pParen
5270: 74 2c 20 7a 50 61 74 68 2c 20 66 6c 61 67 73 2c  t, zPath, flags,
5280: 20 70 52 65 73 4f 75 74 29 3b 0a 20 20 7d 0a 0a   pResOut);.  }..
5290: 20 20 61 73 73 65 72 74 28 73 74 72 6c 65 6e 28    assert(strlen(
52a0: 22 2d 6a 6f 75 72 6e 61 6c 22 29 3d 3d 38 29 3b  "-journal")==8);
52b0: 0a 20 20 69 66 28 20 6e 4e 61 6d 65 3e 38 20 26  .  if( nName>8 &
52c0: 26 20 73 74 72 63 6d 70 28 22 2d 6a 6f 75 72 6e  & strcmp("-journ
52d0: 61 6c 22 2c 20 26 7a 50 61 74 68 5b 6e 4e 61 6d  al", &zPath[nNam
52e0: 65 2d 38 5d 29 3d 3d 30 20 29 7b 0a 20 20 20 20  e-8])==0 ){.    
52f0: 6e 4e 61 6d 65 20 2d 3d 20 38 3b 0a 20 20 20 20  nName -= 8;.    
5300: 69 73 4a 6f 75 72 6e 61 6c 20 3d 20 31 3b 0a 20  isJournal = 1;. 
5310: 20 7d 0a 0a 20 20 70 52 65 61 6c 20 3d 20 70 46   }..  pReal = pF
5320: 73 56 66 73 2d 3e 70 46 69 6c 65 4c 69 73 74 3b  sVfs->pFileList;
5330: 20 0a 20 20 66 6f 72 28 3b 20 70 52 65 61 6c 20   .  for(; pReal 
5340: 26 26 20 73 74 72 6e 63 6d 70 28 70 52 65 61 6c  && strncmp(pReal
5350: 2d 3e 7a 4e 61 6d 65 2c 20 7a 50 61 74 68 2c 20  ->zName, zPath, 
5360: 6e 4e 61 6d 65 29 3b 20 70 52 65 61 6c 3d 70 52  nName); pReal=pR
5370: 65 61 6c 2d 3e 70 4e 65 78 74 29 3b 0a 0a 20 20  eal->pNext);..  
5380: 2a 70 52 65 73 4f 75 74 20 3d 20 28 70 52 65 61  *pResOut = (pRea
5390: 6c 20 26 26 20 28 21 69 73 4a 6f 75 72 6e 61 6c  l && (!isJournal
53a0: 20 7c 7c 20 70 52 65 61 6c 2d 3e 6e 4a 6f 75 72   || pReal->nJour
53b0: 6e 61 6c 3e 30 29 29 3b 0a 20 20 72 65 74 75 72  nal>0));.  retur
53c0: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a  n SQLITE_OK;.}..
53d0: 2f 2a 0a 2a 2a 20 50 6f 70 75 6c 61 74 65 20 62  /*.** Populate b
53e0: 75 66 66 65 72 20 7a 4f 75 74 20 77 69 74 68 20  uffer zOut with 
53f0: 74 68 65 20 66 75 6c 6c 20 63 61 6e 6f 6e 69 63  the full canonic
5400: 61 6c 20 70 61 74 68 6e 61 6d 65 20 63 6f 72 72  al pathname corr
5410: 65 73 70 6f 6e 64 69 6e 67 0a 2a 2a 20 74 6f 20  esponding.** to 
5420: 74 68 65 20 70 61 74 68 6e 61 6d 65 20 69 6e 20  the pathname in 
5430: 7a 50 61 74 68 2e 20 7a 4f 75 74 20 69 73 20 67  zPath. zOut is g
5440: 75 61 72 61 6e 74 65 65 64 20 74 6f 20 70 6f 69  uaranteed to poi
5450: 6e 74 20 74 6f 20 61 20 62 75 66 66 65 72 0a 2a  nt to a buffer.*
5460: 2a 20 6f 66 20 61 74 20 6c 65 61 73 74 20 28 46  * of at least (F
5470: 53 5f 4d 41 58 5f 50 41 54 48 4e 41 4d 45 2b 31  S_MAX_PATHNAME+1
5480: 29 20 62 79 74 65 73 2e 0a 2a 2f 0a 73 74 61 74  ) bytes..*/.stat
5490: 69 63 20 69 6e 74 20 66 73 46 75 6c 6c 50 61 74  ic int fsFullPat
54a0: 68 6e 61 6d 65 28 0a 20 20 73 71 6c 69 74 65 33  hname(.  sqlite3
54b0: 5f 76 66 73 20 2a 70 56 66 73 2c 20 20 20 20 20  _vfs *pVfs,     
54c0: 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65         /* Pointe
54d0: 72 20 74 6f 20 76 66 73 20 6f 62 6a 65 63 74 20  r to vfs object 
54e0: 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  */.  const char 
54f0: 2a 7a 50 61 74 68 2c 20 20 20 20 20 20 20 20 20  *zPath,         
5500: 20 20 20 2f 2a 20 50 6f 73 73 69 62 6c 79 20 72     /* Possibly r
5510: 65 6c 61 74 69 76 65 20 69 6e 70 75 74 20 70 61  elative input pa
5520: 74 68 20 2a 2f 0a 20 20 69 6e 74 20 6e 4f 75 74  th */.  int nOut
5530: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
5540: 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66        /* Size of
5550: 20 6f 75 74 70 75 74 20 62 75 66 66 65 72 20 69   output buffer i
5560: 6e 20 62 79 74 65 73 20 2a 2f 0a 20 20 63 68 61  n bytes */.  cha
5570: 72 20 2a 7a 4f 75 74 20 20 20 20 20 20 20 20 20  r *zOut         
5580: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 75             /* Ou
5590: 74 70 75 74 20 62 75 66 66 65 72 20 2a 2f 0a 29  tput buffer */.)
55a0: 7b 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20  {.  sqlite3_vfs 
55b0: 2a 70 50 61 72 65 6e 74 20 3d 20 28 28 66 73 5f  *pParent = ((fs_
55c0: 76 66 73 5f 74 20 2a 29 70 56 66 73 29 2d 3e 70  vfs_t *)pVfs)->p
55d0: 50 61 72 65 6e 74 3b 0a 20 20 72 65 74 75 72 6e  Parent;.  return
55e0: 20 70 50 61 72 65 6e 74 2d 3e 78 46 75 6c 6c 50   pParent->xFullP
55f0: 61 74 68 6e 61 6d 65 28 70 50 61 72 65 6e 74 2c  athname(pParent,
5600: 20 7a 50 61 74 68 2c 20 6e 4f 75 74 2c 20 7a 4f   zPath, nOut, zO
5610: 75 74 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4f 70  ut);.}../*.** Op
5620: 65 6e 20 74 68 65 20 64 79 6e 61 6d 69 63 20 6c  en the dynamic l
5630: 69 62 72 61 72 79 20 6c 6f 63 61 74 65 64 20 61  ibrary located a
5640: 74 20 7a 50 61 74 68 20 61 6e 64 20 72 65 74 75  t zPath and retu
5650: 72 6e 20 61 20 68 61 6e 64 6c 65 2e 0a 2a 2f 0a  rn a handle..*/.
5660: 73 74 61 74 69 63 20 76 6f 69 64 20 2a 66 73 44  static void *fsD
5670: 6c 4f 70 65 6e 28 73 71 6c 69 74 65 33 5f 76 66  lOpen(sqlite3_vf
5680: 73 20 2a 70 56 66 73 2c 20 63 6f 6e 73 74 20 63  s *pVfs, const c
5690: 68 61 72 20 2a 7a 50 61 74 68 29 7b 0a 20 20 73  har *zPath){.  s
56a0: 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 50 61 72  qlite3_vfs *pPar
56b0: 65 6e 74 20 3d 20 28 28 66 73 5f 76 66 73 5f 74  ent = ((fs_vfs_t
56c0: 20 2a 29 70 56 66 73 29 2d 3e 70 50 61 72 65 6e   *)pVfs)->pParen
56d0: 74 3b 0a 20 20 72 65 74 75 72 6e 20 70 50 61 72  t;.  return pPar
56e0: 65 6e 74 2d 3e 78 44 6c 4f 70 65 6e 28 70 50 61  ent->xDlOpen(pPa
56f0: 72 65 6e 74 2c 20 7a 50 61 74 68 29 3b 0a 7d 0a  rent, zPath);.}.
5700: 0a 2f 2a 0a 2a 2a 20 50 6f 70 75 6c 61 74 65 20  ./*.** Populate 
5710: 74 68 65 20 62 75 66 66 65 72 20 7a 45 72 72 4d  the buffer zErrM
5720: 73 67 20 28 73 69 7a 65 20 6e 42 79 74 65 20 62  sg (size nByte b
5730: 79 74 65 73 29 20 77 69 74 68 20 61 20 68 75 6d  ytes) with a hum
5740: 61 6e 20 72 65 61 64 61 62 6c 65 0a 2a 2a 20 75  an readable.** u
5750: 74 66 2d 38 20 73 74 72 69 6e 67 20 64 65 73 63  tf-8 string desc
5760: 72 69 62 69 6e 67 20 74 68 65 20 6d 6f 73 74 20  ribing the most 
5770: 72 65 63 65 6e 74 20 65 72 72 6f 72 20 65 6e 63  recent error enc
5780: 6f 75 6e 74 65 72 65 64 20 61 73 73 6f 63 69 61  ountered associa
5790: 74 65 64 20 0a 2a 2a 20 77 69 74 68 20 64 79 6e  ted .** with dyn
57a0: 61 6d 69 63 20 6c 69 62 72 61 72 69 65 73 2e 0a  amic libraries..
57b0: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 66  */.static void f
57c0: 73 44 6c 45 72 72 6f 72 28 73 71 6c 69 74 65 33  sDlError(sqlite3
57d0: 5f 76 66 73 20 2a 70 56 66 73 2c 20 69 6e 74 20  _vfs *pVfs, int 
57e0: 6e 42 79 74 65 2c 20 63 68 61 72 20 2a 7a 45 72  nByte, char *zEr
57f0: 72 4d 73 67 29 7b 0a 20 20 73 71 6c 69 74 65 33  rMsg){.  sqlite3
5800: 5f 76 66 73 20 2a 70 50 61 72 65 6e 74 20 3d 20  _vfs *pParent = 
5810: 28 28 66 73 5f 76 66 73 5f 74 20 2a 29 70 56 66  ((fs_vfs_t *)pVf
5820: 73 29 2d 3e 70 50 61 72 65 6e 74 3b 0a 20 20 70  s)->pParent;.  p
5830: 50 61 72 65 6e 74 2d 3e 78 44 6c 45 72 72 6f 72  Parent->xDlError
5840: 28 70 50 61 72 65 6e 74 2c 20 6e 42 79 74 65 2c  (pParent, nByte,
5850: 20 7a 45 72 72 4d 73 67 29 3b 0a 7d 0a 0a 2f 2a   zErrMsg);.}../*
5860: 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 70 6f 69  .** Return a poi
5870: 6e 74 65 72 20 74 6f 20 74 68 65 20 73 79 6d 62  nter to the symb
5880: 6f 6c 20 7a 53 79 6d 62 6f 6c 20 69 6e 20 74 68  ol zSymbol in th
5890: 65 20 64 79 6e 61 6d 69 63 20 6c 69 62 72 61 72  e dynamic librar
58a0: 79 20 70 48 61 6e 64 6c 65 2e 0a 2a 2f 0a 73 74  y pHandle..*/.st
58b0: 61 74 69 63 20 76 6f 69 64 20 28 2a 66 73 44 6c  atic void (*fsDl
58c0: 53 79 6d 28 73 71 6c 69 74 65 33 5f 76 66 73 20  Sym(sqlite3_vfs 
58d0: 2a 70 56 66 73 2c 20 76 6f 69 64 20 2a 70 48 2c  *pVfs, void *pH,
58e0: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 53 79   const char *zSy
58f0: 6d 29 29 28 76 6f 69 64 29 7b 0a 20 20 73 71 6c  m))(void){.  sql
5900: 69 74 65 33 5f 76 66 73 20 2a 70 50 61 72 65 6e  ite3_vfs *pParen
5910: 74 20 3d 20 28 28 66 73 5f 76 66 73 5f 74 20 2a  t = ((fs_vfs_t *
5920: 29 70 56 66 73 29 2d 3e 70 50 61 72 65 6e 74 3b  )pVfs)->pParent;
5930: 0a 20 20 72 65 74 75 72 6e 20 70 50 61 72 65 6e  .  return pParen
5940: 74 2d 3e 78 44 6c 53 79 6d 28 70 50 61 72 65 6e  t->xDlSym(pParen
5950: 74 2c 20 70 48 2c 20 7a 53 79 6d 29 3b 0a 7d 0a  t, pH, zSym);.}.
5960: 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 74 68 65  ./*.** Close the
5970: 20 64 79 6e 61 6d 69 63 20 6c 69 62 72 61 72 79   dynamic library
5980: 20 68 61 6e 64 6c 65 20 70 48 61 6e 64 6c 65 2e   handle pHandle.
5990: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
59a0: 66 73 44 6c 43 6c 6f 73 65 28 73 71 6c 69 74 65  fsDlClose(sqlite
59b0: 33 5f 76 66 73 20 2a 70 56 66 73 2c 20 76 6f 69  3_vfs *pVfs, voi
59c0: 64 20 2a 70 48 61 6e 64 6c 65 29 7b 0a 20 20 73  d *pHandle){.  s
59d0: 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 50 61 72  qlite3_vfs *pPar
59e0: 65 6e 74 20 3d 20 28 28 66 73 5f 76 66 73 5f 74  ent = ((fs_vfs_t
59f0: 20 2a 29 70 56 66 73 29 2d 3e 70 50 61 72 65 6e   *)pVfs)->pParen
5a00: 74 3b 0a 20 20 70 50 61 72 65 6e 74 2d 3e 78 44  t;.  pParent->xD
5a10: 6c 43 6c 6f 73 65 28 70 50 61 72 65 6e 74 2c 20  lClose(pParent, 
5a20: 70 48 61 6e 64 6c 65 29 3b 0a 7d 0a 0a 2f 2a 0a  pHandle);.}../*.
5a30: 2a 2a 20 50 6f 70 75 6c 61 74 65 20 74 68 65 20  ** Populate the 
5a40: 62 75 66 66 65 72 20 70 6f 69 6e 74 65 64 20 74  buffer pointed t
5a50: 6f 20 62 79 20 7a 42 75 66 4f 75 74 20 77 69 74  o by zBufOut wit
5a60: 68 20 6e 42 79 74 65 20 62 79 74 65 73 20 6f 66  h nByte bytes of
5a70: 20 0a 2a 2a 20 72 61 6e 64 6f 6d 20 64 61 74 61   .** random data
5a80: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
5a90: 66 73 52 61 6e 64 6f 6d 6e 65 73 73 28 73 71 6c  fsRandomness(sql
5aa0: 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73 2c 20  ite3_vfs *pVfs, 
5ab0: 69 6e 74 20 6e 42 79 74 65 2c 20 63 68 61 72 20  int nByte, char 
5ac0: 2a 7a 42 75 66 4f 75 74 29 7b 0a 20 20 73 71 6c  *zBufOut){.  sql
5ad0: 69 74 65 33 5f 76 66 73 20 2a 70 50 61 72 65 6e  ite3_vfs *pParen
5ae0: 74 20 3d 20 28 28 66 73 5f 76 66 73 5f 74 20 2a  t = ((fs_vfs_t *
5af0: 29 70 56 66 73 29 2d 3e 70 50 61 72 65 6e 74 3b  )pVfs)->pParent;
5b00: 0a 20 20 72 65 74 75 72 6e 20 70 50 61 72 65 6e  .  return pParen
5b10: 74 2d 3e 78 52 61 6e 64 6f 6d 6e 65 73 73 28 70  t->xRandomness(p
5b20: 50 61 72 65 6e 74 2c 20 6e 42 79 74 65 2c 20 7a  Parent, nByte, z
5b30: 42 75 66 4f 75 74 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  BufOut);.}../*.*
5b40: 2a 20 53 6c 65 65 70 20 66 6f 72 20 6e 4d 69 63  * Sleep for nMic
5b50: 72 6f 20 6d 69 63 72 6f 73 65 63 6f 6e 64 73 2e  ro microseconds.
5b60: 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62   Return the numb
5b70: 65 72 20 6f 66 20 6d 69 63 72 6f 73 65 63 6f 6e  er of microsecon
5b80: 64 73 20 0a 2a 2a 20 61 63 74 75 61 6c 6c 79 20  ds .** actually 
5b90: 73 6c 65 70 74 2e 0a 2a 2f 0a 73 74 61 74 69 63  slept..*/.static
5ba0: 20 69 6e 74 20 66 73 53 6c 65 65 70 28 73 71 6c   int fsSleep(sql
5bb0: 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73 2c 20  ite3_vfs *pVfs, 
5bc0: 69 6e 74 20 6e 4d 69 63 72 6f 29 7b 0a 20 20 73  int nMicro){.  s
5bd0: 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 50 61 72  qlite3_vfs *pPar
5be0: 65 6e 74 20 3d 20 28 28 66 73 5f 76 66 73 5f 74  ent = ((fs_vfs_t
5bf0: 20 2a 29 70 56 66 73 29 2d 3e 70 50 61 72 65 6e   *)pVfs)->pParen
5c00: 74 3b 0a 20 20 72 65 74 75 72 6e 20 70 50 61 72  t;.  return pPar
5c10: 65 6e 74 2d 3e 78 53 6c 65 65 70 28 70 50 61 72  ent->xSleep(pPar
5c20: 65 6e 74 2c 20 6e 4d 69 63 72 6f 29 3b 0a 7d 0a  ent, nMicro);.}.
5c30: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68  ./*.** Return th
5c40: 65 20 63 75 72 72 65 6e 74 20 74 69 6d 65 20 61  e current time a
5c50: 73 20 61 20 4a 75 6c 69 61 6e 20 44 61 79 20 6e  s a Julian Day n
5c60: 75 6d 62 65 72 20 69 6e 20 2a 70 54 69 6d 65 4f  umber in *pTimeO
5c70: 75 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  ut..*/.static in
5c80: 74 20 66 73 43 75 72 72 65 6e 74 54 69 6d 65 28  t fsCurrentTime(
5c90: 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66  sqlite3_vfs *pVf
5ca0: 73 2c 20 64 6f 75 62 6c 65 20 2a 70 54 69 6d 65  s, double *pTime
5cb0: 4f 75 74 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f  Out){.  sqlite3_
5cc0: 76 66 73 20 2a 70 50 61 72 65 6e 74 20 3d 20 28  vfs *pParent = (
5cd0: 28 66 73 5f 76 66 73 5f 74 20 2a 29 70 56 66 73  (fs_vfs_t *)pVfs
5ce0: 29 2d 3e 70 50 61 72 65 6e 74 3b 0a 20 20 72 65  )->pParent;.  re
5cf0: 74 75 72 6e 20 70 50 61 72 65 6e 74 2d 3e 78 43  turn pParent->xC
5d00: 75 72 72 65 6e 74 54 69 6d 65 28 70 50 61 72 65  urrentTime(pPare
5d10: 6e 74 2c 20 70 54 69 6d 65 4f 75 74 29 3b 0a 7d  nt, pTimeOut);.}
5d20: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 70 72 6f  ../*.** This pro
5d30: 63 65 64 75 72 65 20 72 65 67 69 73 74 65 72 73  cedure registers
5d40: 20 74 68 65 20 66 73 20 76 66 73 20 77 69 74 68   the fs vfs with
5d50: 20 53 51 4c 69 74 65 2e 20 49 66 20 74 68 65 20   SQLite. If the 
5d60: 61 72 67 75 6d 65 6e 74 20 69 73 0a 2a 2a 20 74  argument is.** t
5d70: 72 75 65 2c 20 74 68 65 20 66 73 20 76 66 73 20  rue, the fs vfs 
5d80: 62 65 63 6f 6d 65 73 20 74 68 65 20 6e 65 77 20  becomes the new 
5d90: 64 65 66 61 75 6c 74 20 76 66 73 2e 20 49 74 20  default vfs. It 
5da0: 69 73 20 74 68 65 20 6f 6e 6c 79 20 70 75 62 6c  is the only publ
5db0: 69 63 6c 79 0a 2a 2a 20 61 76 61 69 6c 61 62 6c  icly.** availabl
5dc0: 65 20 66 75 6e 63 74 69 6f 6e 20 69 6e 20 74 68  e function in th
5dd0: 69 73 20 66 69 6c 65 2e 0a 2a 2f 0a 69 6e 74 20  is file..*/.int 
5de0: 66 73 5f 72 65 67 69 73 74 65 72 28 76 6f 69 64  fs_register(void
5df0: 29 7b 0a 20 20 69 66 28 20 66 73 5f 76 66 73 2e  ){.  if( fs_vfs.
5e00: 70 50 61 72 65 6e 74 20 29 20 72 65 74 75 72 6e  pParent ) return
5e10: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 66 73   SQLITE_OK;.  fs
5e20: 5f 76 66 73 2e 70 50 61 72 65 6e 74 20 3d 20 73  _vfs.pParent = s
5e30: 71 6c 69 74 65 33 5f 76 66 73 5f 66 69 6e 64 28  qlite3_vfs_find(
5e40: 30 29 3b 0a 20 20 66 73 5f 76 66 73 2e 62 61 73  0);.  fs_vfs.bas
5e50: 65 2e 6d 78 50 61 74 68 6e 61 6d 65 20 3d 20 66  e.mxPathname = f
5e60: 73 5f 76 66 73 2e 70 50 61 72 65 6e 74 2d 3e 6d  s_vfs.pParent->m
5e70: 78 50 61 74 68 6e 61 6d 65 3b 0a 20 20 66 73 5f  xPathname;.  fs_
5e80: 76 66 73 2e 62 61 73 65 2e 73 7a 4f 73 46 69 6c  vfs.base.szOsFil
5e90: 65 20 3d 20 4d 41 58 28 73 69 7a 65 6f 66 28 74  e = MAX(sizeof(t
5ea0: 6d 70 5f 66 69 6c 65 29 2c 20 73 69 7a 65 6f 66  mp_file), sizeof
5eb0: 28 66 73 5f 66 69 6c 65 29 29 3b 0a 20 20 72 65  (fs_file));.  re
5ec0: 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 66 73  turn sqlite3_vfs
5ed0: 5f 72 65 67 69 73 74 65 72 28 26 66 73 5f 76 66  _register(&fs_vf
5ee0: 73 2e 62 61 73 65 2c 20 30 29 3b 0a 7d 0a 0a 23  s.base, 0);.}..#
5ef0: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45 53  ifdef SQLITE_TES
5f00: 54 0a 20 20 69 6e 74 20 53 71 6c 69 74 65 74 65  T.  int Sqlitete
5f10: 73 74 4f 6e 65 66 69 6c 65 5f 49 6e 69 74 28 29  stOnefile_Init()
5f20: 20 7b 72 65 74 75 72 6e 20 66 73 5f 72 65 67 69   {return fs_regi
5f30: 73 74 65 72 28 29 3b 7d 0a 23 65 6e 64 69 66 0a  ster();}.#endif.