/ Hex Artifact Content
Login

Artifact 38f7cbe79d5bafe95bde683cc3a53b8ca16daf10:


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