/ Hex Artifact Content
Login

Artifact 40cf9e212a377a6511469384a64b01e6e34b2eec:


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 32 2a     int nNew = 2*
29d0: 28 69 41 6d 74 2b 69 4f 66 73 74 2b 70 54 6d 70  (iAmt+iOfst+pTmp
29e0: 2d 3e 6e 41 6c 6c 6f 63 29 3b 0a 20 20 20 20 63  ->nAlloc);.    c
29f0: 68 61 72 20 2a 7a 4e 65 77 20 3d 20 73 71 6c 69  har *zNew = sqli
2a00: 74 65 33 5f 72 65 61 6c 6c 6f 63 28 70 54 6d 70  te3_realloc(pTmp
2a10: 2d 3e 7a 41 6c 6c 6f 63 2c 20 6e 4e 65 77 29 3b  ->zAlloc, nNew);
2a20: 0a 20 20 20 20 69 66 28 20 21 7a 4e 65 77 20 29  .    if( !zNew )
2a30: 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53  {.      return S
2a40: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20  QLITE_NOMEM;.   
2a50: 20 7d 0a 20 20 20 20 70 54 6d 70 2d 3e 7a 41 6c   }.    pTmp->zAl
2a60: 6c 6f 63 20 3d 20 7a 4e 65 77 3b 0a 20 20 20 20  loc = zNew;.    
2a70: 70 54 6d 70 2d 3e 6e 41 6c 6c 6f 63 20 3d 20 6e  pTmp->nAlloc = n
2a80: 4e 65 77 3b 0a 20 20 7d 0a 20 20 6d 65 6d 63 70  New;.  }.  memcp
2a90: 79 28 26 70 54 6d 70 2d 3e 7a 41 6c 6c 6f 63 5b  y(&pTmp->zAlloc[
2aa0: 69 4f 66 73 74 5d 2c 20 7a 42 75 66 2c 20 69 41  iOfst], zBuf, iA
2ab0: 6d 74 29 3b 0a 20 20 70 54 6d 70 2d 3e 6e 53 69  mt);.  pTmp->nSi
2ac0: 7a 65 20 3d 20 4d 41 58 28 70 54 6d 70 2d 3e 6e  ze = MAX(pTmp->n
2ad0: 53 69 7a 65 2c 20 69 4f 66 73 74 2b 69 41 6d 74  Size, iOfst+iAmt
2ae0: 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49  );.  return SQLI
2af0: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  TE_OK;.}../*.** 
2b00: 54 72 75 6e 63 61 74 65 20 61 20 74 6d 70 2d 66  Truncate a tmp-f
2b10: 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ile..*/.static i
2b20: 6e 74 20 74 6d 70 54 72 75 6e 63 61 74 65 28 73  nt tmpTruncate(s
2b30: 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 46 69  qlite3_file *pFi
2b40: 6c 65 2c 20 73 71 6c 69 74 65 5f 69 6e 74 36 34  le, sqlite_int64
2b50: 20 73 69 7a 65 29 7b 0a 20 20 74 6d 70 5f 66 69   size){.  tmp_fi
2b60: 6c 65 20 2a 70 54 6d 70 20 3d 20 28 74 6d 70 5f  le *pTmp = (tmp_
2b70: 66 69 6c 65 20 2a 29 70 46 69 6c 65 3b 0a 20 20  file *)pFile;.  
2b80: 70 54 6d 70 2d 3e 6e 53 69 7a 65 20 3d 20 4d 49  pTmp->nSize = MI
2b90: 4e 28 70 54 6d 70 2d 3e 6e 53 69 7a 65 2c 20 73  N(pTmp->nSize, s
2ba0: 69 7a 65 29 3b 0a 20 20 72 65 74 75 72 6e 20 53  ize);.  return S
2bb0: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a  QLITE_OK;.}../*.
2bc0: 2a 2a 20 53 79 6e 63 20 61 20 74 6d 70 2d 66 69  ** Sync a tmp-fi
2bd0: 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  le..*/.static in
2be0: 74 20 74 6d 70 53 79 6e 63 28 73 71 6c 69 74 65  t tmpSync(sqlite
2bf0: 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65 2c 20 69  3_file *pFile, i
2c00: 6e 74 20 66 6c 61 67 73 29 7b 0a 20 20 72 65 74  nt flags){.  ret
2c10: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d  urn SQLITE_OK;.}
2c20: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74  ../*.** Return t
2c30: 68 65 20 63 75 72 72 65 6e 74 20 66 69 6c 65 2d  he current file-
2c40: 73 69 7a 65 20 6f 66 20 61 20 74 6d 70 2d 66 69  size of a tmp-fi
2c50: 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  le..*/.static in
2c60: 74 20 74 6d 70 46 69 6c 65 53 69 7a 65 28 73 71  t tmpFileSize(sq
2c70: 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c  lite3_file *pFil
2c80: 65 2c 20 73 71 6c 69 74 65 5f 69 6e 74 36 34 20  e, sqlite_int64 
2c90: 2a 70 53 69 7a 65 29 7b 0a 20 20 74 6d 70 5f 66  *pSize){.  tmp_f
2ca0: 69 6c 65 20 2a 70 54 6d 70 20 3d 20 28 74 6d 70  ile *pTmp = (tmp
2cb0: 5f 66 69 6c 65 20 2a 29 70 46 69 6c 65 3b 0a 20  _file *)pFile;. 
2cc0: 20 2a 70 53 69 7a 65 20 3d 20 70 54 6d 70 2d 3e   *pSize = pTmp->
2cd0: 6e 53 69 7a 65 3b 0a 20 20 72 65 74 75 72 6e 20  nSize;.  return 
2ce0: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a  SQLITE_OK;.}../*
2cf0: 0a 2a 2a 20 4c 6f 63 6b 20 61 20 74 6d 70 2d 66  .** Lock a tmp-f
2d00: 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ile..*/.static i
2d10: 6e 74 20 74 6d 70 4c 6f 63 6b 28 73 71 6c 69 74  nt tmpLock(sqlit
2d20: 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65 2c 20  e3_file *pFile, 
2d30: 69 6e 74 20 65 4c 6f 63 6b 29 7b 0a 20 20 72 65  int eLock){.  re
2d40: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
2d50: 7d 0a 0a 2f 2a 0a 2a 2a 20 55 6e 6c 6f 63 6b 20  }../*.** Unlock 
2d60: 61 20 74 6d 70 2d 66 69 6c 65 2e 0a 2a 2f 0a 73  a tmp-file..*/.s
2d70: 74 61 74 69 63 20 69 6e 74 20 74 6d 70 55 6e 6c  tatic int tmpUnl
2d80: 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66 69 6c 65  ock(sqlite3_file
2d90: 20 2a 70 46 69 6c 65 2c 20 69 6e 74 20 65 4c 6f   *pFile, int eLo
2da0: 63 6b 29 7b 0a 20 20 72 65 74 75 72 6e 20 53 51  ck){.  return SQ
2db0: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a  LITE_OK;.}../*.*
2dc0: 2a 20 43 68 65 63 6b 20 69 66 20 61 6e 6f 74 68  * Check if anoth
2dd0: 65 72 20 66 69 6c 65 2d 68 61 6e 64 6c 65 20 68  er file-handle h
2de0: 6f 6c 64 73 20 61 20 52 45 53 45 52 56 45 44 20  olds a RESERVED 
2df0: 6c 6f 63 6b 20 6f 6e 20 61 20 74 6d 70 2d 66 69  lock on a tmp-fi
2e00: 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  le..*/.static in
2e10: 74 20 74 6d 70 43 68 65 63 6b 52 65 73 65 72 76  t tmpCheckReserv
2e20: 65 64 4c 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66  edLock(sqlite3_f
2e30: 69 6c 65 20 2a 70 46 69 6c 65 2c 20 69 6e 74 20  ile *pFile, int 
2e40: 2a 70 52 65 73 4f 75 74 29 7b 0a 20 20 2a 70 52  *pResOut){.  *pR
2e50: 65 73 4f 75 74 20 3d 20 30 3b 0a 20 20 72 65 74  esOut = 0;.  ret
2e60: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d  urn SQLITE_OK;.}
2e70: 0a 0a 2f 2a 0a 2a 2a 20 46 69 6c 65 20 63 6f 6e  ../*.** File con
2e80: 74 72 6f 6c 20 6d 65 74 68 6f 64 2e 20 46 6f 72  trol method. For
2e90: 20 63 75 73 74 6f 6d 20 6f 70 65 72 61 74 69 6f   custom operatio
2ea0: 6e 73 20 6f 6e 20 61 20 74 6d 70 2d 66 69 6c 65  ns on a tmp-file
2eb0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
2ec0: 74 6d 70 46 69 6c 65 43 6f 6e 74 72 6f 6c 28 73  tmpFileControl(s
2ed0: 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 46 69  qlite3_file *pFi
2ee0: 6c 65 2c 20 69 6e 74 20 6f 70 2c 20 76 6f 69 64  le, int op, void
2ef0: 20 2a 70 41 72 67 29 7b 0a 20 20 72 65 74 75 72   *pArg){.  retur
2f00: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a  n SQLITE_OK;.}..
2f10: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65  /*.** Return the
2f20: 20 73 65 63 74 6f 72 2d 73 69 7a 65 20 69 6e 20   sector-size in 
2f30: 62 79 74 65 73 20 66 6f 72 20 61 20 74 6d 70 2d  bytes for a tmp-
2f40: 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  file..*/.static 
2f50: 69 6e 74 20 74 6d 70 53 65 63 74 6f 72 53 69 7a  int tmpSectorSiz
2f60: 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a  e(sqlite3_file *
2f70: 70 46 69 6c 65 29 7b 0a 20 20 72 65 74 75 72 6e  pFile){.  return
2f80: 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74   0;.}../*.** Ret
2f90: 75 72 6e 20 74 68 65 20 64 65 76 69 63 65 20 63  urn the device c
2fa0: 68 61 72 61 63 74 65 72 69 73 74 69 63 20 66 6c  haracteristic fl
2fb0: 61 67 73 20 73 75 70 70 6f 72 74 65 64 20 62 79  ags supported by
2fc0: 20 61 20 74 6d 70 2d 66 69 6c 65 2e 0a 2a 2f 0a   a tmp-file..*/.
2fd0: 73 74 61 74 69 63 20 69 6e 74 20 74 6d 70 44 65  static int tmpDe
2fe0: 76 69 63 65 43 68 61 72 61 63 74 65 72 69 73 74  viceCharacterist
2ff0: 69 63 73 28 73 71 6c 69 74 65 33 5f 66 69 6c 65  ics(sqlite3_file
3000: 20 2a 70 46 69 6c 65 29 7b 0a 20 20 72 65 74 75   *pFile){.  retu
3010: 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43  rn 0;.}../*.** C
3020: 6c 6f 73 65 20 61 6e 20 66 73 2d 66 69 6c 65 2e  lose an fs-file.
3030: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 66  .*/.static int f
3040: 73 43 6c 6f 73 65 28 73 71 6c 69 74 65 33 5f 66  sClose(sqlite3_f
3050: 69 6c 65 20 2a 70 46 69 6c 65 29 7b 0a 20 20 69  ile *pFile){.  i
3060: 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f  nt rc = SQLITE_O
3070: 4b 3b 0a 20 20 66 73 5f 66 69 6c 65 20 2a 70 20  K;.  fs_file *p 
3080: 3d 20 28 66 73 5f 66 69 6c 65 20 2a 29 70 46 69  = (fs_file *)pFi
3090: 6c 65 3b 0a 20 20 66 73 5f 72 65 61 6c 5f 66 69  le;.  fs_real_fi
30a0: 6c 65 20 2a 70 52 65 61 6c 20 3d 20 70 2d 3e 70  le *pReal = p->p
30b0: 52 65 61 6c 3b 0a 0a 20 20 2f 2a 20 44 65 63 72  Real;..  /* Decr
30c0: 65 6d 65 6e 74 20 74 68 65 20 72 65 61 6c 5f 66  ement the real_f
30d0: 69 6c 65 20 72 65 66 2d 63 6f 75 6e 74 2e 20 2a  ile ref-count. *
30e0: 2f 0a 20 20 70 52 65 61 6c 2d 3e 6e 52 65 66 2d  /.  pReal->nRef-
30f0: 2d 3b 0a 20 20 61 73 73 65 72 74 28 70 52 65 61  -;.  assert(pRea
3100: 6c 2d 3e 6e 52 65 66 3e 3d 30 29 3b 0a 0a 20 20  l->nRef>=0);..  
3110: 2f 2a 20 57 68 65 6e 20 74 68 65 20 72 65 66 2d  /* When the ref-
3120: 63 6f 75 6e 74 20 72 65 61 63 68 65 73 20 30 2c  count reaches 0,
3130: 20 64 65 73 74 72 6f 79 20 74 68 65 20 73 74 72   destroy the str
3140: 75 63 74 75 72 65 20 2a 2f 0a 20 20 69 66 28 20  ucture */.  if( 
3150: 70 52 65 61 6c 2d 3e 6e 52 65 66 3d 3d 30 20 29  pReal->nRef==0 )
3160: 7b 0a 20 20 20 20 2a 70 52 65 61 6c 2d 3e 70 70  {.    *pReal->pp
3170: 54 68 69 73 20 3d 20 70 52 65 61 6c 2d 3e 70 4e  This = pReal->pN
3180: 65 78 74 3b 0a 20 20 20 20 69 66 28 20 70 52 65  ext;.    if( pRe
3190: 61 6c 2d 3e 70 4e 65 78 74 20 29 7b 0a 20 20 20  al->pNext ){.   
31a0: 20 20 20 70 52 65 61 6c 2d 3e 70 4e 65 78 74 2d     pReal->pNext-
31b0: 3e 70 70 54 68 69 73 20 3d 20 70 52 65 61 6c 2d  >ppThis = pReal-
31c0: 3e 70 70 54 68 69 73 3b 0a 20 20 20 20 7d 0a 20  >ppThis;.    }. 
31d0: 20 20 20 72 63 20 3d 20 70 52 65 61 6c 2d 3e 70     rc = pReal->p
31e0: 46 69 6c 65 2d 3e 70 4d 65 74 68 6f 64 73 2d 3e  File->pMethods->
31f0: 78 43 6c 6f 73 65 28 70 52 65 61 6c 2d 3e 70 46  xClose(pReal->pF
3200: 69 6c 65 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  ile);.    sqlite
3210: 33 5f 66 72 65 65 28 70 52 65 61 6c 29 3b 0a 20  3_free(pReal);. 
3220: 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b   }..  return rc;
3230: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20 64  .}../*.** Read d
3240: 61 74 61 20 66 72 6f 6d 20 61 6e 20 66 73 2d 66  ata from an fs-f
3250: 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ile..*/.static i
3260: 6e 74 20 66 73 52 65 61 64 28 0a 20 20 73 71 6c  nt fsRead(.  sql
3270: 69 74 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65  ite3_file *pFile
3280: 2c 20 0a 20 20 76 6f 69 64 20 2a 7a 42 75 66 2c  , .  void *zBuf,
3290: 20 0a 20 20 69 6e 74 20 69 41 6d 74 2c 20 0a 20   .  int iAmt, . 
32a0: 20 73 71 6c 69 74 65 5f 69 6e 74 36 34 20 69 4f   sqlite_int64 iO
32b0: 66 73 74 0a 29 7b 0a 20 20 69 6e 74 20 72 63 20  fst.){.  int rc 
32c0: 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 66  = SQLITE_OK;.  f
32d0: 73 5f 66 69 6c 65 20 2a 70 20 3d 20 28 66 73 5f  s_file *p = (fs_
32e0: 66 69 6c 65 20 2a 29 70 46 69 6c 65 3b 0a 20 20  file *)pFile;.  
32f0: 66 73 5f 72 65 61 6c 5f 66 69 6c 65 20 2a 70 52  fs_real_file *pR
3300: 65 61 6c 20 3d 20 70 2d 3e 70 52 65 61 6c 3b 0a  eal = p->pReal;.
3310: 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a    sqlite3_file *
3320: 70 46 20 3d 20 70 52 65 61 6c 2d 3e 70 46 69 6c  pF = pReal->pFil
3330: 65 3b 0a 0a 20 20 69 66 28 20 28 70 2d 3e 65 54  e;..  if( (p->eT
3340: 79 70 65 3d 3d 44 41 54 41 42 41 53 45 5f 46 49  ype==DATABASE_FI
3350: 4c 45 20 26 26 20 28 69 41 6d 74 2b 69 4f 66 73  LE && (iAmt+iOfs
3360: 74 29 3e 70 52 65 61 6c 2d 3e 6e 44 61 74 61 62  t)>pReal->nDatab
3370: 61 73 65 29 0a 20 20 20 7c 7c 20 28 70 2d 3e 65  ase).   || (p->e
3380: 54 79 70 65 3d 3d 4a 4f 55 52 4e 41 4c 5f 46 49  Type==JOURNAL_FI
3390: 4c 45 20 26 26 20 28 69 41 6d 74 2b 69 4f 66 73  LE && (iAmt+iOfs
33a0: 74 29 3e 70 52 65 61 6c 2d 3e 6e 4a 6f 75 72 6e  t)>pReal->nJourn
33b0: 61 6c 29 0a 20 20 29 7b 0a 20 20 20 20 72 63 20  al).  ){.    rc 
33c0: 3d 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53  = SQLITE_IOERR_S
33d0: 48 4f 52 54 5f 52 45 41 44 3b 0a 20 20 7d 65 6c  HORT_READ;.  }el
33e0: 73 65 20 69 66 28 20 70 2d 3e 65 54 79 70 65 3d  se if( p->eType=
33f0: 3d 44 41 54 41 42 41 53 45 5f 46 49 4c 45 20 29  =DATABASE_FILE )
3400: 7b 0a 20 20 20 20 72 63 20 3d 20 70 46 2d 3e 70  {.    rc = pF->p
3410: 4d 65 74 68 6f 64 73 2d 3e 78 52 65 61 64 28 70  Methods->xRead(p
3420: 46 2c 20 7a 42 75 66 2c 20 69 41 6d 74 2c 20 69  F, zBuf, iAmt, i
3430: 4f 66 73 74 2b 42 4c 4f 43 4b 53 49 5a 45 29 3b  Ofst+BLOCKSIZE);
3440: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a  .  }else{.    /*
3450: 20 4a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 2a   Journal file. *
3460: 2f 0a 20 20 20 20 69 6e 74 20 69 52 65 6d 20 3d  /.    int iRem =
3470: 20 69 41 6d 74 3b 0a 20 20 20 20 69 6e 74 20 69   iAmt;.    int i
3480: 42 75 66 20 3d 20 30 3b 0a 20 20 20 20 69 6e 74  Buf = 0;.    int
3490: 20 69 69 20 3d 20 69 4f 66 73 74 3b 0a 20 20 20   ii = iOfst;.   
34a0: 20 77 68 69 6c 65 28 20 69 52 65 6d 3e 30 20 26   while( iRem>0 &
34b0: 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  & rc==SQLITE_OK 
34c0: 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 52 65  ){.      int iRe
34d0: 61 6c 4f 66 66 20 3d 20 70 52 65 61 6c 2d 3e 6e  alOff = pReal->n
34e0: 42 6c 6f 62 20 2d 20 42 4c 4f 43 4b 53 49 5a 45  Blob - BLOCKSIZE
34f0: 2a 28 28 69 69 2f 42 4c 4f 43 4b 53 49 5a 45 29  *((ii/BLOCKSIZE)
3500: 2b 31 29 20 2b 20 69 69 25 42 4c 4f 43 4b 53 49  +1) + ii%BLOCKSI
3510: 5a 45 3b 0a 20 20 20 20 20 20 69 6e 74 20 69 52  ZE;.      int iR
3520: 65 61 6c 41 6d 74 20 3d 20 4d 49 4e 28 69 52 65  ealAmt = MIN(iRe
3530: 6d 2c 20 42 4c 4f 43 4b 53 49 5a 45 20 2d 20 28  m, BLOCKSIZE - (
3540: 69 52 65 61 6c 4f 66 66 25 42 4c 4f 43 4b 53 49  iRealOff%BLOCKSI
3550: 5a 45 29 29 3b 0a 0a 20 20 20 20 20 20 72 63 20  ZE));..      rc 
3560: 3d 20 70 46 2d 3e 70 4d 65 74 68 6f 64 73 2d 3e  = pF->pMethods->
3570: 78 52 65 61 64 28 70 46 2c 20 26 28 28 63 68 61  xRead(pF, &((cha
3580: 72 20 2a 29 7a 42 75 66 29 5b 69 42 75 66 5d 2c  r *)zBuf)[iBuf],
3590: 20 69 52 65 61 6c 41 6d 74 2c 20 69 52 65 61 6c   iRealAmt, iReal
35a0: 4f 66 66 29 3b 0a 20 20 20 20 20 20 69 69 20 2b  Off);.      ii +
35b0: 3d 20 69 52 65 61 6c 41 6d 74 3b 0a 20 20 20 20  = iRealAmt;.    
35c0: 20 20 69 42 75 66 20 2b 3d 20 69 52 65 61 6c 41    iBuf += iRealA
35d0: 6d 74 3b 0a 20 20 20 20 20 20 69 52 65 6d 20 2d  mt;.      iRem -
35e0: 3d 20 69 52 65 61 6c 41 6d 74 3b 0a 20 20 20 20  = iRealAmt;.    
35f0: 7d 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20  }.  }..  return 
3600: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 72 69  rc;.}../*.** Wri
3610: 74 65 20 64 61 74 61 20 74 6f 20 61 6e 20 66 73  te data to an fs
3620: 2d 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63  -file..*/.static
3630: 20 69 6e 74 20 66 73 57 72 69 74 65 28 0a 20 20   int fsWrite(.  
3640: 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 46  sqlite3_file *pF
3650: 69 6c 65 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f  ile, .  const vo
3660: 69 64 20 2a 7a 42 75 66 2c 20 0a 20 20 69 6e 74  id *zBuf, .  int
3670: 20 69 41 6d 74 2c 20 0a 20 20 73 71 6c 69 74 65   iAmt, .  sqlite
3680: 5f 69 6e 74 36 34 20 69 4f 66 73 74 0a 29 7b 0a  _int64 iOfst.){.
3690: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
36a0: 45 5f 4f 4b 3b 0a 20 20 66 73 5f 66 69 6c 65 20  E_OK;.  fs_file 
36b0: 2a 70 20 3d 20 28 66 73 5f 66 69 6c 65 20 2a 29  *p = (fs_file *)
36c0: 70 46 69 6c 65 3b 0a 20 20 66 73 5f 72 65 61 6c  pFile;.  fs_real
36d0: 5f 66 69 6c 65 20 2a 70 52 65 61 6c 20 3d 20 70  _file *pReal = p
36e0: 2d 3e 70 52 65 61 6c 3b 0a 20 20 73 71 6c 69 74  ->pReal;.  sqlit
36f0: 65 33 5f 66 69 6c 65 20 2a 70 46 20 3d 20 70 52  e3_file *pF = pR
3700: 65 61 6c 2d 3e 70 46 69 6c 65 3b 0a 0a 20 20 69  eal->pFile;..  i
3710: 66 28 20 70 2d 3e 65 54 79 70 65 3d 3d 44 41 54  f( p->eType==DAT
3720: 41 42 41 53 45 5f 46 49 4c 45 20 29 7b 0a 20 20  ABASE_FILE ){.  
3730: 20 20 69 66 28 20 28 69 41 6d 74 2b 69 4f 66 73    if( (iAmt+iOfs
3740: 74 2b 42 4c 4f 43 4b 53 49 5a 45 29 3e 28 70 52  t+BLOCKSIZE)>(pR
3750: 65 61 6c 2d 3e 6e 42 6c 6f 62 2d 70 52 65 61 6c  eal->nBlob-pReal
3760: 2d 3e 6e 4a 6f 75 72 6e 61 6c 29 20 29 7b 0a 20  ->nJournal) ){. 
3770: 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45       rc = SQLITE
3780: 5f 46 55 4c 4c 3b 0a 20 20 20 20 7d 65 6c 73 65  _FULL;.    }else
3790: 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 70 46 2d  {.      rc = pF-
37a0: 3e 70 4d 65 74 68 6f 64 73 2d 3e 78 57 72 69 74  >pMethods->xWrit
37b0: 65 28 70 46 2c 20 7a 42 75 66 2c 20 69 41 6d 74  e(pF, zBuf, iAmt
37c0: 2c 20 69 4f 66 73 74 2b 42 4c 4f 43 4b 53 49 5a  , iOfst+BLOCKSIZ
37d0: 45 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63  E);.      if( rc
37e0: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  ==SQLITE_OK ){. 
37f0: 20 20 20 20 20 20 20 70 52 65 61 6c 2d 3e 6e 44         pReal->nD
3800: 61 74 61 62 61 73 65 20 3d 20 4d 41 58 28 70 52  atabase = MAX(pR
3810: 65 61 6c 2d 3e 6e 44 61 74 61 62 61 73 65 2c 20  eal->nDatabase, 
3820: 69 41 6d 74 2b 69 4f 66 73 74 29 3b 0a 20 20 20  iAmt+iOfst);.   
3830: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 65 6c     }.    }.  }el
3840: 73 65 7b 0a 20 20 20 20 2f 2a 20 4a 6f 75 72 6e  se{.    /* Journ
3850: 61 6c 20 66 69 6c 65 2e 20 2a 2f 0a 20 20 20 20  al file. */.    
3860: 69 6e 74 20 69 52 65 6d 20 3d 20 69 41 6d 74 3b  int iRem = iAmt;
3870: 0a 20 20 20 20 69 6e 74 20 69 42 75 66 20 3d 20  .    int iBuf = 
3880: 30 3b 0a 20 20 20 20 69 6e 74 20 69 69 20 3d 20  0;.    int ii = 
3890: 69 4f 66 73 74 3b 0a 20 20 20 20 77 68 69 6c 65  iOfst;.    while
38a0: 28 20 69 52 65 6d 3e 30 20 26 26 20 72 63 3d 3d  ( iRem>0 && rc==
38b0: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
38c0: 20 20 20 69 6e 74 20 69 52 65 61 6c 4f 66 66 20     int iRealOff 
38d0: 3d 20 70 52 65 61 6c 2d 3e 6e 42 6c 6f 62 20 2d  = pReal->nBlob -
38e0: 20 42 4c 4f 43 4b 53 49 5a 45 2a 28 28 69 69 2f   BLOCKSIZE*((ii/
38f0: 42 4c 4f 43 4b 53 49 5a 45 29 2b 31 29 20 2b 20  BLOCKSIZE)+1) + 
3900: 69 69 25 42 4c 4f 43 4b 53 49 5a 45 3b 0a 20 20  ii%BLOCKSIZE;.  
3910: 20 20 20 20 69 6e 74 20 69 52 65 61 6c 41 6d 74      int iRealAmt
3920: 20 3d 20 4d 49 4e 28 69 52 65 6d 2c 20 42 4c 4f   = MIN(iRem, BLO
3930: 43 4b 53 49 5a 45 20 2d 20 28 69 52 65 61 6c 4f  CKSIZE - (iRealO
3940: 66 66 25 42 4c 4f 43 4b 53 49 5a 45 29 29 3b 0a  ff%BLOCKSIZE));.
3950: 0a 20 20 20 20 20 20 69 66 28 20 69 52 65 61 6c  .      if( iReal
3960: 4f 66 66 3c 28 70 52 65 61 6c 2d 3e 6e 44 61 74  Off<(pReal->nDat
3970: 61 62 61 73 65 2b 42 4c 4f 43 4b 53 49 5a 45 29  abase+BLOCKSIZE)
3980: 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d   ){.        rc =
3990: 20 53 51 4c 49 54 45 5f 46 55 4c 4c 3b 0a 20 20   SQLITE_FULL;.  
39a0: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
39b0: 20 20 20 72 63 20 3d 20 70 46 2d 3e 70 4d 65 74     rc = pF->pMet
39c0: 68 6f 64 73 2d 3e 78 57 72 69 74 65 28 70 46 2c  hods->xWrite(pF,
39d0: 20 26 28 28 63 68 61 72 20 2a 29 7a 42 75 66 29   &((char *)zBuf)
39e0: 5b 69 42 75 66 5d 2c 20 69 52 65 61 6c 41 6d 74  [iBuf], iRealAmt
39f0: 2c 69 52 65 61 6c 4f 66 66 29 3b 0a 20 20 20 20  ,iRealOff);.    
3a00: 20 20 20 20 69 69 20 2b 3d 20 69 52 65 61 6c 41      ii += iRealA
3a10: 6d 74 3b 0a 20 20 20 20 20 20 20 20 69 42 75 66  mt;.        iBuf
3a20: 20 2b 3d 20 69 52 65 61 6c 41 6d 74 3b 0a 20 20   += iRealAmt;.  
3a30: 20 20 20 20 20 20 69 52 65 6d 20 2d 3d 20 69 52        iRem -= iR
3a40: 65 61 6c 41 6d 74 3b 0a 20 20 20 20 20 20 7d 0a  ealAmt;.      }.
3a50: 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63      }.    if( rc
3a60: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  ==SQLITE_OK ){. 
3a70: 20 20 20 20 20 70 52 65 61 6c 2d 3e 6e 4a 6f 75       pReal->nJou
3a80: 72 6e 61 6c 20 3d 20 4d 41 58 28 70 52 65 61 6c  rnal = MAX(pReal
3a90: 2d 3e 6e 4a 6f 75 72 6e 61 6c 2c 20 69 41 6d 74  ->nJournal, iAmt
3aa0: 2b 69 4f 66 73 74 29 3b 0a 20 20 20 20 7d 0a 20  +iOfst);.    }. 
3ab0: 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b   }..  return rc;
3ac0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 72 75 6e 63 61  .}../*.** Trunca
3ad0: 74 65 20 61 6e 20 66 73 2d 66 69 6c 65 2e 0a 2a  te an fs-file..*
3ae0: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 66 73 54  /.static int fsT
3af0: 72 75 6e 63 61 74 65 28 73 71 6c 69 74 65 33 5f  runcate(sqlite3_
3b00: 66 69 6c 65 20 2a 70 46 69 6c 65 2c 20 73 71 6c  file *pFile, sql
3b10: 69 74 65 5f 69 6e 74 36 34 20 73 69 7a 65 29 7b  ite_int64 size){
3b20: 0a 20 20 66 73 5f 66 69 6c 65 20 2a 70 20 3d 20  .  fs_file *p = 
3b30: 28 66 73 5f 66 69 6c 65 20 2a 29 70 46 69 6c 65  (fs_file *)pFile
3b40: 3b 0a 20 20 66 73 5f 72 65 61 6c 5f 66 69 6c 65  ;.  fs_real_file
3b50: 20 2a 70 52 65 61 6c 20 3d 20 70 2d 3e 70 52 65   *pReal = p->pRe
3b60: 61 6c 3b 0a 20 20 69 66 28 20 70 2d 3e 65 54 79  al;.  if( p->eTy
3b70: 70 65 3d 3d 44 41 54 41 42 41 53 45 5f 46 49 4c  pe==DATABASE_FIL
3b80: 45 20 29 7b 0a 20 20 20 20 70 52 65 61 6c 2d 3e  E ){.    pReal->
3b90: 6e 44 61 74 61 62 61 73 65 20 3d 20 4d 49 4e 28  nDatabase = MIN(
3ba0: 70 52 65 61 6c 2d 3e 6e 44 61 74 61 62 61 73 65  pReal->nDatabase
3bb0: 2c 20 73 69 7a 65 29 3b 0a 20 20 7d 65 6c 73 65  , size);.  }else
3bc0: 7b 0a 20 20 20 20 70 52 65 61 6c 2d 3e 6e 4a 6f  {.    pReal->nJo
3bd0: 75 72 6e 61 6c 20 3d 20 4d 49 4e 28 70 52 65 61  urnal = MIN(pRea
3be0: 6c 2d 3e 6e 4a 6f 75 72 6e 61 6c 2c 20 73 69 7a  l->nJournal, siz
3bf0: 65 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e  e);.  }.  return
3c00: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f   SQLITE_OK;.}../
3c10: 2a 0a 2a 2a 20 53 79 6e 63 20 61 6e 20 66 73 2d  *.** Sync an fs-
3c20: 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  file..*/.static 
3c30: 69 6e 74 20 66 73 53 79 6e 63 28 73 71 6c 69 74  int fsSync(sqlit
3c40: 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65 2c 20  e3_file *pFile, 
3c50: 69 6e 74 20 66 6c 61 67 73 29 7b 0a 20 20 66 73  int flags){.  fs
3c60: 5f 66 69 6c 65 20 2a 70 20 3d 20 28 66 73 5f 66  _file *p = (fs_f
3c70: 69 6c 65 20 2a 29 70 46 69 6c 65 3b 0a 20 20 66  ile *)pFile;.  f
3c80: 73 5f 72 65 61 6c 5f 66 69 6c 65 20 2a 70 52 65  s_real_file *pRe
3c90: 61 6c 20 3d 20 70 2d 3e 70 52 65 61 6c 3b 0a 20  al = p->pReal;. 
3ca0: 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70   sqlite3_file *p
3cb0: 52 65 61 6c 46 69 6c 65 20 3d 20 70 52 65 61 6c  RealFile = pReal
3cc0: 2d 3e 70 46 69 6c 65 3b 0a 20 20 69 6e 74 20 72  ->pFile;.  int r
3cd0: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a  c = SQLITE_OK;..
3ce0: 20 20 69 66 28 20 70 2d 3e 65 54 79 70 65 3d 3d    if( p->eType==
3cf0: 44 41 54 41 42 41 53 45 5f 46 49 4c 45 20 29 7b  DATABASE_FILE ){
3d00: 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20 63 68  .    unsigned ch
3d10: 61 72 20 7a 53 69 7a 65 5b 34 5d 3b 0a 20 20 20  ar zSize[4];.   
3d20: 20 7a 53 69 7a 65 5b 30 5d 20 3d 20 28 70 52 65   zSize[0] = (pRe
3d30: 61 6c 2d 3e 6e 44 61 74 61 62 61 73 65 26 30 78  al->nDatabase&0x
3d40: 46 46 30 30 30 30 30 30 29 3e 3e 32 34 3b 0a 20  FF000000)>>24;. 
3d50: 20 20 20 7a 53 69 7a 65 5b 31 5d 20 3d 20 28 70     zSize[1] = (p
3d60: 52 65 61 6c 2d 3e 6e 44 61 74 61 62 61 73 65 26  Real->nDatabase&
3d70: 30 78 30 30 46 46 30 30 30 30 29 3e 3e 31 36 3b  0x00FF0000)>>16;
3d80: 0a 20 20 20 20 7a 53 69 7a 65 5b 32 5d 20 3d 20  .    zSize[2] = 
3d90: 28 70 52 65 61 6c 2d 3e 6e 44 61 74 61 62 61 73  (pReal->nDatabas
3da0: 65 26 30 78 30 30 30 30 46 46 30 30 29 3e 3e 38  e&0x0000FF00)>>8
3db0: 3b 0a 20 20 20 20 7a 53 69 7a 65 5b 33 5d 20 3d  ;.    zSize[3] =
3dc0: 20 28 70 52 65 61 6c 2d 3e 6e 44 61 74 61 62 61   (pReal->nDataba
3dd0: 73 65 26 30 78 30 30 30 30 30 30 46 46 29 3b 0a  se&0x000000FF);.
3de0: 20 20 20 20 72 63 20 3d 20 70 52 65 61 6c 46 69      rc = pRealFi
3df0: 6c 65 2d 3e 70 4d 65 74 68 6f 64 73 2d 3e 78 57  le->pMethods->xW
3e00: 72 69 74 65 28 70 52 65 61 6c 46 69 6c 65 2c 20  rite(pRealFile, 
3e10: 7a 53 69 7a 65 2c 20 34 2c 20 30 29 3b 0a 20 20  zSize, 4, 0);.  
3e20: 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49  }.  if( rc==SQLI
3e30: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20  TE_OK ){.    rc 
3e40: 3d 20 70 52 65 61 6c 46 69 6c 65 2d 3e 70 4d 65  = pRealFile->pMe
3e50: 74 68 6f 64 73 2d 3e 78 53 79 6e 63 28 70 52 65  thods->xSync(pRe
3e60: 61 6c 46 69 6c 65 2c 20 66 6c 61 67 73 26 28 7e  alFile, flags&(~
3e70: 53 51 4c 49 54 45 5f 53 59 4e 43 5f 44 41 54 41  SQLITE_SYNC_DATA
3e80: 4f 4e 4c 59 29 29 3b 0a 20 20 7d 0a 0a 20 20 72  ONLY));.  }..  r
3e90: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
3ea0: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 63 75  ** Return the cu
3eb0: 72 72 65 6e 74 20 66 69 6c 65 2d 73 69 7a 65 20  rrent file-size 
3ec0: 6f 66 20 61 6e 20 66 73 2d 66 69 6c 65 2e 0a 2a  of an fs-file..*
3ed0: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 66 73 46  /.static int fsF
3ee0: 69 6c 65 53 69 7a 65 28 73 71 6c 69 74 65 33 5f  ileSize(sqlite3_
3ef0: 66 69 6c 65 20 2a 70 46 69 6c 65 2c 20 73 71 6c  file *pFile, sql
3f00: 69 74 65 5f 69 6e 74 36 34 20 2a 70 53 69 7a 65  ite_int64 *pSize
3f10: 29 7b 0a 20 20 66 73 5f 66 69 6c 65 20 2a 70 20  ){.  fs_file *p 
3f20: 3d 20 28 66 73 5f 66 69 6c 65 20 2a 29 70 46 69  = (fs_file *)pFi
3f30: 6c 65 3b 0a 20 20 66 73 5f 72 65 61 6c 5f 66 69  le;.  fs_real_fi
3f40: 6c 65 20 2a 70 52 65 61 6c 20 3d 20 70 2d 3e 70  le *pReal = p->p
3f50: 52 65 61 6c 3b 0a 20 20 69 66 28 20 70 2d 3e 65  Real;.  if( p->e
3f60: 54 79 70 65 3d 3d 44 41 54 41 42 41 53 45 5f 46  Type==DATABASE_F
3f70: 49 4c 45 20 29 7b 0a 20 20 20 20 2a 70 53 69 7a  ILE ){.    *pSiz
3f80: 65 20 3d 20 70 52 65 61 6c 2d 3e 6e 44 61 74 61  e = pReal->nData
3f90: 62 61 73 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  base;.  }else{. 
3fa0: 20 20 20 2a 70 53 69 7a 65 20 3d 20 70 52 65 61     *pSize = pRea
3fb0: 6c 2d 3e 6e 4a 6f 75 72 6e 61 6c 3b 0a 20 20 7d  l->nJournal;.  }
3fc0: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
3fd0: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4c 6f  _OK;.}../*.** Lo
3fe0: 63 6b 20 61 6e 20 66 73 2d 66 69 6c 65 2e 0a 2a  ck an fs-file..*
3ff0: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 66 73 4c  /.static int fsL
4000: 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66 69 6c 65  ock(sqlite3_file
4010: 20 2a 70 46 69 6c 65 2c 20 69 6e 74 20 65 4c 6f   *pFile, int eLo
4020: 63 6b 29 7b 0a 20 20 72 65 74 75 72 6e 20 53 51  ck){.  return SQ
4030: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a  LITE_OK;.}../*.*
4040: 2a 20 55 6e 6c 6f 63 6b 20 61 6e 20 66 73 2d 66  * Unlock an fs-f
4050: 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ile..*/.static i
4060: 6e 74 20 66 73 55 6e 6c 6f 63 6b 28 73 71 6c 69  nt fsUnlock(sqli
4070: 74 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65 2c  te3_file *pFile,
4080: 20 69 6e 74 20 65 4c 6f 63 6b 29 7b 0a 20 20 72   int eLock){.  r
4090: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
40a0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 65 63 6b 20  .}../*.** Check 
40b0: 69 66 20 61 6e 6f 74 68 65 72 20 66 69 6c 65 2d  if another file-
40c0: 68 61 6e 64 6c 65 20 68 6f 6c 64 73 20 61 20 52  handle holds a R
40d0: 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 6f 6e 20  ESERVED lock on 
40e0: 61 6e 20 66 73 2d 66 69 6c 65 2e 0a 2a 2f 0a 73  an fs-file..*/.s
40f0: 74 61 74 69 63 20 69 6e 74 20 66 73 43 68 65 63  tatic int fsChec
4100: 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b 28 73 71  kReservedLock(sq
4110: 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c  lite3_file *pFil
4120: 65 2c 20 69 6e 74 20 2a 70 52 65 73 4f 75 74 29  e, int *pResOut)
4130: 7b 0a 20 20 2a 70 52 65 73 4f 75 74 20 3d 20 30  {.  *pResOut = 0
4140: 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54  ;.  return SQLIT
4150: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46  E_OK;.}../*.** F
4160: 69 6c 65 20 63 6f 6e 74 72 6f 6c 20 6d 65 74 68  ile control meth
4170: 6f 64 2e 20 46 6f 72 20 63 75 73 74 6f 6d 20 6f  od. For custom o
4180: 70 65 72 61 74 69 6f 6e 73 20 6f 6e 20 61 6e 20  perations on an 
4190: 66 73 2d 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74  fs-file..*/.stat
41a0: 69 63 20 69 6e 74 20 66 73 46 69 6c 65 43 6f 6e  ic int fsFileCon
41b0: 74 72 6f 6c 28 73 71 6c 69 74 65 33 5f 66 69 6c  trol(sqlite3_fil
41c0: 65 20 2a 70 46 69 6c 65 2c 20 69 6e 74 20 6f 70  e *pFile, int op
41d0: 2c 20 76 6f 69 64 20 2a 70 41 72 67 29 7b 0a 20  , void *pArg){. 
41e0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
41f0: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  K;.}../*.** Retu
4200: 72 6e 20 74 68 65 20 73 65 63 74 6f 72 2d 73 69  rn the sector-si
4210: 7a 65 20 69 6e 20 62 79 74 65 73 20 66 6f 72 20  ze in bytes for 
4220: 61 6e 20 66 73 2d 66 69 6c 65 2e 0a 2a 2f 0a 73  an fs-file..*/.s
4230: 74 61 74 69 63 20 69 6e 74 20 66 73 53 65 63 74  tatic int fsSect
4240: 6f 72 53 69 7a 65 28 73 71 6c 69 74 65 33 5f 66  orSize(sqlite3_f
4250: 69 6c 65 20 2a 70 46 69 6c 65 29 7b 0a 20 20 72  ile *pFile){.  r
4260: 65 74 75 72 6e 20 42 4c 4f 43 4b 53 49 5a 45 3b  eturn BLOCKSIZE;
4270: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  .}../*.** Return
4280: 20 74 68 65 20 64 65 76 69 63 65 20 63 68 61 72   the device char
4290: 61 63 74 65 72 69 73 74 69 63 20 66 6c 61 67 73  acteristic flags
42a0: 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 61 6e   supported by an
42b0: 20 66 73 2d 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61   fs-file..*/.sta
42c0: 74 69 63 20 69 6e 74 20 66 73 44 65 76 69 63 65  tic int fsDevice
42d0: 43 68 61 72 61 63 74 65 72 69 73 74 69 63 73 28  Characteristics(
42e0: 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 46  sqlite3_file *pF
42f0: 69 6c 65 29 7b 0a 20 20 72 65 74 75 72 6e 20 30  ile){.  return 0
4300: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20  ;.}../*.** Open 
4310: 61 6e 20 66 73 20 66 69 6c 65 20 68 61 6e 64 6c  an fs file handl
4320: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  e..*/.static int
4330: 20 66 73 4f 70 65 6e 28 0a 20 20 73 71 6c 69 74   fsOpen(.  sqlit
4340: 65 33 5f 76 66 73 20 2a 70 56 66 73 2c 0a 20 20  e3_vfs *pVfs,.  
4350: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d  const char *zNam
4360: 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 6c  e,.  sqlite3_fil
4370: 65 20 2a 70 46 69 6c 65 2c 0a 20 20 69 6e 74 20  e *pFile,.  int 
4380: 66 6c 61 67 73 2c 0a 20 20 69 6e 74 20 2a 70 4f  flags,.  int *pO
4390: 75 74 46 6c 61 67 73 0a 29 7b 0a 20 20 66 73 5f  utFlags.){.  fs_
43a0: 76 66 73 5f 74 20 2a 70 46 73 56 66 73 20 3d 20  vfs_t *pFsVfs = 
43b0: 28 66 73 5f 76 66 73 5f 74 20 2a 29 70 56 66 73  (fs_vfs_t *)pVfs
43c0: 3b 0a 20 20 66 73 5f 66 69 6c 65 20 2a 70 20 3d  ;.  fs_file *p =
43d0: 20 28 66 73 5f 66 69 6c 65 20 2a 29 70 46 69 6c   (fs_file *)pFil
43e0: 65 3b 0a 20 20 66 73 5f 72 65 61 6c 5f 66 69 6c  e;.  fs_real_fil
43f0: 65 20 2a 70 52 65 61 6c 20 3d 20 30 3b 0a 20 20  e *pReal = 0;.  
4400: 69 6e 74 20 65 54 79 70 65 3b 0a 20 20 69 6e 74  int eType;.  int
4410: 20 6e 4e 61 6d 65 3b 0a 20 20 69 6e 74 20 72 63   nName;.  int rc
4420: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20   = SQLITE_OK;.. 
4430: 20 69 66 28 20 30 3d 3d 28 66 6c 61 67 73 26 28   if( 0==(flags&(
4440: 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e  SQLITE_OPEN_MAIN
4450: 5f 44 42 7c 53 51 4c 49 54 45 5f 4f 50 45 4e 5f  _DB|SQLITE_OPEN_
4460: 4d 41 49 4e 5f 4a 4f 55 52 4e 41 4c 29 29 20 29  MAIN_JOURNAL)) )
4470: 7b 0a 20 20 20 20 74 6d 70 5f 66 69 6c 65 20 2a  {.    tmp_file *
4480: 70 20 3d 20 28 74 6d 70 5f 66 69 6c 65 20 2a 29  p = (tmp_file *)
4490: 70 46 69 6c 65 3b 0a 20 20 20 20 6d 65 6d 73 65  pFile;.    memse
44a0: 74 28 70 2c 20 30 2c 20 73 69 7a 65 6f 66 28 2a  t(p, 0, sizeof(*
44b0: 70 29 29 3b 0a 20 20 20 20 70 2d 3e 62 61 73 65  p));.    p->base
44c0: 2e 70 4d 65 74 68 6f 64 73 20 3d 20 26 74 6d 70  .pMethods = &tmp
44d0: 5f 69 6f 5f 6d 65 74 68 6f 64 73 3b 0a 20 20 20  _io_methods;.   
44e0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
44f0: 4b 3b 0a 20 20 7d 0a 0a 20 20 65 54 79 70 65 20  K;.  }..  eType 
4500: 3d 20 28 28 66 6c 61 67 73 26 28 53 51 4c 49 54  = ((flags&(SQLIT
4510: 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 44 42 29 29  E_OPEN_MAIN_DB))
4520: 3f 44 41 54 41 42 41 53 45 5f 46 49 4c 45 3a 4a  ?DATABASE_FILE:J
4530: 4f 55 52 4e 41 4c 5f 46 49 4c 45 29 3b 0a 20 20  OURNAL_FILE);.  
4540: 70 2d 3e 62 61 73 65 2e 70 4d 65 74 68 6f 64 73  p->base.pMethods
4550: 20 3d 20 26 66 73 5f 69 6f 5f 6d 65 74 68 6f 64   = &fs_io_method
4560: 73 3b 0a 20 20 70 2d 3e 65 54 79 70 65 20 3d 20  s;.  p->eType = 
4570: 65 54 79 70 65 3b 0a 0a 20 20 61 73 73 65 72 74  eType;..  assert
4580: 28 73 74 72 6c 65 6e 28 22 2d 6a 6f 75 72 6e 61  (strlen("-journa
4590: 6c 22 29 3d 3d 38 29 3b 0a 20 20 6e 4e 61 6d 65  l")==8);.  nName
45a0: 20 3d 20 73 74 72 6c 65 6e 28 7a 4e 61 6d 65 29   = strlen(zName)
45b0: 2d 28 28 65 54 79 70 65 3d 3d 4a 4f 55 52 4e 41  -((eType==JOURNA
45c0: 4c 5f 46 49 4c 45 29 3f 38 3a 30 29 3b 0a 20 20  L_FILE)?8:0);.  
45d0: 70 52 65 61 6c 3d 70 46 73 56 66 73 2d 3e 70 46  pReal=pFsVfs->pF
45e0: 69 6c 65 4c 69 73 74 3b 20 0a 20 20 66 6f 72 28  ileList; .  for(
45f0: 3b 20 70 52 65 61 6c 20 26 26 20 73 74 72 6e 63  ; pReal && strnc
4600: 6d 70 28 70 52 65 61 6c 2d 3e 7a 4e 61 6d 65 2c  mp(pReal->zName,
4610: 20 7a 4e 61 6d 65 2c 20 6e 4e 61 6d 65 29 3b 20   zName, nName); 
4620: 70 52 65 61 6c 3d 70 52 65 61 6c 2d 3e 70 4e 65  pReal=pReal->pNe
4630: 78 74 29 3b 0a 0a 20 20 69 66 28 20 21 70 52 65  xt);..  if( !pRe
4640: 61 6c 20 29 7b 0a 20 20 20 20 69 6e 74 20 72 65  al ){.    int re
4650: 61 6c 5f 66 6c 61 67 73 20 3d 20 28 66 6c 61 67  al_flags = (flag
4660: 73 26 7e 28 53 51 4c 49 54 45 5f 4f 50 45 4e 5f  s&~(SQLITE_OPEN_
4670: 4d 41 49 4e 5f 44 42 29 29 7c 53 51 4c 49 54 45  MAIN_DB))|SQLITE
4680: 5f 4f 50 45 4e 5f 54 45 4d 50 5f 44 42 3b 0a 20  _OPEN_TEMP_DB;. 
4690: 20 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34     sqlite3_int64
46a0: 20 73 69 7a 65 3b 0a 20 20 20 20 73 71 6c 69 74   size;.    sqlit
46b0: 65 33 5f 66 69 6c 65 20 2a 70 52 65 61 6c 46 69  e3_file *pRealFi
46c0: 6c 65 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f  le;.    sqlite3_
46d0: 76 66 73 20 2a 70 50 61 72 65 6e 74 20 3d 20 70  vfs *pParent = p
46e0: 46 73 56 66 73 2d 3e 70 50 61 72 65 6e 74 3b 0a  FsVfs->pParent;.
46f0: 20 20 20 20 61 73 73 65 72 74 28 65 54 79 70 65      assert(eType
4700: 3d 3d 44 41 54 41 42 41 53 45 5f 46 49 4c 45 29  ==DATABASE_FILE)
4710: 3b 0a 0a 20 20 20 20 70 52 65 61 6c 20 3d 20 28  ;..    pReal = (
4720: 66 73 5f 72 65 61 6c 5f 66 69 6c 65 20 2a 29 73  fs_real_file *)s
4730: 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 73 69  qlite3_malloc(si
4740: 7a 65 6f 66 28 2a 70 52 65 61 6c 29 2b 70 50 61  zeof(*pReal)+pPa
4750: 72 65 6e 74 2d 3e 73 7a 4f 73 46 69 6c 65 29 3b  rent->szOsFile);
4760: 0a 20 20 20 20 69 66 28 20 21 70 52 65 61 6c 20  .    if( !pReal 
4770: 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51  ){.      rc = SQ
4780: 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20  LITE_NOMEM;.    
4790: 20 20 67 6f 74 6f 20 6f 70 65 6e 5f 6f 75 74 3b    goto open_out;
47a0: 0a 20 20 20 20 7d 0a 20 20 20 20 6d 65 6d 73 65  .    }.    memse
47b0: 74 28 70 52 65 61 6c 2c 20 30 2c 20 73 69 7a 65  t(pReal, 0, size
47c0: 6f 66 28 2a 70 52 65 61 6c 29 2b 70 50 61 72 65  of(*pReal)+pPare
47d0: 6e 74 2d 3e 73 7a 4f 73 46 69 6c 65 29 3b 0a 20  nt->szOsFile);. 
47e0: 20 20 20 70 52 65 61 6c 2d 3e 7a 4e 61 6d 65 20     pReal->zName 
47f0: 3d 20 7a 4e 61 6d 65 3b 0a 20 20 20 20 70 52 65  = zName;.    pRe
4800: 61 6c 2d 3e 70 46 69 6c 65 20 3d 20 28 73 71 6c  al->pFile = (sql
4810: 69 74 65 33 5f 66 69 6c 65 20 2a 29 28 26 70 52  ite3_file *)(&pR
4820: 65 61 6c 5b 31 5d 29 3b 0a 0a 20 20 20 20 72 63  eal[1]);..    rc
4830: 20 3d 20 70 50 61 72 65 6e 74 2d 3e 78 4f 70 65   = pParent->xOpe
4840: 6e 28 70 50 61 72 65 6e 74 2c 20 7a 4e 61 6d 65  n(pParent, zName
4850: 2c 20 70 52 65 61 6c 2d 3e 70 46 69 6c 65 2c 20  , pReal->pFile, 
4860: 72 65 61 6c 5f 66 6c 61 67 73 2c 20 70 4f 75 74  real_flags, pOut
4870: 46 6c 61 67 73 29 3b 0a 20 20 20 20 69 66 28 20  Flags);.    if( 
4880: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc!=SQLITE_OK ){
4890: 0a 20 20 20 20 20 20 67 6f 74 6f 20 6f 70 65 6e  .      goto open
48a0: 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20  _out;.    }.    
48b0: 70 52 65 61 6c 46 69 6c 65 20 3d 20 70 52 65 61  pRealFile = pRea
48c0: 6c 2d 3e 70 46 69 6c 65 3b 0a 0a 20 20 20 20 72  l->pFile;..    r
48d0: 63 20 3d 20 70 52 65 61 6c 46 69 6c 65 2d 3e 70  c = pRealFile->p
48e0: 4d 65 74 68 6f 64 73 2d 3e 78 46 69 6c 65 53 69  Methods->xFileSi
48f0: 7a 65 28 70 52 65 61 6c 46 69 6c 65 2c 20 26 73  ze(pRealFile, &s
4900: 69 7a 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63  ize);.    if( rc
4910: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  !=SQLITE_OK ){. 
4920: 20 20 20 20 20 67 6f 74 6f 20 6f 70 65 6e 5f 6f       goto open_o
4930: 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66  ut;.    }.    if
4940: 28 20 73 69 7a 65 3d 3d 30 20 29 7b 0a 20 20 20  ( size==0 ){.   
4950: 20 20 20 72 63 20 3d 20 70 52 65 61 6c 46 69 6c     rc = pRealFil
4960: 65 2d 3e 70 4d 65 74 68 6f 64 73 2d 3e 78 57 72  e->pMethods->xWr
4970: 69 74 65 28 70 52 65 61 6c 46 69 6c 65 2c 20 22  ite(pRealFile, "
4980: 5c 30 22 2c 20 31 2c 20 42 4c 4f 42 53 49 5a 45  \0", 1, BLOBSIZE
4990: 2d 31 29 3b 0a 20 20 20 20 20 20 70 52 65 61 6c  -1);.      pReal
49a0: 2d 3e 6e 42 6c 6f 62 20 3d 20 42 4c 4f 42 53 49  ->nBlob = BLOBSI
49b0: 5a 45 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20  ZE;.    }else{. 
49c0: 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 63 68       unsigned ch
49d0: 61 72 20 7a 53 5b 34 5d 3b 0a 20 20 20 20 20 20  ar zS[4];.      
49e0: 70 52 65 61 6c 2d 3e 6e 42 6c 6f 62 20 3d 20 73  pReal->nBlob = s
49f0: 69 7a 65 3b 0a 20 20 20 20 20 20 72 63 20 3d 20  ize;.      rc = 
4a00: 70 52 65 61 6c 46 69 6c 65 2d 3e 70 4d 65 74 68  pRealFile->pMeth
4a10: 6f 64 73 2d 3e 78 52 65 61 64 28 70 52 65 61 6c  ods->xRead(pReal
4a20: 46 69 6c 65 2c 20 7a 53 2c 20 34 2c 20 30 29 3b  File, zS, 4, 0);
4a30: 0a 20 20 20 20 20 20 70 52 65 61 6c 2d 3e 6e 44  .      pReal->nD
4a40: 61 74 61 62 61 73 65 20 3d 20 28 7a 53 5b 30 5d  atabase = (zS[0]
4a50: 3c 3c 32 34 29 2b 28 7a 53 5b 31 5d 3c 3c 31 36  <<24)+(zS[1]<<16
4a60: 29 2b 28 7a 53 5b 32 5d 3c 3c 38 29 2b 7a 53 5b  )+(zS[2]<<8)+zS[
4a70: 33 5d 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63  3];.      if( rc
4a80: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  ==SQLITE_OK ){. 
4a90: 20 20 20 20 20 20 20 72 63 20 3d 20 70 52 65 61         rc = pRea
4aa0: 6c 46 69 6c 65 2d 3e 70 4d 65 74 68 6f 64 73 2d  lFile->pMethods-
4ab0: 3e 78 52 65 61 64 28 70 52 65 61 6c 46 69 6c 65  >xRead(pRealFile
4ac0: 2c 20 7a 53 2c 20 34 2c 20 70 52 65 61 6c 2d 3e  , zS, 4, pReal->
4ad0: 6e 42 6c 6f 62 2d 34 29 3b 0a 20 20 20 20 20 20  nBlob-4);.      
4ae0: 20 20 69 66 28 20 7a 53 5b 30 5d 20 7c 7c 20 7a    if( zS[0] || z
4af0: 53 5b 31 5d 20 7c 7c 20 7a 53 5b 32 5d 20 7c 7c  S[1] || zS[2] ||
4b00: 20 7a 53 5b 33 5d 20 29 7b 0a 20 20 20 20 20 20   zS[3] ){.      
4b10: 20 20 20 20 70 52 65 61 6c 2d 3e 6e 4a 6f 75 72      pReal->nJour
4b20: 6e 61 6c 20 3d 20 70 52 65 61 6c 2d 3e 6e 42 6c  nal = pReal->nBl
4b30: 6f 62 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20  ob;.        }.  
4b40: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20      }.    }..   
4b50: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
4b60: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 52 65 61  OK ){.      pRea
4b70: 6c 2d 3e 70 4e 65 78 74 20 3d 20 70 46 73 56 66  l->pNext = pFsVf
4b80: 73 2d 3e 70 46 69 6c 65 4c 69 73 74 3b 0a 20 20  s->pFileList;.  
4b90: 20 20 20 20 69 66 28 20 70 52 65 61 6c 2d 3e 70      if( pReal->p
4ba0: 4e 65 78 74 20 29 7b 0a 20 20 20 20 20 20 20 20  Next ){.        
4bb0: 70 52 65 61 6c 2d 3e 70 4e 65 78 74 2d 3e 70 70  pReal->pNext->pp
4bc0: 54 68 69 73 20 3d 20 26 70 52 65 61 6c 2d 3e 70  This = &pReal->p
4bd0: 4e 65 78 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20  Next;.      }.  
4be0: 20 20 20 20 70 52 65 61 6c 2d 3e 70 70 54 68 69      pReal->ppThi
4bf0: 73 20 3d 20 26 70 46 73 56 66 73 2d 3e 70 46 69  s = &pFsVfs->pFi
4c00: 6c 65 4c 69 73 74 3b 0a 20 20 20 20 20 20 70 46  leList;.      pF
4c10: 73 56 66 73 2d 3e 70 46 69 6c 65 4c 69 73 74 20  sVfs->pFileList 
4c20: 3d 20 70 52 65 61 6c 3b 0a 20 20 20 20 7d 0a 20  = pReal;.    }. 
4c30: 20 7d 0a 0a 6f 70 65 6e 5f 6f 75 74 3a 0a 20 20   }..open_out:.  
4c40: 69 66 28 20 70 52 65 61 6c 20 29 7b 0a 20 20 20  if( pReal ){.   
4c50: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
4c60: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 2d 3e 70  OK ){.      p->p
4c70: 52 65 61 6c 20 3d 20 70 52 65 61 6c 3b 0a 20 20  Real = pReal;.  
4c80: 20 20 20 20 70 52 65 61 6c 2d 3e 6e 52 65 66 2b      pReal->nRef+
4c90: 2b 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  +;.    }else{.  
4ca0: 20 20 20 20 69 66 28 20 70 52 65 61 6c 2d 3e 70      if( pReal->p
4cb0: 46 69 6c 65 2d 3e 70 4d 65 74 68 6f 64 73 20 29  File->pMethods )
4cc0: 7b 0a 20 20 20 20 20 20 20 20 70 52 65 61 6c 2d  {.        pReal-
4cd0: 3e 70 46 69 6c 65 2d 3e 70 4d 65 74 68 6f 64 73  >pFile->pMethods
4ce0: 2d 3e 78 43 6c 6f 73 65 28 70 52 65 61 6c 2d 3e  ->xClose(pReal->
4cf0: 70 46 69 6c 65 29 3b 0a 20 20 20 20 20 20 7d 0a  pFile);.      }.
4d00: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72        sqlite3_fr
4d10: 65 65 28 70 52 65 61 6c 29 3b 0a 20 20 20 20 7d  ee(pReal);.    }
4d20: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63  .  }.  return rc
4d30: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65 6c 65 74  ;.}../*.** Delet
4d40: 65 20 74 68 65 20 66 69 6c 65 20 6c 6f 63 61 74  e the file locat
4d50: 65 64 20 61 74 20 7a 50 61 74 68 2e 20 49 66 20  ed at zPath. If 
4d60: 74 68 65 20 64 69 72 53 79 6e 63 20 61 72 67 75  the dirSync argu
4d70: 6d 65 6e 74 20 69 73 20 74 72 75 65 2c 0a 2a 2a  ment is true,.**
4d80: 20 65 6e 73 75 72 65 20 74 68 65 20 66 69 6c 65   ensure the file
4d90: 2d 73 79 73 74 65 6d 20 6d 6f 64 69 66 69 63 61  -system modifica
4da0: 74 69 6f 6e 73 20 61 72 65 20 73 79 6e 63 65 64  tions are synced
4db0: 20 74 6f 20 64 69 73 6b 20 62 65 66 6f 72 65 0a   to disk before.
4dc0: 2a 2a 20 72 65 74 75 72 6e 69 6e 67 2e 0a 2a 2f  ** returning..*/
4dd0: 0a 73 74 61 74 69 63 20 69 6e 74 20 66 73 44 65  .static int fsDe
4de0: 6c 65 74 65 28 73 71 6c 69 74 65 33 5f 76 66 73  lete(sqlite3_vfs
4df0: 20 2a 70 56 66 73 2c 20 63 6f 6e 73 74 20 63 68   *pVfs, const ch
4e00: 61 72 20 2a 7a 50 61 74 68 2c 20 69 6e 74 20 64  ar *zPath, int d
4e10: 69 72 53 79 6e 63 29 7b 0a 20 20 69 6e 74 20 72  irSync){.  int r
4e20: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
4e30: 20 66 73 5f 76 66 73 5f 74 20 2a 70 46 73 56 66   fs_vfs_t *pFsVf
4e40: 73 20 3d 20 28 66 73 5f 76 66 73 5f 74 20 2a 29  s = (fs_vfs_t *)
4e50: 70 56 66 73 3b 0a 20 20 66 73 5f 72 65 61 6c 5f  pVfs;.  fs_real_
4e60: 66 69 6c 65 20 2a 70 52 65 61 6c 3b 0a 20 20 73  file *pReal;.  s
4e70: 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 46 3b  qlite3_file *pF;
4e80: 0a 20 20 69 6e 74 20 6e 4e 61 6d 65 20 3d 20 73  .  int nName = s
4e90: 74 72 6c 65 6e 28 7a 50 61 74 68 29 20 2d 20 38  trlen(zPath) - 8
4ea0: 3b 0a 0a 20 20 61 73 73 65 72 74 28 73 74 72 6c  ;..  assert(strl
4eb0: 65 6e 28 22 2d 6a 6f 75 72 6e 61 6c 22 29 3d 3d  en("-journal")==
4ec0: 38 29 3b 0a 20 20 61 73 73 65 72 74 28 73 74 72  8);.  assert(str
4ed0: 63 6d 70 28 22 2d 6a 6f 75 72 6e 61 6c 22 2c 20  cmp("-journal", 
4ee0: 26 7a 50 61 74 68 5b 6e 4e 61 6d 65 5d 29 3d 3d  &zPath[nName])==
4ef0: 30 29 3b 0a 0a 20 20 70 52 65 61 6c 20 3d 20 70  0);..  pReal = p
4f00: 46 73 56 66 73 2d 3e 70 46 69 6c 65 4c 69 73 74  FsVfs->pFileList
4f10: 3b 20 0a 20 20 66 6f 72 28 3b 20 70 52 65 61 6c  ; .  for(; pReal
4f20: 20 26 26 20 73 74 72 6e 63 6d 70 28 70 52 65 61   && strncmp(pRea
4f30: 6c 2d 3e 7a 4e 61 6d 65 2c 20 7a 50 61 74 68 2c  l->zName, zPath,
4f40: 20 6e 4e 61 6d 65 29 3b 20 70 52 65 61 6c 3d 70   nName); pReal=p
4f50: 52 65 61 6c 2d 3e 70 4e 65 78 74 29 3b 0a 20 20  Real->pNext);.  
4f60: 69 66 28 20 70 52 65 61 6c 20 29 7b 0a 20 20 20  if( pReal ){.   
4f70: 20 70 46 20 3d 20 70 52 65 61 6c 2d 3e 70 46 69   pF = pReal->pFi
4f80: 6c 65 3b 0a 20 20 20 20 72 63 20 3d 20 70 46 2d  le;.    rc = pF-
4f90: 3e 70 4d 65 74 68 6f 64 73 2d 3e 78 57 72 69 74  >pMethods->xWrit
4fa0: 65 28 70 46 2c 20 22 5c 30 5c 30 5c 30 5c 30 22  e(pF, "\0\0\0\0"
4fb0: 2c 20 34 2c 20 70 52 65 61 6c 2d 3e 6e 42 6c 6f  , 4, pReal->nBlo
4fc0: 62 2d 42 4c 4f 43 4b 53 49 5a 45 29 3b 0a 20 20  b-BLOCKSIZE);.  
4fd0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
4fe0: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 52 65  _OK ){.      pRe
4ff0: 61 6c 2d 3e 6e 4a 6f 75 72 6e 61 6c 20 3d 20 30  al->nJournal = 0
5000: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65  ;.    }.  }.  re
5010: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a  turn rc;.}../*.*
5020: 2a 20 54 65 73 74 20 66 6f 72 20 61 63 63 65 73  * Test for acces
5030: 73 20 70 65 72 6d 69 73 73 69 6f 6e 73 2e 20 52  s permissions. R
5040: 65 74 75 72 6e 20 74 72 75 65 20 69 66 20 74 68  eturn true if th
5050: 65 20 72 65 71 75 65 73 74 65 64 20 70 65 72 6d  e requested perm
5060: 69 73 73 69 6f 6e 0a 2a 2a 20 69 73 20 61 76 61  ission.** is ava
5070: 69 6c 61 62 6c 65 2c 20 6f 72 20 66 61 6c 73 65  ilable, or false
5080: 20 6f 74 68 65 72 77 69 73 65 2e 0a 2a 2f 0a 73   otherwise..*/.s
5090: 74 61 74 69 63 20 69 6e 74 20 66 73 41 63 63 65  tatic int fsAcce
50a0: 73 73 28 0a 20 20 73 71 6c 69 74 65 33 5f 76 66  ss(.  sqlite3_vf
50b0: 73 20 2a 70 56 66 73 2c 20 0a 20 20 63 6f 6e 73  s *pVfs, .  cons
50c0: 74 20 63 68 61 72 20 2a 7a 50 61 74 68 2c 20 0a  t char *zPath, .
50d0: 20 20 69 6e 74 20 66 6c 61 67 73 2c 20 0a 20 20    int flags, .  
50e0: 69 6e 74 20 2a 70 52 65 73 4f 75 74 0a 29 7b 0a  int *pResOut.){.
50f0: 20 20 66 73 5f 76 66 73 5f 74 20 2a 70 46 73 56    fs_vfs_t *pFsV
5100: 66 73 20 3d 20 28 66 73 5f 76 66 73 5f 74 20 2a  fs = (fs_vfs_t *
5110: 29 70 56 66 73 3b 0a 20 20 66 73 5f 72 65 61 6c  )pVfs;.  fs_real
5120: 5f 66 69 6c 65 20 2a 70 52 65 61 6c 3b 0a 20 20  _file *pReal;.  
5130: 69 6e 74 20 69 73 4a 6f 75 72 6e 61 6c 20 3d 20  int isJournal = 
5140: 30 3b 0a 20 20 69 6e 74 20 6e 4e 61 6d 65 20 3d  0;.  int nName =
5150: 20 73 74 72 6c 65 6e 28 7a 50 61 74 68 29 3b 0a   strlen(zPath);.
5160: 0a 20 20 69 66 28 20 66 6c 61 67 73 21 3d 53 51  .  if( flags!=SQ
5170: 4c 49 54 45 5f 41 43 43 45 53 53 5f 45 58 49 53  LITE_ACCESS_EXIS
5180: 54 53 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  TS ){.    sqlite
5190: 33 5f 76 66 73 20 2a 70 50 61 72 65 6e 74 20 3d  3_vfs *pParent =
51a0: 20 28 28 66 73 5f 76 66 73 5f 74 20 2a 29 70 56   ((fs_vfs_t *)pV
51b0: 66 73 29 2d 3e 70 50 61 72 65 6e 74 3b 0a 20 20  fs)->pParent;.  
51c0: 20 20 72 65 74 75 72 6e 20 70 50 61 72 65 6e 74    return pParent
51d0: 2d 3e 78 41 63 63 65 73 73 28 70 50 61 72 65 6e  ->xAccess(pParen
51e0: 74 2c 20 7a 50 61 74 68 2c 20 66 6c 61 67 73 2c  t, zPath, flags,
51f0: 20 70 52 65 73 4f 75 74 29 3b 0a 20 20 7d 0a 0a   pResOut);.  }..
5200: 20 20 61 73 73 65 72 74 28 73 74 72 6c 65 6e 28    assert(strlen(
5210: 22 2d 6a 6f 75 72 6e 61 6c 22 29 3d 3d 38 29 3b  "-journal")==8);
5220: 0a 20 20 69 66 28 20 6e 4e 61 6d 65 3e 38 20 26  .  if( nName>8 &
5230: 26 20 73 74 72 63 6d 70 28 22 2d 6a 6f 75 72 6e  & strcmp("-journ
5240: 61 6c 22 2c 20 26 7a 50 61 74 68 5b 6e 4e 61 6d  al", &zPath[nNam
5250: 65 2d 38 5d 29 3d 3d 30 20 29 7b 0a 20 20 20 20  e-8])==0 ){.    
5260: 6e 4e 61 6d 65 20 2d 3d 20 38 3b 0a 20 20 20 20  nName -= 8;.    
5270: 69 73 4a 6f 75 72 6e 61 6c 20 3d 20 31 3b 0a 20  isJournal = 1;. 
5280: 20 7d 0a 0a 20 20 70 52 65 61 6c 20 3d 20 70 46   }..  pReal = pF
5290: 73 56 66 73 2d 3e 70 46 69 6c 65 4c 69 73 74 3b  sVfs->pFileList;
52a0: 20 0a 20 20 66 6f 72 28 3b 20 70 52 65 61 6c 20   .  for(; pReal 
52b0: 26 26 20 73 74 72 6e 63 6d 70 28 70 52 65 61 6c  && strncmp(pReal
52c0: 2d 3e 7a 4e 61 6d 65 2c 20 7a 50 61 74 68 2c 20  ->zName, zPath, 
52d0: 6e 4e 61 6d 65 29 3b 20 70 52 65 61 6c 3d 70 52  nName); pReal=pR
52e0: 65 61 6c 2d 3e 70 4e 65 78 74 29 3b 0a 0a 20 20  eal->pNext);..  
52f0: 2a 70 52 65 73 4f 75 74 20 3d 20 28 70 52 65 61  *pResOut = (pRea
5300: 6c 20 26 26 20 28 21 69 73 4a 6f 75 72 6e 61 6c  l && (!isJournal
5310: 20 7c 7c 20 70 52 65 61 6c 2d 3e 6e 4a 6f 75 72   || pReal->nJour
5320: 6e 61 6c 3e 30 29 29 3b 0a 20 20 72 65 74 75 72  nal>0));.  retur
5330: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a  n SQLITE_OK;.}..
5340: 2f 2a 0a 2a 2a 20 50 6f 70 75 6c 61 74 65 20 62  /*.** Populate b
5350: 75 66 66 65 72 20 7a 4f 75 74 20 77 69 74 68 20  uffer zOut with 
5360: 74 68 65 20 66 75 6c 6c 20 63 61 6e 6f 6e 69 63  the full canonic
5370: 61 6c 20 70 61 74 68 6e 61 6d 65 20 63 6f 72 72  al pathname corr
5380: 65 73 70 6f 6e 64 69 6e 67 0a 2a 2a 20 74 6f 20  esponding.** to 
5390: 74 68 65 20 70 61 74 68 6e 61 6d 65 20 69 6e 20  the pathname in 
53a0: 7a 50 61 74 68 2e 20 7a 4f 75 74 20 69 73 20 67  zPath. zOut is g
53b0: 75 61 72 61 6e 74 65 65 64 20 74 6f 20 70 6f 69  uaranteed to poi
53c0: 6e 74 20 74 6f 20 61 20 62 75 66 66 65 72 0a 2a  nt to a buffer.*
53d0: 2a 20 6f 66 20 61 74 20 6c 65 61 73 74 20 28 46  * of at least (F
53e0: 53 5f 4d 41 58 5f 50 41 54 48 4e 41 4d 45 2b 31  S_MAX_PATHNAME+1
53f0: 29 20 62 79 74 65 73 2e 0a 2a 2f 0a 73 74 61 74  ) bytes..*/.stat
5400: 69 63 20 69 6e 74 20 66 73 46 75 6c 6c 50 61 74  ic int fsFullPat
5410: 68 6e 61 6d 65 28 0a 20 20 73 71 6c 69 74 65 33  hname(.  sqlite3
5420: 5f 76 66 73 20 2a 70 56 66 73 2c 20 20 20 20 20  _vfs *pVfs,     
5430: 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65         /* Pointe
5440: 72 20 74 6f 20 76 66 73 20 6f 62 6a 65 63 74 20  r to vfs object 
5450: 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  */.  const char 
5460: 2a 7a 50 61 74 68 2c 20 20 20 20 20 20 20 20 20  *zPath,         
5470: 20 20 20 2f 2a 20 50 6f 73 73 69 62 6c 79 20 72     /* Possibly r
5480: 65 6c 61 74 69 76 65 20 69 6e 70 75 74 20 70 61  elative input pa
5490: 74 68 20 2a 2f 0a 20 20 69 6e 74 20 6e 4f 75 74  th */.  int nOut
54a0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
54b0: 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66        /* Size of
54c0: 20 6f 75 74 70 75 74 20 62 75 66 66 65 72 20 69   output buffer i
54d0: 6e 20 62 79 74 65 73 20 2a 2f 0a 20 20 63 68 61  n bytes */.  cha
54e0: 72 20 2a 7a 4f 75 74 20 20 20 20 20 20 20 20 20  r *zOut         
54f0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 75             /* Ou
5500: 74 70 75 74 20 62 75 66 66 65 72 20 2a 2f 0a 29  tput buffer */.)
5510: 7b 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20  {.  sqlite3_vfs 
5520: 2a 70 50 61 72 65 6e 74 20 3d 20 28 28 66 73 5f  *pParent = ((fs_
5530: 76 66 73 5f 74 20 2a 29 70 56 66 73 29 2d 3e 70  vfs_t *)pVfs)->p
5540: 50 61 72 65 6e 74 3b 0a 20 20 72 65 74 75 72 6e  Parent;.  return
5550: 20 70 50 61 72 65 6e 74 2d 3e 78 46 75 6c 6c 50   pParent->xFullP
5560: 61 74 68 6e 61 6d 65 28 70 50 61 72 65 6e 74 2c  athname(pParent,
5570: 20 7a 50 61 74 68 2c 20 6e 4f 75 74 2c 20 7a 4f   zPath, nOut, zO
5580: 75 74 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4f 70  ut);.}../*.** Op
5590: 65 6e 20 74 68 65 20 64 79 6e 61 6d 69 63 20 6c  en the dynamic l
55a0: 69 62 72 61 72 79 20 6c 6f 63 61 74 65 64 20 61  ibrary located a
55b0: 74 20 7a 50 61 74 68 20 61 6e 64 20 72 65 74 75  t zPath and retu
55c0: 72 6e 20 61 20 68 61 6e 64 6c 65 2e 0a 2a 2f 0a  rn a handle..*/.
55d0: 73 74 61 74 69 63 20 76 6f 69 64 20 2a 66 73 44  static void *fsD
55e0: 6c 4f 70 65 6e 28 73 71 6c 69 74 65 33 5f 76 66  lOpen(sqlite3_vf
55f0: 73 20 2a 70 56 66 73 2c 20 63 6f 6e 73 74 20 63  s *pVfs, const c
5600: 68 61 72 20 2a 7a 50 61 74 68 29 7b 0a 20 20 73  har *zPath){.  s
5610: 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 50 61 72  qlite3_vfs *pPar
5620: 65 6e 74 20 3d 20 28 28 66 73 5f 76 66 73 5f 74  ent = ((fs_vfs_t
5630: 20 2a 29 70 56 66 73 29 2d 3e 70 50 61 72 65 6e   *)pVfs)->pParen
5640: 74 3b 0a 20 20 72 65 74 75 72 6e 20 70 50 61 72  t;.  return pPar
5650: 65 6e 74 2d 3e 78 44 6c 4f 70 65 6e 28 70 50 61  ent->xDlOpen(pPa
5660: 72 65 6e 74 2c 20 7a 50 61 74 68 29 3b 0a 7d 0a  rent, zPath);.}.
5670: 0a 2f 2a 0a 2a 2a 20 50 6f 70 75 6c 61 74 65 20  ./*.** Populate 
5680: 74 68 65 20 62 75 66 66 65 72 20 7a 45 72 72 4d  the buffer zErrM
5690: 73 67 20 28 73 69 7a 65 20 6e 42 79 74 65 20 62  sg (size nByte b
56a0: 79 74 65 73 29 20 77 69 74 68 20 61 20 68 75 6d  ytes) with a hum
56b0: 61 6e 20 72 65 61 64 61 62 6c 65 0a 2a 2a 20 75  an readable.** u
56c0: 74 66 2d 38 20 73 74 72 69 6e 67 20 64 65 73 63  tf-8 string desc
56d0: 72 69 62 69 6e 67 20 74 68 65 20 6d 6f 73 74 20  ribing the most 
56e0: 72 65 63 65 6e 74 20 65 72 72 6f 72 20 65 6e 63  recent error enc
56f0: 6f 75 6e 74 65 72 65 64 20 61 73 73 6f 63 69 61  ountered associa
5700: 74 65 64 20 0a 2a 2a 20 77 69 74 68 20 64 79 6e  ted .** with dyn
5710: 61 6d 69 63 20 6c 69 62 72 61 72 69 65 73 2e 0a  amic libraries..
5720: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 66  */.static void f
5730: 73 44 6c 45 72 72 6f 72 28 73 71 6c 69 74 65 33  sDlError(sqlite3
5740: 5f 76 66 73 20 2a 70 56 66 73 2c 20 69 6e 74 20  _vfs *pVfs, int 
5750: 6e 42 79 74 65 2c 20 63 68 61 72 20 2a 7a 45 72  nByte, char *zEr
5760: 72 4d 73 67 29 7b 0a 20 20 73 71 6c 69 74 65 33  rMsg){.  sqlite3
5770: 5f 76 66 73 20 2a 70 50 61 72 65 6e 74 20 3d 20  _vfs *pParent = 
5780: 28 28 66 73 5f 76 66 73 5f 74 20 2a 29 70 56 66  ((fs_vfs_t *)pVf
5790: 73 29 2d 3e 70 50 61 72 65 6e 74 3b 0a 20 20 70  s)->pParent;.  p
57a0: 50 61 72 65 6e 74 2d 3e 78 44 6c 45 72 72 6f 72  Parent->xDlError
57b0: 28 70 50 61 72 65 6e 74 2c 20 6e 42 79 74 65 2c  (pParent, nByte,
57c0: 20 7a 45 72 72 4d 73 67 29 3b 0a 7d 0a 0a 2f 2a   zErrMsg);.}../*
57d0: 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 70 6f 69  .** Return a poi
57e0: 6e 74 65 72 20 74 6f 20 74 68 65 20 73 79 6d 62  nter to the symb
57f0: 6f 6c 20 7a 53 79 6d 62 6f 6c 20 69 6e 20 74 68  ol zSymbol in th
5800: 65 20 64 79 6e 61 6d 69 63 20 6c 69 62 72 61 72  e dynamic librar
5810: 79 20 70 48 61 6e 64 6c 65 2e 0a 2a 2f 0a 73 74  y pHandle..*/.st
5820: 61 74 69 63 20 76 6f 69 64 20 28 2a 66 73 44 6c  atic void (*fsDl
5830: 53 79 6d 28 73 71 6c 69 74 65 33 5f 76 66 73 20  Sym(sqlite3_vfs 
5840: 2a 70 56 66 73 2c 20 76 6f 69 64 20 2a 70 48 2c  *pVfs, void *pH,
5850: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 53 79   const char *zSy
5860: 6d 29 29 28 76 6f 69 64 29 7b 0a 20 20 73 71 6c  m))(void){.  sql
5870: 69 74 65 33 5f 76 66 73 20 2a 70 50 61 72 65 6e  ite3_vfs *pParen
5880: 74 20 3d 20 28 28 66 73 5f 76 66 73 5f 74 20 2a  t = ((fs_vfs_t *
5890: 29 70 56 66 73 29 2d 3e 70 50 61 72 65 6e 74 3b  )pVfs)->pParent;
58a0: 0a 20 20 72 65 74 75 72 6e 20 70 50 61 72 65 6e  .  return pParen
58b0: 74 2d 3e 78 44 6c 53 79 6d 28 70 50 61 72 65 6e  t->xDlSym(pParen
58c0: 74 2c 20 70 48 2c 20 7a 53 79 6d 29 3b 0a 7d 0a  t, pH, zSym);.}.
58d0: 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 74 68 65  ./*.** Close the
58e0: 20 64 79 6e 61 6d 69 63 20 6c 69 62 72 61 72 79   dynamic library
58f0: 20 68 61 6e 64 6c 65 20 70 48 61 6e 64 6c 65 2e   handle pHandle.
5900: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
5910: 66 73 44 6c 43 6c 6f 73 65 28 73 71 6c 69 74 65  fsDlClose(sqlite
5920: 33 5f 76 66 73 20 2a 70 56 66 73 2c 20 76 6f 69  3_vfs *pVfs, voi
5930: 64 20 2a 70 48 61 6e 64 6c 65 29 7b 0a 20 20 73  d *pHandle){.  s
5940: 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 50 61 72  qlite3_vfs *pPar
5950: 65 6e 74 20 3d 20 28 28 66 73 5f 76 66 73 5f 74  ent = ((fs_vfs_t
5960: 20 2a 29 70 56 66 73 29 2d 3e 70 50 61 72 65 6e   *)pVfs)->pParen
5970: 74 3b 0a 20 20 70 50 61 72 65 6e 74 2d 3e 78 44  t;.  pParent->xD
5980: 6c 43 6c 6f 73 65 28 70 50 61 72 65 6e 74 2c 20  lClose(pParent, 
5990: 70 48 61 6e 64 6c 65 29 3b 0a 7d 0a 0a 2f 2a 0a  pHandle);.}../*.
59a0: 2a 2a 20 50 6f 70 75 6c 61 74 65 20 74 68 65 20  ** Populate the 
59b0: 62 75 66 66 65 72 20 70 6f 69 6e 74 65 64 20 74  buffer pointed t
59c0: 6f 20 62 79 20 7a 42 75 66 4f 75 74 20 77 69 74  o by zBufOut wit
59d0: 68 20 6e 42 79 74 65 20 62 79 74 65 73 20 6f 66  h nByte bytes of
59e0: 20 0a 2a 2a 20 72 61 6e 64 6f 6d 20 64 61 74 61   .** random data
59f0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
5a00: 66 73 52 61 6e 64 6f 6d 6e 65 73 73 28 73 71 6c  fsRandomness(sql
5a10: 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73 2c 20  ite3_vfs *pVfs, 
5a20: 69 6e 74 20 6e 42 79 74 65 2c 20 63 68 61 72 20  int nByte, char 
5a30: 2a 7a 42 75 66 4f 75 74 29 7b 0a 20 20 73 71 6c  *zBufOut){.  sql
5a40: 69 74 65 33 5f 76 66 73 20 2a 70 50 61 72 65 6e  ite3_vfs *pParen
5a50: 74 20 3d 20 28 28 66 73 5f 76 66 73 5f 74 20 2a  t = ((fs_vfs_t *
5a60: 29 70 56 66 73 29 2d 3e 70 50 61 72 65 6e 74 3b  )pVfs)->pParent;
5a70: 0a 20 20 72 65 74 75 72 6e 20 70 50 61 72 65 6e  .  return pParen
5a80: 74 2d 3e 78 52 61 6e 64 6f 6d 6e 65 73 73 28 70  t->xRandomness(p
5a90: 50 61 72 65 6e 74 2c 20 6e 42 79 74 65 2c 20 7a  Parent, nByte, z
5aa0: 42 75 66 4f 75 74 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  BufOut);.}../*.*
5ab0: 2a 20 53 6c 65 65 70 20 66 6f 72 20 6e 4d 69 63  * Sleep for nMic
5ac0: 72 6f 20 6d 69 63 72 6f 73 65 63 6f 6e 64 73 2e  ro microseconds.
5ad0: 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62   Return the numb
5ae0: 65 72 20 6f 66 20 6d 69 63 72 6f 73 65 63 6f 6e  er of microsecon
5af0: 64 73 20 0a 2a 2a 20 61 63 74 75 61 6c 6c 79 20  ds .** actually 
5b00: 73 6c 65 70 74 2e 0a 2a 2f 0a 73 74 61 74 69 63  slept..*/.static
5b10: 20 69 6e 74 20 66 73 53 6c 65 65 70 28 73 71 6c   int fsSleep(sql
5b20: 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73 2c 20  ite3_vfs *pVfs, 
5b30: 69 6e 74 20 6e 4d 69 63 72 6f 29 7b 0a 20 20 73  int nMicro){.  s
5b40: 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 50 61 72  qlite3_vfs *pPar
5b50: 65 6e 74 20 3d 20 28 28 66 73 5f 76 66 73 5f 74  ent = ((fs_vfs_t
5b60: 20 2a 29 70 56 66 73 29 2d 3e 70 50 61 72 65 6e   *)pVfs)->pParen
5b70: 74 3b 0a 20 20 72 65 74 75 72 6e 20 70 50 61 72  t;.  return pPar
5b80: 65 6e 74 2d 3e 78 53 6c 65 65 70 28 70 50 61 72  ent->xSleep(pPar
5b90: 65 6e 74 2c 20 6e 4d 69 63 72 6f 29 3b 0a 7d 0a  ent, nMicro);.}.
5ba0: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68  ./*.** Return th
5bb0: 65 20 63 75 72 72 65 6e 74 20 74 69 6d 65 20 61  e current time a
5bc0: 73 20 61 20 4a 75 6c 69 61 6e 20 44 61 79 20 6e  s a Julian Day n
5bd0: 75 6d 62 65 72 20 69 6e 20 2a 70 54 69 6d 65 4f  umber in *pTimeO
5be0: 75 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  ut..*/.static in
5bf0: 74 20 66 73 43 75 72 72 65 6e 74 54 69 6d 65 28  t fsCurrentTime(
5c00: 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66  sqlite3_vfs *pVf
5c10: 73 2c 20 64 6f 75 62 6c 65 20 2a 70 54 69 6d 65  s, double *pTime
5c20: 4f 75 74 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f  Out){.  sqlite3_
5c30: 76 66 73 20 2a 70 50 61 72 65 6e 74 20 3d 20 28  vfs *pParent = (
5c40: 28 66 73 5f 76 66 73 5f 74 20 2a 29 70 56 66 73  (fs_vfs_t *)pVfs
5c50: 29 2d 3e 70 50 61 72 65 6e 74 3b 0a 20 20 72 65  )->pParent;.  re
5c60: 74 75 72 6e 20 70 50 61 72 65 6e 74 2d 3e 78 43  turn pParent->xC
5c70: 75 72 72 65 6e 74 54 69 6d 65 28 70 50 61 72 65  urrentTime(pPare
5c80: 6e 74 2c 20 70 54 69 6d 65 4f 75 74 29 3b 0a 7d  nt, pTimeOut);.}
5c90: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 70 72 6f  ../*.** This pro
5ca0: 63 65 64 75 72 65 20 72 65 67 69 73 74 65 72 73  cedure registers
5cb0: 20 74 68 65 20 66 73 20 76 66 73 20 77 69 74 68   the fs vfs with
5cc0: 20 53 51 4c 69 74 65 2e 20 49 66 20 74 68 65 20   SQLite. If the 
5cd0: 61 72 67 75 6d 65 6e 74 20 69 73 0a 2a 2a 20 74  argument is.** t
5ce0: 72 75 65 2c 20 74 68 65 20 66 73 20 76 66 73 20  rue, the fs vfs 
5cf0: 62 65 63 6f 6d 65 73 20 74 68 65 20 6e 65 77 20  becomes the new 
5d00: 64 65 66 61 75 6c 74 20 76 66 73 2e 20 49 74 20  default vfs. It 
5d10: 69 73 20 74 68 65 20 6f 6e 6c 79 20 70 75 62 6c  is the only publ
5d20: 69 63 6c 79 0a 2a 2a 20 61 76 61 69 6c 61 62 6c  icly.** availabl
5d30: 65 20 66 75 6e 63 74 69 6f 6e 20 69 6e 20 74 68  e function in th
5d40: 69 73 20 66 69 6c 65 2e 0a 2a 2f 0a 69 6e 74 20  is file..*/.int 
5d50: 66 73 5f 72 65 67 69 73 74 65 72 28 76 6f 69 64  fs_register(void
5d60: 29 7b 0a 20 20 69 66 28 20 66 73 5f 76 66 73 2e  ){.  if( fs_vfs.
5d70: 70 50 61 72 65 6e 74 20 29 20 72 65 74 75 72 6e  pParent ) return
5d80: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 66 73   SQLITE_OK;.  fs
5d90: 5f 76 66 73 2e 70 50 61 72 65 6e 74 20 3d 20 73  _vfs.pParent = s
5da0: 71 6c 69 74 65 33 5f 76 66 73 5f 66 69 6e 64 28  qlite3_vfs_find(
5db0: 30 29 3b 0a 20 20 66 73 5f 76 66 73 2e 62 61 73  0);.  fs_vfs.bas
5dc0: 65 2e 6d 78 50 61 74 68 6e 61 6d 65 20 3d 20 66  e.mxPathname = f
5dd0: 73 5f 76 66 73 2e 70 50 61 72 65 6e 74 2d 3e 6d  s_vfs.pParent->m
5de0: 78 50 61 74 68 6e 61 6d 65 3b 0a 20 20 66 73 5f  xPathname;.  fs_
5df0: 76 66 73 2e 62 61 73 65 2e 73 7a 4f 73 46 69 6c  vfs.base.szOsFil
5e00: 65 20 3d 20 4d 41 58 28 73 69 7a 65 6f 66 28 74  e = MAX(sizeof(t
5e10: 6d 70 5f 66 69 6c 65 29 2c 20 73 69 7a 65 6f 66  mp_file), sizeof
5e20: 28 66 73 5f 66 69 6c 65 29 29 3b 0a 20 20 72 65  (fs_file));.  re
5e30: 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 66 73  turn sqlite3_vfs
5e40: 5f 72 65 67 69 73 74 65 72 28 26 66 73 5f 76 66  _register(&fs_vf
5e50: 73 2e 62 61 73 65 2c 20 30 29 3b 0a 7d 0a 0a 23  s.base, 0);.}..#
5e60: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45 53  ifdef SQLITE_TES
5e70: 54 0a 20 20 69 6e 74 20 53 71 6c 69 74 65 74 65  T.  int Sqlitete
5e80: 73 74 4f 6e 65 66 69 6c 65 5f 49 6e 69 74 28 29  stOnefile_Init()
5e90: 20 7b 72 65 74 75 72 6e 20 66 73 5f 72 65 67 69   {return fs_regi
5ea0: 73 74 65 72 28 29 3b 7d 0a 23 65 6e 64 69 66 0a  ster();}.#endif.